localedef.1: Align with recent charmap(5) / repertoiremap(5) changes

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charmap.5: Update to match current glibc

charmap(5) was outdated, bring it to closer to reality by fixing
syntax descriptions to match current glibc code and practices,
adding missing options, removing obsolete comments and references,
and removing now incorrect examples.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

repertoiremap.5: New page for repertoiremap(5)

Rather obsolete feature but localedef(1) refers to repertoiremaps.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charsets.7: Minor tweaks

And restore a piece about Biblical Hebrew that was
inadvertently deleted by Marko Myllynen's patch.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charsets.7: Update to reflect past developments

Rewrite the introduction to make Unicode's prominence more obvious.
Reformulate parts of the text to reflect current Unicode world.
Minor clarification for ASCII/ISO sections, some other minor fixes.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mq_send.3: ATTRIBUTES: Note functions that are thread-safe

The functions mq_send() and mq_timedsend() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mq_receive.3: ATTRIBUTES: Note functions that are thread-safe

The functions mq_receive() and mq_timedreceive() are thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

mq_open.3: ATTRIBUTES: Note function that is thread-safe

The function mq_open() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

posix_openpt.3: ATTRIBUTES: Note function that is thread-safe

The function posix_openpt() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

posix_fallocate.3: ATTRIBUTES: Note function that is thread-safe

The function posix_fallocate() is thread safe.

Signed-off-by: Peng Haitao <penght@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Clarify AM/PM settings a bit

localedef(1) complains if really undefined, should be empty instead.
Also: add some SEE ALSO references.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.1: Add FILES section, add charmap(5) reference

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.7: Add some SEE ALSO references

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

malloc_get_state.3: SYNOPSIS: use correct header

The nonstandard functions malloc_set_state() and
malloc_get_state() are provided by <malloc.h> not <stdlib.h>.

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

sendmmsg.2: Add reference to feature_test_macros(7)

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

recvmmsg.2: Add reference to feature_test_macros(7)

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

open_by_handle_at.2: Add reference to feature_test_macros(7)

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

getdate.3: Use blank definition of _GNU_SOURCE

Only the definedness of _GNU_SOURCE matters, so eliminate a possible
source of confusion by not using a specific replacement text in the
example program.

Signed-off-by: Rasmus Villemoes <rv@rasmusvillemoes.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

proc.5: srcfix: Remove obsolete FIXMEs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes.old: Fix to 3.41 changelog

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

bootparam.7: Minor tweaks to Petr Gajdos's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

bootparam.7: Describe 'rootflags' and 'rootdelay' kernel parameters

Patch based on text from Documentation/kernel-parameters.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

man-pages.7: Note that .TH 'date' field is nowadays automatically updated by scripts

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

signal.7: Clarify text describing EINTR semantics for socket interfaces

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

signal.7: srcfix: Add FIXMEs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

signal.7: Describe EINTR semantics for recvmmsg(2)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Minor NOTES clarification

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: RLIMIT_NPROC is checked only if preceded by set*uid()

Reported-by: Vasiliy Kulikov <segoon@openwall.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: Before kernel 2.6.0, RLIMIT_NPROC had no effect for set*uid()

Reported-by: NeilBrown <neilb@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

execve.2: Document EAGAIN error

See also https://bugzilla.kernel.org/show_bug.cgi?id=42704

Reviewed-by: Vasiliy Kulikov <segoon@openwall.com>
Reviewed-by: NeilBrown <neilb@suse.de>
Reported-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setreuid.2: Error checking should always be performed, even when caller is UID 0

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setresuid.2: Error checking should always be performed, even when caller is UID 0

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seteuid.2: Error checking should always be performed, even when caller is UID 0

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setuid.2: Error checking should always be performed, even when caller is UID 0

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setuid.2: Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setreuid.2: Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setresuid.2: Since Linux 3.1, the EAGAIN case for RLIMIT_NPROC no longer occurs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setuid.2: Document EAGAIN error that can occur after kernel alloc_uid() failure

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setreuid.2: Document EAGAIN error that can occur after kernel alloc_uid() failure

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setresuid.2: Document EAGAIN error that can occur after kernel alloc_uid() failure

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setreuid.2: Add EAGAIN error for hitting RLIMIT_NPROC limit

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setuid.2: Correct the description of the EAGAIN error

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setresuid.2: Correct the description of the EAGAIN error

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

seteuid.2: seteuid() and setegid() are implemented as library functions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

credentials.7: Minor layout fixes to make list format more consistent

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: ffix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Drop a garbled sentence

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: srcfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Document glibc conventions regarding days and week

Based on existing practice and glibc community wiki page at
https://sourceware.org/glibc/wiki/Locales

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes.old: tfix in 3.68 changelog

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes.old: Fix to 3.68 changelog

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Changes.old: Fixes to 3.68 changelog

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

Start of man-pages-3.69: updating Changes and Changes.old

Start of man-pages-3.69: updating .Announce and .lsm files

Start of man-pages-3.69: renaming .Announce and .lsm files

Ready for 3.68

Removed trailing white space at end of lines

