From nobody Sat Jun 20 08:25:20 2026 Received: from mail-wr1-f42.google.com (mail-wr1-f42.google.com [209.85.221.42]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 260213A4509 for ; Fri, 17 Apr 2026 17:36:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.221.42 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776447403; cv=none; b=Ar6oCUuex1P/YSr96BrVc3VL09VQ+JkLOrBbHgDME57duRU1rdplcGlho3f/oScrcUOeaKEyBO3gjCQRLh6IhldH8LvUgCPyHib/+2O2MXpT63cAdT00t0oMTkL/V9EWcOcm2crw5JW7LBcjSs+35U3+U2Ff3pqW0adSpw7U/nY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1776447403; c=relaxed/simple; bh=jkTCGTx5N5kNDBuJiGd3cHBXCdOpLr+klCtenLR7CNE=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:To:Cc; b=SLc6Qm2eVztnpXA8I6iyi5R3grwCdOQ0oxFS0pwntIuv4cmBtz3YUQQ+UBftkjuGvw4Of7KkPO8KM/j1CtQr00DTAx2/jnuMJMe5yFNFVJEbibxNe16pfJ/UFfeMwuJmJEDz0ZiDlCA7K8SjA40PzoeBu2m+DGxWwG+CFctgCuU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com; spf=pass smtp.mailfrom=suse.com; dkim=pass (2048-bit key) header.d=suse.com header.i=@suse.com header.b=KcTGVCcd; arc=none smtp.client-ip=209.85.221.42 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=suse.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=suse.com header.i=@suse.com header.b="KcTGVCcd" Received: by mail-wr1-f42.google.com with SMTP id ffacd0b85a97d-43fe3e22e33so623891f8f.0 for ; Fri, 17 Apr 2026 10:36:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1776447395; x=1777052195; darn=vger.kernel.org; h=cc:to:message-id:content-transfer-encoding:mime-version:subject :date:from:from:to:cc:subject:date:message-id:reply-to; bh=+okOEmaZb2t8QpikbjQlDiBfQLIdyz/gfflHu8dorl0=; b=KcTGVCcdtlg3nw8BAgXzEsc5FtsAAMV3C7qKTPbllVc50bZPgkchNGpistzh5gFoNi k+fQBhoK1hETiEaGuqarRehzUU3T8k9Cu2b5725SE8rR+j2KlmMMbcqq+dE8kKANqNu2 RZWUjDwrMJi3CCU+4Y0WT1M2qNMQrixKQQFS7i2Y1xuNBjVgewOOg2faStB3xShBG05R bu79LnwQQXGt7anMWRDn8MVXpedXkALUUEEzWPzSjQd4Yomhveih+/Wn1LBXIHVECf7J XHtVPERW4BOLcKuJjFe/Mx3GQTlFDVC98BrCfZ+qqYmg84Yf9xQTkkroz+/q5ExUht63 MCrg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1776447395; x=1777052195; h=cc:to:message-id:content-transfer-encoding:mime-version:subject :date:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=+okOEmaZb2t8QpikbjQlDiBfQLIdyz/gfflHu8dorl0=; b=rQRj/pFSud89UHIoHntxskuA21kKYgUp44W907Sxmj5ks5X4unfU92RuquqYfNU5ZI n/y9ewwOVkrzjDspmXsXr17IeUfY4rTz75uZkL7VRw0gcdKNtyMQeBtW/Vj2Q6kbdRjg IAvDe2kJOU0Rc0iJJFECNxG8SVhMAGnDJ0KA9e+GZUPvkqBmKtLn4GPHV3VZJvUv9psu GCKHvGhYaJEpQbNC1NCzY98+WekkyKndTzpNTNz1eIRE0ismLqiK/KFErBV8yzzipeIH psZUvxMm5ij6XNsaKh7IpuY54uHuZZZVlg/EOlqktg72LCzPjXPmk5ZtaV/z381JL7Ri fUqQ== X-Forwarded-Encrypted: i=1; AFNElJ8Q6jtKJ/QoV1XMHuR8vAsNNodp26uFkjPtOVANqB1mXYkN2Mfx/wsy2kWDXpQlYo4b+6Nk8W0ea0QDswg=@vger.kernel.org X-Gm-Message-State: AOJu0YwNCpwiI1+dg+Z2kpQ7eSwzHEnUfUdZ4vd2JamNzTh9n0OHWiPw eGaGXiizrSZFfLg3syg02caULCHFFdo1FTv4t8V8b8lEwG8GOdGblOu/mORcV37Nb/4= X-Gm-Gg: AeBDiev9LDnmDZT2Wf1TkdxQmY7Af2Okxtxh1cILkmLH0TKMnXGmDoypdDLWmAbG0AU ychLg4TcIvV25Y4nQG1NzAqZcHvn3uAXzwwDM7gKXijePvJG/Ri/mTPPLrqDVUuEV5niBTa5sBP Y/XiJod2PxWKPYU49+TEH9DwD3WC0WfaGdfLglO5uXJuWjGAodyq3FIEfEzZPaWtAyPeiSuXD5W o2DLPxJSuom5mOYr4OOxbZDbPJJV/QKbJ++jTWkiChJN/BaCFxzUaQsisgBa2TAi7KhO7MIyy2X 1Wk/3/i4KZT8Jk/Z5zgNv5LZiew8PgBBkhXS9SRNhVm7FY7oLAkBtPy6e+YTvht+pyDsa+cGnUt b886aC7jJpV9skiKoGhYaKDAPp5y/cRwSMuB5A33+kIUOqfF+MMwMFyOAkJPdYJ5bGvQ01G+G1s F/yS1/AYFJaJy9eBYpFQohAxM= X-Received: by 2002:a05:600c:888b:b0:488:c40b:c8bf with SMTP id 5b1f17b1804b1-488fb73d234mr44822655e9.2.1776447395380; Fri, 17 Apr 2026 10:36:35 -0700 (PDT) Received: from localhost ([2804:7f0:b765:dc8:ce28:aaff:fe86:149c]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-2e53a4a8018sm3917884eec.8.2026.04.17.10.36.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 17 Apr 2026 10:36:34 -0700 (PDT) From: =?utf-8?q?Ricardo_B=2E_Marli=C3=A8re?= Date: Fri, 17 Apr 2026 14:36:28 -0300 Subject: [PATCH] docs: kselftest: Document the FORCE_TARGETS build variable Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20260417-selftests-docs-v1-1-32e4a78214eb@suse.com> X-B4-Tracking: v=1; b=H4sIAJtv4mkC/yWMQQ7CIBREr9L8tURKGo1exbj4wCAYQw2fmiZN7 y7o8k3mvY0EJUHoOmxU8EmS5txgPAzkIucHVPKNyWhz0tN4VoJXqJAqys9OVPBhwsUY9kZTk94 FIa2/4O3+Z1nsE672Sn9YFihbOLvYJ4kLx2PGWmnfv4g8gcKPAAAA X-Change-ID: 20260417-selftests-docs-fdf4e922ad20 To: Shuah Khan , Jonathan Corbet Cc: Shuah Khan , linux-kselftest@vger.kernel.org, workflows@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, =?utf-8?q?Ricardo_B=2E_Marli=C3=A8re?= X-Mailer: b4 0.15.2 X-Developer-Signature: v=1; a=openssh-sha256; t=1776447391; l=1836; i=rbm@suse.com; h=from:subject:message-id; bh=jkTCGTx5N5kNDBuJiGd3cHBXCdOpLr+klCtenLR7CNE=; b=U1NIU0lHAAAAAQAAADMAAAALc3NoLWVkMjU1MTkAAAAgguRCc5X8/UX9M40lkMnr//aFGOhce x5ezt8MFNUFlqYAAAAGcGF0YXR0AAAAAAAAAAZzaGE1MTIAAABTAAAAC3NzaC1lZDI1NTE5AAAA QGCdk+Dqytqm1mJBSK4cT3p4LBx+mdWpB8pQc8eyh2BrVstLyrEfAJ2T/V17tilHX0CXhRx/m1D RzaCl4kQSDw8= X-Developer-Key: i=rbm@suse.com; a=openssh; fpr=SHA256:pzhe0fJpYLz+3cZ33FFPhIfaUElk9CXPFFXmalIH+1g FORCE_TARGETS has been part of the kselftest build system for some time but is absent from the developer documentation. Without an entry here, users relying on kselftest in CI pipelines would have to read the selftests Makefile directly to discover the option. A build that exits zero despite some targets failing can mask real breakage and mislead automated systems into reporting success. Add a dedicated section so that CI authors can easily find and adopt FORCE_TARGETS=3D1 to turn such silent partial failures into hard errors. Signed-off-by: Ricardo B. Marli=C3=A8re --- Documentation/dev-tools/kselftest.rst | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/Documentation/dev-tools/kselftest.rst b/Documentation/dev-tool= s/kselftest.rst index 18c2da67fae4..d7bfe320338c 100644 --- a/Documentation/dev-tools/kselftest.rst +++ b/Documentation/dev-tools/kselftest.rst @@ -126,6 +126,18 @@ dedicated skiplist:: See the top-level tools/testing/selftests/Makefile for the list of all possible targets. =20 +Requiring all targets to build successfully +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +By default, the build succeeds as long as at least one target builds +without error. Set ``FORCE_TARGETS=3D1`` to instead require every target to +build successfully; make will abort as soon as any target fails:: + + $ make -C tools/testing/selftests FORCE_TARGETS=3D1 + +This applies to both the ``all`` and ``install`` targets and is useful in +CI environments where a silent partial build would be misleading. + Running the full range hotplug selftests =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 --- base-commit: 83ef26f911432d9c98b6d8b6ed0709a8b79cd834 change-id: 20260417-selftests-docs-fdf4e922ad20 Best regards, -- =20 Ricardo B. Marli=C3=A8re