==================== Changes in man-pages-3.36 ==================== Released: 2012-02-27, 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: Alain Benedetti carado Christoph Hellwig Clemens Ladisch David Prévot Elie De Brauwer Guillem Jover Jessica McKellar Josef Bacik Junjiro Okajima Lucian Adrian Grijincu Michael Kerrisk Mike Frysinger Pat Pannuto Salvo Tomaselli Simone Piccardi Slaven Rezic starlight@binnacle.cx Stephan Mueller Vijay Rao Walter Haidinger Walter Harms Yang Yang Apologies if I missed anyone! New and rewritten pages ----------------------- sendmmsg.2 Michael Kerrisk [Stephan Mueller] New page for sendmmsg(2) Some pieces inspired by an initial attempt by Stephan Mueller. Newly documented interfaces in existing pages --------------------------------------------- fallocate.2 Lucian Adrian Grijincu Document FALLOC_FL_PUNCH_HOLE FALLOC_FL_PUNCH_HOLE was added in Linux 2.6.38, for punching holes in the allocated space in a file. Changes to individual pages --------------------------- dup.2 Michael Kerrisk SYNOPSIS: Add "#include " for O_* constants fallocate.2 Michael Kerrisk Substantial restructuring of DESCRIPTION The addition of a second class of operation ("hole punching") to the man page made it clear that some significant restructuring is required. So I substantially reworked the page, including the preexisting material on the default "file allocation" operation. Michael Kerrisk [Josef Bacik] Add further details for FALLOC_FL_PUNCH_HOLE Michael Kerrisk ERRORS: Add EPERM error case for FALLOC_FL_PUNCH_HOLE fork.2 Michael Kerrisk NOTES: Describe clone() call equivalent to fork() fsync.2 Christoph Hellwig Various improvements - explain the situation with disk caches better - remove the duplicate fdatasync() explanation in the NOTES section - remove an incorrect note about fsync() generally requiring two writes - remove an obsolete ext2 example note - fsync() works on any file descriptor (doesn't need to be writable); correct the EBADF error code explanation Michael Kerrisk [Guillem Jover] Note that some systems require a writable file descriptor An edited version of Guillem Jover's comments: [While the file descriptor does not need to be writable on Linux] that's not a safe portable assumption to make on POSIX in general as that behavior is not specified and as such is implementation-specific. Some Unix systems do actually fail on read-only file descriptors, for example [HP-UX and AIX]. mount.2 Michael Kerrisk [Junjiro Okajima] Removed erroneous statement about MS_RDONLY and bind mounts open.2 Jessica McKellar Fix grammar in O_DIRECT description Some small grammar fixes to the O_DIRECT description. pipe.2 Michael Kerrisk [Salvo Tomaselli] SYNOPSIS: Add "#include " for O_* constants See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=659750 sched_rr_get_interval.2 Clemens Ladisch Update notes on modifying quantum Since Linux 2.6.24, it is no longer possible to modify the SCHED_RR quantum using setpriority(2). (Slight edits to Clemens' patch by mtk.) Michael Kerrisk Reordered various pieces of text Michael Kerrisk Reworded text of ESRCH error send.2 Michael Kerrisk Add mention of sendmmsg(2) sync.2 Michael Kerrisk [Simone Piccardi] PROTOTYPE: Fix return type of syncfs() vfork.2 Michael Kerrisk [starlight@binnacle.cx] Clarify what is duplicated in the child Add some words to make it clear to the reader that vfork(), like fork(), creates duplicates of process attributes in the child. Michael Kerrisk Note clone() flags equivalent to vfork() Michael Kerrisk [starlight@binnacle.cx, Mike Frysinger] Add some notes on reasons why vfork() still exists Michael Kerrisk [starlight@binnacle.cx] Clarify that calling *thread* is suspended during vfork() Michael Kerrisk CONFORMING TO: Note that POSIX.1-2001 marked vfork() obsolete gets.3 Michael Kerrisk Document C11 and glibc 2.16 changes affecting gets() pthread_sigmask.3 Michael Kerrisk [Pat Pannuto] Fix comment that was inconsistent with code in example program sem_wait.3 Walter Harms EXAMPLE: Remove extraneous line of output from shell session wcsnrtombs.3 wcsrtombs.3 wcstombs.3 Michael Kerrisk Fix-ups for e9c23bc636426366d659809bc99cd84661e86464 core.5 Michael Kerrisk [Junjiro Okajima] Document %E specifier for core_pattern passwd.5 Michael Kerrisk [Walter Haidinger] s/asterisk/asterisk (*)/ to improve clarity Michael Kerrisk Correct note on passwd field value when shadowing is enabled When password shadowing is enabled, the password field contains an 'x' (not a "8'). proc.5 Elie De Brauwer Fix description of fourth field of /proc/loadavg SIgned-off-by: Elie De Brauwer resolv.conf.5 Michael Kerrisk [Slaven Rezic] Describe syntax used for comments See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=656994 feature_test_macros.7 Michael Kerrisk Document _ISOC11_SOURCE inotify.7 Michael Kerrisk [Yang Yang] Note that 'cookie' field is set to zero when unused man.7 Michael Kerrisk Various fixes for description of NAME section As noted by reporter: * The code sample given for the NAME section is incomplete because the actual content sample is not given. * Additionally, the description assumes that the item described is a command, which need not be the case. * The command makewhatis is not present on my system; the documented tool to create the whatis database is called mandb. * The description on .SH NAME in man(7) should either copy the relevant paragraph of lexgrog(1) or refer to it. Reported by: Kristof Zelechovski