Gidday,
The Linux man-pages maintainer proudly announces:
man-pages-3.77 - man pages for Linux
Tarball download:
http://www.kernel.org/doc/man-pages/download.html
Git repository:
https://git.kernel.org/cgit/docs/man-pages/man-pages.git/
Online changelog:
http://man7.org/linux/man-pages/changelog.html#release_3.76
A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2015/01/man-pages-377-is-released.html
The current version of the pages is browsable at:
http://man7.org/linux/man-pages/
A few changes in this release that may be of interest to readers of
this list are given below.
Cheers,
Michael
==================== Changes in man-pages-3.77 ====================
Released: 2015-01-10, Munich
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:
Akihiro Motoki <amotoki@xxxxxxxxx>
Alexandre Bique <bique.alexandre@xxxxxxxxx>
Andre Majorel <aym-xunil@xxxxxxxxx>
Andy Lutomirski <luto@xxxxxxxxxxxxxx>
Daniel Borkmann <dborkman@xxxxxxxxxx>
Dave Hansen <dave.hansen@xxxxxxxxx>
Elie De Brauwer <eliedebrauwer@xxxxxxxxx>
Heinrich Schuchardt <xypron.glpk@xxxxxx>
Ignat Loskutov <ignat.loskutov@xxxxxxxxx>
Jeff Epler <jepler@xxxxxxxxxxxxxx>
Jérôme Pouiller <jezz@xxxxxxxxxx>
Kees Cook <keescook@xxxxxxxxxxxx>
Laurent Georget <laurent.georget@xxxxxxxxxx>
Masanari Iida <standby24x7@xxxxxxxxx>
Michael Haardt <michael@xxxxxxxx>
Michael Kerrisk <mtk.manpages@xxxxxxxxx>
Mike Frysinger <vapier@xxxxxxxxxx>
Richard Cochran <richardcochran@xxxxxxxxx>
Stephan Mueller <stephan.mueller@xxxxxxxxx>
Troy Davis <troy@xxxxxxxx>
Vince Weaver <vincent.weaver@xxxxxxxxx>
Will Drewry <wad@xxxxxxxxxxxx>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
seccomp.2
Kees Cook, Michael Kerrisk, Will Drewry [Andy Lutomirski]
New page documenting seccomp(2)
Combines documentation from prctl, in-kernel seccomp_filter.txt
and dropper.c, along with details specific to the new system call.
Newly documented interfaces in existing pages
---------------------------------------------
netlink.7
Stephan Mueller [Michael Kerrisk]
Add NETLINK_CRYPTO
Changes to individual pages
---------------------------
adjtimex.2
Laurent Georget [Richard Cochran, Jeff Epler]
Clarify the 'ppm scaling' used in struct timex
This patch makes explicit and clarifies the unit used for
the fields "freq", "ppsfreq" and "stabil" in struct timex.
Michael Kerrisk [Masanari Iida]
Note that TIME_ERROR is the modern synonym for TIME_BAD
perf_event_open.2
Vince Weaver
Clarify the PERF_FLAG_FD_* flags
This change clarifies the behavior of the PERF_FLAG_FD_OUTPUT and
PERF_FLAG_FD_NO_GROUP flags to perf_event_open(), and removes
the related FIXME comments.
While writing tests to validate the behavior of these flags I
discovered that PERF_FLAG_FD_OUTPUT has been broken since the
2.6.35 kernel release.
prctl.2
Dave Hansen [Michael Kerrisk]
Add description of Intel MPX calls
The 3.19 kernel will have support for Intel MPX, including
a pair of new prctl() calls (PR_MPX_ENABLE_MANAGEMENT and
PR_MPX_DISABLE_MANAGEMENT) for enabling and disabling the
kernel's management of the "bounds tables". Add a
descriptions of the interface.
Michael Kerrisk
Add mention of seccomp(2) under PR_SET_SECCOMP
Michael Kerrisk
Suggest /proc/PID/status "Seccomp" as alternative to PRCTL_GET_SECCOMP
Michael Kerrisk
SIGKILL can also occur PRCTL_GET_SECCOMP in SECCOMP_MODE_FILTER mode
Kees Cook [Andy Lutomirski]
Document SECCOMP_MODE_FILTER vs EFAULT
This notes the distinction made between EINVAL and EFAULT when
attempting to use SECCOMP_MODE_FILTER with PR_SET_SECCOMP.
setns.2
pid_namespaces.7
Mike Frysinger
Elaborate discussion of the PID namespace descendant limitation
The setns(2) man page already mentions that CLONE_NEWPID may only
be used with descendant namespaces, but this nuance could be
listed in a few more places so it is not missed.
shmget.2
Michael Kerrisk [Akihiro Motoki]
Make wording of SHMALL description a little clearer
sigaction.2
Michael Kerrisk
Add siginfo_t fields for SECCOMP_RET_TRAP
memchr.3
strstr.3
Alexandre Bique
Reference memmem(3) in SEE ALSO section
memcmp.3
Michael Kerrisk [Michael Haardt]
NOTES: add some detail on avoiding memcmp() of cryptographic data
Wording largely based on comments from Michael Haardt.
pthread_tryjoin_np.3
Jérôme Pouiller [Michael Kerrisk]
Document EINVAL error for pthread_timedjoin_np()
mem.4
Elie De Brauwer
/dev/kmem depends on CONFIG_DEVKMEM
Elie De Brauwer
Correct /dev/port group in example
mem.4 mentions that group for /dev/port should be set to 'mem'
However, all other files (/dev/mem and /dev/kmem) use the kmem
group in their examples and on my system /dev/port belongs to
kmem. Hence the 'mem' group was probably a typo:
Elie De Brauwer
Add CONFIG_STRICT_DEVMEM
Since 2.6.26 the CONFIG_NONPROMISC_DEVMEM options limits the
physical addresses which can be accessed through /dev/mem.
random.4
Heinrich Schuchardt
Describe handling of O_NONBLOCK
/dev/random and /dev/urandom treat O_NONBLOCK differently.
This should be described in the manpage.
Heinrich Schuchardt
Mention PRNG used by urandom
/dev/urandom uses a pseudo-random number generator to replace
missing entropy.
proc.5
Michael Kerrisk
Document "Seccomp" field of /proc/PID/status
epoll.7
Michael Kerrisk [Ignat Loskutov]
Use epoll_create1() rather than epoll_create() in the code example
epoll_create1() is more or less the preferred API for new
applications, since it allows for some flags and avoids the
misdesigned epoll_create() argument, and so it seems sensible
to use that in the example, rather than epoll_create().
tcp.7
Troy Davis
Clarify tcp_tw_recycle on Internet-facing hosts
Clarify that tcp_tw_recycle will break communication with many
general-purpose remote Internet hosts (namely, remote NAT devices)
even when the Linux device itself is not behind NAT.
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
