Skip to contentSkip to conversation

man-pages-3.83 released

DISCUSSION Michael Kerrisk (man-pages) 1 participant 1 message Apr 20, 2015 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Michael Kerrisk (man-pages)

author
#0 lore raw

Gidday,

The Linux man-pages maintainer proudly announces:

man-pages-3.83 - 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.83

A short summary of the release is blogged at:
http://linux-man-pages.blogspot.com/2015/04/man-pages-383-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-u79uwXL29TaiAVqoAR/[email protected]

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.83 ====================

Released: 2015-04-19, 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:

Andreas Baak <[email protected]> Andreas Dilger <[email protected]> cdlscpmv <[email protected]> Cyrill Gorcunov <[email protected]> Darrick J. Wong <[email protected]> David Rientjes <[email protected]> Dima Tisnek <[email protected]>
Eric Sandeen <[email protected]> Fabien Pichot <[email protected]> Felix Sedlmeier <[email protected]>
Gleb Fotengauer-Malinovskiy <glebfm-u2l5PoMzF/[email protected]> Heinrich Schuchardt <[email protected]> Jann Horn <[email protected]>
Jon Grant <[email protected]>
Jonny Grant <[email protected]>
Kees Cook <[email protected]> Masanari Iida <[email protected]> Ma Shimiao <[email protected]> Michael Kerrisk <[email protected]> Nikos Mavrogiannopoulos <nmav-c5N7Ur/[email protected]> Omar Sandoval <[email protected]> Pierre Chifflier <[email protected]> Robin H. Johnson <[email protected]> Rob Landley <rob-VoJi6FS/[email protected]> Theodore Ts'o <[email protected]>
Vlastimil Babka <[email protected]>
Walter Harms <[email protected]>
William Woodruff <william-d4iiUcZhRQBWk0Htik3J/[email protected]> YOSHIFUJI Hideaki <[email protected]> Zeng Linggang <[email protected]>

Apologies if I missed anyone!

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

posix_madvise.3
Michael Kerrisk
New page documenting posix_madvise(3)

ftw.3
Michael Kerrisk
Reorganize the page to give primacy to nftw()
nftw() is the better API, and POSIX.1-2008 marks ftw() obsolete.

Newly documented interfaces in existing pages
---------------------------------------------

getdents.2
Michael Kerrisk [Dima Tisnek]
Document getdents64()
See https://bugzilla.kernel.org/show_bug.cgi?id=14795

mount.2
Michael Kerrisk, Theodore Ts'o [Eric Sandeen, Andreas Dilger, Omar Sandoval, Darrick J. Wong]
Document MS_LAZYTIME

proc.5
Michael Kerrisk
Document /proc/sys/kernel/randomize_va_space
Michael Kerrisk
Document /proc/PID/fdinfo epoll format
Michael Kerrisk
Describe /proc/PID/fdinfo eventfd format
Michael Kerrisk
Document /proc/PID/fdinfo signalfd format

New and changed links
---------------------

newfstatat.2
Michael Kerrisk
New link to fstatat64.2

prlimit64.2
Michael Kerrisk
New link to getrlimit.2

Global changes
--------------

Various section 3 math pages
Michael Kerrisk
Note that these functions are also in POSIX.1-2001 and POSIX.1-2008

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

getent.1
Robin H. Johnson
Document options
The options to getent are now documented, after being around for nearly a decade without changes.
Michael Kerrisk
Document help and version options

fallocate.2
Michael Kerrisk
Fix kernel version number for FALLOC_FL_ZERO_RANGE
FALLOC_FL_ZERO_RANGE was added in 3.15, not 3.14.
Michael Kerrisk
Note that SMB3 added FALLOC_FL_ZERO_RANGE support in Linux 3.17

getrlimit.2

    Michael Kerrisk
        Note that the underlying system call for prlimit() is prlimit64()
    Michael Kerrisk
        Remove "_FILE_OFFSET_BITS == 64" from prlimit() FTM requirements
            "_FILE_OFFSET_BITS == 64" is not needed to get the prlimit()
            declaration.

ioctl_list.2
Nikos Mavrogiannopoulos
SIOCADDRT accepts in6_rtmsg in INET6 protocol
Heinrich Schuchardt
TFD_IOC_SET_TICKS
timerfd_create.2 mentions TFD_IOC_SET_TICKS. We should add it to ioctl_list.2, too.

llseek.2
Michael Kerrisk
Advise reader to use lseek(2) instead
Michael Kerrisk
llseek() exists on 32-bit platforms to support seeking to large offsets

madvise.2
David Rientjes
Specify MADV_REMOVE returns EINVAL for hugetlbfs
madvise(2) actually returns with error EINVAL for MADV_REMOVE when used for hugetlb VMAs, not EOPNOTSUPP, and this has been the case since MADV_REMOVE was introduced in commit f6b3ec238d12 ("madvise(MADV_REMOVE): remove pages from tmpfs shm backing store"). Specify the exact behavior.
Michael Kerrisk
SEE ALSO: add posix_madvise(2)

poll.2
Michael Kerrisk [Andreas Baak]
SEE ALSO: add epoll(7)

posix_fadvise.2
Michael Kerrisk
Add "C library/kernel ABI differences" subsection

pread.2
Michael Kerrisk
Add "C library/kernel ABI differences" subsection

seccomp.2
Michael Kerrisk [Pierre Chifflier, Kees Cook]
Note that seccomp_data is read-only

stat.2
Michael Kerrisk
Add some details on various "stat" versions
Three versions of "stat" appeared on 32-bit systems, dealing with structures of different (increasing) sizes. Explain some of the details, and also note that the situation is simpler on modern 64-bit architectures.
Michael Kerrisk
Add mention of newfstatat()
The underlying system call for fstatat() is newfstatat() on some architectures.

