b2fc8e9f28
delete_module.2: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-11-07 13:46:38 +01:00
029599913b
clock_getres.2, clock_nanosleep.2: Linking with -lrt is no longer needed from glibc 2.17 onward
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-29 09:27:58 +01:00
e089cba10e
fork.2: Note treatment of default timer slack value on fork()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
934487a086
prctl.2: Document PR_SET_TIMERSLACK and PR_GET_TIMERSLACK
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
8e9412e7a5
execve.2: Document treatment of SECBIT_KEEP_CAPS securebits flag on execve()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
30cc7676ef
execve.2: Document treatment of PR_SET_PDEATHSIG on execve()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
46b7f60e65
prctl.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:28 +01:00
990e388795
prctl.2: Minor rewording for seccomp description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:23:03 +01:00
f49202ae2b
prctl.2: Reword PR_SET_NAME and PR_GET_NAME in terms of threads
...
Plus tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-28 07:18:11 +01:00
34709982a5
ptrace.2: Clarify that some operations are not present on all architectures
...
PTRACE_GETREGS, PTRACE_SETGREFS, PTRACE_GETFPREGS,
and PTRACE_GETSPREGS are not present on all architectures.
PTRACE_SYSEMU and PTRACE_SYSEMU_SINGLESTEP are present only
on x86.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=122383
Simon Paillard <spaillard@debian.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-25 14:04:23 +02:00
47cfbecf0a
getdomainname.2: Point out that these calls relate to NIS, not DNS
...
See http://bugs.debian.org/295635
Reported-by: Lars Wirzenius <liw@iki.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-25 12:27:15 +02:00
1733db3538
prctl.2: Note 'seccomp' semantics with respect to fork(), execve(), and prctl()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:30 +02:00
ff393a5f0d
times.2: Recommend clock_gettime(2) as alternative to times(2)
...
Recommend clock_gettime(2), not gettimeofday(2) as alternative to times(2).
From times(2):
"To measure changes in elapsed time, use gettimeofday(2)
instead."
From gettimeofday(2):
"POSIX.1-2008 marks gettimeofday() as obsolete, recommending the
use of clock_gettime(2) instead."
Some context, showing how use of gettimeofday() causes actual bugs
(also read comments):
http://blog.habets.pp.se/2010/09/gettimeofday-should-never-be-used-to-measure-time
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:20 +02:00
1959393715
prctl.2: Mention Documentation/prctl/no_new_privs.txt for PR_SET_NO_NEW_PRIVS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
b1df307176
prctl.2: Some edits to Kees's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
0fcc276ff1
prctl.2: Minor edits to Kee's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
f83fe154a8
prctl.2: document PR_SET_NO_NEW_PRIVS, PR_GET_NO_NEW_PRIVS
...
This adds a short description of the no_new_privs bit,
as described in Documentation/prctl/no_new_privs.txt.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
6239dfb213
prctl.2: Small improvements to PR_SET_SECCOMP discussion
...
Note type of 'arg3' for SECCOMP_MODE_FILTER.
Add pointer to Documentation/prctl/seccomp_filter.txt.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
d6ef3d5748
prctl.2: Minor edits to Kees's patch
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
34447828c4
prctl.2: update seccomp sections for mode 2 (BPF)
...
This adds a short summary of the arguments used
for "mode 2" (BPF) seccomp.
Signed-off-by: Kees Cook <keescook@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:54:19 +02:00
3cad956f53
set_thread_area.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
b84a1732b4
get_thread_area.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
f68512e9fe
intro.1, add_key.2, get_mempolicy.2, get_thread_area.2, intro.2, keyctl.2, mbind.2, request_key.2, set_thread_area.2, clock.3, cmsg.3, getcwd.3, getpw.3, intro.3, malloc.3, posix_memalign.3, shm_open.3, sleep.3, sysconf.3, intro.4, sd.4, intro.5, locale.5, slabinfo.5, intro.6, boot.7, bootparam.7, futex.7, glob.7, hier.7, intro.7, libc.7, locale.7, mq_overview.7, netlink.7, sem_overview.7, shm_overview.7, unix.7, intro.8: Global fix: Use consistent capitalization in NAME section
...
The line(s) in the NAME section should only use capitals
where English usage dictates that. Otherwise, use
lowercase throughout.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
ce154705ec
futex.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:48 +02:00
7fac88a949
eventfd.2, futex.2, mmap2.2, open.2, pciconfig_read.2, ptrace.2, reboot.2, request_key.2, sched_rr_get_interval.2, splice.2, stat.2, sync_file_range.2, syscalls.2, timer_create.2, vm86.2, pthread_attr_setscope.3, core.5, proc.5, aio.7, futex.7, netlink.7, time.7: Global fix: "userspace" ==> "user space" or "user-space"
...
Existing pages variously use "userspace or "user space".
But, "userspace" is not quite an English word.
So change "userspace" to "user space" or, when used
attributively, "user-space".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:53:33 +02:00
eceb82f70d
delete_module.2: SEE ALSO: Add modprobe(8)
...
Reported-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:26 +02:00
c470e180cf
query_module.2: Move some information in NOTES to VERSIONS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:26 +02:00
9100326959
create_module.2, delete_module.2, get_kernel_syms.2, init_module.2, query_module.2: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
3371ab17aa
init_module.2: Change copyright and license
...
Little of the original page now remains. Change
copyright and license
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
0cb430a1e5
init_module.2: Changes after review comments from Rusty Russell
...
Reviewed-by: Rusty Russell <rusty@rustcorp.com.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
27ad8f18a5
create_module.2: Note that ENOSYS probably indicates kernel 2.6+
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
6fe81824ca
query_module.2: Note that ENOSYS probably indicates kernel 2.6+
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
f400805045
delete_module.2: Change license and copyright
...
There is now nothing left of the original FSF-copyrighted
page. So, change the copyright and license.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:49:25 +02:00
b4f495025a
delete_module.2: Substantial reorganization after comments from Rusty Russell
...
Rusty notes that O_NONBLOCK is almost always used in
practice. Therefore, it would be better to reorganize
the page to consider that "the default".
Reviewed-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
Reviewed-by: Rusty Russell <rusty@rustcorp.com.au>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-24 14:45:43 +02:00
ce123e8e64
init_module.2: Add various pieces describing Linux 2.6+ behavior
...
Pieces take from, or inspired by, a patch sent by Kees.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
6b9024ca05
get_kernel_syms.2: Note that this system call is present only in kernels before 2.6
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
77a0889553
create_module.2: Note that this system call is present only in kernels before 2.6
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
fdeca96e95
query_module.2: Note that this system call is present only in kernels before 2.6
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
8f4d1a1c3c
init_module.2: Rewrite to Linux 2.6+ reality
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
460240cab4
delete_module.2: Rewrite to Linux 2.6+ reality
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
98038e9855
delete_module.2: SEE ALSO: add rmmod(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
a439440e16
query_module.2: SEE ALSO: Add modinfo(8) and lsinfo(8)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
59bdef6a21
query_module.2: Add a few words clarifying reference to /sys/module
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-18 15:05:25 +02:00
dc51f1ff84
link.2: Add EPERM error triggered by /proc/sys/fs/protected_hardlink
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-16 10:30:15 +02:00
f3996ef7f2
ipc.2: Update note on architectures that don't have ipc()
...
Replace mention of ia64 with x86-64 and ARM.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-16 10:23:02 +02:00
cd1df3b89b
socketcall.2: Update note on architectures that don't have socketcall()
...
Replace mention of ia64 with x86-64 and ARM.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-16 10:21:59 +02:00
b473be57b9
timer_settime.2, man-pages.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-15 11:13:02 +02:00
791657939e
phys.2: New link to unimplemented.2
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-09 14:13:48 +02:00
e7b742f33f
timer_settime.2: Small rewording around discussion of pointer arguments
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-02 07:28:14 +02:00
20de4d9f77
getitimer.2: Note Linux's odd handling of the new_value==NULL case
...
Reported-by: Trevor Woerner <twoerner@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-10-01 10:20:08 +02:00
f2d587e6a1
getitimer.2: Fix types used to declare fields in timeval struct
...
Reported-by: Trevor Woerner <twoerner@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-30 07:40:52 +02:00
8f172c56b2
quotactl.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-28 08:04:03 +02:00
ca8a0bd25b
sched_get_priority_max.2, sched_setparam.2, sched_setaffinity.2, sched_setscheduler.2, timer_create.2, malloc.3, pthread_attr_init.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_getattr_np.3, pthread_cancel.3, pthread_create.3, pthread_setschedparam.3, pthread_setschedprio.3, aio.7, time.7: Global ffix: disable justification and hyphenation in SEE ALSO
...
For a better visual result, disable justification and hyphenation
in SEE ALSO where page names are long.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-25 06:39:39 +02:00
e264f02416
keyctl.2: ffix: prevent hyphenation and justification under SEE ALSO
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-25 06:05:33 +02:00
cf4d436127
keyctl.2: Reorder SEE ALSO, without .br
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-25 06:00:07 +02:00
6c1544c132
syscalls.2, uname.2, boot.7: Global fix: s/OS/operating system/
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 10:05:20 +02:00
66a9882e46
bdflush.2, get_robust_list.2, kexec_load.2, madvise.2, mmap.2, mount.2, prctl.2, query_module.2, rt_sigqueueinfo.2, shmget.2, sigaction.2, syscalls.2, umount.2, malloc.3, hpsa.4, initrd.4, proc.5, bootparam.7, icmp.7, netlink.7, signal.7: Global fix: use "Linux kernel source" consistently
...
Rather than "kernel source".
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 10:02:34 +02:00
173fe7e792
arch_prctl.2, fcntl.2, flock.2, get_robust_list.2, getpriority.2, ioprio_set.2, migrate_pages.2, mmap.2, mremap.2, msync.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select.2, socket.2, subpage_prot.2, unshare.2, btree.3, dbopen.3, dl_iterate_phdr.3, dlopen.3, getnameinfo.3, hash.3, lockf.3, netlink.3, recno.3, rpc.3, xdr.3, cciss.4, console_ioctl.4, hpsa.4, initrd.4, msr.4, rtc.4, st.4, hosts.5, services.5, tzfile.5, aio.7, arp.7, capabilities.7, cpuset.7, feature_test_macros.7, futex.7, inotify.7, ip.7, ipv6.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, math_error.7, netlink.7, packet.7, pthreads.7, raw.7, spufs.7, udplite.7, uri.7, x25.7: Global fix: Various consistency fixes for SEE ALSO
...
Coauthored-by: Michael Kerrisk <mtk.manpages@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 09:53:22 +02:00
318c814291
stat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:36 +02:00
f06f501401
syscalls.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:03 +02:00
85d301e129
wait4.2: Note that these functions are nonstandard and recommend alternatives
...
Some edits to Adrian's path by mtk.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:03 +02:00
0ac42204d0
wait4.2: CONFORMING TO: Note SUS details for wait3()
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-23 15:50:58 +02:00
a38a23a17f
sigaction.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-23 06:49:47 +02:00
ca15be9183
sigaction.2: Tweak SA_RESETHAND description
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-23 06:49:47 +02:00
556bb77a36
shutdown.2: Document EINVAL error (and associated bug)
...
Eric Dumazet noted that EINVAL was not documented. Some further
digging shows that it's also not diagnosed consistently.
See https://bugzilla.kernel.org/show_bug.cgi?id=47111 .
Reported-by: Eric Dumazet <edumazet@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-06 11:42:51 +02:00
72da9ef157
ldd.1, execve.2, getdents.2, quotactl.2, select_tut.2, clock_getcpuclockid.3, fopencookie.3, getservent_r.3, matherr.3, mq_notify.3, pthread_create.3, pthread_getattr_np.3, wordexp.3: Global fix: s/-/\\-/ when real hyphen is required (e.g., in code)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-29 12:14:08 +02:00
352c778d01
semop.2: Recast discussion of blocking behavior in terms of threads
...
semop() blocks the calling thread, not the process.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 12:59:11 +02:00
77ba6370c2
semop.2: Minor rewording
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 12:45:23 +02:00
f81b78a4ca
semop.2: SEE ALSO: Add clone(2)
...
Give reader a clue about CLONE_SYSVSEM.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 12:43:52 +02:00
2e72e99169
select.2: Clarify equivalent pslect() code in terms of threads
...
s/sigprogmask/pthread_sigmask/
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:29:04 +02:00
5adf628119
clock_nanosleep.2: wfix: s/SA_SIGACTION/SA_RESTART/
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:28:19 +02:00
67378c4842
epoll_wait.2: Add pointer to select(2) for discussion of close in another thread
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-17 08:41:35 +02:00
f33050d604
poll.2: Add pointer to select(2) for discussion of close in another thread
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-17 08:36:48 +02:00
10ed041e56
select.2: Note behavior if monitored file descriptor is closed in another thread
...
Executive summary: a sane application can't rely on any
particular behavior if another thread closes a file descriptor
being monitored by select().
See https://bugzilla.kernel.org/show_bug.cgi?id=40852
Reported-by: Stephane Fillod <fillods@users.sf.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-17 08:36:48 +02:00
8c1d94ae86
select.2: Minor wording fixes
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-17 08:36:48 +02:00
355f61b5bc
epoll_wait.2: Describe timeout limitation in kernels < 2.6.37
...
As reported by Fredrik (and as far as I can tell the problem
went back to 2.6.0):
The timeout argument has an upper limit. Any values above that
limit are treated the same as -1, i.e. to wait indefinitely.
The limit is given by:
#define EP_MAX_MSTIMEO min(1000ULL * MAX_SCHEDULE_TIMEOUT / HZ, \
(LONG_MAX - 999ULL) / HZ)
That is, the limit depends on the size of a long and the timer
frequency. Assuming the a long is never smaller than 32 bits
and HZ never larger than 1000, the worst case is 35 minutes.
I think this should be mentioned under "BUGS".
Although this is likely to be fixed in the future
(http://lkml.org/lkml/2010/8/8/144 ), the problem exists in
at least 2.6.14 - 2.6.35. I don't know if select(2) and poll(2)
are affected.
https://bugzilla.kernel.org/show_bug.cgi?id=20762
Reported-by: Fredrik Arnerup <arnerup@kth.se>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-17 08:36:28 +02:00
11c85ed875
Removed trailing white space at end of lines
2012-08-14 00:39:21 +02:00
bf42aad4a7
mprotect.2, syscall.2, realpath.3, iso_8859-1.7: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 00:37:33 +02:00
4832b48ab0
futex.2: Fix description of EINVAL error
...
The current text seems incorrect. Replace with a more general
description.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 00:10:36 +02:00
e808bba0ff
futex.2: Various wording fix-ups
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 14:50:26 +02:00
9f6c40c0e6
futex.2: Consolidate error descriptions to ERRORS
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 14:25:13 +02:00
a2f11be3c1
mprotect.2: 'addr' argument is not const
...
As reported by Rasmus:
Both my system's man-pages (3.22) and the latest online
(3.41) show:
int mprotect(const void *addr, size_t len, int prot);
as the prototype for mprotect(2). However, POSIX [1] and the
actual sys/mman.h (on all the systems I checked) do not have
the const qualifier on the first argument.
Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 14:00:29 +02:00
608bf95023
capget.2, futex.2, sched_setscheduler.2, spu_create.2, spu_run.2, vfork.2, getnameinfo.3, netlink.3, cciss.4, console_codes.4, dsp56k.4, hpsa.4, sk98lin.4, filesystems.5, protocols.5, aio.7, capabilities.7, charsets.7, feature_test_macros.7, futex.7, hier.7, iso_8859-16.7, iso_8859-2.7, koi8-r.7, libc.7, man.7, netlink.7, numa.7, standards.7, unicode.7, units.7, uri.7, x25.7: Global fix: use UR macro where applicable
...
The syntax .UR http://example.com paired with .UE will create
links which one can interact, if the pager allows that. One
way to see the effect is ask the man(1) command to use browser
display, e.g.:
man -H man7/uri.7
("\:" is optional groff syntax to permit hyphenless line breaks.)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 10:02:36 +02:00
6edb20bcd8
migrate_pages.2: spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:26:21 +02:00
b0b1d9b517
ptrace.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-13 09:22:34 +02:00
13f78d96ad
getdents.2, select_tut.2, atof.3, atoi.3, pthread_create.3, pthread_sigmask.3, rtime.3, setbuf.3, tsearch.3, netlink.7: Remove unneeded casts
...
Reported-by: Jan Engelhardt <jengelh@medozas.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
ca302d0ee3
ptrace.2: Explain WNOHANG behavior and EINTR bug
...
I didn't like ithe "SIGKILL operates similarly, with exceptions"
phrase (if it's different, then it's not "similar", right?),
and now I got around to changing it. Now it says simply:
"SIGKILL does not generate signal-delivery-stop and therefore
the tracer can't suppress it."
Replaced "why WNOHANG is not reliable" example with a more
realistic one (the one which actually inspired to add this
information to man page in the first place): we got
ESRCH - process is gone! - but waitpid(WNOHANG) can still
confusingly return 0 "no processes to wait for".
Replaced "This means that unneeded trailing arguments may
be omitted" part with a much better recommendation
to never do that and to supply zero arguments instead.
(The part about "undocumentedness" of gcc behavior was bogus,
btw - deleted).
Expanded BUGS section with the explanation and an example
of visible strace behavior on the buggy syscalls which
exit with EINTR on ptrace attach. I hope this will lead
to people submitting better bug reports to lkml about
such syscalls.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
65cee725a9
adjtimex.2: srcfix: added FIXME
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
cb72917199
ptrace.2: srcfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
41a65f128c
migrate_pages.2: Fix description of return value
...
Reported-by: Christoph Lameter <cl@linux.com>
Reported-by: JoonSoo Kim <js1304@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
1f1fd5eff5
socket.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
982ff543cd
inotify_init.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
82fdd7c7d0
ioprio_set.2: Document who==0 for IOPRIO_WHO_PROCESS and IOPRIO_WHO_PGRP
...
For IOPRIO_WHO_PROCESS, who==0 means operate on the caller.
For IOPRIO_WHO_PGRP, who==0 means operate on the caller's
process group.
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
Reported-by: Марк Коренберг <socketpair@gmail.com>
Reported-by: Kalle Olavi Niemitalo <kon@iki.fi>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
c4949ba488
ioprio_set.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
b91e4e72eb
ioprio_set.2: Clarify the multithreaded behavior of ioprio_set(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-03 10:33:49 +02:00
bf1298c9e5
sigwaitinfo.2: Some wording clarifications
...
Mainly rewording things like "is delivered" to "becomes pending",
which is more accurate terminology.
Reported-by: Daniel Zingaro <daniel.zingaro@utoronto.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 05:52:22 +02:00
4e9ee22571
set_tid_address.2: Some rewordings and minor clarifications
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 05:09:45 +02:00
72442c6803
set_tid_address.2: Some minor rewordings
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 05:01:37 +02:00
568c4c02b7
set_tid_address.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-21 04:55:31 +02:00
f5fe595295
set_tid_address.2: Rename 'ctid' argument for consistency with clone(2) page
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 17:17:06 +02:00
5add3af3d8
clone.2: Rewrite discussion of sys_clone
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-20 17:17:06 +02:00
98309d3fea
syscalls.2: Move discussion of set_zone_reclaim(2) out of main table
...
This system call was never visible to user space, so it makes
sense to move it out of the main table of system calls into
the notes below the table.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
8eec4a2373
syscalls.2: Add kcmp(2)
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
45c99e3ec4
get_robust_list.2, get_thread_area.2, getcpu.2, getdents.2, gettid.2, io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2, ioprio_set.2, kexec_load.2, llseek.2, modify_ldt.2, mq_getsetattr.2, pivot_root.2, readdir.2, rt_sigqueueinfo.2, set_thread_area.2, sgetmask.2, spu_create.2, spu_run.2, subpage_prot.2, sysctl.2, tkill.2: Add note to SYNOPSIS that there is no glibc wrapper for system call
...
Reduce the chance that the reader may be misled into thinking
that there is a wrapper function for this system call by noting
explicitly in the SYNOPSIS that there is no glibc wrapper and
pointing the reader to NOTES for further details.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
498a96a239
syscall.2: Add some more details to the description of syscall(2)
...
And add another example of using syscall() to the program example.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
syscall.2: fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
50cebc0485
kexec_load.2: tfix
...
Reported-by: Michael S. Tsirkin <mst@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
38c6b6401d
path_resolution.2, epoll.4, fifo.4, futex.4, complex.5, environ.5: Remove outdated links
...
Remove links >= 5 years old that were created after historical
moves of pages to new sections.
Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:28 +02:00
44535dd29b
mount.2: For MS_REMOUNT, source is ignored
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-07-19 12:51:27 +02:00
f658081708
seteuid.2: Note glibc version where setegid() implementation changed
...
In glibc 2.2/2.3, setegid() switched from setregid() to setresgid().
2012-07-19 12:51:27 +02:00
6fdbc7794f
access.2, prctl.2, recv.2, send.2, euidaccess.3, mbstowcs.3, mcheck.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:26 +12:00
02ace852fb
open.2, select.2, aio_cancel.3, aio_suspend.3: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:25 +12:00
a59e64bef2
spfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:25 +12:00
f66524636d
msgctl.2, msgget.2, msgop.2, semctl.2, semget.2, semop.2, shmctl.2, shmget.2: NOTES: <sys/types.h> and <sys/ipc.h> aren't strictly needed
...
Add text to NOTES to say that the <sys/types.h> and <sys/ipc.h>
header files aren't required by Linux or the standards, but may
be needed for portability to old systems.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:25 +12:00
548be2a60e
msgctl.2, semctl.2, shmctl.2, svipc.7: Don't mention that ipc_perm is defined in <sys/ipc.h>
...
There's no need to mention that the 'ipc_perm' structure
is defined in <sys/ipc.h>. That's an implementation detail,
and furthermore <sys/ipc.h> is itself included by the other
System V IPC header files. The current text might lead the
reader to conclude that they must include <sys/ipc.h>, which
is not the case (it is required neither on Linux, nor by the
standards).
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:25 +12:00
96668cfdbb
keyctl.2: srcfix: Added FIXMEs
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-06-08 03:10:25 +12:00
0ab8aeecc5
Removed trailing white space at end of lines
2012-05-11 08:13:04 +12:00
dbd577f885
get_robust_list.2: tstamp fix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-11 08:11:32 +12:00
e5080839ee
semop.2: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-11 08:10:50 +12:00
eae2dfceab
futimesat.2, mount.2, confstr.3, iconv.3, makedev.3, malloc.3, strcasecmp.3, strcat.3, strcmp.3, strcpy.3, strdup.3, strftime.3, strnlen.3, strpbrk.3, strspn.3, strtok.3, strxfrm.3, sk98lin.4, icmp.7, ipv6.7, packet.7, raw.7, rtnetlink.7, unix.7, x25.7, ldconfig.8, nscd.8: tstamp
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-11 08:09:28 +12:00
01d8b73f92
poll.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-10 18:07:47 +12:00
e1c5ebfa25
io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2: Rewrite to focus on system call API
...
Rewrite to focus on the system call interface, adding
some notes on the libaio wrapper differences.
See the following mail:
2012-05-07 "aio manuals", linux-man@vger.kernel.org
http://thread.gmane.org/gmane.linux.man/1935/focus=2910
Other minor rewrites.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-10 11:57:03 +12:00
dd3ec6febb
io_cancel.2, io_destroy.2, io_getevents.2, io_setup.2, io_submit.2: srcfix: remove old commented-out formatting directives
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-10 11:57:03 +12:00
1847167b8b
open.2: Describe race of direct I/O and fork()
...
Rework 04cd7f64http://thread.gmane.org/gmane.linux.kernel.mm/77571
Acked-by: KOSAKI Motohiro <kosaki.motohiro@jp.fujitsu.com>
Cowritten-by: Jan Kara <jack@suse.cz>
Cowritten-by: Hugh Dickins <hughd@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-09 19:18:43 +12:00
99eccaa774
get_robust_list.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-09 17:18:07 +12:00
ded312a306
getcpu.2: DESCRIPTION: reword a sentence to be clearer
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-09 17:18:07 +12:00
6ca014574b
getcpu.2: Refer reader to NOTES for more info about 'tcache'
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-09 17:18:07 +12:00
178df36f74
getcpu.2: Add RETURN VALUE and ERRORS sections
...
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-09 17:11:37 +12:00
5d2f567434
symlinkat.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-08 22:37:34 +12:00
8065732760
inotify_init.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-08 22:37:01 +12:00
65a0c0120f
clock_getres.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-08 09:20:22 +12:00
e53eca7462
ioctl_list.2: ffix
...
See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=671514
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:19 +12:00
0ce81ab564
ptrace.2: srcfix to avoid groff warning
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:19 +12:00
56f2caff29
syscalls.2: Formatting fixes
...
From "groff -ww ..." (or "man --warnings=w ..."):
warning: around line 157: table wider than line width
Have to use text blocks. Move some text to its correct column.
Split text to two columns to avoid hyphenation.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:18 +12:00
77b9991851
stat.2: Formatting fixes
...
From "groff -ww" (or "man --warnings=w ..."):
warning: around line 442: table wider than line width
GNU man uses line length of 78.
Use text blocks. Two spaces between sentences or better: start
each sentence in a new line.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:18 +12:00
4a037a4a01
socket.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:18 +12:00
3e18f289e7
ptrace.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:18 +12:00
a3492501ff
prctl.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:18 +12:00
4208a89631
mount.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
f6253e6182
madvise.2: tfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
078a7d6e3a
_exit.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
61e1aee047
mount.2, dbopen.3, fenv.3: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
2dd7f4cbe3
accept.2: wfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
b3682895f8
clock_getres.2: ffix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
4175f99924
add_key.2, query_module.2, request_key.2, resolver.3, stpcpy.3, strftime.3, elf.5, proc.5, mdoc.samples.7: srcfix: Wrap source lines at sentence boundaries
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
f61d734d64
madvise.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
e9dedcd212
madvise.2: grfix
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:17 +12:00
a1402e4c93
syslog.2: Remove some details about obsolete Linux libc
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:16 +12:00
8a2384a440
sysinfo.2: Remove reference to obsolete libc5
...
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:16 +12:00
2606a2b068
signal.2: Note that 'sig_t' requires _BSD_SOURCE
...
Also remove some old Linux libc details
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:16 +12:00
6f0b2c8c9a
poll.2: Clarify discussion of wrapper function emulation
...
Clarify that glibc (as well as old libc) provides emulation
using select(2) on older kernels that don't have a poll()
system call.
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-05-07 15:30:16 +12:00
David Prévot