Changes: Ready for 3.68

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.1, adjtimex.2, clone.2, fork.2, getrlimit.2, remap_file_pages.2, set_mempolicy.2, swapon.2, a64l.3, adjtime.3, argz_add.3, bstring.3, envz_add.3, fpathconf.3, fseek.3, gcvt.3, getaddrinfo_a.3, getauxval.3, getnameinfo.3, getrpcent.3, getrpcport.3, getspnam.3, getutent.3, inet.3, inet_net_pton.3, key_setsecret.3, makecontext.3, makedev.3, malloc_trim.3, mq_getattr.3, newlocale.3, nl_langinfo.3, perror.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigqueue.3, rcmd.3, re_comp.3, resolver.3, rexec.3, rtime.3, scandir.3, setlocale.3, setnetgrent.3, sigvec.3, tsearch.3, core.5, proc.5, charsets.7, locale.7: tstamp

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Note default value for 'first_workday'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Correct the FILES section

locale.5: t_fmt_ampm is needed only for locales that employ AM/PM convention

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Minor fix in CONFORMING TO

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: tfix

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Add brief descriptions of collating-element and collating-symbol

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Remove crufty reference to /usr/lib/nls/src

That file is nowhere to be found

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

newlocale.3: Add LC_ALL_MASK description

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

newlocale.3: List all available category masks

Patch edited slightly by mtk.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charsets.7: Remove ancient paragraph on charsets supported in glibc 2.3.2

That test is rather ancient, and probably of little use.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charsets.7: srcfix: Add FIXME

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charsets.7: Remove crufty statement that Romanian may be switching to ISO 8859-16

It certainly seems like that change happened some time ago.

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charsets.7: spfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

cpuset.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

charsets.7: tfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: srcfix: Add/update FIXMEs

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

localedef.1: srcfix: Clean up trailing white space

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

localedef.1: Minor fixes to new page

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

localedef.1: Replace reference to locale(7) with names of a few relevant functions

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

localedef.1: New page for localedef(1)

Add new page based on Debian localedef(1) page.

Cowritten-by: Richard Braakman <richard.braakman@jollamobile.com>
Cowritten-by: Alastair McKinstry <mckinstry@computer.org>
Cowritten-by: Lars Wirzenius <liw@iki.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.1: Use LC_TELEPHONE instead of LC_MESSAGES in the example

yesstr/nostr in LC_MESSAGES are planned to be changed at some
point [1], so it's better to provide an example which won't
be obsoleted by that change.

[1] https://sourceware.org/bugzilla/show_bug.cgi?id=16975

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.1: Provide a step-by-step example of how to use a custom locale

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.7: Clarify that LOCPATH is used by setlocale(3) and newlocale(3)

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.7: further details of LOCPATH

Helpful for three purposes, 1) shows the expected naming scheme,
2) shows where to point LOCPATH to, and 3) gives an idea to the
attentive how to use a more generic, location independent
directory with location dependent, more specific ones.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Minor tweaks to 's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Document mon_grouping and grouping properly

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

README: Explain usage of prefix when installing

Installing the man pages to /usr may not be the preferred option
when working on a system with a packaging system like apt or yum,
where /usr is reserved for packages and /usr/local or /opt is used
for user addons.

README should explain how to install to a path different to /usr.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

inotify.7: munmap() does not generate inotify events

mmap() and msync() were already described as not leading to
inotify events. This patch adds munmap(). I created and executed
a test to verify this.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

inotify.7: Minor changes to Heinrich Schuechardt's example program

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

inotify.7: Add example program

This example of the usage of the inotify API shows the
usage of inotify_init1(2) and inotify_add_watch(2) as well
as polling and reading from the inotify file descriptor.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.7: Tweaks to Marko Myllynen's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.7: Document LOCPATH

Example from https://sourceware.org/glibc/wiki/Locales

After modifying a locale, make sure it compiles, and install it to a
temporary directory for testing:

  unset LC_ALL
  LOCALE=fi_FI
  export I18NPATH=$HOME/locale-test/
  export LOCPATH=$HOME/locale-test/
  mkdir -p $LOCPATH
  localedef --no-archive -f localedata/charmaps/UTF-8 -i localedata/locales/$LOCALE $I18NPATH/$LOCALE.UTF-8
  LC_TIME=$LOCALE.UTF-8 locale -ck LC_TIME
  LC_TIME=$LOCALE.UTF-8 locale -ck date_fmt
  LC_TIME=$LOCALE.UTF-8 date
  LC_CTYPE=$LOCALE.UTF-8 iconv -f UTF-8 -t ASCII//TRANSLIT < translit-test-input.txt
  LC_COLLATE=$LOCALE.UTF-8 sort < sorting-test-input.txt

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

nl_langinfo.3: expand the example code a bit

Better illustrate querying elements from different categories.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Minor rewordings

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Tweaks to Marko Myllynen's patch

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.5: Clarify LC_TIME/am_pm and LC_NAME keywords usage

am_pm should be defined only if AM/PM convention is used to signal
applications they should not try to print them when using them in
unwanted.

Same for all LC_NAME keywords expect for name_fmt which should be
always defined.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

locale.7: Add further details on various categories

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setlocale.3: Simply locale category listing and add GNU-specific locale categories

Some information that was here will move to locale(7).

Reported-by: Marko Myllynen <myllynen@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>

setlocale.3: wfix

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>