LDP
/
man-pages
mirror of https://github.com/mkerrisk/man-pages
0
1
Fork 0
Code Releases Activity
16,900 Commits 1 Branch 197 Tags 93 MiB
Commit Graph

5549 Commits

Author SHA1 Message Date
Michael Kerrisk 1f73bfaf6e strverscmp.3: Add an example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-31 07:23:03 +12:00
Michael Kerrisk 919b0ce050 pthread_join.3: Clarify use of 'retval' pointer 
Reported-by: 王守堰 <wangshouyan@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-29 09:56:47 +12:00
Ruben Kerkhof 48bafe7c02 readdir_r(3): tfix: Fix reference to readdir(3) 2016-08-28 16:38:31 +12:00
Michael Kerrisk efcf47adbd makedev.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-18 09:59:24 +12:00
Ray Bellis 519303a6a4 resolver.3: Correct arguments to res_ninit(res_state statep) 
The man page for res_ninit() incorrectly says that it takes no
parameters, when in fact (and indeed according to the same page
further down) it has to take a res_state parameter.
 2016-08-12 07:14:42 +12:00
Michael Kerrisk a9672faabc fmemopen.3: Remove bogus suggestion to use setbuffer() 
As Rich Felker comments:

    The stdio buffer associated with the fmemopen-obtained FILE,
    and the output memory buffer into which it's writing, are
    conceptually distinct entities, and there is no reason to
    expect reasonable results if you modify the contents of a
    setvbuf-associated buffer through other means while it's
    associated with a FILE.

See http://stackoverflow.com/questions/38854163/using-rewind-on-a-file-opened-with-fmemopen

