linux-kernel - Re: [PATCH tip/core/rcu 1/8] documentation: Record RCU requirements

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>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20151205000719.GB26663@cloud>
Date:	Fri, 4 Dec 2015 16:07:19 -0800
From:	Josh Triplett <josh@...htriplett.org>
To:	"Paul E. McKenney" <paulmck@...ux.vnet.ibm.com>
Cc:	linux-kernel@...r.kernel.org, mingo@...nel.org,
	jiangshanlai@...il.com, dipankar@...ibm.com,
	akpm@...ux-foundation.org, mathieu.desnoyers@...icios.com,
	tglx@...utronix.de, peterz@...radead.org, rostedt@...dmis.org,
	dhowells@...hat.com, edumazet@...gle.com, dvhart@...ux.intel.com,
	fweisbec@...il.com, oleg@...hat.com, bobby.prani@...il.com
Subject: Re: [PATCH tip/core/rcu 1/8] documentation: Record RCU requirements

On Fri, Dec 04, 2015 at 03:50:19PM -0800, Paul E. McKenney wrote:
> This commit adds RCU requirements as published in a 2015 LWN series.
> Bringing these requirements in-tree allows them to be updated as changes
> are discovered.
> 
> Signed-off-by: Paul E. McKenney <paulmck@...ux.vnet.ibm.com>
> ---
>  .../RCU/Design/Requirements/2013-08-is-it-dead.png |  Bin 0 -> 100825 bytes
>  .../Design/Requirements/GPpartitionReaders1.svg    |  374 +++
>  .../RCU/Design/Requirements/RCUApplicability.svg   |  237 ++
>  .../Design/Requirements/ReadersPartitionGP1.svg    |  639 +++++
>  .../RCU/Design/Requirements/Requirements.html      | 2799 ++++++++++++++++++++
>  .../RCU/Design/Requirements/Requirements.htmlx     | 2643 ++++++++++++++++++
>  Documentation/RCU/Design/htmlqqz.sh                |  108 +
>  7 files changed, 6800 insertions(+)
>  create mode 100644 Documentation/RCU/Design/Requirements/2013-08-is-it-dead.png
>  create mode 100644 Documentation/RCU/Design/Requirements/GPpartitionReaders1.svg
>  create mode 100644 Documentation/RCU/Design/Requirements/RCUApplicability.svg
>  create mode 100644 Documentation/RCU/Design/Requirements/ReadersPartitionGP1.svg
>  create mode 100644 Documentation/RCU/Design/Requirements/Requirements.html
>  create mode 100644 Documentation/RCU/Design/Requirements/Requirements.htmlx

If Requirements.html is machine-generated and shouldn't be hand-edited,
and it can be generated without any special tools, then I don't think it
should be committed in the tree; I'd suggest putting it in .gitignore
and generating it from one of the various "make docs" invocations.

Alternatively, if you want to make sure a usable version is in-tree, you
could make the script reversible (easy enough to do if the compiled
version includes some marker comments or similar), and then tell people
to run it in reverse mode, edit, and run it in forward mode.  Then you
don't need the .htmlx file at all. :)
--
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/