From patchwork Wed Apr 25 03:17:50 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stephen Hemminger X-Patchwork-Id: 38859 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 199E74CA6; Wed, 25 Apr 2018 05:18:10 +0200 (CEST) Received: from mail-pg0-f68.google.com (mail-pg0-f68.google.com [74.125.83.68]) by dpdk.org (Postfix) with ESMTP id B69FE2B86 for ; Wed, 25 Apr 2018 05:18:00 +0200 (CEST) Received: by mail-pg0-f68.google.com with SMTP id p10so12315862pgn.1 for ; Tue, 24 Apr 2018 20:18: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:in-reply-to:references; bh=bBfh4aWZijzCdCpMQfl8QOexxAyooxRImWr91sQQFN0=; b=VxbvqdWO18cB+cEu2GEmupRYdCLvy+eLKJ0hUAJrC2CMkERAODthg1eZl25AX+OMuD TAZquj3FkJ3K8xVCDTyEkKv4AvWxB2Zaafw0y2tivop5zGjPTUVnBNqO5vl75kTdHSRU 8ipbF6TlZTDp3pWBk8U93Awaykmu+EWA5c0oucAlvvCym9L9RZyl1gzKeDkkhToLFFjR pe5bveESnkJHjwAJz+XAxVVBZ7Hfm4gtC6IQxJjtOo3O1BKYjSmyj7yJUUWtVhKHF7Tm ViGGfU5Y+V+4x2YYt4GLtP6qBeiWbCCUMIZLYPPNW5iRseKpsiUkMwAXoTVRGGgQAwIa aT6A== 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:in-reply-to :references; bh=bBfh4aWZijzCdCpMQfl8QOexxAyooxRImWr91sQQFN0=; b=qTHHsZAwKG4jWseTIAwCqKMbzrssVE1Ji7femFbRe3GBVvoLOCSPiYMcq7x4uXU3WI T49mz3T3eaIRdkETcS0A2FXxTkDxzNzydVnCzLbfDLMR288b+h3KRZOe/+4MK5mofl+i Ru1UCuCUH3BGbpTzBI4f5rNlEQJsal+bMSmx+LP1LZMzV9kYhYkbeW7hHPf/D/+ARTmc V4+PTb3K5JbvgWnEnDAfpQYetr8/ZESRJIJCl/VPUK92dzhNbYGjNaRYS0er+mIlsgtc IZT8MYAFGx6a8DHqshmzCMMOus9DqULrGY4J7+TSRVL/br8Y/cdc97hA1jQAhFIIx4xm 9hyg== X-Gm-Message-State: ALQs6tBCBpW8W7wThJafRhmJzInP2k4ASyqbY0fIom3SMxJakgcKFQg9 OMoCD8Ize3sN9jr6tXSlUCiOJczYvBQ= X-Google-Smtp-Source: AB8JxZoVYJDcE5PWlbKK0gfEGyayalRkWh8vskap128MlwywRe9W7tBNG6KDC6ebIEt2PpoDaM8mZw== X-Received: by 2002:a17:902:7d09:: with SMTP id z9-v6mr4784690pll.4.1524626279618; Tue, 24 Apr 2018 20:17:59 -0700 (PDT) Received: from xeon-e3.lan (204-195-71-95.wavecable.com. [204.195.71.95]) by smtp.gmail.com with ESMTPSA id x5sm20137303pfh.115.2018.04.24.20.17.58 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 24 Apr 2018 20:17:58 -0700 (PDT) From: Stephen Hemminger To: dev@dpdk.org Cc: Stephen Hemminger Date: Tue, 24 Apr 2018 20:17:50 -0700 Message-Id: <20180425031750.30973-6-stephen@networkplumber.org> X-Mailer: git-send-email 2.17.0 In-Reply-To: <20180425031750.30973-1-stephen@networkplumber.org> References: <20180425031750.30973-1-stephen@networkplumber.org> Subject: [dpdk-dev] [PATCH v3 5/5] doc: update guides for current preferrred log level syntax 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" Use symbolic names and match rather than numbers and regex in the guides. Signed-off-by: Stephen Hemminger --- doc/guides/cryptodevs/dpaa2_sec.rst | 2 +- doc/guides/cryptodevs/dpaa_sec.rst | 2 +- doc/guides/faq/faq.rst | 23 ++++++++++------------- doc/guides/nics/dpaa2.rst | 4 ++-- doc/guides/nics/qede.rst | 2 +- doc/guides/nics/sfc_efx.rst | 12 ++++++------ doc/guides/nics/tap.rst | 2 +- 7 files changed, 22 insertions(+), 25 deletions(-) diff --git a/doc/guides/cryptodevs/dpaa2_sec.rst b/doc/guides/cryptodevs/dpaa2_sec.rst index 5558ea593e10..fcea48375912 100644 --- a/doc/guides/cryptodevs/dpaa2_sec.rst +++ b/doc/guides/cryptodevs/dpaa2_sec.rst @@ -211,7 +211,7 @@ For enabling logs, use the following EAL parameter: .. code-block:: console - ./your_crypto_application --log-level=pmd.crypto.dpaa2, + ./your_crypto_application --log-level=pmd.crypto.dpaa2: Using ``crypto.dpaa2`` as log matching criteria, all Crypto PMD logs can be enabled which are lower than logging ``level``. diff --git a/doc/guides/cryptodevs/dpaa_sec.rst b/doc/guides/cryptodevs/dpaa_sec.rst index 2964e83572eb..caf3d9cab2ac 100644 --- a/doc/guides/cryptodevs/dpaa_sec.rst +++ b/doc/guides/cryptodevs/dpaa_sec.rst @@ -154,7 +154,7 @@ For enabling logs, use the following EAL parameter: .. code-block:: console - ./your_crypto_application --log-level=pmd.crypto.dpaa, + ./your_crypto_application --log-level=pmd.crypto.dpaa: Using ``pmd.crypto.dpaa`` as log matching criteria, all Crypto PMD logs can be enabled which are lower than logging ``level``. diff --git a/doc/guides/faq/faq.rst b/doc/guides/faq/faq.rst index c1132fb4162f..f19c1389b6af 100644 --- a/doc/guides/faq/faq.rst +++ b/doc/guides/faq/faq.rst @@ -62,19 +62,16 @@ the wrong socket, the application simply will not start. On application startup, there is a lot of EAL information printed. Is there any way to reduce this? --------------------------------------------------------------------------------------------------- -Yes, the option ``--log-level=`` accepts one of these numbers: - -.. code-block:: c - - #define RTE_LOG_EMERG 1U /* System is unusable. */ - #define RTE_LOG_ALERT 2U /* Action must be taken immediately. */ - #define RTE_LOG_CRIT 3U /* Critical conditions. */ - #define RTE_LOG_ERR 4U /* Error conditions. */ - #define RTE_LOG_WARNING 5U /* Warning conditions. */ - #define RTE_LOG_NOTICE 6U /* Normal but significant condition. */ - #define RTE_LOG_INFO 7U /* Informational. */ - #define RTE_LOG_DEBUG 8U /* Debug-level messages. */ - +Yes, the option ``--log-level=`` accepts either symbolic names (or numbers): + +1. emergency +2. alert +3. critical +4. error +5. warning +6. notice +7. info +8. debug How can I tune my network application to achieve lower latency? --------------------------------------------------------------- diff --git a/doc/guides/nics/dpaa2.rst b/doc/guides/nics/dpaa2.rst index 8e38efff4a27..85d26503f325 100644 --- a/doc/guides/nics/dpaa2.rst +++ b/doc/guides/nics/dpaa2.rst @@ -547,7 +547,7 @@ For enabling logging for DPAA2 PMD, following log-level prefix can be used: .. code-block:: console - --log-level=bus.fslmc, -- ... + --log-level=bus.fslmc: -- ... Using ``bus.fslmc`` as log matching criteria, all FSLMC bus logs can be enabled which are lower than logging ``level``. @@ -556,7 +556,7 @@ which are lower than logging ``level``. .. code-block:: console - --log-level=pmd.net.dpaa2, -- ... + --log-level=pmd.net.dpaa2: -- ... Using ``pmd.dpaa2`` as log matching criteria, all PMD logs can be enabled which are lower than logging ``level``. diff --git a/doc/guides/nics/qede.rst b/doc/guides/nics/qede.rst index 42dd70db39df..f6fb548155a3 100644 --- a/doc/guides/nics/qede.rst +++ b/doc/guides/nics/qede.rst @@ -193,7 +193,7 @@ This section provides instructions to configure SR-IOV with Linux OS. #. Running testpmd - (Supply ``--log-level="pmd.net.qede.driver:7`` to view informational messages): + (Supply ``--log-level="pmd.net.qede.driver:info`` to view informational messages): Refer to the document :ref:`compiling and testing a PMD for a NIC ` to run diff --git a/doc/guides/nics/sfc_efx.rst b/doc/guides/nics/sfc_efx.rst index abaed67f52b6..07ccafaaf750 100644 --- a/doc/guides/nics/sfc_efx.rst +++ b/doc/guides/nics/sfc_efx.rst @@ -356,26 +356,26 @@ Dynamic Logging Parameters One may leverage EAL option "--log-level" to change default levels for the log types supported by the driver. The option is used with -an argument typically consisting of two parts separated by a comma. +an argument typically consisting of two parts separated by a colon. -Level value is the last part which takes an integer greater than 0. -Log type is the former part which may contain a regular expression. +Level value is the last part which takes a symbolic name (or integer). +Log type is the former part which may shell match syntax. Depending on the choice of the expression, the given log level may be used either for some specific log type or for a subset of types. SFC EFX PMD provides the following log types available for control: -- ``pmd.net.sfc.driver`` (default level is **6** - ``RTE_LOG_NOTICE``) +- ``pmd.net.sfc.driver`` (default level is **notice**) Affects driver-wide messages unrelated to any particular devices. -- ``pmd.net.sfc.main`` (default level is **6** - ``RTE_LOG_NOTICE``) +- ``pmd.net.sfc.main`` (default level is **notice**) Matches a subset of per-port log types registered during runtime. A full name for a particular type may be obtained by appending a dot and a PCI device identifier (``XXXX:XX:XX.X``) to the prefix. -- ``pmd.net.sfc.mcdi`` (default level is **6** - ``RTE_LOG_NOTICE``) +- ``pmd.net.sfc.mcdi`` (default level is **notice**) Extra logging of the communication with the NIC's management CPU. The format of the log is consumed by the Solarflare netlogdecode diff --git a/doc/guides/nics/tap.rst b/doc/guides/nics/tap.rst index c97786acaa53..3e038cc5eec1 100644 --- a/doc/guides/nics/tap.rst +++ b/doc/guides/nics/tap.rst @@ -166,7 +166,7 @@ Run pktgen from the pktgen directory in a terminal with a commandline like the following:: sudo ./app/app/x86_64-native-linuxapp-gcc/app/pktgen -l 1-5 -n 4 \ - --proc-type auto --log-level 8 --socket-mem 512,512 --file-prefix pg \ + --proc-type auto --log-level debug --socket-mem 512,512 --file-prefix pg \ --vdev=net_tap0 --vdev=net_tap1 -b 05:00.0 -b 05:00.1 \ -b 04:00.0 -b 04:00.1 -b 04:00.2 -b 04:00.3 \ -b 81:00.0 -b 81:00.1 -b 81:00.2 -b 81:00.3 \