Show a cover letter.

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

{
    "id": 166,
    "url": "http://patches.dpdk.org/api/covers/166/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20230921102830.2765-1-pbhagavatula@marvell.com/",
    "project": {
        "id": 1,
        "url": "http://patches.dpdk.org/api/projects/1/?format=api",
        "name": "DPDK",
        "link_name": "dpdk",
        "list_id": "dev.dpdk.org",
        "list_email": "dev@dpdk.org",
        "web_url": "http://core.dpdk.org",
        "scm_url": "git://dpdk.org/dpdk",
        "webscm_url": "http://git.dpdk.org/dpdk",
        "list_archive_url": "https://inbox.dpdk.org/dev",
        "list_archive_url_format": "https://inbox.dpdk.org/dev/{}",
        "commit_url_format": ""
    },
    "msgid": "<20230921102830.2765-1-pbhagavatula@marvell.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20230921102830.2765-1-pbhagavatula@marvell.com",
    "date": "2023-09-21T10:28:27",
    "name": "[v3,0/3] Introduce event link profiles",
    "submitter": {
        "id": 1183,
        "url": "http://patches.dpdk.org/api/people/1183/?format=api",
        "name": "Pavan Nikhilesh Bhagavatula",
        "email": "pbhagavatula@marvell.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/20230921102830.2765-1-pbhagavatula@marvell.com/mbox/",
    "series": [
        {
            "id": 29587,
            "url": "http://patches.dpdk.org/api/series/29587/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=29587",
            "date": "2023-09-21T10:28:27",
            "name": "Introduce event link profiles",
            "version": 3,
            "mbox": "http://patches.dpdk.org/series/29587/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/166/comments/",
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id CA957425FF;\n\tThu, 21 Sep 2023 12:28:41 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 9A40D402EC;\n\tThu, 21 Sep 2023 12:28:41 +0200 (CEST)",
            "from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com\n [67.231.156.173])\n by mails.dpdk.org (Postfix) with ESMTP id 7352A402B5\n for <dev@dpdk.org>; Thu, 21 Sep 2023 12:28:40 +0200 (CEST)",
            "from pps.filterd (m0045851.ppops.net [127.0.0.1])\n by mx0b-0016f401.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id\n 38L75PSb007710; Thu, 21 Sep 2023 03:28:39 -0700",
            "from dc5-exch02.marvell.com ([199.233.59.182])\n by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 3t85ptts5d-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT);\n Thu, 21 Sep 2023 03:28:39 -0700",
            "from DC5-EXCH01.marvell.com (10.69.176.38) by DC5-EXCH02.marvell.com\n (10.69.176.39) with Microsoft SMTP Server (TLS) id 15.0.1497.48;\n Thu, 21 Sep 2023 03:28:37 -0700",
            "from maili.marvell.com (10.69.176.80) by DC5-EXCH01.marvell.com\n (10.69.176.38) with Microsoft SMTP Server id 15.0.1497.48 via Frontend\n Transport; Thu, 21 Sep 2023 03:28:37 -0700",
            "from MININT-80QBFE8.corp.innovium.com (MININT-80QBFE8.marvell.com\n [10.28.164.106])\n by maili.marvell.com (Postfix) with ESMTP id EF9C25B6940;\n Thu, 21 Sep 2023 03:28:32 -0700 (PDT)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com;\n h=from : to : cc :\n subject : date : message-id : in-reply-to : references : mime-version :\n content-transfer-encoding : content-type; s=pfpt0220;\n bh=/ubTp23k5j3Wrg5ClKdbldAvbuX/9SHS9KoilnZ2Iqk=;\n b=jtRUDbUcS7Mf94ZIrOHJgGV2IGZvMmd1272sofR4oiHASonhx+U+479jRwCDZXK0K2a8\n hfnoUI0Hk0eh7ntAhnQ1bQjGS65pZH0hR7k2w6OIZ9OP7gcWFm8sFaH62AsaiWXzqP6h\n CqbQ5M35d+TlnNEVwKizOFQRrXwa/1x4BYnHMBngJYYC2KWyUYboL7qezODsVVdnQ1IT\n T8RXZdzC+CaH+SY11yVMqznMvIFT9xnyNIMNL0dYDkQUqV6w/7iCvU/hOgPU5CkYo/H7\n Zkvg9UBGP1fwuPysvcPrNuLw4ubU83LB61ebllcA0ih4QKfdHfRg+5mnZYjw2O5fg9G5 qQ==",
        "From": "<pbhagavatula@marvell.com>",
        "To": "<jerinj@marvell.com>, <pbhagavatula@marvell.com>, <sthotton@marvell.com>,\n <timothy.mcdaniel@intel.com>, <hemant.agrawal@nxp.com>,\n <sachin.saxena@nxp.com>, <mattias.ronnblom@ericsson.com>,\n <liangma@liangbit.com>, <peter.mccarthy@intel.com>,\n <harry.van.haaren@intel.com>, <erik.g.carrillo@intel.com>,\n <abhinandan.gujjar@intel.com>, <s.v.naga.harish.k@intel.com>,\n <anatoly.burakov@intel.com>",
        "CC": "<dev@dpdk.org>",
        "Subject": "[PATCH v3 0/3] Introduce event link profiles",
        "Date": "Thu, 21 Sep 2023 15:58:27 +0530",
        "Message-ID": "<20230921102830.2765-1-pbhagavatula@marvell.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20230831204424.13367-1-pbhagavatula@marvell.com>",
        "References": "<20230831204424.13367-1-pbhagavatula@marvell.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Proofpoint-GUID": "g495LhxVjTGIWaQuxQlyHkmJLxbcSSaX",
        "X-Proofpoint-ORIG-GUID": "g495LhxVjTGIWaQuxQlyHkmJLxbcSSaX",
        "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.601,FMLib:17.11.176.26\n definitions=2023-09-21_07,2023-09-20_01,2023-05-22_02",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "DPDK patches and discussions <dev.dpdk.org>",
        "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>",
        "List-Archive": "<http://mails.dpdk.org/archives/dev/>",
        "List-Post": "<mailto:dev@dpdk.org>",
        "List-Help": "<mailto:dev-request@dpdk.org?subject=help>",
        "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>",
        "Errors-To": "dev-bounces@dpdk.org"
    },
    "content": "From: Pavan Nikhilesh <pbhagavatula@marvell.com>\n\nA collection of event queues linked to an event port can be associated\nwith unique identifier called as a profile, multiple such profiles can\nbe configured based on the event device capability using the function\n`rte_event_port_profile_links_set` which takes arguments similar to\n`rte_event_port_link` in addition to the profile identifier.\n\nThe maximum link profiles that are supported by an event device is\nadvertised through the structure member\n`rte_event_dev_info::max_profiles_per_port`.\n\nBy default, event ports are configured to use the link profile 0 on\ninitialization.\n\nOnce multiple link profiles are set up and the event device is started, the\napplication can use the function `rte_event_port_profile_switch` to change\nthe currently active profile on an event port. This effects the next\n`rte_event_dequeue_burst` call, where the event queues associated with the\nnewly active link profile will participate in scheduling.\n\nRudementary work flow would something like:\n\nConfig path:\n\n    uint8_t lowQ[4] = {4, 5, 6, 7};\n    uint8_t highQ[4] = {0, 1, 2, 3};\n\n    if (rte_event_dev_info.max_profiles_per_port < 2)\n        return -ENOTSUP;\n\n    rte_event_port_profile_links_set(0, 0, highQ, NULL, 4, 0);\n    rte_event_port_profile_links_set(0, 0, lowQ, NULL, 4, 1);\n\nWorker path:\n\n    empty_high_deq = 0;\n    empty_low_deq = 0;\n    is_low_deq = 0;\n    while (1) {\n        deq = rte_event_dequeue_burst(0, 0, &ev, 1, 0);\n        if (deq == 0) {\n            /**\n             * Change link profile based on work activity on current\n             * active profile\n             */\n            if (is_low_deq) {\n                empty_low_deq++;\n                if (empty_low_deq == MAX_LOW_RETRY) {\n                    rte_event_port_profile_switch(0, 0, 0);\n                    is_low_deq = 0;\n                    empty_low_deq = 0;\n                }\n                continue;\n            }\n\n            if (empty_high_deq == MAX_HIGH_RETRY) {\n                rte_event_port_profile_switch(0, 0, 1);\n                is_low_deq = 1;\n                empty_high_deq = 0;\n            }\n            continue;\n        }\n\n        // Process the event received.\n\n        if (is_low_deq++ == MAX_LOW_EVENTS) {\n            rte_event_port_profile_switch(0, 0, 0);\n            is_low_deq = 0;\n        }\n    }\n\nAn application could use heuristic data of load/activity of a given event\nport and change its active profile to adapt to the traffic pattern.\n\nAn unlink function `rte_event_port_profile_unlink` is provided to\nmodify the links associated to a profile, and\n`rte_event_port_profile_links_get` can be used to retrieve the links\nassociated with a profile.\n\nUsing Link profiles can reduce the overhead of linking/unlinking and\nwaiting for unlinks in progress in fast-path and gives applications\nthe ability to switch between preset profiles on the fly.\n\nv3 Changes:\n----------\n- Rebase to next-eventdev\n- Rename testcase name to match API.\n\nv2 Changes:\n----------\n- Fix compilation.\n\nPavan Nikhilesh (3):\n  eventdev: introduce link profiles\n  event/cnxk: implement event link profiles\n  test/event: add event link profile test\n\n app/test/test_eventdev.c                   | 117 +++++++++++\n config/rte_config.h                        |   1 +\n doc/guides/eventdevs/cnxk.rst              |   1 +\n doc/guides/eventdevs/features/cnxk.ini     |   3 +-\n doc/guides/eventdevs/features/default.ini  |   1 +\n doc/guides/prog_guide/eventdev.rst         |  40 ++++\n doc/guides/rel_notes/release_23_11.rst     |  22 ++\n drivers/common/cnxk/roc_nix_inl_dev.c      |   4 +-\n drivers/common/cnxk/roc_sso.c              |  18 +-\n drivers/common/cnxk/roc_sso.h              |   8 +-\n drivers/common/cnxk/roc_sso_priv.h         |   4 +-\n drivers/event/cnxk/cn10k_eventdev.c        |  45 ++--\n drivers/event/cnxk/cn10k_worker.c          |  11 +\n drivers/event/cnxk/cn10k_worker.h          |   1 +\n drivers/event/cnxk/cn9k_eventdev.c         |  74 ++++---\n drivers/event/cnxk/cn9k_worker.c           |  22 ++\n drivers/event/cnxk/cn9k_worker.h           |   2 +\n drivers/event/cnxk/cnxk_eventdev.c         |  37 ++--\n drivers/event/cnxk/cnxk_eventdev.h         |  10 +-\n drivers/event/dlb2/dlb2.c                  |   1 +\n drivers/event/dpaa/dpaa_eventdev.c         |   1 +\n drivers/event/dpaa2/dpaa2_eventdev.c       |   2 +-\n drivers/event/dsw/dsw_evdev.c              |   1 +\n drivers/event/octeontx/ssovf_evdev.c       |   2 +-\n drivers/event/opdl/opdl_evdev.c            |   1 +\n drivers/event/skeleton/skeleton_eventdev.c |   1 +\n drivers/event/sw/sw_evdev.c                |   1 +\n lib/eventdev/eventdev_pmd.h                |  59 +++++-\n lib/eventdev/eventdev_private.c            |   9 +\n lib/eventdev/eventdev_trace.h              |  32 +++\n lib/eventdev/eventdev_trace_points.c       |  12 ++\n lib/eventdev/rte_eventdev.c                | 146 ++++++++++---\n lib/eventdev/rte_eventdev.h                | 231 +++++++++++++++++++++\n lib/eventdev/rte_eventdev_core.h           |   6 +-\n lib/eventdev/rte_eventdev_trace_fp.h       |   8 +\n lib/eventdev/version.map                   |   4 +\n 36 files changed, 827 insertions(+), 111 deletions(-)\n\n--\n2.25.1"
}