Show a cover letter.

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

{
    "id": 16684,
    "url": "https://patchwork.libcamera.org/api/covers/16684/?format=api",
    "web_url": "https://patchwork.libcamera.org/cover/16684/",
    "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": "<20220719103144.3686313-1-kieran.bingham@ideasonboard.com>",
    "date": "2022-07-19T10:31:42",
    "name": "[libcamera-devel,0/2] request: Support non fatal errors",
    "submitter": {
        "id": 4,
        "url": "https://patchwork.libcamera.org/api/people/4/?format=api",
        "name": "Kieran Bingham",
        "email": "kieran.bingham@ideasonboard.com"
    },
    "mbox": "https://patchwork.libcamera.org/cover/16684/mbox/",
    "series": [
        {
            "id": 3299,
            "url": "https://patchwork.libcamera.org/api/series/3299/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=3299",
            "date": "2022-07-19T10:31:42",
            "name": "request: Support non fatal errors",
            "version": 1,
            "mbox": "https://patchwork.libcamera.org/series/3299/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/covers/16684/comments/",
    "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 29F40BE173\n\tfor <parsemail@patchwork.libcamera.org>;\n\tTue, 19 Jul 2022 10:31:50 +0000 (UTC)",
            "from lancelot.ideasonboard.com (localhost [IPv6:::1])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTP id 4D69A63314;\n\tTue, 19 Jul 2022 12:31:49 +0200 (CEST)",
            "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 5BD3160489\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tTue, 19 Jul 2022 12:31:48 +0200 (CEST)",
            "from Monstersaurus.local\n\t(cpc89244-aztw30-2-0-cust3082.18-1.cable.virginm.net [86.31.172.11])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id CA8236EE;\n\tTue, 19 Jul 2022 12:31:47 +0200 (CEST)"
        ],
        "DKIM-Signature": [
            "v=1; a=rsa-sha256; c=relaxed/simple; d=libcamera.org;\n\ts=mail; t=1658226709;\n\tbh=Yev8h52PoyJAFTOqRg9EhppuA3ADetNeDg+IS862x8c=;\n\th=To:Date:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post:\n\tList-Help:List-Subscribe:From:Reply-To:From;\n\tb=q2UBsKFtKViAiLrR+bRawE3L09tAh5pe4YWQtoGH+ATlXnOyfRpWyOq9PLn5lLs1i\n\tSkcJ6gGUT1ny0sp3xfO0JbF336CacBMMkofcd15DQzwySAEw6IaaiGzSmPYlFho6MZ\n\txSUOX29Ad0whmkfmP35TJHnfy5dJgRvq7dtIHme957wSqHpsjlJNf/+Dys1l3wNqY+\n\t82Pu8eIuifHOfcaUmp/HNUepeUjfDaisLqZCkurJsl+3Cpjbwbr3QorBMILNU1dqAs\n\tv3vft66UBlo1bSIdAnHuxK3o5t4LduzUkpSeIiHMGnLBFgpqrmP0FaKLBLY34GPcoF\n\tP5AYbhyHIIUmg==",
            "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1658226707;\n\tbh=Yev8h52PoyJAFTOqRg9EhppuA3ADetNeDg+IS862x8c=;\n\th=From:To:Cc:Subject:Date:From;\n\tb=vNWWb0tXZPjKMI5DPqZjv4aV4Jjcj+tW/ebxhJFZgpKIKKX6DH7N2P8enrZoa0J/3\n\tTL5zt1EjI9QCimY71G781h7rOySfV+otgnSaqdHDbgudj62VxVKQemkdvxq8ZGKqKt\n\tWLihfuo1TRJSJfKH+yuBZKR8sSdW7lceLp6IAUtQ="
        ],
        "Authentication-Results": "lancelot.ideasonboard.com; dkim=pass (1024-bit key; \n\tunprotected) header.d=ideasonboard.com\n\theader.i=@ideasonboard.com\n\theader.b=\"vNWWb0tX\"; dkim-atps=neutral",
        "To": "libcamera devel <libcamera-devel@lists.libcamera.org>",
        "Date": "Tue, 19 Jul 2022 11:31:42 +0100",
        "Message-Id": "<20220719103144.3686313-1-kieran.bingham@ideasonboard.com>",
        "X-Mailer": "git-send-email 2.34.1",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH 0/2] request: Support non fatal errors",
        "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>",
        "From": "Kieran Bingham via libcamera-devel\n\t<libcamera-devel@lists.libcamera.org>",
        "Reply-To": "Kieran Bingham <kieran.bingham@ideasonboard.com>",
        "Errors-To": "libcamera-devel-bounces@lists.libcamera.org",
        "Sender": "\"libcamera-devel\" <libcamera-devel-bounces@lists.libcamera.org>"
    },
    "content": "Requests may have internal processing errors that don't prevent an image from\nbeing captured, but may for instance prevent setting controls or other minor\nerrors that we can report to the application.\n\nThese non-fatal errors should not cause the Request to be cancelled, as this is\ncurrently used specifically to prevent reqeusts from being requeued.\n\nCancelling otherwise re-usable requests can therefore lead rapidly to a resource\nstarvation where the application believes it is shutting down when the pipeline\nis still operating.\n\nWhilst this definition of Request completion status needs further\nclarification, introduce the ability to set an error flag on a request and use\nit to set a ControlError when the UVC pipeline handler fails to set a control.\n\nThis can happen already for instance if an incorrect exposure control is applied\nto the camera in the Request.\n\nKieran Bingham (1):\n  libcamera: pipeline: uvcvideo: Report control errors\n\nPaul Elder (1):\n  libcamera: request: Add support for error flags\n\n include/libcamera/internal/request.h         |  3 ++\n include/libcamera/request.h                  |  9 +++++\n src/libcamera/pipeline/uvcvideo/uvcvideo.cpp |  7 ++--\n src/libcamera/request.cpp                    | 36 ++++++++++++++++++++\n 4 files changed, 53 insertions(+), 2 deletions(-)"
}