From patchwork Sun Sep 6 03:38:46 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 76625 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 5B4C4A04BE; Sun, 6 Sep 2020 05:39:03 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A6F432BF1; Sun, 6 Sep 2020 05:39:02 +0200 (CEST) Received: from mail-pj1-f68.google.com (mail-pj1-f68.google.com [209.85.216.68]) by dpdk.org (Postfix) with ESMTP id 1A3472BAB for ; Sun, 6 Sep 2020 05:39:00 +0200 (CEST) Received: by mail-pj1-f68.google.com with SMTP id 2so5011028pjx.5 for ; Sat, 05 Sep 2020 20:39:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=networkplumber-org.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=i9tHnBL2yt9AzLEfUrffejm33BfdmI5bFQpBV8dvh10=; b=rugFXErIqv9voVpwyTyC+G79B0X9oRTobkUPhYTuGrl71kuQ0MwBpDNbfO8lKU95T5 44q1+9ScRcl9dF0CD0serJfdjm8JaLnH5w61YgIplezxqZW8ArVZ4VP9Mj36++ascNwe sVn5UyRne19G06xFINCOKuHjn6voDIraT9Ti1IEP1rvRVnR3noE5z3vj9rtiA6nYdt3f 7DFePsKkRDrBukfplz3Cw9Oz29a0xP8SH4Vvh5qfl0JQeqsn4d8Hyzyo7WF5vJRATpVy w4xz9x0BkQvoWsXQtTDLXLJYBaDdEPzADmaPcmOF8Skwo8CZEVWCtj+QboBD2Ecmgw7H rQyg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=i9tHnBL2yt9AzLEfUrffejm33BfdmI5bFQpBV8dvh10=; b=HAAyEGFkUujDWL2FTFvcJkrIcBQn6LW6kUIzEuXFO0rweihR2cE1zEUOlpC3kAXmV+ Dz0Cw56Phlq39p5aZqvaHID3Vg9rTeei5eN5pIB4JF3S6sP0M9M88gmmPmVS9OkXdBBg Oj/zNzOUiBltqP2lzY3g/05El9HT7CHabE1gTw8ERYFW85NGbrdCIaZq8r7qIO3yJbub Lgjr9cK6zv+/y5qELh1XHvRaosMc/NJLMU84bOXx7p8LfbYUnVpgOs7atypD6HZC70oC ALmLIu26n09EOLEjnrIe3Y1xFx08PCOIU5VYUJlD4wEmVzVJ4PX606Ef1BFAgjXpm7wW wW7g== X-Gm-Message-State: AOAM532w6EpXunyAIh4+rTQa0jTQN2mHaCuqO4bPrEq9LQPwJ6xv5wpG HZnP8sB2mYrk8ZjEEwKhdAP1Dg== X-Google-Smtp-Source: ABdhPJz+S/obLqe61a3C1LtihGLz7tn3pls2p3A5OHScZa+tSJflpiw+JOw04tjKdyW38u45rvksmA== X-Received: by 2002:a17:90a:de81:: with SMTP id n1mr14815107pjv.92.1599363540086; Sat, 05 Sep 2020 20:39:00 -0700 (PDT) Received: from hermes.lan (204-195-22-127.wavecable.com. [204.195.22.127]) by smtp.gmail.com with ESMTPSA id kf10sm8639345pjb.2.2020.09.05.20.38.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 05 Sep 2020 20:38:59 -0700 (PDT) From: Stephen Hemminger To: john.mcnamara@intel.com, marko.kovacevic@intel.com Cc: dev@dpdk.org, Stephen Hemminger Date: Sat, 5 Sep 2020 20:38:46 -0700 Message-Id: <20200906033846.24686-1-stephen@networkplumber.org> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc/devbind: remove references to igb_uio 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" We should be encouraging the use of vfio_pci for developers, not telling them to use igb_uio. Also fix typo where .py suffix is visible in document. Signed-off-by: Stephen Hemminger --- doc/guides/tools/devbind.rst | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/guides/tools/devbind.rst b/doc/guides/tools/devbind.rst index a2910e103aab..52690f018648 100644 --- a/doc/guides/tools/devbind.rst +++ b/doc/guides/tools/devbind.rst @@ -30,11 +30,11 @@ OPTIONS Print the current status of all known network interfaces. For each device, it displays the PCI domain, bus, slot and function, along with a text description of the device. Depending upon whether the - device is being used by a kernel driver, the ``igb_uio`` driver, or no + device is being used by a kernel driver, the ``vfio_pci`` driver, or no driver, other relevant information will be displayed: - the Linux interface name e.g. ``if=eth0`` - - the driver being used e.g. ``drv=igb_uio`` - - any suitable drivers not currently using that device e.g. ``unused=igb_uio`` + - the driver being used e.g. ``drv=vfio_pci`` + - any suitable drivers not currently using that device e.g. ``unused=vfio_pci`` NOTE: if this flag is passed along with a bind/unbind option, the status display will always occur after the other operations have taken place. @@ -69,7 +69,7 @@ OPTIONS .. warning:: - While any user can run the ``dpdk-devbind.py`` script to view the status of the network ports, + While any user can run the ``dpdk-devbind`` script to view the status of the network ports, binding or unbinding network ports requires root privileges. @@ -80,9 +80,9 @@ To display current device status:: dpdk-devbind --status -To bind eth1 from the current driver and move to use igb_uio:: +To bind eth1 from the current driver and move to use vfio_pci:: - dpdk-devbind --bind=igb_uio eth1 + dpdk-devbind --bind=vfio_pci eth1 To unbind 0000:01:00.0 from using any driver:: @@ -92,7 +92,7 @@ To bind 0000:02:00.0 and 0000:02:00.1 to the ixgbe kernel driver:: dpdk-devbind -b ixgbe 02:00.0 02:00.1 -To check status of all network ports, assign one to the igb_uio driver and check status again:: +To check status of all network ports, assign one to the vfio_pci driver and check status again:: # Check the status of the available devices. dpdk-devbind --status @@ -105,12 +105,12 @@ To check status of all network ports, assign one to the igb_uio driver and check 0000:0a:00.0 '82599ES 10-Gigabit' if=eth2 drv=ixgbe unused= - # Bind the device to igb_uio. - sudo dpdk-devbind -b igb_uio 0000:0a:00.0 + # Bind the device to vfio_pci. + sudo dpdk-devbind -b vfio_pci 0000:0a:00.0 # Recheck the status of the devices. dpdk-devbind --status Network devices using DPDK-compatible driver ============================================ - 0000:0a:00.0 '82599ES 10-Gigabit' drv=igb_uio unused= + 0000:0a:00.0 '82599ES 10-Gigabit' drv=vfio_pci unused=