Commit Graph

5782 Commits

Author SHA1 Message Date
Michael Kerrisk 75970bd63f getnameinfo.3: wfix
Reported-by: Cameron Wright <wright18@uw.edu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-03 18:45:15 +02:00
Michael Kerrisk 3a9a2ecbe1 shm_open.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-26 14:32:26 +02:00
Michael Kerrisk 475fea9aeb memcpy.3: wfix
Reported-by: Henry Bent <henry.r.bent@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-21 11:47:00 +02:00
Michael Kerrisk f9ce70d255 dlsym.3: _GNU_SOURCE is needed to get RTLD_DEFAULT and RTLD_NEXT definitions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-14 12:02:38 +02:00
Michael Kerrisk 797981eb03 dl_iterate_phdr.3: dl_iterate_phdr() shows the order in which objects were loaded
dl_iterate_phdr() tells us not just which objects are
loaded, but also the order in which they are loaded
(the "link-map order"). Since the order is relevant for
understanding symbol resolution, give the reader this clue.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-13 11:33:00 +02:00
Michael Kerrisk 91a2771d06 dl_iterate_phdr.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-12 13:43:56 +02:00
Michael Kerrisk 6736a8024c dl_iterate_phdr.3: Expand the code example, and show sample output
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-12 13:43:56 +02:00
Michael Kerrisk c4054f820e dl_iterate_phdr.3: List values for the 'p_type' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-12 13:26:22 +02:00
Douglas Caetano dos Santos 1187f16f2d if_nametoindex.3: Add ENODEV error for if_nametoindex()
Checked against glibc and kernel code: when given name isn't
a valid interface, kernel returns ENODEV and glibc just
forwards it.

Signed-off-by: Douglas Caetano dos Santos <douglascs@taghos.com.br>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-09 21:19:06 +02:00
Douglas Caetano dos Santos d0cdb0ef0a if_nameindex.3: tfix
Signed-off-by: Douglas Caetano dos Santos <douglascs@taghos.com.br>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-09 21:18:18 +02:00
Heinrich Schuchardt e5b5658c6e strtol.3: Mention 0X prefix
The prefix 0x may be capitalized as 0X.

