get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/patches/67608/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 67608,
    "url": "http://patches.dpdk.org/api/patches/67608/?format=api",
    "web_url": "http://patches.dpdk.org/project/dpdk/patch/20200401142127.13715-24-mk@semihalf.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": "<20200401142127.13715-24-mk@semihalf.com>",
    "list_archive_url": "https://inbox.dpdk.org/dev/20200401142127.13715-24-mk@semihalf.com",
    "date": "2020-04-01T14:21:21",
    "name": "[v2,23/29] net/ena: limit refill threshold by fixed value",
    "commit_ref": null,
    "pull_url": null,
    "state": "superseded",
    "archived": true,
    "hash": "c8f4b0898f042fbc694bf4c78d73ddddb74a5aa4",
    "submitter": {
        "id": 786,
        "url": "http://patches.dpdk.org/api/people/786/?format=api",
        "name": "Michal Krawczyk",
        "email": "mk@semihalf.com"
    },
    "delegate": {
        "id": 319,
        "url": "http://patches.dpdk.org/api/users/319/?format=api",
        "username": "fyigit",
        "first_name": "Ferruh",
        "last_name": "Yigit",
        "email": "ferruh.yigit@amd.com"
    },
    "mbox": "http://patches.dpdk.org/project/dpdk/patch/20200401142127.13715-24-mk@semihalf.com/mbox/",
    "series": [
        {
            "id": 9153,
            "url": "http://patches.dpdk.org/api/series/9153/?format=api",
            "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=9153",
            "date": "2020-04-01T14:20:58",
            "name": "Update ENA driver to v2.1.0",
            "version": 2,
            "mbox": "http://patches.dpdk.org/series/9153/mbox/"
        }
    ],
    "comments": "http://patches.dpdk.org/api/patches/67608/comments/",
    "check": "success",
    "checks": "http://patches.dpdk.org/api/patches/67608/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "<dev-bounces@dpdk.org>",
        "X-Original-To": "patchwork@inbox.dpdk.org",
        "Delivered-To": "patchwork@inbox.dpdk.org",
        "Received": [
            "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 09549A057B;\n\tWed,  1 Apr 2020 16:25:56 +0200 (CEST)",
            "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id AD7351C12A;\n\tWed,  1 Apr 2020 16:22:15 +0200 (CEST)",
            "from mail-lf1-f65.google.com (mail-lf1-f65.google.com\n [209.85.167.65]) by dpdk.org (Postfix) with ESMTP id 8DCAE1C113\n for <dev@dpdk.org>; Wed,  1 Apr 2020 16:22:09 +0200 (CEST)",
            "by mail-lf1-f65.google.com with SMTP id t11so8199845lfe.4\n for <dev@dpdk.org>; Wed, 01 Apr 2020 07:22:09 -0700 (PDT)",
            "from mkPC.semihalf.local (193-106-246-138.noc.fibertech.net.pl.\n [193.106.246.138])\n by smtp.gmail.com with ESMTPSA id r21sm1435961ljp.29.2020.04.01.07.22.07\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Wed, 01 Apr 2020 07:22:07 -0700 (PDT)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=semihalf-com.20150623.gappssmtp.com; s=20150623;\n h=from:to:cc:subject:date:message-id:in-reply-to:references\n :mime-version:content-transfer-encoding;\n bh=5A9hsbTp+jjQv9P8DNmXLX5GuSXGtPzKA9NbAJIoZv4=;\n b=k6chPiwiGvecUN6TrT2fsMF6eDIsfuwdCvcPDN4N6BPhiHmQUl8jGF8buXVn/crluD\n uEHxur/XYSja74xqMN+NeyeLDpH/49hJbtUIaCbzR92dUbPZxytuVsQNtnsy+E0tuHG8\n rnkqISHsCf6BzxHejzJzbHTSGiBnx9gYIoxYCcOkuk1DH0cA1R9zgWyy6rMbFYcoegT4\n 0+I9u/gtMv23puI11uGvgtIQafZimy9F1sDOZPE/cr05VbEi7Ic89uaJocH1risp3j0n\n FP32My6jvoKcfpgCkaK5tVTOE3vMnkNxl3YX1N9wxfB8P+jfdTO6aHznMlRa6/49BmGf\n 0n0g==",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20161025;\n h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n :references:mime-version:content-transfer-encoding;\n bh=5A9hsbTp+jjQv9P8DNmXLX5GuSXGtPzKA9NbAJIoZv4=;\n b=jkcAFxe7qPHx2JP2HsV30OBIU1P9+1zDKcqNNmeDda+fiSzokH5Btk6hNRAYrBVE8j\n rpyuNYf1rQV+2pQH5e5Vnw5WWbbNoOwWbrcIMTMzDFj96hyfEZxI6WRMb1TxZ/2htl8I\n QZnCpU+CduRqF1QdWgIsI48iArgqmVV0mcMvH1hYp4tAnyCscu/0GjICIouC3i2PKcmq\n uETNLAKr/Vk/16iOgOtrSW/xdsVgyIY4+Ac5/hR+9N7yJnnz9jjNdayZ1YT+ruMnf87Y\n vpUTtox8V8jgQzTRxJyiIn+9d2f2+Fox9mSNHN3GQrc2QSKQn1aD6filb0oyTrMLWr14\n h45g==",
        "X-Gm-Message-State": "AGi0PuZOLktBx8Rj42dheXRne1PrNJtjUfFU9tT6hPRc997pubDkowJl\n QwJK4J/Ph6cLiXbmZkkLx1aqzNJzvI0=",
        "X-Google-Smtp-Source": "\n APiQypLdkO9FVHmO3wxi7IOMcWMBjemzLhgEnFJ3ITey29ElR+XE1iILoozh8nhnQx/Ush2a46BCZQ==",
        "X-Received": "by 2002:ac2:5096:: with SMTP id f22mr15136656lfm.79.1585750928764;\n Wed, 01 Apr 2020 07:22:08 -0700 (PDT)",
        "From": "Michal Krawczyk <mk@semihalf.com>",
        "To": "dev@dpdk.org",
        "Cc": "mw@semihalf.com, mba@semihalf.com, gtzalik@amazon.com, evgenys@amazon.com,\n igorch@amazon.com, Michal Krawczyk <mk@semihalf.com>",
        "Date": "Wed,  1 Apr 2020 16:21:21 +0200",
        "Message-Id": "<20200401142127.13715-24-mk@semihalf.com>",
        "X-Mailer": "git-send-email 2.20.1",
        "In-Reply-To": "<20200401142127.13715-1-mk@semihalf.com>",
        "References": "<20200401142127.13715-1-mk@semihalf.com>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "Subject": "[dpdk-dev] [PATCH v2 23/29] net/ena: limit refill threshold by\n\tfixed value",
        "X-BeenThere": "dev@dpdk.org",
        "X-Mailman-Version": "2.1.15",
        "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": "Divider used for both Tx and Rx cleanup/refill threshold can cause too\nbig delay in case of the really big rings - for example if the 8k Rx\nring will be used, the refill won't trigger unless 1024 threshold will\nbe reached. It will also cause driver to try to allocate that much\ndescriptors.\n\nLimiting it by fixed value - 256 in that case, would limit maximum\ntime spent in repopulate function.\n\nSigned-off-by: Michal Krawczyk <mk@semihalf.com>\nReviewed-by: Igor Chauskin <igorch@amazon.com>\nReviewed-by: Guy Tzalik <gtzalik@amazon.com>\n---\n drivers/net/ena/ena_ethdev.c | 27 ++++++++++++++-------------\n drivers/net/ena/ena_ethdev.h | 10 ++++++++++\n 2 files changed, 24 insertions(+), 13 deletions(-)",
    "diff": "diff --git a/drivers/net/ena/ena_ethdev.c b/drivers/net/ena/ena_ethdev.c\nindex a6375e71c5..fc14f1cb32 100644\n--- a/drivers/net/ena/ena_ethdev.c\n+++ b/drivers/net/ena/ena_ethdev.c\n@@ -35,14 +35,6 @@\n /*reverse version of ENA_IO_RXQ_IDX*/\n #define ENA_IO_RXQ_IDX_REV(q)\t((q - 1) / 2)\n \n-/* While processing submitted and completed descriptors (rx and tx path\n- * respectively) in a loop it is desired to:\n- *  - perform batch submissions while populating sumbissmion queue\n- *  - avoid blocking transmission of other packets during cleanup phase\n- * Hence the utilization ratio of 1/8 of a queue size.\n- */\n-#define ENA_RING_DESCS_RATIO(ring_size)\t(ring_size / 8)\n-\n #define __MERGE_64B_H_L(h, l) (((uint64_t)h << 32) | l)\n #define TEST_BIT(val, bit_shift) (val & (1UL << bit_shift))\n \n@@ -2146,7 +2138,8 @@ static uint16_t eth_ena_recv_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,\n \tstruct ena_ring *rx_ring = (struct ena_ring *)(rx_queue);\n \tunsigned int ring_size = rx_ring->ring_size;\n \tunsigned int ring_mask = ring_size - 1;\n-\tunsigned int refill_required;\n+\tunsigned int free_queue_entries;\n+\tunsigned int refill_threshold;\n \tuint16_t next_to_clean = rx_ring->next_to_clean;\n \tuint16_t descs_in_use;\n \tstruct rte_mbuf *mbuf;\n@@ -2215,11 +2208,15 @@ static uint16_t eth_ena_recv_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,\n \trx_ring->rx_stats.cnt += completed;\n \trx_ring->next_to_clean = next_to_clean;\n \n-\trefill_required = ena_com_free_q_entries(rx_ring->ena_com_io_sq);\n+\tfree_queue_entries = ena_com_free_q_entries(rx_ring->ena_com_io_sq);\n+\trefill_threshold =\n+\t\tRTE_MIN(ring_size / ENA_REFILL_THRESH_DIVIDER,\n+\t\t(unsigned int)ENA_REFILL_THRESH_PACKET);\n+\n \t/* Burst refill to save doorbells, memory barriers, const interval */\n-\tif (refill_required > ENA_RING_DESCS_RATIO(ring_size)) {\n+\tif (free_queue_entries > refill_threshold) {\n \t\tena_com_update_dev_comp_head(rx_ring->ena_com_io_cq);\n-\t\tena_populate_rx_queue(rx_ring, refill_required);\n+\t\tena_populate_rx_queue(rx_ring, free_queue_entries);\n \t}\n \n \treturn completed;\n@@ -2358,6 +2355,7 @@ static uint16_t eth_ena_xmit_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,\n \tuint16_t seg_len;\n \tunsigned int ring_size = tx_ring->ring_size;\n \tunsigned int ring_mask = ring_size - 1;\n+\tunsigned int cleanup_budget;\n \tstruct ena_com_tx_ctx ena_tx_ctx;\n \tstruct ena_tx_buffer *tx_info;\n \tstruct ena_com_buf *ebuf;\n@@ -2515,9 +2513,12 @@ static uint16_t eth_ena_xmit_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,\n \t\t/* Put back descriptor to the ring for reuse */\n \t\ttx_ring->empty_tx_reqs[next_to_clean & ring_mask] = req_id;\n \t\tnext_to_clean++;\n+\t\tcleanup_budget =\n+\t\t\tRTE_MIN(ring_size / ENA_REFILL_THRESH_DIVIDER,\n+\t\t\t(unsigned int)ENA_REFILL_THRESH_PACKET);\n \n \t\t/* If too many descs to clean, leave it for another run */\n-\t\tif (unlikely(total_tx_descs > ENA_RING_DESCS_RATIO(ring_size)))\n+\t\tif (unlikely(total_tx_descs > cleanup_budget))\n \t\t\tbreak;\n \t}\n \ttx_ring->tx_stats.available_desc =\ndiff --git a/drivers/net/ena/ena_ethdev.h b/drivers/net/ena/ena_ethdev.h\nindex 9df34136da..77c405fbdd 100644\n--- a/drivers/net/ena/ena_ethdev.h\n+++ b/drivers/net/ena/ena_ethdev.h\n@@ -30,6 +30,16 @@\n #define ENA_WD_TIMEOUT_SEC\t3\n #define ENA_DEVICE_KALIVE_TIMEOUT (ENA_WD_TIMEOUT_SEC * rte_get_timer_hz())\n \n+/* While processing submitted and completed descriptors (rx and tx path\n+ * respectively) in a loop it is desired to:\n+ *  - perform batch submissions while populating sumbissmion queue\n+ *  - avoid blocking transmission of other packets during cleanup phase\n+ * Hence the utilization ratio of 1/8 of a queue size or max value if the size\n+ * of the ring is very big - like 8k Rx rings.\n+ */\n+#define ENA_REFILL_THRESH_DIVIDER      8\n+#define ENA_REFILL_THRESH_PACKET       256\n+\n struct ena_adapter;\n \n enum ena_ring_type {\n",
    "prefixes": [
        "v2",
        "23/29"
    ]
}