Gidday, The Linux man-pages maintainer proudly announces: man-pages-3.12.tar.gz - man pages for Linux This release is now available for download at: http://www.kernel.org/pub/linux/docs/man-pages or ftp://ftp.kernel.org/pub/linux/docs/man-pages The online changelog is available at http://www.kernel.org/doc/man-pages/changelog.html (blogged at http://linux-man-pages.blogspot.com/2008/10/man-pages-312-is-released.html) and the current version of the pages is browsable at http://www.kernel.org/doc/man-pages/ You are receiving this message either because: a) You contributed to the content of this release. b) You are subscribed to linux-man@xxxxxxxxxxxxxxx (*). c) I have information (possibly inaccurate) that you are the maintainer of a translation of the manual pages, or are the maintainer of the manual pages set in a particular distribution, or have expressed interest in helping with man-pages maintenance, or have otherwise expressed interest in being notified about man-pages releases. If you don't want to receive such messages from me, or you know of some other translator or maintainer who may want to receive such notifications, send me a message. Cheers, Michael (*) linux-man@xxxxxxxxxxxxxxx is the man pages discussion list. Subscribe by sending a message to majordomo@xxxxxxxxxxxxxxx, with the body: subscribe linux-man ==================== Changes in man-pages-3.12 ==================== Released: 2008-10-29, Bucaramanga Contributors ------------ The following people contributed notes, ideas, or patches that have been incorporated in changes in this release: Bert Wesarg <bert.wesarg@xxxxxxxxxxxxxx> Christian Grigis <glove@xxxxxxxxxxxxx> Christoph Hellwig <hch@xxxxxxxxxxxxx> Didier <did447@xxxxxxxxx> Halesh S <halesh.s@xxxxxxxxx> J.H.M. Dassen (Ray) <fsmla@xxxxxxxxxx> Jason Spiro <jasonspiro4@xxxxxxxxx> Lefteris Dimitroulakis <edimitro@xxxxxx> Michael B. Trausch <mike@xxxxxxxxxx> Pierre Cazenave <pwc101@xxxxxxxxxxxxxxx> Stefan Puiu <stefan.puiu@xxxxxxxxx> Apologies if I missed anyone! New and rewritten pages ----------------------- pthread_attr_init.3 Michael Kerrisk New page for pthread_attr_init(3) and pthread_attr_destroy(3) pthread_attr_setdetachstate.3 Michael Kerrisk New page for pthread_attr_setdetachstate(3) and pthread_attr_getdetachstate(3) pthread_attr_setguardsize.3 Michael Kerrisk New page for pthread_attr_setguardsize(3) and pthread_attr_getguardsize(3) pthread_attr_setscope.3 Michael Kerrisk New page for pthread_attr_setscope(3) and pthread_attr_getscope(3) pthread_attr_setstack.3 Michael Kerrisk New page for pthread_attr_setstack(3) and pthread_attr_getstack(3) pthread_attr_setstackaddr.3 Michael Kerrisk New page for pthread_attr_setstackaddr(3) and pthread_attr_getstackaddr(3) pthread_attr_setstacksize.3 Michael Kerrisk New page for pthread_attr_setstacksize(3) and pthread_attr_getstacksize(3) pthread_create.3 Michael Kerrisk New page describing pthread_create(3) pthread_detach.3 Michael Kerrisk New page for pthread_detach(3) pthread_equal.3 Michael Kerrisk New page for pthread_equal(3) pthread_exit.3 Michael Kerrisk New page describing pthread_exit(3) pthread_getattr_np.3 Michael Kerrisk New page for pthread_getattr_np(3) pthread_join.3 Michael Kerrisk New page for pthread_join(3) pthread_self.3 Michael Kerrisk New page for pthread_self(3) pthread_tryjoin_np.3 Michael Kerrisk New page for pthread_tryjoin_np(3) and pthread_timedjoin_np(3) Newly documented interfaces in existing pages --------------------------------------------- dup.2 Michael Kerrisk Add description of dup3() dup3() was added in kernel 2.6.27. epoll_create.2 Michael Kerrisk Add description of new epoll_create1() The new epoll_create1() system call appeared in Linux 2.6.27. eventfd.2 Michael Kerrisk Describe eventfd2() and EFD_NONBLOCK and EFD_CLOEXEC Linux 2.6.27 added eventfd(), which supports a flags argument that eventfd() did not provide. The flags so far implemented are EFD_NONBLOCK and EFD_CLOEXEC, inotify_init.2 Michael Kerrisk Add description of inotify_init1() The inotify_init1() system call was added in Linux 2.6.27. pipe.2 Michael Kerrisk Add description of new pipe2() syscall pipe2() was added in 2.6.27. Describe the O_NONBLOCK and O_CLOEXEC flags. signalfd.2 Michael Kerrisk Describe signalfd4() and SFD_NONBLOCK and SFD_CLOEXEC Linux 2.6.27 added signalfd4(), which supports a flags argument that signalfd() did not provide. The flags so far implemented are SFD_NONBLOCK and SFD_CLOEXEC. New and changed links --------------------- dup3.2 Michael Kerrisk New link to dup.2 dup.2 now contains the description of the new dup3() syscall. epoll_create1.2 Michael Kerrisk New link to epoll_create.2 epoll_create.2 now includes a description of the new epoll_create1() system call. eventfd2.2 Michael Kerrisk New link to eventfd.2 The eventfd.2 page has some details on the eventfd2() system call, which was new in Linux 2.6.27. inotify_init1.2 Michael Kerrisk New link to inotify_init.2 inotify_init.2 now includes a description of the new inotify_init1() system call. pipe2.2 Michael Kerrisk New link to pipe.2 pipe(2) now contains a description of the new pipe2() syscall. pthread_attr_destroy.3 Michael Kerrisk New link to new pthread_attr_init.3 pthread_attr_getdetachstate.3 Michael Kerrisk New link to new pthread_attr_setdetachstate.3 pthread_attr_getguardsize.3 Michael Kerrisk New link to new pthread_attr_setguardsize.3 pthread_attr_getscope.3 Michael Kerrisk New link to new pthread_attr_setscope.3 pthread_attr_getstack.3 Michael Kerrisk New link to new pthread_attr_setstack.3 pthread_attr_getstackaddr.3 Michael Kerrisk New link to new pthread_attr_setstackaddr.3 pthread_attr_getstacksize.3 Michael Kerrisk New link to new pthread_attr_setstacksize.3 pthread_timedjoin_np.3 Michael Kerrisk New link to new pthread_tryjoin_np.3 signalfd4.2 Michael Kerrisk New link to signalfd.2 signalfd.2 now includes text describing signalfd4() system call, new in Linux 2.6.27. Global changes -------------- eventfd.2, getdents.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strtol.3, core.5 Michael Kerrisk Add ".SS Program source" to EXAMPLE Add ".SS Program source" to clearly distinguish shell session and descriptive text from actual program code. eventfd.2, execve.2, getdents.2, ioprio_set.2, mprotect.2, signalfd.2, timerfd_create.2, wait.2, backtrace.3, clock_getcpuclockid.3, end.3, fmemopen.3, fopencookie.3, frexp.3, getdate.3, getgrouplist.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, inet.3, inet_pton.3, makecontext.3, malloc.3, matherr.3, offsetof.3, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, sem_wait.3, strftime.3, strtok.3, strtol.3, core.5, proc.5, cpuset.7, mq_overview.7 Michael Kerrisk Format user input in shell sessions in boldface frexp.3, strftime.3, strtok.3 Michael Kerrisk Relocate shell session above example program Move the shell session text that demonstrates the use of the example program so that it precedes the actual example program. This makes the page consistent with the majority of other pages. Changes to individual pages --------------------------- epoll_create.2 Michael Kerrisk Say more about unused epoll_create() 'size' arg Supply a little more explanation about why the 'size' argument of epoll_create() is nowadays ignored. eventfd.2 Michael Kerrisk Remove crufty text relating to flags argument Remove sentence saying that glibc adds a flags argument to the syscall; that was only relevant for the older eventfd() system call. getdents.2 Christoph Hellwig Fix text relating to DT_UNKNOWN and 'd_type' support Some file systems provide partial support for 'dt_type', returning DT_UNKNOWN for cases they don't support. Update the discussion of 'd_type' and DT_UNKNOWN to support this. getpeername.2, getsockname.2 Michael Kerrisk SEE ALSO: add ip(7) and unix(7) getsockopt.2 Michael Kerrisk EINVAL can also occur if 'optval' is invalid In some cases, EINVAL can occur if 'optval' is invalid. Note this, and point reader to an example in ip(7). In response to: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092 inotify_init.2, pipe.2, timerfd_create.2 Michael Kerrisk Clarify *_NONBLOCK description Make it clear that the NONBLOCK flag sets an attribute in the new open file description. sched_yield.2 Michael Kerrisk Rewrite description in terms of threads The text formerly described the operation of sched_yield() in terms of processes. It should be in terms of threads. Michael Kerrisk Add NOTES text on appropriate use of sched_yield() Strategic calls to sched_yield() can be used to improve performance, but unnecessary use should be avoided. sigaction.2 Michael Kerrisk Clarify that sa_mask affects the *per-thread* signal mask The page didn't previously clearly explain the scope of the signal mask that is affected by sa_mask. signalfd.2 Michael Kerrisk Remove crufty text relating to flags argument Remove sentence saying that glibc adds a flags argument to the syscall; that was only relevant for the older signalfd() system call. sigprocmask.2 Michael Kerrisk Clarify that sigprocmask() operates on a per-thread mask The first sentence of the page was vague on the scope of the attribute changed by sigprocmask(). Reword to make this clearer and add a sentence in NOTES to explicitly state that the signal mask is a per-thread attribute. socket.2 Michael Kerrisk Document SOCK_NONBLOCK and SOCK_CLOEXEC flags These flags, specified in the 'type' argument, are supported since Linux 2.6.27. socketpair.2 Michael Kerrisk Refer to socket(2) for SOCK_CLOEXEC and SOCK_NONBLOCK Refer the reader to socket(2) for a description of the SOCK_CLOEXEC and SOCK_NONBLOCK flags, which are supported by socketpair() since Linux 2.6.27. syscalls.2 Michael Kerrisk Add new 2.6.27 system calls Add pipe2(), dup3(), epoll_create1(), inotify_init1(), eventfd2(), signalfd4(). timerfd_create.2 Michael Kerrisk Document timerfd_create() TFD_CLOEXEC and TFD_NONBLOCK TFD_CLOEXEC and TFD_NONBLOCK are supported since LInux 2.6.27. vfork.2 Michael Kerrisk Clarify meaning of "child releases the parent's memory" The man page was not explicit about how the memory used by the child is released back to the parent. ctime.3 Michael Kerrisk ctime_r() and localtime_r() need not set 'timezone' and 'daylight' The man page already noted that these functions need not set 'tzname', but things could be clearer: it tzset() is not called, then the other two variables also are not set. Also, clarify that ctime() does set 'timezone' and 'daylight'. dlopen.3 Michael Kerrisk LD_LIBRARY_PATH is inspected once, at program start-up Make it clear that LD_LIBRARY_PATH is inspected *once*, at program start-up. (Verified from source and by experiment.) fmemopen.3 Michael Kerrisk Document binary mode (mode 'b') Glibc 2.9 adds support to fmemopen() for binary mode opens. Binary mode is specified by inclusion of the letter 'b' in the 'mode' argument. getaddrinfo.3 Michael Kerrisk Clarify error descriptions with some examples Clarify the description of some errors by giving examples that produce the errors. (Text added for EAI_SERVICE and EAI_SOCKTYPE.) Also, add an error case for EAI_BADFLAGS. gethostbyname.3 Michael Kerrisk Rationalize text on POSIX.1-2001 obsolete interfaces POSIX.1 marks gethostbyname(), gethostbyaddr(), and 'h_errno' as obsolete. The man page explained this, but with some duplication. Remove the duplication, and otherwise tidy up discussion of this point. popen.3 Michael Kerrisk Change one-line description in NAME s%process I/O%pipe stream to or from a process% Michael Kerrisk Document 'e' (close-on-exec) flag glibc 2.9 implements the 'e' flag in 'type', which sets the close-on-exec flag on the underlying file descriptor. raise.3 Michael Kerrisk SEE ALSO: add pthread_kill(3) readdir.3 Christoph Hellwig Fix text relating to DT_UNKNOWN and 'd_type' support (This mirrors the previous change to getdents.2) Some file systems provide partial support for 'dt_type', returning DT_UNKNOWN for cases they don't support. Update the discussion of 'd_type' and DT_UNKNOWN to support this. strcpy.3 Jason Spiro Strengthen warning about checking against buffer overruns http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=413940 tty_ioctl.4 Michael Kerrisk Explain capability requirements for TIOCCONS Explain capability requirements for TIOCCONS, and describe changes in 2.6.10 relating to capabilities. Michael Kerrisk Explain capability requirements for various ioctls For TIOCSLCKTRMIOS, TIOCSCTTY, TIOCEXCL, explain the exact capability that is required (the text formerly just said "root" in each case). proc.5 Michael Kerrisk Document /proc/sys/kernel/threads-max Defines the system-wide limit on the number of threads (tasks). utmp.5 Pierre Cazenave It is just "other" who should not have write perms on utmp The page was vague before, saying that utmp should not be writable by any user. This isn't true: it can be, and typically is, writable by user and group. epoll.7 Michael Kerrisk Mention epoll_create1() as part of epoll API epoll_create1() was added in Linux 2.6.27, and extends the functionality of epoll_create(). inotify.7 Michael Kerrisk Mention inotify_init1() in overview of API Discuss the new inotify_init1() system call in the overview of the inotify API. ip.7 Michael Kerrisk Detail EINVAL error for IP_ADD_MEMBERSHIP socket option In response to: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=216092 iso_8859-7.7 Lefteris Dimitroulakis Add Drachma, Euro, and Greek Ypogegrammeni Also, amend description of characters 0241 and 0242. man-pages.7 Michael Kerrisk Example shell sessions should have user input boldfaced pthreads.7 Michael Kerrisk Describe return value from pthreads functions Describe the usual success (0) and failure (non-zero) returns, and note that POSIX.1-2001 specifies that pthreads functions can never fail with the error EINTR. signal.7 Michael Kerrisk Timeouts make socket interfaces non-restartable If setsockopt() is used to set a timeout on a socket(), then the various socket interfaces are not automatically restarted, even if SA_RESTART is specified when establishing the signal handler. Analogous behavior occurs for the "stop signals" case. socket.7 Michael Kerrisk SEE ALSO: add unix(7) ld.so.8 Michael Kerrisk Document LD_USE_LOAD_BIAS Drawing heavily on Jakub Jelinek's description in http://sources.redhat.com/ml/libc-hacker/2003-11/msg00127.html (Subject: [PATCH] Support LD_USE_LOAD_BIAS) --inhibit-rpath is ignored for setuid/setgid ld.so The --inhibit-rpath option is ignored if ld.so is setuid/setgid (not if the executable is setuid/setgid). Michael Kerrisk Since glibc 2.4, setuid/setgid programs ignore LD_ORIGIN_PATH Michael Kerrisk Fix description of LD_PROFILE and LD_PROFILE_OUTPUT Clarify that LD_PROFILE is pathname or a soname, and identify name of profiling output file. Fix description of LD_PROFILE_OUTPUT, which wasn't even close to the truth. (But why did it remain unfixed for so many years?) Michael Kerrisk Since glibc 2.3.4, setuid/setgid programs ignore LD_DYNAMIC_WEAK Michael Kerrisk Since version 2.3.5, setuid/setgid programs ignore LD_SHOW_AUXV Michael Kerrisk Reorder lists of LD_* environment variables alphabetically Michael Kerrisk Since glibc 2.3.4, setuid/setgid programs ignore LD_DEBUG -- Michael Kerrisk Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/ git://git.kernel.org/pub/scm/docs/man-pages/man-pages.git man-pages online: http://www.kernel.org/doc/man-pages/online_pages.html Found a bug? http://www.kernel.org/doc/man-pages/reporting_bugs.html -- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