See ISO/IEC 9899:1999.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-08 11:00:20 +02:00
Michael Kerrisk 734882f4c4 _exit.2, alarm.2, chmod.2, clone.2, epoll_ctl.2, fcntl.2, fork.2, fsync.2, getdents.2, getpid.2, ioctl.2, ioctl_console.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, kexec_load.2, lseek.2, mincore.2, mkdir.2, mknod.2, mmap.2, open.2, poll.2, posix_fadvise.2, prctl.2, rename.2, sched_setaffinity.2, select.2, select_tut.2, sigaction.2, signalfd.2, sigprocmask.2, sigwaitinfo.2, socketcall.2, stat.2, statx.2, syscalls.2, truncate.2, umask.2, unshare.2, userfaultfd.2, utime.2, utimensat.2, wait.2, bzero.3, cfree.3, exit.3, getentropy.3, grantpt.3, insque.3, shm_open.3, syslog.3, termios.3, ttyname.3, wcsdup.3, console_codes.4, tty.4, vcs.4, elf.5, nsswitch.conf.5, proc.5, slabinfo.5, tmpfs.5, bootparam.7, environ.7, hostname.7, inotify.7, mailaddr.7, man-pages.7, namespaces.7, pid_namespaces.7, pthreads.7, pty.7, sem_overview.7, signal.7, socket.7, tcp.7, termio.7, user_namespaces.7, xattr.7, ld.so.8, zdump.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-03 19:27:48 +02:00
Jakub Wilk ba7fd6d583 ulimit.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-05-02 22:17:23 +02:00
Marko Myllynen 78cba5ac49 getentropy.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-27 14:29:03 +02:00
Michael Kerrisk 3b2a285b58 cfree.3: cfree() is removed from glibc in version 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-25 12:56:37 +02:00
Michael Kerrisk af70d80c47 getrpcport.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 21:19:08 +02:00
Michael Kerrisk e9d4c9a033 insque.3: SEE ALSO: add queue(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 21:16:38 +02:00
Michael Kerrisk 413579fc3b queue.3: SEE ALSO: add insque(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-24 21:16:38 +02:00
Michael Kerrisk 2c43dda391 ttyname.3: wfix
Reported-by: Dmitry V. Levin <ldv@altlinux.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 0289964456 ttyname.3: Minor edits to Christian Brauner's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Christian Brauner 953385d532 ttyname(3): NOTES: warn about a confusing case that may occur with mount namespaces
Signed-off-by: Christian Brauner <christian.brauner@ubuntu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk baf7fedbab setjmp.3: tfix
Reported-by: Ben Dog <wsy2220@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-23 20:21:15 +02:00
Michael Kerrisk 14ecabec05 errno.3: wfix
Reported-by: 丁贵强<dingguiqiang@foxmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-20 21:21:51 +02:00
Michael Kerrisk f0ed97100f getentropy.3: Some improvements to Nikos Mavrogiannopoulos's patch
Reported-by: Florian Weimer <fw@deneb.enyo.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 14:10:11 +02:00
Michael Kerrisk 419ba7b3c5 getentropy.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 14:02:54 +02:00
Nikos Mavrogiannopoulos 9cf011f94b getentropy.3: Correct header file
Signed-off-by: Nikos Mavrogiannopoulos <nmav@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 14:00:22 +02:00
Michael Kerrisk 61428042e2 bzero.3: Add correct header file for exlicit_bzero()
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00
Michael Kerrisk e6af0066c8 bzero.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:50 +02:00
Michael Kerrisk 547afefe40 shm_open.3: Clarify that POSIX shared memory uses tmpfs(5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-04-10 13:47:49 +02:00
Michael Kerrisk a9168840a2 ioctl.2, ioctl_console.2, select_tut.2, termios.3, tty.4, pty.7, termio.7: Change page cross-references from tty_ioctl(4) to ioctl_tty(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:30:50 +02:00
Michael Kerrisk d49a22201d ioctl.2, termios.3, console_codes.4, tty.4, tty_ioctl.4, vcs.4: Change page cross-references for console_ioctl(4) to ioctl_console(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-29 12:29:18 +02:00
Michael Kerrisk 84ec7d432b syslog.3: SEE ALSO: add journalctl(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk 1d8ee5b8ff syslog.3: Various rewordings and improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk 6b5652c1aa syslog.3: Note default value for 'facility' when calling openlog()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk d302d9c917 syslog.3: Various minor improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:54 +02:00
Michael Kerrisk aad9077cbb syslog.3: Reorganize page text for easier parsing and better readability
Inspired by comments from Ian Abbott and Walter Harms

Reported-by: Ian Abbott <abbotti@mev.co.uk>
Reported-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-26 14:19:33 +02:00
Michael Kerrisk aadc226bb7 pthread_atfork.3: New page describing pthread_atfork(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-25 08:20:24 +01:00
Dmitry V. Levin 1e88383bc3 ttyname.3: Document ENODEV error code
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-24 14:34:23 +01:00
Michael Kerrisk 6dcadb9beb grantpt.3: Tell a more nuanced story about what grantpt() does or does not do
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-23 10:34:31 +01:00
Jan Heberer a150608c2c wcsdup.3: RETURN VALUE: fix error in return value description
Return value for failure was accidentally changed from NULL to
-1 in man-pages commit 572acb41c4.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-20 17:49:46 +01:00
Michael Kerrisk 69060c5fc8 openpty.3: Minor wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-18 00:48:16 +01:00
Michael Kerrisk 71e876839d exit.3: Improve discussion of zombie processes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk 4426609333 exit.3: Minor text restructuring for clarity
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-17 06:54:32 +01:00
Michael Kerrisk d75c6df907 getentropy.3: SYNOPSIS: add missing return type for getentropy() declaration
Reported-by: Frank Theile

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-15 05:54:53 +01:00
Michael Kerrisk 7c5ad0dfb9 sigsetops.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-14 15:23:18 +01:00
Michael Kerrisk 31a1b45ece add_key.2, execve.2, fork.2, fsync.2, getrandom.2, getrlimit.2, getxattr.2, inotify_add_watch.2, ioctl.2, ioctl_fat.2, kcmp.2, keyctl.2, link.2, listxattr.2, lseek.2, madvise.2, mincore.2, mlock.2, nanosleep.2, poll.2, posix_fadvise.2, read.2, readv.2, recv.2, request_key.2, select.2, send.2, setxattr.2, sigaction.2, stat.2, statfs.2, syscall.2, tkill.2, truncate.2, unlink.2, vfork.2, write.2, __ppc_set_ppr_med.3, aio_suspend.3, backtrace.3, bcmp.3, bcopy.3, bzero.3, exec.3, fopen.3, fts.3, ftw.3, getline.3, getmntent.3, getopt.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, memset.3, random.3, random_r.3, resolver.3, scandir.3, scanf.3, sem_post.3, sem_wait.3, setjmp.3, sleep.3, strerror.3, strverscmp.3, system.3, random.4, core.5, intro.5, resolv.conf.5, slabinfo.5, environ.7, ip.7, keyrings.7, man.7, persistent-keyring.7, pipe.7, process-keyring.7, random.7, session-keyring.7, signal-safety.7, signal.7, thread-keyring.7, unix.7, user-keyring.7, user-session-keyring.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-13 21:14:49 +01:00
Michael Kerrisk 4f9d01a93e backtrace.3: SEE ALSO: add addr2line(1) and gdb(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-07 09:26:56 +01:00
Michael Kerrisk cf3ecd874c posix_spawn.3: tfix
Reported-by: Paul Fee <paul.f.fee@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-03-03 15:43:05 +01:00
Michael Kerrisk 88f78c4aa7 ftw.3: Correctly handle use of stat info for FTW_NS in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:17:40 +01:00
Michael Kerrisk d252ac9d8b ftw.3: Clarify that stat buffer is undefined for FTW_NS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-24 05:15:07 +01:00
Michael Kerrisk e186d0ca34 mq_receive.3, mq_send.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk 1ce0421b98 mq_open.3: Include definition of the 'mq_attr' structure in this man page
Make the reader's life a little easier by saving them from
having to refer to mq_getattr(3).

Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk c1b9bce2ed mq_send.3: Refer to mq_overview(7) for details on range of message priority
Reported-by: Adam Martindale <adam.john.martindale@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-19 22:40:52 +01:00
Michael Kerrisk c76ea16ab4 fts.3: Clarify meaning of zero as 'instr' value for fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:18 +01:00
Michael Kerrisk 71ddeb19dc fts.3: Improve explanation of 'fts_errno'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 90882d77f2 fts.3: Give a hint that there are further fields in the FTSENT structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 6110d89af1 fts.3: Fix minor error in FTSENT structure definition
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 17b0c3ad68 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 822ffd7cb6 fts.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:17 +01:00
Michael Kerrisk 1fcf641193 fts.3: Use better argument name for fts_children() and fts_set()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-10 08:58:07 +01:00
Michael Kerrisk 8b65f73d05 fts.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 20:03:47 +01:00
Michael Kerrisk 5c71ea83df fts.3: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk c9e5b0e128 fts.3: Minor fix: make the meaning of "stream" a little more obvious
"Stream" was used lower in the page, without first
being defined.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk f6c7968375 fts.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk 58c744401a fts.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 12:10:58 +01:00
Michael Kerrisk 211c7df8cf hsearch.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-05 08:50:24 +01:00
Michael Kerrisk 1ed246aedd printf.3: Fix a small bug in example code
Move the second call to va_end(ap) to above the if-block that
precedes it, so that the va_list 'ap' will be cleaned up in
all cases.

Reported-by: Erik Roland van der Meer <ervdmeer@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:33:04 +13:00
Michael Kerrisk 5d048f53d3 strerror.3: Minor tweak's to Heinrich Schuchardt's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:13:02 +13:00
Michael Kerrisk 154e01afc1 strerror.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:11:37 +13:00
Heinrich Schuchardt e9cf84ab1d strerror.3: Indicate reasonable buffer size for strerror_r() and strerror_l()
Add a hint which buffer size is needed for
strerror_r() and strerror_l().

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 09:09:51 +13:00
Michael Kerrisk 9f2791e93e explicit_bzero.3: New link to bzero.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00
Michael Kerrisk 55e04d2370 bzero.3: Document explicit_bzero() (new in glibc 2.25)
Also, reword the description of bzero somewhat.

By now, over time, I've completely rewritten the page,
so change the copyright as well.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00
Michael Kerrisk 879091c911 bcmp.3, bcopy.3, bzero.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, memset.3: SEE ALSO: add bstring(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-02-02 08:25:18 +13:00
Erik Kline 768b58c715 getenv.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-27 08:45:31 +13:00
Michael Kerrisk b59a4ee7bf scanf.3: Document the quote (') modifier for decimal conversions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 14:53:33 +13:00
Michael Kerrisk 2b609f22c4 printf.3: Add references to setlocale(3) in discussions of locales
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 14:53:33 +13:00
Michael Kerrisk 5d717bda58 printf.3: As a nonstandard extension, GNU treats 'll' and 'L' as synonyms
See https://bugzilla.kernel.org/show_bug.cgi?id=190341.

Reported-by: Nadav Har'El  <nyh@math.technion.ac.il>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:41:48 +13:00
Michael Kerrisk 1b8d305469 printf.3: Document nonstandard 'Z' modifier
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:20:50 +13:00
Michael Kerrisk 74b9e29f92 printf.3: Document 'q' length modifier
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:20:50 +13:00
Michael Kerrisk e00916fdee random_r.3: tfix
Reported-by: Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-26 09:10:30 +13:00
Tadeusz Struk 58b9f0ebb9 readdir.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 13:09:18 +13:00
Michael Kerrisk accc82d2d4 getopt.3: Correct details of use of <stdio.h> to get getopt() declaration
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 11:41:51 +13:00
Michael Kerrisk a4746c3978 getopt.3: Reword discussion of error handling and reporting
The existing description was hard to understand. Break
it into a bullet list that separates out the details
in a manner that is easier to parse.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 10:29:14 +13:00
Michael Kerrisk 797438e749 getopt.3: Remove redundant text
The same information is described in two consecutive paragraphs.
Remove the shorter paragraph, leaving the longer one that
contains more information.

Reported-by: John Wiersba <jrw32982@yahoo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 10:04:27 +13:00
Michael Kerrisk 606b226bd2 random_r.3: Add BUGS section pointing out the weirdness of the initstate_r() API
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:54:36 +13:00
Michael Kerrisk 516a39595e random_r.3: Note that 'buf' records a pointer to 'statebuf'
See https://sourceware.org/bugzilla/show_bug.cgi?id=3662.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:49:08 +13:00
Michael Kerrisk a689fdb223 random.3: Minor improvement to wording in NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:38:21 +13:00
Michael Kerrisk f9a54fa1cd random.3: Relocate information of "optimal" value of initstate() 'n' argument
The information was a bit hidden in NOTES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:32:21 +13:00
Michael Kerrisk 4efbcb17e9 random_r.3: Add some usage notes for setstate_r()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 09:00:12 +13:00
Michael Kerrisk 91e37268d6 random_r.3: 'buf.state' must be initialized to NULL before calling initstate_r()
See https://bugzilla.kernel.org/show_bug.cgi?id=192801.

See also the glibc source file string/strfry.c, which shows
an example of this initialization:

  if (!init)
    {
      static char state[32];
      rdata.state = NULL;
      __initstate_r (time ((time_t *) NULL) ^ getpid (),
                     state, sizeof (state), &rdata);
      init = 1;
    }

Reported-by: Jan Ziak <0xe2.0x9a.0x9b@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 08:43:38 +13:00
Michael Kerrisk 729b84f473 strverscmp.3: Fix comparison error in example program
Reported-by: Vivenzio Pagliari <vivenzio.pagliari@nokia.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 07:41:44 +13:00
Michael Kerrisk c67f5ff2f9 sem_wait.3: Remove statement that SA_RESTART does not cause restarting
This has not been true since Linux 2.6.22. The description
of EINTR maintains a reference to signal(7), which explains
the historical details.

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

Reported-by: Fabjan Sukalia <fsukalia@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk 1b1069ee02 getline.3: Handle null bytes in input
As reported by Kent:

    The example input/output handler in this EXAMPLE is subject
    to introducing subtle bugs if the input stream contains
    literal null bytes.

    Subsequently, there should be some warning that this occurs,
    or an alternative using fwrite(3) might be better.

Change the example program to use fwrite(3).

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

Reported-by: Kent Fredic <kentfredric@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk 0885f9504f getline.3: EXAMPLE: better error handling
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk cbc616e345 getline.3: EXAMPLE: specify file to be opened as command-line argument
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk 71fd04a347 getline.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk 809b6c47cc getline.3: Use better variable name in example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:14:06 +13:00
Michael Kerrisk b026572816 getentropy.3: New page documenting getentropy(3)
getentropy(3) is added to glibc in version 2.25.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:03:15 +13:00
Michael Kerrisk 26cfa7d300 system.3: In the glibc implementation, fork handlers are not executed by system()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-25 00:02:47 +13:00
Michael Kerrisk b557e5650b resolver.3: RES_USE_INET6 is deprecated since glibc 2.25
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-14 08:00:17 +13:00
Michael Kerrisk 414c75f0dd resolver.3: Note that RES_BLAST was unimplemented and is now deprecated
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-14 08:00:17 +13:00
Michael Kerrisk 023ef92770 resolver.3: RES_AAONLY, RES_PRIMARY, RES_NOCHECKNAME, RES_KEEPTSIG are deprecated
These options were never implemented; since glibc 2.25, they
are deprecated.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-14 08:00:07 +13:00
Michael Kerrisk ee5fa04005 resolver.3: RES_USEBSTRING was removed in glibc 2.25
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-14 07:02:52 +13:00
Michael Kerrisk 17d9e0033f resolver.3, resolv.conf.5: Note that RES_USEBSTRING defaults to off
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-14 06:57:30 +13:00
Michael Kerrisk 10863e5f54 resolver.3: The RES_NOIP6DOTINT is removed in glibc 2.25
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-14 06:27:27 +13:00
Michael Kerrisk ad56cef4b2 getmntent.3: Prefer '\\' as the escape to get a backslash
See https://bugzilla.kernel.org/show_bug.cgi?id=191611

Reported-by: Anders Thulin <anders@thulin.name>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-05 17:17:41 +13:00
Michael Kerrisk af500011b7 fopen.3: Change argument name: 'path' to 'pathname'
For consistency with open(2).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-05 15:49:40 +13:00
Michael Kerrisk 7eed8a8f10 fopen.3: Describe freopen() behavior for NULL pathname argument
See https://bugzilla.kernel.org/show_bug.cgi?id=191261

Reported-by: Helmut Eller <eller.helmut@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-05 15:45:01 +13:00
Michael Kerrisk a8250b9163 fopen.3: Note the open(2) flags that correspond to the 'mode' argument
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-05 15:33:13 +13:00
Michael Kerrisk f6386ed6ab fopen.3: Add subsection headings for each function
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-05 15:25:12 +13:00
Michael Kerrisk c67f4a0ab2 fopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-05 15:24:31 +13:00
Jakub Wilk 0f895aa045 aio_suspend.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-01-04 15:25:17 +13:00
Michael Kerrisk 49a93479b6 __ppc_set_ppr_med.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-28 11:44:41 +01:00
Wainer dos Santos Moschetta 831f5b9a38 __ppc_set_ppr_med.3: Note need for _ARCH_PWR8 macro
The _ARCH_PWR8 macro must be defined to get the
 __ppc_set_ppr_very_low() and __ppc_set_ppr_med_high()
definitions.

Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-28 11:42:42 +01:00
Jann Horn a2db5b9d18 getline.3: Document ENOMEM error case
see the error handling in libio/iogetdelim.c

Signed-off-by: Jann Horn <jannh@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-27 17:40:56 +01:00
Michael Kerrisk 09c8844a8b newlocale.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:55 +01:00
Michael Kerrisk 029d9a0744 xdr.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:55 +01:00
Michael Kerrisk 22b1b7524e printf.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:55 +01:00
Michael Kerrisk c4c97d9f79 exec.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:54 +01:00
Michael Kerrisk bcb464e275 error.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:54 +01:00
Michael Kerrisk 344254ad6f getspnam.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:54 +01:00
Michael Kerrisk a39dc3ee44 gethostbyname.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:54 +01:00
Michael Kerrisk ad8a05758b printf.3: SEE ALSO: remove bogus self reference (dprintf(3))
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-17 10:33:47 +01:00
Michael Kerrisk e1d2d7740e scandir.3: Minor reworking of text for example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-15 14:30:43 +01:00
Michael Kerrisk 9a96fb657c scandir.3: Improve logic of the example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-15 14:30:43 +01:00
Michael Kerrisk 5e84ae6cd6 scandir.3: Fix errors in example program
See http://bugs.debian.org/848231.

Reported-by: Ian Jackson <ijackson@chiark.greenend.org.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-15 14:30:43 +01:00
Michael Kerrisk 330e88474e sleep.3: Note that sleep() is implemented via nanosleep(2)
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.

Reported-by: Mike Frysiner <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 09:31:21 +01:00
Michael Kerrisk 0d28787bbd sleep.3: Convert BUGS text to "Portability notes" subsection
The existing text is not a bug, as such.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 09:27:39 +01:00
Michael Kerrisk 5272b4c4a4 sleep.3: Note that sleep() sleeps for a real-time number of seconds
See https://bugzilla.kernel.org/show_bug.cgi?id=73371.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 09:22:05 +01:00
Michael Kerrisk 5288e1f5ee sleep.3: DESCRIPTION: minor reworking
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 09:18:08 +01:00
Michael Kerrisk 1f6cc4a614 sleep.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-13 09:13:10 +01:00
Michael Kerrisk ff1203e5c2 exec.3: execl() and execle() were not async-signal-safe before glibc 2.24
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk aa30b3276d aio_suspend.3: Note that the glibc implementation is not async-signal-safe
See https://sourceware.org/bugzilla/show_bug.cgi?id=13172

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk 46fc35d52b sem_post.3, setjmp.3: SEE ALSO: add signal-safety(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 12:53:05 +01:00
Michael Kerrisk 1b9d581944 Removed trailing white space at end of lines 2016-12-12 10:47:17 +01:00
Michael Kerrisk 35deeb8703 bind.2, chmod.2, chown.2, chroot.2, clock_getres.2, clone.2, connect.2, dup.2, fallocate.2, get_mempolicy.2, getpeername.2, getpriority.2, getsockname.2, getsockopt.2, gettimeofday.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, kill.2, mbind.2, mmap.2, mount.2, mprotect.2, nfsservctl.2, nice.2, open.2, perf_event_open.2, pipe.2, pkey_alloc.2, prctl.2, ptrace.2, quotactl.2, remap_file_pages.2, sched_setscheduler.2, set_mempolicy.2, signal.2, signalfd.2, swapon.2, sync_file_range.2, syscalls.2, timer_create.2, timerfd_create.2, utime.2, utimensat.2, wait.2, atof.3, ctime.3, errno.3, fclose.3, fflush.3, insque.3, malloc_get_state.3, mallopt.3, mbsnrtowcs.3, mq_close.3, mq_open.3, mq_receive.3, mq_send.3, printf.3, pthread_attr_init.3, pthread_create.3, pthread_setaffinity_np.3, ptsname.3, remainder.3, strtod.3, tgamma.3, timegm.3, tmpnam.3, ttyname.3, console_ioctl.4, elf.5, filesystems.5, proc.5, utmp.5, capabilities.7, cgroups.7, credentials.7, ddp.7, feature_test_macros.7, fifo.7, inotify.7, libc.7, mount_namespaces.7, namespaces.7, netlink.7, pid_namespaces.7, pkeys.7, shm_overview.7, standards.7, uri.7, user_namespaces.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-12 10:45:24 +01:00
Michael Kerrisk 60ab7e075d setjmp.3: _BSD_SOURCE must be *explicitly* defined to get BSD setjmp() semantics
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-11 10:11:33 +01:00
Michael Kerrisk 82f634f14c setjmp.3: Repair changes to description of pre-2.19 glibc default behavior
The changes in commit 2ae4c26dec were a mistake.
The System V behavior was always the default for setjmp(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-11 10:11:29 +01:00
Michael Kerrisk 790980e004 getlogin.3: Remove deprecated _REENTRANT from FTM requirements for getlogin_r()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-10 15:20:21 +01:00
Michael Kerrisk d1902a5280 setjmp.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-10 12:22:29 +01:00
Michael Kerrisk f65efcf5b3 fclose.3, fflush.3: SEE ALSO: add fileno(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-10 10:56:12 +01:00
Michael Kerrisk 1ca319aff8 fclose.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-10 10:51:21 +01:00
Michael Kerrisk 5a9fb6b65f insque.3: Remove mention of ancient systems (libc4 and libc5)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-09 13:21:56 +01:00
Michael Kerrisk d6559159a0 setjmp.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-09 09:33:26 +01:00
Michael Kerrisk 010783703f setjmp.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-09 09:28:51 +01:00
Michael Kerrisk 2ae4c26dec setjmp.3: Improve description of pre-2.19 glibc default behavior
Make it clearer that the default FTM settings result in
BSD semantics for setjmp().

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-09 09:25:49 +01:00
Michael Kerrisk 503a47c546 basename.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-09 09:06:11 +01:00
Michael Kerrisk bcdd78a0e0 mq_close.3: DESCRIPTION: add reference to mq_notify(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-08 14:06:34 +01:00
Michael Kerrisk 91d5e32f68 tmpnam.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-08 14:06:02 +01:00
Michael Kerrisk 0230194808 tmpnam.3: Properly document tmpnam_r(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-08 09:38:08 +01:00