Commit Graph

6260 Commits

Author SHA1 Message Date
Michael Kerrisk a6be81bab9 system.3: Create a "Caveats" subsection to hold warnings about the use of system()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-20 14:54:00 +01:00
Seonghun Lim 0fd299bf6c strverscmp.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:34:05 +01:00
Seonghun Lim d42ffdf8e3 sockatmark.3: Fix cruft in code example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:33:26 +01:00
Seonghun Lim 35ed4d7ea0 random_r.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:30:29 +01:00
Seonghun Lim 6da3279c45 stdio.3: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:28:08 +01:00
Seonghun Lim 6968bea38c stdin.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:27:07 +01:00
Seonghun Lim be4c9c66c1 atexit.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-09 09:26:36 +01:00
Lucas Werkmeister e4631a3524 system.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-07 23:14:27 +01:00
Michael Kerrisk 247bbcf00c ffs.3: glibc 2.27 relaxes the FTM requriements for ffsl() nand ffsll()
glibc 2.27 relaxes the FTM requriements for ffsl() and
ffsll() to _DEFAULT_SOURCE.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-11-02 08:20:26 +01:00
Michael Kerrisk 5f70d096ae stdio.3: Remove crufty reference to pc(1)
I'm not sure what compiler is referred to by "pc(1)",
but "dnf whatprovides" and web searches turn up no
mention of a compiler by that name.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-29 13:23:55 +01:00
Michael Kerrisk 3242546c6e stdio.3: Use proper section cross references in function list
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-29 13:23:55 +01:00
G. Branden Robinson 9ab7f611ed Replace Latin abbreviation "cf.".
People seem to be using "cf." ("confere"), which means "compare",
to mean "see" instead, for which the Latin abbreviation would be
"q.v." ("quod vide" -> "which see").

In some cases "cf." might actually be the correct term but it's
still not clear what specific aspects of a function/system call
one is supposed to be comparing.

I left one use in place in hope of obtaining clarification,
because it looks like it might be useful there, if contextualized.

Migrate these uses to English and add them to the list of
abbreviations to be avoided.

If the patch to vfork(2) is not accepted, then the cf. still needs
an \& after it because it is at the end of the line but not the
end of a sentence.

Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-27 17:39:33 +02:00
G. Branden Robinson 9b13f7700e connect.2, ioprio_set.2, dbopen.3, group.5, fifo.7: tfix
Fix nonstandard usage.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-23 06:41:59 +02:00
Michael Kerrisk 84fe93c843 infnan.3: Remove page
This function was in libc4 and libc5, but never part
of glibc. It ceased to be relevant nearly 20 years
ago. Time to remove the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 08:04:30 +02:00
G. Branden Robinson 59524c5eb3 pthread_spin_init(3): tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-22 07:50:53 +02:00
Michael Kerrisk 26cd31fd4a access.2, delete_module.2, eventfd.2, fallocate.2, fcntl.2, getrandom.2, init_module.2, open.2, seccomp.2, timerfd_create.2, openpty.3, pthread_spin_lock.3, shm_open.3, tempnam.3, fifo.7, keyrings.7, pid_namespaces.7, sched.7, thread-keyring.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:55:10 +02:00
Michael Kerrisk a23d8efafc capget.2, fanotify_init.2, fcntl.2, ioctl_tty.2, madvise.2, mbind.2, prctl.2, sched_setaffinity.2, hash.3, isgreater.3, posix_fallocate.3, sigvec.3, full.4, sd.4, wavelan.4, core.5, host.conf.5, epoll.7, signal.7, unix.7, user_namespaces.7: wfix (will fail --> fail/fails)
Reported-by: Pedro Alves <palves@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 16:36:57 +02:00
Michael Kerrisk b858495171 pthread_spin_init.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 5017fc28ec pthread_spin_init.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 28c15b63d6 pthread_spin_init.3: Add more caveats on use of spin locks
Cowritten-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 34d46b816e pthread_spin_init.3: Strengthen note about when spin locks should (not) be used
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:49 +02:00
Michael Kerrisk 0e905edca8 pthread_spin_init.3: Operations on copies of *lock yield undefined behavior
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk eb93621d10 pthread_spin_init.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk af79528ece pthread_spin_lock.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 4eea22f5ae pthread_spin_lock.3: wfix
Reported-by: Zack Weinberg <zackw@panix.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 07fa47a568 pthread_spin_lock.3: Fixes suggested by Carlos O'Donell
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk f3861c72a9 pthread_spin_lock.3: Refer reader to important details in NOTES in pthread_spin_init(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 8cbd1d9e4d pthread_spin_init.3: Warn about deadlock with spin locks
Reported-by: Thomas Gleixner <tglx@linutronix.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 2dea72418d pthread_spin_init.3: Spin locks should be used with real-time scheduling policies
Reported-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 41041696d3 pthread_yield.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 77e0fbc201 pthread_spin_trylock.3, pthread_spin_unlock.3: New links to new pthread_spin_lock3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk ce42a8cf5f pthread_spin_lock.3: New page describing functions that lock and unlock spin locks
Add a page descrbing pthread_spin_lock(3), pthread_spin_unlock(3),
and pthread_spin_trylock(3).

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 14bffcef9c pthread_spin_destroy.3: New link to new pthread_spin_init.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk 7f5f8925ce pthread_spin_init.3: New page describing pthread_spin_init(3) and pthread_spin_destroy(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-20 10:20:48 +02:00
Michael Kerrisk cddd55a004 pthread_yield.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:58:54 +02:00
Michael Kerrisk d304c13dac posix_fallocate.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 9ea5bc667b clone.2, getcpu.2, shmget.2, syscall.2, dladdr.3, proc.5, vdso.7: Consistently use "x86-64", not "x86_64"
When referring to the architecture, consistently use "x86-64",
not "x86_64". Hitherto, there was a mixture of usages, with
"x86-64" predominant.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-18 09:26:12 +02:00
Michael Kerrisk 98f24fc65c abort.3: SEE ALSO: add assert(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 16:19:58 +02:00
Michael Kerrisk 46dc471b8d abort.3: Starting with glibc 2.27, abort() does not attempt to flush streams
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 16:19:47 +02:00
Fangrui Song 8a3f19c369 pow10.3: tfix
Signed-off-by: Fangrui Song <i@maskray.me>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-08 10:52:25 +02:00
Jakub Wilk e40be343f7 mallinfo.3: Fix the example
Remove reference to non-standard "tlpi_hdr.h" and replace calls to
functions that were declared in this header.

Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-05 20:34:40 +02:00
Michael Kerrisk 2050975ecc setlocale.3: The standards do not specify all of the locale categories
Reported-by: Křištof Želechovski <giecrilj@stegny.2a.pl>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-10-03 15:23:37 +02:00
Michael Kerrisk 46f2cf80f4 pthread_yield.3: pthread_yield() is intended for use with real-time scheduling policies
Reported-by: Peter Zijlstra <peterz@infradead.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 22:46:28 +02:00
Michael Kerrisk 454f90d7b7 backtrace.3: Minor tweaks to Stefan Puiu's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 20:36:55 +02:00
Stefan Puiu ca5d5169cb backtrace_symbols_fd() can trigger a call to malloc()
Currently, the backtrace(3) manual page says this about backtrace_symbols_fd():

back‐
       trace_symbols_fd() does not call malloc(3), and so can be
employed in situations where the latter function might fail.

However, I watched a video of a presentation about signal handling and
the speaker was saying that calling backtrace() can trigger a call to
malloc - indirectly. That happens because the backtrace*() functions
are part of libgcc, which gets dynamically loaded whenever needed;
dynamic loading would, in turn, trigger a malloc. The talk can be
found here: http://free-electrons.com/pub/video/2008/ols/ols2008-gilad-ben-yossef-fault-handlers.ogg

I decided to test it out, and it seems that this is still true (at
least on Ubuntu 12.04). I compiled the attached program (I used
CXXFLAGS = '-Wall -g -std=c++0x', the -std= part is not really needed)
and ran it through gdb, putting a breakpoint on the line where
backtrace is called. When that breakpoint is hit, I set a breakpoint
on malloc, continued and voila:

Breakpoint 2, __GI___libc_malloc (bytes=36) at malloc.c:2910
2910    malloc.c: No such file or directory.
(gdb) bt
"/lib/x86_64-linux-gnu/libgcc_s.so.1") at dl-load.c:162
"libgcc_s.so.1", type=2, trace_mode=0, mode=-1879048191,
nsid=<optimized out>) at dl-load.c:2473
errstring=0x7fffffffdd00, mallocedp=0x7fffffffdd0f,
operate=0x7ffff7ded700 <dl_open_worker>, args=0x7fffffffdcb0) at
dl-error.c:178
"libgcc_s.so.1", mode=-2147483647, caller_dlopen=0x7ffff7b260a9,
nsid=-2, argc=1, argv=<optimized out>, env=0x7fffffffe068) at
dl-open.c:639
errstring=0x7fffffffded0, mallocedp=0x7fffffffdeef,
operate=0x7ffff7b4bc20 <do_dlopen>, args=0x7fffffffdeb0) at
dl-error.c:178
operate=0x7ffff7b4bc20 <do_dlopen>) at dl-libc.c:48
out>) at dl-libc.c:165
../sysdeps/x86_64/../ia64/backtrace.c:104

Reviewed-by: Walter Harms <wharms@bfs.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 20:32:23 +02:00
Michael Kerrisk 76f23c9448 pthread_detach.3: Improve sentence describing freeing of resources on process termination
As reported by Rahul, the existing sentence could be read as
meaning that resources of joined and terminated detached
threads are freed at only at process termination. Eliminate
that possible misreading.

