From patchwork Mon Oct 18 04:52:26 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Laurent Pinchart X-Patchwork-Id: 14160 Return-Path: X-Original-To: parsemail@patchwork.libcamera.org Delivered-To: parsemail@patchwork.libcamera.org Received: from lancelot.ideasonboard.com (lancelot.ideasonboard.com [92.243.16.209]) by patchwork.libcamera.org (Postfix) with ESMTPS id 7516AC323E for ; Mon, 18 Oct 2021 04:52:48 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id B565568F59; Mon, 18 Oct 2021 06:52:47 +0200 (CEST) Authentication-Results: lancelot.ideasonboard.com; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="GsXF/21a"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id EFCD960128 for ; Mon, 18 Oct 2021 06:52:46 +0200 (CEST) Received: from pendragon.lan (62-78-145-57.bb.dnainternet.fi [62.78.145.57]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id 709B712A for ; Mon, 18 Oct 2021 06:52:46 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1634532766; bh=5B4cDqXkvyq5jR0D4YTuMf9IyvQfJrtkmoP1WIyvTBs=; h=From:To:Subject:Date:From; b=GsXF/21alz+yAVJajvdp4mVsUcrp9NWhQdvS0vWapWCBlWjddu/xpLm4u+p7+C9oj PH6iL2+GaalZTaBhJTtnuo11Pb1iQ2mFR2Ftie++B6oua57PDnstkZl4oawJmG0tYb JfBUXDFAwM7wQ0zZRE/ACMvM+NEDCxG3gAJXql84= From: Laurent Pinchart To: libcamera-devel@lists.libcamera.org Date: Mon, 18 Oct 2021 07:52:26 +0300 Message-Id: <20211018045226.6759-1-laurent.pinchart@ideasonboard.com> X-Mailer: git-send-email 2.32.0 MIME-Version: 1.0 Subject: [libcamera-devel] [PATCH] README: Document dependencies for backtrace generation X-BeenThere: libcamera-devel@lists.libcamera.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libcamera-devel-bounces@lists.libcamera.org Sender: "libcamera-devel" libcamera now has the ability to use libdw and libunwind to generate backtraces, in addition to the glibc backtrace() function. libdw provides the most detailed output and is highly recommended, but is limited to parsing backtraces, it doesn't support capturing them. libunwind and backtrace() provide both features. If backtrace() is available, libunwind will not bring any improvement. Signed-off-by: Laurent Pinchart Reviewed-by: Paul Elder Reviewed-by: Umang Jain --- README.rst | 8 ++++++++ 1 file changed, 8 insertions(+) base-commit: 2f75a7e5b8c6258dc12e9e3128cb30133f66b4f9 prerequisite-patch-id: a2501788e3af4ef5a091e784838d614c59e5d7fc prerequisite-patch-id: 50f1d9ef74d51440b0f79116eb82580ad1fa04a2 prerequisite-patch-id: 6ad689b8c9be17165b330a16c7cef62dbdfb5d8f diff --git a/README.rst b/README.rst index 9ad0823d2038..8af5f1184e5f 100644 --- a/README.rst +++ b/README.rst @@ -63,6 +63,14 @@ for the libcamera core: [required] for IPA module signing: [required] libgnutls28-dev openssl +for improved debugging: [optional] + libdw-dev libunwind-dev + + libdw and libunwind provide backtraces to help debugging assertion + failures. Their functions overlap, libdw provides the most detailed + information, and libunwind is not needed if both libdw and the glibc + backtrace() function are available. + for the Raspberry Pi IPA: [optional] libboost-dev