==================== Changes in man-pages-3.63 ==================== Released: 2014-03-18, 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: Carlos O'Donell Christoph Hellwig Corrado Zoccolo Gregory P. Smith Joseph S. Myers Michael Kerrisk Mike Frysinger Peng Haitao Phillip Susi Robert P. J. Day Stefan Puiu Zhu Yanhai Apologies if I missed anyone! New and rewritten pages ----------------------- duplocale.3 Michael Kerrisk New page documenting duplocale(3) newlocale.3 Michael Kerrisk [Mike Frysinger] New page documenting newlocale(3) and freelocale(3) towlower.3 Michael Kerrisk Largely rewrite description of towlower() to be simpler and clearer towupper.3 Michael Kerrisk Largely rewrite description of towupper() to be simpler and clearer uselocale.3 Michael Kerrisk New page documenting uselocale(3) Newly documented interfaces in existing pages --------------------------------------------- open.2 Michael Kerrisk Document O_DSYNC and rewrite discussion of O_SYNC isalpha.3 Michael Kerrisk Document the "_l" locale APIs The GNU C library v2.3 added some locale APIs, most of which were later specified in POSIX.1-2008, namely: isalnum_l() isalpha_l() isblank_l() iscntrl_l() isdigit_l() isgraph_l() islower_l() isprint_l() ispunct_l() isspace_l() isupper_l() isxdigit_l() isascii_l() Also update and correct various pieces in CONFORMING TO (and remove a few crufty old pieces there). strerror.3 Michael Kerrisk Document strerror_l() toupper.3 Michael Kerrisk Document toupper_l() and tolower_l() towlower.3 Michael Kerrisk Document towlower_l() towupper.3 Michael Kerrisk Document towupper_l() proc.5 Michael Kerrisk Document /proc/sys/kernel/random/uuid locale.7 Michael Kerrisk Document LC_ADDRESS Michael Kerrisk Document LC_IDENTIFICATION Michael Kerrisk Document LC_MEASUREMENT Michael Kerrisk Document LC_NAME Michael Kerrisk Document LC_PAPER Michael Kerrisk Document LC_TELEPHONE New and changed links --------------------- freelocale.3 Michael Kerrisk New link to new newlocale.3 page isalnum_l.3 isascii_l.3 isblank_l.3 iscntrl_l.3 isdigit_l.3 isgraph_l.3 islower_l.3 isprint_l.3 ispunct_l.3 isspace_l.3 isupper_l.3 isxdigit_l.3 Michael Kerrisk New links to isalpha.3 tolower_l.3 toupper_l.3 Michael Kerrisk New links to toupper.3 towlower_l.3 Michael Kerrisk New link to towlower.3 towupper_l.3 Michael Kerrisk New link to towupper.3 Global changes -------------- Various pages Michael Kerrisk Global change: "upper case" ==> "uppercase", "lower case" ==> lowercase" Changes to individual pages --------------------------- mount.2 Michael Kerrisk SEE ALSO: add blkid(1) msgop.2 Michael Kerrisk Document two MSG_COPY failure modes Since Linux 3.14, the kernel now diagnoses two errors when using msgrcv() MSG_COPY: * MSG_COPY must be specified with IPC_NOWAIT * MSG_COPY can't be specified with MSG_EXCEPT open.2 Michael Kerrisk Organize some material under additional subheadings in NOTES There's an amorphous mass of material under NOTES. Structure it with some subheadings, and do a little reorganizing. Michael Kerrisk Add other system calls and functions that are like openat() fanotify_mark(2), name_to_handle_at(2), and scandirat(3) have a directory file descriptor argument for the same reason as openat(). Also: reword the rationale for the *at() functions somewhat. Michael Kerrisk Clarify ELOOP error interaction with O_PATH readahead.2 Phillip Susi [Corrado Zoccolo, Gregory P. Smith, Zhu Yanhai, Michael Kerrisk, Christoph Hellwig] Don't claim the call blocks until all data has been read The readahead(2) man page was claiming that the call blocks until all data has been read into the cache. This is incorrect. See https://bugzilla.kernel.org/show_bug.cgi?id=54271 stat.2 Michael Kerrisk SEE ALSO: add ls(1) and stat(1) fts.3 Christoph Hellwig [Michael Kerrisk] The fts(3) API does not work with LFS builds As pointed out during a recent discussion on libc-hacker the fts(3) APIs can't be used with large file offsets: https://sourceware.org/bugzilla/show_bug.cgi?id=15838 mbrtowc.3 mbsnrtowcs.3 mbsrtowcs.3 mbtowc.3 Michael Kerrisk Add entries in SEE ALSO Mainly inspired by the POSIX pages. mbsinit.3 Michael Kerrisk SEE ALSO: add mbrlen(3), mbrtowc(3), and wcrtomb(3) mbsrtowcs.3 wcsrtombs.3 Michael Kerrisk SEE ALSO: add mbsinit(3) mbstowcs.3 Michael Kerrisk [Stefan Puiu] Add example program And add some SEE ALSO entries memcmp.3 Peng Haitao ATTRIBUTES: Note function that is thread-safe The function memcmp() is thread safe. memcpy.3 Peng Haitao ATTRIBUTES: Note function that is thread-safe The function memcpy() is thread safe. memfrob.3 Peng Haitao ATTRIBUTES: Note function that is thread-safe The function memfrob() is thread safe. memmem.3 Peng Haitao ATTRIBUTES: Note function that is thread-safe The function memmem() is thread safe. memmove.3 Peng Haitao ATTRIBUTES: Note function that is thread-safe The function memmove() is thread safe. mempcpy.3 Peng Haitao ATTRIBUTES: Note functions that are thread-safe The functions mempcpy() and wmempcpy() are thread safe. memset.3 Peng Haitao ATTRIBUTES: Note function that is thread-safe The function memset() is thread safe. strerror.3 Michael Kerrisk CONFORMING TO: strerror() and strerror_r() are in POSIX.1-2008 Michael Kerrisk Add SS heading for strerror_r() toupper.3 Michael Kerrisk Rewrite to more explicitly bring locales into the discussion Michael Kerrisk Retitle BUGS section to NOTES These are not really bugs, just background info. wcrtomb.3 wcsnrtombs.3 wcsrtombs.3 wcstombs.3 wctomb.3 Michael Kerrisk SEE ALSO: add various entries Mainly inspired by POSIX core.5 Mike Frysinger [Michael Kerrisk] Document core_pattern %d specifier Document %P core_pattern specifier Michael Kerrisk Rearrange core_pattern specifiers alphabetically locale.5 Michael Kerrisk SEE ALSO: add newlocale(3) + duplocale(3) feature_test_macros.7 Michael Kerrisk [Joseph S. Myers] Remove mention of bogus _ISOC95_SOURCE macro The _ISOC95_SOURCE macro is defined in , but it does nothing. So remove discussion of it, and move some of the discussion of C95 under the ISOC99_SOURCE subhead. Michael Kerrisk [Carlos O'Donell] Add packaging note for _BSD_SOURCE/_SVID_SOURCE/_DEFAULT_SOURCE To compile warning-free across glibc < 2.20 and glibc >= 2.20 code may been to define both _DEFAULT_SOURCE and either _BSD_SOURCE or _SVID_SOURCE. Michael Kerrisk Reword description of C90 locale.7 Michael Kerrisk Add subsection on POSIX.1-2008 (originally GNU) extensions to locale API Michael Kerrisk Remove reference to LI18NUX2000 LI18NUX2000 is difficult to even find these days, and in any case this page does not document gettext(), so notes about gettext() in the CONFORMING TO section here make no sense. Michael Kerrisk SEE ALSO: add mbstowcs(3) and wcstombs(3) SEE ALSO: add newlocale(3) + duplocale(3) man-pages.7 Michael Kerrisk Add preferred term "superblock" Michael Kerrisk Add preferred terms "uppercase" and "lowercase"