==================== 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)