[PATCH v2] block/loop: add documentation for sysfs interface

Documentation has been compiled from git logs and by reading through code. Signed-off-by: Aishwarya Pant --- For drivers/block/loop.c, I don't see any maintainers or mailing lists except for LKML. I am guessing linux-block mailing list should be okay. Changes in v2: - Add

[PATCH 03/17] trace doc: add ftrace-uses.rst to doc tree

From: Changbin Du Add ftrace-uses.rst into Sphinx TOC tree. Few format issues are fixed. Cc: Steven Rostedt Signed-off-by: Changbin Du --- Documentation/trace/ftrace-uses.rst | 23 ---

[PATCH 02/17] trace doc: convert trace/ftrace-design.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it to Sphinx TOC tree. This documentation is not synced with current code, so mark it as out of date. Cc: Steven Rostedt Signed-off-by: Changbin Du

[PATCH 04/17] trace doc: convert trace/tracepoint-analysis.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 12/17] trace doc: convert trace/events-nmi.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 09/17] trace doc: convert trace/events.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 06/17] trace doc: convert trace/kprobetrace.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 11/17] trace doc: convert trace/events-power.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 07/17] trace doc: convert trace/uprobetracer.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 14/17] trace doc: convert trace/mmiotrace.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 13/17] trace doc: convert trace/events-msr.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 16/17] trace doc: convert trace/intel_th.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 15/17] trace doc: convert trace/hwlat_detector.txt to rst fromat

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du --- .../{hwlat_detector.txt

[PATCH 17/17] trace doc: convert trace/stm.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 00/17] Include linux trace docs to Sphinx TOC tree

From: Changbin Du Hi All, The linux tracers are so useful that I want to make the docs better. The kernel now uses Sphinx to generate intelligent and beautiful documentation from reStructuredText files. I converted most of the Linux trace docs to rst format in this serias.

[PATCH 08/17] trace doc: convert trace/tracepoints.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 10/17] trace doc: convert trace/events-kmem.txt to rst format

From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du ---

[PATCH 01/17] Documentation: add Linux tracing to Sphinx TOC tree

From: Changbin Du This just add a index.rst for trace subsystem. More docs will be added later. Cc: Steven Rostedt Signed-off-by: Changbin Du --- Documentation/index.rst | 1 + Documentation/trace/index.rst | 6 ++

Re: [PATCH 2/3] Documentation: convert trace/ftrace-design.txt to rst format

On Fri, Feb 16, 2018 at 12:36:29PM -0500, Steven Rostedt wrote: > On Fri, 16 Feb 2018 05:49:52 -0700 > Jonathan Corbet wrote: > > > On Thu, 15 Feb 2018 22:57:05 -0500 > > Steven Rostedt wrote: > > > > > This document is out of date, and I rather have it

Re: [PATCH v3 01/15] Documentation: add newcx initramfs format description

On February 16, 2018 1:47:35 PM PST, Victor Kamensky wrote: > > >On Fri, 16 Feb 2018, Rob Landley wrote: > >> >> On 02/16/2018 02:59 PM, H. Peter Anvin wrote: >>> On 02/16/18 12:33, Taras Kondratiuk wrote: Many of the Linux security/integrity features are dependent on

Re: [PATCH 3/3] taint: Add taint for randstruct

On Fri, Feb 16, 2018 at 1:02 PM, Andrew Morton wrote: > On Thu, 15 Feb 2018 19:37:44 -0800 Kees Cook wrote: > >> --- a/Documentation/sysctl/kernel.txt >> +++ b/Documentation/sysctl/kernel.txt >> @@ -991,6 +991,7 @@ ORed together. The letters are

Re: [PATCH v3 01/15] Documentation: add newcx initramfs format description

On 02/16/18 12:33, Taras Kondratiuk wrote: > Many of the Linux security/integrity features are dependent on file > metadata, stored as extended attributes (xattrs), for making decisions. > These features need to be initialized during initcall and enabled as > early as possible for complete

Re: [PATCH v3 01/15] Documentation: add newcx initramfs format description

On Fri, 16 Feb 2018, Rob Landley wrote: On 02/16/2018 02:59 PM, H. Peter Anvin wrote: On 02/16/18 12:33, Taras Kondratiuk wrote: Many of the Linux security/integrity features are dependent on file metadata, stored as extended attributes (xattrs), for making decisions. These features need

