From patchwork Mon Jan 21 10:41:42 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Varghese, Vipin" X-Patchwork-Id: 49970 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 EEFA04C93; Mon, 21 Jan 2019 05:44:53 +0100 (CET) Received: from mga17.intel.com (mga17.intel.com [192.55.52.151]) by dpdk.org (Postfix) with ESMTP id 5C2014C8D for ; Mon, 21 Jan 2019 05:44:52 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga107.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 20 Jan 2019 20:44:51 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.56,501,1539673200"; d="scan'208";a="120035784" Received: from unknown (HELO saesrv02-S2600CWR.intel.com) ([10.224.122.203]) by orsmga003.jf.intel.com with ESMTP; 20 Jan 2019 20:44:48 -0800 From: Vipin Varghese To: dev@dpdk.org, shreyansh.jain@nxp.com, thomas@monjalon.net Cc: john.mcnamara@intel.com, marko.kovacevic@intel.com, amol.patel@intel.com, sanjay.padubidri@intel.com, Vipin Varghese Date: Mon, 21 Jan 2019 16:11:42 +0530 Message-Id: <20190121104144.67365-1-vipin.varghese@intel.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20190116145452.53835-3-vipin.varghese@intel.com> References: <20190116145452.53835-3-vipin.varghese@intel.com> Subject: [dpdk-dev] [PATCH v5 0/2] doc/howto: add debug and troubleshoot guide 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" This patch series is an attempt to add how to guide for commonly seen issues in various application scenario. It also tries to suggest a step by step guide on how to debug and troubleshoot with available stats and counters. Motivation ========== DPDK allows to build application on top of custom off the shelf components for user scenarios that are modelled with single or multi stage. Each module interacts with PMD or rings with either software or hardware offloads. Identify the cause of issue or performance issues will be tedious and time consuming. The how to guide is an effort to consolidate such scenarios with step by step focus to debug and troubleshoot. Status ====== Reviews and changes accommodated. ACK received and updated. Future ====== 1. Suggestion on vlan filters - Shreyansh Jain Change Log ========== Vipin Varghese (2): doc: add svg for debug and troubleshoot guide doc: add guide for debug and troubleshoot doc/guides/howto/debug_troubleshoot_guide.rst | 375 ++++++++++++++++++ doc/guides/howto/img/dtg_consumer_ring.svg | 19 + doc/guides/howto/img/dtg_crypto.svg | 16 + .../howto/img/dtg_distributor_worker.svg | 31 ++ doc/guides/howto/img/dtg_mempool.svg | 22 + doc/guides/howto/img/dtg_pdump.svg | 28 ++ doc/guides/howto/img/dtg_producer_ring.svg | 19 + doc/guides/howto/img/dtg_qos_tx.svg | 24 ++ doc/guides/howto/img/dtg_rx_rate.svg | 20 + doc/guides/howto/img/dtg_rx_tx_drop.svg | 28 ++ doc/guides/howto/img/dtg_sample_app_model.svg | 105 +++++ doc/guides/howto/img/dtg_service.svg | 15 + doc/guides/howto/index.rst | 1 + 13 files changed, 703 insertions(+) create mode 100644 doc/guides/howto/debug_troubleshoot_guide.rst create mode 100644 doc/guides/howto/img/dtg_consumer_ring.svg create mode 100644 doc/guides/howto/img/dtg_crypto.svg create mode 100644 doc/guides/howto/img/dtg_distributor_worker.svg create mode 100644 doc/guides/howto/img/dtg_mempool.svg create mode 100644 doc/guides/howto/img/dtg_pdump.svg create mode 100644 doc/guides/howto/img/dtg_producer_ring.svg create mode 100644 doc/guides/howto/img/dtg_qos_tx.svg create mode 100644 doc/guides/howto/img/dtg_rx_rate.svg create mode 100644 doc/guides/howto/img/dtg_rx_tx_drop.svg create mode 100644 doc/guides/howto/img/dtg_sample_app_model.svg create mode 100644 doc/guides/howto/img/dtg_service.svg V5: - Corrections is spelling - Marko Kovacevic V4: - Added suggestion and corrections - Shreyansh Jain V3: - Reorder the commit order - Thomas Monjalon V2: - Added ACK - Marko Kovacevic