Ready for 3.71

[thirdparty/man-pages.git] / Changes

==================== Changes in man-pages-3.71 ====================

Released: 2014-08-17, Chicago


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:

Adrian Bunk <bunk@kernel.org>
Damir Nedzibovic <d.nedzibovic@anoxtech.com>
David Prévot <taffit@debian.org>
D. Barbier <bouzim@gmail.com>
Jakub Wilk <jwilk@debian.org>
Jan Chaloupka <jchaloup@redhat.com>
Marko Myllynen <myllynen@redhat.com>
Michael Kerrisk <mtk.manpages@gmail.com>
Mike Frysinger <vapier@gentoo.org>
NeilBrown <neilb@suse.de>
Paul Jackson <pj@usa.net>
Peng Haitao <penght@cn.fujitsu.com>
Rahul Bedarkar <rahulbedarkar89@gmail.com>
Rob Landley <rob@landley.net>
Ryan Hammonds <rhammonds@unicoi.com>
Simon Paillard <spaillard@debian.org>
Ville Ylenius <ville@ylenius.net>
Vince Weaver <vincent.weaver@maine.edu>
Yuri Kozlov <yuray@komyakino.ru>

Apologies if I missed anyone!


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

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

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


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

perf_event_open.2
    Vince Weaver
        Document new comm_exec flag
            Linux 3.16 (more specifically, commit 82b897782d10fcc4 )
            added support for differentiating between process renames
            caused by exec versus those caused by other methods.
    Vince Weaver
        Document new mmap2 record type
            Linux 3.16 (more specifically, commit a5a5ba72843dd05f9 )
            enabled the enhanced mmap2 record support.
            The interface was added in Linux 3.12 but disabled until
            Linux 3.16.
    Vince Weaver
        Document PERF_SAMPLE_BRANCH_COND
            Linux 3.16 (more specifically, commit bac52139f0b7ab31330 )
            adds support for gathering PERF_SAMPLE_BRANCH_COND
            conditional branch values when doing PERF_SAMPLE_BRANCH_STACK
            sampling.

proc.5
    Michael Kerrisk
        Document /proc/PID/comm
    Michael Kerrisk
        Document /proc/PID/pagemap
    Michael Kerrisk
        Document /proc/PID/personality
    Michael Kerrisk
        Document /proc/PID/syscall
    Michael Kerrisk
        Document /proc/kpagecount
    Michael Kerrisk
        Document /proc/kpageflags
    Michael Kerrisk
        Document /proc/sys/vm/overcommit_kbytes

capabilities.7
    Michael Kerrisk
        Add CAP_AUDIT_READ
            CAP_AUDIT_READ is new in Linux 3.16.


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

ldd.1
clone.2
execve.2
getpagesize.2
ioperm.2
msgop.2
readv.2
recv.2
select.2
send.2
seteuid.2
shmop.2
signal.2
sync.2
sysinfo.2
utime.2
abs.3
atoi.3
catopen.3
clearenv.3
ctime.3
des_crypt.3
ecvt.3
flockfile.3
fseeko.3
ftime.3
ftok.3
ftw.3
getcwd.3
getdtablesize.3
getline.3
getpass.3
getpass.3
getutent.3
glob.3
insque.3
lseek64.3
memmem.3
mkstemp.3
mktemp.3
on_exit.3
openpty.3
putenv.3
putenv.3
qecvt.3
realpath.3
realpath.3
remove.3
setbuf.3
sigpause.3
strftime.3
strptime.3
tzset.3
xcrypt.3
utmp.5
environ.7
ipv6.7
packet.7
    Michael Kerrisk
        Remove ancient Linux libc details

access.2
brk.2
chmod.2
eventfd.2
gethostname.2
getpriority.2
mmap.2
poll.2
ptrace.2
readv.2
sched_setaffinity.2
select.2
seteuid.2
signalfd.2
sync_file_range.2
timer_create.2
uname.2
wait.2
    Michael Kerrisk
        NOTES: add "C library/kernel ABI differences" subheading


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

