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

4461 Commits

Author SHA1 Message Date
Michael Kerrisk e0f1f1765b posix_fadvise.2: ERRORS: Since 2.6.16, the kernel correctly deals with the ESPIPE case 
Reported-by: Weijie Yang <weijie.yang.kh@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-11 09:32:53 +01:00
Adam Jiang 59ab8fcf0f sched_setscheduler.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-11 06:16:39 +01:00
Michael Kerrisk 001fed0312 epoll_ctl.2: Regular files and directories can't be monitored with epoll_ctl() 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-10 14:00:25 +01:00
Michael Kerrisk f285a958f3 clock_nanosleep.2: Note that 'clock_id' can also be a CPU clock ID 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-10 13:25:30 +01:00
Michael Kerrisk e125c3e172 timerfd_create.2: srcfix: added FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-10 11:56:49 +01:00
Heinrich Schuchardt b7670bdd0d ioctl.2: Rename 'd' argument to 'fd' in text 
In most other manpages file descriptors are called 'fd'.
This patches renames attribute 'd' to 'fd'.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-09 21:11:52 +01:00
Michael Kerrisk 5bc20f9e79 syscalls.2: SEE ALSO: add errno(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-04 08:20:07 +01:00
Michael Kerrisk 4e0b8e82c7 syscall.2: SEE ALSO: add errno(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-11-04 08:19:25 +01:00
Michael Kerrisk ea55bc7b3a prctl.2: PR_SET_NAME silently truncates strings that exceed 16 bytes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 14:26:23 +01:00
Andreas Schwab db6d60b30a prctl.2: Correct description of null-termination in PR_GET_NAME and PR_SET_NAME 
The size of the process name has always been at most 16 byte
_including_ the null terminator.  This also means that the
name returned by PR_GET_NAME is always null-terminated.

Signed-off-by: Andreas Schwab <schwab@suse.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 14:22:55 +01:00
Michael Gehring 4cd11c5594 process_vm_readv.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 14:14:17 +01:00
Michael Kerrisk f7d11fdac6 tee.2: Add shell session demonstrating use of the example program 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 12:59:24 +01:00
Michael Kerrisk ced56703cb vmsplice.2: srcfix: Added FIXME 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 12:59:24 +01:00
Michael Kerrisk 2377c64851 splice.2: Reformat description of 'fd_in' and 'off_in' to improve readability 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 12:59:24 +01:00
Michael Kerrisk 9c11e37c8f sched_setaffinity.2: NOTES: Add paragraph on how to discover set of CPUs available on system 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 12:59:23 +01:00
Michael Kerrisk f648d34394 sched_setaffinity.2: SEE ALSO: add nproc(1) and lscpu(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-28 12:59:23 +01:00
Michael Kerrisk ad624ff433 readlink.2, readv.2, pthread_rwlockattr_setkind_np.3, signal.7, unix.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-15 11:13:45 +02:00
Michael Kerrisk b6d8894f73 readv.2: The raw preadv() and pwritev() syscalls split 'offset' into 2 arguments 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-14 07:44:15 +02:00
Michael Kerrisk a5c24f8c5f timer_settime.2: tfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-11 08:16:31 +02:00
Michael Kerrisk 4bf044cbf2 readlink.2: Add free() call to example program 
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-10 22:22:27 +02:00
Michael Kerrisk 2d1b2fbc61 truncate.2: wfix 
Reported-by: Jonny Grant <jg@jguk.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-10 21:33:03 +02:00
Michael Kerrisk e890609356 capget.2, ptrace.2, vhangup.2, wait.2, ttyslot.3, console.4, proc.5, utmp.5, boot.7: tfix: page xrefs for init 2014-10-03 08:47:03 +02:00
Michael Kerrisk f29d0171ad open_by_handle_at.2: tfix: page xref 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-03 08:42:29 +02:00
Michael Kerrisk b22f4e4f60 mount.2: tfix: page xref 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-03 08:41:54 +02:00
Michael Kerrisk 834e5597f0 fanotify_mark.2: tfix: xrefs 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-03 08:40:08 +02:00
Michael Kerrisk 6f9e0e572e Removed trailing white space at end of lines 2014-10-03 00:01:00 +02:00
Michael Kerrisk bc65e77236 ldd.1, execve.2, fanotify_init.2, fanotify_mark.2, getrlimit.2, open.2, readlink.2, sched_setattr.2, sched_setscheduler.2, shmget.2, syscalls.2, vmsplice.2, dlopen.3, fseeko.3, getgrent.3, mq_getattr.3, mq_open.3, realpath.3, armscii-8.7, ascii.7, iso_8859-1.7, iso_8859-10.7, iso_8859-11.7, iso_8859-13.7, iso_8859-14.7, iso_8859-15.7, iso_8859-16.7, iso_8859-2.7, iso_8859-3.7, iso_8859-4.7, iso_8859-5.7, iso_8859-6.7, iso_8859-7.7, iso_8859-8.7, iso_8859-9.7, koi8-r.7, koi8-u.7, sched.7, ld.so.8: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-02 23:47:51 +02:00
Michael Kerrisk f479e19cf0 fanotify_init.2: The 'event_f_flags' failure to check invalid flags was fixed in 3.15 
Reported-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 13:38:32 +02:00
Michael Kerrisk 51d266b762 fanotify_init.2: wfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 13:38:32 +02:00
Heinrich Schuchardt 0d69c09327 fanotify_init.2: BUGS: O_CLOEXEC is ignored 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 13:38:32 +02:00
Michael Kerrisk e5209a5af7 fanotify_mark.2: Note that various bugs were fixed in Linux 3.16 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 13:38:32 +02:00
Cyril Hrubis a2cf889831 vmsplice.2: vmsplice() does not fail when nr_segs==0 
This nr_segs==0 case is no-op; the call succeeds and no
EINVAL error is returned.

See fs/splice.c vmsplice syscall which contains:

        if (unlikely(nr_segs > UIO_MAXIOV))
                return -EINVAL;
        else if (unlikely(!nr_segs))
                return 0;

And looking at the git log suggests that the code was always thus.

Signed-off-by: Cyril Hrubis <chrubis@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 13:38:32 +02:00
Michael Kerrisk bb7a4bccb3 readlink.2: Fix description of readlinkat() with empty 'pathname' 
Reported-by: Ben Hutchings <ben@decadent.org.uk>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 11:56:48 +02:00
Michael Kerrisk e15dc33869 getrlimit.2: Since Linux 3.5, the accounting formula for RLIMIT_MSGQUEUE has changed 
Reported-by: Doug Ledford <dledford@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 11:56:47 +02:00
Michael Kerrisk 1aa06521e9 pread.2: tfix 
Reported-by: Lanchon <lanchon@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-10-01 11:56:47 +02:00
Michael Kerrisk 4e1a4d72f0 open.2: Fix number and formula in description of EOVERFLOW error 
Reported-by: Shriramana Sharma <samjnaa@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-26 07:30:02 +02:00
Michael Kerrisk 1d94912fb7 syscalls.2: Add 3 new system calls added in Linux 3.17 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-25 12:25:05 +02:00
Carlos O'Donell 3252fa3f03 wait.2: ffix: add paragraph break before errno note in RETURN VALUE section 
The text "Each of these calls sets errno to an appropriate
value in the case of an error." is not only for waitid.

This patch adds a paragraph break to move the errno note
to a new paragraph where it makes sense, as it applies to
all the wait* functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-25 12:19:37 +02:00
Davidlohr Bueso 9a413675b1 shmget.2: Note some details on defaults for SHMALL and SHMMAX 
Based on a very heavily edited patch from Davidlohr Bueso.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-23 07:18:25 +02:00
Michael Kerrisk 562ac2f24e shmget.2: srcfix: Note commits for 3.16 SHMALL + SHMMAX changes 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-23 06:52:19 +02:00
Michael Kerrisk f037b098c2 shmget.2: Tweak kernel version numbers for SHMALL and SHMMAX changes 
It's quite probably that these changes will go infot 3.16,
rather than 3.17

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-23 06:46:46 +02:00
Michael Kerrisk d4bf702fac shmget.2: Rework the SHMALL description 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-23 06:46:46 +02:00
Michael Kerrisk 1fabbf12f6 shmget.2: Minor tweaks to Manfred's patch 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-23 06:39:49 +02:00
Manfred Spraul e5cceccf91 shmget.2: Update for increase of SHMALL and SHMMAX 
The default values of SHMALL and SHMMAX have been increased.

Signed-off-by: Manfred Spraul <manfred@colorfullife.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-23 06:39:49 +02:00
Michael Kerrisk 1a212a018f execve.2: Remove unneeded ".sh" extension in interpreter script example 
See https://bugzilla.kernel.org/show_bug.cgi?id=84701

As noted by C. Alex North-Keys:

1) Command name extensions considered harmful: Adding ".sh", or
any other unneeded extension, unnecessarily duplicates meta
information already present in the interpreter directive,
exposing an implementation detail that then ends up explicitly
part of other programs running this one.  Later, when such a
script is replaced with a new version in Python, C, etc., the
useless ".sh" has to be retained to avoid breaking those other
programs' calls to this one, and now has a stark antifunction
of lying about the script's content and occasionally causing
admins to run undefined experiments as root (like
"bash -x ./reallyperlscript.sh"). Such extensions, while fine
in DOS which ignores extensions explicitly, is a serious flaw
in Unix-targeted script writing.  Canonical documentation
from the Linux manual should not support such a flawed idiom -
recommending against it would be preferred.

A more extensive rant against them can be found at:
http://www.talisman.org/~erlkonig/documents/commandname-extensions-considered-harmful

2) The space after "#!" in the interpreter directive is minor -
and the kernel's fs/binfmt_script.c specifically allows for it -
but versions of unix have length limits from ~30 characters to
Linux's 127 or so (if that number's correct) so the space does
have a cost.  Most scripts I've seen lack that space, and
there's no real reason to encourage it.

Reported-by: C. Alex North-Keys <erlkonig@talisman.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-23 06:21:51 +02:00
Michael Kerrisk 2333bf67ab readlink.2: SEE ALSO: add realpath(3) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-21 19:51:48 +02:00
Michael Kerrisk ac30de076a sched_setattr.2, sched_setscheduler.2: SEE ALSO: add chrt(1) 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-21 19:51:48 +02:00
Michael Kerrisk f5d401ddda Removed trailing white space at end of lines 2014-09-21 11:24:24 +02:00
Michael Kerrisk daf084cc33 clone.2, flock.2, getpid.2, getunwind.2, mount.2, reboot.2, semop.2, seteuid.2, setgid.2, setns.2, setresuid.2, setreuid.2, setuid.2, uname.2, unshare.2, clock.3, drand48.3, proc.5, capabilities.7, credentials.7, mq_overview.7, namespaces.7, pid_namespaces.7, svipc.7, user_namespaces.7: tstamp 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-21 11:23:07 +02:00
Michael Kerrisk 9219d20802 clone.2: srcfix 
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
 2014-09-16 10:05:11 +02:00