mirror of https://github.com/mkerrisk/man-pages
438 lines
11 KiB
Plaintext
438 lines
11 KiB
Plaintext
==================== 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)
|