[{"id":38327,"web_url":"https://patchwork.libcamera.org/comment/38327/","msgid":"<177262662897.1693075.14289799160566056581@ping.linuxembedded.co.uk>","date":"2026-03-04T12:17:08","subject":"Re: [PATCH v3] utils: Introduce libcamera-bug-report","submitter":{"id":4,"url":"https://patchwork.libcamera.org/api/people/4/","name":"Kieran Bingham","email":"kieran.bingham@ideasonboard.com"},"content":"Quoting Kieran Bingham (2026-02-18 15:51:36)\n> Introduce a script which can be installed into the system to aide\n> reporting potential camera and media related issues.\n> \n> The script shall capture system information and store it in a temporary\n> file - but it remains the users responsibilty to choose to share this\n> data, and no automatic bug submissions are anticipated.\n> \n> Signed-off-by: Kieran Bingham \n> ---\n> There are many occasions where people would like to report issues with\n> their camera, and there are always a common set of commands that we\n> would like to run to identify potential issues.\n> \n> Provide a helper that will ease reporting of camera related issues\n> especially for bringup of new cameras or when cameras do not show.\n\nAnyone got any comments or feedback on this patch ?\n\nI think the impact is low to merge, and I think it can help easily grab\nuseful information when working with cameras.\n\n--\nKieran\n\n\n> \n> ---\n> Changes in v3:\n> \n> - Fix media-ctl usage\n> - Fix devices_deferred to use run_as_sudo\n>\n> v2:\n> - Fix installation with correct filename\n> - Do not override file permissions\n> - Add a request to remove sensitive information\n> - Use posix shell and clear through shellcheck\n> - Ask for permission to use sudo\n> \n> v3:\n> - Fix media device topology printing\n> - fix devices_deferred to run with sudo\n> ---\n> utils/libcamera-bug-report | 119 +++++++++++++++++++++++++++++++++++++++++++++\n> utils/meson.build | 6 +++\n> 2 files changed, 125 insertions(+)\n> \n> diff --git a/utils/libcamera-bug-report b/utils/libcamera-bug-report\n> new file mode 100755\n> index 000000000000..13ae3265082c\n> --- /dev/null\n> +++ b/utils/libcamera-bug-report\n> @@ -0,0 +1,119 @@\n> +#!/bin/sh\n> +# SPDX-License-Identifier: LGPL-2.1-or-later\n> +\n> +REPORT=\"libcamera-report-$(hostname)-$(date +%Y%m%d-%H%M%S).txt\"\n> +\n> +section() {\n> + echo\n> + echo \"==================================================\"\n> + echo \"$1\"\n> + echo \"==================================================\"\n> +}\n> +\n> +run() {\n> + echo\n> + echo \"\\$ $*\"\n> + \"$@\" || echo \"[WARN] Command failed: $*\"\n> +}\n> +\n> +# Run a command with sudo if the script was allowed to use it.\n> +run_with_sudo() {\n> + if [ -n \"$SUDO\" ]; then\n> + echo\n> + echo \"\\$ $SUDO $*\"\n> + $SUDO \"$@\" || echo \"[WARN] Command failed: $SUDO $*\"\n> + else\n> + run \"$@\"\n> + fi\n> +}\n> +\n> +mark_kmsg() {\n> + if [ -w /dev/kmsg ]; then\n> + echo \"libcamera-debug-report[$$]: $1\" > /dev/kmsg\n> + else\n> + if [ -n \"$SUDO\" ]; then\n> + printf \"libcamera-debug-report[%s]: %s\\n\" \"$$\" \"$1\" | $SUDO tee /dev/kmsg >/dev/null || \\\n> + echo \"[WARN] failed to write /dev/kmsg with sudo: $1\"\n> + else\n> + echo \"[INFO] /dev/kmsg not writable, skipping kernel marker: $1\"\n> + fi\n> + fi\n> +}\n> +\n> +main() {\n> +\n> +section \"Report metadata\"\n> +echo \"Date: $(date -Is)\"\n> +echo \"Host: $(hostname)\"\n> +echo \"User: $(id)\"\n> +\n> +section \"Kernel & OS\"\n> +run uname -a\n> +run cat /etc/os-release\n> +command -v lsb_release >/dev/null && run lsb_release -a\n> +\n> +section \"Media / V4L2 tools\"\n> +command -v media-ctl >/dev/null && run media-ctl --version\n> +command -v v4l2-ctl >/dev/null && run v4l2-ctl --version\n> +command -v v4l2-ctl >/dev/null && run v4l2-ctl --list-devices\n> +\n> +section \"Device nodes\"\n> +run ls -l /dev/video* /dev/v4l-* /dev/media* 2>/dev/null\n> +run grep . /sys/class/video4linux/*/name\n> +\n> +section \"Deferred devices\"\n> +run_with_sudo cat /sys/kernel/debug/devices_deferred\n> +\n> +section \"V4L2 async pending subdevices\"\n> +run_with_sudo cat /sys/kernel/debug/v4l2-async/pending_async_subdevices\n> +\n> +section \"Media graph topology\"\n> +for m in /dev/media*; do\n> + echo\n> + echo \"Parsing $m\"\n> + command -v media-ctl >/dev/null && run media-ctl -p -d \"$m\"\n> +done\n> +\n> +section \"libcamera & userspace\"\n> +run which cam\n> +command -v cam >/dev/null && run ldd \"$(which cam)\"\n> +\n> +section \"libcamera probe (cam -l)\"\n> +mark_kmsg \"BEGIN cam -l\"\n> +LIBCAMERA_LOG_LEVELS=\"*:0\" run cam -l\n> +mark_kmsg \"END cam -l\"\n> +\n> +section \"Kernel log (post cam -l)\"\n> +run_with_sudo dmesg\n> +\n> +section \"Permissions & capabilities\"\n> +run id\n> +run groups\n> +command -v getcap >/dev/null && run getcap \"$(which cam)\"\n> +\n> +section \"End of report\"\n> +\n> +cat < +\n> +Report saved to $REPORT.\n> +\n> +Please inspect the report and remove any sensitive information before sharing.\n> +EOF\n> +\n> +}\n> +\n> +# If not running as root, prompt the user once to allow sudo\n> +SUDO=\"\"\n> +if [ \"$(id -u)\" -ne 0 ]; then\n> + if [ -t 0 ]; then\n> + printf \"Some checks require root; allow sudo for privileged commands? [y/N] \"\n> + read -r ans\n> + case \"$ans\" in\n> + [Yy]|[Yy][Ee][Ss]) SUDO=\"sudo\" ;;\n> + *) SUDO=\"\" ;;\n> + esac\n> + fi\n> +fi\n> +\n> +# Run main and tee output to both stdout and the report file.\n> +main 2>&1 | tee \"$REPORT\"\n> diff --git a/utils/meson.build b/utils/meson.build\n> index 3deed8ad4d7e..9c598793035c 100644\n> --- a/utils/meson.build\n> +++ b/utils/meson.build\n> @@ -7,3 +7,9 @@ gen_shader_headers = files('gen-shader-headers.sh')\n> \n> ## Module signing\n> gen_ipa_priv_key = files('gen-ipa-priv-key.sh')\n> +\n> +## Bug reporting utility\n> +install_data(\n> + 'libcamera-bug-report',\n> + install_dir: get_option('bindir'),\n> +)\n> \n> ---\n> base-commit: d97d2a58adaf284860fdf5d1f6785d779ab6e24a\n> change-id: 20260207-kbingham-bug-reporter-60285cd034af\n> \n> Best regards,\n> -- \n> --\n> Kieran\n>","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id A27B8C0DA4\n\tfor ;\n\tWed, 4 Mar 2026 12:17:14 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id B4387623A3;\n\tWed, 4 Mar 2026 13:17:13 +0100 (CET)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[IPv6:2001:4b98:dc2:55:216:3eff:fef7:d647])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 2476D62380\n\tfor ;\n\tWed, 4 Mar 2026 13:17:12 +0100 (CET)","from monstersaurus.ideasonboard.com\n\t(cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 7460B838\n\tfor ;\n\tWed, 4 Mar 2026 13:16:09 +0100 (CET)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"SGqHdjUn\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1772626569;\n\tbh=CO9tKBxJhVuXJnziDv5Sh7am5aqx3JTFtSCtaRSMnt0=;\n\th=In-Reply-To:References:Subject:From:Cc:To:Date:From;\n\tb=SGqHdjUnXJj8g+pq4JAqBd173nWDe5GTiB3wwk2DxtUlTipJ/AU2cQR2TE8n82Hj6\n\tGezkXXdZZK9DWJrHama0vBegkr6BP0wRPuekDakB3svGXDPHEPz/U2SLBiD9savUHj\n\tsH3rjF9cP1Feh98hqZdqFT3k0oTqT9FRxpnYIXUs=","Content-Type":"text/plain; charset=\"utf-8\"","MIME-Version":"1.0","Content-Transfer-Encoding":"quoted-printable","In-Reply-To":"<20260218-kbingham-bug-reporter-v3-1-55484362bcc0@ideasonboard.com>","References":"<20260218-kbingham-bug-reporter-v3-1-55484362bcc0@ideasonboard.com>","Subject":"Re: [PATCH v3] utils: Introduce libcamera-bug-report","From":"Kieran Bingham ","Cc":"","To":"libcamera-devel@lists.libcamera.org","Date":"Wed, 04 Mar 2026 12:17:08 +0000","Message-ID":"<177262662897.1693075.14289799160566056581@ping.linuxembedded.co.uk>","User-Agent":"alot/0.9.1","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}},{"id":38330,"web_url":"https://patchwork.libcamera.org/comment/38330/","msgid":"<20260304132248.GG3891530@killaraus.ideasonboard.com>","date":"2026-03-04T13:22:48","subject":"Re: [PATCH v3] utils: Introduce libcamera-bug-report","submitter":{"id":2,"url":"https://patchwork.libcamera.org/api/people/2/","name":"Laurent Pinchart","email":"laurent.pinchart@ideasonboard.com"},"content":"On Wed, Mar 04, 2026 at 12:17:08PM +0000, Kieran Bingham wrote:\n> Quoting Kieran Bingham (2026-02-18 15:51:36)\n> > Introduce a script which can be installed into the system to aide\n> > reporting potential camera and media related issues.\n> > \n> > The script shall capture system information and store it in a temporary\n> > file - but it remains the users responsibilty to choose to share this\n> > data, and no automatic bug submissions are anticipated.\n> > \n> > Signed-off-by: Kieran Bingham \n> > ---\n> > There are many occasions where people would like to report issues with\n> > their camera, and there are always a common set of commands that we\n> > would like to run to identify potential issues.\n> > \n> > Provide a helper that will ease reporting of camera related issues\n> > especially for bringup of new cameras or when cameras do not show.\n> \n> Anyone got any comments or feedback on this patch ?\n> \n> I think the impact is low to merge, and I think it can help easily grab\n> useful information when working with cameras.\n\nPlease see below for a few small comments.\n\n> > ---\n> > Changes in v3:\n> > \n> > - Fix media-ctl usage\n> > - Fix devices_deferred to use run_as_sudo\n> >\n> > v2:\n> > - Fix installation with correct filename\n> > - Do not override file permissions\n> > - Add a request to remove sensitive information\n> > - Use posix shell and clear through shellcheck\n> > - Ask for permission to use sudo\n> > \n> > v3:\n> > - Fix media device topology printing\n> > - fix devices_deferred to run with sudo\n> > ---\n> > utils/libcamera-bug-report | 119 +++++++++++++++++++++++++++++++++++++++++++++\n> > utils/meson.build | 6 +++\n> > 2 files changed, 125 insertions(+)\n> > \n> > diff --git a/utils/libcamera-bug-report b/utils/libcamera-bug-report\n> > new file mode 100755\n> > index 000000000000..13ae3265082c\n> > --- /dev/null\n> > +++ b/utils/libcamera-bug-report\n> > @@ -0,0 +1,119 @@\n> > +#!/bin/sh\n> > +# SPDX-License-Identifier: LGPL-2.1-or-later\n\nWe usually use GPL-2.0-or-later for shell scripts.\n\n> > +\n> > +REPORT=\"libcamera-report-$(hostname)-$(date +%Y%m%d-%H%M%S).txt\"\n> > +\n> > +section() {\n> > + echo\n> > + echo \"==================================================\"\n> > + echo \"$1\"\n> > + echo \"==================================================\"\n> > +}\n> > +\n> > +run() {\n> > + echo\n> > + echo \"\\$ $*\"\n> > + \"$@\" || echo \"[WARN] Command failed: $*\"\n> > +}\n> > +\n> > +# Run a command with sudo if the script was allowed to use it.\n> > +run_with_sudo() {\n> > + if [ -n \"$SUDO\" ]; then\n> > + echo\n> > + echo \"\\$ $SUDO $*\"\n> > + $SUDO \"$@\" || echo \"[WARN] Command failed: $SUDO $*\"\n> > + else\n> > + run \"$@\"\n> > + fi\n> > +}\n> > +\n> > +mark_kmsg() {\n> > + if [ -w /dev/kmsg ]; then\n> > + echo \"libcamera-debug-report[$$]: $1\" > /dev/kmsg\n> > + else\n> > + if [ -n \"$SUDO\" ]; then\n> > + printf \"libcamera-debug-report[%s]: %s\\n\" \"$$\" \"$1\" | $SUDO tee /dev/kmsg >/dev/null || \\\n> > + echo \"[WARN] failed to write /dev/kmsg with sudo: $1\"\n> > + else\n> > + echo \"[INFO] /dev/kmsg not writable, skipping kernel marker: $1\"\n> > + fi\n> > + fi\n\nYou can write\n\n if [ -w /dev/kmsg ]; then\n echo \"libcamera-debug-report[$$]: $1\" > /dev/kmsg\n elif [ -n \"$SUDO\" ]; then\n printf \"libcamera-debug-report[%s]: %s\\n\" \"$$\" \"$1\" | $SUDO tee /dev/kmsg >/dev/null || \\\n echo \"[WARN] failed to write /dev/kmsg with sudo: $1\"\n else\n echo \"[INFO] /dev/kmsg not writable, skipping kernel marker: $1\"\n fi\n\n> > +}\n> > +\n> > +main() {\n\nI've just noticed that the main() function isn't indented.\n\nApart from those three small issues I think it's good to go.\n\nReviewed-by: Laurent Pinchart \n\n> > +\n> > +section \"Report metadata\"\n> > +echo \"Date: $(date -Is)\"\n> > +echo \"Host: $(hostname)\"\n> > +echo \"User: $(id)\"\n> > +\n> > +section \"Kernel & OS\"\n> > +run uname -a\n> > +run cat /etc/os-release\n> > +command -v lsb_release >/dev/null && run lsb_release -a\n> > +\n> > +section \"Media / V4L2 tools\"\n> > +command -v media-ctl >/dev/null && run media-ctl --version\n> > +command -v v4l2-ctl >/dev/null && run v4l2-ctl --version\n> > +command -v v4l2-ctl >/dev/null && run v4l2-ctl --list-devices\n> > +\n> > +section \"Device nodes\"\n> > +run ls -l /dev/video* /dev/v4l-* /dev/media* 2>/dev/null\n> > +run grep . /sys/class/video4linux/*/name\n> > +\n> > +section \"Deferred devices\"\n> > +run_with_sudo cat /sys/kernel/debug/devices_deferred\n> > +\n> > +section \"V4L2 async pending subdevices\"\n> > +run_with_sudo cat /sys/kernel/debug/v4l2-async/pending_async_subdevices\n> > +\n> > +section \"Media graph topology\"\n> > +for m in /dev/media*; do\n> > + echo\n> > + echo \"Parsing $m\"\n> > + command -v media-ctl >/dev/null && run media-ctl -p -d \"$m\"\n> > +done\n> > +\n> > +section \"libcamera & userspace\"\n> > +run which cam\n> > +command -v cam >/dev/null && run ldd \"$(which cam)\"\n> > +\n> > +section \"libcamera probe (cam -l)\"\n> > +mark_kmsg \"BEGIN cam -l\"\n> > +LIBCAMERA_LOG_LEVELS=\"*:0\" run cam -l\n> > +mark_kmsg \"END cam -l\"\n> > +\n> > +section \"Kernel log (post cam -l)\"\n> > +run_with_sudo dmesg\n> > +\n> > +section \"Permissions & capabilities\"\n> > +run id\n> > +run groups\n> > +command -v getcap >/dev/null && run getcap \"$(which cam)\"\n> > +\n> > +section \"End of report\"\n> > +\n> > +cat < > +\n> > +Report saved to $REPORT.\n> > +\n> > +Please inspect the report and remove any sensitive information before sharing.\n> > +EOF\n> > +\n> > +}\n> > +\n> > +# If not running as root, prompt the user once to allow sudo\n> > +SUDO=\"\"\n> > +if [ \"$(id -u)\" -ne 0 ]; then\n> > + if [ -t 0 ]; then\n> > + printf \"Some checks require root; allow sudo for privileged commands? [y/N] \"\n> > + read -r ans\n> > + case \"$ans\" in\n> > + [Yy]|[Yy][Ee][Ss]) SUDO=\"sudo\" ;;\n> > + *) SUDO=\"\" ;;\n> > + esac\n> > + fi\n> > +fi\n> > +\n> > +# Run main and tee output to both stdout and the report file.\n> > +main 2>&1 | tee \"$REPORT\"\n> > diff --git a/utils/meson.build b/utils/meson.build\n> > index 3deed8ad4d7e..9c598793035c 100644\n> > --- a/utils/meson.build\n> > +++ b/utils/meson.build\n> > @@ -7,3 +7,9 @@ gen_shader_headers = files('gen-shader-headers.sh')\n> > \n> > ## Module signing\n> > gen_ipa_priv_key = files('gen-ipa-priv-key.sh')\n> > +\n> > +## Bug reporting utility\n> > +install_data(\n> > + 'libcamera-bug-report',\n> > + install_dir: get_option('bindir'),\n> > +)\n> > \n> > ---\n> > base-commit: d97d2a58adaf284860fdf5d1f6785d779ab6e24a\n> > change-id: 20260207-kbingham-bug-reporter-60285cd034af","headers":{"Return-Path":"","X-Original-To":"parsemail@patchwork.libcamera.org","Delivered-To":"parsemail@patchwork.libcamera.org","Received":["from lancelot.ideasonboard.com (lancelot.ideasonboard.com\n\t[92.243.16.209])\n\tby patchwork.libcamera.org (Postfix) with ESMTPS id 51548BE086\n\tfor ;\n\tWed, 4 Mar 2026 13:22:52 +0000 (UTC)","from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 634056239D;\n\tWed, 4 Mar 2026 14:22:51 +0100 (CET)","from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id AB75B62380\n\tfor ;\n\tWed, 4 Mar 2026 14:22:49 +0100 (CET)","from killaraus.ideasonboard.com\n\t(99-163-62-37.mobileinternet.proximus.be [37.62.163.99])\n\tby perceval.ideasonboard.com (Postfix) with UTF8SMTPSA id E2F94838;\n\tWed, 4 Mar 2026 14:21:46 +0100 (CET)"],"Authentication-Results":"lancelot.ideasonboard.com; dkim=pass (1024-bit key;\n\tunprotected) header.d=ideasonboard.com header.i=@ideasonboard.com\n\theader.b=\"eqWzmIt1\"; dkim-atps=neutral","DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1772630507;\n\tbh=4MXZvbMsL/d3jUd+c7WglhFw0sguUghVJ0I1lRlB17E=;\n\th=Date:From:To:Cc:Subject:References:In-Reply-To:From;\n\tb=eqWzmIt1j/4XF2PHoHqVzHu0/CAlKC/P+Tjuor55KDV3MUESp5BHa0OvRJVGjJfR+\n\tPmAJLE5YOUcxAPlR1tlLKdTzIBGiE0zmiSwZHdfx2fxt+HW8ZT5gccpCws4wPPCD6Q\n\tqGU2sUHCjzd3zYyR3uRhOMWcHljgz6Q0zD+uVWnc=","Date":"Wed, 4 Mar 2026 14:22:48 +0100","From":"Laurent Pinchart ","To":"Kieran Bingham ","Cc":"libcamera-devel@lists.libcamera.org","Subject":"Re: [PATCH v3] utils: Introduce libcamera-bug-report","Message-ID":"<20260304132248.GG3891530@killaraus.ideasonboard.com>","References":"<20260218-kbingham-bug-reporter-v3-1-55484362bcc0@ideasonboard.com>\n\t<177262662897.1693075.14289799160566056581@ping.linuxembedded.co.uk>","MIME-Version":"1.0","Content-Type":"text/plain; charset=utf-8","Content-Disposition":"inline","In-Reply-To":"<177262662897.1693075.14289799160566056581@ping.linuxembedded.co.uk>","X-BeenThere":"libcamera-devel@lists.libcamera.org","X-Mailman-Version":"2.1.29","Precedence":"list","List-Id":"","List-Unsubscribe":",\n\t","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n\t","Errors-To":"libcamera-devel-bounces@lists.libcamera.org","Sender":"\"libcamera-devel\" "}}]