From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f52.google.com (mail-wm1-f52.google.com [209.85.128.52]) (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 3FDFC48AE3D for ; Wed, 15 Jul 2026 15:39:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.52 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784129949; cv=none; b=CWkTIUf0p/LQoqOF2nOELP6qT95NxiXJ9bYSmncnjuAj10iU/SGq0n2KZyhPj4UPzU2Jmvc4/sdp0Tq63KOoHULxAPTrILlU/QHgkhNSTnH1kkhaJOISf2T5ZZcZs7vgZlVmeCtab07Rh4JOZkiZmJo61WgI1b30EHrlgIUvHHY= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1784129949; c=relaxed/simple; bh=31/AeBHU89rF4Rg5kK/ny14p2jcNSzDGk5CcnTNT90A=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=XIX1KIc+keQmW9YY2zJQxNMBoYo4hfHIV67VLfDfa4ATbBjbfZLrrgdgqcjLmAyzFifHoVeorpST/b4rJY2vo7WeVWzy8fgq4wti/5h6/ZWY+T+dJgQNHpFY21rw2+1wFOV2fDTMLqCxczpHekVywLv6keMYqb6MJ5X0CccVgL0= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=mLR0wRar; arc=none smtp.client-ip=209.85.128.52 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="mLR0wRar" Received: by mail-wm1-f52.google.com with SMTP id 5b1f17b1804b1-493e4ccccc2so35524165e9.2 for ; Wed, 15 Jul 2026 08:39:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1784129945; x=1784734745; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to:content-type; bh=q6FyomukVh8AHc9oMUtQCH7mRWDRSNjzWrBvxz0cBQQ=; b=mLR0wRaroOzHHmOVfNYRRG7Ph4ThmXVVPahPDjZQOh0Uc9agrcUE7aDQCFPMG7sIkc gl8tfK8bHQnwT821iw94TUaQ/+4llKWZ9khE6XOYaeXdRW2abaEUcIdESgliR/H3tDMf 1DIlmwXnsiI9naRHc864JdSkkG5Rcn4OEIXxpngVfEECHdC/tj70eGhjm6LAYnUnnyqj tZJ4RBvkJwd2jlSZw195OIDMdU8TXgejsAyJL/NE0SAodmIkOxbBS07VbXKZoNUPbqRb M64glZkQXRv+58W/fM+IyPnRXywvL4zqga8o0sCeF7PxTi1EsJ9XanzDTsricvIjTUzE fKvQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1784129945; x=1784734745; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=q6FyomukVh8AHc9oMUtQCH7mRWDRSNjzWrBvxz0cBQQ=; b=OlR+DZ6/tga+mSquP3Lo4WB42c3b5Jh06CU74rBkv8zO2MzgOGdHl49Fg1VWhSLK5p qBUwbGr6Lyl3NHHE43mc5zvj/+v3iOq72evjzXzCr4emEJ0UVFm1+17QMx1OlTQ1HUJh KEEiE607Fk8VAYia2e2dt1tJ38HQrsgS3XMNDLQj7ql/deJQqi3qe8kSI4aJgNNdY/EB jIWS6e4K0ITQPZ1SYFGCBEwywfsIKgiMknT1PnFoK0FfOkJkLUTuttBkiYy4xrnSFFcN OXI56g+Jl7H0PLsRKdNMLIGDiRZYZ8qH0FXH1KtNJNm1u+z/pr4MFWwKUc3ftZ64sU3K lFzw== X-Forwarded-Encrypted: i=1; AHgh+Rqlcui+y6gN1RJJZDHkwHg8Eeg7wxiOtPyTp8c+UNxmbRe5RTPb1JxmdGdZ2ZNy+o0Tp629Q8ZB9QH7MZs=@vger.kernel.org X-Gm-Message-State: AOJu0Yw6JUvNlGi0ZQuTyGi0AROUY53ylqkYAL+kfnFvmi6v9xxyHDW9 UL79f72deFtZvaBjzcSpKfZPCNEnUUMnnqY+nNlR1+QMCeEeET6v7lQ= X-Gm-Gg: AfdE7cncyDstA0MYMbdyfmJzR9DSGGJmtifHlCdJK4bwWEpmPeBTuiETtcdJagy3U8P VVnGv33DJaPQsw4k7Avm8YiAl7vppfaBJAm9IINb9V+CsPdv33e75OFQ0jK/PXJyaMgz26KXE9Y 49xWEkkcdwfixBtsmQLYHdGdRMhskfLdF3pMv4KOTIYkkiv0cVfien+f2YTcQBGoldZGStjfY8P yEWEnyU7inpk6JoSHrX6OEJ7aY43vh/6QNwjkf47hO0esDGO+4Cb0/oicNtxhulNwYgPWCiVHkS 5zlKIerpfj1K9vOBpvX/jzCaMIhy438mSQhIQL7Q3jYLCi9TBCkNrl5+D4dye/G7GUQTtIClKeS l7Gc6K6Ly/wNKBGo+hQLsmILV+C2WKvcSQZj+x4TATlh/vvxFx6Q10/9vKjOYsO+AdBpGxEeDAm 9C X-Received: by 2002:a05:600c:46c7:b0:495:4044:11ff with SMTP id 5b1f17b1804b1-49540441383mr9026905e9.33.1784129945352; Wed, 15 Jul 2026 08:39:05 -0700 (PDT) Received: from p183 ([178.172.147.87]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-495087384casm160850245e9.8.2026.07.15.08.39.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 15 Jul 2026 08:39:04 -0700 (PDT) From: Alexey Dobriyan To: corbet@lwn.net, skhan@linuxfoundation.org Cc: adobriyan@gmail.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 1/1] CodingStyle: clarify variable naming rules Date: Wed, 15 Jul 2026 18:42:20 +0300 Message-ID: <20260715154220.234028-1-adobriyan@gmail.com> X-Mailer: git-send-email 2.54.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit * sysctl stuff better have "sysctl" in its name to remind developers to use READ_ONCE() and that their values can change at any time, * variable holding physical time should append unit of time to the name, to make life easier for developers and static checkers. Jiffies aren't included because I'd be crucified for "_ji". Signed-off-by: Alexey Dobriyan --- Documentation/process/coding-style.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/Documentation/process/coding-style.rst b/Documentation/process/coding-style.rst index a8336582f60b..d97ed5be4eab 100644 --- a/Documentation/process/coding-style.rst +++ b/Documentation/process/coding-style.rst @@ -356,6 +356,11 @@ specification that mandates those terms. For new specifications translate specification usage of the terminology to the kernel coding standard where possible. +Variable holding sysctl value should have ``sysctl`` in its name. + +Variable measuring time should be suffixed with the unit of time it is measured in: +``_s`` for seconds, ``_ms`` for milliseconds, ``_us`` for microseconds, ``_ns`` for nanoseconds. + 5) Typedefs ----------- -- 2.54.0