==================== Changes in man-pages-3.01 ==================== Released: 2008-06-16, Konolfingen Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Alain Portal Andreas Herrmann Andrew Clayton Christoph Hellwig Daniele Giacomini Dorin Lazar Neil Horman Paul Jackson Pavel Machek Peter Zijlstra Petr Baudis Petr Gajdos Sam Varshavchik Samuel Thibault Stephane Chazelas Stuart Cunningham Tolga Dalman Yao Zhao Apologies if I missed anyone! New and rewritten pages ----------------------- acct.5 mtk A complete rewrite of this page, now with much more detail. cpuset.7 Paul Jackson, with some review and editing by mtk A description of the cpuset file system. hostname.7 mtk A description of hostname resolution. Taken from FreeBSD 6.2, and lightly edited for man-pages style. symlink.7 mtk Taken from FreeBSD 6.2, but heavily edited for Linux details, improved readability, and man-pages style. Newly documented interfaces in existing pages --------------------------------------------- getrlimit.2 mtk / Peter Zijlstra Add description of RLIMIT_RTTIME limit, new in 2.6.25. mkstemp.3 mtk Add description of mkostemp(), new in glibc 2.7. core.5 mtk, after a note by Petr Gajdos; review by Neil Horman Document core_pattern pipe syntax, which appeared in kernel 2.6.19. Add an example program demonstrating use of core_pattern pipe syntax. mtk Document /proc/PID/coredump_filter, new in kernel 2.6.23. Documentation was based on the text in Documentation/filesystems/proc.txt, plus testing, and checking the kernel source. proc.5 mtk Document /proc/PID/oom_score, which was new in kernel 2.6.11. This file displays the "badness" score of the process, which provides the basis for OOM-killer decisions. mtk Document /proc/PID/oom_adj, which was new in kernel 2.6.11. This file influences the oom_score of a process. mtk Document /proc/PID/limits, which was new in 2.6.24. This file displays a process's resource limits. mtk Document /proc/PID/fdinfo/*, which was new in 2.6.22. These files display info about each descriptor opened by the process: the current file offset, and the file access mode + file status flags as set in open() or fcntl(F_SETFL). mtk Document /proc/PID/mountinfo, which was new in 2.6.26. This file displays information about mount points. Closely based on text from Documentation/filesystems/proc.txt. mtk Document /proc/PID/mountstats, which was new in 2.6.17. This file displays statistics about mount points. mtk Document /proc/PID/status. mtk Add pointer to description of /proc/PID/cpuset in cpuset(7). New links --------- mkostemp.3 mtk Link to mkstemp.3. getcwd.2 mtk Link to getcwd.3, which describes several interfaces, among them getcwd(), which is in fact a system call. sched_setaffinity.2 sched_setscheduler.2 set_mempolicy.2 mbind.2 mtk SEE ALSO: Add cpuset(7). Global changes -------------- chown.2 faccessat.2 fchmodat.2 fchownat.2 fstatat.2 getxattr.2 link.2 linkat.2 listxattr.2 open.2 readlink.2 removexattr.2 rename.2 setxattr.2 stat.2 symlink.2 symlinkat.2 unlink.2 futimes.3 remove.3 path_resolution.7 mtk SEE ALSO: Add symlink(7). intro.1 time.1 fcntl.2 gethostbyname.3 ioctl_list.2 mtk Wrap source lines so that new sentence starts on new line. addseverity.3 backtrace.3 dlopen.3 fmtmsg.3 getnameinfo.3 getpt.3 grantpt.3 makecontext.3 ptsname.3 tcgetsid.3 unlockpt.3 wordexp.3 mtk Added VERSIONS section. io_cancel.2 io_destroy.2 io_getevents.2 io_setup.2 io_submit.2 Alain Portal / mtk Re-order ERRORS and SEE ALSO entries to be alphabetical. msgctl.2 msgget.2 semget.2 semop.2 pciconfig_read.2 basename.3 cmsg.3 ftok.3 console_ioctl.4 tzfile.5 mq_overview.7 pty.7 mtk For consistency, "fix" cases where argument of .B or .I was on the following source line. Changes to individual pages --------------------------- acct.2 mtk Add a few more words to DESCRIPTION. NOTES: Add pointer to acct(5). alarm.2 Alain Portal s/process/calling process/ so as to that the alarm signal is delivered to the calling process. brk.2 Yao Zhao / mtk Clarify discussion of return value of sbrk(). mtk DESCRIPTION: Add some sentences giving an overview of these interfaces. Add note recommending use of malloc(3). Change name of brk() argument to the simpler 'addr'. Add "(void *)" cast to "-1" for error return of sbrk(). Removed some incorrect text about "brk(0)". Note that SUSv2 specified the return value of sbrk(). Added a detail on the glibc brk() wrapper. Remove discussions of standards old (C89 and POSIX.1-1990); CONFORMING TO already discusses the situation with respect to more recent standards. chmod.2 mtk Clarify description of chmod() and fchmod(). Add further detail on S_ISUID, S_ISGID, and S_ISVTX permissions. Reformat list of permissions bits. chown.2 mtk Describe rules governing ownership of new files (bsdgroups versus sysvgroups, and the effect of the parent directory's set-group-ID permission bit). chroot.2 Alain Portal Clarify description a little. s/changes the root directory/ changes the root directory of the calling process/ execve.2 mtk Fix text that warns against use of NULL argv and envp. Using a NULL envp does in fact seem to be portable (works on Solaris and FreeBSD), but the Linux semantics for a NULL argv certainly aren't consistent with other implementations. See http://bugzilla.kernel.org/show_bug.cgi?id=8408. getdents.2 mtk, after a note from george Spelvin Document d_type field, present since kernel 2.6.4. Other minor edits. mknod.2 mtk Note that EEXIST applies, even if the pathname is a (possibly dangling) symbolic link. open.2 mtk, after a note from Christoph Hellwig NOTES: Note that access mode flags are not single bits, and document the Linuxism "access mode 3". See also http://thread.gmane.org/gmane.linux.kernel/653123. readdir.2 mtk Minor wording fixes. sched_setscheduler.2 mtk Add pointer to discussion of RLIMIT_RTTIME in getrlimit.2. mtk, after a note by Andrew Clayton Rewrote and restructured various parts of the page for greater clarity. mtk Add more detail to the rules that are applied when an unprivileged process with a non-zero RLIMIT_RTPRIO limit changes policy and priority. SEE ALSO: Add Documentation/scheduler/sched-rt-group.txt sync_file_range.2 Pavel Machek SYNC_FILE_RANGE_WRITE can block on writes greater than request queue size. For some background, see http://thread.gmane.org/gmane.linux.kernel/687713/focus=688340 syscalls.2 mtk Added system call history back to version 1.2. Fix typo on kernel version for pivot_root(). dprintf.3 mtk Note that these functions are included in the next POSIX revision. Remove editorial discussion about what the functions should have been named. getaddrinfo.3 mtk Improve description or 'hints' and 'res' arguments. Add details on numeric strings that can be specified for 'node'. Other fairly major restructrings and rewrites to improve logical structure and clarity of the page. SEE ALSO: Add hostname(7). gethostbyname.3 mtk DESCRIPTION: Add reference to inet_addr(3) for dotted notation. SEE ALSO: add inet(3). mtk Added BUGS section noting that gethostbyname() does not recognize hexadecimal components in dotted address strings; See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973 getmntent.3 mtk, after Stuart Cunningham pointed out the typo Remove statement that LSB deprecates the functions "endmntent(), setmntent() [sic] and setmntent()". This doesn't seem to be true (I can't find mention of it being deprecated in any of the LSB specs). Rather, LSB simply doesn't specify these functions. (LSB 1.3 had a spec of setmntent(), but not getmntent() or endmntent(), and noted that having a spec of setmntent() was of little use without also having a spec of getmntent().) See also https://lists.linux-foundation.org/pipermail/\ lsb-discuss/2006-October/003078.html getnameinfo.3 Tolga Dalman Remove mention of sa_len field from example code. That field is a BSDism not present on Linux. mtk Various minor changes. inet.3 mtk / Stephane Chazelas inet_aton() is *not* in POSIX.1. Rewrite discussion of why inet_addr() is disfavored. SEE ALSO: Add getaddrinfo(3). as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482979. mtk, after a note by Stephane Chazelas Describe the various address forms supported by inet_aton(). mtk Rewrite description of inet_network(). Clarify discussion of inet_lnaof(), inet_netof(), and inet_makeaddr(). Add discussion of Classful Addressing, noting that it is obsolete. Added an EXAMPLE program. mtk Relocate discussion of i386 byte order to NOTES. Note that inet_aton() returns an address in network byte order. SEE ALSO: Add byteorder(3) and getnameinfo(3). inet_ntop.3 mtk Remove unneeded header files from SYNOPSIS. SEE ALSO: Add inet(3) and getnameinfo(3). Make NAME line more precise. Move errors to an ERRORS section. Add EXAMPLE section pointing to inet_pton(3). inet_pton.3 mtk / Stephane Chazelas Remove statement that inet_pton() extends inet_ntoa(); that's not really true, since inet_pton() doesn't support all of the string forms that are supported by inet_ntoa(). SEE ALSO: Add getaddrinfo(3). as per http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482987. mtk Describe IPv6 address formats. Describe dotted decimal format in more detail. Add an example program. mtk Remove unneeded header files from SYNOPSIS. Make NAME line more precise. Make description of return value more precise. SEE ALSO: Add inet(3). io_getevents.2 Alain Portal Small wording fix. mkfifo.3 mtk Note that EEXIST applies, even if the pathname is a (possibly dangling) symbolic link. mkstemp.3 mtk Fix discussion of O_EXCL flag. These functions may also fail for any of the errors described in open(2). Various other rewordings. readdir.3 mtk Document DT_LNK (symbolic link) for d_type field. Reorder DT_ entries alphabetically. remainder.3 mtk Recommend against drem(), in favor of remainder(). strcat.3 Andreas Herrmann s/strcat/strncat/ (a typo that changed the semantics in DESCRIPTION). strerror.3 mtk, after a note from Daniele Giacomini Modify SYNOPSIS to show protoypes of both versions of strerror_r(), and make other small clarifications of the description regarding the two versions. locale.5 Petr Baudis LC_TIME: Describe first_weekday and first_workday. man-pages.7 mtk Enhanced description of VERSIONS section. mq_overview.7 mtk Note that Linux does not currently support ACLs for POSIX message queues. sem_overview.7 mtk Note that Linux supports ACLs on POSIX named semaphores since 2.6.19. unix.7 mtk, after a note by Samuel Thibault Provide a clear description of the three types of address that can appear in the sockaddr_un structure: pathname, unnamed, and abstract.