linux-kernel - Re: [PATCH 46/57] docs: cma/debugfs.txt: convert to ReST and move to admin-guide/mm

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: <20190416083541.7d126935@coco.lan>
Date:   Tue, 16 Apr 2019 08:35:41 -0300
From:   Mauro Carvalho Chehab <mchehab+samsung@...nel.org>
To:     Mike Rapoport <rppt@...ux.ibm.com>
Cc:     Linux Doc Mailing List <linux-doc@...r.kernel.org>,
        Mauro Carvalho Chehab <mchehab@...radead.org>,
        linux-kernel@...r.kernel.org, Jonathan Corbet <corbet@....net>
Subject: Re: [PATCH 46/57] docs: cma/debugfs.txt: convert to ReST and move
 to admin-guide/mm

Em Tue, 16 Apr 2019 08:21:59 +0300
Mike Rapoport <rppt@...ux.ibm.com> escreveu:

> Hi Mauro,
> 
> On Mon, Apr 15, 2019 at 11:56:11PM -0300, Mauro Carvalho Chehab wrote:
> > The debugfs interface for CMA should be there together with other
> > mm-related documents.
> > 
> > Convert this small file to ReST and move it to its rightful place.
> > 
> > The conversion is actually quite simple: just add a title for the
> > document. In order to make it to look better for the audience,
> > also mark the "echo" command as a literal block.
> > 
> > Signed-off-by: Mauro Carvalho Chehab <mchehab+samsung@...nel.org>
> > ---
> >  Documentation/cma/debugfs.txt | 6 +++++-  
>  
> It wasn't really moved ;-)

Heh, yeah! The original patch was moving it:

	https://git.linuxtv.org/mchehab/experimental.git/commit/?h=all_with_indexes&id=e02d3ba65eba1676b01c82988b8054b88e6e5cdc

It seems I forgot to fix the comment here.

I opted to do just the conversion and place the move patch on a separate
series (yet to be submitted), in order to avoid merge conflicts.

> 
> >  1 file changed, 5 insertions(+), 1 deletion(-)
> > 
> > diff --git a/Documentation/cma/debugfs.txt b/Documentation/cma/debugfs.txt
> > index 6cef20a8cedc..4e06ffabd78a 100644
> > --- a/Documentation/cma/debugfs.txt
> > +++ b/Documentation/cma/debugfs.txt
> > @@ -1,3 +1,7 @@
> > +=====================
> > +CMA Debugfs Interface
> > +=====================
> > +
> >  The CMA debugfs interface is useful to retrieve basic information out of the
> >  different CMA areas and to test allocation/release in each of the areas.
> > 
> > @@ -12,7 +16,7 @@ The structure of the files created under that directory is as follows:
> >   - [RO] count: Amount of memory in the CMA area.
> >   - [RO] order_per_bit: Order of pages represented by one bit.
> >   - [RO] bitmap: The bitmap of page states in the zone.
> > - - [WO] alloc: Allocate N pages from that CMA area. For example:
> > + - [WO] alloc: Allocate N pages from that CMA area. For example::
> > 
> >  	echo 5 > <debugfs>/cma/cma-2/alloc
> > 
> > -- 
> > 2.20.1
> >   
> 



Thanks,
Mauro