From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-12.5 required=3.0 tests=BAYES_00, DKIM_ADSP_CUSTOM_MED,DKIM_INVALID,DKIM_SIGNED,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS, USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 180BFC2BB84 for ; Thu, 10 Sep 2020 07:03:53 +0000 (UTC) Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by mail.kernel.org (Postfix) with ESMTP id B41E120882 for ; Thu, 10 Sep 2020 07:03:52 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=google.com header.i=@google.com header.b="AvAqHkXs" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org B41E120882 Authentication-Results: mail.kernel.org; dmarc=fail (p=reject dis=none) header.from=google.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=owner-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix) id C9572900006; Thu, 10 Sep 2020 03:03:50 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id C22AE6B007E; Thu, 10 Sep 2020 03:03:50 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id A572C900006; Thu, 10 Sep 2020 03:03:50 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from forelay.hostedemail.com (smtprelay0209.hostedemail.com [216.40.44.209]) by kanga.kvack.org (Postfix) with ESMTP id 891136B007D for ; Thu, 10 Sep 2020 03:03:50 -0400 (EDT) Received: from smtpin13.hostedemail.com (10.5.19.251.rfc1918.com [10.5.19.251]) by forelay03.hostedemail.com (Postfix) with ESMTP id 562858248047 for ; Thu, 10 Sep 2020 07:03:50 +0000 (UTC) X-FDA: 77246261820.13.self82_2d12727270e4 Received: from filter.hostedemail.com (10.5.16.251.rfc1918.com [10.5.16.251]) by smtpin13.hostedemail.com (Postfix) with ESMTP id 2596F18140B67 for ; Thu, 10 Sep 2020 07:03:50 +0000 (UTC) X-HE-Tag: self82_2d12727270e4 X-Filterd-Recvd-Size: 6893 Received: from mail-yb1-f201.google.com (mail-yb1-f201.google.com [209.85.219.201]) by imf33.hostedemail.com (Postfix) with ESMTP for ; Thu, 10 Sep 2020 07:03:49 +0000 (UTC) Received: by mail-yb1-f201.google.com with SMTP id g189so644365ybg.9 for ; Thu, 10 Sep 2020 00:03:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=sender:date:in-reply-to:message-id:mime-version:references:subject :from:to:cc; bh=+BKi9csz5osX4KTPzoBomTKB3kjtuT5jT2WVtCJDrmk=; b=AvAqHkXsv7qMuQKnTVg1OfhNw92YOEKDUQ7/oDfMNhxYufaVT9M8mkKJp2N5Fj2Tgw oqdZwnrwHxAut0Byfzq2Ya63bK6G2dsJmJtwEfAZ301TjaRgBAr6TPDsQ/uzm+3mhP7P XV4sDg/LLGvTVF4BCNaXX8Nq6LE7hjr1OPSk2ajZDLAQbLM4egPru0wBU8aAfQRwFzcy pQXV7loKshX9qy1HUlWTHGRQyNaNfGcS2t+v9WIWgsJP2w6PJcE8aPUcN8HNM7VpALDN W1PCqh10Ai/vL6T0U4gYWetWiUCRF6nKHUV/nPswQxa9eVPSGBTckrANpPoPdb+CWQAW XSiQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:sender:date:in-reply-to:message-id:mime-version :references:subject:from:to:cc; bh=+BKi9csz5osX4KTPzoBomTKB3kjtuT5jT2WVtCJDrmk=; b=R5yzhG+GXjBYXVqw6BmBSFZwkvv/jLNrpopgskNusOgj5ikfgNDnwnNpOyTNxENxsX NVh3bZO14U/18IH59v2b3P4i/oeOlir26kQtFiyxzU+UTcsbVWufMtGdSKOLzhS9gfQ7 VzYF4oT44TavrGW3fyZsSoVdvKnBq5b0mx1MGG8L3LUgineI3ECa1e9i6FU72flRWcMb VGV6DGGgRk8GAmPnUPTZm0DigCV8uPa7N4n7XnhHIZhENl6FxUex4b0Lqw94gpU4iDzD DdLZmhg3WJs6nlgsPF5YwKdxO2jJ4MI5sO2TXKIehJDGSM61txHkxiBKS2Z4gyMlMS85 RZUg== X-Gm-Message-State: AOAM5333BIchpin0BivxlZ1pNdZNcsb+m2moq4eSEQpcqT++4KzF2vBR KsBsiA8xdu5WcxmNr1J3AZKj1doPVI0Myg== X-Google-Smtp-Source: ABdhPJyyWHtZNK314x561NUi4PPnX8MrbdIZyQjkBAkwo5J9Q3P2KT4kWz9x6rzrdRkChGnsyQf4Sm4gNm3htA== X-Received: from spirogrip.svl.corp.google.com ([2620:15c:2cb:201:42a8:f0ff:fe4d:3548]) (user=davidgow job=sendgmr) by 2002:a25:6849:: with SMTP id d70mr11302635ybc.117.1599721428940; Thu, 10 Sep 2020 00:03:48 -0700 (PDT) Date: Thu, 10 Sep 2020 00:03:29 -0700 In-Reply-To: <20200910070331.3358048-1-davidgow@google.com> Message-Id: <20200910070331.3358048-5-davidgow@google.com> Mime-Version: 1.0 References: <20200910070331.3358048-1-davidgow@google.com> X-Mailer: git-send-email 2.28.0.526.ge36021eeef-goog Subject: [PATCH v13 4/5] KASAN: Testing Documentation From: David Gow To: trishalfonso@google.com, brendanhiggins@google.com, aryabinin@virtuozzo.com, dvyukov@google.com, mingo@redhat.com, peterz@infradead.org, juri.lelli@redhat.com, vincent.guittot@linaro.org, andreyknvl@google.com, shuah@kernel.org, akpm@linux-foundation.org Cc: linux-kernel@vger.kernel.org, kasan-dev@googlegroups.com, kunit-dev@googlegroups.com, linux-kselftest@vger.kernel.org, linux-mm@kvack.org, David Gow Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 2596F18140B67 X-Spamd-Result: default: False [0.00 / 100.00] X-Rspamd-Server: rspam01 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000007, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: From: Patricia Alfonso Include documentation on how to test KASAN using CONFIG_TEST_KASAN_KUNIT and CONFIG_TEST_KASAN_MODULE. Signed-off-by: Patricia Alfonso Signed-off-by: David Gow Reviewed-by: Andrey Konovalov Reviewed-by: Dmitry Vyukov Acked-by: Brendan Higgins Tested-by: Andrey Konovalov --- Documentation/dev-tools/kasan.rst | 70 +++++++++++++++++++++++++++++++ 1 file changed, 70 insertions(+) diff --git a/Documentation/dev-tools/kasan.rst b/Documentation/dev-tools/kasan.rst index 38fd5681fade..072ecdadba07 100644 --- a/Documentation/dev-tools/kasan.rst +++ b/Documentation/dev-tools/kasan.rst @@ -281,3 +281,73 @@ unmapped. This will require changes in arch-specific code. This allows ``VMAP_STACK`` support on x86, and can simplify support of architectures that do not have a fixed module region. + +CONFIG_KASAN_KUNIT_TEST & CONFIG_TEST_KASAN_MODULE +-------------------------------------------------- + +``CONFIG_KASAN_KUNIT_TEST`` utilizes the KUnit Test Framework for testing. +This means each test focuses on a small unit of functionality and +there are a few ways these tests can be run. + +Each test will print the KASAN report if an error is detected and then +print the number of the test and the status of the test: + +pass:: + + ok 28 - kmalloc_double_kzfree +or, if kmalloc failed:: + + # kmalloc_large_oob_right: ASSERTION FAILED at lib/test_kasan.c:163 + Expected ptr is not null, but is + not ok 4 - kmalloc_large_oob_right +or, if a KASAN report was expected, but not found:: + + # kmalloc_double_kzfree: EXPECTATION FAILED at lib/test_kasan.c:629 + Expected kasan_data->report_expected == kasan_data->report_found, but + kasan_data->report_expected == 1 + kasan_data->report_found == 0 + not ok 28 - kmalloc_double_kzfree + +All test statuses are tracked as they run and an overall status will +be printed at the end:: + + ok 1 - kasan + +or:: + + not ok 1 - kasan + +(1) Loadable Module +~~~~~~~~~~~~~~~~~~~~ + +With ``CONFIG_KUNIT`` enabled, ``CONFIG_KASAN_KUNIT_TEST`` can be built as +a loadable module and run on any architecture that supports KASAN +using something like insmod or modprobe. The module is called ``test_kasan``. + +(2) Built-In +~~~~~~~~~~~~~ + +With ``CONFIG_KUNIT`` built-in, ``CONFIG_KASAN_KUNIT_TEST`` can be built-in +on any architecure that supports KASAN. These and any other KUnit +tests enabled will run and print the results at boot as a late-init +call. + +(3) Using kunit_tool +~~~~~~~~~~~~~~~~~~~~~ + +With ``CONFIG_KUNIT`` and ``CONFIG_KASAN_KUNIT_TEST`` built-in, we can also +use kunit_tool to see the results of these along with other KUnit +tests in a more readable way. This will not print the KASAN reports +of tests that passed. Use `KUnit documentation `_ for more up-to-date +information on kunit_tool. + +.. _KUnit: https://www.kernel.org/doc/html/latest/dev-tools/kunit/index.html + +``CONFIG_TEST_KASAN_MODULE`` is a set of KASAN tests that could not be +converted to KUnit. These tests can be run only as a module with +``CONFIG_TEST_KASAN_MODULE`` built as a loadable module and +``CONFIG_KASAN`` built-in. The type of error expected and the +function being run is printed before the expression expected to give +an error. Then the error is printed, if found, and that test +should be interpretted to pass only if the error was the one expected +by the test. -- 2.28.0.526.ge36021eeef-goog