From patchwork Wed Nov 8 17:40:53 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hemant Agrawal X-Patchwork-Id: 118295 Delivered-To: patch@linaro.org Received: by 10.140.22.164 with SMTP id 33csp5575869qgn; Wed, 8 Nov 2017 09:41:57 -0800 (PST) X-Google-Smtp-Source: ABhQp+RZaLX7uHKcypX5NgqcYZtuiaZK6oU5riqlLNVMDMVOujsAaeC/rqCq/ikfOks++prJI2XR X-Received: by 10.28.26.11 with SMTP id a11mr1130050wma.90.1510162917879; Wed, 08 Nov 2017 09:41:57 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1510162917; cv=none; d=google.com; s=arc-20160816; b=J4ZG8knhPsCZDtfG1LZkU7fRhRSTZng1qREYInjL8rv9mTD5o8hMti66LyNzwrTqzE r7YGojrhFidgg0n78rPO9V42FD04q07JEEHcV/de3/Wg4tXYCJ+VHb5glOF93sBcgyVX jpZCeSOuPkkNzr0EiCRAlyv5dpc6lUVmzt7ouufJwAbK8xDvIMIHnBPOj5JFFRtJ76ls GXzXVVeORV3FKwzER+7Ob8g/QBz1oyBAkUQaAGjfTZ+EOCT7IorUBkgcxkKhp5G7+fHq iQmUMpwg/crkiNIX/G5EbhUjYtaQf9UZ/2zQvvDO3uvQ2C8U1cRjqPo3Y3PXvJ7UqK0A 3bOg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:spamdiagnosticmetadata :spamdiagnosticoutput:mime-version:references:in-reply-to:message-id :date:cc:to:from:arc-authentication-results; bh=Z+kVKOmO5jE+ZP/4mbkwDYHbv6zf7ciiGW0O3vANxqY=; b=zU1Mye3lejkUcLyarzoI+u1zTQdMdrw1KSBDXApSHVJRxeFCyjWKhTtBXQRw5Q2WG5 fc0H4ts2b7hc4VEIFCCZcPDa4yZ6VJJqrWDjZvXxi9TMCP6GaRBB45Fy3rYc9wavOwOG vYpstwSheZeywNf+a/wzbTUrGnVa6XkE0jq20swfS6MSLfV7V2iHUWRs+ELt11V9otRd NtL00ulKf5NTzzi0G/z9pjQNyFjfvbw700xxDasM8NkL5dNoA7gWC1usyk4dgiFqZFmE I0QSy/lvcusdqjRzPegsGHJEP8E+yjhnYsrWtNTqxxrd1iNP6SW8PM7FuF8W7EpOmXuV NuKw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from dpdk.org (dpdk.org. [92.243.14.124]) by mx.google.com with ESMTP id t26si3940268wmc.238.2017.11.08.09.41.57; Wed, 08 Nov 2017 09:41:57 -0800 (PST) Received-SPF: pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) client-ip=92.243.14.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A24F01B22C; Wed, 8 Nov 2017 18:41:49 +0100 (CET) Received: from NAM02-SN1-obe.outbound.protection.outlook.com (mail-sn1nam02on0040.outbound.protection.outlook.com [104.47.36.40]) by dpdk.org (Postfix) with ESMTP id 3B6B21B2AE for ; Wed, 8 Nov 2017 18:41:47 +0100 (CET) Received: from CY1PR03CA0040.namprd03.prod.outlook.com (10.174.128.50) by CY4PR03MB2696.namprd03.prod.outlook.com (10.173.43.139) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.197.13; Wed, 8 Nov 2017 17:41:45 +0000 Received: from BN1AFFO11FD030.protection.gbl (2a01:111:f400:7c10::174) by CY1PR03CA0040.outlook.office365.com (2603:10b6:600::50) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.218.12 via Frontend Transport; Wed, 8 Nov 2017 17:41:45 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=nxp.com; NXP1.onmicrosoft.com; dkim=none (message not signed) header.d=none;NXP1.onmicrosoft.com; dmarc=fail action=none header.from=nxp.com; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BN1AFFO11FD030.mail.protection.outlook.com (10.58.52.168) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.178.5 via Frontend Transport; Wed, 8 Nov 2017 17:41:44 +0000 Received: from bf-netperf1.ap.freescale.net (bf-netperf1.ap.freescale.net [10.232.134.28]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id vA8HfcWA031926; Wed, 8 Nov 2017 10:41:41 -0700 From: Hemant Agrawal To: CC: , , Date: Wed, 8 Nov 2017 23:10:53 +0530 Message-ID: <1510162854-10171-2-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1510162854-10171-1-git-send-email-hemant.agrawal@nxp.com> References: <1510162854-10171-1-git-send-email-hemant.agrawal@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131546365046067692; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(7966004)(336005)(376002)(346002)(39380400002)(39860400002)(2980300002)(1109001)(1110001)(339900001)(199003)(189002)(77096006)(48376002)(53936002)(54906003)(6666003)(8936002)(8656006)(105606002)(6916009)(5003940100001)(106466001)(2950100002)(50986999)(97736004)(5890100001)(296002)(50226002)(498600001)(316002)(86362001)(50466002)(53946003)(47776003)(16586007)(2906002)(81166006)(5660300001)(305945005)(81156014)(85426001)(189998001)(76176999)(33646002)(36756003)(104016004)(2351001)(68736007)(356003)(8676002)(4326008)(21314002)(217873001)(559001)(579004); DIR:OUT; SFP:1101; SCL:1; SRVR:CY4PR03MB2696; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11FD030; 1:B1uA6xoTOSsG4JJjRGvTUCPEOLyVWa64HdMRS6Xt14n2TfIwyV1Y+dsfkGkcRISL3zp6qZ16pPtZ+hULXjTnCxIQMOd1KgdiERWUyLjK7KpNnH2/3aMpvrLjPtw7XNH4 MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: de8f225e-8d5d-4c66-91ec-08d526cffa87 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4628075)(201703131517081)(2017052603199); SRVR:CY4PR03MB2696; X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2696; 3:lrIMYuHywh8LjmPE0fE7j9+Y+qFSfvxMFxB7OjzecKlVfLq0KyClGce7aIpOwGzmjxJ9TJR4amfUK//AdX78ALVICMT/w9iu/ulrLdo3pi//vZWkTgagZBakmE8kxlx4B0XMhxu6NAsn3Wbx5cLmVRp0kTEJHkkALd5ysezRBOxCzQUEdBE9FVAgXD5Fmztcj63PbIrzZV2BBaCElYowHKBuNtWrtJTprZfsaK9rcy94PWTq+sTmyGAIgj0L7gBrtQKbfRRtCj2gDKAqcF3zXSVF4DklTLym/5TzTMdTPcklHrBIVVUTKZYrw1P/3t5wZJJupcJyqTWS6abuJHM9ecq53fyt1/6RBH5Ee4VpnXY=; 25:AqZ1rJFS1j+c+fKPkS4NuFsk7G4KSSFJb+HYfV7zLsTWkhcf4/chIWO70ovx1dr6ga2ESl/MBbxFva3CD4fWWQI2hI7tSF+Nfn1s7N3jye+5dn+CBBzoFj06GSldLIFYeXfCLLv4OQlrYS6SuAjrW80hPWAocECFm1CBiNpf7/0CwVuKOcwoyTUzJERas9xJNb6Lc9CBL3n5yzvuUeXqIs+U0vgFyvgNrtknD97VpLbmeCxw9LYlr4jo2+jir7EwZDnblStOEjct5rPymd/8NHJ2COP7h5MyIjn6cRcZE3KeKoVbfo7VKxdihIkpa8bhwFe2nu8G8pzqvV1r8Sbxlw== X-MS-TrafficTypeDiagnostic: CY4PR03MB2696: X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2696; 31:FAnUktdaIGlBEO4SQj0TtnZBPyKGinQlOO3yDc9PlqXuOJTpJfw+VxFTmg62aLgcT4cciv2jqcy2viVUTQZlvVbPS25KLuL206PLIRTAf20dmFVp/ncpbfI2vFLeDWe569kiuU3tE8vvdn9P/QmdGIH70/S4rY/+y/VjWa1RniYipEjEYp7qtgtcQnvFbtJK1XPZqplwjTnwI+MGi160s/Fkv0Sw13lcTjlQRSHpRx4=; 4:DJOQa+CRxtUy6RIwaw9SEqvjwlXIzIdVEoEMXRomrQBPays5xgWjH4OupRTiuQe2kD4z7sJoSdZ5hWmHYUqET/dmspey3Upr41osdNux6WwbxyMGcZ86ntrhOqlx9pqHy3tifjYficXV7S/3RGUjI+r8flQTL5ncrxnmYbSE93hypFTQtxSmctegg5jf3IAnZ/tamzSY6K2VL8xUnCeiCF0/V5dFEeIZ2nghJoQpO2wyK5QC6w5RAd/pid7pI9A78UvleD3+xANcKClSdDnOwT7rHZbE8DOso791U46yisDeHl4q4z+SKcfZ3E5c4v7m X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6095135)(2401047)(8121501046)(5005006)(3002001)(3231021)(10201501046)(100000703101)(100105400095)(93006095)(93001095)(6055026)(6096035)(20161123561025)(20161123556025)(20161123559100)(201703131430075)(201703131520075)(201703131433075)(201703131441075)(201703131448075)(201703161259150)(20161123565025)(20161123563025)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:CY4PR03MB2696; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(400006)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:CY4PR03MB2696; X-Forefront-PRVS: 0485417665 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CY4PR03MB2696; 23:Lh2EY6ZsPelvqoQc62ACvJ6l8sla/hrFqgo1HK0tg?= N7VFkcXT9pg4qDTbMU3K0ruVlhsJ2ki1TKAP7BDY5kXFa08oVwNYSYodaozqGbrWbdOhR5THrx+ASTZ9W5yiohtgcEg42qQgESLMRQ0aktuWSb+2ZWrIYOX7b9fd5Ah4vmO3g5sf0nOpltATB9u7/IhjBRXVjTowGYQRWDyg8yo9xatTbstXFWNOVADsQT366jEaG3pOV3Jhomn63rjc/ZM3CEYnfs8nRnDlNHYiEmkYPqPzl8OCb0aBz9/XASrwY6z5HNtvboM7u8597q3nGH9N7ySzZAfWgOsKzTHJsZu4n+OwYIloEsdG+VvwLwRW9B7IyGS22GRfpBAsICSD7dtrYIw62l4cm5XS8cQYv0P6tILfPn1YlKq8bg1hI32FlBXsUVfNpANigj5KChTFlrS33viVpuLdaZwX5DE9s1fcAays9Xcq/MdDCBpvet1UMxAaBsP9BzXP5UQt7nmxGjEKKYJm7dvbVwntww6WsrvkbZIt/aX4xnajGkd0/6XlaEpIXqK3ExnLMiCZ+NtdGhpvI3+taZpyqJvApptB6wUmq29enSCSV8kgy5VSyK9rwerEEWVZEzyhK7SkmxcYejUKrXcFfh5sLABjd/92Vr9lSV4Ia6fzdXGBfR0TXaWRDsxSfsxDAe17/YqaCU8uQMEG3Vo1pAh4F6p3EJ8qirC4rAUNM9R0ZpB290J5k/CvMZZb8Y8rcSNInuZMOejrMhuCPCSvQnYbNO7OWMIVSA1NxtoG/kmKHtw0CkrJw7RbShwF28m1Xaj34hh6e6pd0Zme0FXDqEQgJdm1o57xx0wL4AlSiyIk2IUFcBgwVDgyHjJgdH6Pia8EX2V2RxL8eEP2ciLI/ly3/XCbaiMHvQsqmwW9ge3aX+UWp49PX6FYRVwiTtA2CJjSVfQJoLfc9D2FdDCVGBv9SlX1GfwvkO3wRgqDhrMMr1cz9K3eVmK51b4tyOWOvaU5cl13kbDRXnQCMQBqZU46r2WuElRWvvzhc+V/Tsa7QhAMd/qSAmG+MnlTC+3s9rAhX/d/mqf/TddrJ0gTZQ0SS8cVtI26gFGAnunPZaDTEou6x+a+VnVCzUQ1a1RxJwOqs6hwMbpfSJH/RyCyiTbLpVnOSyR70w0H9pB6W/70xdUyUNU+o07LwngGMtJnEWFzCE3EtmWHNu93lH5x/T6SYZkzI7gRRf99aFhB6aV5acNILHfwfm28dMkkAGi9DWk0aPl0e0/wK/VKZCa8eRDJzvp2EKRQDPMp8doxSizuSAkUckmN1PZfVc= X-Microsoft-Exchange-Diagnostics: 1; CY4PR03MB2696; 6:Cr76Llx8oMAxCmLwDy3hVzybhV5Z/Ne3MkDSHwHJRVODAqXFBI7QhsAeumY/ECpnpTaqxXjbAG8nIGuKW+SIK3auOCbneTCqSkxOrRX7FRDh6tjS0QH5y9E7dv7wq+XhJZlsADbhVzjZ5HqGMbu0nesnrG2kUuJb2d/3HoaCD7mxc7r7LNnVFNsl58WSjYVDqpET3sw1w+8vu8KSy6aUWdh9K72ps/VL+uuUf0K5qC5xhAgVXwbCNbKywalRp64/yFR0WO4oFeo4Y8T1o+2KWGlhjVJUs0LwsqENpLP2A+qNkh02q4EMcJycYcgUbu37w4FsLWYhBsSc5eJt/+sm8eh9nYh7Lqq/b8ZZm/6ISoM=; 5:CoJobf+YhbAs/4j0muagSm29wdwqqoIuIy+0hnvTbwNJ+wC2KtSMe5wB7V7N8xTPu1fkKbqtLPsqi+9ogpgmSxNa3R4rpnfEZ8IJWdIU3KwEHIdzwnLuwTdcAVD0LcO4CFmrrVGeJNVW2lyfjHLFfW3pWF+HBRPP21+grbsQav4=; 24:VTNNXlFjW8T7c3QWeuIK9NRsw3u7OtkzBtdlV8ILNUMdwqnDlEfXhMTr5IZgxUq10ZQ+pDtmlUwa8N9vTbsby/bzGNUsgrnulLVJPUrMsw0=; 7:+fA8ivizoEWfXOU+5GFMfWJ/rpdQs4dgvedqmqDzPmMiSKwYnmerE/5Pr+r5IYg+hJ5ugxJWJlrEE8QJuVr0Wq47KrsE/TmrIG0i2iAaNH/2ehS76OlOVqdDHbdE/okeLq67rp1qpKBbRb+F+QgaWav1oVb9Hcxp9x6xwjMMbSIO1GJCqRUvr4MCyd9gBAie15LEI7UVvZ8tWKE9JNVWtR/hP/VcazRkcIGDnaFwsrec1gCYdk9slBu/WkqxD8jA SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Nov 2017 17:41:44.4351 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: de8f225e-8d5d-4c66-91ec-08d526cffa87 X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CY4PR03MB2696 Subject: [dpdk-dev] [RFC PATCH 1/2] lib: introduce raw device library X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Raw device is a generalized interface for expanding non-generic devices into DPDK framework. This library provides primitive interfaces which enable creation of raw devices. Signed-off-by: Hemant Agrawal --- lib/librte_rawdev/Makefile | 53 +++ lib/librte_rawdev/rte_rawdev.c | 626 +++++++++++++++++++++++++++++++ lib/librte_rawdev/rte_rawdev.h | 524 ++++++++++++++++++++++++++ lib/librte_rawdev/rte_rawdev_pmd.h | 540 ++++++++++++++++++++++++++ lib/librte_rawdev/rte_rawdev_version.map | 28 ++ 5 files changed, 1771 insertions(+) create mode 100644 lib/librte_rawdev/Makefile create mode 100644 lib/librte_rawdev/rte_rawdev.c create mode 100644 lib/librte_rawdev/rte_rawdev.h create mode 100644 lib/librte_rawdev/rte_rawdev_pmd.h create mode 100644 lib/librte_rawdev/rte_rawdev_version.map -- 2.7.4 diff --git a/lib/librte_rawdev/Makefile b/lib/librte_rawdev/Makefile new file mode 100644 index 0000000..a2b22a1 --- /dev/null +++ b/lib/librte_rawdev/Makefile @@ -0,0 +1,53 @@ +# BSD LICENSE +# +# Copyright 2017 NXP +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions +# are met: +# +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# * Redistributions in binary form must reproduce the above copyright +# notice, this list of conditions and the following disclaimer in +# the documentation and/or other materials provided with the +# distribution. +# * Neither the name of NXPnor the names of its +# contributors may be used to endorse or promote products derived +# from this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +include $(RTE_SDK)/mk/rte.vars.mk + +# library name +LIB = librte_rawdev.a + +# library version +LIBABIVER := 1 + +# build flags +CFLAGS += -O3 +CFLAGS += $(WERROR_FLAGS) +LDLIBS += -lrte_eal -lrte_mempool -lrte_ring -lrte_mbuf + +# library source files +SRCS-y += rte_rawdev.c + +# export include files +SYMLINK-y-include += rte_rawdev.h + +# versioning export map +EXPORT_MAP := rte_rawdev_version.map + +include $(RTE_SDK)/mk/rte.lib.mk diff --git a/lib/librte_rawdev/rte_rawdev.c b/lib/librte_rawdev/rte_rawdev.c new file mode 100644 index 0000000..1269193 --- /dev/null +++ b/lib/librte_rawdev/rte_rawdev.c @@ -0,0 +1,626 @@ +/* + * BSD LICENSE + * + * Copyright 2017 NXP + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * * Neither the name of NXPnor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include "rte_rawdev.h" +#include "rte_rawdev_pmd.h" + +#define RTE_RAW_MAX_DEVS 2 + +struct rte_rawdev rte_rawdevices[RTE_RAW_MAX_DEVS]; + +struct rte_rawdev *rte_rawdevs = &rte_rawdevices[0]; + +static struct rte_rawdev_global rawdev_globals = { + .nb_devs = 0 +}; + +struct rte_rawdev_global *rte_rawdev_globals = &rawdev_globals; + +/* Event dev north bound API implementation */ + +uint8_t +rte_rawdev_count(void) +{ + return rte_rawdev_globals->nb_devs; +} + +int +rte_rawdev_get_dev_id(const char *name) +{ + int i; + + if (!name) + return -EINVAL; + + for (i = 0; i < rte_rawdev_globals->nb_devs; i++) + if ((strcmp(rte_rawdevices[i].data->name, name) + == 0) && + (rte_rawdevices[i].attached == + RTE_RAWDEV_ATTACHED)) + return i; + return -ENODEV; +} + +int +rte_rawdev_socket_id(uint16_t dev_id) +{ + struct rte_rawdev *dev; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + + return dev->data->socket_id; +} + +int +rte_rawdev_info_get(uint16_t dev_id, struct rte_rawdev_info *dev_info) +{ + struct rte_rawdev *dev; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + + if (dev_info == NULL) + return -EINVAL; + + memset(dev_info, 0, sizeof(struct rte_rawdev_info)); + + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP); + (*dev->dev_ops->dev_infos_get)(dev, dev_info); + + dev_info->dev = dev->dev; + if (dev->driver) + dev_info->driver_name = dev->driver->name; + return 0; +} + +static inline int +rte_rawdev_queue_config(struct rte_rawdev *dev __rte_unused, + uint8_t nb_queues __rte_unused) +{ + /* to be done */ + return 0; +} + +int +rte_rawdev_configure(uint16_t dev_id, void *dev_conf) +{ + struct rte_rawdev *dev; + struct rte_rawdev_info info; + int diag; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_infos_get, -ENOTSUP); + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_configure, -ENOTSUP); + + if (dev->data->dev_started) { + RTE_RDEV_LOG_ERR( + "device %d must be stopped to allow configuration", dev_id); + return -EBUSY; + } + + if (dev_conf == NULL) + return -EINVAL; + + (*dev->dev_ops->dev_infos_get)(dev, &info); + + /* Configure the device */ + diag = (*dev->dev_ops->dev_configure)(dev); + if (diag != 0) + RTE_RDEV_LOG_ERR("dev%d dev_configure = %d", dev_id, diag); + + return diag; +} + +int +rte_rawdev_queue_conf_get(uint16_t dev_id, uint8_t queue_id, void *queue_conf) +{ + struct rte_rawdev *dev; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + + if (queue_conf == NULL) + return -EINVAL; + + + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_def_conf, -ENOTSUP); + (*dev->dev_ops->queue_def_conf)(dev, queue_id, queue_conf); + return 0; +} + + +int +rte_rawdev_queue_setup(uint16_t dev_id, uint8_t queue_id, void *queue_conf) +{ + struct rte_rawdev *dev; + void *def_conf; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + + if (queue_conf == NULL) { + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->queue_def_conf, + -ENOTSUP); + (*dev->dev_ops->queue_def_conf)(dev, queue_id, &def_conf); + queue_conf = &def_conf; + } + + return (*dev->dev_ops->queue_setup)(dev, queue_id, queue_conf); +} + +uint8_t +rte_rawdev_queue_count(uint16_t dev_id) +{ + struct rte_rawdev *dev; + + dev = &rte_rawdevs[dev_id]; + return dev->data->nb_queues; +} + +int +rte_rawdev_dump(uint16_t dev_id, FILE *f) +{ + struct rte_rawdev *dev; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dump, -ENOTSUP); + + (*dev->dev_ops->dump)(dev, f); + return 0; + +} + +static int +xstats_get_count(uint16_t dev_id, enum rte_rawdev_xstats_mode mode, + uint8_t queue_port_id) +{ + struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + if (dev->dev_ops->xstats_get_names != NULL) + return (*dev->dev_ops->xstats_get_names)(dev, mode, + queue_port_id, + NULL, NULL, 0); + return 0; +} + +int +rte_rawdev_xstats_names_get(uint16_t dev_id, + enum rte_rawdev_xstats_mode mode, uint8_t queue_port_id, + struct rte_rawdev_xstats_name *xstats_names, + unsigned int *ids, unsigned int size) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -ENODEV); + const int cnt_expected_entries = xstats_get_count(dev_id, mode, + queue_port_id); + if (xstats_names == NULL || cnt_expected_entries < 0 || + (int)size < cnt_expected_entries) + return cnt_expected_entries; + + /* dev_id checked above */ + const struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + + if (dev->dev_ops->xstats_get_names != NULL) + return (*dev->dev_ops->xstats_get_names)(dev, mode, + queue_port_id, xstats_names, ids, size); + + return -ENOTSUP; +} + +/* retrieve rawdev extended statistics */ +int +rte_rawdev_xstats_get(uint16_t dev_id, enum rte_rawdev_xstats_mode mode, + uint8_t queue_port_id, const unsigned int ids[], + uint64_t values[], unsigned int n) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -ENODEV); + const struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + + /* implemented by the driver */ + if (dev->dev_ops->xstats_get != NULL) + return (*dev->dev_ops->xstats_get)(dev, mode, queue_port_id, + ids, values, n); + return -ENOTSUP; +} + +uint64_t +rte_rawdev_xstats_by_name_get(uint16_t dev_id, const char *name, + unsigned int *id) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, 0); + const struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + unsigned int temp = -1; + + if (id != NULL) + *id = (unsigned int)-1; + else + id = &temp; /* ensure driver never gets a NULL value */ + + /* implemented by driver */ + if (dev->dev_ops->xstats_get_by_name != NULL) + return (*dev->dev_ops->xstats_get_by_name)(dev, name, id); + return -ENOTSUP; +} + +int +rte_rawdev_xstats_reset(uint16_t dev_id, + enum rte_rawdev_xstats_mode mode, int16_t queue_port_id, + const uint32_t ids[], uint32_t nb_ids) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + + if (dev->dev_ops->xstats_reset != NULL) + return (*dev->dev_ops->xstats_reset)(dev, mode, queue_port_id, + ids, nb_ids); + return -ENOTSUP; +} + +int +rte_rawdev_firmware_status_get(uint16_t dev_id, void *status_info) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + + if (dev->dev_ops->firmware_status_get != NULL) + return (*dev->dev_ops->firmware_status_get)(dev, status_info); + + return -ENOTSUP; +} + +int +rte_rawdev_firmware_version_get(uint16_t dev_id, void *version_info) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + + if (dev->dev_ops->firmware_version_get != NULL) + return (*dev->dev_ops->firmware_status_get)(dev, version_info); + + return -ENOTSUP; +} + +int +rte_rawdev_firmware_load(uint16_t dev_id, void *firmware_image) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + + if (!firmware_image) + return -EINVAL; + + if (dev->dev_ops->firmware_load != NULL) + return (*dev->dev_ops->firmware_load)(dev, firmware_image); + + return -ENOTSUP; +} + +int +rte_rawdev_firmware_unload(uint16_t dev_id) +{ + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + struct rte_rawdev *dev = &rte_rawdevs[dev_id]; + + if (dev->dev_ops->firmware_unload != NULL) + return (*dev->dev_ops->firmware_unload)(dev); + + return -ENOTSUP; +} + +int +rte_rawdev_start(uint16_t dev_id) +{ + struct rte_rawdev *dev; + int diag; + + RTE_RDEV_LOG_DEBUG("Start dev_id=%" PRIu8, dev_id); + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_start, -ENOTSUP); + + if (dev->data->dev_started != 0) { + RTE_RDEV_LOG_ERR("Device with dev_id=%" PRIu8 "already started", + dev_id); + return 0; + } + + diag = (*dev->dev_ops->dev_start)(dev); + if (diag == 0) + dev->data->dev_started = 1; + else + return diag; + + return 0; +} + +void +rte_rawdev_stop(uint16_t dev_id) +{ + struct rte_rawdev *dev; + + RTE_RDEV_LOG_DEBUG("Stop dev_id=%" PRIu8, dev_id); + + RTE_RAWDEV_VALID_DEVID_OR_RET(dev_id); + dev = &rte_rawdevs[dev_id]; + RTE_FUNC_PTR_OR_RET(*dev->dev_ops->dev_stop); + + if (dev->data->dev_started == 0) { + RTE_RDEV_LOG_ERR("Device with dev_id=%" PRIu8 "already stopped", + dev_id); + return; + } + + dev->data->dev_started = 0; + (*dev->dev_ops->dev_stop)(dev); +} + +int +rte_rawdev_close(uint16_t dev_id) +{ + struct rte_rawdev *dev; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_close, -ENOTSUP); + + /* Device must be stopped before it can be closed */ + if (dev->data->dev_started == 1) { + RTE_RDEV_LOG_ERR("Device %u must be stopped before closing", + dev_id); + return -EBUSY; + } + + return (*dev->dev_ops->dev_close)(dev); +} + +int +rte_rawdev_reset(uint16_t dev_id) +{ + struct rte_rawdev *dev; + + RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL); + dev = &rte_rawdevs[dev_id]; + RTE_FUNC_PTR_OR_ERR_RET(*dev->dev_ops->dev_reset, -ENOTSUP); + + /* Device must be stopped before it can be reset */ + /* XXX: Is forced reset also a possibility? */ + if (dev->data->dev_started == 1) { + RTE_RDEV_LOG_ERR("Device %u must be stopped before resetting", + dev_id); + return -EBUSY; + } + + return (*dev->dev_ops->dev_reset)(dev); +} + +static inline int +rte_rawdev_data_alloc(uint16_t dev_id, struct rte_rawdev_data **data, + int socket_id) +{ + char mz_name[RTE_RAWDEV_NAME_MAX_LEN]; + const struct rte_memzone *mz; + int n; + + /* Generate memzone name */ + n = snprintf(mz_name, sizeof(mz_name), "rte_rawdev_data_%u", dev_id); + if (n >= (int)sizeof(mz_name)) + return -EINVAL; + + if (rte_eal_process_type() == RTE_PROC_PRIMARY) { + mz = rte_memzone_reserve(mz_name, + sizeof(struct rte_rawdev_data), + socket_id, 0); + } else + mz = rte_memzone_lookup(mz_name); + + if (mz == NULL) + return -ENOMEM; + + *data = mz->addr; + if (rte_eal_process_type() == RTE_PROC_PRIMARY) + memset(*data, 0, sizeof(struct rte_rawdev_data)); + + return 0; +} + +static inline uint8_t +rte_rawdev_find_free_device_index(void) +{ + uint16_t dev_id; + + for (dev_id = 0; dev_id < RTE_RAW_MAX_DEVS; dev_id++) { + if (rte_rawdevs[dev_id].attached == + RTE_RAWDEV_DETACHED) + return dev_id; + } + return RTE_RAW_MAX_DEVS; +} + +struct rte_rawdev * +rte_rawdev_pmd_allocate(const char *name, int socket_id) +{ + struct rte_rawdev *rawdev; + uint16_t dev_id; + + if (rte_rawdev_pmd_get_named_dev(name) != NULL) { + RTE_RDEV_LOG_ERR("Event device with name %s already " + "allocated!", name); + return NULL; + } + + dev_id = rte_rawdev_find_free_device_index(); + if (dev_id == RTE_RAW_MAX_DEVS) { + RTE_RDEV_LOG_ERR("Reached maximum number of raw devices"); + return NULL; + } + + rawdev = &rte_rawdevs[dev_id]; + + if (rawdev->data == NULL) { + struct rte_rawdev_data *rawdev_data = NULL; + + int retval = rte_rawdev_data_alloc(dev_id, &rawdev_data, + socket_id); + + if (retval < 0 || rawdev_data == NULL) + return NULL; + + rawdev->data = rawdev_data; + + snprintf(rawdev->data->name, RTE_RAWDEV_NAME_MAX_LEN, + "%s", name); + + rawdev->data->dev_id = dev_id; + rawdev->data->socket_id = socket_id; + rawdev->data->dev_started = 0; + + rawdev->attached = RTE_RAWDEV_ATTACHED; + + rawdev_globals.nb_devs++; + } + + return rawdev; +} + +int +rte_rawdev_pmd_release(struct rte_rawdev *rawdev) +{ + int ret; + char mz_name[RTE_RAWDEV_NAME_MAX_LEN]; + const struct rte_memzone *mz; + + if (rawdev == NULL) + return -EINVAL; + + ret = rte_rawdev_close(rawdev->data->dev_id); + if (ret < 0) + return ret; + + rawdev->attached = RTE_RAWDEV_DETACHED; + rawdev_globals.nb_devs--; + + if (rte_eal_process_type() == RTE_PROC_PRIMARY) { + rte_free(rawdev->data->dev_private); + + /* Generate memzone name */ + ret = snprintf(mz_name, sizeof(mz_name), "rte_rawdev_data_%u", + rawdev->data->dev_id); + if (ret >= (int)sizeof(mz_name)) + return -EINVAL; + + mz = rte_memzone_lookup(mz_name); + if (mz == NULL) + return -ENOMEM; + + ret = rte_memzone_free(mz); + if (ret) + return ret; + } + + rawdev->data = NULL; + return 0; +} + +struct rte_rawdev * +rte_rawdev_pmd_vdev_init(const char *name, size_t dev_private_size, + int socket_id) +{ + struct rte_rawdev *rawdev; + + /* Allocate device structure */ + rawdev = rte_rawdev_pmd_allocate(name, socket_id); + if (rawdev == NULL) + return NULL; + + /* Allocate private device structure */ + if (rte_eal_process_type() == RTE_PROC_PRIMARY) { + rawdev->data->dev_private = + rte_zmalloc_socket("rawdev device private", + dev_private_size, + RTE_CACHE_LINE_SIZE, + socket_id); + + if (rawdev->data->dev_private == NULL) + rte_panic("Cannot allocate memzone for private device" + " data"); + } + + return rawdev; +} + +int +rte_rawdev_pmd_vdev_uninit(const char *name) +{ + struct rte_rawdev *rawdev; + + if (name == NULL) + return -EINVAL; + + rawdev = rte_rawdev_pmd_get_named_dev(name); + if (rawdev == NULL) + return -ENODEV; + + /* Free the raw device */ + rte_rawdev_pmd_release(rawdev); + + return 0; +} diff --git a/lib/librte_rawdev/rte_rawdev.h b/lib/librte_rawdev/rte_rawdev.h new file mode 100644 index 0000000..aec437e --- /dev/null +++ b/lib/librte_rawdev/rte_rawdev.h @@ -0,0 +1,524 @@ +/* + * BSD LICENSE + * + * Copyright 2017 NXP + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * * Neither the name of NXPnor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef _RTE_RAWDEV_H_ +#define _RTE_RAWDEV_H_ + +#ifdef __cplusplus +extern "C" { +#endif + +#include +#include +#include + +/** TODO: Revisit this - no specific reason for this limitation */ +#define RTE_RAWDEV_MAX_DEVS 2 + +/** + * Get the total number of raw devices that have been successfully + * initialised. + * + * @return + * The total number of usable raw devices. + */ +uint8_t +rte_rawdev_count(void); + +/** + * Get the device identifier for the named raw device. + * + * @param name + * Raw device name to select the raw device identifier. + * + * @return + * Returns raw device identifier on success. + * - <0: Failure to find named raw device. + */ +int +rte_rawdev_get_dev_id(const char *name); + +/** + * Return the NUMA socket to which a device is connected. + * + * @param dev_id + * The identifier of the device. + * @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. + */ +int +rte_rawdev_socket_id(uint16_t dev_id); + +/** + * Raw device information + */ +struct rte_rawdev_info { + const char *driver_name; /**< Raw driver name */ + struct rte_device *dev; /**< Generic device encapsulation */ + void *info; /**< Opaque information */ + int is_attached; /**< Device state */ +}; + +/** + * Retrieve the contextual information of an raw device. + * + * @param dev_id + * The identifier of the device. + * + * @param[out] dev_info + * A pointer to a structure of type *rte_rawdev_info* to be filled with the + * contextual information of the device. + * + * @return + * - 0: Success, driver updates the contextual information of the raw device + * - <0: Error code returned by the driver info get function. + * + */ +int +rte_rawdev_info_get(uint16_t dev_id, struct rte_rawdev_info *dev_info); + +/** + * Configure an raw device. + * + * This function must be invoked first before any other function in the + * API. This function can also be re-invoked when a device is in the + * stopped state. + * + * The caller may use rte_rawdev_info_get() to get the capability of each + * resources available for this raw device. + * + * @param dev_id + * The identifier of the device to configure. + * @param dev_conf + * The raw device configuration structure as void - to be interpreted by + * by the given driver. + * + * @return + * - 0: Success, device configured. + * - <0: Error code returned by the driver configuration function. + */ +int +rte_rawdev_configure(uint16_t dev_id, void *dev_conf); + + +/** + * Retrieve the current configuration information of an raw queue designated + * by its *queue_id* from the raw driver for an raw device. + * + * This function intended to be used in conjunction with rte_raw_queue_setup() + * where caller needs to set up the queue by overriding few default values. + * + * @param dev_id + * The identifier of the device. + * @param queue_id + * The index of the raw queue to get the configuration information. + * The value must be in the range [0, nb_raw_queues - 1] + * previously supplied to rte_rawdev_configure(). + * @param[out] queue_conf + * The pointer to the default raw queue configuration data. + * @return + * - 0: Success, driver updates the default raw queue configuration data. + * - <0: Error code returned by the driver info get function. + * + * @see rte_raw_queue_setup() + * + */ +int +rte_rawdev_queue_conf_get(uint16_t dev_id, uint8_t queue_id, void *queue_conf); + +/** + * Allocate and set up an raw queue for an raw device. + * + * @param dev_id + * The identifier of the device. + * @param queue_id + * The index of the raw queue to setup. The value must be in the range + * [0, nb_raw_queues - 1] previously supplied to rte_rawdev_configure(). + * @param queue_conf + * The pointer to the configuration data to be used for the raw queue. + * NULL value is allowed, in which case default configuration used. + * + * @see rte_rawdev_queue_default_conf_get() + * + * @return + * - 0: Success, raw queue correctly set up. + * - <0: raw queue configuration failed + */ +int +rte_rawdev_queue_setup(uint16_t dev_id, uint8_t queue_id, void *queue_conf); + +/** + * Get the number of raw queues on a specific raw device + * + * @param dev_id + * Raw device identifier. + * @return + * - The number of configured raw queues + */ +uint8_t +rte_rawdev_queue_count(uint16_t dev_id); + +/** + * Start an raw device. + * + * The device start step is the last one and consists of setting the raw + * queues to start accepting the raws and schedules to raw ports. + * + * On success, all basic functions exported by the API (raw enqueue, + * raw dequeue and so on) can be invoked. + * + * @param dev_id + * Raw device identifier + * @return + * - 0: Success, device started. + * < 0: Failure + */ +int +rte_rawdev_start(uint16_t dev_id); + +/** + * Stop an raw device. The device can be restarted with a call to + * rte_rawdev_start() + * + * @param dev_id + * Raw device identifier. + */ +void +rte_rawdev_stop(uint16_t dev_id); + +/** + * Close an raw device. The device cannot be restarted after this call. + * + * @param dev_id + * Raw device identifier + * + * @return + * - 0 on successfully closing device + * - <0 on failure to close device + * - (-EAGAIN) if device is busy + */ +int +rte_rawdev_close(uint16_t dev_id); + +/** + * Reset a raw device. + * This is different from cycle of rte_rawdev_start->rte_rawdev_stop in the + * sense similar to hard or soft reset. + * + * @param dev_id + * Raw device identifiers + * @return + * 0 for sucessful reset, + * !0 for failure in resetting + */ +int +rte_rawdev_reset(uint16_t dev_id); + +#define RTE_RAWDEV_NAME_MAX_LEN (64) +/**< @internal Max length of name of raw PMD */ + +/** + * @internal + * The data part, with no function pointers, associated with each device. + * + * This structure is safe to place in shared memory to be common among + * different processes in a multi-process configuration. + */ +struct rte_rawdev_data { + int socket_id; + /**< Socket ID where memory is allocated */ + uint16_t dev_id; + /**< Device ID for this instance */ + uint8_t nb_queues; + /**< Number of raw queues. */ + void *dev_private; + /**< PMD-specific private data */ + + RTE_STD_C11 + uint8_t dev_started : 1; + /**< Device state: STARTED(1)/STOPPED(0) */ + + char name[RTE_RAWDEV_NAME_MAX_LEN]; + /**< Unique identifier name */ +} __rte_cache_aligned; + +/** @internal The data structure associated with each raw device. */ +struct rte_rawdev { + struct rte_rawdev_data *data; + /**< Generic device information */ + + const struct rte_rawdev_ops *dev_ops; + /**< Functions exported by PMD */ + + struct rte_device *dev; + /**< Device info. supplied by probing */ + + struct rte_driver *driver; + /**< Device info. supplied by probing */ + + RTE_STD_C11 + uint8_t attached : 1; + /**< Flag indicating the device is attached */ +} __rte_cache_aligned; + +extern struct rte_rawdev *rte_rawdevs; +/** @internal The pool of rte_rawdev structures. */ + + +/** + * Dump internal information about *dev_id* to the FILE* provided in *f*. + * + * @param dev_id + * The identifier of the device. + * + * @param f + * A pointer to a file for output + * + * @return + * - 0: on success + * - <0: on failure. + */ +int +rte_rawdev_dump(uint16_t dev_id, FILE *f); + +/** Maximum name length for extended statistics counters */ +#define RTE_RAW_DEV_XSTATS_NAME_SIZE 64 + +/** + * Selects the component of the rawdev to retrieve statistics from. + */ +enum rte_rawdev_xstats_mode { + RTE_RAW_DEV_XSTATS_DEVICE, + RTE_RAW_DEV_XSTATS_PORT, + RTE_RAW_DEV_XSTATS_QUEUE, +}; + +/** + * A name-key lookup element for extended statistics. + * + * This structure is used to map between names and ID numbers + * for extended ethdev statistics. + */ +struct rte_rawdev_xstats_name { + char name[RTE_RAW_DEV_XSTATS_NAME_SIZE]; +}; + +/** + * Retrieve names of extended statistics of an raw device. + * + * @param dev_id + * The identifier of the raw device. + * @param mode + * The mode of statistics to retrieve. Choices include the device statistics, + * port statistics or queue statistics. + * @param queue_port_id + * Used to specify the port or queue number in queue or port mode, and is + * ignored in device mode. + * @param[out] xstats_names + * Block of memory to insert names into. Must be at least size in capacity. + * If set to NULL, function returns required capacity. + * @param[out] ids + * Block of memory to insert ids into. Must be at least size in capacity. + * If set to NULL, function returns required capacity. The id values returned + * can be passed to *rte_rawdev_xstats_get* to select statistics. + * @param size + * Capacity of xstats_names (number of names). + * @return + * - positive value lower or equal to size: success. The return value + * is the number of entries filled in the stats table. + * - positive value higher than size: error, the given statistics table + * is too small. The return value corresponds to the size that should + * be given to succeed. The entries in the table are not valid and + * shall not be used by the caller. + * - negative value on error: + * -ENODEV for invalid *dev_id* + * -EINVAL for invalid mode, queue port or id parameters + * -ENOTSUP if the device doesn't support this function. + */ +int +rte_rawdev_xstats_names_get(uint16_t dev_id, + enum rte_rawdev_xstats_mode mode, + uint8_t queue_port_id, + struct rte_rawdev_xstats_name *xstats_names, + unsigned int *ids, + unsigned int size); + +/** + * Retrieve extended statistics of an raw device. + * + * @param dev_id + * The identifier of the device. + * @param mode + * The mode of statistics to retrieve. Choices include the device statistics, + * port statistics or queue statistics. + * @param queue_port_id + * Used to specify the port or queue number in queue or port mode, and is + * ignored in device mode. + * @param ids + * The id numbers of the stats to get. The ids can be got from the stat + * position in the stat list from rte_rawdev_get_xstats_names(), or + * by using rte_rawdev_get_xstats_by_name() + * @param[out] values + * The values for each stats request by ID. + * @param n + * The number of stats requested + * @return + * - positive value: number of stat entries filled into the values array + * - negative value on error: + * -ENODEV for invalid *dev_id* + * -EINVAL for invalid mode, queue port or id parameters + * -ENOTSUP if the device doesn't support this function. + */ +int +rte_rawdev_xstats_get(uint16_t dev_id, + enum rte_rawdev_xstats_mode mode, + uint8_t queue_port_id, + const unsigned int ids[], + uint64_t values[], + unsigned int n); + +/** + * Retrieve the value of a single stat by requesting it by name. + * + * @param dev_id + * The identifier of the device + * @param name + * The stat name to retrieve + * @param[out] id + * If non-NULL, the numerical id of the stat will be returned, so that further + * requests for the stat can be got using rte_rawdev_xstats_get, which will + * be faster as it doesn't need to scan a list of names for the stat. + * If the stat cannot be found, the id returned will be (unsigned)-1. + * @return + * - positive value or zero: the stat value + * - negative value: -EINVAL if stat not found, -ENOTSUP if not supported. + */ +uint64_t +rte_rawdev_xstats_by_name_get(uint16_t dev_id, const char *name, + unsigned int *id); + +/** + * Reset the values of the xstats of the selected component in the device. + * + * @param dev_id + * The identifier of the device + * @param mode + * The mode of the statistics to reset. Choose from device, queue or port. + * @param queue_port_id + * The queue or port to reset. 0 and positive values select ports and queues, + * while -1 indicates all ports or queues. + * @param ids + * Selects specific statistics to be reset. When NULL, all statistics selected + * by *mode* will be reset. If non-NULL, must point to array of at least + * *nb_ids* size. + * @param nb_ids + * The number of ids available from the *ids* array. Ignored when ids is NULL. + * @return + * - zero: successfully reset the statistics to zero + * - negative value: -EINVAL invalid parameters, -ENOTSUP if not supported. + */ +int +rte_rawdev_xstats_reset(uint16_t dev_id, + enum rte_rawdev_xstats_mode mode, + int16_t queue_port_id, + const uint32_t ids[], + uint32_t nb_ids); + +/** + * Get Firmware status of the device.. + * Returns a memory allocated by driver/implementation containing status + * information block. It is responsibility of caller to release the buffer. + * + * @param dev_id + * Raw device identifier + * @param status_info + * Pointer to status information area. Caller is responsible for releasing + * the memory associated. + * @return + * 0 for success, + * !0 for failure, `status_info` argument state is undefined + */ +int +rte_rawdev_firmware_status_get(uint16_t dev_id, void *status_info); + +/** + * Get Firmware version of the device. + * Returns a memory allocated by driver/implementation containing version + * information block. It is responsibility of caller to release the buffer. + * + * @param dev_id + * Raw device identifier + * @param version_info + * Pointer to version information area. Caller is responsible for releasing + * the memory associated. + * @return + * 0 for success, + * !0 for failure, `version_info` argument state is undefined + */ +int +rte_rawdev_firmware_version_get(uint16_t dev_id, void *version_info); + +/** + * Load firmware on the device. + * TODO: In future, methods like directly flashing from file too can be + * supported. + * + * @param dev_id + * Raw device identifier + * @param firmware_image + * Pointer to buffer containing image binary data + * @return + * 0 for successful Load + * !0 for failure to load the provided image, or image incorrect. + */ +int +rte_rawdev_firmware_load(uint16_t dev_id, void *firmware_image); + +/** + * Unload firmware from the device. + * + * @param dev_id + * Raw device identifiers + * @return + * 0 for successful Unload + * !0 for failure in unloading + */ +int +rte_rawdev_firmware_unload(uint16_t dev_id); + +#ifdef __cplusplus +} +#endif + +#endif /* _RTE_RAWDEV_H_ */ diff --git a/lib/librte_rawdev/rte_rawdev_pmd.h b/lib/librte_rawdev/rte_rawdev_pmd.h new file mode 100644 index 0000000..3963523 --- /dev/null +++ b/lib/librte_rawdev/rte_rawdev_pmd.h @@ -0,0 +1,540 @@ +/* + * + * Copyright 2017 NXP + * + * Redistribution and use in source and binary forms, with or without + * modification, are permitted provided that the following conditions + * are met: + * + * * Redistributions of source code must retain the above copyright + * notice, this list of conditions and the following disclaimer. + * * Redistributions in binary form must reproduce the above copyright + * notice, this list of conditions and the following disclaimer in + * the documentation and/or other materials provided with the + * distribution. + * * Neither the name of NXPnor the names of its + * contributors may be used to endorse or promote products derived + * from this software without specific prior written permission. + * + * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS + * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT + * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR + * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT + * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, + * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, + * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY + * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE + * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + */ + +#ifndef _RTE_RAWDEV_PMD_H_ +#define _RTE_RAWDEV_PMD_H_ + +/** @file + * RTE RAW PMD APIs + * + * @note + * Driver facing APIs for a raw device. These are not to be called directly by + * any application. + * @b EXPERIMENTAL: this API may change without prior notice + */ + +#ifdef __cplusplus +extern "C" { +#endif + +#include + +#include +#include +#include +#include + +#include "rte_rawdev.h" + +/* Logging Macros */ +#define RTE_RDEV_LOG_ERR(...) \ + RTE_LOG(ERR, USER8, \ + RTE_FMT("%s() line %u: " RTE_FMT_HEAD(__VA_ARGS__,) "\n", \ + __func__, __LINE__, RTE_FMT_TAIL(__VA_ARGS__,))) + +#ifdef RTE_LIBRTE_RAWDEV_DEBUG +#define RTE_RDEV_LOG_DEBUG(...) \ + RTE_LOG(DEBUG, USER8, \ + RTE_FMT("%s() line %u: " RTE_FMT_HEAD(__VA_ARGS__,) "\n", \ + __func__, __LINE__, RTE_FMT_TAIL(__VA_ARGS__,))) +#else +#define RTE_RDEV_LOG_DEBUG(...) (void)0 +#endif + +/* Macros to check for valid device */ +#define RTE_RAWDEV_VALID_DEVID_OR_ERR_RET(dev_id, retval) do { \ + if (!rte_rawdev_pmd_is_valid_dev((dev_id))) { \ + RTE_RDEV_LOG_ERR("Invalid dev_id=%d\n", dev_id); \ + return retval; \ + } \ +} while (0) + +#define RTE_RAWDEV_VALID_DEVID_OR_RET(dev_id) do { \ + if (!rte_rawdev_pmd_is_valid_dev((dev_id))) { \ + RTE_RDEV_LOG_ERR("Invalid dev_id=%d\n", dev_id); \ + return; \ + } \ +} while (0) + +#define RTE_RAWDEV_DETACHED (0) +#define RTE_RAWDEV_ATTACHED (1) + +/** Global structure used for maintaining state of allocated raw devices */ +struct rte_rawdev_global { + uint8_t nb_devs; /**< Number of devices found */ +}; + +extern struct rte_rawdev_global *rte_rawdev_globals; +/** Pointer to global raw devices data structure. */ +extern struct rte_rawdev *rte_rawdevs; +/** The pool of rte_rawdev structures. */ + +/** + * Get the rte_rawdev structure device pointer for the named device. + * + * @param name + * device name to select the device structure. + * + * @return + * - The rte_rawdev structure pointer for the given device ID. + */ +static inline struct rte_rawdev * +rte_rawdev_pmd_get_named_dev(const char *name) +{ + struct rte_rawdev *dev; + unsigned int i; + + if (name == NULL) + return NULL; + + for (i = 0; i < RTE_RAWDEV_MAX_DEVS; i++) { + dev = &rte_rawdevs[i]; + if ((dev->attached == RTE_RAWDEV_ATTACHED) && + (strcmp(dev->data->name, name) == 0)) + return dev; + } + + return NULL; +} + +/** + * Validate if the raw device index is a valid attached raw device. + * + * @param dev_id + * raw device index. + * + * @return + * - If the device index is valid (1) or not (0). + */ +static inline unsigned +rte_rawdev_pmd_is_valid_dev(uint8_t dev_id) +{ + struct rte_rawdev *dev; + + if (dev_id >= RTE_RAWDEV_MAX_DEVS) + return 0; + + dev = &rte_rawdevs[dev_id]; + if (dev->attached != RTE_RAWDEV_ATTACHED) + return 0; + else + return 1; +} + +/** + * Definitions of all functions exported by a driver through the + * the generic structure of type *rawdev_ops* supplied in the + * *rte_rawdev* structure associated with a device. + */ + +/** + * Get device information of a device. + * + * @param dev + * Raw device pointer + * @param dev_info + * Raw device information structure + * + * @return + * Returns 0 on success + */ +typedef void (*rawdev_info_get_t)(struct rte_rawdev *dev, void *dev_info); + +/** + * Configure a device. + * + * @param dev + * Raw device pointer + * + * @return + * Returns 0 on success + */ +typedef int (*rawdev_configure_t)(const struct rte_rawdev *dev); + +/** + * Start a configured device. + * + * @param dev + * Raw device pointer + * + * @return + * Returns 0 on success + */ +typedef int (*rawdev_start_t)(struct rte_rawdev *dev); + +/** + * Stop a configured device. + * + * @param dev + * Raw device pointer + */ +typedef void (*rawdev_stop_t)(struct rte_rawdev *dev); + +/** + * Close a configured device. + * + * @param dev + * Raw device pointer + * + * @return + * - 0 on success + * - (-EAGAIN) if can't close as device is busy + */ +typedef int (*rawdev_close_t)(struct rte_rawdev *dev); + +/** + * Reset a configured device. + * + * @param dev + * Raw device pointer + * @return + * 0 for success + * !0 for failure + */ +typedef int (*rawdev_reset_t)(struct rte_rawdev *dev); + +/** + * Retrieve the current raw queue configuration. + * + * @param dev + * Raw device pointer + * @param queue_id + * Raw device queue index + * @param[out] queue_conf + * Raw device queue configuration structure + * + */ +typedef void (*rawdev_queue_conf_get_t)(struct rte_rawdev *dev, + uint8_t queue_id, + void *queue_conf); + +/** + * Setup an raw queue. + * + * @param dev + * Rawdevice pointer + * @param queue_id + * Rawqueue index + * @param queue_conf + * Rawqueue configuration structure + * + * @return + * Returns 0 on success. + */ +typedef int (*rawdev_queue_setup_t)(struct rte_rawdev *dev, + uint8_t queue_id, + void *queue_conf); + +/** + * Release resources allocated by given raw queue. + * + * @param dev + * Raw device pointer + * @param queue_id + * Raw queue index + * + */ +typedef void (*rawdev_queue_release_t)(struct rte_rawdev *dev, + uint8_t queue_id); + +/** + * Enqueue an array of raw buffers to the device. + * + * Buffer being used is opaque - it can be obtained from mempool or from + * any other source. Interpretation of buffer is responsibility of driver. + * + * @param dev + * Raw deviec pointer + * @param bufs + * array of void buffers + * @param count + * number of buffers passed + */ +typedef int (*rawdev_enqueue_bufs_t)(struct rte_rawdev *dev, + void **bufs, + unsigned int count); + +/** + * Dequeue an array of raw buffers from the device. + * + * @param dev + * Raw deviec pointer + * @param bufs + * array of void buffers + * @return + * >0, ~0: Count of buffers returned + * <0: Error + * XXX: Should error be returned or unsigned? (0 as combined success/failure) + */ +typedef int (*rawdev_dequeue_bufs_t)(struct rte_rawdev *dev, void **bufs); + +/** + * Dump internal information + * + * @param dev + * Raw device pointer + * @param f + * A pointer to a file for output + * + */ +typedef void (*rawdev_dump_t)(struct rte_rawdev *dev, FILE *f); + +/** + * Retrieve a set of statistics from device. + * Note: Being a raw device, the stats are specific to the device being + * implemented thus represented as xstats. + * + * @param dev + * Raw device pointer + * @param ids + * The stat ids to retrieve + * @param values + * The returned stat values + * @param n + * The number of id values and entries in the values array + * @return + * The number of stat values successfully filled into the values array + */ +typedef int (*rawdev_xstats_get_t)(const struct rte_rawdev *dev, + enum rte_rawdev_xstats_mode mode, uint8_t queue_port_id, + const unsigned int ids[], uint64_t values[], unsigned int n); + +/** + * Resets the statistic values in xstats for the device, based on mode. + */ +typedef int (*rawdev_xstats_reset_t)(struct rte_rawdev *dev, + enum rte_rawdev_xstats_mode mode, + int16_t queue_port_id, + const uint32_t ids[], + uint32_t nb_ids); + +/** + * Get names of extended stats of an raw device + * + * @param dev + * Raw device pointer + * @param xstats_names + * Array of name values to be filled in + * @param size + * Number of values in the xstats_names array + * @return + * When size >= the number of stats, return the number of stat values filled + * into the array. + * When size < the number of available stats, return the number of stats + * values, and do not fill in any data into xstats_names. + */ +typedef int (*rawdev_xstats_get_names_t)(const struct rte_rawdev *dev, + enum rte_rawdev_xstats_mode mode, uint8_t queue_port_id, + struct rte_rawdev_xstats_name *xstats_names, + unsigned int *ids, unsigned int size); + +/** + * Get value of one stats and optionally return its id + * + * @param dev + * Raw device pointer + * @param name + * The name of the stat to retrieve + * @param id + * Pointer to an unsigned int where we store the stat-id for future reference. + * This pointer may be null if the id is not required. + * @return + * The value of the stat, or (uint64_t)-1 if the stat is not found. + * If the stat is not found, the id value will be returned as (unsigned)-1, + * if id pointer is non-NULL + */ +typedef uint64_t (*rawdev_xstats_get_by_name)(const struct rte_rawdev *dev, + const char *name, + unsigned int *id); + +/** + * Get firmware/device-stack status. + * Implementation to allocate buffer for returning information. + * + * @param dev + * Raw device pointer + * @param status + * void block containing device specific status information + * @return + * 0 for success, + * !0 for failure, with undefined value in `status_info` + */ +typedef int (*rawdev_firmware_status_get_t)(struct rte_rawdev *dev, + void *status_info); + +/** + * Get firmware version information + * + * @param dev + * Raw device pointer + * @param version_info + * void pointer to version information returned by device + * @return + * 0 for success, + * !0 for failure, with undefined value in `version_info` + */ +typedef int (*rawdev_firmware_version_get_t)(struct rte_rawdev *dev, + void *version_info); + +/** + * Load firwmare from a buffer (DMA'able) + * + * @param dev + * Raw device pointer + * @param firmware_file + * file pointer to firmware area + * @return + * >0, ~0: for successful load + * <0: for failure + * + * @see Application may use 'firmware_version_get` for ascertaining successful + * load + */ +typedef int (*rawdev_firmware_load_t)(struct rte_rawdev *dev, + void *firmware_buf); + +/** + * Unload firwmare + * + * @param dev + * Raw device pointer + * @return + * >0, ~0 for successful unloading + * <0 for failure in unloading + * + * Note: Application can use the `firmware_status_get` or + * `firmware_version_get` to get result of unload. + */ +typedef int (*rawdev_firmware_unload_t)(struct rte_rawdev *dev); + + +/** Rawdevice operations function pointer table */ +struct rte_rawdev_ops { + rawdev_info_get_t dev_infos_get; /**< Get device info. */ + rawdev_configure_t dev_configure; /**< Configure device. */ + rawdev_start_t dev_start; /**< Start device. */ + rawdev_stop_t dev_stop; /**< Stop device. */ + rawdev_close_t dev_close; /**< Close device. */ + rawdev_reset_t dev_reset; /**< Reset device. */ + + rawdev_queue_conf_get_t queue_def_conf; + /**< Get raw queue configuration. */ + rawdev_queue_setup_t queue_setup; + /**< Set up an raw queue. */ + rawdev_queue_release_t queue_release; + /**< Release an raw queue. */ + rawdev_enqueue_bufs_t enqueue_bufs; + /**< Enqueue an array of raw buffers to device. */ + rawdev_dequeue_bufs_t dequeue_bufs; + /**< Dequeue an array of raw buffers from device. */ + /** TODO: Callback based enqueue and dequeue can also be supported */ + + rawdev_dump_t dump; + /* Dump internal information */ + + rawdev_xstats_get_t xstats_get; + /**< Get extended device statistics. */ + rawdev_xstats_get_names_t xstats_get_names; + /**< Get names of extended stats. */ + rawdev_xstats_get_by_name xstats_get_by_name; + /**< Get one value by name. */ + rawdev_xstats_reset_t xstats_reset; + /**< Reset the statistics values in xstats. */ + + rawdev_firmware_status_get_t firmware_status_get; + /**< Obtainer firmware status */ + rawdev_firmware_version_get_t firmware_version_get; + /**< Obtain firmware version information */ + rawdev_firmware_load_t firmware_load; + /**< Load firmware */ + rawdev_firmware_unload_t firmware_unload; + /**< Unload firmware */ +}; + +/** + * Allocates a new rawdev slot for an raw device and returns the pointer + * to that slot for the driver to use. + * + * @param name + * Unique identifier name for each device + * @param socket_id + * Socket to allocate resources on. + * @return + * - Slot in the rte_dev_devices array for a new device; + */ +struct rte_rawdev * +rte_rawdev_pmd_allocate(const char *name, int socket_id); + +/** + * Release the specified rawdev device. + * + * @param rawdev + * The *rawdev* pointer is the address of the *rte_rawdev* structure. + * @return + * - 0 on success, negative on error + */ +int +rte_rawdev_pmd_release(struct rte_rawdev *rawdev); + +/** + * Creates a new virtual raw device and returns the pointer to that device. + * + * @param name + * PMD type name + * @param dev_private_size + * Size of raw PMDs private data + * @param socket_id + * Socket to allocate resources on. + * + * @return + * - Raw device pointer if device is successfully created. + * - NULL if device cannot be created. + */ +struct rte_rawdev * +rte_rawdev_pmd_vdev_init(const char *name, size_t dev_private_size, + int socket_id); + +/** + * Destroy the given virtual raw device + * + * @param name + * PMD type name + * @return + * - 0 on success, negative on error + */ +int +rte_rawdev_pmd_vdev_uninit(const char *name); + +#ifdef __cplusplus +} +#endif + +#endif /* _RTE_RAWDEV_PMD_H_ */ diff --git a/lib/librte_rawdev/rte_rawdev_version.map b/lib/librte_rawdev/rte_rawdev_version.map new file mode 100644 index 0000000..fd9b969 --- /dev/null +++ b/lib/librte_rawdev/rte_rawdev_version.map @@ -0,0 +1,28 @@ +EXPERIMENTAL { + global: + + rte_rawdev_close; + rte_rawdev_configure; + rte_rawdev_count; + rte_rawdev_firmware_load; + rte_rawdev_firmware_status_get; + rte_rawdev_firmware_unload; + rte_rawdev_firmware_version_get; + rte_rawdev_get_dev_id; + rte_rawdev_info_get; + rte_rawdev_pmd_allocate; + rte_rawdev_pmd_release; + rte_rawdev_queue_conf_get; + rte_rawdev_queue_setup; + rte_rawdev_queue_release; + rte_rawdev_reset; + rte_rawdev_socket_id; + rte_rawdev_start; + rte_rawdev_stop; + rte_rawdev_xstats_by_name_get; + rte_rawdev_xstats_get; + rte_rawdev_xstats_names_get; + rte_rawdev_xstats_reset; + + local: *; +}; From patchwork Wed Nov 8 17:40:54 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Hemant Agrawal X-Patchwork-Id: 118296 Delivered-To: patch@linaro.org Received: by 10.140.22.164 with SMTP id 33csp5576126qgn; Wed, 8 Nov 2017 09:42:12 -0800 (PST) X-Google-Smtp-Source: ABhQp+Tmly0V5chl3lj96ajIjZDh8kISgX9vpx4toNbmtz8txYh/EZgG+IlSiNvvglRhjf5feB3/ X-Received: by 10.223.154.184 with SMTP id a53mr1248194wrc.48.1510162932098; Wed, 08 Nov 2017 09:42:12 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1510162932; cv=none; d=google.com; s=arc-20160816; b=B01GMVve3TtWpORRYiSfxuX+J6V02KtNSfKP9swnLWcSgBRnLiZX1dI2dCjZKMLSY0 Sd+KP7Cj7SLod3tyIh17euhq0XmDmSdtp9E+j9VpHI+EyGVKHZlZCf+NuPZAXPoCyRVz gpNM8XCqPo22rqpE3htDOYwc7i5aiUjGlUOKj1HfWlXsMsxgr3PjFAob6mbyWxEdfpYo zOZEYPTY7NRLxn843pjCvs46DABCH6vDW2umnMCt/pNACZ7nUqmt041lMoqmvAEvNmd+ uVBRHyFchylDeAXxrRrJNz7TdoG6QdfIWMvHjkgE9s3DhMtB2ZltH/FidZEa/eRvdMXi 0gng== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject:spamdiagnosticmetadata :spamdiagnosticoutput:mime-version:references:in-reply-to:message-id :date:cc:to:from:arc-authentication-results; bh=zPbt3DRXjKaui2d1wc+CTY6ZsHUA+4Rjsk8Iz2qoxng=; b=FzntA/27+pRq46K1Fxmq81+p0T9MXv2r95I39A/y/9UHGenpUgPmfp2raYkgVyzf87 vgp+D2RWwgk4kzzg4NbIAp6gaYn7a4Tb6rfeyJdXsv/9Q6KH9N9v637jbSMlcnRas66I nOMLTAYjz4axjPtuN7INs0VXrH3fo95zTDiuaYspMRAkWQDKaDq7gTlB9zbn9BK2rpat tD8kHuo6U5mx8U0DL80/q7PlNZRjNdaW1J8QryGuWd4QE4kkS7vHOhhmbENAdgbLWToq a8/o8a1zqHmm1Yf/7BXOXBm7GfBevvsKeeZdzg1ZizCWXhU19L0jk1UMKWhqWg5mpG1p OOpg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from dpdk.org (dpdk.org. [92.243.14.124]) by mx.google.com with ESMTP id d26si4804341wrb.314.2017.11.08.09.42.11; Wed, 08 Nov 2017 09:42:12 -0800 (PST) Received-SPF: pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) client-ip=92.243.14.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id E57781B2AF; Wed, 8 Nov 2017 18:41:53 +0100 (CET) Received: from NAM02-BL2-obe.outbound.protection.outlook.com (mail-bl2nam02on0079.outbound.protection.outlook.com [104.47.38.79]) by dpdk.org (Postfix) with ESMTP id 833921B2AF for ; Wed, 8 Nov 2017 18:41:52 +0100 (CET) Received: from BN6PR03CA0074.namprd03.prod.outlook.com (10.164.122.140) by BN6PR03MB2690.namprd03.prod.outlook.com (10.173.144.9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.197.13; Wed, 8 Nov 2017 17:41:51 +0000 Received: from BY2FFO11FD031.protection.gbl (2a01:111:f400:7c0c::128) by BN6PR03CA0074.outlook.office365.com (2603:10b6:405:6f::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.218.12 via Frontend Transport; Wed, 8 Nov 2017 17:41:51 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=nxp.com; NXP1.onmicrosoft.com; dkim=none (message not signed) header.d=none;NXP1.onmicrosoft.com; dmarc=fail action=none header.from=nxp.com; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BY2FFO11FD031.mail.protection.outlook.com (10.1.14.196) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.178.5 via Frontend Transport; Wed, 8 Nov 2017 17:41:50 +0000 Received: from bf-netperf1.ap.freescale.net (bf-netperf1.ap.freescale.net [10.232.134.28]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id vA8HfcWB031926; Wed, 8 Nov 2017 10:41:44 -0700 From: Hemant Agrawal To: CC: , , Date: Wed, 8 Nov 2017 23:10:54 +0530 Message-ID: <1510162854-10171-3-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1510162854-10171-1-git-send-email-hemant.agrawal@nxp.com> References: <1510162854-10171-1-git-send-email-hemant.agrawal@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131546365105321868; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(336005)(7966004)(39860400002)(376002)(39380400002)(346002)(2980300002)(1110001)(1109001)(339900001)(189002)(199003)(33646002)(104016004)(5003940100001)(189998001)(47776003)(36756003)(50226002)(305945005)(5660300001)(81166006)(8936002)(85426001)(81156014)(8676002)(356003)(48376002)(53936002)(498600001)(2906002)(8656006)(4326008)(77096006)(50466002)(97736004)(2351001)(2950100002)(6916009)(68736007)(6666003)(54906003)(296002)(86362001)(16586007)(316002)(105606002)(50986999)(106466001)(76176999)(217873001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN6PR03MB2690; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; MX:1; A:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD031; 1:KmydXDCBX3OsszSSYdnHfEspYb8C8YmEUVXN9VWHC++P9WrYysmoE5SPyuE2Fje6Y1wzTbd9YY1xYCXRbfFJ9i+O4xhI+GtbNwYoTiHJCBysxs8w4Y2tuSTUP0kqt7GT MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 2f3a25ea-6f86-4d4e-b78c-08d526cffe0f X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(4534020)(4628075)(201703131517081)(2017052603199); SRVR:BN6PR03MB2690; X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2690; 3:ICy01qcny4rsOLpKI1ieiLvIzhqeMk7yxStjewNxsf3t/ZYDWKrwEC6oWfKoflV9UPSCBm7h2LxXaDlT/HEvCS3eeYZcVeM94lKXAFYiZokYmofIjd1gdv+WLvOsC0EbMuMYmwKvFBEqns9v+sV8c6sIx9qkzVm3rQD1+Hu3v0AVBNBuVIXPHl92RMuBK9n+HL7MWHm6694CfH4N4m5VxBR0Caa11cqGhn5P5Kxyk050cJNwZjUPnZwmWXzBqu13HDd3a8sJs9loqLeGUGXGyk75eO+t4WFg7owmQTvQ/DeBLAMVuo6wxUqw1Bjcjvag2/pti4iVMgEpSyZbokseRdkpolROe7uygFGG+B0+AD0=; 25:AmVkSQ7KDAlBi5yGVtknAw7SKDvxJEx4QAxVTJnobXAziCQOX3OSBF5JutcZEd8nzVFN7goNc6+z/LZX9705pQw7ZP5N28B8+eWkQRJPfg0XO8BzpaM+mk8H689aKB24vQsmzcmLEaVQ8fOntYAcaJUnQhLr1nS5fGPQczgKg9WOtftFRRJvqyh+ulUaGsIqtWqF4eAPS17psZUppJCifZu28HaiY0k6erYNwGf1NpUYB2MnNRMDYgc9Oq1qh7pojK82QQKaR827Lt9ULl/Z+flJ/G1Ubwy1wykYfmmWu6gY3R68I7ESGszb9N+HoUdgzOZCnzqPGaMWJ1R2ONJfgw== X-MS-TrafficTypeDiagnostic: BN6PR03MB2690: X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2690; 31:dN3mfRs4R/wwLTwKtFiKBCg7vmyl+8O2u2Zfx8ojP799ipKLld2Up4y9zJD2WD1YZQ5yicuDzx7AEUVJvdgb8K+JZAU0aColoRpWVBIUTROzx583IViQtFvNqD7bc00eZaW6vmkvW5+eNXVdILjiRfLirxZpYhbL6J7zlv/ooLEwsHUPZ41W7TRHAEFLRXFjGs8Us9Cgeb05ctbm4N45O2zRlp4ngRqefSZHsbCvUVI=; 4:P4rYUnC9ChT65pTt6TUBKt8FeTZViJ1THhSBPDiLTzOKbVj6ASaC60LJaofCtuoQ2aN6DUDWU8ZgrYXb7ieNhDxzo4DVM4YDmRJ7Iar7B3fQw3sgGFVqFaMQW0I4uVchF+h4QtUut1CdNvHjZ5TMNy++2YkmSPf3uCI0BXYP/xHFO8IVT3ARn6qvY7Zmcc7TrjsiTl9RsVPdMQ+9v8nxE356P+6u3Nji05ZtIok0Is+wJGvTWat9vnbbk6dY/wkq00cj6Tc91t/GCB7LhH0//+yaSent5o9ZFdLIR18BIMSnF3lWHXL97aqM2VlN+jP0 X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(100000700101)(100105000095)(100000701101)(100105300095)(100000702101)(100105100095)(6095135)(2401047)(5005006)(8121501046)(3002001)(93006095)(93001095)(10201501046)(100000703101)(100105400095)(3231021)(6055026)(6096035)(20161123559100)(20161123556025)(20161123563025)(20161123561025)(20161123565025)(201703131430075)(201703131520075)(201703131441075)(201703131448075)(201703131433075)(201703161259150)(201708071742011)(100000704101)(100105200095)(100000705101)(100105500095); SRVR:BN6PR03MB2690; BCL:0; PCL:0; RULEID:(100000800101)(100110000095)(100000801101)(100110300095)(100000802101)(100110100095)(100000803101)(100110400095)(400006)(100000804101)(100110200095)(100000805101)(100110500095); SRVR:BN6PR03MB2690; X-Forefront-PRVS: 0485417665 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN6PR03MB2690; 23:EUFaXGk9ofyGfuF8iusXhzMc1P86I0FJWIypxIDrZ?= 1wI3LzKr2J2+MwSkHiJVZI04ZUCIN+vxLKh3NECprzwyCXrrbdoBJv9WwwDBuyby5/cMyE/YoScsRJXTzgX9j9IHGL2B8AM0gnXomSZZZ8KsC2UYvQ5XbJdfijEehwONNbNEuOBMmbiaDiNwthnmPmakZSL/BbfRvKNb1MlPzEQtVX72UIp5qtwAjY966eHW00aVWkNxA0FnJRyRW92O5H1I2YzqL7ZtaJjAqRY6u8jPR6cUGgtm+Xqb+Y3RVfeOS2CQ3N0oyFvW/ifXpZZU9rcbNypZMBFQoMA/COKc7nNQS8BYUaqSQppXh1r9KP7OlptN2y0Ykudd+h8g+eYUFZkZVj51UUu9pXNgPkCs3Pco/WCCTX//urlw+PJyogesDypPWU5XHRneYm1x1K2eVQc21udm+/4OQmPhDDI4PveLqJlKTqnTevmpvJaCOYhjHFIa+mf+uTUZPDMhpjr/F5jRs6+7evVaNN/unx6oxN/uY7vgux7t6ytN5ZV/j4B4Kfkxx4X+s0S0D2uDYAZcEVY9rHTmPPc0XrzMH93GUjcjWODt3bkkv/hb2UzQK/I1/9HWweWZcg8unqOe7474qp1vyIE0QI3wey5NV9zo1Pu0lHCZmW9R9qRmwx0AV0l9UJa9aPFb9ozgIjoBFCrVIoKwRBL5uLbLZbPkM/m8HhxIrZDLeg/waX69bSSu9j/ro4f2Jk21MwaJOOrNTMph4yKwshuNBd2cFKc2EDOE5BmtgS6cliw86dA+oiu410TGl5dwxXnuAt/IuxoA0gXdH505QaqelYCUvx7yhMv9I9Tv0lcd9ET7+JQ7T34mm7FyqY5dmCQUigbfl+N+YUO+6Q0vmt97q8GJeuUQxDMHEPjm1hHMU4Ep8Ig2fyDheYpufy33Lal/LhjRDV3y53yHZL1qJHqhuy2bWbrbNBtpcoO1H43oexILgTxbbEKZS9ShJhEuiXPLzLhErjhQo6MrocP07pbIkFXRtzCYXzwddoOluLQA4iAtZR003X8RkxIEWbozV1r0fx07W6YyyGqWmrb9CvTjSm2ESo7sxp+aa/jlFKac0HLwWQbJ0UIjO+vahqPjkM8ZBLnUSa9eQ95OaIaW1QwWByQHK/CygA5WkstsmFFBjx/uQPVx4S9GZpHBWu/6LRqd/XAg/oZOsaKqIgwz0z6+LfWPjx/4FJz7psNcA== X-Microsoft-Exchange-Diagnostics: 1; BN6PR03MB2690; 6:WSiC/4KWbrMc+ygthM7dHUiZHk/xmjyV2MAwYSRHXvK14NS/Uu1Yty+WRP7fxZgboQn7uouYaZbzucwkYNfTK6g5HOHakzUgPLanHEOf/89wbEUmDP+aN5AtGEb2/aYG7Zp3g67lbStHVfkJaa9T9yUTexBQyze5V5N1WwlweDkS/p8g+NzPUyLOVWtvTP6sdkmS/u+VDO3Ld5bVCXhZBBGJuIZdiEkhIUtqf1oqWMD3IZqS94GQWKSU3cauJljYR9nBM+V3peqpCSXrqaIem8wqPKN5Lkm0p321HCMS0rxEhUb5EtMxrJZbLGES7N68bk/qF6G8BaaGkuRbX3II9d/ndLNZKJ+UC98G4OfcHcY=; 5:9M9kNUuSK2D6sE+RYhvqHWnPweaVjlVGR56dgS+Yq/j5SaXSwDSxmZP7IRgMF57bfKD2wQNp2Scks/dsWMA8pBcneg4BtgEDVhlHUMXPP4qZXNMml6UlwiGAM0aqZ1Bpd/Exf2C6AlCa41XWLC0V/WlH7P0gcByfScV1w/cK608=; 24:cjGeWo8tugKfDjtFly3Bno+jnkBmZ1GWPMvSuQZnylf6U0QguvIZ7YdMrgsbeE5X5Zvzc7T4H0rSK1Mb18Dq8KfDzFeo7ihOwG+0Oo+EI5E=; 7:FUOEDLDOI1TbQFL4CalbBO/YytTTzCap53/GEuEz0zKCOu8/W6r1LIaYueqR+dhXQR/TAn2rJLqOLeWnUDR2u5oof4gJy2xthK0de+sA92L4OrYeXqEg6QdMTeq4Ra2bqcLfeBtkWZJSBDnVRqriOGOSaODst+fEiXDgDKZ6eR9vPJSLd5SKzFj8s31G/8q8aHWoDoJY18a1qSWIgRrkQ2JlG0OQbCPGhfvDA1Nouw7LmZPP3IutiLshcRSkBa67 SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Nov 2017 17:41:50.3449 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 2f3a25ea-6f86-4d4e-b78c-08d526cffe0f X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN6PR03MB2690 Subject: [dpdk-dev] [RFC PATCH 2/2] config: enable compilation of raw device library X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Signed-off-by: Hemant Agrawal --- config/common_base | 7 +++++++ lib/Makefile | 3 +++ 2 files changed, 10 insertions(+) -- 2.7.4 diff --git a/config/common_base b/config/common_base index 34f04a9..30ab741 100644 --- a/config/common_base +++ b/config/common_base @@ -793,6 +793,13 @@ CONFIG_RTE_LIBRTE_VHOST_NUMA=n CONFIG_RTE_LIBRTE_VHOST_DEBUG=n # +# Compile raw device support +# EXPERIMENTAL: API may change without prior notice +# +CONFIG_RTE_LIBRTE_RAWDEV=y +CONFIG_RTE_LIBRTE_RAWDEV_DEBUG=n + +# # Compile vhost PMD # To compile, CONFIG_RTE_LIBRTE_VHOST should be enabled. # diff --git a/lib/Makefile b/lib/Makefile index dc4e8df..4c60f30 100644 --- a/lib/Makefile +++ b/lib/Makefile @@ -126,4 +126,7 @@ DIRS-$(CONFIG_RTE_LIBRTE_KNI) += librte_kni endif DEPDIRS-librte_kni := librte_eal librte_mempool librte_mbuf librte_ether +DIRS-$(CONFIG_RTE_LIBRTE_RAWDEV) += librte_rawdev +DEPDIRS-librte_rawdev := librte_eal librte_mbuf librte_ether librte_cryptodev + include $(RTE_SDK)/mk/rte.subdir.mk