Cover Detail
Show a cover letter.
GET /api/covers/52447/?format=api
{ "id": 52447, "url": "http://patches.dpdk.org/api/covers/52447/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/cover/20190409063344.36564-1-vipin.varghese@intel.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20190409063344.36564-1-vipin.varghese@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20190409063344.36564-1-vipin.varghese@intel.com", "date": "2019-04-09T06:33:42", "name": "[v8,0/2] guide to debug and troubleshoot.", "submitter": { "id": 882, "url": "http://patches.dpdk.org/api/people/882/?format=api", "name": "Varghese, Vipin", "email": "vipin.varghese@intel.com" }, "mbox": "http://patches.dpdk.org/project/dpdk/cover/20190409063344.36564-1-vipin.varghese@intel.com/mbox/", "series": [ { "id": 4192, "url": "http://patches.dpdk.org/api/series/4192/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=4192", "date": "2019-04-09T06:33:42", "name": "guide to debug and troubleshoot.", "version": 8, "mbox": "http://patches.dpdk.org/series/4192/mbox/" } ], "comments": "http://patches.dpdk.org/api/covers/52447/comments/", "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@dpdk.org", "Delivered-To": "patchwork@dpdk.org", "Received": [ "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 9BD8E4CC3;\n\tTue, 9 Apr 2019 08:33:28 +0200 (CEST)", "from mga04.intel.com (mga04.intel.com [192.55.52.120])\n\tby dpdk.org (Postfix) with ESMTP id AF62C2B95\n\tfor <dev@dpdk.org>; Tue, 9 Apr 2019 08:33:26 +0200 (CEST)", "from fmsmga005.fm.intel.com ([10.253.24.32])\n\tby fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t08 Apr 2019 23:33:25 -0700", "from unknown (HELO saesrv02-S2600CWR.intel.com) ([10.224.122.203])\n\tby fmsmga005.fm.intel.com with ESMTP; 08 Apr 2019 23:33:22 -0700" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "X-IronPort-AV": "E=Sophos;i=\"5.60,328,1549958400\"; d=\"scan'208\";a=\"336190489\"", "From": "Vipin Varghese <vipin.varghese@intel.com>", "To": "dev@dpdk.org, marko.kovacevic@intel.com, john.mcnamara@intel.com,\n\tshreyansh.jain@nxp.com", "Cc": "keith.wiles@intel.com, amit.tamboli@intel.com, sanjay.padubidri@intel.com,\n\tamol.patel@intel.com, ferruh.yigit@intel.com,\n\tVipin Varghese <vipin.varghese@intel.com>", "Date": "Tue, 9 Apr 2019 12:03:42 +0530", "Message-Id": "<20190409063344.36564-1-vipin.varghese@intel.com>", "X-Mailer": "git-send-email 2.17.1", "In-Reply-To": "<20190225171222.64134-3-vipin.varghese@intel.com>", "References": "<20190225171222.64134-3-vipin.varghese@intel.com>", "Subject": "[dpdk-dev] [PATCH v8 0/2] guide to debug and troubleshoot.", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.15", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n\t<mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n\t<mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "The patch series adds a how-to guide for debugging and\ntroubleshooting tips.\n\nMotivation\n==========\n\nDPDK proc-info tool is been enhanced to accommodate the debug information\nfor the port, traffic manager crypto, ring and mempool contents. With these\nadditional information, it becomes easy to analyze issues and performance\nvariance.\n\nBut applications are designed based on the target platform, workload, poll\nmode drivers, and multi-process. This raises variance in debugging and\ncollecting data. Hence attempt of patch series is identified such symptoms\nand share step by step guide to cover the cases.\n\nNot all possible cases could be covered in a single attempt. But with\nfeedback and support from the community, this can be expanded.\n\n\nStatus\n======\n\nReviews and changes accommodated. ACK received for documentation and SVG\nfiles.\n\n\nChange Log\n==========\n\nV8:\n - remove quotes from notes section - John Macnamara\n - add quotes for DPDK API and variables - Thomas Monjalon\n - update use of JUMBO for rx bottleneck - Vipin Varghese\n - Add ACK from v7 - Vipin Varghese\n\nV7:\n - add space to note and indent - John Macnamara\n\nV6:\n - correction for word style and grammar - Thomas Monjalon\n - add license for svg files - Vipin Varghese\n\nv5:\n - rework of content - Vipin Varghese\n\nV4:\n - Correction for word style - Shreyansh Jain\n\nV3:\n - reorder for removing warning in 'make doc-guides-html' - Thomas Monjalon\n\nV2:\n - add offload flag check - Vipin Varghese\n - change tab to space - Marko Kovacevic\n - spelling correction - Marko Kovacevic\n - remove extra characters - Marko Kovacevic\n - add ACK by Marko - Vipn Varghese\n - add ACK from Marko - Vipin Varghese\n\nVipin Varghese (2):\n doc: add svg for debug and troubleshoot guide\n doc: add guide for debug and troubleshoot\n\n doc/guides/howto/debug_troubleshoot_guide.rst | 464 ++++++++++++++++++\n doc/guides/howto/img/dtg_consumer_ring.svg | 24 +\n doc/guides/howto/img/dtg_crypto.svg | 21 +\n .../howto/img/dtg_distributor_worker.svg | 36 ++\n doc/guides/howto/img/dtg_mempool.svg | 27 +\n doc/guides/howto/img/dtg_pdump.svg | 33 ++\n doc/guides/howto/img/dtg_producer_ring.svg | 24 +\n doc/guides/howto/img/dtg_qos_tx.svg | 29 ++\n doc/guides/howto/img/dtg_rx_rate.svg | 25 +\n doc/guides/howto/img/dtg_rx_tx_drop.svg | 33 ++\n doc/guides/howto/img/dtg_sample_app_model.svg | 110 +++++\n doc/guides/howto/img/dtg_service.svg | 20 +\n doc/guides/howto/index.rst | 1 +\n 13 files changed, 847 insertions(+)\n create mode 100644 doc/guides/howto/debug_troubleshoot_guide.rst\n create mode 100644 doc/guides/howto/img/dtg_consumer_ring.svg\n create mode 100644 doc/guides/howto/img/dtg_crypto.svg\n create mode 100644 doc/guides/howto/img/dtg_distributor_worker.svg\n create mode 100644 doc/guides/howto/img/dtg_mempool.svg\n create mode 100644 doc/guides/howto/img/dtg_pdump.svg\n create mode 100644 doc/guides/howto/img/dtg_producer_ring.svg\n create mode 100644 doc/guides/howto/img/dtg_qos_tx.svg\n create mode 100644 doc/guides/howto/img/dtg_rx_rate.svg\n create mode 100644 doc/guides/howto/img/dtg_rx_tx_drop.svg\n create mode 100644 doc/guides/howto/img/dtg_sample_app_model.svg\n create mode 100644 doc/guides/howto/img/dtg_service.svg\n\nFuture Work\n===========\n\n - More use cases.\n - Runs as non root.\n - Effects of Cache partitioning.\n - How to run application as non root user." }