From nobody Sat May 4 20:05:28 2024 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 vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 11B12C433FE for ; Sat, 1 Oct 2022 06:46:56 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229504AbiJAGqy (ORCPT ); Sat, 1 Oct 2022 02:46:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34364 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229451AbiJAGqv (ORCPT ); Sat, 1 Oct 2022 02:46:51 -0400 Received: from mail-yb1-xb4a.google.com (mail-yb1-xb4a.google.com [IPv6:2607:f8b0:4864:20::b4a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 58A0B18F919 for ; Fri, 30 Sep 2022 23:46:50 -0700 (PDT) Received: by mail-yb1-xb4a.google.com with SMTP id h4-20020a5b02c4000000b006bc192d672bso5689316ybp.22 for ; Fri, 30 Sep 2022 23:46:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20210112; h=cc:to:from:subject:message-id:mime-version:date:from:to:cc:subject :date; bh=5zNt32/N2HQpKa6Qm7c9xylYxhuD0bqhJn/lNQVUNhM=; b=XWrF1DiUzMXENRq/Iu+7n02pSDqptsRUyggyW/Hc+tpIF5Ke+t7sDs7z9rOythum9Y bO/hApuSbJMB+IAqEhOhphTsU/sChRLlHsCELQXICiS7HCgwBj/wPEqlFjvV934d6JOt cF3U9y7MIem5h0M9cBXBvJsf/rKvAqXFjcXvcIfgWYi19wAEVmqSJzcGkp77RA+oqDqx 9LIBudNeFHAHOTzIlUKLV24kzd5mM6n8mu7nKXNZTiW5I2S7/DCMp0qTUGQQMHtWFC0r AdIq/FGA3LKk3IxGOhyBXa9NRA4OW4OaYRE4YVtZ1iMlFvb1Thnh0YEbDIOtGU5Zaovn cxoQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:from:subject:message-id:mime-version:date:x-gm-message-state :from:to:cc:subject:date; bh=5zNt32/N2HQpKa6Qm7c9xylYxhuD0bqhJn/lNQVUNhM=; b=7zzYoaDnXLYEOEZ1rjKNldyzDg4S+AvC6zBytQheuGuzpWuSgoP0wrmviNHlZwniTn s8rUmgwx/asESQITI4/GqRovJ2+pbfKcKztTt/tCcspiyzd8+/GLjc9bAcuC16uy7msI Gc3pZvoz3IEr7q9NPBHiJvU+hGcSpByUxsiEhGNup9/Bh1N70tA5lqVH9gzu0IQZVGC3 kUnYjYuxKMEJkx8Lg6QaGSHHwy1C2A2VP2MECwsjhvGU5YRFjvGAZnzwgC0cRtBEOQUm Ecj/6w5Gk4579YIq54ory2Zh/P+EYcILMNaTo8xF02/YOSLVINZnRFvdK/KHQUp2dNYq EoNw== X-Gm-Message-State: ACrzQf1KLJ2LSqjKfVL+/mTrDQoITGHh7QBh/b9sTnt1jdk5Cs9yUVKj t4kc4xcqJsnWxi2MwCQB7bEpPLSf3aMkpg== X-Google-Smtp-Source: AMsMyM4Z6YtiXAPCR8c1iixwmX3z4uvcsfz9v4SnwzXlw31W/9ARj8Wc0mWEzt2fsEGLmGBp6FgrW94MExqppg== X-Received: from slicestar.c.googlers.com ([fda3:e722:ac3:cc00:4f:4b78:c0a8:20a1]) (user=davidgow job=sendgmr) by 2002:a25:aaed:0:b0:6bc:8f6e:5c3b with SMTP id t100-20020a25aaed000000b006bc8f6e5c3bmr10477174ybi.524.1664606809644; Fri, 30 Sep 2022 23:46:49 -0700 (PDT) Date: Sat, 1 Oct 2022 14:46:43 +0800 Mime-Version: 1.0 X-Mailer: git-send-email 2.38.0.rc1.362.ged0d419d3c-goog Message-ID: <20221001064643.667075-1-davidgow@google.com> Subject: [PATCH] Documentation: kunit: Update description of --alltests option From: David Gow To: Daniel Latypov , Shuah Khan , Brendan Higgins , Sadiya Kazi , Jonathan Corbet Cc: David Gow , kunit-dev@googlegroups.com, linux-kselftest@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" kunit_tool's --alltests option was changed in commit 980ac3ad0512 ("kunit: tool: rename all_test_uml.config, use it for --alltes= ts") to use a manually curated list of architecture-indpendent Kconfig options, rather than attempting to use make allyesconfig on UML, which was broken. Update the kunit_tool documentation to reflect the new behaviour of --alltests. Signed-off-by: David Gow Reviewed-by: Daniel Latypov --- Documentation/dev-tools/kunit/run_wrapper.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/Documentation/dev-tools/kunit/run_wrapper.rst b/Documentation/= dev-tools/kunit/run_wrapper.rst index 6b33caf6c8ab..dafe8eb28d30 100644 --- a/Documentation/dev-tools/kunit/run_wrapper.rst +++ b/Documentation/dev-tools/kunit/run_wrapper.rst @@ -251,14 +251,15 @@ command line arguments: compiling a kernel (using ``build`` or ``run`` commands). For example: to enable compiler warnings, we can pass ``--make_options W=3D1``. =20 -- ``--alltests``: Builds a UML kernel with all config options enabled - using ``make allyesconfig``. This allows us to run as many tests as - possible. - - .. note:: It is slow and prone to breakage as new options are - added or modified. Instead, enable all tests - which have satisfied dependencies by adding - ``CONFIG_KUNIT_ALL_TESTS=3Dy`` to your ``.kunitconfig``. +- ``--alltests``: Enable a predefined set of options in order to build + as many tests as possible. + + .. note:: The list of enabled options can be found in + ``tools/testing/kunit/configs/all_tests.config``. + + If you only want to enable all tests with otherwise satisfied + dependencies, instead add ``CONFIG_KUNIT_ALL_TESTS=3Dy`` to yo= ur + ``.kunitconfig``. =20 - ``--kunitconfig``: Specifies the path or the directory of the ``.kunitco= nfig`` file. For example: --=20 2.38.0.rc1.362.ged0d419d3c-goog