From patchwork Sat Nov 19 08:12:51 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Gow X-Patchwork-Id: 13049639 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id 2926FC4332F for ; Sat, 19 Nov 2022 08:13:07 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 6D0246B0073; Sat, 19 Nov 2022 03:13:06 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 65A3A6B0074; Sat, 19 Nov 2022 03:13:06 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 4AB528E0001; Sat, 19 Nov 2022 03:13:06 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0011.hostedemail.com [216.40.44.11]) by kanga.kvack.org (Postfix) with ESMTP id 358456B0073 for ; Sat, 19 Nov 2022 03:13:06 -0500 (EST) Received: from smtpin21.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay03.hostedemail.com (Postfix) with ESMTP id 06B3AA0C8C for ; Sat, 19 Nov 2022 08:13:06 +0000 (UTC) X-FDA: 80149476372.21.A0A3464 Received: from mail-pg1-f201.google.com (mail-pg1-f201.google.com [209.85.215.201]) by imf05.hostedemail.com (Postfix) with ESMTP id 86A66100009 for ; Sat, 19 Nov 2022 08:13:05 +0000 (UTC) Received: by mail-pg1-f201.google.com with SMTP id q63-20020a632a42000000b0045724b1dfb9so4282805pgq.3 for ; Sat, 19 Nov 2022 00:13:05 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:from:to:cc:subject:date:message-id:reply-to; bh=EQq0YjZ1txdSpkL6jAisYu5mB9Yl+atKGSU09uhepI4=; b=QtwcUhMLxxlhu63SCsIAZikJ2Cdiebecyw7uTINwtFeToqE0Lb06WSDNRW39Qb9VaT sri0U30v930zgfNas2Ehhu8wEUyD4634+IIW4XBvcADtCMEj/kAOWnEe2YRAMRZ/z+j7 rcwduzeq7GDD2QYV/9UEmfvln20obiZruXwKlHwf4R0BKpT/11tHduTVJOXFlxQXL7H7 fEmqpxkTRIn4LKMBn+T0eDeGYInqOKpNF/4Y8ra0U+e2wb5dlg0+bGIlkmAiG8W9UeZQ 7tovm0gHb5llKcwh5cPdiCYL9uRRFEM1ZOJA3pAHIW4yMfTYS0Va+cOLdN8ts8g1RJae KNkA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:from:subject:message-id:references:mime-version:in-reply-to :date:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=EQq0YjZ1txdSpkL6jAisYu5mB9Yl+atKGSU09uhepI4=; b=oATPD0Vg6+SnRF+d/ZPyRLIPzcV8eczMA0BLC5ZfGp/XV9fKoa5CUy2nWBa7GbReSt SsxQKl1XO6cjAiZmG1eCx6gC6oEdRR5/ksnlNOnP6isjsobdoujovHA0ezBdkE+iGGiD Pc07VFzRm/0iSMQrzYJYRbsLiB69hyZVNadM8f83qSwm3A0E4X7Iv7gJZLS3LavUX3a4 nANzoX/CQ4WTWat7pmCe4t7mXE2iycMnTWwMR6xm3j6swsW81ZUXeYv61YGoWWRPlYrL GItxhelh7clsKALFlNNG23tXJfmxXQP5QJOyT7/TBbprrE1lmcWjlKKEtkdKZger7AXX ma0A== X-Gm-Message-State: ANoB5pnogsDYk8Bgs0oUbe8NICnE6g/lM5qoIV7OjVZOhnyupGpHnRf8 MDibCK3o+DKS2wz9jFaL+zygKunmM4do4w== X-Google-Smtp-Source: AA0mqf78VSvCJWAPNRCcPn1dsdtFg1FE1gaTd9E/VXddYv47AISoGCQreuLzaKBkf9gibnQrFcBIspsXxu+Duw== X-Received: from slicestar.c.googlers.com ([fda3:e722:ac3:cc00:4f:4b78:c0a8:20a1]) (user=davidgow job=sendgmr) by 2002:a17:90b:3941:b0:215:db2e:bb17 with SMTP id oe1-20020a17090b394100b00215db2ebb17mr11493335pjb.166.1668845584292; Sat, 19 Nov 2022 00:13:04 -0800 (PST) Date: Sat, 19 Nov 2022 16:12:51 +0800 In-Reply-To: <20221119081252.3864249-1-davidgow@google.com> Mime-Version: 1.0 References: <20221119081252.3864249-1-davidgow@google.com> X-Mailer: git-send-email 2.38.1.584.g0f3c55d4c2-goog Message-ID: <20221119081252.3864249-2-davidgow@google.com> Subject: [PATCH v3 2/3] kunit: Use the static key when retrieving the current test From: David Gow To: Brendan Higgins , Daniel Latypov , Shuah Khan Cc: David Gow , kunit-dev@googlegroups.com, linux-kselftest@vger.kernel.org, linux-kernel@vger.kernel.org, Kees Cook , linux-doc@vger.kernel.org, linux-mm@kvack.org, Jonathan Corbet , Sadiya Kazi ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1668845585; a=rsa-sha256; cv=none; b=BH1d5Ye7HxiNWMppr5nOqy1lLDyazY6/boabS0BjWjlJ9mRbZFW40qYtuoiQgUApC+kxHv MgzJwv7x0FdSH1IfWdO/saSjRgtsNIOZcQcJk4JcqHdyT2GEJm5EcyLz9XhgOIaObQ3jHJ qhTy8GT710Yt4CSWedVsX+2Q8yrj3QU= ARC-Authentication-Results: i=1; imf05.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=QtwcUhML; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf05.hostedemail.com: domain of 3EJB4YwgKCDUURmZUXfnXffXcV.TfdcZelo-ddbmRTb.fiX@flex--davidgow.bounces.google.com designates 209.85.215.201 as permitted sender) smtp.mailfrom=3EJB4YwgKCDUURmZUXfnXffXcV.TfdcZelo-ddbmRTb.fiX@flex--davidgow.bounces.google.com ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1668845585; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=EQq0YjZ1txdSpkL6jAisYu5mB9Yl+atKGSU09uhepI4=; b=GGrGBka1WzLpPJuKxZW3rbqzv4mf9oDYYQdvPptbt8dJ5EBzIX77822GAlHHP7wyOX4NdR kHsIWxtgFEe1bCDIuKG77M1E/OdlpO7TjfHAkvmfHOHiXcuocYY4ZJfe7JuxSGj6WZ8VTa jl9KJnZkWnmy9rODsFkKJjTQfTAsIYs= Authentication-Results: imf05.hostedemail.com; dkim=pass header.d=google.com header.s=20210112 header.b=QtwcUhML; dmarc=pass (policy=reject) header.from=google.com; spf=pass (imf05.hostedemail.com: domain of 3EJB4YwgKCDUURmZUXfnXffXcV.TfdcZelo-ddbmRTb.fiX@flex--davidgow.bounces.google.com designates 209.85.215.201 as permitted sender) smtp.mailfrom=3EJB4YwgKCDUURmZUXfnXffXcV.TfdcZelo-ddbmRTb.fiX@flex--davidgow.bounces.google.com X-Rspam-User: X-Stat-Signature: zu8yimn4szgtpn3gw3xbjrsi5hpbisx4 X-Rspamd-Queue-Id: 86A66100009 X-Rspamd-Server: rspam11 X-HE-Tag: 1668845585-16532 X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: In order to detect if a KUnit test is running, and to access its context, the 'kunit_test' member of the current task_struct is used. Usually, this is accessed directly or via the kunit_fail_current_task() function. In order to speed up the case where no test is running, add a wrapper, kunit_get_current_test(), which uses the static key to fail early. Equally, Speed up kunit_fail_current_test() by using the static key. This should make it convenient for code to call this unconditionally in fakes or error paths, without worrying that this will slow the code down significantly. If CONFIG_KUNIT=n (or m), this compiles away to nothing. If CONFIG_KUNIT=y, it will compile down to a NOP (on most architectures) if no KUnit test is currently running. Note that kunit_get_current_test() does not work if KUnit is built as a module. This mirrors the existing restriction on kunit_fail_current_test(). Note that the definition of kunit_fail_current_test() still wraps an empty, inline function if KUnit is not built-in. This is to ensure that the printf format string __attribute__ will still work. Also update the documentation to suggest users use the new kunit_get_current_test() function, update the example, and to describe the behaviour when KUnit is disabled better. Cc: Jonathan Corbet Cc: Sadiya Kazi Signed-off-by: David Gow Reviewed-by: Daniel Latypov --- As-is, the only code which will be directly affected by this (via the kunit_fail_current_test() change) will be UBSAN's KUnit integration. Patches to port other tests to use kunit_get_current_test() will be sent separately (other than the SLUB one in patch 3/3). KASAN in particular are reworking their KUnit tests and integration, so we'll use this in a follow up to avoid introducing a conflict. Changes since v2: https://lore.kernel.org/all/20221025071907.1251820-2-davidgow@google.com/ - Only add kunit_get_current_test() when KUnit is built-in, as the static key isn't available otherwise. - I'm going to try to put together some patches to make things like this available when CONFIG_KUNIT=m in the future. - Also update the documentation to note this. Changes since v1: https://lore.kernel.org/linux-kselftest/20221021072854.333010-2-davidgow@google.com/ - Fix a missing '}' which broke everything. Thanks Kees, kernel test robot. - Add the new kunit_get_current_test() function, as most of the cases where we retrieve the current test (even to fail it) were accessing current->kunit_test directly, not using kunit_fail_current_test(). - Add some documentation comments. - Update the documentation in usage.rst. - The version in tips.rst was not updated, and will be removed: https://lore.kernel.org/linux-kselftest/20221025055844.1231592-1-davidgow@google.com/ --- Documentation/dev-tools/kunit/usage.rst | 25 +++++++----- include/kunit/test-bug.h | 53 +++++++++++++++++++++++-- 2 files changed, 66 insertions(+), 12 deletions(-) diff --git a/Documentation/dev-tools/kunit/usage.rst b/Documentation/dev-tools/kunit/usage.rst index 2737863ef365..e70014b82350 100644 --- a/Documentation/dev-tools/kunit/usage.rst +++ b/Documentation/dev-tools/kunit/usage.rst @@ -625,17 +625,21 @@ as shown in next section: *Accessing The Current Test*. Accessing The Current Test -------------------------- -In some cases, we need to call test-only code from outside the test file. -For example, see example in section *Injecting Test-Only Code* or if -we are providing a fake implementation of an ops struct. Using -``kunit_test`` field in ``task_struct``, we can access it via -``current->kunit_test``. +In some cases, we need to call test-only code from outside the test file, +for example, when providing a fake implementation of a function, or to fail +any current test from within an error handler. +We can do this via the ``kunit_test`` field in ``task_struct``, which we can +access using the ``kunit_get_current_test`` function in ``kunit/test-bug.h``. -The example below includes how to implement "mocking": +``kunit_get_current_test`` requires KUnit be built-in to the kernel, i.e. +``CONFIG_KUNIT=y``. It is safe to call even if KUnit is not enabled, is built as a module, +or no test is currently running, in which case it will quickly return ``NULL``. + +The example below uses this to implement a "mock" implementation of a function, ``foo``: .. code-block:: c - #include /* for current */ + #include /* for kunit_get_current_test */ struct test_data { int foo_result; @@ -644,7 +648,7 @@ The example below includes how to implement "mocking": static int fake_foo(int arg) { - struct kunit *test = current->kunit_test; + struct kunit *test = kunit_get_current_test(); struct test_data *test_data = test->priv; KUNIT_EXPECT_EQ(test, test_data->want_foo_called_with, arg); @@ -675,7 +679,7 @@ Each test can have multiple resources which have string names providing the same flexibility as a ``priv`` member, but also, for example, allowing helper functions to create resources without conflicting with each other. It is also possible to define a clean up function for each resource, making it easy to -avoid resource leaks. For more information, see Documentation/dev-tools/kunit/api/test.rst. +avoid resource leaks. For more information, see Documentation/dev-tools/kunit/api/resource.rst. Failing The Current Test ------------------------ @@ -703,3 +707,6 @@ structures as shown below: static void my_debug_function(void) { } #endif +Note that ``kunit_fail_current_test`` requires KUnit be built-in to the kernel, i.e. +``CONFIG_KUNIT=y``. It is safe to call even if KUnit is not enabled, is built as a module, +or no test is currently running, but will do nothing. diff --git a/include/kunit/test-bug.h b/include/kunit/test-bug.h index 5fc58081d511..87a953dceeaa 100644 --- a/include/kunit/test-bug.h +++ b/include/kunit/test-bug.h @@ -9,16 +9,63 @@ #ifndef _KUNIT_TEST_BUG_H #define _KUNIT_TEST_BUG_H -#define kunit_fail_current_test(fmt, ...) \ - __kunit_fail_current_test(__FILE__, __LINE__, fmt, ##__VA_ARGS__) - #if IS_BUILTIN(CONFIG_KUNIT) +#include /* For static branch */ +#include + +/* Static key if KUnit is running any tests. */ +extern struct static_key_false kunit_running; + +/** + * kunit_get_current_test() - Return a pointer to the currently-running + * KUnit test. + * + * If a KUnit test is running in the current task, returns a pointer to + * its associated struct kunit, which can then be passed to any KUnit function + * or assertion. If no test is running (or a test is running in a different + * task), returns NULL. + * + * This function is safe to call even when KUnit is disabled: it will compile + * down to nothing if CONFIG_KUNIT is not enabled, and will be very fast if + * no test is running. + */ +static inline struct kunit *kunit_get_current_test(void) +{ + if (!static_branch_unlikely(&kunit_running)) + return NULL; + + return current->kunit_test; +} + + +/** + * kunit_fail_current_test() - If a KUnit test is running, fail it. + * + * If a KUnit test is running in the current task, mark that test as failed. + * + * This macro will only work if KUnit is built-in (though the tests + * themselves can be modules). Otherwise, it compiles down to nothing. + */ +#define kunit_fail_current_test(fmt, ...) do { \ + if (static_branch_unlikely(&kunit_running)) { \ + __kunit_fail_current_test(__FILE__, __LINE__, \ + fmt, ##__VA_ARGS__); \ + } \ + } while (0) + + extern __printf(3, 4) void __kunit_fail_current_test(const char *file, int line, const char *fmt, ...); #else +static inline struct kunit *kunit_get_current_test(void) { return NULL; } + +/* We define this with an empty helper function so format string warnings work */ +#define kunit_fail_current_test(fmt, ...) \ + __kunit_fail_current_test(__FILE__, __LINE__, fmt, ##__VA_ARGS__) + static inline __printf(3, 4) void __kunit_fail_current_test(const char *file, int line, const char *fmt, ...) {