mirror of https://github.com/mkerrisk/man-pages
Changes: Ready for 3.71
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
parent
af81e9cd97
commit
9da7b16499
408
Changes
408
Changes
|
@ -1,6 +1,6 @@
|
||||||
==================== Changes in man-pages-3.71 ====================
|
==================== Changes in man-pages-3.71 ====================
|
||||||
|
|
||||||
Released: ????-??-??, Munich
|
Released: ????-??-??, Chicago
|
||||||
|
|
||||||
|
|
||||||
Contributors
|
Contributors
|
||||||
|
@ -10,6 +10,25 @@ The following people contributed patches/fixes or (noted in brackets
|
||||||
in the changelog below) reports, notes, and ideas that have been
|
in the changelog below) reports, notes, and ideas that have been
|
||||||
incorporated in changes in this release:
|
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!
|
Apologies if I missed anyone!
|
||||||
|
|
||||||
|
@ -17,19 +36,402 @@ Apologies if I missed anyone!
|
||||||
New and rewritten pages
|
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
|
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.
|
||||||
|
|
||||||
New and changed links
|
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
|
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
|
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)
|
||||||
|
|
Loading…
Reference in New Issue