man-pages-3.37 released

man-pages-3.37 released

[Michael Kerrisk (man-pages)]

Gidday,

The Linux man-pages maintainer proudly announces:

   man-pages-3.37.tar.gz - man pages for Linux

Tarball download:
   http://www.kernel.org/pub/linux/docs/man-pages/
Git repository:
   http://git.kernel.org/pub/scm/docs/man-pages/man-pages.git
Online changelog:
   http://man7.org/linux/man-pages/changelog.html#release_3.37

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2012/03/man-pages-337-is-released.html

The current version of the pages is browsable at:
http://man7.org/linux/man-pages/

You are receiving this message either because:

a) You contributed to the content of this release.

b) You are subscribed to linux-man-u79uwXL29TY76Z2rM5mHXA@public.gmane.org (*).

c) I have information (possibly inaccurate) that you are the
maintainer of a translation of the manual pages, or are the maintainer
of the manual pages set in a particular distribution, or have
expressed interest in helping with man-pages maintenance, or have
otherwise expressed interest in being notified about man-pages
releases.  If you don't want to receive such messages from me, or you
know of some other translator or maintainer who may want to receive
such notifications, send me a message.

Cheers,

Michael


==================== Changes in man-pages-3.37 ====================

Released: 2012-03-06, Christchurch


Contributors
------------

The following people contributed patches/fixes or (noted in brackets
in the changelog below) reports, notes, and ideas that have been
incorporated in changes in this release:

Denys Vlasenko <dvlasenk-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
Mark R. Bannister <cambridge-Rn4VEauK+AKRv+LV9MX5uipxlwaOVQ5f@public.gmane.org>
Michael Kerrisk <mtk.manpages-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
Oleg Nesterov <oleg-H+wXaHxf7aLQT0dZR+AlfA@public.gmane.org>
Tejun Heo <tj-DgEjT+Ai2ygdnm+yROfE0A@public.gmane.org>

Apologies if I missed anyone!


New and rewritten pages
-----------------------

getent.1
    Mark R. Bannister
        New page to document 'getent' binary provided by glibc


Changes to individual pages
---------------------------

bdflush.2
    Michael Kerrisk
        Note that bdflush() is deprecated, and does nothing

nfsservctl.2
    Michael Kerrisk
        Note that this system call was removed in Linux 3.1

ptrace.2
    Denys Vlasenko  [Oleg Nesterov, Tejun Heo]
        add extended description of various ptrace quirks
            Changes include:

            s/parent/tracer/g, s/child/tracee/g - ptrace interface now
            is sufficiently cleaned up to not treat tracing process
            as parent.

            Deleted several outright false statements:
            - pid 1 can be traced
            - tracer is not shown as parent in ps output
            - PTRACE_ATTACH is not "the same behavior as if tracee had done
              a PTRACE_TRACEME": PTRACE_ATTACH delivers a SIGSTOP.
            - SIGSTOP _can_ be injected.
            - Removed mentions of SunOS and Solaris as irrelevant.
            - Added a few more known bugs.

            Added a large block of text in DESCRIPTION which doesn't focus
            on mechanical description of each flag and operation, but rather
            tries to describe a bigger picture. The targeted audience is
            a person which is reasonably knowledgeable in Unix but did not
            spend years working with ptrace, and thus may be unaware of its
            quirks. This text went through several iterations of review by
            Oleg Nesterov and Tejun Heo.
            This block of text intentionally uses as little markup as possible,
            otherwise future modifications to it will be very hard to make.
    Michael Kerrisk
        Global clean-up of page
            * Wording and formatting fixes to existing text and
              Denys Vlasenko's new text.
            * Various technical amendments and improvements to
              Denys Vlasenko's new text.
            * Added FIXME for various problems with the current text.
    Michael Kerrisk
        Integrated changes after further review from Denys Vlasenko

syscalls.2
    Michael Kerrisk
        Note that nfsservctl(2) was removed in Linux 3.1
        Note that bdflush(2) is deprecated

capabilities.7
    Michael Kerrisk
        Add CAP_WAKE_ALARM
    Michael Kerrisk
        Add various operations under CAP_SYS_ADMIN
        Add perf_event_open(2) to CAP_SYS_ADMIN
        Add VM86_REQUEST_IRQ vm86(2) command to CAP_SYS_ADMIN
        Update CAP_NET_ADMIN with notes from include/linux/capability.h
        Add nfsservctl(2) to CAP_SYS_ADMIN
    Michael Kerrisk
        Add ioctl(FIBMAP) under CAP_SYS_RAWIO
    Michael Kerrisk
        Add virtual terminal ioctl()s under CAP_SYS_TTY_CONFIG
    Michael Kerrisk
        Update CAP_NET_RAW with notes from include/linux/capability.h
    Michael Kerrisk
        Add F_SETPIPE_SZ case to CAP_SYS_RESOURCE
        Add POSIX messages queues queues_max case to CAP_SYS_RESOURCE
        Update CAP_SYS_RESOURCE with notes from include/linux/capability.h
    Michael Kerrisk
        SEE ALSO: Add libcap(3)

