From patchwork Wed Jan 14 05:29:14 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Kieran Bingham X-Patchwork-Id: 25764 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 61C91BE08B for ; Wed, 14 Jan 2026 05:29:22 +0000 (UTC) Received: from lancelot.ideasonboard.com (localhost [IPv6:::1]) by lancelot.ideasonboard.com (Postfix) with ESMTP id 95B7D61FC3; Wed, 14 Jan 2026 06:29:21 +0100 (CET) Authentication-Results: lancelot.ideasonboard.com; dkim=pass (1024-bit key; unprotected) header.d=ideasonboard.com header.i=@ideasonboard.com header.b="NurtobDn"; dkim-atps=neutral Received: from perceval.ideasonboard.com (perceval.ideasonboard.com [213.167.242.64]) by lancelot.ideasonboard.com (Postfix) with ESMTPS id A4B586142F for ; Wed, 14 Jan 2026 06:29:19 +0100 (CET) Received: from charm.hippo-penny.ts.net (cpc89244-aztw30-2-0-cust6594.18-1.cable.virginm.net [86.31.185.195]) by perceval.ideasonboard.com (Postfix) with ESMTPSA id CD72D4BB; Wed, 14 Jan 2026 06:28:52 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com; s=mail; t=1768368532; bh=jSlOl+wTaC1ujLYdSdE4sIBDHCILFDRHAqcTgZFotQ4=; h=From:To:Cc:Subject:Date:From; b=NurtobDn+8sDFpfLhnXBEQCiySW3wjtMzCz1oasWtorzX5bk8m1W+kM6TFoAC2HFj EDL3TFsTFre6oCZ6AWgbOHMQYffg8QD9Fpw5DI2VzSqY1/E1RsFYvZVE1ZpADFbVnZ svb4Pb+/ukBL/vs1DXeXmhSU7Qn9CpBbRk5VsZYY= From: Kieran Bingham To: libcamera devel Cc: Kieran Bingham Subject: [PATCH] libcamera: Provide an ABI compatibility record Date: Wed, 14 Jan 2026 05:29:14 +0000 Message-ID: <20260114052914.26432-1-kieran.bingham@ideasonboard.com> X-Mailer: git-send-email 2.52.0 MIME-Version: 1.0 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" Changes between releases may require updates to user applications and ABI changes will require a recompilation of applications. Track changes which have an impact on the ABI or API to support users migrating to a newer release. Signed-off-by: Kieran Bingham --- ABI | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 ABI diff --git a/ABI b/ABI new file mode 100644 index 000000000000..f2772402225f --- /dev/null +++ b/ABI @@ -0,0 +1,50 @@ +# ABI/API Compatibility log + +This file reports on ABI and API changes which occur between releases. + +The ABI can be checked and verified with the abi-checker tool. To report on the +ABI and API compatibility of your local tree against the latest release, simply +run: + + ./utils/abi-compat.sh + +To check the API and ABI compatibility of a single commit specify the previous +commit as the start point: + + ./utils/abi-compat.sh $COMMIT^ $COMMIT + +## v0.7 + +Commit: b7ed763f0dfb ("libcamera: request: Make controls_ a class instance") + struct Request + - Size of this type has been changed from 80 bytes to 152 bytes. + The fields or parameters of such data type may be incorrectly initialized or + accessed by old client applications. + + - Type of field controls_ has been changed from struct ControlList* (8 bytes) + to struct ControlList (80 bytes). + Size of the inclusive type has been changed. + + Impact: + + The Request->controls() now has the ControlList allocated directly inside the + Request object. There is no API impact, but the change to the size and + offsets of the Request object is an ABI breakage and requires re-compilation + of users. + + +Commit: dce2ef36f2ef ("libcamera: request: Move metadata_ to Private") + struct Request + - Size of this type has been changed from 88 bytes to 80 bytes. + The fields or parameters of such data type may be incorrectly initialized or + accessed by old client applications. + + - Field metadata_ has been removed from this type. + Size of the inclusive type has been changed. + + Impact: + + The Request->metadata() usage now returns a const reference to the underlying + metadata control list. Users can not modify this data. The size and offsets + of the Request object is an ABI breakage and requires re-compilation of users. +