Commit Graph

15764 Commits

Author SHA1 Message Date
Michael Kerrisk fca67dd016 strftime.3: Note which 'tm' fields are used to calculate each output string
See https://bugzilla.redhat.com/show_bug.cgi?id=1162218

Reported-by: Jeremy Harris <jeharris@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-13 10:51:34 +13:00
Michael Kerrisk 8dc9c2d66e strftime.3: Minor reordering of some text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-13 10:51:16 +13:00
Michael Kerrisk 92a2239f31 symlink.7: Some "magic" symlinks have permissions other than 0777
See https://bugs.debian.org/743525

Reported-by: Zefram <zefram@fysh.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-13 10:43:27 +13:00
Michael Kerrisk f1e1b550a9 dl_iterate_phdr.3: Note that first object visited by 'callback' is the main program
See https://bugzilla.kernel.org/show_bug.cgi?id=94141

Reported-by: Simon Que <sque@chromium.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 20:28:11 +01:00
Michael Kerrisk 9b14ad2db5 dl_iterate_phdr.3: Describe 'struct dl_phdr_info' fields added in glibc 2.4
See https://bugzilla.kernel.org/show_bug.cgi?id=103011

Reported-by: Paul Pluzhnikov <ppluzhnikov@google.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 19:59:46 +01:00
Michael Kerrisk cf1487b1da open.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 17:36:20 +01:00
Michael Kerrisk 1893b64807 recv.2, cmsg.3: Note that cmsg_len is typed as socklen_t in POSIX.1
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:58:07 +01:00
Michael Kerrisk 4ecc4f795f cmsg.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:53:52 +01:00
Michael Kerrisk 8d8ee1cac3 recv.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:52:34 +01:00
Michael Kerrisk 8924f60387 recv.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:52:21 +01:00
Nikola Forró aea45daeee recv.2, cmsg.3: Fix type of cmsg_len member of cmsghdr structure
The type shown for cmsg_len member of cmsghdr structure is socklen_t,
but the actual type used by glibc and the kernel is size_t.

The information was obtained from glibc source code:
http://bit.ly/21m1RMp

Signed-off-by: Nikola Forró <nforro@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 16:51:07 +01:00
Michael Kerrisk 1182ddb36a fmemopen.3: Update timestamp (page reviewed by Adhemerval Zanella)
Reviewed-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 15:38:57 +01:00
Michael Kerrisk 98faa645ea pipe.7: Clarify that I/O signalling requires use of both F_SETOWN and O_ASYNC
Reported-by: Jason Vas Dias <jason.vas.dias@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 07:58:17 +01:00
Michael Kerrisk 7255c7c0df fcntl.2: Rework description of F_SETOWN
As suggested by Jason, make it clearer that I/O signalling
requires the use of both F_SETOWN and O_ASYNC. While we're at,
make a few other cleanups to the text.

Reported-by: Jason Vas Dias <jason.vas.dias@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 07:49:11 +01:00
Michael Kerrisk 501934a934 timegm.3: Expand DESCRIPTION a little
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:43:05 +01:00
Michael Kerrisk 25a0440e45 timegm.3: Remove sample implementation of timegm()
Stephen and Mats both question the wisdom of showing a portable
*non-thread-safe* implementation of timegm(), and I find it
hard to disagree. So, remove this code.

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