symlink.2
Michael Kerrisk [Jonny Grant]
ERRORS: add linkpath=="" case for ENOENT

syscalls.2
Michael Kerrisk
Remove prlimit()
There really is only the prlimit64() system call.
Michael Kerrisk
Add some details about the "multiple versions of system calls"
The multiple-system-call-version phenomenon is particularly a feature of older 32-bit platforms. Hint at that fact in the text.

timerfd_create.2
Cyrill Gorcunov [Michael Kerrisk]
Document TFD_IOC_SET_TICKS ioctl() operation
Michael Kerrisk
Add some details to C library/kernel ABI differences

unshare.2
Michael Kerrisk [Fabien Pichot]
Remove mention of "System V" from discussion of CLONE_NEWIPC
These days, CLONE_NEWIPC also affects POSIX message queues.

asprintf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe

carg.3
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

ccos.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

ccosh.3
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

cexp.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe

clock.3
Ma Shimiao
ATTRIBUTES: Note functions that is thread-safe

clog.3
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

csin.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

csinh.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

csqrt.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Simplify description of what these functions calculate

ctan.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

ctanh.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe
Michael Kerrisk
Add introductory sentence explaining what these functions calculate

ctime.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

exec.3
Michael Kerrisk
SYNOPSIS: Clarify calling signature for execl() and execlp()
Michael Kerrisk [Andreas Baak]
Correct prototype for execle()
Make the prototype shown into correct C.

ftw.3
Michael Kerrisk [Felix Sedlmeier]
ftw() and nftw() differ for the non-stat-able symlink case
The POSIX specification of ftw() says that an un-stat-able symlink may yield either FTW_NS or FTW_SL. The specification of nftw() does not carry this statement.
Michael Kerrisk
CONFORMING TO: add POSIX.1-2008
Michael Kerrisk
Update POSIX version references in NOTES

getcwd.3
Jann Horn [Michael Kerrisk]
Note behavior for unreachable current working directory
Michael Kerrisk
Add ENOMEM error

gethostbyname.3
Michael Kerrisk [Jonny Grant]
Clarify that NO_ADDRESS and NO_DATA are synonyms
Michael Kerrisk
Add some detail for NO_DATA
Text consistent with POSIX and FreeBSD's gethostbyname() man page.
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

getnetent.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

get_nprocs_conf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe

getutent.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

glob.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

insque.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe

login.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

lseek64.3
Michael Kerrisk
Clarify details with respect to 32-bit and 64-bit systems

malloc.3
Michael Kerrisk
Add ENOMEM error

mbsnrtowcs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe

mbsrtowcs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe

mq_notify.3
Michael Kerrisk
Add "C library/kernel ABI differences" subsection

mq_open.3
Michael Kerrisk [Fabien Pichot]
NOTES: explain differences from the underlying system call
The check for the slash at the start of a pathname is done in glibc

openpty.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

perror.3
Zeng Linggang
ATTRIBUTES: Note function that is thread-safe

posix_memalign.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

printf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe
Walter Harms [Michael Kerrisk]
Simplify the example code

qsort.3
Michael Kerrisk [Rob Landley]
alphasort() and versionsort() are not suitable for 'compar'
In glibc 2.10, the prototypes of alphasort() and versionsort() were changed so that the arguments switched from 'const void *' to 'const struct dirent **', to match the POSIX.1-2008 specification of alphasort(). As such, compiler warnings will result if these functions are used as the arguments of qsort().

warning: passing argument 4 of 'qsort' from incompatible pointer type
expected '__compar_fn_t' but argument is of type 'int (*)(const struct dirent **, const struct dirent **)'

Therefore, remove the ancient NOTES text suggesting that alphasort() and versionsort() can be used as suitable 'compar' arguments for qsort().

realpath.3
Michael Kerrisk [Jon Grant]
Add ENOMEM error

scandir.3
Michael Kerrisk
glibc 2.10 changed the argument types for alphasort() and versionsort()
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe

scanf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe

setnetgrent.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

significand.3
Ma Shimiao
ATTRIBUTES: Note functions that are thread-safe

strcasecmp.3
Michael Kerrisk [Jonny Grant]
Clarify that strcasecmp() does a byte-wise comparison
Michael Kerrisk
CONFORMING TO: add POSIX.1-2008

unlocked_stdio.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

updwtmp.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

wcrtomb.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe

wcsnrtombs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe

wcsrtombs.3
Zeng Linggang
ATTRIBUTES: Note function that isn't thread-safe

wordexp.3
Zeng Linggang
ATTRIBUTES: Note functions that aren't thread-safe

wprintf.3
Zeng Linggang
ATTRIBUTES: Note functions that are thread-safe

proc.5
Michael Kerrisk
Describe "mnt_id" field of /proc/PID/fdinfo
Michael Kerrisk
Note that abstract sockets are included in /proc/net/unix
Michael Kerrisk
Update description /proc/sys/unix 'Type' field
The existing text was very crufty. UNIX domain sockets support more than SOCK_STREAM for a _very_ long time now.
Michael Kerrisk
Add some detail to /proc/PID/timers
Michael Kerrisk [Vlastimil Babka]
Enhance discussion of /proc/PID/status 'VmSwap' field
Based on https://lwn.net/Articles/634978/

epoll.7
Michael Kerrisk
SEE ALSO: add poll(2) and select(2)

icmp.7
YOSHIFUJI Hideaki/吉藤英明
Document net.ipv4.ping_group_range knob

nptl.7
Michael Kerrisk
Add reference to timer_create(2)

Signature · 7 lines
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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html