From: ogawa.yasufumi@lab.ntt.co.jp
To: ferruh.yigit@intel.com, spp@dpdk.org, ogawa.yasufumi@lab.ntt.co.jp
Subject: [spp] [PATCH 1/7] docs: remove spp_vm from howto use section
Date: Thu, 17 Jan 2019 11:46:39 +0900 [thread overview]
Message-ID: <1547693205-17710-2-git-send-email-ogawa.yasufumi@lab.ntt.co.jp> (raw)
In-Reply-To: <1547693205-17710-1-git-send-email-ogawa.yasufumi@lab.ntt.co.jp>
From: Yasufumi Ogawa <ogawa.yasufumi@lab.ntt.co.jp>
Remove spp_vm from How to Use section in Setup Guide.
Signed-off-by: Yasufumi Ogawa <ogawa.yasufumi@lab.ntt.co.jp>
---
docs/guides/setup/howto_use.rst | 67 +++++------------------------------------
1 file changed, 8 insertions(+), 59 deletions(-)
diff --git a/docs/guides/setup/howto_use.rst b/docs/guides/setup/howto_use.rst
index 51ad8da..f8a33bc 100644
--- a/docs/guides/setup/howto_use.rst
+++ b/docs/guides/setup/howto_use.rst
@@ -262,12 +262,12 @@ SPP Secondary
-------------
Secondary process behaves as a client of primary process and a worker
-for doing tasks for packet processing.
+for doing tasks for packet processing. There are several kinds of secondary
+process, for example, simply forwarding between ports or classsifying
+by referring packet header.
-This section describes about ``spp_nfv`` and ``spp_vm``,
-which just simply forward packets similar to ``l2fwd``.
-The difference between them is running on host or VM.
-``spp_vm`` runs inside a VM as described in name.
+This section describes about the simplest ``spp_nfv`` which simply forward
+packets similar to ``l2fwd``.
Launch spp_nfv on Host
@@ -301,8 +301,8 @@ unique among all of secondaries.
If you attempt to launch a secondary process with the same ID, it
is failed.
-Launch spp_vf on VM
-~~~~~~~~~~~~~~~~~~~
+Launch SPP on VM
+~~~~~~~~~~~~~~~~
To communicate DPDK application running on a VM,
it is required to create a virtual device for the VM.
@@ -317,7 +317,7 @@ Run ``add`` command with resource UID ``vhost:0`` to create socket file.
spp > nfv 1; add vhost:0
-In this example, create socket file with index 0 from ``spp_nfv`` of ID 1.
+In this example, it creates socket file with index 0 from ``spp_nfv`` of ID 1.
Socket file is created as ``/tmp/sock0``.
It is used as a qemu option to add vhost interface.
@@ -370,54 +370,3 @@ For other options, please refer to
to the VMs. It is just one time for installing for template.
After booted, you install DPDK and SPP in the VM as in the host.
-
-Run ``spp_vm`` with options.
-
-.. code-block:: console
-
- $ cd /path/to/spp
- $ sudo ./src/vm/x86_64-native-linuxapp-gcc/spp_vm \
- -l 0-1 -n 4 \
- --proc-type=primary \
- -- \
- -p 0x01 \
- -n 1 \
- -s 192.168.1.100:6666
-
-- EAL options:
-
- - -l: core list (two cores required)
- - --proc-type: process type
-
-- Application options:
-
- - -p: port mask
- - -n: secondary ID
- - -s: IP address of controller and port prepared for secondary
-
-``spp_vm`` is also managed from SPP controller as same as on host.
-Secondary ID is used to identify for sending messages and must be
-unique among all of secondaries.
-If you attempt to launch a secondary process with the same ID,
-it is failed.
-
-In this case, port mask option is ``-p 0x01`` (using one port) because
-the VM is launched with just one vhost interface.
-You can use two or more ports if you launch VM with several
-``vhost-user`` and ``virtio-net-pci`` interfaces.
-
-Notice that ``spp_vm`` takes options similar to ``spp_primary``, not
-``spp_nfv``.
-It means that ``spp_vm`` has responsibilities for initializing EAL
-and forwarding packets in the VM.
-
-.. note::
-
- ``spp_vm`` is actually running as primary process on a VM,
- but managed as secondary process from SPP controller.
- SPP does not support running resource manager as primary inside
- a VM. Client behaves as secondary, but actually a primary, running
- on the VM to communicate with other SPP procesess on host.
-
- ``spp_vm`` must be launched with ``--proc-type=primary`` and
- ``-p [PORTMASK]`` options similar to primary to initialize EAL.
--
2.7.4
next prev parent reply other threads:[~2019-01-17 2:49 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-01-17 2:46 [spp] [PATCH 0/7] Remove spp_vm from documentation ogawa.yasufumi
2019-01-17 2:46 ` ogawa.yasufumi [this message]
2019-01-17 2:46 ` [spp] [PATCH 2/7] docs: remove spp_vm from spp-ctl API ogawa.yasufumi
2019-01-17 2:46 ` [spp] [PATCH 3/7] docs: remove spp_vm from SPP container ogawa.yasufumi
2019-01-17 2:46 ` [spp] [PATCH 4/7] docs: remove spp_vm from usecases ogawa.yasufumi
2019-01-17 2:46 ` [spp] [PATCH 5/7] docs: remove spp_vm from secondary commands ogawa.yasufumi
2019-01-17 2:46 ` [spp] [PATCH 6/7] docs: remove spp_vf from image of usecase ogawa.yasufumi
2019-01-17 2:46 ` [spp] [PATCH 7/7] docs: update hugepages setup ogawa.yasufumi
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1547693205-17710-2-git-send-email-ogawa.yasufumi@lab.ntt.co.jp \
--to=ogawa.yasufumi@lab.ntt.co.jp \
--cc=ferruh.yigit@intel.com \
--cc=spp@dpdk.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).