Reported-by: Rahul Bedarkar <rpal143@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-29 18:24:22 +02:00
Mike Frysinger 3144b41214 perror.3: tfix: add missing period
Signed-off-by: Mike Frysinger <vapier@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 17:21:12 +02:00
Michael Kerrisk f6cf8f80bc lround.3: Minor tweaks to .TH line
A further follow-up to
https://bugzilla.kernel.org/show_bug.cgi?id=194601

Reported-by: David Eckardt <david.eckardt@sociomantic.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-28 08:56:18 +02:00
Michael Kerrisk 940bdd7ece daemon.3: SEE ALSO: add daemon(7)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 13:06:24 +02:00
Michael Kerrisk f620444aea malloc.3: SEE ALSO: add valgrind(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:14:07 +02:00
Michael Kerrisk 8f7a89b0fb daemon.3: SEE ALSO: add logrotate(8)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 12:05:09 +02:00
Michael Kerrisk 39a6b7e8fb sysconf.3: Mention get_nprocs_conf(3)
Mention get_nprocs_conf(3) in discussion of _SC_NPROCESSORS_CONF
and _SC_NPROCESSORS_ONLN.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 11:53:51 +02:00
Michael Kerrisk c9cfbbe945 get_nprocs_conf.3: SEE ALSO: add nproc(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 11:53:16 +02:00
Michael Kerrisk a448a0c6c3 get_nprocs_conf.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-25 11:51:26 +02:00
Michael Kerrisk ce08dedca4 lround.3: Clarify that lround() rounds *halfway cases" away from zero
See https://bugzilla.kernel.org/show_bug.cgi?id=194601

Reported-by: David Eckardt <david.eckardt@sociomantic.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-24 09:53:49 +02:00
Julien Gomes 13e69b6c6a openpty.3: tfix
Signed-off-by: Julien Gomes <julien@arista.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 10:04:56 +02:00
Michael Kerrisk c551100943 fexecve.3: Add some detail on the glibc implementation of fexecve() via execveat(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 136badedfd fexecve.3: Minor tweaks to Cristian's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Cristian Rodríguez b71753c1fc fexecve.3: fexecve() is now implemented with execveat(2), where available
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-22 08:44:18 +02:00
Michael Kerrisk 046a128700 fexecve.3: O_PATH file descriptors are also usable with fexecve()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-16 15:38:21 +02:00
Michael Kerrisk 4b8c67d976 iconv.1, ldd.1, locale.1, localedef.1, memusage.1, memusagestat.1, mtrace.1, pldd.1, sprof.1, time.1, _syscall.2, add_key.2, alloc_hugepages.2, arch_prctl.2, bpf.2, cacheflush.2, capget.2, chdir.2, chmod.2, chown.2, chroot.2, clock_getres.2, clock_nanosleep.2, clone.2, close.2, connect.2, copy_file_range.2, create_module.2, delete_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, fallocate.2, fanotify_init.2, fcntl.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdents.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, init_module.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, intro.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_console.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, ioctl_tty.2, ioctl_userfaultfd.2, ioperm.2, iopl.2, ioprio_set.2, ipc.2, kcmp.2, kexec_load.2, keyctl.2, kill.2, link.2, listen.2, listxattr.2, llseek.2, lookup_dcookie.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, open.2, open_by_handle_at.2, outb.2, perf_event_open.2, perfmonctl.2, personality.2, pivot_root.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, read.2, readahead.2, readdir.2, readlink.2, readv.2, reboot.2, recv.2, recvmmsg.2, remap_file_pages.2, rename.2, request_key.2, restart_syscall.2, rt_sigqueueinfo.2, s390_pci_mmio_write.2, s390_runtime_instr.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, seccomp.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, sendmmsg.2, set_mempolicy.2, set_thread_area.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, sgetmask.2, shmctl.2, shmget.2, shmop.2, sigaction.2, sigaltstack.2, signal.2, sigpending.2, sigprocmask.2, sigreturn.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, splice.2, spu_create.2, spu_run.2, stat.2, statfs.2, statx.2, subpage_prot.2, swapon.2, symlink.2, sync.2, sync_file_range.2, syscall.2, syscalls.2, sysctl.2, sysfs.2, sysinfo.2, syslog.2, tee.2, time.2, timer_create.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unimplemented.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vmsplice.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, acos.3, acosh.3, adjtime.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, backtrace.3, basename.3, bindresvport.3, bsd_signal.3, bsearch.3, bswap.3, btree.3, byteorder.3, bzero.3, canonicalize_file_name.3, carg.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cfree.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, cmsg.3, confstr.3, copysign.3, cos.3, cosh.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, finite.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fopen.3, fopencookie.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, frexp.3, fseek.3, fseeko.3, ftime.3, fts.3, ftw.3, futimes.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getumask.3, getutent.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, inet.3, inet_net_pton.3, inet_ntop.3, inet_pton.3, initgroups.3, insque.3, intro.3, isalpha.3, isgreater.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, posix_spawn.3, pow.3, pow10.3, printf.3, profil.3, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, putgrent.3, putpwent.3, qsort.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, strcasecmp.3, strcat.3, strchr.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strftime.3, strptime.3, strsignal.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, trunc.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, unlocked_stdio.3, updwtmp.3, uselocale.3, usleep.3, wcrtomb.3, wcsdup.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctob.3, wcwidth.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3, cciss.4, console_codes.4, dsp56k.4, fuse.4, hd.4, hpsa.4, initrd.4, intro.4, loop.4, random.4, rtc.4, sd.4, sk98lin.4, st.4, wavelan.4, acct.5, core.5, elf.5, filesystems.5, host.conf.5, hosts.5, locale.5, nologin.5, proc.5, resolv.conf.5, rpc.5, slabinfo.5, utmp.5, aio.7, arp.7, bootparam.7, capabilities.7, cgroup_namespaces.7, cgroups.7, charsets.7, cpuset.7, ddp.7, environ.7, epoll.7, fanotify.7, feature_test_macros.7, futex.7, inode.7, inotify.7, ip.7, ipv6.7, keyrings.7, locale.7, man-pages.7, man.7, math_error.7, mount_namespaces.7, mq_overview.7, namespaces.7, netdevice.7, netlink.7, packet.7, pipe.7, pkeys.7, pthreads.7, pty.7, raw.7, rtld-audit.7, rtnetlink.7, sched.7, session-keyring.7, signal.7, sock_diag.7, socket.7, spufs.7, suffixes.7, tcp.7, udp.7, udplite.7, unicode.7, units.7, unix.7, uri.7, user_namespaces.7, vdso.7, x25.7, xattr.7, iconvconfig.8, ld.so.8, ldconfig.8, sln.8: Update timestamps
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 12:44:56 +02:00
Yubin Ruan 91fd35ad46 pthread_mutexattr_setrobust.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:53:17 +02:00
Michael Kerrisk 336e15b267 malloc.3: Minor fix: reword to ease understanding
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:33:02 +02:00
Jonas Grabber c87d084b87 getrlimit.2, mmap.2, malloc.3: RLIMIT_DATA affects mmap (2) since Linux 4.7
Starting with Linux kernel 4.5 and 84638335900f1995
(mm: rework virtual memory accounting) RLIMIT_DATA affects
mmap(2).  With d977d56ce5b3e88 (mm: warn about VmData over
RLIMIT_DATA) only warnings are emmitted when going over the
specified RLIMIT_DATA in 4.5.

As of 4.7 and f4fcd55841fc9 (mm: enable RLIMIT_DATA by default
with workaround for valgrind) going over RLIMIT_DATA through
mmap(2) is forbidden.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-15 09:33:02 +02:00
Michael Kerrisk a40d006b5d strptime.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-14 15:47:15 +02:00
Michael Kerrisk 6c22b2c593 strchr.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-14 15:46:44 +02:00
Michael Kerrisk 1a14615c34 pthread_mutexattr_init.3: SEE ALSO: add pthread_mutexattr_getpshared(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 2fdf4c5f1e pthread_mutexattr_setpshared.3: New link to new pthread_mutexattr_getpshared.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk b967efeb5b pthread_mutexattr_getpshared.3: New page for pthread_mutexattr_getpshared(3) and pthread_mutexattr_setpshared.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 7cff199dfc pthread_mutexattr_destroy.3: New link to new pthread_mutexattr_init.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 9d48165364 pthread_mutexattr_init.3: New page for pthread_mutexattr_init(3) and pthread_mutexattr_destroy(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk a126d04055 pthread_mutex_consistent.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk cf5744eb46 pthread_mutex_consistent.3: Point out that the application must make shared data consistent
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:32 +02:00
Michael Kerrisk 2fe9fbf168 pthread_mutex_consistent.3: Clarify that EOWNERDEAD is returned by pthread_mutex_lock()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk a9e45d2423 pthread_mutex_consistent.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk f49ed5cd38 pthread_mutex_consistent.3: Refer to example in pthread_mutexattr_setrobust(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 77988d6276 pthread_mutex_consistent_np.3: New link to new pthread_mutex_consistent.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 99fa587d0d pthread_mutex_consistent.3: Mention pthread_mutex_consistent_np()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 5214dd2066 pthread_mutex_consistent.3: Add VERSIONS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk abdad18584 pthread_mutex_consistent.3: Add feature test macro requirements and CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk da9fc02934 pthread_mutex_consistent.3: srcfix: rewrap source lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk fcc827bc2d pthread_mutex_consistent.3: tfix: fix spelling errors and grammar
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk de2fba0e1a pthread_mutex_consistent.3: srcfix: remove blank lines
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 700b4034e9 pthread_mutexattr_setrobust.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 16:47:31 +02:00
Michael Kerrisk 8fbf748dd0 pthread_mutexattr_setrobust.3: SEE ALSO: add get_robust_list(2) and set_robust_list(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 5ede40bbc8 pthread_mutexattr_setrobust.3: On Linux execve(2) also causes EOWNERDIED notification
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 143e516fbd pthread_mutexattr_setrobust.3: Minor fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 8524bca574 pthread_mutexattr_setrobust.3: EXAMPLE: show example run of program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk f6569f44bd pthread_mutexattr_setrobust.3: Minor rewording in example
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk a205ca43a4 pthread_mutexattr_setrobust.3: Various improvements to the example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 5d26c00fc9 pthread_mutexattr_setrobust.3: EXAMPLE: use a more conventional name for the mutex variable
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk d1524d1813 pthread_mutexattr_setrobust.3: Various rewordings and improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 99afed9ead pthread_mutexattr_setrobust.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 5514936a31 pthread_mutexattr_setrobust.3: Add VERSIONS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 06ae85bd18 pthread_mutexattr_setrobust.3: Add feature test macro requirements plus CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 61265f77f7 pthread_mutexattr_setrobust.3: Move the "_np" interfaces to NOTES
Move the old GNU nonportable APIs into notes. Having them
in the main text is a distraction.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 52124b96e4 pthread_mutexattr_setrobust.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 37f0c285e1 pthread_mutexattr_setrobust.3: Fix minor type error in SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 4057660b6e pthread_mutexattr_setrobust.3: Minor tweaks to the example program
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk ad2825bf83 pthread_mutexattr_setrobust.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 2db681968e pthread_mutexattr_setrobust.3: Minor: spelling fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk f899f232b9 pthread_mutexattr_setrobust.3: srcfix: rewrap source lines at sentence boundaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 150a51c660 pthread_mutexattr_setrobust.3: srcfix: trim trailing white space
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 3a2b5cc7a9 pthread_mutexattr_setrobust.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 92e6bd77f2 pthread_mutexattr_setrobust_np.3: New link to new pthread_mutexattr_setrobust.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 1bb9b395d3 pthread_mutexattr_getrobust_np.3: New link to new pthread_mutexattr_setrobust.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 1c50bb7393 pthread_mutexattr_getrobust.3: New link to new pthread_mutexattr_setrobust.3 page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Yubin Ruan 6d7934260e pthread_mutex_consistent.3: New page documenting pthread_mutex_consistent(3)
Signed-off-by: Yubin Ruan <ablacktshirt@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Yubin Ruan cb5f05898c pthread_mutexattr_setrobust.3: New page describing robust mutex attribute functions
>Document pthread_mutexattr_setrobust(3) and
pthread_mutexattr_getrobust(3).

Signed-off-by: Yubin Ruan <ablacktshirt@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:45:09 +02:00
Michael Kerrisk 18523cfc81 exit.3: SEE ALSO: add get_robust_list(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:12:38 +02:00
Michael Kerrisk ee7c8e26e9 exit.3: Mention the prctl(2) PR_SET_PDEATHSIG operation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:10:27 +02:00
Michael Kerrisk 5088242f95 exit.3: Add a heading to delimit discussion of signals sent to other processes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:10:27 +02:00
Michael Kerrisk cffa795059 exit.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-13 15:10:27 +02:00
Michael Kerrisk 268bac1ffa sincos.3: Note that sincos() is intended to be more efficient than sin() + cos()
On a current x86-64 i7 system, sincos() is about 15% faster than
sin()+cos() according to the following test program.

/*
 * Build with: cc -O -lm -fno-fast-math -fno-builtin
 */

int
main(int argc, char *argv[])
{
    double arg, rsin, rcos;
    int loop, i;

    arg = strtod(argv[1], NULL);
    loop = 10000000;
    if (argc > 2)
        loop = atoi(argv[2]);

    if (argc > 3) {
        printf("sin + cos\n");
        for (i = 0; i < loop; i++) {
            rsin = sin(arg);
            rcos = cos(arg);
        }
    } else {
        printf("sincos\n");
        for (i = 0; i < loop; i++) {
            sincos(arg, &rsin, &rcos);
        }
    }
}

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-11 07:42:42 +02:00
Michael Kerrisk 6354e66208 pow10.3: Note that pow10() is now obsolete in favor of exp10()
Also, the pow10() functions are no longer supported by glibc,
starting with version 2.27.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 12:50:11 +02:00
Michael Kerrisk b9f5883bd5 pow10.3: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-10 08:49:54 +02:00
Michael Kerrisk d64b372593 add_key.2, backtrace.3, syslog.3: Fix misordered SEE ALSO entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 21:06:48 +02:00
Michael Kerrisk 3b3b8d5dcc getdents.2, ioctl_fat.2, mkdir.2, process_vm_readv.2, get_phys_pages.3, nextup.3, operator.7: srcfix: fix unbalanced .nf/.fi pairs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 20:43:22 +02:00
Michael Kerrisk a3847715fe clock_getres.2, ctime.3, tgamma.3: srcfix: fix unbalanced .RS/.RE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 20:38:25 +02:00
Michael Kerrisk 34a2ee189b ftw.3: Fix misordering of sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 18:08:09 +02:00
Michael Kerrisk a2d7a55eca cfree.3: Fix misordering of sections
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-06 18:07:04 +02:00
Michael Kerrisk 59d99553ae crypt.3: Note glibc version that added 'rounds' parameter
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 20:15:43 +02:00
Michael Kerrisk 42079b0179 crypt.3: Rework text describing 'rounds' parameter
The text reads a little more clearly if we talk about
'xxx' rather than 'the supplied number'.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 20:13:18 +02:00
Michael Kerrisk 4c130fabc3 crypt.3: Minor wording improvements to Konstantin's patches
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 20:13:18 +02:00
Konstantin Shemyak 84bee58c24 crypt.3: Add description of previously undocumented 'rounds' parameter
Files crypt/sha{256,512}-crypt.c in the glibc source define
macros:

    /* Default number of rounds if not explicitly specified.  */
    #define ROUNDS_DEFAULT 5000
    /* Minimum number of rounds.  */
    #define ROUNDS_MIN 1000
    /* Maximum number of rounds.  */
    #define ROUNDS_MAX 999999999

And the main encryption function __sha512_crypt_r() sets:

    rounds = MAX (ROUNDS_MIN, MIN (srounds, ROUNDS_MAX));

One can check that for example

    crypt("key", "$5$rounds=1$salt")

returns the string

    $5$rounds=1000$salt$PWLKU7MTJ0s5M/mjBPcqnMsorm3qKyoBctxmZ1mNwn2

This parameter has been introduced in glibc 2.7.

Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 19:49:35 +02:00
Konstantin Shemyak d32b36982d crypt.3: Clarify that ending of the salt string with '$' is optional
In crypt/sha512-crypt.c::__sha512_crypt_r() and the similar
sha256 function, the length of the actually used salt is
calculated as:

  salt_len = MIN (strcspn (salt, "$"), SALT_LEN_MAX);

Thus the trailing '$' is optional in the salt string. One can
check that

    crypt("key", "$5$salt")

yields the same result as

    crypt("key", "$5$salt$").

Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 19:48:35 +02:00
Konstantin Shemyak 893c609dcd crypt.3: Encryption isn't done with SHA-xxx, but with a function based on SHA-xxx
The encryption is done by glibc functions __shaxxx_crypt_r() in
files crypt/shaxxx-crypt.c. They implement a nontrivial algorithm
to construct the inputs for the hashing functions and to apply
them iteratively.

Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-05 19:47:52 +02:00
Konstantin Shemyak 266d8f7ef1 crypt.3: ffix
Signed-off-by: Konstantin Shemyak <konstantin@shemyak.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-09-04 01:27:21 +02:00
Michael Kerrisk 4d53aa005e MB_LEN_MAX.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 21:41:03 +02:00
Michael Kerrisk 2a2ecb8753 MB_LEN_MAX.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 21:41:03 +02:00
Michael Kerrisk b96315d884 queue.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 20:54:52 +02:00
Michael Kerrisk b5360edbd3 MB_CUR_MAX.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-25 20:51:31 +02:00
Michael Kerrisk 73593f0d3b matherr.3: Note that glibc 2.27 removes the 'matherr' mechanism
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-23 12:36:40 +02:00
Michael Kerrisk d4f849a29d matherr.3: Remove crufty feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-23 12:12:11 +02:00
Michael Kerrisk b48303402a sin.3, sincos.3, sinh.3, sqrt.3, stdio_ext.3, strdup.3, strfry.3, strtoimax.3, tan.3, tanh.3, toupper.3, trunc.3, updwtmp.3, wcstoimax.3, y0.3, sk98lin.4: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:41 +02:00
Michael Kerrisk 301adac41e setjmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:41 +02:00
Michael Kerrisk bfcd3eb0b3 __setfpucw.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:41 +02:00
Michael Kerrisk a0ce17b14f remquo.3, rint.3, round.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 13:07:37 +02:00
Michael Kerrisk 4a2b2c2ce1 regex.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:55:23 +02:00
Michael Kerrisk a1048f8e1d j0.3, ldexp.3, lgamma.3, log.3, log10.3, log1p.3, log2.3, lrint.3, lround.3, modf.3, netlink.3, opendir.3, pow.3, pow10.3, printf.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:55:02 +02:00
Michael Kerrisk 8f92fd96a8 INFINITY.3, exec.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fenv.3, fgetwc.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmod.3, fmtmsg.3, fpathconf.3, fpurge.3, fputwc.3, frexp.3, getgrent_r.3, getgrnam.3, gethostbyname.3, glob.3, hsearch.3, hypot.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:50:24 +02:00
Michael Kerrisk 3f89e93db7 encrypt.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:44:34 +02:00
Michael Kerrisk c8ee75723b confstr.3, copysign.3, cos.3, cosh.3, cpow.3, crypt.3, ctime.3, div.3, drand48_r.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:44:18 +02:00
Michael Kerrisk 9910d338e7 cmsg.3: Reorganize the text somewhat (no content changes)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:41:32 +02:00
Michael Kerrisk 79e1824a12 abs.3, acosh.3, aio_suspend.3, asin.3, asinh.3, atan.3, atanh.3, atoi.3, cbrt.3, ceil.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:33:21 +02:00
Michael Kerrisk 7e4e1fdb60 strcat.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 12:16:46 +02:00
Michael Kerrisk 67f2fdfef6 queue.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:27:58 +02:00
Michael Kerrisk 692637965f string.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-20 10:00:05 +02:00
Michael Kerrisk b9c93deb3d getgroups.2, getrlimit.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, semop.2, difftime.3, getpw.3, malloc_hook.3, mbrtowc.3, newlocale.3, offsetof.3, pthread_tryjoin_np.3, rand.3, rtnetlink.3, setbuf.3, strtol.3, fuse.4, feature_test_macros.7, pkeys.7: ffix: fix mismatched .EX/.EE tags
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 22:16:47 +02:00
Michael Kerrisk 9bc87ed07a ctime.3, drand48.3, fmtmsg.3, getnameinfo.3, gsignal.3, strftime.3, strptime.3, cciss.4, console_codes.4, sd.4, sk98lin.4, st.4, proc.5, charsets.7, cpuset.7, pty.7, suffixes.7, udplite.7, unix.7: Use en-dash for ranges
Based on a patch by Bjarni Ingi Gislason.

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 22:01:55 +02:00
Michael Kerrisk d2fdb1e30a memusage.1, time.1, ioctl_console.2, mmap.2, msync.2, perf_event_open.2, syslog.2, strptime.3, hd.4, sd.4: Use en-dash for ranges
Based on a patch by Bjarni Ingi Gislason.

Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:42:31 +02:00
Michael Kerrisk c788525612 getrlimit.2, signalfd.2, statfs.2, tee.2, dlopen.3, duplocale.3, ftw.3, get_nprocs.3, mbstowcs.3, posix_spawn.3, strftime.3, full.4, fanotify.7, inotify.7, ip.7, netdevice.7, rtld-audit.7, unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 21:02:23 +02:00
Michael Kerrisk 408731d435 intro.1, locale.1, ioctl_list.2, listxattr.2, memfd_create.2, nfsservctl.2, open_by_handle_at.2, perf_event_open.2, poll.2, process_vm_readv.2, ptrace.2, select.2, select_tut.2, semop.2, sendmmsg.2, shmget.2, sigaction.2, spu_run.2, umask.2, wait4.2, nan.3, setlocale.3, feature_test_macros.7, glob.7, posixoptions.7, rtld-audit.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk a2b7a14421 sinh.3, sockatmark.3, stdarg.3, stpcpy.3, syslog.3, system.3, tanh.3, termios.3, wctrans.3, wctype.3, wcwidth.3, wordexp.3, cciss.4, fuse.4, initrd.4, loop.4, acct.5, hosts.5, nss.5, operator.7, unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk 207050fa9e _syscall.2, shmget.2, stat.2, syscall.2, sysctl.2, utimensat.2, wait.2, CPU_SET.3, a64l.3, alloca.3, atexit.3, basename.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, ccos.3, ccosh.3, cexp.3, cimag.3, clearenv.3, clog.3, conj.3, cosh.3, creal.3, csin.3, csinh.3, ctan.3, ctanh.3, difftime.3, div.3, dl_iterate_phdr.3, encrypt.3, envz_add.3, expm1.3, fenv.3, fmtmsg.3, fopen.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getcontext.3, getline.3, getpt.3, getpwnam.3, getsubopt.3, getttyent.3, getutent.3, hsearch.3, log1p.3, malloc_hook.3, malloc_info.3, mallopt.3, matherr.3, mbsinit.3, mempcpy.3, mtrace.3, nan.3, nl_langinfo.3, printf.3, pthread_setaffinity_np.3, pthread_tryjoin_np.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, sigvec.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk b8302363ed execve.2, ioctl_console.2, ioctl_iflags.2, ioctl_ns.2, ioctl_userfaultfd.2, kcmp.2, kexec_load.2, keyctl.2, link.2, listxattr.2, membarrier.2, memfd_create.2, mmap.2, modify_ldt.2, mprotect.2, msgctl.2, nanosleep.2, open_by_handle_at.2, perf_event_open.2, poll.2, posix_fadvise.2, process_vm_readv.2, ptrace.2, query_module.2, quotactl.2, readdir.2, readv.2, recv.2, recvmmsg.2, request_key.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setattr.2, sched_setscheduler.2, seccomp.2, select.2, select_tut.2, semctl.2, semop.2, send.2, sendmmsg.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sigaltstack.2, signal.2, sigwaitinfo.2, stat.2, statfs.2, statx.2, sync_file_range.2, syscall.2, sysctl.2, sysinfo.2, tee.2, timer_create.2, timer_settime.2, timerfd_create.2, unshare.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, aio_init.3, backtrace.3, basename.3, bswap.3, btree.3, clock_getcpuclockid.3, cmsg.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlinfo.3, dlopen.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, ether_aton.3, fgetgrent.3, fgetpwent.3, fmemopen.3, frexp.3, ftime.3, fts.3, getaddrinfo.3, getaddrinfo_a.3, getdate.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getmntent.3, getnameinfo.3, getnetent.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getservent.3, getservent_r.3, getspnam.3, getttyent.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallinfo.3, malloc_info.3, mallopt.3, matherr.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, ntp_gettime.3, posix_openpt.3, printf.3, pthread_attr_init.3, pthread_attr_setschedparam.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_tryjoin_np.3, readdir.3, realpath.3, recno.3, regex.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, statvfs.3, strcat.3, strcpy.3, strftime.3, strtok.3, strtol.3, strverscmp.3, toupper.3, ttyslot.3, xdr.3, fuse.4, loop.4, rtc.4, st.4, acct.5, core.5, elf.5, slabinfo.5, aio.7, arp.7, capabilities.7, cgroup_namespaces.7, cgroups.7, ddp.7, fanotify.7, feature_test_macros.7, inode.7, inotify.7, ip.7, keyrings.7, locale.7, mount_namespaces.7, namespaces.7, netdevice.7, netlink.7, packet.7, pkeys.7, pthreads.7, sched.7, session-keyring.7, sock_diag.7, socket.7, spufs.7, udplite.7, unix.7, user_namespaces.7, vdso.7, x25.7, ld.so.8: Use consistent markup for code snippets
Change .nf/.fi to .EX/.EE

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:27 +02:00
Michael Kerrisk e646a1bad9 ioctl_console.2, ioctl_getfsmap.2, ioctl_iflags.2, ioctl_list.2, ioctl_ns.2, kcmp.2, kexec_load.2, keyctl.2, link.2, mmap.2, modify_ldt.2, msgctl.2, poll.2, query_module.2, quotactl.2, recv.2, recvmmsg.2, sched_setscheduler.2, seccomp.2, select.2, semctl.2, semop.2, send.2, set_thread_area.2, setns.2, shmctl.2, shmget.2, sigaction.2, sysinfo.2, timer_create.2, timerfd_create.2, uname.2, unshare.2, userfaultfd.2, ustat.2, utimensat.2, vmsplice.2, wait.2, adjtime.3, backtrace.3, bswap.3, btree.3, clock_getcpuclockid.3, confstr.3, dbopen.3, dl_iterate_phdr.3, dlinfo.3, duplocale.3, encrypt.3, end.3, endian.3, err.3, errno.3, fmemopen.3, fopencookie.3, frexp.3, fts.3, ftw.3, getaddrinfo.3, getaddrinfo_a.3, getcontext.3, getgrouplist.3, getifaddrs.3, getipnodebyname.3, getnameinfo.3, getopt.3, getprotoent_r.3, getpwent_r.3, getrpcent.3, getservent_r.3, getttyent.3, getumask.3, glob.3, gnu_get_libc_version.3, hash.3, hsearch.3, inet.3, inet_pton.3, insque.3, isalpha.3, makecontext.3, mallopt.3, mbstowcs.3, mcheck.3, memchr.3, mq_getattr.3, mq_open.3, mtrace.3, newlocale.3, ntp_gettime.3, offsetof.3, posix_openpt.3, printf.3, pthread_setname_np.3, pthread_setschedparam.3, rpc.3, scanf.3, sched_getcpu.3, sem_wait.3, setaliasent.3, sigqueue.3, sigvec.3, stdarg.3, strcat.3, strcpy.3, strftime.3, strtol.3, toupper.3, ttyslot.3, fuse.4, loop.4, st.4, elf.5, cgroup_namespaces.7, cgroups.7, feature_test_macros.7, inode.7, inotify.7, keyrings.7, man-pages.7, math_error.7, mount_namespaces.7, mq_overview.7, pthreads.7, sched.7, session-keyring.7, udplite.7, unix.7, vdso.7: Use consistent markup for code snippets
The preferred form is

    .PP/.IP
    .in +4n
    .EX
    <code>
    .EE
    .in
    .PP/.IP

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:26 +02:00
Michael Kerrisk c4b7e5ac34 add_key.2, alloc_hugepages.2, execve.2, fanotify_init.2, getrlimit.2, listxattr.2, mmap.2, shmget.2, malloc.3, random.4, st.4, bootparam.7, epoll.7, keyrings.7, pipe.7, xattr.7: Use non-breaking space for measurement units
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-19 13:47:10 +02:00
Michael Kerrisk ee8655b59a arch_prctl.2, ioctl_fideduperange.2, ioctl_getfsmap.2, kexec_load.2, madvise.2, mbind.2, mmap.2, mmap2.2, mprotect.2, perf_event_open.2, process_vm_readv.2, set_mempolicy.2, shmget.2, subpage_prot.2, pthread_attr_init.3, pthread_create.3, pthread_getattr_np.3, regex.3, wavelan.4, filesystems.5, proc.5, bootparam.7, raw.7, tcp.7, units.7, ld.so.8: Add a non-breaking space between a number and a unit (prefix)
Based on a patch by Bjarni Ingi Gislason.

According to SI, ""The numerical value always precedes the unit,
and a space is always used to separate the unit from the number
[...] The only exceptions to this rule are for the unit symbols
for degree, minute, and second for plane angle."

Cowritten-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 12:12:59 +02:00
Michael Kerrisk ab5736e921 btree.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 11:28:10 +02:00
Michael Kerrisk 11ac5b5109 add_key.2, bpf.2, fcntl.2, futex.2, listxattr.2, perf_event_open.2, prctl.2, request_key.2, sigaltstack.2, __ppc_set_ppr_med.3, __ppc_yield.3, getw.3, setbuf.3, setjmp.3, lirc.4, core.5, securetty.5, inode.7, keyrings.7, process-keyring.7, user-keyring.7, ld.so.8: srcfix: use .PP instead of .P
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:13:44 +02:00
Michael Kerrisk dd3568a147 getent.1, intro.1, time.1, _exit.2, alloc_hugepages.2, arch_prctl.2, clock_getres.2, getitimer.2, getrusage.2, intro.2, ioctl_console.2, ioctl_list.2, ioctl_tty.2, kill.2, madvise.2, mlock.2, mmap.2, mount.2, open.2, outb.2, perf_event_open.2, ptrace.2, quotactl.2, reboot.2, recv.2, remap_file_pages.2, select.2, semctl.2, send.2, set_tid_address.2, seteuid.2, shmop.2, statfs.2, times.2, truncate.2, uname.2, uselib.2, vm86.2, wait.2, a64l.3, aio_cancel.3, aio_fsync.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, atexit.3, basename.3, bindresvport.3, cacos.3, cacosh.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catgets.3, catopen.3, cexp.3, cfree.3, cimag.3, clog.3, conj.3, creal.3, ctime.3, des_crypt.3, dirfd.3, div.3, dlopen.3, envz_add.3, exit.3, fenv.3, flockfile.3, fmtmsg.3, fpclassify.3, fpurge.3, fseeko.3, ftime.3, ftok.3, ftw.3, getcontext.3, getcwd.3, getdate.3, getfsent.3, getgrent.3, getgrnam.3, gethostbyname.3, getipnodebyname.3, getlogin.3, getpwnam.3, getrpcent.3, getspnam.3, getutent.3, gsignal.3, hsearch.3, lockf.3, logb.3, login.3, lseek64.3, makecontext.3, malloc.3, malloc_hook.3, nan.3, nl_langinfo.3, openpty.3, posix_spawn.3, putenv.3, realpath.3, remainder.3, rint.3, rpc.3, rtime.3, scandir.3, setlogmask.3, shm_open.3, sigpause.3, statvfs.3, stdio_ext.3, strfmon.3, strftime.3, strptime.3, strtod.3, strtol.3, strtoul.3, swab.3, sysconf.3, syslog.3, tcgetpgrp.3, tempnam.3, termios.3, tmpfile.3, tmpnam.3, ttyslot.3, tzset.3, ualarm.3, usleep.3, wordexp.3, xcrypt.3, xdr.3, cciss.4, console_codes.4, full.4, hd.4, loop.4, mem.4, null.4, pts.4, ram.4, random.4, tty.4, ttyS.4, vcs.4, networks.5, nsswitch.conf.5, protocols.5, resolv.conf.5, slabinfo.5, termcap.5, ascii.7, boot.7, bootparam.7, charsets.7, icmp.7, inode.7, man.7, netdevice.7, posixoptions.7, ld.so.8: srcfix: use .PP instead of .LP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:12:54 +02:00
Michael Kerrisk 51f5698d3c capget.2, gettimeofday.2, nanosleep.2, process_vm_readv.2, readv.2, seccomp.2, semop.2, sigaction.2, sigwaitinfo.2, dbopen.3, dladdr.3, ether_aton.3, fenv.3, fgetgrent.3, fgetpwent.3, frexp.3, ftime.3, gamma.3, getaddrinfo.3, getaddrinfo_a.3, getgrent_r.3, getgrnam.3, gethostbyname.3, getifaddrs.3, getipnodebyname.3, getmntent.3, getnetent.3, getprotoent.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getservent.3, getspnam.3, getutent.3, glob.3, hsearch.3, if_nameindex.3, inet.3, mq_receive.3, putgrent.3, putpwent.3, rand.3, sigqueue.3, strfromd.3, strptime.3, strtol.3, termios.3, timeradd.3, lp.4, tty.4, ip.7, ipv6.7, netdevice.7, raw.7, rtnetlink.7, units.7, zic.8: ffix: replace .sp by .PP
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-18 01:00:48 +02:00
Michael Kerrisk bdd915e20f _syscall.2, capget.2, ioprio_set.2, semop.2, send.2, ctime.3, dysize.3, fenv.3, fmtmsg.3, ftok.3, ftw.3, getaddrinfo.3, getgrent_r.3, gethostbyname.3, getopt.3, getpw.3, getpwent_r.3, getsubopt.3, getutent.3, glob.3, if_nameindex.3, inet.3, lseek64.3, malloc_hook.3, mbrtowc.3, mkstemp.3, mq_receive.3, mq_send.3, posix_spawn.3, putgrent.3, putpwent.3, qsort.3, raise.3, rand.3, rtime.3, setaliasent.3, setbuf.3, shm_open.3, significand.3, sigqueue.3, statvfs.3, strfromd.3, strptime.3, strtol.3, strtoul.3, termios.3, tgamma.3, timeradd.3, tsearch.3, tzset.3, updwtmp.3, usleep.3, wcstok.3, console_codes.4, hd.4, hpsa.4, mem.4, null.4, ram.4, sd.4, ttyS.4, filesystems.5, group.5, passwd.5, shells.5, termcap.5, ttytype.5, tzfile.5, utmp.5, ascii.7, bootparam.7, complex.7, cpuset.7, epoll.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-17 23:40:17 +02:00
Michael Kerrisk ba39b288ab fcntl.2, ioctl_tty.2, kcmp.2, prctl.2, semop.2, swapon.2, atof.3, atoi.3, bsearch.3, cfree.3, ctime.3, drand48.3, errno.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-17 13:41:27 +02:00
Michael Kerrisk e7d0bb4715 memusage.1, clone.2, eventfd.2, futex.2, getdents.2, ioctl_fat.2, ioctl_ns.2, kcmp.2, keyctl.2, mmap.2, mprotect.2, msgop.2, recvmmsg.2, request_key.2, sched_setaffinity.2, seccomp.2, setns.2, tee.2, timer_create.2, timerfd_create.2, unshare.2, userfaultfd.2, wait.2, __ppc_get_timebase.3, backtrace.3, bswap.3, clock_getcpuclockid.3, dl_iterate_phdr.3, dlinfo.3, dlopen.3, duplocale.3, end.3, endian.3, fmemopen.3, fopencookie.3, frexp.3, ftw.3, getdate.3, getgrouplist.3, getifaddrs.3, getprotoent_r.3, getservent_r.3, gnu_get_libc_version.3, if_nameindex.3, inet.3, inet_net_pton.3, inet_pton.3, insque.3, makecontext.3, mallinfo.3, malloc_info.3, mallopt.3, matherr.3, mbstowcs.3, mcheck.3, mq_getattr.3, mq_notify.3, newlocale.3, offsetof.3, posix_spawn.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, scandir.3, sem_wait.3, strcat.3, strftime.3, strtok.3, strtol.3, strverscmp.3, loop.4, core.5, aio.7, fanotify.7, feature_test_macros.7, inotify.7, pkeys.7, unix.7, user_namespaces.7: Use .EX/.EE for EXAMPLE programs
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 10:44:33 +02:00
Michael Kerrisk 75b8c5b935 strfmon.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 05:16:19 +02:00
Michael Kerrisk 847e0d8871 CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, acos.3, acosh.3, adjtime.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, backtrace.3, basename.3, bindresvport.3, bsd_signal.3, bsearch.3, bswap.3, btree.3, byteorder.3, bzero.3, canonicalize_file_name.3, carg.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, clearenv.3, clock.3, clog.3, clog10.3, clog2.3, confstr.3, copysign.3, cos.3, cosh.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctime.3, dbopen.3, dl_iterate_phdr.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48_r.3, duplocale.3, encrypt.3, end.3, endian.3, envz_add.3, erf.3, erfc.3, err.3, errno.3, error.3, euidaccess.3, exec.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, finite.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fopen.3, fopencookie.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, frexp.3, fseek.3, fseeko.3, ftime.3, fts.3, ftw.3, futimes.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcwd.3, getdate.3, getentropy.3, getenv.3, getfsent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getline.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getprotoent.3, getprotoent_r.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getutent.3, getwchar.3, glob.3, gnu_get_libc_version.3, grantpt.3, gsignal.3, hash.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, inet.3, inet_net_pton.3, inet_ntop.3, initgroups.3, insque.3, intro.3, isalpha.3, isgreater.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, lio_listio.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, makedev.3, mallinfo.3, malloc_get_state.3, malloc_info.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, mallopt.3, matherr.3, mbsnrtowcs.3, mbsrtowcs.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mtrace.3, newlocale.3, nextafter.3, nextup.3, nl_langinfo.3, ntp_gettime.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.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, program_invocation_name.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, ptsname.3, putgrent.3, putpwent.3, qsort.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, recno.3, regex.3, remainder.3, remove.3, remquo.3, resolver.3, rexec.3, rint.3, round.3, rpc.3, rpmatch.3, rtime.3, scalb.3, scalbln.3, scandir.3, scanf.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_wait.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdin.3, strcasecmp.3, strcat.3, strchr.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strftime.3, strptime.3, strsignal.3, strstr.3, strtod.3, strtok.3, strtol.3, strtoul.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, telldir.3, tempnam.3, termios.3, tgamma.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, trunc.3, tzset.3, ualarm.3, ulimit.3, undocumented.3, unlocked_stdio.3, updwtmp.3, uselocale.3, usleep.3, wcrtomb.3, wcsdup.3, wcsnrtombs.3, wcsrtombs.3, wcstombs.3, wctob.3, wcwidth.3, wordexp.3, wprintf.3, xcrypt.3, xdr.3, y0.3: Formatting fix: replace blank lines with .PP/.IP
Blank lines shouldn't generally appear in *roff source (other
than in code examples), since they create large vertical
spaces between text blocks.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 05:13:02 +02:00
Sukadev Bhattiprolu cf699fb57e cmsg.3: Add a scatter/gather buffer to sample code
Add a simple scatter/gather buffer to the cmsg sample code.

It appears that the scatter/gather buffer is required even though
it may not be used. In my testing (on Fedora 24
4.8.7-200.fc24.x86_64 as well as a 4.11 based kernel) return value
of sendmsg() was the number of bytes in the scatter/gather buffer
(1 with the patch below).

Without the iovec buffer, sendmsg() returns 0 which means no bytes
were transferred and the corresponding recvmsg() blocks
indefinitely.

Signed-off-by: Sukadev Bhattiprolu <sukadev@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 02:29:29 +02:00
Michael Kerrisk d8026103cb posix_memalign.3, loop.4: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-16 00:15:02 +02:00
Alex Henrie 523e7e59ad log1p.3: Document fixes to give EDOM or ERANGE on error
The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6792
was fixed in glibc 2.22.

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 20:45:09 +02:00
Michael Kerrisk dbfe9c700e _syscall.2, clock_getres.2, clone.2, copy_file_range.2, create_module.2, delete_module.2, fallocate.2, futex.2, get_kernel_syms.2, get_robust_list.2, getcpu.2, getdents.2, gettid.2, gettimeofday.2, getunwind.2, init_module.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioctl_userfaultfd.2, ioprio_set.2, kcmp.2, kexec_load.2, keyctl.2, link.2, llseek.2, memfd_create.2, mmap.2, mq_getsetattr.2, msgctl.2, msgget.2, open_by_handle_at.2, outb.2, perf_event_open.2, pivot_root.2, process_vm_readv.2, query_module.2, readdir.2, recvmmsg.2, rename.2, request_key.2, restart_syscall.2, rt_sigqueueinfo.2, s390_pci_mmio_write.2, s390_runtime_instr.2, sched_setattr.2, seccomp.2, select.2, select_tut.2, send.2, sendmmsg.2, set_thread_area.2, set_tid_address.2, sgetmask.2, shmop.2, sigaction.2, sigprocmask.2, splice.2, spu_create.2, spu_run.2, statx.2, subpage_prot.2, sync_file_range.2, syscall.2, sysctl.2, sysfs.2, tee.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, tkill.2, uselib.2, utimensat.2, vmsplice.2, wait.2, aio_init.3, asinh.3, atan2.3, atanh.3, backtrace.3, basename.3, bswap.3, bzero.3, catgets.3, catopen.3, dladdr.3, dlsym.3, endian.3, envz_add.3, erf.3, erfc.3, error.3, ferror.3, ffs.3, fgetc.3, fmemopen.3, fopen.3, fopencookie.3, fseek.3, ftw.3, futimes.3, getdate.3, getenv.3, getline.3, getlogin.3, getrpcent.3, getsubopt.3, getutmp.3, getw.3, gnu_get_libc_version.3, inet_net_pton.3, isalpha.3, lio_listio.3, makedev.3, malloc_get_state.3, malloc_stats.3, malloc_trim.3, malloc_usable_size.3, matherr.3, memchr.3, nextup.3, ntp_gettime.3, posix_madvise.3, program_invocation_name.3, pthread_atfork.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cleanup_push_defer_np.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_join.3, pthread_kill.3, pthread_kill_other_threads_np.3, pthread_rwlockattr_setkind_np.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedprio.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, puts.3, random.3, random_r.3, rpc.3, sched_getcpu.3, setnetgrent.3, sigwait.3, stdin.3, strerror.3, strfmon.3, timeradd.3, tmpnam.3, toupper.3, towlower.3, towupper.3, ttyname.3, uselocale.3, xdr.3, dsp56k.4, sigevent.7, vdso.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 19:39:04 +02:00
Michael Kerrisk f90f031e0f _exit.2, accept.2, chmod.2, dup.2, getgroups.2, keyctl.2, link.2, mkdir.2, mknod.2, pipe.2, poll.2, reboot.2, rename.2, select.2, select_tut.2, stat.2, symlink.2, unlink.2, __ppc_get_timebase.3, abs.3, bzero.3, crypt.3, dbopen.3, dl_iterate_phdr.3, dlinfo.3, dlsym.3, duplocale.3, encrypt.3, err.3, ffs.3, fpurge.3, ftw.3, getdate.3, gethostbyname.3, getlogin.3, getmntent.3, getpwent_r.3, getpwnam.3, getspnam.3, inet_pton.3, insque.3, isfdtype.3, mallinfo.3, mallopt.3, matherr.3, mcheck.3, mempcpy.3, mkfifo.3, mq_getattr.3, newlocale.3, open_memstream.3, openpty.3, perror.3, posix_memalign.3, posix_spawn.3, printf.3, pthread_attr_init.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_create.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_setaffinity_np.3, pthread_setschedparam.3, pthread_sigmask.3, pthread_sigqueue.3, regex.3, resolver.3, rpmatch.3, rtnetlink.3, scanf.3, setbuf.3, strchr.3, strfromd.3, strverscmp.3, termios.3, tsearch.3, unlocked_stdio.3, updwtmp.3, netlink.7, rtld-audit.7, sock_diag.7, unix.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 17:44:09 +02:00
Michael Kerrisk 68e4db0a44 _exit.2, bpf.2, cacheflush.2, capget.2, chdir.2, chmod.2, chroot.2, clock_getres.2, clock_nanosleep.2, close.2, connect.2, create_module.2, dup.2, epoll_create.2, epoll_ctl.2, epoll_wait.2, eventfd.2, execve.2, execveat.2, exit_group.2, fanotify_mark.2, flock.2, fork.2, fsync.2, futex.2, futimesat.2, get_kernel_syms.2, get_mempolicy.2, get_robust_list.2, getcpu.2, getdomainname.2, getgid.2, getgroups.2, gethostname.2, getitimer.2, getpagesize.2, getpeername.2, getpid.2, getpriority.2, getrandom.2, getresuid.2, getrlimit.2, getrusage.2, getsid.2, getsockname.2, getsockopt.2, gettid.2, gettimeofday.2, getuid.2, getunwind.2, getxattr.2, idle.2, inotify_add_watch.2, inotify_init.2, inotify_rm_watch.2, ioctl.2, ioctl_fat.2, ioctl_ficlonerange.2, ioctl_fideduperange.2, ioctl_getfsmap.2, ioctl_tty.2, ioperm.2, iopl.2, keyctl.2, kill.2, link.2, listen.2, listxattr.2, llseek.2, lseek.2, madvise.2, mbind.2, membarrier.2, memfd_create.2, migrate_pages.2, mincore.2, mkdir.2, mknod.2, mlock.2, mmap.2, mmap2.2, modify_ldt.2, mount.2, move_pages.2, mprotect.2, mq_getsetattr.2, mremap.2, msgop.2, msync.2, nanosleep.2, nfsservctl.2, nice.2, pause.2, pciconfig_read.2, perf_event_open.2, perfmonctl.2, personality.2, pkey_alloc.2, poll.2, posix_fadvise.2, prctl.2, pread.2, process_vm_readv.2, ptrace.2, query_module.2, read.2, readahead.2, readdir.2, readv.2, reboot.2, recv.2, remap_file_pages.2, removexattr.2, rename.2, request_key.2, rmdir.2, rt_sigqueueinfo.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setaffinity.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, select_tut.2, semctl.2, semget.2, semop.2, send.2, sendfile.2, set_mempolicy.2, set_tid_address.2, seteuid.2, setfsgid.2, setfsuid.2, setgid.2, setns.2, setpgid.2, setresuid.2, setreuid.2, setsid.2, setuid.2, setup.2, setxattr.2, sgetmask.2, shmctl.2, shmget.2, shutdown.2, sigaction.2, sigaltstack.2, sigpending.2, sigprocmask.2, sigsuspend.2, sigwaitinfo.2, socket.2, socketcall.2, socketpair.2, stat.2, statfs.2, stime.2, swapon.2, symlink.2, sync.2, sysctl.2, sysinfo.2, syslog.2, time.2, timer_create.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, timerfd_create.2, times.2, tkill.2, truncate.2, umask.2, umount.2, uname.2, unlink.2, unshare.2, uselib.2, userfaultfd.2, ustat.2, utime.2, utimensat.2, vfork.2, vhangup.2, vm86.2, wait.2, wait4.2, write.2, CPU_SET.3, INFINITY.3, __ppc_get_timebase.3, __ppc_set_ppr_med.3, __ppc_yield.3, __setfpucw.3, a64l.3, abort.3, abs.3, acos.3, acosh.3, addseverity.3, adjtime.3, aio_cancel.3, aio_error.3, aio_fsync.3, aio_init.3, aio_read.3, aio_return.3, aio_suspend.3, aio_write.3, alloca.3, argz_add.3, asin.3, asinh.3, asprintf.3, assert.3, assert_perror.3, atan.3, atan2.3, atanh.3, atexit.3, atof.3, atoi.3, basename.3, bcmp.3, bcopy.3, bsd_signal.3, bsearch.3, bstring.3, btowc.3, byteorder.3, cabs.3, cacos.3, cacosh.3, canonicalize_file_name.3, carg.3, casin.3, casinh.3, catan.3, catanh.3, catopen.3, cbrt.3, ccos.3, ccosh.3, ceil.3, cexp.3, cexp2.3, cfree.3, cimag.3, clearenv.3, clock.3, clock_getcpuclockid.3, clog.3, clog10.3, clog2.3, closedir.3, cmsg.3, confstr.3, conj.3, copysign.3, cos.3, cosh.3, cpow.3, cproj.3, creal.3, crypt.3, csin.3, csinh.3, csqrt.3, ctan.3, ctanh.3, ctermid.3, ctime.3, daemon.3, difftime.3, dirfd.3, div.3, dlerror.3, dlopen.3, dlsym.3, drand48.3, drand48_r.3, duplocale.3, dysize.3, ecvt.3, ecvt_r.3, encrypt.3, endian.3, erf.3, erfc.3, err.3, errno.3, ether_aton.3, euidaccess.3, exec.3, exit.3, exp.3, exp10.3, exp2.3, expm1.3, fabs.3, fclose.3, fcloseall.3, fdim.3, fenv.3, ferror.3, fexecve.3, fflush.3, ffs.3, fgetc.3, fgetgrent.3, fgetpwent.3, fgetwc.3, fgetws.3, finite.3, flockfile.3, floor.3, fma.3, fmax.3, fmemopen.3, fmin.3, fmod.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fpurge.3, fputwc.3, fputws.3, fread.3, frexp.3, fseek.3, fseeko.3, ftime.3, ftok.3, fts.3, ftw.3, futimes.3, fwide.3, gamma.3, gcvt.3, get_nprocs_conf.3, get_phys_pages.3, getaddrinfo.3, getaddrinfo_a.3, getauxval.3, getcontext.3, getcwd.3, getdate.3, getdirentries.3, getdtablesize.3, getentropy.3, getenv.3, getfsent.3, getgrent.3, getgrent_r.3, getgrnam.3, getgrouplist.3, gethostbyname.3, gethostid.3, getifaddrs.3, getipnodebyname.3, getline.3, getloadavg.3, getlogin.3, getmntent.3, getnameinfo.3, getnetent.3, getnetent_r.3, getopt.3, getpass.3, getprotoent.3, getprotoent_r.3, getpt.3, getpw.3, getpwent.3, getpwent_r.3, getpwnam.3, getrpcent_r.3, getrpcport.3, gets.3, getservent.3, getservent_r.3, getspnam.3, getsubopt.3, getttyent.3, getumask.3, getusershell.3, getutent.3, getw.3, getwchar.3, glob.3, grantpt.3, group_member.3, gsignal.3, hsearch.3, hypot.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, if_nametoindex.3, ilogb.3, index.3, inet.3, inet_net_pton.3, inet_ntop.3, infnan.3, initgroups.3, insque.3, isalpha.3, isatty.3, isfdtype.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, j0.3, key_setsecret.3, killpg.3, ldexp.3, lgamma.3, localeconv.3, lockf.3, log.3, log10.3, log1p.3, log2.3, logb.3, login.3, lrint.3, lround.3, lsearch.3, lseek64.3, makecontext.3, malloc.3, malloc_get_state.3, malloc_hook.3, malloc_info.3, matherr.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsnrtowcs.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, mcheck.3, memccpy.3, memchr.3, memcmp.3, memcpy.3, memfrob.3, memmem.3, memmove.3, mempcpy.3, memset.3, mkdtemp.3, mkfifo.3, mkstemp.3, mktemp.3, modf.3, mpool.3, mq_close.3, mq_getattr.3, mq_notify.3, mq_open.3, mq_receive.3, mq_send.3, mq_unlink.3, mtrace.3, nan.3, netlink.3, newlocale.3, nextafter.3, nl_langinfo.3, offsetof.3, on_exit.3, open_memstream.3, opendir.3, openpty.3, perror.3, popen.3, posix_fallocate.3, posix_madvise.3, posix_memalign.3, posix_openpt.3, pow.3, pow10.3, printf.3, profil.3, psignal.3, pthread_atfork.3, pthread_attr_init.3, pthread_attr_setaffinity_np.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstackaddr.3, pthread_attr_setstacksize.3, pthread_cancel.3, pthread_cleanup_push.3, pthread_cleanup_push_defer_np.3, pthread_create.3, pthread_detach.3, pthread_equal.3, pthread_exit.3, pthread_getattr_default_np.3, pthread_getattr_np.3, pthread_getcpuclockid.3, pthread_join.3, pthread_kill.3, pthread_rwlockattr_setkind_np.3, pthread_self.3, pthread_setaffinity_np.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setname_np.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_sigqueue.3, pthread_testcancel.3, pthread_tryjoin_np.3, pthread_yield.3, ptsname.3, putenv.3, putgrent.3, putpwent.3, puts.3, putwchar.3, qecvt.3, qsort.3, raise.3, rand.3, random.3, random_r.3, rcmd.3, re_comp.3, readdir.3, realpath.3, remainder.3, remove.3, remquo.3, resolver.3, rewinddir.3, rexec.3, rint.3, round.3, rpmatch.3, rtime.3, rtnetlink.3, scalb.3, scalbln.3, scandir.3, scanf.3, sched_getcpu.3, seekdir.3, sem_close.3, sem_destroy.3, sem_getvalue.3, sem_init.3, sem_open.3, sem_post.3, sem_unlink.3, sem_wait.3, setaliasent.3, setbuf.3, setenv.3, setlocale.3, setlogmask.3, setnetgrent.3, shm_open.3, siginterrupt.3, signbit.3, significand.3, sigpause.3, sigqueue.3, sigset.3, sigvec.3, sigwait.3, sin.3, sincos.3, sinh.3, sleep.3, sockatmark.3, sqrt.3, statvfs.3, stdarg.3, stdio.3, stdio_ext.3, stpcpy.3, stpncpy.3, strcasecmp.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strdup.3, strerror.3, strfmon.3, strfromd.3, strfry.3, strftime.3, strlen.3, strnlen.3, strpbrk.3, strptime.3, strsep.3, strsignal.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strverscmp.3, strxfrm.3, swab.3, sysconf.3, syslog.3, system.3, sysv_signal.3, tan.3, tanh.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tempnam.3, termios.3, tgamma.3, timegm.3, timeradd.3, tmpfile.3, tmpnam.3, toascii.3, toupper.3, towctrans.3, towlower.3, towupper.3, trunc.3, tsearch.3, ttyname.3, ttyslot.3, tzset.3, ualarm.3, ulimit.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, updwtmp.3, uselocale.3, usleep.3, wcpcpy.3, wcpncpy.3, wcrtomb.3, wcscasecmp.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcsdup.3, wcslen.3, wcsncasecmp.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcsnlen.3, wcsnrtombs.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, xcrypt.3, y0.3, dsp56k.4, random.4, rtc.4, st.4, ddp.7, ip.7, ipv6.7, packet.7, rtnetlink.7, socket.7, tcp.7, udp.7, udplite.7, x25.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 17:16:29 +02:00
Michael Kerrisk 019d9ee872 getauxval.3, cciss.4, cpuid.4, msr.4, proc.5, tmpfs.5, man-pages.7, pid_namespaces.7, ld.so.8, nscd.8: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-15 16:15:21 +02:00
Michael Kerrisk aa80442a5d readdir_r.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 13:35:45 +02:00
Michael Kerrisk 6db9f2db52 sigsetops.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:12:50 +02:00
Michael Kerrisk 7736b88651 setjmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:11:00 +02:00
Michael Kerrisk 0c545d6712 setjmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-14 09:09:13 +02:00
Michael Kerrisk f47758ba0a strverscmp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:29:51 +02:00
Michael Kerrisk 172070f8dc strverscmp.3: srcfix: remove excess .in tag
Reported-by: Sam Varshavchik <mrsam@courier-mta.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-08-12 22:27:59 +02:00
Alex Henrie 377ec1fda7 exp2.3: Remove C89 designation
[mtk: Confirmed by consulting C90 draft standard]

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-22 09:23:16 +02:00
Michael Kerrisk 230ed8339d Removed trailing white space at end of lines 2017-07-13 14:22:45 +02:00
Michael Kerrisk f55a6d598d Changes, ldd.1, chown.2, epoll_wait.2, get_mempolicy.2, ioctl_getfsmap.2, madvise.2, membarrier.2, mount.2, pipe.2, readv.2, seccomp.2, sigaltstack.2, splice.2, tee.2, timer_create.2, vmsplice.2, acosh.3, asinh.3, atanh.3, bsd_signal.3, dl_iterate_phdr.3, dlsym.3, flockfile.3, fpathconf.3, ftw.3, getaddrinfo.3, getcontext.3, getgrent.3, if_nametoindex.3, malloc.3, nl_langinfo.3, posix_madvise.3, ptsname.3, rand.3, resolver.3, sigpause.3, sigwait.3, strtol.3, sysconf.3, ttyslot.3, unlocked_stdio.3, unlockpt.3, capabilities.7, cgroup_namespaces.7, inode.7, man.7, pipe.7, sigevent.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-13 14:22:45 +02:00
Long Wang f0e956cafb getline.3: wfix
Signed-off-by: Long Wang <w@laoqinren.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-12 19:36:34 +02:00
Alex Henrie 7cada58cad acosh.3, asinh.3, atanh.3: Remove C89 designation.
See https://bugzilla.kernel.org/show_bug.cgi?id=196319

[mtk: confirmed from review of draft of C90 standard]

Signed-off-by: Alex Henrie <alexhenrie24@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-11 09:59:50 +02:00
Joe Brown 5df38b3325 getaddrinfo.3: wsfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:39:08 +02:00
Carlos O'Donell 0d4f6d6f88 getcontext.3: Exemplar structure should use 'ucontext_t'.
In glibc we just finished a round of purging 'struct ucontext'
which is not in the POSIX reserved namespace of *_t tags. This has
some consequences to applications using the non-standard struct
ucontext:
https://sourceware.org/glibc/wiki/Release/2.26#Removal_of_.27struct_ucontext.27
but it also fixes a namespace conformance issue which is always a
longterm pain for large portable programs.

It was noted by Peter Maydell
(https://sourceware.org/bugzilla/show_bug.cgi?id=21457) that the
linux man pages still had references to 'struct ucontext' but only
in the form of an exemplar structure.

The patch fixes the exemplar to match what is in glibc
and therefore it won't ever suggest users can use 'struct
ucontext'.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:29:59 +02:00
Dr. Tobias Quathamer be3b29c722 posix_madvise.3: Remove paragraph about POSIX_FADV_NOREUSE
POSIX_FADV_NOREUSE is documented for posix_fadvise, and a
corresponding POSIX_MADV_NOREUSE flag is not specified by POSIX.

Thanks to Marc Lehmann <debian-reportbug@plan9.de>
See https://bugs.debian.org/865699

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:26:46 +02:00
Jakub Wilk c52ba260ff ttyslot.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-07-05 10:19:25 +02:00
Michael Kerrisk 2ad31d9de8 ttyname.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-25 12:15:59 +02:00
Michael Kerrisk f57d94ca99 malloc.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk bc045fdd60 malloc.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk 081eeee527 malloc.3: Document the reallocarray() added in glibc 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 16:29:50 +02:00
Michael Kerrisk 4b80e269ee malloc.3: Minor clarification to CONFORMING TO
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:42:17 +02:00
Michael Kerrisk ceaad4d829 cfree.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-19 15:35:55 +02:00
Michael Kerrisk bc051678fe fpathconf.3: srcfix: Add self to copyright notice
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 21:15:57 +02:00
Michael Kerrisk 3509905bd8 fpathconf.3: Largely rewrite the description of _PC_CHOWN_RESTRICTED
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 21:14:56 +02:00
Michael Kerrisk 6cde427101 fpathconf.3: Rewrite description of _PC_PIPE_BUF
The existing description was not accurate, and lacked details.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:58:17 +02:00
Michael Kerrisk 09c8f2e4ea fpathconf.3: Add an errors section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:50:53 +02:00
Michael Kerrisk a282334152 fpathconf.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:31:06 +02:00
Michael Kerrisk 5425e5c59c fpathconf.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 081a3c719b fpathconf.3: Rework RETURN VALUE description to add more detail
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 480ef6d924 sysconf.3: Rework RETURN VALUE description to add more detail
Make the discussion clearer, and add a few details.
Also, fix the problem report from Pavel Tikhomirov
who noted that the man page falsely said that errno
is not changed on a successful return.

Addresses https://bugzilla.kernel.org/show_bug.cgi?id=195955

Reported-by: Pavel Tikhomirov <ptikhomirov@virtuozzo.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-18 20:29:49 +02:00
Michael Kerrisk 386732aa86 sysconf.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-17 10:40:40 +02:00
Michael Kerrisk 646896d32c sysconf.3: Add ERRORS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-17 09:53:56 +02:00
Michael Kerrisk 26bab9df0b getgrent.3, sigwait.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk bccf0b0760 getgrent.3: Note glibc 2.22 changes for feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 2079d4344e sigpause.3: Note glibc 2.26 changes to feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk cc7fb6123a sigpause.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:45 +02:00
Michael Kerrisk 4c931ba32b nl_langinfo.3: Note feature test macro requirements for nl_langinfo_l()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 06adeea53d sigwait.3: Note glibc 2.26 feature test macro changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 940758abfe bsd_signal.3: Note feature test macro requirements changes for glibc 2.26
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk a97ae929a6 flockfile.3: Note glibc 2.24 feature test macro requirement changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk f83b1bbc94 unlocked_stdio.3: Note glibc 2.24 feature test macro requirement changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Michael Kerrisk 7676eafe87 ptsname.3: Since glibc 2.26, ptsname_r() no longer gives EINVAL for buf==NULL
Reported-by: Arjun Shankar <arjun.is@lostca.se>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:44 +02:00
Ferdinand Thiessen c2ba3716a9 grantpt.3, ptsname.3, unlockpt.3: Update feature test macro-requirements for glibc 2.24
Cowritten-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk b49377954c rand.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk c3a558fae9 rand.3: Note glibc 2.24 feature test macro requirement changes for rand_r()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk f30306c4a2 ttyslot.3: Note feature test macro requirements changes in glibc 2.24
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk 3f1873a8e3 ttyslot.3: Fix error in feature test macro requirements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk f8c8a9031d ttyslot.3: Clarify details of use of <stdlib.h> file
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk 62dc68ae00 ttyslot.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 11:42:36 +02:00
Michael Kerrisk ab67ced080 resolver.3: Add basic notes on 'op' argument of res_nmkquery() and res_mkquery()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-16 07:49:06 +02:00
Quentin Rameau 94db8ae182 getaddrinfo.3: Fix _POSIX_C_SOURCE value for getaddrinfo()
The correct _POSIX_C_SOURCE value is 200112L, not 201112L in features.h.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-11 08:14:05 +02:00
Michael Kerrisk 687d31a42f ftw.3: BUGS: document a probable glibc regression in FTW_SLN case
See https://bugzilla.redhat.com/show_bug.cgi?id=1422736
and http://austingroupbugs.net/view.php?id=1121.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-10 21:52:48 +02:00
Michael Kerrisk cbc091e863 ftw.3: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-10 20:58:35 +02:00
Michael Kerrisk b8f9afd0ad ftw.3: Minor clarification of 'ftwbuf' argument to callback function
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2017-06-10 20:58:26 +02:00
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
Wainer dos Santos Moschetta b61e3789ab strtod.3: SEE ALSO: add strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-07 16:39:49 +01:00
Wainer dos Santos Moschetta e46790a80a printf.3: SEE ALSO: add strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-07 16:39:43 +01:00
Wainer dos Santos Moschetta afaf39e9ac atof.3: SEE ALSO: add strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-07 16:39:31 +01:00
Wainer dos Santos Moschetta 2bf84c0f98 strfroml.3: New link to strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-07 16:38:53 +01:00
Wainer dos Santos Moschetta af9a175d03 strfromf.3: New link to strfromd(3)
Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-07 16:38:26 +01:00
Michael Kerrisk f75bdcaf5f strfromd.3: Minor tweaks to Wainer dos Santos Moschetta's page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-07 16:37:57 +01:00
Wainer dos Santos Moschetta d8be6d2b70 strfromd.3: New page documenting strfromd(3), strfromf(3), and strfroml(3)
The ISO/IEC TS 18661-1 specifies the strfrom() class
of functions that convert a float-point value to string.

The strfromd(), strfromf(), and strfroml() functions are
introduced (commit 6962682ffe5e) in GNU C Library 2.25.

Signed-off-by: Wainer dos Santos Moschetta <wainersm@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-07 16:23:58 +01:00
Michael Kerrisk eaa8868c7b strerror.3: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-05 16:02:06 +01:00
Michael Kerrisk 97d8fd295f ptsname.3: Note that ptsname_r() is proposed for future inclusion in POSIX.1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-05 16:02:06 +01:00
Michael Kerrisk b078637007 ptsname.3: CONFORMING TO:: clarify that only ptsname() is standardized (so far)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-12-05 16:02:06 +01:00
Michael Kerrisk 5b711f5e45 mbsnrtowcs.3: Note behavior of mbsnrtowcs() for an incomplete character
Note the behavior of mbsnrtowcs() when an incomplete character
is found at end of the input buffer.

Reported-by: Igor Liferenko <igor.liferenko@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-26 14:15:59 +01:00
Michael Kerrisk 9caecea1f2 mbsnrtowcs.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-26 14:06:12 +01:00
Michael Kerrisk 02326b5cce isalpha.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-21 13:20:29 +01:00
Michael Kerrisk a57bca4d34 mbstowcs.3: Add missing include to example program
See https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=845172

Reported-by: Igor Liferenko <igor.liferenko@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-21 11:33:56 +01:00
Michael Kerrisk 2e8302fca0 remainder.3: Note fix to remainder(nan(""), 0) handling
The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6779
has been fixed in glibc 2.15.
2016-11-19 11:28:46 +01:00
Michael Kerrisk f5a9a2041a remainder.3: Document fixes for EDOM handling for range errors
The bug http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783
was fixed in glibc 2.15.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-19 11:28:46 +01:00
Michael Kerrisk bde63f932d tgamma.3: Document fixes to give ERANGE for underflow range error
The bug https://www.sourceware.org/bugzilla/show_bug.cgi?id=6810
was fixed in glibc 2.19.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-18 20:18:03 +01:00
Michael Kerrisk 3c5ba5ed1c isalpha.3: Note circumstances where 'c' must be cast to 'unsigned char'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-17 21:51:05 +01:00
Michael Kerrisk d81889735b toupper.3: Note circumstances where 'c' must be cast to 'unsigned char'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-17 21:49:37 +01:00
Michael Kerrisk 7903974202 dlopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-11 09:20:54 +01:00
Michael Kerrisk 160b2e8799 ttyname.3: SEE ALSO: add tty(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:19:56 +01:00
Michael Kerrisk 2a47cc96ba getlogin.3: SEE ALSO: add logname(1)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-11-10 11:18:16 +01:00