mirror of https://github.com/mkerrisk/man-pages
Changes: Update with details for 3.27 release
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
This commit is contained in:
Michael Kerrisk
parent
516ddeefbd
commit
5e1a04e9e5
482
Changes
482
Changes
|
|
@ -1,6 +1,6 @@
|
|||
==================== Changes in man-pages-3.27 ====================
|
||||
|
||||
Released: ????-??-??, Munich
|
||||
Released: 2010-09-22, Nuernberg
|
||||
|
||||
|
||||
Contributors
|
||||
|
|
@ -9,6 +9,24 @@ Contributors
|
|||
The following people contributed notes, ideas, or patches that have
|
||||
been incorporated in changes in this release:
|
||||
|
||||
caishuxian@gmail.com
|
||||
Denis Barbier <bouzim@gmail.com>
|
||||
Denis Silakov <silakov@ispras.ru>
|
||||
der Mouse <mouse@rodents-montreal.org>
|
||||
Jan Kratochvil <jan.kratochvil@redhat.com>
|
||||
Jim Belton <jim.belton@gmail.com>
|
||||
Jiri Olsa <jolsa@redhat.com>
|
||||
KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
|
||||
Mark Hills <mark@pogo.org.uk>
|
||||
Matthew Flaschen <matthew.flaschen@gatech.edu>
|
||||
Michael Kerrisk <mtk.manpages@gmail.com>
|
||||
Ozgur Gurcan <ozgur.gurcan@lpp.polytechnique.fr>
|
||||
Petr Baudis <pasky@suse.cz>
|
||||
Remi Denis-Courmont <remi@remlab.net>
|
||||
Tanaka Akira <akr@fsij.org>
|
||||
Tim Stoakes <tim@stoakes.net>
|
||||
W. Trevor King <wking@drexel.edu>
|
||||
Yuri Kozlov <yuray@komyakino.ru>
|
||||
|
||||
Apologies if I missed anyone!
|
||||
|
||||
|
|
@ -16,19 +34,473 @@ Apologies if I missed anyone!
|
|||
New and rewritten pages
|
||||
-----------------------
|
||||
|
||||
sigevent.7
|
||||
Petr Baudis, Michael Kerrisk
|
||||
New page to centralize description of sigevent structure
|
||||
Several interfaces use this structure. Best to centralize the
|
||||
common details in one place. Content taken from the existing
|
||||
timerfd_create.2 and mq_open.3 pages, with additions by
|
||||
Petr Baudis and Michael Kerrisk.
|
||||
|
||||
|
||||
Newly documented interfaces in existing pages
|
||||
---------------------------------------------
|
||||
|
||||
|
||||
New and changed links
|
||||
---------------------
|
||||
|
||||
|
||||
Global changes
|
||||
--------------
|
||||
|
||||
_exit.2
|
||||
brk.2
|
||||
chdir.2
|
||||
chmod.2
|
||||
chown.2
|
||||
chroot.2
|
||||
clock_nanosleep.2
|
||||
getdtablesize.2
|
||||
gethostname.2
|
||||
getpagesize.2
|
||||
getsid.2
|
||||
killpg.2
|
||||
mknod.2
|
||||
mknodat.2
|
||||
posix_fadvise.2
|
||||
pread.2
|
||||
readlink.2
|
||||
setpgid.2
|
||||
setpgid.2
|
||||
setreuid.2
|
||||
sigaltstack.2
|
||||
stat.2
|
||||
symlink.2
|
||||
sync.2
|
||||
truncate.2
|
||||
vfork.2
|
||||
wait.2
|
||||
wait4.2
|
||||
a64l.3
|
||||
abs.3
|
||||
acos.3
|
||||
acosh.3
|
||||
asin.3
|
||||
asinh.3
|
||||
atan.3
|
||||
atan2.3
|
||||
atanh.3
|
||||
atoi.3
|
||||
cbrt.3
|
||||
ceil.3
|
||||
clock_getcpuclockid.3
|
||||
copysign.3
|
||||
cos.3
|
||||
cosh.3
|
||||
dirfd.3
|
||||
div.3
|
||||
dprintf.3
|
||||
ecvt.3
|
||||
erf.3
|
||||
erfc.3
|
||||
exp.3
|
||||
exp2.3
|
||||
expm1.3
|
||||
fabs.3
|
||||
fdim.3
|
||||
fexecve.3
|
||||
ffs.3
|
||||
floor.3
|
||||
fma.3
|
||||
fmax.3
|
||||
fmemopen.3
|
||||
fmin.3
|
||||
fmod.3
|
||||
fpclassify.3
|
||||
frexp.3
|
||||
fwide.3
|
||||
gamma.3
|
||||
gcvt.3
|
||||
getcwd.3
|
||||
getdate.3
|
||||
getgrent.3
|
||||
gethostid.3
|
||||
getpass.3
|
||||
getpwent.3
|
||||
getsubopt.3
|
||||
getw.3
|
||||
hypot.3
|
||||
ilogb.3
|
||||
insque.3
|
||||
isalpha.3
|
||||
isgreater.3
|
||||
iswblank.3
|
||||
j0.3
|
||||
j0.3
|
||||
ldexp.3
|
||||
lockf.3
|
||||
log.3
|
||||
log10.3
|
||||
log1p.3
|
||||
log2.3
|
||||
logb.3
|
||||
lrint.3
|
||||
lround.3
|
||||
mbsnrtowcs.3
|
||||
mkdtemp.3
|
||||
mkstemp.3
|
||||
mktemp.3
|
||||
modf.3
|
||||
mq_receive.3
|
||||
mq_send.3
|
||||
nan.3
|
||||
nextafter.3
|
||||
posix_fallocate.3
|
||||
posix_memalign.3
|
||||
pow.3
|
||||
printf.3
|
||||
qecvt.3
|
||||
random.3
|
||||
realpath.3
|
||||
remainder.3
|
||||
remquo.3
|
||||
rint.3
|
||||
rint.3
|
||||
round.3
|
||||
scalb.3
|
||||
scalbln.3
|
||||
scanf.3
|
||||
siginterrupt.3
|
||||
signbit.3
|
||||
sigset.3
|
||||
sin.3
|
||||
sinh.3
|
||||
sqrt.3
|
||||
stpcpy.3
|
||||
stpncpy.3
|
||||
strdup.3
|
||||
strdup.3
|
||||
strnlen.3
|
||||
strsignal.3
|
||||
strtod.3
|
||||
strtol.3
|
||||
strtoul.3
|
||||
tan.3
|
||||
tanh.3
|
||||
tgamma.3
|
||||
trunc.3
|
||||
ttyslot.3
|
||||
ualarm.3
|
||||
usleep.3
|
||||
wcpcpy.3
|
||||
wcpncpy.3
|
||||
wcscasecmp.3
|
||||
wcsdup.3
|
||||
wcsncasecmp.3
|
||||
wcsnlen.3
|
||||
wcsnrtombs.3
|
||||
wprintf.3
|
||||
Michael Kerrisk
|
||||
Add/fix/update feature test macro requirements in SYNOPSIS
|
||||
Various changes to:
|
||||
* Update feature test requirements to note changes in
|
||||
recent glibc releases
|
||||
* Correct errors in feature test macro requirements
|
||||
* Add feature test macro requirements to pages where
|
||||
the requirements were not previously stated.
|
||||
|
||||
accept.2
|
||||
clone.2
|
||||
dup.2
|
||||
fallocate.2
|
||||
pipe.2
|
||||
readahead.2
|
||||
sched_setaffinity.2
|
||||
unshare.2
|
||||
CPU_SET.3
|
||||
endian.3
|
||||
euidaccess.3
|
||||
fexecve.3
|
||||
getpt.3
|
||||
getpw.3
|
||||
getumask.3
|
||||
getutmp.3
|
||||
gnu_get_libc_version.3
|
||||
makedev.3
|
||||
matherr.3
|
||||
mbsnrtowcs.3
|
||||
memfrob.3
|
||||
pthread_attr_setaffinity_np.3
|
||||
pthread_getattr_np.3
|
||||
pthread_setaffinity_np.3
|
||||
pthread_tryjoin_np.3
|
||||
tcgetsid.3
|
||||
wcscasecmp.3
|
||||
wcsncasecmp.3
|
||||
wcsnlen.3
|
||||
wcsnrtombs.3
|
||||
wcswidth.3
|
||||
rtld-audit.7
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Add reference to feature_test_macros(7)
|
||||
These pages specify feature test macros in the function
|
||||
prototypes. Add a reference to feature_test_macros(7),
|
||||
so that readers are pointed to the information that
|
||||
feature test macros must be defined before including
|
||||
*any* header file.
|
||||
|
||||
clock_nanosleep.2
|
||||
clock_getcpuclockid.3
|
||||
getnetent_r.3
|
||||
getprotoent_r.3
|
||||
getrpcent_r.3
|
||||
getservent_r.3
|
||||
sigwait.3
|
||||
Michael Kerrisk
|
||||
RETURN VALUE: Note that "positive error numbers" are listed in ERRORS
|
||||
|
||||
fcntl.2
|
||||
intro.2
|
||||
open.2
|
||||
poll.2
|
||||
ftw.3
|
||||
intro.3
|
||||
matherr.3
|
||||
system.3
|
||||
tmpnam.3
|
||||
unix.7
|
||||
Michael Kerrisk
|
||||
Note that feature test macros must be defined before *any* includes
|
||||
Programmers often make the mistake of including a feature test
|
||||
macro only after having already included some header files.
|
||||
This patch adds some text at opportune places to remind
|
||||
programmers to do things the right way.
|
||||
|
||||
index.3
|
||||
stpcpy.3
|
||||
strcasecmp.3
|
||||
strcat.3
|
||||
strchr.3
|
||||
strcmp.3
|
||||
strcoll.3
|
||||
strcpy.3
|
||||
strdup.3
|
||||
strfry.3
|
||||
strpbrk.3
|
||||
strsep.3
|
||||
strspn.3
|
||||
strstr.3
|
||||
strtok.3
|
||||
strxfrm.3
|
||||
Michael Kerrisk
|
||||
SEE ALSO: Add reference to string(3)
|
||||
The idea here is to provide a route to discover other
|
||||
string functions.
|
||||
|
||||
armscii-8.7
|
||||
cp1251.7
|
||||
iso_8859-3.7
|
||||
iso_8859-5.7
|
||||
iso_8859-6.7
|
||||
iso_8859-8.7
|
||||
iso_8859-10.7
|
||||
iso_8859-11.7
|
||||
iso_8859-13.7
|
||||
iso_8859-14.7
|
||||
koi8-u.7
|
||||
Denis Barbier
|
||||
Fix decimal values in encoding tables
|
||||
Octal and hexadecimal values are right, but there are some
|
||||
off-by one errors in decimal values. Correct values are
|
||||
printed by this command:
|
||||
|
||||
perl -pi -e 'if (s/^([0-7]+)\t([0-9]+)\t([0-9a-fA-F]+)//)
|
||||
{printf "%03o\t%d\t%s", hex($3), hex($3), $3;};' man7/*.7
|
||||
|
||||
|
||||
Changes to individual pages
|
||||
---------------------------
|
||||
|
||||
capget.2
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Remove unneeded "undef _POSIX_SOURCE"
|
||||
|
||||
fcntl.2
|
||||
Michael Kerrisk
|
||||
Add feature test macro requirements for F_GETOWN and F_SETOWN
|
||||
|
||||
fcntl.2
|
||||
Michael Kerrisk
|
||||
Note feature test macro requirements for F_DUPFD_CLOEXEC
|
||||
|
||||
getrlimit.2
|
||||
Michael Kerrisk
|
||||
Document units for RLIMIT_RTTIME limit
|
||||
This limit is in microseconds
|
||||
|
||||
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596492
|
||||
|
||||
lseek.2
|
||||
Michael Kerrisk
|
||||
Removed note about return type on ancient systems
|
||||
|
||||
mount.2
|
||||
Michael Kerrisk
|
||||
Definitions of various MS_* constants only appeared in glibc 2.12
|
||||
See http://sourceware.org/bugzilla/show_bug.cgi?id=11235
|
||||
|
||||
stat.2
|
||||
Michael Kerrisk
|
||||
Update information on nanosecond timestamp fields
|
||||
Update feature test macro requirements for exposing these fields.
|
||||
Note that these fields are specified in POSIX.1-2008.
|
||||
|
||||
timer_create.2
|
||||
Michael Kerrisk
|
||||
Factor out generic material that was moved to new sigevent(7) page
|
||||
|
||||
aio_fsync.3
|
||||
Michael Kerrisk
|
||||
Add reference to new sigevent(7) page
|
||||
|
||||
atanh.3
|
||||
Michael Kerrisk
|
||||
glibc 2.10 fixed pole error bug
|
||||
http://sourceware.org/bugzilla/show_bug.cgi?id=6759
|
||||
was resolved.
|
||||
|
||||
cerf.3
|
||||
Michael Kerrisk
|
||||
Make it clearer that this function is unimplemented
|
||||
|
||||
cos.3
|
||||
Michael Kerrisk
|
||||
errno is now correctly set to EDOM on a domain error
|
||||
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780
|
||||
was (silently) resolved.
|
||||
|
||||
expm1.3
|
||||
Michael Kerrisk
|
||||
errno is now correctly set to ERANGE on a range error
|
||||
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788
|
||||
was (silently) resolved.
|
||||
|
||||
fmod.3
|
||||
Michael Kerrisk
|
||||
errno is now correctly set to EDOM for the x==inf domain error
|
||||
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6784
|
||||
was (silently) resolved.
|
||||
|
||||
insque.3
|
||||
Michael Kerrisk
|
||||
Noted prev == NULL bug in glibc 2.4 and earlier
|
||||
As noted by Remi Denis-Courmont, glibc nowadays allows
|
||||
'prev' to be NULL, as required by POSIX for initializing
|
||||
a linear list. But in glibc 2.4 and earlier, 'prev' could
|
||||
not be NULL. Add a BUGS section noting this.
|
||||
|
||||
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=551201
|
||||
|
||||
insque.3
|
||||
Michael Kerrisk
|
||||
Added info on circular lists, and initializing circular lists
|
||||
Michael Kerrisk
|
||||
Added example program
|
||||
|
||||
lgamma.3
|
||||
Michael Kerrisk
|
||||
glibc 2.10 fixed pole error bug
|
||||
http://sourceware.org/bugzilla/show_bug.cgi?id=6777
|
||||
was (silently) resolved.
|
||||
|
||||
log2.3
|
||||
Matthew Flaschen
|
||||
log2() function does not conform to C89
|
||||
log2(), log2f(), and log2l() do not conform to C89.
|
||||
They are defined in C99. See http://flash-gordon.me.uk/ansi.c.txt
|
||||
and http://www.schweikhardt.net/identifiers.html
|
||||
|
||||
mq_notify.3
|
||||
Michael Kerrisk
|
||||
Factor out generic material that was moved to new sigevent(7) page
|
||||
|
||||
pow.3
|
||||
Michael Kerrisk
|
||||
errno is now correctly set to ERANGE on a pole error
|
||||
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776
|
||||
was (silently) resolved.
|
||||
|
||||
pthread_kill_other_threads_np.3
|
||||
Michael Kerrisk
|
||||
CONFORMING TO: Note meaning of "_np" suffix
|
||||
|
||||
rand.3
|
||||
Michael Kerrisk
|
||||
Clarify description of range of returned value
|
||||
Michael Kerrisk
|
||||
Add an example program
|
||||
Michael Kerrisk
|
||||
Expand description of rand_r()
|
||||
|
||||
random.3
|
||||
W. Trevor King
|
||||
Update initstate() return value description to match glibc
|
||||
|
||||
readdir.3
|
||||
Michael Kerrisk
|
||||
Clarify that "positive error numbers" are listed in ERRORS
|
||||
Reported-by fkater@googlemail.com
|
||||
|
||||
rexec.3
|
||||
Michael Kerrisk
|
||||
SYNOPSIS: Add header file and feature test macro requirements
|
||||
|
||||
sigpause.3
|
||||
Michael Kerrisk
|
||||
Correct discussion of when BSD vs SysV version is used in glibc
|
||||
|
||||
sin.3
|
||||
Michael Kerrisk
|
||||
errno is now correctly set to EDOM on a domain error
|
||||
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781
|
||||
was (silently) resolved.
|
||||
|
||||
tan.3
|
||||
Michael Kerrisk
|
||||
errno is now correctly set to EDOM on a domain error
|
||||
http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782
|
||||
was (silently) resolved.
|
||||
|
||||
wcscasecmp.3
|
||||
wcsncasecmp.3
|
||||
wcsnlen.3
|
||||
Michael Kerrisk
|
||||
Added VERSIONS section
|
||||
|
||||
boot.7
|
||||
Yuri Kozlov
|
||||
Update list of major Linux distributions
|
||||
|
||||
feature_test_macros.7
|
||||
Michael Kerrisk
|
||||
Make text on required placement of macros more prominent
|
||||
Move the text that notes the requirement that feature test macros
|
||||
must be defined before including any header files to the top of
|
||||
the page, and highlight the text further, so that the reader will
|
||||
not miss this point.
|
||||
|
||||
ip.7
|
||||
Jiri Olsa
|
||||
Document IP_NODEFRAG
|
||||
This option is new in Linux 2.6.36
|
||||
|
||||
pthreads.7
|
||||
signal.7
|
||||
Michael Kerrisk
|
||||
Add SEE ALSO reference to new sigevent(7) page
|
||||
|
||||
tcp.7
|
||||
Michael Kerrisk
|
||||
Clarify header file details for SIOCINQ and SIOCOUTQ
|
||||
Also note synonymous FIONREAD and TIOCOUTQ.
|
||||
|
||||
unix.7
|
||||
Michael Kerrisk
|
||||
Document SIOCINQ ioctl() operation
|
||||
|
|
|
|||
Loading…
Reference in New Issue