ld.so.8
    Michael Kerrisk
        Add --audit command-line option

-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: man-pages-3.37 released

[D. Barbier]

[-- Attachment #1: Type: text/plain, Size: 628 bytes --]

Le 9 mars 2012 18:28, Michael Kerrisk (man-pages) a écrit :
> Gidday,
>
> The Linux man-pages maintainer proudly announces:
>
>   man-pages-3.37.tar.gz - man pages for Linux
[...]

Hello Michael,

There is an nroff syntax error in man2/ptrace.2:

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 37c4dff..775a26d 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -726,7 +726,7 @@ group-stop, PTRACE_EVENT stops, syscall-stops
 .BR PTRACE_SINGLESTEP ,
 .BR PTRACE_SYSEMU ,
 and
-.BE PTRACE_SYSEMU_SINGLESTEP .
+.BR PTRACE_SYSEMU_SINGLESTEP .
 They all are reported by
 .BR waitpid (2)
 with


Denis

[-- Attachment #2: ptrace.patch --]
[-- Type: text/x-patch, Size: 343 bytes --]

diff --git a/man2/ptrace.2 b/man2/ptrace.2
index 37c4dff..775a26d 100644
--- a/man2/ptrace.2
+++ b/man2/ptrace.2
@@ -726,7 +726,7 @@ group-stop, PTRACE_EVENT stops, syscall-stops
 .BR PTRACE_SINGLESTEP ,
 .BR PTRACE_SYSEMU ,
 and
-.BE PTRACE_SYSEMU_SINGLESTEP .
+.BR PTRACE_SYSEMU_SINGLESTEP .
 They all are reported by
 .BR waitpid (2)
 with

Re: man-pages-3.37 released

[Michael Kerrisk (man-pages)]

On Sat, Mar 10, 2012 at 8:03 AM, D. Barbier <bouzim-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> wrote:
> Le 9 mars 2012 18:28, Michael Kerrisk (man-pages) a écrit :
>> Gidday,
>>
>> The Linux man-pages maintainer proudly announces:
>>
>>   man-pages-3.37.tar.gz - man pages for Linux
> [...]
>
> Hello Michael,
>
> There is an nroff syntax error in man2/ptrace.2:
>
> diff --git a/man2/ptrace.2 b/man2/ptrace.2
> index 37c4dff..775a26d 100644
> --- a/man2/ptrace.2
> +++ b/man2/ptrace.2
> @@ -726,7 +726,7 @@ group-stop, PTRACE_EVENT stops, syscall-stops
>  .BR PTRACE_SINGLESTEP ,
>  .BR PTRACE_SYSEMU ,
>  and
> -.BE PTRACE_SYSEMU_SINGLESTEP .
> +.BR PTRACE_SYSEMU_SINGLESTEP .
>  They all are reported by
>  .BR waitpid (2)
>  with

Thanks Denis. This piece was fixed in a separate patch by Denys Vlasenko.

Cheers,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: man-pages-3.37 released

[Mark R Bannister]

Hi Michael,

Thanks for incorporating my getent(1) man page into 3.37.

Thanks also for picking up my qsort_r(1) changes and for feeding back 
regarding scandirat(3) for which I'll get a new revision out to you shortly.

However, there are still some man pages that I have contributed that are 
still MIA.  Namely:

     nsswitch.conf(5) rewrite: contributed 13th Oct 2011.
     scandir(3) minor update: contributed 15th Nov 2011.
     umask(2) minor update: contributed 2nd Dec 2011.

Do you know what is happening with these?

Best regards,
Mark Bannister.

On 09/03/2012 17:28, Michael Kerrisk (man-pages) wrote:
> Gidday,
>
> The Linux man-pages maintainer proudly announces:
>
>     man-pages-3.37.tar.gz - man pages for Linux
>

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: man-pages-3.37 released

[Michael Kerrisk (man-pages)]

On Sun, Mar 18, 2012 at 10:00 AM, Mark R Bannister
<mark-/K+B3afwL8Jt0JrxVvvTASp2UmYkHbXO@public.gmane.org> wrote:
> Hi Michael,
>
> Thanks for incorporating my getent(1) man page into 3.37.
>
> Thanks also for picking up my qsort_r(1) changes and for feeding back
> regarding scandirat(3) for which I'll get a new revision out to you shortly.
>
> However, there are still some man pages that I have contributed that are
> still MIA.  Namely:
>
>    nsswitch.conf(5) rewrite: contributed 13th Oct 2011.
>    scandir(3) minor update: contributed 15th Nov 2011.
>    umask(2) minor update: contributed 2nd Dec 2011.
>
> Do you know what is happening with these?

Hi Mark,

They're in my queue. Ping me if no action by the end of the month.

Thanks,

Michael


> On 09/03/2012 17:28, Michael Kerrisk (man-pages) wrote:
>>
>> Gidday,
>>
>> The Linux man-pages maintainer proudly announces:
>>
>>    man-pages-3.37.tar.gz - man pages for Linux
>>
>



-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html