Re: [PATCH 3/3] taint: Add taint for randstruct

On Thu, 15 Feb 2018 19:37:44 -0800 Kees Cook wrote: > --- a/Documentation/sysctl/kernel.txt > +++ b/Documentation/sysctl/kernel.txt > @@ -991,6 +991,7 @@ ORed together. The letters are seen in "Tainted" line of > Oops reports. > 16384 (L): A soft lockup has previously

Re: [PATCH v2 3/7] soc: qcom: Add GENI based QUP Wrapper driver

On 2/14/2018 4:07 AM, Amit Kucheria wrote: On Sat, Jan 13, 2018 at 6:35 AM, Karthikeyan Ramasubramanian wrote: This driver manages the Generic Interface (GENI) firmware based Qualcomm Universal Peripheral (QUP) Wrapper. GENI based QUP is the next generation

[PATCH v3 02/15] initramfs: replace states with function pointers

Currently the FSM states are mapped directly to function pointers. Extra level of intirection is not needed and makes navigation over the code harder. One can't jump between states directly when browsing code (e.g. with cscope). Need to go through actions[] array each time. Replace states with

[PATCH v3 01/15] Documentation: add newcx initramfs format description

Many of the Linux security/integrity features are dependent on file metadata, stored as extended attributes (xattrs), for making decisions. These features need to be initialized during initcall and enabled as early as possible for complete security coverage. Initramfs (tmpfs) supports xattrs, but

[PATCH v3 04/15] initramfs: remove unnecessary symlinks processing shortcut

Special handling of symlinks in do_header() assumes that name and body entries are sequential and reads them together. This shortcut has no real performance benefits, but it complicates changes to the state machine. Make handling of symlinks more similar to a regular files. Store name in name_buf

[PATCH v3 05/15] initramfs: move files creation into separate state

Move most of the file creation logic into a separate state. This splits collection of data stage from data processing and makes it easier to add additional states for a new archive format. Signed-off-by: Taras Kondratiuk --- init/initramfs.c | 52

[PATCH v3 03/15] initramfs: store file name in name_buf

There is already name_buf buffer pre-allocated for a file name. No need to allocate vcollected for every file. More over a name can be already stored in name_buf by read_info() function. Add memcpy_optional() function to handle such case. Signed-off-by: Taras Kondratiuk ---

[PATCH v3 07/15] initramfs: split header layout information from parsing function

Header parsing has hardcoded assumption about header field size and layout. It is hard to modify the function to parse a new format. Move information about size and layout into a data structure to make parsing code more generic and simplify adding a new format. This also removes some magic

[PATCH v3 06/15] initramfs: separate reading cpio method from header

From: Mimi Zohar In preparation for adding xattr support, read the CPIO method separately from the rest of the header. Signed-off-by: Mimi Zohar Signed-off-by: Taras Kondratiuk --- init/initramfs.c | 15 +++

[PATCH v3 10/15] gen_init_cpio: move header formatting into function

CPIO header is generated in multiple places with the same sprintf() format string. Move formatting into a single function in preparation to adding a new cpio format. Signed-off-by: Taras Kondratiuk --- usr/gen_init_cpio.c | 186

[PATCH v3 12/15] gen_init_cpio: set extended attributes for newcx format

gen_init_cpio creates CPIO archive according to cpio_list manifest file that contains list of archive entries (one per line). To be able to store extended attributes in newcx CPIO format we need to pass them via cpio_list file. One way of doing it would be to append xattrs to each entry line, but

[PATCH v3 09/15] initramfs: set extended attributes

