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

18553 Commits

Author SHA1 Message Date
Michael Kerrisk 3b53a603c4 flock.2: Minor wording fix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-10-03 15:28:30 +02:00
Michael Kerrisk 657a14bfa0 flock.2: Break NFS details int two separate paragraphs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-10-03 15:23:53 +02:00
Michael Kerrisk 50bfd0b3e2 flock.2: Move NFS details to a headed subsection 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-10-03 15:23:37 +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 b0ea1ea30d prctl.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-10-03 14:25:47 +02:00
Michael Kerrisk 4c3e123384 splice.2: Since Linux 2.6.31,'fd_in' and 'fd_out' may both refer to pipes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-10-03 14:13:56 +02:00
Michael Kerrisk bf3e64ce7c mremap.2: Update timestamp: review of new BUGS by Michal Hocko and Mike Kravetz 
Reviewed-by: Mike Kravetz <mike.kravetz@oracle.com>
Reviewed-by: Michal Hocko <mhocko@kernel.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-29 23:38:35 +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 9ce1d9202d sched_yield.2: sched_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:43:30 +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
Michael Kerrisk 5c6f8de052 open.2: ERRORS: document EINVAL error for invalid filename 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-29 11:40:03 +02:00
Michael Kerrisk cd37d57ed6 mkdir.2: ERRORS: document EINVAL error for invalid filename 
Reported-by: Raghavendra D Prabhu <me@rdprabhu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-29 11:38:46 +02:00
Michael Kerrisk c6822f6930 fsync.2, write.2: Minor tweaks to NeilBrown's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 18:17:01 +02:00
NeilBrown 9c93cce7a7 write.2, fsync.2, close.2: update description of error codes 
Since 4.13, errors from writeback are more reliably reported
to all file descriptors that might be relevant.

Add notes to this effect, and also add detail about ENOSPC and
EDQUOT which can be delayed in a similar many to EIO - for NFS
in particular.

Reviewed-by: Jeff Layton <jlayton@redhat.com>
Signed-off-by: NeilBrown <neilb@suse.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 18:08:28 +02:00
Michael Kerrisk bf1420bb85 fcntl.2: Inode read-write hints persist only until the filesystem is unmounted 
Reported-by: Jens Axboe <axboe@kernel.dk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:12 +02:00
Michael Kerrisk 6a11a5d439 open.2: Clarify that O_TMPFILE creates a *regular* file 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:12 +02:00
Michael Kerrisk ca20a8a5c8 open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:12 +02:00
Michael Kerrisk 431161696a open.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:12 +02:00
Michael Kerrisk ef81e101f5 open.2: Make the purpose of open() a little clearer at the start of the page 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:12 +02:00
Michael Kerrisk 6f72cae5db open.2: Make it explicit that O_CREAT creates a regular file 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:12 +02:00
Michael Kerrisk d8a21977bf sysfs.5: Add brief description of /sys/kernel/debug/tracing 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:12 +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 57c80845d0 getpid.2: Mention that PID == TGID, and note contrast with TID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 17:21:08 +02:00
Michael Kerrisk 80b435e1ba getpid.2: Minor wording fix: clarify that PID is the acronym for "process ID" 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 09:13:09 +02:00
Michael Kerrisk c9269da6d1 gettid.2: SEE ALSO: add getpid(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 09:08:23 +02:00
Michael Kerrisk 12fe9b1750 getpid.2: SEE ALSO: add gettid(2) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-28 09:07:47 +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
Mihir Mehta d904b9a167 ld.so.8: wfix 
Someone omitted a word in ld.so.8; this patch fixes that.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-27 09:52:28 +02:00
Michael Kerrisk 3a6474a315 tty.4: SEE ALSO: remove erroneiusly added tset(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 14:26:56 +02:00
Michael Kerrisk d6a1cc47c8 tty.4: SEE ALSO: add tset(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 14:00:26 +02:00
Michael Kerrisk bbd6443407 shells.5: SEE ALSO: add pam_shells(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 13:55:53 +02:00
Michael Kerrisk a971f65268 core.5: SEE ALO: add systemd-coredump(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 13:51:12 +02:00
Michael Kerrisk b9bf67f47a standards.7: SEE ALSO: add getconf(1), confstr(3), pathconf(3), sysconf(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 13:32:50 +02:00
Michael Kerrisk 083218c73d icmp.7: SEE ALSO: add rdisc(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 13:10:52 +02:00
Michael Kerrisk eb44f02b68 hier.7: SEE ALSO: add file-hierarchy(7) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 13:09:14 +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 8774257b50 capabilities.7: SEE ALSO: add captest(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 13:04:30 +02:00
Michael Kerrisk c8d6cd34da sched_setaffinity.2: SEE ALSO: add numactl(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 12:56:44 +02:00
Michael Kerrisk 53506ea9c7 ptrace.2: SEE ALSO: add ltrace(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 12:37:43 +02:00
Michael Kerrisk 8abf3239a1 keyctl.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 12:33:03 +02:00
Michael Kerrisk cd6d0def2f copy_file_range.2: wfix: s/COPY/COPY_FILE_RANGE/ in .TH line 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 12:22:28 +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 2222ef9b93 arp.7: SEE ALSO: add arpd(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 11:58:32 +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 b2bced6d6d pivot_root.2: SEE ALSO: add switch_root(8) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2017-09-25 10:46:39 +02:00