Reported-by: Rich Felker <dalias@libc.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-12 07:14:42 +12:00
Michael Kerrisk afdd425e68 towlower.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk 9f7a5b0e57 sigset.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk 119a385181 resolver.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk fca8d7eb25 readdir_r.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk 95183c2e0a dlinfo.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:16 +10:00
Michael Kerrisk 53c9ce2def towupper.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 909eb7e97a towlower.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk bdec6fb099 strerror.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 84f6b0672e sigvec.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 7c8c6f2da9 pthread_rwlockattr_setkind_np.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 9c78ec5b5c posix_spawn.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 355b6107b4 ntp_gettime.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 2443152c7b nextup.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk ec0f3c469d isalpha.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk 82bd66b8b6 dlopen.3: Fix section ordering 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:15 +10:00
Michael Kerrisk ca38b869e5 wcstombs.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:14 +10:00
Michael Kerrisk e8b81d3405 wcstombs.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:14 +10:00
Michael Kerrisk ea7378c307 toupper.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:14 +10:00
Michael Kerrisk c0f12d150f system.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:14 +10:00
Michael Kerrisk 0125c2578d random.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:14 +10:00
Michael Kerrisk be4653091b pthread_setaffinity_np.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:14 +10:00
Michael Kerrisk 2e94784dd0 mbtowc.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:14 +10:00
Michael Kerrisk 68d316001d mbstowcs.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 13bc1e7875 mbsinit.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk dd18a3b676 isalpha.3: Fix order of SEE ALSO entries 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 95e77601fc confstr.3: Minor fix-ups in SEE ALSO 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 66ced968fe realpath.3: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 3fe3c87e65 posix_fallocate.3: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 6b0d93ef13 lio_listio.3: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk 48f9dd5975 getcwd.3: Order ERRORS alphabetically 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:13 +10:00
Michael Kerrisk bf7bc8b898 arch_prctl.2, execveat.2, fanotify_mark.2, fcntl.2, fork.2, madvise.2, mknod.2, mmap.2, modify_ldt.2, mount.2, open.2, prctl.2, ptrace.2, restart_syscall.2, seccomp.2, semop.2, set_thread_area.2, symlink.2, umount.2, unlink.2, error.3, getnetent.3, getprotoent.3, getservent.3, getutent.3, glob.3, login.3, setjmp.3, setnetgrent.3, wordexp.3, epoll.7: Remove section number from page self reference 
Fix places where pages refer to the function that they describe
and include a section number in that reference. Such references
cause some HTML-rendering tools to create self-references in the
page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-08 05:54:12 +10:00
Quentin Rameau c6785202b0 mkstemp.3: Fix _POSIX_C_SOURCE value for mkstemp() 
The correct _POSIX_C_SOURCE value has always been 200809L,
not 200112L.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-08-04 08:15:25 +10:00
Michael Kerrisk cdff989b46 endian.3: SEE ALSO: add bswap(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk b1bc4fd1ab byteorder.3: SEE ALSO: add bswap(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 70811de458 bswap_64.3: New link to new bswap.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 3dedc90a6e bswap_32.3: New link to new bswap.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk e032ad6e7e bswap_16.3: New link to new bswap.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 9f0b7bd6b0 bswap.3: New page documenting bswap_16(), bswap_32(), and bswap_64() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-24 21:53:46 +02:00
Michael Kerrisk 2ae96e8ae8 Removed trailing white space at end of lines 2016-07-17 18:10:19 +02:00
Michael Kerrisk 3df541c0e6 ldd.1, localedef.1, add_key.2, chroot.2, clone.2, fork.2, futex.2, get_mempolicy.2, get_robust_list.2, getitimer.2, getpriority.2, ioctl.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kcmp.2, kill.2, lookup_dcookie.2, mmap.2, mount.2, open.2, pciconfig_read.2, perf_event_open.2, prctl.2, process_vm_readv.2, ptrace.2, quotactl.2, recv.2, setfsgid.2, setfsuid.2, sysinfo.2, umask.2, umount.2, unshare.2, utimensat.2, wait.2, assert.3, fmax.3, fmin.3, getauxval.3, inet_pton.3, malloc_hook.3, memmem.3, mkdtemp.3, mktemp.3, printf.3, strcasecmp.3, strcat.3, strtoul.3, strxfrm.3, console_codes.4, console_ioctl.4, lirc.4, tty.4, vcs.4, charmap.5, elf.5, locale.5, proc.5, repertoiremap.5, utmp.5, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cp1251.7, cp1252.7, credentials.7, feature_test_macros.7, iso_8859-1.7, iso_8859-15.7, iso_8859-5.7, koi8-r.7, koi8-u.7, man-pages.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, unix.7, user_namespaces.7, utf-8.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-17 18:10:19 +02:00
Michael Kerrisk e732a1c21d nextdown.3, nextdownf.3, nextdownl.3, nextupf.3, nextupl.3: New links to nextup(3) 2016-07-16 11:20:55 +02:00
Michael Kerrisk ab472b501a nextup.3: Add thread-safety markings 
Based on code inspection and glibc manual mark-up.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-16 11:20:55 +02:00
Michael Kerrisk c484406d06 nextup.3: New page documenting nextup(), nextdown(), and related functions 2016-07-15 23:53:08 +02:00
Cownie, James H 7e318d44a1 getauxval.3: Minor fix to AT_HWCAP text 
Reported-by: Szabolcs Nagy <szabolcs.nagy@arm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-14 08:43:01 +02:00
Michael Kerrisk 291415ef4a getauxval.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-12 22:24:22 +02:00
Cownie, James H 063bf5a777 getauxval.3: Correct AT_HWCAP result description 
The getauxval(3) man page describes the result for AT_HWCAP as
"A pointer to a multibyte mask of bits", however the actual value
returned is not a pointer, but simply the first 32 bits of the
capabilities mask.

This can be observed directly. Note the value shown for AT_HWCAP
is a 32 bit value that is not a pointer (see AT_PHDR or AT_RANDOM
for how pointers are shown).

% LD_SHOW_AUXV=1 cat < /dev/null
AT_SYSINFO_EHDR: 0x7fffe89fe000
AT_HWCAP:        bfebfbff
AT_PAGESZ:       4096
AT_CLKTCK:       100
AT_PHDR:         0x400040
AT_PHENT:        56
AT_PHNUM:        9
AT_BASE:         0x0
AT_FLAGS:        0x0
AT_ENTRY:        0x402634
AT_UID:          515
AT_EUID:         515
AT_GID:          114
AT_EGID:         114
AT_SECURE:       0
AT_RANDOM:       0x7fffe8917be9
AT_EXECFN:       /usr/bin/cat
AT_PLATFORM:     x86_64
 2016-07-12 22:23:29 +02:00
Michael Kerrisk 1d360c2637 strxfrm.3: Remove NOTES section 
strxfrm() and strncpy() are not precisely equivalent in the
POSIX locale, so this NOTES section was not really correct.

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

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-07-07 13:44:50 +02:00
Michael Kerrisk 74714ea895 ctime.3, error.3, getmntent.3, getnetent_r.3, getrpcent_r.3, getservent_r.3, pthread_attr_init.3, pthread_getattr_np.3, pthread_tryjoin_np.3, rpc.3, setaliasent.3, setenv.3, unlocked_stdio.3: srcfix: Eliminate some groff warnings 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-26 11:25:22 +02:00
Michael Kerrisk 0b5ff3b662 fmax.3, fmin.3: SEE ALSO: add fdim(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-22 12:10:46 +02:00
Michael Kerrisk c545391400 strtoul.3: SEE ALSO: add a64l(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-22 12:04:15 +02:00
Michael Kerrisk b2f0984e04 strcat.3: Add a program that shows the performance characteristics of strcat() 
In honor of Joel Spolksy's visit to Munich, let's start educating
Schlemiel The Painter.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-21 13:55:09 +02:00
Michael Kerrisk bfb9c7c014 getaddrinfo_a.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk 67c7e1d53d getaddrinfo_a.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk 31cc838703 getunwind.2, prctl.2, aio_suspend.3, setenv.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk 616c2730de remap_file_pages.2, sigaltstack.2, umask.2, wait4.2, basename.3, canonicalize_file_name.3, dlerror.3, dlopen.3, dlsym.3, sockatmark.3, strtok.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Michael Kerrisk cd2c21a021 cacos.3, cacosh.3, catan.3, catanh.3: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-20 14:00:37 +02:00
Tobias Stoeckmann 36f99b9242 getauxval.3: tfix 
Fix typo. It's supposed to be "its" not "it's" in this context.

Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org>
 2016-06-15 22:53:03 +02:00
Michael Kerrisk a1476a498c malloc_hook.3: glibc 2.24 removes __malloc_initialize_hook 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-10 16:26:53 +02:00
Michael Kerrisk 6de48cdf60 regex.3: Minor fix to 'info libc' regex reference 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-09 22:12:34 +02:00
Michael Kerrisk 2974f4050a printf.3: Note support in other C libraries for %m and %n 
Reported-by: Shawn Landden <shawn@churchofgit.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-09 22:12:29 +02:00
Michael Kerrisk 1b2385537f memmem.3: Note that memmem() is present on some other systems 
Reported-by: Shawn Landden <shawn@churchofgit.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-09 10:02:56 +02:00
Jakub Wilk d1f84ed72a clone.2, confstr.3, hpsa.4, tcp.7: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-06-08 11:24:08 +02:00
Jakub Wilk 8d48cea31a termios.3: spfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
 2016-06-06 09:13:54 -05:00
Michael Kerrisk 9b3661c406 assert.3: Clarify details of message printed by assert() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-03 06:38:32 -05:00
Michael Kerrisk 4d644289dd assert.3: Minor clean-ups 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-03 06:38:32 -05:00
Nikos Mavrogiannopoulos f34fcbb86b assert.3: Improved description 
Removed text referring to text not being helpful to users. Provide
the error text instead to allow the reader to determine whether it
is helpful.  Recommend against using NDEBUG for programs to
exhibit deterministic behavior.  Moved description ahead of
recommendations.

Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
 2016-06-03 06:37:52 -05:00
Michael Kerrisk c39946e06e mkdtemp.3, mktemp.3: SEE ALSO: add mktemp(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-06-01 11:02:44 -05:00
Michael Kerrisk 0ee6740485 strcasecmp.3: Minor tweak to strncasecmp() description 
Reported-by: Ori Avtalion <ori@avtalion.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-29 11:53:38 -05:00
Michael Kerrisk 2392242b06 strcasecmp.3: Make details of strncasecmp() comparison clearer 
Quoting Ori:

The manpage for strncasecmp has a few wording issues that can be improved:

1)
In the DESCRIPTION section, "except it compares only the first n
bytes of s1"

s1 can be shorter than n bytes. Consider adding "(at most)" after
"first".

For comparison with reference materials, POSIX uses the wording
"not more than n bytes", OSX and FreeBSD use "compares at
most [...]".

2)
In the RETURN VALUE section: "if s1 (or the first n bytes
thereof) is found [...] to match [...] s2"

This could theoretically be read to suggest that the first n bytes
of s1 are compared against the FULL s2, which is not the case.
Consider removing the parenthetical altogether (thus, not
mentioning 'n' at all). POSIX doesn't mention 'n' in its RETURN
VALUE section.

3)
The RETURN VALUE section doesn't mention case insensitivity. It's
in the DESCRIPTION, but perhaps it should also be in this section.
POSIX mentions case-insensitivity in RETURN VALUE.

Consider adding "and ignoring case" after "respectively".

Reported-by: Ori Avtalion <ori@avtalion.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-29 06:52:09 -05:00
Stefan Puiu 04fd9903e3 inet_pton.3: Mention byte order 
Come to think of it, this probably applies to IPv6 as well. Moving to
the paragraph before:
 2016-05-18 13:33:30 +02:00
Michael Kerrisk a03a743568 getauxval.3: tfix 
Reported-by: Håkon Sandsmark <hsandsma@cisco.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-13 13:47:25 +02:00
Michael Kerrisk 4590829a1b dlsym.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-13 10:59:06 +02:00
Élie Bouttier 819eeff4c6 getaddrinfo_a.3: tfix 
EAI_CANCELED and EAI_NOTCANCELED are defined without double L in resolv/netdb.h from glibc.
See https://sourceware.org/git/?p=glibc.git;a=blob;f=resolv/netdb.h;h=3aba530932c7a62a4f23e3193e9186da677f552b;hb=HEAD#l632
 2016-05-11 08:37:44 +02:00
Michael Kerrisk 5c61e57f56 strtod.3: Improve a detail in RETURN VALUE 
Reported-by: Ed Avis <eda@waniasset.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-05-09 22:53:25 +02:00
Nikola Forró ea5bce080a popen.3: RETURN VALUE: describe successful case 
Reference:
http://pubs.opengroup.org/onlinepubs/9699919799/functions/popen.html
http://pubs.opengroup.org/onlinepubs/9699919799/functions/pclose.html

Signed-off-by: Nikola Forró <nforro@redhat.com>
 2016-05-09 22:45:36 +02:00
Michael Kerrisk 38f55864aa cmsg.3: Minor cosmetic changes in example code 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-22 15:38:49 +02:00
Michael Kerrisk 6cd7a2c6da cmsg.3: Minor cosmetic changes to example code 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-22 10:00:25 +02:00
Michael Kerrisk 85a4005516 makedev.3: NOTES: mention that <sys/types.h> may also define these macros 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-20 14:06:28 +02:00
Mike Frysinger 3350a86413 makedev(3): Use <sys/sysmacros.h> in SYNOPSIS 
Defining these functions via <sys/types.h> causes problems for
some folk. As noted by Zack Wein:

    libstdc++ force-enables _GNU_SOURCE, which means people
    writing in C++ _can't_ avoid these nonstandard macros by
    using a strict conformance mode.

Since glibc has basically always used <sys/sysmacros.h>,
update the docs to have people include that instead.

Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-04-20 14:06:28 +02:00
Michael Kerrisk a90f441afb readdir.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-26 07:08:16 +13:00
Michael Kerrisk 2c767761a2 Removed trailing white space at end of lines 2016-03-15 17:30:43 +13:00
Michael Kerrisk 979867082b locale.1, localedef.1, _exit.2, accept.2, access.2, acct.2, adjtimex.2, bdflush.2, bind.2, bpf.2, brk.2, chdir.2, chmod.2, chown.2, chroot.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_ctl.2, eventfd.2, execve.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, get_kernel_syms.2, getdomainname.2, getgroups.2, gethostname.2, getpagesize.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, gettimeofday.2, init_module.2, ioctl.2, ioctl_list.2, ioperm.2, iopl.2, kexec_load.2, kill.2, killpg.2, link.2, listen.2, llseek.2, lseek.2, madvise.2, memfd_create.2, mincore.2, mkdir.2, mknod.2, mmap.2, mount.2, nanosleep.2, nice.2, open.2, personality.2, pipe.2, poll.2, posix_fadvise.2, read.2, readahead.2, readlink.2, readv.2, recv.2, recvmmsg.2, rename.2, request_key.2, sched_setaffinity.2, sched_setattr.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendfile.2, sendmmsg.2, seteuid.2, setns.2, setpgid.2, setreuid.2, shutdown.2, sigaction.2, sigaltstack.2, signal.2, signalfd.2, sigpending.2, sigprocmask.2, sigsuspend.2, socketpair.2, splice.2, stat.2, statfs.2, stime.2, symlink.2, sync.2, syscall.2, syscalls.2, times.2, truncate.2, unlink.2, unshare.2, uselib.2, utimensat.2, vfork.2, vhangup.2, wait.2, wait4.2, write.2, a64l.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_read.3, aio_write.3, asin.3, asinh.3, atan.3, atan2.3, atanh.3, atoi.3, backtrace.3, cbrt.3, ceil.3, cfree.3, clearenv.3, clock_getcpuclockid.3, clog10.3, cmsg.3, copysign.3, cos.3, cosh.3, ctermid.3, ctime.3, daemon.3, dirfd.3, div.3, dl_iterate_phdr.3, drand48.3, drand48_r.3, dysize.3, ecvt.3, ecvt_r.3, endian.3, erf.3, erfc.3, errno.3, exec.3, exp.3, exp2.3, expm1.3, fabs.3, fdim.3, ferror.3, fexecve.3, ffs.3, fgetgrent.3, fgetpwent.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmin.3, fmod.3, fopen.3, fpclassify.3, frexp.3, fseeko.3, fts.3, futimes.3, fwide.3, gamma.3, gcvt.3, getaddrinfo.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getline.3, getloadavg.3, getmntent.3, getnameinfo.3, getnetent_r.3, getpass.3, getprotoent_r.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getservent_r.3, getspnam.3, getsubopt.3, getusershell.3, getutent.3, getw.3, gsignal.3, hypot.3, ilogb.3, inet.3, initgroups.3, insque.3, isalpha.3, isgreater.3, iswblank.3, j0.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, lrint.3, lround.3, makedev.3, matherr.3, mbsnrtowcs.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_receive.3, mq_send.3, nan.3, nextafter.3, on_exit.3, open_memstream.3, opendir.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, printf.3, profil.3, psignal.3, pthread_attr_setstack.3, pthread_setaffinity_np.3, putenv.3, putpwent.3, qecvt.3, rand.3, random.3, random_r.3, rcmd.3, readdir.3, realpath.3, remainder.3, remquo.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, scalb.3, scalbln.3, scandir.3, scanf.3, seekdir.3, sem_wait.3, setbuf.3, setenv.3, setjmp.3, setnetgrent.3, siginterrupt.3, signbit.3, significand.3, sigset.3, sigsetops.3, sigvec.3, sigwait.3, sin.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stpcpy.3, stpncpy.3, strdup.3, strerror.3, strftime.3, strlen.3, strnlen.3, strsep.3, strsignal.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, system.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, unlocked_stdio.3, usleep.3, wcpcpy.3, wcpncpy.3, wcscasecmp.3, wcsdup.3, wcsncasecmp.3, wcsnlen.3, wcsnrtombs.3, wprintf.3, y0.3, pts.4, st.4, tty_ioctl.4, elf.5, gai.conf.5, group.5, locale.5, nsswitch.conf.5, proc.5, utmp.5, aio.7, capabilities.7, credentials.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, inotify.7, ip.7, mq_overview.7, namespaces.7, pipe.7, signal.7, socket.7, standards.7, svipc.7, symlink.7, time.7, unicode.7, unix.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-15 17:30:43 +13:00
Michael Kerrisk 68df07dd4d posix_spawn.3: srcfix: Add license delimiter tags 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-15 17:30:43 +13:00
Nikola Forró 1754f8d0f7 strftime.3: tfix 
Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-15 06:21:50 +13:00
Jakub Wilk d260f95eb0 readdir_r.3: tfix 
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-14 08:32:54 +13:00
Michael Kerrisk fca67dd016 strftime.3: Note which 'tm' fields are used to calculate each output string 
See https://bugzilla.redhat.com/show_bug.cgi?id=1162218

Reported-by: Jeremy Harris <jeharris@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-13 10:51:34 +13:00
Michael Kerrisk 8dc9c2d66e strftime.3: Minor reordering of some text 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-13 10:51:16 +13:00
Michael Kerrisk f1e1b550a9 dl_iterate_phdr.3: Note that first object visited by 'callback' is the main program 
See https://bugzilla.kernel.org/show_bug.cgi?id=94141

Reported-by: Simon Que <sque@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 20:28:11 +01:00
Michael Kerrisk 9b14ad2db5 dl_iterate_phdr.3: Describe 'struct dl_phdr_info' fields added in glibc 2.4 
See https://bugzilla.kernel.org/show_bug.cgi?id=103011

Reported-by: Paul Pluzhnikov <ppluzhnikov@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 19:59:46 +01:00
Michael Kerrisk 1893b64807 recv.2, cmsg.3: Note that cmsg_len is typed as socklen_t in POSIX.1 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 16:58:07 +01:00
Michael Kerrisk 4ecc4f795f cmsg.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 16:53:52 +01:00
Nikola Forró aea45daeee recv.2, cmsg.3: Fix type of cmsg_len member of cmsghdr structure 
The type shown for cmsg_len member of cmsghdr structure is socklen_t,
but the actual type used by glibc and the kernel is size_t.

The information was obtained from glibc source code:
http://bit.ly/21m1RMp

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 16:51:07 +01:00
Michael Kerrisk 1182ddb36a fmemopen.3: Update timestamp (page reviewed by Adhemerval Zanella) 
Reviewed-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 15:38:57 +01:00
Michael Kerrisk 501934a934 timegm.3: Expand DESCRIPTION a little 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 00:43:05 +01:00
Michael Kerrisk 25a0440e45 timegm.3: Remove sample implementation of timegm() 
Stephen and Mats both question the wisdom of showing a portable
*non-thread-safe* implementation of timegm(), and I find it
hard to disagree. So, remove this code.

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

Reported-by: Stephen Hurd <shurd@sasktel.net>
Reported-by: Mats Wichmann <mats@linuxfoundation.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-11 00:42:36 +01:00
Michael Kerrisk ddef8b9573 fmemopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-10 21:05:11 +01:00
Michael Kerrisk cf486e4aa9 CPU_SET.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-10 16:31:50 +01:00
Michael Kerrisk 7d02e97e66 pthread_setaffinity_np.3: SEE ALSO: add CPU_SET(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-10 15:56:14 +01:00
Michael Kerrisk 8a61b8f5db readdir.3: tfix 
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-10 15:50:12 +01:00
Michael Kerrisk 77c73ca424 open_memstream.3: SEE ALSO: add setbuf(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-10 02:57:14 +01:00
Michael Kerrisk 207f4520b8 open_memstream.3: Minor reworking 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-10 02:57:14 +01:00
Michael Kerrisk 493e0eb3c2 fmemopen.3: srcfix: update copyright 
Little or no text remains from Walters initial version
10 years ago.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 11:41:58 +01:00
Michael Kerrisk 8190a9eeac open_memstream.3: srcfix: Update copyright info 
The open_memstream() text was jsut by me.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 11:41:24 +01:00
Michael Kerrisk b5a636d650 fmemopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:20:12 +01:00
Michael Kerrisk e3d1b1b740 open_memstream.3: Rework text describing dynamic allocation 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk 31a3c48847 open_memstream.3: Add some details on current buffer position 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk a6bd38c621 fopen.3: SEE ALSO: add open_memstream(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk 8e23ae0316 open_wmemstream.3: Update link to point to new open_memstream(2) page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 05:12:56 +01:00
Michael Kerrisk 09ffd9ca50 fmemopen.3, open_memstream.3: Split open_memstream() and open_wmemstream() out to separate page 
The current fmemopen(3) page documents too many functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:55:07 +01:00
Michael Kerrisk 551c427e75 fmemopen.3: srcfix: copyright date 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:36:48 +01:00
Michael Kerrisk 36ad378145 fmemopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:34:31 +01:00
Michael Kerrisk d779692dc7 fmemopen.3: Small clarification to the discussion of write errors 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:31:40 +01:00
Michael Kerrisk 82aa5cf962 fmemopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:20:13 +01:00
Michael Kerrisk f29c8cd8e9 fmemopen.3: Minor fix: reorder a paragraph 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:19:52 +01:00
Michael Kerrisk f39842ae12 fmemopen.3: ffix: add a subheading 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:18:33 +01:00
Michael Kerrisk 0b54423fb5 fmemopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk c7de29d451 fmemopen.3: Expand discussion of "current position" for fmemopen() stream 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 1e9eb6c1b6 fmemopen.3: Rework discussion of the (obsolete) binary mode 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 2841079cd0 fmemopen.3: ffix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 9c8b5ebfc4 fmemopen.3: Rework description of 'buf' and 'len' arguments 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 04:15:13 +01:00
Michael Kerrisk 58c55bb87b fmemopen.3: Greatly expand description of 'mode' argument 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 03:42:26 +01:00
Michael Kerrisk 02989b144e fmemopen.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 03:09:36 +01:00
Michael Kerrisk 93bb19b18c fmemopen.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 03:09:36 +01:00
Michael Kerrisk 0edb356c58 fmemopen.3: Small improvements to the description of open_memstream() 
Make it a little more evident that the caller should not
pass a previously allocated buffer to open_memstream().

Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:49:57 +01:00
Michael Kerrisk d9b4881f64 fmemopen.3: Fix "Usage" message 
Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:33:45 +01:00
Michael Kerrisk 852d92f7ae getnameinfo.3: Update FTM requirements 
The FTM requirements changed in glibc 2.22

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:28:38 +01:00
Michael Kerrisk 5358a2546d getaddrinfo.3: Update FTM requirements for glibc 2.22 
Since glibc 2.22 getaddrinfo() etc. are only declared for
POSIX.1-2001 or later.

Reported-by: Andreas Schwab <schwab@suse.de>
Reported-by: Orion Poplawski <orion@cora.nwra.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 02:19:11 +01:00
Michael Kerrisk c50730b607 gamma.3: gamma() was documented in SVID 2 
Reported-by: Alan Cox <etchedpixels@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 01:05:16 +01:00
Michael Kerrisk f1e369b09f ntp_adjtime.3: New link to adjtimex(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 00:36:16 +01:00
Jérémie Galarneau 4d70ca99ed posix_fallocate.3: ERRORS: add EINTR 
The glibc implementation of posix_fallocate(), which calls
fallocate(), may be interrupted. The fallocate() emulation
also makes use of pread()/pwrite(), which may also be
interrupted.

Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-09 00:34:48 +01:00
Michael Kerrisk 85c30f7eab ntp_gettime.3: Add ATTRIBUTES section 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 11:15:18 +01:00
Michael Kerrisk 39ad98a088 sysconf.3: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 11:15:18 +01:00
Michael Kerrisk b5133e9ad9 ntp_gettime.3: Note that these APIs always succeed 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 11:15:18 +01:00
Michael Kerrisk cfb9b2f966 ntp_gettimex.3: New link to ntp_gettime.3 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 01:36:29 +01:00
Michael Kerrisk 6d78bc966a ntp_gettime.3: New page describing ntp_gettime(3) and ntp_gettimex(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-07 01:34:55 +01:00
Michael Kerrisk 82b43a7692 posix_spawn.3: Tweak a few more details 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk 5356204785 posix_spawn.3: Add note on "posix_fspawn" functionality 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk 7b5e3ad522 posix_spawn.3: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk c0d82fb9cb posix_spawnp.3: New link to new posix_spawn.3 page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk 10069ed030 posix_spawn.3: Major reworking of and additions to contributed page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Bill O. Gallmeister a5458d4938 posix_spawn.3: New man page for posix_spawn(3) and posix_spawnp(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 10:26:32 +01:00
Michael Kerrisk df383cdf95 posix_memalign.3: Note posix_memalign()'s treatment of 'memptr' on error 
Reported-by: Eric Blake <eblake@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-05 08:52:29 +01:00
Michael Kerrisk 9c048ec195 fmemopen.3: Note one more memory stream bug that was fixed in glibc 2.22 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 16:23:19 +01:00
Michael Kerrisk 39ef79baad fmemopen.3: Note various fmemopen() bugs that were fixed in glibc 2.22 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2016-03-02 16:23:19 +01:00