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 164C643BDF; Mon, 26 Feb 2024 06:01:59 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B56C7402B2; Mon, 26 Feb 2024 06:01:58 +0100 (CET) Received: from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com [67.231.148.174]) by mails.dpdk.org (Postfix) with ESMTP id B55DC40271 for ; Mon, 26 Feb 2024 06:01:55 +0100 (CET) Received: from pps.filterd (m0045849.ppops.net [127.0.0.1]) by mx0a-0016f401.pphosted.com (8.17.1.24/8.17.1.24) with ESMTP id 41PMk1Yk012344; Sun, 25 Feb 2024 21:01:54 -0800 Received: from nam12-bn8-obe.outbound.protection.outlook.com (mail-bn8nam12lp2169.outbound.protection.outlook.com [104.47.55.169]) by mx0a-0016f401.pphosted.com (PPS) with ESMTPS id 3wfepr4242-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Sun, 25 Feb 2024 21:01:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=MRflt3bThMaCoeIC7AwfYiAcIHCcqaXXIT/iBzg3ww5fKLK64tnDJ2j2oNzby9O77GlWvSJDckf8VKveYZcoguR1Qda8dvMLduZco4qRhqT375lJUUL6c94nVcu10ffvpPCZWZHnrB8EFtpL14IoFAZuW07zlFGp8PgAPeEHD+XzaCdx+OPuW1PFnhsbBqL+/K4bXBcAhMZ52YxIha0FQ0GzjCCnCDHSXoE1N3ALdfPDphWY8esBOXUqY+TATEMC6Y+8FZHMtLn0z9nhb5KcbFyJpaZF+JzO4oQaiEN3zbFzP8mJDo9DUbmw7zUBqLtgupQ4dGu2GBjWGya1o7bPqw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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; bh=I+ZXC2P7+/ICXMtNFJ/UWBhuoIV4HoH5tOF9u9RsXek=; b=Gdq5MomW9qTC7pCgSpiR0iyuCYbGojZxDR0TvbU0H3zJaq2hb0EVgMl8qTubW20KfrIk3Os4e82kDPLWHElpWeKHOu9Im3QooKy5wGrYwCDjVMWR1kLn/79WarnJX0e61BXVIXQVsjpXl3TjhslD3AVtHa2em1nbjc0K269jHb2uxKbxx3c4rF8V0x/YDuR3yiv2tKAJAlgO0oEG+b/2BnuBhSWoclqLZxn9LOV2jBhAkGkYWSmHAgUu8UWRQWpsnITzHDxEQpZKRNfpHvXD+HYW7hSHunLNVOCLz4SSBrRqNS4y6RoSQkHn/fS4amjg+hEY8cPwJMipgrgnu08w4A== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=marvell.com; dmarc=pass action=none header.from=marvell.com; dkim=pass header.d=marvell.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.onmicrosoft.com; s=selector1-marvell-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=I+ZXC2P7+/ICXMtNFJ/UWBhuoIV4HoH5tOF9u9RsXek=; b=RqttvM+G7XG261KghnZPNJ1gDHBNNzs+sslP0jE7MvJX1YsU2WSMEYtitL1o2XmMJQtMrJJwAAwZezo9X/ddSJOrNGrqVUc4cwsZwMiGZurBPzcOj7XTY2gF82+Y7EuaYeCifTgqCbT7oAgB3Jln5Bxy5Y4q/EXMnWFXBsz6ge8= Received: from PH0PR18MB4086.namprd18.prod.outlook.com (2603:10b6:510:3::9) by SJ0PR18MB5111.namprd18.prod.outlook.com (2603:10b6:a03:43a::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7316.34; Mon, 26 Feb 2024 05:01:49 +0000 Received: from PH0PR18MB4086.namprd18.prod.outlook.com ([fe80::baf5:a4b6:7776:10f4]) by PH0PR18MB4086.namprd18.prod.outlook.com ([fe80::baf5:a4b6:7776:10f4%6]) with mapi id 15.20.7316.034; Mon, 26 Feb 2024 05:01:49 +0000 From: Pavan Nikhilesh Bhagavatula To: Bruce Richardson , "dev@dpdk.org" , Jerin Jacob , "mattias.ronnblom@ericsson.com" Subject: RE: [EXT] [PATCH v4 02/12] eventdev: move text on driver internals to proper section Thread-Topic: [EXT] [PATCH v4 02/12] eventdev: move text on driver internals to proper section Thread-Index: AQHaZLFQsVFvZOrxV0adzZ5FZXUAt7EcGEWQ Date: Mon, 26 Feb 2024 05:01:49 +0000 Message-ID: References: <20240119174346.108905-1-bruce.richardson@intel.com> <20240221103221.933238-1-bruce.richardson@intel.com> <20240221103221.933238-3-bruce.richardson@intel.com> In-Reply-To: <20240221103221.933238-3-bruce.richardson@intel.com> Accept-Language: en-US, en-IN Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: PH0PR18MB4086:EE_|SJ0PR18MB5111:EE_ x-ms-office365-filtering-correlation-id: 37455ba7-4617-447a-fce5-08dc36880a3a x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: tErdi6P3dHKxYjNbD3n4e2c7KWYnBr/KzyljK3OwS18rUKg5piP6nvbQ66WL7G3lQJfgJDlQFFpqZxCP8OKSgAtY1M/WxJGW920JFCqiGEpHd54PW/vVcWqcWvsidYi+WDn5CPpbqXJFJPxe7rOmH8yyuWRW1PIgXhGh258inldTB6P+xJcWLf72A7P81JcNZXov7k7zTuYnoVAoMswf8YQq7IMIXdaWk7onNngwqNDhk5KNkWy9TZqx6AGqJD+mXQi4JSHONFPK7FA1OC7DnDFLdUDhjV1/aVVFQqHtY3cO4ViNj4g1WvPcXUdNf5O0T1WjA2roohEMSqfTi2Z3gYWTnx5CZBJwe2iRZMOrPjIMjIV7WILjFc0XnhGEcUlUT5hRW3wa10fIQaRj7f4WO8dJwEy41JJNF9FTA2Pq+VUGERDMTw9dD9hQkKk7v6PLHC1WOFTkFt8iNc4GgIaDT3X3BlcQ6VN0RpZMA8wQHR7O9WX7kBGdntFKAaOnzuvQ2WUCtOGO5aAi8TTMIpshBjDjf6Ub8XzkLRU2sB3J5DJmQijbC0x1GKOFFwaH7jkrD/723gcMj/GmTtKV8XI6kwCSiKqSUorJvsCTWmnT7zUThChpcGqI5QcwONGyq41oPOKJ3EbD38e6q+X/f+PWSQP6I8VzgS/VBcrOPA6bnG9Ve09t+PvfENVPYq1A6apremTUfxS5BEyTIHVecL4DTYQojvpnF+Zyx83ScZxYfVM= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:PH0PR18MB4086.namprd18.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230031)(38070700009); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?/eJOVju7HrL69Z5qwyAehheZEyEJPAGcEvKE66uFIeSYutW/Z89b37P/7hYq?= =?us-ascii?Q?sDDuU5l2V0cWxaaq3gwYmJ0r2Y7UOtdNpylnIGQta+UdqWrKXYHxyMJ38DWh?= =?us-ascii?Q?X6VB895iBguEI68WVtn1MdvVlZVNaOlSrdy8/RLNAqeP2fsTpzD4nmVUFkaC?= =?us-ascii?Q?R6V9nWTvQYUFzO+vzCQKRB/i6o7kVlOtZBZhRE5Nev1t9GmCh3WW14VlPgcH?= =?us-ascii?Q?YO+xZO4d4QPfnJj9qWZ4uC/nHFR3eNmR34HM7qj7mmwtOeOYlkXqVTJLnduA?= =?us-ascii?Q?yjmzzF86eWKM9YvbCIzYohW8HgSrEJF9BV3GWP0NOq6+FnXdWglGvu6+uv+o?= =?us-ascii?Q?8iOPYAceTLWOM0DODQKa49vFmC/0kjWz8rNc9ioZxAXQL+9G0C5MphmomByN?= =?us-ascii?Q?aJ6tYkE2erRrGMpwXe7GI9B9LICrAQQYIgiUp/uvsuW+vM8SrtO8uIpcO8Sx?= =?us-ascii?Q?MqIMR92RqldA9Zz5Q4o48k6FLoTNiVe2+HUl7Eplm/bt5DUTwPFLnSVHkgEa?= =?us-ascii?Q?tXjORKO3LZVn+NfeJuKJUd9RJRWteZhkVKL90RlBlDg7DY5Gs0nePPLwK6SM?= =?us-ascii?Q?u+20rQr5Vm1LF++LuOqONBKXvt6YytiPMZJNBHG+r6hG06YX4z0+Slii18W3?= =?us-ascii?Q?nDRUeGPx5qO2ovpMxjd2ZGN5hqZIaLJrNecOf72hX5n+VAIugE/UCINmPLZ/?= =?us-ascii?Q?9ukXyLA66bfV6LiNajq5RcpxKWeznT/q7nCEObtU84sP1YfGOiLO3BB3c9Lo?= =?us-ascii?Q?wblgCTB+SIFXGX4zoh+gTZqKY8ca0Wv0jxQ/AdQQ09q0nPgOXpc9kDHovVMQ?= =?us-ascii?Q?eOR6wN3TTsT0E+pNWr1VF7tF+5dvutQqTyZIHggkOlkXFe1gjB59KPafntIo?= =?us-ascii?Q?H0s29Qy0zfLe8uZ2R2416amqQ84m333AcCYxOfpOlzlYsxwyB+Zjj3NVIGDF?= =?us-ascii?Q?4W/aVtaCEworierGXWEXrxc27/Y95sXJzYA0CJCTU49F6dtZig+dYET1eEuK?= =?us-ascii?Q?S4PyaKPe0w0pYV6H2z/xsTTDuPjjSinZyP+qpMheVIllV2BVEeruzsJAM2MP?= =?us-ascii?Q?Ac2OjQHsri/5NvFfnYZG2pEDW73gWhYoOSan6xjLj4FQkFGiI7Mmi4aoL4EA?= =?us-ascii?Q?sP6TTrwjjfKYU1NyN3JLRNR3HVkGSNwvrqY5QsSS9WcPAlzeXytbzzkLvcYy?= =?us-ascii?Q?YIBI9owtsEEywOAaxvl7YoXbIttXe+esTFdfV38CpI9k6ITh+DSjm7aWLjbw?= =?us-ascii?Q?4pKeNA13xDnjaDO4QIlUA1hKevgwtQxA9k0bVZruKvHw/ghKnpdZVirKFz+V?= =?us-ascii?Q?yHyhAATd2ejKaW+tm/nWyXUGC28ranfIfjzCy3wWUSlwCSqUSVVP6d0oJPbk?= =?us-ascii?Q?iq1J9HT6v0d5hOvwpH2PnpE2RnWakoQDIjPxYiug5rNLv6Dm2bxY78JIZmUZ?= =?us-ascii?Q?k5RSxTWQh0w92tB81Q4miX0TbTdelDZ3JgeBZPDgPkhkdJxboRejCxMK/k8d?= =?us-ascii?Q?k5kec0uKwCADbOVThX+I9xqMUpq1Kuphm9dEXi5RIs02kqWu4JpyU/1SfTVc?= =?us-ascii?Q?0on5S9zYYaY4B1PtIVf7umM5F3rDcpzf0cIIauT2?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: marvell.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: PH0PR18MB4086.namprd18.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 37455ba7-4617-447a-fce5-08dc36880a3a X-MS-Exchange-CrossTenant-originalarrivaltime: 26 Feb 2024 05:01:49.4353 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 70e1fb47-1155-421d-87fc-2e58f638b6e0 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: lPgPpP1ZReL2pWRm1d37vbZypQcucj2ESg3TJmRJz+ld4z44eqvqPnc3Yf1045czGkAlrzAq/xOcCpanaR08UN5ym+bCfpW9d1YmIVOnNf8= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SJ0PR18MB5111 X-Proofpoint-ORIG-GUID: w19PSkhc6wgsd8GMqA_FgiKEAnZhCu8l X-Proofpoint-GUID: w19PSkhc6wgsd8GMqA_FgiKEAnZhCu8l X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.1011,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2024-02-26_01,2024-02-23_01,2023-05-22_02 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 > Inside the doxygen introduction text, some internal details of how > eventdev works was mixed in with application-relevant details. Move > these details on probing etc. to the driver-relevant section. >=20 > Signed-off-by: Bruce Richardson Acked-by: Pavan Nikhilesh > --- > lib/eventdev/rte_eventdev.h | 32 ++++++++++++++++---------------- > 1 file changed, 16 insertions(+), 16 deletions(-) >=20 > diff --git a/lib/eventdev/rte_eventdev.h b/lib/eventdev/rte_eventdev.h > index 985286c616..c2782b2e30 100644 > --- a/lib/eventdev/rte_eventdev.h > +++ b/lib/eventdev/rte_eventdev.h > @@ -124,22 +124,6 @@ > * In all functions of the Event API, the Event device is > * designated by an integer >=3D 0 named the device identifier *dev_id* > * > - * At the Event driver level, Event devices are represented by a generic > - * data structure of type *rte_event_dev*. > - * > - * Event devices are dynamically registered during the PCI/SoC device pr= obing > - * phase performed at EAL initialization time. > - * When an Event device is being probed, an *rte_event_dev* structure is > allocated > - * for it and the event_dev_init() function supplied by the Event driver > - * is invoked to properly initialize the device. > - * > - * The role of the device init function is to reset the device hardware = or > - * to initialize the software event driver implementation. > - * > - * If the device init operation is successful, the device is assigned a = device > - * id (dev_id) for application use. > - * Otherwise, the *rte_event_dev* structure is freed. > - * > * The functions exported by the application Event API to setup a device > * must be invoked in the following order: > * - rte_event_dev_configure() > @@ -175,6 +159,22 @@ > * Driver-Oriented Event API > * ------------------------- > * > + * At the Event driver level, Event devices are represented by a generic > + * data structure of type *rte_event_dev*. > + * > + * Event devices are dynamically registered during the PCI/SoC device pr= obing > + * phase performed at EAL initialization time. > + * When an Event device is being probed, an *rte_event_dev* structure is > allocated > + * for it and the event_dev_init() function supplied by the Event driver > + * is invoked to properly initialize the device. > + * > + * The role of the device init function is to reset the device hardware = or > + * to initialize the software event driver implementation. > + * > + * If the device init operation is successful, the device is assigned a = device > + * id (dev_id) for application use. > + * Otherwise, the *rte_event_dev* structure is freed. > + * > * Each function of the application Event API invokes a specific functio= n > * of the PMD that controls the target device designated by its device > * identifier. > -- > 2.40.1