Reported-by: Stephen Hurd <shurd@sasktel.net>
Reported-by: Mats Wichmann <mats@linuxfoundation.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:42:36 +01:00
Michael Kerrisk 813596e5f2 epoll_ctl.2: Document ELOOP error for circular monitoring loops
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:42:31 +01:00
Askar Safin cc7b36035b splice.2: Improve description of 0 return value.
See https://bugzilla.kernel.org/show_bug.cgi?id=90911

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:32:15 +01:00
Askar Safin 69fff55970 sendfile.2: Fix incorrect description in text referring to splice(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-11 00:32:15 +01:00
Michael Kerrisk ddef8b9573 fmemopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:05:11 +01:00
Michael Kerrisk 02959ce250 select.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:05:11 +01:00
Michael Kerrisk 4a866754d5 capabilities.7: wfix
Reported-by: Krzysztof Adamski <k@japko.eu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:05:11 +01:00
Michael Kerrisk 4efcd5dd6a sched_setaffinity.2: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:05:11 +01:00
Michael Kerrisk 310ac27840 sched_setaffinity.2: Warn that CPU_ALLOC() may allocate a slightly CPU set than requested
Reported-by: Florian Weimer <fweimer@redhat.com>
Reviewed-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 21:04:55 +01:00
Michael Kerrisk cf486e4aa9 CPU_SET.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 16:31:50 +01:00
Michael Kerrisk b796767217 sched_setaffinity.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 16:02:39 +01:00
Michael Kerrisk 7d02e97e66 pthread_setaffinity_np.3: SEE ALSO: add CPU_SET(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 15:56:14 +01:00
Michael Kerrisk 8a61b8f5db readdir.3: tfix
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 15:50:12 +01:00
Michael Kerrisk 77c73ca424 open_memstream.3: SEE ALSO: add setbuf(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 02:57:14 +01:00
Michael Kerrisk 207f4520b8 open_memstream.3: Minor reworking
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 02:57:14 +01:00
Michael Kerrisk 8cd11c4293 execve.2: Add EPERM error for capabilities check of capability-dumb binaries
Reported-by: Krzysztof Adamski <k@japko.eu>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 01:30:38 +01:00
Michael Kerrisk e0e5783736 capabilities.7: Explain safety check for capability-dumb binaries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 01:02:30 +01:00
Michael Kerrisk 556eafcad9 capabilities.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-10 00:22:33 +01:00
Michael Kerrisk 8a07a1c488 elf.5: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 19:42:59 +01:00
Michael Kerrisk b3b6aa6dd1 elf.5: Improve description of STV_DEFAULT
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 19:42:59 +01:00
Michael Kerrisk d24f72ec80 elf.5: Improve description of STV_HIDDEN
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 19:42:59 +01:00
Michael Kerrisk 2c8e09b4ff elf.5: Fix description of STV_PROTECTED
Quoting Mike:

gabi says:
https://refspecs.linuxbase.org/elf/gabi4+/ch4.symtab.html
A symbol defined in the current component is protected if it is
visible in other components but not preemptable, meaning that
any reference to such a symbol from within the defining component
must be resolved to the definition in that component, even if
there is a definition in another component that would preempt by
the default rules. A symbol with STB_LOCAL binding may not have
STV_PROTECTED visibility. If a symbol definition with
STV_PROTECTED visibility from a shared object is taken as
resolving a reference from an executable or another shared object,
the SHN_UNDEF symbol table entry created has STV_DEFAULT
visibility.

solaris/oracle says:
https://docs.oracle.com/cd/E26502_01/html/E26507/chapter6-79797.html
A symbol that is defined in the current component is protected
if the symbol is visible in other components, but cannot be
preempted. Any reference to such a symbol from within the defining
component must be resolved to the definition in that component.
This resolution must occur, even if a symbol definition exists in
another component that would interpose by the default rules.
A symbol with STB_LOCAL binding will not have STV_PROTECTED
visibility.

but i think this ibm article is probably the most understandable:
https://www.ibm.com/developerworks/aix/library/au-aix-symbol-visibility/
The symbol is visible outside the current executable or shared
object, but it may not be overridden. In other words, if a
protected symbol in a shared library is referenced by an other
code in the shared library, the other code will always reference
the symbol in the shared library, even if the executable defines
a symbol with the same name.

Reported-by: Gabriel Corona <gabriel.corona@enst-bretagne.fr>
Reported-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 19:42:54 +01:00
Michael Kerrisk db337e545c elf.5: srcfix: remove commented-out mandoc markuo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 19:17:49 +01:00
Michael Kerrisk 493e0eb3c2 fmemopen.3: srcfix: update copyright
Little or no text remains from Walters initial version
10 years ago.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 11:41:58 +01:00
Michael Kerrisk 8190a9eeac open_memstream.3: srcfix: Update copyright info
The open_memstream() text was jsut by me.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 11:41:24 +01:00
Michael Kerrisk b5a636d650 fmemopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:20:12 +01:00
Michael Kerrisk e3d1b1b740 open_memstream.3: Rework text describing dynamic allocation
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
Michael Kerrisk 31a3c48847 open_memstream.3: Add some details on current buffer position
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
Michael Kerrisk a6bd38c621 fopen.3: SEE ALSO: add open_memstream(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
Michael Kerrisk 8e23ae0316 open_wmemstream.3: Update link to point to new open_memstream(2) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 05:12:56 +01:00
Michael Kerrisk 09ffd9ca50 fmemopen.3, open_memstream.3: Split open_memstream() and open_wmemstream() out to separate page
The current fmemopen(3) page documents too many functions.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:55:07 +01:00
Michael Kerrisk 551c427e75 fmemopen.3: srcfix: copyright date
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:36:48 +01:00
Michael Kerrisk 36ad378145 fmemopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:34:31 +01:00
Michael Kerrisk d779692dc7 fmemopen.3: Small clarification to the discussion of write errors
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:31:40 +01:00
Michael Kerrisk 82aa5cf962 fmemopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:20:13 +01:00