Commit Graph

15678 Commits

Author SHA1 Message Date
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
Michael Kerrisk f29c8cd8e9 fmemopen.3: Minor fix: reorder a paragraph
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:19:52 +01:00
Michael Kerrisk f39842ae12 fmemopen.3: ffix: add a subheading
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:18:33 +01:00
Michael Kerrisk 0b54423fb5 fmemopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
Michael Kerrisk c7de29d451 fmemopen.3: Expand discussion of "current position" for fmemopen() stream
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
Michael Kerrisk 1e9eb6c1b6 fmemopen.3: Rework discussion of the (obsolete) binary mode
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
Michael Kerrisk 2841079cd0 fmemopen.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
Michael Kerrisk 9c8b5ebfc4 fmemopen.3: Rework description of 'buf' and 'len' arguments
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 04:15:13 +01:00
Michael Kerrisk 58c55bb87b fmemopen.3: Greatly expand description of 'mode' argument
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 03:42:26 +01:00
Michael Kerrisk 02989b144e fmemopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 03:09:36 +01:00
Michael Kerrisk 93bb19b18c fmemopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 03:09:36 +01:00
Michael Kerrisk 0edb356c58 fmemopen.3: Small improvements to the description of open_memstream()
Make it a little more evident that the caller should not
pass a previously allocated buffer to open_memstream().

Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:49:57 +01:00
Michael Kerrisk d9b4881f64 fmemopen.3: Fix "Usage" message
Reported-by: Rasmus Villemoes <Rasmus.Villemoes@decode.is>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:33:45 +01:00
Michael Kerrisk 852d92f7ae getnameinfo.3: Update FTM requirements
The FTM requirements changed in glibc 2.22

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:28:38 +01:00
Michael Kerrisk 5358a2546d getaddrinfo.3: Update FTM requirements for glibc 2.22
Since glibc 2.22 getaddrinfo() etc. are only declared for
POSIX.1-2001 or later.

Reported-by: Andreas Schwab <schwab@suse.de>
Reported-by: Orion Poplawski <orion@cora.nwra.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 02:19:11 +01:00
Michael Kerrisk 8295fc02a9 capabilities.7: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 01:25:11 +01:00
Michael Kerrisk c50730b607 gamma.3: gamma() was documented in SVID 2
Reported-by: Alan Cox <etchedpixels@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 01:05:16 +01:00
Michael Kerrisk f1e369b09f ntp_adjtime.3: New link to adjtimex(2)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 00:36:16 +01:00
Jérémie Galarneau 4d70ca99ed posix_fallocate.3: ERRORS: add EINTR
The glibc implementation of posix_fallocate(), which calls
fallocate(), may be interrupted. The fallocate() emulation
also makes use of pread()/pwrite(), which may also be
interrupted.

Signed-off-by: Jérémie Galarneau <jeremie.galarneau@efficios.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 00:34:48 +01:00
Michael Kerrisk bf9c09382b sched_setaffinity.2: Add reference to CPU_ALLOC(3)
Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-09 00:34:41 +01:00
Michael Kerrisk d7e537ce94 proc.5: /proc/PID/fdinfo displays the setting of the close-on-exec flag
Note also the pre-3.1 bug in the display of this info.

Reported-by: Patrick Donnelly <batrick@batbytes.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 20:31:56 +01:00
Michael Kerrisk 9599cbb35c proc.5: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 20:28:38 +01:00
Michael Kerrisk d742465f2c inotify.7: Refer reader to proc(5) for info on /proc/PID/fdinfo inotify entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 20:11:12 +01:00
Michael Kerrisk 75f8598a1f fanotify.7: Refer reader to proc(5) for info on /proc/PID/fdinfo fanotify entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 20:08:46 +01:00
Michael Kerrisk e2444bcbe7 proc.5: Document fanotify /proc/PID/fdinfo entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 20:07:32 +01:00
Michael Kerrisk 4e77145cca proc.5: Document inotify /proc/PID/fdinfo entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 20:07:32 +01:00
Michael Kerrisk 58a80cd4f0 epoll.7: Mention that epoll info is available via /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 19:24:48 +01:00
Michael Kerrisk 9764a9ff2a eventfd.2: Note that eventfd info is available in /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 19:24:48 +01:00
Michael Kerrisk 13dd2598aa signalfd.2: Note that signalfd info is available in /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 19:24:47 +01:00
Michael Kerrisk aaf7a57425 open.2: NOTES: mention existence of proc/PID/fd and /proc/PID/fdinfo
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 18:58:34 +01:00
Michael Kerrisk b6a7fd5032 proc.5: Add some kernel version numbers for /proc/PID/fdinfo entries
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 18:50:06 +01:00
Marko Myllynen e27900b2e8 locale.5: tel + fax are deprecated
Reviewed-by: Mike Frysinger <vapier@gentoo.org>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-08 18:16:28 +01:00
Michael Kerrisk 8bbae7d03c adjtimex.2: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 19:30:53 +01:00
Michael Kerrisk ebfc893ec7 adjtimex.2: Add ATTRIBUTES section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00
Michael Kerrisk 85c30f7eab ntp_gettime.3: Add ATTRIBUTES section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00
Michael Kerrisk 39ad98a088 sysconf.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00
Michael Kerrisk b5133e9ad9 ntp_gettime.3: Note that these APIs always succeed
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2016-03-07 11:15:18 +01:00