Commit Graph

5289 Commits

Author SHA1 Message Date
Jakub Wilk a423ef7cd1 cbrt.3: tfix
Signed-off-by: Jakub Wilk <jwilk@jwilk.net>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-07 08:09:33 +01:00
Michael Kerrisk 6f3c74a8b9 mremap.2, open.2, perf_event_open.2, prctl.2, ptrace.2, reboot.2, seccomp.2, signalfd.2, syscalls.2, __ppc_set_ppr_med.3, daemon.3, dirfd.3, fgetgrent.3, fgetpwent.3, getauxval.3, getspnam.3, mallinfo.3, mallopt.3, posix_fallocate.3, termios.3, tty_ioctl.4, core.5, nsswitch.conf.5, proc.5, aio.7, capabilities.7, path_resolution.7, pipe.7, rtld-audit.7, signal.7, tcp.7: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:46:28 +01:00
Michael Kerrisk 2e056718fc dlopen.3: Include a shell session showing build/run in EXAMPLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:46:28 +01:00
Michael Kerrisk 4373ccc072 dlopen.3: Change arguments to main() to "void" in EXAMPLE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:46:22 +01:00
Michael Kerrisk b44cf4bcd4 dlopen.3: Correct the pathname used in EXAMPLE
Quoting Florian:

    This does not work because libm.so can be a linker script:

           handle = dlopen("libm.so", RTLD_LAZY);

    The proper way to do this is to include <gnu/lib-names.h>
    and use LIBM_SO.

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

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:40:31 +01:00
Michael Kerrisk 614e5d137a daemon.3: Minor wording fix
As noted by Florian Weimer:

    The manual daemon(3) manual page talks about the "calling
    process's current working directory".  I think this is
    misleading because the function exits the calling process
    before changing the current directory.

Reported-by: Florian Weimer <fweimer@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:40:31 +01:00
Michael Kerrisk dd1d112d2f scanf.3: Minor wording fix in %s description
Reported-by: Stefan Tauner <tauner@technikum-wien.at>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-05 10:40:31 +01:00
Michael Kerrisk 6e8ccc0d6c termios.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-02 20:21:09 +01:00
Michael Kerrisk a0262e270d termios.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-02 20:17:30 +01:00
Olivier TARTROU 2d7c8f1f78 termios.3: Add missing details on behaviour of PARMRK
For a serial terminal, with a specific configuration, input bytes
with value 0377 are passed to the program as two bytes, 0377 0377.

