lists.openwall.net   lists  /  announce  owl-users  owl-dev  john-users  john-dev  passwdqc-users  yescrypt  popa3d-users  /  oss-security  kernel-hardening  musl  sabotage  tlsify  passwords  /  crypt-dev  xvendor  /  Bugtraq  Full-Disclosure  linux-kernel  linux-netdev  linux-ext4  linux-hardening  linux-cve-announce  PHC 
Open Source and information security mailing list archives
 
Hash Suite: Windows password security audit tool. GUI, reports in PDF.
[<prev] [next>] [day] [month] [year] [list]
Date:	Tue, 2 Dec 2014 10:14:55 +0100
From:	Nicholas Mc Guire <der.herr@...r.at>
To:	Randy Dunlap <rdunlap@...radead.org>
Cc:	Michal Marek <mmarek@...e.cz>,
	Christoph Hellwig <hch@...radead.org>,
	Joe Perches <joe@...ches.com>,
	LKML <linux-kernel@...r.kernel.org>
Subject: [PATCH 1/5] mandate defined build cmd and source ref for _shipped
	files


mandate defined build cmd and source ref for _shipped files

Currently shipped files have more or less free style indications
of how to generate them respectively what the sources are, in
their header. Mandating defined tags and keywords would allow
for automated checking.

This patch is against 3.18.0-rc6

Signed-off-by: Nicholas Mc Guire <der.herr@...r.at>
---
 Documentation/CodingStyle |   18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/Documentation/CodingStyle b/Documentation/CodingStyle
index 9f28b14..3bcd4ce 100644
--- a/Documentation/CodingStyle
+++ b/Documentation/CodingStyle
@@ -844,6 +844,24 @@ next instruction in the assembly output:
 	     "more_magic %reg2, %reg3"
 	     : /* outputs */ : /* inputs */ : /* clobbers */);
 
+               Chapter 20:  Generated files
+
+For files generated by special purpose tools/scripts that
+justify providing _shipped files the header of the generated
+file needs indicate that it was generated, how to generate
+the file and its source location.
+
+/* Do not edit this file! It was automatically generated by   */
+/* generator: command options arguments                       */
+/* sources: path/to/sources/filename                           */
+
+Example:
+
+/* Do not edit this file! It was automatically generated by   */
+/* generator: loadkeys --mktable defkeymap.map > defkeymap.c  */
+/* sources: drivers/tty/vt/defkeymap.map                      */
+
+
 
 		Chapter 20: Conditional Compilation
 
-- 
1.7.10.4

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Powered by blists - more mailing lists