Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/115986/?format=api
{ "id": 115986, "url": "https://patches.dpdk.org/api/patches/115986/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/20220906161352.296110-6-mattias.ronnblom@ericsson.com/", "project": { "id": 1, "url": "https://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": "<20220906161352.296110-6-mattias.ronnblom@ericsson.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20220906161352.296110-6-mattias.ronnblom@ericsson.com", "date": "2022-09-06T16:13:52", "name": "[6/6] service: provide links to functions in documentation", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "dbbd2cf20de66f94429544e1a10fb18314924009", "submitter": { "id": 1077, "url": "https://patches.dpdk.org/api/people/1077/?format=api", "name": "Mattias Rönnblom", "email": "mattias.ronnblom@ericsson.com" }, "delegate": { "id": 24651, "url": "https://patches.dpdk.org/api/users/24651/?format=api", "username": "dmarchand", "first_name": "David", "last_name": "Marchand", "email": "david.marchand@redhat.com" }, "mbox": "https://patches.dpdk.org/project/dpdk/patch/20220906161352.296110-6-mattias.ronnblom@ericsson.com/mbox/", "series": [ { "id": 24564, "url": "https://patches.dpdk.org/api/series/24564/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=24564", "date": "2022-09-06T16:13:49", "name": "[1/6] service: reduce statistics overhead for parallel services", "version": 1, "mbox": "https://patches.dpdk.org/series/24564/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/115986/comments/", "check": "warning", "checks": "https://patches.dpdk.org/api/patches/115986/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 mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 047A5A0542;\n\tTue, 6 Sep 2022 18:17:06 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 8E3E642905;\n\tTue, 6 Sep 2022 18:16:40 +0200 (CEST)", "from EUR04-HE1-obe.outbound.protection.outlook.com\n (mail-eopbgr70059.outbound.protection.outlook.com [40.107.7.59])\n by mails.dpdk.org (Postfix) with ESMTP id 087804282D\n for <dev@dpdk.org>; Tue, 6 Sep 2022 18:16:38 +0200 (CEST)", "from AS8P189CA0046.EURP189.PROD.OUTLOOK.COM (2603:10a6:20b:458::18)\n by AM6PR07MB6134.eurprd07.prod.outlook.com (2603:10a6:20b:28::27)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5612.12; Tue, 6 Sep\n 2022 16:16:36 +0000", "from VE1EUR02FT013.eop-EUR02.prod.protection.outlook.com\n (2603:10a6:20b:458:cafe::9f) by AS8P189CA0046.outlook.office365.com\n (2603:10a6:20b:458::18) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5588.10 via Frontend\n Transport; Tue, 6 Sep 2022 16:16:36 +0000", "from oa.msg.ericsson.com (192.176.1.74) by\n VE1EUR02FT013.mail.protection.outlook.com (10.152.12.142) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id\n 15.20.5588.10 via Frontend Transport; Tue, 6 Sep 2022 16:16:36 +0000", "from ESESSMB502.ericsson.se (153.88.183.163) by\n ESESSMR506.ericsson.se (153.88.183.128) with Microsoft SMTP Server\n (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id\n 15.1.2375.31; Tue, 6 Sep 2022 18:16:32 +0200", "from seliicinfr00049.seli.gic.ericsson.se (153.88.183.153) by\n smtp.internal.ericsson.com (153.88.183.190) with Microsoft SMTP Server id\n 15.1.2375.31 via Frontend Transport; Tue, 6 Sep 2022 18:16:32 +0200", "from localhost.localdomain (seliicwb00002.seli.gic.ericsson.se\n [10.156.25.100])\n by seliicinfr00049.seli.gic.ericsson.se (Postfix) with ESMTP id E2B59380061;\n Tue, 6 Sep 2022 18:16:32 +0200 (CEST)" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=EdGo3MQqTHR+0zzrh2tXMfRlVuqaQ0g3+7Gt7CCRCctkG5MtBVogNw9EShWEzhQJjp+iXAVBuIeO9ziRhXFmxWs6i78vzJ+U6rFSGUNzxRPTPV9Yn8kKxorzm8v8dOxHPJZqV0vjyLBuuEq8b/ypJAsaqYoSWseXxIRB1Vby8Q9tp8jhKjDlNo+W+DAmT4+KilobufdXXen/lszDRq7oxorHzlXepIlxARhENmUUL/zLIKdTU8wz7a1tOXa7QsMVvfjPoQP4yZrfRuCTsqdPt/RYPDjyzFh5toCnq7d1z1B5AwPxa58fMpLL3V3w0/YR7LnLty9tm7Z5rTB5BCp5XA==", "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=2LS0P000MZ7yF1YZP1Cn00rREYWnihJtZCoXwThnuGs=;\n b=BoYSENSxo3onZzq4UryC6in5xIY7t99uGIcIU4ZG6xrIYH6rxJK3COfOdA9uZebRJvurDFj0ZGwUAAKSrYju3zYPnQlzWXcfgpsuPBlcXCrSYghhbJBjv67q07Uy+2Xs6gQsXb6AMQU5zMajM+sBZV43xgLe8vCg3f21UFWzLpleezdBbByrlBwx+V1sxfPH3v0IYHFj0Si/fBsN+CNkD/Edvggr3kTjFIVDRu7quqzOrK8KPHkxo90lxHGMhNSu1KK6WXu3jjT2OKOMe4DXzXchQ4j2X6KCXEKIOEEn9YkRkHRrj9Q2UcAgAtFIUxqxbCClBjOIUZ1BmjceFUoZzA==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 192.176.1.74) smtp.rcpttodomain=arm.com smtp.mailfrom=ericsson.com;\n dmarc=pass (p=reject sp=reject pct=100) action=none header.from=ericsson.com;\n dkim=none (message not signed); arc=none", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com;\n s=selector1;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=2LS0P000MZ7yF1YZP1Cn00rREYWnihJtZCoXwThnuGs=;\n b=bTRlhqebCXuxDVFimOT9tS0WxiDB1/DapvGrh4mmAfIAaZlj/HRQrCxeZDLC0ttEcmRi+xsLB0XjH+ykaKfv+NGh0AhvjqtToENX9+r3ctj+aLZgg/zWdd/9rju0B7o0ZJpe2R/YoWkduHS0ZyWLP+MvHcpIWyjxvf8UQUQC6Tk=", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 192.176.1.74)\n smtp.mailfrom=ericsson.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=ericsson.com;", "Received-SPF": "Pass (protection.outlook.com: domain of ericsson.com designates\n 192.176.1.74 as permitted sender)\n receiver=protection.outlook.com;\n client-ip=192.176.1.74; helo=oa.msg.ericsson.com; pr=C", "From": "=?utf-8?q?Mattias_R=C3=B6nnblom?= <mattias.ronnblom@ericsson.com>", "To": "Van@dpdk.org, Haaren@dpdk.org, Harry <harry.van.haaren@intel.com>", "CC": "<dev@dpdk.org>, Honnappa Nagarahalli <Honnappa.Nagarahalli@arm.com>,\n\t=?utf-8?q?Morten_Br=C3=B8rup?= <mb@smartsharesystems.com>, nd <nd@arm.com>,\n\t=?utf-8?q?Mattias_R=C3=B6nnblom?= <mattias.ronnblom@ericsson.com>", "Subject": "[PATCH 6/6] service: provide links to functions in documentation", "Date": "Tue, 6 Sep 2022 18:13:52 +0200", "Message-ID": "<20220906161352.296110-6-mattias.ronnblom@ericsson.com>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20220906161352.296110-1-mattias.ronnblom@ericsson.com>", "References": "<20220708125645.3141464-2-harry.van.haaren@intel.com>\n <20220906161352.296110-1-mattias.ronnblom@ericsson.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"UTF-8\"", "Content-Transfer-Encoding": "8bit", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-Correlation-Id": "e4e2e420-a285-4da9-5066-08da90232bfa", "X-MS-TrafficTypeDiagnostic": "AM6PR07MB6134:EE_", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n 5TKQk1AQE/qthojjaeGUGhAAt8klo2e1sK3yu1v+ELPBjN8q5eNHJBWk3U5q9aN/kYpgkSlchnoslzZ8GCr5w7Z5BAycCrILksofsDsU3UArdIn8wlF3uyBGKG+fu9DOhp6RDHV7iQkbN/BzQw8CJioutJrlQgF+4weMDLgt94XhcL5JoU0+j3e5x86zQDARri1PJYWn0KyMm2qSjeA3nERI3oOogBx7vxyfj+LQwsUNKFmz0zZ+co7I+e231oRSi2EH806vqtVCMx5cP3OuBjKGbLiVD8irHxium3jjcOb+dvPt9elqtCjJiS0aEAUAub8ywv8bqSNKMHZV9LFhs9ONUlZ4ah66hKOUTfW97scpzuAPxxOVOT7X7GYT96AMjytr+Db5iSeq9AbcMYKqRbhJGGh11XiYNuEYwDbg+tkOTRGfUoKye+p5jVdxa6wA6CIVZGuwcPVewH7e5svy6HGL30ncwnMbzUn3A0kU/GB/3bpp+Eiyq72HGDXnMf10NJKniN73fRbc9FxWLTL1ww4Y7wXlT1HTDZkiDszq2eEHoVfBHeS9n36QjvXzunRZOaX82WZXALKNpZXpfChP3u541UTTffdnkGHZZEgCIcRfPJAzXLWXY6Ebf5r5b4WM1semk57NbLTaqfC+TBUjWwODncKXYUEwZx4mrOa625PwBaLBTVkZdAcSIw9pOAgn2ogbRlgGNJykSnE8AX1OtVhCeDpgyT+KAeAPe2vcyNTWdETjQJHsBnfNaxqG/Si0TUSNIUPhN956vBXGcL53Dg==", "X-Forefront-Antispam-Report": "CIP:192.176.1.74; CTRY:SE; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:oa.msg.ericsson.com; PTR:office365.se.ericsson.net;\n CAT:NONE;\n SFS:(13230016)(4636009)(346002)(376002)(39860400002)(136003)(396003)(40470700004)(36840700001)(46966006)(82960400001)(40460700003)(7636003)(356005)(36860700001)(8676002)(4326008)(82740400003)(70586007)(70206006)(6916009)(316002)(82310400005)(1076003)(2906002)(40480700001)(5660300002)(8936002)(2616005)(83380400001)(6266002)(186003)(336012)(66574015)(47076005)(54906003)(478600001)(26005)(6666004)(41300700001)(86362001)(107886003)(36756003);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "ericsson.com", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "AM6PR07MB6134", "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": "Refer to API functions with parenthesis, making doxygen create\nhyperlinks.\n\nSigned-off-by: Mattias Rönnblom <mattias.ronnblom@ericsson.com>\n---\n lib/eal/include/rte_service.h | 26 +++++++++++++-------------\n 1 file changed, 13 insertions(+), 13 deletions(-)", "diff": "diff --git a/lib/eal/include/rte_service.h b/lib/eal/include/rte_service.h\nindex 70deb6e53a..90116a773a 100644\n--- a/lib/eal/include/rte_service.h\n+++ b/lib/eal/include/rte_service.h\n@@ -37,7 +37,7 @@ extern \"C\" {\n \n /* Capabilities of a service.\n *\n- * Use the *rte_service_probe_capability* function to check if a service is\n+ * Use the rte_service_probe_capability() function to check if a service is\n * capable of a specific capability.\n */\n /** When set, the service is capable of having multiple threads run it at the\n@@ -147,13 +147,13 @@ int32_t rte_service_map_lcore_get(uint32_t service_id, uint32_t lcore);\n int32_t rte_service_runstate_set(uint32_t id, uint32_t runstate);\n \n /**\n- * Get the runstate for the service with *id*. See *rte_service_runstate_set*\n+ * Get the runstate for the service with *id*. See rte_service_runstate_set()\n * for details of runstates. A service can call this function to ensure that\n * the application has indicated that it will receive CPU cycles. Either a\n * service-core is mapped (default case), or the application has explicitly\n * disabled the check that a service-cores is mapped to the service and takes\n * responsibility to run the service manually using the available function\n- * *rte_service_run_iter_on_app_lcore* to do so.\n+ * rte_service_run_iter_on_app_lcore() to do so.\n *\n * @retval 1 Service is running\n * @retval 0 Service is stopped\n@@ -181,7 +181,7 @@ rte_service_may_be_active(uint32_t id);\n /**\n * Enable or disable the check for a service-core being mapped to the service.\n * An application can disable the check when takes the responsibility to run a\n- * service itself using *rte_service_run_iter_on_app_lcore*.\n+ * service itself using rte_service_run_iter_on_app_lcore().\n *\n * @param id The id of the service to set the check on\n * @param enable When zero, the check is disabled. Non-zero enables the check.\n@@ -216,7 +216,7 @@ int32_t rte_service_set_runstate_mapped_check(uint32_t id, int32_t enable);\n * atomics, applications can choose to enable or disable this feature\n *\n * Note that any thread calling this function MUST be a DPDK EAL thread, as\n- * the *rte_lcore_id* function is used to access internal data structures.\n+ * the rte_lcore_id() function is used to access internal data structures.\n *\n * @retval 0 Service was run on the calling thread successfully\n * @retval -EBUSY Another lcore is executing the service, and it is not a\n@@ -232,7 +232,7 @@ int32_t rte_service_run_iter_on_app_lcore(uint32_t id,\n *\n * Starting a core makes the core begin polling. Any services assigned to it\n * will be run as fast as possible. The application must ensure that the lcore\n- * is in a launchable state: e.g. call *rte_eal_lcore_wait* on the lcore_id\n+ * is in a launchable state: e.g. call rte_eal_lcore_wait() on the lcore_id\n * before calling this function.\n *\n * @retval 0 Success\n@@ -248,7 +248,7 @@ int32_t rte_service_lcore_start(uint32_t lcore_id);\n * service core. Note that the service lcore thread may not have returned from\n * the service it is running when this API returns.\n *\n- * The *rte_service_lcore_may_be_active* API can be used to check if the\n+ * The rte_service_lcore_may_be_active() API can be used to check if the\n * service lcore is * still active.\n *\n * @retval 0 Success\n@@ -265,7 +265,7 @@ int32_t rte_service_lcore_stop(uint32_t lcore_id);\n * Reports if a service lcore is currently running.\n *\n * This function returns if the core has finished service cores code, and has\n- * returned to EAL control. If *rte_service_lcore_stop* has been called but\n+ * returned to EAL control. If rte_service_lcore_stop() has been called but\n * the lcore has not returned to EAL yet, it might be required to wait and call\n * this function again. The amount of time to wait before the core returns\n * depends on the duration of the services being run.\n@@ -293,7 +293,7 @@ int32_t rte_service_lcore_add(uint32_t lcore);\n /**\n * Removes lcore from the list of service cores.\n *\n- * This can fail if the core is not stopped, see *rte_service_core_stop*.\n+ * This can fail if the core is not stopped, see rte_service_core_stop().\n *\n * @retval 0 Success\n * @retval -EBUSY Lcore is not stopped, stop service core before removing.\n@@ -308,7 +308,7 @@ int32_t rte_service_lcore_del(uint32_t lcore);\n * service core count can be used in mapping logic when creating mappings\n * from service cores to services.\n *\n- * See *rte_service_lcore_list* for details on retrieving the lcore_id of each\n+ * See rte_service_lcore_list() for details on retrieving the lcore_id of each\n * service core.\n *\n * @return The number of service cores currently configured.\n@@ -344,14 +344,14 @@ int32_t rte_service_set_stats_enable(uint32_t id, int32_t enable);\n * indicating the lcore_id of a service core.\n *\n * Adding and removing service cores can be performed using\n- * *rte_service_lcore_add* and *rte_service_lcore_del*.\n- * @param [out] array An array of at least *rte_service_lcore_count* items.\n+ * rte_service_lcore_add() and rte_service_lcore_del().\n+ * @param [out] array An array of at least rte_service_lcore_count() items.\n * If statically allocating the buffer, use RTE_MAX_LCORE.\n * @param [out] n The size of *array*.\n * @retval >=0 Number of service cores that have been populated in the array\n * @retval -ENOMEM The provided array is not large enough to fill in the\n * service core list. No items have been populated, call this function\n- * with a size of at least *rte_service_core_count* items.\n+ * with a size of at least rte_service_core_count() items.\n */\n int32_t rte_service_lcore_list(uint32_t array[], uint32_t n);\n \n", "prefixes": [ "6/6" ] }