Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/109279/?format=api
{ "id": 109279, "url": "http://patches.dpdk.org/api/patches/109279/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20220406151106.2915304-14-juraj.linkes@pantheon.tech/", "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": "<20220406151106.2915304-14-juraj.linkes@pantheon.tech>", "list_archive_url": "https://inbox.dpdk.org/dev/20220406151106.2915304-14-juraj.linkes@pantheon.tech", "date": "2022-04-06T15:10:55", "name": "[RFC,v1,13/24] dts: merge DTS doc/dts_gsg/usr_guide/asan_test.rst to DPDK", "commit_ref": null, "pull_url": null, "state": "rfc", "archived": true, "hash": "0e9d89a4bbd492c797928eb01187605902679dca", "submitter": { "id": 1626, "url": "http://patches.dpdk.org/api/people/1626/?format=api", "name": "Juraj Linkeš", "email": "juraj.linkes@pantheon.tech" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20220406151106.2915304-14-juraj.linkes@pantheon.tech/mbox/", "series": [ { "id": 22379, "url": "http://patches.dpdk.org/api/series/22379/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=22379", "date": "2022-04-06T15:10:42", "name": "merge DTS documentation files to DPDK", "version": 1, "mbox": "http://patches.dpdk.org/series/22379/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/109279/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/109279/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "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])\n\tby inbox.dpdk.org (Postfix) with ESMTP id A6A51A0508;\n\tWed, 6 Apr 2022 17:12:52 +0200 (CEST)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id BD4BF428E4;\n\tWed, 6 Apr 2022 17:11:30 +0200 (CEST)", "from lb.pantheon.sk (lb.pantheon.sk [46.229.239.20])\n by mails.dpdk.org (Postfix) with ESMTP id 3515D428D0\n for <dev@dpdk.org>; Wed, 6 Apr 2022 17:11:27 +0200 (CEST)", "from localhost (localhost [127.0.0.1])\n by lb.pantheon.sk (Postfix) with ESMTP id 281F6184FE9;\n Wed, 6 Apr 2022 17:11:26 +0200 (CEST)", "from lb.pantheon.sk ([127.0.0.1])\n by localhost (lb.pantheon.sk [127.0.0.1]) (amavisd-new, port 10024)\n with ESMTP id ZX6FFZobJozw; Wed, 6 Apr 2022 17:11:25 +0200 (CEST)", "from entguard.lab.pantheon.local (unknown [46.229.239.141])\n by lb.pantheon.sk (Postfix) with ESMTP id 5856F184FF9;\n Wed, 6 Apr 2022 17:11:13 +0200 (CEST)" ], "X-Virus-Scanned": "amavisd-new at siecit.sk", "From": "=?utf-8?q?Juraj_Linke=C5=A1?= <juraj.linkes@pantheon.tech>", "To": "thomas@monjalon.net, david.marchand@redhat.com,\n Honnappa.Nagarahalli@arm.com, ohilyard@iol.unh.edu, lijuan.tu@intel.com", "Cc": "dev@dpdk.org, =?utf-8?q?Juraj_Linke=C5=A1?= <juraj.linkes@pantheon.tech>", "Subject": "[RFC PATCH v1 13/24] dts: merge DTS\n doc/dts_gsg/usr_guide/asan_test.rst to DPDK", "Date": "Wed, 6 Apr 2022 15:10:55 +0000", "Message-Id": "<20220406151106.2915304-14-juraj.linkes@pantheon.tech>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20220406151106.2915304-1-juraj.linkes@pantheon.tech>", "References": "<20220406151106.2915304-1-juraj.linkes@pantheon.tech>", "MIME-Version": "1.0", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <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 <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "---\n dts/doc/dts_gsg/usr_guide/asan_test.rst | 59 +++++++++++++++++++++++++\n 1 file changed, 59 insertions(+)\n create mode 100644 dts/doc/dts_gsg/usr_guide/asan_test.rst", "diff": "diff --git a/dts/doc/dts_gsg/usr_guide/asan_test.rst b/dts/doc/dts_gsg/usr_guide/asan_test.rst\nnew file mode 100644\nindex 0000000000..65de3a7f80\n--- /dev/null\n+++ b/dts/doc/dts_gsg/usr_guide/asan_test.rst\n@@ -0,0 +1,59 @@\n+About ASan\n+===========\n+\n+AddressSanitizer a.k.a. ASan is a widely-used debugging tool to detect memory access errors.\n+It helps to detect issues like use-after-free, various kinds of buffer overruns in C/C++\n+programs, and other similar errors, as well as printing out detailed debug information whenever\n+an error is detected.\n+\n+ASan is integrated with gcc and clang and can be enabled via a meson option: -Db_sanitize=address,\n+See the documentation for details (especially regarding clang).\n+\n+About ASan test\n+===============\n+\n+DTS adds one parameter named asan to control ASan test, support through added asan parameter,\n+otherwise not support. It contains three steps on the whole:\n+\n+ - Append ASan build parameters to meson build options. this may open the function of ASan detect\n+ memory access errors. if occuring memory access errors, the stack info will recorded in DTS log\n+\n+ - After all cases tested finish, analyze DTS log and redefine case test result according to whether\n+ case log contain memory access error info. modify the result to failed if contain otherwise inherit\n+ the original result.\n+\n+ - Generate ASan report to distinguish it from the original report.\n+\n+ASan test steps\n+=======================\n+\n+Check ASan test config\n+----------------------\n+\n+ASan config file is placed in conf/asan.cfg\n+\n+Firstly, check the log filter bounds pairs, customer can modify the pairs if need, and use colon split\n+bounds, use comma split pairs, there are two pairs key word default as follow:\n+\n+ - filter_bounds=LeakSanitizer:SUMMARY,AddressSanitizer:SUMMARY\n+\n+Secondly, check the meson build parameter options pair, there is a list of parameters default as follow:\n+\n+ - build_param=-Dbuildtype=debug -Db_lundef=false -Db_sanitize=address\n+\n+Launch DTS\n+----------\n+\n+ ./dts --asan\n+\n+When launch DTS, there are two parameters need attention:\n+ - provide --asan parameter, means support ASan test.\n+ - Don't provide -s parameter to skip build DPDK package. ASan test need rebuild DPDK package.\n+\n+Obtain the ASan test report\n+---------------------------\n+\n+ASan report located at DTS output directory also, and provided three format as follow:\n+ - Json format named asan_test_results.json\n+ - Excel format named asan_test_results.xls\n+ - Statistics information of txt format named asan_statistics.txt\n\\ No newline at end of file\n", "prefixes": [ "RFC", "v1", "13/24" ] }