From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id E3D61A04B0; Fri, 14 Aug 2020 22:12:04 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 3971F1C0C3; Fri, 14 Aug 2020 22:12:03 +0200 (CEST) Received: from mail-lf1-f68.google.com (mail-lf1-f68.google.com [209.85.167.68]) by dpdk.org (Postfix) with ESMTP id 5C7901C0BC for ; Fri, 14 Aug 2020 22:12:02 +0200 (CEST) Received: by mail-lf1-f68.google.com with SMTP id v15so5419274lfg.6 for ; Fri, 14 Aug 2020 13:12:02 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:cc:subject:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=PKDRB+c7AeDK4Bf5tEmxDSRHG6UcbqwCAgU105GTsgo=; b=T9Ss7kTmTmatCOlWG+hmp5Fb+r38XRDBGiVoulCNaybgqN7POGc4ihkEVPEauKX77a LDxaE9jdzDKFeiAH9SGRD4I1+MKwztUSGCnCl5ap3I6IDqsb5vZF+We+fsGJnyqEniEB CQMQnnd6Ti/Ppz2LtfgS8myhf3WCYJjxzqmaeNctU0pYSH4n+Ct71w9y0xs8l5txV/L9 OfQNpyKRexN0cBRRudAu/XkIlJo1XPLHgnxc1d9ski94TKGfOdU2zw4yYL2NkX/sF4kR Dp9zQjNzLJuUQmw58edjRrx8V7XgXu+4a6WA3k4a1+9dDlOqJ1hDsg9NhRkbmsJFRx5C hAxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:cc:subject:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=PKDRB+c7AeDK4Bf5tEmxDSRHG6UcbqwCAgU105GTsgo=; b=k4T0/8Ttup+jDfYRepku9H7EZJ4ql4GaxMlU/xiMW+1ssvTD9qu2LzIOEUNBqUlDs2 x08UnDj4ldnt6g1ITtzP2aFPoGQjqm+B10dkrQIBg35Ru+iUvnG3/Svd11GQdiHBc6Cm FlJ4TCChOYXK6FQBybv//b1I8lcpjSuv5Phni7awnVqJdnsIUEkvWJKyXysp8Jel36tU nfCmqnLt7r6PfkwWIbj14c4PS/g89wWQLmwzoumyecuZYVNCuVOahuVyVBXf9+9sM6C7 MPOIO6uMZih2R0Z93GTl1GP4qQSZUiXUDUga+HIM24uNXhKfo9VRlKPuXgHqhxgmdLw5 s+4g== X-Gm-Message-State: AOAM533RNAhNpHkbLXeTYXdQmFxUP1omEKYonEJeS+SkmcWLm52esQRX 5rNcuzO/1bAR3KBHwFl17DM= X-Google-Smtp-Source: ABdhPJxQRsBLBqmzyRspKLCfOO2iI3/4o6RcUl5Uy3Vk4IpAB7clJ606tzx7MH2RiRJKzgbs9vH/7A== X-Received: by 2002:a19:7710:: with SMTP id s16mr1963345lfc.162.1597435921782; Fri, 14 Aug 2020 13:12:01 -0700 (PDT) Received: from sovereign (broadband-37-110-65-23.ip.moscow.rt.ru. [37.110.65.23]) by smtp.gmail.com with ESMTPSA id m12sm1950807lji.106.2020.08.14.13.12.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 14 Aug 2020 13:12:00 -0700 (PDT) Date: Fri, 14 Aug 2020 23:11:59 +0300 From: Dmitry Kozlyuk To: Narcisa Ana Maria Vasile Cc: dev@dpdk.org, thomas@monjalon.net, haramakr@linux.microsoft.com, ocardona@microsoft.com, pallavi.kadam@intel.com, ranjit.menon@intel.com, dmitrym@microsoft.com, Harini Ramakrishnan Message-ID: <20200814231159.6d278b04@sovereign> In-Reply-To: <1597360905-74106-22-git-send-email-navasile@linux.microsoft.com> References: <1597360905-74106-1-git-send-email-navasile@linux.microsoft.com> <1597360905-74106-22-git-send-email-navasile@linux.microsoft.com> X-Mailer: Claws Mail 3.17.4 (GTK+ 2.24.32; x86_64-pc-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Subject: Re: [dpdk-dev] [PATCH 21/22] doc: updating REAME for NetUIO driver 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" On Thu, 13 Aug 2020 16:21:44 -0700, Narcisa Ana Maria Vasile wrote: > From: Harini Ramakrishnan >=20 > Signed-off-by: Harini Ramakrishnan > --- > kernel/README_NetUIO.rst | 63 ++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 63 insertions(+) > create mode 100644 kernel/README_NetUIO.rst >=20 > diff --git a/kernel/README_NetUIO.rst b/kernel/README_NetUIO.rst > new file mode 100644 > index 000000000..9b21a4a8b > --- /dev/null > +++ b/kernel/README_NetUIO.rst > @@ -0,0 +1,63 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2020 Microsoft Corporation. > + > +Compiling the NetUIO Driver from Source > +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D > + > +Operating System > +~~~~~~~~~~~~~~~~ > + > +The NetUIO source has been validated against the following operating sys= tems: > + > +* Windows Server 2016 > +* Windows Server 2019 > + > +Hardware Requirements > +~~~~~~~~~~~~~~~~~~~~~ > +The NetUIO driver has been validated using the following network adapter= s on the Windows platform: > + > +* > +* NICs missing. > + > +Software Requirements > +~~~~~~~~~~~~~~~~~~~~~ > + > +* Install Microsoft Visual Studio 2017 or Visual Stuido Studio 2019 Ente= rprise from https://visualstudio.microsoft.com/downloads/=20 AFAIK, Visual Studio 2019 Community Edition is sufficient. > + * During installation ensure following components are selected: > + Windows 10 SDK (10.0.15063.0)=20 > + Windows 10 SDK (10.0.17763.0) > + Windows Drivers Kit > + =09 > +* Install WDK for Windows 10 (10.0.17763.1) from https://docs.microsoft.= com/en-us/windows-hardware/drivers/download-the-wdk=20 > + > +Building the NetUIO Driver > +-------------------------- > +Follow the steps below to build the NetUIO driver and install the driver= for the network adapter.=20 > + > +* Clone the dpdk-kmods repository: git clone git://dpdk.org/dpdk-kmods > +* Navigate to \dpdk-kmods\windows\netuio\mk\exec-env\windows\netuio > +* Load netuio.sln in Microsoft Visual Studio 2017 or 2019 > +* Choose Release as the configuration mode and Build the solution > +* The resultant output files can be found in \dpdk-kmods\windows\netuio\= x64\Release\netuio > +=20 > +Installing netuio.sys Driver for development > +-------------------------------------------- > +NOTE: In a development environment, NetUIO driver can be loaded by enabl= ing test-signing.=20 > +Please implement adequate precautionary measures before installing a tes= t-signed driver, replacing a signed-driver. reStructured Text syntax for banners (note, warning) is as follows: .. note:: Banner text. > + > +To ensure test-signed kernel-mode drivers can load on Windows, enable te= st-signing, using the following BCDEdit command. > + > +C:\windows\system32>Bcdedit.exe -set TESTSIGNING ON =20 > + > +Windows displays the text =E2=80=9CTest Mode=E2=80=9D to remind users th= e system has test-signing enabled.=20 > +Refer to the MSDN documentation on how to Test-Sign a Driver Package. There are similar instructions in windows/README.rst. You might choose to point there, but this is not a strong opinion. > +=20 > +To procure a WHQL signed NetUIO driver for Windows, please reach out to = dpdkwin@microsoft.com > + > +* Go to Device Manager -> Network Adapters. > +* Right Click on target network adapter -> Select Update Driver. > +* Select =E2=80=9CBrowse my computer for driver software=E2=80=9D. > +* In the resultant Window, select =E2=80=9CLet me pick from a list of av= ailable drivers on my computer=E2=80=9D. s/Window/window/ > +* Select =E2=80=9CDPDK netUIO for Network Adapter=E2=80=9D from the list= of drivers. > +* The NetUIO.sys driver is successfully installed. > +=20 > \ No newline at end of file No newline at end of file.