access.2
    Michael Kerrisk
        Glibc falls back to using access() on kernels that lack faccessat()

bdflush.2
fsync.2
sync.2
proc.5
    Adrian Bunk
        Change "sync(1)" to "sync(8)"

bind.2
    Michael Kerrisk  [Ryan Hammonds]
        Correct EINVAL error description
            As pointed out by Ryan:

                My application is trying to bind an IPv4 UDP socket to an
                address. I've found that passing an invalid address length
                to bind() causes bind to return EINVAL. According to the
                bind(2) manpage, this should only occur when using unix
                domain sockets (which I am not).

chmod.2
    Michael Kerrisk
        Glibc falls back to chmod() on kernels that don't support fchmodat()
    Michael Kerrisk
        Glibc falls back to chown()/lchown() on kernels that lack fchownat()

epoll_wait.2
    Michael Kerrisk
        NOTES: describe raw epoll_pwait() system call differences

getgroups.2
    Michael Kerrisk
        SEE ALSO: add group_member(3)

getpriority.2
    Michael Kerrisk
        Enhance discussion of kernel nice range versus user-space nice range
    Michael Kerrisk
        Move text describing nice range on other systems

getrlimit.2
    Michael Kerrisk
        Add cross reference to core(5) in discussion of RLIMIT_CORE
    Michael Kerrisk
        Describe the "large" resource limit bug on 32-bit platforms
            See https://bugzilla.kernel.org/show_bug.cgi?id=5042.
    Michael Kerrisk
        Glibc's setrlimit() and getrlimit() are implemented using prlimit()

kexec_load.2
    Michael Kerrisk
        Note limit of 16 for 'nr_segments'
    Michael Kerrisk
        Clarify the 'flags' bits that contain the architecture
    Michael Kerrisk
        Add KEXEC_ARCH_68K to list of architectures for 'flags'
    Michael Kerrisk
        Reword description of 'flags' a little

link.2
    Michael Kerrisk
        Glibc falls back to link() on kernels that lack linkat()
            Unless 'flags' contains AT_SYMLINK_FOLLOW.

mkdir.2
    Michael Kerrisk
        Glibc falls back to mkdir() on kernels that don't support mkdirat()

perf_event_open.2
    Vince Weaver
        Clarify PERF_SAMPLE_STACK_USER usage
            This clarifies the PERF_SAMPLE_STACK_USER section.
            I found these issue while implementing some code that uses
            the option.  The important change is fixing the name of the
            sample_stack_user parameter, the rest is just some wording
            fixes and minor clarifications.
    Vince Weaver
        Clarify PERF_SAMPLE_DATA_SRC usage
            When checking the fields in the PERF_SAMPLE_DATA_SRC type samples
            you need to shift the masks before doing the compare.

            Although the value you are checking (perf_mem_data_src) is
            specified as a bitfield so this might all fall apart if trying
            to access the field in a cross-endian way.  The Power people
            were working on this issue, not sure if they resolved it.

poll.2
    Michael Kerrisk
        Describe fifth argument (sigsetsize) of raw ppoll() system call

process_vm_readv.2
    Michael Kerrisk  [Ville Ylenius]
        Fix typo in example program

readlink.2
    Michael Kerrisk
        Glibc falls back to readlink() on kernels that lack readlinkat()

recv.2
    Michael Kerrisk
        'addrlen' should be NULL (not 0) if we don't need sender address

rename.2
    Michael Kerrisk
        Glibc falls back to rename() when the kernel doesn't have renameat()

sigwaitinfo.2
    Michael Kerrisk
        The raw sigtimedwait() system call has a fifth argument

symlink.2
    Michael Kerrisk
        Glibc falls back to symlink() on kernels that lack symlinkat()

sysinfo.2
    Michael Kerrisk
        Add VERSIONS section

unlink.2
    Michael Kerrisk
        Glibc falls back to unlink() or rmdir() on kernels that lack unlinkat()

