Commit Graph

7584 Commits

Author SHA1 Message Date
Michael Kerrisk 6f92d1d707 Makefile: use "mkdir -p" instead of "-make"
For some casual readers of the Makefile, "mkdir -p" is
probably a little easier to read than the equivalent "-make".

Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:08 +12:00
Michael Kerrisk 50b5741877 Removed trailing white space at end of lines 2012-04-17 23:09:04 +12:00
Michael Kerrisk 69287cb678 prctl.2: Fixes to PR_SET_MM after comments from Cyrill
Remove some FIXMEs and comment out pieces of text that describe
features not yet merged mainline kernel.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 3612be0418 prctl.2: Various edits and improvements to Cyrill's patch
* Wording improvements

* Addition of some FIXMEs for suspicious points

* Addition of various EINVAL cases

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Cyrill Gorcunov 3a620d0b7b prctl.2: Document PR_SET_MM (new in Linux 3.3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Reuben Thomas 5ee63e782f Makefile: Add "uninstall" as a synonym for "remove" target
"uninstall" is the GNU standard name for the target,
so it'll be the one most users are used to.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 37ec86d510 div.3: CONFORMING TO: Add C99
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 47561b003a memchr.3: Remove mention of terminating null in description of rawmemchr()
Reported-by: Reuben Thomas <rrt@sc3d.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 3062824dae mmap.2: Clarify NOTES discussion of mmap() versus mmap2()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 02ddee60aa mmap2.2: Clarify that this system call should not be invoked directly
See https://bugzilla.kernel.org/show_bug.cgi?id=42892

Reported-by: Kevin O'Gorman <kevinogorman4@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 1e4e3badf3 unix.7: Add a detail on autobind feature
Reported-by: Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 486fccf2e7 nologin.5: nologin must not only exist, but *be readable* to be effective
Reported-by: Tetsuo Handa <penguin-kernel@i-love.sakura.ne.jp>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:09:04 +12:00
Michael Kerrisk 962232bffc times.2: ERRORS: Add EFAULT
As Simone notes, RETURN VALUE says:

On error, (clock_t) -1 is returned, and errno is set appropriately

but no value for errno is specified.  The only error case is
EFAULT, so let's add that.

Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-17 23:08:58 +12:00
Michael Kerrisk 20d58e69bd times.2: tfix: BUGS: clockid_t ==> clock_t
Reported-by: Simone Piccardi <piccardi@truelite.it>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Michael Kerrisk b857fda584 poll.2: Document semantics of passing zero in 'events' field
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Michael Kerrisk 096ca08af4 poll.2: Document negative value in 'fd' field
Reported-by: Michael Welsh Duggan <mwd@cert.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Mike Frysinger ef30129360 sigprocmask.2: ERRORS: add EFAULT
Signed-off-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:27:09 +12:00
Michael Kerrisk 2d350ede02 fchmodat.2: Note difference between glibc wrapper and underlying system call
The wrapper function has a 'flags' argument (which currently
serves no purpose), while the underlying system call does not.

Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:26:36 +12:00
Michael Kerrisk d660ffd524 fchmodat.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:18:29 +12:00
Michael Kerrisk 79038fa74d perror.3: Note that use of 'sys_errlist' is deprecated
Reported-by: Jesus Otero <jesus.otero@rysg.es>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:18:29 +12:00
Michael Kerrisk b29f28723d perror.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:18:29 +12:00
Michael Kerrisk 3dd1c10f28 sysconf.3: Add mention of _SC_SYMLOOP_MAX
Reported-by: Ricardo Catalinas Jiménez <jimenezrick@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-16 08:18:29 +12:00
Michael Kerrisk ecc1f45b58 capabilities.7: Add prctl(PR_SET_MM) to CAP_SYS_RESOURCE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 12:56:14 +12:00
Abhijith Das a8ceabbc8c fcntl.2: Explain behaviour of F_GETLEASE during lease break
Here's a patch to the fcntl.2 manpage that explains
the working of F_GETLEASE in a bit more detail during
lease breaks. Basically, what happens is this: When a
lease break is initiated by a lease breaker, subsequent
F_GETLEASE calls return the target lease type after
the lease break and not the existing lease type. This
behavior persists until the lease holder downgrades/unlocks
the lease or the kernel forcibly does it after the lease
break timeout expires.

The implicit assumption is that F_GETLEASE should
return the existing lock type until the downgrade/unlock
has actually taken place, which is not true. I've verified
that the kernel indeed returns the target lease type. It
is also simple enough to verify this behavior in a small
program, where you can observe that the lease type
returned by F_GETLEASE in the signal handler for a
lease break is different from the existing lease type.

Signed-off-by: Abhijith Das <adas@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 10:43:00 +12:00
Michael Kerrisk a05228ea3a getaddrinfo.3: Correct type of ai_addrlen field
Reported-by: Jak <jak@gmx.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 528db0236c mallopt.3: Fix text describing M_PERTURB and free()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 7396b79c68 epoll_wait.2: Another thread can add to epoll instance while epoll_wait is blocked
See https://bugzilla.kernel.org/show_bug.cgi?id=43072

Reported-by: Armin Rigo <arigo@tunes.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 70a6338b76 epoll_wait.2: A few wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 72bbde85be epoll_wait.2: Clarify that epoll_pwait() blocks calling *thread*
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 284976f891 epoll_wait.2: Minor change: add explicit reference to epoll(7) at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk fde633deb6 epoll_create.2: Rework discussion of 'size' argument
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 6b6f540407 epoll_create.2: Add .SS for description of epoll_create1()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 5f4e9d5acd epoll_create.2: Minor change: add explicit reference to epoll(7) at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 78d1cbdec8 epoll_ctl.2: Minor change: add explicit reference to epoll(7) at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Michael Kerrisk 2b348e568f epoll.7: Some minor clarifications at start of DESCRIPTION
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-15 09:39:52 +12:00
Jeff Mahoney dfad7db9a2 netlink.7: Note cases where nonprivileged users can use netlink multicast groups
See also https://bugzilla.novell.com/show_bug.cgi?id=754611

Reported-by: Petr Gajdos <pgajdos@suse.cz>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 13:32:33 +12:00
Michael Kerrisk 1d7824bbfe pthread_testcancel.3: tfix
Reported-by: Armin Rigo <arigo@tunes.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 13:18:23 +12:00
Michael Kerrisk 7534ecb2ca nsswitch.conf.5: Minor fix-ups after comments from Mark Bannister
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 11:37:22 +12:00
Michael Kerrisk 9aa96150d0 nsswitch.conf.5: Light edits to Mark Bannister's changes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 11:37:22 +12:00
Mark R Bannister 79e2fba2d9 nsswitch.conf.5: Significant rewrites and improvements
This patch applies to nsswitch.conf.5 in man-pages-3.36.

My changes almost completely rewrite large sections of the
man page. They are needed to add clarity, correct grammar,
reduce confusion, and bring up-to-date with the latest glibc.
I have checked the man page against the nss source code in
glibc 2.14.90.

Historical notes are demoted to the footer.

The rewrite makes the man page much clearer to
understand, more authoratitive, and easier to read.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-14 11:37:22 +12:00
Michael Kerrisk b76a964b20 queue.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 13:21:07 +12:00
Michael Kerrisk f1e90ec441 gettimeofday.2: Note that compiler issues warnings if 'tv' is NULL
Reported-by: Felix <fkater@googlemail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 13:16:49 +12:00
Michael Kerrisk d5c4e19747 gettimeofday.2: Reorganize content
The main change is to move the historical information about
the 'tz_dsttime' to NOTES.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 13:10:57 +12:00
Michael Kerrisk dff6bb1919 sigaction.2: Clarify that the use of SI_SIGIO is for Linux 2.2 only
See also http://sourceware.org/bugzilla/show_bug.cgi?id=6745

Reported-by: Andreas Jaeger <aj@suse.com>
Reported-by: <who@connect.carleton.ca>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 11:47:43 +12:00
Michael Kerrisk 609b89e9f8 aio_read.3: tfix
Reported-by: Alexander Kruppa <akruppa@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 11:17:05 +12:00
Michael Kerrisk d53de2a707 select.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 05:44:52 +12:00
Michael Kerrisk c89b11cc01 Changes.old: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-04-12 04:33:31 +12:00
Regid Ichira c294cd695d fread.3: Clarify further that return value is number of items, not bytes
See also http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=665780

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-30 07:55:26 +13:00
Michael Kerrisk ed9821bba0 fcntl.2: Change type of arg from "long" to "int"
Various fcntl(2) commands require an integral 'arg'.
The man page said it must be "long" in all such cases.
However, for the cases covered by POSIX, there is an
explicit requirement that these arguments be "int".
Update the man page to reflect. Probably, all of the
other "long" cases (not specified in POSIX) should
be "int", and this patch makes them so. Based on a
note fromEric Blake, relating to F_DUPFD_CLOEXEC.

Reported-by: Eric Blake <ebb9@byu.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-30 07:36:20 +13:00
Michael Kerrisk d39a9b9833 ptrace.2: Minor edits to Denys Vlasenko's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-03-30 06:59:50 +13:00