Show a cover letter.

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

{
    "id": 221,
    "url": "http://patches.dpdk.org/api/covers/221/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/20231003094721.5115-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": "<20231003094721.5115-1-pbhagavatula@marvell.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20231003094721.5115-1-pbhagavatula@marvell.com",
    "date": "2023-10-03T09:47:18",
    "name": "[v6,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/20231003094721.5115-1-pbhagavatula@marvell.com/mbox/",
    "series": [
        {
            "id": 29719,
            "url": "http://patches.dpdk.org/api/series/29719/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=29719",
            "date": "2023-10-03T09:47:18",
            "name": "Introduce event link profiles",
            "version": 6,
            "mbox": "http://patches.dpdk.org/series/29719/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/221/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 ECBEC426AE;\n\tTue,  3 Oct 2023 11:47:33 +0200 (CEST)",
            "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 93C9C4026B;\n\tTue,  3 Oct 2023 11:47:33 +0200 (CEST)",
            "from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com\n [67.231.148.174])\n by mails.dpdk.org (Postfix) with ESMTP id 3AC2B40262\n for <dev@dpdk.org>; Tue,  3 Oct 2023 11:47:32 +0200 (CEST)",
            "from pps.filterd (m0045849.ppops.net [127.0.0.1])\n by mx0a-0016f401.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id\n 3933inQa022273; Tue, 3 Oct 2023 02:47:31 -0700",
            "from dc5-exch02.marvell.com ([199.233.59.182])\n by mx0a-0016f401.pphosted.com (PPS) with ESMTPS id 3tgbas92tf-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT);\n Tue, 03 Oct 2023 02:47:31 -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 Tue, 3 Oct 2023 02:47:29 -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; Tue, 3 Oct 2023 02:47:29 -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 D285B3F7043;\n Tue,  3 Oct 2023 02:47:22 -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=2r8aM64hGOxEn00aAwUFA+koqIjXNwrxuDcSdl3kF04=;\n b=CuyLOKepZ/w8sFcy2LYtA/EGPRjSNrbyedIWPL8cSzPM1EYDu+pe/8tUwKM40mX1OX+B\n Z64OUbyvo8wm9ZnP/pF8nyVmIa3kS4mwQtdEU5917JRnnzp0Y9RnSiOrNCyOI5MZG1hA\n M0QzeLK58geuSUwVBgtNdLGBoB9pjuIJZ9xxE2mFNUzaW+VOy+fejwlwgwx4BmeDxbdo\n vPTMYzdBIu5KpOvIN0l6Tgtbgd1fNU4HfC4l85LvBwn3EAVN7mSN/6iZHcw/wMpLfiEm\n B6w4bcrj9hTFYUA5CIVd12haJ9OMFsSMvReGUIXZw1J2aK4RQOA24SHBT4jgJfAZ2D3O yA==",
        "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 v6 0/3] Introduce event link profiles",
        "Date": "Tue, 3 Oct 2023 15:17:18 +0530",
        "Message-ID": "<20231003094721.5115-1-pbhagavatula@marvell.com>",
        "X-Mailer": "git-send-email 2.25.1",
        "In-Reply-To": "<20231003075109.4309-1-pbhagavatula@marvell.com>",
        "References": "<20231003075109.4309-1-pbhagavatula@marvell.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Content-Type": "text/plain",
        "X-Proofpoint-ORIG-GUID": "W4ebC5hgNLgpJ8bpw0xODvV5D3-G-6uO",
        "X-Proofpoint-GUID": "W4ebC5hgNLgpJ8bpw0xODvV5D3-G-6uO",
        "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.267,Aquarius:18.0.980,Hydra:6.0.619,FMLib:17.11.176.26\n definitions=2023-10-03_06,2023-10-02_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 link profile, multiple such profiles\ncan be 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 lq[4] = {4, 5, 6, 7};\n    uint8_t hq[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, hq, NULL, 4, 0);\n    rte_event_port_profile_links_set(0, 0, lq, 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\nv6 Changes:\n----------\n- Fix compilation.\n\nv5 Changes:\n----------\n- Rebase on next-event\n\nv4 Changes:\n----------\n- Address review comments (Jerin).\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    |  13 ++\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 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               | 150 +++++++++++---\n lib/eventdev/rte_eventdev.h               | 231 ++++++++++++++++++++++\n lib/eventdev/rte_eventdev_core.h          |   5 +\n lib/eventdev/rte_eventdev_trace_fp.h      |   8 +\n lib/eventdev/version.map                  |   4 +\n 28 files changed, 813 insertions(+), 109 deletions(-)\n\n--\n2.25.1"
}