diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2017-08-19 12:56:40 +0200 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2017-08-19 13:47:27 +0200 |
| commit | 408731d4351ed9f72a30f763e75cb801cca1c0d1 (patch) | |
| tree | e8e181d94bec4e034fcfd4e48e28a2b52171abf9 /man7 | |
| parent | 9c40f2b9ba935b423a6c31ec4c252c3afdee696c (diff) | |
| download | man-pages-408731d4351ed9f72a30f763e75cb801cca1c0d1.tar.gz | |
intro.1, locale.1, ioctl_list.2, listxattr.2, memfd_create.2, nfsservctl.2, open_by_handle_at.2, perf_event_open.2, poll.2, process_vm_readv.2, ptrace.2, select.2, select_tut.2, semop.2, sendmmsg.2, shmget.2, sigaction.2, spu_run.2, umask.2, wait4.2, nan.3, setlocale.3, feature_test_macros.7, glob.7, posixoptions.7, rtld-audit.7: ffix
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man7')
| -rw-r--r-- | man7/feature_test_macros.7 | 70 | ||||
| -rw-r--r-- | man7/glob.7 | 4 | ||||
| -rw-r--r-- | man7/posixoptions.7 | 291 | ||||
| -rw-r--r-- | man7/rtld-audit.7 | 6 |
4 files changed, 151 insertions, 220 deletions
diff --git a/man7/feature_test_macros.7 b/man7/feature_test_macros.7 index 3a26397986..d4f4e4c209 100644 --- a/man7/feature_test_macros.7 +++ b/man7/feature_test_macros.7 @@ -95,13 +95,13 @@ definitions must be made before including any header files: .PP Alternatively, equivalent definitions can be included in the compilation command: -.RS -.nf - +.PP +.in +4n +.EX cc \-D_BSD_SOURCE cc \-D_XOPEN_SOURCE # Or any value < 500 -.fi -.RE +.EE +.in .PP Note that, as described below, .BR "some feature test macros are defined by default" , @@ -113,14 +113,14 @@ In a few cases, manual pages use a shorthand for expressing the feature test macro requirements (this example from .BR readahead (2)): .PP -.RS -.nf +.in +4n +.EX .B #define _GNU_SOURCE .B #include <fcntl.h> .PP .BI "ssize_t readahead(int " fd ", off64_t *" offset ", size_t " count ); -.fi -.RE +.EE +.in .PP This format is employed in cases where only a single feature test macro can be used to expose the function @@ -155,23 +155,21 @@ with a value of 600 or greater produces the same effects as defining .BR _POSIX_C_SOURCE with a value of 200112L or greater. Where one sees -.RS -.nf - - _POSIX_C_SOURCE >= 200112L - -.fi -.RE +.IP +.in +4n +.EX +_POSIX_C_SOURCE >= 200112L +.EE +.in .IP in the feature test macro requirements in the SYNOPSIS of a man page, it is implicit that the following has the same effect: -.RS -.nf - - _XOPEN_SOURCE >= 600 - -.fi -.RE +.IP +.in +4n +.EX +_XOPEN_SOURCE >= 600 +.EE +.in .IP * Defining .BR _XOPEN_SOURCE @@ -179,23 +177,21 @@ with a value of 700 or greater produces the same effects as defining .BR _POSIX_C_SOURCE with a value of 200809L or greater. Where one sees -.RS -.nf - - _POSIX_C_SOURCE >= 200809L - -.fi -.RE +.IP +.in +4n +.EX +_POSIX_C_SOURCE >= 200809L +.EE +.in .IP in the feature test macro requirements in the SYNOPSIS of a man page, it is implicit that the following has the same effect: -.RS -.nf - - _XOPEN_SOURCE >= 700 - -.fi -.RE +.IP +.in +4n +.EX +_XOPEN_SOURCE >= 700 +.EE +.in .\" The details in glibc 2.0 are simpler, but combining a .\" a description of them with the details in later glibc versions .\" would make for a complicated description. diff --git a/man7/glob.7 b/man7/glob.7 index 706325bb2f..7d52c2bd6c 100644 --- a/man7/glob.7 +++ b/man7/glob.7 @@ -177,13 +177,13 @@ by the category in the current locale. .PP (iv) Named character classes, like +.PP .nf - [:alnum:] [:alpha:] [:blank:] [:cntrl:] [:digit:] [:graph:] [:lower:] [:print:] [:punct:] [:space:] [:upper:] [:xdigit:] - .fi +.PP so that one can say "\fI[[:lower:]]\fP" instead of "\fI[a\-z]\fP", and have things work in Denmark, too, where there are three letters past \(aqz\(aq in the alphabet. diff --git a/man7/posixoptions.7 b/man7/posixoptions.7 index 74bc55c47d..1c97c59296 100644 --- a/man7/posixoptions.7 +++ b/man7/posixoptions.7 @@ -47,26 +47,23 @@ Much more precise detail can be found in the POSIX standard itself, versions of which can nowadays be accessed freely on the web. .SS ADV - _POSIX_ADVISORY_INFO - _SC_ADVISORY_INFO The following advisory functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_fadvise (), .IR posix_fallocate (), .IR posix_memalign (), .IR posix_madvise (). -.br -.in -4 +.in .fi .SS AIO - _POSIX_ASYNCHRONOUS_IO - _SC_ASYNCHRONOUS_IO The header .I <aio.h> is present. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR aio_cancel (), .IR aio_error (), .IR aio_fsync (), @@ -75,8 +72,7 @@ The following functions are present: .IR aio_suspend (), .IR aio_write (), .IR lio_listio (). -.br -.in -4 +.in .fi .SS BAR - _POSIX_BARRIERS - _SC_BARRIERS This option implies the @@ -85,17 +81,15 @@ and .B _POSIX_THREAD_SAFE_FUNCTIONS options. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_barrier_destroy (), .IR pthread_barrier_init (), .IR pthread_barrier_wait (), .IR pthread_barrierattr_destroy (), .IR pthread_barrierattr_init (). -.in -4 -.br +.in .fi .\" .SS BE .\" Batch environment. @@ -114,16 +108,15 @@ This option implies the .B _POSIX_TIMERS option. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_condattr_getclock (), .IR pthread_condattr_setclock (), .IR clock_nanosleep (). -.in -4 - +.in .fi +.PP If .B CLOCK_REALTIME is changed by the function @@ -155,10 +148,9 @@ Internet Protocol Version 6 is supported. If this option is in effect (as it always is under POSIX.1-2001), then the system implements POSIX-style job control, and the following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR setpgid (), .IR tcdrain (), .IR tcflush (), @@ -166,7 +158,7 @@ and the following functions are present: .IR tcsendbreak (), .IR tcsetattr (), .IR tcsetpgrp (). -.in -4 +.in .fi .SS MF - _POSIX_MAPPED_FILES - _SC_MAPPED_FILES Shared memory is supported. @@ -198,10 +190,9 @@ The include file .I <mqueue.h> is present. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR mq_close (), .IR mq_getattr (), .IR mq_notify (), @@ -210,8 +201,7 @@ The following functions are present: .IR mq_send (), .IR mq_setattr (), .IR mq_unlink (). -.br -.in -4 +.in .fi .SS MON - _POSIX_MONOTONIC_CLOCK - _SC_MONOTONIC_CLOCK .B CLOCK_MONOTONIC @@ -220,15 +210,15 @@ This option implies the .B _POSIX_TIMERS option. Affected functions are +.PP .nf -.in +4 - +.in +4n .IR aio_suspend (), .IR clock_getres (), .IR clock_gettime (), .IR clock_settime (), .IR timer_create (). -.in -4 +.in .fi .SS --- - _POSIX_MULTI_PROCESS - _SC_MULTI_PROCESS This option has been deleted. @@ -245,23 +235,21 @@ This property may be dependent on the path prefix of the component. .SS PIO - _POSIX_PRIORITIZED_IO - _SC_PRIORITIZED_IO This option says that one can specify priorities for asynchronous I/O. This affects the functions -.br +.PP .nf -.in +4 - +.in +4n .IR aio_read (), .IR aio_write (). -.in -4 +.in .fi .SS PS - _POSIX_PRIORITY_SCHEDULING - _SC_PRIORITY_SCHEDULING The include file .I <sched.h> is present. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR sched_get_priority_max (), .IR sched_get_priority_min (), .IR sched_getparam (), @@ -270,21 +258,19 @@ The following functions are present: .IR sched_setparam (), .IR sched_setscheduler (), .IR sched_yield (). -.in -4 - +.in .fi If also .B _POSIX_SPAWN is in effect, then the following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_spawnattr_getschedparam (), .IR posix_spawnattr_getschedpolicy (), .IR posix_spawnattr_setschedparam (), .IR posix_spawnattr_setschedpolicy (). -.in -4 +.in .fi .SS RS - _POSIX_RAW_SOCKETS Raw sockets are supported. @@ -299,10 +285,10 @@ Conversely, under POSIX.1-2001 the .B _POSIX_THREADS option implies this option. -.nf +.PP The following functions are present: -.in +4 - +.in +4n +.nf .IR pthread_rwlock_destroy (), .IR pthread_rwlock_init (), .IR pthread_rwlock_rdlock (), @@ -312,52 +298,46 @@ The following functions are present: .IR pthread_rwlock_wrlock (), .IR pthread_rwlockattr_destroy (), .IR pthread_rwlockattr_init (). -.in -4 +.in .fi .SS RTS - _POSIX_REALTIME_SIGNALS - _SC_REALTIME_SIGNALS Realtime signals are supported. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR sigqueue (), .IR sigtimedwait (), .IR sigwaitinfo (). -.br -.in -4 +.in .fi .SS --- - _POSIX_REGEXP - _SC_REGEXP If this option is in effect (as it always is under POSIX.1-2001) then POSIX regular expressions are supported and the following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR regcomp (), .IR regerror (), .IR regexec (), .IR regfree (). -.br -.in -4 +.in .fi .SS --- - _POSIX_SAVED_IDS - _SC_SAVED_IDS If this option is in effect (as it always is under POSIX.1-2001), then a process has a saved set-user-ID and a saved set-group-ID. Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR exec (), .IR kill (), .IR seteuid (), .IR setegid (), .IR setgid (), .IR setuid (). -.br -.in -4 +.in .fi .\" .SS SD .\" Software development @@ -366,10 +346,9 @@ The include file .I <semaphore.h> is present. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR sem_close (), .IR sem_destroy (), .IR sem_getvalue (), @@ -379,21 +358,18 @@ The following functions are present: .IR sem_trywait (), .IR sem_unlink (), .IR sem_wait (). -.br -.in -4 +.in .fi .SS SHM - _POSIX_SHARED_MEMORY_OBJECTS - _SC_SHARED_MEMORY_OBJECTS The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR mmap (), .IR munmap (), .IR shm_open (), .IR shm_unlink (). -.br -.in -4 +.in .fi .SS --- - _POSIX_SHELL - _SC_SHELL If this option is in effect (as it always is under POSIX.1-2001), @@ -410,10 +386,9 @@ If is in effect, then the include file .I <spawn.h> and the following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_spawn (), .IR posix_spawn_file_actions_addclose (), .IR posix_spawn_file_actions_adddup2 (), @@ -431,22 +406,20 @@ and the following functions are present: .IR posix_spawnattr_setpgroup (), .IR posix_spawnattr_setsigmask (), .IR posix_spawnp (). -.in -4 -.br +.in .fi If also .B _POSIX_PRIORITY_SCHEDULING is in effect, then the following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_spawnattr_getschedparam (), .IR posix_spawnattr_getschedpolicy (), .IR posix_spawnattr_setschedparam (), .IR posix_spawnattr_setschedpolicy (). -.in -4 +.in .fi .SS SPI - _POSIX_SPIN_LOCKS - _SC_SPIN_LOCKS This option implies the @@ -455,17 +428,15 @@ and .B _POSIX_THREAD_SAFE_FUNCTIONS options. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_spin_destroy (), .IR pthread_spin_init (), .IR pthread_spin_lock (), .IR pthread_spin_trylock (), .IR pthread_spin_unlock (). -.in -4 -.br +.in -4n .fi .SS SS - _POSIX_SPORADIC_SERVER - _SC_SPORADIC_SERVER The scheduling policy @@ -475,14 +446,12 @@ This option implies the .B _POSIX_PRIORITY_SCHEDULING option. Affected functions are -.br +.PP .nf -.in +4 - +.in +n4 .IR sched_setparam (), .IR sched_setscheduler (). -.in -4 -.br +.in .fi .SS SIO - _POSIX_SYNCHRONIZED_IO - _SC_SYNCHRONIZED_IO Affected functions are @@ -492,29 +461,25 @@ Affected functions are .IR fdatasync (). .SS TSA - _POSIX_THREAD_ATTR_STACKADDR - _SC_THREAD_ATTR_STACKADDR Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_attr_getstack (), .IR pthread_attr_getstackaddr (), .IR pthread_attr_setstack (), .IR pthread_attr_setstackaddr (). -.in -4 -.br +.in .fi .SS TSS - _POSIX_THREAD_ATTR_STACKSIZE - _SC_THREAD_ATTR_STACKSIZE Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_attr_getstack (), .IR pthread_attr_getstacksize (), .IR pthread_attr_setstack (), .IR pthread_attr_setstacksize (). -.in -4 -.br +.in .fi .SS TCT - _POSIX_THREAD_CPUTIME - _SC_THREAD_CPUTIME The clockID CLOCK_THREAD_CPUTIME_ID is supported. @@ -522,52 +487,45 @@ This option implies the .B _POSIX_TIMERS option. Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_getcpuclockid (), .IR clock_getres (), .IR clock_gettime (), .IR clock_settime (), .IR timer_create (). -.in -4 -.br +.in .fi .SS TPI - _POSIX_THREAD_PRIO_INHERIT - _SC_THREAD_PRIO_INHERIT Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_mutexattr_getprotocol (), .IR pthread_mutexattr_setprotocol (). -.in -4 -.br +.in .fi .SS TPP - _POSIX_THREAD_PRIO_PROTECT - _SC_THREAD_PRIO_PROTECT Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_mutex_getprioceiling (), .IR pthread_mutex_setprioceiling (), .IR pthread_mutexattr_getprioceiling (), .IR pthread_mutexattr_getprotocol (), .IR pthread_mutexattr_setprioceiling (), .IR pthread_mutexattr_setprotocol (). -.in -4 -.br +.in .fi .SS TPS - _POSIX_THREAD_PRIORITY_SCHEDULING - _SC_THREAD_PRIORITY_SCHEDULING If this option is in effect, the different threads inside a process can run with different priorities and/or different schedulers. Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_attr_getinheritsched (), .IR pthread_attr_getschedpolicy (), .IR pthread_attr_getscope (), @@ -577,15 +535,13 @@ Affected functions are .IR pthread_getschedparam (), .IR pthread_setschedparam (), .IR pthread_setschedprio (). -.in -4 -.br +.in .fi .SS TSH - _POSIX_THREAD_PROCESS_SHARED - _SC_THREAD_PROCESS_SHARED Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_barrierattr_getpshared (), .IR pthread_barrierattr_setpshared (), .IR pthread_condattr_getpshared (), @@ -594,15 +550,13 @@ Affected functions are .IR pthread_mutexattr_setpshared (), .IR pthread_rwlockattr_getpshared (), .IR pthread_rwlockattr_setpshared (). -.in -4 -.br +.in .fi .SS TSF - _POSIX_THREAD_SAFE_FUNCTIONS - _SC_THREAD_SAFE_FUNCTIONS Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR readdir_r (), .IR getgrgid_r (), .IR getgrnam_r (), @@ -622,31 +576,27 @@ Affected functions are .IR ctime_r (), .IR gmtime_r (), .IR localtime_r (). -.in -4 -.br +.in .fi .SS TSP - _POSIX_THREAD_SPORADIC_SERVER - _SC_THREAD_SPORADIC_SERVER This option implies the .B _POSIX_THREAD_PRIORITY_SCHEDULING option. Affected functions are -.br +.PP .nf -.in +4 - +.in +4n .IR sched_getparam (), .IR sched_setparam (), .IR sched_setscheduler (). -.in -4 -.br +.in .fi .SS THR - _POSIX_THREADS - _SC_THREADS Basic support for POSIX threads is available. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR pthread_atfork (), .IR pthread_attr_destroy (), .IR pthread_attr_getdetachstate (), @@ -695,15 +645,13 @@ The following functions are present: .IR pthread_setcanceltype (), .IR pthread_setspecific (), .IR pthread_testcancel (). -.in -4 -.br +.in .fi .SS TMO - _POSIX_TIMEOUTS - _SC_TIMEOUTS The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR mq_timedreceive (), .IR mq_timedsend (), .IR pthread_mutex_timedlock (), @@ -711,15 +659,13 @@ The following functions are present: .IR pthread_rwlock_timedwrlock (), .IR sem_timedwait (), .IR posix_trace_timedgetnext_event (). -.in -4 -.br +.in .fi .SS TMR - _POSIX_TIMERS - _SC_TIMERS The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR clock_getres (), .IR clock_gettime (), .IR clock_settime (), @@ -729,16 +675,14 @@ The following functions are present: .IR timer_gettime (), .IR timer_getoverrun (), .IR timer_settime (). -.in -4 -.br +.in .fi .SS TRC - _POSIX_TRACE - _SC_TRACE POSIX tracing is available. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_trace_attr_destroy (), .IR posix_trace_attr_getclockres (), .IR posix_trace_attr_getcreatetime (), @@ -770,18 +714,16 @@ The following functions are present: .IR posix_trace_start (), .IR posix_trace_stop (), .IR posix_trace_trygetnext_event (). -.in -4 -.br +.in .fi .SS TEF - _POSIX_TRACE_EVENT_FILTER - _SC_TRACE_EVENT_FILTER This option implies the .B _POSIX_TRACE option. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_trace_eventset_add (), .IR posix_trace_eventset_del (), .IR posix_trace_eventset_empty (), @@ -790,8 +732,7 @@ The following functions are present: .IR posix_trace_get_filter (), .IR posix_trace_set_filter (), .IR posix_trace_trid_eventid_open (). -.in -4 -.br +.in .fi .SS TRI - _POSIX_TRACE_INHERIT - _SC_TRACE_INHERIT Tracing children of the traced process is supported. @@ -799,24 +740,21 @@ This option implies the .B _POSIX_TRACE option. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_trace_attr_getinherited (), .IR posix_trace_attr_setinherited (). -.in -4 -.br +.in .fi .SS TRL - _POSIX_TRACE_LOG - _SC_TRACE_LOG This option implies the .B _POSIX_TRACE option. The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_trace_attr_getlogfullpolicy (), .IR posix_trace_attr_getlogsize (), .IR posix_trace_attr_setlogfullpolicy (), @@ -825,20 +763,17 @@ The following functions are present: .IR posix_trace_create_withlog (), .IR posix_trace_open (), .IR posix_trace_rewind (). -.in -4 -.br +.in .fi .SS TYM - _POSIX_TYPED_MEMORY_OBJECTS - _SC_TYPED_MEMORY_OBJECT The following functions are present: -.br +.PP .nf -.in +4 - +.in +4n .IR posix_mem_offset (), .IR posix_typed_mem_get_info (), .IR posix_typed_mem_open (). -.in -4 -.br +.in .fi .SS --- - _POSIX_VDISABLE Always present (probably 0). diff --git a/man7/rtld-audit.7 b/man7/rtld-audit.7 index 91719203ba..4d659042d7 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -415,8 +415,8 @@ depend on the hardware platform. (The appropriate definition is supplied by .IR <link.h> .) Here is the definition for x86-32: +.PP .nf - .BI "unsigned int la_i86_gnu_pltexit(Elf32_Sym *" sym ", unsigned int " ndx , .BI " uintptr_t *" refcook ", uintptr_t *" defcook , .BI " const La_i86_regs *" inregs ", La_i86_retval *" outregs , @@ -501,7 +501,7 @@ This is reportedly fixed in glibc 2.10. .\" glibc bug filed: http://sourceware.org/bugzilla/show_bug.cgi?id=9733 .\" Reportedly, this is fixed on 16 Mar 2009 (i.e., for glibc 2.10) .SH EXAMPLE -.nf +.EX #include <link.h> #include <stdio.h> @@ -599,7 +599,7 @@ la_i86_gnu_pltenter(Elf32_Sym *sym, unsigned int ndx, return sym\->st_value; } -.fi +.EE .SH SEE ALSO .BR ldd (1), .BR dlopen (3), |