Show a patch.

GET /api/1.1/patches/15300/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 15300,
    "url": "https://patchwork.libcamera.org/api/1.1/patches/15300/?format=api",
    "web_url": "https://patchwork.libcamera.org/patch/15300/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/1.1/projects/1/?format=api",
        "name": "libcamera",
        "link_name": "libcamera",
        "list_id": "libcamera_core",
        "list_email": "libcamera-devel@lists.libcamera.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": ""
    },
    "msgid": "<20220130235821.48076-4-djrscally@gmail.com>",
    "date": "2022-01-30T23:58:18",
    "name": "[libcamera-devel,v2,3/6] media: docs: Add entries documenting ancillary links",
    "commit_ref": null,
    "pull_url": null,
    "state": "not-applicable",
    "archived": false,
    "hash": "2c43bea7c91d7e5cf383bcdc5dab434330cdafd6",
    "submitter": {
        "id": 90,
        "url": "https://patchwork.libcamera.org/api/1.1/people/90/?format=api",
        "name": "Daniel Scally",
        "email": "djrscally@gmail.com"
    },
    "delegate": null,
    "mbox": "https://patchwork.libcamera.org/patch/15300/mbox/",
    "series": [
        {
            "id": 2904,
            "url": "https://patchwork.libcamera.org/api/1.1/series/2904/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=2904",
            "date": "2022-01-30T23:58:15",
            "name": "Introduce ancillary links",
            "version": 2,
            "mbox": "https://patchwork.libcamera.org/series/2904/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/patches/15300/comments/",
    "check": "pending",
    "checks": "https://patchwork.libcamera.org/api/patches/15300/checks/",
    "tags": {},
    "headers": {
        "Return-Path": "<libcamera-devel-bounces@lists.libcamera.org>",
        "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 18780BDCBF\n\tfor <parsemail@patchwork.libcamera.org>;\n\tSun, 30 Jan 2022 23:59:13 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id F2D63609EA;\n\tMon, 31 Jan 2022 00:59:11 +0100 (CET)",
            "from mail-wm1-x333.google.com (mail-wm1-x333.google.com\n\t[IPv6:2a00:1450:4864:20::333])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id 0F85B60986\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tMon, 31 Jan 2022 00:59:09 +0100 (CET)",
            "by mail-wm1-x333.google.com with SMTP id\n\tj5-20020a05600c1c0500b0034d2e956aadso8190591wms.4\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tSun, 30 Jan 2022 15:59:09 -0800 (PST)",
            "from localhost.localdomain\n\t(cpc141996-chfd3-2-0-cust928.12-3.cable.virginm.net. [86.13.91.161])\n\tby smtp.gmail.com with ESMTPSA id\n\t11sm11993663wrb.30.2022.01.30.15.59.08\n\t(version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n\tSun, 30 Jan 2022 15:59:08 -0800 (PST)"
        ],
        "Authentication-Results": "lancelot.ideasonboard.com;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tunprotected) header.d=gmail.com header.i=@gmail.com\n\theader.b=\"GSmf0mux\"; dkim-atps=neutral",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references\n\t:mime-version:content-transfer-encoding;\n\tbh=3jJ0g27dpE1FUu3MPy8YxNnCH8nvgWy6GR4rkrcef5o=;\n\tb=GSmf0muxy9deZ2hL+lVMfPRZ9wWaJDwAM7NcmHet2TImu1Y0ImdwB2qX6il+G6+C0c\n\tPpRMV1do1RnOhkTF3hrOv9nIButtvsI8m1zzvHOV7RBrF82gobVzP54IJZhozx+jicfn\n\thI0TBoNdxjGJJqwWXaXzcfQqDgtCprqNho6Ji5tq5os2OSnuJRN8L0Uwfmcz3L6c5Ual\n\t5xZiRSTt5N2tY70ns5rHK2rfWUPusuQQZsV6di6c2gsx+gd9k6w0hfALtw+VshGFm4NJ\n\tKixHFg5VUCGrHDO9nAClNuLrjzvkVlCxJPhBcimYS8i6FT6ZCSHghFWMtw9hMBrbEGlO\n\tayEQ==",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20210112;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references:mime-version:content-transfer-encoding;\n\tbh=3jJ0g27dpE1FUu3MPy8YxNnCH8nvgWy6GR4rkrcef5o=;\n\tb=rzq50ih+KYutwnuLrvfQNDKnA0ZPqF74xxnP1uIFQCqCHJlMWMQKf6pfD6Lom/PR5l\n\tXV2OV4/qW/3+QhH58DKl7x0d1H/dx5mYkVVhdnACnSU3hSdKs6cdrvg2iXss4VqHJL4x\n\toj6e6TMSDoGnX10jH8ILaFSj9xSQzGFb6QuFY5AxvjnMwO8ypcaeahxTZXi6s314EeW4\n\t/saf+NqUfFgAzHsuHM09GXXaZyb4oKAn2jkXhIPMOyQjOqlk4NLnO4v/ddr6foy//OgV\n\tsYVu4CsJV6krSM4sCSn3V8nHb97/QiPAN2a1qz6myLDYAin/ZwGolZsdzQVADPwKfU+E\n\tiw/A==",
        "X-Gm-Message-State": "AOAM531FbDcpCp6eWZLjb0C6/wmIbg5Z0lWH5mLBarctIglcGR92/BBA\n\tWsu5HiI5wK8vpN64hQ+u21I=",
        "X-Google-Smtp-Source": "ABdhPJzSV5eAjHoUiE6Tb04AF1J4I8wvc/pfMPqepm8Ru1a3nU6DkeuKalY3PAG2cPf8E1daEETexA==",
        "X-Received": "by 2002:a7b:cbda:: with SMTP id\n\tn26mr25225403wmi.76.1643587148829; \n\tSun, 30 Jan 2022 15:59:08 -0800 (PST)",
        "From": "Daniel Scally <djrscally@gmail.com>",
        "To": "linux-media@vger.kernel.org,\n\tlibcamera-devel@lists.libcamera.org",
        "Date": "Sun, 30 Jan 2022 23:58:18 +0000",
        "Message-Id": "<20220130235821.48076-4-djrscally@gmail.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20220130235821.48076-1-djrscally@gmail.com>",
        "References": "<20220130235821.48076-1-djrscally@gmail.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH v2 3/6] media: docs: Add entries\n\tdocumenting ancillary links",
        "X-BeenThere": "libcamera-devel@lists.libcamera.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "<libcamera-devel.lists.libcamera.org>",
        "List-Unsubscribe": "<https://lists.libcamera.org/options/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=unsubscribe>",
        "List-Archive": "<https://lists.libcamera.org/pipermail/libcamera-devel/>",
        "List-Post": "<mailto:libcamera-devel@lists.libcamera.org>",
        "List-Help": "<mailto:libcamera-devel-request@lists.libcamera.org?subject=help>",
        "List-Subscribe": "<https://lists.libcamera.org/listinfo/libcamera-devel>,\n\t<mailto:libcamera-devel-request@lists.libcamera.org?subject=subscribe>",
        "Cc": "sakari.ailus@linux.intel.com",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "Add some elements to the uAPI documentation to explain the new link\ntype, their purpose and some aspects of their current implementation.\n\nSigned-off-by: Daniel Scally <djrscally@gmail.com>\n---\nChanges since v1:\n\n\t- New patch\n\n .../media/mediactl/media-controller-model.rst            | 6 ++++++\n .../userspace-api/media/mediactl/media-types.rst         | 9 ++++++++-\n 2 files changed, 14 insertions(+), 1 deletion(-)",
    "diff": "diff --git a/Documentation/userspace-api/media/mediactl/media-controller-model.rst b/Documentation/userspace-api/media/mediactl/media-controller-model.rst\nindex 222cb99debb5..f77cb9d952e5 100644\n--- a/Documentation/userspace-api/media/mediactl/media-controller-model.rst\n+++ b/Documentation/userspace-api/media/mediactl/media-controller-model.rst\n@@ -33,3 +33,9 @@ are:\n \n -  An **interface link** is a point-to-point bidirectional control\n    connection between a Linux Kernel interface and an entity.\n+\n+- An **ancillary link** is a point-to-point connection describing a physical\n+  relationship between two entities. For example this could represent the\n+  fact that a particular camera sensor and lens controller form a single\n+  physical module, meaning this lens controller drives the lens for this\n+  camera sensor.\n\\ No newline at end of file\ndiff --git a/Documentation/userspace-api/media/mediactl/media-types.rst b/Documentation/userspace-api/media/mediactl/media-types.rst\nindex 0a26397bd01d..d69bae359e5b 100644\n--- a/Documentation/userspace-api/media/mediactl/media-types.rst\n+++ b/Documentation/userspace-api/media/mediactl/media-types.rst\n@@ -413,7 +413,7 @@ must be set for every pad.\n \n     *  -  ``MEDIA_LNK_FL_LINK_TYPE``\n        -  This is a bitmask that defines the type of the link. Currently,\n-\t  two types of links are supported:\n+\t  three types of links are supported:\n \n \t  .. _MEDIA-LNK-FL-DATA-LINK:\n \n@@ -423,3 +423,10 @@ must be set for every pad.\n \n \t  ``MEDIA_LNK_FL_INTERFACE_LINK`` if the link is between an\n \t  interface and an entity\n+\n+\t  .. _MEDIA-LNK-FL-ANCILLARY-LINK:\n+\n+\t  ``MEDIA_LNK_FL_ANCILLARY_LINK`` if the link is between two\n+\t  different entities. This at present implies both MEDIA_LNK_FL_ENABLED\n+\t  and MEDIA_LNK_FL_IMMUTABLE, however applications should not rely on\n+\t  that being the case in the future.\n",
    "prefixes": [
        "libcamera-devel",
        "v2",
        "3/6"
    ]
}