Commit Graph

7980 Commits

Author SHA1 Message Date
Guillem Jover 318c814291 stat.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:36 +02:00
David Prévot be029488f4 tsearch.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:28 +02:00
David Prévot 8720e679e0 regex.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:23 +02:00
David Prévot 72b62e6876 cpuid.4: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:10 +02:00
David Prévot 453a26b887 getutent.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:03 +02:00
David Prévot f06f501401 syscalls.2: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:03 +02:00
David Prévot 053439c9fb ldd.1: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:03 +02:00
Michael Kerrisk bc636d8ab1 inotify.7: tfix
Reported-by: Anatoli Klassen <anatoli@aksoft.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-24 07:15:03 +02:00
Adrian Bunk 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
Michael Kerrisk 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
Yuri Kozlov c0a2871b70 aio_write.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-23 15:38:22 +02:00
Michael Kerrisk a38a23a17f sigaction.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-23 06:49:47 +02:00
Michael Kerrisk ca15be9183 sigaction.2: Tweak SA_RESETHAND description
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-23 06:49:47 +02:00
Michael Kerrisk 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
Michael Kerrisk 559a2b6696 sigvec.3: Add "int" arg to sv_handler definition in sigvec structure
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-06 09:36:43 +02:00
Michael Kerrisk e191c68505 sigvec.3: Fix small error in discussion of blocking of signals
The signal that causes the handler to be invoked is blocked,
but saying "by default" implies that this can be changed via
the API. It cannot. (One needs sigaction(2) for that.)

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-06 09:12:38 +02:00
Michael Kerrisk 1bea464c1f sigvec.3: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-09-06 09:12:38 +02:00
Michael Kerrisk bb890443c8 fts.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-29 12:16:17 +02:00
Michael Kerrisk 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
Michael Kerrisk 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
Michael Kerrisk 77ba6370c2 semop.2: Minor rewording
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 12:45:23 +02:00
Michael Kerrisk 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
Michael Kerrisk eb58a74c8c ld.so.8: Add some details for LD_PRELOAD
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:20 +02:00
Michael Kerrisk 15d116d5c9 ld.so.8: Describe interpretation of slashes in dependency strings
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:20 +02:00
Michael Kerrisk 8e9ea025e1 ld.so.8: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:20 +02:00
Michael Kerrisk de6d7600bf ld.so.8: grfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:20 +02:00
Michael Kerrisk d9839d46f3 ld.so.8: Repeat note that LD_LIBRARY_PATH is ignored in privileged programs
This point is already noted when discussing search order for
libraries, but it's woth repeating under the specific discussion
of LD_LIBRARY_PATH further down the page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:20 +02:00
Michael Kerrisk df7ef2672f ld.so.8: Note that LD_PRELOAD list separator can be space or colon
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:20 +02:00
Michael Kerrisk 24d989e596 ld.so.8: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:19 +02:00
Michael Kerrisk 7bc74c600d gnu_get_libc_version.3: Remove unneeded "#define _GNU_SOURCE" from SYNOPSIS
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-27 00:53:19 +02:00
Michael Kerrisk 5484b544f9 Changes.old: spfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-24 09:29:49 +02:00
Michael Kerrisk 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
Michael Kerrisk 34ef249eb7 pthread_kill.3, pthread_sigqueue.3: Remove wording "another"
Writing "another thread" in these pages implies that these
functions can't be used to send a signal to the calling thread
itself, which is of course untrue.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:28:56 +02:00
Michael Kerrisk 760655c297 getenv.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:28:19 +02:00
Michael Kerrisk 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
Michael Kerrisk 67914165b3 proc.5: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:28:19 +02:00
Michael Kerrisk 055024ed2e proc.5: Update description of 'starttime' field of /proc/PID/stat
The unit of measurement changed from jiffies to clock ticks in
Linux 2.6.

See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=675891

Reported-by: Frédéric Brière <fbriere@fbriere.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-22 15:27:31 +02:00
Simon Josefsson dee998a215 syslog.3: Remove (apparently bogus) text claiming LOG_AUTH is deprecated
LOG_AUTH is in POSIX, and widely available. There
seems to be no basis to the claim it is deprecated.

Quoting Simon:
    I cannot find any other source that claim LOG_AUTH is
    deprecated in any way.  LOG_AUTH is distinct from
    LOG_AUTHPRIV.  The GNU C Library manual only documents
    LOG_AUTH.  The header files contains both without any
    comment.  Common systems like Debian appear to refer to
    both auth and authpriv facilities in syslog configurations.
    Popular daemons appear to use both facilities.
    Both facilities are discussed in several RFCs.

See https://bugzilla.kernel.org/show_bug.cgi?id=46091

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-17 15:02:42 +02:00
Michael Kerrisk 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
Michael Kerrisk 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
Michael Kerrisk 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
Michael Kerrisk 8c1d94ae86 select.2: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-17 08:36:48 +02:00
Michael Kerrisk 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
Michael Kerrisk de54b4ec24 slabinfo.5: srcfix: Added FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-16 10:48:24 +02:00
Michael Kerrisk 2e2c032fe3 iso_8859-1.7: Minor fixes
Reported-by: Bjarni Ingi Gislason <bjarniig@rhi.hi.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 21:17:05 +02:00
Michael Kerrisk 00702accc4 proc.5: Clarify header file referred related to 'flags' field of /proc/PID/stat
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 21:10:51 +02:00
Michael Kerrisk 454910ee9e secure_getenv.3: New link to getenv.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 10:59:38 +02:00
Michael Kerrisk 4e1927c6ec getenv.3: Document secure_getenv(3)
Reviewed-by: Florian Weimer <fweimer@redhat.com>
Reviewed-by: Andreas Schwab <schwab@linux-m68k.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2012-08-14 10:59:38 +02:00
Michael Kerrisk e82600ef6e Start of man-pages-3.43: updating Changes and Changes.old 2012-08-14 00:46:52 +02:00
Michael Kerrisk 1a7006aaaf Start of man-pages-3.43: updating .Announce and .lsm files 2012-08-14 00:46:52 +02:00