From: Mimi Zohar This patch writes out the extended attributes included in the cpio file. As the "security.ima" xattr needs to be written after the file data. this patch separates extracting and setting the xattrs by defining new do_setxattrs state. [kamensky: fixed

[PATCH v3 08/15] initramfs: add newcx format

Add 'newcx' format that adds extended attributes and increased size of c_mtime and c_filesize fields. Refer to Documentation/early-userspace/buffer-format.txt for detailed format description. Signed-off-by: Taras Kondratiuk --- init/initramfs.c | 121

[PATCH v3 14/15] selinux: allow setxattr on rootfs so initramfs code can set them

From: Victor Kamensky initramfs code supporting extended cpio format have ability to fill extended attributes from cpio archive, but if SELinux enabled and security server is not initialized yet, selinux callback would refuse setxattr made by initramfs code. Solution enable

[PATCH v3 11/15] gen_init_cpio: add newcx format

Add "newcx" format that supports extended attributes and has increased size of c_mtime and c_filesize fields. Added -x option to select "newcx" format. Default is "newc". Refer to Documentation/early-userspace/buffer-format.txt for detailed format description. Signed-off-by: Taras Kondratiuk

[PATCH v3 14/14] selinux: delay sid population for rootfs till init is complete

From: Victor Kamensky With initramfs cpio format that supports extended attributes we need to skip sid population on sys_lsetxattr call from initramfs for rootfs if security server is not initialized yet. Otherwise callback in selinux_inode_post_setxattr will try to

[PATCH v3 15/15] selinux: delay sid population for rootfs till init is complete

From: Victor Kamensky With initramfs cpio format that supports extended attributes we need to skip sid population on sys_lsetxattr call from initramfs for rootfs if security server is not initialized yet. Otherwise callback in selinux_inode_post_setxattr will try to

[PATCH v3 13/15] gen_initramfs_list.sh: add -x option to enable newcx format

From: Mimi Zohar -x option populates extended attributes in cpio_list file passed to get_init_cpio and selects newcx CPIO format. Signed-off-by: Mimi Zohar Signed-off-by: Taras Kondratiuk ---

[PATCH v3 12/14] gen_initramfs_list.sh: add -x option to enable newcx format

From: Mimi Zohar -x option populates extended attributes in cpio_list file passed to get_init_cpio and selects newcx CPIO format. Signed-off-by: Mimi Zohar Signed-off-by: Taras Kondratiuk ---

[PATCH v3 00/15] extend initramfs archive format to support xattrs

Many of the Linux security/integrity features are dependent on file metadata, stored as extended attributes (xattrs), for making decisions. These features need to be initialized during initcall and enabled as early as possible for complete security coverage. Initramfs (tmpfs) supports xattrs,

[PATCH v3 13/14] selinux: allow setxattr on rootfs so initramfs code can set them

From: Victor Kamensky initramfs code supporting extended cpio format have ability to fill extended attributes from cpio archive, but if SELinux enabled and security server is not initialized yet, selinux callback would refuse setxattr made by initramfs code. Solution enable

Re: Inline emphasis warnings (more)

> Am 16.02.2018 um 19:56 schrieb Markus Heiser : > > >> Am 01.10.2017 um 20:33 schrieb Randy Dunlap : >> >> A different "problem" this time: >> >> Documentation/driver-api/basics.rst pulls in include/linux/kernel.h. >> has kernel-doc notation

Re: Inline emphasis warnings (more)

> Am 01.10.2017 um 20:33 schrieb Randy Dunlap : > > A different "problem" this time: > > Documentation/driver-api/basics.rst pulls in include/linux/kernel.h. > has kernel-doc notation for (among others) trace_printk() > and trace_puts(). > > Part of the text for

[PATCH 00/23] kconfig: move compiler capability tests to Kconfig

I brushed up the implementation in this version. In the previous RFC, CC_HAS_ was described by using 'option shell=', like this: config CC_HAS_STACKPROTECTOR bool option shell="$CC -Werror -fstack-protector -c -x c /dev/null" After I thought a bit more, the following syntax is

[PATCH 06/23] kconfig: reference environments directly and remove 'option env=' syntax

To get an environment value, Kconfig needs to define a symbol using "option env=" syntax. It is tedious to add a config entry for each environment given that we need more environments such as 'CC', 'AS', 'srctree' etc. to evaluate the compiler capability in Kconfig. Adding '$' to symbols is

Re: ReST questions

On 02/16/2018 09:53 AM, Markus Heiser wrote: > >> Am 22.10.2017 um 21:42 schrieb Randy Dunlap : >> >> Hi, >> >> I'm trying to render the ascii-art in lib/textsearch.c "ARCHITECTURE" (block >> diagram): > > Hi Randy, > > FYI: if you not have already been noticed, with

Re: ReST questions

> Am 22.10.2017 um 21:42 schrieb Randy Dunlap : > > Hi, > > I'm trying to render the ascii-art in lib/textsearch.c "ARCHITECTURE" (block > diagram): Hi Randy, FYI: if you not have already been noticed, with Jon's patch [1] it should work. [1]

Re: [PATCH 2/3] Documentation: convert trace/ftrace-design.txt to rst format

On Fri, 16 Feb 2018 05:49:52 -0700 Jonathan Corbet wrote: > On Thu, 15 Feb 2018 22:57:05 -0500 > Steven Rostedt wrote: > > > This document is out of date, and I rather have it updated before we > > make it more "available" elsewhere. > > Imagine that, an

Re: [PATCH 2/3] Documentation: convert trace/ftrace-design.txt to rst format

On Fri, 16 Feb 2018 17:07:26 +0800 "Du, Changbin" wrote: > > This document is out of date, and I rather have it updated before we > > make it more "available" elsewhere. > > > Got you. I plan to convert below docs. Are they out of date, too? > > events-msr.txt,

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

On Fri, Feb 16, 2018 at 10:08:28AM -0600, Christopher Lameter wrote: > On Fri, 16 Feb 2018, Matthew Wilcox wrote: > > I don't understand this response. I'm not suggesting mixing objects > > of different sizes within the same page. The vast majority of slabs > > use order-0 pages, a few use

Re: [PATCH] scripts: kernel_doc: fixup reporting of function identifiers

> Am 16.02.2018 um 15:56 schrieb Jonathan Corbet : > > On Tue, 13 Feb 2018 13:31:46 +0200 > Mike Rapoport wrote: > >> When function description includes brackets after the function name as >> suggested by Documentation/doc-guide/kernel-doc, the

Re: [PATCH 4/6] scripts: kernel-doc: support in-line comments on nested structs/unions

> Am 16.02.2018 um 15:56 schrieb Mauro Carvalho Chehab > : > > Em Fri, 16 Feb 2018 15:52:33 +0100 > Markus Heiser escreveu: > >>> Am 16.02.2018 um 14:48 schrieb Mauro Carvalho Chehab >>> : >>> >>> The parser at

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

On Fri, 16 Feb 2018, Matthew Wilcox wrote: > On Fri, Feb 16, 2018 at 09:44:25AM -0600, Christopher Lameter wrote: > > On Thu, 15 Feb 2018, Matthew Wilcox wrote: > > > What I was proposing was an intermediate page allocator where slab would > > > request 2MB for its own uses all at once, then

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

On Fri, Feb 16, 2018 at 09:44:25AM -0600, Christopher Lameter wrote: > On Thu, 15 Feb 2018, Matthew Wilcox wrote: > > What I was proposing was an intermediate page allocator where slab would > > request 2MB for its own uses all at once, then allocate pages from that to > > individual slabs, so

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

On Thu, 15 Feb 2018, Matthew Wilcox wrote: > > The inducing of releasing memory back is not there but you can run SLUB > > with MAX_ORDER allocations by passing "slab_min_order=9" or so on bootup. > > This is subtly different from the idea that I had. If you set > slub_min_order to 9, then slub

Re: [patch 1/2] mm, page_alloc: extend kernelcore and movablecore for percent

On Thu, 15 Feb 2018, Matthew Wilcox wrote: > On Thu, Feb 15, 2018 at 09:49:00AM -0600, Christopher Lameter wrote: > > On Thu, 15 Feb 2018, Matthew Wilcox wrote: > > > > > What if ... on startup, slab allocated a MAX_ORDER page for itself. > > > It would then satisfy its own page allocation

Re: [PATCH v2 0/6] crypto: engine - Permit to enqueue all async requests

On Thu, Feb 15, 2018 at 11:51:00PM +0800, Herbert Xu wrote: > On Fri, Jan 26, 2018 at 08:15:28PM +0100, Corentin Labbe wrote: > > Hello > > > > The current crypto_engine support only ahash and ablkcipher request. > > My first patch which try to add skcipher was Nacked, it will add too many > >

Re: [PATCH 4/6] scripts: kernel-doc: support in-line comments on nested structs/unions

Em Fri, 16 Feb 2018 15:52:33 +0100 Markus Heiser escreveu: > > Am 16.02.2018 um 14:48 schrieb Mauro Carvalho Chehab > > : > > > > The parser at kernel-doc rejects names with dots in the middle. > > Fix it, in order to support nested

Re: [PATCH] scripts: kernel_doc: fixup reporting of function identifiers

On Tue, 13 Feb 2018 13:31:46 +0200 Mike Rapoport wrote: > When function description includes brackets after the function name as > suggested by Documentation/doc-guide/kernel-doc, the kernel-doc script > omits the function name from "Scanning doc for" report. > Extending

Re: [PATCH 4/6] scripts: kernel-doc: support in-line comments on nested structs/unions

> Am 16.02.2018 um 14:48 schrieb Mauro Carvalho Chehab > : > > The parser at kernel-doc rejects names with dots in the middle. > Fix it, in order to support nested structs/unions. > > Tested-by: Jani Nikula > Signed-off-by: Mauro Carvalho

Re: [PATCH] Documentation: Delete reference to the kernel-mentors mailing list

On Thu, 15 Feb 2018 20:03:14 -0500 Minghui Liu wrote: > Delete reference to the kernel-mentors mailing list because the mailing list > no longer exists > > Signed-off-by: Minghui Liu It does indeed seem to have vanished. Applied, thanks.

Re: [PATCH v4 16/18] scripts: kernel-doc: improve nested logic to handle multiple identifiers

Em Wed, 14 Feb 2018 20:20:21 +0200 Jani Nikula escreveu: > On Wed, 14 Feb 2018, Mauro Carvalho Chehab wrote: > > There is a simple fix, though. Make inline comments to accept a dot: > > > > diff --git a/scripts/kernel-doc

[PATCH 6/6] drm: intel_dpio_phy: fix kernel-doc comments at nested struct

The in-lined comments for channel.port doesn't follow the syntax described at kernel-doc document, causing the following warning: $ ./scripts/kernel-doc -none drivers/gpu/drm/i915/intel_dpio_phy.c drivers/gpu/drm/i915/intel_dpio_phy.c:154: warning: Function parameter or member

[PATCH 4/6] scripts: kernel-doc: support in-line comments on nested structs/unions

The parser at kernel-doc rejects names with dots in the middle. Fix it, in order to support nested structs/unions. Tested-by: Jani Nikula Signed-off-by: Mauro Carvalho Chehab --- scripts/kernel-doc | 2 +- 1 file changed, 1 insertion(+), 1

[PATCH 5/6] doc-guide: kernel-doc: add examples about nested union/structs

It helps to give some examples about how to use in-line comments also when nested union/structs are present. So add it. Signed-off-by: Mauro Carvalho Chehab --- Documentation/doc-guide/kernel-doc.rst | 13 +++-- 1 file changed, 11 insertions(+), 2 deletions(-)

[PATCH 3/6] doc-guide: kernel-doc: move in-line section to be after nested struct

We want to give some examples about how to do in-line comments for nested structs. So, move it to be after nested structs/unions chapter. The section content was not changed on this patch. Signed-off-by: Mauro Carvalho Chehab --- Documentation/doc-guide/kernel-doc.rst

[PATCH 2/6] doc-guide: kernel-doc: fix example for inlined comments

Without ending with a ";", kernel-doc doesn't recognize it as an struct, and it fails to parse the example. Signed-off-by: Mauro Carvalho Chehab --- Documentation/doc-guide/kernel-doc.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git

[PATCH 1/6] doc-guide: kernel-doc: fix example for nested_foobar struct

There's a missing */ at the end of Kernel docs example. Even adding it, it will still produce 3 warnings: example:33: warning: Function parameter or member 'bar' not described in 'nested_foobar' example:33: warning: Function parameter or member 'bar.st1' not described in

[PATCH 0/6] Add support for in-line nested struct comments

This series fix two bugs at kernel-doc.rst examples and add support for in-line nested struct comments. It also converts one documentation at intel_dpio_phy to use it, in order to give a practical example about how to use it. Mauro Carvalho Chehab (6): doc-guide: kernel-doc: fix example for

Re: [PATCH 2/3] Documentation: convert trace/ftrace-design.txt to rst format

On Thu, 15 Feb 2018 22:57:05 -0500 Steven Rostedt wrote: > This document is out of date, and I rather have it updated before we > make it more "available" elsewhere. Imagine that, an out-of-date doc in the kernel :) Seriously, though, I'd argue that (1) it's already highly

Re: [PATCH 2/3] Documentation: convert trace/ftrace-design.txt to rst format

On Thu, Feb 15, 2018 at 10:57:05PM -0500, Steven Rostedt wrote: > On Fri, 16 Feb 2018 11:12:18 +0800 > changbin...@intel.com wrote: > > > From: Changbin Du > > > > Signed-off-by: Changbin Du > > --- > > .../trace/{ftrace-design.txt =>