Show a cover letter.

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

{
    "id": 653,
    "url": "https://patchwork.libcamera.org/api/1.1/covers/653/?format=api",
    "web_url": "https://patchwork.libcamera.org/cover/653/",
    "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": "<20190228162913.6508-1-laurent.pinchart@ideasonboard.com>",
    "date": "2019-02-28T16:29:03",
    "name": "[libcamera-devel,00/10] Rework request completion handling",
    "submitter": {
        "id": 2,
        "url": "https://patchwork.libcamera.org/api/1.1/people/2/?format=api",
        "name": "Laurent Pinchart",
        "email": "laurent.pinchart@ideasonboard.com"
    },
    "mbox": "https://patchwork.libcamera.org/cover/653/mbox/",
    "series": [
        {
            "id": 196,
            "url": "https://patchwork.libcamera.org/api/1.1/series/196/?format=api",
            "web_url": "https://patchwork.libcamera.org/project/libcamera/list/?series=196",
            "date": "2019-02-28T16:29:03",
            "name": "Rework request completion handling",
            "version": 1,
            "mbox": "https://patchwork.libcamera.org/series/196/mbox/"
        }
    ],
    "comments": "https://patchwork.libcamera.org/api/covers/653/comments/",
    "headers": {
        "Return-Path": "<laurent.pinchart@ideasonboard.com>",
        "Received": [
            "from perceval.ideasonboard.com (perceval.ideasonboard.com\n\t[213.167.242.64])\n\tby lancelot.ideasonboard.com (Postfix) with ESMTPS id DBD3F610B6\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 28 Feb 2019 17:29:24 +0100 (CET)",
            "from pendragon.bb.dnainternet.fi (81-175-216-236.bb.dnainternet.fi\n\t[81.175.216.236])\n\tby perceval.ideasonboard.com (Postfix) with ESMTPSA id 5AE1A49\n\tfor <libcamera-devel@lists.libcamera.org>;\n\tThu, 28 Feb 2019 17:29:24 +0100 (CET)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/simple; d=ideasonboard.com;\n\ts=mail; t=1551371364;\n\tbh=AMfALyUqK9uDDBKHwqYdYp8mvRrOGhtSgDsuClHl3AA=;\n\th=From:To:Subject:Date:From;\n\tb=TQTLQxge9AlgTc0JkLH1fCFG/OhxE5Ktb3IFKo+Hn7SEvw0LAtQOGbteLBtNergjw\n\tcMBclYhBsTTqzrMSWC5zYoltH/m4WSBWDYiMReKjM0nVbHoSbMTqDUkQM0/sA1C4JN\n\tsYS0u6aYL92uHFWwLOcmNOwnSAnC5L8NZ6ZjhIzM=",
        "From": "Laurent Pinchart <laurent.pinchart@ideasonboard.com>",
        "To": "libcamera-devel@lists.libcamera.org",
        "Date": "Thu, 28 Feb 2019 18:29:03 +0200",
        "Message-Id": "<20190228162913.6508-1-laurent.pinchart@ideasonboard.com>",
        "X-Mailer": "git-send-email 2.19.2",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[libcamera-devel] [PATCH 00/10] Rework request completion handling",
        "X-BeenThere": "libcamera-devel@lists.libcamera.org",
        "X-Mailman-Version": "2.1.23",
        "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, 28 Feb 2019 16:29:25 -0000"
    },
    "content": "Hello,\n\nThis patch series reworks request completion handling to make it\nexplicitly handled by pipeline handlers. The main reason for this is to\nguarantee that requests will complete in the order they're queued, while\ngiving an option to pipeline handlers to delay request completion until\nall metadata is available.\n\nPatch 01/10 fixes a double release of media devices in pipeline\nhandlers. Patches 02/10 to 06/10 make pipeline-specific camera data\nmandatory in pipeline handlers in order to simplify the API and store\nmore information in the base CameraData class. Patches 07/10 and 08/10\nthen add buffer and request completion status support, and patch 09/10\nperforms the bulk of the request completion handling rework. Finally\npatch 10/10 prevents requeuing requests when the stream stops in the cam\napplication.\n\nThis series fixes leak of allocated requests that are not freed at\nstream stop time, leaving only two memory leaks in the cam application\nthat are due to libudev.\n\nLaurent Pinchart (10):\n  libcamera: pipeline: Fix double release of media devices\n  libcamera: pipeline: uvcvideo: Create UVCCameraData\n  libcamera: pipeline: vimc: Create VimcCameraData\n  libcamera: pipeline_handler: Pass a non-const Camera to methods\n  libcamera: pipeline_handler: Store pipe and camera in CameraData\n  libcamera: pipeline_handler: Make pipeline-specific data mandatory\n  libcamera: buffer: Add buffer completion status\n  libcamera: request: Add request completion status\n  libcamera: Handle request completion explicitly in pipeline handlers\n  cam: Don't requeue requests when stopping stream\n\n include/libcamera/buffer.h               |  15 +-\n include/libcamera/camera.h               |   3 +\n include/libcamera/request.h              |  16 ++-\n src/cam/main.cpp                         |   3 +\n src/libcamera/buffer.cpp                 |  40 +++++-\n src/libcamera/camera.cpp                 |  21 +++\n src/libcamera/include/pipeline_handler.h |  25 +++-\n src/libcamera/pipeline/ipu3/ipu3.cpp     |  70 +++++----\n src/libcamera/pipeline/uvcvideo.cpp      | 105 ++++++++++----\n src/libcamera/pipeline/vimc.cpp          | 102 ++++++++++----\n src/libcamera/pipeline_handler.cpp       | 172 ++++++++++++++++++-----\n src/libcamera/request.cpp                |  66 ++++++---\n src/libcamera/v4l2_device.cpp            |   5 +-\n 13 files changed, 483 insertions(+), 160 deletions(-)"
}