Show a cover letter.

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

{
    "id": 88469,
    "url": "http://patches.dpdk.org/api/covers/88469/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/cover/1614868228-13685-1-git-send-email-xuemingl@nvidia.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": "<1614868228-13685-1-git-send-email-xuemingl@nvidia.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/1614868228-13685-1-git-send-email-xuemingl@nvidia.com",
    "date": "2021-03-04T14:30:16",
    "name": "[v8,0/9] ethdev: support SubFunction representor",
    "submitter": {
        "id": 1904,
        "url": "http://patches.dpdk.org/api/people/1904/?format=api",
        "name": "Xueming Li",
        "email": "xuemingl@nvidia.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/cover/1614868228-13685-1-git-send-email-xuemingl@nvidia.com/mbox/",
    "series": [
        {
            "id": 15491,
            "url": "http://patches.dpdk.org/api/series/15491/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=15491",
            "date": "2021-03-04T14:30:16",
            "name": "ethdev: support SubFunction representor",
            "version": 8,
            "mbox": "http://patches.dpdk.org/series/15491/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/covers/88469/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 04F1AA0561;\n\tThu,  4 Mar 2021 15:30:52 +0100 (CET)",
            "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 74C5D40684;\n\tThu,  4 Mar 2021 15:30:52 +0100 (CET)",
            "from mellanox.co.il (mail-il-dmz.mellanox.com [193.47.165.129])\n by mails.dpdk.org (Postfix) with ESMTP id 280CF40147\n for <dev@dpdk.org>; Thu,  4 Mar 2021 15:30:51 +0100 (CET)",
            "from Internal Mail-Server by MTLPINE1 (envelope-from\n xuemingl@nvidia.com) with SMTP; 4 Mar 2021 16:30:47 +0200",
            "from nvidia.com (pegasus05.mtr.labs.mlnx [10.210.16.100])\n by labmailer.mlnx (8.13.8/8.13.8) with ESMTP id 124EUkoO027668;\n Thu, 4 Mar 2021 16:30:47 +0200"
        ],
        "From": "Xueming Li <xuemingl@nvidia.com>",
        "To": "Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>",
        "Cc": "dev@dpdk.org, Viacheslav Ovsiienko <viacheslavo@nvidia.com>,\n xuemingl@nvidia.com, Asaf Penso <asafp@nvidia.com>",
        "Date": "Thu,  4 Mar 2021 14:30:16 +0000",
        "Message-Id": "<1614868228-13685-1-git-send-email-xuemingl@nvidia.com>",
        "X-Mailer": "git-send-email 1.8.3.1",
        "In-Reply-To": "<1608303356-13089-2-git-send-email-xuemingl@nvidia.com>",
        "References": "<1608303356-13089-2-git-send-email-xuemingl@nvidia.com>",
        "Subject": "[dpdk-dev] [PATCH v8 0/9] ethdev: support SubFunction representor",
        "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",
        "Sender": "\"dev\" <dev-bounces@dpdk.org>"
    },
    "content": "SubFunction [1] is a portion of the PCI device, a SF netdev has its own\ndedicated queues(txq, rxq). A SF netdev supports E-Switch representation\noffload similar to existing PF and VF representors. A SF shares PCI\nlevel resources with other SFs and/or with its parent PCI function.\n\nFrom SmartNIC perspective, when PCI device is shared for multi-host,\nrepresentors for host controller and host PF is required.\n\nThis patch set introduces new representor types in addtion to existing\nVF representor. Syntax:\n\n[[c#]pf#]vf#: VF port representor/s from controller/pf\n[[c#]pf#]sf#: SF port representor/s from controller/pf\n#: VF representor - for backwards compatibility\n\n\"#\" is number instance, list or range, valid examples:\n  1, [1,3,5], [0-3], [0,2-4,6]\n\nFor backward compatibility, this patch also introduces new netdev\ncapability to indicate the capability of supportting SF representor.\n\nVersion history:\n RFC:\n \tinitial version [2]\n V2:\n    - separate patch for represnetor infrastructure, controller, pf and\n      sf.\n    - replace representor ID macro with functions:\n      rte_eth_representor_id_encode()\n      rte_eth_representor_id_parse()\n    - new patch to allow devargs with same PCI BDF but different\n      representors.\n    - other minor code updates according to comments, thanks Andrew!\n    - update document\n V3:\n    - improve probing of allowed devargs with same name.\n    - parse single word of kvargs as key.\n    - update kvargs test cases.\n V4:\n    - split first representor refactor patch into\n      1: add representor type\n      2: refector representor list parsing\n    - push the patch supporting multi-devargs for same device.\n V5:\n    - add comments for parsing functions\n    - update switch_representation.rst - Thanks Ajit\n V6:\n    - split representor types into different patches, move to\n      rte_ethdev.h\n    - improvements of rte_eth_devargs_process_list() according to\n      Andrew's suggestion\n    - fixed PF probe failure for Intel i40e\n    - replace ethdev SF capability with rte_eth_representor_info_get()\n    - add new ethdev ops api to get representor info from PMD\n    - replace representor ID encode/decode with conversion from\n      representor info\n    - change ethdev representor iterator to use new ID encoding\n V7:\n    - error on duplicated representor argument:\n      DBDF,representor=a,representor=b\n    - fix pf representor type parsing\n    - other small fixes suggested by Andrew.\n V8:\n \t- remove the \"ignore\" hint from pmd representor info\n \t- changed representor_id type in representor info to u32\n \t- rename rte_eth_representor_id_convert() to ..._get()\n \t- other small fixes suggested by Andrew\n   \n\n\n[1] SubFunction in kernel:\nhttps://lore.kernel.org/netdev/20201112192424.2742-1-parav@nvidia.com/\n\n[2] RFC:\nhttp://patchwork.dpdk.org/project/dpdk/list/?series=14376\n\n[3] V2:\nhttp://patchwork.dpdk.org/project/dpdk/list/?series=14559\n\n[4] V3:\n1 http://patchwork.dpdk.org/patch/86460/\n2 http://patchwork.dpdk.org/patch/86461/\n3 http://patchwork.dpdk.org/patch/86462/\n4 http://patchwork.dpdk.org/patch/86463/\n5 http://patchwork.dpdk.org/patch/86464/\n6 http://patchwork.dpdk.org/patch/86465/\n7 http://patchwork.dpdk.org/patch/86467/\n8 http://patchwork.dpdk.org/patch/86466/\n9 http://patchwork.dpdk.org/patch/86468/\n\n[5] V4:\nhttp://patchwork.dpdk.org/project/dpdk/list/?series=14809\n\n[6] V5:\nhttp://patchwork.dpdk.org/project/dpdk/list/?series=14834\n\n[7] V6:\nhttp://patchwork.dpdk.org/project/dpdk/list/?series=15258\n\n[8] v7:\nhttp://patchwork.dpdk.org/project/dpdk/list/?series=15441\n\nXueming Li (9):\n  ethdev: introduce representor type\n  ethdev: support representor port list\n  ethdev: support new VF representor syntax\n  ethdev: support sub function representor\n  ethdev: support PF index in representor\n  ethdev: support multi-host in representor\n  ethdev: new API to get representor info\n  ethdev: representor iterator compare complete info\n  kvargs: update parser to support lists\n\n app/test/test_kvargs.c                        |  46 ++++-\n config/rte_config.h                           |   1 +\n doc/guides/prog_guide/poll_mode_drv.rst       |  18 +-\n .../prog_guide/switch_representation.rst      |  35 ++--\n drivers/net/bnxt/bnxt_ethdev.c                |   7 +\n drivers/net/enic/enic_ethdev.c                |   6 +\n drivers/net/i40e/i40e_ethdev.c                |   7 +\n drivers/net/ixgbe/ixgbe_ethdev.c              |   7 +\n drivers/net/mlx5/linux/mlx5_os.c              |  11 ++\n lib/librte_ethdev/ethdev_driver.h             |  50 +++++-\n lib/librte_ethdev/ethdev_private.c            | 169 ++++++++++++------\n lib/librte_ethdev/ethdev_private.h            |   3 -\n lib/librte_ethdev/rte_class_eth.c             |  40 +++--\n lib/librte_ethdev/rte_ethdev.c                | 113 +++++++++++-\n lib/librte_ethdev/rte_ethdev.h                |  61 +++++++\n lib/librte_ethdev/version.map                 |   4 +\n lib/librte_kvargs/rte_kvargs.c                | 101 ++++++++---\n 17 files changed, 554 insertions(+), 125 deletions(-)"
}