From patchwork Thu Mar 7 10:06:07 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sunil Kumar Kori X-Patchwork-Id: 138090 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 6EDE743BA7; Thu, 7 Mar 2024 11:06:15 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 579FD42E23; Thu, 7 Mar 2024 11:06:15 +0100 (CET) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by mails.dpdk.org (Postfix) with ESMTP id 4DF6E42DF3 for ; Thu, 7 Mar 2024 11:06:14 +0100 (CET) Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.17.1.24/8.17.1.24) with ESMTP id 427121Y4030227 for ; Thu, 7 Mar 2024 02:06:13 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding:content-type; s= pfpt0220; bh=cAzlTCkACZgDpCRw+/csYjXBrE/owRc4EbL8BA1ovz4=; b=S+b CIt9FiJi0BTnizNtm2Fh7kfGD47VMbszl8Qh5lH3TVF5gqC22kVEf5bcANwrsFaS JqJQmTxkqN3uEnhIzCmLm1ZH3enyJrKbcZgakaMuvNLhyKinH+Uci+HugJeeLIcn aY2uI5BgsfrdabKTZ56eJ6dzsp+/wkQpcc9eALOgOglX+uZ57ebS0o/mEJvCYsxO pOaCIQ3SDKNQfijYOfN1+SQ2u6JkdfSYAIHa4Eowjd9/4Pof0v4BBHJ813AwLudZ CjVFu4FeDVZRfW/GvOkbPkVkUZpr1/l3WJannudBLsuRhmNu6UHUPxs7IUYNPrE8 WUFFsg0+lTXsIvRBwIA== Received: from dc6wp-exch02.marvell.com ([4.21.29.225]) by mx0b-0016f401.pphosted.com (PPS) with ESMTPS id 3wq3jfse2v-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Thu, 07 Mar 2024 02:06:13 -0800 (PST) Received: from DC6WP-EXCH02.marvell.com (10.76.176.209) by DC6WP-EXCH02.marvell.com (10.76.176.209) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1258.12; Thu, 7 Mar 2024 02:06:12 -0800 Received: from maili.marvell.com (10.69.176.80) by DC6WP-EXCH02.marvell.com (10.76.176.209) with Microsoft SMTP Server id 15.2.1258.12 via Frontend Transport; Thu, 7 Mar 2024 02:06:12 -0800 Received: from localhost.localdomain (unknown [10.28.34.25]) by maili.marvell.com (Postfix) with ESMTP id DE85F3F707F; Thu, 7 Mar 2024 02:06:10 -0800 (PST) From: To: Sunil Kumar Kori , Rakesh Kudurumalla CC: Subject: [PATCH v2 1/1] doc: update command scope information Date: Thu, 7 Mar 2024 15:36:07 +0530 Message-ID: <20240307100607.3225783-1-skori@marvell.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20240108073415.1987009-1-skori@marvell.com> References: <20240108073415.1987009-1-skori@marvell.com> MIME-Version: 1.0 X-Proofpoint-GUID: KXm1sWWLOpa4LoZDwbqLDxP3DhYOIm2W X-Proofpoint-ORIG-GUID: KXm1sWWLOpa4LoZDwbqLDxP3DhYOIm2W X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.1011,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2024-03-07_06,2024-03-06_01,2023-05-22_02 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org From: Sunil Kumar Kori Set of CLI commands are classified into following types; - Commands which must be used in script only. - Commands which must be used via telnet session only. - Commands which can be used either in script or via telnet session. Rename "Dynamic" column to "Scope" to provide clear scope of commands. Signed-off-by: Sunil Kumar Kori Acked-by: Rakesh Kudurumalla --- v1..v2: - Rebase on top of the tree. doc/guides/tools/graph.rst | 217 +++++++++++++++++++------------------ 1 file changed, 111 insertions(+), 106 deletions(-) diff --git a/doc/guides/tools/graph.rst b/doc/guides/tools/graph.rst index 5308967b6b..d8c147d73e 100644 --- a/doc/guides/tools/graph.rst +++ b/doc/guides/tools/graph.rst @@ -168,112 +168,117 @@ file to express the requested use case configuration. .. table:: Exposed CLIs :widths: auto - +--------------------------------------+-----------------------------------+---------+----------+ - | Command | Description | Dynamic | Optional | - +======================================+===================================+=========+==========+ - | | graph [bsz ] | | Command to express the desired | No | No | - | | [tmo ] [coremask ] | | use case. Also enables/disable | | | - | | model pcap_enable| | pcap capturing. | | | - | | <0/1> num_pcap_pkts pcap_file| | | | - | | | | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | graph start | | Command to start the graph. | No | No | - | | | This command triggers that no | | | - | | | more commands are left to be | | | - | | | parsed and graph initialization | | | - | | | can be started now. It must be | | | - | | | the last command in usecase.cli | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | graph stats show | | Command to dump current graph | Yes | Yes | - | | | statistics. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | help graph | | Command to dump graph help | Yes | Yes | - | | | message. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | mempool size | | Command to create mempool which | No | No | - | | buffers | | will be further associated to | | | - | | | | RxQ to dequeue the packets. | | | - | | cache numa | | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | help mempool | | Command to dump mempool help | Yes | Yes | - | | | message. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ethdev rxq | | Command to create DPDK port with| No | No | - | | txq | | given number of Rx and Tx queues| | | - | | | . Also attach RxQ with given | | | - | | | mempool. Each port can have | | | - | | | single mempool only i.e. all | | | - | | | RxQs will share the same mempool| | | - | | | . | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | ethdev mtu | | Command to configure MTU of DPDK| Yes | Yes | - | | | port. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ethdev forward | | Command to configure port | No | Yes | - | | | | forwarding of DPDK | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ethdev promiscuous | | Command to enable/disable | Yes | Yes | - | | | | promiscuous mode on DPDK port. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | ethdev show | | Command to dump current ethdev | Yes | Yes | - | | | configuration. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | ethdev stats | | Command to dump current ethdev | Yes | Yes | - | | | statistics. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ethdev ip4 addr add | | Command to configure IPv4 | Yes | Yes | - | | netmask | | address on given PCI device. It | | | - | | | is needed if user wishes to use | | | - | | | ``ipv4_lookup`` node. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ethdev ip6 addr add | | Command to configure IPv6 | Yes | Yes | - | | netmask | | address on given PCI device. It | | | - | | | is needed if user wishes to use | | | - | | | ``ipv6_lookup`` node. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | help ethdev | | Command to dump ethdev help | Yes | Yes | - | | | message. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ipv4_lookup route add ipv4 | | Command to add a route into | Yes | Yes | - | | netmask via | | ``ipv4_lookup`` LPM table. It is| | | - | | | needed if user wishes to route | | | - | | | the packets based on LPM lookup | | | - | | | table. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | help ipv4_lookup | | Command to dump ``ipv4_lookup`` | Yes | Yes | - | | | help message. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ipv6_lookup route add ipv6 | | Command to add a route into | Yes | Yes | - | | netmask via | | ``ipv6_lookup`` LPM table. It is| | | - | | | needed if user wishes to route | | | - | | | the packets based on LPM6 lookup| | | - | | | table. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | help ipv6_lookup | | Command to dump ``ipv6_lookup`` | Yes | Yes | - | | | help message. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | neigh add ipv4 | | Command to add a neighbour | Yes | Yes | - | | | information into | | | - | | | ``ipv4_rewrite`` node. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | neigh add ipv6 | | Command to add a neighbour | Yes | Yes | - | | | information into | | | - | | | ``ipv6_rewrite`` node. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | help neigh | | Command to dump neigh help | Yes | Yes | - | | | message. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | | ethdev_rx map port | | Command to add port-queue-core | No | No | - | | queue core | | mapping to ``ethdev_rx`` node. | | | - | | | ``ethdev_rx`` node instance will| | | - | | | be pinned on given core and will| | | - | | | poll on requested port/queue | | | - | | | pair. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - | help ethdev_rx | | Command to dump ethdev_rx help | Yes | Yes | - | | | message. | | | - +--------------------------------------+-----------------------------------+---------+----------+ - + +--------------------------------------+-----------------------------------+-------------------+----------+ + | Command | Description | Scope | Optional | + +======================================+===================================+===================+==========+ + | | graph [bsz ] | | Command to express the desired | :ref:`1 ` | No | + | | [tmo ] [coremask ] | | use case. Also enables/disable | | | + | | model pcap_enable| | pcap capturing. | | | + | | <0/1> num_pcap_pkts pcap_file| | | | + | | | | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | graph start | | Command to start the graph. | :ref:`1 ` | No | + | | | This command triggers that no | | | + | | | more commands are left to be | | | + | | | parsed and graph initialization | | | + | | | can be started now. It must be | | | + | | | the last command in usecase.cli | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | graph stats show | | Command to dump current graph | :ref:`2 ` | Yes | + | | | statistics. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | help graph | | Command to dump graph help | :ref:`2 ` | Yes | + | | | message. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | mempool size | | Command to create mempool which | :ref:`1 ` | No | + | | buffers | | will be further associated to | | | + | | | | RxQ to dequeue the packets. | | | + | | cache numa | | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | help mempool | | Command to dump mempool help | :ref:`2 ` | Yes | + | | | message. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ethdev rxq | | Command to create DPDK port with| :ref:`1 ` | No | + | | txq | | given number of Rx and Tx queues| | | + | | | . Also attach RxQ with given | | | + | | | mempool. Each port can have | | | + | | | single mempool only i.e. all | | | + | | | RxQs will share the same mempool| | | + | | | . | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | ethdev mtu | | Command to configure MTU of DPDK| :ref:`3 ` | Yes | + | | | port. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ethdev forward | | Command to configure port | :ref:`1 ` | Yes | + | | | | forwarding of DPDK | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ethdev promiscuous | | Command to enable/disable | :ref:`3 ` | Yes | + | | | | promiscuous mode on DPDK port. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | ethdev show | | Command to dump current ethdev | :ref:`2 ` | Yes | + | | | configuration. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | ethdev stats | | Command to dump current ethdev | :ref:`2 ` | Yes | + | | | statistics. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ethdev ip4 addr add | | Command to configure IPv4 | :ref:`3 ` | Yes | + | | netmask | | address on given PCI device. It | | | + | | | is needed if user wishes to use | | | + | | | ``ipv4_lookup`` node. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ethdev ip6 addr add | | Command to configure IPv6 | :ref:`3 ` | Yes | + | | netmask | | address on given PCI device. It | | | + | | | is needed if user wishes to use | | | + | | | ``ipv6_lookup`` node. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | help ethdev | | Command to dump ethdev help | :ref:`2 ` | Yes | + | | | message. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ipv4_lookup route add ipv4 | | Command to add a route into | :ref:`3 ` | Yes | + | | netmask via | | ``ipv4_lookup`` LPM table. It is| | | + | | | needed if user wishes to route | | | + | | | the packets based on LPM lookup | | | + | | | table. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | help ipv4_lookup | | Command to dump ``ipv4_lookup`` | :ref:`2 ` | Yes | + | | | help message. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ipv6_lookup route add ipv6 | | Command to add a route into | :ref:`3 ` | Yes | + | | netmask via | | ``ipv6_lookup`` LPM table. It is| | | + | | | needed if user wishes to route | | | + | | | the packets based on LPM6 lookup| | | + | | | table. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | help ipv6_lookup | | Command to dump ``ipv6_lookup`` | :ref:`2 ` | Yes | + | | | help message. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | neigh add ipv4 | | Command to add a neighbour | :ref:`3 ` | Yes | + | | | information into | | | + | | | ``ipv4_rewrite`` node. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | neigh add ipv6 | | Command to add a neighbour | :ref:`3 ` | Yes | + | | | information into | | | + | | | ``ipv6_rewrite`` node. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | help neigh | | Command to dump neigh help | :ref:`2 ` | Yes | + | | | message. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | | ethdev_rx map port | | Command to add port-queue-core | :ref:`1 ` | No | + | | queue core | | mapping to ``ethdev_rx`` node. | | | + | | | ``ethdev_rx`` node instance will| | | + | | | be pinned on given core and will| | | + | | | poll on requested port/queue | | | + | | | pair. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + | help ethdev_rx | | Command to dump ethdev_rx help | :ref:`2 ` | Yes | + | | | message. | | | + +--------------------------------------+-----------------------------------+-------------------+----------+ + +.. _scopes: + +1. Script only +2. Telnet only +3. Script and telnet both Runtime configuration ---------------------