From nobody Thu Dec 18 19:39:40 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass(p=none dis=none) header.from=linaro.org ARC-Seal: i=1; a=rsa-sha256; t=1751901758; cv=none; d=zohomail.com; s=zohoarc; b=jsC53+/FBlZg+f4bUjEoclkOHUbKhiEwtpcvJ9AoF/kCYdvlS2ii6meDW004jdS9ABWTTPHn0ZPmNwCzcB6w0HGUxYqMbdqPh0WQOCzKwE4tAC3N20DLRGgWZ3qdp1c29t9UlMHfSocHqzC4mSeC+m5gyTe32GU3Cy0YlgG5b94= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1751901758; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:Subject:To:To:Message-Id:Reply-To; bh=Dd9xuKmUOLqFFJSSVk33+N9XqTung+GNu3r67W7FU5k=; b=k8BOwp8a9BD/cgKAuVrQRxku4aGJVz3/WolN7MzW7h9ViTflfbaOFIkwFKypdvlq+MjvANSGTOimOlfk0VIsQjhbGCshUDqHMFUsGkfnKrLP8Hvkg7fKBBwJB8aFPsPaUHeEHAR7QR+a0BrB57AaGwKF7naBwoouCnXjMF4Ydu0= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mx.zohomail.com with SMTPS id 1751901758340838.886450143243; Mon, 7 Jul 2025 08:22:38 -0700 (PDT) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uYnfC-0007VA-Jr; Mon, 07 Jul 2025 11:21:50 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uYn9n-0002OZ-S6 for qemu-devel@nongnu.org; Mon, 07 Jul 2025 10:49:23 -0400 Received: from mail-wm1-x32f.google.com ([2a00:1450:4864:20::32f]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1uYn9m-0006fM-0J for qemu-devel@nongnu.org; Mon, 07 Jul 2025 10:49:23 -0400 Received: by mail-wm1-x32f.google.com with SMTP id 5b1f17b1804b1-4537edf2c3cso35165515e9.3 for ; Mon, 07 Jul 2025 07:49:20 -0700 (PDT) Received: from orth.archaic.org.uk (orth.archaic.org.uk. [2001:8b0:1d0::2]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-454b161e8dbsm115361395e9.5.2025.07.07.07.49.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 07 Jul 2025 07:49:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; t=1751899759; x=1752504559; darn=nongnu.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=Dd9xuKmUOLqFFJSSVk33+N9XqTung+GNu3r67W7FU5k=; b=bWwSMs1ckMyuNAMGLa/yocUcDMjpCr8ex0rC+bA/zytcJ8KvbvMAJNRjL1E7C10hOH 2N5n8ewjvyADPZUfp2jMLeaW0K1Gbx7A85Nc6pdXW5cEctT5ODhuH/wzE2ukxuhGMPWR CmKtnx3MUSF6h379vCPu8VRl+PW4I7N+/B5/qmYeK7Om1IKZ3q1pj36xB+GbVTnYiqEm OG4gnX93gHYqbUm+zSY71vn+/0cCQuGk55nttvgg9kGT+fAo3luP/8AcuDooYV9sOfxO nyr5WgGfk32Zu8Uc041fW3LFF8HEp44DG5B424lhAYOv6ngeWVQczntN+jKNoWn9Cccr 1Ouw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1751899759; x=1752504559; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=Dd9xuKmUOLqFFJSSVk33+N9XqTung+GNu3r67W7FU5k=; b=uFCrjmwnNR3BWXyASB6hxAUBQlz5Yl+Vm+IGGctmarzQao6zV9zNPMKppPCGg8UE1o lt+Dlb4KDS4pCG4H3pxi97ZVF+ktb2JXnBa9WHCLGQYx3SoPfDZeLagDzVyRHV0e7Y2f sTpYdkX3kTlIoKwvAzVWwe4eXI+Tz92s3+dKH+IWO9KOdNYm76qII0Z1sboEwmPzqN7A AG9zLF0/JHQ8TovjuEZCxUB8rAFXqOLJzTFkP5D7lGJq8Vm5UR249ihF0Zf9CMilCbT4 lJaW9FeK7HtvwXZr9JcPTh1cCQRY/C/VYv1hr3OarWpacp47DgkZwDygyl7ogWdNHPWR XGAA== X-Gm-Message-State: AOJu0YyDPThRdAZuHo72gqU7wXDMVCwXjdhf77tw+sdfljpEe/05IT1n 035r2x717JW+F2fbv03btQLNL793k62G0aqOC7U9qKnoiVjWu/ZApp7moLn6jCMQkQASwYaqqvA B9ZhB X-Gm-Gg: ASbGncuFqRfI/BCm+0EVisVEdIKNHrwW2NtBmLYXrW2uO8E4NHJ0H3WRcT1jNL4Dawg jKOclttyGBJiNcY8/q7O0lzHiVxpTgyWbcWljEkrQxZZlia/hL4mPM4xHqdxg2SC5At7HUOQRR8 txbekv6rZX618+GQbe+XAN68mZcl/Yi+MSbl1TgUUZVnKyOVFLWGPUkSCCC1nlF/t2KN+laAdUm /y7T9tSxJGFF3Fza00A69GWroyjWVmTSZkrKOGgpOtykxzJn4emw4dhRsK7qlurItfzsdtVkENO Zh0r/BHpILo8l9n0CrNaD8sJA+GJoqm3zdQFO1+O+zN0nOQEa4GPCYWz9p8+4v2yNk3B X-Google-Smtp-Source: AGHT+IG/Y3IpctD2VxBtSTx2pzODDrXbdbTV8321+8wVesiYUYCHnDNYz0aLRM+pjv5YdloJQSUYWQ== X-Received: by 2002:a05:600c:1c85:b0:43c:ec0a:ddfd with SMTP id 5b1f17b1804b1-454bb7fa925mr75924085e9.6.1751899759210; Mon, 07 Jul 2025 07:49:19 -0700 (PDT) From: Peter Maydell To: qemu-devel@nongnu.org, qemu-trivial@nongnu.org Cc: Stefan Hajnoczi , Mads Ynddal , =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= Subject: [PATCH] docs/devel/tracing: Update trace.h creation rune to include SPDX Date: Mon, 7 Jul 2025 15:49:17 +0100 Message-ID: <20250707144917.576573-1-peter.maydell@linaro.org> X-Mailer: git-send-email 2.43.0 MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Received-SPF: pass (zohomail.com: domain of gnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: pass client-ip=2a00:1450:4864:20::32f; envelope-from=peter.maydell@linaro.org; helo=mail-wm1-x32f.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: qemu-devel-bounces+importer=patchew.org@nongnu.org X-ZohoMail-DKIM: pass (identity @linaro.org) X-ZM-MESSAGEID: 1751901760600116600 Content-Type: text/plain; charset="utf-8" checkpatch now checks that new files have an SPDX line. If you use the shell rune in tracing.rst to create a trace.h wrapper header, this triggers checkpatch to complain. Although these files are tiny, it's worth having the SPDX line to avoid having to add extra exception cases to checkpatch. Update the rune to include creating an SPDX line. Signed-off-by: Peter Maydell --- NB that checkpatch's SPDX test gets confused by this patch: ^* matches null string many times in regex; marked by <-- HERE in m/^* <--= HERE /'$/ at ./scripts/checkpatch.pl line 1389 --- docs/devel/tracing.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/devel/tracing.rst b/docs/devel/tracing.rst index 043bed7fd0f..f4557ee20e4 100644 --- a/docs/devel/tracing.rst +++ b/docs/devel/tracing.rst @@ -76,7 +76,7 @@ The "io/trace.h" file must be created manually with an #i= nclude of the corresponding "trace/trace-.h" file that will be generated in the builddir:: =20 - $ echo '#include "trace/trace-io.h"' >io/trace.h + $ (echo '/* SPDX-License-Identifier: GPL-2.0-or-later */' ; echo '#inclu= de "trace/trace-io.h"') >io/trace.h =20 While it is possible to include a trace.h file from outside a source file'= s own sub-directory, this is discouraged in general. It is strongly preferred th= at --=20 2.43.0