From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 4798543CAD for ; Thu, 14 Mar 2024 01:10:21 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3B4F542E41; Thu, 14 Mar 2024 01:10:21 +0100 (CET) Received: from mail-wr1-f44.google.com (mail-wr1-f44.google.com [209.85.221.44]) by mails.dpdk.org (Postfix) with ESMTP id F06804021E for ; Thu, 14 Mar 2024 01:10:18 +0100 (CET) Received: by mail-wr1-f44.google.com with SMTP id ffacd0b85a97d-33e99915809so323723f8f.3 for ; Wed, 13 Mar 2024 17:10:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710375018; x=1710979818; darn=dpdk.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=1MzMIkr001tQyGNHx41KWE0EcWRmejiypJXq5OXJkRk=; b=cuonZP3tKVkmKcCHQYh3gfXzBE6VVzhFgtajzwHuV5phcAml69uz8e1iHRJ+5YA9IR OCNimcrNa5nhBUK34kIcbGZlBq19sK34+qA0U02p9uSxjD3/+SA+ziEiBmnCuQPRqL2R dK5maE9Y3fVx9lxw2RUb7mEEKzVK1CG3xB65D5F7Plq72h/1FCoWw5vz1Xx+dJhJ7grd aV1p21EC5dk11iIms/Y1J9vtuHGDBwJcObebmOIMZkuVnwkOtu+CZxCivZUAw7WRHcLK oIOT768xr0Xmu2GGBr8avnDltvx9QD7nIZ3K/QUkKk4PsGP+4Adlq2uoTC4srHFMgr5X wevA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710375018; x=1710979818; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=1MzMIkr001tQyGNHx41KWE0EcWRmejiypJXq5OXJkRk=; b=Q8IEKtcLomPd/M42DcDn1fqY2Zn5jgsbTmLWbjRg3CFCuLHQggsfNzp51lSSdByQ5n 91OT0IaqJcRn+uHg4TW5R3cft8F1LdB87E+STvFwWxsU4Ub15vM3mhqShYIw38/yWgKw +4alOy42Swnx8mOlorr5UKxc0wQc3+QOeohEsElEzR1ARf4xAS995Km4e12XJjqer59k h/9GynnSz5JCQ0iVlbHFTdOKTMkOyHLxjRE1/UM7ofIIlhjLAzvqJU2NrMVGP6TwF9DH m/ZVxRHxHBGDFVcY9pQkhkz6dLVJzuUj4ZNMgekCHD2BGa08VnOgZRPZHOEirRO0NDIY 1fJg== X-Forwarded-Encrypted: i=1; AJvYcCXml3EL5MowB7qpEeCypkhtYcC/UirQ7SLPHKDXfjhIjj2hbfDJR3VQUBzQSIicMU78syf+yVTnxV3Re/dAn4I= X-Gm-Message-State: AOJu0Yzwf8D2OU4p9m8QjbihlJqWrOh8PyCMDZaPY4yBmyQLoWyXDLBb LccGCjlcXtH+TPOijDroFqfq71k/pSKLahFgo6AigKi6XEargK62Rp4sjNTK X-Google-Smtp-Source: AGHT+IEpV5uQkncMALAgHNd3RE4aOUqAZmK7k7v07g90v0/lxSbZxULK7Jv6e3nnA7TJ4MahztE53Q== X-Received: by 2002:adf:ee8a:0:b0:33d:2b46:3ee3 with SMTP id b10-20020adfee8a000000b0033d2b463ee3mr75282wro.22.1710375018507; Wed, 13 Mar 2024 17:10:18 -0700 (PDT) Received: from localhost ([2a01:4b00:d036:ae00:7aef:1aaa:3dff:d546]) by smtp.gmail.com with ESMTPSA id q16-20020adfea10000000b0033e052be14fsm278765wrm.98.2024.03.13.17.10.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 13 Mar 2024 17:10:17 -0700 (PDT) From: luca.boccassi@gmail.com To: Bruce Richardson Cc: Pavan Nikhilesh , Jerin Jacob , dpdk stable Subject: patch 'eventdev: improve Doxygen comments on configure struct' has been queued to stable release 22.11.5 Date: Thu, 14 Mar 2024 00:09:03 +0000 Message-Id: <20240314000957.2810803-7-luca.boccassi@gmail.com> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240314000957.2810803-1-luca.boccassi@gmail.com> References: <20240307013159.1735343-102-luca.boccassi@gmail.com> <20240314000957.2810803-1-luca.boccassi@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Hi, FYI, your patch has been queued to stable release 22.11.5 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 03/16/24. So please shout if anyone has objections. Also note that after the patch there's a diff of the upstream commit vs the patch applied to the branch. This will indicate if there was any rebasing needed to apply to the stable branch. If there were code changes for rebasing (ie: not only metadata diffs), please double check that the rebase was correctly done. Queued patches are on a temporary branch at: https://github.com/bluca/dpdk-stable This queued commit can be viewed at: https://github.com/bluca/dpdk-stable/commit/ad39899ad85f7e8035d9cd5e1a4ab86e5a683739 Thanks. Luca Boccassi --- >From ad39899ad85f7e8035d9cd5e1a4ab86e5a683739 Mon Sep 17 00:00:00 2001 From: Bruce Richardson Date: Wed, 21 Feb 2024 10:32:15 +0000 Subject: [PATCH] eventdev: improve Doxygen comments on configure struct [ upstream commit 1203462c5ada21bdace88e009db5a8f17f88528a ] General rewording and cleanup on the rte_event_dev_config structure. Improved the wording of some sentences and created linked cross-references out of the existing references to the dev_info structure. As part of the rework, fix issue with how single-link port-queue pairs were counted in the rte_event_dev_config structure. This did not match the actual implementation and, if following the documentation, certain valid port/queue configurations would have been impossible to configure. Fix this by changing the documentation to match the implementation Bugzilla ID: 1368 Fixes: 75d113136f38 ("eventdev: express DLB/DLB2 PMD constraints") Signed-off-by: Bruce Richardson Acked-by: Pavan Nikhilesh Acked-by: Jerin Jacob --- lib/eventdev/rte_eventdev.h | 61 ++++++++++++++++++++++--------------- 1 file changed, 37 insertions(+), 24 deletions(-) diff --git a/lib/eventdev/rte_eventdev.h b/lib/eventdev/rte_eventdev.h index a90e23ac8b..695a1f636c 100644 --- a/lib/eventdev/rte_eventdev.h +++ b/lib/eventdev/rte_eventdev.h @@ -507,9 +507,9 @@ rte_event_dev_attr_get(uint8_t dev_id, uint32_t attr_id, struct rte_event_dev_config { uint32_t dequeue_timeout_ns; /**< rte_event_dequeue_burst() timeout on this device. - * This value should be in the range of *min_dequeue_timeout_ns* and - * *max_dequeue_timeout_ns* which previously provided in - * rte_event_dev_info_get() + * This value should be in the range of @ref rte_event_dev_info.min_dequeue_timeout_ns and + * @ref rte_event_dev_info.max_dequeue_timeout_ns returned by + * @ref rte_event_dev_info_get() * The value 0 is allowed, in which case, default dequeue timeout used. * @see RTE_EVENT_DEV_CFG_PER_DEQUEUE_TIMEOUT */ @@ -517,40 +517,53 @@ struct rte_event_dev_config { /**< In a *closed system* this field is the limit on maximum number of * events that can be inflight in the eventdev at a given time. The * limit is required to ensure that the finite space in a closed system - * is not overwhelmed. The value cannot exceed the *max_num_events* - * as provided by rte_event_dev_info_get(). - * This value should be set to -1 for *open system*. + * is not exhausted. + * The value cannot exceed @ref rte_event_dev_info.max_num_events + * returned by rte_event_dev_info_get(). + * + * This value should be set to -1 for *open systems*, that is, + * those systems returning -1 in @ref rte_event_dev_info.max_num_events. + * + * @see rte_event_port_conf.new_event_threshold */ uint8_t nb_event_queues; /**< Number of event queues to configure on this device. - * This value cannot exceed the *max_event_queues* which previously - * provided in rte_event_dev_info_get() + * This value *includes* any single-link queue-port pairs to be used. + * This value cannot exceed @ref rte_event_dev_info.max_event_queues + + * @ref rte_event_dev_info.max_single_link_event_port_queue_pairs + * returned by rte_event_dev_info_get(). + * The number of non-single-link queues i.e. this value less + * *nb_single_link_event_port_queues* in this struct, cannot exceed + * @ref rte_event_dev_info.max_event_queues */ uint8_t nb_event_ports; /**< Number of event ports to configure on this device. - * This value cannot exceed the *max_event_ports* which previously - * provided in rte_event_dev_info_get() + * This value *includes* any single-link queue-port pairs to be used. + * This value cannot exceed @ref rte_event_dev_info.max_event_ports + + * @ref rte_event_dev_info.max_single_link_event_port_queue_pairs + * returned by rte_event_dev_info_get(). + * The number of non-single-link ports i.e. this value less + * *nb_single_link_event_port_queues* in this struct, cannot exceed + * @ref rte_event_dev_info.max_event_ports */ uint32_t nb_event_queue_flows; - /**< Number of flows for any event queue on this device. - * This value cannot exceed the *max_event_queue_flows* which previously - * provided in rte_event_dev_info_get() + /**< Max number of flows needed for a single event queue on this device. + * This value cannot exceed @ref rte_event_dev_info.max_event_queue_flows + * returned by rte_event_dev_info_get() */ uint32_t nb_event_port_dequeue_depth; - /**< Maximum number of events can be dequeued at a time from an - * event port by this device. - * This value cannot exceed the *max_event_port_dequeue_depth* - * which previously provided in rte_event_dev_info_get(). + /**< Max number of events that can be dequeued at a time from an event port on this device. + * This value cannot exceed @ref rte_event_dev_info.max_event_port_dequeue_depth + * returned by rte_event_dev_info_get(). * Ignored when device is not RTE_EVENT_DEV_CAP_BURST_MODE capable. - * @see rte_event_port_setup() + * @see rte_event_port_setup() rte_event_dequeue_burst() */ uint32_t nb_event_port_enqueue_depth; - /**< Maximum number of events can be enqueued at a time from an - * event port by this device. - * This value cannot exceed the *max_event_port_enqueue_depth* - * which previously provided in rte_event_dev_info_get(). + /**< Maximum number of events can be enqueued at a time to an event port on this device. + * This value cannot exceed @ref rte_event_dev_info.max_event_port_enqueue_depth + * returned by rte_event_dev_info_get(). * Ignored when device is not RTE_EVENT_DEV_CAP_BURST_MODE capable. - * @see rte_event_port_setup() + * @see rte_event_port_setup() rte_event_enqueue_burst() */ uint32_t event_dev_cfg; /**< Event device config flags(RTE_EVENT_DEV_CFG_)*/ @@ -560,7 +573,7 @@ struct rte_event_dev_config { * queues; this value cannot exceed *nb_event_ports* or * *nb_event_queues*. If the device has ports and queues that are * optimized for single-link usage, this field is a hint for how many - * to allocate; otherwise, regular event ports and queues can be used. + * to allocate; otherwise, regular event ports and queues will be used. */ }; -- 2.39.2 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2024-03-14 00:09:21.130583909 +0000 +++ 0007-eventdev-improve-Doxygen-comments-on-configure-struc.patch 2024-03-14 00:09:20.569614348 +0000 @@ -1 +1 @@ -From 1203462c5ada21bdace88e009db5a8f17f88528a Mon Sep 17 00:00:00 2001 +From ad39899ad85f7e8035d9cd5e1a4ab86e5a683739 Mon Sep 17 00:00:00 2001 @@ -5,0 +6,2 @@ +[ upstream commit 1203462c5ada21bdace88e009db5a8f17f88528a ] + @@ -19 +20,0 @@ -Cc: stable@dpdk.org @@ -29 +30 @@ -index 9808889625..fb1c4429f0 100644 +index a90e23ac8b..695a1f636c 100644 @@ -32 +33 @@ -@@ -684,9 +684,9 @@ rte_event_dev_attr_get(uint8_t dev_id, uint32_t attr_id, +@@ -507,9 +507,9 @@ rte_event_dev_attr_get(uint8_t dev_id, uint32_t attr_id, @@ -45 +46 @@ -@@ -694,40 +694,53 @@ struct rte_event_dev_config { +@@ -517,40 +517,53 @@ struct rte_event_dev_config { @@ -119 +120 @@ -@@ -737,7 +750,7 @@ struct rte_event_dev_config { +@@ -560,7 +573,7 @@ struct rte_event_dev_config {