This (correct) behaviour is described in the documentation of the
GNU C Library
(https://www.gnu.org/software/libc/manual/html_node/Input-Modes.html#Input-Modes)
but not in the termios.3 man page.

Problematic configuration: INPCK set, IGNPAR not set, PARMRK set,
ISTRIP not set.

This man page problem affects several users. Examples:
* http://sourceforge.net/p/ftdi-usb-sio/mailman/message/4079724/
* http://mailman.uclinux.org/pipermail/uclinux-dev/2006-November/040984.html
* ...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-02 20:09:25 +01:00
Michael Kerrisk 1a08b97b56 dlopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-12-02 14:03:49 +01:00
Michael Kerrisk 8dbd75b8ba dlopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-11-17 10:36:03 +01:00
Michael Kerrisk 50008330de dlopen.3: Make it more explicit that LD_BIND_NOW overrides RTLD_LAZY
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-11-17 10:31:56 +01:00
Michael Kerrisk 630551b9f9 daemon.3: Note that damon is buggy with respect to controlling tty acquisition
Reported-by: Johannes Stüttgen <Johannes.Stuettgen@gmail.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-16 21:24:55 +02:00
Gabriel F. T. Gomes a9a3390a4e __ppc_set_ppr_very_low.3: New link to __ppc_set_ppr_med.3
Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-08 22:07:29 +01:00
Gabriel F. T. Gomes 97ad561735 __ppc_set_ppr_med_high.3: New link to __ppc_set_ppr_med.3
Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-08 21:22:11 +01:00
Michael Kerrisk 42f014d3f7 __ppc_set_ppr_med.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-08 21:21:26 +01:00
Michael Kerrisk e65b3f0d2d __ppc_set_ppr_med.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-08 21:19:47 +01:00
Gabriel F. T. Gomes eb6b6909a7 __ppc_set_ppr_med.3: Document PPC functions providing access to PPR
GNU C Library commit 1747fcda4902a3b46183d93fb16ed9b436b2608b
extends the priorities that can be set to the Program Priority
Register (PPR), with the functions: __ppc_set_ppr_very_low(3)
and __ppc_set_ppr_med_high(3).

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-08 21:16:38 +01:00
Jonathan Wakely 03ffcdae22 dirfd.3: Remove outdated NOTES
As stated in the SYNOPSIS, since glibc 2.10 this function is also
declared by the relevant X/Open and POSIX macros.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-05 10:09:57 +01:00
Michael Kerrisk 624fbe44d9 posix_fallocate.3: Clarify text relating to MT-safety
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-05 10:00:29 +01:00
Michael Kerrisk 141c1d0547 posix_fallocate.3: ffix + wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-05 10:00:29 +01:00
Carlos O'Donell a74bc4c9e4 posix_fallocate.3: Mention glibc emulation caveats
When the glibc implementation of posix_fallocate detects
that the underlying filesystem does not support fallocate()
it uses an emulation function to attempt to allocate the
space requested. The most common case is calling
posix_fallocatei() for a file that is on NFS where the
NFS server is not new enough to support the recent fallocate
extensions. This emulation has various serious caveats that
must be understood in order to use posix_fallocate robustly
on all filesystems. The change documents the caveats in the
glibc implementation.

Lastly, we expand the meaning of EINVAL to match POSIX
2013 (Issue 7). If the underlying filesystem doesn't support
posix_fallocate()i, the implementation can return EINVAL, but
glibc does not do this, it emulates the operation instead.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-10-05 09:47:47 +01:00
Michael Kerrisk 422dd47fd8 getauxval.3: Add some details for AT_SECURE
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-13 11:59:48 +02:00
Michael Kerrisk 6912d54fe2 getauxval.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-13 11:58:25 +02:00
Michael Kerrisk 3a09fae856 getspnam.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:09:57 +02:00
Zeng Linggang b6c73e0bdf termios.3: srcfix: add FIXME
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:07:24 +02:00
Zeng Linggang eabb7166a9 sigpause.3: srcfix: add FIXME
Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:07:02 +02:00
Zeng Linggang c32cf2684a mallinfo.3: ATTRIBUTES: Note function that is not thread-safe
The marking matches glibc marking.
The marking of functions in glibc is:
- mallinfo: MT-Unsafe init const:mallopt

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:06:44 +02:00
Zeng Linggang 557d7d9682 getspnam.3: ATTRIBUTES: Note functions that are/aren't thread-safe
After research, We think
* getspnam(),
* getspent(),
* setspent(),
* endspent(),
* getspent_r(),
* fgetspent(),
* sgetspent(),
are not thread-safe. And
* putspent(),
* getspnam_r(),
* sgetspent_r(),
* lckpwdf(),
* ulckpwdf(),
* fgetspent_r(),
are thread-safe. But, there are not
markings of them in glibc document.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:06:23 +02:00
Zeng Linggang 1ec27c36ff fgetpwent.3: ATTRIBUTES: Note function that is not thread-safe
The marking matches glibc marking.
marking of function in glibc is:
- fgetgrent: MT-Unsafe race:fpwent

ps: We think race:fpwent in glibc maybe hard for users to understand,
and have sent a patch to the GNU libc community for changing it to
race:fgetpwent, however, something about the copyright impeded the progress.
Here we mark it "race:fgetpwent", so there is a little different.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:06:08 +02:00
Zeng Linggang 098cd28bbf fgetgrent.3: ATTRIBUTES: Note function that is not thread-safe
The marking matches glibc marking.
marking of function in glibc is:
- fgetgrent: MT-Unsafe race:fgrent

ps: We think race:fgrent in glibc maybe hard for users to understand,
and have sent a patch to the GNU libc community for changing it to
race:fgetgrent, however, something about the copyright impeded the progress.
Here we mark it "race:fgetgrent", so there is a little different.

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-09-11 12:05:11 +02:00
Michael Kerrisk b72bd8d1c0 mallopt.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-30 05:02:25 -07:00
Michael Kerrisk bb1ee72e6f mallopt.3: Minor tweaks to Carlos's patch
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-30 05:02:25 -07:00
Carlos O'Donell 9d116bd272 mallopt.3: Document M_ARENA_TEST and M_ARENA_MAX
In 2013 I brought up the discussion if M_ARENA_MAX and M_ARENA_TEST
were public parameters:
https://sourceware.org/ml/libc-alpha/2013-03/msg00376.html
Consensus among Siddhesh and myself was that they should be
public, and in fact they were already in the public header.
Therefore there may already be applications uses these constants
and expecting them to work. At best we could limit mallopt()'s
acceptance of the options, but that seems like a bad solution
that could lead to unexpected behavior for user applications.
A quick google search shows that there are packages relying on
these constants to tune the glibc malloc implementation.

Since glibc 2.10 the M_ARENA_TEST and M_ARENA_MAX features
have been part of the public interface with
--enable-experimental-malloc.

Since glibc 2.15 the experimental allocator has been on by default
and M_ARENA_TEST and M_ARENA_MAX have been more broadly used.

There are environment variables, without trailing underscore, that
can also be used to adjust these values at runtime i.e.
MALLOC_ARENA_MAX, and MALLOC_ARENA_TEST.

This change describes these two options in the mallopt(3) man page
along with their environment variables.

Tested with glibc master on x86_64 to verify it works as expected.

Signed-off-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-30 03:09:38 -07:00
Michael Kerrisk 30ea59e720 Removed trailing white space at end of lines 2015-08-08 18:23:54 +02:00
Michael Kerrisk d6dcb338fc mktemp.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 18:22:46 +02:00
Michael Kerrisk 460495ca58 ldd.1, sprof.1, accept.2, alarm.2, bind.2, chdir.2, clock_nanosleep.2, close.2, connect.2, dup.2, execve.2, fsync.2, getgid.2, getpeername.2, getsid.2, getsockname.2, getsockopt.2, getuid.2, io_getevents.2, kill.2, listen.2, lseek.2, mmap.2, msgctl.2, msgget.2, msgop.2, msync.2, nanosleep.2, nice.2, pause.2, pipe.2, rmdir.2, sched_get_priority_max.2, sched_rr_get_interval.2, sched_setparam.2, sched_setscheduler.2, sched_yield.2, select_tut.2, semctl.2, semop.2, setsid.2, shmctl.2, shmget.2, shmop.2, shutdown.2, sigaction.2, signal.2, socketpair.2, sync.2, timer_delete.2, timer_getoverrun.2, timer_settime.2, times.2, truncate.2, umask.2, MB_CUR_MAX.3, a64l.3, abs.3, assert.3, atexit.3, atof.3, atoi.3, basename.3, bsearch.3, btowc.3, byteorder.3, catgets.3, catopen.3, clock.3, clock_getcpuclockid.3, closedir.3, confstr.3, crypt.3, ctermid.3, difftime.3, div.3, dladdr.3, dlerror.3, dlinfo.3, dlopen.3, dlsym.3, drand48.3, encrypt.3, exit.3, fclose.3, ffs.3, fgetc.3, fgetwc.3, fgetws.3, flockfile.3, fmtmsg.3, fnmatch.3, fopen.3, fpathconf.3, fpclassify.3, fputwc.3, fputws.3, fseek.3, fseeko.3, ftok.3, fwide.3, getdate.3, getenv.3, getgrent.3, getgrnam.3, gethostid.3, getlogin.3, getnetent.3, getopt.3, getpwent.3, getpwnam.3, getsubopt.3, getutent.3, getwchar.3, grantpt.3, hsearch.3, iconv.3, iconv_close.3, iconv_open.3, if_nameindex.3, inet.3, inet_ntop.3, inet_pton.3, insque.3, isatty.3, isgreater.3, iswalnum.3, iswalpha.3, iswblank.3, iswcntrl.3, iswctype.3, iswdigit.3, iswgraph.3, iswlower.3, iswprint.3, iswpunct.3, iswspace.3, iswupper.3, iswxdigit.3, lockf.3, longjmp.3, lsearch.3, malloc.3, mblen.3, mbrlen.3, mbrtowc.3, mbsinit.3, mbsrtowcs.3, mbstowcs.3, mbtowc.3, memccpy.3, memchr.3, memcmp.3, memmove.3, memset.3, mktemp.3, mq_close.3, mq_getattr.3, mq_receive.3, mq_send.3, mq_unlink.3, offsetof.3, popen.3, posix_memalign.3, posix_openpt.3, printf.3, pthread_attr_setdetachstate.3, pthread_attr_setguardsize.3, pthread_attr_setinheritsched.3, pthread_attr_setschedparam.3, pthread_attr_setschedpolicy.3, pthread_attr_setscope.3, pthread_attr_setstack.3, pthread_attr_setstacksize.3, pthread_equal.3, pthread_exit.3, pthread_getcpuclockid.3, pthread_kill.3, pthread_self.3, pthread_setcancelstate.3, pthread_setconcurrency.3, pthread_setschedparam.3, pthread_setschedprio.3, pthread_sigmask.3, pthread_testcancel.3, ptsname.3, putenv.3, puts.3, putwchar.3, qsort.3, raise.3, random.3, readdir.3, regex.3, remove.3, rewinddir.3, seekdir.3, sem_destroy.3, sem_getvalue.3, sem_unlink.3, sem_wait.3, setenv.3, setjmp.3, setlocale.3, setlogmask.3, signbit.3, sigpause.3, sigset.3, sigsetops.3, sigwait.3, sleep.3, sockatmark.3, statvfs.3, strcat.3, strchr.3, strcmp.3, strcoll.3, strcpy.3, strlen.3, strpbrk.3, strptime.3, strspn.3, strstr.3, strtod.3, strtoimax.3, strtok.3, strtol.3, strtoul.3, strxfrm.3, swab.3, sysconf.3, system.3, tcgetpgrp.3, tcgetsid.3, telldir.3, tmpfile.3, towctrans.3, tsearch.3, ttyname.3, tzset.3, ungetwc.3, unlocked_stdio.3, unlockpt.3, wcrtomb.3, wcscat.3, wcschr.3, wcscmp.3, wcscpy.3, wcscspn.3, wcslen.3, wcsncat.3, wcsncmp.3, wcsncpy.3, wcspbrk.3, wcsrchr.3, wcsrtombs.3, wcsspn.3, wcsstr.3, wcstoimax.3, wcstok.3, wcstombs.3, wcswidth.3, wctob.3, wctomb.3, wctrans.3, wctype.3, wcwidth.3, wmemchr.3, wmemcmp.3, wmemcpy.3, wmemmove.3, wmemset.3, wordexp.3, wprintf.3, fanotify.7, mq_overview.7, nptl.7, sem_overview.7, shm_overview.7, sigevent.7, symlink.7, ld.so.8: tstamp
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 18:21:22 +02:00
Michael Kerrisk 80bf84f684 nl_langinfo.3: srcfix (copyright)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:59:17 +02:00
Michael Kerrisk 3fc0259556 dlinfo.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:38:51 +02:00
Michael Kerrisk 78f2bf20fb dlinfo.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:38:37 +02:00
Michael Kerrisk 0fdbc11423 dlopen.3: Note a case where dlmopen() provides better isolation than RTLD_LOCAL
Cowritten-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 6fd1b6ebb7 dlopen.3: srcfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 438168a249 dlopen.3: wfix
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk ce65f81e7a dladdr.3: Minor wording fixes
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 51f796a450 dlinfo.3: ATTRIBUTES: Note function that is thread-safe
After research, we think
* dlinfo()
is thread-safe. But, there are not markings of it in
glibc document.

[mtk: split out of a larger dlopen() patch]

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk e8a1758ca3 dlopen.3: Reorganize conformance information for 'flags'
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 6962fdf954 dlopen.3: srcfix: FIXME
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk 39720f03eb dlsym.3: ATTRIBUTES: Note functions that are thread-safe
After research, We think
* dlsym(),
* dlvsym()
are thread-safe. But, there are not markings of them in
glibc document.

[mtk: Split out patch for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk b23510e5db dlopen.3: ATTRIBUTES: Note functions that are thread-safe
After research, we think
* dlopen(),
* dlmopen(),
* dlclose()
are thread-safe. But, there are not markings of them in
glibc document.

[mtk: Split out patch for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:45 +02:00
Michael Kerrisk eab0df1736 dlerror.3: ATTRIBUTES: Note function that is thread-safe
After research, we think
* dlerror()
is thread-safe. But, there are not markings of it in
glibc document.

[mtk: Split out patch for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Zeng Linggang 06c0008da9 dladdr.3: ATTRIBUTES: Note functions that are thread-safe
After research, we think
* dladdr(),
* dladdr1()
are thread-safe. But, there are not markings of them in
glibc document.

[mtk: Split out patches for formerly single dlopen.3 page]

Signed-off-by: Zeng Linggang <zenglg.jy@cn.fujitsu.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 92bade29b9 atexit.3: SEE ALSO: add dlopen(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk b198e0ae76 dlopen.3: Move atexit() discussion under "Initialization and Finalization"
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 6ceba646b4 dlopen.3: Mention other functions in the dlopen API in the initial paragraph
Doing so helps orient the reader.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 747b2b0a98 dlopen.3: dlclose() will unload the object when all references have been released
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 9ebcbe1377 dlopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk c72bea436f dlerror.3: Note that the returned string does not include a trailing newline
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk c85226feb3 dlerror.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 78978ec9a7 dlerror.3: Note that the returned message may be in a statically allocated buffer
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 982eac0dba dlopen.3: Corrections and improvements after comments from Carlos O'Donell
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 374b34d32e dlopen.3: Remove dlerror() content that was migrated to dlerror(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 936b64f661 dlsym.3: SEE ALSO: add dlerror(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk da9356be20 dlinfo.3: SEE ALSO: add dlerror(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 75b7da85c3 dlerror.3: Migrate dlerror(3) to a separate man page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk b6779d1d8f dlopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk e83ed17d21 dlopen.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 7766185cf8 dlopen.3: EXAMPLE: Remove mention of "-rdynamic"
That option isn't needed for compiling and running this program.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 896c71d0bd dlopen.3: Remove content migrated to new dlsym() page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 273b4e247c dlinfo.3: SEE ALSO: add dlysm(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk de7d051d35 dladdr.3: SEE ALSO: add dlysm(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk efe8c6fd04 dlvsym.3: Adjust link to point to new self-contained dlsym(3) page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 15e1b31b8e dlsym.3: Move dlsym() and dlvsym3() content to their own page
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk c7c01315dc dlopen.3: Rework the discussion of initialization and finalization functions
Deemphasize the obsolete _init/_fini and give more prominence
to gcc constructors/destructors.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk e8290357ce dlopen.3: Move discussion of _init() and _fini() to NOTES
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 7e936c2917 dlopen.3: Remove reference to ld.so info page
The command "info ld.so" simply shows the man page...

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 65175b1d2a dlopen.3: Note some dlmopen() restrictions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk fe854f153e dlopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 43151de329 ldd.1, sprof.1, execve.2, dlopen.3, ld.so.8: Prefer "shared object" over "shared library"
The man pages variously use "shared library" or "shared object".
Try to more consistently use one term ("shared object"), while
also pointing out on a few pages that the terms are synonymous.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:44 +02:00
Michael Kerrisk 9c1697549f dlopen.3: Improvements after input from Carlos O'Donell
Reported-by: Carlos O'Donell <carlos@redhat.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 020fed6aba dlmopen.3: New link to dlopen.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk efdd68a5b2 dlopen.3: Document dlmopen(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 9987012c0c dladdr.3: SEE ALSO: add dlinfo(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 46db2df163 dlopen.3: SEE ALSO: add dlinfo(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 2b8adcef3d dlinfo.3: New page describing dlinfo(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk a7634f0141 dl_iterate_phdr.3: SEE ALSO: add dladdr(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 6c46d3bc43 dlopen.3: SEE ALSO: add dladdr(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 10b22cd92b dladdr1.3: New link to (new) dladdr(3) page 2015-08-08 17:35:43 +02:00
Michael Kerrisk affaa041c3 dladdr.3: New page documenting dladdr() and dladdr1()
Relocate/rewrite dladdr() text formerly contained in dlopen(3).

Add documentation of dladdr1().

Peter Baudis's "caveat text" was moved from dlopen() into
this page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 3f4c09d0d3 dlopen.3: Integrate dlvsym() discussion into main page text
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 705e06be7f dlopen.3: Minor fix: remind reader that _init() and _fini() are obsolete
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 6445992d72 dlopen.3: Remove dladdr() content
This content will be migrated to a new page.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 8ac45f42e7 dlopen.3: tfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 0a78ab7b0a dlopen.3: Minor wording fix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk adb1cfab52 dlopen.3: Add VERSIONS section
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 48a11e1d6e dl_iterate_phdr.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk c9629ff8c0 dl_iterate_phdr.3: CONFORMING TO: note that this function appears on some other systems
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Michael Kerrisk 70476aa4c8 dl_iterate_phdr.3: Note that 'size' allows callback() to discover structure extensions
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 17:35:43 +02:00
Gleb Fotengauer-Malinovskiy 9b44ad2028 mktemp.3: Reference mkdtemp(3) in addition to mkstemp(3)
Mention mkdtemp(3) as another secure alternative to mktemp(3).

See also https://sourceware.org/bugzilla/show_bug.cgi?id=2898.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-08 10:08:09 +02:00
Michael Kerrisk 872e754b01 nl_langinfo.3: NOTES: note undefined behavior for nl_langinfo_l()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:46:34 +02:00
Michael Kerrisk 75b3623dc4 nl_langinfo.3: POSIX specifies that the caller may not modify the returned string
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:43:40 +02:00
Michael Kerrisk cc331dfc6c nl_langinfo.3: Enhance RETURN VALUE description
Note some further cases where returned string may be
invalidated or overwritten.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:39:30 +02:00
Michael Kerrisk 7003ff6ad0 nl_langinfo.3: Explicitly describe the return value on success
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:30:45 +02:00
Michael Kerrisk c607c3a695 nl_langinfo.3: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:24:03 +02:00
Michael Kerrisk 29f6f82cb3 nl_langinfo.3: Clarify details of nl_langinfo_l() return value
setlocale() does not come into play for nl_langinfo_l(),
as far as I can tell.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:22:17 +02:00
Michael Kerrisk 1f741719e4 nl_langinfo.3: Minor wording improvements
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:15:53 +02:00
Michael Kerrisk 83a366e0ec nl_langinfo.3: wfix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:04:24 +02:00
Michael Kerrisk 244802a58c nl_langinfo_l.3: New link to nl_langinfo.3
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 13:00:00 +02:00
Sam Varshavchik 665d98c5fe nl_langinfo.3: Add documentation for nl_langinfo_l(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-07 12:59:25 +02:00
Michael Kerrisk d83d1e1cf9 __ppc_set_ppr_med.3: Various minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 14:34:56 +02:00
Gabriel F. T. Gomes 457c4b3476 __ppc_set_ppr_med_low.3: New link to __ppc_set_ppr_med.3
Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 14:34:56 +02:00
Gabriel F. T. Gomes 430f054d9b __ppc_set_ppr_low.3: New link to __ppc_set_ppr_med.3
Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 14:34:56 +02:00
Gabriel F. T. Gomes fff0e08c75 __ppc_set_ppr_med.3: Document PPC functions providing access to PPR
GNU C Library 2.18 adds functions (__ppc_set_ppr_low(3),
__ppc_set_ppr_med(3), __ppc_set_ppr_med_low(3)) that provide
access to the Program Priority Register (PPR).

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 14:34:56 +02:00
Michael Kerrisk 2cd276f398 __ppc_yield.3: Minor tweaks
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 14:34:56 +02:00
Gabriel F. T. Gomes c79eb77b7a __ppc_mdoio.3: New link to __ppc_yield.3
Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 14:15:53 +02:00
Gabriel F. T. Gomes 559088931c __ppc_mdoom.3: New link to __ppc_yield.3
Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 14:15:53 +02:00
Gabriel F. T. Gomes 36b531052b __ppc_yield.3: Document PPC performance-hint functions
GNU C Library 2.18 adds functions __ppc_yield(3), __ppc_mdoio(3),
and __ppc_mdoom(3) that can be used provide a hint that
performance could be improved if shared resources are released
for use by other processors.

Signed-off-by: Gabriel F. T. Gomes <gftg@linux.vnet.ibm.com>
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-08-06 13:43:59 +02:00
Michael Kerrisk 3824cf5bc1 mq_receive.3, mq_send.3: Clarify discussion of 'timeout'
In particular, remove the word 'ceiling', which falsely
suggests that the call might return prematurely.

Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-30 13:37:01 +02:00
Michael Kerrisk db39a67945 printf.3: Describe dprintf() and vdprintf()
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 72836d5146 wprintf.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk d5b31ab411 wmemset.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 4604841c06 wmemmove.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 9c0de892c8 wmemcpy.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk b84a22324c wmemcmp.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk d8b29663bc wmemchr.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk f01583a180 wctype.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 432ef7b205 wctrans.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk f6221652b6 wctomb.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 563a5c3f79 wctob.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 6d2e3caf7c wcstombs.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 789a49facc wcstok.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk bc9959895c wcstoimax.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk d2fc216e58 wcsstr.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 7706c03f6e wcsspn.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk 8e08c66a72 wcsrtombs.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk a2efcfde7e wcsrchr.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:15 +02:00
Michael Kerrisk abcb5d325a wcspbrk.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk 69b4132c4f wcsncpy.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk d6597cb0f7 wcsncmp.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk ea98095cc6 wcsncat.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk 02a0486fc3 wcslen.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk e4c0766a62 wcscspn.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk 7e30d30db2 wcscpy.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk eea7ea7a19 wcscmp.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk d8e94e530f wcschr.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk c31eef93ce wcscat.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk f639deaff9 wcrtomb.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk 088942c98a ungetwc.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk 7aaf19e710 towctrans.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00
Michael Kerrisk 91d3cef71f strxfrm.3: CONFORMING TO: add POSIX.1-2001 and POSIX.1-2008
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
2015-07-24 09:32:14 +02:00