diff -Nru manpages-3.52/Changes manpages-3.54/Changes --- manpages-3.52/Changes 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/Changes 2013-09-17 08:27:55.000000000 +0200 @@ -1,6 +1,6 @@ -==================== Changes in man-pages-3.52 ==================== +==================== Changes in man-pages-3.54 ==================== -Released: 2013-07-04, Munich +Released: 2013-09-17, Munich Contributors @@ -10,55 +10,57 @@ in the changelog below) reports, notes, and ideas that have been incorporated in changes in this release: -Adrian Bunk -Andrea Remondini -Anthony Foiani -Brian Norris -Cyril Hrubis -Dan Jacobson +A. Costa +Akihiro MOTOKI +Andreas Wiese +Andrew Hunter +Chen Gang +Christopher Hall +Christos Tsopokis David Prévot -Eric S. Raymond -Georg Sauthoff -Jeff Moyer -Jérémie Galarneau +D. Barbier +Doug Goldstein +Elie De Brauwer +Eugen Dedu +Felix Janda +G.raud +Hannes Landeholm +J. Bruce Fields +J. Bruce Fields +Johan Erlandsson Jon Grant -Manuel Traut -Марк Коренберг +Magnus Reftel +Marko Myllynen Michael Kerrisk -Mike Frysinger -Pavel Emelyanov +Oleg Nesterov Peng Haitao -Peter LaDow -Petr Gajdos -Regid -Siddhesh Poyarekar -Simone Piccardi +Peter Schiffer +Robert Harris +Rodrigo Campos Simon Paillard +Stas Vince Weaver -Yuri Kozlov +Will Newton +Zdenek Pavlas +Zsbán Ambrus Apologies if I missed anyone! + Newly documented interfaces in existing pages --------------------------------------------- -perf_event_open.2 - Vince Weaver - Add PERF_IOC_FLAG_GROUP documentation - The perf_event_open() ENABLE/DISABLE/RESET ioctls can take an - argument, PERF_IOC_FLAG_GROUP. This wasn't documented at all - until about a year ago (despite the support being there from - the beginning) so I missed this when initially writing - the man page. - -socket.7 - Pavel Emelyanov, Michael Kerrisk - Document SO_PEEK_OFF option - Since Linux 3.4 there appeared an ability to specify the - offset in bytes from which the data will be MSG_PEEK-ed. - Describe this socket option in the socket(7) page, where - all the other socket options are described. +ioctl_list.2 + Zsbán Ambrus + Document FAT_IOCTL_GET_ATTRIBUTES + The attached patch adds four ioctls from linux/msdos_fs.h to the + ioctl_list(2) manpage. + + The ioctl FAT_IOCTL_GET_ATTRIBUTES reads FAT attributes of a + file a mounted vfat file system. I tested this on Linux + 2.6.33, an example script can be found at + http://www.perlmonks.com/?node_id=832623 Global changes @@ -66,572 +68,323 @@ Various pages Michael Kerrisk - Convert inline formatting (\fX...\fP) to dot-directive formatting - -readdir.2 -asprintf. -getline.3 -getlogin.3 -pthread_setname_np.3 -readdir.3 -strerror.3 - Michael Kerrisk [Jon Grant] - Clarify that terminating null byte is '\0' + Global fix: s/file system/filesystem/ + Notwithstanding 24d01c530c5a3f75217543d02bf6712395e5f90c, + "filesystem" is the form used by the great majority of man pages + outside the man-pages project and in a number of other sources, + so let's go with that. Changes to individual pages --------------------------- -execve.2 - Peter LaDow - Add envp to the Linux notes about NULL pointers - During the review of static analysis results, we discovered a - functional, but non-portable, use of execve(). For example: - - char *cmd[] = { "/path/to/some/file", NULL }; - execve(cmd[0], cmd, NULL); - - The call succeeds. Yet, the static analysis tool (rightly) - pointed out that envp could be dereferenced. But digging into - glibc and the kernel, it appears that like argv, envp when NULL - is treated as if it were an empty list. - - So, to clear things up, I'm submitting this patch to update the - man page to indicate that envp is treated like argv. - -fallocate.2 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -io_setup.2 - Cyril Hrubis [Jeff Moyer] - Clarify the nr_events parameter - Currently the io_setup.2 man page describes what the kernel really - does, i.e., that the resulting context may be able to hold more - than the 'nr_event's operations because the memory allocated in - kernel is rounded to be multiple of page size. - - It is better not to expose this implementation detail and - simply state that the resulting context is suitable for - 'nr_events' operations. +access.2 + J. Bruce Fields + Fix outdated NFS information + Note that NFS versions since version 3 support an "access" call + so that the client doesn't have to guess permissions or ID + mapping on its own. -perf_event_open.2 - Vince Weaver - Clarify the perf_event_open() wakeup_events/wakeup_watermark fields - Clarify the perf_event_open() wakeup_events/wakeup_watermark - fields a bit, based on info from kernel commit cfeb1d90a1b1. - Vince Weaver - Update to match the Linux 3.10 release - This patch updates the perf_event_open() documentation to include - new interfaces added in the 3.10 kernel. + (See RFC 1813 sections 1.7 and 3.3.4.) - It also documents a few [To be documented] instances left over - from the 3.7 kernel. - Vince Weaver - Small correction to description of 'flags' argument - -prctl.2 +adjtimex.2 Michael Kerrisk - Note equivalents of PR_SET_NAME - pthread_setname_np() and pthread_getname_np() and - /proc/self/task/TID/comm provide access to the same - attribute. - -pread.2 - Michael Kerrisk [Марк Коренберг] - pread() and pwrite() are especially useful in multithreaded applications + SEE ALSO: Add adjtimex(8) -recv.2 +clock_getres.2 + Michael Kerrisk [Rodrigo Campos] + Note circumstances in which "SMP" note applies. Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -semctl.2 - Michael Kerrisk [Simone Piccardi] - 'sem_nsems' is 'unsigned long' since Linux 2.4 - -shmget.2 - Michael Kerrisk - Rewrite RETURN VALUE and mention that 'errno' is set on error - -sigaction.2 - Michael Kerrisk [Brian Norris] - RETURN VALUE: mention that 'errno' is set on error - -signal.2 + Add kernel version for CLOCK_*_CPUTIME_ID + CLOCK_PROCESS_CPUTIME_ID and CLOCK_THREAD_CPUTIME_ID + appeared in 2.6.12. Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Add VERSIONS section -sigpending.2 +futex.2 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + The 'timeout' can be rounded upwards by clock granularity and also overrun -sigprocmask.2 +kill.2 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Small improvements to text on historical rules for permissions -sigsuspend.2 +nfsservctl.2 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Note commands that were only in Linux 2.4.x and earlier -syscall.2 - Mike Frysinger - Document s390/s390x calling convention +open.2 + Robert Harris + Add mmap(2) to list of calls that fail when given an O_PATH descriptor + Doug Goldstein + Add EINVAL to errors list + EINVAL can be returned by open(2) when the underlying filesystem + doesn't support O_DIRECT. It is documented in the NOTES section + but this patch adds it to the list of possible errors. -a64l.3 - Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function l64a() is not thread safe. - -abs.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions abs(), labs(), llabs() and imaxabs() are - thread-safe. - -aio_error.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function aio_error() is thread safe. - -aio_return.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function aio_return() is thread safe. - -alloca.3 - Adrian Bunk - Correct information on getting non-inlined version with gcc+glibc - - remove the incorrect information that -fno-builtin would help - - add -std=c11 to the list of strict options - - emphasize more that both the gcc option and not including - alloca.h are needed - - add the #ifdef from the glibc alloca.h to make the situation - clearer - -bindresvport.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - Before glibc 2.17, bindresvport() is not thread-safe. - Since glibc 2.17, it is thread-safe, the patch can refer to URL: - http://sourceware.org/git/?p=glibc.git;a=commit;h=f6da27e53695ad1cc0e2a9490358decbbfdff5e5 +perf_event_open.2 + Vince Weaver + PERF_SAMPLE_BRANCH_STACK updates + This started out as just adding the new perf_event_open features + from Linux 3.11 (which was the addition of transactional memory + defines for PERF_SAMPLE_BRANCH_STACK samples) but turned into a + general cleanup of the PERF_SAMPLE_BRANCH_STACK documentation. -canonicalize_file_name.3 + The main clarification is that at least one of the non-privilege + values must be set or else perf_event_open() will return an EINVAL + error. Michael Kerrisk - Put CONFORMING TO section in right location - -catgets.3 - Michael Kerrisk [Jon Grant] - Clarify that null byte is '\0' - -ceil.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions ceil(), ceilf() and ceill() are thread safe. - -cimag.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions cimag(), cimagf() and cimagl() are thread safe. - -clock_getcpuclockid.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - The function clock_getcpuclockid() is thread safe. + Reorder text describing fields of 'perf_event_header' structure + Place the fields with the shorter descriptions first, to make the + information easier to read. -conj.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions conj(), conjf() and conjl() are thread safe. - -crypt.3 - Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function crypt() is not thread safe. - -ctermid.3 - Peng Haitao - ATTRIBUTES: Note function that is thread safe with exceptions - The function ctermid() is thread safe with exceptions. - -dirfd.3 +poll.2 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -drand48.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions drand48(), erand48(), lrand48(), nrand48(), - mrand48(), jrand48(), srand48(), seed48() and lcong48() are - not thread safe. - -ecvt.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions ecvt() and fcvt() return a string located in a - static buffer which is overwritten by the next call to the - functions, so they are not thread-safe. + Clarify wording of 'timeout' as a "minimum" interval -encrypt.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions encrypt() and setkey() are not thread safe. - -ether_aton.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions ether_aton() and ether_ntoa() are not thread safe. +sched_setaffinity.2 + Michael Kerrisk [Christos Tsopokis] + Clarify that these system calls affect a per-thread attribute -fcloseall.3 - Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function fcloseall() is not thread safe. - -ferror.3 - Peng Haitao - ATTRIBUTES: Note functions that are thread-safe - The functions ferror(), clearerr(), feof() and fileno() are - thread safe. - -fgetgrent.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -fgetpwent.3 +sched_setparam.2 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Clarify that this system call applies to threads (not processes) -fgetwc.3 +sched_setscheduler.2 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Clarify that this system call applies to threads (not processes) -fmtmsg.3 - Peng Haitao - ATTRIBUTES: Note function that is thread-safe - Before glibc 2.16, fmtmsg() is not thread-safe. - Since glibc 2.16, it is thread-safe, the patch can refer to URL: - http://sourceware.org/git/?p=glibc.git;a=commit;h=7724defcf8873116fe4efab256596861eef21a94 +select.2 + Michael Kerrisk [G.raud] + Clarify wording of 'timeout' as a "minimum" interval -fputwc.3 +setfsgid.2 + Michael Kerrisk [Oleg Nesterov] + Clarify description of return value + More clearly describe the weirdness in the return value of this + system call, and note the problems it creates in in BUGS Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -getdate.3 - Peng Haitao - ATTRIBUTES: Note functions that are and aren't thread-safe - -getgrent.3 - Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function getgrent() is not thread safe. - -getgrnam.3 - Peng Haitao - ATTRIBUTES: Note functions that are and aren't thread-safe - -getline.3 + Correct header file in SYNOPSIS Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -getlogin.3 - Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function getlogin() is not thread safe. - The function cuserid() is thread-safe with exceptions. + Refer to setfsuid(2) for an explanation of why setfsgid() is obsolete Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Wording improvements -getpass.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - -getpwent.3 - Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function getpwent() is not thread safe. - -getpwnam.3 - Peng Haitao - ATTRIBUTES: Note functions that are and aren't thread-safe - -getspnam.3 +setfsuid.2 + Michael Kerrisk [Oleg Nesterov] + Clarify description of return value + More clearly describe the weirdness in the return value of this + system call, and ote the problems it creates in in BUGS + Michael Kerrisk [Chen Gang] + Clarify historical details and note that setfsuid() is obsolete Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -getttyent.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - -getusershell.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions getusershell(), setusershell() and endusershell() - are not thread safe. - -getutent.3 + Wording improvements Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Correct header file in SYNOPSIS -hsearch.3 +sigwaitinfo.2 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Clarify wording of 'timeout' as a "minimum" interval -hsearch.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions hsearch(), hcreate() and hdestroy() are not - thread-safe. - -localeconv.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The function localeconv() returns a pointer to a structure which - might be overwritten by subsequent calls to localeconv() or by - calls to setlocale(), so it is not thread-safe. - Peng Haitao - Add RETURN VALUE section +syscall.2 + Johan Erlandsson + Add missing argument in example + Johan Erlandsson + Correct registers for arm/EABI + Registers was off by one. + + Reference: + http://www.arm.linux.org.uk/developer/patches/viewpatch.php?id=3105/4 + + See also: + http://peterdn.com/post/e28098Hello-World!e28099-in-ARM-assembly.aspx + https://wiki.debian.org/ArmEabiPort + http://en.wikipedia.org/wiki/Calling_convention#ARM + +wait.2 + Michael Kerrisk [Hannes Landeholm] + Add details on the fifth argument provided by raw waitid() system call + See https://bugzilla.kernel.org/show_bug.cgi?id=60744 -malloc_info.3 +clock.3 Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + clock() switched from using times(2) to clock_gettime() in glibc 2.18 -mblen.3 +drand48_r.3 Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function mblen() is not thread safe. + ATTRIBUTES: Note functions that are thread-safe + The functions drand48_r(), erand48_r(), lrand48_r(), + nrand48_r(), mrand48_r(), jrand48_r(), srand48_r(), seed48_r(), + and lcong48_r() are thread safe. -mbrlen.3 +fma.3 Peng Haitao - ATTRIBUTES: Note function that is thread safe with exceptions - The function mbrlen() is thread safe with exceptions. + ATTRIBUTES: Note functions that are thread-safe + The functions fma(), fmaf() and fmal() are thread safe. -mbrtowc.3 +fmax.3 Peng Haitao - ATTRIBUTES: Note function that is thread safe with exceptions - The function mbrtowc() is thread safe with exceptions. - -mktemp.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + ATTRIBUTES: Note functions that are thread-safe + The functions fmax(), fmaxf() and fmaxl() are thread safe. -modf.3 +fmin.3 Peng Haitao ATTRIBUTES: Note functions that are thread-safe - The functions modf(), modff() and modfl() are thread safe. - -popen.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -pthread_attr_setinheritsched.3 - Michael Kerrisk - Note the scheduling attributes affected by this function + The functions fmin(), fminf() and fminl() are thread safe. -pthread_attr_setschedparam.3 -pthread_attr_setschedpolicy.3 -pthread_attr_setscope.3 - Michael Kerrisk [Manuel Traut, Siddhesh Poyarekar] - The inherit-scheduler attribute must be set to PTHREAD_EXPLICIT_SCHED - In order for the attributes set by these functions to have - an effect, the caller must use pthread_attr_setinheritsched(3) - to set the inherit-scheduler attribute of the attributes object - to PTHREAD_EXPLICIT_SCHED. - -ptsname.3 +fpclassify.3 Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function ptsname() is not thread safe. - -putenv.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -putpwent.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + ATTRIBUTES: Note functions that are thread-safe + The functions fpclassify(), isfinite(), isnormal(), isnan(), and + isinf() are thread safe. -qecvt.3 +frexp.3 Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions qecvt() and qfcvt() are not thread-safe. + ATTRIBUTES: Note functions that are thread-safe + The functions frexp(), frexpf() and frexpl() are thread safe. -random.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - Michael Kerrisk - Add EINVAL error for setstate() +gethostbyname.3 + Michael Kerrisk [Jon Grant] + gai_strerror() is the modern replacement for herror() and hstrerror() Michael Kerrisk - BUGS: inistate() does not return NULL on error - http://sourceware.org/bugzilla/show_bug.cgi?id=15380 - -random_r.3 + Update feature test macro requirements for herror() and hstrerror() Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + Add feature test macro requirements for h_errno -readdir.3 +ilogb.3 Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The data returned by readdir() may be overwritten by subsequent - calls to readdir() for the same directory stream, so it is not - thread-safe. - -re_comp.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions re_comp() and re_exec() are not thread safe. - -rexec.3 - Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions rexec() and rexec_af() are not thread safe. + ATTRIBUTES: Note functions that are thread-safe + The functions ilogb(), ilogbf() and ilogbl() are thread safe. -round.3 +ldexp.3 Peng Haitao ATTRIBUTES: Note functions that are thread-safe - The functions round(), roundf() and roundl() are thread safe. + The functions ldexp(), ldexpf() and ldexpl() are thread safe. -scalbln.3 +lrint.3 Peng Haitao ATTRIBUTES: Note functions that are thread-safe - The functions scalbn(), scalbnf(), scalbnl(), scalbln(), - scalblnf() and scalblnl() are thread safe. - -scandir.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error - -siginterrupt.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + The functions lrint(), lrintf(), lrintl(), llrint(), llrintf(), + and llrintl() are thread safe. -signbit.3 +lround.3 Peng Haitao - ATTRIBUTES: Note macro that is thread-safe - The macro signbit() is thread safe. - -sigsetops.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + ATTRIBUTES: Note functions that are thread-safe + The functions lround(), lroundf(), lroundl(), llround(), + llroundf() and llroundl() are thread safe. -stdio_ext.3 +lseek64.3 Peng Haitao - ATTRIBUTES: Note functions that are not thread-safe - The functions __fbufsize(), __fpending(), __fpurge() and - __fsetlocking() are not thread safe. - -strdup.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + ATTRIBUTES: Note function that is thread-safe + The function lseek64() is thread safe. -strerror.3 +mbsinit.3 Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function strerror() is not thread safe. - -strftime.3 - Michael Kerrisk - Clarify details of return value - Michael Kerrisk - BUGS: 'errno' is not set if the result string would exceed 'max' bytes + ATTRIBUTES: Note function that is thread-safe + The function mbsinit() is thread safe. -strtok.3 +nextafter.3 Peng Haitao - ATTRIBUTES: Note function that is not thread-safe - The function strtok() is not thread safe. - Michael Kerrisk [Georg Sauthoff] - Add more detail on the operation of strtok() - Add a number of missing details on the operation of strtok() - -tempnam.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error + ATTRIBUTES: Note functions that are thread-safe + The functions nextafter(), nextafterf(), nextafterl(), + nexttoward(), nexttowardf() and nexttowardl() are thread safe. -timegm.3 - Jérémie Galarneau - copy the string returned by getenv() - The example of a portable version of timegm() uses the string - returned by getenv() after calling setenv() on the same - environment variable. The tz string may be invalid as per - getenv.3: +posix_memalign.3 + Michael Kerrisk [Will Newton] + 'errno" is indeterminate after a call to posix_memalign() + Michael Kerrisk [Will Newton] + Clarify wording on "return value" when size==0 + +printf.3 + Christopher Hall + Correctly describe the meaning of a negative precision + The printf(3) manpage says that a negative precision is taken to + be zero, whereas printf(3p) says that a negative precision is + taken as if the precision were omitted. glibc agrees with the + latter (POSIX) specification. + + Test code: + + printf("%f\n",42.0); // "42.000000" + printf("%.*f\n",0,42.0); // "42" + printf("%.*f\n",-1,42.0); // "42.000000" - "The string pointed to by the return value of getenv() - may be statically allocated, and can be modified by a - subsequent call to getenv(), putenv(3), setenv(3), or - unsetenv(3)." + This patch corrects the explanation to match what actually happens. -tmpnam.3 +rewinddir.3 Peng Haitao - ATTRIBUTES: Note function that is thread safe with exceptions - The function tmpnam() is thread safe with exceptions. + ATTRIBUTES: Note function that is thread-safe + The function rewinddir() is thread safe. -trunc.3 +rint.3 Peng Haitao ATTRIBUTES: Note functions that are thread-safe - The functions trunc(), truncf() and truncl() are thread safe. + The functions nearbyint(), nearbyintf(), nearbyintl(), rint(), + rintf() and rintl() are thread safe. -ttyname.3 - Michael Kerrisk - ATTRIBUTES: Note functions that are and aren't thread-safe - -ttyslot.3 - Michael Kerrisk - ATTRIBUTES: Note functions that are not thread-safe +seekdir.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function seekdir() is thread safe. -usleep.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error +telldir.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function telldir() is thread safe. -wcsdup.3 - Michael Kerrisk - RETURN VALUE: mention that 'errno' is set on error +wctomb.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function wctomb() is not thread safe. -core.5 - Michael Kerrisk - Implicitly adding the PID to a core filename was dropped in 2.6.27 +wavelan.4 + Michael Kerrisk [Elie De Brauwer] + This driver disappeared in 2.56.35 + +dir_colors.5 + Michael Kerrisk [Stas] + Add various synonyms + See http://bugs.debian.org/553477 + Simon Paillard [Stas] + Add keywords SUID, SGID, STICKY, STICKY_OTHER_WRITABLE, OTHER_WRITABLE + See http://bugs.debian.org/553477 + See ls.c and dircolors.c in coreutils proc.5 + Peter Schiffer + Document /proc/[pid]/io file + Attempt to document fields in the /proc/[pid]/io file, based on + the Documentation/filesystems/proc.txt. The text will probably + need some grammar corrections. + Michael Kerrisk [Marko Myllynen] + /proc/sys/fs/inode-max went away in Linux 2.4 + Also, the 'preshrink' field in /proc/sys/fs/inode-state became + a dummy value in Linux 2.4. + + See https://bugzilla.kernel.org/show_bug.cgi?id=60836 + Michael Kerrisk [A. Costa] + Note block size used by /proc/partitions + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=666972 Michael Kerrisk - Document /proc/[pid]/fd/ anon_inode symlinks - Mike Frysinger - Document /proc/[pid]/fd/ symlinks a bit more - Describe the type:[inode] syntax used in this dir + Add rationale on drop_caches and note that it can hurt performance + See also http://lwn.net/Articles/562211/ bootparam.7 - Michael Kerrisk [Dan Jacobson] - Remove outdated text on LILO and LoadLin - Strike the discussion of LILO and LoadLin, which - are long obsolete, and make a brief mention of GRUB. - See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604019 - Regid - Remove mention of the deprecated rdev(8) - The deprecated rdev(8) command was removed from util-linux in 2010. - See https://git.kernel.org/?p=utils/util-linux/util-linux.git;a=commit;h=a3e40c14651fccf18e7954f081e601389baefe3fO - Andrea Remondini - Document the 'resume' boot parameter + Michael Kerrisk [Eugen Dedu] + Remove "lilo" entries from SEE ALSO + See http://bugs.debian.org/604019 inotify.7 - Michael Kerrisk [Jon Grant] - Clarify that null byte is '\0' - -iso_8859-2.7 - Eric S. Raymond - Remove incorrect reference to nonexistent groff glyph \[shc] - The reference incorrectly attempted to duplicate an - actual soft hyphen (hex 0xad) just before it in the file. - -man-pages.7 - Peng Haitao - Add description of "ATTRIBUTES" - "ATTRIBUTES" section can mention thread safety, - cancellation safety, and async-cancel-safety. - -socket.7 Michael Kerrisk - Note that 'optval' for socket options is an 'int' in most cases + SEE ALSO: add inotifywait(1) and inotifywatch(1) -tcp.7 - Michael Kerrisk - Note that 'optval' for socket options is an 'int' in most cases +ip.7 + Simon Paillard + IP_MULTICAST_IF setsockopt recognizes struct mreq (compatibility) + Kernel added compatibility only recently in + 3a084ddb4bf299a6e898a9a07c89f3917f0713f7 + See: http://bugs.debian.org/607979 -udp.7 +standards.7 Michael Kerrisk - Note that 'optval' for socket options is an 'int' in most cases + Add mention of SUSv4-TC1 (POSIX.1-2013) diff -Nru manpages-3.52/Changes.old manpages-3.54/Changes.old --- manpages-3.52/Changes.old 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/Changes.old 2013-09-17 08:27:55.000000000 +0200 @@ -26656,3 +26656,860 @@ the actual letter µ instead of an ASCII approximation. See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=704787 + + +==================== Changes in man-pages-3.52 ==================== + +Released: 2013-07-04, Christchurch + + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes, and ideas that have been +incorporated in changes in this release: + +Adrian Bunk +Andrea Remondini +Anthony Foiani +Brian Norris +Cyril Hrubis +Dan Jacobson +David Prévot +Eric S. Raymond +Georg Sauthoff +Jeff Moyer +Jérémie Galarneau +Jon Grant +Manuel Traut +Марк Коренберг +Michael Kerrisk +Mike Frysinger +Pavel Emelyanov +Peng Haitao +Peter LaDow +Petr Gajdos +Regid +Siddhesh Poyarekar +Simone Piccardi +Simon Paillard +Vince Weaver +Yuri Kozlov + +Apologies if I missed anyone! + + +Newly documented interfaces in existing pages +--------------------------------------------- + +perf_event_open.2 + Vince Weaver + Add PERF_IOC_FLAG_GROUP documentation + The perf_event_open() ENABLE/DISABLE/RESET ioctls can take an + argument, PERF_IOC_FLAG_GROUP. This wasn't documented at all + until about a year ago (despite the support being there from + the beginning) so I missed this when initially writing + the man page. + +socket.7 + Pavel Emelyanov, Michael Kerrisk + Document SO_PEEK_OFF option + Since Linux 3.4 there appeared an ability to specify the + offset in bytes from which the data will be MSG_PEEK-ed. + Describe this socket option in the socket(7) page, where + all the other socket options are described. + + +Global changes +-------------- + +Various pages + Michael Kerrisk + Convert inline formatting (\fX...\fP) to dot-directive formatting + +readdir.2 +asprintf. +getline.3 +getlogin.3 +pthread_setname_np.3 +readdir.3 +strerror.3 + Michael Kerrisk [Jon Grant] + Clarify that terminating null byte is '\0' + + +Changes to individual pages +--------------------------- + +execve.2 + Peter LaDow + Add envp to the Linux notes about NULL pointers + During the review of static analysis results, we discovered a + functional, but non-portable, use of execve(). For example: + + char *cmd[] = { "/path/to/some/file", NULL }; + execve(cmd[0], cmd, NULL); + + The call succeeds. Yet, the static analysis tool (rightly) + pointed out that envp could be dereferenced. But digging into + glibc and the kernel, it appears that like argv, envp when NULL + is treated as if it were an empty list. + + So, to clear things up, I'm submitting this patch to update the + man page to indicate that envp is treated like argv. + +fallocate.2 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +io_setup.2 + Cyril Hrubis [Jeff Moyer] + Clarify the nr_events parameter + Currently the io_setup.2 man page describes what the kernel really + does, i.e., that the resulting context may be able to hold more + than the 'nr_event's operations because the memory allocated in + kernel is rounded to be multiple of page size. + + It is better not to expose this implementation detail and + simply state that the resulting context is suitable for + 'nr_events' operations. + +perf_event_open.2 + Vince Weaver + Clarify the perf_event_open() wakeup_events/wakeup_watermark fields + Clarify the perf_event_open() wakeup_events/wakeup_watermark + fields a bit, based on info from kernel commit cfeb1d90a1b1. + Vince Weaver + Update to match the Linux 3.10 release + This patch updates the perf_event_open() documentation to include + new interfaces added in the 3.10 kernel. + + It also documents a few [To be documented] instances left over + from the 3.7 kernel. + Vince Weaver + Small correction to description of 'flags' argument + +prctl.2 + Michael Kerrisk + Note equivalents of PR_SET_NAME + pthread_setname_np() and pthread_getname_np() and + /proc/self/task/TID/comm provide access to the same + attribute. + +pread.2 + Michael Kerrisk [Марк Коренберг] + pread() and pwrite() are especially useful in multithreaded applications + +recv.2 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +semctl.2 + Michael Kerrisk [Simone Piccardi] + 'sem_nsems' is 'unsigned long' since Linux 2.4 + +shmget.2 + Michael Kerrisk + Rewrite RETURN VALUE and mention that 'errno' is set on error + +sigaction.2 + Michael Kerrisk [Brian Norris] + RETURN VALUE: mention that 'errno' is set on error + +signal.2 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +sigpending.2 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +sigprocmask.2 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +sigsuspend.2 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +syscall.2 + Mike Frysinger + Document s390/s390x calling convention + +a64l.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function l64a() is not thread safe. + +abs.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions abs(), labs(), llabs() and imaxabs() are + thread-safe. + +aio_error.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function aio_error() is thread safe. + +aio_return.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function aio_return() is thread safe. + +alloca.3 + Adrian Bunk + Correct information on getting non-inlined version with gcc+glibc + - remove the incorrect information that -fno-builtin would help + - add -std=c11 to the list of strict options + - emphasize more that both the gcc option and not including + alloca.h are needed + - add the #ifdef from the glibc alloca.h to make the situation + clearer + +bindresvport.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + Before glibc 2.17, bindresvport() is not thread-safe. + Since glibc 2.17, it is thread-safe, the patch can refer to URL: + http://sourceware.org/git/?p=glibc.git;a=commit;h=f6da27e53695ad1cc0e2a9490358decbbfdff5e5 + +canonicalize_file_name.3 + Michael Kerrisk + Put CONFORMING TO section in right location + +catgets.3 + Michael Kerrisk [Jon Grant] + Clarify that null byte is '\0' + +ceil.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions ceil(), ceilf() and ceill() are thread safe. + +cimag.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions cimag(), cimagf() and cimagl() are thread safe. + +clock_getcpuclockid.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function clock_getcpuclockid() is thread safe. + +conj.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions conj(), conjf() and conjl() are thread safe. + +crypt.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function crypt() is not thread safe. + +ctermid.3 + Peng Haitao + ATTRIBUTES: Note function that is thread safe with exceptions + The function ctermid() is thread safe with exceptions. + +dirfd.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +drand48.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions drand48(), erand48(), lrand48(), nrand48(), + mrand48(), jrand48(), srand48(), seed48() and lcong48() are + not thread safe. + +ecvt.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions ecvt() and fcvt() return a string located in a + static buffer which is overwritten by the next call to the + functions, so they are not thread-safe. + +encrypt.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions encrypt() and setkey() are not thread safe. + +ether_aton.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions ether_aton() and ether_ntoa() are not thread safe. + +fcloseall.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function fcloseall() is not thread safe. + +ferror.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions ferror(), clearerr(), feof() and fileno() are + thread safe. + +fgetgrent.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +fgetpwent.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +fgetwc.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +fmtmsg.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + Before glibc 2.16, fmtmsg() is not thread-safe. + Since glibc 2.16, it is thread-safe, the patch can refer to URL: + http://sourceware.org/git/?p=glibc.git;a=commit;h=7724defcf8873116fe4efab256596861eef21a94 + +fputwc.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +getdate.3 + Peng Haitao + ATTRIBUTES: Note functions that are and aren't thread-safe + +getgrent.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function getgrent() is not thread safe. + +getgrnam.3 + Peng Haitao + ATTRIBUTES: Note functions that are and aren't thread-safe + +getline.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +getlogin.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function getlogin() is not thread safe. + The function cuserid() is thread-safe with exceptions. + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +getpass.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + +getpwent.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function getpwent() is not thread safe. + +getpwnam.3 + Peng Haitao + ATTRIBUTES: Note functions that are and aren't thread-safe + +getspnam.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +getttyent.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + +getusershell.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions getusershell(), setusershell() and endusershell() + are not thread safe. + +getutent.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +hsearch.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +hsearch.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions hsearch(), hcreate() and hdestroy() are not + thread-safe. + +localeconv.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The function localeconv() returns a pointer to a structure which + might be overwritten by subsequent calls to localeconv() or by + calls to setlocale(), so it is not thread-safe. + Peng Haitao + Add RETURN VALUE section + +malloc_info.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +mblen.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function mblen() is not thread safe. + +mbrlen.3 + Peng Haitao + ATTRIBUTES: Note function that is thread safe with exceptions + The function mbrlen() is thread safe with exceptions. + +mbrtowc.3 + Peng Haitao + ATTRIBUTES: Note function that is thread safe with exceptions + The function mbrtowc() is thread safe with exceptions. + +mktemp.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +modf.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions modf(), modff() and modfl() are thread safe. + +popen.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +pthread_attr_setinheritsched.3 + Michael Kerrisk + Note the scheduling attributes affected by this function + +pthread_attr_setschedparam.3 +pthread_attr_setschedpolicy.3 +pthread_attr_setscope.3 + Michael Kerrisk [Manuel Traut, Siddhesh Poyarekar] + The inherit-scheduler attribute must be set to PTHREAD_EXPLICIT_SCHED + In order for the attributes set by these functions to have + an effect, the caller must use pthread_attr_setinheritsched(3) + to set the inherit-scheduler attribute of the attributes object + to PTHREAD_EXPLICIT_SCHED. + +ptsname.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function ptsname() is not thread safe. + +putenv.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +putpwent.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +qecvt.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions qecvt() and qfcvt() are not thread-safe. + +random.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + Michael Kerrisk + Add EINVAL error for setstate() + Michael Kerrisk + BUGS: inistate() does not return NULL on error + http://sourceware.org/bugzilla/show_bug.cgi?id=15380 + +random_r.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +readdir.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The data returned by readdir() may be overwritten by subsequent + calls to readdir() for the same directory stream, so it is not + thread-safe. + +re_comp.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions re_comp() and re_exec() are not thread safe. + +rexec.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions rexec() and rexec_af() are not thread safe. + +round.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions round(), roundf() and roundl() are thread safe. + +scalbln.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions scalbn(), scalbnf(), scalbnl(), scalbln(), + scalblnf() and scalblnl() are thread safe. + +scandir.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +siginterrupt.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +signbit.3 + Peng Haitao + ATTRIBUTES: Note macro that is thread-safe + The macro signbit() is thread safe. + +sigsetops.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +stdio_ext.3 + Peng Haitao + ATTRIBUTES: Note functions that are not thread-safe + The functions __fbufsize(), __fpending(), __fpurge() and + __fsetlocking() are not thread safe. + +strdup.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +strerror.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function strerror() is not thread safe. + +strftime.3 + Michael Kerrisk + Clarify details of return value + Michael Kerrisk + BUGS: 'errno' is not set if the result string would exceed 'max' bytes + +strtok.3 + Peng Haitao + ATTRIBUTES: Note function that is not thread-safe + The function strtok() is not thread safe. + Michael Kerrisk [Georg Sauthoff] + Add more detail on the operation of strtok() + Add a number of missing details on the operation of strtok() + +tempnam.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +timegm.3 + Jérémie Galarneau + copy the string returned by getenv() + The example of a portable version of timegm() uses the string + returned by getenv() after calling setenv() on the same + environment variable. The tz string may be invalid as per + getenv.3: + + "The string pointed to by the return value of getenv() + may be statically allocated, and can be modified by a + subsequent call to getenv(), putenv(3), setenv(3), or + unsetenv(3)." + +tmpnam.3 + Peng Haitao + ATTRIBUTES: Note function that is thread safe with exceptions + The function tmpnam() is thread safe with exceptions. + +trunc.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions trunc(), truncf() and truncl() are thread safe. + +ttyname.3 + Michael Kerrisk + ATTRIBUTES: Note functions that are and aren't thread-safe + +ttyslot.3 + Michael Kerrisk + ATTRIBUTES: Note functions that are not thread-safe + +usleep.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +wcsdup.3 + Michael Kerrisk + RETURN VALUE: mention that 'errno' is set on error + +core.5 + Michael Kerrisk + Implicitly adding the PID to a core filename was dropped in 2.6.27 + +proc.5 + Michael Kerrisk + Document /proc/[pid]/fd/ anon_inode symlinks + Mike Frysinger + Document /proc/[pid]/fd/ symlinks a bit more + Describe the type:[inode] syntax used in this dir + +bootparam.7 + Michael Kerrisk [Dan Jacobson] + Remove outdated text on LILO and LoadLin + Strike the discussion of LILO and LoadLin, which + are long obsolete, and make a brief mention of GRUB. + See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=604019 + Regid + Remove mention of the deprecated rdev(8) + The deprecated rdev(8) command was removed from util-linux in 2010. + See https://git.kernel.org/?p=utils/util-linux/util-linux.git;a=commit;h=a3e40c14651fccf18e7954f081e601389baefe3fO + Andrea Remondini + Document the 'resume' boot parameter + +inotify.7 + Michael Kerrisk [Jon Grant] + Clarify that null byte is '\0' + +iso_8859-2.7 + Eric S. Raymond + Remove incorrect reference to nonexistent groff glyph \[shc] + The reference incorrectly attempted to duplicate an + actual soft hyphen (hex 0xad) just before it in the file. + +man-pages.7 + Peng Haitao + Add description of "ATTRIBUTES" + "ATTRIBUTES" section can mention thread safety, + cancellation safety, and async-cancel-safety. + +socket.7 + Michael Kerrisk + Note that 'optval' for socket options is an 'int' in most cases + +tcp.7 + Michael Kerrisk + Note that 'optval' for socket options is an 'int' in most cases + +udp.7 + Michael Kerrisk + Note that 'optval' for socket options is an 'int' in most cases + + +==================== Changes in man-pages-3.53 ==================== + +Released: 2013-07-31, Munich + + +Contributors +------------ + +The following people contributed patches/fixes or (noted in brackets +in the changelog below) reports, notes, and ideas that have been +incorporated in changes in this release: + +Al Viro +Andrey Vagin +Benjamin Poirier +Chris Heath +Chuck Coffing +David Prévot +Denys Vlasenko +Dmitry V. Levin +Felix_Schulte@McAfee.com +graud@gmx.com +Michael Kerrisk +Oleg Nesterov +Peng Haitao +Peter Schiffer +Simon Paillard +Vince Weaver + +Apologies if I missed anyone! + + +New and rewritten pages +----------------------- + +restart_syscall.2 + Michael Kerrisk + New page for restart_syscall(2) system call + + +Newly documented interfaces in existing pages +--------------------------------------------- + +fchownat.2 + Michael Kerrisk + Document AT_EMPTY_PATH + +fstatat.2 + Michael Kerrisk + Document AT_EMPTY_PATH + +linkat.2 + Michael Kerrisk + Document AT_EMPTY_PATH + +open.2 + Michael Kerrisk [Al Viro] + Document O_PATH + See also https://bugzilla.redhat.com/show_bug.cgi?id=885740 + + +Changes to individual pages +--------------------------- + +clock_nanosleep.2 +futex.2 +nanosleep.2 +poll.2 +sigaction.2 +sigreturn.2 +signal.7 + Michael Kerrisk + SEE ALSO: add restart_syscall(2) + +open.2 + Michael Kerrisk [Geoffrey Thomas] + Remove warning that O_DIRECTORY is only for use with opendir(3) + O_DIRECTORY can also be used with, for example, O_PATH. + +perf_event_open.2 + Vince Weaver + Improve PERF_SAMPLE_BRANCH_STACK documentation + Vince Weaver + Fix indentation of the MMAP layout section + The indentation of the MMAP layout section wasn't quite right. + I think this improves things but I admit I'm not an expert at the + low-level indentation directives. + Vince Weaver + Update PERF_IOC_FLAG_GROUP info + It turns out PERF_IOC_FLAG_GROUP was broken from 75f937f24bd9 + (in Linux 2.6.31, the initial perf_event release) until + 724b6daa1 (Linux 3.4). + + I've done some extensive kernel source code digging plus + running tests of various kernels and I hope the info + presented is accurate now. + + (Patch edited somewhat by mtk.) + Vince Weaver + Improve sysfs files documentation + This improves the documentation of the various + perf_event_open()-related sysfs files. + +ptrace.2 + Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin] + If SEIZE was used, initial auto-attach stop is EVENT_STOP + For every PTRACE_O_TRACEfoo option, mention that old-style SIGSTOP + is replaced by PTRACE_EVENT_STOP if PTRACE_SEIZE attach was used. + + Mention the same thing again in the description of + PTRACE_EVENT_STOP. + Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin] + Mention that PTRACE_PEEK* libc API and kernel API are different + Denys Vlasenko [Oleg Nesterov, Dmitry V. Levin] + Clarify PTRACE_INTERRUPT, PTRACE_LISTEN, and group-stop behavior + +readlink.2 + Michael Kerrisk + Document use of empty 'pathname' argument + Michael Kerrisk + Change error check in example program from "< 0" to "== -1" + Chuck Coffing + Fix possible race condition in readlink.2 example + I noticed that the example in the readlink.2 man pages does error + checking for a race condition that would cause the value of the + symbolic link to get larger. However, it doesn't handle the + opposite case, in which the value gets shorter. (The NULL + terminator is always set at the old, longer offset.) This could + cause the program to operate on uninitialized data. + +setpgid.2 + Michael Kerrisk [graud@gmx.com] + s/SIGTSTP/SIGTTIN/ when discussing reads from terminal + See https://bugzilla.kernel.org/show_bug.cgi?id=60504 + +clog2.3 + Michael Kerrisk + Note that these functions are still not present in glibc 2.17 + +dirfd.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function dirfd() is thread safe. + +div.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions div(), ldiv(), lldiv() and imaxdiv() are thread + safe. + +fabs.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions fabs(), fabsf() and fabsl() are thread safe. + +fdim.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions fdim(), fdimf() and fdiml() are thread safe. + +fflush.3 + Peng Haitao + ATTRIBUTES: Note function that is thread-safe + The function fflush() is thread safe. + +finite.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions finite(), finitef(), finitel(), isinf(), isinff(), + isinfl(), isnan(), isnanf() and isnanl() are thread safe. + +flockfile.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions flockfile(), ftrylockfile() and funlockfile() are + thread safe. + +floor.3 + Peng Haitao + ATTRIBUTES: Note functions that are thread-safe + The functions floor(), floorf() and floorl() are thread safe. + +resolv.conf.5 + Simon Paillard + Explain how to set empty domain + See http://bugs.debian.org/463575 + +capabilities.7 + Michael Kerrisk + Add open_by_handle_at(2) under CAP_DAC_READ_SEARCH + +inotify.7 + Michael Kerrisk [Felix_Schulte@McAfee.com] + Clarify description of IN_MOVED_FROM and IN_MOVED_TO + +man-pages.7 + Michael Kerrisk + DESCRIPTION should note versions for new interface features or behavior + +udp.7 + Benjamin Poirier + Add missing #include directive + Using the UDP_CORK socket option documented in udp.7 requires + including . + +ld.so.8 + Michael Kerrisk + Rework rpath token expansion text + Michael Kerrisk + Describe $PLATFORM rpath token + Michael Kerrisk + Describe $LIB rpath token + Michael Kerrisk + Document LD_BIND_NOT + Michael Kerrisk [Simon Paillard] + Add reference to pthreads(7) in discussion of LD_ASSUME_KERNEL diff -Nru manpages-3.52/debian/changelog manpages-3.54/debian/changelog --- manpages-3.52/debian/changelog 2013-08-01 15:23:31.000000000 +0200 +++ manpages-3.54/debian/changelog 2013-09-26 00:46:31.000000000 +0200 @@ -1,3 +1,28 @@ +manpages (3.54-1ubuntu1) saucy; urgency=low + + * Merge from Debian unstable; remaining changes: + - man2/ptrace.2: Document Yama-specific PTRACE_ATTACH behaviour + which has been the default in Ubuntu since maverick. + + -- Benjamin Drung Thu, 26 Sep 2013 00:46:19 +0200 + +manpages (3.54-1) unstable; urgency=low + + * Imported Upstream version 3.54 + . dir_colors.5: Add various synonyms (Closes: #553477) + . ip.7: IP_MULTICAST_IF setsockopt recognizes struct mreq (Closes: #607979) + + -- Simon Paillard Mon, 23 Sep 2013 23:11:58 +0200 + +manpages (3.53-1) unstable; urgency=low + + * Imported Upstream version 3.53 + . new manpage: restart_syscall.2 + . resolv.conf.5: Explain how to set empty domain (Closes: #463575) + * missing.7: update after #235967 closure + + -- Simon Paillard Thu, 05 Sep 2013 01:16:25 +0200 + manpages (3.52-1ubuntu1) saucy; urgency=low * Resynchronize with Debian unstable, remaining changes: diff -Nru manpages-3.52/debian/patches/debian-changes manpages-3.54/debian/patches/debian-changes --- manpages-3.52/debian/patches/debian-changes 2013-08-01 15:24:00.000000000 +0200 +++ manpages-3.54/debian/patches/debian-changes 2013-10-02 02:06:46.000000000 +0200 @@ -5,18 +5,14 @@ information below has been extracted from the changelog. Adjust it or drop it. . - manpages (3.52-1) unstable; urgency=low + manpages (3.54-1) unstable; urgency=low . - * Imported Upstream version 3.52 - . bootparam.7: Remove outdated text on LILO and LoadLin (Closes: #604019) - * Take over libc-bin related manpages (Closes: #564874) - . d/control: Replaces libc-bin (<< 2.17-91) - . install: ldd.1 ldconfig.8 ld.so.8 gai.conf.5 zic.8 zdump.8 - * Switch to dpkg-source 3.0 (quilt) format - * debian/watch: Switch to xz upstream source + * Imported Upstream version 3.54 + . dir_colors.5: Add various synonyms (Closes: #553477) + . ip.7: IP_MULTICAST_IF setsockopt recognizes struct mreq (Closes: #607979) Author: Simon Paillard -Bug-Debian: http://bugs.debian.org/564874 -Bug-Debian: http://bugs.debian.org/604019 +Bug-Debian: http://bugs.debian.org/553477 +Bug-Debian: http://bugs.debian.org/607979 --- The information above should follow the Patch Tagging Guidelines, please @@ -31,8 +27,8 @@ Reviewed-By: Last-Update: ---- manpages-3.52.orig/Makefile -+++ manpages-3.52/Makefile +--- manpages-3.54.orig/Makefile ++++ manpages-3.54/Makefile @@ -55,7 +55,7 @@ install: install -m 644 "$$i"/* $(DESTDIR)$(MANDIR)/"$$i" || exit $$?; \ done; \ @@ -43,7 +39,7 @@ GROFF_LOG := $(shell mktemp /tmp/manpages-checksXXXX) check-groff-warnings: --- /dev/null -+++ manpages-3.52/man7/LDP.7 ++++ manpages-3.54/man7/LDP.7 @@ -0,0 +1,90 @@ +.\" Copyright (C) 2000 Stein Gjoen +.\" @@ -135,8 +131,8 @@ +.BR emacs (1) +or +.BR info (1) ---- manpages-3.52.orig/man7/man.7 -+++ manpages-3.52/man7/man.7 +--- manpages-3.54.orig/man7/man.7 ++++ manpages-3.54/man7/man.7 @@ -563,12 +563,12 @@ is not implemented. .BR lexgrog (1), .BR man (1), @@ -150,10 +146,10 @@ -.BR mdoc.samples (7) +.BR mdoc (7) .SH COLOPHON - This page is part of release 3.52 of the Linux + This page is part of release 3.54 of the Linux .I man-pages ---- manpages-3.52.orig/man7/rtnetlink.7 -+++ manpages-3.52/man7/rtnetlink.7 +--- manpages-3.54.orig/man7/rtnetlink.7 ++++ manpages-3.54/man7/rtnetlink.7 @@ -18,6 +18,8 @@ rtnetlink \- Linux IPv4 routing socket .SH SYNOPSIS .B #include @@ -164,7 +160,7 @@ .br .B #include --- /dev/null -+++ manpages-3.52/man7/undocumented.7 ++++ manpages-3.54/man7/undocumented.7 @@ -0,0 +1,106 @@ +.\" Copyright (C) 1996 Erick Branderhorst +.\" @@ -272,8 +268,8 @@ +.BR man (7), +.BR mandb (8), +.BR missing (7). ---- manpages-3.52.orig/man7/mdoc.7 -+++ manpages-3.52/man7/mdoc.7 +--- manpages-3.54.orig/man7/mdoc.7 ++++ manpages-3.54/man7/mdoc.7 @@ -62,7 +62,7 @@ The macro names and their meanings are listed below for quick reference; for a detailed explanation on using the package, @@ -284,8 +280,8 @@ Note that this is not the usual macro package for Linux documentation, although it is used for documentation of several widely used programs; --- /dev/null -+++ manpages-3.52/man7/missing.7 -@@ -0,0 +1,196 @@ ++++ manpages-3.54/man7/missing.7 +@@ -0,0 +1,192 @@ +.\" Copyright (c) 2001 Martin Schulze +.\" +.\" %%%LICENSE_START(GPLv2_MISC) @@ -432,10 +428,6 @@ +.BR capsetp "(3), " capgetp (3) +\- Linux specific capability manipulation on arbitrary processes +.TP -+.RI Bug# 235967 -+.BR if_nametoindex (3) -+\- map network interface name to corresponding index. -+.TP +.RI Bug# 349388 +.BR argp_parse (3) +\- main interface to argp. @@ -482,8 +474,8 @@ +.RB < http://www.opengroup.org/onlinepubs/007908799/toc.htm >, +the Single UNIX Specification, Version 3, at +.RB < http://www.UNIX-systems.org/version3/ >. ---- manpages-3.52.orig/man4/console_codes.4 -+++ manpages-3.52/man4/console_codes.4 +--- manpages-3.54.orig/man4/console_codes.4 ++++ manpages-3.54/man4/console_codes.4 @@ -19,6 +19,7 @@ .\" Tiny correction, aeb, 961107. .\" @@ -504,8 +496,8 @@ .TE .PP It also recognizes ESC % and provides a more complete UTF-8 ---- manpages-3.52.orig/man3/getpwnam.3 -+++ manpages-3.52/man3/getpwnam.3 +--- manpages-3.54.orig/man3/getpwnam.3 ++++ manpages-3.54/man3/getpwnam.3 @@ -210,10 +210,18 @@ structure. .TP .B ERANGE @@ -524,7 +516,7 @@ +System Databases and Name Service Switch configuration file .SH ATTRIBUTES .SS Multithreading (see pthreads(7)) - The functions + The @@ -332,6 +340,7 @@ main(int argc, char *argv[]) .BR getspnam (3), .BR putpwent (3), @@ -532,9 +524,9 @@ +.BR nsswitch.conf (5), .BR passwd (5) .SH COLOPHON - This page is part of release 3.52 of the Linux ---- manpages-3.52.orig/man3/fclose.3 -+++ manpages-3.52/man3/fclose.3 + This page is part of release 3.54 of the Linux +--- manpages-3.54.orig/man3/fclose.3 ++++ manpages-3.54/man3/fclose.3 @@ -56,6 +56,16 @@ function flushes the stream pointed to b (writing any buffered output data using .BR fflush (3)) @@ -552,8 +544,8 @@ .SH RETURN VALUE Upon successful completion 0 is returned. Otherwise, ---- manpages-3.52.orig/man3/puts.3 -+++ manpages-3.52/man3/puts.3 +--- manpages-3.54.orig/man3/puts.3 ++++ manpages-3.54/man3/puts.3 @@ -65,7 +65,7 @@ more than once. .PP .BI "putchar(" c ); @@ -563,8 +555,8 @@ .PP .BR puts () writes the string ---- manpages-3.52.orig/man3/nl_langinfo.3 -+++ manpages-3.52/man3/nl_langinfo.3 +--- manpages-3.54.orig/man3/nl_langinfo.3 ++++ manpages-3.54/man3/nl_langinfo.3 @@ -31,6 +31,8 @@ in a more flexible way than does. Individual and additional elements of the locale categories can @@ -574,8 +566,8 @@ .PP Examples for the locale elements that can be specified in \fIitem\fP using the constants defined in \fI\fP are: ---- manpages-3.52.orig/man3/getpwent.3 -+++ manpages-3.52/man3/getpwent.3 +--- manpages-3.54.orig/man3/getpwent.3 ++++ manpages-3.54/man3/getpwent.3 @@ -28,7 +28,8 @@ .\" 386BSD man pages .\" @@ -625,9 +617,9 @@ +.BR shadow (5), .BR passwd (5) .SH COLOPHON - This page is part of release 3.52 of the Linux + This page is part of release 3.54 of the Linux --- /dev/null -+++ manpages-3.52/man5/mailname.5 ++++ manpages-3.54/man5/mailname.5 @@ -0,0 +1,41 @@ +.\" Copyright (c) 2002 Joe Wreschnig +.\" @@ -670,9 +662,9 @@ +.SH SEE ALSO +.BR mailaddr (7), +.BR sendmail (8) ---- manpages-3.52.orig/man5/dir_colors.5 -+++ manpages-3.52/man5/dir_colors.5 -@@ -355,6 +355,21 @@ RIGHTCODE m +--- manpages-3.54.orig/man5/dir_colors.5 ++++ manpages-3.54/man5/dir_colors.5 +@@ -407,6 +407,21 @@ RIGHTCODE m The default .B ENDCODE is undefined. @@ -694,8 +686,8 @@ .SH SEE ALSO .BR dircolors (1), .BR ls (1), ---- manpages-3.52.orig/man5/tzfile.5 -+++ manpages-3.52/man5/tzfile.5 +--- manpages-3.54.orig/man5/tzfile.5 ++++ manpages-3.54/man5/tzfile.5 @@ -144,6 +144,28 @@ if either .I tzh_timecnt is zero or the time argument is less than the first transition time recorded @@ -725,9 +717,9 @@ .PP For version-2-format timezone files, the above header and data is followed by a second header and data, ---- manpages-3.52.orig/man5/resolv.conf.5 -+++ manpages-3.52/man5/resolv.conf.5 -@@ -203,6 +203,8 @@ This has the effect of trying a AAAA que +--- manpages-3.54.orig/man5/resolv.conf.5 ++++ manpages-3.54/man5/resolv.conf.5 +@@ -204,6 +204,8 @@ This has the effect of trying a AAAA que .BR gethostbyname (3) function, and of mapping IPv4 responses in IPv6 "tunneled form" if no AAAA records are found but an A record set exists. @@ -736,8 +728,8 @@ .TP .BR ip6-bytestring " (since glibc 2.3.4)" sets ---- manpages-3.52.orig/man5/nsswitch.conf.5 -+++ manpages-3.52/man5/nsswitch.conf.5 +--- manpages-3.54.orig/man5/nsswitch.conf.5 ++++ manpages-3.54/man5/nsswitch.conf.5 @@ -271,6 +271,11 @@ Include the specified .I user from the NIS passwd map. @@ -750,8 +742,8 @@ .BI +@ netgroup Include all users in the given .IR netgroup . ---- manpages-3.52.orig/man5/motd.5 -+++ manpages-3.52/man5/motd.5 +--- manpages-3.54.orig/man5/motd.5 ++++ manpages-3.54/man5/motd.5 @@ -31,17 +31,32 @@ motd \- message of the day The contents of .I /etc/motd @@ -786,10 +778,10 @@ +.BR issue (5), +.BR pam_motd (8) .SH COLOPHON - This page is part of release 3.52 of the Linux + This page is part of release 3.54 of the Linux .I man-pages ---- manpages-3.52.orig/man2/ptrace.2 -+++ manpages-3.52/man2/ptrace.2 +--- manpages-3.54.orig/man2/ptrace.2 ++++ manpages-3.54/man2/ptrace.2 @@ -138,6 +138,17 @@ isn't expecting to trace it. and .IR data diff -Nru manpages-3.52/man1/getent.1 manpages-3.54/man1/getent.1 --- manpages-3.52/man1/getent.1 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man1/getent.1 2013-09-17 08:27:55.000000000 +0200 @@ -368,7 +368,7 @@ .SH SEE ALSO .BR nsswitch.conf (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man1/intro.1 manpages-3.54/man1/intro.1 --- manpages-3.52/man1/intro.1 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man1/intro.1 2013-09-17 08:27:55.000000000 +0200 @@ -240,8 +240,8 @@ .SS Disks and filesystems The command .I mount -will attach the file system found on some disk (or floppy, or CDROM or so) -to the big file system hierarchy. +will attach the filesystem found on some disk (or floppy, or CDROM or so) +to the big filesystem hierarchy. And .I umount detaches it again. @@ -302,7 +302,7 @@ .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man1/ldd.1 manpages-3.54/man1/ldd.1 --- manpages-3.52/man1/ldd.1 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man1/ldd.1 2013-09-17 08:27:55.000000000 +0200 @@ -109,7 +109,7 @@ .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man1/time.1 manpages-3.54/man1/time.1 --- manpages-3.52/man1/time.1 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man1/time.1 2013-09-17 08:27:55.000000000 +0200 @@ -202,10 +202,10 @@ .B "I/O" .TP .B %I -Number of file system inputs by the process. +Number of filesystem inputs by the process. .TP .B %O -Number of file system outputs by the process. +Number of filesystem outputs by the process. .TP .B %r Number of socket messages received by the process. @@ -308,7 +308,7 @@ .BR times (2), .BR wait3 (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/accept.2 manpages-3.54/man2/accept.2 --- manpages-3.52/man2/accept.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/accept.2 2013-09-17 08:27:55.000000000 +0200 @@ -386,7 +386,7 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/access.2 manpages-3.54/man2/access.2 --- manpages-3.52/man2/access.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/access.2 2013-09-17 08:27:55.000000000 +0200 @@ -40,7 +40,7 @@ .\" Modified 2004-06-23 by Michael Kerrisk .\" 2007-06-10, mtk, various parts rewritten, and added BUGS section. .\" -.TH ACCESS 2 2013-04-16 "Linux" "Linux Programmer's Manual" +.TH ACCESS 2 2013-09-13 "Linux" "Linux Programmer's Manual" .SH NAME access \- check real user's permissions for a file .SH SYNOPSIS @@ -131,7 +131,7 @@ is not, in fact, a directory. .TP .B EROFS -Write permission was requested for a file on a read-only file system. +Write permission was requested for a file on a read-only filesystem. .PP .BR access () may fail if: @@ -209,9 +209,10 @@ call will still fail. .PP .BR access () -may not work correctly on NFS file systems with UID mapping enabled, +may not work correctly on NFSv2 filesystems with UID mapping enabled, because UID mapping is done on the server and hidden from the client, -which checks permissions. +which checks permissions. (NFS versions 3 and higher perform the check on +the server.) Similar problems can occur to FUSE mounts. .SH BUGS In kernel 2.4 (and earlier) there is some strangeness in the handling of @@ -243,7 +244,7 @@ .B MS_NOEXEC flag if it was used to .BR mount (2) -the underlying file system. +the underlying filesystem. Since kernel 2.6.20, .BR access () honors this flag. @@ -259,7 +260,7 @@ .BR credentials (7), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/acct.2 manpages-3.54/man2/acct.2 --- manpages-3.52/man2/acct.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/acct.2 2013-09-17 08:27:55.000000000 +0200 @@ -123,7 +123,7 @@ .TP .B EROFS .I filename -refers to a file on a read-only file system. +refers to a file on a read-only filesystem. .TP .B EUSERS There are no more free file structures or we ran out of memory. @@ -143,7 +143,7 @@ .SH SEE ALSO .BR acct (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/add_key.2 manpages-3.54/man2/add_key.2 --- manpages-3.52/man2/add_key.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/add_key.2 2013-09-17 08:27:55.000000000 +0200 @@ -128,7 +128,7 @@ .BR keyctl (2), .BR request_key (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/adjtimex.2 manpages-3.54/man2/adjtimex.2 --- manpages-3.52/man2/adjtimex.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/adjtimex.2 2013-09-17 08:27:55.000000000 +0200 @@ -27,7 +27,7 @@ .\" .\" FIXME 2.6.29 added ADJ_SETOFFSET .\" -.TH ADJTIMEX 2 2004-05-27 "Linux" "Linux Programmer's Manual" +.TH ADJTIMEX 2 2013-08-07 "Linux" "Linux Programmer's Manual" .SH NAME adjtimex \- tune kernel clock .SH SYNOPSIS @@ -151,9 +151,10 @@ .BR settimeofday (2), .BR adjtime (3), .BR capabilities (7), -.BR time (7) +.BR time (7), +.BR adjtimex (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/alarm.2 manpages-3.54/man2/alarm.2 --- manpages-3.52/man2/alarm.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/alarm.2 2013-09-17 08:27:55.000000000 +0200 @@ -86,7 +86,7 @@ .BR sleep (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/alloc_hugepages.2 manpages-3.54/man2/alloc_hugepages.2 --- manpages-3.52/man2/alloc_hugepages.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/alloc_hugepages.2 2013-09-17 08:27:55.000000000 +0200 @@ -133,11 +133,11 @@ .SH NOTES These system calls are gone; they existed only in Linux 2.5.36 through to 2.5.54. -Now the hugetlbfs file system can be used instead. +Now the hugetlbfs filesystem can be used instead. Memory backed by huge pages (if the CPU supports them) is obtained by using .BR mmap (2) -to map files in this virtual file system. +to map files in this virtual filesystem. .LP The maximal number of huge pages can be specified using the .B hugepages= @@ -148,7 +148,7 @@ .\" mount -t hugetlbfs hugetlbfs /huge .\" SHM_HUGETLB .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/arch_prctl.2 manpages-3.54/man2/arch_prctl.2 --- manpages-3.52/man2/arch_prctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/arch_prctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -143,7 +143,7 @@ AMD X86-64 Programmer's manual .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/bdflush.2 manpages-3.54/man2/bdflush.2 --- manpages-3.52/man2/bdflush.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/bdflush.2 2013-09-17 08:27:55.000000000 +0200 @@ -122,7 +122,7 @@ .BR sync (8), .BR update (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/bind.2 manpages-3.54/man2/bind.2 --- manpages-3.52/man2/bind.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/bind.2 2013-09-17 08:27:55.000000000 +0200 @@ -218,7 +218,7 @@ A component of the path prefix is not a directory. .TP .B EROFS -The socket inode would reside on a read-only file system. +The socket inode would reside on a read-only filesystem. .SH CONFORMING TO SVr4, 4.4BSD, POSIX.1-2001 .RB ( bind () @@ -330,7 +330,7 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/brk.2 manpages-3.54/man2/brk.2 --- manpages-3.52/man2/brk.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/brk.2 2013-09-17 08:27:55.000000000 +0200 @@ -167,7 +167,7 @@ .BR end (3), .BR malloc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/cacheflush.2 manpages-3.54/man2/cacheflush.2 --- manpages-3.52/man2/cacheflush.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/cacheflush.2 2013-09-17 08:27:55.000000000 +0200 @@ -87,7 +87,7 @@ arguments. Therefore, the whole cache is always flushed. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/capget.2 manpages-3.54/man2/capget.2 --- manpages-3.52/man2/capget.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/capget.2 2013-09-17 08:27:55.000000000 +0200 @@ -230,7 +230,7 @@ .BR gettid (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/chdir.2 manpages-3.54/man2/chdir.2 --- manpages-3.52/man2/chdir.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/chdir.2 2013-09-17 08:27:55.000000000 +0200 @@ -73,7 +73,7 @@ .I errno is set appropriately. .SH ERRORS -Depending on the file system, other errors can be returned. +Depending on the filesystem, other errors can be returned. The more general errors for .BR chdir () @@ -138,7 +138,7 @@ .BR getcwd (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/chmod.2 manpages-3.54/man2/chmod.2 --- manpages-3.52/man2/chmod.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/chmod.2 2013-09-17 08:27:55.000000000 +0200 @@ -133,19 +133,19 @@ bit will be turned off, but this will not cause an error to be returned. -As a security measure, depending on the file system, +As a security measure, depending on the filesystem, the set-user-ID and set-group-ID execution bits may be turned off if a file is written. (On Linux this occurs if the writing process does not have the .B CAP_FSETID capability.) -On some file systems, only the superuser can set the sticky bit, +On some filesystems, only the superuser can set the sticky bit, which may have a special meaning. For the sticky bit, and for set-user-ID and set-group-ID bits on directories, see .BR stat (2). -On NFS file systems, restricting the permissions will immediately influence +On NFS filesystems, restricting the permissions will immediately influence already open files, because the access control is done on the server, but open files are maintained by the client. Widening the permissions may be @@ -156,7 +156,7 @@ .I errno is set appropriately. .SH ERRORS -Depending on the file system, other errors can be returned. +Depending on the filesystem, other errors can be returned. The more general errors for .BR chmod () are listed below: @@ -197,7 +197,7 @@ capability). .TP .B EROFS -The named file resides on a read-only file system. +The named file resides on a read-only filesystem. .PP The general errors for .BR fchmod () @@ -226,7 +226,7 @@ .BR stat (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/chown.2 manpages-3.54/man2/chown.2 --- manpages-3.52/man2/chown.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/chown.2 2013-09-17 08:27:55.000000000 +0200 @@ -122,7 +122,7 @@ .I errno is set appropriately. .SH ERRORS -Depending on the file system, other errors can be returned. +Depending on the filesystem, other errors can be returned. The more general errors for .BR chown () are listed below. @@ -158,7 +158,7 @@ (see above) to change owner and/or group. .TP .B EROFS -The named file resides on a read-only file system. +The named file resides on a read-only filesystem. .PP The general errors for .BR fchown () @@ -213,14 +213,14 @@ .BR open (2) or .BR mkdir (2)), -its owner is made the same as the file system user ID of the +its owner is made the same as the filesystem user ID of the creating process. The group of the file depends on a range of factors, -including the type of file system, -the options used to mount the file system, +including the type of filesystem, +the options used to mount the filesystem, and whether or not the set-group-ID permission bit is enabled on the parent directory. -If the file system supports the +If the filesystem supports the .I "\-o\ grpid" (or, synonymously .IR "\-o\ bsdgroups" ) @@ -231,18 +231,18 @@ .BR mount (8) options, then the rules are as follows: .IP * 2 -If the file system is mounted with +If the filesystem is mounted with .IR "\-o\ grpid" , then the group of a new file is made the same as that of the parent directory. .IP * -If the file system is mounted with +If the filesystem is mounted with .IR "\-o\ nogrpid" and the set-group-ID bit is disabled on the parent directory, then the group of a new file is made the same as the -process's file system GID. +process's filesystem GID. .IP * -If the file system is mounted with +If the filesystem is mounted with .IR "\-o\ nogrpid" and the set-group-ID bit is enabled on the parent directory, then the group of a new file is made @@ -254,13 +254,13 @@ and .IR "\-o\ nogrpid" mount options are supported by ext2, ext3, ext4, and XFS. -File systems that don't support these mount options follow the +Filesystems that don't support these mount options follow the .IR "\-o\ nogrpid" rules. .PP The .BR chown () -semantics are deliberately violated on NFS file systems +semantics are deliberately violated on NFS filesystems which have UID mapping enabled. Additionally, the semantics of all system calls which access the file contents are violated, because @@ -340,7 +340,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/chroot.2 manpages-3.54/man2/chroot.2 --- manpages-3.52/man2/chroot.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/chroot.2 2013-09-17 08:27:55.000000000 +0200 @@ -93,7 +93,7 @@ .I errno is set appropriately. .SH ERRORS -Depending on the file system, other errors can be returned. +Depending on the filesystem, other errors can be returned. The more general errors are listed below: .TP .B EACCES @@ -152,7 +152,7 @@ .BR chdir (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/clock_getres.2 manpages-3.54/man2/clock_getres.2 --- manpages-3.52/man2/clock_getres.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/clock_getres.2 2013-09-17 08:27:55.000000000 +0200 @@ -27,7 +27,7 @@ .\" 2003-08-24 aeb, large parts rewritten .\" 2004-08-06 Christoph Lameter , SMP note .\" -.TH CLOCK_GETRES 2 2013-02-25 "" "Linux Programmer's Manual" +.TH CLOCK_GETRES 2 2013-09-04 "" "Linux Programmer's Manual" .SH NAME clock_getres, clock_gettime, clock_settime \- clock and time functions .SH SYNOPSIS @@ -171,10 +171,10 @@ which may have discontinuities if the time is changed using .BR settimeofday (2). .TP -.B CLOCK_PROCESS_CPUTIME_ID +.BR CLOCK_PROCESS_CPUTIME_ID " (since Linux 2.6.12)" High-resolution per-process timer from the CPU. .TP -.B CLOCK_THREAD_CPUTIME_ID +.BR CLOCK_THREAD_CPUTIME_ID " (since Linux 2.6.12)" Thread-specific CPU-time clock. .SH RETURN VALUE .BR clock_gettime (), @@ -201,6 +201,8 @@ .B EPERM .BR clock_settime () does not have permission to set the clock indicated. +.SH VERSIONS +These system calls first appeared in Linux 2.6. .SH CONFORMING TO SUSv2, POSIX.1-2001. .SH AVAILABILITY @@ -219,12 +221,13 @@ (See also .BR sysconf (3).) .SH NOTES -.SS Note for SMP systems -The +.SS Historical note for SMP systems +Before Linux added kernel support for .B CLOCK_PROCESS_CPUTIME_ID and -.B CLOCK_THREAD_CPUTIME_ID -clocks are realized on many platforms using timers from the CPUs +.BR CLOCK_THREAD_CPUTIME_ID , +glibc implemented these clocks on many platforms using timer +registers from the CPUs (TSC on i386, AR.ITC on Itanium). These registers may differ between CPUs and as a consequence these clocks may return @@ -250,6 +253,15 @@ Kernel). Typically these offsets are small and therefore the effects may be negligible in most cases. + +Since glibc 2.4, +the wrapper functions for the system calls described in this page avoid +the abovementioned problems by employing the kernel implementation of +.B CLOCK_PROCESS_CPUTIME_ID +and +.BR CLOCK_THREAD_CPUTIME_ID , +on systems that provide such an implementation +(i.e., Linux 2.6.12 and later). .SH BUGS According to POSIX.1-2001, a process with "appropriate privileges" may set the .B CLOCK_PROCESS_CPUTIME_ID @@ -273,7 +285,7 @@ .BR sysconf (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/clock_nanosleep.2 manpages-3.54/man2/clock_nanosleep.2 --- manpages-3.52/man2/clock_nanosleep.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/clock_nanosleep.2 2013-09-17 08:27:55.000000000 +0200 @@ -23,7 +23,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH CLOCK_NANOSLEEP 2 2012-11-07 "Linux" "Linux Programmer's Manual" +.TH CLOCK_NANOSLEEP 2 2013-07-30 "Linux" "Linux Programmer's Manual" .SH NAME clock_nanosleep \- high-resolution sleep with specifiable clock .SH SYNOPSIS @@ -247,12 +247,13 @@ .SH SEE ALSO .BR clock_getres (2), .BR nanosleep (2), +.BR restart_syscall (2), .BR timer_create (2), .BR sleep (3), .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/clone.2 manpages-3.54/man2/clone.2 --- manpages-3.52/man2/clone.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/clone.2 2013-09-17 08:27:55.000000000 +0200 @@ -224,9 +224,9 @@ .BR CLONE_FS " (since Linux 2.0)" If .B CLONE_FS -is set, the caller and the child process share the same file system +is set, the caller and the child process share the same filesystem information. -This includes the root of the file system, the current +This includes the root of the filesystem, the current working directory, and the umask. Any call to .BR chroot (2), @@ -238,7 +238,7 @@ If .B CLONE_FS -is not set, the child process works on a copy of the file system +is not set, the child process works on a copy of the filesystem information of the calling process at the time of the .BR clone () call. @@ -1179,7 +1179,7 @@ .BR capabilities (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/close.2 manpages-3.54/man2/close.2 --- manpages-3.52/man2/close.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/close.2 2013-09-17 08:27:55.000000000 +0200 @@ -101,7 +101,7 @@ .PP A successful close does not guarantee that the data has been successfully saved to disk, as the kernel defers writes. -It is not common for a file system +It is not common for a filesystem to flush the buffers when the stream is closed. If you need to be sure that the data is physically stored use @@ -130,7 +130,7 @@ .BR unlink (2), .BR fclose (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/connect.2 manpages-3.54/man2/connect.2 --- manpages-3.52/man2/connect.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/connect.2 2013-09-17 08:27:55.000000000 +0200 @@ -268,7 +268,7 @@ .BR socket (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/create_module.2 manpages-3.54/man2/create_module.2 --- manpages-3.52/man2/create_module.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/create_module.2 2013-09-17 08:27:55.000000000 +0200 @@ -67,7 +67,7 @@ .BR init_module (2), .BR query_module (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/delete_module.2 manpages-3.54/man2/delete_module.2 --- manpages-3.52/man2/delete_module.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/delete_module.2 2013-09-17 08:27:55.000000000 +0200 @@ -207,7 +207,7 @@ .BR modprobe (8), .BR rmmod (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/dup.2 manpages-3.54/man2/dup.2 --- manpages-3.52/man2/dup.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/dup.2 2013-09-17 08:27:55.000000000 +0200 @@ -209,7 +209,7 @@ .BR fcntl (2), .BR open (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/epoll_create.2 manpages-3.54/man2/epoll_create.2 --- manpages-3.52/man2/epoll_create.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/epoll_create.2 2013-09-17 08:27:55.000000000 +0200 @@ -147,7 +147,7 @@ .BR epoll_wait (2), .BR epoll (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/epoll_ctl.2 manpages-3.54/man2/epoll_ctl.2 --- manpages-3.52/man2/epoll_ctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/epoll_ctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -256,7 +256,7 @@ .BR poll (2), .BR epoll (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/epoll_wait.2 manpages-3.54/man2/epoll_wait.2 --- manpages-3.52/man2/epoll_wait.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/epoll_wait.2 2013-09-17 08:27:55.000000000 +0200 @@ -92,7 +92,7 @@ .I data of each returned structure will contain the same data the user set with an .BR epoll_ctl (2) -.RB ( EPOLL_CTL_ADD , EPOLL_CTL_MOD ) +.RB ( EPOLL_CTL_ADD ", " EPOLL_CTL_MOD ) while the .I events member will contain the returned event bit field. @@ -221,7 +221,7 @@ .BR epoll_ctl (2), .BR epoll (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/eventfd.2 manpages-3.54/man2/eventfd.2 --- manpages-3.52/man2/eventfd.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/eventfd.2 2013-09-17 08:27:55.000000000 +0200 @@ -426,7 +426,7 @@ .BR epoll (7), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/execve.2 manpages-3.54/man2/execve.2 --- manpages-3.52/man2/execve.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/execve.2 2013-09-17 08:27:55.000000000 +0200 @@ -83,7 +83,7 @@ If the set-user-ID bit is set on the program file pointed to by \fIfilename\fP, -and the underlying file system is not mounted +and the underlying filesystem is not mounted .I nosuid (the .B MS_NOSUID @@ -381,7 +381,7 @@ Execute permission is denied for the file or a script or ELF interpreter. .TP .B EACCES -The file system is mounted +The filesystem is mounted .IR noexec . .TP .B EFAULT @@ -436,7 +436,7 @@ or a script or ELF interpreter is not a directory. .TP .B EPERM -The file system is mounted +The filesystem is mounted .IR nosuid , the user is not the superuser, and the file has the set-user-ID or set-group-ID bit set. @@ -461,7 +461,7 @@ Linux ignores the set-user-ID and set-group-ID bits on scripts. -The result of mounting a file system +The result of mounting a filesystem .I nosuid varies across Linux kernel versions: some will refuse execution of set-user-ID and set-group-ID @@ -648,7 +648,7 @@ .BR path_resolution (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/_exit.2 manpages-3.54/man2/_exit.2 --- manpages-3.52/man2/_exit.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/_exit.2 2013-09-17 08:27:55.000000000 +0200 @@ -134,7 +134,7 @@ .BR on_exit (3), .BR termios (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/exit_group.2 manpages-3.54/man2/exit_group.2 --- manpages-3.52/man2/exit_group.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/exit_group.2 2013-09-17 08:27:55.000000000 +0200 @@ -49,7 +49,7 @@ .SH SEE ALSO .BR exit (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/faccessat.2 manpages-3.54/man2/faccessat.2 --- manpages-3.52/man2/faccessat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/faccessat.2 2013-09-17 08:27:55.000000000 +0200 @@ -167,7 +167,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/fallocate.2 manpages-3.54/man2/fallocate.2 --- manpages-3.52/man2/fallocate.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/fallocate.2 2013-09-17 08:27:55.000000000 +0200 @@ -90,8 +90,8 @@ and continuing for .I len bytes. -Within the specified range, partial file system blocks are zeroed, -and whole file system blocks are removed from the file. +Within the specified range, partial filesystem blocks are zeroed, +and whole filesystem blocks are removed from the file. After a successful call, subsequent reads from this range will return zeroes. @@ -106,9 +106,9 @@ .BR stat (2)) does not change. -Not all file systems support +Not all filesystems support .BR FALLOC_FL_PUNCH_HOLE ; -if a file system doesn't support the operation, an error is returned. +if a filesystem doesn't support the operation, an error is returned. .SH RETURN VALUE On success, .BR fallocate () @@ -142,7 +142,7 @@ was less than or equal to 0. .TP .B EIO -An I/O error occurred while reading from or writing to a file system. +An I/O error occurred while reading from or writing to a filesystem. .TP .B ENODEV .I fd @@ -161,12 +161,12 @@ .BR fallocate (). .TP .B EOPNOTSUPP -The file system containing the file referred to by +The filesystem containing the file referred to by .I fd does not support this operation; or the .I mode -is not supported by the file system containing the file referred to by +is not supported by the filesystem containing the file referred to by .IR fd . .TP .B EPERM @@ -205,7 +205,7 @@ .BR posix_fadvise (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/fchmodat.2 manpages-3.54/man2/fchmodat.2 --- manpages-3.52/man2/fchmodat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/fchmodat.2 2013-09-17 08:27:55.000000000 +0200 @@ -156,7 +156,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/fchownat.2 manpages-3.54/man2/fchownat.2 --- manpages-3.52/man2/fchownat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/fchownat.2 2013-09-17 08:27:55.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FCHOWNAT 2 2012-05-04 "Linux" "Linux Programmer's Manual" +.TH FCHOWNAT 2 2013-07-21 "Linux" "Linux Programmer's Manual" .SH NAME fchownat \- change ownership of a file relative to a directory \ file descriptor @@ -88,8 +88,25 @@ .I dirfd is ignored. +The .I flags -can either be 0, or include the following flag: +argument is a bit mask created by ORing together +0 or more of the following values; +.TP +.BR AT_EMPTY_PATH " (since Linux 2.6.39)" +.\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d +If +.I pathname +is an empty string, operate on the file referred to by +.IR dirfd +(which may have been obtained using the +.BR open (2) +.B O_PATH +flag). +In this case, +.I dirfd +can refer to any type of file, not just a directory. + .TP .B AT_SYMLINK_NOFOLLOW If @@ -147,7 +164,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/fcntl.2 manpages-3.54/man2/fcntl.2 --- manpages-3.52/man2/fcntl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/fcntl.2 2013-09-17 08:27:55.000000000 +0200 @@ -247,7 +247,7 @@ is positive, then the range to be locked covers bytes .I l_start up to and including -.IR l_start + l_len \- 1 . +.IR l_start + l_len \-1. Specifying 0 for .I l_len has the special meaning: lock all bytes starting at the @@ -414,9 +414,9 @@ .BR EAGAIN . To make use of mandatory locks, mandatory locking must be enabled -both on the file system that contains the file to be locked, +both on the filesystem that contains the file to be locked, and on the file itself. -Mandatory locking is enabled on a file system +Mandatory locking is enabled on a filesystem using the "\-o mand" option to .BR mount (8), or the @@ -815,7 +815,7 @@ .P Leases may be taken out only on regular files. An unprivileged process may take out a lease only on a file whose -UID (owner) matches the file system UID of the process. +UID (owner) matches the filesystem UID of the process. A process with the .B CAP_LEASE capability may take out leases on arbitrary files. @@ -1009,7 +1009,7 @@ .I inotify interface (available since kernel 2.6.13), which provides a much superior interface for obtaining notifications of -file system events. +filesystem events. See .BR inotify (7). .SS Changing the capacity of a pipe @@ -1316,7 +1316,7 @@ is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/flock.2 manpages-3.54/man2/flock.2 --- manpages-3.52/man2/flock.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/flock.2 2013-09-17 08:27:55.000000000 +0200 @@ -213,7 +213,7 @@ .RI ( Documentation/locks.txt in older kernels) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/fork.2 manpages-3.54/man2/fork.2 --- manpages-3.52/man2/fork.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/fork.2 2013-09-17 08:27:55.000000000 +0200 @@ -253,7 +253,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/fstatat.2 manpages-3.54/man2/fstatat.2 --- manpages-3.52/man2/fstatat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/fstatat.2 2013-09-17 08:27:55.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FSTATAT 2 2012-05-04 "Linux" "Linux Programmer's Manual" +.TH FSTATAT 2 2013-07-21 "Linux" "Linux Programmer's Manual" .SH NAME fstatat \- get file status relative to a directory file descriptor .SH SYNOPSIS @@ -91,6 +91,21 @@ .I flags can either be 0, or include one or more of the following flags ORed: .TP +.BR AT_EMPTY_PATH " (since Linux 2.6.39)" +.\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d +If +.I pathname +is an empty string, operate on the file referred to by +.IR dirfd +(which may have been obtained using the +.BR open (2) +.B O_PATH +flag). +In this case, +.I dirfd +can refer to any type of file, not just a directory. + +.TP .BR AT_NO_AUTOMOUNT " (since Linux 2.6.38)" Don't automount the terminal ("basename") component of .I pathname @@ -164,7 +179,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/fsync.2 manpages-3.54/man2/fsync.2 --- manpages-3.52/man2/fsync.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/fsync.2 2013-09-17 08:27:55.000000000 +0200 @@ -169,7 +169,7 @@ .BR sync (8), .BR update (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/futex.2 manpages-3.54/man2/futex.2 --- manpages-3.52/man2/futex.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/futex.2 2013-09-17 08:27:55.000000000 +0200 @@ -50,7 +50,7 @@ .\" .\" See Documentation/futex-requeue-pi.txt .\" -.TH FUTEX 2 2013-03-15 "Linux" "Linux Programmer's Manual" +.TH FUTEX 2 2013-09-04 "Linux" "Linux Programmer's Manual" .SH NAME futex \- fast user-space locking .SH SYNOPSIS @@ -116,8 +116,13 @@ on this futex address. If the .I timeout -argument is non-NULL, its contents describe the minimum -duration of the wait, which is infinite otherwise. +argument is non-NULL, its contents specify the duration of the wait. +(This interval will be rounded up to the system clock granularity, +and kernel scheduling delays mean that the +blocking interval may overrun by a small amount.) +If +.I timeout +is NULL, the call blocks indefinitely. The arguments .I uaddr2 and @@ -310,6 +315,7 @@ .\" and Rusty Russell (IBM Linux Technology Center). .\" This page written by bert hubert. .SH SEE ALSO +.BR restart_syscall (2), .BR futex (7) .PP \fIFuss, Futexes and Furwocks: Fast Userlevel Locking in Linux\fP @@ -323,7 +329,7 @@ .UR ftp://ftp.nl.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/ .UE .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/futimesat.2 manpages-3.54/man2/futimesat.2 --- manpages-3.52/man2/futimesat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/futimesat.2 2013-09-17 08:27:55.000000000 +0200 @@ -132,7 +132,7 @@ .BR futimes (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getcpu.2 manpages-3.54/man2/getcpu.2 --- manpages-3.52/man2/getcpu.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getcpu.2 2013-09-17 08:27:55.000000000 +0200 @@ -143,7 +143,7 @@ .BR sched_getcpu (3), .BR cpuset (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getdents.2 manpages-3.54/man2/getdents.2 --- manpages-3.52/man2/getdents.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getdents.2 2013-09-17 08:27:55.000000000 +0200 @@ -134,7 +134,7 @@ Currently, .\" kernel 2.6.27 .\" The same sentence is in readdir.2 -only some file systems (among them: Btrfs, ext2, ext3, and ext4) +only some filesystems (among them: Btrfs, ext2, ext3, and ext4) have full support for returning the file type in .IR d_type . All applications must properly handle a return of @@ -180,7 +180,7 @@ The original Linux .BR getdents () -system call did not handle large file systems and large file offsets. +system call did not handle large filesystems and large file offsets. Consequently, Linux 2.4 added .BR getdents64 (), with wider types for the @@ -283,7 +283,7 @@ .BR readdir (2), .BR readdir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getdomainname.2 manpages-3.54/man2/getdomainname.2 --- manpages-3.52/man2/getdomainname.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getdomainname.2 2013-09-17 08:27:55.000000000 +0200 @@ -129,7 +129,7 @@ .BR sethostname (2), .BR uname (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getgid.2 manpages-3.54/man2/getgid.2 --- manpages-3.52/man2/getgid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getgid.2 2013-09-17 08:27:55.000000000 +0200 @@ -65,7 +65,7 @@ .BR setregid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getgroups.2 manpages-3.54/man2/getgroups.2 --- manpages-3.52/man2/getgroups.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getgroups.2 2013-09-17 08:27:55.000000000 +0200 @@ -176,7 +176,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/gethostname.2 manpages-3.54/man2/gethostname.2 --- manpages-3.52/man2/gethostname.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/gethostname.2 2013-09-17 08:27:55.000000000 +0200 @@ -178,7 +178,7 @@ .BR setdomainname (2), .BR uname (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getitimer.2 manpages-3.54/man2/getitimer.2 --- manpages-3.52/man2/getitimer.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getitimer.2 2013-09-17 08:27:55.000000000 +0200 @@ -244,7 +244,7 @@ .BR timerfd_create (2), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/get_kernel_syms.2 manpages-3.54/man2/get_kernel_syms.2 --- manpages-3.52/man2/get_kernel_syms.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/get_kernel_syms.2 2013-09-17 08:27:55.000000000 +0200 @@ -83,7 +83,7 @@ .BR init_module (2), .BR query_module (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/get_mempolicy.2 manpages-3.54/man2/get_mempolicy.2 --- manpages-3.52/man2/get_mempolicy.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/get_mempolicy.2 2013-09-17 08:27:55.000000000 +0200 @@ -245,7 +245,7 @@ .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getpagesize.2 manpages-3.54/man2/getpagesize.2 --- manpages-3.52/man2/getpagesize.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getpagesize.2 2013-09-17 08:27:55.000000000 +0200 @@ -109,7 +109,7 @@ .BR mmap (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getpeername.2 manpages-3.54/man2/getpeername.2 --- manpages-3.52/man2/getpeername.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getpeername.2 2013-09-17 08:27:55.000000000 +0200 @@ -148,7 +148,7 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getpid.2 manpages-3.54/man2/getpid.2 --- manpages-3.52/man2/getpid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getpid.2 2013-09-17 08:27:55.000000000 +0200 @@ -108,7 +108,7 @@ .BR tmpnam (3), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getpriority.2 manpages-3.54/man2/getpriority.2 --- manpages-3.52/man2/getpriority.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getpriority.2 2013-09-17 08:27:55.000000000 +0200 @@ -238,7 +238,7 @@ .I Documentation/scheduler/sched-nice-design.txt in the Linux kernel source tree (since Linux 2.6.23) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getresuid.2 manpages-3.54/man2/getresuid.2 --- manpages-3.52/man2/getresuid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getresuid.2 2013-09-17 08:27:55.000000000 +0200 @@ -90,7 +90,7 @@ .BR setuid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getrlimit.2 manpages-3.54/man2/getrlimit.2 --- manpages-3.52/man2/getrlimit.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getrlimit.2 2013-09-17 08:27:55.000000000 +0200 @@ -672,7 +672,7 @@ .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/get_robust_list.2 manpages-3.54/man2/get_robust_list.2 --- manpages-3.52/man2/get_robust_list.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/get_robust_list.2 2013-09-17 08:27:55.000000000 +0200 @@ -135,7 +135,7 @@ in the Linux kernel source tree .\" http://lwn.net/Articles/172149/ .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getrusage.2 manpages-3.54/man2/getrusage.2 --- manpages-3.52/man2/getrusage.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getrusage.2 2013-09-17 08:27:55.000000000 +0200 @@ -147,10 +147,10 @@ .\" On some systems, this is the number of swaps out of physical memory. .TP .IR ru_inblock " (since Linux 2.6.22)" -The number of times the file system had to perform input. +The number of times the filesystem had to perform input. .TP .IR ru_oublock " (since Linux 2.6.22)" -The number of times the file system had to perform output. +The number of times the filesystem had to perform output. .TP .IR ru_msgsnd " (unmaintained)" This field is currently unused on Linux. @@ -251,7 +251,7 @@ .BR wait4 (2), .BR clock (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getsid.2 manpages-3.54/man2/getsid.2 --- manpages-3.52/man2/getsid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getsid.2 2013-09-17 08:27:55.000000000 +0200 @@ -86,7 +86,7 @@ .BR setsid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getsockname.2 manpages-3.54/man2/getsockname.2 --- manpages-3.52/man2/getsockname.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getsockname.2 2013-09-17 08:27:55.000000000 +0200 @@ -119,7 +119,7 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getsockopt.2 manpages-3.54/man2/getsockopt.2 --- manpages-3.52/man2/getsockopt.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getsockopt.2 2013-09-17 08:27:55.000000000 +0200 @@ -208,7 +208,7 @@ .BR tcp (7), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/get_thread_area.2 manpages-3.54/man2/get_thread_area.2 --- manpages-3.52/man2/get_thread_area.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/get_thread_area.2 2013-09-17 08:27:55.000000000 +0200 @@ -56,7 +56,7 @@ .BR modify_ldt (2), .BR set_thread_area (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/gettid.2 manpages-3.54/man2/gettid.2 --- manpages-3.52/man2/gettid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/gettid.2 2013-09-17 08:27:55.000000000 +0200 @@ -88,7 +88,7 @@ .BR timer_create (2), .BR tgkill (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/gettimeofday.2 manpages-3.54/man2/gettimeofday.2 --- manpages-3.52/man2/gettimeofday.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/gettimeofday.2 2013-09-17 08:27:55.000000000 +0200 @@ -254,7 +254,7 @@ .BR capabilities (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getuid.2 manpages-3.54/man2/getuid.2 --- manpages-3.52/man2/getuid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getuid.2 2013-09-17 08:27:55.000000000 +0200 @@ -76,7 +76,7 @@ .BR setuid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getunwind.2 manpages-3.54/man2/getunwind.2 --- manpages-3.52/man2/getunwind.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getunwind.2 2013-09-17 08:27:55.000000000 +0200 @@ -111,7 +111,7 @@ .SH SEE ALSO .BR getauxval (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/getxattr.2 manpages-3.54/man2/getxattr.2 --- manpages-3.52/man2/getxattr.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/getxattr.2 2013-09-17 08:27:55.000000000 +0200 @@ -58,7 +58,7 @@ .I name and associated with the given .I path -in the file system. +in the filesystem. The length of the attribute .I value is returned. @@ -115,7 +115,7 @@ .IR .) .TP .B ENOTSUP -Extended attributes are not supported by the file system, or are disabled. +Extended attributes are not supported by the filesystem, or are disabled. .TP .B ERANGE The @@ -149,7 +149,7 @@ .BR attr (5), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/idle.2 manpages-3.54/man2/idle.2 --- manpages-3.52/man2/idle.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/idle.2 2013-09-17 08:27:55.000000000 +0200 @@ -62,7 +62,7 @@ This function is Linux-specific, and should not be used in programs intended to be portable. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/init_module.2 manpages-3.54/man2/init_module.2 --- manpages-3.52/man2/init_module.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/init_module.2 2013-09-17 08:27:55.000000000 +0200 @@ -96,7 +96,7 @@ but reads the module to be loaded from the file descriptor .IR fd . It is useful when the authenticity of a kernel module -can be determined from its location in the file system; +can be determined from its location in the filesystem; in cases where that is possible, the overhead of using cryptographically signed modules to determine the authenticity of a module can be avoided. @@ -341,7 +341,7 @@ .BR lsmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/inotify_add_watch.2 manpages-3.54/man2/inotify_add_watch.2 --- manpages-3.52/man2/inotify_add_watch.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/inotify_add_watch.2 2013-09-17 08:27:55.000000000 +0200 @@ -73,7 +73,7 @@ .I inotify_event structures (see .BR inotify (7)) -indicating file system events; +indicating filesystem events; the watch descriptor inside this structure identifies the object for which the event occurred. .SH RETURN VALUE @@ -120,7 +120,7 @@ .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/inotify_init.2 manpages-3.54/man2/inotify_init.2 --- manpages-3.52/man2/inotify_init.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/inotify_init.2 2013-09-17 08:27:55.000000000 +0200 @@ -101,7 +101,7 @@ .BR inotify_rm_watch (2), .BR inotify (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/inotify_rm_watch.2 manpages-3.54/man2/inotify_rm_watch.2 --- manpages-3.52/man2/inotify_rm_watch.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/inotify_rm_watch.2 2013-09-17 08:27:55.000000000 +0200 @@ -72,7 +72,7 @@ .BR inotify_init (2), .BR inotify (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/intro.2 manpages-3.54/man2/intro.2 --- manpages-3.52/man2/intro.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/intro.2 2013-09-17 08:27:55.000000000 +0200 @@ -110,7 +110,7 @@ .BR symlink (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/io_cancel.2 manpages-3.54/man2/io_cancel.2 --- manpages-3.52/man2/io_cancel.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/io_cancel.2 2013-09-17 08:27:55.000000000 +0200 @@ -100,7 +100,7 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/ioctl.2 manpages-3.54/man2/ioctl.2 --- manpages-3.52/man2/ioctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/ioctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -146,7 +146,7 @@ .BR sd (4), .BR tty (4) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/ioctl_list.2 manpages-3.54/man2/ioctl_list.2 --- manpages-3.52/man2/ioctl_list.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/ioctl_list.2 2013-09-17 08:27:55.000000000 +0200 @@ -27,7 +27,7 @@ .\" 2007-12-29 Alain Portal and Michael Kerrisk .\" : .\" Various formatting improvements -.TH IOCTL_LIST 2 2007-12-29 "Linux" "Linux Programmer's Manual" +.TH IOCTL_LIST 2 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME ioctl_list \- list of ioctl calls in Linux/i386 kernel .SH DESCRIPTION @@ -474,6 +474,15 @@ 0x000089E1 SIOCGETSGCNT struct sioc_sg_req * // I-O .TE +// +.TS +l l l l. +0x82307201 VFAT_IOCTL_READDIR_BOTH struct dirent [2] +0x82307202 VFAT_IOCTL_READDIR_SHORT struct dirent [2] +0x80047210 FAT_IOCTL_GET_ATTRIBUTES __u32 * +0x40047211 FAT_IOCTL_SET_ATTRIBUTES const __u32 * +.TE + // .TS l l l. @@ -954,7 +963,7 @@ .SH SEE ALSO .BR ioctl (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/io_destroy.2 manpages-3.54/man2/io_destroy.2 --- manpages-3.52/man2/io_destroy.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/io_destroy.2 2013-09-17 08:27:55.000000000 +0200 @@ -89,7 +89,7 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/io_getevents.2 manpages-3.54/man2/io_getevents.2 --- manpages-3.52/man2/io_getevents.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/io_getevents.2 2013-09-17 08:27:55.000000000 +0200 @@ -108,7 +108,7 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/ioperm.2 manpages-3.54/man2/ioperm.2 --- manpages-3.52/man2/ioperm.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/ioperm.2 2013-09-17 08:27:55.000000000 +0200 @@ -123,7 +123,7 @@ .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/iopl.2 manpages-3.54/man2/iopl.2 --- manpages-3.52/man2/iopl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/iopl.2 2013-09-17 08:27:55.000000000 +0200 @@ -102,7 +102,7 @@ .BR outb (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/ioprio_set.2 manpages-3.54/man2/ioprio_set.2 --- manpages-3.52/man2/ioprio_set.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/ioprio_set.2 2013-09-17 08:27:55.000000000 +0200 @@ -229,7 +229,7 @@ One can view the current I/O scheduler via the .I /sys -file system. +filesystem. For example, the following command displays a list of all schedulers currently loaded in the kernel: .sp @@ -352,7 +352,7 @@ .I Documentation/block/ioprio.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/io_setup.2 manpages-3.54/man2/io_setup.2 --- manpages-3.52/man2/io_setup.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/io_setup.2 2013-09-17 08:27:55.000000000 +0200 @@ -102,7 +102,7 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/io_submit.2 manpages-3.54/man2/io_submit.2 --- manpages-3.52/man2/io_submit.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/io_submit.2 2013-09-17 08:27:55.000000000 +0200 @@ -104,7 +104,7 @@ .\" .SH AUTHOR .\" Kent Yoder. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/ipc.2 manpages-3.54/man2/ipc.2 --- manpages-3.52/man2/ipc.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/ipc.2 2013-09-17 08:27:55.000000000 +0200 @@ -68,7 +68,7 @@ .BR shmdt (2), .BR shmget (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/kcmp.2 manpages-3.54/man2/kcmp.2 --- manpages-3.52/man2/kcmp.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/kcmp.2 2013-09-17 08:27:55.000000000 +0200 @@ -74,8 +74,8 @@ are ignored. .TP .BR KCMP_FS -Check whether the processes share the same file system information -(i.e., file mode creation mask, working directory, and file system root). +Check whether the processes share the same filesystem information +(i.e., file mode creation mask, working directory, and filesystem root). The arguments .I idx1 and @@ -210,7 +210,7 @@ The alternative to this system call would have been to expose suitable process information via the .BR proc (5) -file system; this was deemed to be unsuitable for security reasons. +filesystem; this was deemed to be unsuitable for security reasons. See .BR clone (2) @@ -220,7 +220,7 @@ .BR clone (2), .BR unshare (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/kexec_load.2 manpages-3.54/man2/kexec_load.2 --- manpages-3.52/man2/kexec_load.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/kexec_load.2 2013-09-17 08:27:55.000000000 +0200 @@ -160,7 +160,7 @@ .BR reboot (2), .BR syscall (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/keyctl.2 manpages-3.54/man2/keyctl.2 --- manpages-3.52/man2/keyctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/keyctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -149,7 +149,7 @@ .BR keyctl_update (3), .BR request-key (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/kill.2 manpages-3.54/man2/kill.2 --- manpages-3.52/man2/kill.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/kill.2 2013-09-17 08:27:55.000000000 +0200 @@ -41,7 +41,7 @@ .\" Modified 2004-06-24 by aeb .\" Modified, 2004-11-30, after idea from emmanuel.colbus@ensimag.imag.fr .\" -.TH KILL 2 2013-02-05 "Linux" "Linux Programmer's Manual" +.TH KILL 2 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME kill \- send signal to a process .SH SYNOPSIS @@ -96,6 +96,7 @@ .B SIGCONT it suffices when the sending and receiving processes belong to the same session. +(Historically, the rules were different; see NOTES.) .SH RETURN VALUE On success (at least one signal was sent), zero is returned. On error, \-1 is returned, and @@ -150,11 +151,11 @@ .\" In the 0.* kernels things chopped and changed quite .\" a bit - MTK, 24 Jul 02 In kernels 1.0 to 1.2.2, a signal could be sent if the -effective user ID of the sender matched that of the receiver, -or the real user ID of the sender matched that of the receiver. +effective user ID of the sender matched effective user ID of the target, +or the real user ID of the sender matched the real user ID of the target. From kernel 1.2.3 until 1.3.77, a signal could be sent if the effective user ID of the sender matched either the real or effective -user ID of the receiver. +user ID of the target. The current rules, which conform to POSIX.1-2001, were adopted in kernel 1.3.78. .SH BUGS @@ -178,7 +179,7 @@ .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/killpg.2 manpages-3.54/man2/killpg.2 --- manpages-3.52/man2/killpg.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/killpg.2 2013-09-17 08:27:55.000000000 +0200 @@ -138,7 +138,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/link.2 manpages-3.54/man2/link.2 --- manpages-3.52/man2/link.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/link.2 2013-09-17 08:27:55.000000000 +0200 @@ -68,7 +68,7 @@ .BR path_resolution (7).) .TP .B EDQUOT -The user's quota of disk blocks on the file system has been exhausted. +The user's quota of disk blocks on the filesystem has been exhausted. .TP .B EEXIST .I newpath @@ -114,7 +114,7 @@ is a directory. .TP .B EPERM -The file system containing +The filesystem containing .IR oldpath " and " newpath does not support the creation of hard links. .TP @@ -126,15 +126,15 @@ .BR proc (5)). .TP .B EROFS -The file is on a read-only file system. +The file is on a read-only filesystem. .TP .B EXDEV .IR oldpath " and " newpath -are not on the same mounted file system. -(Linux permits a file system to be mounted at multiple points, but +are not on the same mounted filesystem. +(Linux permits a filesystem to be mounted at multiple points, but .BR link () does not work across different mount points, -even if the same file system is mounted on both.) +even if the same filesystem is mounted on both.) .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001 (but see NOTES). .\" SVr4 documents additional ENOLINK and @@ -143,7 +143,7 @@ .SH NOTES Hard links, as created by .BR link (), -cannot span file systems. +cannot span filesystems. Use .BR symlink (2) if this is required. @@ -179,7 +179,7 @@ creating a link, see .BR linkat (2). .SH BUGS -On NFS file systems, the return code may be wrong in case the NFS server +On NFS filesystems, the return code may be wrong in case the NFS server performs the link creation and dies before it can say so. Use .BR stat (2) @@ -195,7 +195,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/linkat.2 manpages-3.54/man2/linkat.2 --- manpages-3.52/man2/linkat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/linkat.2 2013-09-17 08:27:55.000000000 +0200 @@ -22,9 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.\" FIXME: Linux 2.6.39 added AT_EMPTY_PATH -.\" -.TH LINKAT 2 2012-05-04 "Linux" "Linux Programmer's Manual" +.TH LINKAT 2 2013-07-21 "Linux" "Linux Programmer's Manual" .SH NAME linkat \- create a file link relative to directory file descriptors .SH SYNOPSIS @@ -97,19 +95,47 @@ to the directory referred to by the file descriptor .IR newdirfd . +The following values can be bitwise ORed in +.IR flags : +.TP +.BR AT_EMPTY_PATH " (since Linux 2.6.39)" +.\" commit 11a7b371b64ef39fc5fb1b6f2218eef7c4d035e3 +If +.I oldpath +is an empty string, create a link to the file referenced by +.IR olddirfd +(which may have been obtained using the +.BR open (2) +.B O_PATH +flag). +In this case, +.I olddirfd +can refer to any type of file, not just a directory. +The caller must have the +.BR CAP_DAC_READ_SEARCH +capability in order to use this flag; +this prevents arbitrary users from creating hard links +using file descriptors received via a UNIX domain socket +(see the discussion of +.BR SCM_RIGHTS +in +.BR unix (7)). +.TP +.BR AT_SYMLINK_FOLLOW " (since Linux 2.6.18)" By default, .BR linkat (), does not dereference .I oldpath if it is a symbolic link (like .BR link (2)). -Since Linux 2.6.18, the flag +The flag .B AT_SYMLINK_FOLLOW can be specified in .I flags to cause .I oldpath to be dereferenced if it is a symbolic link. +.PP Before kernel 2.6.18, the .I flags argument was unused, and had to be specified as 0. @@ -134,6 +160,16 @@ .I newdirfd is not a valid file descriptor. .TP +.B ENOENT +.B AT_EMPTY_PATH +was specified in +.IR flags , +but the caller did not have the +.B CAP_DAC_READ_SEARCH +capability. +.TP +.B ENOTDIR +.TP .B ENOTDIR .I oldpath is relative and @@ -160,7 +196,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/listen.2 manpages-3.54/man2/listen.2 --- manpages-3.52/man2/listen.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/listen.2 2013-09-17 08:27:55.000000000 +0200 @@ -173,7 +173,7 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/listxattr.2 manpages-3.54/man2/listxattr.2 --- manpages-3.52/man2/listxattr.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/listxattr.2 2013-09-17 08:27:55.000000000 +0200 @@ -52,7 +52,7 @@ retrieves the list of extended attribute names associated with the given .I path -in the file system. +in the filesystem. The retrieved list is placed in .IR list , a caller-allocated buffer whose size (in bytes) is specified in the argument @@ -127,7 +127,7 @@ .SH ERRORS .TP .B ENOTSUP -Extended attributes are not supported by the file system, or are disabled. +Extended attributes are not supported by the filesystem, or are disabled. .TP .B ERANGE The @@ -161,7 +161,7 @@ .BR attr (5), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/llseek.2 manpages-3.54/man2/llseek.2 --- manpages-3.52/man2/llseek.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/llseek.2 2013-09-17 08:27:55.000000000 +0200 @@ -88,7 +88,7 @@ .BR lseek (2), .BR lseek64 (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/lookup_dcookie.2 manpages-3.54/man2/lookup_dcookie.2 --- manpages-3.52/man2/lookup_dcookie.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/lookup_dcookie.2 2013-09-17 08:27:55.000000000 +0200 @@ -86,7 +86,7 @@ The path returned may be suffixed by the string " (deleted)" if the directory entry has been removed. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/lseek.2 manpages-3.54/man2/lseek.2 --- manpages-3.52/man2/lseek.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/lseek.2 2013-09-17 08:27:55.000000000 +0200 @@ -130,13 +130,13 @@ For the purposes of these operations, a hole is a sequence of zeros that (normally) has not been allocated in the underlying file storage. -However, a file system is not obliged to report holes, +However, a filesystem is not obliged to report holes, so these operations are not a guaranteed mechanism for mapping the storage space actually allocated to a file. (Furthermore, a sequence of zeros that actually has been written to the underlying storage may not be reported as a hole.) In the simplest implementation, -a file system can support the operations by making +a filesystem can support the operations by making .BR SEEK_HOLE always return the offset of the end of the file, and making @@ -179,7 +179,7 @@ Or: the resulting file offset would be negative, or beyond the end of a seekable device. .\" Some systems may allow negative offsets for character devices -.\" and/or for remote file systems. +.\" and/or for remote filesystems. .TP .B EOVERFLOW .\" HP-UX 11 says EINVAL for this case (but POSIX.1 says EOVERFLOW) @@ -250,7 +250,7 @@ .BR lseek64 (3), .BR posix_fallocate (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/madvise.2 manpages-3.54/man2/madvise.2 --- manpages-3.52/man2/madvise.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/madvise.2 2013-09-17 08:27:55.000000000 +0200 @@ -103,7 +103,7 @@ and its associated backing store. Currently, .\" 2.6.18-rc5 -only shmfs/tmpfs supports this; other file systems return with the +only shmfs/tmpfs supports this; other filesystems return with the error .BR ENOSYS . .\" Databases want to use this feature to drop a section of their @@ -377,7 +377,7 @@ .BR munmap (2), .BR core (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mbind.2 manpages-3.54/man2/mbind.2 --- manpages-3.52/man2/mbind.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mbind.2 2013-09-17 08:27:55.000000000 +0200 @@ -466,7 +466,7 @@ .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/migrate_pages.2 manpages-3.54/man2/migrate_pages.2 --- manpages-3.52/man2/migrate_pages.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/migrate_pages.2 2013-09-17 08:27:55.000000000 +0200 @@ -159,7 +159,7 @@ .IR Documentation/vm/page_migration in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mincore.2 manpages-3.54/man2/mincore.2 --- manpages-3.52/man2/mincore.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mincore.2 2013-09-17 08:27:55.000000000 +0200 @@ -167,7 +167,7 @@ .BR mlock (2), .BR mmap (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mkdir.2 manpages-3.54/man2/mkdir.2 --- manpages-3.52/man2/mkdir.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mkdir.2 2013-09-17 08:27:55.000000000 +0200 @@ -36,7 +36,7 @@ The newly created directory will be owned by the effective user ID of the process. If the directory containing the file has the set-group-ID -bit set, or if the file system is mounted with BSD group semantics +bit set, or if the filesystem is mounted with BSD group semantics .RI ( "mount -o bsdgroups" or, synonymously .IR "mount -o grpid" ), @@ -61,7 +61,7 @@ .BR path_resolution (7).) .TP .B EDQUOT -The user's quota of disk blocks or inodes on the file system has been +The user's quota of disk blocks or inodes on the filesystem has been exhausted. .TP .B EEXIST @@ -108,13 +108,13 @@ is not, in fact, a directory. .TP .B EPERM -The file system containing +The filesystem containing .I pathname does not support the creation of directories. .TP .B EROFS .I pathname -refers to a file on a read-only file system. +refers to a file on a read-only filesystem. .SH CONFORMING TO SVr4, BSD, POSIX.1-2001. .\" SVr4 documents additional EIO, EMULTIHOP @@ -143,7 +143,7 @@ .BR unlink (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mkdirat.2 manpages-3.54/man2/mkdirat.2 --- manpages-3.52/man2/mkdirat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mkdirat.2 2013-09-17 08:27:55.000000000 +0200 @@ -125,7 +125,7 @@ .BR openat (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mknod.2 manpages-3.54/man2/mknod.2 --- manpages-3.52/man2/mknod.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mknod.2 2013-09-17 08:27:55.000000000 +0200 @@ -39,7 +39,7 @@ .SH DESCRIPTION The system call .BR mknod () -creates a file system node (file, device special file or +creates a filesystem node (file, device special file or named pipe) named .IR pathname , with attributes specified by @@ -95,7 +95,7 @@ The newly created node will be owned by the effective user ID of the process. If the directory containing the node has the set-group-ID -bit set, or if the file system is mounted with BSD group semantics, the +bit set, or if the filesystem is mounted with BSD group semantics, the new node will inherit the group ownership from its parent directory; otherwise it will be owned by the effective group ID of the process. .SH RETURN VALUE @@ -114,7 +114,7 @@ .BR path_resolution (7).) .TP .B EDQUOT -The user's quota of disk blocks or inodes on the file system has been +The user's quota of disk blocks or inodes on the filesystem has been exhausted. .TP .B EEXIST @@ -167,13 +167,13 @@ .\" For UNIX domain sockets and regular files, EPERM is returned only in .\" Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can .\" use mknod() to make these files. -also returned if the file system containing +also returned if the filesystem containing .I pathname does not support the type of node requested. .TP .B EROFS .I pathname -refers to a file on a read-only file system. +refers to a file on a read-only filesystem. .SH CONFORMING TO SVr4, 4.4BSD, POSIX.1-2001 (but see below). .\" The Linux version differs from the SVr4 version in that it @@ -221,7 +221,7 @@ .BR mkfifo (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mknodat.2 manpages-3.54/man2/mknodat.2 --- manpages-3.52/man2/mknodat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mknodat.2 2013-09-17 08:27:55.000000000 +0200 @@ -129,7 +129,7 @@ .BR openat (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mlock.2 manpages-3.54/man2/mlock.2 --- manpages-3.52/man2/mlock.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mlock.2 2013-09-17 08:27:55.000000000 +0200 @@ -334,7 +334,7 @@ .BR proc (5), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mmap.2 manpages-3.54/man2/mmap.2 --- manpages-3.52/man2/mmap.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mmap.2 2013-09-17 08:27:55.000000000 +0200 @@ -451,7 +451,7 @@ .\" A file could not be mapped for reading. .TP .B ENODEV -The underlying file system of the specified file does not support +The underlying filesystem of the specified file does not support memory mapping. .TP .B ENOMEM @@ -463,7 +463,7 @@ .I prot argument asks for .B PROT_EXEC -but the mapped area belongs to a file on a file system that +but the mapped area belongs to a file on a filesystem that was mounted no-exec. .\" (Since 2.4.25 / 2.6.0.) .TP @@ -735,7 +735,7 @@ .\" Repeat after me: private read-only mappings are 100% equivalent to .\" shared read-only mappings. No ifs, buts, or maybes. -- Linus .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mmap2.2 manpages-3.54/man2/mmap2.2 --- manpages-3.52/man2/mmap2.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mmap2.2 2013-09-17 08:27:55.000000000 +0200 @@ -37,7 +37,7 @@ .BI " int " flags ", int " fd ", off_t " pgoffset ); .fi .SH DESCRIPTION -This is probably not the system call you are interested; instead, see +This is probably not the system call that you are interested in; instead, see .BR mmap (2), which describes the glibc wrapper function that invokes this system call. @@ -96,7 +96,7 @@ .BR msync (2), .BR shm_open (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/modify_ldt.2 manpages-3.54/man2/modify_ldt.2 --- manpages-3.52/man2/modify_ldt.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/modify_ldt.2 2013-09-17 08:27:55.000000000 +0200 @@ -136,7 +136,7 @@ .SH SEE ALSO .BR vm86 (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mount.2 manpages-3.54/man2/mount.2 --- manpages-3.52/man2/mount.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mount.2 2013-09-17 08:27:55.000000000 +0200 @@ -39,7 +39,7 @@ .\" .TH MOUNT 2 2012-07-05 "Linux" "Linux Programmer's Manual" .SH NAME -mount \- mount file system +mount \- mount filesystem .SH SYNOPSIS .nf .B "#include " @@ -50,7 +50,7 @@ .fi .SH DESCRIPTION .BR mount () -attaches the file system specified by +attaches the filesystem specified by .I source (which is often a device name, but can also be a directory name or a dummy) to the directory specified by @@ -58,9 +58,9 @@ Appropriate privilege (Linux: the .B CAP_SYS_ADMIN -capability) is required to mount file systems. +capability) is required to mount filesystems. -Since Linux 2.4 a single file system can be visible at +Since Linux 2.4 a single filesystem can be visible at multiple mount points, and multiple mounts can be stacked on the same mount point. .\" Multiple mounts on same mount point: since 2.3.99pre7. @@ -132,8 +132,8 @@ .BR MS_BIND " (Linux 2.4 onward)" .\" since 2.4.0-test9 Perform a bind mount, making a file or a directory subtree visible at -another point within a file system. -Bind mounts may cross file system boundaries and span +another point within a filesystem. +Bind mounts may cross filesystem boundaries and span .BR chroot (2) jails. The @@ -149,13 +149,13 @@ the underlying mount point). .TP .BR MS_DIRSYNC " (since Linux 2.5.19)" -Make directory changes on this file system synchronous. +Make directory changes on this filesystem synchronous. (This property can be obtained for individual directories or subtrees using .BR chattr (1).) .TP .B MS_MANDLOCK -Permit mandatory locking on files in this file system. +Permit mandatory locking on files in this filesystem. (Mandatory locking must still be enabled on a per-file basis, as described in .BR fcntl (2).) @@ -173,13 +173,13 @@ arguments are ignored. .TP .B MS_NOATIME -Do not update access times for (all types of) files on this file system. +Do not update access times for (all types of) files on this filesystem. .TP .B MS_NODEV -Do not allow access to devices (special files) on this file system. +Do not allow access to devices (special files) on this filesystem. .TP .B MS_NODIRATIME -Do not update access times for directories on this file system. +Do not update access times for directories on this filesystem. This flag provides a subset of the functionality provided by .BR MS_NOATIME ; that is, @@ -188,26 +188,26 @@ .BR MS_NODIRATIME . .TP .B MS_NOEXEC -Do not allow programs to be executed from this file system. -.\" (Possibly useful for a file system that contains non-Linux executables. +Do not allow programs to be executed from this filesystem. +.\" (Possibly useful for a filesystem that contains non-Linux executables. .\" Often used as a security feature, e.g., to make sure that restricted .\" users cannot execute files uploaded using ftp or so.) .TP .B MS_NOSUID Do not honor set-user-ID and set-group-ID bits when executing -programs from this file system. +programs from this filesystem. .\" (This is a security feature to prevent users executing set-user-ID and .\" set-group-ID programs from removable disk devices.) .TP .B MS_RDONLY -Mount file system read-only. +Mount filesystem read-only. .\" .\" FIXME Document MS_REC, available since 2.4.11. .\" This flag has meaning in conjunction with MS_BIND and .\" also with the shared subtree flags. .TP .BR MS_RELATIME " (Since Linux 2.6.20)" -When a file on this file system is accessed, +When a file on this filesystem is accessed, update the file's last access time (atime) only if the current value of atime is less than or equal to the file's last modification time (mtime) or last status change time (ctime). @@ -233,7 +233,7 @@ .I mountflags and .I data -of an existing mount without having to unmount and remount the file system. +of an existing mount without having to unmount and remount the filesystem. .I target should be the same value specified in the initial .BR mount () @@ -268,7 +268,7 @@ .TP .BR MS_STRICTATIME " (Since Linux 2.6.30)" Always update the last access time (atime) when files on this -file system are accessed. +filesystem are accessed. (This was the default behavior before Linux 2.6.30.) Specifying this flag overrides the effect of setting the .BR MS_NOATIME @@ -277,12 +277,12 @@ flags. .TP .B MS_SYNCHRONOUS -Make writes on this file system synchronous (as though +Make writes on this filesystem synchronous (as though the .B O_SYNC flag to .BR open (2) -was specified for all file opens to this file system). +was specified for all file opens to this filesystem). .PP From Linux 2.4 onward, the .BR MS_NODEV ", " MS_NOEXEC ", and " MS_NOSUID @@ -298,9 +298,9 @@ .PP The .I data -argument is interpreted by the different file systems. +argument is interpreted by the different filesystems. Typically it is a string of comma-separated options -understood by this file system. +understood by this filesystem. See .BR mount (8) for details of the options available for each filesystem type. @@ -312,7 +312,7 @@ .SH ERRORS The error values given below result from filesystem type independent errors. -Each file-system type may have its own special errors and its +Each filesystem type may have its own special errors and its own special behavior. See the Linux kernel source code for details. .TP @@ -320,12 +320,12 @@ A component of a path was not searchable. (See also .BR path_resolution (7).) -Or, mounting a read-only file system was attempted without giving the +Or, mounting a read-only filesystem was attempted without giving the .B MS_RDONLY flag. Or, the block device .I source -is located on a file system mounted with the +is located on a filesystem mounted with the .B MS_NODEV option. .\" mtk: Probably: write permission is required for MS_BIND, with @@ -428,7 +428,7 @@ was added to \fI\fP. .LP Before Linux 2.4 an attempt to execute a set-user-ID or set-group-ID program -on a file system mounted with +on a filesystem mounted with .B MS_NOSUID would fail with .BR EPERM . @@ -438,7 +438,7 @@ .SS Per-process namespaces Starting with kernel 2.4.19, Linux provides per-process mount namespaces. -A mount namespace is the set of file system mounts that +A mount namespace is the set of filesystem mounts that are visible to a process. Mount-point namespaces can be (and usually are) shared between multiple processes, @@ -486,7 +486,7 @@ .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/move_pages.2 manpages-3.54/man2/move_pages.2 --- manpages-3.52/man2/move_pages.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/move_pages.2 2013-09-17 08:27:55.000000000 +0200 @@ -124,13 +124,13 @@ .B -EIO Unable to write back a page. The page has to be written back -in order to move it since the page is dirty and the file system +in order to move it since the page is dirty and the filesystem does not provide a migration function that would allow the move of dirty pages. .TP .B -EINVAL A dirty page cannot be moved. -The file system does not +The filesystem does not provide a migration function and has no ability to write back pages. .TP .B -ENOENT @@ -233,7 +233,7 @@ .BR migratepages (8), .BR numastat (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mprotect.2 manpages-3.54/man2/mprotect.2 --- manpages-3.52/man2/mprotect.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mprotect.2 2013-09-17 08:27:55.000000000 +0200 @@ -227,7 +227,7 @@ .BR mmap (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mq_getsetattr.2 manpages-3.54/man2/mq_getsetattr.2 --- manpages-3.52/man2/mq_getsetattr.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mq_getsetattr.2 2013-09-17 08:27:55.000000000 +0200 @@ -57,7 +57,7 @@ .BR mq_getattr (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/mremap.2 manpages-3.54/man2/mremap.2 --- manpages-3.52/man2/mremap.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/mremap.2 2013-09-17 08:27:55.000000000 +0200 @@ -212,7 +212,7 @@ \fIInside Linux\fP by Randolf Bentson, \fIThe Design of the UNIX Operating System\fP by Maurice J. Bach) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/msgctl.2 manpages-3.54/man2/msgctl.2 --- manpages-3.52/man2/msgctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/msgctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -333,8 +333,9 @@ operations are used by the .BR ipcs (1) program to provide information on allocated resources. -In the future these may modified or moved to a /proc file system -interface. +In the future these may modified or moved to a +.I /proc +filesystem interface. Various fields in the \fIstruct msqid_ds\fP were typed as @@ -357,7 +358,7 @@ .BR mq_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/msgget.2 manpages-3.54/man2/msgget.2 --- manpages-3.52/man2/msgget.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/msgget.2 2013-09-17 08:27:55.000000000 +0200 @@ -236,7 +236,7 @@ .BR mq_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/msgop.2 manpages-3.54/man2/msgop.2 --- manpages-3.52/man2/msgop.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/msgop.2 2013-09-17 08:27:55.000000000 +0200 @@ -450,7 +450,7 @@ .BR mq_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/msync.2 manpages-3.54/man2/msync.2 --- manpages-3.52/man2/msync.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/msync.2 2013-09-17 08:27:55.000000000 +0200 @@ -122,7 +122,7 @@ B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128-129 and 389-391. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/nanosleep.2 manpages-3.54/man2/nanosleep.2 --- manpages-3.52/man2/nanosleep.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/nanosleep.2 2013-09-17 08:27:55.000000000 +0200 @@ -31,7 +31,7 @@ .\" NOTES: describe case where clock_nanosleep() can be preferable. .\" NOTES: describe CLOCK_REALTIME versus CLOCK_NANOSLEEP .\" Replace crufty discussion of HZ with a pointer to time(7). -.TH NANOSLEEP 2 2009-01-19 "Linux" "Linux Programmer's Manual" +.TH NANOSLEEP 2 2013-07-30 "Linux" "Linux Programmer's Manual" .SH NAME nanosleep \- high-resolution sleep .SH SYNOPSIS @@ -209,13 +209,14 @@ counted against the sleep interval. .SH SEE ALSO .BR clock_nanosleep (2), +.BR restart_syscall (2), .BR sched_setscheduler (2), .BR timer_create (2), .BR sleep (3), .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/nfsservctl.2 manpages-3.54/man2/nfsservctl.2 --- manpages-3.52/man2/nfsservctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/nfsservctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -5,7 +5,7 @@ .\" FIXME The description of nfsservctl() on this page .\" is woefully thin. .\" -.TH NFSSERVCTL 2 2012-03-05 "Linux" "Linux Programmer's Manual" +.TH NFSSERVCTL 2 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME nfsservctl \- syscall interface to kernel nfs daemon .SH SYNOPSIS @@ -26,10 +26,12 @@ #define NFSCTL_SVC 0 /* This is a server process. */ #define NFSCTL_ADDCLIENT 1 /* Add an NFS client. */ #define NFSCTL_DELCLIENT 2 /* Remove an NFS client. */ -#define NFSCTL_EXPORT 3 /* export a file system. */ -#define NFSCTL_UNEXPORT 4 /* unexport a file system. */ -#define NFSCTL_UGIDUPDATE 5 /* update a client's UID/GID map. */ -#define NFSCTL_GETFH 6 /* get an fh (used by mountd) */ +#define NFSCTL_EXPORT 3 /* Export a filesystem. */ +#define NFSCTL_UNEXPORT 4 /* Unexport a filesystem. */ +#define NFSCTL_UGIDUPDATE 5 /* Update a client's UID/GID map + (only in Linux 2.4.x and earlier). */ +#define NFSCTL_GETFH 6 /* Get a file handle (used by mountd) + (only in Linux 2.4.x and earlier). */ struct nfsctl_arg { int ca_version; /* safeguard */ @@ -56,7 +58,7 @@ .SH CONFORMING TO This call is Linux-specific. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/nice.2 manpages-3.54/man2/nice.2 --- manpages-3.52/man2/nice.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/nice.2 2013-09-17 08:27:55.000000000 +0200 @@ -110,7 +110,7 @@ .BR setpriority (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/open.2 manpages-3.54/man2/open.2 --- manpages-3.52/man2/open.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/open.2 2013-09-17 08:27:55.000000000 +0200 @@ -47,9 +47,8 @@ .\" FIXME . Apr 08: The next POSIX revision has O_EXEC, O_SEARCH, and .\" O_TTYINIT. Eventually these may need to be documented. --mtk .\" FIXME Linux 2.6.33 has O_DSYNC, and a hidden __O_SYNC. -.\" FIXME: Linux 2.6.39 added O_PATH .\" -.TH OPEN 2 2013-02-18 "Linux" "Linux Programmer's Manual" +.TH OPEN 2 2013-08-09 "Linux" "Linux Programmer's Manual" .SH NAME open, creat \- open and possibly create a file or device .SH SYNOPSIS @@ -159,7 +158,7 @@ as if with .BR lseek (2). .B O_APPEND -may lead to corrupted files on NFS file systems if more than one process +may lead to corrupted files on NFS filesystems if more than one process appends data to a file at once. .\" For more background, see .\" http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=453946 @@ -212,7 +211,7 @@ of the process. The group ownership (group ID) is set either to the effective group ID of the process or to the group ID of the -parent directory (depending on file system type and mount options, +parent directory (depending on filesystem type and mount options, and the mode of the parent directory, see the mount options .I bsdgroups and @@ -316,9 +315,7 @@ avoid denial-of-service problems if .BR opendir (3) is called on a -FIFO or tape device, but should not be used outside of the -implementation of -.BR opendir (3). +FIFO or tape device. .TP .B O_EXCL Ensure that this call creates the file: @@ -365,7 +362,7 @@ and need to avoid reliance on NFS support for .BR O_EXCL , can create a unique file on -the same file system (e.g., incorporating hostname and PID), and use +the same filesystem (e.g., incorporating hostname and PID), and use .BR link (2) to make a link to the lockfile. If @@ -406,7 +403,7 @@ .BR read (2). This flag is intended for use by indexing or backup programs, where its use can significantly reduce the amount of disk activity. -This flag may not be effective on all file systems. +This flag may not be effective on all filesystems. One example is NFS, where the server maintains the access time. .\" The O_NOATIME flag also affects the treatment of st_atime .\" by mmap() and readdir(2), MTK, Dec 04. @@ -424,6 +421,9 @@ This is a FreeBSD extension, which was added to Linux in version 2.1.126. Symbolic links in earlier components of the pathname will still be followed. +See also +.BR O_NOPATH +below. .\" The headers from glibc 2.0.100 and later include a .\" definition of this flag; \fIkernels before 2.1.126 will ignore it if .\" used\fP. @@ -441,6 +441,97 @@ in conjunction with mandatory file locks and with file leases, see .BR fcntl (2). .TP +.BR O_PATH " (since Linux 2.6.39)" +.\" commit 1abf0c718f15a56a0a435588d1b104c7a37dc9bd +.\" commit 326be7b484843988afe57566b627fb7a70beac56 +.\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d +.\" +.\" http://thread.gmane.org/gmane.linux.man/2790/focus=3496 +.\" Subject: Re: [PATCH] open(2): document O_PATH +.\" Newsgroups: gmane.linux.man, gmane.linux.kernel +.\" +Obtain a file descriptor that can be used for two purposes: +to indicate a location in the filesystem tree and +to perform operations that act purely at the file descriptor level. +The file itself is not opened, and other file operations (e.g., +.BR read (2), +.BR write (2), +.BR fchmod (2), +.BR fchown (2), +.BR fgetxattr (2), +.BR mmap (2)) +fail with the error +.BR EBADF . + +The following operations +.I can +be performed on the resulting file descriptor: +.RS +.IP * 3 +.BR close (2); +.BR fchdir (2) +(since Linux 3.5); +.\" commit 332a2e1244bd08b9e3ecd378028513396a004a24 +.BR fstat (2) +(since Linux 3.6). +.\" fstat(): commit 55815f70147dcfa3ead5738fd56d3574e2e3c1c2 +.IP * +Duplicating the file descriptor +.RB ( dup (2), +.BR fcntl (2) +.BR F_DUPFD , +etc.). +.IP * +Getting and setting file descriptor flags +.RB ( fcntl (2) +.BR F_GETFD +and +.BR F_SETFD ). +.IP * +Retrieving open file status flags using the +.BR fcntl (2) +.BR F_GETFL +operation: the returned flags will include the bit +.BR O_PATH . + +.IP * +Passing the file descriptor as the +.IR dirfd +argument of +.BR openat (2) +and the other "*at()" system calls. +.IP * +Passing the file descriptor to another process via a UNIX domain socket +(see +.BR SCM_RIGHTS +in +.BR unix (7)). +.RE +.IP +When +.B O_PATH +is specified in +.IR flags , +flag bits other than +.BR O_DIRECTORY +and +.BR O_NOFOLLOW +are ignored. + +If the +.BR O_NOFOLLOW +flag is also specified, +then the call returns a file descriptor referring to the symbolic link. +This file descriptor can be used as the +.I dirfd +argument in calls to +.BR fchownat (2), +.BR fstatat (2), +.BR linkat (2), +and +.BR readlinkat (2) +with an empty pathname to have the calls operate on the symbolic link. +.TP .B O_SYNC The file is opened for synchronous I/O. Any @@ -497,7 +588,7 @@ Where .B O_CREAT is specified, the file does not exist, and the user's quota of disk -blocks or inodes on the file system has been exhausted. +blocks or inodes on the filesystem has been exhausted. .TP .B EEXIST .I pathname @@ -520,6 +611,13 @@ the call was interrupted by a signal handler; see .BR signal (7). .TP +.B EINVAL +The filesystem does not support the +.BR O_DIRECT +flag. See +.BR NOTES +for more information. +.TP .B EISDIR .I pathname refers to a directory and the access requested involved writing @@ -606,13 +704,13 @@ The .B O_NOATIME flag was specified, but the effective user ID of the caller -.\" Strictly speaking, it's the file system UID... (MTK) +.\" Strictly speaking, it's the filesystem UID... (MTK) did not match the owner of the file and the caller was not privileged .RB ( CAP_FOWNER ). .TP .B EROFS .I pathname -refers to a file on a read-only file system and write access was +refers to a file on a read-only filesystem and write access was requested. .TP .B ETXTBSY @@ -631,8 +729,9 @@ The .BR O_DIRECTORY , .BR O_NOATIME , +.BR O_NOFOLLOW , and -.B O_NOFOLLOW +.BR O_PATH flags are Linux-specific, and one may need to define .B _GNU_SOURCE (before including @@ -719,7 +818,7 @@ .B O_RSYNC to the same numerical value as .BR O_SYNC . -Most Linux file systems don't actually implement the POSIX +Most Linux filesystems don't actually implement the POSIX .B O_SYNC semantics, which require all metadata updates of a write to be on disk on returning to user space, but only the @@ -735,7 +834,7 @@ .BR mknod (2) instead. .LP -On NFS file systems with UID mapping enabled, +On NFS filesystems with UID mapping enabled, .BR open () may return a file descriptor but, for example, @@ -773,12 +872,12 @@ flag may impose alignment restrictions on the length and address of user-space buffers and the file offset of I/Os. In Linux alignment -restrictions vary by file system and kernel version and might be +restrictions vary by filesystem and kernel version and might be absent entirely. -However there is currently no file system\-independent +However there is currently no filesystem\-independent interface for an application to discover these restrictions for a given -file or file system. -Some file systems provide their own interfaces +file or filesystem. +Some filesystems provide their own interfaces for doing so, for example the .B XFS_IOC_DIOINFO operation in @@ -786,7 +885,7 @@ .LP Under Linux 2.4, transfer sizes, and the alignment of the user buffer and the file offset must all be multiples of the logical block size -of the file system. +of the filesystem. Under Linux 2.6, alignment to 512-byte boundaries suffices. .LP .B O_DIRECT @@ -836,7 +935,7 @@ .B O_DIRECT support was added under Linux in kernel version 2.4.10. Older Linux kernels simply ignore this flag. -Some file systems may not implement the flag and +Some filesystems may not implement the flag and .BR open () will fail with .B EINVAL @@ -846,7 +945,7 @@ .B O_DIRECT and normal I/O to the same file, and especially to overlapping byte regions in the same file. -Even when the file system correctly handles the coherency issues in +Even when the filesystem correctly handles the coherency issues in this situation, overall I/O throughput is likely to be slower than using either mode alone. Likewise, applications should avoid mixing @@ -855,7 +954,7 @@ .LP The behaviour of .B O_DIRECT -with NFS will differ from local file systems. +with NFS will differ from local filesystems. Older kernels, or kernels configured in certain ways, may not support this combination. The NFS protocol does not support passing the flag to the server, so @@ -921,7 +1020,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/openat.2 manpages-3.54/man2/openat.2 --- manpages-3.52/man2/openat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/openat.2 2013-09-17 08:27:55.000000000 +0200 @@ -178,7 +178,7 @@ .BR mkfifoat (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/outb.2 manpages-3.54/man2/outb.2 --- manpages-3.52/man2/outb.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/outb.2 2013-09-17 08:27:55.000000000 +0200 @@ -97,7 +97,7 @@ .BR ioperm (2), .BR iopl (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/pause.2 manpages-3.54/man2/pause.2 --- manpages-3.52/man2/pause.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/pause.2 2013-09-17 08:27:55.000000000 +0200 @@ -62,7 +62,7 @@ .BR signal (2), .BR sigsuspend (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/pciconfig_read.2 manpages-3.54/man2/pciconfig_read.2 --- manpages-3.52/man2/pciconfig_read.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/pciconfig_read.2 2013-09-17 08:27:55.000000000 +0200 @@ -114,7 +114,7 @@ .SH SEE ALSO .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/perf_event_open.2 manpages-3.54/man2/perf_event_open.2 --- manpages-3.52/man2/perf_event_open.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/perf_event_open.2 2013-09-17 08:27:55.000000000 +0200 @@ -24,7 +24,7 @@ .\" This document is based on the perf_event.h header file, the .\" tools/perf/design.txt file, and a lot of bitter experience. .\" -.TH PERF_EVENT_OPEN 2 2013-07-02 "Linux" "Linux Programmer's Manual" +.TH PERF_EVENT_OPEN 2 2013-09-13 "Linux" "Linux Programmer's Manual" .SH NAME perf_event_open \- set up performance monitoring .SH SYNOPSIS @@ -164,7 +164,7 @@ This flag activates per-container system-wide monitoring. A container is an abstraction that isolates a set of resources for finer grain -control (CPUs, memory, etc...). +control (CPUs, memory, etc.). In this mode, the event is measured only if the thread running on the monitored CPU belongs to the designated container (cgroup). @@ -379,12 +379,12 @@ .TP .B PERF_COUNT_HW_CPU_CYCLES Total cycles. -Be wary of what happens during CPU frequency scaling +Be wary of what happens during CPU frequency scaling. .TP .B PERF_COUNT_HW_INSTRUCTIONS Retired instructions. Be careful, these can be affected by various -issues, most notably hardware interrupt counts +issues, most notably hardware interrupt counts. .TP .B PERF_COUNT_HW_CACHE_REFERENCES Cache accesses. @@ -654,8 +654,13 @@ Usually returned by tracepoint events. .TP .BR PERF_SAMPLE_BRANCH_STACK " (Since Linux 3.4)" -Records the branch stack. -See branch_sample_type. +This provides a record of recent branches, as provided +by CPU branch sampling hardware (such as Intel Last Branch Record). +Not all hardware supports this feature. + +See the +.I branch_sample_type +field for how to filter which branches are reported. .TP .BR PERF_SAMPLE_REGS_USER " (Since Linux 3.7)" Records the current user-level CPU register state @@ -831,15 +836,15 @@ .TP 0 - .B SAMPLE_IP -can have arbitrary skid +can have arbitrary skid. .TP 1 - .B SAMPLE_IP -must have constant skid +must have constant skid. .TP 2 - .B SAMPLE_IP -requested to have 0 skid +requested to have 0 skid. .TP 3 - .B SAMPLE_IP @@ -863,10 +868,10 @@ is selected. .TP .IR "exclude_host" " (Since Linux 3.2)" -Do not measure time spent in VM host +Do not measure time spent in VM host. .TP .IR "exclude_guest" " (Since Linux 3.2)" -Do not measure time spent in VM guest +Do not measure time spent in VM guest. .TP .IR "exclude_callchain_kernel" " (Since Linux 3.7)" Do not include kernel callchains. @@ -900,19 +905,19 @@ .RS .TP .BR HW_BREAKPOINT_EMPTY -no breakpoint +No breakpoint. .TP .BR HW_BREAKPOINT_R -count when we read the memory location +Count when we read the memory location. .TP .BR HW_BREAKPOINT_W -count when we write the memory location +Count when we write the memory location. .TP .BR HW_BREAKPOINT_RW -count when we read or write the memory location +Count when we read or write the memory location. .TP .BR HW_BREAKPOINT_X -count when we execute code at the memory location +Count when we execute code at the memory location. .LP The values can be combined via a bitwise or, but the combination of @@ -960,34 +965,57 @@ field. .TP .IR "branch_sample_type" " (Since Linux 3.4)" -This is used with the CPUs hardware branch sampling, if available. -It can have one of the following values: +If +.B PERF_SAMPLE_BRANCH_STACK +is enabled, then this specifies what branches to include +in the branch record. + +The first part of the value is the privilege level, which +is a combination of one of the following values. +If the user does not set privilege level explicitly, the kernel +will use the event's privilege level. +Event and branch privilege levels do not have to match. .RS .TP .B PERF_SAMPLE_BRANCH_USER -Branch target is in user space +Branch target is in user space. .TP .B PERF_SAMPLE_BRANCH_KERNEL -Branch target is in kernel space +Branch target is in kernel space. .TP .B PERF_SAMPLE_BRANCH_HV -Branch target is in hypervisor +Branch target is in hypervisor. +.TP +.B PERF_SAMPLE_BRANCH_PLM_ALL +A convenience value that is the three preceding values ORed together. + +.P +In addition to the privilege value, at least one or more of the +following bits must be set. + .TP .B PERF_SAMPLE_BRANCH_ANY Any branch type. .TP .B PERF_SAMPLE_BRANCH_ANY_CALL -Any call branch +Any call branch. .TP .B PERF_SAMPLE_BRANCH_ANY_RETURN -Any return branch +Any return branch. +.TP +.B PERF_SAMPLE_BRANCH_IND_CALL +Indirect calls. .TP -.BR PERF_SAMPLE_BRANCH_IND_CALL -Indirect calls +.BR PERF_SAMPLE_BRANCH_ABORT_TX " (Since Linux 3.11)" +Transactional memory aborts. .TP -.BR PERF_SAMPLE_BRANCH_PLM_ALL -User, kernel, and hv +.BR PERF_SAMPLE_BRANCH_IN_TX " (Since Linux 3.11)" +Branch in transactional memory transaction. +.TP +.BR PERF_SAMPLE_BRANCH_NO_TX " (Since Linux 3.11)" +Branch not in transactional memory transaction. .RE + .TP .IR "sample_regs_user" " (Since Linux 3.7)" This bitmask defines the set of user CPU registers to dump on samples. @@ -1155,7 +1183,7 @@ Time the event was running. .TP .I cap_usr_time -User time capability +User time capability. .TP .I cap_usr_rdpmc If the hardware supports user-space read of performance counters @@ -1274,7 +1302,7 @@ below, it will be stashed just after the .I perf_event_header and the fields already present for the existing -fields, i.e., at the end of the payload. +fields, that is, at the end of the payload. That way a newer perf.data file will be supported by older perf tools, with these new optional fields being ignored. @@ -1294,6 +1322,60 @@ Below, we describe the .I perf_event_header fields in more detail. +For ease of reading, +the fields with shorter descriptions are presented first. +.TP +.I size +This indicates the size of the record. +.TP +.I misc +The +.I misc +field contains additional information about the sample. + +The CPU mode can be determined from this value by masking with +.B PERF_RECORD_MISC_CPUMODE_MASK +and looking for one of the following (note these are not +bit masks, only one can be set at a time): +.RS +.TP +.B PERF_RECORD_MISC_CPUMODE_UNKNOWN +Unknown CPU mode. +.TP +.B PERF_RECORD_MISC_KERNEL +Sample happened in the kernel. +.TP +.B PERF_RECORD_MISC_USER +Sample happened in user code. +.TP +.B PERF_RECORD_MISC_HYPERVISOR +Sample happened in the hypervisor. +.TP +.B PERF_RECORD_MISC_GUEST_KERNEL +Sample happened in the guest kernel. +.TP +.B PERF_RECORD_MISC_GUEST_USER +Sample happened in guest user code. +.RE + +.RS +In addition, one of the following bits can be set: +.TP +.B PERF_RECORD_MISC_MMAP_DATA +This is set when the mapping is not executable; +otherwise the mapping is executable. +.TP +.B PERF_RECORD_MISC_EXACT_IP +This indicates that the content of +.B PERF_SAMPLE_IP +points +to the actual instruction that triggered the event. +See also +.IR perf_event_attr.precise_ip . +.TP +.B PERF_RECORD_MISC_EXT_RESERVED +This indicates there is extended data available (currently not used). +.RE .TP .I type The @@ -1447,8 +1529,8 @@ u64 data_src; /* if PERF_SAMPLE_DATA_SRC */ }; .fi -.RS -.TP +.RS 4 +.TP 4 .I ip If .B PERF_SAMPLE_IP @@ -1545,9 +1627,43 @@ the number of records is included, followed by .I bnr .I perf_branch_entry -structures. -These structures have from, to, and flags values indicating -the from and to addresses from the branches on the callstack. +structures which each include the fields: +.RS +.TP +.I from +This indicates the source instruction (may not be a branch). +.TP +.I to +The branch target. +.TP +.I mispred +The branch target was mispredicted. +.TP +.I predicted +The branch target was predicted. +.TP +.IR in_tx " (Since Linux 3.11)" +The branch was in a transactional memory transaction. +.TP +.IR abort " (Since Linux 3.11)" +The branch was in an aborted transactional memory transaction. + +.P +The entries are from most to least recent, so the first entry +has the most recent branch. + +Support for +.I mispred +and +.I predicted +is optional; if not supported, both +values will be 0. + +The type of branches recorded is specified by the +.I branch_sample_type +field. +.RE + .TP .IR abi ", " regs[weight(mask)] If @@ -1582,13 +1698,12 @@ is the stack data. .I dyn_size is the amount of data actually dumped (can be less than -.I size -). +.IR size ). .TP .I weight If .B PERF_SAMPLE_WEIGHT -is enabled, then a 64 bit value provided by the hardwre +is enabled, then a 64 bit value provided by the hardware is recorded that indicates how costly the event was. This allows expensive events to stand out more clearly in profiles. @@ -1599,141 +1714,148 @@ is enabled, then a 64 bit value is recorded that is made up of the following fields: .RS -.TP +.TP 4 .I mem_op -type of opcode, a bitwise combination of +Type of opcode, a bitwise combination of: + +.PD 0 +.RS +.TP 24 .B PERF_MEM_OP_NA -(not available), +Not available +.TP .B PERF_MEM_OP_LOAD -(load instruction), +Load instruction +.TP .B PERF_MEM_OP_STORE -(store instruction), +Store instruction +.TP .B PERF_MEM_OP_PFETCH -(prefetch), and +Prefetch +.TP .B PERF_MEM_OP_EXEC -(executable code). +Executable code +.RE +.PD .TP .I mem_lvl -memory hierarchy level hit or miss, a bitwise combination of +Memory hierarchy level hit or miss, a bitwise combination of: + +.PD 0 +.RS +.TP 24 .B PERF_MEM_LVL_NA -(not available), +Not available +.TP .B PERF_MEM_LVL_HIT -(hit), +Hit +.TP .B PERF_MEM_LVL_MISS -(miss), +Miss +.TP .B PERF_MEM_LVL_L1 -(level 1 cache), +Level 1 cache +.TP .B PERF_MEM_LVL_LFB -(line fill buffer), +Line fill buffer +.TP .B PERF_MEM_LVL_L2 -(level 2 cache), +Level 2 cache +.TP .B PERF_MEM_LVL_L3 -(level 3 cache), +Level 3 cache +.TP .B PERF_MEM_LVL_LOC_RAM -(local DRAM), +Local DRAM +.TP .B PERF_MEM_LVL_REM_RAM1 -(remote DRAM 1 hop), +Remote DRAM 1 hop +.TP .B PERF_MEM_LVL_REM_RAM2 -(remote DRAM 2 hops), +Remote DRAM 2 hops +.TP .B PERF_MEM_LVL_REM_CCE1 -(remote cache 1 hop), +Remote cache 1 hop +.TP .B PERF_MEM_LVL_REM_CCE2 -(remote Cache 2 hops), +Remote cache 2 hops +.TP .B PERF_MEM_LVL_IO -(I/O memory), and +I/O memory +.TP .B PERF_MEM_LVL_UNC -(uncached memory). +Uncached memory +.RE +.PD .TP .I mem_snoop -snoop mode, a bitwise combination of +Snoop mode, a bitwise combination of: + +.PD 0 +.RS +.TP 24 .B PERF_MEM_SNOOP_NA -(not available), +Not available +.TP .B PERF_MEM_SNOOP_NONE -(no snoop), +No snoop +.TP .B PERF_MEM_SNOOP_HIT -(snoop hit), +Snoop hit +.TP .B PERF_MEM_SNOOP_MISS -(snoop miss), and +Snoop miss +.TP .B PERF_MEM_SNOOP_HITM -(snoop hit modified). +Snoop hit modified +.RE +.PD .TP .I mem_lock -lock instruction, a bitwise combination of +Lock instruction, a bitwise combination of: + +.PD 0 +.RS +.TP 24 .B PERF_MEM_LOCK_NA -(not available) and +Not available +.TP .B PERF_MEM_LOCK_LOCKED -(locked transaction). +Locked transaction +.RE +.PD .TP .I mem_dtlb -tlb access hit or miss, a bitwise combination of +TLB access hit or miss, a bitwise combination of: + +.PD 0 +.RS +.TP 24 .B PERF_MEM_TLB_NA -(not available), +Not available +.TP .B PERF_MEM_TLB_HIT -(hit), +Hit +.TP .B PERF_MEM_TLB_MISS -(miss), +Miss +.TP .B PERF_MEM_TLB_L1 -(level 1 TLB), +Level 1 TLB +.TP .B PERF_MEM_TLB_L2 -(level 2 TLB), +Level 2 TLB +.TP .B PERF_MEM_TLB_WK -(hardware walker), and +Hardware walker +.TP .B PERF_MEM_TLB_OS -(OS fault handler). +OS fault handler .RE +.PD .RE .RE -.TP -.I misc -The -.I misc -field contains additional information about the sample. - -The CPU mode can be determined from this value by masking with -.B PERF_RECORD_MISC_CPUMODE_MASK -and looking for one of the following (note these are not -bit masks, only one can be set at a time): -.RS -.TP -.B PERF_RECORD_MISC_CPUMODE_UNKNOWN -Unknown CPU mode. -.TP -.B PERF_RECORD_MISC_KERNEL -Sample happened in the kernel. -.TP -.B PERF_RECORD_MISC_USER -Sample happened in user code. -.TP -.B PERF_RECORD_MISC_HYPERVISOR -Sample happened in the hypervisor. -.TP -.B PERF_RECORD_MISC_GUEST_KERNEL -Sample happened in the guest kernel. -.TP -.B PERF_RECORD_MISC_GUEST_USER -Sample happened in guest user code. .RE - -In addition, one of the following bits can be set: -.RS -.TP -.B PERF_RECORD_MISC_MMAP_DATA -This is set when the mapping is not executable; -otherwise the mapping is executable. -.TP -.B PERF_RECORD_MISC_EXACT_IP -This indicates that the content of -.B PERF_SAMPLE_IP -points -to the actual instruction that triggered the event. -See also -.IR perf_event_attr.precise_ip . -.TP -.B PERF_RECORD_MISC_EXT_RESERVED -This indicates there is extended data available (currently not used). -.TP -.I size -This indicates the size of the record. .RE .SS Signal overflow Events can be set to deliver a signal when a threshold is crossed. @@ -1803,7 +1925,8 @@ If the .B PERF_IOC_FLAG_GROUP bit is set in the ioctl argument, then all events in a group are -enabled, even if the event specified is not the group leader. +enabled, even if the event specified is not the group leader +(but see BUGS). .TP .B PERF_EVENT_IOC_DISABLE Disables the individual counter or event group specified by the @@ -1819,7 +1942,8 @@ If the .B PERF_IOC_FLAG_GROUP bit is set in the ioctl argument, then all events in a group are -disabled, even if the event specified is not the group leader. +disabled, even if the event specified is not the group leader +(but see BUGS). .TP .B PERF_EVENT_IOC_REFRESH Non-inherited overflow counters can use this @@ -1837,7 +1961,7 @@ .TP .B PERF_EVENT_IOC_RESET Reset the event count specified by the -file descriptor argumentto zero. +file descriptor argument to zero. This resets only the counts; there is no way to reset the multiplexing .I time_enabled @@ -1848,14 +1972,8 @@ If the .B PERF_IOC_FLAG_GROUP bit is set in the ioctl argument, then all events in a group are -reset, even if the event specified is not the group leader. - -If the -.B PERF_IOC_FLAG_GROUP -bit is not set, then the behavior is somwhat unexpected: -when sent to a group leader only the leader is reset -(children are left alone); -when sent to a child all events in a group are reset. +reset, even if the event specified is not the group leader +(but see BUGS). .TP .B PERF_EVENT_IOC_PERIOD IOC_PERIOD is the command to update the period; it @@ -1899,15 +2017,17 @@ The .I perf_event_paranoid file can be set to restrict access to the performance counters. - -2 - only allow user-space measurements - -1 - (default) allow both kernel and user measurements - -0 - allow access to CPU-specific data but not raw tracepoint samples - -\-1 - no restrictions - +.RS +.IP 2 4 +only allow user-space measurements. +.IP 1 +allow both kernel and user measurements (default). +.IP 0 +allow access to CPU-specific data but not raw tracepoint samples. +.IP \-1 +no restrictions. +.RE +.IP The existence of the .I perf_event_paranoid file is the official method for determining if a kernel supports @@ -1926,6 +2046,7 @@ Maximum number of pages an unprivileged user can mlock (2) . The default is 516 (kB). + .RE Files in .I /sys/bus/event_source/devices/ @@ -1936,30 +2057,61 @@ .IR /sys/bus/event_source/devices/ . Each subdirectory corresponds to a different PMU. .TP -.I /sys/bus/event_source/devices/*/type +.IR /sys/bus/event_source/devices/*/type " (Since Linux 2.6.38)" This contains an integer that can be used in the .I type field of perf_event_attr to indicate you wish to use this PMU. .TP -.I /sys/bus/event_source/devices/*/rdpmc -[To be documented] -.TP -.I /sys/bus/event_source/devices/*/format/ -This sub-directory contains information on what bits in the +.IR /sys/bus/event_source/devices/*/rdpmc " (Since Linux 3.4)" +If this file is 1, then direct user-space access to the +performance counter registers is allowed via the rdpmc instruction. +This can be disabled by echoing 0 to the file. +.TP +.IR /sys/bus/event_source/devices/*/format/ " (Since Linux 3.4)" +This sub-directory contains information on the architecture-specific +sub-fields available for programming the various .I config -field of perf_event_attr correspond to. +fields in the perf_event_attr struct. + +The content of each file is the name of the config field, followed +by a colon, followed by a series of integer bit ranges separated by +commas. +For example, the file +.I event +may contain the value +.I config1:1,6-10,44 +which indicates that event is an attribute that occupies bits 1,6-10, and 44 +of perf_event_attr::config1. .TP -.I /sys/bus/event_source/devices/*/events/ +.IR /sys/bus/event_source/devices/*/events/ " (Since Linux 3.4)" This sub-directory contains files with pre-defined events. The contents are strings describing the event settings -expressed in terms of the fields found in the +expressed in terms of the fields found in the previously mentioned .I ./format/ directory. These are not necessarily complete lists of all events supported by a PMU, but usually a subset of events deemed useful or interesting. + +The content of each file is a list of attribute names +separated by commas. +Each entry has an optional value (either hex or decimal). +If no value is specified than it is assumed to be a single-bit +field with a value of 1. +An example entry may look like this: +.IR event=0x2,inv,ldlat=3 . .TP .I /sys/bus/event_source/devices/*/uevent -[To be documented] +This file is the standard kernel device interface +for injecting hotplug events. +.TP +.IR /sys/bus/event_source/devices/*/cpumask " (Since Linux 3.7)" +The +.I cpumask +file contains a comma-separated list of integers that +indicate a representative CPU number for each socket (package) +on the motherboard. +This is needed when setting up uncore or northbridge events, as +those PMUs present socket-wide events. .RE .SH RETURN VALUE .BR perf_event_open () @@ -2042,6 +2194,12 @@ was chosen if the union has a non-zero value in it. +From Linux 2.6.31 to Linux 3.4, the +.B PERF_IOC_FLAG_GROUP +ioctl argument was broken and would repeatedly operate +on the event specified rather than iterating across +all sibling events in a group. + Always double-check your results! Various generalized events have had wrong values. For example, retired branches measured @@ -2112,7 +2270,7 @@ .BR prctl (2), .BR read (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/perfmonctl.2 manpages-3.54/man2/perfmonctl.2 --- manpages-3.52/man2/perfmonctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/perfmonctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -207,7 +207,7 @@ The perfmon2 interface specification .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/personality.2 manpages-3.54/man2/personality.2 --- manpages-3.52/man2/personality.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/personality.2 2013-09-17 08:27:55.000000000 +0200 @@ -70,7 +70,7 @@ is Linux-specific and should not be used in programs intended to be portable. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/pipe.2 manpages-3.54/man2/pipe.2 --- manpages-3.52/man2/pipe.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/pipe.2 2013-09-17 08:27:55.000000000 +0200 @@ -195,7 +195,7 @@ .BR popen (3), .BR pipe (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/pivot_root.2 manpages-3.54/man2/pivot_root.2 --- manpages-3.52/man2/pivot_root.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/pivot_root.2 2013-09-17 08:27:55.000000000 +0200 @@ -9,7 +9,7 @@ .\" .TH PIVOT_ROOT 2 2012-07-13 "Linux" "Linux Programmer's Manual" .SH NAME -pivot_root \- change the root file system +pivot_root \- change the root filesystem .SH SYNOPSIS .BI "int pivot_root(const char *" new_root ", const char *" put_old ); @@ -17,8 +17,8 @@ There is no glibc wrapper for this system call; see NOTES. .SH DESCRIPTION .BR pivot_root () -moves the root file system of the calling process to the -directory \fIput_old\fP and makes \fInew_root\fP the new root file system +moves the root filesystem of the calling process to the +directory \fIput_old\fP and makes \fInew_root\fP the new root filesystem of the calling process. .\" .\" The @@ -28,8 +28,8 @@ The typical use of .BR pivot_root () is during system startup, when the -system mounts a temporary root file system (e.g., an \fBinitrd\fP), then -mounts the real root file system, and eventually turns the latter into +system mounts a temporary root filesystem (e.g., an \fBinitrd\fP), then +mounts the real root filesystem, and eventually turns the latter into the current root of all relevant processes or threads. .BR pivot_root () @@ -56,9 +56,9 @@ is necessary in order to prevent kernel threads from keeping the old root directory busy with their root and current working directory, even if they never access -the file system in any way. +the filesystem in any way. In the future, there may be a mechanism for -kernel threads to explicitly relinquish any access to the file system, +kernel threads to explicitly relinquish any access to the filesystem, such that this fairly intrusive mechanism can be removed from .BR pivot_root (). @@ -74,14 +74,14 @@ .IP \- 3 They must be directories. .IP \- 3 -\fInew_root\fP and \fIput_old\fP must not be on the same file system as +\fInew_root\fP and \fIput_old\fP must not be on the same filesystem as the current root. .IP \- 3 \fIput_old\fP must be underneath \fInew_root\fP, that is, adding a nonzero number of \fI/..\fP to the string pointed to by \fIput_old\fP must yield the same directory as \fInew_root\fP. .IP \- 3 -No other file system may be mounted on \fIput_old\fP. +No other filesystem may be mounted on \fIput_old\fP. .PP See also .BR pivot_root (8) @@ -92,11 +92,11 @@ or .BR pivot_root (), see also below), not the old root directory, but the -mount point of that file system is mounted on \fIput_old\fP. +mount point of that filesystem is mounted on \fIput_old\fP. \fInew_root\fP does not have to be a mount point. In this case, -\fI/proc/mounts\fP will show the mount point of the file system containing +\fI/proc/mounts\fP will show the mount point of the filesystem containing \fInew_root\fP as root (\fI/\fP). .SH RETURN VALUE On success, zero is returned. @@ -109,8 +109,8 @@ Additionally, it may return: .TP .B EBUSY -\fInew_root\fP or \fIput_old\fP are on the current root file system, -or a file system is already mounted on \fIput_old\fP. +\fInew_root\fP or \fIput_old\fP are on the current root filesystem, +or a filesystem is already mounted on \fIput_old\fP. .TP .B EINVAL \fIput_old\fP is not underneath \fInew_root\fP. @@ -147,7 +147,7 @@ .BR initrd (4), .BR pivot_root (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/poll.2 manpages-3.54/man2/poll.2 --- manpages-3.52/man2/poll.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/poll.2 2013-09-17 08:27:55.000000000 +0200 @@ -28,7 +28,7 @@ .\" 2006-07-01, mtk, Added POLLRDHUP + various other wording and .\" formatting changes. .\" -.TH POLL 2 2012-08-17 "Linux" "Linux Programmer's Manual" +.TH POLL 2 2013-09-04 "Linux" "Linux Programmer's Manual" .SH NAME poll, ppoll \- wait for some event on a file descriptor .SH SYNOPSIS @@ -122,12 +122,12 @@ The .I timeout -argument specifies the minimum number of milliseconds that +argument specifies the number of milliseconds that .BR poll () -will block. -(This interval will be rounded up to the system clock granularity, +should block waiting for a file descriptor to become ready. +This interval will be rounded up to the system clock granularity, and kernel scheduling delays mean that the blocking interval -may overrun by a small amount.) +may overrun by a small amount. Specifying a negative value in .I timeout means an infinite timeout. @@ -364,11 +364,12 @@ BUGS section of .BR select (2). .SH SEE ALSO +.BR restart_syscall (2), .BR select (2), .BR select_tut (2), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/posix_fadvise.2 manpages-3.54/man2/posix_fadvise.2 --- manpages-3.52/man2/posix_fadvise.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/posix_fadvise.2 2013-09-17 08:27:55.000000000 +0200 @@ -195,7 +195,7 @@ .BR posix_madvise (3) .\" FIXME . Write a posix_fadvise(3) page. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/prctl.2 manpages-3.54/man2/prctl.2 --- manpages-3.52/man2/prctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/prctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -980,7 +980,7 @@ .BR signal (2), .BR core (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/pread.2 manpages-3.54/man2/pread.2 --- manpages-3.52/man2/pread.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/pread.2 2013-09-17 08:27:55.000000000 +0200 @@ -161,7 +161,7 @@ .BR readv (2), .BR write (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/process_vm_readv.2 manpages-3.54/man2/process_vm_readv.2 --- manpages-3.52/man2/process_vm_readv.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/process_vm_readv.2 2013-09-17 08:27:55.000000000 +0200 @@ -332,7 +332,7 @@ .BR readv (2), .BR writev (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/ptrace.2 manpages-3.54/man2/ptrace.2 --- manpages-3.52/man2/ptrace.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/ptrace.2 2013-09-17 08:27:55.000000000 +0200 @@ -41,7 +41,7 @@ .\" (Thanks to Blaisorblade, Daniel Jacobowitz and others who helped.) .\" 2011-09, major update by Denys Vlasenko .\" -.TH PTRACE 2 2013-02-16 "Linux" "Linux Programmer's Manual" +.TH PTRACE 2 2013-07-11 "Linux" "Linux Programmer's Manual" .SH NAME ptrace \- process trace .SH SYNOPSIS @@ -255,18 +255,6 @@ .B iov.len to indicate the actual number of bytes returned. .TP -.BR PTRACE_GETSIGINFO " (since Linux 2.3.99-pre6)" -Retrieve information about the signal that caused the stop. -Copy a -.I siginfo_t -structure (see -.BR sigaction (2)) -from the tracee to the address -.I data -in the tracer. -.RI ( addr -is ignored.) -.TP .BR PTRACE_SETREGS ", " PTRACE_SETFPREGS Modify the tracee's general-purpose or floating-point registers, respectively, from the address @@ -301,6 +289,18 @@ is analogous to .BR PTRACE_GETREGSET . .TP +.BR PTRACE_GETSIGINFO " (since Linux 2.3.99-pre6)" +Retrieve information about the signal that caused the stop. +Copy a +.I siginfo_t +structure (see +.BR sigaction (2)) +from the tracee to the address +.I data +in the tracer. +.RI ( addr +is ignored.) +.TP .BR PTRACE_SETSIGINFO " (since Linux 2.3.99-pre6)" Set signal information: copy a @@ -340,7 +340,12 @@ .BR clone (2) and automatically start tracing the newly cloned process, which will start with a -.BR SIGSTOP . +.BR SIGSTOP , +or +.B PTRACE_EVENT_STOP +if +.B PTRACE_SEIZE +was used. A .BR waitpid (2) by the tracer will return a @@ -421,7 +426,12 @@ .BR fork (2) and automatically start tracing the newly forked process, which will start with a -.BR SIGSTOP . +.BR SIGSTOP , +or +.B PTRACE_EVENT_STOP +if +.B PTRACE_SEIZE +was used. A .BR waitpid (2) by the tracer will return a @@ -449,7 +459,12 @@ .BR vfork (2) and automatically start tracing the newly vforked process, which will start with a -.BR SIGSTOP . +.BR SIGSTOP , +or +.B PTRACE_EVENT_STOP +if +.B PTRACE_SEIZE +was used. A .BR waitpid (2) by the tracer will return a @@ -598,14 +613,28 @@ .TP .BR PTRACE_INTERRUPT " (since Linux 3.4)" Stop a tracee. -If the tracee is running, it will stop with -.BR PTRACE_EVENT_STOP . -If the tracee is already stopped by a signal, or receives a signal -in parallel with -.BR PTRACE_INTERRUPT , -it may report a group-stop -or a signal-delivery-stop instead of -.BR PTRACE_EVENT_STOP . +If the tracee is running or sleeping in kernel space and +.B PTRACE_SYSCALL +is in effect, +the system call is interrupted and syscall-exit-stop is reported. +(The interrupted system call is restarted when the tracee is restarted.) +If the tracee was already stopped by a signal and +.B PTRACE_LISTEN +was sent to it, +the tracee stops with +.B PTRACE_EVENT_STOP +and +.I WSTOPSIG(status) +returns the stop signal. +If any other ptrace-stop is generated at the same time (for example, +if a signal is sent to the tracee), this ptrace-stop happens. +If none of the above applies (for example, if the tracee is running in userspace), +it stops with +.B PTRACE_EVENT_STOP +with +.I WSTOPSIG(status) +== +.BR SIGTRAP . .B PTRACE_INTERRUPT only works on tracees attached by .BR PTRACE_SEIZE . @@ -760,6 +789,26 @@ the thread group leader's PID. .SS Stopped states A tracee can be in two states: running or stopped. +For the purposes of ptrace, a tracee which is blocked in a system call +(such as +.BR read (2), +.BR pause (2), +etc.) +is nevertheless considered to be running, even if the tracee is blocked +for a long time. +The state of the tracee after +.BR PTRACE_LISTEN +is somewhat of a gray area: it is not in any ptrace-stop (ptrace commands +won't work on it, and it will deliver +.BR waitpid (2) +notifications), +but it also may be considered "stopped" because +it is not executing instructions (is not scheduled), and if it was +in group-stop before +.BR PTRACE_LISTEN , +it will not respond to signals until +.B SIGCONT +is received. .LP There are many kinds of states when the tracee is stopped, and in ptrace discussions they are often conflated. @@ -1045,6 +1094,16 @@ .B SIGKILL killed the tracee.) .LP +If tracee was attached using +.BR PTRACE_SEIZE , +group-stop is indicated by +.BR PTRACE_EVENT_STOP : +.IR "status>>16 == PTRACE_EVENT_STOP" . +This allows detection of group-stops +without requiring an extra +.B PTRACE_GETSIGINFO +call. +.LP As of Linux 2.6.38, after the tracer sees the tracee ptrace-stop and until it restarts or kills it, the tracee will not run, @@ -1170,7 +1229,14 @@ .B PTRACE_EVENT_STOP Stop induced by .B PTRACE_INTERRUPT -command. +command, or group-stop, or initial ptrace-stop when a new child is attached +(only if attached using +.BR PTRACE_SEIZE ), +or +.B PTRACE_EVENT_STOP +if +.B PTRACE_SEIZE +was used. .LP .B PTRACE_GETSIGINFO on @@ -1714,8 +1780,15 @@ .SH RETURN VALUE On success, .B PTRACE_PEEK* -requests return the requested data, -while other requests return zero. +requests return the requested data, while other requests return zero. +(On Linux, this is done in the libc wrapper around ptrace system call. +On the system call level, +.B PTRACE_PEEK* +requests have a different API: they store the result +at the address specified by +.I data +parameter, and return value is the error flag.) +.LP On error, all requests return \-1, and .I errno is set appropriately. @@ -1882,7 +1955,7 @@ The usual symptom of this bug is that when you attach to a quiescent process with the command - strace -p + strace \-p then, instead of the usual and expected one-line output such as @@ -1939,7 +2012,7 @@ .BR capabilities (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/query_module.2 manpages-3.54/man2/query_module.2 --- manpages-3.52/man2/query_module.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/query_module.2 2013-09-17 08:27:55.000000000 +0200 @@ -192,7 +192,7 @@ .BR lsmod (8), .BR modinfo (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/quotactl.2 manpages-3.54/man2/quotactl.2 --- manpages-3.52/man2/quotactl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/quotactl.2 2013-09-17 08:27:55.000000000 +0200 @@ -38,9 +38,9 @@ .SH DESCRIPTION .LP The quota system can be used to set per-user and per-group limits on the -amount of disk space used on a file system. +amount of disk space used on a filesystem. For each user and/or group, -a soft limit and a hard limit can be set for each file system. +a soft limit and a hard limit can be set for each filesystem. The hard limit can't be exceeded. The soft limit can be exceeded, but warnings will ensue. Moreover, the user can't exceed the soft limit for more than one week @@ -75,7 +75,7 @@ The .I special argument is a pointer to a null-terminated string containing the pathname -of the (mounted) block special device for the file system being manipulated. +of the (mounted) block special device for the filesystem being manipulated. The .I addr @@ -90,7 +90,7 @@ value is one of the following: .TP 8 .B Q_QUOTAON -Turn on quotas for a file system. +Turn on quotas for a filesystem. The .I id argument is the identification number of the quota format to be used. @@ -112,7 +112,7 @@ The .IR addr argument points to the pathname of a file containing the quotas for -the file system. +the filesystem. The quota file must exist; it is normally created with the .BR quotacheck (8) program. @@ -120,7 +120,7 @@ .RB ( CAP_SYS_ADMIN ). .TP 8 .B Q_QUOTAOFF -Turn off quotas for a file system. +Turn off quotas for a filesystem. The .I addr and @@ -300,17 +300,17 @@ .RB ( CAP_SYS_ADMIN ). .TP .B Q_GETFMT -Get quota format used on the specified file system. +Get quota format used on the specified filesystem. The .I addr argument should be a pointer to a 4-byte buffer where the format number will be stored. .TP .B Q_SYNC -Update the on-disk copy of quota usages for a file system. +Update the on-disk copy of quota usages for a filesystem. If .I special -is NULL, then all file systems with active quotas are sync'ed. +is NULL, then all filesystems with active quotas are sync'ed. The .I addr and @@ -337,11 +337,11 @@ .I /proc/sys/fs/quota/ carry the information instead. .PP -For XFS file systems making use of the XFS Quota Manager (XQM), +For XFS filesystems making use of the XFS Quota Manager (XQM), the above commands are bypassed and the following commands are used: .TP 8 .B Q_XQUOTAON -Turn on quotas for an XFS file system. +Turn on quotas for an XFS filesystem. XFS provides the ability to turn on/off quota limit enforcement with quota accounting. Therefore, XFS expects @@ -362,10 +362,10 @@ .RB ( CAP_SYS_ADMIN ). .TP .B Q_XQUOTAOFF -Turn off quotas for an XFS file system. +Turn off quotas for an XFS filesystem. As with .BR Q_QUOTAON , -XFS file systems expect a pointer to an +XFS filesystems expect a pointer to an .I "unsigned int" that specifies whether quota accounting and/or limit enforcement need to be turned off. @@ -401,10 +401,10 @@ .B Q_XGETQSTAT Returns an .I fs_quota_stat -structure containing XFS file system specific quota information. +structure containing XFS filesystem specific quota information. This is useful for finding out how much space is used to store quota information, and also to get quotaon/off status of a given local XFS -file system. +filesystem. .TP .B Q_XQUOTARM Free the disk space taken by disk quotas. @@ -414,7 +414,7 @@ .B Q_SYNC for XFS since .BR sync (1) -writes quota information to disk (in addition to the other file system +writes quota information to disk (in addition to the other filesystem metadata that it writes out). .SH RETURN VALUE .LP @@ -461,7 +461,7 @@ .TP .B ESRCH No disk quota is found for the indicated user. -Quotas have not been turned on for this file system. +Quotas have not been turned on for this filesystem. .LP If .I cmd @@ -490,7 +490,7 @@ exists, but is not a regular file; or, the quota file pointed to by .I addr -exists, but is not on the file system pointed to by +exists, but is not on the filesystem pointed to by .IR special . .TP .B EBUSY @@ -510,7 +510,7 @@ .BR quotacheck (8), .BR quotaon (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/read.2 manpages-3.54/man2/read.2 --- manpages-3.52/man2/read.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/read.2 2013-09-17 08:27:55.000000000 +0200 @@ -173,7 +173,7 @@ .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES -On NFS file systems, reading small amounts of data will update the +On NFS filesystems, reading small amounts of data will update the timestamp only the first time, subsequent calls may not do so. This is caused by client side attribute caching, because most if not all NFS clients @@ -198,7 +198,7 @@ .BR write (2), .BR fread (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/readahead.2 manpages-3.54/man2/readahead.2 --- manpages-3.52/man2/readahead.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/readahead.2 2013-09-17 08:27:55.000000000 +0200 @@ -101,7 +101,7 @@ .BR posix_fadvise (2), .BR read (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/readdir.2 manpages-3.54/man2/readdir.2 --- manpages-3.52/man2/readdir.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/readdir.2 2013-09-17 08:27:55.000000000 +0200 @@ -128,7 +128,7 @@ .BR getdents (2), .BR readdir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/readlink.2 manpages-3.54/man2/readlink.2 --- manpages-3.52/man2/readlink.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/readlink.2 2013-09-17 08:27:55.000000000 +0200 @@ -40,7 +40,7 @@ .\" 2011-09-20, Guillem Jover : .\" Added text on dynamically allocating buffer + example program .\" -.TH READLINK 2 2011-09-20 "Linux" "Linux Programmer's Manual" +.TH READLINK 2 2013-07-18 "Linux" "Linux Programmer's Manual" .SH NAME readlink \- read value of a symbolic link .SH SYNOPSIS @@ -106,7 +106,7 @@ The named file is not a symbolic link. .TP .B EIO -An I/O error occurred while reading from the file system. +An I/O error occurred while reading from the filesystem. .TP .B ELOOP Too many symbolic links were encountered in translating the pathname. @@ -193,7 +193,7 @@ r = readlink(argv[1], linkname, sb.st_size + 1); - if (r < 0) { + if (r == \-1) { perror("lstat"); exit(EXIT_FAILURE); } @@ -204,7 +204,7 @@ exit(EXIT_FAILURE); } - linkname[sb.st_size] = \(aq\\0\(aq; + linkname[r] = \(aq\\0\(aq; printf("\(aq%s\(aq points to \(aq%s\(aq\\n", argv[1], linkname); @@ -220,7 +220,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/readlinkat.2 manpages-3.54/man2/readlinkat.2 --- manpages-3.52/man2/readlinkat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/readlinkat.2 2013-09-17 08:27:55.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH READLINKAT 2 2012-05-04 "Linux" "Linux Programmer's Manual" +.TH READLINKAT 2 2013-07-31 "Linux" "Linux Programmer's Manual" .SH NAME readlinkat \- read value of a symbolic link relative to a directory file descriptor @@ -87,7 +87,22 @@ is absolute, then .I dirfd is ignored. -.SH RETURN VALUE + +Since Linux 2.6.39, +.\" commit 65cfc6722361570bfe255698d9cd4dccaf47570d +.I pathname +can be an empty string, +in which case the call operates on the file referred to by +.IR dirfd +(which may have been obtained using the +.BR open (2) +.B O_PATH +flag). +In this case, +.I dirfd +can refer to any type of file, not just a directory. + +.SH "RETURN VALUE" On success, .BR readlinkat () returns the number of bytes placed in @@ -128,7 +143,7 @@ .BR readlink (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/readv.2 manpages-3.54/man2/readv.2 --- manpages-3.52/man2/readv.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/readv.2 2013-09-17 08:27:55.000000000 +0200 @@ -286,7 +286,7 @@ .BR read (2), .BR write (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/reboot.2 manpages-3.54/man2/reboot.2 --- manpages-3.52/man2/reboot.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/reboot.2 2013-09-17 08:27:55.000000000 +0200 @@ -188,7 +188,7 @@ .BR halt (8), .BR reboot (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/recv.2 manpages-3.54/man2/recv.2 --- manpages-3.52/man2/recv.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/recv.2 2013-09-17 08:27:55.000000000 +0200 @@ -507,7 +507,7 @@ .BR sockatmark (3), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/recvmmsg.2 manpages-3.54/man2/recvmmsg.2 --- manpages-3.52/man2/recvmmsg.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/recvmmsg.2 2013-09-17 08:27:55.000000000 +0200 @@ -273,7 +273,7 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/remap_file_pages.2 manpages-3.54/man2/remap_file_pages.2 --- manpages-3.52/man2/remap_file_pages.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/remap_file_pages.2 2013-09-17 08:27:55.000000000 +0200 @@ -162,7 +162,7 @@ .BR mremap (2), .BR msync (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/removexattr.2 manpages-3.54/man2/removexattr.2 --- manpages-3.52/man2/removexattr.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/removexattr.2 2013-09-17 08:27:55.000000000 +0200 @@ -52,7 +52,7 @@ .I name and associated with the given .I path -in the file system. +in the filesystem. .PP .BR lremovexattr () is identical to @@ -91,7 +91,7 @@ .IR .) .TP .B ENOTSUP -Extended attributes are not supported by the file system, or are disabled. +Extended attributes are not supported by the filesystem, or are disabled. .PP In addition, the errors documented in .BR stat (2) @@ -118,7 +118,7 @@ .BR attr (5), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/rename.2 manpages-3.54/man2/rename.2 --- manpages-3.52/man2/rename.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/rename.2 2013-09-17 08:27:55.000000000 +0200 @@ -132,7 +132,7 @@ handle such situations.) .TP .B EDQUOT -The user's quota of disk blocks on the file system has been exhausted. +The user's quota of disk blocks on the filesystem has been exhausted. .TP .B EFAULT .IR oldpath " or " newpath " points outside your accessible address space." @@ -215,24 +215,24 @@ (Linux: does not have the .B CAP_FOWNER capability); -or the file system containing +or the filesystem containing .I pathname does not support renaming of the type requested. .TP .B EROFS -The file is on a read-only file system. +The file is on a read-only filesystem. .TP .B EXDEV .IR oldpath " and " newpath -are not on the same mounted file system. -(Linux permits a file system to be mounted at multiple points, but +are not on the same mounted filesystem. +(Linux permits a filesystem to be mounted at multiple points, but .BR rename () does not work across different mount points, -even if the same file system is mounted on both.) +even if the same filesystem is mounted on both.) .SH CONFORMING TO 4.3BSD, C89, C99, POSIX.1-2001. .SH BUGS -On NFS file systems, you can not assume that if the operation +On NFS filesystems, you can not assume that if the operation failed the file was not renamed. If the server does the rename operation and then crashes, the retransmitted RPC which will be processed when the @@ -252,7 +252,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/renameat.2 manpages-3.54/man2/renameat.2 --- manpages-3.52/man2/renameat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/renameat.2 2013-09-17 08:27:55.000000000 +0200 @@ -140,7 +140,7 @@ .BR rename (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/request_key.2 manpages-3.54/man2/request_key.2 --- manpages-3.52/man2/request_key.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/request_key.2 2013-09-17 08:27:55.000000000 +0200 @@ -137,7 +137,7 @@ .BR keyctl (2), .BR request-key (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/restart_syscall.2 manpages-3.54/man2/restart_syscall.2 --- manpages-3.52/man2/restart_syscall.2 1970-01-01 01:00:00.000000000 +0100 +++ manpages-3.54/man2/restart_syscall.2 2013-09-17 08:27:55.000000000 +0200 @@ -0,0 +1,138 @@ +.\" Copyright (c) 2013 by Michael Kerrisk +.\" +.\" %%%LICENSE_START(VERBATIM) +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. The author(s) may not +.\" have taken the same level of care in the production of this manual, +.\" which is licensed free of charge, as they might when working +.\" professionally. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" %%%LICENSE_END +.\" +.\" http://thread.gmane.org/gmane.linux.kernel/76552/focus=76803 +.\" From: Linus Torvalds transmeta.com> +.\" Subject: Re: [PATCH] compatibility syscall layer (lets try again) +.\" Newsgroups: gmane.linux.kernel +.\" Date: 2002-12-05 02:51:12 GMT +.\" +.\" See also Section 11.3.3 of Understanding the Linux Kernel, 3rd edition +.\" +.TH RESTART_SYSCALL 2 2013-07-30 "Linux" "Linux Programmer's Manual" +.SH NAME +restart_syscall \- restart a system call after interruption by a stop signal +.SH SYNOPSIS +.B int restart_syscall(void); + +.IR Note : +There is no glibc wrapper for this system call; see NOTES. +.SH DESCRIPTION +The +.BR restart_syscall () +system call is used to restart certain system calls +after a process that was stopped by a signal (e.g., +.BR SIGSTOP +or +.BR SIGTSTP ) +is later resumed after receiving a +.BR SIGCONT +signal. +This system call is designed only for internal use by the kernel. + +.BR restart_syscall () +is used for restarting only those system calls that, +when restarted, should adjust their time-related parameters\(emnamely +.BR poll (2) +(since Linux 2.6.24), +.BR nanosleep (2) +(since Linux 2.6), +.BR clock_nanosleep (2) +(since Linux 2.6), +and +.BR futex (2), +when employed with the +.BR FUTEX_WAIT +(since Linux 2.6.22) +and +.BR FUTEX_WAIT_BITSET +(since Linux 2.6.31) +operations. +.\" These system calls correspond to the special internal errno value +.\" ERESTART_RESTARTBLOCK. Each of the system calls has a "restart" +.\" helper function that is invoked by restart_syscall(). +.BR restart_syscall () +restarts the interrupted system call with a +time argument that is suitably adjusted to account for the +time that has already elapsed (including the time where the process +was stopped by a signal). +Without the +.BR restart_syscall () +mechanism, restarting these system calls would not correctly deduce the +already elapsed time when the process continued execution. +.SH RETURN VALUE +The return value of +.BR restart_syscall () +is the return value of whatever system call is being restarted. +.SH ERRORS +.I errno +is set as per the errors for whatever system call is being restarted by +.BR restart_syscall (). +.SH VERSIONS +The +.BR restart_syscall () +system call is present since Linux 2.6. +.SH CONFORMING TO +This system call is Linux specific. +.SH NOTES +There is no glibc wrapper for this system call, +because it is intended for use only by the kernel and +should never be called by applications. + +From user space, the operation of +.BR restart_syscall (2) +is largely invisible: +to the process that made the system call that is restarted, +it appears as though that system call executed and +returned in the usual fashion. +.\" +.\" FIXME +.\" There is one oddness in the implementation though, with respect to +.\" nanosleep() (and probably also clock_nanosleep()). The scenario +.\" is as follows: +.\" 1. Start a nanosleep() for (say) 30 seconds, +.\" 2. Stop the process with (say) SIGTSTP (^Z). +.\" 3. Resume the process with SIGCONT, +.\" 4. Upon return, the 'rem' argument of nanosleep() will contain the +.\" remaining unslept time **at the time when SIGTSTP was delivered**. +.\" The behavior at point 4 is odd, but doesn't violate the standards, which +.\" specify the treatment of 'rem' only when the system call returns with +.\" the error EINTR (i.e., the call was interrupted by a signal handler). +.\" +.SH SEE ALSO +.BR sigreturn (2), +.BR sigaction (2), +.BR signal (7) +.\" FIXME select(2) should probably get the restart_syscall() treatment: +.\" If a select() call is suspended by stop-sig+SIGCONT, the time +.\" spent suspended is *not* deducted when the select() is restarted. +.\" FIXME: check whether recvmmsg() handles stop-sig+SIGCONT properly. +.SH COLOPHON +This page is part of release 3.54 of the Linux +.I man-pages +project. +A description of the project, +and information about reporting bugs, +can be found at +\%http://www.kernel.org/doc/man\-pages/. diff -Nru manpages-3.52/man2/rmdir.2 manpages-3.54/man2/rmdir.2 --- manpages-3.52/man2/rmdir.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/rmdir.2 2013-09-17 08:27:55.000000000 +0200 @@ -117,13 +117,13 @@ capability). .TP .B EPERM -The file system containing +The filesystem containing .I pathname does not support the removal of directories. .TP .B EROFS .I pathname -refers to a directory on a read-only file system. +refers to a directory on a read-only filesystem. .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH BUGS @@ -139,7 +139,7 @@ .BR unlink (2), .BR unlinkat (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/rt_sigqueueinfo.2 manpages-3.54/man2/rt_sigqueueinfo.2 --- manpages-3.52/man2/rt_sigqueueinfo.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/rt_sigqueueinfo.2 2013-09-17 08:27:55.000000000 +0200 @@ -194,7 +194,7 @@ .BR sigqueue (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/s390_runtime_instr.2 manpages-3.54/man2/s390_runtime_instr.2 --- manpages-3.52/man2/s390_runtime_instr.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/s390_runtime_instr.2 2013-09-17 08:27:55.000000000 +0200 @@ -89,7 +89,7 @@ .BR syscall (2), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sched_get_priority_max.2 manpages-3.54/man2/sched_get_priority_max.2 --- manpages-3.52/man2/sched_get_priority_max.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sched_get_priority_max.2 2013-09-17 08:27:55.000000000 +0200 @@ -126,7 +126,7 @@ .I Programming for the real world \- POSIX.4 by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sched_rr_get_interval.2 manpages-3.54/man2/sched_rr_get_interval.2 --- manpages-3.52/man2/sched_rr_get_interval.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sched_rr_get_interval.2 2013-09-17 08:27:55.000000000 +0200 @@ -136,7 +136,7 @@ .I Programming for the real world \- POSIX.4 by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sched_setaffinity.2 manpages-3.54/man2/sched_setaffinity.2 --- manpages-3.52/man2/sched_setaffinity.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sched_setaffinity.2 2013-09-17 08:27:55.000000000 +0200 @@ -31,10 +31,10 @@ .\" 2008-11-12, mtk, removed CPU_*() macro descriptions to a .\" separate CPU_SET(3) page. .\" -.TH SCHED_SETAFFINITY 2 2013-02-11 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETAFFINITY 2 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME sched_setaffinity, sched_getaffinity \- \ -set and get a process's CPU affinity mask +set and get a thread's CPU affinity mask .SH SYNOPSIS .nf .BR "#define _GNU_SOURCE" " /* See feature_test_macros(7) */" @@ -47,18 +47,18 @@ .BI " cpu_set_t *" mask ); .fi .SH DESCRIPTION -A process's CPU affinity mask determines the set of CPUs on which +A thread's CPU affinity mask determines the set of CPUs on which it is eligible to run. On a multiprocessor system, setting the CPU affinity mask can be used to obtain performance benefits. For example, -by dedicating one CPU to a particular process -(i.e., setting the affinity mask of that process to specify a single CPU, -and setting the affinity mask of all other processes to exclude that CPU), -it is possible to ensure maximum execution speed for that process. -Restricting a process to run on a single CPU also avoids +by dedicating one CPU to a particular thread +(i.e., setting the affinity mask of that thread to specify a single CPU, +and setting the affinity mask of all other threads to exclude that CPU), +it is possible to ensure maximum execution speed for that thread. +Restricting a thread to run on a single CPU also avoids the performance cost caused by the cache invalidation that occurs -when a process ceases to execute on one CPU and then +when a thread ceases to execute on one CPU and then recommences execution on a different CPU. A CPU affinity mask is represented by the @@ -69,13 +69,13 @@ .BR CPU_SET (3). .BR sched_setaffinity () -sets the CPU affinity mask of the process whose ID is +sets the CPU affinity mask of the thread whose ID is .I pid to the value specified by .IR mask . If .I pid -is zero, then the calling process is used. +is zero, then the calling thread is used. The argument .I cpusetsize is the length (in bytes) of the data pointed to by @@ -83,15 +83,15 @@ Normally this argument would be specified as .IR "sizeof(cpu_set_t)" . -If the process specified by +If the thread specified by .I pid is not currently running on one of the CPUs specified in .IR mask , -then that process is migrated to one of the CPUs specified in +then that thread is migrated to one of the CPUs specified in .IR mask . .BR sched_getaffinity () -writes the affinity mask of the process whose ID is +writes the affinity mask of the thread whose ID is .I pid into the .I cpu_set_t @@ -103,7 +103,7 @@ .IR mask . If .I pid -is zero, then the mask of the calling process is returned. +is zero, then the mask of the calling thread is returned. .SH RETURN VALUE On success, .BR sched_setaffinity () @@ -122,7 +122,7 @@ The affinity bit mask .I mask contains no processors that are currently physically on the system -and permitted to the process according to any restrictions that +and permitted to the thread according to any restrictions that may be imposed by the "cpuset" mechanism described in .BR cpuset (7). .TP @@ -135,16 +135,16 @@ .TP .B EPERM .RB ( sched_setaffinity ()) -The calling process does not have appropriate privileges. +The calling thread does not have appropriate privileges. The caller needs an effective user ID equal to the real user ID -or effective user ID of the process identified by +or effective user ID of the thread identified by .IR pid , or it must possess the .B CAP_SYS_NICE capability. .TP .B ESRCH -The process whose ID is \fIpid\fP could not be found. +The thread whose ID is \fIpid\fP could not be found. .SH VERSIONS The CPU affinity system calls were introduced in Linux kernel 2.5.8. The system call wrappers were introduced in glibc 2.3. @@ -161,21 +161,21 @@ .SH NOTES After a call to .BR sched_setaffinity (), -the set of CPUs on which the process will actually run is +the set of CPUs on which the thread will actually run is the intersection of the set specified in the .I mask argument and the set of CPUs actually present on the system. -The system may further restrict the set of CPUs on which the process +The system may further restrict the set of CPUs on which the thread runs if the "cpuset" mechanism described in .BR cpuset (7) is being used. -These restrictions on the actual set of CPUs on which the process +These restrictions on the actual set of CPUs on which the thread will run are silently imposed by the kernel. .BR sched_setscheduler (2) has a description of the Linux scheduling scheme. .PP -The affinity mask is actually a per-thread attribute that can be +The affinity mask is a per-thread attribute that can be adjusted independently for each of the threads in a thread group. The value returned from a call to .BR gettid (2) @@ -231,7 +231,7 @@ .BR capabilities (7), .BR cpuset (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sched_setparam.2 manpages-3.54/man2/sched_setparam.2 --- manpages-3.52/man2/sched_setparam.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sched_setparam.2 2013-09-17 08:27:55.000000000 +0200 @@ -27,7 +27,7 @@ .\" revision .\" Modified 2004-05-27 by Michael Kerrisk .\" -.TH SCHED_SETPARAM 2 2013-02-12 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETPARAM 2 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME sched_setparam, sched_getparam \- set and get scheduling parameters .SH SYNOPSIS @@ -66,7 +66,7 @@ .BR sched_setparam () checks the validity of \fIparam\fP for the scheduling policy of the -process. +thread. The value \fIparam\->sched_priority\fP must lie within the range given by .BR sched_get_priority_min (2) @@ -132,7 +132,7 @@ .I Programming for the real world \- POSIX.4 by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sched_setscheduler.2 manpages-3.54/man2/sched_setscheduler.2 --- manpages-3.52/man2/sched_setscheduler.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sched_setscheduler.2 2013-09-17 08:27:55.000000000 +0200 @@ -43,7 +43,7 @@ .\" .\" Worth looking at: http://rt.wiki.kernel.org/index.php .\" -.TH SCHED_SETSCHEDULER 2 2013-02-12 "Linux" "Linux Programmer's Manual" +.TH SCHED_SETSCHEDULER 2 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME sched_setscheduler, sched_getscheduler \- set and get scheduling policy/parameters @@ -66,9 +66,9 @@ .SH DESCRIPTION .BR sched_setscheduler () sets both the scheduling policy and the associated parameters for the -process whose ID is specified in \fIpid\fP. +thread whose ID is specified in \fIpid\fP. If \fIpid\fP equals zero, the -scheduling policy and parameters of the calling process will be set. +scheduling policy and parameters of the calling thread will be set. The interpretation of the argument \fIparam\fP depends on the selected policy. Currently, Linux supports the following "normal" @@ -89,7 +89,7 @@ .PP The following "real-time" policies are also supported, for special time-critical applications that need precise control over -the way in which runnable processes are selected for execution: +the way in which runnable threads are selected for execution: .TP 14 .BR SCHED_FIFO a first-in, first-out policy; and @@ -100,22 +100,22 @@ The semantics of each of these policies are detailed below. .BR sched_getscheduler () -queries the scheduling policy currently applied to the process +queries the scheduling policy currently applied to the thread identified by \fIpid\fP. If \fIpid\fP equals zero, the policy of the -calling process will be retrieved. +calling thread will be retrieved. .\" .SS Scheduling policies -The scheduler is the kernel component that decides which runnable process +The scheduler is the kernel component that decides which runnable thread will be executed by the CPU next. -Each process has an associated scheduling policy and a \fIstatic\fP +Each thread has an associated scheduling policy and a \fIstatic\fP scheduling priority, \fIsched_priority\fP; these are the settings that are modified by .BR sched_setscheduler (). The scheduler makes it decisions based on knowledge of the scheduling -policy and static priority of all processes on the system. +policy and static priority of all threads on the system. -For processes scheduled under one of the normal scheduling policies +For threads scheduled under one of the normal scheduling policies (\fBSCHED_OTHER\fP, \fBSCHED_IDLE\fP, \fBSCHED_BATCH\fP), \fIsched_priority\fP is not used in scheduling decisions (it must be specified as 0). @@ -123,8 +123,8 @@ Processes scheduled under one of the real-time policies (\fBSCHED_FIFO\fP, \fBSCHED_RR\fP) have a \fIsched_priority\fP value in the range 1 (low) to 99 (high). -(As the numbers imply, real-time processes always have higher priority -than normal processes.) +(As the numbers imply, real-time threads always have higher priority +than normal threads.) Note well: POSIX.1-2001 requires an implementation to support only a minimum 32 distinct priority levels for the real-time policies, and some systems supply just this minimum. @@ -135,38 +135,38 @@ to find the range of priorities supported for a particular policy. Conceptually, the scheduler maintains a list of runnable -processes for each possible \fIsched_priority\fP value. -In order to determine which process runs next, the scheduler looks for +threads for each possible \fIsched_priority\fP value. +In order to determine which thread runs next, the scheduler looks for the nonempty list with the highest static priority and selects the -process at the head of this list. +thread at the head of this list. -A process's scheduling policy determines -where it will be inserted into the list of processes +A thread's scheduling policy determines +where it will be inserted into the list of threads with equal static priority and how it will move inside this list. -All scheduling is preemptive: if a process with a higher static -priority becomes ready to run, the currently running process +All scheduling is preemptive: if a thread with a higher static +priority becomes ready to run, the currently running thread will be preempted and returned to the wait list for its static priority level. The scheduling policy determines the -ordering only within the list of runnable processes with equal static +ordering only within the list of runnable threads with equal static priority. .SS SCHED_FIFO: First in-first out scheduling \fBSCHED_FIFO\fP can be used only with static priorities higher than -0, which means that when a \fBSCHED_FIFO\fP processes becomes runnable, +0, which means that when a \fBSCHED_FIFO\fP threads becomes runnable, it will always immediately preempt any currently running -\fBSCHED_OTHER\fP, \fBSCHED_BATCH\fP, or \fBSCHED_IDLE\fP process. +\fBSCHED_OTHER\fP, \fBSCHED_BATCH\fP, or \fBSCHED_IDLE\fP thread. \fBSCHED_FIFO\fP is a simple scheduling algorithm without time slicing. -For processes scheduled under the +For threads scheduled under the \fBSCHED_FIFO\fP policy, the following rules apply: .IP * 3 -A \fBSCHED_FIFO\fP process that has been preempted by another process of +A \fBSCHED_FIFO\fP thread that has been preempted by another thread of higher priority will stay at the head of the list for its priority and -will resume execution as soon as all processes of higher priority are +will resume execution as soon as all threads of higher priority are blocked again. .IP * -When a \fBSCHED_FIFO\fP process becomes runnable, it +When a \fBSCHED_FIFO\fP thread becomes runnable, it will be inserted at the end of the list for its priority. .IP * A call to @@ -174,39 +174,39 @@ or .BR sched_setparam (2) will put the -\fBSCHED_FIFO\fP (or \fBSCHED_RR\fP) process identified by +\fBSCHED_FIFO\fP (or \fBSCHED_RR\fP) thread identified by \fIpid\fP at the start of the list if it was runnable. -As a consequence, it may preempt the currently running process if +As a consequence, it may preempt the currently running thread if it has the same priority. -(POSIX.1-2001 specifies that the process should go to the end +(POSIX.1-2001 specifies that the thread should go to the end of the list.) -.\" In 2.2.x and 2.4.x, the process is placed at the front of the queue -.\" In 2.0.x, the Right Thing happened: the process went to the back -- MTK +.\" In 2.2.x and 2.4.x, the thread is placed at the front of the queue +.\" In 2.0.x, the Right Thing happened: the thread went to the back -- MTK .IP * -A process calling +A thread calling .BR sched_yield (2) will be put at the end of the list. .PP -No other events will move a process +No other events will move a thread scheduled under the \fBSCHED_FIFO\fP policy in the wait list of -runnable processes with equal static priority. +runnable threads with equal static priority. A \fBSCHED_FIFO\fP -process runs until either it is blocked by an I/O request, it is -preempted by a higher priority process, or it calls +thread runs until either it is blocked by an I/O request, it is +preempted by a higher priority thread, or it calls .BR sched_yield (2). .SS SCHED_RR: Round-robin scheduling \fBSCHED_RR\fP is a simple enhancement of \fBSCHED_FIFO\fP. Everything described above for \fBSCHED_FIFO\fP also applies to \fBSCHED_RR\fP, -except that each process is allowed to run only for a maximum time +except that each thread is allowed to run only for a maximum time quantum. -If a \fBSCHED_RR\fP process has been running for a time +If a \fBSCHED_RR\fP thread has been running for a time period equal to or longer than the time quantum, it will be put at the end of the list for its priority. -A \fBSCHED_RR\fP process that has -been preempted by a higher priority process and subsequently resumes -execution as a running process will complete the unexpired portion of +A \fBSCHED_RR\fP thread that has +been preempted by a higher priority thread and subsequently resumes +execution as a running thread will complete the unexpired portion of its round-robin time quantum. The length of the time quantum can be retrieved using @@ -217,31 +217,31 @@ .SS SCHED_OTHER: Default Linux time-sharing scheduling \fBSCHED_OTHER\fP can be used at only static priority 0. \fBSCHED_OTHER\fP is the standard Linux time-sharing scheduler that is -intended for all processes that do not require the special +intended for all threads that do not require the special real-time mechanisms. -The process to run is chosen from the static +The thread to run is chosen from the static priority 0 list based on a \fIdynamic\fP priority that is determined only inside this list. The dynamic priority is based on the nice value (set by .BR nice (2) or .BR setpriority (2)) -and increased for each time quantum the process is ready to run, +and increased for each time quantum the thread is ready to run, but denied to run by the scheduler. -This ensures fair progress among all \fBSCHED_OTHER\fP processes. +This ensures fair progress among all \fBSCHED_OTHER\fP threads. .\" .SS SCHED_BATCH: Scheduling batch processes (Since Linux 2.6.16.) \fBSCHED_BATCH\fP can be used only at static priority 0. This policy is similar to \fBSCHED_OTHER\fP in that it schedules -the process according to its dynamic priority +the thread according to its dynamic priority (based on the nice value). The difference is that this policy will cause the scheduler to always assume -that the process is CPU-intensive. +that the thread is CPU-intensive. Consequently, the scheduler will apply a small scheduling penalty with respect to wakeup behaviour, -so that this process is mildly disfavored in scheduling decisions. +so that this thread is mildly disfavored in scheduling decisions. .\" The following paragraph is drawn largely from the text that .\" accompanied Ingo Molnar's patch for the implementation of @@ -285,7 +285,7 @@ flag is specified, the following rules apply for subsequently created children: .IP * 3 -If the calling process has a scheduling policy of +If the calling thread has a scheduling policy of .B SCHED_FIFO or .BR SCHED_RR , @@ -299,7 +299,7 @@ After the .BR SCHED_RESET_ON_FORK flag has been enabled, -it can be reset only if the process has the +it can be reset only if the thread has the .BR CAP_SYS_NICE capability. This flag is disabled in child processes created by @@ -313,20 +313,20 @@ .SS Privileges and resource limits In Linux kernels before 2.6.12, only privileged .RB ( CAP_SYS_NICE ) -processes can set a nonzero static priority (i.e., set a real-time +threads can set a nonzero static priority (i.e., set a real-time scheduling policy). -The only change that an unprivileged process can make is to set the +The only change that an unprivileged thread can make is to set the .B SCHED_OTHER policy, and this can be done only if the effective user ID of the caller of .BR sched_setscheduler () -matches the real or effective user ID of the target process -(i.e., the process specified by +matches the real or effective user ID of the target thread +(i.e., the thread specified by .IR pid ) whose policy is being changed. Since Linux 2.6.12, the .B RLIMIT_RTPRIO -resource limit defines a ceiling on an unprivileged process's +resource limit defines a ceiling on an unprivileged thread's static priority for the .B SCHED_RR and @@ -334,7 +334,7 @@ policies. The rules for changing scheduling policy and priority are as follows: .IP * 3 -If an unprivileged process has a nonzero +If an unprivileged thread has a nonzero .B RLIMIT_RTPRIO soft limit, then it can change its scheduling policy and priority, subject to the restriction that the priority cannot be set to a @@ -348,20 +348,20 @@ or to switch to a non-real-time policy. .IP * Subject to the same rules, -another unprivileged process can also make these changes, -as long as the effective user ID of the process making the change -matches the real or effective user ID of the target process. +another unprivileged thread can also make these changes, +as long as the effective user ID of the thread making the change +matches the real or effective user ID of the target thread. .IP * Special rules apply for the .BR SCHED_IDLE . In Linux kernels before 2.6.39, -an unprivileged process operating under this policy cannot +an unprivileged thread operating under this policy cannot change its policy, regardless of the value of its .BR RLIMIT_RTPRIO resource limit. In Linux kernels since 2.6.39, .\" commit c02aa73b1d18e43cfd79c2f193b225e84ca497c8 -an unprivileged process can switch to either the +an unprivileged thread can switch to either the .BR SCHED_BATCH or the .BR SCHED_NORMAL @@ -372,7 +372,7 @@ .PP Privileged .RB ( CAP_SYS_NICE ) -processes ignore the +threads ignore the .B RLIMIT_RTPRIO limit; as with older kernels, they can make arbitrary changes to scheduling policy and priority. @@ -381,7 +381,7 @@ for further information on .BR RLIMIT_RTPRIO . .SS Response time -A blocked high priority process waiting for the I/O has a certain +A blocked high priority thread waiting for the I/O has a certain response time before it is scheduled again. The device driver writer can greatly reduce this response time by using a "slow interrupt" @@ -400,8 +400,8 @@ or .BR mlockall (2). -Since a nonblocking infinite loop in a process scheduled under -\fBSCHED_FIFO\fP or \fBSCHED_RR\fP will block all processes with lower +Since a nonblocking infinite loop in a thread scheduled under +\fBSCHED_FIFO\fP or \fBSCHED_RR\fP will block all threads with lower priority forever, a software developer should always keep available on the console a shell scheduled under a higher static priority than the tested application. @@ -425,7 +425,7 @@ returns zero. On success, .BR sched_getscheduler () -returns the policy for the process (a nonnegative integer). +returns the policy for the thread (a nonnegative integer). On error, \-1 is returned, and .I errno is set appropriately. @@ -437,21 +437,21 @@ or \fIparam\fP does not make sense for the \fIpolicy\fP. .TP .B EPERM -The calling process does not have appropriate privileges. +The calling thread does not have appropriate privileges. .TP .B ESRCH -The process whose ID is \fIpid\fP could not be found. +The thread whose ID is \fIpid\fP could not be found. .SH CONFORMING TO POSIX.1-2001 (but see BUGS below). The \fBSCHED_BATCH\fP and \fBSCHED_IDLE\fP policies are Linux-specific. .SH NOTES POSIX.1 does not detail the permissions that an unprivileged -process requires in order to call +thread requires in order to call .BR sched_setscheduler (), and details vary across systems. For example, the Solaris 7 manual page says that -the real or effective user ID of the calling process must -match the real user ID or the save set-user-ID of the target process. +the real or effective user ID of the caller must +match the real user ID or the save set-user-ID of the target. .PP The scheduling policy and parameters are in fact per-thread attributes on Linux. @@ -525,7 +525,7 @@ real-time operating system. The FIFO and RR scheduling policies that can be selected using .BR sched_setscheduler () -are then used to run a process +are then used to run a thread with true real-time priority and a minimum worst-case scheduling latency. .SH BUGS POSIX says that on success, @@ -564,7 +564,7 @@ The Linux kernel source file .I Documentation/scheduler/sched-rt-group.txt .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sched_yield.2 manpages-3.54/man2/sched_yield.2 --- manpages-3.52/man2/sched_yield.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sched_yield.2 2013-09-17 08:27:55.000000000 +0200 @@ -83,7 +83,7 @@ .I Programming for the real world \- POSIX.4 by Bill O. Gallmeister, O'Reilly & Associates, Inc., ISBN 1-56592-074-0. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/select.2 manpages-3.54/man2/select.2 --- manpages-3.52/man2/select.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/select.2 2013-09-17 08:27:55.000000000 +0200 @@ -35,7 +35,7 @@ .\" 2005-03-11, mtk, modified pselect() text (it is now a system .\" call in 2.6.16. .\" -.TH SELECT 2 2012-08-17 "Linux" "Linux Programmer's Manual" +.TH SELECT 2 2013-09-04 "Linux" "Linux Programmer's Manual" .SH NAME select, pselect, FD_CLR, FD_ISSET, FD_SET, FD_ZERO \- synchronous I/O multiplexing @@ -159,12 +159,12 @@ .PP The .I timeout -argument specifies the minimum interval that +argument specifies the interval that .BR select () should block waiting for a file descriptor to become ready. -(This interval will be rounded up to the system clock granularity, +This interval will be rounded up to the system clock granularity, and kernel scheduling delays mean that the blocking interval -may overrun by a small amount.) +may overrun by a small amount. If both fields of the .I timeval structure are zero, then @@ -586,7 +586,7 @@ For a tutorial with discussion and examples, see .BR select_tut (2). .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/select_tut.2 manpages-3.54/man2/select_tut.2 --- manpages-3.52/man2/select_tut.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/select_tut.2 2013-09-17 08:27:55.000000000 +0200 @@ -836,7 +836,7 @@ .\" .SH AUTHORS .\" This man page was written by Paul Sheer. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/semctl.2 manpages-3.54/man2/semctl.2 --- manpages-3.52/man2/semctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/semctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -495,8 +495,9 @@ operations are used by the .BR ipcs (1) program to provide information on allocated resources. -In the future these may modified or moved to a /proc file system -interface. +In the future these may modified or moved to a +.I /proc +filesystem interface. .LP Various fields in a \fIstruct semid_ds\fP were typed as .I short @@ -540,7 +541,7 @@ .BR sem_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/semget.2 manpages-3.54/man2/semget.2 --- manpages-3.52/man2/semget.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/semget.2 2013-09-17 08:27:55.000000000 +0200 @@ -299,7 +299,7 @@ .BR sem_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/semop.2 manpages-3.54/man2/semop.2 --- manpages-3.52/man2/semop.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/semop.2 2013-09-17 08:27:55.000000000 +0200 @@ -543,7 +543,7 @@ .BR svipc (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/send.2 manpages-3.54/man2/send.2 --- manpages-3.52/man2/send.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/send.2 2013-09-17 08:27:55.000000000 +0200 @@ -437,7 +437,7 @@ .BR tcp (7), .BR udp (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sendfile.2 manpages-3.54/man2/sendfile.2 --- manpages-3.52/man2/sendfile.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sendfile.2 2013-09-17 08:27:55.000000000 +0200 @@ -201,7 +201,7 @@ .BR splice (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sendmmsg.2 manpages-3.54/man2/sendmmsg.2 --- manpages-3.52/man2/sendmmsg.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sendmmsg.2 2013-09-17 08:27:55.000000000 +0200 @@ -239,7 +239,7 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/seteuid.2 manpages-3.54/man2/seteuid.2 --- manpages-3.52/man2/seteuid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/seteuid.2 2013-09-17 08:27:55.000000000 +0200 @@ -129,7 +129,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setfsgid.2 manpages-3.54/man2/setfsgid.2 --- manpages-3.52/man2/setfsgid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setfsgid.2 2013-09-17 08:27:55.000000000 +0200 @@ -28,25 +28,25 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH SETFSGID 2 2010-11-22 "Linux" "Linux Programmer's Manual" +.TH SETFSGID 2 2013-08-08 "Linux" "Linux Programmer's Manual" .SH NAME -setfsgid \- set group identity used for file system checks +setfsgid \- set group identity used for filesystem checks .SH SYNOPSIS -.B #include -/* glibc uses */ +.B #include .sp .BI "int setfsgid(uid_t " fsgid ); .SH DESCRIPTION The system call .BR setfsgid () -sets the group ID that the Linux kernel uses to check for all accesses -to the file system. +changes the value of the caller's filesystem group ID\(emthe +group ID that the Linux kernel uses to check for all accesses +to the filesystem. Normally, the value of -.I fsgid +the filesystem group ID will shadow the value of the effective group ID. In fact, whenever the effective group ID is changed, -.I fsgid +the filesystem group ID will also be changed to the new value of the effective group ID. Explicit calls to @@ -63,16 +63,11 @@ .BR setfsgid () will succeed only if the caller is the superuser or if .I fsgid -matches either the real group ID, effective group ID, -saved set-group-ID, or the current value of -.IR fsgid . +matches either the caller's real group ID, effective group ID, +saved set-group-ID, or current the filesystem user ID. .SH RETURN VALUE -On success, the previous value of -.I fsgid -is returned. -On error, the current value of -.I fsgid -is returned. +On both success and failure, +this call returns the previous filesystem group ID of the caller. .SH VERSIONS This system call is present in Linux since version 1.2. .\" This system call is present since Linux 1.1.44 @@ -91,6 +86,13 @@ Note that at the time this system call was introduced, a process could send a signal to a process with the same effective user ID. Today signal permission handling is slightly different. +See +.BR setfsuid (2) +for a discussion of why the use of both +.BR setfsuid (2) +and +.BR setfsgid () +is nowadays unneeded. The original Linux .BR setfsgid () @@ -102,7 +104,16 @@ .BR setfsgid () wrapper function transparently deals with the variation across kernel versions. .SH BUGS -No error messages of any kind are returned to the caller. +No error indications of any kind are returned to the caller, +and the fact that both successful and unsuccessful calls return +the same value makes it impossible to directly determine +whether the call succeeded or failed. +Instead, the caller must resort to looking at the return value +from a further call such as +.IR setfsgid(\-1) +(which will always fail), in order to determine if a preceding call to +.BR setfsgid () +changed the filesystem group ID. At the very least, .B EPERM @@ -115,7 +126,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setfsuid.2 manpages-3.54/man2/setfsuid.2 --- manpages-3.52/man2/setfsuid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setfsuid.2 2013-09-17 08:27:55.000000000 +0200 @@ -28,25 +28,25 @@ .\" Modified, 27 May 2004, Michael Kerrisk .\" Added notes on capability requirements .\" -.TH SETFSUID 2 2010-11-22 "Linux" "Linux Programmer's Manual" +.TH SETFSUID 2 2013-08-08 "Linux" "Linux Programmer's Manual" .SH NAME -setfsuid \- set user identity used for file system checks +setfsuid \- set user identity used for filesystem checks .SH SYNOPSIS -.B #include -/* glibc uses */ +.B #include .sp .BI "int setfsuid(uid_t " fsuid ); .SH DESCRIPTION The system call .BR setfsuid () -sets the user ID that the Linux kernel uses to check for all accesses -to the file system. +changes the value of the caller's filesystem user ID\(emthe +user ID that the Linux kernel uses to check for all accesses +to the filesystem. Normally, the value of -.I fsuid +the filesystem user ID will shadow the value of the effective user ID. In fact, whenever the effective user ID is changed, -.I fsuid +the filesystem user ID will also be changed to the new value of the effective user ID. Explicit calls to @@ -63,16 +63,11 @@ .BR setfsuid () will succeed only if the caller is the superuser or if .I fsuid -matches either the real user ID, effective user ID, saved set-user-ID, or -the current value of -.IR fsuid . +matches either the caller's real user ID, effective user ID, +saved set-user-ID, or current filesystem user ID. .SH RETURN VALUE -On success, the previous value of -.I fsuid -is returned. -On error, the current value of -.I fsuid -is returned. +On both success and failure, +this call returns the previous filesystem user ID of the caller. .SH VERSIONS This system call is present in Linux since version 1.2. .\" This system call is present since Linux 1.1.44 @@ -88,9 +83,24 @@ without attempting the system call. .LP -Note that at the time this system call was introduced, a process -could send a signal to a process with the same effective user ID. -Today signal permission handling is slightly different. +At the time when this system call was introduced, one process +could send a signal to another process with the same effective user ID. +This meant that if a privilged process changed its effective user ID +for the purpose of file permission checking, +then it could become vulnerable to receiving signals +sent by another (unprivileged) process with the same user ID. +The filesystem user ID attribute was thus added to allow a process to +change its user ID for the purposes of file permission checking without +at the same time becoming vulnerable to receiving unwanted signals. +Since Linux 2.0, signal permission handling is different (see +.BR kill (2)), +with the result that a process change can change its effective user ID +without being vulnerable to receiving signals from unwanted processes. +Thus, +.BR setfsuid () +is nowadays unneeded and should be avoided in new applications +(likewise for +.BR setfsgid (2)). The original Linux .BR setfsuid () @@ -102,7 +112,16 @@ .BR setfsuid () wrapper function transparently deals with the variation across kernel versions. .SH BUGS -No error messages of any kind are returned to the caller. +No error indications of any kind are returned to the caller, +and the fact that both successful and unsuccessful calls return +the same value makes it impossible to directly determine +whether the call succeeded or failed. +Instead, the caller must resort to looking at the return value +from a further call such as +.IR setfsuid(\-1) +(which will always fail), in order to determine if a preceding call to +.BR setfsuid () +changed the filesystem user ID. At the very least, .B EPERM @@ -115,7 +134,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setgid.2 manpages-3.54/man2/setgid.2 --- manpages-3.52/man2/setgid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setgid.2 2013-09-17 08:27:55.000000000 +0200 @@ -82,7 +82,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/set_mempolicy.2 manpages-3.54/man2/set_mempolicy.2 --- manpages-3.52/man2/set_mempolicy.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/set_mempolicy.2 2013-09-17 08:27:55.000000000 +0200 @@ -296,7 +296,7 @@ .BR numa (7), .BR numactl (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setns.2 manpages-3.54/man2/setns.2 --- manpages-3.52/man2/setns.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setns.2 2013-09-17 08:27:55.000000000 +0200 @@ -146,7 +146,7 @@ clone() returned 3550 uts.nodename in child: bizarro uts.nodename in parent: antero -# \fBuname -n\fP # Verify hostname in the shell +# \fBuname \-n\fP # Verify hostname in the shell antero .in .fi @@ -159,7 +159,7 @@ .nf .in +4n # \fB./ns_exec /proc/3550/ns/uts /bin/bash\fP -# \fBuname -n\fP # Executed in shell started by ns_exec +# \fBuname \-n\fP # Executed in shell started by ns_exec bizarro .in .fi @@ -203,7 +203,7 @@ .BR proc (5), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setpgid.2 manpages-3.54/man2/setpgid.2 --- manpages-3.52/man2/setpgid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setpgid.2 2013-09-17 08:27:55.000000000 +0200 @@ -45,7 +45,7 @@ .\" 2007-07-25, mtk, fairly substantial rewrites and rearrangements .\" of text. .\" -.TH SETPGID 2 2010-09-26 "Linux" "Linux Programmer's Manual" +.TH SETPGID 2 2013-07-31 "Linux" "Linux Programmer's Manual" .SH NAME setpgid, getpgid, setpgrp, getpgrp \- set/get process group .SH SYNOPSIS @@ -274,7 +274,7 @@ if a background process group tries to .BR read (2) from the terminal, then the group is sent a -.B SIGTSTP +.B SIGTTIN signal, which suspends it. The .BR tcgetpgrp (3) @@ -322,7 +322,7 @@ .BR termios (3), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setresuid.2 manpages-3.54/man2/setresuid.2 --- manpages-3.52/man2/setresuid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setresuid.2 2013-09-17 08:27:55.000000000 +0200 @@ -52,13 +52,13 @@ If one of the arguments equals \-1, the corresponding value is not changed. Regardless of what changes are made to the real UID, effective UID, -and saved set-user-ID, the file system UID is always set to the same +and saved set-user-ID, the filesystem UID is always set to the same value as the (possibly new) effective UID. Completely analogously, .BR setresgid () sets the real GID, effective GID, and saved set-group-ID -of the calling process (and always modifies the file system GID +of the calling process (and always modifies the filesystem GID to be the same as the effective GID), with the same restrictions for unprivileged processes. .SH RETURN VALUE @@ -113,7 +113,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setreuid.2 manpages-3.54/man2/setreuid.2 --- manpages-3.52/man2/setreuid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setreuid.2 2013-09-17 08:27:55.000000000 +0200 @@ -165,7 +165,7 @@ .BR setuid (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setsid.2 manpages-3.54/man2/setsid.2 --- manpages-3.52/man2/setsid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setsid.2 2013-09-17 08:27:55.000000000 +0200 @@ -89,7 +89,7 @@ .BR tcgetsid (3), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/set_thread_area.2 manpages-3.54/man2/set_thread_area.2 --- manpages-3.52/man2/set_thread_area.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/set_thread_area.2 2013-09-17 08:27:55.000000000 +0200 @@ -72,7 +72,7 @@ .SH SEE ALSO .BR get_thread_area (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/set_tid_address.2 manpages-3.54/man2/set_tid_address.2 --- manpages-3.52/man2/set_tid_address.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/set_tid_address.2 2013-09-17 08:27:55.000000000 +0200 @@ -100,7 +100,7 @@ .BR clone (2), .BR futex (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setuid.2 manpages-3.54/man2/setuid.2 --- manpages-3.52/man2/setuid.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setuid.2 2013-09-17 08:27:55.000000000 +0200 @@ -95,11 +95,11 @@ sets all of the real, saved, and effective user IDs. .\" SVr4 documents an additional EINVAL error condition. .SH NOTES -Linux has the concept of the file system user ID, normally equal to the +Linux has the concept of the filesystem user ID, normally equal to the effective user ID. The .BR setuid () -call also sets the file system user ID of the calling process. +call also sets the filesystem user ID of the calling process. See .BR setfsuid (2). .PP @@ -125,7 +125,7 @@ .BR capabilities (7), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setup.2 manpages-3.54/man2/setup.2 --- manpages-3.52/man2/setup.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setup.2 2013-09-17 08:27:55.000000000 +0200 @@ -33,7 +33,7 @@ .\" .TH SETUP 2 2008-12-03 "Linux" "Linux Programmer's Manual" .SH NAME -setup \- setup devices and file systems, mount root file system +setup \- setup devices and filesystems, mount root filesystem .SH SYNOPSIS .B #include .sp @@ -42,8 +42,8 @@ .BR setup () is called once from within .IR linux/init/main.c . -It calls initialization functions for devices and file systems -configured into the kernel and then mounts the root file system. +It calls initialization functions for devices and filesystems +configured into the kernel and then mounts the root filesystem. .PP No user process may call .BR setup (). @@ -70,7 +70,7 @@ and at other times a single argument .IR "int magic" . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/setxattr.2 manpages-3.54/man2/setxattr.2 --- manpages-3.52/man2/setxattr.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/setxattr.2 2013-09-17 08:27:55.000000000 +0200 @@ -58,7 +58,7 @@ .I name and associated with the given .I path -in the file system. +in the filesystem. The .I size of the @@ -130,7 +130,7 @@ There is insufficient space remaining to store the extended attribute. .TP .B ENOTSUP -Extended attributes are not supported by the file system, or are disabled, +Extended attributes are not supported by the filesystem, or are disabled, .I errno is set to .BR ENOTSUP . @@ -160,7 +160,7 @@ .BR attr (5), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sgetmask.2 manpages-3.54/man2/sgetmask.2 --- manpages-3.52/man2/sgetmask.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sgetmask.2 2013-09-17 08:27:55.000000000 +0200 @@ -81,7 +81,7 @@ .BR sigprocmask (2), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/shmctl.2 manpages-3.54/man2/shmctl.2 --- manpages-3.52/man2/shmctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/shmctl.2 2013-09-17 08:27:55.000000000 +0200 @@ -397,8 +397,9 @@ operations are used by the .BR ipcs (1) program to provide information on allocated resources. -In the future these may modified or moved to a /proc file system -interface. +In the future these may modified or moved to a +.I /proc +filesystem interface. Linux permits a process to attach .RB ( shmat (2)) @@ -428,7 +429,7 @@ .BR capabilities (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/shmget.2 manpages-3.54/man2/shmget.2 --- manpages-3.52/man2/shmget.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/shmget.2 2013-09-17 08:27:55.000000000 +0200 @@ -312,7 +312,7 @@ .BR shm_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/shmop.2 manpages-3.54/man2/shmop.2 --- manpages-3.52/man2/shmop.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/shmop.2 2013-09-17 08:27:55.000000000 +0200 @@ -293,7 +293,7 @@ .BR shm_overview (7), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/shutdown.2 manpages-3.54/man2/shutdown.2 --- manpages-3.52/man2/shutdown.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/shutdown.2 2013-09-17 08:27:55.000000000 +0200 @@ -115,7 +115,7 @@ .BR socket (2), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sigaction.2 manpages-3.54/man2/sigaction.2 --- manpages-3.52/man2/sigaction.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sigaction.2 2013-09-17 08:27:55.000000000 +0200 @@ -44,7 +44,7 @@ .\" 2010-06-11 Andi Kleen, add hwpoison signal extensions .\" 2010-06-11 mtk, improvements to discussion of various siginfo_t fields. .\" -.TH SIGACTION 2 2013-04-19 "Linux" "Linux Programmer's Manual" +.TH SIGACTION 2 2013-07-30 "Linux" "Linux Programmer's Manual" .SH NAME sigaction \- examine and change a signal action .SH SYNOPSIS @@ -405,7 +405,7 @@ On some architectures, these signals also fill in the .I si_trapno -filed. +field. Some suberrors of .BR SIGBUS , in particular @@ -795,6 +795,7 @@ .BR kill (2), .BR killpg (2), .BR pause (2), +.BR restart_syscall (2), .BR sigaltstack (2), .BR signal (2), .BR signalfd (2), @@ -810,7 +811,7 @@ .BR core (5), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sigaltstack.2 manpages-3.54/man2/sigaltstack.2 --- manpages-3.52/man2/sigaltstack.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sigaltstack.2 2013-09-17 08:27:55.000000000 +0200 @@ -237,7 +237,7 @@ .BR sigsetjmp (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/signal.2 manpages-3.54/man2/signal.2 --- manpages-3.52/man2/signal.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/signal.2 2013-09-17 08:27:55.000000000 +0200 @@ -295,7 +295,7 @@ .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/signalfd.2 manpages-3.54/man2/signalfd.2 --- manpages-3.52/man2/signalfd.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/signalfd.2 2013-09-17 08:27:55.000000000 +0200 @@ -444,7 +444,7 @@ .BR epoll (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sigpending.2 manpages-3.54/man2/sigpending.2 --- manpages-3.52/man2/sigpending.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sigpending.2 2013-09-17 08:27:56.000000000 +0200 @@ -93,7 +93,7 @@ .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sigprocmask.2 manpages-3.54/man2/sigprocmask.2 --- manpages-3.52/man2/sigprocmask.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sigprocmask.2 2013-09-17 08:27:56.000000000 +0200 @@ -153,7 +153,7 @@ .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sigreturn.2 manpages-3.54/man2/sigreturn.2 --- manpages-3.52/man2/sigreturn.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sigreturn.2 2013-09-17 08:27:56.000000000 +0200 @@ -26,7 +26,7 @@ .\" Modified Tue Oct 22 22:09:03 1996 by Eric S. Raymond .\" 2008-06-26, mtk, added some more detail on the work done by sigreturn() .\" -.TH SIGRETURN 2 2008-06-26 "Linux" "Linux Programmer's Manual" +.TH SIGRETURN 2 2013-07-30 "Linux" "Linux Programmer's Manual" .SH NAME sigreturn \- return from signal handler and cleanup stack frame .SH SYNOPSIS @@ -73,11 +73,12 @@ argument varies depending on the architecture. .SH SEE ALSO .BR kill (2), +.BR restart_syscall (2), .BR sigaltstack (2), .BR signal (2), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sigsuspend.2 manpages-3.54/man2/sigsuspend.2 --- manpages-3.52/man2/sigsuspend.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sigsuspend.2 2013-09-17 08:27:56.000000000 +0200 @@ -116,7 +116,7 @@ .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sigwaitinfo.2 manpages-3.54/man2/sigwaitinfo.2 --- manpages-3.52/man2/sigwaitinfo.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sigwaitinfo.2 2013-09-17 08:27:56.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH SIGWAITINFO 2 2012-07-21 "Linux" "Linux Programmer's Manual" +.TH SIGWAITINFO 2 2013-09-04 "Linux" "Linux Programmer's Manual" .SH NAME sigwaitinfo, sigtimedwait \- synchronously wait for queued signals .SH SYNOPSIS @@ -79,7 +79,7 @@ .BR sigwaitinfo () except that it has an additional argument, .IR timeout , -which specifies a minimum interval for which +which specifies the interval for which the thread is suspended waiting for a signal. (This interval will be rounded up to the system clock granularity, and kernel scheduling delays mean that the interval @@ -197,7 +197,7 @@ .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/socket.2 manpages-3.54/man2/socket.2 --- manpages-3.52/man2/socket.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/socket.2 2013-09-17 08:27:56.000000000 +0200 @@ -417,7 +417,7 @@ reprinted in .I UNIX Programmer's Supplementary Documents Volume 1. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/socketcall.2 manpages-3.54/man2/socketcall.2 --- manpages-3.52/man2/socketcall.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/socketcall.2 2013-09-17 08:27:56.000000000 +0200 @@ -69,7 +69,7 @@ .BR socket (2), .BR socketpair (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/socketpair.2 manpages-3.54/man2/socketpair.2 --- manpages-3.52/man2/socketpair.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/socketpair.2 2013-09-17 08:27:56.000000000 +0200 @@ -129,7 +129,7 @@ .BR socket (7), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/splice.2 manpages-3.54/man2/splice.2 --- manpages-3.52/man2/splice.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/splice.2 2013-09-17 08:27:56.000000000 +0200 @@ -146,7 +146,7 @@ or do not have proper read-write mode. .TP .B EINVAL -Target file system doesn't support splicing; +Target filesystem doesn't support splicing; target file is opened in append mode; .\" The append-mode error is given since 2.6.27; in earlier kernels, .\" splice() in append mode was broken @@ -228,7 +228,7 @@ .BR tee (2), .BR vmsplice (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/spu_create.2 manpages-3.54/man2/spu_create.2 --- manpages-3.52/man2/spu_create.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/spu_create.2 2013-09-17 08:27:56.000000000 +0200 @@ -48,7 +48,7 @@ and returns a file descriptor associated with it. .I pathname must refer to a nonexistent directory in the mount point of -the SPU file system +the SPU filesystem .RB ( spufs ). If .BR spu_create () @@ -273,7 +273,7 @@ .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/spu_run.2 manpages-3.54/man2/spu_run.2 --- manpages-3.52/man2/spu_run.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/spu_run.2 2013-09-17 08:27:56.000000000 +0200 @@ -267,7 +267,7 @@ .BR capabilities (7), .BR spufs (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/stat.2 manpages-3.54/man2/stat.2 --- manpages-3.52/man2/stat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/stat.2 2013-09-17 08:27:56.000000000 +0200 @@ -116,7 +116,7 @@ gid_t st_gid; /* group ID of owner */ dev_t st_rdev; /* device ID (if special file) */ off_t st_size; /* total size, in bytes */ - blksize_t st_blksize; /* blocksize for file system I/O */ + blksize_t st_blksize; /* blocksize for filesystem I/O */ blkcnt_t st_blocks; /* number of 512B blocks allocated */ time_t st_atime; /* time of last access */ time_t st_mtime; /* time of last modification */ @@ -154,12 +154,12 @@ The .I st_blksize -field gives the "preferred" blocksize for efficient file system I/O. +field gives the "preferred" blocksize for efficient filesystem I/O. (Writing to a file in smaller chunks may cause an inefficient read-modify-rewrite.) .PP -Not all of the Linux file systems implement all of the time fields. -Some file system types allow mounting in such a way that file +Not all of the Linux filesystems implement all of the time fields. +Some filesystem types allow mounting in such a way that file and/or directory accesses do not cause an update of the .I st_atime field. @@ -516,7 +516,7 @@ If none of the aforementioned macros are defined, then the nanosecond values are exposed with names of the form .IR st_atimensec . -On file systems that do not support subsecond timestamps, +On filesystems that do not support subsecond timestamps, the nanosecond fields are returned with the value 0. .\" As at kernel 2.6.25, XFS and JFS support nanosecond timestamps, .\" but ext2, ext3, and Reiserfs do not. @@ -662,7 +662,7 @@ .BR capabilities (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/statfs.2 manpages-3.54/man2/statfs.2 --- manpages-3.52/man2/statfs.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/statfs.2 2013-09-17 08:27:56.000000000 +0200 @@ -27,7 +27,7 @@ .\" .TH STATFS 2 2010-11-21 "Linux" "Linux Programmer's Manual" .SH NAME -statfs, fstatfs \- get file system statistics +statfs, fstatfs \- get filesystem statistics .SH SYNOPSIS .BR "#include " "/* or */" .sp @@ -37,9 +37,9 @@ .SH DESCRIPTION The function .BR statfs () -returns information about a mounted file system. +returns information about a mounted filesystem. .I path -is the pathname of any file within the mounted file system. +is the pathname of any file within the mounted filesystem. .I buf is a pointer to a .I statfs @@ -54,21 +54,21 @@ #endif struct statfs { - __SWORD_TYPE f_type; /* type of file system (see below) */ + __SWORD_TYPE f_type; /* type of filesystem (see below) */ __SWORD_TYPE f_bsize; /* optimal transfer block size */ - fsblkcnt_t f_blocks; /* total data blocks in file system */ + fsblkcnt_t f_blocks; /* total data blocks in filesystem */ fsblkcnt_t f_bfree; /* free blocks in fs */ fsblkcnt_t f_bavail; /* free blocks available to unprivileged user */ - fsfilcnt_t f_files; /* total file nodes in file system */ + fsfilcnt_t f_files; /* total file nodes in filesystem */ fsfilcnt_t f_ffree; /* free file nodes in fs */ - fsid_t f_fsid; /* file system id */ + fsid_t f_fsid; /* filesystem id */ __SWORD_TYPE f_namelen; /* maximum length of filenames */ __SWORD_TYPE f_frsize; /* fragment size (since Linux 2.6) */ __SWORD_TYPE f_spare[5]; }; -File system types: +Filesystem types: ADFS_SUPER_MAGIC 0xadf5 AFFS_SUPER_MAGIC 0xADFF @@ -122,7 +122,7 @@ .I f_fsid is supposed to contain (but see below). .PP -Fields that are undefined for a particular file system are set to 0. +Fields that are undefined for a particular filesystem are set to 0. .BR fstatfs () returns the same information about an open file referenced by descriptor .IR fd . @@ -155,7 +155,7 @@ This call was interrupted by a signal. .TP .B EIO -An I/O error occurred while reading from the file system. +An I/O error occurred while reading from the filesystem. .TP .B ELOOP .RB ( statfs ()) @@ -177,7 +177,7 @@ Insufficient kernel memory was available. .TP .B ENOSYS -The file system does not support this call. +The filesystem does not support this call. .TP .B ENOTDIR .RB ( statfs ()) @@ -262,11 +262,11 @@ .RI ( f_fsid , ino ) uniquely determines a file. Some operating systems use (a variation on) the device number, or the device number -combined with the file-system type. +combined with the filesystem type. Several OSes restrict giving out the .I f_fsid field to the superuser only (and zero it for unprivileged users), -because this field is used in the filehandle of the file system +because this field is used in the filehandle of the filesystem when NFS-exported, and giving it out is a security concern. .LP Under some operating systems the @@ -279,7 +279,7 @@ .BR statvfs (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/stime.2 manpages-3.54/man2/stime.2 --- manpages-3.52/man2/stime.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/stime.2 2013-09-17 08:27:56.000000000 +0200 @@ -72,7 +72,7 @@ .BR settimeofday (2), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/subpage_prot.2 manpages-3.54/man2/subpage_prot.2 --- manpages-3.52/man2/subpage_prot.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/subpage_prot.2 2013-09-17 08:27:56.000000000 +0200 @@ -132,7 +132,7 @@ .IR Documentation/vm/hugetlbpage.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/swapon.2 manpages-3.54/man2/swapon.2 --- manpages-3.52/man2/swapon.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/swapon.2 2013-09-17 08:27:56.000000000 +0200 @@ -126,7 +126,7 @@ or, for .BR swapon (), the indicated path does not contain a valid swap signature or -resides on an in-memory file system like tmpfs; or, for +resides on an in-memory filesystem like tmpfs; or, for .BR swapoff (), .I path is not currently a swap area. @@ -193,7 +193,7 @@ .BR swapoff (8), .BR swapon (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/symlink.2 manpages-3.54/man2/symlink.2 --- manpages-3.52/man2/symlink.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/symlink.2 2013-09-17 08:27:56.000000000 +0200 @@ -98,9 +98,9 @@ .BR path_resolution (7).) .TP .B EDQUOT -The user's quota of resources on the file system has been exhausted. -The resources could be inodes or disk blocks, depending on the file -system implementation. +The user's quota of resources on the filesystem has been exhausted. +The resources could be inodes or disk blocks, depending on the filesystem +implementation. .TP .B EEXIST .I newpath @@ -139,13 +139,13 @@ is not, in fact, a directory. .TP .B EPERM -The file system containing +The filesystem containing .I newpath does not support the creation of symbolic links. .TP .B EROFS .I newpath -is on a read-only file system. +is on a read-only filesystem. .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional error codes EDQUOT and ENOSYS. @@ -174,7 +174,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/symlinkat.2 manpages-3.54/man2/symlinkat.2 --- manpages-3.52/man2/symlinkat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/symlinkat.2 2013-09-17 08:27:56.000000000 +0200 @@ -127,7 +127,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sync.2 manpages-3.54/man2/sync.2 --- manpages-3.52/man2/sync.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sync.2 2013-09-17 08:27:56.000000000 +0200 @@ -65,12 +65,12 @@ .SH DESCRIPTION .BR sync () causes all buffered modifications to file metadata and data to be -written to the underlying file systems. +written to the underlying filesystems. .BR syncfs () is like .BR sync (), -but synchronizes just the file system containing file +but synchronizes just the filesystem containing file referred to by the open file descriptor .IR fd . .SH RETURN VALUE @@ -123,7 +123,7 @@ .BR sync (8), .BR update (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sync_file_range.2 manpages-3.54/man2/sync_file_range.2 --- manpages-3.52/man2/sync_file_range.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sync_file_range.2 2013-09-17 08:27:56.000000000 +0200 @@ -89,11 +89,11 @@ already-instantiated disk blocks, there are no guarantees that the data will be available after a crash. There is no user interface to know if a write is purely an overwrite. -On file systems using copy-on-write semantics (e.g., +On filesystems using copy-on-write semantics (e.g., .IR btrfs ) an overwrite of existing allocated blocks is impossible. When writing into preallocated space, -many file systems also require calls into the block +many filesystems also require calls into the block allocator, which this system call does not sync out to disk. This system call does not flush disk write caches and thus does not provide any data integrity on systems with volatile disk write caches. @@ -224,7 +224,7 @@ .BR msync (2), .BR sync (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/syscall.2 manpages-3.54/man2/syscall.2 --- manpages-3.52/man2/syscall.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/syscall.2 2013-09-17 08:27:56.000000000 +0200 @@ -37,7 +37,7 @@ .\" 2002-03-20 Christoph Hellwig .\" - adopted for Linux .\" -.TH SYSCALL 2 2013-06-21 "Linux" "Linux Programmer's Manual" +.TH SYSCALL 2 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME syscall \- indirect system call .SH SYNOPSIS @@ -156,7 +156,7 @@ arch/ABI instruction syscall # retval Notes _ arm/OABI swi NR - a1 NR is syscall # -arm/EABI swi 0x0 r7 r1 +arm/EABI swi 0x0 r7 r0 blackfin excpt 0x0 P0 R0 i386 int $0x80 eax eax ia64 break 0x100000 r15 r10/r8 @@ -181,7 +181,7 @@ arch/ABI arg1 arg2 arg3 arg4 arg5 arg6 arg7 _ arm/OABI a1 a2 a3 a4 v1 v2 v3 -arm/EABI r1 r2 r3 r4 r5 r6 r7 +arm/EABI r0 r1 r2 r3 r4 r5 r6 blackfin R0 R1 R2 R3 R4 R5 - i386 ebx ecx edx esi edi ebp - ia64 r11 r9 r10 r14 r15 r13 - @@ -205,6 +205,7 @@ #include #include #include +#include int main(int argc, char *argv[]) @@ -212,7 +213,7 @@ pid_t tid; tid = syscall(SYS_gettid); - tid = syscall(SYS_tgkill, getpid(), tid); + tid = syscall(SYS_tgkill, getpid(), tid, SIGHUP); } .fi .SH SEE ALSO @@ -220,7 +221,7 @@ .BR intro (2), .BR syscalls (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/_syscall.2 manpages-3.54/man2/_syscall.2 --- manpages-3.52/man2/_syscall.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/_syscall.2 2013-09-17 08:27:56.000000000 +0200 @@ -105,7 +105,7 @@ codes. You need to read the source to be sure how it will return errors. Usually, it is the negative of a standard error code, -for example, i +for example, .RI \- EPERM . The _syscall() macros will return the result .I r @@ -186,7 +186,7 @@ .BR syscall (2), .BR errno (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/syscalls.2 manpages-3.54/man2/syscalls.2 --- manpages-3.52/man2/syscalls.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/syscalls.2 2013-09-17 08:27:56.000000000 +0200 @@ -835,7 +835,7 @@ .BR unimplemented (2), .BR libc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sysctl.2 manpages-3.54/man2/sysctl.2 --- manpages-3.52/man2/sysctl.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sysctl.2 2013-09-17 08:27:56.000000000 +0200 @@ -181,7 +181,7 @@ .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sysfs.2 manpages-3.54/man2/sysfs.2 --- manpages-3.52/man2/sysfs.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sysfs.2 2013-09-17 08:27:56.000000000 +0200 @@ -26,7 +26,7 @@ .\" .TH SYSFS 2 2010-06-27 "Linux" "Linux Programmer's Manual" .SH NAME -sysfs \- get file system type information +sysfs \- get filesystem type information .SH SYNOPSIS .BI "int sysfs(int " option ", const char *" fsname ); @@ -35,7 +35,7 @@ .BI "int sysfs(int " option ); .SH DESCRIPTION .BR sysfs () -returns information about the file system types currently present in +returns information about the filesystem types currently present in the kernel. The specific form of the .BR sysfs () @@ -44,14 +44,14 @@ in effect: .TP 3 .B 1 -Translate the file-system identifier string +Translate the filesystem identifier string .I fsname -into a file-system type index. +into a filesystem type index. .TP .B 2 -Translate the file-system type index +Translate the filesystem type index .I fs_index -into a null-terminated file-system identifier string. +into a null-terminated filesystem identifier string. This string will be written to the buffer pointed to by .IR buf . @@ -60,18 +60,18 @@ has enough space to accept the string. .TP .B 3 -Return the total number of file system types currently present in the +Return the total number of filesystem types currently present in the kernel. .PP -The numbering of the file-system type indexes begins with zero. +The numbering of the filesystem type indexes begins with zero. .SH RETURN VALUE On success, .BR sysfs () -returns the file-system index for option +returns the filesystem index for option .BR 1 , zero for option .BR 2 , -and the number of currently configured file systems for option +and the number of currently configured filesystems for option .BR 3 . On error, \-1 is returned, and .I errno @@ -84,7 +84,7 @@ .TP .B EINVAL .I fsname -is not a valid file-system type identifier; +is not a valid filesystem type identifier; .I fs_index is out-of-bounds; .I option @@ -102,7 +102,7 @@ There is no libc or glibc support. There is no way to guess how large \fIbuf\fP should be. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/sysinfo.2 manpages-3.54/man2/sysinfo.2 --- manpages-3.52/man2/sysinfo.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/sysinfo.2 2013-09-17 08:27:56.000000000 +0200 @@ -94,7 +94,7 @@ .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/syslog.2 manpages-3.54/man2/syslog.2 --- manpages-3.52/man2/syslog.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/syslog.2 2013-09-17 08:27:56.000000000 +0200 @@ -310,7 +310,7 @@ .BR syslog (3), .BR capabilities (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/tee.2 manpages-3.54/man2/tee.2 --- manpages-3.52/man2/tee.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/tee.2 2013-09-17 08:27:56.000000000 +0200 @@ -198,7 +198,7 @@ .BR splice (2), .BR vmsplice (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/time.2 manpages-3.54/man2/time.2 --- manpages-3.52/man2/time.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/time.2 2013-09-17 08:27:56.000000000 +0200 @@ -80,7 +80,7 @@ .BR ftime (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/timer_create.2 manpages-3.54/man2/timer_create.2 --- manpages-3.52/man2/timer_create.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/timer_create.2 2013-09-17 08:27:56.000000000 +0200 @@ -412,7 +412,7 @@ .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/timer_delete.2 manpages-3.54/man2/timer_delete.2 --- manpages-3.52/man2/timer_delete.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/timer_delete.2 2013-09-17 08:27:56.000000000 +0200 @@ -73,7 +73,7 @@ .BR timer_settime (2), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/timerfd_create.2 manpages-3.54/man2/timerfd_create.2 --- manpages-3.52/man2/timerfd_create.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/timerfd_create.2 2013-09-17 08:27:56.000000000 +0200 @@ -551,7 +551,7 @@ .BR epoll (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/timer_getoverrun.2 manpages-3.54/man2/timer_getoverrun.2 --- manpages-3.52/man2/timer_getoverrun.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/timer_getoverrun.2 2013-09-17 08:27:56.000000000 +0200 @@ -139,7 +139,7 @@ .BR signal (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/timer_settime.2 manpages-3.54/man2/timer_settime.2 --- manpages-3.52/man2/timer_settime.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/timer_settime.2 2013-09-17 08:27:56.000000000 +0200 @@ -214,7 +214,7 @@ .BR timer_getoverrun (2), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/times.2 manpages-3.54/man2/times.2 --- manpages-3.52/man2/times.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/times.2 2013-09-17 08:27:56.000000000 +0200 @@ -213,7 +213,7 @@ .BR sysconf (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/tkill.2 manpages-3.54/man2/tkill.2 --- manpages-3.52/man2/tkill.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/tkill.2 2013-09-17 08:27:56.000000000 +0200 @@ -134,7 +134,7 @@ .BR kill (2), .BR rt_sigqueueinfo (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/truncate.2 manpages-3.54/man2/truncate.2 --- manpages-3.52/man2/truncate.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/truncate.2 2013-09-17 08:27:56.000000000 +0200 @@ -163,13 +163,13 @@ A component of the path prefix is not a directory. .TP .B EPERM -.\" This happens for at least MSDOS and VFAT file systems +.\" This happens for at least MSDOS and VFAT filesystems .\" on kernel 2.6.13 -The underlying file system does not support extending +The underlying filesystem does not support extending a file beyond its current size. .TP .B EROFS -The named file resides on a read-only file system. +The named file resides on a read-only filesystem. .TP .B ETXTBSY The file is a pure procedure (shared text) file that is being executed. @@ -218,8 +218,8 @@ is not specified at all in such an environment): either returning an error, or extending the file. Like most UNIX implementations, Linux follows the XSI requirement -when dealing with native file systems. -However, some nonnative file systems do not permit +when dealing with native filesystems. +However, some nonnative filesystems do not permit .BR truncate () and .BR ftruncate () @@ -258,7 +258,7 @@ .BR stat (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/umask.2 manpages-3.54/man2/umask.2 --- manpages-3.52/man2/umask.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/umask.2 2013-09-17 08:27:56.000000000 +0200 @@ -122,7 +122,7 @@ .BR stat (2), .BR acl (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/umount.2 manpages-3.54/man2/umount.2 --- manpages-3.52/man2/umount.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/umount.2 2013-09-17 08:27:56.000000000 +0200 @@ -29,7 +29,7 @@ .\" .TH UMOUNT 2 2010-06-19 "Linux" "Linux Programmer's Manual" .SH NAME -umount, umount2 \- unmount file system +umount, umount2 \- unmount filesystem .SH SYNOPSIS .nf .B "#include " @@ -42,7 +42,7 @@ .BR umount () and .BR umount2 () -remove the attachment of the (topmost) file system mounted on +remove the attachment of the (topmost) filesystem mounted on .IR target . .\" Note: the kernel naming differs from the glibc naming .\" umount2 is the glibc name for what the kernel now calls umount @@ -50,7 +50,7 @@ Appropriate privilege (Linux: the .B CAP_SYS_ADMIN -capability) is required to unmount file systems. +capability) is required to unmount filesystems. Linux 2.1.116 added the .BR umount2 () @@ -95,16 +95,16 @@ .I target if it is a symbolic link. This flag allows security problems to be avoided in set-user-ID-\fIroot\fP -programs that allow unprivileged users to unmount file systems. +programs that allow unprivileged users to unmount filesystems. .SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno is set appropriately. .SH ERRORS -The error values given below result from file-system type independent +The error values given below result from filesystem type independent errors. -Each file system type may have its own special errors and its +Each filesystem type may have its own special errors and its own special behavior. See the Linux kernel source code for details. .TP @@ -113,7 +113,7 @@ .BR umount2 () specifying .B MNT_EXPIRE -successfully marked an unbusy file system as expired. +successfully marked an unbusy filesystem as expired. .TP .B EBUSY .I target @@ -173,7 +173,7 @@ .BR mount (8), .BR umount (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/uname.2 manpages-3.54/man2/uname.2 --- manpages-3.52/man2/uname.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/uname.2 2013-09-17 08:27:56.000000000 +0200 @@ -169,7 +169,7 @@ .BR getdomainname (2), .BR gethostname (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/unimplemented.2 manpages-3.54/man2/unimplemented.2 --- manpages-3.52/man2/unimplemented.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/unimplemented.2 2013-09-17 08:27:56.000000000 +0200 @@ -64,7 +64,7 @@ .SH SEE ALSO .BR syscalls (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/unlink.2 manpages-3.54/man2/unlink.2 --- manpages-3.52/man2/unlink.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/unlink.2 2013-09-17 08:27:56.000000000 +0200 @@ -38,7 +38,7 @@ .BI "int unlink(const char *" pathname ); .SH DESCRIPTION .BR unlink () -deletes a name from the file system. +deletes a name from the filesystem. If that name was the last link to a file and no processes have the file open the file is deleted and the space it was using is made available for reuse. @@ -122,7 +122,7 @@ for this case.) .TP .BR EPERM " (Linux only)" -The file system does not allow unlinking of files. +The filesystem does not allow unlinking of files. .TP .BR EPERM " or " EACCES The directory containing @@ -137,7 +137,7 @@ .TP .B EROFS .I pathname -refers to a file on a read-only file system. +refers to a file on a read-only filesystem. .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional error @@ -159,7 +159,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/unlinkat.2 manpages-3.54/man2/unlinkat.2 --- manpages-3.52/man2/unlinkat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/unlinkat.2 2013-09-17 08:27:56.000000000 +0200 @@ -165,7 +165,7 @@ .BR unlink (2), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/unshare.2 manpages-3.54/man2/unshare.2 --- manpages-3.52/man2/unshare.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/unshare.2 2013-09-17 08:27:56.000000000 +0200 @@ -85,7 +85,7 @@ .BR clone (2) .B CLONE_FS flag. -Unshare file system attributes, so that the calling process +Unshare filesystem attributes, so that the calling process no longer shares its root directory .RB ( chroot (2)), current directory @@ -273,7 +273,7 @@ .I Documentation/unshare.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/uselib.2 manpages-3.54/man2/uselib.2 --- manpages-3.52/man2/uselib.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/uselib.2 2013-09-17 08:27:56.000000000 +0200 @@ -110,7 +110,7 @@ .BR capabilities (7), .BR ld.so (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/ustat.2 manpages-3.54/man2/ustat.2 --- manpages-3.52/man2/ustat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/ustat.2 2013-09-17 08:27:56.000000000 +0200 @@ -29,7 +29,7 @@ .\" .TH USTAT 2 2003-08-04 "Linux" "Linux Programmer's Manual" .SH NAME -ustat \- get file system statistics +ustat \- get filesystem statistics .SH SYNOPSIS .nf .B #include @@ -42,10 +42,10 @@ .fi .SH DESCRIPTION .BR ustat () -returns information about a mounted file system. +returns information about a mounted filesystem. .I dev is a device number identifying a device containing -a mounted file system. +a mounted filesystem. .I ubuf is a pointer to a .I ustat @@ -84,10 +84,10 @@ .TP .B EINVAL .I dev -does not refer to a device containing a mounted file system. +does not refer to a device containing a mounted filesystem. .TP .B ENOSYS -The mounted file system referenced by +The mounted filesystem referenced by .I dev does not support this operation, or any version of Linux before 1.3.16. @@ -108,18 +108,18 @@ .IR f_blksize , that is unknown elsewhere. HP-UX warns: -For some file systems, the number of free inodes does not change. -Such file systems will return \-1 in the field +For some filesystems, the number of free inodes does not change. +Such filesystems will return \-1 in the field .IR f_tinode . .\" Some software tries to use this in order to test whether the -.\" underlying file system is NFS. -For some file systems, inodes are dynamically allocated. -Such file systems will return the current number of free inodes. +.\" underlying filesystem is NFS. +For some filesystems, inodes are dynamically allocated. +Such filesystems will return the current number of free inodes. .SH SEE ALSO .BR stat (2), .BR statfs (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/utime.2 manpages-3.54/man2/utime.2 --- manpages-3.52/man2/utime.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/utime.2 2013-09-17 08:27:56.000000000 +0200 @@ -158,7 +158,7 @@ .TP .B EROFS .I path -resides on a read-only file system. +resides on a read-only filesystem. .SH CONFORMING TO .BR utime (): SVr4, POSIX.1-2001. @@ -186,7 +186,7 @@ .BR futimens (3), .BR futimes (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/utimensat.2 manpages-3.54/man2/utimensat.2 --- manpages-3.52/man2/utimensat.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/utimensat.2 2013-09-17 08:27:56.000000000 +0200 @@ -109,7 +109,7 @@ .in .PP Updated file timestamps are set to the greatest value -supported by the file system that is not greater than the specified time. +supported by the filesystem that is not greater than the specified time. If the .I tv_nsec @@ -277,7 +277,7 @@ .IP * the file is marked immutable (see .BR chattr (1)). -.\" EXT2_IMMUTABLE_FL and similar flags for other file systems. +.\" EXT2_IMMUTABLE_FL and similar flags for other filesystems. .RE .PD .TP @@ -395,7 +395,7 @@ the file is marked append-only or immutable (see .BR chattr (1)). .\" EXT2_IMMUTABLE_FL EXT_APPPEND_FL and similar flags for -.\" other file systems. +.\" other filesystems. .\" .\" Why the inconsistency (which is described under NOTES) between .\" EACCES and EPERM, where only EPERM tests for append-only. @@ -404,7 +404,7 @@ .PD .TP .B EROFS -The file is on a read-only file system. +The file is on a read-only filesystem. .TP .B ESRCH .RB ( utimensat ()) @@ -613,7 +613,7 @@ .BR path_resolution (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/vfork.2 manpages-3.54/man2/vfork.2 --- manpages-3.52/man2/vfork.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/vfork.2 2013-09-17 08:27:56.000000000 +0200 @@ -277,7 +277,7 @@ .BR unshare (2), .BR wait (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/vhangup.2 manpages-3.54/man2/vhangup.2 --- manpages-3.52/man2/vhangup.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/vhangup.2 2013-09-17 08:27:56.000000000 +0200 @@ -67,7 +67,7 @@ .BR capabilities (7), .BR init (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/vm86.2 manpages-3.54/man2/vm86.2 --- manpages-3.52/man2/vm86.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/vm86.2 2013-09-17 08:27:56.000000000 +0200 @@ -74,7 +74,7 @@ This call is specific to Linux on 32-bit Intel processors, and should not be used in programs intended to be portable. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/vmsplice.2 manpages-3.54/man2/vmsplice.2 --- manpages-3.52/man2/vmsplice.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/vmsplice.2 2013-09-17 08:27:56.000000000 +0200 @@ -155,7 +155,7 @@ .BR splice (2), .BR tee (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/wait.2 manpages-3.54/man2/wait.2 --- manpages-3.52/man2/wait.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/wait.2 2013-09-17 08:27:56.000000000 +0200 @@ -46,7 +46,7 @@ .\" 2005-05-10, mtk, __W* flags can't be used with waitid() .\" 2008-07-04, mtk, removed erroneous text about SA_NOCLDSTOP .\" -.TH WAIT 2 2012-12-21 "Linux" "Linux Programmer's Manual" +.TH WAIT 2 2013-09-04 "Linux" "Linux Programmer's Manual" .SH NAME wait, waitpid, waitid \- wait for process to change state .SH SYNOPSIS @@ -60,6 +60,8 @@ .BI "int waitid(idtype_t " idtype ", id_t " id \ ", siginfo_t *" infop ", int " options ); + /* This is the glibc and POSIX interface; see + NOTES for information on the raw system call. */ .sp .in -4n Feature Test Macro Requirements for glibc (see @@ -518,6 +520,18 @@ Do not wait for children of other threads in the same thread group. This was the default before Linux 2.4. +.PP +The raw +.BR waitid () +system call takes a fith argument, of type +.IR "struct rusage\ *" . +If this argument is non-NULL, +then it is used to return resource usage information about the child, +in the same manner as +.BR wait4 (2). +See +.BR getrusage (2) +for details. .SH BUGS According to POSIX.1-2008, an application calling .BR waitid () @@ -629,7 +643,7 @@ .BR credentials (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/wait4.2 manpages-3.54/man2/wait4.2 --- manpages-3.52/man2/wait4.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/wait4.2 2013-09-17 08:27:56.000000000 +0200 @@ -170,7 +170,7 @@ .BR wait (2), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man2/write.2 manpages-3.54/man2/write.2 --- manpages-3.52/man2/write.2 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man2/write.2 2013-09-17 08:27:56.000000000 +0200 @@ -85,7 +85,7 @@ which can be proved to occur after a .BR write () has returned returns the new data. -Note that not all file systems are POSIX conforming. +Note that not all filesystems are POSIX conforming. .SH RETURN VALUE On success, the number of bytes written is returned (zero indicates nothing was written). @@ -134,7 +134,7 @@ .BR connect (2). .TP .B EDQUOT -The user's quota of disk blocks on the file system containing the file +The user's quota of disk blocks on the filesystem containing the file referred to by .I fd has been exhausted. @@ -221,7 +221,7 @@ .BR writev (2), .BR fwrite (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/a64l.3 manpages-3.54/man3/a64l.3 --- manpages-3.52/man3/a64l.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/a64l.3 2013-09-17 08:27:56.000000000 +0200 @@ -95,7 +95,7 @@ .\" .BR itoa (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/abort.3 manpages-3.54/man3/abort.3 --- manpages-3.52/man3/abort.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/abort.3 2013-09-17 08:27:56.000000000 +0200 @@ -78,7 +78,7 @@ .BR longjmp (3), .BR raise (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/abs.3 manpages-3.54/man3/abs.3 --- manpages-3.52/man3/abs.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/abs.3 2013-09-17 08:27:56.000000000 +0200 @@ -139,7 +139,7 @@ .BR floor (3), .BR rint (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/acos.3 manpages-3.54/man3/acos.3 --- manpages-3.52/man3/acos.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/acos.3 2013-09-17 08:27:56.000000000 +0200 @@ -125,7 +125,7 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/acosh.3 manpages-3.54/man3/acosh.3 --- manpages-3.52/man3/acosh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/acosh.3 2013-09-17 08:27:56.000000000 +0200 @@ -131,7 +131,7 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/addseverity.3 manpages-3.54/man3/addseverity.3 --- manpages-3.52/man3/addseverity.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/addseverity.3 2013-09-17 08:27:56.000000000 +0200 @@ -70,7 +70,7 @@ .SH SEE ALSO .BR fmtmsg (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/adjtime.3 manpages-3.54/man3/adjtime.3 --- manpages-3.52/man3/adjtime.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/adjtime.3 2013-09-17 08:27:56.000000000 +0200 @@ -143,7 +143,7 @@ .BR gettimeofday (2), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_cancel.3 manpages-3.54/man3/aio_cancel.3 --- manpages-3.52/man3/aio_cancel.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_cancel.3 2013-09-17 08:27:56.000000000 +0200 @@ -126,7 +126,7 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_error.3 manpages-3.54/man3/aio_error.3 --- manpages-3.52/man3/aio_error.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_error.3 2013-09-17 08:27:56.000000000 +0200 @@ -99,7 +99,7 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_fsync.3 manpages-3.54/man3/aio_fsync.3 --- manpages-3.52/man3/aio_fsync.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_fsync.3 2013-09-17 08:27:56.000000000 +0200 @@ -113,7 +113,7 @@ .BR aio (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_init.3 manpages-3.54/man3/aio_init.3 --- manpages-3.52/man3/aio_init.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_init.3 2013-09-17 08:27:56.000000000 +0200 @@ -99,7 +99,7 @@ .SH SEE ALSO .BR aio (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_read.3 manpages-3.54/man3/aio_read.3 --- manpages-3.52/man3/aio_read.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_read.3 2013-09-17 08:27:56.000000000 +0200 @@ -156,7 +156,7 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_return.3 manpages-3.54/man3/aio_return.3 --- manpages-3.52/man3/aio_return.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_return.3 2013-09-17 08:27:56.000000000 +0200 @@ -94,7 +94,7 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_suspend.3 manpages-3.54/man3/aio_suspend.3 --- manpages-3.52/man3/aio_suspend.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_suspend.3 2013-09-17 08:27:56.000000000 +0200 @@ -137,7 +137,7 @@ .BR aio (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/aio_write.3 manpages-3.54/man3/aio_write.3 --- manpages-3.52/man3/aio_write.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/aio_write.3 2013-09-17 08:27:56.000000000 +0200 @@ -158,7 +158,7 @@ .BR lio_listio (3), .BR aio (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/alloca.3 manpages-3.54/man3/alloca.3 --- manpages-3.52/man3/alloca.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/alloca.3 2013-09-17 08:27:56.000000000 +0200 @@ -155,7 +155,7 @@ .BR longjmp (3), .BR malloc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/argz_add.3 manpages-3.54/man3/argz_add.3 --- manpages-3.52/man3/argz_add.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/argz_add.3 2013-09-17 08:27:56.000000000 +0200 @@ -85,9 +85,9 @@ .LP .BR argz_append () appends the argz vector -.RI ( buf ,\ buf_len ) +.RI ( buf ,\ buf_len ) after -.RI ( *argz ,\ *argz_len ) +.RI ( *argz ,\ *argz_len ) and updates .IR *argz and @@ -100,7 +100,7 @@ .BR argz_count () counts the number of strings, that is, the number of null bytes (\(aq\\0\(aq), in -.RI ( argz ,\ argz_len ). +.RI ( argz ,\ argz_len ). .LP .BR argz_create () converts a UNIX-style argument vector @@ -108,13 +108,13 @@ terminated by .IR "(char\ *)\ 0" , into an argz vector -.RI ( *argz ,\ *argz_len ). +.RI ( *argz ,\ *argz_len ). .LP .BR argz_create_sep () converts the null-terminated string .I str into an argz vector -.RI ( *argz ,\ *argz_len ) +.RI ( *argz ,\ *argz_len ) by breaking it up at every occurrence of the separator .IR sep . .LP @@ -122,7 +122,7 @@ removes the substring pointed to by .I entry from the argz vector -.RI ( *argz ,\ *argz_len ) +.RI ( *argz ,\ *argz_len ) and updates .I *argz and @@ -132,7 +132,7 @@ is the opposite of .BR argz_create (). It takes the argz vector -.RI ( argz ,\ argz_len ) +.RI ( argz ,\ argz_len ) and fills the array starting at .I argv with pointers to the substrings, and a final NULL, @@ -140,7 +140,7 @@ The array .I argv must have room for -.IR argz_count ( argz , argz_len ") + 1" +.IR argz_count ( argz ", " argz_len ") + 1" pointers. .LP .BR argz_insert () @@ -151,7 +151,7 @@ at position .I before into the argz vector -.RI ( *argz ,\ *argz_len ) +.RI ( *argz ,\ *argz_len ) and updates .I *argz and @@ -204,7 +204,7 @@ .SH SEE ALSO .BR envz_add (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/asin.3 manpages-3.54/man3/asin.3 --- manpages-3.52/man3/asin.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/asin.3 2013-09-17 08:27:56.000000000 +0200 @@ -123,7 +123,7 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/asinh.3 manpages-3.54/man3/asinh.3 --- manpages-3.52/man3/asinh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/asinh.3 2013-09-17 08:27:56.000000000 +0200 @@ -116,7 +116,7 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/asprintf.3 manpages-3.54/man3/asprintf.3 --- manpages-3.52/man3/asprintf.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/asprintf.3 2013-09-17 08:27:56.000000000 +0200 @@ -69,7 +69,7 @@ .BR malloc (3), .BR printf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/assert.3 manpages-3.54/man3/assert.3 --- manpages-3.52/man3/assert.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/assert.3 2013-09-17 08:27:56.000000000 +0200 @@ -78,7 +78,7 @@ .BR assert_perror (3), .BR exit (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/assert_perror.3 manpages-3.54/man3/assert_perror.3 --- manpages-3.52/man3/assert_perror.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/assert_perror.3 2013-09-17 08:27:56.000000000 +0200 @@ -74,7 +74,7 @@ .BR exit (3), .BR strerror (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/atan2.3 manpages-3.54/man3/atan2.3 --- manpages-3.52/man3/atan2.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/atan2.3 2013-09-17 08:27:56.000000000 +0200 @@ -178,7 +178,7 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/atan.3 manpages-3.54/man3/atan.3 --- manpages-3.52/man3/atan.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/atan.3 2013-09-17 08:27:56.000000000 +0200 @@ -109,7 +109,7 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/atanh.3 manpages-3.54/man3/atanh.3 --- manpages-3.52/man3/atanh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/atanh.3 2013-09-17 08:27:56.000000000 +0200 @@ -161,7 +161,7 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/atexit.3 manpages-3.54/man3/atexit.3 --- manpages-3.52/man3/atexit.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/atexit.3 2013-09-17 08:27:56.000000000 +0200 @@ -163,7 +163,7 @@ .BR exit (3), .BR on_exit (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/atof.3 manpages-3.54/man3/atof.3 --- manpages-3.52/man3/atof.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/atof.3 2013-09-17 08:27:56.000000000 +0200 @@ -63,7 +63,7 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/atoi.3 manpages-3.54/man3/atoi.3 --- manpages-3.52/man3/atoi.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/atoi.3 2013-09-17 08:27:56.000000000 +0200 @@ -116,7 +116,7 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/backtrace.3 manpages-3.54/man3/backtrace.3 --- manpages-3.52/man3/backtrace.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/backtrace.3 2013-09-17 08:27:56.000000000 +0200 @@ -254,7 +254,7 @@ .BR dlopen (3), .BR malloc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/basename.3 manpages-3.54/man3/basename.3 --- manpages-3.52/man3/basename.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/basename.3 2013-09-17 08:27:56.000000000 +0200 @@ -178,7 +178,7 @@ .BR basename (1), .BR dirname (1) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/bcmp.3 manpages-3.54/man3/bcmp.3 --- manpages-3.52/man3/bcmp.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/bcmp.3 2013-09-17 08:27:56.000000000 +0200 @@ -73,7 +73,7 @@ .BR strncasecmp (3), .BR strncmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/bcopy.3 manpages-3.54/man3/bcopy.3 --- manpages-3.52/man3/bcopy.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/bcopy.3 2013-09-17 08:27:56.000000000 +0200 @@ -72,7 +72,7 @@ .BR strcpy (3), .BR strncpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/bindresvport.3 manpages-3.54/man3/bindresvport.3 --- manpages-3.52/man3/bindresvport.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/bindresvport.3 2013-09-17 08:27:56.000000000 +0200 @@ -114,7 +114,7 @@ .BR bind (2), .BR getsockname (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/bsd_signal.3 manpages-3.54/man3/bsd_signal.3 --- manpages-3.52/man3/bsd_signal.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/bsd_signal.3 2013-09-17 08:27:56.000000000 +0200 @@ -97,7 +97,7 @@ .BR sysv_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/bsearch.3 manpages-3.54/man3/bsearch.3 --- manpages-3.52/man3/bsearch.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/bsearch.3 2013-09-17 08:27:56.000000000 +0200 @@ -132,7 +132,7 @@ .BR qsort (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/bstring.3 manpages-3.54/man3/bstring.3 --- manpages-3.52/man3/bstring.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/bstring.3 2013-09-17 08:27:56.000000000 +0200 @@ -92,7 +92,7 @@ .BR memmove (3), .BR memset (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/btowc.3 manpages-3.54/man3/btowc.3 --- manpages-3.52/man3/btowc.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/btowc.3 2013-09-17 08:27:56.000000000 +0200 @@ -70,7 +70,7 @@ .BR mbtowc (3), .BR wctob (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/btree.3 manpages-3.54/man3/btree.3 --- manpages-3.52/man3/btree.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/btree.3 2013-09-17 08:27:56.000000000 +0200 @@ -163,7 +163,7 @@ If .I psize is 0 (no page size is specified) a page size is chosen based on the -underlying file system I/O block size. +underlying filesystem I/O block size. .TP .I compare Compare is the key comparison function. @@ -253,7 +253,7 @@ .IR "The Art of Computer Programming Vol. 3: Sorting and Searching" , D.E. Knuth, 1968, pp 471-480. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/byteorder.3 manpages-3.54/man3/byteorder.3 --- manpages-3.52/man3/byteorder.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/byteorder.3 2013-09-17 08:27:56.000000000 +0200 @@ -85,7 +85,7 @@ .BR gethostbyname (3), .BR getservent (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/bzero.3 manpages-3.54/man3/bzero.3 --- manpages-3.52/man3/bzero.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/bzero.3 2013-09-17 08:27:56.000000000 +0200 @@ -58,7 +58,7 @@ .BR memset (3), .BR swab (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cabs.3 manpages-3.54/man3/cabs.3 --- manpages-3.52/man3/cabs.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cabs.3 2013-09-17 08:27:56.000000000 +0200 @@ -38,7 +38,7 @@ .BR hypot (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cacos.3 manpages-3.54/man3/cacos.3 --- manpages-3.52/man3/cacos.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cacos.3 2013-09-17 08:27:56.000000000 +0200 @@ -75,7 +75,7 @@ .BR clog (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cacosh.3 manpages-3.54/man3/cacosh.3 --- manpages-3.52/man3/cacosh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cacosh.3 2013-09-17 08:27:56.000000000 +0200 @@ -77,7 +77,7 @@ .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/canonicalize_file_name.3 manpages-3.54/man3/canonicalize_file_name.3 --- manpages-3.52/man3/canonicalize_file_name.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/canonicalize_file_name.3 2013-09-17 08:27:56.000000000 +0200 @@ -76,7 +76,7 @@ .BR readlink (2), .BR realpath (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/carg.3 manpages-3.54/man3/carg.3 --- manpages-3.52/man3/carg.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/carg.3 2013-09-17 08:27:56.000000000 +0200 @@ -60,7 +60,7 @@ .BR cabs (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/casin.3 manpages-3.54/man3/casin.3 --- manpages-3.52/man3/casin.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/casin.3 2013-09-17 08:27:56.000000000 +0200 @@ -41,7 +41,7 @@ .BR csin (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/casinh.3 manpages-3.54/man3/casinh.3 --- manpages-3.52/man3/casinh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/casinh.3 2013-09-17 08:27:56.000000000 +0200 @@ -43,7 +43,7 @@ .BR csinh (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/catan.3 manpages-3.54/man3/catan.3 --- manpages-3.52/man3/catan.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/catan.3 2013-09-17 08:27:56.000000000 +0200 @@ -72,7 +72,7 @@ .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/catanh.3 manpages-3.54/man3/catanh.3 --- manpages-3.52/man3/catanh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/catanh.3 2013-09-17 08:27:56.000000000 +0200 @@ -74,7 +74,7 @@ .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/catgets.3 manpages-3.54/man3/catgets.3 --- manpages-3.52/man3/catgets.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/catgets.3 2013-09-17 08:27:56.000000000 +0200 @@ -85,7 +85,7 @@ .BR catopen (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/catopen.3 manpages-3.54/man3/catopen.3 --- manpages-3.52/man3/catopen.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/catopen.3 2013-09-17 08:27:56.000000000 +0200 @@ -191,7 +191,7 @@ .BR catgets (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cbrt.3 manpages-3.54/man3/cbrt.3 --- manpages-3.52/man3/cbrt.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cbrt.3 2013-09-17 08:27:56.000000000 +0200 @@ -95,7 +95,7 @@ .BR pow (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ccos.3 manpages-3.54/man3/ccos.3 --- manpages-3.52/man3/ccos.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/ccos.3 2013-09-17 08:27:56.000000000 +0200 @@ -34,7 +34,7 @@ .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ccosh.3 manpages-3.54/man3/ccosh.3 --- manpages-3.52/man3/ccosh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/ccosh.3 2013-09-17 08:27:56.000000000 +0200 @@ -34,7 +34,7 @@ .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ceil.3 manpages-3.54/man3/ceil.3 --- manpages-3.52/man3/ceil.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/ceil.3 2013-09-17 08:27:56.000000000 +0200 @@ -125,7 +125,7 @@ .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cerf.3 manpages-3.54/man3/cerf.3 --- manpages-3.52/man3/cerf.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cerf.3 2013-09-17 08:27:56.000000000 +0200 @@ -41,7 +41,7 @@ .BR erf (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cexp2.3 manpages-3.54/man3/cexp2.3 --- manpages-3.52/man3/cexp2.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cexp2.3 2013-09-17 08:27:56.000000000 +0200 @@ -31,7 +31,7 @@ .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cexp.3 manpages-3.54/man3/cexp.3 --- manpages-3.52/man3/cexp.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cexp.3 2013-09-17 08:27:56.000000000 +0200 @@ -38,7 +38,7 @@ .BR cpow (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cfree.3 manpages-3.54/man3/cfree.3 --- manpages-3.52/man3/cfree.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cfree.3 2013-09-17 08:27:56.000000000 +0200 @@ -117,7 +117,7 @@ .SH SEE ALSO .BR malloc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cimag.3 manpages-3.54/man3/cimag.3 --- manpages-3.52/man3/cimag.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cimag.3 2013-09-17 08:27:56.000000000 +0200 @@ -48,7 +48,7 @@ .BR creal (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/clearenv.3 manpages-3.54/man3/clearenv.3 --- manpages-3.52/man3/clearenv.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/clearenv.3 2013-09-17 08:27:56.000000000 +0200 @@ -101,7 +101,7 @@ .BR unsetenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/clock.3 manpages-3.54/man3/clock.3 --- manpages-3.52/man3/clock.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/clock.3 2013-09-17 08:27:56.000000000 +0200 @@ -26,7 +26,7 @@ .\" Modified 14 Jun 2002, Michael Kerrisk .\" Added notes on differences from other UNIX systems with respect to .\" waited-for children. -.TH CLOCK 3 2008-08-28 "GNU" "Linux Programmer's Manual" +.TH CLOCK 3 2013-08-19 "GNU" "Linux Programmer's Manual" .SH NAME clock \- determine processor time .SH SYNOPSIS @@ -83,12 +83,23 @@ .BR times (2) function, which explicitly returns (separate) information about the caller and its children, may be preferable. + +In glibc 2.17 and earlier, +.BR clock () +was implemented on top of +.BR times (2). +For improved precision, +since glibc 2.18, it is implemented on top of +.BR clock_gettime (2) +(using the +.BR CLOCK_PROCESS_CPUTIME_ID +clock). .SH SEE ALSO .BR clock_gettime (2), .BR getrusage (2), .BR times (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/clock_getcpuclockid.3 manpages-3.54/man3/clock_getcpuclockid.3 --- manpages-3.52/man3/clock_getcpuclockid.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/clock_getcpuclockid.3 2013-09-17 08:27:56.000000000 +0200 @@ -157,7 +157,7 @@ .BR pthread_getcpuclockid (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/clog10.3 manpages-3.54/man3/clog10.3 --- manpages-3.52/man3/clog10.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/clog10.3 2013-09-17 08:27:56.000000000 +0200 @@ -44,7 +44,7 @@ .BR clog2 (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/clog2.3 manpages-3.54/man3/clog2.3 --- manpages-3.52/man3/clog2.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/clog2.3 2013-09-17 08:27:56.000000000 +0200 @@ -4,7 +4,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH CLOG2 3 2008-08-07 "" "Linux Programmer's Manual" +.TH CLOG2 3 2013-07-23 "" "Linux Programmer's Manual" .SH NAME clog2, clog2f, clog2l \- base-2 logarithm of a complex number .SH SYNOPSIS @@ -34,7 +34,7 @@ .SH CONFORMING TO These function names are reserved for future use in C99. .SH AVAILABILITY -Not yet in glibc, as at version 2.8. +Not yet in glibc, as at version 2.17. .\" But reserved in NAMESPACE. .SH SEE ALSO .BR cabs (3), @@ -43,7 +43,7 @@ .BR clog10 (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/clog.3 manpages-3.54/man3/clog.3 --- manpages-3.52/man3/clog.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/clog.3 2013-09-17 08:27:56.000000000 +0200 @@ -47,7 +47,7 @@ .BR clog2 (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/closedir.3 manpages-3.54/man3/closedir.3 --- manpages-3.52/man3/closedir.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/closedir.3 2013-09-17 08:27:56.000000000 +0200 @@ -75,7 +75,7 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cmsg.3 manpages-3.54/man3/cmsg.3 --- manpages-3.52/man3/cmsg.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cmsg.3 2013-09-17 08:27:56.000000000 +0200 @@ -220,7 +220,7 @@ .PP RFC\ 2292 .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/confstr.3 manpages-3.54/man3/confstr.3 --- manpages-3.52/man3/confstr.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/confstr.3 2013-09-17 08:27:56.000000000 +0200 @@ -148,7 +148,7 @@ .BR exec (3), .BR system (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/conj.3 manpages-3.54/man3/conj.3 --- manpages-3.52/man3/conj.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/conj.3 2013-09-17 08:27:56.000000000 +0200 @@ -46,7 +46,7 @@ .BR csqrt (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/copysign.3 manpages-3.54/man3/copysign.3 --- manpages-3.52/man3/copysign.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/copysign.3 2013-09-17 08:27:56.000000000 +0200 @@ -102,7 +102,7 @@ .SH SEE ALSO .BR signbit (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cos.3 manpages-3.54/man3/cos.3 --- manpages-3.52/man3/cos.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cos.3 2013-09-17 08:27:56.000000000 +0200 @@ -124,7 +124,7 @@ .BR sincos (3), .BR tan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cosh.3 manpages-3.54/man3/cosh.3 --- manpages-3.52/man3/cosh.3 2013-07-04 12:54:00.000000000 +0200 +++ manpages-3.54/man3/cosh.3 2013-09-17 08:27:56.000000000 +0200 @@ -135,7 +135,7 @@ .BR sinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cpow.3 manpages-3.54/man3/cpow.3 --- manpages-3.52/man3/cpow.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/cpow.3 2013-09-17 08:27:56.000000000 +0200 @@ -37,7 +37,7 @@ .BR pow (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/cproj.3 manpages-3.54/man3/cproj.3 --- manpages-3.52/man3/cproj.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/cproj.3 2013-09-17 08:27:56.000000000 +0200 @@ -41,7 +41,7 @@ .BR cabs (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/CPU_SET.3 manpages-3.54/man3/CPU_SET.3 --- manpages-3.52/man3/CPU_SET.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/CPU_SET.3 2013-09-17 08:27:56.000000000 +0200 @@ -359,7 +359,7 @@ .BR pthread_setaffinity_np (3), .BR cpuset (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/creal.3 manpages-3.54/man3/creal.3 --- manpages-3.52/man3/creal.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/creal.3 2013-09-17 08:27:56.000000000 +0200 @@ -40,7 +40,7 @@ .BR cimag (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/crypt.3 manpages-3.54/man3/crypt.3 --- manpages-3.52/man3/crypt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/crypt.3 2013-09-17 08:27:56.000000000 +0200 @@ -242,7 +242,7 @@ .BR getpass (3), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/csin.3 manpages-3.54/man3/csin.3 --- manpages-3.52/man3/csin.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/csin.3 2013-09-17 08:27:56.000000000 +0200 @@ -34,7 +34,7 @@ .BR ctan (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/csinh.3 manpages-3.54/man3/csinh.3 --- manpages-3.52/man3/csinh.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/csinh.3 2013-09-17 08:27:56.000000000 +0200 @@ -34,7 +34,7 @@ .BR ctanh (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/csqrt.3 manpages-3.54/man3/csqrt.3 --- manpages-3.52/man3/csqrt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/csqrt.3 2013-09-17 08:27:56.000000000 +0200 @@ -33,7 +33,7 @@ .BR cexp (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ctan.3 manpages-3.54/man3/ctan.3 --- manpages-3.52/man3/ctan.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ctan.3 2013-09-17 08:27:56.000000000 +0200 @@ -34,7 +34,7 @@ .BR csin (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ctanh.3 manpages-3.54/man3/ctanh.3 --- manpages-3.52/man3/ctanh.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ctanh.3 2013-09-17 08:27:56.000000000 +0200 @@ -35,7 +35,7 @@ .BR csinh (3), .BR complex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ctermid.3 manpages-3.54/man3/ctermid.3 --- manpages-3.52/man3/ctermid.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ctermid.3 2013-09-17 08:27:56.000000000 +0200 @@ -77,7 +77,7 @@ .SH SEE ALSO .BR ttyname (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ctime.3 manpages-3.54/man3/ctime.3 --- manpages-3.52/man3/ctime.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ctime.3 2013-09-17 08:27:56.000000000 +0200 @@ -372,7 +372,7 @@ .BR tzset (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/daemon.3 manpages-3.54/man3/daemon.3 --- manpages-3.52/man3/daemon.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/daemon.3 2013-09-17 08:27:56.000000000 +0200 @@ -106,7 +106,7 @@ .BR fork (2), .BR setsid (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/dbopen.3 manpages-3.54/man3/dbopen.3 --- manpages-3.52/man3/dbopen.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/dbopen.3 2013-09-17 08:27:56.000000000 +0200 @@ -560,7 +560,7 @@ .IR "LIBTP: Portable, Modular Transactions for UNIX" , Margo Seltzer, Michael Olson, USENIX proceedings, Winter 1992. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/des_crypt.3 manpages-3.54/man3/des_crypt.3 --- manpages-3.52/man3/des_crypt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/des_crypt.3 2013-09-17 08:27:56.000000000 +0200 @@ -139,7 +139,7 @@ .BR crypt (3), .BR xcrypt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/difftime.3 manpages-3.54/man3/difftime.3 --- manpages-3.52/man3/difftime.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/difftime.3 2013-09-17 08:27:56.000000000 +0200 @@ -68,7 +68,7 @@ .BR gmtime (3), .BR localtime (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/dirfd.3 manpages-3.54/man3/dirfd.3 --- manpages-3.52/man3/dirfd.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/dirfd.3 2013-09-17 08:27:56.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH DIRFD 3 2013-04-19 "Linux" "Linux Programmer's Manual" +.TH DIRFD 3 2013-07-05 "Linux" "Linux Programmer's Manual" .SH NAME dirfd \- get directory stream file descriptor .SH SYNOPSIS @@ -84,6 +84,11 @@ .B ENOTSUP The implementation does not support the association of a file descriptor with a directory. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR dirfd () +function is thread-safe. .SH CONFORMING TO POSIX.1-2008. This function was a BSD extension, present in 4.3BSD-Reno, not in 4.2BSD. @@ -106,7 +111,7 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/div.3 manpages-3.54/man3/div.3 --- manpages-3.52/man3/div.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/div.3 2013-09-17 08:27:56.000000000 +0200 @@ -31,7 +31,7 @@ .\" Modified 1993-07-24, Rik Faith (faith@cs.unc.edu) .\" Modified 2002-08-10, 2003-11-01 Walter Harms, aeb .\" -.TH DIV 3 2012-04-17 "" "Linux Programmer's Manual" +.TH DIV 3 2013-07-05 "" "Linux Programmer's Manual" .SH NAME div, ldiv, lldiv, imaxdiv \- compute quotient and remainder of an integer division @@ -88,6 +88,15 @@ of the same type as the function arguments. .SH RETURN VALUE The \fIdiv_t\fP (etc.) structure. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR div (), +.BR ldiv (), +.BR lldiv (), +and +.BR imaxdiv () +functions are thread-safe. .SH CONFORMING TO SVr4, 4.3BSD, C89. C99. The functions @@ -107,7 +116,7 @@ .BR abs (3), .BR remainder (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/dl_iterate_phdr.3 manpages-3.54/man3/dl_iterate_phdr.3 --- manpages-3.52/man3/dl_iterate_phdr.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/dl_iterate_phdr.3 2013-09-17 08:27:56.000000000 +0200 @@ -203,7 +203,7 @@ .IR "Executable and Linking Format Specification" , available at various locations online. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/dlopen.3 manpages-3.54/man3/dlopen.3 --- manpages-3.52/man3/dlopen.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/dlopen.3 2013-09-17 08:27:56.000000000 +0200 @@ -516,7 +516,7 @@ ld.so info pages, gcc info pages, ld info pages .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/dprintf.3 manpages-3.54/man3/dprintf.3 --- manpages-3.52/man3/dprintf.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/dprintf.3 2013-09-17 08:27:56.000000000 +0200 @@ -95,7 +95,7 @@ .SH SEE ALSO .BR printf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/drand48.3 manpages-3.54/man3/drand48.3 --- manpages-3.52/man3/drand48.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/drand48.3 2013-09-17 08:27:56.000000000 +0200 @@ -267,7 +267,7 @@ .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/drand48_r.3 manpages-3.54/man3/drand48_r.3 --- manpages-3.52/man3/drand48_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/drand48_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -24,7 +24,7 @@ .\" .\" Created 2004-10-31. Text taken from a page by Walter Harms, 2003-09-08 .\" -.TH DRAND48_R 3 2007-07-26 "GNU" "Linux Programmer's Manual" +.TH DRAND48_R 3 2013-09-09 "GNU" "Linux Programmer's Manual" .SH NAME drand48_r, erand48_r, lrand48_r, nrand48_r, mrand48_r, jrand48_r, srand48_r, seed48_r, lcong48_r @@ -95,6 +95,20 @@ .BR lcong48_r (). .SH RETURN VALUE The return value is 0. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR drand48_r (), +.BR erand48_r (), +.BR lrand48_r (), +.BR nrand48_r (), +.BR mrand48_r (), +.BR jrand48_r (), +.BR srand48_r (), +.BR seed48_r (), +and +.BR lcong48_r () +functions are thread-safe. .SH CONFORMING TO These functions are GNU extensions and are not portable. .SH SEE ALSO @@ -102,7 +116,7 @@ .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/dysize.3 manpages-3.54/man3/dysize.3 --- manpages-3.52/man3/dysize.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/dysize.3 2013-09-17 08:27:56.000000000 +0200 @@ -57,7 +57,7 @@ .SH SEE ALSO .BR strftime (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ecvt.3 manpages-3.54/man3/ecvt.3 --- manpages-3.52/man3/ecvt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ecvt.3 2013-09-17 08:27:56.000000000 +0200 @@ -139,7 +139,7 @@ .BR setlocale (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ecvt_r.3 manpages-3.54/man3/ecvt_r.3 --- manpages-3.52/man3/ecvt_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ecvt_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -97,7 +97,7 @@ .BR qecvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/encrypt.3 manpages-3.54/man3/encrypt.3 --- manpages-3.52/man3/encrypt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/encrypt.3 2013-09-17 08:27:56.000000000 +0200 @@ -27,7 +27,7 @@ .\" .\" Modified 2003-04-04, aeb .\" -.TH ENCRYPT 3 2013-06-21 "" "Linux Programmer's Manual" +.TH ENCRYPT 3 2013-07-22 "" "Linux Programmer's Manual" .SH NAME encrypt, setkey, encrypt_r, setkey_r \- encrypt 64-bit messages .SH SYNOPSIS @@ -123,17 +123,17 @@ (For example because of former USA export restrictions.) .SH ATTRIBUTES .SS Multithreading (see pthreads(7)) -The functions +The .BR encrypt () and .BR setkey () -are not thread-safe. +functions are not thread-safe. .LP -The functions +The .BR encrypt_r () and .BR setkey_r () -are thread-safe. +functions are thread-safe. .SH CONFORMING TO The functions .BR encrypt () @@ -177,7 +177,7 @@ .BR ecb_crypt (3), .\" .BR fcrypt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/end.3 manpages-3.54/man3/end.3 --- manpages-3.52/man3/end.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/end.3 2013-09-17 08:27:56.000000000 +0200 @@ -111,7 +111,7 @@ .BR sbrk (2), .BR elf (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/endian.3 manpages-3.54/man3/endian.3 --- manpages-3.52/man3/endian.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/endian.3 2013-09-17 08:27:56.000000000 +0200 @@ -151,7 +151,7 @@ .SH SEE ALSO .BR byteorder (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/envz_add.3 manpages-3.54/man3/envz_add.3 --- manpages-3.52/man3/envz_add.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/envz_add.3 2013-09-17 08:27:56.000000000 +0200 @@ -143,7 +143,7 @@ .SH SEE ALSO .BR argz_add (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/erf.3 manpages-3.54/man3/erf.3 --- manpages-3.52/man3/erf.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/erf.3 2013-09-17 08:27:56.000000000 +0200 @@ -134,7 +134,7 @@ .BR erfc (3), .BR exp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/erfc.3 manpages-3.54/man3/erfc.3 --- manpages-3.52/man3/erfc.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/erfc.3 2013-09-17 08:27:56.000000000 +0200 @@ -137,7 +137,7 @@ .BR erf (3), .BR exp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/err.3 manpages-3.54/man3/err.3 --- manpages-3.52/man3/err.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/err.3 2013-09-17 08:27:56.000000000 +0200 @@ -156,7 +156,7 @@ .BR printf (3), .BR strerror (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/errno.3 manpages-3.54/man3/errno.3 --- manpages-3.52/man3/errno.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/errno.3 2013-09-17 08:27:56.000000000 +0200 @@ -433,7 +433,7 @@ Interrupted system call should be restarted .TP .B EROFS -Read-only file system (POSIX.1) +Read-only filesystem (POSIX.1) .TP .B ESHUTDOWN Cannot send after transport endpoint shutdown @@ -451,7 +451,7 @@ .B ESTALE Stale file handle (POSIX.1) .sp -This error can occur for NFS and for other file systems +This error can occur for NFS and for other filesystems .TP .B ESTRPIPE Streams pipe error @@ -540,7 +540,7 @@ .BR perror (3), .BR strerror (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/error.3 manpages-3.54/man3/error.3 --- manpages-3.52/man3/error.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/error.3 2013-09-17 08:27:56.000000000 +0200 @@ -129,7 +129,7 @@ .BR program_invocation_name (3), .BR strerror (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ether_aton.3 manpages-3.54/man3/ether_aton.3 --- manpages-3.52/man3/ether_aton.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ether_aton.3 2013-09-17 08:27:56.000000000 +0200 @@ -149,7 +149,7 @@ .SH SEE ALSO .BR ethers (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/euidaccess.3 manpages-3.54/man3/euidaccess.3 --- manpages-3.52/man3/euidaccess.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/euidaccess.3 2013-09-17 08:27:56.000000000 +0200 @@ -103,7 +103,7 @@ .BR credentials (7), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/exec.3 manpages-3.54/man3/exec.3 --- manpages-3.52/man3/exec.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/exec.3 2013-09-17 08:27:56.000000000 +0200 @@ -246,7 +246,7 @@ .BR fexecve (3), .BR environ (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/exit.3 manpages-3.54/man3/exit.3 --- manpages-3.52/man3/exit.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/exit.3 2013-09-17 08:27:56.000000000 +0200 @@ -182,7 +182,7 @@ .BR on_exit (3), .BR tmpfile (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/exp10.3 manpages-3.54/man3/exp10.3 --- manpages-3.52/man3/exp10.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/exp10.3 2013-09-17 08:27:56.000000000 +0200 @@ -83,7 +83,7 @@ .BR log10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/exp2.3 manpages-3.54/man3/exp2.3 --- manpages-3.52/man3/exp2.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/exp2.3 2013-09-17 08:27:56.000000000 +0200 @@ -101,7 +101,7 @@ .BR exp10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/exp.3 manpages-3.54/man3/exp.3 --- manpages-3.52/man3/exp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/exp.3 2013-09-17 08:27:56.000000000 +0200 @@ -138,7 +138,7 @@ .BR exp2 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/expm1.3 manpages-3.54/man3/expm1.3 --- manpages-3.52/man3/expm1.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/expm1.3 2013-09-17 08:27:56.000000000 +0200 @@ -172,7 +172,7 @@ .BR log (3), .BR log1p (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fabs.3 manpages-3.54/man3/fabs.3 --- manpages-3.52/man3/fabs.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fabs.3 2013-09-17 08:27:56.000000000 +0200 @@ -29,7 +29,7 @@ .\" Modified Sat Jul 24 19:42:04 1993 by Rik Faith (faith@cs.unc.edu) .\" Added fabsl, fabsf, aeb, 2001-06-07 .\" -.TH FABS 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FABS 3 2013-07-10 "" "Linux Programmer's Manual" .SH NAME fabs, fabsf, fabsl \- absolute value of floating-point number .SH SYNOPSIS @@ -62,9 +62,7 @@ .RE .ad b .SH DESCRIPTION -The -.BR fabs () -functions return the absolute value of the floating-point +These functions return the absolute value of the floating-point number .IR x . .SH RETURN VALUE @@ -84,6 +82,14 @@ is negative infinity or positive infinity, positive infinity is returned. .SH ERRORS No errors occur. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR fabs (), +.BR fabsf (), +and +.BR fabsl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. The variant returning @@ -98,7 +104,7 @@ .BR labs (3), .BR rint (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fclose.3 manpages-3.54/man3/fclose.3 --- manpages-3.52/man3/fclose.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fclose.3 2013-09-17 08:27:56.000000000 +0200 @@ -106,7 +106,7 @@ .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fcloseall.3 manpages-3.54/man3/fcloseall.3 --- manpages-3.52/man3/fcloseall.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fcloseall.3 2013-09-17 08:27:56.000000000 +0200 @@ -66,7 +66,7 @@ .BR fopen (3), .BR setbuf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fdim.3 manpages-3.54/man3/fdim.3 --- manpages-3.52/man3/fdim.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fdim.3 2013-09-17 08:27:56.000000000 +0200 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH FDIM 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FDIM 3 2013-07-15 "" "Linux Programmer's Manual" .SH NAME fdim, fdimf, fdiml \- positive difference .SH SYNOPSIS @@ -78,12 +78,20 @@ .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796 .SH VERSIONS These functions first appeared in glibc in version 2.1. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR fdim (), +.BR fdimf (), +and +.BR fdiml () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fenv.3 manpages-3.54/man3/fenv.3 --- manpages-3.52/man3/fenv.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fenv.3 2013-09-17 08:27:56.000000000 +0200 @@ -323,7 +323,7 @@ .SH SEE ALSO .BR math_error (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ferror.3 manpages-3.54/man3/ferror.3 --- manpages-3.52/man3/ferror.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ferror.3 2013-09-17 08:27:56.000000000 +0200 @@ -125,7 +125,7 @@ .BR stdio (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fexecve.3 manpages-3.54/man3/fexecve.3 --- manpages-3.52/man3/fexecve.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fexecve.3 2013-09-17 08:27:56.000000000 +0200 @@ -87,7 +87,7 @@ .B ENOSYS The .I /proc -file system could not be accessed. +filesystem could not be accessed. .SH VERSIONS .BR fexecve () is implemented since glibc 2.3.2. @@ -100,13 +100,13 @@ .BR fexecve () is implemented using the .BR proc (5) -file system, so +filesystem, so .I /proc needs to be mounted and available at the time of the call. .SH SEE ALSO .BR execve (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fflush.3 manpages-3.54/man3/fflush.3 --- manpages-3.52/man3/fflush.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fflush.3 2013-09-17 08:27:56.000000000 +0200 @@ -42,7 +42,7 @@ .\" Modified 2000-07-22 by Nicolás Lichtmaier .\" Modified 2001-10-16 by John Levon .\" -.TH FFLUSH 3 2009-09-06 "GNU" "Linux Programmer's Manual" +.TH FFLUSH 3 2013-07-15 "GNU" "Linux Programmer's Manual" .SH NAME fflush \- flush a stream .SH SYNOPSIS @@ -90,6 +90,11 @@ .I errno for any of the errors specified for .BR write (2). +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR fflush () +function is thread-safe. .SH CONFORMING TO C89, C99, POSIX.1-2001, POSIX.1-2008. @@ -114,7 +119,7 @@ .BR setbuf (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ffs.3 manpages-3.54/man3/ffs.3 --- manpages-3.52/man3/ffs.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ffs.3 2013-09-17 08:27:56.000000000 +0200 @@ -103,7 +103,7 @@ .SH SEE ALSO .BR memchr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fgetgrent.3 manpages-3.54/man3/fgetgrent.3 --- manpages-3.52/man3/fgetgrent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fgetgrent.3 2013-09-17 08:27:56.000000000 +0200 @@ -102,7 +102,7 @@ .BR setgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fgetpwent.3 manpages-3.54/man3/fgetpwent.3 --- manpages-3.52/man3/fgetpwent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fgetpwent.3 2013-09-17 08:27:56.000000000 +0200 @@ -112,7 +112,7 @@ .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fgetwc.3 manpages-3.54/man3/fgetwc.3 --- manpages-3.52/man3/fgetwc.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fgetwc.3 2013-09-17 08:27:56.000000000 +0200 @@ -90,7 +90,7 @@ .BR ungetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fgetws.3 manpages-3.54/man3/fgetws.3 --- manpages-3.52/man3/fgetws.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fgetws.3 2013-09-17 08:27:56.000000000 +0200 @@ -74,7 +74,7 @@ .BR fgetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/finite.3 manpages-3.54/man3/finite.3 --- manpages-3.52/man3/finite.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/finite.3 2013-09-17 08:27:56.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FINITE 3 2008-08-05 "" "Linux Programmer's Manual" +.TH FINITE 3 2013-07-22 "" "Linux Programmer's Manual" .SH NAME finite, finitef, finitel, isinf, isinff, isinfl, isnan, isnanf, isnanl \- BSD floating-point classification functions @@ -89,26 +89,49 @@ .ad b .SH DESCRIPTION The -.BR finite () +.BR finite (), +.BR finitef (), +and +.BR finitel () functions return a nonzero value if .I x is neither infinite nor a "not-a-number" (NaN) value, and 0 otherwise. The -.BR isnan () +.BR isnan (), +.BR isnanf (), +and +.BR isnanl () functions return a nonzero value if .I x is a NaN value, and 0 otherwise. The -.BR isinf () +.BR isinf (), +.BR isinff (), +and +.BR isinfl () functions return 1 if .I x is positive infinity, \-1 if .I x is negative infinity, and 0 otherwise. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR finite (), +.BR finitef (), +.BR finitel (), +.BR isinf (), +.BR isinff (), +.BR isinfl (), +.BR isnan (), +.BR isnanf (), +and +.BR isnanl () +functions are thread-safe. .SH NOTES Note that these functions are obsolete. C99 defines macros @@ -132,7 +155,7 @@ .SH SEE ALSO .BR fpclassify (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/flockfile.3 manpages-3.54/man3/flockfile.3 --- manpages-3.52/man3/flockfile.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/flockfile.3 2013-09-17 08:27:56.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FLOCKFILE 3 2008-08-29 "" "Linux Programmer's Manual" +.TH FLOCKFILE 3 2013-07-23 "" "Linux Programmer's Manual" .SH NAME flockfile, ftrylockfile, funlockfile \- lock FILE for stdio .SH SYNOPSIS @@ -124,6 +124,14 @@ (the lock was obtained), and nonzero for failure. .SH ERRORS None. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR flockfile (), +.BR ftrylockfile (), +and +.BR funlockfile () +functions are thread-safe. .SH CONFORMING TO POSIX.1-2001. .SH AVAILABILITY @@ -135,7 +143,7 @@ .SH SEE ALSO .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/floor.3 manpages-3.54/man3/floor.3 --- manpages-3.52/man3/floor.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/floor.3 2013-09-17 08:27:56.000000000 +0200 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH FLOOR 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FLOOR 3 2013-07-23 "" "Linux Programmer's Manual" .SH NAME floor, floorf, floorl \- largest integral value not greater than argument .SH SYNOPSIS @@ -77,6 +77,14 @@ .SH ERRORS No errors occur. POSIX.1-2001 documents a range error for overflows, but see NOTES. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR floor (), +.BR floorf (), +and +.BR floorl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. The variant returning @@ -107,7 +115,7 @@ .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fma.3 manpages-3.54/man3/fma.3 --- manpages-3.52/man3/fma.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fma.3 2013-09-17 08:27:56.000000000 +0200 @@ -9,7 +9,7 @@ .\" Modified 2004-11-15, Added further text on FLT_ROUNDS .\" as suggested by AEB and Fabian Kreutz .\" -.TH FMA 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FMA 3 2013-09-17 "" "Linux Programmer's Manual" .SH NAME fma, fmaf, fmal \- floating-point multiply and add .SH SYNOPSIS @@ -153,13 +153,21 @@ .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801 .SH VERSIONS These functions first appeared in glibc in version 2.1. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR fma (), +.BR fmaf (), +and +.BR fmal () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH SEE ALSO .BR remainder (3), .BR remquo (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fmax.3 manpages-3.54/man3/fmax.3 --- manpages-3.52/man3/fmax.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fmax.3 2013-09-17 08:27:56.000000000 +0200 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH FMAX 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FMAX 3 2013-09-17 "" "Linux Programmer's Manual" .SH NAME fmax, fmaxf, fmaxl \- determine maximum of two floating-point numbers .SH SYNOPSIS @@ -55,12 +55,20 @@ No errors occur. .SH VERSIONS These functions first appeared in glibc in version 2.1. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR fmax (), +.BR fmaxf (), +and +.BR fmaxl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH SEE ALSO .BR fmin (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fmemopen.3 manpages-3.54/man3/fmemopen.3 --- manpages-3.52/man3/fmemopen.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fmemopen.3 2013-09-17 08:27:56.000000000 +0200 @@ -342,7 +342,7 @@ .BR fopen (3), .BR fopencookie (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fmin.3 manpages-3.54/man3/fmin.3 --- manpages-3.52/man3/fmin.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fmin.3 2013-09-17 08:27:56.000000000 +0200 @@ -6,7 +6,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH FMIN 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FMIN 3 2013-09-17 "" "Linux Programmer's Manual" .SH NAME fmin, fminf, fminl \- determine minimum of two floating-point numbers .SH SYNOPSIS @@ -38,7 +38,7 @@ .RE .ad .SH DESCRIPTION -These functions the lesser value of +These functions return the lesser value of .I x and .IR y . @@ -55,12 +55,20 @@ No errors occur. .SH VERSIONS These functions first appeared in glibc in version 2.1. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR fmin (), +.BR fminf (), +and +.BR fminl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH SEE ALSO .BR fmax (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fmod.3 manpages-3.54/man3/fmod.3 --- manpages-3.52/man3/fmod.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fmod.3 2013-09-17 08:27:56.000000000 +0200 @@ -160,7 +160,7 @@ .SH SEE ALSO .BR remainder (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fmtmsg.3 manpages-3.54/man3/fmtmsg.3 --- manpages-3.52/man3/fmtmsg.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fmtmsg.3 2013-09-17 08:27:56.000000000 +0200 @@ -310,7 +310,7 @@ .BR addseverity (3), .BR perror (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fnmatch.3 manpages-3.54/man3/fnmatch.3 --- manpages-3.52/man3/fnmatch.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fnmatch.3 2013-09-17 08:27:56.000000000 +0200 @@ -105,7 +105,7 @@ .BR wordexp (3), .BR glob (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fopen.3 manpages-3.54/man3/fopen.3 --- manpages-3.52/man3/fopen.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fopen.3 2013-09-17 08:27:56.000000000 +0200 @@ -352,7 +352,7 @@ .BR fmemopen (3), .BR fopencookie (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fopencookie.3 manpages-3.54/man3/fopencookie.3 --- manpages-3.52/man3/fopencookie.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fopencookie.3 2013-09-17 08:27:56.000000000 +0200 @@ -440,7 +440,7 @@ .BR fopen (3), .BR fseek (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fpathconf.3 manpages-3.54/man3/fpathconf.3 --- manpages-3.52/man3/fpathconf.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fpathconf.3 2013-09-17 08:27:56.000000000 +0200 @@ -183,7 +183,7 @@ .BR statfs (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fpclassify.3 manpages-3.54/man3/fpclassify.3 --- manpages-3.52/man3/fpclassify.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fpclassify.3 2013-09-17 08:27:56.000000000 +0200 @@ -7,7 +7,7 @@ .\" This was done with the help of the glibc manual. .\" .\" 2004-10-31, aeb, corrected -.TH FPCLASSIFY 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FPCLASSIFY 3 2013-08-06 "" "Linux Programmer's Manual" .SH NAME fpclassify, isfinite, isnormal, isnan, isinf \- floating-point classification macros @@ -115,6 +115,16 @@ is positive infinity, and \-1 if .I x is negative infinity. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR fpclassify (), +.BR isfinite (), +.BR isnormal (), +.BR isnan (), +and +.BR isinf () +macros are thread-safe. .SH CONFORMING TO C99, POSIX.1. @@ -135,7 +145,7 @@ .BR isgreater (3), .BR signbit (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fpurge.3 manpages-3.54/man3/fpurge.3 --- manpages-3.52/man3/fpurge.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fpurge.3 2013-09-17 08:27:56.000000000 +0200 @@ -83,7 +83,7 @@ .BR setbuf (3), .BR stdio_ext (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fputwc.3 manpages-3.54/man3/fputwc.3 --- manpages-3.52/man3/fputwc.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fputwc.3 2013-09-17 08:27:56.000000000 +0200 @@ -87,7 +87,7 @@ .BR fputws (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fputws.3 manpages-3.54/man3/fputws.3 --- manpages-3.52/man3/fputws.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fputws.3 2013-09-17 08:27:56.000000000 +0200 @@ -61,7 +61,7 @@ .BR fputwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fread.3 manpages-3.54/man3/fread.3 --- manpages-3.52/man3/fread.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fread.3 2013-09-17 08:27:56.000000000 +0200 @@ -109,7 +109,7 @@ .BR ferror (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/frexp.3 manpages-3.54/man3/frexp.3 --- manpages-3.52/man3/frexp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/frexp.3 2013-09-17 08:27:56.000000000 +0200 @@ -30,7 +30,7 @@ .\" Modified 2002-07-27 by Walter Harms .\" (walter.harms@informatik.uni-oldenburg.de) .\" -.TH FREXP 3 2010-09-20 "" "Linux Programmer's Manual" +.TH FREXP 3 2013-08-06 "" "Linux Programmer's Manual" .SH NAME frexp, frexpf, frexpl \- convert floating-point number to fractional and integral components @@ -105,6 +105,14 @@ is unspecified. .SH ERRORS No errors occur. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR frexp (), +.BR frexpf (), +and +.BR frexpl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. The variant returning @@ -148,7 +156,7 @@ .BR ldexp (3), .BR modf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fseek.3 manpages-3.54/man3/fseek.3 --- manpages-3.52/man3/fseek.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fseek.3 2013-09-17 08:27:56.000000000 +0200 @@ -171,7 +171,7 @@ .BR lseek (2), .BR fseeko (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fseeko.3 manpages-3.54/man3/fseeko.3 --- manpages-3.52/man3/fseeko.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fseeko.3 2013-09-17 08:27:56.000000000 +0200 @@ -93,7 +93,7 @@ .SH SEE ALSO .BR fseek (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ftime.3 manpages-3.54/man3/ftime.3 --- manpages-3.52/man3/ftime.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ftime.3 2013-09-17 08:27:56.000000000 +0200 @@ -95,7 +95,7 @@ .BR gettimeofday (2), .BR time (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ftok.3 manpages-3.54/man3/ftok.3 --- manpages-3.52/man3/ftok.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ftok.3 2013-09-17 08:27:56.000000000 +0200 @@ -105,7 +105,7 @@ .BR stat (2), .BR svipc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fts.3 manpages-3.54/man3/fts.3 --- manpages-3.52/man3/fts.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fts.3 2013-09-17 08:27:56.000000000 +0200 @@ -789,7 +789,7 @@ .BR ftw (3), .BR qsort (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ftw.3 manpages-3.54/man3/ftw.3 --- manpages-3.52/man3/ftw.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ftw.3 2013-09-17 08:27:56.000000000 +0200 @@ -225,7 +225,7 @@ (By default, each directory is handled \fIbefore\fP its contents.) .TP .B FTW_MOUNT -If set, stay within the same file system +If set, stay within the same filesystem (i.e., do not cross mount points). .TP .B FTW_PHYS @@ -407,7 +407,7 @@ .BR fts (3), .BR readdir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/futimes.3 manpages-3.54/man3/futimes.3 --- manpages-3.52/man3/futimes.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/futimes.3 2013-09-17 08:27:56.000000000 +0200 @@ -76,7 +76,7 @@ .B ENOSYS The .I /proc -file system could not be accessed. +filesystem could not be accessed. .PP The following additional error may occur for .BR lutimes (): @@ -98,7 +98,7 @@ .BR utimensat (2), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/fwide.3 manpages-3.54/man3/fwide.3 --- manpages-3.52/man3/fwide.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/fwide.3 2013-09-17 08:27:56.000000000 +0200 @@ -99,7 +99,7 @@ .BR fprintf (3), .BR fwprintf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/gamma.3 manpages-3.54/man3/gamma.3 --- manpages-3.52/man3/gamma.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/gamma.3 2013-09-17 08:27:56.000000000 +0200 @@ -99,7 +99,7 @@ .BR signgam (3), .BR tgamma (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/gcvt.3 manpages-3.54/man3/gcvt.3 --- manpages-3.52/man3/gcvt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/gcvt.3 2013-09-17 08:27:56.000000000 +0200 @@ -88,7 +88,7 @@ .BR fcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getaddrinfo.3 manpages-3.54/man3/getaddrinfo.3 --- manpages-3.52/man3/getaddrinfo.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getaddrinfo.3 2013-09-17 08:27:56.000000000 +0200 @@ -825,7 +825,7 @@ .BR hostname (7), .BR ip (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getaddrinfo_a.3 manpages-3.54/man3/getaddrinfo_a.3 --- manpages-3.52/man3/getaddrinfo_a.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getaddrinfo_a.3 2013-09-17 08:27:56.000000000 +0200 @@ -605,7 +605,7 @@ .BR ip (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getauxval.3 manpages-3.54/man3/getauxval.3 --- manpages-3.52/man3/getauxval.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getauxval.3 2013-09-17 08:27:56.000000000 +0200 @@ -215,7 +215,7 @@ The kernel source file .IR Documentation/ABI/stable/vdso .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getcontext.3 manpages-3.54/man3/getcontext.3 --- manpages-3.52/man3/getcontext.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getcontext.3 2013-09-17 08:27:56.000000000 +0200 @@ -192,7 +192,7 @@ .BR makecontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getcwd.3 manpages-3.54/man3/getcwd.3 --- manpages-3.52/man3/getcwd.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getcwd.3 2013-09-17 08:27:56.000000000 +0200 @@ -148,7 +148,7 @@ (Note that on some systems, .B PATH_MAX may not be a compile-time constant; -furthermore, its value may depend on the file system, see +furthermore, its value may depend on the filesystem, see .BR pathconf (3).) For portability and security reasons, use of .BR getwd () @@ -233,7 +233,7 @@ is a system call (since 2.1.92). On older systems it would query .IR /proc/self/cwd . -If both system call and proc file system are missing, a +If both system call and proc filesystem are missing, a generic implementation is called. Only in that case can these calls fail under Linux with @@ -254,7 +254,7 @@ .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getdate.3 manpages-3.54/man3/getdate.3 --- manpages-3.52/man3/getdate.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getdate.3 2013-09-17 08:27:56.000000000 +0200 @@ -313,7 +313,7 @@ .BR strftime (3), .BR strptime (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getdirentries.3 manpages-3.54/man3/getdirentries.3 --- manpages-3.52/man3/getdirentries.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getdirentries.3 2013-09-17 08:27:56.000000000 +0200 @@ -26,7 +26,7 @@ .\" .TH GETDIRENTRIES 3 2007-07-26 "GNU" "Linux Programmer's Manual" .SH NAME -getdirentries \- get directory entries in a file system-independent format +getdirentries \- get directory entries in a filesystem-independent format .SH SYNOPSIS .B #include .sp @@ -73,7 +73,7 @@ .BR lseek (2), .BR open (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getdtablesize.3 manpages-3.54/man3/getdtablesize.3 --- manpages-3.52/man3/getdtablesize.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getdtablesize.3 2013-09-17 08:27:56.000000000 +0200 @@ -93,7 +93,7 @@ .BR getrlimit (2), .BR open (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getenv.3 manpages-3.54/man3/getenv.3 --- manpages-3.52/man3/getenv.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getenv.3 2013-09-17 08:27:56.000000000 +0200 @@ -135,7 +135,7 @@ .BR capabilities (7), .BR environ (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getfsent.3 manpages-3.54/man3/getfsent.3 --- manpages-3.52/man3/getfsent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getfsent.3 2013-09-17 08:27:56.000000000 +0200 @@ -140,7 +140,7 @@ .BR getmntent (3), .BR fstab (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getgrent.3 manpages-3.54/man3/getgrent.3 --- manpages-3.52/man3/getgrent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getgrent.3 2013-09-17 08:27:56.000000000 +0200 @@ -174,7 +174,7 @@ .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getgrent_r.3 manpages-3.54/man3/getgrent_r.3 --- manpages-3.52/man3/getgrent_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getgrent_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -188,7 +188,7 @@ .BR putgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getgrnam.3 manpages-3.54/man3/getgrnam.3 --- manpages-3.52/man3/getgrnam.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getgrnam.3 2013-09-17 08:27:56.000000000 +0200 @@ -30,7 +30,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2003-11-15 by aeb .\" -.TH GETGRNAM 3 2013-06-21 "" "Linux Programmer's Manual" +.TH GETGRNAM 3 2013-07-22 "" "Linux Programmer's Manual" .SH NAME getgrnam, getgrnam_r, getgrgid, getgrgid_r \- get group file entry .SH SYNOPSIS @@ -209,17 +209,17 @@ local group database file .SH ATTRIBUTES .SS Multithreading (see pthreads(7)) -The functions +The .BR getgrnam () and .BR getgrgid () -are not thread-safe. +functions are not thread-safe. .LP -The functions +The .BR getgrnam_r () and .BR getgrgid_r () -are thread-safe. +functions are thread-safe. .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES @@ -251,7 +251,7 @@ .BR setgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getgrouplist.3 manpages-3.54/man3/getgrouplist.3 --- manpages-3.52/man3/getgrouplist.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getgrouplist.3 2013-09-17 08:27:56.000000000 +0200 @@ -193,7 +193,7 @@ .BR group (5), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/gethostbyname.3 manpages-3.54/man3/gethostbyname.3 --- manpages-3.52/man3/gethostbyname.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/gethostbyname.3 2013-09-17 08:27:56.000000000 +0200 @@ -35,7 +35,7 @@ .\" Modified 2002-08-05, Michael Kerrisk .\" Modified 2004-10-31, Andries Brouwer .\" -.TH GETHOSTBYNAME 3 2010-10-04 "" "Linux Programmer's Manual" +.TH GETHOSTBYNAME 3 2013-09-04 "" "Linux Programmer's Manual" .SH NAME gethostbyname, gethostbyaddr, sethostent, gethostent, endhostent, h_errno, @@ -107,24 +107,41 @@ .BR hstrerror (): .RS 4 .TP 4 -Since glibc 2.8: +Since glibc 2.12: +_BSD_SOURCE || _SVID_SOURCE +.TP 4 +From glibc 2.8 to glibc 2.11: _BSD_SOURCE || _SVID_SOURCE || _GNU_SOURCE .TP Before glibc 2.8: none .RE + +.BR h_errno : +.RS 4 +.TP 4 +Since glibc 2.12: +_BSD_SOURCE || _SVID_SOURCE || + (_POSIX_C_SOURCE < 200809L && _XOPEN_SOURCE < 700) +.TP +Before glibc 2.12: +none +.RE .ad b .PD .SH DESCRIPTION The -.BR gethostbyname* () +.BR gethostbyname* (), +.BR gethostbyaddr* (), +.BR herror (), and -.BR gethostbyaddr* () +.BR hstrerror () functions are obsolete. Applications should use -.BR getaddrinfo (3) +.BR getaddrinfo (3), +.BR getnameinfo (3), and -.BR getnameinfo (3) +.BR gai_strerror (3) instead. The @@ -441,7 +458,7 @@ .BR named (8) .\" .BR resolv+ (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/gethostid.3 manpages-3.54/man3/gethostid.3 --- manpages-3.52/man3/gethostid.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/gethostid.3 2013-09-17 08:27:56.000000000 +0200 @@ -125,7 +125,7 @@ .BR hostid (1), .BR gethostbyname (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getifaddrs.3 manpages-3.54/man3/getifaddrs.3 --- manpages-3.52/man3/getifaddrs.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getifaddrs.3 2013-09-17 08:27:56.000000000 +0200 @@ -294,7 +294,7 @@ .BR packet (7), .BR ifconfig (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getipnodebyname.3 manpages-3.54/man3/getipnodebyname.3 --- manpages-3.52/man3/getipnodebyname.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getipnodebyname.3 2013-09-17 08:27:56.000000000 +0200 @@ -269,7 +269,7 @@ .BR inet_ntop (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getline.3 manpages-3.54/man3/getline.3 --- manpages-3.52/man3/getline.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getline.3 2013-09-17 08:27:56.000000000 +0200 @@ -176,7 +176,7 @@ .BR gets (3), .BR scanf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getloadavg.3 manpages-3.54/man3/getloadavg.3 --- manpages-3.52/man3/getloadavg.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getloadavg.3 2013-09-17 08:27:56.000000000 +0200 @@ -70,7 +70,7 @@ .BR uptime (1), .BR proc (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getlogin.3 manpages-3.54/man3/getlogin.3 --- manpages-3.52/man3/getlogin.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getlogin.3 2013-09-17 08:27:56.000000000 +0200 @@ -211,7 +211,7 @@ .BR getuid (2), .BR utmp (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getmntent.3 manpages-3.54/man3/getmntent.3 --- manpages-3.52/man3/getmntent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getmntent.3 2013-09-17 08:27:56.000000000 +0200 @@ -32,7 +32,7 @@ .TH GETMNTENT 3 2009-09-15 "" "Linux Programmer's Manual" .SH NAME getmntent, setmntent, addmntent, endmntent, hasmntopt, -getmntent_r \- get file system descriptor file entry +getmntent_r \- get filesystem descriptor file entry .SH SYNOPSIS .nf .B #include @@ -63,14 +63,14 @@ .BR getmntent_r (): _BSD_SOURCE || _SVID_SOURCE .SH DESCRIPTION -These routines are used to access the file system description file +These routines are used to access the filesystem description file .I /etc/fstab -and the mounted file system description file -.IR etc/mtab . +and the mounted filesystem description file +.IR /etc/mtab . .PP The .BR setmntent () -function opens the file system description file +function opens the filesystem description file .I filename and returns a file pointer which can be used by .BR getmntent (). @@ -84,7 +84,7 @@ .PP The .BR getmntent () -function reads the next line from the file system +function reads the next line from the filesystem description file .I fp and returns a pointer to a structure @@ -106,7 +106,7 @@ .PP The .BR endmntent () -function closes the file system description file +function closes the filesystem description file .IR fp . .PP The @@ -149,8 +149,8 @@ .in +4n .nf struct mntent { - char *mnt_fsname; /* name of mounted file system */ - char *mnt_dir; /* file system path prefix */ + char *mnt_fsname; /* name of mounted filesystem */ + char *mnt_dir; /* filesystem path prefix */ char *mnt_type; /* mount type (see mntent.h) */ char *mnt_opts; /* mount options (see mntent.h) */ int mnt_freq; /* dump frequency in days */ @@ -195,8 +195,8 @@ a match is found and NULL otherwise. .SH FILES .nf -/etc/fstab file system description file -/etc/mtab mounted file system description file +/etc/fstab filesystem description file +/etc/mtab mounted filesystem description file .fi .SH CONFORMING TO The nonreentrant functions are from SunOS 4.1.3. @@ -221,7 +221,7 @@ .BR fstab (5), .BR mount (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getnameinfo.3 manpages-3.54/man3/getnameinfo.3 --- manpages-3.52/man3/getnameinfo.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getnameinfo.3 2013-09-17 08:27:56.000000000 +0200 @@ -306,7 +306,7 @@ .UR http://www.usenix.org\:/publications\:/library\:/proceedings\:/usenix2000\:/freenix\:/metzprotocol.html .UE . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getnetent.3 manpages-3.54/man3/getnetent.3 --- manpages-3.52/man3/getnetent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getnetent.3 2013-09-17 08:27:56.000000000 +0200 @@ -159,7 +159,7 @@ .br RFC\ 1101 .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getnetent_r.3 manpages-3.54/man3/getnetent_r.3 --- manpages-3.52/man3/getnetent_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getnetent_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -146,7 +146,7 @@ .BR getnetent (3), .BR networks (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/get_nprocs_conf.3 manpages-3.54/man3/get_nprocs_conf.3 --- manpages-3.52/man3/get_nprocs_conf.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/get_nprocs_conf.3 2013-09-17 08:27:56.000000000 +0200 @@ -53,7 +53,7 @@ implementation of these functions is rather expensive, since they open and parse files in the .I /sys -file system each time they are called. +filesystem each time they are called. The following .BR sysconf (3) @@ -86,7 +86,7 @@ .fi .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getopt.3 manpages-3.54/man3/getopt.3 --- manpages-3.52/man3/getopt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getopt.3 2013-09-17 08:27:56.000000000 +0200 @@ -514,7 +514,7 @@ .SH SEE ALSO .BR getsubopt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getpass.3 manpages-3.54/man3/getpass.3 --- manpages-3.52/man3/getpass.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getpass.3 2013-09-17 08:27:56.000000000 +0200 @@ -159,7 +159,7 @@ .SH SEE ALSO .BR crypt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getprotoent.3 manpages-3.54/man3/getprotoent.3 --- manpages-3.52/man3/getprotoent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getprotoent.3 2013-09-17 08:27:56.000000000 +0200 @@ -145,7 +145,7 @@ .BR getservent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getprotoent_r.3 manpages-3.54/man3/getprotoent_r.3 --- manpages-3.52/man3/getprotoent_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getprotoent_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -238,7 +238,7 @@ .BR getprotoent (3), .BR protocols (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getpt.3 manpages-3.54/man3/getpt.3 --- manpages-3.52/man3/getpt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getpt.3 2013-09-17 08:27:56.000000000 +0200 @@ -53,7 +53,7 @@ .BR ptmx (4), .BR pty (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getpw.3 manpages-3.54/man3/getpw.3 --- manpages-3.52/man3/getpw.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getpw.3 2013-09-17 08:27:56.000000000 +0200 @@ -112,7 +112,7 @@ .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getpwent.3 manpages-3.54/man3/getpwent.3 --- manpages-3.52/man3/getpwent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getpwent.3 2013-09-17 08:27:56.000000000 +0200 @@ -176,7 +176,7 @@ .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getpwent_r.3 manpages-3.54/man3/getpwent_r.3 --- manpages-3.52/man3/getpwent_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getpwent_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -186,7 +186,7 @@ .BR putpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getpwnam.3 manpages-3.54/man3/getpwnam.3 --- manpages-3.52/man3/getpwnam.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getpwnam.3 2013-09-17 08:27:56.000000000 +0200 @@ -34,7 +34,7 @@ .\" Modified 2003-11-15 by aeb .\" 2008-11-07, mtk, Added an example program for getpwnam_r(). .\" -.TH GETPWNAM 3 2013-06-21 "GNU" "Linux Programmer's Manual" +.TH GETPWNAM 3 2013-07-22 "GNU" "Linux Programmer's Manual" .SH NAME getpwnam, getpwnam_r, getpwuid, getpwuid_r \- get password file entry .SH SYNOPSIS @@ -216,17 +216,17 @@ local password database file .SH ATTRIBUTES .SS Multithreading (see pthreads(7)) -The functions +The .BR getpwnam () and .BR getpwuid () -are not thread_safe. +functions are not thread-safe. .LP -The functions +The .BR getpwnam_r () and .BR getpwuid_r () -are thread-safe. +functions are thread-safe. .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. The @@ -334,7 +334,7 @@ .BR setpwent (3), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getrpcent.3 manpages-3.54/man3/getrpcent.3 --- manpages-3.52/man3/getrpcent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getrpcent.3 2013-09-17 08:27:56.000000000 +0200 @@ -113,7 +113,7 @@ .BR rpcinfo (8), .BR ypserv (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getrpcent_r.3 manpages-3.54/man3/getrpcent_r.3 --- manpages-3.52/man3/getrpcent_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getrpcent_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -135,7 +135,7 @@ .BR getrpcent (3), .BR rpc (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getrpcport.3 manpages-3.54/man3/getrpcport.3 --- manpages-3.52/man3/getrpcport.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getrpcport.3 2013-09-17 08:27:56.000000000 +0200 @@ -37,7 +37,7 @@ Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other systems. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/gets.3 manpages-3.54/man3/gets.3 --- manpages-3.52/man3/gets.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/gets.3 2013-09-17 08:27:56.000000000 +0200 @@ -187,7 +187,7 @@ .BR unlocked_stdio (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getservent.3 manpages-3.54/man3/getservent.3 --- manpages-3.52/man3/getservent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getservent.3 2013-09-17 08:27:56.000000000 +0200 @@ -162,7 +162,7 @@ .BR getservent_r (3), .BR services (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getservent_r.3 manpages-3.54/man3/getservent_r.3 --- manpages-3.52/man3/getservent_r.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getservent_r.3 2013-09-17 08:27:56.000000000 +0200 @@ -242,7 +242,7 @@ .BR getservent (3), .BR services (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getspnam.3 manpages-3.54/man3/getspnam.3 --- manpages-3.52/man3/getspnam.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getspnam.3 2013-09-17 08:27:56.000000000 +0200 @@ -256,7 +256,7 @@ .BR getpwnam_r (3), .BR shadow (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getsubopt.3 manpages-3.54/man3/getsubopt.3 --- manpages-3.52/man3/getsubopt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getsubopt.3 2013-09-17 08:27:56.000000000 +0200 @@ -226,7 +226,7 @@ .SH SEE ALSO .BR getopt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getttyent.3 manpages-3.54/man3/getttyent.3 --- manpages-3.52/man3/getttyent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getttyent.3 2013-09-17 08:27:56.000000000 +0200 @@ -4,7 +4,7 @@ .\" Distributed under GPL .\" %%%LICENSE_END .\" -.TH GETTTYENT 3 2013-06-21 "GNU" "Linux Programmer's Manual" +.TH GETTTYENT 3 2013-07-22 "GNU" "Linux Programmer's Manual" .SH NAME getttyent, getttynam, setttyent, endttyent \- get ttys file entry .SH SYNOPSIS @@ -73,17 +73,17 @@ .SS Multithreading (see pthreads(7)) The .BR getttyent () -returns a pointer to a static variable, so it is not thread-safe. +function returns a pointer to a static variable, so it is not thread-safe. .LP The .BR setttyent () and .BR endttyent () -use a static variable, so they are not thread-safe. +functions use a static variable, so they are not thread-safe. .LP The .BR getttynam () -calls thread-unsafe function +function calls thread-unsafe function .BR getttyent () so it is not thread-safe. .SH CONFORMING TO @@ -97,7 +97,7 @@ .BR ttyname (3), .BR ttyslot (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getumask.3 manpages-3.54/man3/getumask.3 --- manpages-3.52/man3/getumask.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getumask.3 2013-09-17 08:27:56.000000000 +0200 @@ -63,7 +63,7 @@ .SH SEE ALSO .BR umask (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getusershell.3 manpages-3.54/man3/getusershell.3 --- manpages-3.52/man3/getusershell.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getusershell.3 2013-09-17 08:27:56.000000000 +0200 @@ -103,7 +103,7 @@ .SH SEE ALSO .BR shells (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getutent.3 manpages-3.54/man3/getutent.3 --- manpages-3.52/man3/getutent.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getutent.3 2013-09-17 08:27:56.000000000 +0200 @@ -293,7 +293,7 @@ .BR getutmp (3), .BR utmp (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getutmp.3 manpages-3.54/man3/getutmp.3 --- manpages-3.52/man3/getutmp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getutmp.3 2013-09-17 08:27:56.000000000 +0200 @@ -70,7 +70,7 @@ .BR getutent (3), .BR utmp (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getw.3 manpages-3.54/man3/getw.3 --- manpages-3.52/man3/getw.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getw.3 2013-09-17 08:27:56.000000000 +0200 @@ -90,7 +90,7 @@ .BR getc (3), .BR putc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/getwchar.3 manpages-3.54/man3/getwchar.3 --- manpages-3.52/man3/getwchar.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/getwchar.3 2013-09-17 08:27:56.000000000 +0200 @@ -71,7 +71,7 @@ .BR fgetwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/glob.3 manpages-3.54/man3/glob.3 --- manpages-3.52/man3/glob.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/glob.3 2013-09-17 08:27:56.000000000 +0200 @@ -153,7 +153,7 @@ .IR pglob\->gl_opendir , .IR pglob\->gl_lstat ", and" .I pglob\->gl_stat -for file system access instead of the normal library +for filesystem access instead of the normal library functions. .TP .B GLOB_BRACE @@ -328,7 +328,7 @@ .BR wordexp (3), .BR glob (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/gnu_get_libc_version.3 manpages-3.54/man3/gnu_get_libc_version.3 --- manpages-3.52/man3/gnu_get_libc_version.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/gnu_get_libc_version.3 2013-09-17 08:27:56.000000000 +0200 @@ -76,7 +76,7 @@ .SH SEE ALSO .BR confstr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/grantpt.3 manpages-3.54/man3/grantpt.3 --- manpages-3.52/man3/grantpt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/grantpt.3 2013-09-17 08:27:56.000000000 +0200 @@ -69,7 +69,7 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/gsignal.3 manpages-3.54/man3/gsignal.3 --- manpages-3.52/man3/gsignal.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/gsignal.3 2013-09-17 08:27:56.000000000 +0200 @@ -105,7 +105,7 @@ .BR signal (2), .BR raise (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/hash.3 manpages-3.54/man3/hash.3 --- manpages-3.52/man3/hash.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/hash.3 2013-09-17 08:27:56.000000000 +0200 @@ -169,7 +169,7 @@ .IR "A New Hash Package for UNIX" , Margo Seltzer, USENIX Proceedings, Winter 1991. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/hsearch.3 manpages-3.54/man3/hsearch.3 --- manpages-3.52/man3/hsearch.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/hsearch.3 2013-09-17 08:27:56.000000000 +0200 @@ -32,7 +32,7 @@ .\" 2008-09-03, mtk, restructured somewhat, in part after suggestions from .\" Timothy S. Nelson .\" -.TH HSEARCH 3 2013-04-19 "GNU" "Linux Programmer's Manual" +.TH HSEARCH 3 2013-07-22 "GNU" "Linux Programmer's Manual" .SH NAME hcreate, hdestroy, hsearch, hcreate_r, hdestroy_r, hsearch_r \- hash table management @@ -230,19 +230,19 @@ error. .SH ATTRIBUTES .SS Multithreading (see pthreads(7)) -The functions +The .BR hcreate (), .BR hsearch (), and .BR hdestroy () -use a global space for storing the table, so they are not thread-safe. +functions use a global space for storing the table, so they are not thread-safe. .LP -The functions +The .BR hcreate_r (), .BR hsearch_r (), and .BR hdestroy_r () -are thread-safe. +functions are thread-safe. .SH CONFORMING TO The functions .BR hcreate (), @@ -346,7 +346,7 @@ .BR malloc (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/hypot.3 manpages-3.54/man3/hypot.3 --- manpages-3.52/man3/hypot.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/hypot.3 2013-09-17 08:27:56.000000000 +0200 @@ -165,7 +165,7 @@ .BR cabs (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iconv.3 manpages-3.54/man3/iconv.3 --- manpages-3.52/man3/iconv.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iconv.3 2013-09-17 08:27:56.000000000 +0200 @@ -164,7 +164,7 @@ .BR iconv_close (3), .BR iconv_open (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iconv_close.3 manpages-3.54/man3/iconv_close.3 --- manpages-3.52/man3/iconv_close.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iconv_close.3 2013-09-17 08:27:56.000000000 +0200 @@ -42,7 +42,7 @@ .BR iconv (3), .BR iconv_open (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iconv_open.3 manpages-3.54/man3/iconv_open.3 --- manpages-3.52/man3/iconv_open.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iconv_open.3 2013-09-17 08:27:56.000000000 +0200 @@ -111,7 +111,7 @@ .BR iconv (3), .BR iconv_close (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/if_nameindex.3 manpages-3.54/man3/if_nameindex.3 --- manpages-3.52/man3/if_nameindex.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/if_nameindex.3 2013-09-17 08:27:56.000000000 +0200 @@ -151,7 +151,7 @@ .BR if_nametoindex (3), .BR ifconfig (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/if_nametoindex.3 manpages-3.54/man3/if_nametoindex.3 --- manpages-3.52/man3/if_nametoindex.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/if_nametoindex.3 2013-09-17 08:27:56.000000000 +0200 @@ -91,7 +91,7 @@ .BR if_nameindex (3), .BR ifconfig (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ilogb.3 manpages-3.54/man3/ilogb.3 --- manpages-3.52/man3/ilogb.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ilogb.3 2013-09-17 08:27:57.000000000 +0200 @@ -26,7 +26,7 @@ .\" .\" Inspired by a page by Walter Harms created 2002-08-10 .\" -.TH ILOGB 3 2010-09-20 "" "Linux Programmer's Manual" +.TH ILOGB 3 2013-08-06 "" "Linux Programmer's Manual" .SH NAME ilogb, ilogbf, ilogbl \- get integer exponent of a floating-point value .SH SYNOPSIS @@ -143,6 +143,14 @@ .\" or raise an exception? .\" log(), log2(), log10() do set errno .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794 +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR ilogb (), +.BR ilogbf (), +and +.BR ilogbl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH SEE ALSO @@ -150,7 +158,7 @@ .BR logb (3), .BR significand (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/index.3 manpages-3.54/man3/index.3 --- manpages-3.52/man3/index.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/index.3 2013-09-17 08:27:57.000000000 +0200 @@ -81,7 +81,7 @@ .BR strstr (3), .BR strtok (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/inet.3 manpages-3.54/man3/inet.3 --- manpages-3.52/man3/inet.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/inet.3 2013-09-17 08:27:57.000000000 +0200 @@ -305,7 +305,7 @@ .BR hosts (5), .BR networks (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/inet_ntop.3 manpages-3.54/man3/inet_ntop.3 --- manpages-3.52/man3/inet_ntop.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/inet_ntop.3 2013-09-17 08:27:57.000000000 +0200 @@ -120,7 +120,7 @@ .BR inet (3), .BR inet_pton (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/inet_pton.3 manpages-3.54/man3/inet_pton.3 --- manpages-3.52/man3/inet_pton.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/inet_pton.3 2013-09-17 08:27:57.000000000 +0200 @@ -217,7 +217,7 @@ .BR inet (3), .BR inet_ntop (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/INFINITY.3 manpages-3.54/man3/INFINITY.3 --- manpages-3.52/man3/INFINITY.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/INFINITY.3 2013-09-17 08:27:57.000000000 +0200 @@ -102,7 +102,7 @@ .BR fpclassify (3), .BR math_error (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/infnan.3 manpages-3.54/man3/infnan.3 --- manpages-3.52/man3/infnan.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/infnan.3 2013-09-17 08:27:57.000000000 +0200 @@ -90,7 +90,7 @@ This obsolete function was provided in libc4 and libc5, but is not available in glibc2. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/initgroups.3 manpages-3.54/man3/initgroups.3 --- manpages-3.52/man3/initgroups.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/initgroups.3 2013-09-17 08:27:57.000000000 +0200 @@ -92,7 +92,7 @@ .BR setgroups (2), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/insque.3 manpages-3.54/man3/insque.3 --- manpages-3.52/man3/insque.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/insque.3 2013-09-17 08:27:57.000000000 +0200 @@ -242,7 +242,7 @@ } .fi .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/intro.3 manpages-3.54/man3/intro.3 --- manpages-3.52/man3/intro.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/intro.3 2013-09-17 08:27:57.000000000 +0200 @@ -108,7 +108,7 @@ .BR signal (7), .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/isalpha.3 manpages-3.54/man3/isalpha.3 --- manpages-3.52/man3/isalpha.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/isalpha.3 2013-09-17 08:27:57.000000000 +0200 @@ -205,7 +205,7 @@ .BR ascii (7), .BR locale (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/isatty.3 manpages-3.54/man3/isatty.3 --- manpages-3.52/man3/isatty.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/isatty.3 2013-09-17 08:27:57.000000000 +0200 @@ -65,7 +65,7 @@ .BR fstat (2), .BR ttyname (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/isgreater.3 manpages-3.54/man3/isgreater.3 --- manpages-3.52/man3/isgreater.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/isgreater.3 2013-09-17 08:27:57.000000000 +0200 @@ -133,7 +133,7 @@ .BR fpclassify (3), .BR isnan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswalnum.3 manpages-3.54/man3/iswalnum.3 --- manpages-3.52/man3/iswalnum.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswalnum.3 2013-09-17 08:27:57.000000000 +0200 @@ -76,7 +76,7 @@ .BR isalnum (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswalpha.3 manpages-3.54/man3/iswalpha.3 --- manpages-3.52/man3/iswalpha.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswalpha.3 2013-09-17 08:27:57.000000000 +0200 @@ -80,7 +80,7 @@ .BR isalpha (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswblank.3 manpages-3.54/man3/iswblank.3 --- manpages-3.52/man3/iswblank.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswblank.3 2013-09-17 08:27:57.000000000 +0200 @@ -79,7 +79,7 @@ .BR isblank (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswcntrl.3 manpages-3.54/man3/iswcntrl.3 --- manpages-3.52/man3/iswcntrl.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswcntrl.3 2013-09-17 08:27:57.000000000 +0200 @@ -64,7 +64,7 @@ .BR iscntrl (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswctype.3 manpages-3.54/man3/iswctype.3 --- manpages-3.52/man3/iswctype.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswctype.3 2013-09-17 08:27:57.000000000 +0200 @@ -78,7 +78,7 @@ .BR iswxdigit (3), .BR wctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswdigit.3 manpages-3.54/man3/iswdigit.3 --- manpages-3.52/man3/iswdigit.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswdigit.3 2013-09-17 08:27:57.000000000 +0200 @@ -79,7 +79,7 @@ .BR isdigit (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswgraph.3 manpages-3.54/man3/iswgraph.3 --- manpages-3.52/man3/iswgraph.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswgraph.3 2013-09-17 08:27:57.000000000 +0200 @@ -72,7 +72,7 @@ .BR isgraph (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswlower.3 manpages-3.54/man3/iswlower.3 --- manpages-3.52/man3/iswlower.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswlower.3 2013-09-17 08:27:57.000000000 +0200 @@ -90,7 +90,7 @@ .BR iswctype (3), .BR towlower (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswprint.3 manpages-3.54/man3/iswprint.3 --- manpages-3.52/man3/iswprint.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswprint.3 2013-09-17 08:27:57.000000000 +0200 @@ -58,7 +58,7 @@ .BR isprint (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswpunct.3 manpages-3.54/man3/iswpunct.3 --- manpages-3.52/man3/iswpunct.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswpunct.3 2013-09-17 08:27:57.000000000 +0200 @@ -74,7 +74,7 @@ .BR ispunct (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswspace.3 manpages-3.54/man3/iswspace.3 --- manpages-3.52/man3/iswspace.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswspace.3 2013-09-17 08:27:57.000000000 +0200 @@ -66,7 +66,7 @@ .BR isspace (3), .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswupper.3 manpages-3.54/man3/iswupper.3 --- manpages-3.52/man3/iswupper.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswupper.3 2013-09-17 08:27:57.000000000 +0200 @@ -84,7 +84,7 @@ .BR iswctype (3), .BR towupper (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/iswxdigit.3 manpages-3.54/man3/iswxdigit.3 --- manpages-3.52/man3/iswxdigit.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/iswxdigit.3 2013-09-17 08:27:57.000000000 +0200 @@ -71,7 +71,7 @@ .BR iswctype (3), .BR isxdigit (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/j0.3 manpages-3.54/man3/j0.3 --- manpages-3.52/man3/j0.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/j0.3 2013-09-17 08:27:57.000000000 +0200 @@ -165,7 +165,7 @@ .SH SEE ALSO .BR y0 (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/key_setsecret.3 manpages-3.54/man3/key_setsecret.3 --- manpages-3.52/man3/key_setsecret.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/key_setsecret.3 2013-09-17 08:27:57.000000000 +0200 @@ -68,7 +68,7 @@ .SH SEE ALSO .BR crypt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ldexp.3 manpages-3.54/man3/ldexp.3 --- manpages-3.52/man3/ldexp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/ldexp.3 2013-09-17 08:27:57.000000000 +0200 @@ -31,7 +31,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2004-10-31 by aeb .\" -.TH LDEXP 3 2010-09-20 "" "Linux Programmer's Manual" +.TH LDEXP 3 2013-08-19 "" "Linux Programmer's Manual" .SH NAME ldexp, ldexpf, ldexpl \- multiply floating-point number by integral power of 2 .SH SYNOPSIS @@ -126,6 +126,14 @@ An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR ldexp (), +.BR ldexpf (), +and +.BR ldexpl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. The variant returning @@ -137,7 +145,7 @@ .BR modf (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/lgamma.3 manpages-3.54/man3/lgamma.3 --- manpages-3.52/man3/lgamma.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/lgamma.3 2013-09-17 08:27:57.000000000 +0200 @@ -175,7 +175,7 @@ .SH SEE ALSO .BR tgamma (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/lio_listio.3 manpages-3.54/man3/lio_listio.3 --- manpages-3.52/man3/lio_listio.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/lio_listio.3 2013-09-17 08:27:57.000000000 +0200 @@ -225,7 +225,7 @@ .BR aio_write (3), .BR aio (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/localeconv.3 manpages-3.54/man3/localeconv.3 --- manpages-3.52/man3/localeconv.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/localeconv.3 2013-09-17 08:27:57.000000000 +0200 @@ -84,7 +84,7 @@ .BR strftime (3), .BR locale (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/lockf.3 manpages-3.54/man3/lockf.3 --- manpages-3.52/man3/lockf.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/lockf.3 2013-09-17 08:27:57.000000000 +0200 @@ -169,7 +169,7 @@ is called .IR mandatory.txt ) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/log10.3 manpages-3.54/man3/log10.3 --- manpages-3.52/man3/log10.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/log10.3 2013-09-17 08:27:57.000000000 +0200 @@ -100,7 +100,7 @@ .BR log2 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/log1p.3 manpages-3.54/man3/log1p.3 --- manpages-3.52/man3/log1p.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/log1p.3 2013-09-17 08:27:57.000000000 +0200 @@ -147,7 +147,7 @@ .BR expm1 (3), .BR log (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/log2.3 manpages-3.54/man3/log2.3 --- manpages-3.52/man3/log2.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/log2.3 2013-09-17 08:27:57.000000000 +0200 @@ -101,7 +101,7 @@ .BR log10 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/log.3 manpages-3.54/man3/log.3 --- manpages-3.52/man3/log.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/log.3 2013-09-17 08:27:57.000000000 +0200 @@ -146,7 +146,7 @@ .BR log2 (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/logb.3 manpages-3.54/man3/logb.3 --- manpages-3.52/man3/logb.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/logb.3 2013-09-17 08:27:57.000000000 +0200 @@ -146,7 +146,7 @@ .BR ilogb (3), .BR log (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/login.3 manpages-3.54/man3/login.3 --- manpages-3.52/man3/login.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/login.3 2013-09-17 08:27:57.000000000 +0200 @@ -131,7 +131,7 @@ .BR getutent (3), .BR utmp (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/longjmp.3 manpages-3.54/man3/longjmp.3 --- manpages-3.52/man3/longjmp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/longjmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -133,7 +133,7 @@ .BR setjmp (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/lrint.3 manpages-3.54/man3/lrint.3 --- manpages-3.52/man3/lrint.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/lrint.3 2013-09-17 08:27:57.000000000 +0200 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH LRINT 3 2010-09-20 "" "Linux Programmer's Manual" +.TH LRINT 3 2013-08-19 "" "Linux Programmer's Manual" .SH NAME lrint, lrintf, lrintl, llrint, llrintf, llrintl \- round to nearest integer .SH SYNOPSIS @@ -106,6 +106,17 @@ .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6798 .SH VERSIONS These functions first appeared in glibc in version 2.1. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR lrint (), +.BR lrintf (), +.BR lrintl (), +.BR llrint (), +.BR llrintf (), +and +.BR llrintl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH SEE ALSO @@ -116,7 +127,7 @@ .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/lround.3 manpages-3.54/man3/lround.3 --- manpages-3.52/man3/lround.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/lround.3 2013-09-17 08:27:57.000000000 +0200 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH LROUND 3 2010-09-20 "" "Linux Programmer's Manual" +.TH LROUND 3 2013-08-26 "" "Linux Programmer's Manual" .SH NAME lround, lroundf, lroundl, llround, llroundf, llroundl \- round to nearest integer, away from zero @@ -109,6 +109,17 @@ .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6797 .SH VERSIONS These functions first appeared in glibc in version 2.1. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR lround (), +.BR lroundf (), +.BR lroundl (), +.BR llround (), +.BR llroundf (), +and +.BR llroundl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH SEE ALSO @@ -119,7 +130,7 @@ .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/lsearch.3 manpages-3.54/man3/lsearch.3 --- manpages-3.52/man3/lsearch.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/lsearch.3 2013-09-17 08:27:57.000000000 +0200 @@ -87,7 +87,7 @@ .BR hsearch (3), .BR tsearch (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/lseek64.3 manpages-3.54/man3/lseek64.3 --- manpages-3.52/man3/lseek64.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/lseek64.3 2013-09-17 08:27:57.000000000 +0200 @@ -22,7 +22,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH LSEEK64 3 2004-12-11 "Linux" "Linux Programmer's Manual" +.TH LSEEK64 3 2013-08-19 "Linux" "Linux Programmer's Manual" .SH NAME lseek64 \- reposition 64-bit read/write file offset .SH SYNOPSIS @@ -156,11 +156,16 @@ .sp For more details, see .BR llseek (2). +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR lseek64 () +function is thread-safe. .SH SEE ALSO .BR llseek (2), .BR lseek (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/makecontext.3 manpages-3.54/man3/makecontext.3 --- manpages-3.52/man3/makecontext.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/makecontext.3 2013-09-17 08:27:57.000000000 +0200 @@ -224,7 +224,7 @@ .BR getcontext (3), .BR sigsetjmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/makedev.3 manpages-3.54/man3/makedev.3 --- manpages-3.52/man3/makedev.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/makedev.3 2013-09-17 08:27:57.000000000 +0200 @@ -81,7 +81,7 @@ .BR mknod (2), .BR stat (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mallinfo.3 manpages-3.54/man3/mallinfo.3 --- manpages-3.52/man3/mallinfo.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mallinfo.3 2013-09-17 08:27:57.000000000 +0200 @@ -277,7 +277,7 @@ .BR malloc_trim (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/malloc.3 manpages-3.54/man3/malloc.3 --- manpages-3.52/man3/malloc.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/malloc.3 2013-09-17 08:27:57.000000000 +0200 @@ -281,7 +281,7 @@ .BR mtrace (3), .BR posix_memalign (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/malloc_get_state.3 manpages-3.54/man3/malloc_get_state.3 --- manpages-3.52/man3/malloc_get_state.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/malloc_get_state.3 2013-09-17 08:27:57.000000000 +0200 @@ -112,7 +112,7 @@ .BR malloc (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/malloc_hook.3 manpages-3.54/man3/malloc_hook.3 --- manpages-3.52/man3/malloc_hook.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/malloc_hook.3 2013-09-17 08:27:57.000000000 +0200 @@ -140,7 +140,7 @@ .BR mcheck (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/malloc_info.3 manpages-3.54/man3/malloc_info.3 --- manpages-3.52/man3/malloc_info.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/malloc_info.3 2013-09-17 08:27:57.000000000 +0200 @@ -260,7 +260,7 @@ .BR mallopt (3), .BR open_memstream (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/malloc_stats.3 manpages-3.54/man3/malloc_stats.3 --- manpages-3.52/man3/malloc_stats.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/malloc_stats.3 2013-09-17 08:27:57.000000000 +0200 @@ -65,7 +65,7 @@ .BR malloc_info (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/malloc_trim.3 manpages-3.54/man3/malloc_trim.3 --- manpages-3.52/man3/malloc_trim.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/malloc_trim.3 2013-09-17 08:27:57.000000000 +0200 @@ -80,7 +80,7 @@ .BR malloc (3), .BR mallopt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/malloc_usable_size.3 manpages-3.54/man3/malloc_usable_size.3 --- manpages-3.52/man3/malloc_usable_size.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/malloc_usable_size.3 2013-09-17 08:27:57.000000000 +0200 @@ -62,7 +62,7 @@ .SH SEE ALSO .BR malloc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mallopt.3 manpages-3.54/man3/mallopt.3 --- manpages-3.52/man3/mallopt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mallopt.3 2013-09-17 08:27:57.000000000 +0200 @@ -578,7 +578,7 @@ .BR mtrace (3), .BR posix_memalign (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/matherr.3 manpages-3.54/man3/matherr.3 --- manpages-3.52/man3/matherr.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/matherr.3 2013-09-17 08:27:57.000000000 +0200 @@ -427,7 +427,7 @@ .BR math_error (7), .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/MB_CUR_MAX.3 manpages-3.54/man3/MB_CUR_MAX.3 --- manpages-3.52/man3/MB_CUR_MAX.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/MB_CUR_MAX.3 2013-09-17 08:27:57.000000000 +0200 @@ -42,7 +42,7 @@ .BR wcstombs (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mblen.3 manpages-3.54/man3/mblen.3 --- manpages-3.52/man3/mblen.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mblen.3 2013-09-17 08:27:57.000000000 +0200 @@ -106,7 +106,7 @@ .SH SEE ALSO .BR mbrlen (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/MB_LEN_MAX.3 manpages-3.54/man3/MB_LEN_MAX.3 --- manpages-3.52/man3/MB_LEN_MAX.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/MB_LEN_MAX.3 2013-09-17 08:27:57.000000000 +0200 @@ -44,7 +44,7 @@ .SH SEE ALSO .BR MB_CUR_MAX (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mbrlen.3 manpages-3.54/man3/mbrlen.3 --- manpages-3.52/man3/mbrlen.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mbrlen.3 2013-09-17 08:27:57.000000000 +0200 @@ -119,7 +119,7 @@ .SH SEE ALSO .BR mbrtowc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mbrtowc.3 manpages-3.54/man3/mbrtowc.3 --- manpages-3.52/man3/mbrtowc.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mbrtowc.3 2013-09-17 08:27:57.000000000 +0200 @@ -189,7 +189,7 @@ .SH SEE ALSO .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mbsinit.3 manpages-3.54/man3/mbsinit.3 --- manpages-3.52/man3/mbsinit.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mbsinit.3 2013-09-17 08:27:57.000000000 +0200 @@ -13,7 +13,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH MBSINIT 3 2000-11-20 "GNU" "Linux Programmer's Manual" +.TH MBSINIT 3 2013-08-26 "GNU" "Linux Programmer's Manual" .SH NAME mbsinit \- test for initial shift state .SH SYNOPSIS @@ -81,6 +81,11 @@ .I ps is a NULL pointer. Otherwise it returns 0. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR mbsinit () +function is thread-safe. .SH CONFORMING TO C99. .SH NOTES @@ -94,7 +99,7 @@ .BR mbsrtowcs (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mbsnrtowcs.3 manpages-3.54/man3/mbsnrtowcs.3 --- manpages-3.52/man3/mbsnrtowcs.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mbsnrtowcs.3 2013-09-17 08:27:57.000000000 +0200 @@ -177,7 +177,7 @@ .BR iconv (3), .BR mbsrtowcs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mbsrtowcs.3 manpages-3.54/man3/mbsrtowcs.3 --- manpages-3.52/man3/mbsrtowcs.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mbsrtowcs.3 2013-09-17 08:27:57.000000000 +0200 @@ -142,7 +142,7 @@ .BR mbsnrtowcs (3), .BR mbstowcs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mbstowcs.3 manpages-3.54/man3/mbstowcs.3 --- manpages-3.52/man3/mbstowcs.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mbstowcs.3 2013-09-17 08:27:57.000000000 +0200 @@ -108,7 +108,7 @@ .BR mbsrtowcs (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mbtowc.3 manpages-3.54/man3/mbtowc.3 --- manpages-3.52/man3/mbtowc.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mbtowc.3 2013-09-17 08:27:57.000000000 +0200 @@ -131,7 +131,7 @@ .BR mbrtowc (3), .BR mbstowcs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mcheck.3 manpages-3.54/man3/mcheck.3 --- manpages-3.52/man3/mcheck.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mcheck.3 2013-09-17 08:27:57.000000000 +0200 @@ -206,7 +206,7 @@ .BR mallopt (3), .BR mtrace (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memccpy.3 manpages-3.54/man3/memccpy.3 --- manpages-3.52/man3/memccpy.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memccpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -76,7 +76,7 @@ .BR strcpy (3), .BR strncpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memchr.3 manpages-3.54/man3/memchr.3 --- manpages-3.52/man3/memchr.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memchr.3 2013-09-17 08:27:57.000000000 +0200 @@ -145,7 +145,7 @@ .BR strstr (3), .BR wmemchr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memcmp.3 manpages-3.54/man3/memcmp.3 --- manpages-3.52/man3/memcmp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memcmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -68,7 +68,7 @@ .BR strncmp (3), .BR wmemcmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memcpy.3 manpages-3.54/man3/memcpy.3 --- manpages-3.52/man3/memcpy.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memcpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -60,7 +60,7 @@ .BR strncpy (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memfrob.3 manpages-3.54/man3/memfrob.3 --- manpages-3.52/man3/memfrob.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memfrob.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ .SH SEE ALSO .BR strfry (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memmem.3 manpages-3.54/man3/memmem.3 --- manpages-3.52/man3/memmem.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memmem.3 2013-09-17 08:27:57.000000000 +0200 @@ -83,7 +83,7 @@ .SH SEE ALSO .BR strstr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memmove.3 manpages-3.54/man3/memmove.3 --- manpages-3.52/man3/memmove.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memmove.3 2013-09-17 08:27:57.000000000 +0200 @@ -69,7 +69,7 @@ .BR strncpy (3), .BR wmemmove (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mempcpy.3 manpages-3.54/man3/mempcpy.3 --- manpages-3.52/man3/mempcpy.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mempcpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -76,7 +76,7 @@ .BR memmove (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/memset.3 manpages-3.54/man3/memset.3 --- manpages-3.52/man3/memset.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/memset.3 2013-09-17 08:27:57.000000000 +0200 @@ -58,7 +58,7 @@ .BR swab (3), .BR wmemset (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mkdtemp.3 manpages-3.54/man3/mkdtemp.3 --- manpages-3.52/man3/mkdtemp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mkdtemp.3 2013-09-17 08:27:57.000000000 +0200 @@ -96,7 +96,7 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mkfifo.3 manpages-3.54/man3/mkfifo.3 --- manpages-3.52/man3/mkfifo.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mkfifo.3 2013-09-17 08:27:57.000000000 +0200 @@ -45,7 +45,7 @@ A FIFO special file is similar to a pipe, except that it is created in a different way. Instead of being an anonymous communications -channel, a FIFO special file is entered into the file system by +channel, a FIFO special file is entered into the filesystem by calling .BR mkfifo (). .PP @@ -71,7 +71,7 @@ (execute) permission. .TP .B EDQUOT -The user's quota of disk blocks or inodes on the file system has been +The user's quota of disk blocks or inodes on the filesystem has been exhausted. .TP .B EEXIST @@ -85,7 +85,7 @@ \fBPATH_MAX\fP, or an individual filename component has a length greater than \fBNAME_MAX\fP. In the GNU system, there is no imposed -limit on overall filename length, but some file systems may place +limit on overall filename length, but some filesystems may place limits on the length of a component. .TP .B ENOENT @@ -93,14 +93,14 @@ dangling symbolic link. .TP .B ENOSPC -The directory or file system has no room for the new file. +The directory or filesystem has no room for the new file. .TP .B ENOTDIR A component used as a directory in \fIpathname\fP is not, in fact, a directory. .TP .B EROFS -\fIpathname\fP refers to a read-only file system. +\fIpathname\fP refers to a read-only filesystem. .SH CONFORMING TO POSIX.1-2001. .SH SEE ALSO @@ -114,7 +114,7 @@ .BR mkfifoat (3), .BR fifo (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mkfifoat.3 manpages-3.54/man3/mkfifoat.3 --- manpages-3.52/man3/mkfifoat.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mkfifoat.3 2013-09-17 08:27:57.000000000 +0200 @@ -128,7 +128,7 @@ .BR mkfifo (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mkstemp.3 manpages-3.54/man3/mkstemp.3 --- manpages-3.52/man3/mkstemp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mkstemp.3 2013-09-17 08:27:57.000000000 +0200 @@ -218,7 +218,7 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mktemp.3 manpages-3.54/man3/mktemp.3 --- manpages-3.52/man3/mktemp.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mktemp.3 2013-09-17 08:27:57.000000000 +0200 @@ -118,7 +118,7 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/modf.3 manpages-3.54/man3/modf.3 --- manpages-3.52/man3/modf.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/modf.3 2013-09-17 08:27:57.000000000 +0200 @@ -110,7 +110,7 @@ .BR frexp (3), .BR ldexp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mpool.3 manpages-3.54/man3/mpool.3 --- manpages-3.52/man3/mpool.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mpool.3 2013-09-17 08:27:57.000000000 +0200 @@ -233,7 +233,7 @@ .BR hash (3), .BR recno (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mq_close.3 manpages-3.54/man3/mq_close.3 --- manpages-3.52/man3/mq_close.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mq_close.3 2013-09-17 08:27:57.000000000 +0200 @@ -71,7 +71,7 @@ .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mq_getattr.3 manpages-3.54/man3/mq_getattr.3 --- manpages-3.52/man3/mq_getattr.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mq_getattr.3 2013-09-17 08:27:57.000000000 +0200 @@ -153,7 +153,7 @@ .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mq_notify.3 manpages-3.54/man3/mq_notify.3 --- manpages-3.52/man3/mq_notify.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mq_notify.3 2013-09-17 08:27:57.000000000 +0200 @@ -250,7 +250,7 @@ .BR mq_overview (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mq_open.3 manpages-3.54/man3/mq_open.3 --- manpages-3.52/man3/mq_open.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mq_open.3 2013-09-17 08:27:57.000000000 +0200 @@ -85,7 +85,7 @@ user ID of the calling process. The group ownership (group ID) is set to the effective group ID of the calling process. -.\" In reality the file system IDs are used on Linux. +.\" In reality the filesystem IDs are used on Linux. .TP .B O_EXCL If @@ -236,7 +236,7 @@ .BR mq_unlink (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mq_receive.3 manpages-3.54/man3/mq_receive.3 --- manpages-3.52/man3/mq_receive.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mq_receive.3 2013-09-17 08:27:57.000000000 +0200 @@ -171,7 +171,7 @@ .BR mq_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mq_send.3 manpages-3.54/man3/mq_send.3 --- manpages-3.52/man3/mq_send.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mq_send.3 2013-09-17 08:27:57.000000000 +0200 @@ -176,7 +176,7 @@ .BR mq_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mq_unlink.3 manpages-3.54/man3/mq_unlink.3 --- manpages-3.52/man3/mq_unlink.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mq_unlink.3 2013-09-17 08:27:57.000000000 +0200 @@ -70,7 +70,7 @@ .BR mq_send (3), .BR mq_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/mtrace.3 manpages-3.54/man3/mtrace.3 --- manpages-3.52/man3/mtrace.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/mtrace.3 2013-09-17 08:27:57.000000000 +0200 @@ -170,7 +170,7 @@ .BR malloc_hook (3), .BR mcheck (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/nan.3 manpages-3.54/man3/nan.3 --- manpages-3.52/man3/nan.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/nan.3 2013-09-17 08:27:57.000000000 +0200 @@ -81,7 +81,7 @@ .BR strtod (3), .BR math_error (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/netlink.3 manpages-3.54/man3/netlink.3 --- manpages-3.52/man3/netlink.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/netlink.3 2013-09-17 08:27:57.000000000 +0200 @@ -98,7 +98,7 @@ .UE for libnetlink .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/nextafter.3 manpages-3.54/man3/nextafter.3 --- manpages-3.52/man3/nextafter.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/nextafter.3 2013-09-17 08:27:57.000000000 +0200 @@ -8,7 +8,7 @@ .\" .\" Based on glibc infopages .\" -.TH NEXTAFTER 3 2010-09-20 "GNU" "Linux Programmer's Manual" +.TH NEXTAFTER 3 2013-09-02 "GNU" "Linux Programmer's Manual" .SH NAME nextafter, nextafterf, nextafterl, nexttoward, nexttowardf, nexttowardl \- floating-point number manipulation @@ -69,7 +69,10 @@ .ad b .SH DESCRIPTION The -.BR nextafter () +.BR nextafter (), +.BR nextafterf (), +and +.BR nextafterl () functions return the next representable floating-point value following .I x in the direction of @@ -89,8 +92,11 @@ .IR y . The -.BR nexttoward () -functions do the same as the +.BR nexttoward (), +.BR nexttowardf (), +and +.BR nexttowardl () +functions do the same as the corresponding .BR nextafter () functions, except that they have a .I "long double" @@ -170,6 +176,17 @@ .IR errno . .\" FIXME . Is it intentional that these functions do not set errno? .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6799 +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR nextafter (), +.BR nextafterf (), +.BR nextafterl (), +.BR nexttoward (), +.BR nexttowardf (), +and +.BR nexttowardl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. This function is defined in IEC 559 (and the appendix with @@ -182,7 +199,7 @@ .SH SEE ALSO .BR nearbyint (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/nl_langinfo.3 manpages-3.54/man3/nl_langinfo.3 --- manpages-3.52/man3/nl_langinfo.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/nl_langinfo.3 2013-09-17 08:27:57.000000000 +0200 @@ -142,7 +142,7 @@ .br The GNU C Library Reference Manual .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/offsetof.3 manpages-3.54/man3/offsetof.3 --- manpages-3.52/man3/offsetof.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/offsetof.3 2013-09-17 08:27:57.000000000 +0200 @@ -103,7 +103,7 @@ } .fi .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/on_exit.3 manpages-3.54/man3/on_exit.3 --- manpages-3.52/man3/on_exit.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/on_exit.3 2013-09-17 08:27:57.000000000 +0200 @@ -90,7 +90,7 @@ .BR atexit (3), .BR exit (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/opendir.3 manpages-3.54/man3/opendir.3 --- manpages-3.52/man3/opendir.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/opendir.3 2013-09-17 08:27:57.000000000 +0200 @@ -147,7 +147,7 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/openpty.3 manpages-3.54/man3/openpty.3 --- manpages-3.52/man3/openpty.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/openpty.3 2013-09-17 08:27:57.000000000 +0200 @@ -180,7 +180,7 @@ .BR ttyname (3), .BR pty (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/perror.3 manpages-3.54/man3/perror.3 --- manpages-3.52/man3/perror.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/perror.3 2013-09-17 08:27:57.000000000 +0200 @@ -142,7 +142,7 @@ .BR error (3), .BR strerror (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/popen.3 manpages-3.54/man3/popen.3 --- manpages-3.52/man3/popen.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/popen.3 2013-09-17 08:27:57.000000000 +0200 @@ -141,7 +141,7 @@ .BR wait4 (2) returns an error, or some other error is detected. In the event of an error, these functions set -.I errnro +.I errno to indicate the cause of the error. .SH ERRORS The @@ -209,7 +209,7 @@ .BR stdio (3), .BR system (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/posix_fallocate.3 manpages-3.54/man3/posix_fallocate.3 --- manpages-3.52/man3/posix_fallocate.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/posix_fallocate.3 2013-09-17 08:27:57.000000000 +0200 @@ -131,7 +131,7 @@ .BR lseek (2), .BR posix_fadvise (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/posix_memalign.3 manpages-3.54/man3/posix_memalign.3 --- manpages-3.52/man3/posix_memalign.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/posix_memalign.3 2013-09-17 08:27:57.000000000 +0200 @@ -26,7 +26,7 @@ .\" 2001-10-11, 2003-08-22, aeb, added some details .\" 2012-03-23, Michael Kerrisk .\" Document pvalloc() and aligned_alloc() -.TH POSIX_MEMALIGN 3 2012-03-23 "GNU" "Linux Programmer's Manual" +.TH POSIX_MEMALIGN 3 2013-09-02 "GNU" "Linux Programmer's Manual" .SH NAME posix_memalign, aligned_alloc, memalign, valloc, pvalloc \- allocate aligned memory .SH SYNOPSIS @@ -95,8 +95,9 @@ If .I size is 0, then -.BR posix_memalign () -returns either NULL, +the value placed in +.IR "*memptr" +is either NULL, .\" glibc does this: or a unique pointer value that can later be successfully passed to .BR free (3). @@ -149,9 +150,10 @@ .BR posix_memalign () returns zero on success, or one of the error values listed in the next section on failure. -Note that +The value of .I errno -is not set. +is indeterminate after a call to +.BR posix_memalign (). .SH ERRORS .TP .B EINVAL @@ -273,7 +275,7 @@ .BR free (3), .BR malloc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/posix_openpt.3 manpages-3.54/man3/posix_openpt.3 --- manpages-3.52/man3/posix_openpt.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/posix_openpt.3 2013-09-17 08:27:57.000000000 +0200 @@ -112,7 +112,7 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pow10.3 manpages-3.54/man3/pow10.3 --- manpages-3.52/man3/pow10.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pow10.3 2013-09-17 08:27:57.000000000 +0200 @@ -55,7 +55,7 @@ .BR exp10 (3), .BR pow (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pow.3 manpages-3.54/man3/pow.3 --- manpages-3.52/man3/pow.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pow.3 2013-09-17 08:27:57.000000000 +0200 @@ -367,7 +367,7 @@ .BR cpow (3), .BR sqrt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/printf.3 manpages-3.54/man3/printf.3 --- manpages-3.52/man3/printf.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/printf.3 2013-09-17 08:27:57.000000000 +0200 @@ -31,7 +31,7 @@ .\" 2000-07-26 jsm28@hermes.cam.ac.uk - three small fixes .\" 2000-10-16 jsm28@hermes.cam.ac.uk - more fixes .\" -.TH PRINTF 3 2013-03-05 "GNU" "Linux Programmer's Manual" +.TH PRINTF 3 2013-09-04 "GNU" "Linux Programmer's Manual" .SH NAME printf, fprintf, sprintf, snprintf, vprintf, vfprintf, vsprintf, vsnprintf \- formatted output conversion @@ -409,8 +409,9 @@ is given in the next argument, or in the m-th argument, respectively, which must be of type .IR int . -If the precision is given as just \(aq.\(aq, or the precision is negative, -the precision is taken to be zero. +If the precision is given as just \(aq.\(aq, the precision is taken to +be zero. +A negative precision is taken as if the precision were omitted. This gives the minimum number of digits to appear for .BR d , .BR i , @@ -1087,7 +1088,7 @@ .BR wprintf (3), .BR locale (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/profil.3 manpages-3.54/man3/profil.3 --- manpages-3.52/man3/profil.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/profil.3 2013-09-17 08:27:57.000000000 +0200 @@ -84,7 +84,7 @@ .BR sigaction (2), .BR signal (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/program_invocation_name.3 manpages-3.54/man3/program_invocation_name.3 --- manpages-3.52/man3/program_invocation_name.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/program_invocation_name.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ .SH SEE ALSO .BR proc (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/psignal.3 manpages-3.54/man3/psignal.3 --- manpages-3.52/man3/psignal.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/psignal.3 2013-09-17 08:27:57.000000000 +0200 @@ -116,7 +116,7 @@ .BR strsignal (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_init.3 manpages-3.54/man3/pthread_attr_init.3 --- manpages-3.52/man3/pthread_attr_init.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_init.3 2013-09-17 08:27:57.000000000 +0200 @@ -311,7 +311,7 @@ .BR pthread_getattr_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setaffinity_np.3 manpages-3.54/man3/pthread_attr_setaffinity_np.3 --- manpages-3.52/man3/pthread_attr_setaffinity_np.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setaffinity_np.3 2013-09-17 08:27:57.000000000 +0200 @@ -122,7 +122,7 @@ .BR cpuset (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setdetachstate.3 manpages-3.54/man3/pthread_attr_setdetachstate.3 --- manpages-3.52/man3/pthread_attr_setdetachstate.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setdetachstate.3 2013-09-17 08:27:57.000000000 +0200 @@ -115,7 +115,7 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setguardsize.3 manpages-3.54/man3/pthread_attr_setguardsize.3 --- manpages-3.52/man3/pthread_attr_setguardsize.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setguardsize.3 2013-09-17 08:27:57.000000000 +0200 @@ -164,7 +164,7 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setinheritsched.3 manpages-3.54/man3/pthread_attr_setinheritsched.3 --- manpages-3.52/man3/pthread_attr_setinheritsched.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setinheritsched.3 2013-09-17 08:27:57.000000000 +0200 @@ -141,7 +141,7 @@ .BR pthread_setschedprio (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setschedparam.3 manpages-3.54/man3/pthread_attr_setschedparam.3 --- manpages-3.52/man3/pthread_attr_setschedparam.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setschedparam.3 2013-09-17 08:27:57.000000000 +0200 @@ -119,7 +119,7 @@ .BR pthread_setschedprio (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setschedpolicy.3 manpages-3.54/man3/pthread_attr_setschedpolicy.3 --- manpages-3.52/man3/pthread_attr_setschedpolicy.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setschedpolicy.3 2013-09-17 08:27:57.000000000 +0200 @@ -114,7 +114,7 @@ .BR pthread_setschedprio (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setscope.3 manpages-3.54/man3/pthread_attr_setscope.3 --- manpages-3.52/man3/pthread_attr_setscope.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setscope.3 2013-09-17 08:27:57.000000000 +0200 @@ -140,7 +140,7 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setstack.3 manpages-3.54/man3/pthread_attr_setstack.3 --- manpages-3.52/man3/pthread_attr_setstack.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setstack.3 2013-09-17 08:27:57.000000000 +0200 @@ -166,7 +166,7 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setstackaddr.3 manpages-3.54/man3/pthread_attr_setstackaddr.3 --- manpages-3.52/man3/pthread_attr_setstackaddr.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setstackaddr.3 2013-09-17 08:27:57.000000000 +0200 @@ -114,7 +114,7 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_attr_setstacksize.3 manpages-3.54/man3/pthread_attr_setstacksize.3 --- manpages-3.52/man3/pthread_attr_setstacksize.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_attr_setstacksize.3 2013-09-17 08:27:57.000000000 +0200 @@ -116,7 +116,7 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_cancel.3 manpages-3.54/man3/pthread_cancel.3 --- manpages-3.52/man3/pthread_cancel.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_cancel.3 2013-09-17 08:27:57.000000000 +0200 @@ -236,7 +236,7 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_cleanup_push.3 manpages-3.54/man3/pthread_cleanup_push.3 --- manpages-3.52/man3/pthread_cleanup_push.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_cleanup_push.3 2013-09-17 08:27:57.000000000 +0200 @@ -319,7 +319,7 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_cleanup_push_defer_np.3 manpages-3.54/man3/pthread_cleanup_push_defer_np.3 --- manpages-3.52/man3/pthread_cleanup_push_defer_np.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_cleanup_push_defer_np.3 2013-09-17 08:27:57.000000000 +0200 @@ -108,7 +108,7 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_create.3 manpages-3.54/man3/pthread_create.3 --- manpages-3.52/man3/pthread_create.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_create.3 2013-09-17 08:27:57.000000000 +0200 @@ -380,7 +380,7 @@ .BR pthread_self (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_detach.3 manpages-3.54/man3/pthread_detach.3 --- manpages-3.52/man3/pthread_detach.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_detach.3 2013-09-17 08:27:57.000000000 +0200 @@ -102,7 +102,7 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_equal.3 manpages-3.54/man3/pthread_equal.3 --- manpages-3.52/man3/pthread_equal.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_equal.3 2013-09-17 08:27:57.000000000 +0200 @@ -58,7 +58,7 @@ .BR pthread_self (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_exit.3 manpages-3.54/man3/pthread_exit.3 --- manpages-3.52/man3/pthread_exit.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_exit.3 2013-09-17 08:27:57.000000000 +0200 @@ -107,7 +107,7 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_getattr_np.3 manpages-3.54/man3/pthread_getattr_np.3 --- manpages-3.52/man3/pthread_getattr_np.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_getattr_np.3 2013-09-17 08:27:57.000000000 +0200 @@ -359,7 +359,7 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_getcpuclockid.3 manpages-3.54/man3/pthread_getcpuclockid.3 --- manpages-3.52/man3/pthread_getcpuclockid.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_getcpuclockid.3 2013-09-17 08:27:57.000000000 +0200 @@ -175,7 +175,7 @@ .BR pthreads (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_join.3 manpages-3.54/man3/pthread_join.3 --- manpages-3.52/man3/pthread_join.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_join.3 2013-09-17 08:27:57.000000000 +0200 @@ -132,7 +132,7 @@ .BR pthread_tryjoin_np (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_kill.3 manpages-3.54/man3/pthread_kill.3 --- manpages-3.52/man3/pthread_kill.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_kill.3 2013-09-17 08:27:57.000000000 +0200 @@ -82,7 +82,7 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_kill_other_threads_np.3 manpages-3.54/man3/pthread_kill_other_threads_np.3 --- manpages-3.52/man3/pthread_kill_other_threads_np.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_kill_other_threads_np.3 2013-09-17 08:27:57.000000000 +0200 @@ -70,7 +70,7 @@ .BR pthread_setcanceltype (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_self.3 manpages-3.54/man3/pthread_self.3 --- manpages-3.52/man3/pthread_self.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_self.3 2013-09-17 08:27:57.000000000 +0200 @@ -78,7 +78,7 @@ .BR pthread_equal (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_setaffinity_np.3 manpages-3.54/man3/pthread_setaffinity_np.3 --- manpages-3.52/man3/pthread_setaffinity_np.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_setaffinity_np.3 2013-09-17 08:27:57.000000000 +0200 @@ -212,7 +212,7 @@ .BR cpuset (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_setcancelstate.3 manpages-3.54/man3/pthread_setcancelstate.3 --- manpages-3.52/man3/pthread_setcancelstate.3 2013-07-04 12:54:01.000000000 +0200 +++ manpages-3.54/man3/pthread_setcancelstate.3 2013-09-17 08:27:57.000000000 +0200 @@ -180,7 +180,7 @@ .BR pthread_testcancel (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_setconcurrency.3 manpages-3.54/man3/pthread_setconcurrency.3 --- manpages-3.52/man3/pthread_setconcurrency.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_setconcurrency.3 2013-09-17 08:27:57.000000000 +0200 @@ -101,7 +101,7 @@ .BR pthread_attr_setscope (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_setname_np.3 manpages-3.54/man3/pthread_setname_np.3 --- manpages-3.52/man3/pthread_setname_np.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_setname_np.3 2013-09-17 08:27:57.000000000 +0200 @@ -202,7 +202,7 @@ .BR pthread_create (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_setschedparam.3 manpages-3.54/man3/pthread_setschedparam.3 --- manpages-3.52/man3/pthread_setschedparam.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_setschedparam.3 2013-09-17 08:27:57.000000000 +0200 @@ -443,7 +443,7 @@ .BR pthread_setschedprio (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_setschedprio.3 manpages-3.54/man3/pthread_setschedprio.3 --- manpages-3.52/man3/pthread_setschedprio.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_setschedprio.3 2013-09-17 08:27:57.000000000 +0200 @@ -103,7 +103,7 @@ .BR pthread_setschedparam (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_sigmask.3 manpages-3.54/man3/pthread_sigmask.3 --- manpages-3.52/man3/pthread_sigmask.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_sigmask.3 2013-09-17 08:27:57.000000000 +0200 @@ -142,7 +142,7 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_sigqueue.3 manpages-3.54/man3/pthread_sigqueue.3 --- manpages-3.52/man3/pthread_sigqueue.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_sigqueue.3 2013-09-17 08:27:57.000000000 +0200 @@ -29,7 +29,7 @@ .nf .B #include -.BI "int pthread_sigqueue(pthread_t *" thread ", int " sig , +.BI "int pthread_sigqueue(pthread_t " thread ", int " sig , .BI " const union sigval " value ); .fi .sp @@ -101,7 +101,7 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_testcancel.3 manpages-3.54/man3/pthread_testcancel.3 --- manpages-3.52/man3/pthread_testcancel.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_testcancel.3 2013-09-17 08:27:57.000000000 +0200 @@ -66,7 +66,7 @@ .BR pthread_setcancelstate (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_tryjoin_np.3 manpages-3.54/man3/pthread_tryjoin_np.3 --- manpages-3.52/man3/pthread_tryjoin_np.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_tryjoin_np.3 2013-09-17 08:27:57.000000000 +0200 @@ -138,7 +138,7 @@ .BR pthread_join (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/pthread_yield.3 manpages-3.54/man3/pthread_yield.3 --- manpages-3.52/man3/pthread_yield.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/pthread_yield.3 2013-09-17 08:27:57.000000000 +0200 @@ -64,7 +64,7 @@ .BR sched_yield (2), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ptsname.3 manpages-3.54/man3/ptsname.3 --- manpages-3.52/man3/ptsname.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/ptsname.3 2013-09-17 08:27:57.000000000 +0200 @@ -106,7 +106,7 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/putenv.3 manpages-3.54/man3/putenv.3 --- manpages-3.52/man3/putenv.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/putenv.3 2013-09-17 08:27:57.000000000 +0200 @@ -123,7 +123,7 @@ .BR unsetenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/putgrent.3 manpages-3.54/man3/putgrent.3 --- manpages-3.52/man3/putgrent.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/putgrent.3 2013-09-17 08:27:57.000000000 +0200 @@ -48,7 +48,7 @@ .BR getgrent (3), .BR group (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/putpwent.3 manpages-3.54/man3/putpwent.3 --- manpages-3.52/man3/putpwent.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/putpwent.3 2013-09-17 08:27:57.000000000 +0200 @@ -90,7 +90,7 @@ .BR getpwuid (3), .BR setpwent (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/puts.3 manpages-3.54/man3/puts.3 --- manpages-3.52/man3/puts.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/puts.3 2013-09-17 08:27:57.000000000 +0200 @@ -122,7 +122,7 @@ .BR scanf (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/putwchar.3 manpages-3.54/man3/putwchar.3 --- manpages-3.52/man3/putwchar.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/putwchar.3 2013-09-17 08:27:57.000000000 +0200 @@ -76,7 +76,7 @@ .BR fputwc (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/qecvt.3 manpages-3.54/man3/qecvt.3 --- manpages-3.52/man3/qecvt.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/qecvt.3 2013-09-17 08:27:57.000000000 +0200 @@ -25,7 +25,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH QECVT 3 2013-06-21 "GNU" "Linux Programmer's Manual" +.TH QECVT 3 2013-07-22 "GNU" "Linux Programmer's Manual" .SH NAME qecvt, qfcvt, qgcvt \- convert a floating-point number to a string .SH SYNOPSIS @@ -71,15 +71,15 @@ .BR gcvt (3). .SH ATTRIBUTES .SS Multithreading (see pthreads(7)) -The functions +The .BR qecvt () and .BR qfcvt () -are not thread-safe. +functions are not thread-safe. .LP -The function +The .BR qgcvt () -is thread-safe. +function is thread-safe. .SH CONFORMING TO SVr4. Not seen in most common UNIX implementations, @@ -97,7 +97,7 @@ .BR gcvt (3), .BR sprintf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/qsort.3 manpages-3.54/man3/qsort.3 --- manpages-3.52/man3/qsort.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/qsort.3 2013-09-17 08:27:57.000000000 +0200 @@ -158,7 +158,7 @@ .BR strcmp (3), .BR versionsort (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/queue.3 manpages-3.54/man3/queue.3 --- manpages-3.52/man3/queue.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/queue.3 2013-09-17 08:27:57.000000000 +0200 @@ -489,7 +489,7 @@ queue functions first appeared in 4.4BSD. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/raise.3 manpages-3.54/man3/raise.3 --- manpages-3.52/man3/raise.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/raise.3 2013-09-17 08:27:57.000000000 +0200 @@ -82,7 +82,7 @@ .BR pthread_kill (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rand.3 manpages-3.54/man3/rand.3 --- manpages-3.52/man3/rand.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rand.3 2013-09-17 08:27:57.000000000 +0200 @@ -218,7 +218,7 @@ .BR drand48 (3), .BR random (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/random.3 manpages-3.54/man3/random.3 --- manpages-3.52/man3/random.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/random.3 2013-09-17 08:27:57.000000000 +0200 @@ -191,7 +191,7 @@ .BR random_r (3), .BR srand (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/random_r.3 manpages-3.54/man3/random_r.3 --- manpages-3.52/man3/random_r.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/random_r.3 2013-09-17 08:27:57.000000000 +0200 @@ -134,7 +134,7 @@ .BR rand (3), .BR random (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rcmd.3 manpages-3.54/man3/rcmd.3 --- manpages-3.52/man3/rcmd.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rcmd.3 2013-09-17 08:27:57.000000000 +0200 @@ -291,7 +291,7 @@ .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/readdir.3 manpages-3.54/man3/readdir.3 --- manpages-3.52/man3/readdir.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/readdir.3 2013-09-17 08:27:57.000000000 +0200 @@ -78,7 +78,7 @@ off_t d_off; /* not an offset; see NOTES */ unsigned short d_reclen; /* length of this record */ unsigned char d_type; /* type of file; not supported - by all file system types */ + by all filesystem types */ char d_name[256]; /* filename */ }; .fi @@ -179,7 +179,7 @@ at the current position in the directory stream. Be aware that despite its type and name, the .I d_off -field is seldom any kind of directory offset on modern file systems. +field is seldom any kind of directory offset on modern filesystems. .\" https://lwn.net/Articles/544298/ Applications should treat this field as an opaque value, making no assumptions about its contents; see also @@ -232,7 +232,7 @@ Currently, .\" kernel 2.6.27 .\" The same sentence is in getdents.2 -only some file systems (among them: Btrfs, ext2, ext3, and ext4) +only some filesystems (among them: Btrfs, ext2, ext3, and ext4) have full support for returning the file type in .IR d_type . All applications must properly handle a return of @@ -275,7 +275,7 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/realpath.3 manpages-3.54/man3/realpath.3 --- manpages-3.52/man3/realpath.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/realpath.3 2013-09-17 08:27:57.000000000 +0200 @@ -115,7 +115,7 @@ is NULL.) .TP .B EIO -An I/O error occurred while reading from the file system. +An I/O error occurred while reading from the filesystem. .TP .B ELOOP Too many symbolic links were encountered in translating the pathname. @@ -230,7 +230,7 @@ .BR pathconf (3), .BR sysconf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/recno.3 manpages-3.54/man3/recno.3 --- manpages-3.52/man3/recno.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/recno.3 2013-09-17 08:27:57.000000000 +0200 @@ -143,7 +143,7 @@ If .I psize is 0 (no page size is specified) a page size is chosen based on the -underlying file system I/O block size. +underlying filesystem I/O block size. See .BR btree (3) for more information. @@ -231,7 +231,7 @@ Michael Stonebraker, Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum No. UCB/ERL M82/32, May 1982. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/re_comp.3 manpages-3.54/man3/re_comp.3 --- manpages-3.52/man3/re_comp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/re_comp.3 2013-09-17 08:27:57.000000000 +0200 @@ -81,7 +81,7 @@ .BR regex (7), GNU regex manual .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/regex.3 manpages-3.54/man3/regex.3 --- manpages-3.52/man3/regex.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/regex.3 2013-09-17 08:27:57.000000000 +0200 @@ -310,7 +310,7 @@ The glibc manual section, .I "Regular Expression Matching" .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/remainder.3 manpages-3.54/man3/remainder.3 --- manpages-3.52/man3/remainder.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/remainder.3 2013-09-17 08:27:57.000000000 +0200 @@ -217,7 +217,7 @@ .BR fmod (3), .BR remquo (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/remove.3 manpages-3.54/man3/remove.3 --- manpages-3.52/man3/remove.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/remove.3 2013-09-17 08:27:57.000000000 +0200 @@ -37,7 +37,7 @@ .BI "int remove(const char *" pathname ); .SH DESCRIPTION .BR remove () -deletes a name from the file system. +deletes a name from the filesystem. It calls .BR unlink (2) for files, and @@ -90,7 +90,7 @@ .BR mkfifo (3), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/remquo.3 manpages-3.54/man3/remquo.3 --- manpages-3.52/man3/remquo.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/remquo.3 2013-09-17 08:27:57.000000000 +0200 @@ -128,7 +128,7 @@ .BR logb (3), .BR remainder (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/resolver.3 manpages-3.54/man3/resolver.3 --- manpages-3.52/man3/resolver.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/resolver.3 2013-09-17 08:27:57.000000000 +0200 @@ -278,7 +278,7 @@ .BR hostname (7), .BR named (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rewinddir.3 manpages-3.54/man3/rewinddir.3 --- manpages-3.52/man3/rewinddir.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rewinddir.3 2013-09-17 08:27:57.000000000 +0200 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 18:29:11 1993 by Rik Faith (faith@cs.unc.edu) .\" Modified 11 June 1995 by Andries Brouwer (aeb@cwi.nl) -.TH REWINDDIR 3 1995-06-11 "" "Linux Programmer's Manual" +.TH REWINDDIR 3 2013-09-02 "" "Linux Programmer's Manual" .SH NAME rewinddir \- reset directory stream .SH SYNOPSIS @@ -50,6 +50,11 @@ The .BR rewinddir () function returns no value. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR rewinddir () +function is thread-safe. .SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH SEE ALSO @@ -60,7 +65,7 @@ .BR seekdir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rexec.3 manpages-3.54/man3/rexec.3 --- manpages-3.52/man3/rexec.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rexec.3 2013-09-17 08:27:57.000000000 +0200 @@ -168,7 +168,7 @@ .BR rcmd (3), .BR rexecd (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rint.3 manpages-3.54/man3/rint.3 --- manpages-3.52/man3/rint.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rint.3 2013-09-17 08:27:57.000000000 +0200 @@ -24,7 +24,7 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH RINT 3 2010-09-20 "" "Linux Programmer's Manual" +.TH RINT 3 2013-08-26 "" "Linux Programmer's Manual" .SH NAME nearbyint, nearbyintf, nearbyintl, rint, rintf, rintl \- round to nearest integer @@ -85,7 +85,10 @@ .ad b .SH DESCRIPTION The -.BR nearbyint () +.BR nearbyint (), +.BR nearbyintf (), +and +.BR nearbyintl () functions round their argument to an integer value in floating-point format, using the current rounding direction (see .BR fesetround (3)) @@ -94,7 +97,10 @@ exception. .LP The -.BR rint () +.BR rint (), +.BR rintf (), +and +.BR rintl () functions do the same, but will raise the .I inexact exception @@ -113,6 +119,17 @@ .SH ERRORS No errors occur. POSIX.1-2001 documents a range error for overflows, but see NOTES. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR nearbyint (), +.BR nearbyintf (), +.BR nearbyintl (), +.BR rint (), +.BR rintf (), +and +.BR rintl () +functions are thread-safe. .SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES @@ -142,7 +159,7 @@ .BR round (3), .BR trunc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/round.3 manpages-3.54/man3/round.3 --- manpages-3.52/man3/round.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/round.3 2013-09-17 08:27:57.000000000 +0200 @@ -124,7 +124,7 @@ .BR rint (3), .BR trunc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rpc.3 manpages-3.54/man3/rpc.3 --- manpages-3.52/man3/rpc.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rpc.3 2013-09-17 08:27:57.000000000 +0200 @@ -1119,7 +1119,7 @@ RFC\ 1050, Sun Microsystems, Inc., USC-ISI. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rpmatch.3 manpages-3.54/man3/rpmatch.3 --- manpages-3.52/man3/rpmatch.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rpmatch.3 2013-09-17 08:27:57.000000000 +0200 @@ -148,7 +148,7 @@ .BR regcomp (3), .BR setlocale (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rtime.3 manpages-3.54/man3/rtime.3 --- manpages-3.52/man3/rtime.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rtime.3 2013-09-17 08:27:57.000000000 +0200 @@ -129,7 +129,7 @@ .\" .BR rdate (1), .BR inetd (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/rtnetlink.3 manpages-3.54/man3/rtnetlink.3 --- manpages-3.52/man3/rtnetlink.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/rtnetlink.3 2013-09-17 08:27:57.000000000 +0200 @@ -124,7 +124,7 @@ .BR netlink (7), .BR rtnetlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/scalb.3 manpages-3.54/man3/scalb.3 --- manpages-3.52/man3/scalb.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/scalb.3 2013-09-17 08:27:57.000000000 +0200 @@ -201,7 +201,7 @@ .BR ldexp (3), .BR scalbln (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/scalbln.3 manpages-3.54/man3/scalbln.3 --- manpages-3.52/man3/scalbln.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/scalbln.3 2013-09-17 08:27:57.000000000 +0200 @@ -190,7 +190,7 @@ .BR ldexp (3), .BR scalb (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/scandir.3 manpages-3.54/man3/scandir.3 --- manpages-3.52/man3/scandir.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/scandir.3 2013-09-17 08:27:57.000000000 +0200 @@ -187,7 +187,7 @@ .BR strverscmp (3), .BR telldir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/scandirat.3 manpages-3.54/man3/scandirat.3 --- manpages-3.52/man3/scandirat.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/scandirat.3 2013-09-17 08:27:57.000000000 +0200 @@ -114,7 +114,7 @@ .BR scandir (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/scanf.3 manpages-3.54/man3/scanf.3 --- manpages-3.52/man3/scanf.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/scanf.3 2013-09-17 08:27:57.000000000 +0200 @@ -720,7 +720,7 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sched_getcpu.3 manpages-3.54/man3/sched_getcpu.3 --- manpages-3.52/man3/sched_getcpu.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sched_getcpu.3 2013-09-17 08:27:57.000000000 +0200 @@ -95,7 +95,7 @@ .SH SEE ALSO .BR getcpu (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/seekdir.3 manpages-3.54/man3/seekdir.3 --- manpages-3.52/man3/seekdir.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/seekdir.3 2013-09-17 08:27:57.000000000 +0200 @@ -28,7 +28,7 @@ .\" 386BSD man pages .\" Modified Sat Jul 24 18:25:21 1993 by Rik Faith (faith@cs.unc.edu) .\" -.TH SEEKDIR 3 2013-03-24 "" "Linux Programmer's Manual" +.TH SEEKDIR 3 2013-09-09 "" "Linux Programmer's Manual" .SH NAME seekdir \- set the position of the next readdir() call in the directory stream. @@ -61,6 +61,11 @@ The .BR seekdir () function returns no value. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR seekdir () +function is thread-safe. .SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH NOTES @@ -84,7 +89,7 @@ .BR scandir (3), .BR telldir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_close.3 manpages-3.54/man3/sem_close.3 --- manpages-3.52/man3/sem_close.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_close.3 2013-09-17 08:27:57.000000000 +0200 @@ -65,7 +65,7 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_destroy.3 manpages-3.54/man3/sem_destroy.3 --- manpages-3.52/man3/sem_destroy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_destroy.3 2013-09-17 08:27:57.000000000 +0200 @@ -77,7 +77,7 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_getvalue.3 manpages-3.54/man3/sem_getvalue.3 --- manpages-3.52/man3/sem_getvalue.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_getvalue.3 2013-09-17 08:27:57.000000000 +0200 @@ -73,7 +73,7 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_init.3 manpages-3.54/man3/sem_init.3 --- manpages-3.52/man3/sem_init.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_init.3 2013-09-17 08:27:57.000000000 +0200 @@ -105,7 +105,7 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_open.3 manpages-3.54/man3/sem_open.3 --- manpages-3.52/man3/sem_open.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_open.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ user ID of the calling process. The group ownership (group ID) is set to the effective group ID of the calling process. -.\" In reality the file system IDs are used on Linux. +.\" In reality the filesystem IDs are used on Linux. If both .B O_CREAT and @@ -177,7 +177,7 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_post.3 manpages-3.54/man3/sem_post.3 --- manpages-3.52/man3/sem_post.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_post.3 2013-09-17 08:27:57.000000000 +0200 @@ -72,7 +72,7 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_unlink.3 manpages-3.54/man3/sem_unlink.3 --- manpages-3.52/man3/sem_unlink.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_unlink.3 2013-09-17 08:27:57.000000000 +0200 @@ -68,7 +68,7 @@ .BR sem_wait (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sem_wait.3 manpages-3.54/man3/sem_wait.3 --- manpages-3.52/man3/sem_wait.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sem_wait.3 2013-09-17 08:27:57.000000000 +0200 @@ -266,7 +266,7 @@ .BR sem_overview (7), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/setaliasent.3 manpages-3.54/man3/setaliasent.3 --- manpages-3.52/man3/setaliasent.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/setaliasent.3 2013-09-17 08:27:57.000000000 +0200 @@ -152,7 +152,7 @@ .\" Yellow Pages .\" newaliases, postalias .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/setbuf.3 manpages-3.54/man3/setbuf.3 --- manpages-3.52/man3/setbuf.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/setbuf.3 2013-09-17 08:27:57.000000000 +0200 @@ -206,7 +206,7 @@ .BR printf (3), .BR puts (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/setenv.3 manpages-3.54/man3/setenv.3 --- manpages-3.52/man3/setenv.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/setenv.3 2013-09-17 08:27:57.000000000 +0200 @@ -155,7 +155,7 @@ .BR putenv (3), .BR environ (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/__setfpucw.3 manpages-3.54/man3/__setfpucw.3 --- manpages-3.52/man3/__setfpucw.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/__setfpucw.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ .br .I .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/setjmp.3 manpages-3.54/man3/setjmp.3 --- manpages-3.52/man3/setjmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/setjmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -127,7 +127,7 @@ .BR longjmp (3), .BR siglongjmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/setlocale.3 manpages-3.54/man3/setlocale.3 --- manpages-3.52/man3/setlocale.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/setlocale.3 2013-09-17 08:27:57.000000000 +0200 @@ -199,7 +199,7 @@ .BR charsets (7), .BR locale (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/setlogmask.3 manpages-3.54/man3/setlogmask.3 --- manpages-3.52/man3/setlogmask.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/setlogmask.3 2013-09-17 08:27:57.000000000 +0200 @@ -80,7 +80,7 @@ .BR openlog (3), .BR syslog (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/setnetgrent.3 manpages-3.54/man3/setnetgrent.3 --- manpages-3.52/man3/setnetgrent.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/setnetgrent.3 2013-09-17 08:27:57.000000000 +0200 @@ -109,7 +109,7 @@ .BR setprotoent (3), .BR setservent (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/shm_open.3 manpages-3.54/man3/shm_open.3 --- manpages-3.52/man3/shm_open.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/shm_open.3 2013-09-17 08:27:57.000000000 +0200 @@ -94,7 +94,7 @@ Create the shared memory object if it does not exist. The user and group ownership of the object are taken from the corresponding effective IDs of the calling process, -.\" In truth it is actually the file system IDs on Linux, but these +.\" In truth it is actually the filesystem IDs on Linux, but these .\" are nearly always the same as the effective IDs. (MTK, Jul 05) and the object's permission bits are set according to the low-order 9 bits of @@ -265,7 +265,7 @@ shared memory object\(emthis may not be so on other UNIX systems. .LP The POSIX shared memory object implementation on Linux 2.4 makes use -of a dedicated file system, which is normally +of a dedicated filesystem, which is normally mounted under .IR /dev/shm . .SH SEE ALSO @@ -280,7 +280,7 @@ .BR umask (2), .BR shm_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/siginterrupt.3 manpages-3.54/man3/siginterrupt.3 --- manpages-3.52/man3/siginterrupt.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/siginterrupt.3 2013-09-17 08:27:57.000000000 +0200 @@ -96,7 +96,7 @@ .SH SEE ALSO .BR signal (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/signbit.3 manpages-3.54/man3/signbit.3 --- manpages-3.52/man3/signbit.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/signbit.3 2013-09-17 08:27:57.000000000 +0200 @@ -70,7 +70,7 @@ .SH SEE ALSO .BR copysign (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/significand.3 manpages-3.54/man3/significand.3 --- manpages-3.52/man3/significand.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/significand.3 2013-09-17 08:27:57.000000000 +0200 @@ -58,7 +58,7 @@ .BR ilogb (3), .BR scalb (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sigpause.3 manpages-3.54/man3/sigpause.3 --- manpages-3.52/man3/sigpause.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sigpause.3 2013-09-17 08:27:57.000000000 +0200 @@ -104,7 +104,7 @@ .BR sigvec (3), .BR feature_test_macros (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sigqueue.3 manpages-3.54/man3/sigqueue.3 --- manpages-3.52/man3/sigqueue.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sigqueue.3 2013-09-17 08:27:57.000000000 +0200 @@ -155,7 +155,7 @@ .BR sigwait (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sigset.3 manpages-3.54/man3/sigset.3 --- manpages-3.52/man3/sigset.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sigset.3 2013-09-17 08:27:57.000000000 +0200 @@ -274,7 +274,7 @@ .BR sigvec (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sigsetops.3 manpages-3.54/man3/sigsetops.3 --- manpages-3.52/man3/sigsetops.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sigsetops.3 2013-09-17 08:27:57.000000000 +0200 @@ -174,7 +174,7 @@ .BR sigprocmask (2), .BR sigsuspend (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sigvec.3 manpages-3.54/man3/sigvec.3 --- manpages-3.52/man3/sigvec.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sigvec.3 2013-09-17 08:27:57.000000000 +0200 @@ -260,7 +260,7 @@ .BR sigset (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sigwait.3 manpages-3.54/man3/sigwait.3 --- manpages-3.52/man3/sigwait.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sigwait.3 2013-09-17 08:27:57.000000000 +0200 @@ -95,7 +95,7 @@ .BR sigsetops (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sin.3 manpages-3.54/man3/sin.3 --- manpages-3.52/man3/sin.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sin.3 2013-09-17 08:27:57.000000000 +0200 @@ -128,7 +128,7 @@ .BR sincos (3), .BR tan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sincos.3 manpages-3.54/man3/sincos.3 --- manpages-3.52/man3/sincos.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sincos.3 2013-09-17 08:27:57.000000000 +0200 @@ -79,7 +79,7 @@ .BR sin (3), .BR tan (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sinh.3 manpages-3.54/man3/sinh.3 --- manpages-3.52/man3/sinh.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sinh.3 2013-09-17 08:27:57.000000000 +0200 @@ -135,7 +135,7 @@ .BR csinh (3), .BR tanh (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sleep.3 manpages-3.54/man3/sleep.3 --- manpages-3.52/man3/sleep.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sleep.3 2013-09-17 08:27:57.000000000 +0200 @@ -64,7 +64,7 @@ .BR signal (2), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sockatmark.3 manpages-3.54/man3/sockatmark.3 --- manpages-3.52/man3/sockatmark.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sockatmark.3 2013-09-17 08:27:57.000000000 +0200 @@ -137,7 +137,7 @@ .BR send (2), .BR tcp (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sqrt.3 manpages-3.54/man3/sqrt.3 --- manpages-3.52/man3/sqrt.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sqrt.3 2013-09-17 08:27:57.000000000 +0200 @@ -115,7 +115,7 @@ .BR csqrt (3), .BR hypot (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/statvfs.3 manpages-3.54/man3/statvfs.3 --- manpages-3.52/man3/statvfs.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/statvfs.3 2013-09-17 08:27:57.000000000 +0200 @@ -29,7 +29,7 @@ .\" .TH STATVFS 3 2003-08-22 "Linux" "Linux Programmer's Manual" .SH NAME -statvfs, fstatvfs \- get file system statistics +statvfs, fstatvfs \- get filesystem statistics .SH SYNOPSIS .B #include .sp @@ -39,9 +39,9 @@ .SH DESCRIPTION The function .BR statvfs () -returns information about a mounted file system. +returns information about a mounted filesystem. .I path -is the pathname of any file within the mounted file system. +is the pathname of any file within the mounted filesystem. .I buf is a pointer to a .I statvfs @@ -50,7 +50,7 @@ .in +4n .nf struct statvfs { - unsigned long f_bsize; /* file system block size */ + unsigned long f_bsize; /* filesystem block size */ unsigned long f_frsize; /* fragment size */ fsblkcnt_t f_blocks; /* size of fs in f_frsize units */ fsblkcnt_t f_bfree; /* # free blocks */ @@ -58,7 +58,7 @@ fsfilcnt_t f_files; /* # inodes */ fsfilcnt_t f_ffree; /* # free inodes */ fsfilcnt_t f_favail; /* # free inodes for unprivileged users */ - unsigned long f_fsid; /* file system ID */ + unsigned long f_fsid; /* filesystem ID */ unsigned long f_flag; /* mount flags */ unsigned long f_namemax; /* maximum filename length */ }; @@ -81,14 +81,14 @@ Bits defined by POSIX are .TP .B ST_RDONLY -Read-only file system. +Read-only filesystem. .TP .B ST_NOSUID Set-user-ID/set-group-ID bits are ignored by .BR exec (3). .LP It is unspecified whether all members of the returned struct -have meaningful values on all file systems. +have meaningful values on all filesystems. .BR fstatvfs () returns the same information about an open file referenced by descriptor @@ -122,7 +122,7 @@ This call was interrupted by a signal. .TP .B EIO -An I/O error occurred while reading from the file system. +An I/O error occurred while reading from the filesystem. .TP .B ELOOP .RB ( statvfs ()) @@ -144,7 +144,7 @@ Insufficient kernel memory was available. .TP .B ENOSYS -The file system does not support this call. +The filesystem does not support this call. .TP .B ENOTDIR .RB ( statvfs ()) @@ -181,7 +181,7 @@ .SH SEE ALSO .BR statfs (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/stdarg.3 manpages-3.54/man3/stdarg.3 --- manpages-3.52/man3/stdarg.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/stdarg.3 2013-09-17 08:27:57.000000000 +0200 @@ -327,7 +327,7 @@ } .fi .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/stdin.3 manpages-3.54/man3/stdin.3 --- manpages-3.52/man3/stdin.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/stdin.3 2013-09-17 08:27:57.000000000 +0200 @@ -158,7 +158,7 @@ .BR fopen (3), .BR stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/stdio.3 manpages-3.54/man3/stdio.3 --- manpages-3.52/man3/stdio.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/stdio.3 2013-09-17 08:27:57.000000000 +0200 @@ -255,7 +255,7 @@ .BR stdout (3), .BR unlocked_stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/stdio_ext.3 manpages-3.54/man3/stdio_ext.3 --- manpages-3.52/man3/stdio_ext.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/stdio_ext.3 2013-09-17 08:27:57.000000000 +0200 @@ -152,7 +152,7 @@ .BR flockfile (3), .BR fpurge (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/stpcpy.3 manpages-3.54/man3/stpcpy.3 --- manpages-3.52/man3/stpcpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/stpcpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -117,7 +117,7 @@ .BR string (3), .BR wcpcpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/stpncpy.3 manpages-3.54/man3/stpncpy.3 --- manpages-3.52/man3/stpncpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/stpncpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -87,7 +87,7 @@ or, if .I dest is not null-terminated, -.IR "dest + n" . +.IR dest + n . .SH CONFORMING TO This function was added to POSIX.1-2008. Before that, it was a GNU extension. @@ -95,7 +95,7 @@ .BR strncpy (3), .BR wcpncpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strcasecmp.3 manpages-3.54/man3/strcasecmp.3 --- manpages-3.52/man3/strcasecmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strcasecmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -85,7 +85,7 @@ .BR wcscasecmp (3), .BR wcsncasecmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strcat.3 manpages-3.54/man3/strcat.3 --- manpages-3.52/man3/strcat.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strcat.3 2013-09-17 08:27:57.000000000 +0200 @@ -176,7 +176,7 @@ .BR wcscat (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strchr.3 manpages-3.54/man3/strchr.3 --- manpages-3.52/man3/strchr.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strchr.3 2013-09-17 08:27:57.000000000 +0200 @@ -125,7 +125,7 @@ .BR wcschr (3), .BR wcsrchr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strcmp.3 manpages-3.54/man3/strcmp.3 --- manpages-3.52/man3/strcmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strcmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -89,7 +89,7 @@ .BR wcscmp (3), .BR wcsncmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strcoll.3 manpages-3.54/man3/strcoll.3 --- manpages-3.52/man3/strcoll.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strcoll.3 2013-09-17 08:27:57.000000000 +0200 @@ -72,7 +72,7 @@ In the .I "POSIX" or -.I ""C" +.I "C" locales .BR strcoll () is equivalent to @@ -86,7 +86,7 @@ .BR string (3), .BR strxfrm (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strcpy.3 manpages-3.54/man3/strcpy.3 --- manpages-3.52/man3/strcpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strcpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -222,7 +222,7 @@ .BR wcscpy (3), .BR wcsncpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strdup.3 manpages-3.54/man3/strdup.3 --- manpages-3.52/man3/strdup.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strdup.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ .RS 4 .TP 4 Since glibc 2.10: -POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700 +_POSIX_C_SOURCE\ >=\ 200809L || _XOPEN_SOURCE\ >=\ 700 .TP Before glibc 2.10: _GNU_SOURCE @@ -139,7 +139,7 @@ .BR string (3), .BR wcsdup (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strerror.3 manpages-3.54/man3/strerror.3 --- manpages-3.52/man3/strerror.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strerror.3 2013-09-17 08:27:57.000000000 +0200 @@ -217,7 +217,7 @@ .BR perror (3), .BR strsignal (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strfmon.3 manpages-3.54/man3/strfmon.3 --- manpages-3.52/man3/strfmon.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strfmon.3 2013-09-17 08:27:57.000000000 +0200 @@ -178,7 +178,7 @@ .BR sprintf (3), .BR locale (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strfry.3 manpages-3.54/man3/strfry.3 --- manpages-3.52/man3/strfry.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strfry.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ .BR memfrob (3), .BR string (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strftime.3 manpages-3.54/man3/strftime.3 --- manpages-3.52/man3/strftime.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strftime.3 2013-09-17 08:27:57.000000000 +0200 @@ -571,7 +571,7 @@ .BR sprintf (3), .BR strptime (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/string.3 manpages-3.54/man3/string.3 --- manpages-3.52/man3/string.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/string.3 2013-09-17 08:27:57.000000000 +0200 @@ -117,7 +117,7 @@ .BR strtok (3), .BR strxfrm (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strlen.3 manpages-3.54/man3/strlen.3 --- manpages-3.52/man3/strlen.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strlen.3 2013-09-17 08:27:57.000000000 +0200 @@ -55,7 +55,7 @@ .BR wcslen (3), .BR wcsnlen (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strnlen.3 manpages-3.54/man3/strnlen.3 --- manpages-3.52/man3/strnlen.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strnlen.3 2013-09-17 08:27:57.000000000 +0200 @@ -73,7 +73,7 @@ .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strpbrk.3 manpages-3.54/man3/strpbrk.3 --- manpages-3.52/man3/strpbrk.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strpbrk.3 2013-09-17 08:27:57.000000000 +0200 @@ -67,7 +67,7 @@ .BR strtok (3), .BR wcspbrk (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strptime.3 manpages-3.54/man3/strptime.3 --- manpages-3.52/man3/strptime.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strptime.3 2013-09-17 08:27:57.000000000 +0200 @@ -426,7 +426,7 @@ .BR setlocale (3), .BR strftime (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strsep.3 manpages-3.54/man3/strsep.3 --- manpages-3.52/man3/strsep.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strsep.3 2013-09-17 08:27:57.000000000 +0200 @@ -108,7 +108,7 @@ .BR strstr (3), .BR strtok (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strsignal.3 manpages-3.54/man3/strsignal.3 --- manpages-3.52/man3/strsignal.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strsignal.3 2013-09-17 08:27:57.000000000 +0200 @@ -88,7 +88,7 @@ .BR psignal (3), .BR strerror (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strspn.3 manpages-3.54/man3/strspn.3 --- manpages-3.52/man3/strspn.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strspn.3 2013-09-17 08:27:57.000000000 +0200 @@ -86,7 +86,7 @@ .BR wcscspn (3), .BR wcsspn (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strstr.3 manpages-3.54/man3/strstr.3 --- manpages-3.52/man3/strstr.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strstr.3 2013-09-17 08:27:57.000000000 +0200 @@ -94,7 +94,7 @@ .BR strtok (3), .BR wcsstr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strtod.3 manpages-3.54/man3/strtod.3 --- manpages-3.52/man3/strtod.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strtod.3 2013-09-17 08:27:57.000000000 +0200 @@ -183,7 +183,7 @@ .BR strtol (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strtoimax.3 manpages-3.54/man3/strtoimax.3 --- manpages-3.52/man3/strtoimax.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strtoimax.3 2013-09-17 08:27:57.000000000 +0200 @@ -64,7 +64,7 @@ .BR strtoul (3), .BR wcstoimax (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strtok.3 manpages-3.54/man3/strtok.3 --- manpages-3.52/man3/strtok.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strtok.3 2013-09-17 08:27:57.000000000 +0200 @@ -277,7 +277,7 @@ .BR strstr (3), .BR wcstok (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strtol.3 manpages-3.54/man3/strtol.3 --- manpages-3.52/man3/strtol.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strtol.3 2013-09-17 08:27:57.000000000 +0200 @@ -289,7 +289,7 @@ .BR strtod (3), .BR strtoul (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strtoul.3 manpages-3.54/man3/strtoul.3 --- manpages-3.52/man3/strtoul.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strtoul.3 2013-09-17 08:27:57.000000000 +0200 @@ -217,7 +217,7 @@ .BR strtod (3), .BR strtol (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strverscmp.3 manpages-3.54/man3/strverscmp.3 --- manpages-3.52/man3/strverscmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strverscmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -95,7 +95,7 @@ .BR strcmp (3), .BR strcoll (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/strxfrm.3 manpages-3.54/man3/strxfrm.3 --- manpages-3.52/man3/strxfrm.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/strxfrm.3 2013-09-17 08:27:57.000000000 +0200 @@ -94,7 +94,7 @@ .BR strcoll (3), .BR string (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/swab.3 manpages-3.54/man3/swab.3 --- manpages-3.52/man3/swab.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/swab.3 2013-09-17 08:27:57.000000000 +0200 @@ -74,7 +74,7 @@ .SH SEE ALSO .BR bstring (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sysconf.3 manpages-3.54/man3/sysconf.3 --- manpages-3.52/man3/sysconf.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sysconf.3 2013-09-17 08:27:57.000000000 +0200 @@ -47,7 +47,7 @@ At run time, one can ask for numerical values using the present function .BR sysconf (). One can ask for numerical values that may depend -on the file system a file is in using the calls +on the filesystem a file is in using the calls .BR fpathconf (3) and .BR pathconf (3). @@ -341,7 +341,7 @@ .BR pathconf (3), .BR posixoptions (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/syslog.3 manpages-3.54/man3/syslog.3 --- manpages-3.52/man3/syslog.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/syslog.3 2013-09-17 08:27:57.000000000 +0200 @@ -318,7 +318,7 @@ .BR syslog.conf (5), .BR syslogd (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/system.3 manpages-3.54/man3/system.3 --- manpages-3.52/man3/system.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/system.3 2013-09-17 08:27:57.000000000 +0200 @@ -156,7 +156,7 @@ .BR wait (2), .BR exec (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/sysv_signal.3 manpages-3.54/man3/sysv_signal.3 --- manpages-3.52/man3/sysv_signal.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/sysv_signal.3 2013-09-17 08:27:57.000000000 +0200 @@ -90,7 +90,7 @@ .BR bsd_signal (3), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tan.3 manpages-3.54/man3/tan.3 --- manpages-3.52/man3/tan.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tan.3 2013-09-17 08:27:57.000000000 +0200 @@ -152,7 +152,7 @@ .BR ctan (3), .BR sin (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tanh.3 manpages-3.54/man3/tanh.3 --- manpages-3.52/man3/tanh.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tanh.3 2013-09-17 08:27:57.000000000 +0200 @@ -111,7 +111,7 @@ .BR ctanh (3), .BR sinh (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tcgetpgrp.3 manpages-3.54/man3/tcgetpgrp.3 --- manpages-3.52/man3/tcgetpgrp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tcgetpgrp.3 2013-09-17 08:27:57.000000000 +0200 @@ -122,7 +122,7 @@ .BR setsid (2), .BR credentials (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tcgetsid.3 manpages-3.54/man3/tcgetsid.3 --- manpages-3.52/man3/tcgetsid.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tcgetsid.3 2013-09-17 08:27:57.000000000 +0200 @@ -73,7 +73,7 @@ .SH SEE ALSO .BR getsid (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/telldir.3 manpages-3.54/man3/telldir.3 --- manpages-3.52/man3/telldir.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/telldir.3 2013-09-17 08:27:57.000000000 +0200 @@ -27,7 +27,7 @@ .\" Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991) .\" 386BSD man pages .\" Modified Sat Jul 24 17:48:42 1993 by Rik Faith (faith@cs.unc.edu) -.TH TELLDIR 3 2013-03-24 "" "Linux Programmer's Manual" +.TH TELLDIR 3 2013-09-02 "" "Linux Programmer's Manual" .SH NAME telldir \- return current location in directory stream .SH SYNOPSIS @@ -61,6 +61,11 @@ .TP .B EBADF Invalid directory stream descriptor \fIdirp\fP. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR telldir () +function is thread-safe. .SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH NOTES @@ -72,12 +77,12 @@ .IR long , and this is the type used since glibc 2.1.2. -In early file systems, the value returned by +In early filesystems, the value returned by .BR telldir () was a simple file offset within a directory. -Modern file systems use tree or hash structures, rather than flat tables, +Modern filesystems use tree or hash structures, rather than flat tables, to represent directories. -On such file systems, the value returned by +On such filesystems, the value returned by .BR telldir () (and used internally by .BR readdir (3)) @@ -95,7 +100,7 @@ .BR scandir (3), .BR seekdir (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tempnam.3 manpages-3.54/man3/tempnam.3 --- manpages-3.52/man3/tempnam.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tempnam.3 2013-09-17 08:27:57.000000000 +0200 @@ -85,7 +85,7 @@ and hence should be freed by .BR free (3). .SH RETURN VALUE -On succes, the +On success, the .BR tempnam () function returns a pointer to a unique temporary filename. It returns NULL if a unique name cannot be generated, with @@ -171,7 +171,7 @@ .BR tmpfile (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/termios.3 manpages-3.54/man3/termios.3 --- manpages-3.52/man3/termios.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/termios.3 2013-09-17 08:27:57.000000000 +0200 @@ -980,7 +980,7 @@ .BR tty_ioctl (4), .BR setserial (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tgamma.3 manpages-3.54/man3/tgamma.3 --- manpages-3.52/man3/tgamma.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tgamma.3 2013-09-17 08:27:57.000000000 +0200 @@ -189,7 +189,7 @@ .BR gamma (3), .BR lgamma (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/timegm.3 manpages-3.54/man3/timegm.3 --- manpages-3.52/man3/timegm.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/timegm.3 2013-09-17 08:27:57.000000000 +0200 @@ -105,7 +105,7 @@ .BR mktime (3), .BR tzset (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/timeradd.3 manpages-3.54/man3/timeradd.3 --- manpages-3.52/man3/timeradd.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/timeradd.3 2013-09-17 08:27:57.000000000 +0200 @@ -151,7 +151,7 @@ .BR gettimeofday (2), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tmpfile.3 manpages-3.54/man3/tmpfile.3 --- manpages-3.52/man3/tmpfile.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tmpfile.3 2013-09-17 08:27:57.000000000 +0200 @@ -74,7 +74,7 @@ There was no room in the directory to add the new filename. .TP .B EROFS -Read-only file system. +Read-only filesystem. .SH CONFORMING TO SVr4, 4.3BSD, C89, C99, SUSv2, POSIX.1-2001. .SH NOTES @@ -101,7 +101,7 @@ .BR tempnam (3), .BR tmpnam (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tmpnam.3 manpages-3.54/man3/tmpnam.3 --- manpages-3.52/man3/tmpnam.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tmpnam.3 2013-09-17 08:27:57.000000000 +0200 @@ -166,7 +166,7 @@ .BR tempnam (3), .BR tmpfile (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/toascii.3 manpages-3.54/man3/toascii.3 --- manpages-3.52/man3/toascii.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/toascii.3 2013-09-17 08:27:57.000000000 +0200 @@ -65,7 +65,7 @@ .BR tolower (3), .BR toupper (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/toupper.3 manpages-3.54/man3/toupper.3 --- manpages-3.52/man3/toupper.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/toupper.3 2013-09-17 08:27:57.000000000 +0200 @@ -77,7 +77,7 @@ .BR towupper (3), .BR locale (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/towctrans.3 manpages-3.54/man3/towctrans.3 --- manpages-3.52/man3/towctrans.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/towctrans.3 2013-09-17 08:27:57.000000000 +0200 @@ -66,7 +66,7 @@ .BR towupper (3), .BR wctrans (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/towlower.3 manpages-3.54/man3/towlower.3 --- manpages-3.52/man3/towlower.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/towlower.3 2013-09-17 08:27:57.000000000 +0200 @@ -67,7 +67,7 @@ .BR towctrans (3), .BR towupper (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/towupper.3 manpages-3.54/man3/towupper.3 --- manpages-3.52/man3/towupper.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/towupper.3 2013-09-17 08:27:57.000000000 +0200 @@ -67,7 +67,7 @@ .BR towctrans (3), .BR towlower (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/trunc.3 manpages-3.54/man3/trunc.3 --- manpages-3.52/man3/trunc.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/trunc.3 2013-09-17 08:27:57.000000000 +0200 @@ -99,7 +99,7 @@ .BR rint (3), .BR round (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tsearch.3 manpages-3.54/man3/tsearch.3 --- manpages-3.52/man3/tsearch.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tsearch.3 2013-09-17 08:27:57.000000000 +0200 @@ -292,7 +292,7 @@ .BR lsearch (3), .BR qsort (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ttyname.3 manpages-3.54/man3/ttyname.3 --- manpages-3.52/man3/ttyname.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/ttyname.3 2013-09-17 08:27:57.000000000 +0200 @@ -87,7 +87,7 @@ .BR ctermid (3), .BR isatty (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ttyslot.3 manpages-3.54/man3/ttyslot.3 --- manpages-3.52/man3/ttyslot.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/ttyslot.3 2013-09-17 08:27:57.000000000 +0200 @@ -25,7 +25,7 @@ .\" This replaces an earlier man page written by Walter Harms .\" . .\" -.TH TTYSLOT 3 2013-06-21 "GNU" "Linux Programmer's Manual" +.TH TTYSLOT 3 2013-07-22 "GNU" "Linux Programmer's Manual" .SH NAME ttyslot \- find the slot of the current user's terminal in some file .SH SYNOPSIS @@ -124,7 +124,7 @@ .SS Multithreading (see pthreads(7)) The .BR ttyslot () -calls thread-unsafe function +function calls thread-unsafe function .BR getttyent (), so it is not thread-safe. .SH CONFORMING TO @@ -155,7 +155,7 @@ .BR ttyname (3), .BR utmp (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/tzset.3 manpages-3.54/man3/tzset.3 --- manpages-3.52/man3/tzset.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/tzset.3 2013-09-17 08:27:57.000000000 +0200 @@ -238,7 +238,7 @@ .BR getenv (3), .BR tzfile (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ualarm.3 manpages-3.54/man3/ualarm.3 --- manpages-3.52/man3/ualarm.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/ualarm.3 2013-09-17 08:27:57.000000000 +0200 @@ -148,7 +148,7 @@ .BR usleep (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ulimit.3 manpages-3.54/man3/ulimit.3 --- manpages-3.52/man3/ulimit.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/ulimit.3 2013-09-17 08:27:57.000000000 +0200 @@ -86,7 +86,7 @@ .BR setrlimit (2), .BR sysconf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/undocumented.3 manpages-3.54/man3/undocumented.3 --- manpages-3.52/man3/undocumented.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/undocumented.3 2013-09-17 08:27:57.000000000 +0200 @@ -181,7 +181,7 @@ .BR yp_unbind (3), .BR yp_update (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/ungetwc.3 manpages-3.54/man3/ungetwc.3 --- manpages-3.52/man3/ungetwc.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/ungetwc.3 2013-09-17 08:27:57.000000000 +0200 @@ -86,7 +86,7 @@ .SH SEE ALSO .BR fgetwc (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/unlocked_stdio.3 manpages-3.54/man3/unlocked_stdio.3 --- manpages-3.52/man3/unlocked_stdio.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/unlocked_stdio.3 2013-09-17 08:27:57.000000000 +0200 @@ -137,7 +137,7 @@ .BR flockfile (3), .BR stdio (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/unlockpt.3 manpages-3.54/man3/unlockpt.3 --- manpages-3.52/man3/unlockpt.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/unlockpt.3 2013-09-17 08:27:57.000000000 +0200 @@ -52,7 +52,7 @@ .BR pts (4), .BR pty (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/updwtmp.3 manpages-3.54/man3/updwtmp.3 --- manpages-3.52/man3/updwtmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/updwtmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -88,7 +88,7 @@ .BR getutxent (3), .BR wtmp (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/usleep.3 manpages-3.54/man3/usleep.3 --- manpages-3.52/man3/usleep.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/usleep.3 2013-09-17 08:27:57.000000000 +0200 @@ -149,7 +149,7 @@ .BR ualarm (3), .BR time (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcpcpy.3 manpages-3.54/man3/wcpcpy.3 --- manpages-3.52/man3/wcpcpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcpcpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -70,7 +70,7 @@ .BR strcpy (3), .BR wcscpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcpncpy.3 manpages-3.54/man3/wcpncpy.3 --- manpages-3.52/man3/wcpncpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcpncpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -89,14 +89,14 @@ .SH RETURN VALUE .BR wcpncpy () returns a pointer to the last wide character written, that is, -.IR dest + n \- 1" . +.IR dest + n \-1. .SH CONFORMING TO POSIX.1-2008. .SH SEE ALSO .BR stpncpy (3), .BR wcsncpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcrtomb.3 manpages-3.54/man3/wcrtomb.3 --- manpages-3.52/man3/wcrtomb.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcrtomb.3 2013-09-17 08:27:57.000000000 +0200 @@ -123,7 +123,7 @@ .SH SEE ALSO .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcscasecmp.3 manpages-3.54/man3/wcscasecmp.3 --- manpages-3.52/man3/wcscasecmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcscasecmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -95,7 +95,7 @@ .BR strcasecmp (3), .BR wcscmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcscat.3 manpages-3.54/man3/wcscat.3 --- manpages-3.52/man3/wcscat.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcscat.3 2013-09-17 08:27:57.000000000 +0200 @@ -38,7 +38,7 @@ The strings may not overlap. .PP The programmer must ensure that there is room for at least -.IR "wcslen(dest) + wcslen(src) + 1" +.IR wcslen(dest) + wcslen(src) +1 wide characters at .IR dest . .SH RETURN VALUE @@ -53,7 +53,7 @@ .BR wcscpy (3), .BR wcsncat (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcschr.3 manpages-3.54/man3/wcschr.3 --- manpages-3.52/man3/wcschr.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcschr.3 2013-09-17 08:27:57.000000000 +0200 @@ -53,7 +53,7 @@ .BR wcsstr (3), .BR wmemchr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcscmp.3 manpages-3.54/man3/wcscmp.3 --- manpages-3.52/man3/wcscmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcscmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ .BR wcscasecmp (3), .BR wmemcmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcscpy.3 manpages-3.54/man3/wcscpy.3 --- manpages-3.52/man3/wcscpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcscpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -55,7 +55,7 @@ .BR wcsdup (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcscspn.3 manpages-3.54/man3/wcscspn.3 --- manpages-3.52/man3/wcscspn.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcscspn.3 2013-09-17 08:27:57.000000000 +0200 @@ -65,7 +65,7 @@ .BR wcspbrk (3), .BR wcsspn (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsdup.3 manpages-3.54/man3/wcsdup.3 --- manpages-3.52/man3/wcsdup.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsdup.3 2013-09-17 08:27:57.000000000 +0200 @@ -76,7 +76,7 @@ .BR strdup (3), .BR wcscpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcslen.3 manpages-3.54/man3/wcslen.3 --- manpages-3.52/man3/wcslen.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcslen.3 2013-09-17 08:27:57.000000000 +0200 @@ -44,7 +44,7 @@ .SH SEE ALSO .BR strlen (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsncasecmp.3 manpages-3.54/man3/wcsncasecmp.3 --- manpages-3.52/man3/wcsncasecmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsncasecmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -100,7 +100,7 @@ .BR strncasecmp (3), .BR wcsncmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsncat.3 manpages-3.54/man3/wcsncat.3 --- manpages-3.52/man3/wcsncat.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsncat.3 2013-09-17 08:27:57.000000000 +0200 @@ -41,7 +41,7 @@ The strings may not overlap. .PP The programmer must ensure that there is room for at least -.IR "wcslen(dest) + n + 1" +.IR wcslen(dest) + n +1 wide characters at .IR dest . .SH RETURN VALUE @@ -54,7 +54,7 @@ .BR strncat (3), .BR wcscat (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsncmp.3 manpages-3.54/man3/wcsncmp.3 --- manpages-3.52/man3/wcsncmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsncmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -76,7 +76,7 @@ .BR strncmp (3), .BR wcsncasecmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsncpy.3 manpages-3.54/man3/wcsncpy.3 --- manpages-3.52/man3/wcsncpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsncpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -71,7 +71,7 @@ .SH SEE ALSO .BR strncpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsnlen.3 manpages-3.54/man3/wcsnlen.3 --- manpages-3.52/man3/wcsnlen.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsnlen.3 2013-09-17 08:27:57.000000000 +0200 @@ -85,7 +85,7 @@ .BR strnlen (3), .BR wcslen (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsnrtombs.3 manpages-3.54/man3/wcsnrtombs.3 --- manpages-3.52/man3/wcsnrtombs.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsnrtombs.3 2013-09-17 08:27:57.000000000 +0200 @@ -174,7 +174,7 @@ .BR iconv (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcspbrk.3 manpages-3.54/man3/wcspbrk.3 --- manpages-3.52/man3/wcspbrk.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcspbrk.3 2013-09-17 08:27:57.000000000 +0200 @@ -53,7 +53,7 @@ .BR wcschr (3), .BR wcscspn (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsrchr.3 manpages-3.54/man3/wcsrchr.3 --- manpages-3.52/man3/wcsrchr.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsrchr.3 2013-09-17 08:27:57.000000000 +0200 @@ -50,7 +50,7 @@ .BR strrchr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsrtombs.3 manpages-3.54/man3/wcsrtombs.3 --- manpages-3.52/man3/wcsrtombs.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsrtombs.3 2013-09-17 08:27:57.000000000 +0200 @@ -141,7 +141,7 @@ .BR wcsnrtombs (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsspn.3 manpages-3.54/man3/wcsspn.3 --- manpages-3.52/man3/wcsspn.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsspn.3 2013-09-17 08:27:57.000000000 +0200 @@ -63,7 +63,7 @@ .BR strspn (3), .BR wcscspn (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcsstr.3 manpages-3.54/man3/wcsstr.3 --- manpages-3.52/man3/wcsstr.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcsstr.3 2013-09-17 08:27:57.000000000 +0200 @@ -59,7 +59,7 @@ .BR strstr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcstoimax.3 manpages-3.54/man3/wcstoimax.3 --- manpages-3.52/man3/wcstoimax.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcstoimax.3 2013-09-17 08:27:57.000000000 +0200 @@ -57,7 +57,7 @@ .BR wcstol (3), .BR wcstoul (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcstok.3 manpages-3.54/man3/wcstok.3 --- manpages-3.52/man3/wcstok.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcstok.3 2013-09-17 08:27:57.000000000 +0200 @@ -100,7 +100,7 @@ .BR strtok (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcstombs.3 manpages-3.54/man3/wcstombs.3 --- manpages-3.52/man3/wcstombs.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcstombs.3 2013-09-17 08:27:57.000000000 +0200 @@ -103,7 +103,7 @@ .BR mbstowcs (3), .BR wcsrtombs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcswidth.3 manpages-3.54/man3/wcswidth.3 --- manpages-3.52/man3/wcswidth.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcswidth.3 2013-09-17 08:27:57.000000000 +0200 @@ -57,7 +57,7 @@ .BR iswprint (3), .BR wcwidth (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wctob.3 manpages-3.54/man3/wctob.3 --- manpages-3.52/man3/wctob.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wctob.3 2013-09-17 08:27:57.000000000 +0200 @@ -70,7 +70,7 @@ .BR wcrtomb (3), .BR wctomb (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wctomb.3 manpages-3.54/man3/wctomb.3 --- manpages-3.52/man3/wctomb.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wctomb.3 2013-09-17 08:27:57.000000000 +0200 @@ -13,7 +13,7 @@ .\" OpenGroup's Single UNIX specification http://www.UNIX-systems.org/online.html .\" ISO/IEC 9899:1999 .\" -.TH WCTOMB 3 1999-07-25 "GNU" "Linux Programmer's Manual" +.TH WCTOMB 3 2013-09-09 "GNU" "Linux Programmer's Manual" .SH NAME wctomb \- convert a wide character to a multibyte sequence .SH SYNOPSIS @@ -81,6 +81,11 @@ .BR wctomb () function returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. +.SH ATTRIBUTES +.SS Multithreading (see pthreads(7)) +The +.BR wctomb () +function is not thread-safe. .SH CONFORMING TO C99. .SH NOTES @@ -91,7 +96,6 @@ category of the current locale. .PP -This function is not multithread safe. The function .BR wcrtomb (3) provides @@ -101,7 +105,7 @@ .BR wcrtomb (3), .BR wcstombs (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wctrans.3 manpages-3.54/man3/wctrans.3 --- manpages-3.52/man3/wctrans.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wctrans.3 2013-09-17 08:27:57.000000000 +0200 @@ -71,7 +71,7 @@ .SH SEE ALSO .BR towctrans (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wctype.3 manpages-3.54/man3/wctype.3 --- manpages-3.52/man3/wctype.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wctype.3 2013-09-17 08:27:57.000000000 +0200 @@ -83,7 +83,7 @@ .SH SEE ALSO .BR iswctype (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wcwidth.3 manpages-3.54/man3/wcwidth.3 --- manpages-3.52/man3/wcwidth.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wcwidth.3 2013-09-17 08:27:57.000000000 +0200 @@ -61,7 +61,7 @@ .BR iswprint (3), .BR wcswidth (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wmemchr.3 manpages-3.54/man3/wmemchr.3 --- manpages-3.52/man3/wmemchr.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wmemchr.3 2013-09-17 08:27:57.000000000 +0200 @@ -54,7 +54,7 @@ .BR memchr (3), .BR wcschr (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wmemcmp.3 manpages-3.54/man3/wmemcmp.3 --- manpages-3.52/man3/wmemcmp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wmemcmp.3 2013-09-17 08:27:57.000000000 +0200 @@ -73,7 +73,7 @@ .BR memcmp (3), .BR wcscmp (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wmemcpy.3 manpages-3.54/man3/wmemcpy.3 --- manpages-3.52/man3/wmemcpy.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wmemcpy.3 2013-09-17 08:27:57.000000000 +0200 @@ -57,7 +57,7 @@ .BR wmemmove (3), .BR wmempcpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wmemmove.3 manpages-3.54/man3/wmemmove.3 --- manpages-3.52/man3/wmemmove.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wmemmove.3 2013-09-17 08:27:57.000000000 +0200 @@ -53,7 +53,7 @@ .BR memmove (3), .BR wmemcpy (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wmemset.3 manpages-3.54/man3/wmemset.3 --- manpages-3.52/man3/wmemset.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wmemset.3 2013-09-17 08:27:57.000000000 +0200 @@ -45,7 +45,7 @@ .SH SEE ALSO .BR memset (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wordexp.3 manpages-3.54/man3/wordexp.3 --- manpages-3.52/man3/wordexp.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wordexp.3 2013-09-17 08:27:57.000000000 +0200 @@ -214,7 +214,7 @@ .BR fnmatch (3), .BR glob (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/wprintf.3 manpages-3.54/man3/wprintf.3 --- manpages-3.52/man3/wprintf.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/wprintf.3 2013-09-17 08:27:57.000000000 +0200 @@ -258,7 +258,7 @@ .BR snprintf (3) .\" .BR wscanf (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/xcrypt.3 manpages-3.54/man3/xcrypt.3 --- manpages-3.52/man3/xcrypt.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/xcrypt.3 2013-09-17 08:27:57.000000000 +0200 @@ -72,7 +72,7 @@ .SH SEE ALSO .BR cbc_crypt (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/xdr.3 manpages-3.54/man3/xdr.3 --- manpages-3.52/man3/xdr.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/xdr.3 2013-09-17 08:27:57.000000000 +0200 @@ -553,7 +553,7 @@ USC-ISI. .RE .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man3/y0.3 manpages-3.54/man3/y0.3 --- manpages-3.52/man3/y0.3 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man3/y0.3 2013-09-17 08:27:58.000000000 +0200 @@ -246,7 +246,7 @@ .SH SEE ALSO .BR j0 (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/cciss.4 manpages-3.54/man4/cciss.4 --- manpages-3.52/man4/cciss.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/cciss.4 2013-09-17 08:27:58.000000000 +0200 @@ -226,8 +226,9 @@ Additionally, note that the driver will not engage the SCSI core at init time. -The driver must be directed to dynamically engage the SCSI core via -the /proc file-system entry, +The driver must be directed to dynamically engage the SCSI core via the +.I /proc +filesystem entry, which the "block" side of the driver creates as .I /proc/driver/cciss/cciss* at run time. @@ -260,7 +261,9 @@ .B cciss driver must be informed that changes to the SCSI bus have been made. -This may be done via the /proc file system. +This may be done via the +.I /proc +filesystem. For example: echo "rescan" > /proc/scsi/cciss0/1 @@ -281,7 +284,9 @@ The driver then notifies the SCSI midlayer of these changes. -Note that the naming convention of the /proc file-system entries +Note that the naming convention of the +.I /proc +filesystem entries contains a number in addition to the driver name (e.g., "cciss0" instead of just "cciss", which you might expect). @@ -363,7 +368,7 @@ .\" Charles White, Francis Wiran .\" and probably some other people. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/console.4 manpages-3.54/man4/console.4 --- manpages-3.52/man4/console.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/console.4 2013-09-17 08:27:58.000000000 +0200 @@ -110,7 +110,7 @@ .BR resizecons (8), .BR setfont (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/console_codes.4 manpages-3.54/man4/console_codes.4 --- manpages-3.52/man4/console_codes.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/console_codes.4 2013-09-17 08:27:58.000000000 +0200 @@ -644,7 +644,7 @@ .BR console_ioctl (4), .BR charsets (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/console_ioctl.4 manpages-3.54/man4/console_ioctl.4 --- manpages-3.52/man4/console_ioctl.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/console_ioctl.4 2013-09-17 08:27:58.000000000 +0200 @@ -213,7 +213,7 @@ .I charheight are filled with the respective data for the currently loaded font, and the -.I hardata +.I chardata array contains the font data if the initial value of .I charcount indicated enough space was available; otherwise the @@ -241,7 +241,6 @@ .B PIO_FONTX Sets screen font and associated rendering information. .I argp - points to a .in +4n @@ -285,7 +284,7 @@ .I argp points to an area of size -.IR E_TABSZ*sizeof(unsigned short) , +.IR "E_TABSZ*sizeof(unsigned short)" , which is loaded with the Unicodes each character represent. A special set of Unicodes, @@ -872,7 +871,7 @@ .IR /usr/include/linux/kd.h , .I /usr/include/linux/vt.h .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/cpuid.4 manpages-3.54/man4/cpuid.4 --- manpages-3.52/man4/cpuid.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/cpuid.4 2013-09-17 08:27:58.000000000 +0200 @@ -94,7 +94,7 @@ Intel Corporation, Intel Processor Identification and the CPUID Instruction, Application note 485. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/dsp56k.4 manpages-3.54/man4/dsp56k.4 --- manpages-3.52/man4/dsp56k.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/dsp56k.4 2013-09-17 08:27:58.000000000 +0200 @@ -119,7 +119,7 @@ .UE , DSP56000/DSP56001 Digital Signal Processor User's Manual .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/fd.4 manpages-3.54/man4/fd.4 --- manpages-3.52/man4/fd.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/fd.4 2013-09-17 08:27:58.000000000 +0200 @@ -219,7 +219,7 @@ .BR mount (8), .BR setfdprm (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/full.4 manpages-3.54/man4/full.4 --- manpages-3.52/man4/full.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/full.4 2013-09-17 08:27:58.000000000 +0200 @@ -63,7 +63,7 @@ .BR null (4), .BR zero (4) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/hd.4 manpages-3.54/man4/hd.4 --- manpages-3.52/man4/hd.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/hd.4 2013-09-17 08:27:58.000000000 +0200 @@ -108,7 +108,7 @@ .BR sd (4), .BR mount (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/hpsa.4 manpages-3.54/man4/hpsa.4 --- manpages-3.52/man4/hpsa.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/hpsa.4 2013-09-17 08:27:58.000000000 +0200 @@ -195,7 +195,7 @@ .\" Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel .\" and probably some other people. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/initrd.4 manpages-3.54/man4/initrd.4 --- manpages-3.52/man4/initrd.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/initrd.4 2013-09-17 08:27:58.000000000 +0200 @@ -79,13 +79,13 @@ contents for a two-phase system boot-up. .PP In the first boot-up phase, the kernel starts up -and mounts an initial root file-system from the contents of +and mounts an initial root filesystem from the contents of .I /dev/initrd (e.g., RAM disk initialized by the boot loader). In the second phase, additional drivers or other modules are loaded from the initial root device's contents. -After loading the additional modules, a new root file system -(i.e., the normal root file system) is mounted from a +After loading the additional modules, a new root filesystem +(i.e., the normal root filesystem) is mounted from a different device. .\" .\" @@ -109,16 +109,16 @@ .IP 3. The kernel then read-write mounts the device .I /dev/ram0 -as the initial root file system. +as the initial root filesystem. .IP 4. -If the indicated normal root file system is also the initial -root file-system (e.g., +If the indicated normal root filesystem is also the initial +root filesystem (e.g., .IR /dev/ram0 ) then the kernel skips to the last step for the usual boot sequence. .IP 5. If the executable file .IR /linuxrc -is present in the initial root file-system, +is present in the initial root filesystem, .I /linuxrc is executed with UID 0. (The file @@ -132,15 +132,15 @@ .I /linuxrc is not executed or when .I /linuxrc -terminates, the normal root file system is mounted. +terminates, the normal root filesystem is mounted. (If .I /linuxrc -exits with any file-systems mounted on the initial root -file-system, then the behavior of the kernel is +exits with any filesystems mounted on the initial root +filesystem, then the behavior of the kernel is .BR UNSPECIFIED . See the NOTES section for the current kernel behavior.) .IP 7. -If the normal root file system has a directory +If the normal root filesystem has a directory .IR /initrd , the device .I /dev/ram0 @@ -162,7 +162,7 @@ .IR /dev/ram0 . If directory .I /initrd -does not exist on the normal root file system +does not exist on the normal root filesystem and any processes remain running from .IR /dev/ram0 when @@ -173,7 +173,7 @@ .IP 8. The usual boot sequence (e.g., invocation of .IR /sbin/init ) -is performed on the normal root file system. +is performed on the normal root filesystem. .\" .\" .\" @@ -195,7 +195,7 @@ configuration file .IR /etc/lilo.config . The filename specified with this -option will typically be a gzipped file-system image. +option will typically be a gzipped filesystem image. .TP .I noinitrd This boot option disables the two-phase boot-up operation. @@ -207,13 +207,13 @@ loaded into memory by the boot loader contents are preserved. This option permits the contents of .I /dev/initrd -to be any data and need not be limited to a file system image. +to be any data and need not be limited to a filesystem image. However, device .I /dev/initrd is read-only and can be read only one time after system startup. .TP .BI root= "device-name" -Specifies the device to be used as the normal root file system. +Specifies the device to be used as the normal root filesystem. For .B LOADLIN this is a command-line option. @@ -225,26 +225,26 @@ configuration file .IR /etc/lilo.config . The device specified by the this option must be a mountable -device having a suitable root file-system. +device having a suitable root filesystem. .\" .\" .\" -.SS Changing the normal root file system +.SS Changing the normal root filesystem By default, the kernel's settings (e.g., set in the kernel file with .BR rdev (8) or compiled into the kernel file), or the boot loader option setting -is used for the normal root file systems. -For an NFS-mounted normal root file system, one has to use the +is used for the normal root filesystems. +For an NFS-mounted normal root filesystem, one has to use the .B nfs_root_name and .B nfs_root_addrs boot options to give the NFS settings. For more information on NFS-mounted root see the kernel documentation file .BR Documentation/filesystems/nfsroot.txt . -For more information on setting the root file system see also the +For more information on setting the root filesystem see also the .BR LILO and .BR LOADLIN @@ -268,9 +268,9 @@ .IR /proc/sys/kernel/nfs-root-addrs . For a physical root device, the root device is changed by having .I /linuxrc -write the new root file system device number into +write the new root filesystem device number into .IR /proc/sys/kernel/real-root-dev . -For an NFS root file system, the root device is changed by having +For an NFS root filesystem, the root device is changed by having .I /linuxrc write the NFS setting into files .IR /proc/sys/kernel/nfs-root-name @@ -302,14 +302,14 @@ .BR Note : The use of .I /proc/sys/kernel/real-root-dev -to change the root file system is obsolete. +to change the root filesystem is obsolete. See the Linux kernel source file .I Documentation/initrd.txt as well as .BR pivot_root (2) and .BR pivot_root (8) -for information on the modern method of changing the root file system. +for information on the modern method of changing the root filesystem. .\" FIXME the manual page should describe the pivot_root mechanism. .\" .\" @@ -325,26 +325,26 @@ (e.g., support for .IR /dev/ram , .IR /dev/initrd , -and the ext2 file-system) and loads +and the ext2 filesystem) and loads .IR /dev/initrd -with a gzipped version of the initial file-system. +with a gzipped version of the initial filesystem. .IP 2. The executable .I /linuxrc -determines what is needed to (1) mount the normal root file-system -(i.e., device type, device drivers, file system) and (2) the +determines what is needed to (1) mount the normal root filesystem +(i.e., device type, device drivers, filesystem) and (2) the distribution media (e.g., CD-ROM, network, tape, ...). This can be done by asking the user, by auto-probing, or by using a hybrid approach. .IP 3. The executable .I /linuxrc -loads the necessary modules from the initial root file-system. +loads the necessary modules from the initial root filesystem. .IP 4. The executable .I /linuxrc -creates and populates the root file system. -(At this stage the normal root file system does not have to be a +creates and populates the root filesystem. +(At this stage the normal root filesystem does not have to be a completed system yet.) .IP 5. The executable @@ -353,17 +353,17 @@ .IR /proc/sys/kernel/real-root-dev , unmount .IR /proc , -the normal root file system and any other file -systems it has mounted, and then terminates. +the normal root filesystem and any other filesystems +it has mounted, and then terminates. .IP 6. -The kernel then mounts the normal root file system. +The kernel then mounts the normal root filesystem. .IP 7. -Now that the file system is accessible and intact, +Now that the filesystem is accessible and intact, the boot loader can be installed. .IP 8. The boot loader is configured to load into .I /dev/initrd -a file system with the set of modules that was used to bring up the system. +a filesystem with the set of modules that was used to bring up the system. (e.g., Device .I /dev/ram0 can be modified, then unmounted, and finally, the image is written from @@ -393,7 +393,7 @@ would be different. .PP A third scenario is more convenient recovery disks. -Because information like the location of the root file-system +Because information like the location of the root filesystem partition is not needed at boot time, the system loaded from .I /dev/initrd can use a dialog and/or auto-detection followed by a @@ -428,7 +428,7 @@ .\" .SH NOTES .IP 1. 3 -With the current kernel, any file systems that remain mounted when +With the current kernel, any filesystems that remain mounted when .I /dev/ram0 is moved from .I / @@ -447,7 +447,7 @@ .B not be fully unmounted if .I /dev/ram0 -is used by any process or has any file-system mounted on it. +is used by any process or has any filesystem mounted on it. If .IR /dev/ram0 is @@ -482,7 +482,7 @@ in the Linux kernel source tree, the LILO documentation, the LOADLIN documentation, the SYSLINUX documentation .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/intro.4 manpages-3.54/man4/intro.4 --- manpages-3.52/man4/intro.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/intro.4 2013-09-17 08:27:58.000000000 +0200 @@ -38,7 +38,7 @@ .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/lp.4 manpages-3.54/man4/lp.4 --- manpages-3.52/man4/lp.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/lp.4 2013-09-17 08:27:58.000000000 +0200 @@ -139,7 +139,7 @@ .BR lpcntl (8), .BR tunelp (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/mem.4 manpages-3.54/man4/mem.4 --- manpages-3.52/man4/mem.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/mem.4 2013-09-17 08:27:58.000000000 +0200 @@ -86,7 +86,7 @@ .BR mknod (1), .BR ioperm (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/mouse.4 manpages-3.54/man4/mouse.4 --- manpages-3.52/man4/mouse.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/mouse.4 2013-09-17 08:27:58.000000000 +0200 @@ -185,7 +185,7 @@ .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/msr.4 manpages-3.54/man4/msr.4 --- manpages-3.52/man4/msr.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/msr.4 2013-09-17 08:27:58.000000000 +0200 @@ -57,7 +57,7 @@ Software Developer's Manual Volume 3B Appendix B, for an overview of the Intel CPU MSRs. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/null.4 manpages-3.54/man4/null.4 --- manpages-3.52/man4/null.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/null.4 2013-09-17 08:27:58.000000000 +0200 @@ -66,7 +66,7 @@ .BR mknod (1), .BR full (4) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/pts.4 manpages-3.54/man4/pts.4 --- manpages-3.52/man4/pts.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/pts.4 2013-09-17 08:27:58.000000000 +0200 @@ -63,7 +63,7 @@ The Linux support for the above (known as UNIX 98 pseudoterminal naming) is done using the .I devpts -file system, that should be mounted on +filesystem, that should be mounted on .IR /dev/pts . .LP Before this UNIX 98 scheme, master pseudoterminals were called @@ -78,7 +78,7 @@ .BR unlockpt (3), .BR pty (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/ram.4 manpages-3.54/man4/ram.4 --- manpages-3.52/man4/ram.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/ram.4 2013-09-17 08:27:58.000000000 +0200 @@ -45,7 +45,7 @@ .BR mknod (1), .BR mount (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/random.4 manpages-3.54/man4/random.4 --- manpages-3.52/man4/random.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/random.4 2013-09-17 08:27:58.000000000 +0200 @@ -284,7 +284,7 @@ .br RFC\ 1750, "Randomness Recommendations for Security" .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/rtc.4 manpages-3.54/man4/rtc.4 --- manpages-3.52/man4/rtc.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/rtc.4 2013-09-17 08:27:58.000000000 +0200 @@ -342,7 +342,7 @@ .I Documentation/rtc.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/sd.4 manpages-3.54/man4/sd.4 --- manpages-3.52/man4/sd.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/sd.4 2013-09-17 08:27:58.000000000 +0200 @@ -135,7 +135,7 @@ .\".SH "SEE ALSO" .\".BR scsi (4) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/sk98lin.4 manpages-3.54/man4/sk98lin.4 --- manpages-3.52/man4/sk98lin.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/sk98lin.4 2013-09-17 08:27:58.000000000 +0200 @@ -85,8 +85,8 @@ .B sk98lin is bound to one or more adapter cards and the .I /proc -file system is mounted on your system, a dedicated statistics file -will be created in folder +filesystem is mounted on your system, a dedicated statistics file +will be created in the folder .I /proc/net/sk98lin for all ports of the installed network adapter cards. Those files are named @@ -613,7 +613,7 @@ .BR insmod (8), .BR modprobe (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/st.4 manpages-3.54/man4/st.4 --- manpages-3.52/man4/st.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/st.4 2013-09-17 08:27:58.000000000 +0200 @@ -962,7 +962,7 @@ the most recent information about the driver and its configuration possibilities .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/tty.4 manpages-3.54/man4/tty.4 --- manpages-3.52/man4/tty.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/tty.4 2013-09-17 08:27:58.000000000 +0200 @@ -83,7 +83,7 @@ .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/tty_ioctl.4 manpages-3.54/man4/tty_ioctl.4 --- manpages-3.52/man4/tty_ioctl.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/tty_ioctl.4 2013-09-17 08:27:58.000000000 +0200 @@ -496,7 +496,7 @@ .\" TIOCSERSETMULTI const struct serial_multiport_struct * .\" TIOCGSERIAL, TIOCSSERIAL (see above) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/ttyS.4 manpages-3.54/man4/ttyS.4 --- manpages-3.52/man4/ttyS.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/ttyS.4 2013-09-17 08:27:58.000000000 +0200 @@ -53,7 +53,7 @@ .BR mingetty (8), .BR setserial (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/vcs.4 manpages-3.54/man4/vcs.4 --- manpages-3.52/man4/vcs.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/vcs.4 2013-09-17 08:27:58.000000000 +0200 @@ -75,7 +75,7 @@ operations of .BR console (4), so the system -administrator can control access using file system permissions. +administrator can control access using filesystem permissions. .PP The devices for the first eight virtual consoles may be created by: @@ -176,7 +176,7 @@ .BR ttyS (4), .BR gpm (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man4/wavelan.4 manpages-3.54/man4/wavelan.4 --- manpages-3.52/man4/wavelan.4 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man4/wavelan.4 2013-09-17 08:27:58.000000000 +0200 @@ -12,12 +12,15 @@ .\" (mtk, July 2006) .\" %%%LICENSE_END .\" -.TH WAVELAN 4 1996-10-22 "Linux" "Linux Programmer's Manual" +.TH WAVELAN 4 2013-09-04 "Linux" "Linux Programmer's Manual" .SH NAME wavelan \- AT&T GIS WaveLAN ISA device driver .SH SYNOPSIS .BI "insmod wavelan_cs.o [io=" B,B.. "] [ irq=" I,I.. "] [name=" N,N.. ] .SH DESCRIPTION +.I This driver is obsolete: +it was removed from the kernel in version 2.6.35. + .I wavelan is the low-level device driver for the NCR / AT&T / Lucent .B WaveLAN ISA @@ -140,7 +143,7 @@ .BR iwpriv (8), .BR iwspy (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/acct.5 manpages-3.54/man5/acct.5 --- manpages-3.52/man5/acct.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/acct.5 2013-09-17 08:27:58.000000000 +0200 @@ -177,7 +177,7 @@ .BR accton (8), .BR sa (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/charmap.5 manpages-3.54/man5/charmap.5 --- manpages-3.52/man5/charmap.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/charmap.5 2013-09-17 08:27:58.000000000 +0200 @@ -128,7 +128,7 @@ .BR setlocale (3), .BR locale (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/core.5 manpages-3.54/man5/core.5 --- manpages-3.52/man5/core.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/core.5 2013-09-17 08:27:58.000000000 +0200 @@ -63,9 +63,9 @@ core dump already exists, but there is more than one hard link to that file. .IP * -The file system where the core dump file would be created is full; +The filesystem where the core dump file would be created is full; or has run out of inodes; or is mounted read-only; -or the user has reached their quota for the file system. +or the user has reached their quota for the filesystem. .IP * The directory in which the core dump file is to be created does not exist. @@ -418,7 +418,7 @@ .BR pthreads (7), .BR signal (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/dir_colors.5 manpages-3.54/man5/dir_colors.5 --- manpages-3.52/man5/dir_colors.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/dir_colors.5 2013-09-17 08:27:58.000000000 +0200 @@ -9,7 +9,7 @@ .\" .\" Modified Sat Dec 22 22:25:33 2001 by Martin Schulze .\" -.TH DIR_COLORS 5 2001-12-26 "GNU" "Linux User Manual" +.TH DIR_COLORS 5 2013-08-09 "GNU" "Linux User Manual" .SH NAME dir_colors \- configuration file for dircolors(1) .SH DESCRIPTION @@ -102,6 +102,9 @@ .TP .B NORMAL \fIcolor-sequence\fR Specifies the color used for normal (nonfilename) text. + +Synonym: +.BR NORM . .TP .B FILE \fIcolor-sequence\fR Specifies the color used for a regular file. @@ -111,6 +114,10 @@ .TP .B LINK \fIcolor-sequence\fR Specifies the color used for a symbolic link. + +Synonyms: +.BR LNK , +.BR SYMLINK . .TP .B ORPHAN \fIcolor-sequence\fR Specifies the color used for an orphaned symbolic link (one which @@ -132,6 +139,9 @@ .TP .B FIFO \fIcolor-sequence\fR Specifies the color used for a FIFO (named pipe). + +Synonym: +.BR PIPE . .TP .B SOCK \fIcolor-sequence\fR Specifies the color used for a socket. @@ -142,27 +152,69 @@ .TP .B BLK \fIcolor-sequence\fR Specifies the color used for a block device special file. + +Synonym: +.BR BLOCK . .TP .B CHR \fIcolor-sequence\fR Specifies the color used for a character device special file. + +Synonym: +.BR CHAR . .TP .B EXEC \fIcolor-sequence\fR Specifies the color used for a file with the executable attribute set. .TP +.B SUID \fIcolor-sequence\fR +Specifies the color used for a file with the set-user-ID attribute set. + +Synonym: +.BR SETUID . +.TP +.B SGID \fIcolor-sequence\fR +Specifies the color used for a file with the set-group-ID attribute set. + +Synonym: +.BR SETGID . +.TP +.B STICKY \fIcolor-sequence\fR +Specifies the color used for a directory with the sticky attribute set. +.TP +.B STICKY_OTHER_WRITABLE \fIcolor-sequence\fR +Specifies the color used for a other-writable directory with the executable attribute set. + +Synonym: +.BR OWT . +.TP +.B OTHER_WRITABLE \fIcolor-sequence\fR +Specifies the color used for a other-writable directory without the executable attribute set. + +Synonym: +.BR OWR . +.TP .B LEFTCODE \fIcolor-sequence\fR Specifies the .I "left code" for non-ISO\ 6429 terminals (see below). + +Synonym: +.BR LEFT . .TP .B RIGHTCODE \fIcolor-sequence\fR Specifies the .I "right code" for non-ISO\ 6429 terminals (see below). + +Synonym: +.BR RIGHT . .TP .B ENDCODE \fIcolor-sequence\fR Specifies the .I "end code" for non-ISO\ 6429 terminals (see below). + +Synonym: +.BR END . .TP \fB*\fIextension\fR \fIcolor-sequence\fR Specifies the color used for any file that ends in \fIextension\fR. @@ -322,7 +374,7 @@ .TE .RE .sp -Please note that escapes are necessary to enter a space, backslash, +Note that escapes are necessary to enter a space, backslash, caret, or any control character anywhere in the string, as well as a hash mark as the first character. .SH FILES @@ -361,7 +413,7 @@ .BR stty (1), .BR xterm (1) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/elf.5 manpages-3.54/man5/elf.5 --- manpages-3.52/man5/elf.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/elf.5 2013-09-17 08:27:58.000000000 +0200 @@ -1961,7 +1961,7 @@ .IR "System V Application Binary Interface AMD64 Architecture Processor Supplement" . .PP .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/filesystems.5 manpages-3.54/man5/filesystems.5 --- manpages-3.52/man5/filesystems.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/filesystems.5 2013-09-17 08:27:58.000000000 +0200 @@ -26,29 +26,29 @@ .TH FILESYSTEMS 5 2012-08-05 "Linux" "Linux Programmer's Manual" .nh .SH NAME -filesystems \- Linux file-system types: minix, ext, ext2, ext3, ext4, Reiserfs, +filesystems \- Linux filesystem types: minix, ext, ext2, ext3, ext4, Reiserfs, XFS, JFS, xia, msdos, umsdos, vfat, ntfs, proc, nfs, iso9660, hpfs, sysv, smb, ncpfs .SH DESCRIPTION When, as is customary, the .B proc -file system is mounted on +filesystem is mounted on .IR /proc , you can find in the file .I /proc/filesystems -which file systems your kernel currently supports. +which filesystems your kernel currently supports. If you need a currently unsupported one, insert the corresponding module or recompile the kernel. -In order to use a file system, you have to +In order to use a filesystem, you have to .I mount it; see .BR mount (8). -Below a short description of a few of the available file systems. +Below a short description of a few of the available filesystems. .TP 10 .B "minix" -is the file system used in the Minix operating system, the first to run +is the filesystem used in the Minix operating system, the first to run under Linux. It has a number of shortcomings: a 64MB partition size limit, short filenames, a single timestamp, etc. @@ -57,24 +57,24 @@ .B ext is an elaborate extension of the .B minix -file system. +filesystem. It has been completely superseded by the second version -of the extended file system +of the extended filesystem .RB ( ext2 ) and has been removed from the kernel (in 2.1.21). .TP .B ext2 -is the high performance disk file system used by Linux for fixed disks +is the high performance disk filesystem used by Linux for fixed disks as well as removable media. -The second extended file system was designed as an extension of the -extended file system +The second extended filesystem was designed as an extension of the +extended filesystem .RB ( ext ). .B ext2 offers the best performance (in terms of speed and CPU usage) of -the file systems supported under Linux. +the filesystems supported under Linux. .TP .B ext3 -is a journaling version of the ext2 file system. +is a journaling version of the ext2 filesystem. It is easy to switch back and forth between ext2 and ext3. .TP @@ -84,51 +84,51 @@ plus large increases in volume, file, and directory size limits. .TP .B Reiserfs -is a journaling file system, designed by Hans Reiser, +is a journaling filesystem, designed by Hans Reiser, that was integrated into Linux in kernel 2.4.1. .TP .B XFS -is a journaling file system, developed by SGI, +is a journaling filesystem, developed by SGI, that was integrated into Linux in kernel 2.4.20. .TP .B JFS -is a journaling file system, developed by IBM, +is a journaling filesystem, developed by IBM, that was integrated into Linux in kernel 2.4.24. .TP .B xiafs -was designed and implemented to be a stable, safe file system by -extending the Minix file system code. +was designed and implemented to be a stable, safe filesystem by +extending the Minix filesystem code. It provides the basic most requested features without undue complexity. The .B xia -file system is no longer actively developed or maintained. +filesystem is no longer actively developed or maintained. It was removed from the kernel in 2.1.21. .TP .B msdos -is the file system used by DOS, Windows, and some OS/2 computers. +is the filesystem used by DOS, Windows, and some OS/2 computers. .B msdos filenames can be no longer than 8 characters, followed by an optional period and 3 character extension. .TP .B umsdos -is an extended DOS file system used by Linux. +is an extended DOS filesystem used by Linux. It adds capability for long filenames, UID/GID, POSIX permissions, and special files -(devices, named pipes, etc.) under the DOS file system, without +(devices, named pipes, etc.) under the DOS filesystem, without sacrificing compatibility with DOS. .TP .B vfat -is an extended DOS file system used by Microsoft Windows95 and Windows NT. -VFAT adds the capability to use long filenames under the MSDOS file system. +is an extended DOS filesystem used by Microsoft Windows95 and Windows NT. +VFAT adds the capability to use long filenames under the MSDOS filesystem. .TP .B ntfs -replaces Microsoft Window's FAT file systems (VFAT, FAT32). +replaces Microsoft Window's FAT filesystems (VFAT, FAT32). It has reliability, performance, and space-utilization enhancements plus features like ACLs, journaling, encryption, and so on. .TP .B proc -is a pseudo file system which is used as an interface to kernel data +is a pseudo filesystem which is used as an interface to kernel data structures rather than reading and interpreting .IR /dev/kmem . In particular, its files do not take disk space. @@ -136,42 +136,42 @@ .BR proc (5). .TP .B iso9660 -is a CD-ROM file system type conforming to the ISO 9660 standard. +is a CD-ROM filesystem type conforming to the ISO 9660 standard. .RS .TP .B "High Sierra" Linux supports High Sierra, the precursor to the ISO 9660 standard for -CD-ROM file systems. +CD-ROM filesystems. It is automatically recognized within the .B iso9660 -file-system support under Linux. +filesystem support under Linux. .TP .B "Rock Ridge" Linux also supports the System Use Sharing Protocol records specified by the Rock Ridge Interchange Protocol. They are used to further describe the files in the .B iso9660 -file system to a UNIX host, and provide information such as long +filesystem to a UNIX host, and provide information such as long filenames, UID/GID, POSIX permissions, and devices. It is automatically recognized within the .B iso9660 -file-system support under Linux. +filesystem support under Linux. .RE .TP .B hpfs is the High Performance Filesystem, used in OS/2. -This file system is +This filesystem is read-only under Linux due to the lack of available documentation. .TP .B sysv -is an implementation of the SystemV/Coherent file system for Linux. +is an implementation of the SystemV/Coherent filesystem for Linux. It implements all of Xenix FS, SystemV/386 FS, and Coherent FS. .TP .B nfs -is the network file system used to access disks located on remote computers. +is the network filesystem used to access disks located on remote computers. .TP .B smb -is a network file system that supports the SMB protocol, used by +is a network filesystem that supports the SMB protocol, used by Windows for Workgroups, Windows NT, and Lan Manager. .sp To use @@ -182,7 +182,7 @@ .UE . .TP .B ncpfs -is a network file system that supports the NCP protocol, used by +is a network filesystem that supports the NCP protocol, used by Novell NetWare. .sp To use @@ -196,7 +196,7 @@ .BR mkfs (8), .BR mount (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/ftpusers.5 manpages-3.54/man5/ftpusers.5 --- manpages-3.52/man5/ftpusers.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/ftpusers.5 2013-09-17 08:27:58.000000000 +0200 @@ -51,7 +51,7 @@ .BR proftpd (8), .BR wuftpd (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/gai.conf.5 manpages-3.54/man5/gai.conf.5 --- manpages-3.52/man5/gai.conf.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/gai.conf.5 2013-09-17 08:27:58.000000000 +0200 @@ -94,7 +94,7 @@ .BR getaddrinfo(3), RFC\ 3484 .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/group.5 manpages-3.54/man5/group.5 --- manpages-3.52/man5/group.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/group.5 2013-09-17 08:27:58.000000000 +0200 @@ -65,7 +65,7 @@ .BR getgrnam (3), .BR passwd (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/host.conf.5 manpages-3.54/man5/host.conf.5 --- manpages-3.52/man5/host.conf.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/host.conf.5 2013-09-17 08:27:58.000000000 +0200 @@ -202,7 +202,7 @@ .BR named (8), .BR resolv+ (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/hosts.5 manpages-3.54/man5/hosts.5 --- manpages-3.52/man5/hosts.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/hosts.5 2013-09-17 08:27:58.000000000 +0200 @@ -124,7 +124,7 @@ .\" This manual page was written by Manoj Srivastava , .\" for the Debian GNU/Linux system. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/hosts.equiv.5 manpages-3.54/man5/hosts.equiv.5 --- manpages-3.52/man5/hosts.equiv.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/hosts.equiv.5 2013-09-17 08:27:58.000000000 +0200 @@ -86,7 +86,7 @@ .BR rlogind (8), .BR rshd (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/intro.5 manpages-3.54/man5/intro.5 --- manpages-3.52/man5/intro.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/intro.5 2013-09-17 08:27:58.000000000 +0200 @@ -38,7 +38,7 @@ .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/issue.5 manpages-3.54/man5/issue.5 --- manpages-3.52/man5/issue.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/issue.5 2013-09-17 08:27:58.000000000 +0200 @@ -43,7 +43,7 @@ .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/locale.5 manpages-3.54/man5/locale.5 --- manpages-3.52/man5/locale.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/locale.5 2013-09-17 08:27:58.000000000 +0200 @@ -614,7 +614,7 @@ .BR setlocale (3), .BR charmap (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/motd.5 manpages-3.54/man5/motd.5 --- manpages-3.52/man5/motd.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/motd.5 2013-09-17 08:27:58.000000000 +0200 @@ -43,7 +43,7 @@ .BR login (1), .BR issue (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/networks.5 manpages-3.54/man5/networks.5 --- manpages-3.52/man5/networks.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/networks.5 2013-09-17 08:27:58.000000000 +0200 @@ -78,7 +78,7 @@ .BR netstat (8), .BR route (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/nologin.5 manpages-3.54/man5/nologin.5 --- manpages-3.52/man5/nologin.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/nologin.5 2013-09-17 08:27:58.000000000 +0200 @@ -39,7 +39,7 @@ .BR login (1), .BR shutdown (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/nscd.conf.5 manpages-3.54/man5/nscd.conf.5 --- manpages-3.52/man5/nscd.conf.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/nscd.conf.5 2013-09-17 08:27:58.000000000 +0200 @@ -235,7 +235,7 @@ .\" .B nscd .\" was written by Thorsten Kukuk and Ulrich Drepper. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/nss.5 manpages-3.54/man5/nss.5 --- manpages-3.52/man5/nss.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/nss.5 2013-09-17 08:27:58.000000000 +0200 @@ -110,7 +110,7 @@ .SH SEE ALSO \fInsswitch.conf\fR .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/nsswitch.conf.5 manpages-3.54/man5/nsswitch.conf.5 --- manpages-3.52/man5/nsswitch.conf.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/nsswitch.conf.5 2013-09-17 08:27:58.000000000 +0200 @@ -353,7 +353,7 @@ .BR getent (1), .BR nss (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/passwd.5 manpages-3.54/man5/passwd.5 --- manpages-3.52/man5/passwd.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/passwd.5 2013-09-17 08:27:58.000000000 +0200 @@ -169,7 +169,7 @@ .BR group (5), .BR shadow (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/proc.5 manpages-3.54/man5/proc.5 --- manpages-3.52/man5/proc.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/proc.5 2013-09-17 08:27:58.000000000 +0200 @@ -59,20 +59,20 @@ .\" to see what information could be imported from that file .\" into this file. .\" -.TH PROC 5 2013-06-27 "Linux" "Linux Programmer's Manual" +.TH PROC 5 2013-09-04 "Linux" "Linux Programmer's Manual" .SH NAME -proc \- process information pseudo-file system +proc \- process information pseudo-filesystem .SH DESCRIPTION The .I proc -file system is a pseudo-file system which is used as an interface to +filesystem is a pseudo-filesystem which provides an interface to kernel data structures. It is commonly mounted at .IR /proc . Most of it is read-only, but some files allow kernel variables to be changed. .LP -The following outline gives a quick tour through the +The following list describes many of the files and directories under the .I /proc hierarchy. .PD 1 @@ -350,9 +350,88 @@ .BR open (2)). The files in this directory are readable only by the owner of the process. -.\" FIXME document /proc/[pid]/io -.\" .TP -.\" .IR /proc/[pid]/io " (since kernel 2.6.20)" +.TP +.IR /proc/[pid]/io " (since kernel 2.6.20)" +.\" commit 7c3ab7381e79dfc7db14a67c6f4f3285664e1ec2 +This file contains I/O statistics for the process, for example: +.in +4n +.nf + +.RB "#" " cat /proc/3828/io" +rchar: 323934931 +wchar: 323929600 +syscr: 632687 +syscw: 632675 +read_bytes: 0 +write_bytes: 323932160 +cancelled_write_bytes: 0 +.fi +.in + +The fields are as follows: +.RS +.TP +.IR rchar ": characters read" +The number of bytes which this task has caused to be read from storage. +This is simply the sum of bytes which this process passed to +.BR read (2) +and similar system calls. +It includes things such as terminal I/O and +is unaffected by whether or not actual +physical disk I/O was required (the read might have been satisfied from +pagecache). +.TP +.IR wchar ": characters written" +The number of bytes which this task has caused, or shall cause to be written +to disk. +Similar caveats apply here as with +.IR rchar . +.TP +.IR syscr ": read syscalls" +Attempt to count the number of read I/O operations\(emthat is, +system calls such as +.BR read (2) +and +.BR pread (2). +.TP +.IR syscw ": write syscalls" +Attempt to count the number of write I/O operations\(emthat is, +system calls such as +.BR write (2) +and +.BR pwrite (2). +.TP +.IR read_bytes ": bytes read" +Attempt to count the number of bytes which this process really did cause to +be fetched from the storage layer. +This is accurate for block-backed filesystems. +.TP +.IR write_bytes ": bytes written" +Attempt to count the number of bytes which this process caused to be sent to +the storage layer. +.TP +.IR cancelled_write_bytes : +The big inaccuracy here is truncate. +If a process writes 1MB to a file and then deletes the file, +it will in fact perform no writeout. +But it will have been accounted as having caused 1MB of write. +In other words: this field represents the number of bytes which this process +caused to not happen, by truncating pagecache. +A task can cause "negative" I/O too. +If this task truncates some dirty pagecache, +some I/O which another task has been accounted for +(in its +.IR write_bytes ) +will not be happening. +.RE +.IP +.IR Note : +In the current implementation, things are a bit racy on 32-bit systems: +if process A reads process B's +.I /proc/[pid]/io +while process B is updating one of these 64-bit counters, +process A could see an intermediate result. +.RE .TP .IR /proc/[pid]/limits " (since kernel 2.6.24)" This file displays the soft limit, hard limit, and units of measurement @@ -551,11 +630,11 @@ (3) major:minor: value of .I st_dev -for files on file system (see +for files on filesystem (see .BR stat (2)). .TP (4) -root: root of the mount within the file system. +root: root of the mount within the filesystem. .TP (5) mount point: mount point relative to the process's root. @@ -570,10 +649,10 @@ separator: marks the end of the optional fields. .TP (9) -file system type: name of file system in the form "type[.subtype]". +filesystem type: name of filesystem in the form "type[.subtype]". .TP (10) -mount source: file system-specific information or "none". +mount source: filesystem-specific information or "none". .TP (11) super options: per-super block options. @@ -607,13 +686,13 @@ in the Linux kernel source tree. .TP .IR /proc/[pid]/mounts " (since Linux 2.4.19)" -This is a list of all the file systems currently mounted in the +This is a list of all the filesystems currently mounted in the process's mount namespace. The format of this file is documented in .BR fstab (5). Since kernel version 2.6.15, this file is pollable: after opening the file for reading, a change in this file -(i.e., a file system mount or unmount) causes +(i.e., a filesystem mount or unmount) causes .BR select (2) to mark the file descriptor as readable, and .BR poll (2) @@ -639,14 +718,14 @@ (or "nodevice" if there is no corresponding device). .TP (2) -The mount point within the file system tree. +The mount point within the filesystem tree. .TP (3) -The file system type. +The filesystem type. .TP (4) Optional statistics and configuration information. -Currently (as at Linux 2.6.26), only NFS file systems export +Currently (as at Linux 2.6.26), only NFS filesystems export information via this field. .RE .IP @@ -849,7 +928,7 @@ .TP .I /proc/[pid]/root UNIX and Linux support the idea of a per-process root of the -file system, set by the +filesystem, set by the .BR chroot (2) system call. This file is a symbolic link that points to the process's @@ -1268,7 +1347,7 @@ PID of process tracing this process (0 if not being traced). .IP * .IR Uid ", " Gid : -Real, effective, saved set, and file system UIDs (GIDs). +Real, effective, saved set, and filesystem UIDs (GIDs). .IP * .IR FDSize : Number of file descriptor slots currently allocated. @@ -1498,20 +1577,20 @@ is defined during kernel compilation. .TP .I /proc/filesystems -A text listing of the file systems which are supported by the kernel, -namely file systems which were compiled into the kernel or whose kernel +A text listing of the filesystems which are supported by the kernel, +namely filesystems which were compiled into the kernel or whose kernel modules are currently loaded. (See also .BR filesystems (5).) -If a file system is marked with "nodev", +If a filesystem is marked with "nodev", this means that it does not require a block device to be mounted -(e.g., virtual file system, network file system). +(e.g., virtual filesystem, network filesystem). Incidentally, this file may be used by .BR mount (8) -when no file system is specified and it didn't manage to determine the -file system type. -Then file systems contained in this file are tried +when no filesystem is specified and it didn't manage to determine the +filesystem type. +Then filesystems contained in this file are tried (excepted those that are marked with "nodev"). .TP .I /proc/fs @@ -1882,7 +1961,7 @@ .TP .I /proc/mounts Before kernel 2.4.19, this file was a list -of all the file systems currently mounted on the system. +of all the filesystems currently mounted on the system. With the introduction of per-process mount namespaces in Linux 2.4.19, this file became a link to .IR /proc/self/mounts , @@ -2080,8 +2159,8 @@ socket and Path is the bound path (if any) of the socket. .TP .I /proc/partitions -Contains major and minor numbers of each partition as well as number -of blocks and partition name. +Contains the major and minor numbers of each partition as well as the number +of 1024-byte blocks and the partition name. .TP .I /proc/pci This is a listing of all PCI devices found during kernel initialization @@ -2171,7 +2250,7 @@ .I /proc/self This directory refers to the process accessing the .I /proc -file system, +filesystem, and is identical to the .I /proc directory named by the process ID of the same process. @@ -2307,7 +2386,7 @@ This directory (present since 1.3.57) contains a number of files and subdirectories corresponding to kernel variables. These variables can be read and sometimes modified using -the \fI/proc\fP file system, and the (deprecated) +the \fI/proc\fP filesystem, and the (deprecated) .BR sysctl (2) system call. .TP @@ -2329,7 +2408,7 @@ .TP .I /proc/sys/fs This directory contains the files and subdirectories for kernel variables -related to file systems. +related to filesystems. .TP .I /proc/sys/fs/binfmt_misc Documentation for files in this directory can be found @@ -2418,15 +2497,6 @@ imposes an upper limit on the value that may be placed in .IR file-max . -If you increase -.IR /proc/sys/fs/file-max "," -be sure to increase -.I /proc/sys/fs/inode-max -to 3-4 times the new -value of -.IR /proc/sys/fs/file-max "," -or you will run out of inodes. - Privileged processes .RB ( CAP_SYS_ADMIN ) can override the @@ -2452,15 +2522,18 @@ Since Linux 2.6, the kernel does deallocate freed file handles, and the "free file handles" value is always zero. .TP -.I /proc/sys/fs/inode-max +.IR /proc/sys/fs/inode-max " (only present until Linux 2.2)" This file contains the maximum number of in-memory inodes. -On some (2.4) systems, it may not be present. This value should be 3-4 times larger than the value in .IR file-max , since \fIstdin\fP, \fIstdout\fP and network sockets also need an inode to handle them. When you regularly run out of inodes, you need to increase this value. + +Starting with Linux 2.4, +there is no longer a static limit on the number of inodes, +and this file is removed. .TP .I /proc/sys/fs/inode-nr This file contains the first two values from @@ -2472,20 +2545,23 @@ .IR nr_inodes , .IR nr_free_inodes , .IR preshrink , -and four dummy values. +and four dummy values (always zero). + .I nr_inodes is the number of inodes the system has allocated. -This can be slightly more than -.I inode-max -because Linux allocates them one page full at a time. +.\" This can be slightly more than +.\" .I inode-max +.\" because Linux allocates them one page full at a time. .I nr_free_inodes represents the number of free inodes. + .I preshrink is nonzero when the .I nr_inodes > .I inode-max -and the system needs to prune the inode list instead of allocating more. +and the system needs to prune the inode list instead of allocating more; +since Linux 2.4, this field is a dummy value (always zero). .TP .IR /proc/sys/fs/inotify " (since Linux 2.6.13)" This directory contains files @@ -2524,9 +2600,9 @@ These files allow you to change the value of the fixed UID and GID. The default is 65534. -Some file systems support only 16-bit UIDs and GIDs, although in Linux +Some filesystems support only 16-bit UIDs and GIDs, although in Linux UIDs and GIDs are 32 bits. -When one of these file systems is mounted +When one of these filesystems is mounted with writes enabled, any UID or GID that would exceed 65535 is translated to the overflow value before being written to disk. .TP @@ -2558,11 +2634,11 @@ .BR CAP_FOWNER capability. .IP * -The file system UID of the process creating the link matches +The filesystem UID of the process creating the link matches the owner (UID) of the target file (as described in .BR credentials (7), -a process's file system UID is normally the same as its effective UID). +a process's filesystem UID is normally the same as its effective UID). .IP * All of the following conditions are true: .RS 4 @@ -2603,11 +2679,11 @@ in the following circumstances: .RS .IP * 3 -the file system UID of the process following the link matches +the filesystem UID of the process following the link matches the owner (UID) of the symbolic link (as described in .BR credentials (7), -a process's file system UID is normally the same as its effective UID); +a process's filesystem UID is normally the same as its effective UID); .IP * the link is not in a sticky world-writable directory; or .IP * @@ -2642,7 +2718,7 @@ .TP \fI1\ ("debug")\fP All processes dump core when possible. -The core dump is owned by the file system user ID of the dumping process +The core dump is owned by the filesystem user ID of the dumping process and no security is applied. This is intended for system debugging situations only. Ptrace is unchecked. @@ -2671,17 +2747,17 @@ .I /proc/sys/fs/super-max This file controls the maximum number of superblocks, and -thus the maximum number of mounted file systems the kernel +thus the maximum number of mounted filesystems the kernel can have. You need increase only .I super-max -if you need to mount more file systems than the current value in +if you need to mount more filesystems than the current value in .I super-max allows you to. .TP .I /proc/sys/fs/super-nr This file -contains the number of file systems currently mounted. +contains the number of filesystems currently mounted. .TP .I /proc/sys/kernel This directory contains files controlling a range of kernel parameters, @@ -2696,7 +2772,7 @@ .IR frequency . If BSD-style process accounting is enabled these values control its behavior. -If free space on file system where the log lives goes below +If free space on filesystem where the log lives goes below .I lowwater percent accounting suspends. If free space gets above @@ -3162,7 +3238,7 @@ This directory may be empty. .TP .I /proc/sys/sunrpc -This directory supports Sun remote procedure call for network file system +This directory supports Sun remote procedure call for network filesystem (NFS). On some systems, it is not present. .TP @@ -3171,17 +3247,26 @@ cache management. .TP .IR /proc/sys/vm/drop_caches " (since Linux 2.6.16)" -Writing to this file causes the kernel to drop clean caches, dentries and +Writing to this file causes the kernel to drop clean caches, dentries, and inodes from memory, causing that memory to become free. +This can be useful for memory management testing and +performing reproducible filesystem benchmarks. +Because writing to this file causes the benefits of caching to be lost, +it can degrade overall system performance. + +To free pagecache, use: + + echo 1 > /proc/sys/vm/drop_caches + +To free dentries and inodes, use: + + echo 2 > /proc/sys/vm/drop_caches + +To free pagecache, dentries and inodes, use: -To free pagecache, use -.IR "echo 1 > /proc/sys/vm/drop_caches" ; -to free dentries and inodes, use -.IR "echo 2 > /proc/sys/vm/drop_caches" ; -to free pagecache, dentries and inodes, use -.IR "echo 3 > /proc/sys/vm/drop_caches" . + echo 3 > /proc/sys/vm/drop_caches -Because this is a nondestructive operation and dirty objects +Because writing to this file is a nondestructive operation and dirty objects are not freeable, the user should run .BR sync (8) @@ -3474,7 +3559,7 @@ and .IR Documentation/sysctl/vm.txt . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/protocols.5 manpages-3.54/man5/protocols.5 --- manpages-3.52/man5/protocols.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/protocols.5 2013-09-17 08:27:58.000000000 +0200 @@ -84,7 +84,7 @@ .UR http://www.iana.org\:/assignments\:/protocol-numbers .UE .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/resolv.conf.5 manpages-3.54/man5/resolv.conf.5 --- manpages-3.52/man5/resolv.conf.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/resolv.conf.5 2013-09-17 08:27:58.000000000 +0200 @@ -20,7 +20,7 @@ .\" .\" Added ndots remark by Bernhard R. Link - debian bug #182886 .\" -.TH RESOLV.CONF 5 2013-03-05 "" "Linux Programmer's Manual" +.TH RESOLV.CONF 5 2013-07-31 "" "Linux Programmer's Manual" .UC 4 .SH NAME resolv.conf \- resolver configuration file @@ -63,6 +63,7 @@ \fBdomain\fP Local domain name. Most queries for names within this domain can use short names relative to the local domain. +If set to \(aq.\(aq, the root domain is considered. If no \fBdomain\fP entry is present, the domain is determined from the local hostname returned by .BR gethostname (2); @@ -291,7 +292,7 @@ .br Name Server Operations Guide for BIND .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/rpc.5 manpages-3.54/man5/rpc.5 --- manpages-3.52/man5/rpc.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/rpc.5 2013-09-17 08:27:58.000000000 +0200 @@ -80,7 +80,7 @@ .SH SEE ALSO .BR getrpcent (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/securetty.5 manpages-3.54/man5/securetty.5 --- manpages-3.52/man5/securetty.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/securetty.5 2013-09-17 08:27:58.000000000 +0200 @@ -44,7 +44,7 @@ .BR login (1), .BR login.defs (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/services.5 manpages-3.54/man5/services.5 --- manpages-3.52/man5/services.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/services.5 2013-09-17 08:27:58.000000000 +0200 @@ -220,7 +220,7 @@ Assigned Numbers RFC, most recently RFC\ 1700, (AKA STD0002). .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/shells.5 manpages-3.54/man5/shells.5 --- manpages-3.52/man5/shells.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/shells.5 2013-09-17 08:27:58.000000000 +0200 @@ -57,7 +57,7 @@ .BR chsh (1), .BR getusershell (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/slabinfo.5 manpages-3.54/man5/slabinfo.5 --- manpages-3.52/man5/slabinfo.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/slabinfo.5 2013-09-17 08:27:58.000000000 +0200 @@ -133,7 +133,7 @@ .B CONFIG_SLAB kernel configuration option is enabled. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/termcap.5 manpages-3.54/man5/termcap.5 --- manpages-3.52/man5/termcap.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/termcap.5 2013-09-17 08:27:58.000000000 +0200 @@ -472,7 +472,7 @@ .BR termcap (3), .BR terminfo (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/ttytype.5 manpages-3.54/man5/ttytype.5 --- manpages-3.52/man5/ttytype.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/ttytype.5 2013-09-17 08:27:58.000000000 +0200 @@ -70,7 +70,7 @@ .BR agetty (8), .BR mingetty (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/tzfile.5 manpages-3.54/man5/tzfile.5 --- manpages-3.52/man5/tzfile.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/tzfile.5 2013-09-17 08:27:58.000000000 +0200 @@ -162,7 +162,7 @@ .I timezone/tzfile.h in the glibc source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man5/utmp.5 manpages-3.54/man5/utmp.5 --- manpages-3.52/man5/utmp.5 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man5/utmp.5 2013-09-17 08:27:58.000000000 +0200 @@ -350,7 +350,7 @@ .BR updwtmp (3), .BR init (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man6/intro.6 manpages-3.54/man6/intro.6 --- manpages-3.52/man6/intro.6 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man6/intro.6 2013-09-17 08:27:58.000000000 +0200 @@ -35,7 +35,7 @@ conditions. Note that these can be different from page to page! .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/aio.7 manpages-3.54/man7/aio.7 --- manpages-3.52/man7/aio.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/aio.7 2013-09-17 08:27:58.000000000 +0200 @@ -463,7 +463,7 @@ .UR http://www.squid-cache.org\:/~adrian\:/Reprint-Pulavarty-OLS2003.pdf .UE .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/armscii-8.7 manpages-3.54/man7/armscii-8.7 --- manpages-3.52/man7/armscii-8.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/armscii-8.7 2013-09-17 08:27:58.000000000 +0200 @@ -141,7 +141,7 @@ .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/arp.7 manpages-3.54/man7/arp.7 --- manpages-3.52/man7/arp.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/arp.7 2013-09-17 08:27:58.000000000 +0200 @@ -308,7 +308,7 @@ algorithms used. Linux 2.2+ IPv4 ARP uses the IPv6 algorithms when applicable. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/ascii.7 manpages-3.54/man7/ascii.7 --- manpages-3.52/man7/ascii.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/ascii.7 2013-09-17 08:27:58.000000000 +0200 @@ -199,7 +199,7 @@ .BR iso_8859-8 (7), .BR iso_8859-9 (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/boot.7 manpages-3.54/man7/boot.7 --- manpages-3.52/man7/boot.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/boot.7 2013-09-17 08:27:58.000000000 +0200 @@ -90,11 +90,11 @@ When the kernel is loaded, it initializes the devices (via their drivers), starts the swapper (it is a "kernel process", called kswapd in modern Linux kernels), and mounts the root -file system (/). +filesystem (/). Some of the parameters that may be passed to the kernel relate to these activities (e.g: You can override the -default root file system). +default root filesystem). For further information on Linux kernel parameters read .BR bootparam (7). @@ -206,7 +206,7 @@ .BR runlevel (8), .BR shutdown (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/bootparam.7 manpages-3.54/man7/bootparam.7 --- manpages-3.52/man7/bootparam.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/bootparam.7 2013-09-17 08:27:58.000000000 +0200 @@ -27,7 +27,7 @@ .\" FIXME ? The use of quotes on this page is inconsistent with the .\" rest of man-pages. .\" -.TH BOOTPARAM 7 2013-06-08 "Linux" "Linux Programmer's Manual" +.TH BOOTPARAM 7 2013-08-01 "Linux" "Linux Programmer's Manual" .SH NAME bootparam \- introduction to boot time parameters of the Linux kernel .SH DESCRIPTION @@ -42,7 +42,7 @@ which you copied a kernel using 'cp zImage /dev/fd0'), you have no opportunity to specify any parameters. So, in order to take advantage of this possibility you have to -use boot loader software that is able to pass parameters, such as GRUB. +use a boot loader that is able to pass parameters, such as GRUB. .\" The LILO program (LInux LOader) written by Werner Almesberger is the .\" most commonly used. @@ -178,7 +178,7 @@ .TP .B "'root=...'" This argument tells the kernel what device is to be used as the root -file system while booting. +filesystem while booting. The default of this setting is determined at compile time, and usually is the value of the root device of the system that the kernel was built on. @@ -188,7 +188,7 @@ The root device can be specified symbolically or numerically. A symbolic specification has the form -.I /dev/XXYN, +.IR /dev/XXYN , where XX designates the device type ('hd' for ST-506 compatible hard disk, with Y in \&'a'-'d'; 'sd' for SCSI compatible disk, with Y in 'a'-'e'; @@ -205,7 +205,7 @@ (The type nfs specifies a net boot; ram refers to a ram disk.) Note that this has nothing to do with the designation of these -devices on your file system. +devices on your filesystem. The '/dev/' part is purely conventional. The more awkward and less portable numeric specification of the above @@ -224,16 +224,16 @@ need to boot the box from alternate media. .TP .BR 'ro' " and " 'rw' -The 'ro' option tells the kernel to mount the root file system -as 'read-only' so that file system consistency check programs (fsck) -can do their work on a quiescent file system. +The 'ro' option tells the kernel to mount the root filesystem +as 'read-only' so that filesystem consistency check programs (fsck) +can do their work on a quiescent filesystem. No processes can -write to files on the file system in question until it is 'remounted' +write to files on the filesystem in question until it is 'remounted' as read/write capable, for example, by 'mount \-w \-n \-o remount /'. (See also .BR mount (8).) -The 'rw' option tells the kernel to mount the root file system read/write. +The 'rw' option tells the kernel to mount the root filesystem read/write. This is the default. .TP @@ -324,7 +324,7 @@ .in +4n .nf -echo N > /proc/sys/kernel/panic". +echo N > /proc/sys/kernel/panic .fi .in .TP @@ -418,7 +418,7 @@ it is often useful to load the floppy contents into a ramdisk. One might also have a system in which first -some modules (for file system or hardware) must be loaded +some modules (for filesystem or hardware) must be loaded before the main disk can be accessed. In Linux 1.3.48, ramdisk handling was changed drastically. @@ -427,7 +427,7 @@ (This could also be set in the kernel image at compile time.) These days ram disks use the buffer cache, and grow dynamically. For a lot of information in conjunction with the new ramdisk -setup), see the kernel source file +setup, see the kernel source file .IR Documentation/blockdev/ramdisk.txt .RI ( Documentation/ramdisk.txt in older kernels). @@ -465,8 +465,8 @@ a "normal" ramdisk, which is mounted read-write as root device; then .I /linuxrc -is executed; afterward the "real" root file system is mounted, -and the initrd file system is moved over tocw +is executed; afterward the "real" root filesystem is mounted, +and the initrd filesystem is moved over to .IR /initrd ; finally the usual boot sequence (e.g., invocation of @@ -1584,9 +1584,7 @@ .\" .SH AUTHORS .\" Linus Torvalds (and many others) .SH SEE ALSO -.BR lilo.conf (5), .BR klogd (8), -.BR lilo (8), .BR mount (8) Large parts of this man page have been derived from the @@ -1595,7 +1593,7 @@ An up-to-date source of information is the kernel source file .IR Documentation/kernel-parameters.txt . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/capabilities.7 manpages-3.54/man7/capabilities.7 --- manpages-3.52/man7/capabilities.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/capabilities.7 2013-09-17 08:27:58.000000000 +0200 @@ -45,7 +45,7 @@ .\" other capabilities where the permitted or inheritable bit is set. .\" 2011-09-07, mtk/Serge hallyn: Add CAP_SYSLOG .\" -.TH CAPABILITIES 7 2013-04-17 "Linux" "Linux Programmer's Manual" +.TH CAPABILITIES 7 2013-07-21 "Linux" "Linux Programmer's Manual" .SH NAME capabilities \- overview of Linux capabilities .SH DESCRIPTION @@ -93,15 +93,24 @@ (DAC is an abbreviation of "discretionary access control".) .TP .B CAP_DAC_READ_SEARCH +.PD 0 +.RS +.IP * 2 Bypass file read permission checks and -directory read and execute permission checks. +directory read and execute permission checks; +.IP * +Invoke +.BR open_by_handle_at (2). +.RE +.PD + .TP .B CAP_FOWNER .PD 0 .RS .IP * 2 Bypass permission checks on operations that normally -require the file system UID of the process to match the UID of +require the filesystem UID of the process to match the UID of the file (e.g., .BR chmod (2), .BR utime (2)), @@ -131,7 +140,7 @@ Don't clear set-user-ID and set-group-ID permission bits when a file is modified; set the set-group-ID bit for a file whose GID does not match -the file system or any of the supplementary GIDs of the calling process. +the filesystem or any of the supplementary GIDs of the calling process. .TP .B CAP_IPC_LOCK .\" FIXME As at Linux 3.2, there are some strange uses of this capability @@ -382,7 +391,7 @@ .BR ioctl (2) operations; .IP * -perform various privileged file-system +perform various privileged filesystem .BR ioctl (2) operations; .IP * @@ -514,7 +523,7 @@ .PD 0 .RS .IP * 2 -Use reserved space on ext2 file systems; +Use reserved space on ext2 filesystems; .IP * make .BR ioctl (2) @@ -623,7 +632,7 @@ The kernel must provide system calls allowing a thread's capability sets to be changed and retrieved. .IP 3. -The file system must support attaching capabilities to an executable file, +The filesystem must support attaching capabilities to an executable file, so that a process gains those capabilities when the file is executed. .PP Before kernel 2.6.24, only the first two of these requirements are met; @@ -909,7 +918,7 @@ 0 and nonzero user IDs, the kernel makes the following changes to a thread's capability sets on changes to the thread's real, effective, saved set, -and file system user IDs (using +and filesystem user IDs (using .BR setuid (2), .BR setresuid (2), or similar): @@ -926,7 +935,7 @@ If the effective user ID is changed from nonzero to 0, then the permitted set is copied to the effective set. .IP 4. -If the file system user ID is changed from 0 to nonzero (see +If the filesystem user ID is changed from 0 to nonzero (see .BR setfsuid (2)) then the following capabilities are cleared from the effective set: .BR CAP_CHOWN , @@ -940,7 +949,7 @@ and .B CAP_MKNOD (since Linux 2.2.30). -If the file system UID is changed from nonzero to 0, +If the filesystem UID is changed from nonzero to 0, then any of these capabilities that are enabled in the permitted set are enabled in the effective set. .PP @@ -1008,7 +1017,7 @@ .TP .B SECBIT_NO_SETUID_FIXUP Setting this flag stops the kernel from adjusting capability sets when -the threads's effective and file system UIDs are switched between +the threads's effective and filesystem UIDs are switched between zero and nonzero values. (See the subsection .IR "Effect of User ID Changes on Capabilities" .) @@ -1150,7 +1159,7 @@ .I include/linux/capability.h in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/charsets.7 manpages-3.54/man7/charsets.7 --- manpages-3.52/man7/charsets.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/charsets.7 2013-09-17 08:27:58.000000000 +0200 @@ -365,7 +365,7 @@ .BR unicode (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/complex.7 manpages-3.54/man7/complex.7 --- manpages-3.52/man7/complex.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/complex.7 2013-09-17 08:27:58.000000000 +0200 @@ -80,7 +80,7 @@ .BR ctan (3), .BR ctanh (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/cp1251.7 manpages-3.54/man7/cp1251.7 --- manpages-3.52/man7/cp1251.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/cp1251.7 2013-09-17 08:27:58.000000000 +0200 @@ -176,7 +176,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/cpuset.7 manpages-3.54/man7/cpuset.7 --- manpages-3.52/man7/cpuset.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/cpuset.7 2013-09-17 08:27:58.000000000 +0200 @@ -26,7 +26,7 @@ .SH NAME cpuset \- confine processes to processor and memory node subsets .SH DESCRIPTION -The cpuset file system is a pseudo-file-system interface +The cpuset filesystem is a pseudo-filesystem interface to the kernel cpuset mechanism, which is used to control the processor placement and memory placement of processes. @@ -39,15 +39,15 @@ .B nodev cpuset in the file .IR /proc/filesystems . -By mounting the cpuset file system (see the +By mounting the cpuset filesystem (see the .B EXAMPLE section below), the administrator can configure the cpusets on a system to control the processor and memory placement of processes on that system. By default, if the cpuset configuration -on a system is not modified or if the cpuset file -system is not even mounted, then the cpuset mechanism, +on a system is not modified or if the cpuset filesystem +is not even mounted, then the cpuset mechanism, though present, has no affect on the system's behavior. .PP A cpuset defines a list of CPUs and memory nodes. @@ -62,14 +62,14 @@ while NUMA (non-uniform memory access) systems have multiple memory nodes. .PP Cpusets are represented as directories in a hierarchical -pseudo-file system, where the top directory in the hierarchy +pseudo-filesystem, where the top directory in the hierarchy .RI ( /dev/cpuset ) represents the entire system (all online CPUs and memory nodes) and any cpuset that is the child (descendant) of another parent cpuset contains a subset of that parent's CPUs and memory nodes. The directories and files representing cpusets have normal -file-system permissions. +filesystem permissions. .PP Every process in the system belongs to exactly one cpuset. A process is confined to run only on the CPUs in @@ -305,7 +305,7 @@ .IR cpuset.memory_spread_page " (since Linux 2.6.17)" Flag (0 or 1). If set (1), pages in the kernel page cache -(file-system buffers) are uniformly spread across the cpuset. +(filesystem buffers) are uniformly spread across the cpuset. By default this is off (0) in the top cpuset, and inherited from the parent cpuset in newly created cpusets. @@ -362,7 +362,7 @@ each process has a pseudo-file, .IR /proc//cpuset , that displays the path of the process's cpuset directory -relative to the root of the cpuset file system. +relative to the root of the cpuset filesystem. .\" ================== proc status ================== .PP Also the @@ -446,7 +446,7 @@ or not, restrict allocations of memory for user space. .PP This enables configuring a system so that several independent -jobs can share common kernel data, such as file system pages, +jobs can share common kernel data, such as filesystem pages, while isolating each job's user allocation in its own cpuset. To do this, construct a large .I hardwall @@ -471,7 +471,7 @@ the kernel will run the command .IR /sbin/cpuset_release_agent , supplying the pathname (relative to the mount point of the -cpuset file system) of the abandoned cpuset. +cpuset filesystem) of the abandoned cpuset. This enables automatic removal of abandoned cpusets. .PP The default value of @@ -565,9 +565,9 @@ The kernel direct reclaim code is entered whenever a process has to satisfy a memory page request by first finding some other page to repurpose, due to lack of any readily available already free pages. -Dirty file system pages are repurposed by first writing them +Dirty filesystem pages are repurposed by first writing them to disk. -Unmodified file system buffer pages are repurposed +Unmodified filesystem buffer pages are repurposed by simply dropping them, though if that page is needed again, it will have to be reread from disk. .PP @@ -580,7 +580,7 @@ .\" ================== Memory Spread ================== .SS Memory spread There are two Boolean flag files per cpuset that control where the -kernel allocates pages for the file-system buffers and related +kernel allocates pages for the filesystem buffers and related in-kernel data structures. They are called .I cpuset.memory_spread_page @@ -590,14 +590,14 @@ If the per-cpuset Boolean flag file .I cpuset.memory_spread_page is set, then -the kernel will spread the file-system buffers (page cache) evenly +the kernel will spread the filesystem buffers (page cache) evenly over all the nodes that the faulting process is allowed to use, instead of preferring to put those pages on the node where the process is running. .PP If the per-cpuset Boolean flag file .I cpuset.memory_spread_slab is set, -then the kernel will spread some file-system-related slab caches, +then the kernel will spread some filesystem-related slab caches, such as those for inodes and directory entries, evenly over all the nodes that the faulting process is allowed to use, instead of preferring to put those pages on the node where the process is running. @@ -652,7 +652,7 @@ memory nodes close to the CPUs which are running the threads that most frequently access that data; but also .IP b) -need to access large file-system data sets that must to be spread +need to access large filesystem data sets that must to be spread across the several nodes in the job's cpuset in order to fit. .PP Without this policy, @@ -946,7 +946,7 @@ .\" ================== PERMISSIONS ================== .SH PERMISSIONS The permissions of a cpuset are determined by the permissions -of the directories and pseudo-files in the cpuset file system, +of the directories and pseudo-files in the cpuset filesystem, normally mounted at .IR /dev/cpuset . .PP @@ -978,7 +978,7 @@ file. .PP There is one minor difference between the manner in which these -permissions are evaluated and the manner in which normal file-system +permissions are evaluated and the manner in which normal filesystem operation permissions are evaluated. The kernel interprets relative pathnames starting at a process's current working directory. @@ -996,20 +996,20 @@ .IR /dev/cpuset , which is a bit unusual) or if some user code converts the relative cpuset path to a -full file-system path. +full filesystem path. .PP In theory, this means that user code should specify cpusets using absolute pathnames, which requires knowing the mount point of -the cpuset file system (usually, but not necessarily, +the cpuset filesystem (usually, but not necessarily, .IR /dev/cpuset ). In practice, all user level code that this author is aware of -simply assumes that if the cpuset file system is mounted, then +simply assumes that if the cpuset filesystem is mounted, then it is mounted at .IR /dev/cpuset . Furthermore, it is common practice for carefully written user code to verify the presence of the pseudo-file .I /dev/cpuset/tasks -in order to verify that the cpuset pseudo-file system +in order to verify that the cpuset pseudo-filesystem is currently mounted. .\" ================== WARNINGS ================== .SH WARNINGS @@ -1503,7 +1503,7 @@ .IR Documentation/cpusets.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/credentials.7 manpages-3.54/man7/credentials.7 --- manpages-3.52/man7/credentials.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/credentials.7 2013-09-17 08:27:58.000000000 +0200 @@ -135,7 +135,7 @@ as message queues, shared memory, and semaphores. On most UNIX systems, these IDs also determine the permissions when accessing files. -However, Linux uses the file system IDs described below +However, Linux uses the filesystem IDs described below for this task. A process can obtain its effective user (group) ID using .BR geteuid (2) @@ -163,18 +163,18 @@ .BR getresuid (2) .RB ( getresgid (2)). .IP * -File system user ID and file system group ID (Linux-specific). +Filesystem user ID and filesystem group ID (Linux-specific). These IDs, in conjunction with the supplementary group IDs described below, are used to determine permissions for accessing files; see .BR path_resolution (7) for details. Whenever a process's effective user (group) ID is changed, -the kernel also automatically changes the file system user (group) ID +the kernel also automatically changes the filesystem user (group) ID to the same value. -Consequently, the file system IDs normally have the same values +Consequently, the filesystem IDs normally have the same values as the corresponding effective ID, and the semantics for file-permission checks are thus the same on Linux as on other UNIX systems. -The file system IDs can be made to differ from the effective IDs +The filesystem IDs can be made to differ from the effective IDs by calling .BR setfsuid (2) and @@ -236,7 +236,7 @@ are specified in POSIX.1-2001. The real, effective, and saved set user and groups IDs, and the supplementary group IDs, are specified in POSIX.1-2001. -The file system user and group IDs are a Linux extension. +The filesystem user and group IDs are a Linux extension. .SH NOTES The POSIX threads specification requires that credentials are shared by all of the threads in a process. @@ -280,7 +280,7 @@ .BR path_resolution (7), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/ddp.7 manpages-3.54/man7/ddp.7 --- manpages-3.52/man7/ddp.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/ddp.7 2013-09-17 08:27:58.000000000 +0200 @@ -252,7 +252,7 @@ .BR capabilities (7), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/environ.7 manpages-3.54/man7/environ.7 --- manpages-3.52/man7/environ.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/environ.7 2013-09-17 08:27:58.000000000 +0200 @@ -253,7 +253,7 @@ .BR unsetenv (3), .BR locale (5) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/epoll.7 manpages-3.54/man7/epoll.7 --- manpages-3.52/man7/epoll.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/epoll.7 2013-09-17 08:27:58.000000000 +0200 @@ -549,7 +549,7 @@ .BR epoll_ctl (2), .BR epoll_wait (2) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/feature_test_macros.7 manpages-3.54/man7/feature_test_macros.7 --- manpages-3.52/man7/feature_test_macros.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/feature_test_macros.7 2013-09-17 08:27:58.000000000 +0200 @@ -248,7 +248,7 @@ .B _FILE_OFFSET_BITS Defining this macro with the value 64 automatically converts references to 32-bit functions and data types -related to file I/O and file system operations into references to +related to file I/O and filesystem operations into references to their 64-bit counterparts. This is useful for performing I/O on large files (> 2 Gigabytes) on 32-bit systems. @@ -330,7 +330,7 @@ to detect some buffer overflow errors when employing various string and memory manipulation functions. Not all buffer overflows are detected, just some common cases. -In the current implementation checks are added for +In the current implementation, checks are added for calls to .BR memcpy (3), .BR mempcpy (3), @@ -608,7 +608,7 @@ .I /usr/include/features.h .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/fifo.7 manpages-3.54/man7/fifo.7 --- manpages-3.52/man7/fifo.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/fifo.7 2013-09-17 08:27:58.000000000 +0200 @@ -15,16 +15,16 @@ fifo \- first-in first-out special file, named pipe .SH DESCRIPTION A FIFO special file (a named pipe) is similar to a pipe, -except that it is accessed as part of the file system. +except that it is accessed as part of the filesystem. It can be opened by multiple processes for reading or writing. When processes are exchanging data via the FIFO, the kernel passes all data internally without writing it -to the file system. +to the filesystem. Thus, the FIFO special file has no -contents on the file system; the file system entry merely +contents on the filesystem; the filesystem entry merely serves as a reference point so that processes can access -the pipe using a name in the file system. +the pipe using a name in the filesystem. .PP The kernel maintains exactly one pipe object for each FIFO special file that is opened by at least one process. @@ -72,7 +72,7 @@ .BR mkfifo (3), .BR pipe (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/futex.7 manpages-3.54/man7/futex.7 --- manpages-3.52/man7/futex.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/futex.7 2013-09-17 08:27:58.000000000 +0200 @@ -51,7 +51,7 @@ .SS Semantics .PP Any futex operation starts in user space, -but it may necessary to communicate with the kernel using the +but it may be necessary to communicate with the kernel using the .BR futex (2) system call. .PP @@ -121,7 +121,7 @@ .UR ftp://ftp.kernel.org\:/pub\:/linux\:/kernel\:/people\:/rusty/ .UE . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/glob.7 manpages-3.54/man7/glob.7 --- manpages-3.52/man7/glob.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/glob.7 2013-09-17 08:27:58.000000000 +0200 @@ -120,7 +120,7 @@ .I bash one can force the classical behavior using this command: - shopt -s nullglob + shopt \-s nullglob .\" In Bash v1, by setting allow_null_glob_expansion=true (Similar problems occur elsewhere. @@ -212,7 +212,7 @@ .BR locale (7), .BR regex (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/hier.7 manpages-3.54/man7/hier.7 --- manpages-3.52/man7/hier.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/hier.7 2013-09-17 08:27:58.000000000 +0200 @@ -30,7 +30,7 @@ .\" Modified Fri Sep 7 20:32:45 2001 by Tammy Fox .TH HIER 7 2012-08-05 "Linux" "Linux Programmer's Manual" .SH NAME -hier \- description of the file system hierarchy +hier \- description of the filesystem hierarchy .SH DESCRIPTION A typical Linux system has, among others, the following directories: .TP @@ -93,18 +93,18 @@ .TP .I /lib This directory should hold those shared libraries that are necessary -to boot the system and to run the commands in the root file system. +to boot the system and to run the commands in the root filesystem. .TP .I /media This directory contains mount points for removable media such as CD and DVD disks or USB sticks. .TP .I /mnt -This directory is a mount point for a temporarily mounted file system. +This directory is a mount point for a temporarily mounted filesystem. In some distributions, .I /mnt contains subdirectories intended to be used as mount points for several -temporary file systems. +temporary filesystems. .TP .I /opt This directory should contain add-on packages that contain static files. @@ -112,9 +112,9 @@ .I /proc This is a mount point for the .I proc -file system, which provides information about running processes and +filesystem, which provides information about running processes and the kernel. -This pseudo-file system is described in more detail in +This pseudo-filesystem is described in more detail in .BR proc (5). .TP .I /root @@ -418,7 +418,7 @@ .I LCK.. where .I -is the device's name in the file system. +is the device's name in the filesystem. The format used is that of HDU UUCP lock files, that is, lock files contain a PID as a 10-byte ASCII decimal number, followed by a newline character. @@ -506,7 +506,7 @@ The Filesystem Hierarchy Standard .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/hostname.7 manpages-3.54/man7/hostname.7 --- manpages-3.52/man7/hostname.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/hostname.7 2013-09-17 08:27:58.000000000 +0200 @@ -91,7 +91,7 @@ .\" Hostname appeared in .\" 4.2BSD. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/icmp.7 manpages-3.54/man7/icmp.7 --- manpages-3.52/man7/icmp.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/icmp.7 2013-09-17 08:27:58.000000000 +0200 @@ -193,7 +193,7 @@ .PP RFC\ 792 for a description of the ICMP protocol. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/inotify.7 manpages-3.54/man7/inotify.7 --- manpages-3.52/man7/inotify.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/inotify.7 2013-09-17 08:27:58.000000000 +0200 @@ -23,13 +23,13 @@ .\" the source, must acknowledge the copyright and authors of this work. .\" %%%LICENSE_END .\" -.TH INOTIFY 7 2013-06-21 "Linux" "Linux Programmer's Manual" +.TH INOTIFY 7 2013-09-16 "Linux" "Linux Programmer's Manual" .SH NAME -inotify \- monitoring file system events +inotify \- monitoring filesystem events .SH DESCRIPTION The .I inotify -API provides a mechanism for monitoring file system events. +API provides a mechanism for monitoring filesystem events. Inotify can be used to monitor individual files, or to monitor directories. When a directory is monitored, inotify will return events @@ -216,10 +216,12 @@ Watched file/directory was itself moved. .TP .B IN_MOVED_FROM -File moved out of watched directory (*). +Generated for the directory containing the old filename +when a file is renamed (*). .TP .B IN_MOVED_TO -File moved into watched directory (*). +Generated for the directory containing the new filename +when a file is renamed (*). .TP .B IN_OPEN File was opened (*). @@ -308,7 +310,7 @@ .B IN_IGNORED Watch was removed explicitly .RB ( inotify_rm_watch (2)) -or automatically (file was deleted, or file system was unmounted). +or automatically (file was deleted, or filesystem was unmounted). .TP .B IN_ISDIR Subject of this event is a directory. @@ -319,7 +321,7 @@ is \-1 for this event). .TP .B IN_UNMOUNT -File system containing watched object was unmounted. +Filesystem containing watched object was unmounted. .PD .RE .SS /proc interfaces @@ -452,6 +454,8 @@ .I oldest unread event. .SH SEE ALSO +.BR inotifywait (1), +.BR inotifywatch (1), .BR inotify_add_watch (2), .BR inotify_init (2), .BR inotify_init1 (2), @@ -462,7 +466,7 @@ .IR Documentation/filesystems/inotify.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/intro.7 manpages-3.54/man7/intro.7 --- manpages-3.52/man7/intro.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/intro.7 2013-09-17 08:27:58.000000000 +0200 @@ -31,7 +31,7 @@ .SH DESCRIPTION Section 7 of the manual provides overviews on various topics, and describes conventions and protocols, -character set standards, the standard file system layout, +character set standards, the standard filesystem layout, and miscellaneous other things. .SH NOTES .SS Authors and copyright conditions @@ -41,7 +41,7 @@ .SH SEE ALSO .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/ip.7 manpages-3.54/man7/ip.7 --- manpages-3.52/man7/ip.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/ip.7 2013-09-17 08:27:58.000000000 +0200 @@ -33,7 +33,7 @@ .\" commit 76e21053b5bf33a07c76f99d27a74238310e3c71 .\" Author: Erich E. Hoover .\" -.TH IP 7 2013-04-16 "Linux" "Linux Programmer's Manual" +.TH IP 7 2013-09-17 "Linux" "Linux Programmer's Manual" .SH NAME ip \- Linux IPv4 protocol implementation .SH SYNOPSIS @@ -542,6 +542,9 @@ .I ip_mreqn or .I ip_mreq +.\" net: IP_MULTICAST_IF setsockopt now recognizes struct mreq +.\" Commit: 3a084ddb4bf299a6e898a9a07c89f3917f0713f7 +(since Linux 3.5) structure similar to .BR IP_ADD_MEMBERSHIP . .IP @@ -1249,7 +1252,7 @@ RFC\ 1812 for the IPv4 router requirements. .\" FIXME autobind INADDR REUSEADDR .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/ipv6.7 manpages-3.54/man7/ipv6.7 --- manpages-3.52/man7/ipv6.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/ipv6.7 2013-09-17 08:27:58.000000000 +0200 @@ -416,7 +416,7 @@ Linux tries to be compliant to this. RFC\ 2460: IPv6 specification. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-10.7 manpages-3.54/man7/iso_8859-10.7 --- manpages-3.52/man7/iso_8859-10.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/iso_8859-10.7 2013-09-17 08:27:58.000000000 +0200 @@ -167,7 +167,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-11.7 manpages-3.54/man7/iso_8859-11.7 --- manpages-3.52/man7/iso_8859-11.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/iso_8859-11.7 2013-09-17 08:27:58.000000000 +0200 @@ -160,7 +160,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-13.7 manpages-3.54/man7/iso_8859-13.7 --- manpages-3.52/man7/iso_8859-13.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/iso_8859-13.7 2013-09-17 08:27:58.000000000 +0200 @@ -165,7 +165,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-14.7 manpages-3.54/man7/iso_8859-14.7 --- manpages-3.52/man7/iso_8859-14.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/iso_8859-14.7 2013-09-17 08:27:58.000000000 +0200 @@ -163,7 +163,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-15.7 manpages-3.54/man7/iso_8859-15.7 --- manpages-3.52/man7/iso_8859-15.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/iso_8859-15.7 2013-09-17 08:27:58.000000000 +0200 @@ -177,7 +177,7 @@ .BR ascii (7), .BR iso_8859-1 (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-16.7 manpages-3.54/man7/iso_8859-16.7 --- manpages-3.52/man7/iso_8859-16.7 2013-07-04 12:54:02.000000000 +0200 +++ manpages-3.54/man7/iso_8859-16.7 2013-09-17 08:27:58.000000000 +0200 @@ -178,7 +178,7 @@ .UR http://bucovina.chem.tue.nl\:/fonturi\:/index-en.html .UE . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-1.7 manpages-3.54/man7/iso_8859-1.7 --- manpages-3.52/man7/iso_8859-1.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-1.7 2013-09-17 08:27:58.000000000 +0200 @@ -182,7 +182,7 @@ .BR ascii (7), .BR iso_8859-15 (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-2.7 manpages-3.54/man7/iso_8859-2.7 --- manpages-3.52/man7/iso_8859-2.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-2.7 2013-09-17 08:27:58.000000000 +0200 @@ -180,7 +180,7 @@ .UR http://sizif.mf.uni-lj.si\:/linux\:/cee\:/iso8859-2.html .UE . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-3.7 manpages-3.54/man7/iso_8859-3.7 --- manpages-3.52/man7/iso_8859-3.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-3.7 2013-09-17 08:27:58.000000000 +0200 @@ -159,7 +159,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-4.7 manpages-3.54/man7/iso_8859-4.7 --- manpages-3.52/man7/iso_8859-4.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-4.7 2013-09-17 08:27:58.000000000 +0200 @@ -162,7 +162,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-5.7 manpages-3.54/man7/iso_8859-5.7 --- manpages-3.52/man7/iso_8859-5.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-5.7 2013-09-17 08:27:58.000000000 +0200 @@ -166,7 +166,7 @@ .BR ascii (7), .BR koi8-r (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-6.7 manpages-3.54/man7/iso_8859-6.7 --- manpages-3.52/man7/iso_8859-6.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-6.7 2013-09-17 08:27:58.000000000 +0200 @@ -119,7 +119,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-7.7 manpages-3.54/man7/iso_8859-7.7 --- manpages-3.52/man7/iso_8859-7.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-7.7 2013-09-17 08:27:58.000000000 +0200 @@ -169,7 +169,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-8.7 manpages-3.54/man7/iso_8859-8.7 --- manpages-3.52/man7/iso_8859-8.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-8.7 2013-09-17 08:27:58.000000000 +0200 @@ -132,7 +132,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/iso_8859-9.7 manpages-3.54/man7/iso_8859-9.7 --- manpages-3.52/man7/iso_8859-9.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/iso_8859-9.7 2013-09-17 08:27:58.000000000 +0200 @@ -163,7 +163,7 @@ .SH SEE ALSO .BR ascii (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/koi8-r.7 manpages-3.54/man7/koi8-r.7 --- manpages-3.52/man7/koi8-r.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/koi8-r.7 2013-09-17 08:27:58.000000000 +0200 @@ -205,7 +205,7 @@ .UR http://koi8.pp.ru/ .UE .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/koi8-u.7 manpages-3.54/man7/koi8-u.7 --- manpages-3.52/man7/koi8-u.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/koi8-u.7 2013-09-17 08:27:58.000000000 +0200 @@ -191,7 +191,7 @@ .BR ascii (7), .BR koi8-r (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/libc.7 manpages-3.54/man7/libc.7 --- manpages-3.52/man7/libc.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/libc.7 2013-09-17 08:27:58.000000000 +0200 @@ -102,7 +102,7 @@ .BR man-pages (7), .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/locale.7 manpages-3.54/man7/locale.7 --- manpages-3.52/man7/locale.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/locale.7 2013-09-17 08:27:58.000000000 +0200 @@ -223,7 +223,7 @@ .BR strftime (3), .BR strxfrm (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/mailaddr.7 manpages-3.54/man7/mailaddr.7 --- manpages-3.52/man7/mailaddr.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/mailaddr.7 2013-09-17 08:27:58.000000000 +0200 @@ -125,7 +125,7 @@ RFC\ 2822 (Internet Message Format) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/man.7 manpages-3.54/man7/man.7 --- manpages-3.52/man7/man.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/man.7 2013-09-17 08:27:58.000000000 +0200 @@ -570,7 +570,7 @@ .BR mdoc (7), .BR mdoc.samples (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/man-pages.7 manpages-3.54/man7/man-pages.7 --- manpages-3.52/man7/man-pages.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/man-pages.7 2013-09-17 08:27:58.000000000 +0200 @@ -27,7 +27,7 @@ .\" 2007-05-30 created by mtk, using text from old man.7 plus .\" rewrites and additional text. .\" -.TH MAN-PAGES 7 2013-06-21 "Linux" "Linux Programmer's Manual" +.TH MAN-PAGES 7 2013-07-24 "Linux" "Linux Programmer's Manual" .SH NAME man-pages \- conventions for writing Linux man pages .SH SYNOPSIS @@ -261,6 +261,23 @@ .\" section (and just place an overview in the .\" .B DESCRIPTION .\" section). + +When describing new behavior or new flags for +a system call or library function, +be careful to note the kernel or C library version +that introduced the change. +The preferred method of noting this information for flags is as part of a +.B .TP +list, in the following form (here, for a new system call flag): +.RS 22 +.TP +.BR XYZ_FLAG " (since Linux 3.7)" +Description of flag... +.RE +.IP +Including version information is especially useful to users +who are constrained to using older kernel or C library versions +(which is typical in embedded systems, for example). .TP .B OPTIONS describes the command-line options accepted by a @@ -602,7 +619,7 @@ .BR man (7), .BR mdoc (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/math_error.7 manpages-3.54/man7/math_error.7 --- manpages-3.52/man7/math_error.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/math_error.7 2013-09-17 08:27:58.000000000 +0200 @@ -265,7 +265,7 @@ .I "info libc" .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/mdoc.7 manpages-3.54/man7/mdoc.7 --- manpages-3.52/man7/mdoc.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/mdoc.7 2013-09-17 08:27:58.000000000 +0200 @@ -431,7 +431,7 @@ .Xr man 7 , .Xr man-pages 7 .Sh COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .Em man-pages project. A description of the project, diff -Nru manpages-3.52/man7/mdoc.samples.7 manpages-3.54/man7/mdoc.samples.7 --- manpages-3.52/man7/mdoc.samples.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/mdoc.samples.7 2013-09-17 08:27:58.000000000 +0200 @@ -2955,7 +2955,7 @@ .Xr groff_mdoc 7 , .Xr mdoc 7 .Sh COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .Em man-pages project. A description of the project, diff -Nru manpages-3.52/man7/mq_overview.7 manpages-3.54/man7/mq_overview.7 --- manpages-3.52/man7/mq_overview.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/mq_overview.7 2013-09-17 08:27:58.000000000 +0200 @@ -195,11 +195,11 @@ that can be consumed by all of the message queues belonging to a process's real user ID, is described in .BR getrlimit (2). -.SS Mounting the message queue file system -On Linux, message queues are created in a virtual file system. +.SS Mounting the message queue filesystem +On Linux, message queues are created in a virtual filesystem. (Other implementations may also provide such a feature, but the details are likely to differ.) -This file system can be mounted (by the superuser) using the following +This filesystem can be mounted (by the superuser) using the following commands: .in +4n .nf @@ -211,7 +211,7 @@ .in The sticky bit is automatically enabled on the mount directory. -After the file system has been mounted, the message queues on the system +After the filesystem has been mounted, the message queues on the system can be viewed and manipulated using the commands usually used for files (e.g., .BR ls (1) @@ -292,7 +292,7 @@ .BR mq_unlink (3), .BR epoll (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/netdevice.7 manpages-3.54/man7/netdevice.7 --- manpages-3.52/man7/netdevice.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/netdevice.7 2013-09-17 08:27:58.000000000 +0200 @@ -345,7 +345,7 @@ .BR ip (7), .BR rtnetlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/netlink.7 manpages-3.54/man7/netlink.7 --- manpages-3.52/man7/netlink.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/netlink.7 2013-09-17 08:27:58.000000000 +0200 @@ -483,7 +483,7 @@ RFC 3549 "Linux Netlink as an IP Services Protocol" .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/numa.7 manpages-3.54/man7/numa.7 --- manpages-3.52/man7/numa.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/numa.7 2013-09-17 08:27:58.000000000 +0200 @@ -189,7 +189,7 @@ .BR cpuset (7), .BR numactl (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/operator.7 manpages-3.54/man7/operator.7 --- manpages-3.52/man7/operator.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/operator.7 2013-09-17 08:27:58.000000000 +0200 @@ -63,7 +63,7 @@ .fi .\" .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/packet.7 manpages-3.54/man7/packet.7 --- manpages-3.52/man7/packet.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/packet.7 2013-09-17 08:27:58.000000000 +0200 @@ -406,7 +406,7 @@ .I include file for physical layer protocols. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/path_resolution.7 manpages-3.54/man7/path_resolution.7 --- manpages-3.52/man7/path_resolution.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/path_resolution.7 2013-09-17 08:27:58.000000000 +0200 @@ -126,17 +126,17 @@ The path resolution process will assume that these entries have their conventional meanings, regardless of whether they are -actually present in the physical file system. +actually present in the physical filesystem. One cannot walk down past the root: "/.." is the same as "/". .SS Mount points After a "mount dev path" command, the pathname "path" refers to -the root of the file system hierarchy on the device "dev", and no +the root of the filesystem hierarchy on the device "dev", and no longer to whatever it referred to earlier. -One can walk out of a mounted file system: "path/.." refers to +One can walk out of a mounted filesystem: "path/.." refers to the parent directory of "path", -outside of the file system hierarchy on "dev". +outside of the filesystem hierarchy on "dev". .SS Trailing slashes If a pathname ends in a \(aq/\(aq, that forces resolution of the preceding component as in Step 2: it has to exist and resolve to a directory. @@ -189,7 +189,7 @@ changed by the system call .BR setfsuid (2). -(Here "fsuid" stands for something like "file system user ID". +(Here "fsuid" stands for something like "filesystem user ID". The concept was required for the implementation of a user space NFS server at a time when processes could send a signal to a process with the same effective user ID. @@ -197,11 +197,11 @@ Nobody should use .BR setfsuid (2).) -Similarly, Linux uses the fsgid ("file system group ID") +Similarly, Linux uses the fsgid ("filesystem group ID") instead of the effective group ID. See .BR setfsgid (2). -.\" FIXME say something about file system mounted read-only ? +.\" FIXME say something about filesystem mounted read-only ? .SS Bypassing permission checks: superuser and capabilities On a traditional UNIX system, the superuser .RI ( root , @@ -240,7 +240,7 @@ .BR credentials (7), .BR symlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/pipe.7 manpages-3.54/man7/pipe.7 --- manpages-3.52/man7/pipe.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/pipe.7 2013-09-17 08:27:58.000000000 +0200 @@ -45,8 +45,8 @@ .BR pipe (2) for an example. -A FIFO (short for First In First Out) has a name within the file -system (created using +A FIFO (short for First In First Out) has a name within the filesystem +(created using .BR mkfifo (3)), and is opened using .BR open (2). @@ -60,7 +60,7 @@ .BR fifo (7) for further details. .IR Note : -although FIFOs have a pathname in the file system, +although FIFOs have a pathname in the filesystem, I/O on FIFOs does not involve operations on the underlying device (if there is one). .SS I/O on pipes and FIFOs @@ -242,7 +242,7 @@ .BR epoll (7), .BR fifo (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/posixoptions.7 manpages-3.54/man7/posixoptions.7 --- manpages-3.52/man7/posixoptions.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/posixoptions.7 2013-09-17 08:27:58.000000000 +0200 @@ -855,7 +855,7 @@ .BR sysconf (3), .BR standards (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/pthreads.7 manpages-3.54/man7/pthreads.7 --- manpages-3.52/man7/pthreads.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/pthreads.7 2013-09-17 08:27:58.000000000 +0200 @@ -927,7 +927,7 @@ and .BR pthread_testcancel (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/pty.7 manpages-3.54/man7/pty.7 --- manpages-3.52/man7/pty.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/pty.7 2013-09-17 08:27:58.000000000 +0200 @@ -159,7 +159,7 @@ .BR tty (4), .BR tty_ioctl (4) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/raw.7 manpages-3.54/man7/raw.7 --- manpages-3.52/man7/raw.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/raw.7 2013-09-17 08:27:58.000000000 +0200 @@ -280,7 +280,7 @@ .I header file for the IP protocol. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/regex.7 manpages-3.54/man7/regex.7 --- manpages-3.52/man7/regex.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/regex.7 2013-09-17 08:27:58.000000000 +0200 @@ -289,7 +289,7 @@ .PP POSIX.2, section 2.8 (Regular Expression Notation). .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/rtld-audit.7 manpages-3.54/man7/rtld-audit.7 --- manpages-3.52/man7/rtld-audit.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/rtld-audit.7 2013-09-17 08:27:58.000000000 +0200 @@ -605,7 +605,7 @@ .BR ld.so (8), .BR ldconfig (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/rtnetlink.7 manpages-3.54/man7/rtnetlink.7 --- manpages-3.52/man7/rtnetlink.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/rtnetlink.7 2013-09-17 08:27:58.000000000 +0200 @@ -473,7 +473,7 @@ .BR ip (7), .BR netlink (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/sem_overview.7 manpages-3.54/man7/sem_overview.7 --- manpages-3.52/man7/sem_overview.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/sem_overview.7 2013-09-17 08:27:58.000000000 +0200 @@ -121,8 +121,8 @@ .I cc \-pthread to link against the real-time library, .IR librt . -.SS Accessing named semaphores via the file system -On Linux, named semaphores are created in a virtual file system, +.SS Accessing named semaphores via the filesystem +On Linux, named semaphores are created in a virtual filesystem, normally mounted under .IR /dev/shm , with names of the form @@ -160,7 +160,7 @@ .BR sem_wait (3), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/shm_overview.7 manpages-3.54/man7/shm_overview.7 --- manpages-3.52/man7/shm_overview.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/shm_overview.7 2013-09-17 08:27:58.000000000 +0200 @@ -91,13 +91,13 @@ .I cc \-lrt to link against the real-time library, .IR librt . -.SS Accessing shared memory objects via the file system +.SS Accessing shared memory objects via the filesystem On Linux, shared memory objects are created in a .RI ( tmpfs ) -virtual file system, normally mounted under +virtual filesystem, normally mounted under .IR /dev/shm . Since kernel 2.6.19, Linux supports the use of access control lists (ACLs) -to control the permissions of objects in the virtual file system. +to control the permissions of objects in the virtual filesystem. .SH CONFORMING TO POSIX.1-2001. .SH NOTES @@ -125,7 +125,7 @@ .BR shm_unlink (3), .BR sem_overview (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/sigevent.7 manpages-3.54/man7/sigevent.7 --- manpages-3.52/man7/sigevent.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/sigevent.7 2013-09-17 08:27:58.000000000 +0200 @@ -140,7 +140,7 @@ .BR aio (7), .BR pthreads (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/signal.7 manpages-3.54/man7/signal.7 --- manpages-3.52/man7/signal.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/signal.7 2013-09-17 08:27:58.000000000 +0200 @@ -43,7 +43,7 @@ .\" Added section on stop/cont signals interrupting syscalls. .\" 2008-10-05, mtk: various additions .\" -.TH SIGNAL 7 2012-05-01 "Linux" "Linux Programmer's Manual" +.TH SIGNAL 7 2013-07-30 "Linux" "Linux Programmer's Manual" .SH NAME signal \- overview of signals .SH DESCRIPTION @@ -852,6 +852,7 @@ .BR getrlimit (2), .BR kill (2), .BR killpg (2), +.BR restart_syscall (2), .BR rt_sigqueueinfo (2), .BR setitimer (2), .BR setrlimit (2), @@ -881,7 +882,7 @@ .BR pthreads (7), .BR sigevent (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/socket.7 manpages-3.54/man7/socket.7 --- manpages-3.52/man7/socket.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/socket.7 2013-09-17 08:27:58.000000000 +0200 @@ -456,7 +456,7 @@ the byte offset specified by the option value. At the same time, the "peek offset" will be incremented by the number of bytes that were peeked from the queue, -so that a subsequent peek will return the next data in the queue.i +so that a subsequent peek will return the next data in the queue. If data is removed from the front of the queue via a call to .BR recv (2) @@ -923,7 +923,7 @@ .BR udp (7), .BR unix (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/spufs.7 manpages-3.54/man7/spufs.7 --- manpages-3.52/man7/spufs.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/spufs.7 2013-09-17 08:27:58.000000000 +0200 @@ -26,16 +26,16 @@ .\" .TH SPUFS 7 2007-12-20 Linux "Linux Programmer's Manual" .SH NAME -spufs \- SPU file system +spufs \- SPU filesystem .SH DESCRIPTION -The SPU file system is used on PowerPC machines that implement the +The SPU filesystem is used on PowerPC machines that implement the Cell Broadband Engine Architecture in order to access Synergistic Processor Units (SPUs). -The file system provides a name space similar to POSIX shared +The filesystem provides a name space similar to POSIX shared memory or message queues. Users that have write permissions -on the file system can use +on the filesystem can use .BR spu_create (2) to establish SPU contexts under the .B spufs @@ -68,7 +68,7 @@ or .BR write (2), but often support only a subset of the operations -supported on regular file systems. +supported on regular filesystems. This list details the supported operations and the deviations from the standard behavior described in the respective man pages. @@ -771,7 +771,7 @@ .I The Cell Broadband Engine Architecture (CBEA) specification .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/standards.7 manpages-3.54/man7/standards.7 --- manpages-3.52/man7/standards.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/standards.7 2013-09-17 08:27:58.000000000 +0200 @@ -23,7 +23,7 @@ .\" . .\" %%%LICENSE_END .\" -.TH STANDARDS 7 2012-08-05 "Linux" "Linux Programmer's Manual" +.TH STANDARDS 7 2013-09-06 "Linux" "Linux Programmer's Manual" .SH NAME standards \- C and UNIX Standards .SH DESCRIPTION @@ -261,6 +261,11 @@ lists POSIX.1-2001, it can be assumed that the interface also conforms to POSIX.1-2008, unless otherwise noted. +Technical Corrigenda 1 (minor fixes and improvements) +of this standard was released in 2013 +(referred to as +.IR POSIX.1-2013 ). + Further information can be found on the Austin group web site, .UR http://www.opengroup.org\:/austin/ .UE . @@ -269,7 +274,7 @@ .BR libc (7), .BR posixoptions (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/suffixes.7 manpages-3.54/man7/suffixes.7 --- manpages-3.52/man7/suffixes.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/suffixes.7 2013-09-17 08:27:58.000000000 +0200 @@ -282,7 +282,7 @@ .BR file (1), .BR make (1) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/svipc.7 manpages-3.54/man7/svipc.7 --- manpages-3.52/man7/svipc.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/svipc.7 2013-09-17 08:27:58.000000000 +0200 @@ -346,7 +346,7 @@ .BR shmget (2), .BR ftok (3) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/symlink.7 manpages-3.54/man7/symlink.7 --- manpages-3.52/man7/symlink.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/symlink.7 2013-09-17 08:27:58.000000000 +0200 @@ -47,22 +47,22 @@ the same .IR "i-node number" , where an i-node number is an index into the i-node table, -which contains metadata about all files on a file system. +which contains metadata about all files on a filesystem. See .BR stat (2).) Changes to a file are independent of the name used to reference the file. Hard links may not refer to directories -(to prevent the possibility of loops within the file system tree, +(to prevent the possibility of loops within the filesystem tree, which would confuse many programs) -and may not refer to files on different file systems -(because i-node numbers are not unique across file systems). +and may not refer to files on different filesystems +(because i-node numbers are not unique across filesystems). A symbolic link is a special type of file whose contents are a string that is the pathname another file, the file to which the link refers. In other words, a symbolic link is a pointer to another name, and not to an underlying object. For this reason, symbolic links may refer to directories and may cross -file system boundaries. +filesystem boundaries. There is no requirement that the pathname referred to by a symbolic link should exist. @@ -70,7 +70,7 @@ to be a .IR "dangling link" . -Because a symbolic link and its referenced object coexist in the file system +Because a symbolic link and its referenced object coexist in the filesystem name space, confusion can arise in distinguishing between the link itself and the referenced object. On historical systems, @@ -487,7 +487,7 @@ .BR lutimes (3), .BR path_resolution (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/tcp.7 manpages-3.54/man7/tcp.7 --- manpages-3.52/man7/tcp.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/tcp.7 2013-09-17 08:27:58.000000000 +0200 @@ -1192,7 +1192,7 @@ .br RFC\ 2018 and RFC\ 2883 for SACK and extensions to SACK. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/termio.7 manpages-3.54/man7/termio.7 --- manpages-3.52/man7/termio.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/termio.7 2013-09-17 08:27:58.000000000 +0200 @@ -64,7 +64,7 @@ .BR tty (4), .BR tty_ioctl (4) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/time.7 manpages-3.54/man7/time.7 --- manpages-3.52/man7/time.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/time.7 2013-09-17 08:27:58.000000000 +0200 @@ -218,7 +218,7 @@ .BR rtc (4), .BR hwclock (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/udp.7 manpages-3.54/man7/udp.7 --- manpages-3.52/man7/udp.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/udp.7 2013-09-17 08:27:58.000000000 +0200 @@ -9,13 +9,15 @@ .\" .\" $Id: udp.7,v 1.7 2000/01/22 01:55:05 freitag Exp $ .\" -.TH UDP 7 2013-06-21 "Linux" "Linux Programmer's Manual" +.TH UDP 7 2013-07-31 "Linux" "Linux Programmer's Manual" .SH NAME udp \- User Datagram Protocol for IPv4 .SH SYNOPSIS .B #include .br .B #include +.br +.B #include .sp .B udp_socket = socket(AF_INET, SOCK_DGRAM, 0); .SH DESCRIPTION @@ -263,7 +265,7 @@ .br RFC\ 1191 for a description of path MTU discovery. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/udplite.7 manpages-3.54/man7/udplite.7 --- manpages-3.52/man7/udplite.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/udplite.7 2013-09-17 08:27:58.000000000 +0200 @@ -154,7 +154,7 @@ .I Documentation/networking/udplite.txt in the Linux kernel source tree .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/unicode.7 manpages-3.54/man7/unicode.7 --- manpages-3.52/man7/unicode.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/unicode.7 2013-09-17 08:27:58.000000000 +0200 @@ -312,7 +312,7 @@ .BR charsets (7), .BR utf-8 (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/units.7 manpages-3.54/man7/units.7 --- manpages-3.52/man7/units.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/units.7 2013-09-17 08:27:58.000000000 +0200 @@ -128,7 +128,7 @@ the MB are megabytes and the KiB are kibibytes. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/unix.7 manpages-3.54/man7/unix.7 --- manpages-3.52/man7/unix.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/unix.7 2013-09-17 08:27:58.000000000 +0200 @@ -34,9 +34,9 @@ socket family is used to communicate between processes on the same machine efficiently. Traditionally, UNIX domain sockets can be either unnamed, -or bound to a file system pathname (marked as being of type socket). +or bound to a filesystem pathname (marked as being of type socket). Linux also supports an abstract namespace which is independent of the -file system. +filesystem. Valid types are: .BR SOCK_STREAM , @@ -82,7 +82,9 @@ and .BR accept (2), its length is -.IR "offsetof(struct sockaddr_un, sun_path) + strlen(sun_path) + 1" , + + offsetof(struct sockaddr_un, sun_path) + strlen(sun_path) + 1 + and .I sun_path contains the null-terminated pathname. @@ -116,7 +118,7 @@ .IR sun_path that are covered by the specified length of the address structure. (Null bytes in the name have no special significance.) -The name has no connection with file system pathnames. +The name has no connection with filesystem pathnames. When the address of an abstract socket is returned by .BR getsockname (2), .BR getpeername (2), @@ -320,7 +322,7 @@ .SH ERRORS .TP .B EADDRINUSE -The specified local address is already in use or the file system socket +The specified local address is already in use or the filesystem socket object already exists. .TP .B ECONNREFUSED @@ -394,7 +396,7 @@ Unknown socket type. .PP Other errors can be generated by the generic socket layer or -by the file system while generating a file system socket object. +by the filesystem while generating a filesystem socket object. See the appropriate manual pages for more information. .SH VERSIONS .B SCM_CREDENTIALS @@ -404,7 +406,7 @@ but the implementation details differ.) .SH NOTES In the Linux implementation, sockets which are visible in the -file system honor the permissions of the directory they are in. +filesystem honor the permissions of the directory they are in. Their owner, group and their permissions can be changed. Creation of a new socket will fail if the process does not have write and search (execute) permission on the directory the socket is created in. @@ -415,11 +417,11 @@ this feature for security. Binding to a socket with a filename creates a socket -in the file system that must be deleted by the caller when it is no +in the filesystem that must be deleted by the caller when it is no longer needed (using .BR unlink (2)). The usual UNIX close-behind semantics apply; the socket can be unlinked -at any time and will be finally removed from the file system when the last +at any time and will be finally removed from the filesystem when the last reference to it is closed. To pass file descriptors or credentials over a @@ -450,7 +452,7 @@ .BR credentials (7), .BR socket (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/uri.7 manpages-3.54/man7/uri.7 --- manpages-3.52/man7/uri.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/uri.7 2013-09-17 08:27:58.000000000 +0200 @@ -685,11 +685,11 @@ (though filename globbing could partially overcome this). Finally, using the file: scheme doesn't easily support people who dynamically load documentation from the Internet (instead of -loading the files onto a local file system). +loading the files onto a local filesystem). A future URI scheme may be added (e.g., "userdoc:") to permit programs to include cross-references to more detailed documentation without having to know the exact location of that documentation. -Alternatively, a future version of the file-system specification may +Alternatively, a future version of the filesystem specification may specify file locations sufficiently so that the file: scheme will be able to locate documentation. .PP @@ -713,7 +713,7 @@ IETF RFC\ 2255 .UE .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/utf-8.7 manpages-3.54/man7/utf-8.7 --- manpages-3.52/man7/utf-8.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/utf-8.7 2013-09-17 08:27:58.000000000 +0200 @@ -296,7 +296,7 @@ .BR charsets (7), .BR unicode (7) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man7/x25.7 manpages-3.54/man7/x25.7 --- manpages-3.52/man7/x25.7 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man7/x25.7 2013-09-17 08:27:58.000000000 +0200 @@ -125,7 +125,7 @@ .UR ftp://ftp.pspt.fi\:/pub\:/ham\:/linux\:/ax25\:/x25doc.tgz .UE . .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/intro.8 manpages-3.54/man8/intro.8 --- manpages-3.52/man8/intro.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/intro.8 2013-09-17 08:27:58.000000000 +0200 @@ -47,7 +47,7 @@ conditions. Note that these can be different from page to page! .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/ldconfig.8 manpages-3.54/man8/ldconfig.8 --- manpages-3.52/man8/ldconfig.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/ldconfig.8 2013-09-17 08:27:58.000000000 +0200 @@ -176,7 +176,7 @@ .BR ldd (1), .BR ld.so (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/ld.so.8 manpages-3.54/man8/ld.so.8 --- manpages-3.52/man8/ld.so.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/ld.so.8 2013-09-17 08:27:58.000000000 +0200 @@ -2,7 +2,7 @@ .\" This is in the public domain .\" %%%LICENSE_END .\" -.TH LD.SO 8 2013-02-10 "GNU" "Linux Programmer's Manual" +.TH LD.SO 8 2013-07-15 "GNU" "Linux Programmer's Manual" .SH NAME ld.so, ld-linux.so* \- dynamic linker/loader .SH SYNOPSIS @@ -85,19 +85,20 @@ If the binary was linked with the .B \-z nodeflib linker option, this step is skipped. -.SS $ORIGIN and rpath +.SS Rpath token expansion .PP .B ld.so -understands the string -.I $ORIGIN -(or equivalently -.IR ${ORIGIN} ) -in an rpath specification (DT_RPATH or DT_RUNPATH) to mean +understands certain strings in an rpath specification (DT_RPATH or DT_RUNPATH); those strings are substituted as follows +.TP +.IR $ORIGIN " (or equivalently " ${ORIGIN} ) +This expands to the directory containing the application executable. Thus, an application located in .I somedir/app could be compiled with -.I gcc -Wl,-rpath,\(aq$ORIGIN/../lib\(aq + + gcc \-Wl,\-rpath,\(aq$ORIGIN/../lib\(aq + so that it finds an associated shared library in .I somedir/lib no matter where @@ -107,16 +108,33 @@ do not need to be installed into special directories, but can instead be unpacked into any directory and still find their own shared libraries. -.\" ld.so also understands $LIB, with the same meaning as $ORIGIN/lib, -.\" it appears. -.\" -.\" There is also $PLATFORM. This is a kind of wildcard -.\" of directories related to AT_PLATFORM. To get an idea of the -.\" places that $PLATFORM would match, look at the output of the -.\" following: +.TP +.IR $LIB " (or equivalently " ${LIB} ) +This expands to +.I lib +or +.I lib64 +depending on the architecture +(e.g., on x86-64, it expands to +.IR lib64 +and +on x86-32, it expands to +.IR lib ). +.TP +.IR $PLATFORM " (or equivalently " ${PLATFORM} ) +This expands to a string corresponding to the processor type +of the host system (e.g., "x86_64"). +On some architectures, the Linux kernel doesn't provide a platform +string to the dynamic linker. +The value of this string is taken from the +.BR AT_PLATFORM +value in the auxiliary vector (see +.BR getauxval (3)). +.\" To get an idea of the places that $PLATFORM would match, +.\" look at the output of the following: .\" -.\" mkdir /tmp/d -.\" LD_LIBRARY_PATH=/tmp/d strace -e open /bin/date 2>&1 | grep /tmp/d +.\" mkdir /tmp/d +.\" LD_LIBRARY_PATH=/tmp/d strace -e open /bin/date 2>&1 | grep /tmp/d .\" .\" ld.so lets names be abbreviated, so $O will work for $ORIGIN; .\" Don't do this!! @@ -178,6 +196,54 @@ .SH ENVIRONMENT There are four important environment variables. .TP +.B LD_ASSUME_KERNEL +(glibc since 2.2.3) +Each shared library can inform the dynamic linker of the minimum kernel ABI +version that it requires. +(This requirement is encoded in an ELF note section that is viewable via +.IR "readelf\ \-n" +as a section labeled +.BR NT_GNU_ABI_TAG .) +At run time, +the dynamic linker determines the ABI version of the running kernel and +will reject loading shared libraries that specify minimum ABI versions +that exceed that ABI version. + +.BR LD_ASSUME_KERNEL +can be used to +cause the dynamic linker to assume that it is running on a system with +a different kernel ABI version. +For example, the following command line causes the +dynamic linker to assume it is running on Linux 2.2.5 when loading +the shared libraries required by +.IR myprog : + +.in +4n +.nf +$ \fBLD_ASSUME_KERNEL=2.2.5 ./myprog\fP +.fi +.in + +On systems that provide multiple versions of a shared library +(in different directories in the search path) that have +different minimum kernel ABI version requirements, +.BR LD_ASSUME_KERNEL +can be used to select the version of the library that is used +(dependent on the directory search order). +Historically, the most common use of the +.BR LD_ASSUME_KERNEL +feature was to manually select the older +LinuxThreads POSIX threads implementation on systems that provided both +LinuxThreads and NPTL +(which latter was typically the default on such systems); +see +.BR pthreads (7). +.TP +.B LD_BIND_NOT +(glibc since 2.2) +Don't update the Global Offset Table (GOT) and Procedure Linkage Table (PLT) +when resolving a symbol. +.TP .B LD_BIND_NOW (libc5; glibc since 2.1.1) If set to a nonempty string, @@ -274,9 +340,10 @@ .TP .B LD_DEBUG_OUTPUT (glibc since 2.1) -File where +File in which .B LD_DEBUG -output should be fed into, default is standard output. +output should be written. +The default is standard output. .B LD_DEBUG_OUTPUT is ignored for set-user-ID/set-group-ID binaries. .TP @@ -376,9 +443,9 @@ (glibc since 2.1) If set to a nonempty string, output symbol versioning information about the -program if +program if the .B LD_TRACE_LOADED_OBJECTS -variable has been set. +environment variable has been set. .TP .B LD_WARN (ELF only)(glibc since 2.1.3) @@ -418,10 +485,10 @@ ELF functionality is available since Linux 1.1.52 and libc5. .SH SEE ALSO .BR ldd (1), -.BR sln (1), .BR getauxval (3), .BR rtld-audit (7), -.BR ldconfig (8) +.BR ldconfig (8), +.BR sln (8) .\" .SH AUTHORS .\" ld.so: David Engel, Eric Youngdale, Peter MacDonald, Hongjiu Lu, Linus .\" Torvalds, Lars Wirzenius and Mitch D'Souza @@ -429,7 +496,7 @@ .\" .\" In the above, (libc5) stands for David Engel's ld.so/ld-linux.so. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/nscd.8 manpages-3.54/man8/nscd.8 --- manpages-3.52/man8/nscd.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/nscd.8 2013-09-17 08:27:58.000000000 +0200 @@ -89,7 +89,7 @@ .\" .B nscd .\" was written by Thorsten Kukuk and Ulrich Drepper. .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/sln.8 manpages-3.54/man8/sln.8 --- manpages-3.52/man8/sln.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/sln.8 2013-09-17 08:27:58.000000000 +0200 @@ -62,7 +62,7 @@ .BR ldconfig (8), .BR ld.so (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/sync.8 manpages-3.54/man8/sync.8 --- manpages-3.52/man8/sync.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/sync.8 2013-09-17 08:27:58.000000000 +0200 @@ -27,7 +27,7 @@ The kernel keeps data in memory to avoid doing (relatively slow) disk reads and writes. This improves performance, but if the computer -crashes, data may be lost or the file system corrupted as a result. +crashes, data may be lost or the filesystem corrupted as a result. .B sync ensures that everything in memory is written to disk. .PP @@ -92,7 +92,7 @@ .BR reboot (8), .BR update (8) .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/tzselect.8 manpages-3.54/man8/tzselect.8 --- manpages-3.52/man8/tzselect.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/tzselect.8 2013-09-17 08:27:58.000000000 +0200 @@ -50,7 +50,7 @@ .BR zic (8) .\" @(#)tzselect.8 1.3 .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/zdump.8 manpages-3.54/man8/zdump.8 --- manpages-3.52/man8/zdump.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/zdump.8 2013-09-17 08:27:58.000000000 +0200 @@ -58,7 +58,7 @@ .BR zic (8) .\" @(#)zdump.8 7.3 .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man8/zic.8 manpages-3.54/man8/zic.8 --- manpages-3.52/man8/zic.8 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/man8/zic.8 2013-09-17 08:27:58.000000000 +0200 @@ -420,7 +420,7 @@ .BR zdump (8) .\" @(#)zic.8 7.19 .SH COLOPHON -This page is part of release 3.52 of the Linux +This page is part of release 3.54 of the Linux .I man-pages project. A description of the project, diff -Nru manpages-3.52/man-pages-3.52.Announce manpages-3.54/man-pages-3.52.Announce --- manpages-3.52/man-pages-3.52.Announce 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/man-pages-3.52.Announce 1970-01-01 01:00:00.000000000 +0100 @@ -1,62 +0,0 @@ -RELEASE -The Linux man page maintainer proudly announces. . . - - man-pages-3.52.tar.gz - man pages for Linux - -Differences from the previous manual pages release are listed in -the file "Changes". - -For further information, visit http://www.kernel.org/doc/man-pages/ - -POSIX PAGES -This package used to contains a copy of the POSIX 1003.1-2003 -man pages. The POSIX pages are now distributed in the separate -man-pages-posix package. - -THE PAGES -These pages are most of the section 2, 3, 4, 5, 7 man pages -for Linux. A few pages are provided in sections 1 and 8 for commands -that are not documented in other packages, and there are a few pages -in sections 5 and 8 for the timezone utilities. - -[The timezone pages were taken from -ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.] -[The section 3 man pages for the db routines have been taken from -ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.] -[The rpc man pages were taken from the 4.4BSD-Lite CDROM.] - -Here is a breakdown of what this distribution contains: - - Section 1 = user commands (intro, plus a few other pages) - Section 2 = system calls - Section 3 = libc calls - Section 4 = devices (e.g., hd, sd) - Section 5 = file formats and protocols (e.g., wtmp, /etc/passwd, nfs) - Section 6 = games (intro only) - Section 7 = overviews, conventions, macro packages, etc. - Section 8 = system administration (intro, plus a few other pages) - - This package contains no, or very few, section 1, 6, and 8 man pages - because these should be distributed with the binaries they are written - for. Sometimes Section 9 is used for man pages describing parts of - the kernel. - - Note that only Section 2 is rather complete, but Section 3 contains - several hundred man pages. If you want to write some man pages, - or suggest improvments to existing pages, please visit - http://www.kernel.org/doc/man-pages/ . - - -Copyright information: - - These man pages are distributed under a variety of copyright licenses. - Although these licenses permit free distribution of the nroff sources - contained in this package, commercial distribution may impose other - requirements (e.g., acknowledgement of copyright or inclusion of the - raw nroff sources with the commercial distribution). - If you distribute these man pages commercially, it is your - responsibility to figure out your obligations. (For many man pages, - these obligations require you to distribute nroff sources with any - pre-formatted man pages that you provide.) Each file that contains - nroff source for a man page also contains the author(s) name, email - address, and copyright notice. diff -Nru manpages-3.52/man-pages-3.52.lsm manpages-3.54/man-pages-3.52.lsm --- manpages-3.52/man-pages-3.52.lsm 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/man-pages-3.52.lsm 1970-01-01 01:00:00.000000000 +0100 @@ -1,14 +0,0 @@ -Begin3 -Title: Section 2, 3, 4, 5 and 7 man pages for Linux -Version: 3.52 -Entered-date: 2013-07-04 -Description: Linux manual pages -Keywords: man pages -Author: several -Maintained-by: Michael Kerrisk -Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages - 1850k man-pages-3.52.tar.gz -Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages -Copying-policy: several; the pages are all freely distributable as long as - nroff source is provided -End diff -Nru manpages-3.52/man-pages-3.54.Announce manpages-3.54/man-pages-3.54.Announce --- manpages-3.52/man-pages-3.54.Announce 1970-01-01 01:00:00.000000000 +0100 +++ manpages-3.54/man-pages-3.54.Announce 2013-09-17 08:27:55.000000000 +0200 @@ -0,0 +1,62 @@ +RELEASE +The Linux man page maintainer proudly announces. . . + + man-pages-3.54.tar.gz - man pages for Linux + +Differences from the previous manual pages release are listed in +the file "Changes". + +For further information, visit http://www.kernel.org/doc/man-pages/ + +POSIX PAGES +This package used to contains a copy of the POSIX 1003.1-2003 +man pages. The POSIX pages are now distributed in the separate +man-pages-posix package. + +THE PAGES +These pages are most of the section 2, 3, 4, 5, 7 man pages +for Linux. A few pages are provided in sections 1 and 8 for commands +that are not documented in other packages, and there are a few pages +in sections 5 and 8 for the timezone utilities. + +[The timezone pages were taken from +ftp://elsie.nci.nih.gov/pub/tzcode2001a.tar.gz.] +[The section 3 man pages for the db routines have been taken from +ftp://ftp.terra.net/pub/sleepycat/db.1.86.tar.gz.] +[The rpc man pages were taken from the 4.4BSD-Lite CDROM.] + +Here is a breakdown of what this distribution contains: + + Section 1 = user commands (intro, plus a few other pages) + Section 2 = system calls + Section 3 = libc calls + Section 4 = devices (e.g., hd, sd) + Section 5 = file formats and protocols (e.g., wtmp, /etc/passwd, nfs) + Section 6 = games (intro only) + Section 7 = overviews, conventions, macro packages, etc. + Section 8 = system administration (intro, plus a few other pages) + + This package contains no, or very few, section 1, 6, and 8 man pages + because these should be distributed with the binaries they are written + for. Sometimes Section 9 is used for man pages describing parts of + the kernel. + + Note that only Section 2 is rather complete, but Section 3 contains + several hundred man pages. If you want to write some man pages, + or suggest improvments to existing pages, please visit + http://www.kernel.org/doc/man-pages/ . + + +Copyright information: + + These man pages are distributed under a variety of copyright licenses. + Although these licenses permit free distribution of the nroff sources + contained in this package, commercial distribution may impose other + requirements (e.g., acknowledgement of copyright or inclusion of the + raw nroff sources with the commercial distribution). + If you distribute these man pages commercially, it is your + responsibility to figure out your obligations. (For many man pages, + these obligations require you to distribute nroff sources with any + pre-formatted man pages that you provide.) Each file that contains + nroff source for a man page also contains the author(s) name, email + address, and copyright notice. diff -Nru manpages-3.52/man-pages-3.54.lsm manpages-3.54/man-pages-3.54.lsm --- manpages-3.52/man-pages-3.54.lsm 1970-01-01 01:00:00.000000000 +0100 +++ manpages-3.54/man-pages-3.54.lsm 2013-09-17 08:27:55.000000000 +0200 @@ -0,0 +1,14 @@ +Begin3 +Title: Section 2, 3, 4, 5 and 7 man pages for Linux +Version: 3.54 +Entered-date: 2013-09-17 +Description: Linux manual pages +Keywords: man pages +Author: several +Maintained-by: Michael Kerrisk +Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages + 1865k man-pages-3.54.tar.gz +Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages +Copying-policy: several; the pages are all freely distributable as long as + nroff source is provided +End diff -Nru manpages-3.52/proj.man-pages.desc manpages-3.54/proj.man-pages.desc --- manpages-3.52/proj.man-pages.desc 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/proj.man-pages.desc 2013-09-17 08:27:58.000000000 +0200 @@ -1 +1 @@ -man-pages|Linux kernel and C library user-space interface documentation|https://www.kernel.org/doc/man-pages/|REPO|Git|https://www.kernel.org/doc/man-pages/index.html|https://www.kernel.org/doc/man-pages/reporting_bugs.html|2013-07-04 +man-pages|Linux kernel and C library user-space interface documentation|https://www.kernel.org/doc/man-pages/|REPO|Git|https://www.kernel.org/doc/man-pages/index.html|https://www.kernel.org/doc/man-pages/reporting_bugs.html|2013-09-17 diff -Nru manpages-3.52/proj.man-pages.pages manpages-3.54/proj.man-pages.pages --- manpages-3.52/proj.man-pages.pages 2013-07-04 12:54:03.000000000 +0200 +++ manpages-3.54/proj.man-pages.pages 2013-09-17 08:27:58.000000000 +0200 @@ -177,6 +177,7 @@ man2/syncfs.2 man2/accept.2 man2/setgroups32.2 +man2/restart_syscall.2 man2/sched_get_priority_max.2 man2/preadv.2 man2/llseek.2 diff -Nru manpages-3.52/scripts/add_parens_for_own_funcs.sh manpages-3.54/scripts/add_parens_for_own_funcs.sh --- manpages-3.52/scripts/add_parens_for_own_funcs.sh 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/scripts/add_parens_for_own_funcs.sh 2013-09-17 08:27:55.000000000 +0200 @@ -53,6 +53,19 @@ # ###################################################################### # +# (C) Copyright 2005 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# +# # file_base="tmp.$(basename $0)" diff -Nru manpages-3.52/scripts/find_dots_no_parens.sh manpages-3.54/scripts/find_dots_no_parens.sh --- manpages-3.52/scripts/find_dots_no_parens.sh 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/scripts/find_dots_no_parens.sh 2013-09-17 08:27:55.000000000 +0200 @@ -18,6 +18,21 @@ # # cd man-pages-x.yy # sh find_dots_no_parens.sh . man?/*.? > matches.log +# +###################################################################### +# +# (C) Copyright 2005 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# if test $# -lt 2; then echo "Usage: $0 man-page-root-dir file file..." 1>&2 diff -Nru manpages-3.52/scripts/find_repeated_words.sh manpages-3.54/scripts/find_repeated_words.sh --- manpages-3.52/scripts/find_repeated_words.sh 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/scripts/find_repeated_words.sh 2013-09-17 08:27:55.000000000 +0200 @@ -1,11 +1,28 @@ #!/bin/sh # +# find_repeated_words.sh +# # A simple script for finding instances of repeated consecutive words # in manual pages -- human inspection can then determine if these # are real errors in the text. # # Usage: sh find_repeated_words.sh [file...] # +###################################################################### +# +# (C) Copyright 2007 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# +# for file in "$@" ; do words=$(MANWIDTH=2000 man -l "$file" 2> /dev/null | col -b | \ diff -Nru manpages-3.52/scripts/find_slashes_no_parens.sh manpages-3.54/scripts/find_slashes_no_parens.sh --- manpages-3.52/scripts/find_slashes_no_parens.sh 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/scripts/find_slashes_no_parens.sh 2013-09-17 08:27:55.000000000 +0200 @@ -18,6 +18,21 @@ # # cd man-pages-x.yy # sh find_slashes_no_parens.sh . man?/*.? > matches.log +# +###################################################################### +# +# (C) Copyright 2005 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# if test $# -lt 2; then echo "Usage: $0 man-page-root-dir file file..." 1>&2 diff -Nru manpages-3.52/scripts/FIXME_list.sh manpages-3.54/scripts/FIXME_list.sh --- manpages-3.52/scripts/FIXME_list.sh 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/scripts/FIXME_list.sh 2013-09-17 08:27:55.000000000 +0200 @@ -1,8 +1,36 @@ #!/bin/sh +# # FIXME_list.sh # # Display FIXME segments from man-pages source files # +# (C) Copyright 2007 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# +###################################################################### +# +# (C) Copyright 2006 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# +# show_all="n" while getopts "a" optname; do diff -Nru manpages-3.52/scripts/remove_COLOPHON.sh manpages-3.54/scripts/remove_COLOPHON.sh --- manpages-3.52/scripts/remove_COLOPHON.sh 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/scripts/remove_COLOPHON.sh 2013-09-17 08:27:55.000000000 +0200 @@ -8,6 +8,21 @@ # in order to do a "diff -ruN" to see the "real" differences between # the trees.) # +###################################################################### +# +# (C) Copyright 2008 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# +# for f in "$@"; do sed -i '/^\.SH COLOPHON/,$d' "$f" done diff -Nru manpages-3.52/scripts/unformat_parens.sh manpages-3.54/scripts/unformat_parens.sh --- manpages-3.52/scripts/unformat_parens.sh 2013-07-04 12:53:59.000000000 +0200 +++ manpages-3.54/scripts/unformat_parens.sh 2013-09-17 08:27:55.000000000 +0200 @@ -20,6 +20,19 @@ # ###################################################################### # +# (C) Copyright 2005 & 2013, Michael Kerrisk +# This program is free software; you can redistribute it and/or +# modify it under the terms of the GNU General Public License +# as published by the Free Software Foundation; either version 2 +# of the License, or (at your option) any later version. +# +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details +# (http://www.gnu.org/licenses/gpl-2.0.html). +# +# file_base="tmp.$(basename $0)"