From 4cc67f4b8fdf53d414fe68f8351dac1a9309a344 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sun, 15 Jan 2006 23:11:15 +0000 Subject: Ready for 2.21 --- Changes | 132 +++++++++++++++++++++++++++++------------------------ HOWTOHELP | 1 + man-pages-2.21.lsm | 4 +- 3 files changed, 76 insertions(+), 61 deletions(-) diff --git a/Changes b/Changes index 520a5b555..3074c4496 100644 --- a/Changes +++ b/Changes @@ -1,6 +1,6 @@ ==================== Changes in man-pages-2.21 ==================== -Released: 2006-??-?? +Released: 2006-01-16 Contributors ------------ @@ -9,7 +9,9 @@ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Andries Brouwer +Falk Hueffner Mike Frysinger +Senthil Kumar Stefan Puiu Apologies if I missed anyone! @@ -18,65 +20,31 @@ Apologies if I missed anyone! Global changes -------------- -dd.1 -cp.1 -truncate.2 -gethostname.2 -lseek.2 -listxattr.2 -readlink.2 -sysfs.2 -stat.2 -ustat.2 -uname.2 -getdomainname.2 -getlogin.3 -ttyname.3 -getpass.3 -getline.3 -hsearch.3 -bzero.3 -string.3 -scanf.3 -getnameinfo.3 -dlopen.3 -stpcpy.3 -sysconf.3 -readdir.3 -argz_add.3 -perror.3 -gethostbyname.3 -confstr.3 -bstring.3 -strdup.3 -printf.3 -strptime.3 -termios.3 -strftime.3 -fwide.3 -strfmon.3 -asprintf.3 -tty_ioctl.4 -dsp56k.4 -elf.5 -termcap.5 -proc.5 -charsets.7 -unix.7 +dd.1 cp.1 +truncate.2 gethostname.2 lseek.2 listxattr.2 readlink.2 +sysfs.2 stat.2 ustat.2 uname.2 getdomainname.2 +argz_add.3 asprintf.3 confstr.3 bstring.3 bzero.3 dlopen.3 fwide.3 +gethostbyname.3 getline.3 getlogin.3 getnameinfo.3 getpass.3 hsearch.3 +perror.3 printf.3 readdir.3 scanf.3 stpcpy.3 strdup.3 strfmon.3 +strftime.3 string.3 strptime.3 sysconf.3 termios.3 ttyname.3 +dsp56k.4 tty_ioctl.4 +elf.5 proc.5 termcap.5 +charsets.7 unix.7 mtk Various pages use inconsistent terms for 'null byte' (which is the C99/SUSv3 term for the '\0' character). - To rectify this the following changes were made in the above pages: + To rectify this the following changes were made in the above + pages: Replace 'zero byte' with 'null byte'. Replace 'null character' with 'null byte'. Replace 'nulls' with 'null bytes'. - Replace 'NUL-terminated' by 'null-terminated'. - Replace 'NUL' by 'null byte'. - Replace 'terminating NUL' by 'terminating null byte'. - Replace 'final NUL' by 'terminating null byte'. - Replace 'NUL character' by 'null byte'. + Replace 'NUL-terminated' by 'null-terminated'. + Replace 'NUL' by 'null byte'. + Replace 'terminating NUL' by 'terminating null byte'. + Replace 'final NUL' by 'terminating null byte'. + Replace 'NUL character' by 'null byte'. Various pages mtk @@ -86,41 +54,87 @@ Typographical or grammatical errors have been corrected in several places. +New pages +--------- + +mmap64.3 + Mike Frysinger + New link to mmap.2 + + Changes to individual pages --------------------------- +capget.2 + mtk + Noted bug that could wrongly cause EPERM in unprivileged + capset() with 'pid' field == getpid(). + epoll_ctl.2 mtk Noted that EPOLLONESHOT was added in 2.6.2. - + gethostname.2 mtk Added GLIBC NOTES describing operation of glibc's - gethostname() wrapper function. + gethostname() wrapper function. + +mmap.2 + mtk / Mike Frysinger + Clarify relationship between mmap2(2) and mmap64(3) + mtk + A few other small rewordings. + +open.2 + mtk + Added BUG noting that O_ASYNC can't be enabled via + open(): fcntl() must be used for this purpose. recv.2 Stefan Puiu Relocate misplaced discussion of MSG_DONTWAIT. +dlopen.3 + mtk + Rewrote discussion of dlopen() 'flag' argument; + added description is of RTLD_NOLOAD, RTLD_DELETE, + and RTLD_DEEPBIND. + + Noted use of atexit() to register a function that is + automatically called when a library is unloaded. + fmemopen.3 mtk Rewrote substantial parts of the page, and relicensed under GPL. +fseeko.3 + Mike Frysinger + Add RETURN VALUE section. + getopt.3 mtk Noted historical use of to declare getopt(). +qsort.3 + mtk / Falk Hueffner + Clarify how strcmp() should be used as the 'compar' + function by providing an example. + As per Debian bug 348072. + proc.5 mtk Noted that /proc/mounts is pollable since kernel 2.6.15. - Documented /proc/PID/task. + Documented /proc/PID/task. - Noted that the contents of /proc/PID/{cwd,exe,fd,root,task} - are not available if the main thread has terminated. + Noted that the contents of /proc/PID/{cwd,exe,fd,root,task} + are not available if the main thread has terminated. + + Senthil Kumar + Add pointer to random(4) for description of files under + /proc/sys/kernel/random. udp.7 Stefan Puiu / mtk Small rewording of discussion of SO_BSDCOMPAT - (add cross-ref to socket(7)). - + (add cross-ref to socket(7)). diff --git a/HOWTOHELP b/HOWTOHELP index d9a204e7a..a4a6293bf 100644 --- a/HOWTOHELP +++ b/HOWTOHELP @@ -289,6 +289,7 @@ Library Functions (See a further list of missing pages in the "undocumented(3)" manual page.) adjtime(3) +dlinfo(3) (Solaris and FreeBSD have a similar function.) dladdr1(3) dlmopen(3) (Since glibc 2.3.4; probably to be documented on dlopen.3 page) readdir_r(3) (probably as additional text in readdir.3) diff --git a/man-pages-2.21.lsm b/man-pages-2.21.lsm index 8f9277162..4eafa37e0 100644 --- a/man-pages-2.21.lsm +++ b/man-pages-2.21.lsm @@ -1,13 +1,13 @@ Begin3 Title: Section 2, 3, 4, 5 and 7 man pages for Linux Version: 2.21 -Entered-date: 2005-??-?? +Entered-date: 2005-01-16 Description: Linux and POSIX manual pages Keywords: man pages Author: several Maintained-by: Michael Kerrisk Primary-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages - ????k man-pages-2.21.tar.gz + 2521k man-pages-2.21.tar.gz Alternate-site: ftp://ftp.XX.kernel.org/pub/linux/docs/manpages Copying-policy: several; for the POSIX pages, see the file POSIX-COPYRIGHT; the other pages are all freely distributable provided -- cgit v1.2.3