atoi.3
    Michael Kerrisk
        Downgrade discussion of atoq()
            Remove most references to atoq() in this page, since this function
            was present only in Linux libc (not glibc).

cerf.3
cexp2.3
clog2.3
    Michael Kerrisk
        Update version number on "Not yet in glibc" sentence

fgetgrent.3
getgrent.3
getgrent_r.3
getgrnam.3
    Michael Kerrisk  [Rob Landley]
        Clarify that 'gr_mem' is a NULL-terminated array of pointers

fseeko.3
    Michael Kerrisk
        Add VERSIONS section

ftw.3
    Michael Kerrisk
        Add VERSIONS section

getauxval.3
    Michael Kerrisk
        Document ENOENT error
            And add an entry to BUGS explaining the ambiguity that was
            present before the addition of this error.

getgrouplist.3
    Michael Kerrisk
        SEE ALSO: add group_member(3)

getline.3
    Rahul Bedarkar
        Close opened file at end of example program

memmem.3
    Michael Kerrisk
        Rewrite text of glibc 2.0 bug

printf.3
    Michael Kerrisk  [Jakub Wilk]
        Clarify details of the %n conversion specifier
            See http://bugs.debian.org/756602
    Michael Kerrisk  [Jakub Wilk]
        Note use of 'j', 'z', and 't' length modifiers for '%n'
            See http://bugs.debian.org/756602
    Michael Kerrisk
        Update with some SUSv3 details

setbuf.3
    Michael Kerrisk
        Remove ancient Linux libc and 4.x BSD details

strstr.3
    Michael Kerrisk
        Remove discussion of Linux libc bugs
            Linux libc is old enough that we needn't care any longer.

strtod.3
    Michael Kerrisk
        Explain NAN(n-char-sequence)

strtod.3
    Michael Kerrisk
        SEE ALSO: add nan(3), nanf(3), NANL(3)

updwtmp.3
    Michael Kerrisk
        Replace AVAILABILITY section with note to link logwtmp() using -lutil
            Linux libc details are no longer needed these days.

core.5
    Rahul Bedarkar
        Close opened file in example program

proc.5
    Michael Kerrisk
        Fix kernel version numbers for /proc/PID/stat fields

proc.5
    jchaloup
        Add missing proc stats fields
            Adding missing proc stats fields from
            https://www.kernel.org/doc/Documentation/filesystems/proc.txt
    Michael Kerrisk  [Simon Paillard]
        Remove crufty text under 'timer_stats'
    Michael Kerrisk
        Update /proc/PID/stat 'state' field documentation
    Michael Kerrisk
        Improve description of /proc/PID/stat fields added in Linux 3.3 and 3.5
    Michael Kerrisk
        Refer to getauxval(3) in discussion of /proc/PID/auxv
    Michael Kerrisk
        Rework formatting of /proc/PID/stat list
            Make the field numbers more prominent.
    Michael Kerrisk
        Note that /proc/PID/cmdline is read-only
    Michael Kerrisk
        Rework discussion of CommitLimit and /proc/sys/vm/overcommit_memory
    Michael Kerrisk
        Improve discussion of /proc/sys/vm/overcommit_ratio

charsets.7
    David Prévot  [Marko Myllynen]
        Tidy up list
            Remove German from main list, to be consistent with earlier
            removal of Dutch and French (in commit a8ed5f7430e0d1).

inotify.7
    Michael Kerrisk
        Note that IN_ONLY_DIR can be used to avoid races
    Michael Kerrisk
        Note that insertion of IN_MOVED_FROM+IN_MOVED_TO pair is not atomic
    Michael Kerrisk
        Mention use of timeout when reading IN_MOVED_TO after IN_MOVED_FROM

man-pages.7
    Michael Kerrisk
        Add description of "C library/kernel ABI differences" subsection
    Michael Kerrisk
        Rework text describing sections (stylistic improvements)

vdso.7
    Mike Frysinger
        Add new i386 vdso symbols in Linux 3.15
    Michael Kerrisk
        Note kernel version that exports new i386 symbols (Linux 3.15)