From patchwork Fri Jan 19 17:43:40 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 135997 X-Patchwork-Delegate: jerinj@marvell.com Return-Path: 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]) by inbox.dpdk.org (Postfix) with ESMTP id C8A7143901; Fri, 19 Jan 2024 18:44:41 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 1992F42DE0; Fri, 19 Jan 2024 18:44:13 +0100 (CET) Received: from mgamail.intel.com (mgamail.intel.com [192.198.163.12]) by mails.dpdk.org (Postfix) with ESMTP id 3930642DB2 for ; Fri, 19 Jan 2024 18:44:11 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1705686251; x=1737222251; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=L5m5miMiYE21agROvRXl0A3v7/+usNFxKwe9mRepIpA=; b=UXAQB83TDPTfzRsvq0P/WFKUO2qIKewNh6IzdR4FCWD6rQfrJuTYpLIz 9rpTDaPic7QmQDGKohpv4qCyVOjMDQKaCnMDvzoSSZ3RzqwcnGQ59g5vI IZ2h2wUJcw1m3r0GfMd4TrgOmGNbyT56U+9TXiYnSLYXvtkspfNJSNvGF 68smDCPlnSqRur86CacoX77LnYWmjupTMtpPUO91gT2E+vLktott6ouF6 A+31ityRgxmbS9QRRIr0k0bRTTyxBrrMPR1S4EzZM+TuujKZIHQnPlC9J gNt9R6fj4xgY3NB1yk4K+KzsHhJAqIIwJyydCeuCC0GZQ+76lz9fWE/2n Q==; X-IronPort-AV: E=McAfee;i="6600,9927,10957"; a="683704" X-IronPort-AV: E=Sophos;i="6.05,204,1701158400"; d="scan'208";a="683704" Received: from orsmga006.jf.intel.com ([10.7.209.51]) by fmvoesa106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 19 Jan 2024 09:44:10 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10957"; a="761177787" X-IronPort-AV: E=Sophos;i="6.05,204,1701158400"; d="scan'208";a="761177787" Received: from silpixa00400957.ir.intel.com (HELO silpixa00401385.ir.intel.com) ([10.237.214.26]) by orsmga006.jf.intel.com with ESMTP; 19 Jan 2024 09:44:07 -0800 From: Bruce Richardson To: dev@dpdk.org Cc: jerinj@marvell.com, mattias.ronnblom@ericsson.com, abdullah.sevincer@intel.com, sachin.saxena@oss.nxp.com, hemant.agrawal@nxp.com, pbhagavatula@marvell.com, pravin.pathak@intel.com, Bruce Richardson Subject: [PATCH v2 05/11] eventdev: improve function documentation for query fns Date: Fri, 19 Jan 2024 17:43:40 +0000 Message-Id: <20240119174346.108905-6-bruce.richardson@intel.com> X-Mailer: git-send-email 2.40.1 In-Reply-To: <20240119174346.108905-1-bruce.richardson@intel.com> References: <20240118134557.73172-1-bruce.richardson@intel.com> <20240119174346.108905-1-bruce.richardson@intel.com> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org General improvements to the doxygen docs for eventdev functions for querying basic information: * number of devices * id for a particular device * socket id of device * capability information for a device Signed-off-by: Bruce Richardson --- lib/eventdev/rte_eventdev.h | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/lib/eventdev/rte_eventdev.h b/lib/eventdev/rte_eventdev.h index 872f241df2..c57c93a22e 100644 --- a/lib/eventdev/rte_eventdev.h +++ b/lib/eventdev/rte_eventdev.h @@ -440,8 +440,7 @@ struct rte_event; */ /** - * Get the total number of event devices that have been successfully - * initialised. + * Get the total number of event devices available for application use. * * @return * The total number of usable event devices. @@ -456,8 +455,10 @@ rte_event_dev_count(void); * Event device name to select the event device identifier. * * @return - * Returns event device identifier on success. - * - <0: Failure to find named event device. + * Event device identifier (dev_id >= 0) on success. + * Negative error code on failure: + * - -EINVAL - input name parameter is invalid + * - -ENODEV - no event device found with that name */ int rte_event_dev_get_dev_id(const char *name); @@ -470,7 +471,8 @@ rte_event_dev_get_dev_id(const char *name); * @return * The NUMA socket id to which the device is connected or * a default of zero if the socket could not be determined. - * -(-EINVAL) dev_id value is out of range. + * -EINVAL on error, where the given dev_id value does not + * correspond to any event device. */ int rte_event_dev_socket_id(uint8_t dev_id); @@ -539,18 +541,20 @@ struct rte_event_dev_info { }; /** - * Retrieve the contextual information of an event device. + * Retrieve details of an event device's capabilities and configuration limits. * * @param dev_id * The identifier of the device. * * @param[out] dev_info * A pointer to a structure of type *rte_event_dev_info* to be filled with the - * contextual information of the device. + * information about the device's capabilities. * * @return - * - 0: Success, driver updates the contextual information of the event device - * - <0: Error code returned by the driver info get function. + * - 0: Success, information about the event device is present in dev_info. + * - <0: Failure, error code returned by the function. + * - -EINVAL - invalid input parameters, e.g. incorrect device id + * - -ENOTSUP - device does not support returning capabilities information */ int rte_event_dev_info_get(uint8_t dev_id, struct rte_event_dev_info *dev_info);