Show a cover letter.

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

{
    "id": 2218112,
    "url": "http://patchwork.ozlabs.org/api/covers/2218112/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/openvswitch/cover/cover.1774960196.git.tredaelli@redhat.com/",
    "project": {
        "id": 47,
        "url": "http://patchwork.ozlabs.org/api/projects/47/?format=api",
        "name": "Open vSwitch",
        "link_name": "openvswitch",
        "list_id": "ovs-dev.openvswitch.org",
        "list_email": "ovs-dev@openvswitch.org",
        "web_url": "http://openvswitch.org/",
        "scm_url": "git@github.com:openvswitch/ovs.git",
        "webscm_url": "https://github.com/openvswitch/ovs",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<cover.1774960196.git.tredaelli@redhat.com>",
    "list_archive_url": null,
    "date": "2026-03-31T12:34:20",
    "name": "[ovs-dev,v2,0/5] Add systemd socket activation for ovsdb-server",
    "submitter": {
        "id": 70949,
        "url": "http://patchwork.ozlabs.org/api/people/70949/?format=api",
        "name": "Timothy Redaelli",
        "email": "tredaelli@redhat.com"
    },
    "mbox": "http://patchwork.ozlabs.org/project/openvswitch/cover/cover.1774960196.git.tredaelli@redhat.com/mbox/",
    "series": [
        {
            "id": 498188,
            "url": "http://patchwork.ozlabs.org/api/series/498188/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/openvswitch/list/?series=498188",
            "date": "2026-03-31T12:34:22",
            "name": "Add systemd socket activation for ovsdb-server",
            "version": 2,
            "mbox": "http://patchwork.ozlabs.org/series/498188/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/covers/2218112/comments/",
    "headers": {
        "Return-Path": "<ovs-dev-bounces@openvswitch.org>",
        "X-Original-To": [
            "incoming@patchwork.ozlabs.org",
            "dev@openvswitch.org"
        ],
        "Delivered-To": [
            "patchwork-incoming@legolas.ozlabs.org",
            "ovs-dev@lists.linuxfoundation.org"
        ],
        "Authentication-Results": [
            "legolas.ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=bvA2SuAn;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=openvswitch.org\n (client-ip=2605:bc80:3010::137; helo=smtp4.osuosl.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=patchwork.ozlabs.org)",
            "smtp4.osuosl.org;\n\tdkim=fail reason=\"signature verification failed\" (1024-bit key)\n header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=bvA2SuAn",
            "smtp1.osuosl.org; dmarc=pass (p=quarantine dis=none)\n header.from=redhat.com",
            "smtp1.osuosl.org;\n dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com\n header.a=rsa-sha256 header.s=mimecast20190719 header.b=bvA2SuAn"
        ],
        "Received": [
            "from smtp4.osuosl.org (smtp4.osuosl.org [IPv6:2605:bc80:3010::137])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4flSHs543wz1yCp\n\tfor <incoming@patchwork.ozlabs.org>; Tue, 31 Mar 2026 23:35:05 +1100 (AEDT)",
            "from localhost (localhost [127.0.0.1])\n\tby smtp4.osuosl.org (Postfix) with ESMTP id 6BB8F40426;\n\tTue, 31 Mar 2026 12:34:58 +0000 (UTC)",
            "from smtp4.osuosl.org ([127.0.0.1])\n by localhost (smtp4.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id VLo1C7DqCwYg; Tue, 31 Mar 2026 12:34:57 +0000 (UTC)",
            "from lists.linuxfoundation.org (lf-lists.osuosl.org\n [IPv6:2605:bc80:3010:104::8cd3:938])\n\tby smtp4.osuosl.org (Postfix) with ESMTPS id 5E8E5401F7;\n\tTue, 31 Mar 2026 12:34:57 +0000 (UTC)",
            "from lf-lists.osuosl.org (localhost [127.0.0.1])\n\tby lists.linuxfoundation.org (Postfix) with ESMTP id 17F10C054A;\n\tTue, 31 Mar 2026 12:34:57 +0000 (UTC)",
            "from smtp1.osuosl.org (smtp1.osuosl.org [IPv6:2605:bc80:3010::138])\n by lists.linuxfoundation.org (Postfix) with ESMTP id A2AFEC0549\n for <dev@openvswitch.org>; Tue, 31 Mar 2026 12:34:55 +0000 (UTC)",
            "from localhost (localhost [127.0.0.1])\n by smtp1.osuosl.org (Postfix) with ESMTP id 803E3807C2\n for <dev@openvswitch.org>; Tue, 31 Mar 2026 12:34:55 +0000 (UTC)",
            "from smtp1.osuosl.org ([127.0.0.1])\n by localhost (smtp1.osuosl.org [127.0.0.1]) (amavis, port 10024) with ESMTP\n id OTp_YfVGn_HJ for <dev@openvswitch.org>;\n Tue, 31 Mar 2026 12:34:54 +0000 (UTC)",
            "from us-smtp-delivery-124.mimecast.com\n (us-smtp-delivery-124.mimecast.com [170.10.133.124])\n by smtp1.osuosl.org (Postfix) with ESMTPS id 56ECF80786\n for <dev@openvswitch.org>; Tue, 31 Mar 2026 12:34:53 +0000 (UTC)",
            "from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-104-FXmAWcGdP9SIebgTZGbkcg-1; Tue,\n 31 Mar 2026 08:34:51 -0400",
            "from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 54A9418005B4\n for <dev@openvswitch.org>; Tue, 31 Mar 2026 12:34:50 +0000 (UTC)",
            "from aldebaran.char-dominant.ts.net (unknown [10.44.32.65])\n by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id 5DCF019560AB; Tue, 31 Mar 2026 12:34:49 +0000 (UTC)"
        ],
        "X-Virus-Scanned": [
            "amavis at osuosl.org",
            "amavis at osuosl.org"
        ],
        "X-Comment": "SPF check N/A for local connections -\n client-ip=2605:bc80:3010:104::8cd3:938; helo=lists.linuxfoundation.org;\n envelope-from=ovs-dev-bounces@openvswitch.org; receiver=<UNKNOWN> ",
        "DKIM-Filter": [
            "OpenDKIM Filter v2.11.0 smtp4.osuosl.org 5E8E5401F7",
            "OpenDKIM Filter v2.11.0 smtp1.osuosl.org 56ECF80786"
        ],
        "Received-SPF": "Pass (mailfrom) identity=mailfrom; client-ip=170.10.133.124;\n helo=us-smtp-delivery-124.mimecast.com; envelope-from=tredaelli@redhat.com;\n receiver=<UNKNOWN>",
        "DMARC-Filter": "OpenDMARC Filter v1.4.2 smtp1.osuosl.org 56ECF80786",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1774960492;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding;\n bh=wy/uYKuG3N1Qrn1BBDLo6vwO2a6OkjMgVbgUuC0cA3w=;\n b=bvA2SuAnmDzl773qYTPM8lMEY3CKYGrw3AOrMoRxNvwjMOgfq0Z3btQv2XoxOijgaoLb1p\n o9WCqNZJoCtJjWdasKngyAGJUjlGt7s2Jrw2Xro9JXWtuepoJ0ovgdnsSM/Eae3/OknwEM\n W1UrGzn2lTDB0IiOqL54lPBoIItZhw0=",
        "X-MC-Unique": "FXmAWcGdP9SIebgTZGbkcg-1",
        "X-Mimecast-MFC-AGG-ID": "FXmAWcGdP9SIebgTZGbkcg_1774960490",
        "To": "dev@openvswitch.org",
        "Date": "Tue, 31 Mar 2026 14:34:20 +0200",
        "Message-ID": "<cover.1774960196.git.tredaelli@redhat.com>",
        "MIME-Version": "1.0",
        "X-Scanned-By": "MIMEDefang 3.0 on 10.30.177.12",
        "X-Mimecast-Spam-Score": "0",
        "X-Mimecast-MFC-PROC-ID": "N7Y6kAIbSrJLXP4zBfAb0R4GTd1oOhIQTaX9RoPbDN4_1774960490",
        "X-Mimecast-Originator": "redhat.com",
        "Subject": "[ovs-dev] [PATCH v2 0/5] Add systemd socket activation for\n ovsdb-server",
        "X-BeenThere": "ovs-dev@openvswitch.org",
        "X-Mailman-Version": "2.1.30",
        "Precedence": "list",
        "List-Id": "<ovs-dev.openvswitch.org>",
        "List-Unsubscribe": "<https://mail.openvswitch.org/mailman/options/ovs-dev>,\n <mailto:ovs-dev-request@openvswitch.org?subject=unsubscribe>",
        "List-Archive": "<http://mail.openvswitch.org/pipermail/ovs-dev/>",
        "List-Post": "<mailto:ovs-dev@openvswitch.org>",
        "List-Help": "<mailto:ovs-dev-request@openvswitch.org?subject=help>",
        "List-Subscribe": "<https://mail.openvswitch.org/mailman/listinfo/ovs-dev>,\n <mailto:ovs-dev-request@openvswitch.org?subject=subscribe>",
        "From": "Timothy Redaelli via dev <ovs-dev@openvswitch.org>",
        "Reply-To": "Timothy Redaelli <tredaelli@redhat.com>",
        "Content-Type": "text/plain; charset=\"us-ascii\"",
        "Content-Transfer-Encoding": "7bit",
        "Errors-To": "ovs-dev-bounces@openvswitch.org",
        "Sender": "\"dev\" <ovs-dev-bounces@openvswitch.org>"
    },
    "content": "Currently ovsdb-server creates its own Unix domain socket at\n/run/openvswitch/db.sock, and dependent services need explicit\nordering and assertion checks to ensure the socket is available.\n\nThis series transfers socket ownership to systemd, which creates\nthe listening socket before any service starts.  The socket remains\navailable across service restarts, so clients queue instead of\ngetting connection failures.\n\nChanges since v1:\n  - stream: Use str_to_long() instead of strtol(); return EINVAL\n    instead of ERANGE on invalid fd number (Aaron Conole).\n  - ovs-ctl: Also unset LISTEN_PIDFDID when clearing socket\n    activation environment variables (Aaron Conole).\n\nTimothy Redaelli (5):\n  stream: Add \"pfd:\" passive stream for pre-opened file descriptors.\n  ovs-ctl: Detect systemd socket activation.\n  rhel: Add ovsdb-server.socket unit for systemd socket activation.\n  debian: Add ovsdb-server.socket unit for systemd socket activation.\n  tests: Add pfd stream tests.\n\n Documentation/ref/ovsdb.7.rst                 |  12 +\n debian/automake.mk                            |   1 +\n debian/openvswitch-switch.install             |   1 +\n .../openvswitch-switch.ovs-vswitchd.service   |   5 +-\n .../openvswitch-switch.ovsdb-server.service   |   1 +\n debian/openvswitch-switch.ovsdb-server.socket |  11 +\n lib/stream-provider.h                         |   1 +\n lib/stream-unix.c                             |  52 ++++\n lib/stream.c                                  |   5 +\n ovsdb/ovsdb-server.c                          |  23 +-\n rhel/automake.mk                              |   1 +\n rhel/openvswitch-fedora.spec.in               |   4 +\n ..._system_ovs-delete-transient-ports.service |   3 +-\n ...lib_systemd_system_ovs-vswitchd.service.in |   5 +-\n ...sr_lib_systemd_system_ovsdb-server.service |   1 +\n ...usr_lib_systemd_system_ovsdb-server.socket |  17 ++\n tests/automake.mk                             |   1 +\n tests/pfd-stream.at                           | 248 ++++++++++++++++++\n tests/testsuite.at                            |   1 +\n utilities/ovs-ctl.in                          |   8 +-\n 20 files changed, 391 insertions(+), 10 deletions(-)\n create mode 100644 debian/openvswitch-switch.ovsdb-server.socket\n create mode 100644 rhel/usr_lib_systemd_system_ovsdb-server.socket\n create mode 100644 tests/pfd-stream.at"
}