Show a cover letter.

GET /api/covers/3694/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 3694,
    "url": "https://patchwork.libcamera.org/api/covers/3694/?format=api",
    "web_url": "https://patchwork.libcamera.org/cover/3694/",
    "project": {
        "id": 1,
        "url": "https://patchwork.libcamera.org/api/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": "<20200507143537.2945672-1-jacopo@jmondi.org>",
    "date": "2020-05-07T14:35:31",
    "name": "[libcamera-devel,v6,0/6] media: Register read-only sub-dev devnode",
    "submitter": {
        "id": 3,
        "url": "https://patchwork.libcamera.org/api/people/3/?format=api",
        "name": "Jacopo Mondi",
        "email": "jacopo@jmondi.org"
    },
    "mbox": "https://patchwork.libcamera.org/cover/3694/mbox/",
    "series": [
        {
            "id": 883,
            "url": "https://patchwork.libcamera.org/api/series/883/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=883",
            "date": "2020-05-07T14:35:31",
            "name": "media: Register read-only sub-dev devnode",
            "version": 6,
            "mbox": "https://patchwork.libcamera.org/series/883/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/covers/3694/comments/",
    "headers": {
        "Return-Path": "<jacopo@jmondi.org>",
        "Received": [
            "from relay12.mail.gandi.net (relay12.mail.gandi.net\n\t[217.70.178.232])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id A4C93603EA\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu,  7 May 2020 16:32:39 +0200 (CEST)",
            "from localhost.localdomain (2-224-242-101.ip172.fastwebnet.it\n\t[2.224.242.101]) (Authenticated sender: jacopo@jmondi.org)\n\tby relay12.mail.gandi.net (Postfix) with ESMTPSA id 7D16E200007;\n\tThu,  7 May 2020 14:32:36 +0000 (UTC)"
        ],
        "From": "Jacopo Mondi <jacopo@jmondi.org>",
        "To": "linux-media@vger.kernel.org,\n\tlibcamera-devel@lists.libcamera.org",
        "Cc": "Jacopo Mondi <jacopo@jmondi.org>, mchehab@kernel.org,\n\thverkuil-cisco@xs4all.nl, sakari.ailus@linux.intel.com,\n\tandrey.konovalov@linaro.org, laurent.pinchart@ideasonboard.com",
        "Date": "Thu,  7 May 2020 16:35:31 +0200",
        "Message-Id": "<20200507143537.2945672-1-jacopo@jmondi.org>",
        "X-Mailer": "git-send-email 2.26.1",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH v6 0/6] media: Register read-only sub-dev\n\tdevnode",
        "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>",
        "X-List-Received-Date": "Thu, 07 May 2020 14:32:39 -0000"
    },
    "content": "Hello,\n  this new v6 addresses the last two concerns on the series\n1) Versioning of the new VIDIOC_SUBDEV_QUERYCAP IOCTL is done by adding\n   a reserved field\n2) Renamed the struct v4l2_subdev_capabilities.subdev_cap field to\n   struct v4l2_subdev_capabilities.capabilities\n3) Replace v5 [4/6] with a new\n   \"media: v4l2-subdev: Guard whole fops and ioctl hdlr\" which was\n   sent as 5.1 RFC and there return -ENODEV in stub function as suggested\n   by Sakari.\n\nSeries based on latest media tree master.\n\nApplies cleanly on Hans' br-v5.8g (I was afraid of documentation clashes, seems\nthere are none).\n\nThanks\n   j\n\nv5.1->v6:\n- Add __u32 reserved[14] field to struct v4l2_subdev_capabilities\n- s/v4l2_subdev_capabilities.subdev_cap/v4l2_subdev_capabilities.capabilities\n- Update documentation accordingly\n\nv5->v5.1:\n- Replace\n  \"media: v4l2-subdev: Assume V4L2_SUBDEV_API is selected\"\n  with\n  \"media: v4l2-subdev: Guard whole fops and ioctl hdlr\"\n\nv4->v5:\n- Add \"media: v4l2-subdev: Assume V4L2_SUBDEV_API is selected\"\n- Use BIT() instead of manual bitshifting\n- Use tabs in documentation in place of 8 spaces\n- minor documentation fixes\n\nv3->v4:\n- Rebase v3 on latest media master and new documentation layout\n- Add SUBDEV_QUERYCAP support\n\nv2->v3:\n- Add Sakari's ack to the series\n- Documentation:\n  - Address Sakari' and Hans suggestions\n- Implementation:\n  - Rename V4L2_FL_RO_DEVNODE to V4L2_FL_SUBDEV_RO_DEVNODE\n  - Limit the ability to register sub-device video device nodes to\n    driver claiming support for CONFIG_VIDEO_V4L2_SUBDEV_API\n\nv1->v2:\n- Documentation:\n  - Add a new patch using Laurent's suggestion to update the sub-device\n    userspace API introduction\n  - Take in some of Laurent's suggestions in v4l2-subdev.rst and add a new\n    section in dev-subdev.rst\n- Implementation:\n  - As noted by Andrey, V4L2_FL_* are meant to be used as bitmasks. Use\n    test_bit()/set_bit() as the rest of the v4l2 core does. It's a bit an\n    overkill compared to use plain BIT() as noted by Sakari but I preferred\n    consistency with the rest of the core\n  - Make v4l2_device_register_subdev_nodes() and\n    v4l2_device_register_ro_subdev_nodes() to v4l2-device.h and make them\n    inline functions. Documentation style has been copied from other functions\n    with similar implementations, such as __video_register_device() in\n    v4l2-dev.h\n\n\nHans Verkuil (2):\n  v4l2-subdev: add VIDIOC_SUBDEV_QUERYCAP ioctl\n  v4l: document VIDIOC_SUBDEV_QUERYCAP\n\nJacopo Mondi (4):\n  Documentation: media: Update sub-device API intro\n  Documentation: media: Document read-only subdevice\n  media: v4l2-dev: Add v4l2_device_register_ro_subdev_node()\n  media: v4l2-subdev: Guard whole fops and ioctl hdlr\n\n .../driver-api/media/v4l2-subdev.rst          |  53 +++++++-\n .../userspace-api/media/v4l/dev-subdev.rst    |   5 +\n .../userspace-api/media/v4l/user-func.rst     |   1 +\n .../media/v4l/vidioc-g-dv-timings.rst         |   6 +\n .../userspace-api/media/v4l/vidioc-g-std.rst  |   6 +\n .../media/v4l/vidioc-subdev-g-crop.rst        |   9 ++\n .../media/v4l/vidioc-subdev-g-fmt.rst         |   8 ++\n .../v4l/vidioc-subdev-g-frame-interval.rst    |   8 ++\n .../media/v4l/vidioc-subdev-g-selection.rst   |   8 ++\n .../media/v4l/vidioc-subdev-querycap.rst      | 117 ++++++++++++++++++\n drivers/media/v4l2-core/v4l2-device.c         |   7 +-\n drivers/media/v4l2-core/v4l2-subdev.c         |  70 +++++++++--\n include/media/v4l2-dev.h                      |   7 ++\n include/media/v4l2-device.h                   |  50 +++++++-\n include/uapi/linux/v4l2-subdev.h              |  18 +++\n 15 files changed, 357 insertions(+), 16 deletions(-)\n create mode 100644 Documentation/userspace-api/media/v4l/vidioc-subdev-querycap.rst\n\n--\n2.26.1"
}