From b60a8f50cdfeb4438eb20649009b61a0d5fad169 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Tue, 19 Aug 2014 12:11:14 -0500 Subject: [PATCH] Start of man-pages-3.72: updating Changes and Changes.old --- Changes | 410 +----------------------------------------------- Changes.old | 439 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 443 insertions(+), 406 deletions(-) diff --git a/Changes b/Changes index f120a1334..9a8a6f079 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.71 ==================== +==================== Changes in man-pages-3.72 ==================== -Released: 2014-08-17, Chicago +Released: ????-??-??, Munich Contributors @@ -10,25 +10,6 @@ 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 -Damir Nedzibovic -David Prévot -D. Barbier -Jakub Wilk -Jan Chaloupka -Marko Myllynen -Michael Kerrisk -Mike Frysinger -NeilBrown -Paul Jackson -Peng Haitao -Rahul Bedarkar -Rob Landley -Ryan Hammonds -Simon Paillard -Ville Ylenius -Vince Weaver -Yuri Kozlov Apologies if I missed anyone! @@ -36,402 +17,19 @@ 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. +New and changed links +--------------------- 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) diff --git a/Changes.old b/Changes.old index b956a3b15..06339a144 100644 --- a/Changes.old +++ b/Changes.old @@ -33086,3 +33086,442 @@ ld.so.8 contents of the target file. Michael Kerrisk SEE ALSO: add sprof(1) + + +==================== 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 +Damir Nedzibovic +David Prévot +D. Barbier +Jakub Wilk +Jan Chaloupka +Marko Myllynen +Michael Kerrisk +Mike Frysinger +NeilBrown +Paul Jackson +Peng Haitao +Rahul Bedarkar +Rob Landley +Ryan Hammonds +Simon Paillard +Ville Ylenius +Vince Weaver +Yuri Kozlov + +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)