diff --git a/man1/getent.1 b/man1/getent.1 index 97ddf2d96..d458fbd6b 100644 --- a/man1/getent.1 +++ b/man1/getent.1 @@ -341,7 +341,7 @@ in succession to .BR getspnam (3) and display the result. .RE -.SH "EXIT STATUS" +.SH EXIT STATUS One of the following exit values can be returned by .BR getent : .RS 3 @@ -364,5 +364,5 @@ could not be found in the Enumeration not supported on this .IR database . .RE -.SH "SEE ALSO" +.SH SEE ALSO .BR nsswitch.conf (5) diff --git a/man1/intro.1 b/man1/intro.1 index ef62fa6c3..6182eea8a 100644 --- a/man1/intro.1 +++ b/man1/intro.1 @@ -297,5 +297,5 @@ and use a browser if you find HTML files there. .\" .\" Actual examples? Separate section for each of cat, cp, ...? .\" gzip, bzip2, tar, rpm -.SH "SEE ALSO" +.SH SEE ALSO .BR standards (7) diff --git a/man1/time.1 b/man1/time.1 index 1b2f22bea..a3f7baf8a 100644 --- a/man1/time.1 +++ b/man1/time.1 @@ -60,7 +60,7 @@ When in the POSIX locale, use the precise traditional format (with numbers in seconds) where the number of decimals in the output for %f is unspecified but is sufficient to express the clock tick accuracy, and at least one. -.SH "EXIT STATUS" +.SH EXIT STATUS If .I command was invoked, the exit status is that of @@ -83,7 +83,7 @@ are used. The last one to search for .IR command . The remaining ones for the text and formatting of the output. -.SH "GNU VERSION" +.SH GNU VERSION Below a description of the GNU 1.7 version of .BR time . Disregarding the name of the utility, GNU makes it output lots of @@ -299,7 +299,7 @@ and C compiler you used. .\" Helped with portability .\" .IP "Francois Pinard" .\" Helped with portability -.SH "SEE ALSO" +.SH SEE ALSO .BR tcsh (1), .BR times (2), .BR wait3 (2) diff --git a/man2/_exit.2 b/man2/_exit.2 index bdd0a9bee..b4183a900 100644 --- a/man2/_exit.2 +++ b/man2/_exit.2 @@ -76,9 +76,9 @@ The function .BR _Exit () is equivalent to .BR _exit (). -.SH "RETURN VALUE" +.SH RETURN VALUE These functions do not return. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD. The function .BR _Exit () @@ -121,7 +121,7 @@ wrapper function invoked the kernel system call of the same name. Since glibc 2.3, the wrapper function invokes .BR exit_group (2), in order to terminate all of the threads in a process. -.SH "SEE ALSO" +.SH SEE ALSO .BR execve (2), .BR exit_group (2), .BR fork (2), diff --git a/man2/_syscall.2 b/man2/_syscall.2 index 77d11c5d5..9605e2522 100644 --- a/man2/_syscall.2 +++ b/man2/_syscall.2 @@ -38,7 +38,7 @@ .TH _SYSCALL 2 2007-12-19 "Linux" "Linux Programmer's Manual" .SH NAME _syscall \- invoking a system call without library support (OBSOLETE) -.SH "SYNOPSIS" +.SH SYNOPSIS .B #include A _syscall macro @@ -74,7 +74,7 @@ Once you include the _syscall() in your source file, you call the system call by \fIname\fP. .SH FILES .I /usr/include/linux/unistd.h -.SH "CONFORMING TO" +.SH CONFORMING TO The use of these macros is Linux-specific, and deprecated. .SH NOTES Starting around kernel 2.6.18, the _syscall macros were removed @@ -160,7 +160,7 @@ Memory in buffers = 5066752 Swap: total 27881472 / free 24698880 Number of processes = 40 .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR intro (2), .BR syscall (2), .BR errno (3) diff --git a/man2/accept.2 b/man2/accept.2 index 774984445..0a58d162c 100644 --- a/man2/accept.2 +++ b/man2/accept.2 @@ -175,7 +175,7 @@ See the description of the flag in .BR open (2) for reasons why this may be useful. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these system calls return a nonnegative integer that is a descriptor for the accepted socket. @@ -289,7 +289,7 @@ The .BR accept4 () system call is available starting with Linux 2.6.28; support in glibc is available starting with version 2.10. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR accept (): POSIX.1-2001, SVr4, 4.4BSD, @@ -376,7 +376,7 @@ stupid thing, so they silently just renamed their blunder)." .SH EXAMPLE See .BR bind (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR bind (2), .BR connect (2), .BR listen (2), diff --git a/man2/access.2 b/man2/access.2 index 9aaffb881..5bb7d658a 100644 --- a/man2/access.2 +++ b/man2/access.2 @@ -85,7 +85,7 @@ then an .B X_OK check is successful for a regular file if execute permission is enabled for any of the file owner, group, or other. -.SH "RETURN VALUE" +.SH RETURN VALUE On success (all requested permissions granted), zero is returned. On error (at least one bit in .I mode @@ -145,7 +145,7 @@ Insufficient kernel memory was available. .B ETXTBSY Write access was requested to an executable which is being executed. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES .PP @@ -238,7 +238,7 @@ the underlying file system. Since kernel 2.6.20, .BR access () honors this flag. -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (2), .BR chown (2), .BR faccessat (2), diff --git a/man2/acct.2 b/man2/acct.2 index 622c1f951..62acdb16e 100644 --- a/man2/acct.2 +++ b/man2/acct.2 @@ -57,7 +57,7 @@ accounting is turned on, and records for each terminating process are appended to \fIfilename\fP as it terminates. An argument of NULL causes accounting to be turned off. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -127,7 +127,7 @@ refers to a file on a read-only file system. .TP .B EUSERS There are no more free file structures or we ran out of memory. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD (but not POSIX). .\" SVr4 documents an EBUSY error condition, but no EISDIR or ENOSYS. .\" Also AIX and HP-UX document EBUSY (attempt is made @@ -140,5 +140,5 @@ In particular, nonterminating processes are never accounted for. The structure of the records written to the accounting file is described in .BR acct (5). -.SH "SEE ALSO" +.SH SEE ALSO .BR acct (5) diff --git a/man2/adjtimex.2 b/man2/adjtimex.2 index 549019655..bbf85a9ba 100644 --- a/man2/adjtimex.2 +++ b/man2/adjtimex.2 @@ -91,7 +91,7 @@ Ordinary users are restricted to a zero value for Only the superuser may set any parameters. .br .ne 12v -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR adjtimex () returns the clock state: @@ -140,7 +140,7 @@ is nonzero and the caller does not have sufficient privilege. Under Linux the .B CAP_SYS_TIME capability is required. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR adjtimex () is Linux-specific and should not be used in programs intended to be portable. @@ -148,7 +148,7 @@ See .BR adjtime (3) for a more portable, but less flexible, method of adjusting the system clock. -.SH "SEE ALSO" +.SH SEE ALSO .BR settimeofday (2), .BR adjtime (3), .BR capabilities (7), diff --git a/man2/alarm.2 b/man2/alarm.2 index 0a8469e25..7ec398414 100644 --- a/man2/alarm.2 +++ b/man2/alarm.2 @@ -53,12 +53,12 @@ is scheduled. In any event any previously set .BR alarm () is canceled. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR alarm () returns the number of seconds remaining until any previously scheduled alarm was due to be delivered, or zero if there was no previously scheduled alarm. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD. .SH NOTES .BR alarm () @@ -78,7 +78,7 @@ is a bad idea. Scheduling delays can, as ever, cause the execution of the process to be delayed by an arbitrary amount of time. -.SH "SEE ALSO" +.SH SEE ALSO .BR gettimeofday (2), .BR pause (2), .BR select (2), diff --git a/man2/alloc_hugepages.2 b/man2/alloc_hugepages.2 index 4ece3a023..b44444e11 100644 --- a/man2/alloc_hugepages.2 +++ b/man2/alloc_hugepages.2 @@ -106,7 +106,7 @@ with the given key existed. If this flag is not set, then .B ENOENT is returned when no segment with the given key exists. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR alloc_hugepages () returns the allocated virtual address, and @@ -127,7 +127,7 @@ This can be read and written. .I /proc/meminfo Gives info on the number of configured hugetlb pages and on their size in the three variables HugePages_Total, HugePages_Free, Hugepagesize. -.SH "CONFORMING TO" +.SH CONFORMING TO These calls are specific to Linux on Intel processors, and should not be used in programs intended to be portable. .SH NOTES diff --git a/man2/arch_prctl.2 b/man2/arch_prctl.2 index 7032f7eb8..8018e42f8 100644 --- a/man2/arch_prctl.2 +++ b/man2/arch_prctl.2 @@ -99,7 +99,7 @@ is not a valid subcommand. is outside the process address space. .\" .SH AUTHOR .\" Man page written by Andi Kleen. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR arch_prctl () is a Linux/x86-64 extension and should not be used in programs intended to be portable. @@ -134,7 +134,7 @@ This may be fixed in future glibc versions. .I FS may be already used by the threading library. -.SH "SEE ALSO" +.SH SEE ALSO .BR mmap (2), .BR modify_ldt (2), .BR prctl (2), diff --git a/man2/bdflush.2 b/man2/bdflush.2 index 40a3a588f..1149b713f 100644 --- a/man2/bdflush.2 +++ b/man2/bdflush.2 @@ -86,7 +86,7 @@ to that value. The set of parameters, their values, and their valid ranges are defined in the Linux kernel source file .IR fs/buffer.c . -.SH "RETURN VALUE" +.SH RETURN VALUE If .I func is negative or 0 and the daemon successfully starts, @@ -113,11 +113,11 @@ or to write an invalid value to a parameter. Caller does not have the .B CAP_SYS_ADMIN capability. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR bdflush () is Linux-specific and should not be used in programs intended to be portable. -.SH "SEE ALSO" +.SH SEE ALSO .BR fsync (2), .BR sync (2), .BR sync (8), diff --git a/man2/bind.2 b/man2/bind.2 index f7c9ed0e8..ce24f9437 100644 --- a/man2/bind.2 +++ b/man2/bind.2 @@ -147,7 +147,7 @@ pointer passed in .I addr in order to avoid compiler warnings. See EXAMPLE below. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -217,7 +217,7 @@ A component of the path prefix is not a directory. .TP .B EROFS The socket inode would reside on a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD, POSIX.1-2001 .RB ( bind () first appeared in 4.2BSD). @@ -314,7 +314,7 @@ main(int argc, char *argv[]) should be deleted using unlink(2) or remove(3) */ } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR connect (2), .BR getsockname (2), diff --git a/man2/brk.2 b/man2/brk.2 index c87d2c005..aa86c7a16 100644 --- a/man2/brk.2 +++ b/man2/brk.2 @@ -91,7 +91,7 @@ Calling with an .I increment of 0 can be used to find the current location of the program break. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR brk () returns zero. @@ -112,7 +112,7 @@ is returned, and .I errno is set to .BR ENOMEM . -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD; SUSv1, marked LEGACY in SUSv2, removed in POSIX.1-2001. .\" .\" .BR brk () @@ -162,7 +162,7 @@ is implemented as a library function that uses the .BR brk () system call, and does some internal bookkeeping so that it can return the old break value. -.SH "SEE ALSO" +.SH SEE ALSO .BR execve (2), .BR getrlimit (2), .BR end (3), diff --git a/man2/cacheflush.2 b/man2/cacheflush.2 index 426331ba1..8e59d222c 100644 --- a/man2/cacheflush.2 +++ b/man2/cacheflush.2 @@ -49,7 +49,7 @@ Write back to memory and invalidate the affected valid cache lines. .B BCACHE Same as .BR (ICACHE|DCACHE) . -.SH "RETURN VALUE" +.SH RETURN VALUE .BR cacheflush () returns 0 on success or \-1 on error. If errors are detected, diff --git a/man2/capget.2 b/man2/capget.2 index 3fb25bc84..09fa5f277 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -149,7 +149,7 @@ to all members of the process group whose ID is \-\fIpid\fP. For details on the data, see .BR capabilities (7). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -207,7 +207,7 @@ instead of 0.) .TP .B ESRCH No such thread. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. .SH NOTES The portable interface to the capability querying and setting @@ -217,7 +217,7 @@ library and is available here: .br .UR http://www.kernel.org\:/pub\:/linux\:/libs\:/security\:/linux-privs .UE -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR gettid (2), .BR capabilities (7) diff --git a/man2/chdir.2 b/man2/chdir.2 index 5b9b973a0..360154408 100644 --- a/man2/chdir.2 +++ b/man2/chdir.2 @@ -67,7 +67,7 @@ is identical to .BR chdir (); the only difference is that the directory is given as an open file descriptor. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -122,7 +122,7 @@ Search permission was denied on the directory open on .B EBADF .I fd is not a valid file descriptor. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD, POSIX.1-2001. .SH NOTES The current working directory is the starting point for interpreting @@ -133,7 +133,7 @@ A child process created via inherits its parent's current working directory. The current working directory is left unchanged by .BR execve (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR chroot (2), .BR getcwd (3), .BR path_resolution (7) diff --git a/man2/chmod.2 b/man2/chmod.2 index b9b9aefb9..3a86d0834 100644 --- a/man2/chmod.2 +++ b/man2/chmod.2 @@ -150,7 +150,7 @@ already open files, because the access control is done on the server, but open files are maintained by the client. Widening the permissions may be delayed for other clients if attribute caching is enabled on them. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -216,9 +216,9 @@ See above. .TP .B EROFS See above. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, SVr4, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (2), .BR execve (2), .BR fchmodat (2), diff --git a/man2/chown.2 b/man2/chown.2 index 05e362dc2..06dd5839c 100644 --- a/man2/chown.2 +++ b/man2/chown.2 @@ -116,7 +116,7 @@ bit is not set) the .B S_ISGID bit indicates mandatory locking, and is not cleared by a .BR chown (). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -178,7 +178,7 @@ See above. .TP .B EROFS See above. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, SVr4, POSIX.1-2001. The 4.4BSD version can only be @@ -333,7 +333,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (2), .BR fchownat (2), .BR flock (2), diff --git a/man2/chroot.2 b/man2/chroot.2 index a21f57ef3..422b2d022 100644 --- a/man2/chroot.2 +++ b/man2/chroot.2 @@ -87,7 +87,7 @@ by doing: This call does not close open file descriptors, and such file descriptors may allow access to files outside the chroot tree. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -131,7 +131,7 @@ is not a directory. .TP .B EPERM The caller has insufficient privilege. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD, SUSv2 (marked LEGACY). This function is not part of POSIX.1-2001. .\" SVr4 documents additional EINTR, ENOLINK and EMULTIHOP error conditions. @@ -148,6 +148,6 @@ FreeBSD has a stronger system call. .\" FIXME . eventually say something about containers, .\" virtual servers, etc.? -.SH "SEE ALSO" +.SH SEE ALSO .BR chdir (2), .BR path_resolution (7) diff --git a/man2/clock_getres.2 b/man2/clock_getres.2 index 794dd6525..9d90c1f53 100644 --- a/man2/clock_getres.2 +++ b/man2/clock_getres.2 @@ -153,7 +153,7 @@ High-resolution per-process timer from the CPU. .TP .B CLOCK_THREAD_CPUTIME_ID Thread-specific CPU-time clock. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR clock_gettime (), .BR clock_settime () and @@ -178,7 +178,7 @@ specified is not supported on this system. .B EPERM .BR clock_settime () does not have permission to set the clock indicated. -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv2, POSIX.1-2001. .SH AVAILABILITY On POSIX systems on which these functions are available, the symbol @@ -237,7 +237,7 @@ clocks using On Linux, these clocks are not settable (i.e., no process has "appropriate privileges"). .\" See http://bugzilla.kernel.org/show_bug.cgi?id=11972 -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR gettimeofday (2), .BR settimeofday (2), diff --git a/man2/clock_nanosleep.2 b/man2/clock_nanosleep.2 index 6b0244db0..e10298de6 100644 --- a/man2/clock_nanosleep.2 +++ b/man2/clock_nanosleep.2 @@ -141,7 +141,7 @@ it returns the remaining unslept time in This value can then be used to call .BR clock_nanosleep () again and complete a (relative) sleep. -.SH "RETURN VALUE" +.SH RETURN VALUE On successfully sleeping for the requested interval, .BR clock_nanosleep () returns 0. @@ -176,7 +176,7 @@ The .BR clock_nanosleep () system call first appeared in Linux 2.6. Support is available in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES If the interval specified in @@ -242,7 +242,7 @@ clock via .BR clock_settime (2) shall have no effect on a thread that is blocked on a relative .BR clock_nanosleep (). -.SH "SEE ALSO" +.SH SEE ALSO .BR clock_getres (2), .BR nanosleep (2), .BR timer_create (2), diff --git a/man2/clone.2 b/man2/clone.2 index 62a408e7d..735ad70fa 100644 --- a/man2/clone.2 +++ b/man2/clone.2 @@ -801,7 +801,7 @@ does not take arguments .IR tls , and .IR ctid . -.SH "RETURN VALUE" +.SH RETURN VALUE .\" gettid(2) returns current->pid; .\" getpid(2) returns current->tgid; On success, the thread ID of the child process is returned @@ -925,7 +925,7 @@ in libc5. glibc2 provides .BR clone () as described in this manual page. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR clone () and @@ -1119,7 +1119,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fork (2), .BR futex (2), .BR getpid (2), diff --git a/man2/close.2 b/man2/close.2 index a2a296126..fe3bc0227 100644 --- a/man2/close.2 +++ b/man2/close.2 @@ -61,7 +61,7 @@ if the descriptor was the last reference to a file which has been removed using .BR unlink (2) the file is deleted. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR close () returns zero on success. On error, \-1 is returned, and @@ -81,7 +81,7 @@ call was interrupted by a signal; see .TP .B EIO An I/O error occurred. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents an additional ENOLINK error condition. .SH NOTES @@ -122,7 +122,7 @@ that may cause unintended side effects. .\" call has restared after ERESTARTSYS, the original system call will .\" later restart with the reused file descriptor. This is most likely a .\" serious programming error. -.SH "SEE ALSO" +.SH SEE ALSO .BR fcntl (2), .BR fsync (2), .BR open (2), diff --git a/man2/connect.2 b/man2/connect.2 index 649f5e77f..f8cb69ca6 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -122,7 +122,7 @@ member of set to .BR AF_UNSPEC (supported on Linux since kernel 2.2). -.SH "RETURN VALUE" +.SH RETURN VALUE If the connection or binding succeeds, zero is returned. On error, \-1 is returned, and .I errno @@ -220,7 +220,7 @@ The server may be too busy to accept new connections. Note that for IP sockets the timeout may be very long when syncookies are enabled on the server. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD, (the .BR connect () function first appeared in 4.2BSD), POSIX.1-2001. @@ -258,7 +258,7 @@ An example of the use of .BR connect () is shown in .BR getaddrinfo (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR bind (2), .BR getsockname (2), diff --git a/man2/create_module.2 b/man2/create_module.2 index cb0d81559..55d9d104e 100644 --- a/man2/create_module.2 +++ b/man2/create_module.2 @@ -22,7 +22,7 @@ This system call is present only in kernels before Linux 2.6. attempts to create a loadable module entry and reserve the kernel memory that will be needed to hold the module. This system call requires privilege. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, returns the kernel address at which the module will reside. On error \-1 is returned and .I errno @@ -57,10 +57,10 @@ capability). This system call is only present on Linux up until kernel 2.4; it was removed in Linux 2.6. .\" Removed in Linux 2.5.48 -.SH "CONFORMING TO" +.SH CONFORMING TO .BR create_module () is Linux-specific. -.SH "SEE ALSO" +.SH SEE ALSO .BR delete_module (2), .BR init_module (2), .BR query_module (2) diff --git a/man2/delete_module.2 b/man2/delete_module.2 index 3c1294944..025af7ded 100644 --- a/man2/delete_module.2 +++ b/man2/delete_module.2 @@ -119,7 +119,7 @@ this flag is silently ignored. .BR CONFIG_MODULE_FORCE_UNLOAD is enabled.) Using this flag taints the kernel (TAINT_FORCED_RMMOD). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned and .I errno @@ -167,7 +167,7 @@ but the reference count of this module is nonzero and .B O_TRUNC was not specified in .IR flags . -.SH "CONFORMING TO" +.SH CONFORMING TO .BR delete_module () is Linux-specific. .SH NOTES @@ -197,7 +197,7 @@ Some further details of differences in the behavior of in Linux 2.4 and earlier are .I not currently explained in this manual page. -.SH "SEE ALSO" +.SH SEE ALSO .BR create_module (2), .BR init_module (2), .BR query_module (2), diff --git a/man2/dup.2 b/man2/dup.2 index dba82a66c..bdb1c7ca5 100644 --- a/man2/dup.2 +++ b/man2/dup.2 @@ -117,7 +117,7 @@ then .BR dup3 () fails with the error .BR EINVAL . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these system calls return the new descriptor. On error, \-1 is returned, and @@ -167,7 +167,7 @@ descriptors open and tried to open a new one. was added to Linux in version 2.6.27; glibc support is available starting with version 2.9. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR dup (), .BR dup2 (): SVr4, 4.3BSD, POSIX.1-2001. @@ -204,7 +204,7 @@ or without closing .I newfd first. -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR fcntl (2), .BR open (2) diff --git a/man2/epoll_create.2 b/man2/epoll_create.2 index 344d648f4..0141f43ec 100644 --- a/man2/epoll_create.2 +++ b/man2/epoll_create.2 @@ -75,7 +75,7 @@ See the description of the flag in .BR open (2) for reasons why this may be useful. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these system calls return a nonnegative file descriptor. @@ -142,7 +142,7 @@ must still be greater than zero, in order to ensure backward compatibility when new .B epoll applications are run on older kernels. -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR epoll_ctl (2), .BR epoll_wait (2), diff --git a/man2/epoll_ctl.2 b/man2/epoll_ctl.2 index b4c4621bc..cd624d623 100644 --- a/man2/epoll_ctl.2 +++ b/man2/epoll_ctl.2 @@ -155,7 +155,7 @@ The user must call with .B EPOLL_CTL_MOD to rearm the file descriptor with a new event mask. -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, .BR epoll_ctl () returns zero. @@ -251,7 +251,7 @@ when using Applications that need to be portable to kernels before 2.6.9 should specify a non-NULL pointer in .IR event . -.SH "SEE ALSO" +.SH SEE ALSO .BR epoll_create (2), .BR epoll_wait (2), .BR poll (2), diff --git a/man2/epoll_wait.2 b/man2/epoll_wait.2 index c91870a4e..90544aece 100644 --- a/man2/epoll_wait.2 +++ b/man2/epoll_wait.2 @@ -138,7 +138,7 @@ argument may be specified as NULL, in which case .BR epoll_pwait () is equivalent to .BR epoll_wait (). -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, .BR epoll_wait () returns the number of file descriptors ready for the requested I/O, or zero @@ -217,7 +217,7 @@ is 4 and the kernel .I HZ value is 1000, this means that timeouts greater than 35.79 minutes are treated as infinity. -.SH "SEE ALSO" +.SH SEE ALSO .BR epoll_create (2), .BR epoll_ctl (2), .BR epoll (7) diff --git a/man2/eventfd.2 b/man2/eventfd.2 index 49958d624..67c442504 100644 --- a/man2/eventfd.2 +++ b/man2/eventfd.2 @@ -218,7 +218,7 @@ File descriptors created by are preserved across .BR execve (2), unless the close-on-exec flag has been set. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR eventfd () returns a new eventfd file descriptor. @@ -413,7 +413,7 @@ main(int argc, char *argv[]) } } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR futex (2), .BR pipe (2), .BR poll (2), diff --git a/man2/execve.2 b/man2/execve.2 index 86ebdd58e..1b2269332 100644 --- a/man2/execve.2 +++ b/man2/execve.2 @@ -352,7 +352,7 @@ environment space as was provided by Linux 2.6.23 and earlier. Additionally, the limit per string is 32 pages (the kernel constant .BR MAX_ARG_STRLEN ), and the maximum number of strings is 0x7FFFFFFF. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR execve () does not return, on error \-1 is returned, and @@ -447,7 +447,7 @@ file has the set-user-ID or set-group-ID bit set. .TP .B ETXTBSY Executable was open for writing by one or more processes. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. POSIX.1-2001 does not document the #! behavior but is otherwise compatible. @@ -634,7 +634,7 @@ argv[3]: hello argv[4]: world .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (2), .BR fork (2), .BR ptrace (2), diff --git a/man2/exit_group.2 b/man2/exit_group.2 index 1d1f4c9a5..bdbf68e23 100644 --- a/man2/exit_group.2 +++ b/man2/exit_group.2 @@ -34,15 +34,15 @@ This system call is equivalent to .BR exit (2) except that it terminates not only the calling thread, but all threads in the calling process's thread group. -.SH "RETURN VALUE" +.SH RETURN VALUE This system call does not return. .SH VERSIONS This call is present since Linux 2.5.35. -.SH "CONFORMING TO" +.SH CONFORMING TO This call is Linux-specific. .SH NOTES Since glibc 2.3, this is the system call invoked when the .BR exit (2) wrapper function is called. -.SH "SEE ALSO" +.SH SEE ALSO .BR exit (2) diff --git a/man2/faccessat.2 b/man2/faccessat.2 index b0b949235..322ca51d8 100644 --- a/man2/faccessat.2 +++ b/man2/faccessat.2 @@ -104,7 +104,7 @@ If .I pathname is a symbolic link, do not dereference it: instead return information about the link itself. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, (all requested permissions granted) .BR faccessat () returns 0. @@ -136,7 +136,7 @@ is a file descriptor referring to a file other than a directory. .BR faccessat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See @@ -160,7 +160,7 @@ flags are actually implemented within the glibc wrapper function for If either of these flags are specified, then the wrapper function employs .BR fstatat (2) to determine access permissions. -.SH "SEE ALSO" +.SH SEE ALSO .BR access (2), .BR openat (2), .BR euidaccess (3), diff --git a/man2/fchmodat.2 b/man2/fchmodat.2 index 007251242..c55befcbb 100644 --- a/man2/fchmodat.2 +++ b/man2/fchmodat.2 @@ -98,7 +98,7 @@ If is a symbolic link, do not dereference it: instead operate on the link itself. This flag is not currently implemented. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR fchmodat () returns 0. @@ -136,7 +136,7 @@ which is not supported. .BR fchmodat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See @@ -151,7 +151,7 @@ This interface differs from the underlying Linux system call, which does have a .I flags argument. -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (2), .BR openat (2), .BR path_resolution (7), diff --git a/man2/fchownat.2 b/man2/fchownat.2 index 2bb46ddaa..3f190cd7d 100644 --- a/man2/fchownat.2 +++ b/man2/fchownat.2 @@ -102,7 +102,7 @@ instead operate on the link itself, like .BR fchownat () dereferences symbolic links, like .BR chown (2).) -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR fchownat () returns 0. @@ -134,7 +134,7 @@ is a file descriptor referring to a file other than a directory. .BR fchownat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. A similar system call exists on Solaris. .SH NOTES @@ -142,7 +142,7 @@ See .BR openat (2) for an explanation of the need for .BR fchownat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (2), .BR openat (2), .BR path_resolution (7), diff --git a/man2/fcntl.2 b/man2/fcntl.2 index 38be5b8cb..4e6e3b663 100644 --- a/man2/fcntl.2 +++ b/man2/fcntl.2 @@ -1048,7 +1048,7 @@ of buffer space currently used to store data produces the error .BR F_GETPIPE_SZ " (\fIvoid\fP; since Linux 2.6.35)" Return (as the function result) the capacity of the pipe referred to by .IR fd . -.SH "RETURN VALUE" +.SH RETURN VALUE For a successful call, the return value depends on the operation: .TP 0.9i .B F_DUPFD @@ -1143,7 +1143,7 @@ protocol failed (e.g., locking over NFS). Attempted to clear the .B O_APPEND flag on a file that has the append-only attribute set. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. Only the operations .BR F_DUPFD , @@ -1294,7 +1294,7 @@ only after a write lock was acquired. Similar races exist between mandatory locks and .BR mmap (2). It is therefore inadvisable to rely on mandatory locking. -.SH "SEE ALSO" +.SH SEE ALSO .BR dup2 (2), .BR flock (2), .BR open (2), diff --git a/man2/flock.2 b/man2/flock.2 index 7f3f3f929..1e8b8f782 100644 --- a/man2/flock.2 +++ b/man2/flock.2 @@ -107,7 +107,7 @@ are preserved across an A shared or exclusive lock can be placed on a file regardless of the mode in which the file was opened. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -134,7 +134,7 @@ The kernel ran out of memory for allocating lock records. The file is locked and the .B LOCK_NB flag was selected. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD (the .BR flock () call first appeared in 4.2BSD). @@ -197,7 +197,7 @@ was specified. and occurs on many other implementations.) .\" Kernel 2.5.21 changed things a little: during lock conversion .\" it is now the highest priority process that will get the lock -- mtk -.SH "SEE ALSO" +.SH SEE ALSO .BR flock (1), .BR close (2), .BR dup (2), diff --git a/man2/fork.2 b/man2/fork.2 index e2430337b..5e3d677b8 100644 --- a/man2/fork.2 +++ b/man2/fork.2 @@ -164,7 +164,7 @@ in the parent and child .I may share the directory stream positioning; on Linux/glibc they do not. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the PID of the child process is returned in the parent, and 0 is returned in the child. On failure, \-1 is returned in the parent, @@ -197,7 +197,7 @@ failed to allocate the necessary kernel structures because memory is tight. is not supported on this platform (for example, .\" e.g., arm (optionally), blackfin, c6x, frv, h8300, microblaze, xtensa hardware without a Memory-Management Unit). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES .PP @@ -235,7 +235,7 @@ See .BR pipe (2) and .BR wait (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR execve (2), .BR exit (2), diff --git a/man2/fstatat.2 b/man2/fstatat.2 index a415e0e03..a3e3b5555 100644 --- a/man2/fstatat.2 +++ b/man2/fstatat.2 @@ -113,7 +113,7 @@ instead return information about the link itself, like .BR fstatat () dereferences symbolic links, like .BR stat (2).) -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR fstatat () returns 0. @@ -145,7 +145,7 @@ is a file descriptor referring to a file other than a directory. .BR fstatat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. A similar system call exists on Solaris. .SH NOTES @@ -158,7 +158,7 @@ The underlying system call employed by the glibc .BR fstatat () wrapper function is actually called .BR fstatat64 (). -.SH "SEE ALSO" +.SH SEE ALSO .BR openat (2), .BR stat (2), .BR path_resolution (7), diff --git a/man2/fsync.2 b/man2/fsync.2 index 8416eae16..e0e7970ee 100644 --- a/man2/fsync.2 +++ b/man2/fsync.2 @@ -106,7 +106,7 @@ The aim of .BR fdatasync () is to reduce disk activity for applications that do not require all metadata to be synchronized with the disk. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these system calls return zero. On error, \-1 is returned, and .I errno @@ -123,7 +123,7 @@ An error occurred during synchronization. .BR EROFS ", " EINVAL .I fd is bound to a special file which does not support synchronization. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH AVAILABILITY On POSIX systems on which @@ -160,7 +160,7 @@ In these cases disk caches need to be disabled using or .BR sdparm (8) to guarantee safe operation. -.SH "SEE ALSO" +.SH SEE ALSO .BR bdflush (2), .BR open (2), .BR sync (2), diff --git a/man2/futex.2 b/man2/futex.2 index 66c741719..67cea41f7 100644 --- a/man2/futex.2 +++ b/man2/futex.2 @@ -29,7 +29,7 @@ futex \- fast user-space locking .BI " int *" uaddr2 ", int " val3 ); .\" int *? void *? u32 *? .fi -.SH "DESCRIPTION" +.SH DESCRIPTION .PP The .BR futex () @@ -170,7 +170,7 @@ If not, the operation fails with the error The argument .I timeout is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE .PP In the event of an error, all operations return \-1, and set .I errno @@ -247,7 +247,7 @@ and the value pointed to by was not equal to the expected value .I val at the time of the call. -.SH "VERSIONS" +.SH VERSIONS .PP Initial futex support was merged in Linux 2.5.7 but with different semantics from what was described above. @@ -257,9 +257,9 @@ In Linux 2.5.70 one argument was added. In Linux 2.6.7 a sixth argument was added\(emmessy, especially on the s390 architecture. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. -.SH "NOTES" +.SH NOTES .PP To reiterate, bare futexes are not intended as an easy-to-use abstraction for end-users. @@ -273,7 +273,7 @@ read the sources of the futex user-space library referenced below. .\" Matthew Kirkwood, Ingo Molnar (Red Hat) .\" and Rusty Russell (IBM Linux Technology Center). .\" This page written by bert hubert. -.SH "SEE ALSO" +.SH SEE ALSO .BR futex (7) .PP \fIFuss, Futexes and Furwocks: Fast Userlevel Locking in Linux\fP diff --git a/man2/futimesat.2 b/man2/futimesat.2 index e3a535b76..a53eb8bca 100644 --- a/man2/futimesat.2 +++ b/man2/futimesat.2 @@ -82,7 +82,7 @@ If is absolute, then .I dirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR futimesat () returns a 0. @@ -110,7 +110,7 @@ is a file descriptor referring to a file other than a directory. .BR futimesat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is nonstandard. It was implemented from a specification that was proposed for POSIX.1, but that specification was replaced by the one for @@ -126,7 +126,7 @@ is NULL, then the glibc wrapper function updates the times for the file referred to by .IR dirfd . .\" The Solaris futimesat() also has this strangeness. -.SH "SEE ALSO" +.SH SEE ALSO .BR stat (2), .BR utimensat (2), .BR utimes (2), diff --git a/man2/get_kernel_syms.2 b/man2/get_kernel_syms.2 index 30ccb4165..5a10ebd3f 100644 --- a/man2/get_kernel_syms.2 +++ b/man2/get_kernel_syms.2 @@ -43,7 +43,7 @@ which the module is loaded. The symbols exported from each module follow their magic module tag and the modules are returned in the reverse of the order in which they were loaded. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, returns the number of symbols copied to .IR table . On error, \-1 is returned and @@ -59,7 +59,7 @@ is not supported in this version of the kernel. This system call is only present on Linux up until kernel 2.4; it was removed in Linux 2.6. .\" Removed in Linux 2.5.48 -.SH "CONFORMING TO" +.SH CONFORMING TO .BR get_kernel_syms () is Linux-specific. .SH BUGS @@ -75,7 +75,7 @@ favor of .BR query_module (2) (which is itself nowadays deprecated in favor of other interfaces described on its manual page). -.SH "SEE ALSO" +.SH SEE ALSO .BR create_module (2), .BR delete_module (2), .BR init_module (2), diff --git a/man2/get_robust_list.2 b/man2/get_robust_list.2 index 36b312db9..f2e03b59c 100644 --- a/man2/get_robust_list.2 +++ b/man2/get_robust_list.2 @@ -72,7 +72,7 @@ The .I len argument should be .IR sizeof(*head) . -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR set_robust_list () and @@ -123,7 +123,7 @@ In the unlikely event that you want to call them directly, use A thread can have only one robust futex list; therefore applications that wish to use this functionality should use the robust mutexes provided by glibc. -.SH "SEE ALSO" +.SH SEE ALSO .BR futex (2) .\" .BR pthread_mutexattr_setrobust_np (3) diff --git a/man2/get_thread_area.2 b/man2/get_thread_area.2 index ebb412173..d13b3dc57 100644 --- a/man2/get_thread_area.2 +++ b/man2/get_thread_area.2 @@ -6,7 +6,7 @@ .TH GET_THREAD_AREA 2 2012-07-13 "Linux" "Linux Programmer's Manual" .SH NAME get_thread_area \- get a thread-local storage (TLS) area -.SH "SYNOPSIS" +.SH SYNOPSIS .B #include .br .B #include @@ -15,7 +15,7 @@ get_thread_area \- get a thread-local storage (TLS) area .IR Note : There is no glibc wrapper for this system call; see NOTES. -.SH "DESCRIPTION" +.SH DESCRIPTION .BR get_thread_area () returns an entry in the current thread's thread-local storage (TLS) array. The index of the entry corresponds to the value @@ -24,7 +24,7 @@ If the value is in bounds, .BR get_thread_area () copies the corresponding TLS entry into the area pointed to by \fIu_info\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR get_thread_area () returns 0 on success. Otherwise, it returns \-1 and sets @@ -41,7 +41,7 @@ appropriately. A version of .BR get_thread_area () first appeared in Linux 2.5.32. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR get_thread_area () is Linux-specific and should not be used in programs that are intended to be portable. @@ -50,6 +50,6 @@ Glibc does not provide a wrapper for this system call, since it is generally intended only for use by threading libraries. In the unlikely event that you want to call it directly, use .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR modify_ldt (2), .BR set_thread_area (2) diff --git a/man2/getcpu.2 b/man2/getcpu.2 index e04cd5842..37e458c5a 100644 --- a/man2/getcpu.2 +++ b/man2/getcpu.2 @@ -52,7 +52,7 @@ The caller must allow for the possibility that the information returned in and .I node is no longer current by the time the call returns. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, 0 is returned. On error, \-1 is returned, and .I errno diff --git a/man2/getdents.2 b/man2/getdents.2 index ae4fa78bd..b0af9f3c1 100644 --- a/man2/getdents.2 +++ b/man2/getdents.2 @@ -136,7 +136,7 @@ have full support for returning the file type in .IR d_type . All applications must properly handle a return of .BR DT_UNKNOWN . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the number of bytes read is returned. On end of directory, 0 is returned. On error, \-1 is returned, and @@ -159,7 +159,7 @@ No such directory. .TP .B ENOTDIR File descriptor does not refer to a directory. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. .\" SVr4 documents additional ENOLINK, EIO error conditions. .SH NOTES @@ -276,6 +276,6 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR readdir (2), .BR readdir (3) diff --git a/man2/getdomainname.2 b/man2/getdomainname.2 index 7898b687c..09f0117ef 100644 --- a/man2/getdomainname.2 +++ b/man2/getdomainname.2 @@ -72,7 +72,7 @@ bytes. If the null-terminated domain name requires more than \fIlen\fP bytes, .BR getdomainname () returns the first \fIlen\fP bytes (glibc) or gives an error (libc). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -107,7 +107,7 @@ is NULL or is longer than .I len bytes. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX does not specify these calls. .\" But they appear on most systems... .SH NOTES @@ -124,7 +124,7 @@ as a library function that returns a copy of the .I domainname field returned from a call to .BR uname (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostname (2), .BR sethostname (2), .BR uname (2) diff --git a/man2/getgid.2 b/man2/getgid.2 index 1fc602b4c..142dc4e1c 100644 --- a/man2/getgid.2 +++ b/man2/getgid.2 @@ -41,7 +41,7 @@ returns the real group ID of the calling process. returns the effective group ID of the calling process. .SH ERRORS These functions are always successful. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, 4.3BSD. .SH NOTES The original Linux @@ -59,7 +59,7 @@ The glibc and .BR getegid () wrapper functions transparently deal with the variations across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getresgid (2), .BR setgid (2), .BR setregid (2), diff --git a/man2/getgroups.2 b/man2/getgroups.2 index 3c47375c9..53d13cab6 100644 --- a/man2/getgroups.2 +++ b/man2/getgroups.2 @@ -89,7 +89,7 @@ The argument specifies the number of supplementary group IDs in the buffer pointed to by .IR list . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR getgroups () returns the number of supplementary group IDs. @@ -130,7 +130,7 @@ Out of memory. .TP .B EPERM The calling process has insufficient privilege. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD. The .BR getgroups () @@ -168,7 +168,7 @@ supporting 32-bit IDs. The glibc .BR getgroups () wrapper function transparently deals with the variation across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getgid (2), .BR setgid (2), .BR getgrouplist (3), diff --git a/man2/gethostname.2 b/man2/gethostname.2 index be8f43b35..4bf495b66 100644 --- a/man2/gethostname.2 +++ b/man2/gethostname.2 @@ -86,7 +86,7 @@ then the name is truncated, and no error is returned (but see NOTES below). POSIX.1-2001 says that if such truncation occurs, then it is unspecified whether the returned buffer includes a terminating null byte. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -121,7 +121,7 @@ For the caller did not have the .B CAP_SYS_ADMIN capability. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD). POSIX.1-2001 specifies .BR gethostname () @@ -173,7 +173,7 @@ and the function returns \-1 with .I errno set to .BR ENAMETOOLONG . -.SH "SEE ALSO" +.SH SEE ALSO .BR getdomainname (2), .BR setdomainname (2), .BR uname (2) diff --git a/man2/getitimer.2 b/man2/getitimer.2 index 9c9ae3075..bdfa9b9a4 100644 --- a/man2/getitimer.2 +++ b/man2/getitimer.2 @@ -114,7 +114,7 @@ If the timer expires while the process is active (always true for the signal will be delivered immediately when generated. Otherwise the delivery will be offset by a small time dependent on the system loading. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -140,7 +140,7 @@ or (since Linux 2.6.22) one of the fields in the structure pointed to by .I new_value contains a value outside the range 0 to 999999. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, SVr4, 4.4BSD (this call first appeared in 4.2BSD). POSIX.1-2008 marks .BR getitimer () @@ -231,7 +231,7 @@ error. .\" Bugzilla report 25 Apr 2006: .\" http://bugzilla.kernel.org/show_bug.cgi?id=6443 .\" "setitimer() should reject noncanonical arguments" -.SH "SEE ALSO" +.SH SEE ALSO .BR gettimeofday (2), .BR sigaction (2), .BR signal (2), diff --git a/man2/getpagesize.2 b/man2/getpagesize.2 index 2f2703953..31350b6ff 100644 --- a/man2/getpagesize.2 +++ b/man2/getpagesize.2 @@ -103,6 +103,6 @@ Here libc4, libc5, glibc 2.0 fail because their .BR getpagesize () returns a statically derived value, and does not use a system call. Things are OK in glibc 2.1. -.SH "SEE ALSO" +.SH SEE ALSO .BR mmap (2), .BR sysconf (3) diff --git a/man2/getpeername.2 b/man2/getpeername.2 index 61d0f7f0c..a35a3824d 100644 --- a/man2/getpeername.2 +++ b/man2/getpeername.2 @@ -63,7 +63,7 @@ The returned address is truncated if the buffer provided is too small; in this case, .I addrlen will return a value greater than was supplied to the call. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -96,7 +96,7 @@ The socket is not connected. The argument .I sockfd is a file, not a socket. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD (the .BR getpeername () function call first appeared in 4.2BSD), POSIX.1-2001. @@ -138,7 +138,7 @@ call was also executed on the peer). Note also that the receiver of a datagram can obtain the address of the sender when using .BR recvfrom (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR bind (2), .BR getsockname (2), diff --git a/man2/getpid.2 b/man2/getpid.2 index f04f5fcb6..584add641 100644 --- a/man2/getpid.2 +++ b/man2/getpid.2 @@ -41,7 +41,7 @@ routines that generate unique temporary filenames.) returns the process ID of the parent of the calling process. .SH ERRORS These functions are always successful. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, 4.3BSD, SVr4. .SH NOTES Since glibc version 2.3.4, @@ -95,7 +95,7 @@ for discussion of a case where may return the wrong value even when invoking .BR clone (2) via the glibc wrapper function. -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR fork (2), .BR kill (2), diff --git a/man2/getpriority.2 b/man2/getpriority.2 index 1b7611207..0beef4db8 100644 --- a/man2/getpriority.2 +++ b/man2/getpriority.2 @@ -102,7 +102,7 @@ The call sets the priorities of all of the specified processes to the specified value. Only the superuser may lower priorities. -.SH "RETURN VALUE" +.SH RETURN VALUE Since .BR getpriority () can legitimately return the value \-1, it is necessary @@ -155,7 +155,7 @@ and was not privileged (on Linux: did not have the .B CAP_SYS_NICE capability). But see NOTES below. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD (these function calls first appeared in 4.2BSD), POSIX.1-2001. .SH NOTES @@ -227,7 +227,7 @@ the nice value is a per-thread attribute: different threads in the same process can have different nice values. Portable applications should avoid relying on the Linux behavior, which may be made standards conformant in the future. -.SH "SEE ALSO" +.SH SEE ALSO .BR nice (1), .BR renice (1), .BR fork (2), diff --git a/man2/getresuid.2 b/man2/getresuid.2 index 368eb1a40..b05d2be1d 100644 --- a/man2/getresuid.2 +++ b/man2/getresuid.2 @@ -46,7 +46,7 @@ and respectively. .BR getresgid () performs the analogous task for the process's group IDs. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -63,7 +63,7 @@ The prototypes are given by glibc since version 2.3.2, provided .B _GNU_SOURCE is defined. -.SH "CONFORMING TO" +.SH CONFORMING TO These calls are nonstandard; they also appear on HP-UX and some of the BSDs. .SH NOTES @@ -82,7 +82,7 @@ The glibc and .BR getresgid () wrapper functions transparently deal with the variations across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getuid (2), .BR setresuid (2), .BR setreuid (2), diff --git a/man2/getrlimit.2 b/man2/getrlimit.2 index ad4a47689..eb9a25684 100644 --- a/man2/getrlimit.2 +++ b/man2/getrlimit.2 @@ -650,7 +650,7 @@ main(int argc, char *argv[]) exit(EXIT_FAILURE); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR prlimit (1), .BR dup (2), .BR fcntl (2), diff --git a/man2/getrusage.2 b/man2/getrusage.2 index 339f5f912..b935cbbca 100644 --- a/man2/getrusage.2 +++ b/man2/getrusage.2 @@ -177,7 +177,7 @@ The number of times a context switch resulted due to a higher priority process becoming runnable or because the current process exceeded its time slice. .PP -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -191,7 +191,7 @@ points outside the accessible address space. .B EINVAL .I who is invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD. POSIX.1-2001 specifies .BR getrusage (), @@ -242,7 +242,7 @@ See also the description of .IR /proc/PID/stat in .BR proc (5). -.SH "SEE ALSO" +.SH SEE ALSO .BR clock_gettime (2), .BR getrlimit (2), .BR times (2), diff --git a/man2/getsid.2 b/man2/getsid.2 index 42c82b1e7..609a96f92 100644 --- a/man2/getsid.2 +++ b/man2/getsid.2 @@ -75,12 +75,12 @@ was found. This system call is available on Linux since version 2.0. .\" Linux has this system call since Linux 1.3.44. .\" There is libc support since libc 5.2.19. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .SH NOTES Linux does not return .BR EPERM . -.SH "SEE ALSO" +.SH SEE ALSO .BR getpgid (2), .BR setsid (2), .BR credentials (7) diff --git a/man2/getsockname.2 b/man2/getsockname.2 index cab1bbed8..42fb71f87 100644 --- a/man2/getsockname.2 +++ b/man2/getsockname.2 @@ -62,7 +62,7 @@ The returned address is truncated if the buffer provided is too small; in this case, .I addrlen will return a value greater than was supplied to the call. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -92,7 +92,7 @@ to perform the operation. The argument .I sockfd is a file, not a socket. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD (the .BR getsockname () function call appeared in 4.2BSD), POSIX.1-2001. @@ -107,7 +107,7 @@ Some POSIX confusion resulted in the present \fIsocklen_t\fP, also used by glibc. See also .BR accept (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR bind (2), .BR socket (2), .BR getifaddrs (3), diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index d29224396..ed8a6a989 100644 --- a/man2/getsockopt.2 +++ b/man2/getsockopt.2 @@ -126,7 +126,7 @@ option is to be disabled. For a description of the available socket options see .BR socket (7) and the appropriate protocol man pages. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -166,7 +166,7 @@ The option is unknown at the level indicated. The argument .I sockfd is a file, not a socket. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD (these system calls first appeared in 4.2BSD), POSIX.1-2001. .\" SVr4 documents additional ENOMEM and ENOSR error codes, but does @@ -197,7 +197,7 @@ See also .SH BUGS Several of the socket options should be handled at lower levels of the system. -.SH "SEE ALSO" +.SH SEE ALSO .BR ioctl (2), .BR socket (2), .BR getprotoent (3), diff --git a/man2/gettid.2 b/man2/gettid.2 index b7f5f87cf..e21da930a 100644 --- a/man2/gettid.2 +++ b/man2/gettid.2 @@ -47,7 +47,7 @@ For further details, see the discussion of .BR CLONE_THREAD in .BR clone (2). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, returns the thread ID of the calling process. .SH ERRORS This call is always successful. @@ -55,7 +55,7 @@ This call is always successful. The .BR gettid () system call first appeared on Linux in kernel 2.4.11. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR gettid () is Linux-specific and should not be used in programs that are intended to be portable. @@ -68,7 +68,7 @@ Glibc does not provide a wrapper for this system call; call it using The thread ID returned by this call is not the same thing as a POSIX thread ID (i.e., the opaque value returned by .BR pthread_self (3)). -.SH "SEE ALSO" +.SH SEE ALSO .BR capget (2), .BR clone (2), .BR fcntl (2), diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index 7c3d47a78..95b1fa3d9 100644 --- a/man2/gettimeofday.2 +++ b/man2/gettimeofday.2 @@ -135,7 +135,7 @@ In such a case it is assumed that the CMOS clock is on local time, and that it has to be incremented by this amount to get UTC system time. No doubt it is a bad idea to use this feature. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR gettimeofday () and .BR settimeofday () @@ -160,7 +160,7 @@ The calling process has insufficient privilege to call under Linux the .B CAP_SYS_TIME capability is required. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD. POSIX.1-2001 describes .BR gettimeofday () @@ -243,7 +243,7 @@ this period is determined by unpredictable political decisions. So this method of representing timezones has been abandoned. -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR adjtimex (2), .BR clock_gettime (2), diff --git a/man2/getuid.2 b/man2/getuid.2 index ad32a0197..d35ff0369 100644 --- a/man2/getuid.2 +++ b/man2/getuid.2 @@ -42,7 +42,7 @@ returns the real user ID of the calling process. returns the effective user ID of the calling process. .SH ERRORS These functions are always successful. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, 4.3BSD. .SH NOTES .SS History @@ -70,7 +70,7 @@ The glibc and .BR geteuid () wrapper functions transparently deal with the variations across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getresuid (2), .BR setreuid (2), .BR setuid (2), diff --git a/man2/getunwind.2 b/man2/getunwind.2 index 108202d4d..13ed6e392 100644 --- a/man2/getunwind.2 +++ b/man2/getunwind.2 @@ -77,7 +77,7 @@ value is zero indicates the end of the table. For more information about the format, see the .I IA-64 Software Conventions and Runtime Architecture manual. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR getunwind () returns the size of unwind table. @@ -107,5 +107,5 @@ is passed to user level via Glibc does not provide a wrapper for this system call; in the unlikely event that you want to call it, use .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR getauxval (3) diff --git a/man2/getxattr.2 b/man2/getxattr.2 index 130059157..ea702a125 100644 --- a/man2/getxattr.2 +++ b/man2/getxattr.2 @@ -132,7 +132,7 @@ can also occur. .SH VERSIONS These system calls have been available on Linux since kernel 2.4; glibc support is provided since version 2.3. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. .\" .SH AUTHORS .\" Andreas Gruenbacher, diff --git a/man2/idle.2 b/man2/idle.2 index 00c95996d..313639808 100644 --- a/man2/idle.2 +++ b/man2/idle.2 @@ -49,7 +49,7 @@ Only process 0 may call Any user process, even a process with superuser permission, will receive .BR EPERM . -.SH "RETURN VALUE" +.SH RETURN VALUE .BR idle () never returns for process 0, and always returns \-1 for a user process. .SH ERRORS @@ -58,6 +58,6 @@ never returns for process 0, and always returns \-1 for a user process. Always, for a user process. .SH VERSIONS Since Linux 2.3.13, this system call does not exist anymore. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is Linux-specific, and should not be used in programs intended to be portable. diff --git a/man2/init_module.2 b/man2/init_module.2 index be7dfd9d9..fbc459a14 100644 --- a/man2/init_module.2 +++ b/man2/init_module.2 @@ -145,7 +145,7 @@ If the kernel is built to permit forced loading (i.e., configured with then loading will continue, otherwise it will fail with .B ENOEXEC as expected for malformed modules. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these system calls return 0. On error, \-1 is returned and .I errno @@ -250,7 +250,7 @@ function. .SH VERSIONS .B finit_module () is available since Linux 3.8. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR init_module () and .BR finit_module () @@ -332,7 +332,7 @@ and are expected to point within the module body and be initialized as appropriate for kernel space, that is, relocated with the rest of the module. -.SH "SEE ALSO" +.SH SEE ALSO .BR create_module (2), .BR delete_module (2), .BR query_module (2), diff --git a/man2/inotify_add_watch.2 b/man2/inotify_add_watch.2 index 4e3cd81d2..19c9ab8e7 100644 --- a/man2/inotify_add_watch.2 +++ b/man2/inotify_add_watch.2 @@ -77,7 +77,7 @@ structures (see indicating file system events; the watch descriptor inside this structure identifies the object for which the event occurred. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR inotify_add_watch () returns a nonnegative watch descriptor. @@ -114,9 +114,9 @@ The user limit on the total number of inotify watches was reached or the kernel failed to allocate a needed resource. .SH VERSIONS Inotify was merged into the 2.6.13 Linux kernel. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. -.SH "SEE ALSO" +.SH SEE ALSO .BR inotify_init (2), .BR inotify_rm_watch (2), .BR inotify (7) diff --git a/man2/inotify_init.2 b/man2/inotify_init.2 index 97c808d39..8339752aa 100644 --- a/man2/inotify_init.2 +++ b/man2/inotify_init.2 @@ -68,7 +68,7 @@ See the description of the flag in .BR open (2) for reasons why this may be useful. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these system calls return a new file descriptor. On error, \-1 is returned, and .I errno @@ -95,9 +95,9 @@ library support was added to glibc in version 2.4. .BR inotify_init1 () was added in Linux 2.6.27; library support was added to glibc in version 2.9. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. -.SH "SEE ALSO" +.SH SEE ALSO .BR inotify_add_watch (2), .BR inotify_rm_watch (2), .BR inotify (7) diff --git a/man2/inotify_rm_watch.2 b/man2/inotify_rm_watch.2 index 4415595f6..953d9bf75 100644 --- a/man2/inotify_rm_watch.2 +++ b/man2/inotify_rm_watch.2 @@ -46,7 +46,7 @@ Removing a watch causes an event to be generated for this watch descriptor. (See .BR inotify (7).) -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR inotify_rm_watch () returns zero, or \-1 if an error occurred (in which case, @@ -66,9 +66,9 @@ is not valid; or is not an inotify file descriptor. .SH VERSIONS Inotify was merged into the 2.6.13 Linux kernel. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. -.SH "SEE ALSO" +.SH SEE ALSO .BR inotify_add_watch (2), .BR inotify_init (2), .BR inotify (7) diff --git a/man2/intro.2 b/man2/intro.2 index 34c5d65d9..d4ad7a866 100644 --- a/man2/intro.2 +++ b/man2/intro.2 @@ -65,7 +65,7 @@ header files.) In such cases, the required macro is described in the man page. For further information on feature test macros, see .BR feature_test_macros (7). -.SH "CONFORMING TO" +.SH CONFORMING TO Certain terms and abbreviations are used to indicate UNIX variants and standards to which calls in this section conform. See @@ -84,7 +84,7 @@ described in Look at the header of the manual page source for the author(s) and copyright conditions. Note that these can be different from page to page! -.SH "SEE ALSO" +.SH SEE ALSO .ad l .nh .BR _syscall (2), diff --git a/man2/io_cancel.2 b/man2/io_cancel.2 index 0297d09bd..9c41e7783 100644 --- a/man2/io_cancel.2 +++ b/man2/io_cancel.2 @@ -5,7 +5,7 @@ .TH IO_CANCEL 2 2012-07-13 "Linux" "Linux Programmer's Manual" .SH NAME io_cancel \- cancel an outstanding asynchronous I/O operation -.SH "SYNOPSIS" +.SH SYNOPSIS .nf .BR "#include " " /* Defines needed types */" @@ -15,7 +15,7 @@ io_cancel \- cancel an outstanding asynchronous I/O operation .IR Note : There is no glibc wrapper for this system call; see NOTES. -.SH "DESCRIPTION" +.SH DESCRIPTION .PP The .BR io_cancel () @@ -28,12 +28,12 @@ argument is the AIO context ID of the operation to be canceled. If the AIO context is found, the event will be canceled and then copied into the memory pointed to by \fIresult\fP without being placed into the completion queue. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR io_cancel () returns 0. For the failure return, see NOTES. -.SH "ERRORS" +.SH ERRORS .TP .B EAGAIN The \fIiocb\fP specified was not canceled. @@ -47,10 +47,10 @@ The AIO context specified by \fIctx_id\fP is invalid. .B ENOSYS .BR io_cancel () is not implemented on this architecture. -.SH "VERSIONS" +.SH VERSIONS .PP The asynchronous I/O system calls first appeared in Linux 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO .PP .BR io_cancel () is Linux-specific and should not be used @@ -85,7 +85,7 @@ then the return value follows the usual conventions for indicating an error: \-1, with .I errno set to a (positive) value that indicates the error. -.SH "SEE ALSO" +.SH SEE ALSO .BR io_destroy (2), .BR io_getevents (2), .BR io_setup (2), diff --git a/man2/io_destroy.2 b/man2/io_destroy.2 index 27d614d76..54c267d96 100644 --- a/man2/io_destroy.2 +++ b/man2/io_destroy.2 @@ -6,7 +6,7 @@ .TH IO_DESTROY 2 2012-07-13 "Linux" "Linux Programmer's Manual" .SH NAME io_destroy \- destroy an asynchronous I/O context -.SH "SYNOPSIS" +.SH SYNOPSIS .nf .BR "#include " " /* Defines needed types */" @@ -15,7 +15,7 @@ io_destroy \- destroy an asynchronous I/O context .IR Note : There is no glibc wrapper for this system call; see NOTES. -.SH "DESCRIPTION" +.SH DESCRIPTION .PP The .BR io_destroy () @@ -26,12 +26,12 @@ from the list of I/O contexts and then destroys it. It can also cancel any outstanding asynchronous I/O actions on \fIctx_id\fP and block on completion. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR io_destroy () returns 0. For the failure return, see NOTES. -.SH "ERRORS" +.SH ERRORS .TP .B EFAULT The context pointed to is invalid. @@ -42,10 +42,10 @@ The AIO context specified by \fIctx_id\fP is invalid. .B ENOSYS .BR io_destroy () is not implemented on this architecture. -.SH "VERSIONS" +.SH VERSIONS .PP The asynchronous I/O system calls first appeared in Linux 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO .PP .BR io_destroy () is Linux-specific and should not be used in programs @@ -80,7 +80,7 @@ then the return value follows the usual conventions for indicating an error: \-1, with .I errno set to a (positive) value that indicates the error. -.SH "SEE ALSO" +.SH SEE ALSO .BR io_cancel (2), .BR io_getevents (2), .BR io_setup (2), diff --git a/man2/io_getevents.2 b/man2/io_getevents.2 index d9fdfebd4..33974ce1f 100644 --- a/man2/io_getevents.2 +++ b/man2/io_getevents.2 @@ -5,7 +5,7 @@ .TH IO_GETEVENTS 2 2012-11-11 "Linux" "Linux Programmer's Manual" .SH NAME io_getevents \- read asynchronous I/O events from the completion queue -.SH "SYNOPSIS" +.SH SYNOPSIS .nf .BR "#include " " /* Defines needed types */" .BR "#include " " /* Defines 'struct timespec' */" @@ -18,7 +18,7 @@ io_getevents \- read asynchronous I/O events from the completion queue .IR Note : There is no glibc wrapper for this system call; see NOTES. -.SH "DESCRIPTION" +.SH DESCRIPTION .PP The .BR io_getevents () @@ -31,13 +31,13 @@ where a NULL timeout waits until at least \fImin_nr\fP events have been seen. Note that \fItimeout\fP is relative and will be updated if not NULL and the operation blocks. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR io_getevents () returns the number of events read: 0 if no events are available, or less than \fImin_nr\fP if the \fItimeout\fP has elapsed. For the failure return, see NOTES. -.SH "ERRORS" +.SH ERRORS .TP .B EFAULT Either \fIevents\fP or \fItimeout\fP is an invalid pointer. @@ -54,10 +54,10 @@ Interrupted by a signal handler; see .B ENOSYS .BR io_getevents () is not implemented on this architecture. -.SH "VERSIONS" +.SH VERSIONS .PP The asynchronous I/O system calls first appeared in Linux 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO .PP .BR io_getevents () is Linux-specific and should not be used in @@ -97,7 +97,7 @@ An invalid .IR ctx_id may cause a segmentation fault instead of genenerating the error .BR EINVAL . -.SH "SEE ALSO" +.SH SEE ALSO .PP .BR io_cancel (2), .BR io_destroy (2), diff --git a/man2/io_setup.2 b/man2/io_setup.2 index 7113b8f38..8ab75b978 100644 --- a/man2/io_setup.2 +++ b/man2/io_setup.2 @@ -5,7 +5,7 @@ .TH IO_SETUP 2 2012-07-13 "Linux" "Linux Programmer's Manual" .SH NAME io_setup \- create an asynchronous I/O context -.SH "SYNOPSIS" +.SH SYNOPSIS .nf .BR "#include " " /* Defines needed types */" @@ -14,7 +14,7 @@ io_setup \- create an asynchronous I/O context .IR Note : There is no glibc wrapper for this system call; see NOTES. -.SH "DESCRIPTION" +.SH DESCRIPTION .PP The .BR io_setup () @@ -27,12 +27,12 @@ argument must not point to an AIO context that already exists, and must be initialized to 0 prior to the call. On successful creation of the AIO context, \fI*ctx_idp\fP is filled in with the resulting handle. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR io_setup () returns 0. For the failure return, see NOTES. -.SH "ERRORS" +.SH ERRORS .TP .B EAGAIN The specified \fInr_events\fP exceeds the user's limit of available events. @@ -51,10 +51,10 @@ Insufficient kernel resources are available. .B ENOSYS .BR io_setup () is not implemented on this architecture. -.SH "VERSIONS" +.SH VERSIONS .PP The asynchronous I/O system calls first appeared in Linux 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO .PP .BR io_setup () is Linux-specific and should not be used in programs @@ -89,7 +89,7 @@ then the return value follows the usual conventions for indicating an error: \-1, with .I errno set to a (positive) value that indicates the error. -.SH "SEE ALSO" +.SH SEE ALSO .BR io_cancel (2), .BR io_destroy (2), .BR io_getevents (2), diff --git a/man2/io_submit.2 b/man2/io_submit.2 index 75a5a5c78..cc4dc11f2 100644 --- a/man2/io_submit.2 +++ b/man2/io_submit.2 @@ -5,7 +5,7 @@ .TH IO_SUBMIT 2 2012-07-13 "Linux" "Linux Programmer's Manual" .SH NAME io_submit \- submit asynchronous I/O blocks for processing -.SH "SYNOPSIS" +.SH SYNOPSIS .nf .BR "#include " " /* Defines needed types */" @@ -15,7 +15,7 @@ io_submit \- submit asynchronous I/O blocks for processing .IR Note : There is no glibc wrapper for this system call; see NOTES. -.SH "DESCRIPTION" +.SH DESCRIPTION .PP The .BR io_submit () @@ -26,13 +26,13 @@ The .I iocbpp argument should be an array of \fInr\fP AIO control blocks, which will be submitted to context \fIctx_id\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR io_submit () returns the number of \fIiocb\fPs submitted (which may be 0 if \fInr\fP is zero). For the failure return, see NOTES. -.SH "ERRORS" +.SH ERRORS .TP .B EAGAIN Insufficient resources are available to queue any \fIiocb\fPs. @@ -55,10 +55,10 @@ in the \fIiocb\fP. .B ENOSYS .BR io_submit () is not implemented on this architecture. -.SH "VERSIONS" +.SH VERSIONS .PP The asynchronous I/O system calls first appeared in Linux 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO .PP .BR io_submit () is Linux-specific and should not be used in @@ -93,7 +93,7 @@ then the return value follows the usual conventions for indicating an error: \-1, with .I errno set to a (positive) value that indicates the error. -.SH "SEE ALSO" +.SH SEE ALSO .BR io_cancel (2), .BR io_destroy (2), .BR io_getevents (2), diff --git a/man2/ioctl.2 b/man2/ioctl.2 index 5891d94a0..a90c467ce 100644 --- a/man2/ioctl.2 +++ b/man2/ioctl.2 @@ -78,7 +78,7 @@ Macros and defines used in specifying an .I request are located in the file .IR . -.SH "RETURN VALUE" +.SH RETURN VALUE Usually, on success zero is returned. A few .BR ioctl () @@ -135,7 +135,7 @@ call has unwanted side effects, that can be avoided under Linux by giving it the .B O_NONBLOCK flag. -.SH "SEE ALSO" +.SH SEE ALSO .BR execve (2), .BR fcntl (2), .BR ioctl_list (2), diff --git a/man2/ioctl_list.2 b/man2/ioctl_list.2 index c31c5d042..91f9fb488 100644 --- a/man2/ioctl_list.2 +++ b/man2/ioctl_list.2 @@ -100,7 +100,7 @@ or because of legacy values. Thus, it seems that the new structure only gave disadvantages: it does not help in checking, but it causes varying values for the various architectures. -.SH "RETURN VALUE" +.SH RETURN VALUE Decent ioctls return 0 on success and \-1 on error, while any output value is stored via the argument. However, diff --git a/man2/ioperm.2 b/man2/ioperm.2 index 3470a8dc5..04ff47459 100644 --- a/man2/ioperm.2 +++ b/man2/ioperm.2 @@ -70,7 +70,7 @@ programs. This call is mostly for the i386 architecture. On many other architectures it does not exist or will always return an error. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -92,7 +92,7 @@ Out of memory. .TP .B EPERM The calling process has insufficient privilege. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR ioperm () is Linux-specific and should not be used in programs intended to be portable. @@ -105,6 +105,6 @@ Glibc2 has a prototype both in and in .IR . Avoid the latter, it is available on i386 only. -.SH "SEE ALSO" +.SH SEE ALSO .BR iopl (2), .BR capabilities (7) diff --git a/man2/iopl.2 b/man2/iopl.2 index 024d9d5a6..a406fa434 100644 --- a/man2/iopl.2 +++ b/man2/iopl.2 @@ -62,7 +62,7 @@ The I/O privilege level for a normal process is 0. This call is mostly for the i386 architecture. On many other architectures it does not exist or will always return an error. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -82,7 +82,7 @@ The calling process has insufficient privilege to call the .B CAP_SYS_RAWIO capability is required. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR iopl () is Linux-specific and should not be used in programs that are intended to be portable. @@ -95,6 +95,6 @@ Glibc2 has a prototype both in and in .IR . Avoid the latter, it is available on i386 only. -.SH "SEE ALSO" +.SH SEE ALSO .BR ioperm (2), .BR capabilities (7) diff --git a/man2/ioprio_set.2 b/man2/ioprio_set.2 index 6099b2a55..f89ac1d6f 100644 --- a/man2/ioprio_set.2 +++ b/man2/ioprio_set.2 @@ -147,7 +147,7 @@ writes. I/O priorities are not supported for asynchronous writes because they are issued outside the context of the program dirtying the memory, and thus program-specific priorities do not apply. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR ioprio_get () returns the @@ -194,7 +194,7 @@ and .SH VERSIONS These system calls have been available on Linux since kernel 2.6.13. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. .SH NOTES Glibc does not provide a wrapper for these system calls; call them using @@ -344,7 +344,7 @@ Glibc does not yet provide a suitable header file defining the function prototypes and macros described on this page. Suitable definitions can be found in .IR linux/ioprio.h . -.SH "SEE ALSO" +.SH SEE ALSO .BR ionice (1), .BR getpriority (2), .BR open (2), diff --git a/man2/ipc.2 b/man2/ipc.2 index 961957a51..d56a767c3 100644 --- a/man2/ipc.2 +++ b/man2/ipc.2 @@ -43,7 +43,7 @@ the other arguments are passed through to the appropriate call. User programs should call the appropriate functions by their usual names. Only standard library implementors and kernel hackers need to know about .BR ipc (). -.SH "CONFORMING TO" +.SH CONFORMING TO .BR ipc () is Linux-specific, and should not be used in programs intended to be portable. @@ -55,7 +55,7 @@ system call; instead .BR semctl (2), .BR shmctl (2), and so on really are implemented as separate system calls. -.SH "SEE ALSO" +.SH SEE ALSO .BR msgctl (2), .BR msgget (2), .BR msgrcv (2), diff --git a/man2/kcmp.2 b/man2/kcmp.2 index 49bb03ee0..9371e8fc9 100644 --- a/man2/kcmp.2 +++ b/man2/kcmp.2 @@ -120,7 +120,7 @@ is not protected against false positives which may have place if tasks are running. Which means one should stop tasks being inspected with this syscall to obtain meaningful results. -.SH "RETURN VALUE" +.SH RETURN VALUE The return value of a successful call to .BR kcmp () is simply the result of arithmetic comparison @@ -195,7 +195,7 @@ does not exist. The .BR kcmp () system call first appeared in Linux 3.5. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR kcmp () is Linux specific and should not be used in programs intended to be portable. .SH NOTES @@ -215,6 +215,6 @@ See .BR clone (2) for some background information on the shared resources referred to on this page. -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR unshare (2) diff --git a/man2/kill.2 b/man2/kill.2 index 7d24a8ac0..f4076544b 100644 --- a/man2/kill.2 +++ b/man2/kill.2 @@ -96,7 +96,7 @@ In the case of .B SIGCONT it suffices when the sending and receiving processes belong to the same session. -.SH "RETURN VALUE" +.SH RETURN VALUE On success (at least one signal was sent), zero is returned. On error, \-1 is returned, and .I errno @@ -117,7 +117,7 @@ a process which already committed termination, but has not yet been .BR wait (2)ed for. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES The only signals that can be sent to process ID 1, the @@ -167,7 +167,7 @@ if the caller did not have permission to send the signal to \fIany\fP (rather than \fIall\fP) of the members of the process group. Notwithstanding this error return, the signal was still delivered to all of the processes for which the caller had permission to signal. -.SH "SEE ALSO" +.SH SEE ALSO .BR _exit (2), .BR killpg (2), .BR signal (2), diff --git a/man2/killpg.2 b/man2/killpg.2 index d7aff1d23..362037570 100644 --- a/man2/killpg.2 +++ b/man2/killpg.2 @@ -85,7 +85,7 @@ In the case of .B SIGCONT it suffices when the sending and receiving processes belong to the same session. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -107,7 +107,7 @@ No process can be found in the process group specified by .B ESRCH The process group was given as 0 but the sending process does not have a process group. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD (the .BR killpg () function call first appeared in 4BSD), POSIX.1-2001. @@ -130,7 +130,7 @@ On Linux, .BR killpg () is implemented as a library function that makes the call .IR "kill(-pgrp,\ sig)" . -.SH "SEE ALSO" +.SH SEE ALSO .BR getpgrp (2), .BR kill (2), .BR signal (2), diff --git a/man2/link.2 b/man2/link.2 index a59e09ff4..06d9ec31d 100644 --- a/man2/link.2 +++ b/man2/link.2 @@ -49,7 +49,7 @@ This new name may be used exactly as the old one for any operation; both names refer to the same file (and so have the same permissions and ownership) and it is impossible to tell which name was the "original". -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -135,7 +135,7 @@ are not on the same mounted file system. .BR link () does not work across different mount points, even if the same file system is mounted on both.) -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001 (but see NOTES). .\" SVr4 documents additional ENOLINK and .\" EMULTIHOP error conditions; POSIX.1 does not document ELOOP. @@ -184,7 +184,7 @@ performs the link creation and dies before it can say so. Use .BR stat (2) to find out if the link got created. -.SH "SEE ALSO" +.SH SEE ALSO .BR ln (1), .BR linkat (2), .BR open (2), diff --git a/man2/linkat.2 b/man2/linkat.2 index 484342ae7..8e5dd5f06 100644 --- a/man2/linkat.2 +++ b/man2/linkat.2 @@ -113,7 +113,7 @@ to be dereferenced if it is a symbolic link. Before kernel 2.6.18, the .I flags argument was unused, and had to be specified as 0. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR linkat () returns 0. @@ -147,14 +147,14 @@ and .BR linkat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See .BR openat (2) for an explanation of the need for .BR linkat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR link (2), .BR openat (2), .BR path_resolution (7), diff --git a/man2/listen.2 b/man2/listen.2 index 3fe38d101..5305bdc83 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -77,7 +77,7 @@ may receive an error with an indication of .B ECONNREFUSED or, if the underlying protocol supports retransmission, the request may be ignored so that a later reattempt at connection succeeds. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -101,7 +101,7 @@ is not a socket. The socket is not of a type that supports the .BR listen () operation. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, POSIX.1-2001. The .BR listen () @@ -164,7 +164,7 @@ with the value 128. .SH EXAMPLE See .BR bind (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR bind (2), .BR connect (2), diff --git a/man2/listxattr.2 b/man2/listxattr.2 index a02126bcc..ec9dab662 100644 --- a/man2/listxattr.2 +++ b/man2/listxattr.2 @@ -141,7 +141,7 @@ can also occur. .SH VERSIONS These system calls have been available on Linux since kernel 2.4; glibc support is provided since version 2.3. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. .\" .SH AUTHORS .\" Andreas Gruenbacher, diff --git a/man2/llseek.2 b/man2/llseek.2 index 60c6015fb..1a06bbfe2 100644 --- a/man2/llseek.2 +++ b/man2/llseek.2 @@ -57,7 +57,7 @@ or respectively. It returns the resulting file position in the argument .IR result . -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion, .BR _llseek () returns 0. @@ -76,12 +76,12 @@ Problem with copying results to user space. .B EINVAL .I whence is invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is Linux-specific, and should not be used in programs intended to be portable. .SH NOTES Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek (2), .BR lseek64 (3) diff --git a/man2/lookup_dcookie.2 b/man2/lookup_dcookie.2 index 9b96e56d0..6a7d91c99 100644 --- a/man2/lookup_dcookie.2 +++ b/man2/lookup_dcookie.2 @@ -40,7 +40,7 @@ For .BR lookup_dcookie () to return successfully, the kernel must still hold a cookie reference to the directory entry. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR lookup_dcookie () returns the length of the path string copied into the buffer. @@ -75,10 +75,10 @@ Available since Linux 2.5.43. The .B ENAMETOOLONG error return was added in 2.5.70. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR lookup_dcookie () is Linux-specific. -.SH "NOTES" +.SH NOTES .BR lookup_dcookie () is a special-purpose system call, currently used only by the oprofile profiler. It relies on a kernel driver to register cookies for directory entries. diff --git a/man2/lseek.2 b/man2/lseek.2 index 8caaf851a..1051d2b61 100644 --- a/man2/lseek.2 +++ b/man2/lseek.2 @@ -148,7 +148,7 @@ it can be considered to consist of data that is a sequence of zeros). .\" https://lkml.org/lkml/2011/4/22/79 .\" http://lwn.net/Articles/440255/ .\" http://blogs.oracle.com/bonwick/entry/seek_hole_and_seek_data -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion, .BR lseek () returns the resulting offset location as measured in bytes from the @@ -186,7 +186,7 @@ is or .BR SEEK_HOLE , and the current file offset is beyond the end of the file. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .BR SEEK_DATA @@ -231,7 +231,7 @@ or .BR fork (2) share the current file position pointer, so seeking on such files may be subject to race conditions. -.SH "SEE ALSO" +.SH SEE ALSO .BR dup (2), .BR fork (2), .BR open (2), diff --git a/man2/madvise.2 b/man2/madvise.2 index c6c5ef298..397cdc58a 100644 --- a/man2/madvise.2 +++ b/man2/madvise.2 @@ -265,7 +265,7 @@ file (see .BR MADV_DODUMP " (since Linux 3.4)" Undo the effect of an earlier .BR MADV_DONTDUMP . -.SH "RETURN VALUE" +.SH RETURN VALUE On success .BR madvise () returns zero. @@ -322,7 +322,7 @@ Not enough memory: paging in failed. .B ENOMEM Addresses in the specified range are not currently mapped, or are outside the address space of the process. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1b. POSIX.1-2001 describes .BR posix_madvise (3) @@ -368,7 +368,7 @@ from the system call, as it should). .\" The .\" .BR madvise () .\" function first appeared in 4.4BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR getrlimit (2), .BR mincore (2), .BR mmap (2), diff --git a/man2/migrate_pages.2 b/man2/migrate_pages.2 index d5ceb3e12..0c8095b0e 100644 --- a/man2/migrate_pages.2 +++ b/man2/migrate_pages.2 @@ -84,7 +84,7 @@ Pages shared with another process will only be moved if the initiating process has the .B CAP_SYS_NICE privilege. -.SH "RETURN VALUE" +.SH RETURN VALUE On success .BR migrate_pages () returns the number of pages that could not be moved @@ -114,7 +114,7 @@ The system call first appeared on Linux in version 2.6.16. .SH CONFORMING TO This system call is Linux-specific. -.SH "NOTES" +.SH NOTES For information on library support, see .BR numa (7). @@ -144,7 +144,7 @@ The header is not included with glibc, but requires installing .I libnuma-devel or a similar package. -.SH "SEE ALSO" +.SH SEE ALSO .BR get_mempolicy (2), .BR mbind (2), .BR set_mempolicy (2), diff --git a/man2/mincore.2 b/man2/mincore.2 index cf54295b4..3bde3c416 100644 --- a/man2/mincore.2 +++ b/man2/mincore.2 @@ -91,7 +91,7 @@ is only a snapshot: pages that are not locked in memory can come and go at any moment, and the contents of .I vec may already be stale by the time this call returns. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR mincore () returns zero. @@ -131,7 +131,7 @@ to contained unmapped memory. .SH VERSIONS Available since Linux 2.3.99pre1 and glibc 2.2. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR mincore () is not specified in POSIX.1-2001, and it is not available on all UNIX implementations. @@ -163,6 +163,6 @@ mappings, or for nonlinear mappings (established using .\" .B mincore .\" always fails with the error .\" .BR ENOMEM . -.SH "SEE ALSO" +.SH SEE ALSO .BR mlock (2), .BR mmap (2) diff --git a/man2/mkdir.2 b/man2/mkdir.2 index 7682e5fce..3763a18ae 100644 --- a/man2/mkdir.2 +++ b/man2/mkdir.2 @@ -44,7 +44,7 @@ otherwise it will be owned by the effective group ID of the process. If the parent directory has the set-group-ID bit set then so will the newly created directory. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR mkdir () returns zero on success, or \-1 if an error occurred (in which case, .I errno @@ -114,7 +114,7 @@ does not support the creation of directories. .B EROFS .I pathname refers to a file on a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, BSD, POSIX.1-2001. .\" SVr4 documents additional EIO, EMULTIHOP .SH NOTES @@ -129,7 +129,7 @@ See also There are many infelicities in the protocol underlying NFS. Some of these affect .BR mkdir (). -.SH "SEE ALSO" +.SH SEE ALSO .BR mkdir (1), .BR chmod (2), .BR chown (2), diff --git a/man2/mkdirat.2 b/man2/mkdirat.2 index aa73cca60..b70fa4b40 100644 --- a/man2/mkdirat.2 +++ b/man2/mkdirat.2 @@ -86,7 +86,7 @@ If is absolute, then .I dirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR mkdirat () returns 0. @@ -114,14 +114,14 @@ is a file descriptor referring to a file other than a directory. .BR mkdirat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See .BR openat (2) for an explanation of the need for .BR mkdirat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR mkdir (2), .BR openat (2), .BR path_resolution (7) diff --git a/man2/mknod.2 b/man2/mknod.2 index 3cd962a53..96adacfec 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -97,7 +97,7 @@ If the directory containing the node has the set-group-ID bit set, or if the file system is mounted with BSD group semantics, the new node will inherit the group ownership from its parent directory; otherwise it will be owned by the effective group ID of the process. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR mknod () returns zero on success, or \-1 if an error occurred (in which case, .I errno @@ -173,7 +173,7 @@ does not support the type of node requested. .B EROFS .I pathname refers to a file on a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD, POSIX.1-2001 (but see below). .\" The Linux version differs from the SVr4 version in that it .\" does not require root permission to create pipes, also in that no @@ -205,7 +205,7 @@ One should make directories with There are many infelicities in the protocol underlying NFS. Some of these affect .BR mknod (). -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (2), .BR chown (2), .BR fcntl (2), diff --git a/man2/mknodat.2 b/man2/mknodat.2 index 90cbc67e0..c8e607ebb 100644 --- a/man2/mknodat.2 +++ b/man2/mknodat.2 @@ -90,7 +90,7 @@ If is absolute, then .I dirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR mknodat () returns 0. @@ -118,14 +118,14 @@ is a file descriptor referring to a file other than a directory. .BR mknodat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See .BR openat (2) for an explanation of the need for .BR mknodat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR mknod (2), .BR openat (2), .BR path_resolution (7) diff --git a/man2/mlock.2 b/man2/mlock.2 index debe6daf7..33f02a814 100644 --- a/man2/mlock.2 +++ b/man2/mlock.2 @@ -114,7 +114,7 @@ signal to the process. .BR munlockall () unlocks all pages mapped into the address space of the calling process. -.SH "RETURN VALUE" +.SH RETURN VALUE On success these system calls return 0. On error, \-1 is returned, .I errno @@ -184,7 +184,7 @@ For .B EPERM (Linux 2.6.8 and earlier) The caller was not privileged .RB ( CAP_IPC_LOCK ). -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, SVr4. .SH AVAILABILITY On POSIX systems on which @@ -211,7 +211,7 @@ is defined in \fI\fP to a value greater than 0. .\" POSIX.1-2001: It shall be defined to -1 or 0 or 200112L. .\" -1: unavailable, 0: ask using sysconf(). .\" glibc defines it to 1. -.SH "NOTES" +.SH NOTES Memory locking has two main applications: real-time algorithms and high-security data processing. Real-time applications require @@ -302,7 +302,7 @@ that a privileged process can lock and the .B RLIMIT_MEMLOCK soft resource limit instead defines a limit on how much memory an unprivileged process may lock. -.SH "BUGS" +.SH BUGS In the 2.4 series Linux kernels up to and including 2.4.17, a bug caused the .BR mlockall () @@ -327,7 +327,7 @@ resource limit is encountered. .\" http://marc.theaimsgroup.com/?l=linux-kernel&m=113801392825023&w=2 .\" "Rationale for RLIMIT_MEMLOCK" .\" 23 Jan 2006 -.SH "SEE ALSO" +.SH SEE ALSO .BR mmap (2), .BR setrlimit (2), .BR shmctl (2), diff --git a/man2/mmap.2 b/man2/mmap.2 index 6441f6b4f..456f407cb 100644 --- a/man2/mmap.2 +++ b/man2/mmap.2 @@ -372,7 +372,7 @@ with the or .B MS_ASYNC flag, if one occurs. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR mmap () returns a pointer to the mapped area. @@ -482,7 +482,7 @@ Attempted write into a region mapped as read-only. Attempted access to a portion of the buffer that does not correspond to the file (for example, beyond the end of the file, including the case where another process has truncated the file). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD, POSIX.1-2001. .\" SVr4 documents additional error codes ENXIO and ENODEV. .\" SUSv2 documents additional error codes EMFILE and EOVERFLOW. @@ -681,7 +681,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getpagesize (2), .BR mincore (2), .BR mlock (2), diff --git a/man2/mmap2.2 b/man2/mmap2.2 index 1749b3bcb..466cca839 100644 --- a/man2/mmap2.2 +++ b/man2/mmap2.2 @@ -51,7 +51,7 @@ file in 4096-byte units (instead of bytes, as is done by This enables applications that use a 32-bit .I off_t to map large files (up to 2^44 bytes). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR mmap2 () returns a pointer to the mapped area. @@ -74,7 +74,7 @@ can also return any of the errors described in .SH VERSIONS .BR mmap2 () is available since Linux 2.3.31. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. .SH NOTES Nowadays, the glibc @@ -89,7 +89,7 @@ is actually the system page size, rather than 4096 bytes. .\" ia64 can have page sizes ranging from 4kB to 64kB. .\" On cris, it looks like the unit might also be the page size, .\" which is 8192 bytes. -- mtk, June 2007 -.SH "SEE ALSO" +.SH SEE ALSO .BR getpagesize (2), .BR mmap (2), .BR mremap (2), diff --git a/man2/modify_ldt.2 b/man2/modify_ldt.2 index 524060873..3e61dcf13 100644 --- a/man2/modify_ldt.2 +++ b/man2/modify_ldt.2 @@ -96,7 +96,7 @@ In Linux 2.4 and earlier, this structure was named .\" will result in a segmentation violation when trying to access the memory .\" outside of the process address space. The memory protection is enforced .\" at the paging layer. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR modify_ldt () returns either the actual number of bytes read (for reading) @@ -128,11 +128,11 @@ is 1 and the new ldt entry has invalid values. .B ENOSYS .I func is neither 0 nor 1. -.SH "CONFORMING TO" +.SH CONFORMING TO This call is Linux-specific and should not be used in programs intended to be portable. .SH NOTES Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR vm86 (2) diff --git a/man2/mount.2 b/man2/mount.2 index af64547d7..73af6d3df 100644 --- a/man2/mount.2 +++ b/man2/mount.2 @@ -278,7 +278,7 @@ understood by this file system. See .BR mount (8) for details of the options available for each filesystem type. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -388,7 +388,7 @@ and were only added to glibc headers in version 2.12. .\" FIXME: Definitions of the so-far-undocumented MS_UNBINDABLE, MS_PRIVATE, .\" MS_SHARED, and MS_SLAVE were (also) only added to glibc headers in 2.12. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is Linux-specific and should not be used in programs intended to be portable. .SH NOTES @@ -453,7 +453,7 @@ file exposes the list of mount points in the mount namespace of the process with the specified ID; see .BR proc (5) for details. -.SH "SEE ALSO" +.SH SEE ALSO .BR umount (2), .BR path_resolution (7), .BR mount (8), diff --git a/man2/move_pages.2 b/man2/move_pages.2 index 059956b5e..f675e6fe5 100644 --- a/man2/move_pages.2 +++ b/man2/move_pages.2 @@ -138,7 +138,7 @@ The page is not present. .TP .B -ENOMEM Unable to allocate memory on target node. -.SH "RETURN VALUE" +.SH RETURN VALUE On success .BR move_pages () returns zero. @@ -192,7 +192,7 @@ Process does not exist. first appeared on Linux in version 2.6.18. .SH CONFORMING TO This system call is Linux-specific. -.SH "NOTES" +.SH NOTES For information on library support, see .BR numa (7). @@ -222,7 +222,7 @@ The header is not included with glibc, but requires installing .I libnuma-devel or a similar package. -.SH "SEE ALSO" +.SH SEE ALSO .BR get_mempolicy (2), .BR mbind (2), .BR set_mempolicy (2), diff --git a/man2/mprotect.2 b/man2/mprotect.2 index 02aa114cc..83540abb4 100644 --- a/man2/mprotect.2 +++ b/man2/mprotect.2 @@ -74,7 +74,7 @@ The memory can be modified. The memory can be executed. .\" FIXME .\" Document PROT_GROWSUP and PROT_GROWSDOWN -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR mprotect () returns zero. @@ -109,7 +109,7 @@ or specify one or more pages that are not mapped. (Before kernel 2.4.19, the error .BR EFAULT was incorrectly produced for these cases.) -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVr4 defines an additional error .\" code EAGAIN. The SVr4 error conditions don't map neatly onto Linux's. @@ -222,6 +222,6 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR mmap (2), .BR sysconf (3) diff --git a/man2/mq_getsetattr.2 b/man2/mq_getsetattr.2 index cadb72235..d563126a8 100644 --- a/man2/mq_getsetattr.2 +++ b/man2/mq_getsetattr.2 @@ -53,6 +53,6 @@ This interface is nonstandard; avoid its use. Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). (Actually, never call it unless you are writing a C library!) -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_getattr (3), .BR mq_overview (7) diff --git a/man2/mremap.2 b/man2/mremap.2 index ad6f4eb13..a652e90ca 100644 --- a/man2/mremap.2 +++ b/man2/mremap.2 @@ -125,7 +125,7 @@ is locked (using or similar), then this lock is maintained when the segment is resized and/or relocated. As a consequence, the amount of memory locked by the process may change. -.SH "RETURN VALUE" +.SH RETURN VALUE On success .BR mremap () returns a pointer to the new virtual memory area. @@ -183,7 +183,7 @@ The memory area cannot be expanded at the current virtual address, and the .B MREMAP_MAYMOVE flag is not set in \fIflags\fP. Or, there is not enough (virtual) memory available. -.SH "CONFORMING TO" +.SH CONFORMING TO This call is Linux-specific, and should not be used in programs intended to be portable. .\" 4.2BSD had a (never actually implemented) @@ -197,7 +197,7 @@ and the prototype for did not allow for the .I new_address argument. -.SH "SEE ALSO" +.SH SEE ALSO .BR brk (2), .BR getpagesize (2), .BR getrlimit (2), diff --git a/man2/msgctl.2 b/man2/msgctl.2 index a74bb2371..4da4ef91c 100644 --- a/man2/msgctl.2 +++ b/man2/msgctl.2 @@ -221,7 +221,7 @@ However, the argument is not a queue identifier, but instead an index into the kernel's internal array that maintains information about all message queues on the system. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR IPC_STAT , .BR IPC_SET , @@ -306,7 +306,7 @@ of the message queue, and the process is not privileged (Linux: it does not have the .B CAP_SYS_ADMIN capability). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVID does not document the EIDRM error condition. .SH NOTES @@ -347,7 +347,7 @@ a recompilation under glibc-2.1.91 or later should suffice. .B IPC_64 flag in .IR cmd .) -.SH "SEE ALSO" +.SH SEE ALSO .BR msgget (2), .BR msgrcv (2), .BR msgsnd (2), diff --git a/man2/msgget.2 b/man2/msgget.2 index 158525552..b0b0276d9 100644 --- a/man2/msgget.2 +++ b/man2/msgget.2 @@ -132,7 +132,7 @@ is set to the system limit If the message queue already exists the permissions are verified, and a check is made to see if it is marked for destruction. -.SH "RETURN VALUE" +.SH RETURN VALUE If successful, the return value will be the message queue identifier (a nonnegative integer), otherwise \-1 with @@ -178,7 +178,7 @@ A message queue has to be created but the system limit for the maximum number of message queues .RB ( MSGMNI ) would be exceeded. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .SH NOTES The inclusion of @@ -225,7 +225,7 @@ The name choice was perhaps unfortunate, .B IPC_NEW would more clearly show its function. -.SH "SEE ALSO" +.SH SEE ALSO .BR msgctl (2), .BR msgrcv (2), .BR msgsnd (2), diff --git a/man2/msgop.2 b/man2/msgop.2 index fe27c2154..c9653cb00 100644 --- a/man2/msgop.2 +++ b/man2/msgop.2 @@ -282,7 +282,7 @@ is decremented by 1. .IP .I msg_rtime is set to the current time. -.SH "RETURN VALUE" +.SH RETURN VALUE On failure both functions return \-1 with .I errno @@ -394,7 +394,7 @@ was less than 0. was specified in .I msgflg and no message of the requested type existed on the message queue. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .SH NOTES The inclusion of @@ -441,7 +441,7 @@ number of message headers .RB ( MSGTQL ) and for the system wide maximum size in bytes of the message pool .RB ( MSGPOOL ). -.SH "SEE ALSO" +.SH SEE ALSO .BR msgctl (2), .BR msgget (2), .BR capabilities (7), diff --git a/man2/msync.2 b/man2/msync.2 index d5b9ef618..0c44e3d54 100644 --- a/man2/msync.2 +++ b/man2/msync.2 @@ -65,7 +65,7 @@ asks for an update and waits for it to complete. .B MS_INVALIDATE asks to invalidate other mappings of the same file (so that they can be updated with the fresh values just written). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -93,7 +93,7 @@ are set in .TP .B ENOMEM The indicated memory (or part of it) was not mapped. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. This call was introduced in Linux 1.3.21, and then used @@ -115,7 +115,7 @@ are defined in \fI\fP to a value greater than 0. .\" POSIX.1-2001: It shall be defined to -1 or 0 or 200112L. .\" -1: unavailable, 0: ask using sysconf(). .\" glibc defines them to 1. -.SH "SEE ALSO" +.SH SEE ALSO .BR mmap (2) B.O. Gallmeister, POSIX.4, O'Reilly, pp. 128-129 and 389-391. diff --git a/man2/nanosleep.2 b/man2/nanosleep.2 index f1bbcff59..401f8e97b 100644 --- a/man2/nanosleep.2 +++ b/man2/nanosleep.2 @@ -98,7 +98,7 @@ POSIX.1 explicitly specifies that it does not interact with signals; and it makes the task of resuming a sleep that has been interrupted by a signal handler easier. -.SH "RETURN VALUE" +.SH RETURN VALUE On successfully sleeping for the requested interval, .BR nanosleep () returns 0. @@ -125,7 +125,7 @@ The value in the field was not in the range 0 to 999999999 or .I tv_sec was negative. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES If the interval specified in @@ -203,7 +203,7 @@ signal. If the system call is subsequently restarted, then the time that the thread spent in the stopped state is \fInot\fP counted against the sleep interval. -.SH "SEE ALSO" +.SH SEE ALSO .BR clock_nanosleep (2), .BR sched_setscheduler (2), .BR timer_create (2), diff --git a/man2/nfsservctl.2 b/man2/nfsservctl.2 index 634505ade..1b947073b 100644 --- a/man2/nfsservctl.2 +++ b/man2/nfsservctl.2 @@ -48,10 +48,10 @@ union nfsctl_res { unsigned int cr_debug; }; .fi -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno is set appropriately. -.SH "CONFORMING TO" +.SH CONFORMING TO This call is Linux-specific. diff --git a/man2/nice.2 b/man2/nice.2 index f2aaa3f11..ee9cd77c1 100644 --- a/man2/nice.2 +++ b/man2/nice.2 @@ -53,7 +53,7 @@ Only the super\%user may specify a negative increment, or priority increase. The range for nice values is described in .BR getpriority (2). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the new nice value is returned (but see NOTES below). On error, \-1 is returned, and .I errno @@ -72,7 +72,7 @@ capability is required. .B RLIMIT_NICE resource limit in .BR setrlimit (2).) -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. However, the Linux and (g)libc (earlier than glibc 2.2.4) return value is nonstandard, see below. @@ -102,7 +102,7 @@ To reliably detect an error, set to 0 before the call, and check its value when .BR nice () returns \-1. -.SH "SEE ALSO" +.SH SEE ALSO .BR nice (1), .BR renice (1), .BR fork (2), diff --git a/man2/open.2 b/man2/open.2 index ebe608e03..4988791b5 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -474,7 +474,7 @@ with .I flags equal to .BR O_CREAT|O_WRONLY|O_TRUNC . -.SH "RETURN VALUE" +.SH RETURN VALUE .BR open () and .BR creat () @@ -626,7 +626,7 @@ The flag was specified, and an incompatible lease was held on the file (see .BR fcntl (2)). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. The .BR O_DIRECTORY , @@ -898,7 +898,7 @@ use to enable this flag. .\" FIXME . Check bugzilla report on open(O_ASYNC) .\" See http://bugzilla.kernel.org/show_bug.cgi?id=5993 -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (2), .BR chown (2), .BR close (2), diff --git a/man2/openat.2 b/man2/openat.2 index a2bccbd48..9cc9ff838 100644 --- a/man2/openat.2 +++ b/man2/openat.2 @@ -87,7 +87,7 @@ If is absolute, then .I dirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR openat () returns a new file descriptor. @@ -115,7 +115,7 @@ is a file descriptor referring to a file other than a directory. .BR openat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. A similar system call exists on Solaris. .\" The 'at' suffix in Solaris is actually double sensed. It @@ -161,7 +161,7 @@ directory", via file descriptor(s) maintained by the application. on the use of .IR /proc/self/fd/ dirfd, but less efficiently.) -.SH "SEE ALSO" +.SH SEE ALSO .BR faccessat (2), .BR fchmodat (2), .BR fchownat (2), diff --git a/man2/outb.2 b/man2/outb.2 index 014b37fda..360fce0c5 100644 --- a/man2/outb.2 +++ b/man2/outb.2 @@ -87,7 +87,7 @@ to tell the kernel to allow the user space application to access the I/O ports in question. Failure to do this will cause the application to receive a segmentation fault. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR outb () and friends are hardware-specific. The @@ -96,6 +96,6 @@ argument is passed first and the .I port argument is passed second, which is the opposite order from most DOS implementations. -.SH "SEE ALSO" +.SH SEE ALSO .BR ioperm (2), .BR iopl (2) diff --git a/man2/pause.2 b/man2/pause.2 index 892b66f16..b8503c65e 100644 --- a/man2/pause.2 +++ b/man2/pause.2 @@ -39,7 +39,7 @@ pause \- wait for signal causes the calling process (or thread) to sleep until a signal is delivered that either terminates the process or causes the invocation of a signal-catching function. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR pause () only returns when a signal was caught and the signal-catching function returned. @@ -54,9 +54,9 @@ is set to .TP .B EINTR a signal was caught and the signal-catching function returned. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR select (2), .BR signal (2), diff --git a/man2/pciconfig_read.2 b/man2/pciconfig_read.2 index b9949b275..547e2f0a5 100644 --- a/man2/pciconfig_read.2 +++ b/man2/pciconfig_read.2 @@ -44,7 +44,7 @@ value. You pass it a bus/devfn pair and get a physical address for either the memory offset (for things like prep, this is 0xc0000000), the IO base for PIO cycles, or the ISA holes if any. -.SH "RETURN VALUE" +.SH RETURN VALUE .TP .BR pciconfig_read () On success zero is returned. @@ -104,7 +104,7 @@ is invalid. User does not have the \fBCAP_SYS_ADMIN\fP capability. This does not apply to .BR pciconfig_iobase (). -.SH "CONFORMING TO" +.SH CONFORMING TO These calls are Linux-specific, available since Linux 2.0.26/2.1.11. -.SH "SEE ALSO" +.SH SEE ALSO .BR capabilities (7) diff --git a/man2/perf_event_open.2 b/man2/perf_event_open.2 index cbc7d4755..60d007e52 100644 --- a/man2/perf_event_open.2 +++ b/man2/perf_event_open.2 @@ -1929,7 +1929,7 @@ a PMU, but usually a subset of events deemed useful or interesting. .RE -.SH "RETURN VALUE" +.SH RETURN VALUE .BR perf_event_open () returns the new file descriptor, or \-1 if an error occurred (in which case, @@ -2084,7 +2084,7 @@ main(int argc, char **argv) } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fcntl (2), .BR mmap (2), .BR open (2), diff --git a/man2/perfmonctl.2 b/man2/perfmonctl.2 index c74844227..c35c0070a 100644 --- a/man2/perfmonctl.2 +++ b/man2/perfmonctl.2 @@ -186,7 +186,7 @@ Reset PMC registers to default values. .\" .nf .\" .BI "perfmonctl(int " fd ", PFM_GETINFO_EVTSETS, pfarg_setinfo_t *info, n); .\" .fi -.SH "RETURN VALUE" +.SH RETURN VALUE .BR performctl () returns zero when the operation is successful. On error, \-1 is returned and @@ -201,6 +201,6 @@ is Linux specific and is available only on the IA-64 architecture. .SH NOTES Glibc does not provide a wrapper for this system call; call it using .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR gprof(1), .I The perfmon2 interface specification diff --git a/man2/personality.2 b/man2/personality.2 index 36c44de8a..a3c72ccfe 100644 --- a/man2/personality.2 +++ b/man2/personality.2 @@ -52,7 +52,7 @@ Otherwise, it will make the execution domain referenced by .I persona the new execution domain of the calling process. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the previous .I persona is returned. @@ -63,7 +63,7 @@ is set appropriately. .TP .B EINVAL The kernel was unable to change the personality. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR personality () is Linux-specific and should not be used in programs intended to be portable. diff --git a/man2/pipe.2 b/man2/pipe.2 index e3b1fba07..7fefe9cb1 100644 --- a/man2/pipe.2 +++ b/man2/pipe.2 @@ -89,7 +89,7 @@ flag on the two new file descriptors. See the description of the same flag in .BR open (2) for reasons why this may be useful. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -115,7 +115,7 @@ The system limit on the total number of open files has been reached. was added to Linux in version 2.6.27; glibc support is available starting with version 2.9. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR pipe (): POSIX.1-2001. @@ -187,7 +187,7 @@ main(int argc, char *argv[]) } } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fork (2), .BR read (2), .BR socketpair (2), diff --git a/man2/pivot_root.2 b/man2/pivot_root.2 index 54f258bb7..1c1cc8d36 100644 --- a/man2/pivot_root.2 +++ b/man2/pivot_root.2 @@ -95,7 +95,7 @@ mount point of that file system is mounted on \fIput_old\fP. In this case, \fI/proc/mounts\fP will show the mount point of the file system containing \fInew_root\fP as root (\fI/\fP). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and \fIerrno\fP is set appropriately. @@ -122,7 +122,7 @@ capability. .SH VERSIONS .BR pivot_root () was introduced in Linux 2.3.41. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR pivot_root () is Linux-specific and hence is not portable. .SH NOTES @@ -137,7 +137,7 @@ Some of the more obscure uses of .BR pivot_root () may quickly lead to insanity. -.SH "SEE ALSO" +.SH SEE ALSO .BR chdir (2), .BR chroot (2), .BR stat (2), diff --git a/man2/poll.2 b/man2/poll.2 index 58d77060b..c62691e41 100644 --- a/man2/poll.2 +++ b/man2/poll.2 @@ -280,7 +280,7 @@ If is specified as NULL, then .BR ppoll () can block indefinitely. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, a positive number is returned; this is the number of structures which have nonzero .I revents @@ -326,7 +326,7 @@ system call was added to Linux in kernel 2.6.16. The .BR ppoll () library call was added in glibc 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR poll () conforms to POSIX.1-2001. .BR ppoll () @@ -363,7 +363,7 @@ argument. See the discussion of spurious readiness notifications under the BUGS section of .BR select (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR select (2), .BR select_tut (2), .BR time (7) diff --git a/man2/posix_fadvise.2 b/man2/posix_fadvise.2 index 740e69184..cbb29bb8f 100644 --- a/man2/posix_fadvise.2 +++ b/man2/posix_fadvise.2 @@ -83,7 +83,7 @@ The specified data will be accessed in the near future. .TP .B POSIX_FADV_DONTNEED The specified data will not be accessed in the near future. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, an error number is returned. .SH ERRORS @@ -108,7 +108,7 @@ the underlying system call is called Library support has been provided since glibc version 2.2, via the wrapper function .BR posix_fadvise (). -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. Note that the type of the .I len @@ -179,7 +179,7 @@ In kernels before 2.6.6, if .I len was specified as 0, then this was interpreted literally as "zero bytes", rather than as meaning "all bytes through to the end of the file". -.SH "SEE ALSO" +.SH SEE ALSO .BR readahead (2), .BR sync_file_range (2), .BR posix_fallocate (3), diff --git a/man2/prctl.2 b/man2/prctl.2 index 0e930b3de..a0e97a179 100644 --- a/man2/prctl.2 +++ b/man2/prctl.2 @@ -759,7 +759,7 @@ option. .\" ========== END FIXME .RE .\" -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR PR_GET_DUMPABLE , .BR PR_GET_KEEPCAPS , @@ -949,7 +949,7 @@ The .BR prctl () system call was introduced in Linux 2.1.57. .\" The library interface was added in glibc 2.0.6 -.SH "CONFORMING TO" +.SH CONFORMING TO This call is Linux-specific. IRIX has a .BR prctl () @@ -963,6 +963,6 @@ and options to get the maximum number of processes per user, get the maximum number of processors the calling process can use, find out whether a specified process is currently blocked, get or set the maximum stack size, and so on. -.SH "SEE ALSO" +.SH SEE ALSO .BR signal (2), .BR core (5) diff --git a/man2/pread.2 b/man2/pread.2 index e4de8c43e..845e9e02e 100644 --- a/man2/pread.2 +++ b/man2/pread.2 @@ -74,7 +74,7 @@ The file offset is not changed. The file referenced by .I fd must be capable of seeking. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the number of bytes read or written is returned (zero indicates that nothing was written, in the case of .BR pwrite (), @@ -110,7 +110,7 @@ in 2.1.69. C library support (including emulation using .BR lseek (2) on older kernels without the system calls) was added in glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES On Linux, the underlying system calls were renamed @@ -140,7 +140,7 @@ However, on Linux, if a file is opened with .BR pwrite () appends data to the end of the file, regardless of the value of .IR offset . -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek (2), .BR read (2), .BR readv (2), diff --git a/man2/process_vm_readv.2 b/man2/process_vm_readv.2 index 14e030ab0..94249306c 100644 --- a/man2/process_vm_readv.2 +++ b/man2/process_vm_readv.2 @@ -204,7 +204,7 @@ of the remote process must match the real group ID of the caller. .BR ptrace (2) .BR PTRACE_ATTACH on the remote process.) -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR process_vm_readv () returns the number of bytes read and @@ -274,7 +274,7 @@ exists. .SH VERSIONS These system calls were added in Linux 3.2. Support is provided in glibc since version 2.15. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are nonstandard Linux extensions. .SH NOTES The data transfers performed by @@ -326,6 +326,6 @@ main(void) return 0; } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR readv (2), .BR writev (2) diff --git a/man2/ptrace.2 b/man2/ptrace.2 index f571c4c27..583dcd93e 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -1599,7 +1599,7 @@ result, to the real parent (to the real parent only when the whole multithreaded process exits). If the tracer and the real parent are the same process, the report is sent only once. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .B PTRACE_PEEK* requests return the requested data, @@ -1656,7 +1656,7 @@ or (on kernels before 2.6.26) be The specified process does not exist, or is not currently being traced by the caller, or is not stopped (for requests that require a stopped tracee). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD. .SH NOTES Although arguments to @@ -1812,7 +1812,7 @@ again. errors may behave in an unintended way upon an .BR strace (1) attach.) -.SH "SEE ALSO" +.SH SEE ALSO .BR gdb (1), .BR strace (1), .BR clone (2), diff --git a/man2/query_module.2 b/man2/query_module.2 index 6d442d41d..1ada6409a 100644 --- a/man2/query_module.2 +++ b/man2/query_module.2 @@ -124,7 +124,7 @@ etc., that indicates the current status of the module is set to the size of the .I module_info structure. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned and .I errno @@ -167,7 +167,7 @@ is not supported in this version of the kernel This system call is only present on Linux up until kernel 2.4; it was removed in Linux 2.6. .\" Removed in Linux 2.5.48 -.SH "CONFORMING TO" +.SH CONFORMING TO .BR query_module () is Linux-specific. .SH NOTES @@ -182,7 +182,7 @@ and the files under the directory Glibc does not provide a wrapper for this system call; in the unlikely event that you need to use it on an old kernel, use .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR create_module (2), .BR delete_module (2), .BR get_kernel_syms (2), diff --git a/man2/quotactl.2 b/man2/quotactl.2 index 9b7430e72..ee7bdea16 100644 --- a/man2/quotactl.2 +++ b/man2/quotactl.2 @@ -502,7 +502,7 @@ The quota file is corrupted. .TP .B ESRCH Specified quota format was not found. -.SH "SEE ALSO" +.SH SEE ALSO .BR quota (1), .BR getrlimit (2), .BR quotacheck (8), diff --git a/man2/read.2 b/man2/read.2 index d79b49d65..c83195654 100644 --- a/man2/read.2 +++ b/man2/read.2 @@ -78,7 +78,7 @@ If is greater than .BR SSIZE_MAX , the result is unspecified. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the number of bytes read is returned (zero indicates end of file), and the file position is advanced by this number. It is not an error if this number is smaller than the number of bytes @@ -170,7 +170,7 @@ to return \-1 (with set to .BR EINTR ) or to return the number of bytes already read. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES On NFS file systems, reading small amounts of data will only update the @@ -184,7 +184,7 @@ server side reads. UNIX semantics can be obtained by disabling client side attribute caching, but in most situations this will substantially increase server load and decrease performance. -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR fcntl (2), .BR ioctl (2), diff --git a/man2/readahead.2 b/man2/readahead.2 index 4bd2ad600..e4e4dcc0e 100644 --- a/man2/readahead.2 +++ b/man2/readahead.2 @@ -62,7 +62,7 @@ blocks until the specified data has been read. The current file offset of the open file referred to by .I fd is left unchanged. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR readahead () returns 0; on failure, \-1 is returned, with @@ -84,12 +84,12 @@ The .BR readahead () system call appeared in Linux 2.4.13; glibc support has been provided since version 2.3. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR readahead () system call is Linux-specific, and its use should be avoided in portable applications. -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek (2), .BR madvise (2), .BR mmap (2), diff --git a/man2/readdir.2 b/man2/readdir.2 index a47822c8c..a560535c4 100644 --- a/man2/readdir.2 +++ b/man2/readdir.2 @@ -86,7 +86,7 @@ is the size of not counting the terminating null byte. .I d_name is a null-terminated filename. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, 1 is returned. On end of directory, 0 is returned. On error, \-1 is returned, and @@ -109,7 +109,7 @@ No such directory. .TP .B ENOTDIR File descriptor does not refer to a directory. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. .SH NOTES Glibc does not provide a wrapper for this system call; call it using @@ -120,6 +120,6 @@ structure yourself. However, probably you should use .BR readdir (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR getdents (2), .BR readdir (3) diff --git a/man2/readlink.2 b/man2/readlink.2 index 41af6960d..549988be7 100644 --- a/man2/readlink.2 +++ b/man2/readlink.2 @@ -72,7 +72,7 @@ does not append a null byte to It will truncate the contents (to a length of .I bufsiz characters), in case the buffer is too small to hold all of the contents. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR readlink () returns the number of bytes placed in @@ -120,7 +120,7 @@ Insufficient kernel memory was available. .TP .B ENOTDIR A component of the path prefix is not a directory. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD .RB ( readlink () first appeared in 4.2BSD), @@ -209,7 +209,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR readlink (1), .BR lstat (2), .BR readlinkat (2), diff --git a/man2/readlinkat.2 b/man2/readlinkat.2 index 08a92cc8e..5e4e7f127 100644 --- a/man2/readlinkat.2 +++ b/man2/readlinkat.2 @@ -88,7 +88,7 @@ If is absolute, then .I dirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR readlinkat () returns the number of bytes placed in @@ -117,14 +117,14 @@ is a file descriptor referring to a file other than a directory. .BR readlinkat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See .BR openat (2) for an explanation of the need for .BR readlinkat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR openat (2), .BR readlink (2), .BR path_resolution (7) diff --git a/man2/readv.2 b/man2/readv.2 index 65784e8d6..de0ddcccf 100644 --- a/man2/readv.2 +++ b/man2/readv.2 @@ -172,7 +172,7 @@ The file offset is not changed by these system calls. The file referred to by .I fd must be capable of seeking. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR readv () and @@ -209,7 +209,7 @@ permitted maximum. and .BR pwritev () first appeared in Linux 2.6.30; library support was added in glibc 2.10. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR readv (), .BR writev (): 4.4BSD (these system calls first appeared in 4.2BSD), POSIX.1-2001. @@ -279,7 +279,7 @@ iov[1].iov_len = strlen(str1); nwritten = writev(STDOUT_FILENO, iov, 2); .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR pread (2), .BR read (2), .BR write (2) diff --git a/man2/reboot.2 b/man2/reboot.2 index 18524a406..f780c78ad 100644 --- a/man2/reboot.2 +++ b/man2/reboot.2 @@ -145,7 +145,7 @@ For the i386 architecture, the additional argument does not do anything at present (2.1.122), but the type of reboot can be determined by kernel command-line arguments ("reboot=...") to be either warm or cold, and either hard or through the BIOS. -.SH "RETURN VALUE" +.SH RETURN VALUE For the values of .I cmd that stop or restart the system, @@ -173,11 +173,11 @@ The calling process has insufficient privilege to call the .B CAP_SYS_BOOT capability is required. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR reboot () is Linux-specific, and should not be used in programs intended to be portable. -.SH "SEE ALSO" +.SH SEE ALSO .BR sync (2), .BR bootparam (7), .BR capabilities (7), diff --git a/man2/recv.2 b/man2/recv.2 index f58d9c6cb..710ed973d 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -383,7 +383,7 @@ is returned to indicate that expedited or out-of-band data were received. .B MSG_ERRQUEUE indicates that no data was received but an extended error from the socket error queue. -.SH "RETURN VALUE" +.SH RETURN VALUE These calls return the number of bytes received, or \-1 if an error occurred. The return value will be 0 when the @@ -440,7 +440,7 @@ and The argument .I sockfd does not refer to a socket. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD (these function calls first appeared in 4.2BSD), POSIX.1-2001. .LP @@ -490,7 +490,7 @@ An example of the use of .BR recvfrom () is shown in .BR getaddrinfo (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR fcntl (2), .BR getsockopt (2), .BR read (2), diff --git a/man2/remap_file_pages.2 b/man2/remap_file_pages.2 index f96f59490..c7e49c051 100644 --- a/man2/remap_file_pages.2 +++ b/man2/remap_file_pages.2 @@ -119,7 +119,7 @@ argument has the same meaning as for but all flags other than .B MAP_NONBLOCK are ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR remap_file_pages () returns 0. @@ -148,11 +148,11 @@ The .BR remap_file_pages () system call appeared in Linux 2.5.46; glibc support was added in version 2.3.3. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR remap_file_pages () system call is Linux-specific. -.SH "SEE ALSO" +.SH SEE ALSO .BR getpagesize (2), .BR mmap (2), .BR mmap2 (2), diff --git a/man2/removexattr.2 b/man2/removexattr.2 index 2ce150318..e9cfe6d4b 100644 --- a/man2/removexattr.2 +++ b/man2/removexattr.2 @@ -101,7 +101,7 @@ can also occur. .SH VERSIONS These system calls have been available on Linux since kernel 2.4; glibc support is provided since version 2.3. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. .\" .SH AUTHORS .\" Andreas Gruenbacher, diff --git a/man2/rename.2 b/man2/rename.2 index 23843c585..bd7cd2e37 100644 --- a/man2/rename.2 +++ b/man2/rename.2 @@ -88,7 +88,7 @@ If refers to a symbolic link the link is renamed; if .I newpath refers to a symbolic link the link will be overwritten. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -229,7 +229,7 @@ are not on the same mounted file system. .BR rename () does not work across different mount points, even if the same file system is mounted on both.) -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, C89, C99, POSIX.1-2001. .SH BUGS On NFS file systems, you can not assume that if the operation @@ -242,7 +242,7 @@ deal with this. See .BR link (2) for a similar problem. -.SH "SEE ALSO" +.SH SEE ALSO .BR mv (1), .BR chmod (2), .BR link (2), diff --git a/man2/renameat.2 b/man2/renameat.2 index 7d9e62de1..9bfbd5788 100644 --- a/man2/renameat.2 +++ b/man2/renameat.2 @@ -95,7 +95,7 @@ is as for except that a relative pathname is interpreted relative to the directory referred to by the file descriptor .IR newdirfd . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR renameat () returns 0. @@ -129,14 +129,14 @@ and .BR renameat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See .BR openat (2) for an explanation of the need for .BR renameat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR openat (2), .BR rename (2), .BR path_resolution (7) diff --git a/man2/rmdir.2 b/man2/rmdir.2 index 8455d5cbf..a6c00e2fd 100644 --- a/man2/rmdir.2 +++ b/man2/rmdir.2 @@ -37,7 +37,7 @@ rmdir \- delete a directory .SH DESCRIPTION .BR rmdir () deletes a directory, which must be empty. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -124,12 +124,12 @@ does not support the removal of directories. .B EROFS .I pathname refers to a directory on a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH BUGS Infelicities in the protocol underlying NFS can cause the unexpected disappearance of directories which are still being used. -.SH "SEE ALSO" +.SH SEE ALSO .BR rm (1), .BR rmdir (1), .BR chdir (2), diff --git a/man2/rt_sigqueueinfo.2 b/man2/rt_sigqueueinfo.2 index 0fa6cf919..2d6269bac 100644 --- a/man2/rt_sigqueueinfo.2 +++ b/man2/rt_sigqueueinfo.2 @@ -124,7 +124,7 @@ a thread group ID, and .IR tid , a thread in that thread group. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these system calls return 0. On error, they return \-1 and .I errno @@ -171,7 +171,7 @@ system call was added to Linux in version 2.2. The .BR rt_tgsigqueueinfo () system call was added to Linux in version 2.6.31. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. .SH NOTES Since these system calls are not intended for application use, @@ -183,7 +183,7 @@ As with .BR kill (2), the null signal (0) can be used to check if the specified process or thread exists. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR sigaction (2), .BR sigprocmask (2), diff --git a/man2/sched_get_priority_max.2 b/man2/sched_get_priority_max.2 index 936e6fcc3..2c1396930 100644 --- a/man2/sched_get_priority_max.2 +++ b/man2/sched_get_priority_max.2 @@ -84,7 +84,7 @@ and are available define .B _POSIX_PRIORITY_SCHEDULING in \fI\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sched_get_priority_max () and @@ -98,9 +98,9 @@ is set appropriately. .TP .B EINVAL The argument \fIpolicy\fP does not identify a defined scheduling policy. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .ad l .nh .BR sched_getaffinity (2), diff --git a/man2/sched_rr_get_interval.2 b/man2/sched_rr_get_interval.2 index a73a00723..973d68d7b 100644 --- a/man2/sched_rr_get_interval.2 +++ b/man2/sched_rr_get_interval.2 @@ -71,7 +71,7 @@ is zero, the time quantum for the calling process is written into .\" The round-robin time quantum value is not alterable under Linux .\" 1.3.81. .\" -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sched_rr_get_interval () returns 0. @@ -92,7 +92,7 @@ The system call is not yet implemented (only on rather old kernels). .B ESRCH Could not find a process with the ID .IR pid . -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES POSIX systems on which @@ -123,7 +123,7 @@ quantum cannot be modified. .\" returns with error .\" ENOSYS, because SCHED_RR has not yet been fully implemented and tested .\" properly. -.SH "SEE ALSO" +.SH SEE ALSO .BR sched_setscheduler (2) has a description of the Linux scheduling scheme. .PP diff --git a/man2/sched_setaffinity.2 b/man2/sched_setaffinity.2 index b369b5346..a0f94ee22 100644 --- a/man2/sched_setaffinity.2 +++ b/man2/sched_setaffinity.2 @@ -105,7 +105,7 @@ argument specifies the size (in bytes) of If .I pid is zero, then the mask of the calling process is returned. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sched_setaffinity () and @@ -157,9 +157,9 @@ In glibc 2.3.3, the .I cpusetsize argument was removed, but was then restored in glibc 2.3.4, with type .IR size_t . -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. -.SH "NOTES" +.SH NOTES After a call to .BR sched_setaffinity (), the set of CPUs on which the process will actually run is @@ -212,7 +212,7 @@ system call returns the size (in bytes) of the .I cpumask_t data type that is used internally by the kernel to represent the CPU set bit mask. -.SH "SEE ALSO" +.SH SEE ALSO .ad l .nh .BR taskset (1), diff --git a/man2/sched_setparam.2 b/man2/sched_setparam.2 index 7a10e10e7..a70157634 100644 --- a/man2/sched_setparam.2 +++ b/man2/sched_setparam.2 @@ -85,7 +85,7 @@ and are available define .B _POSIX_PRIORITY_SCHEDULING in \fI\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sched_setparam () and @@ -108,7 +108,7 @@ capability). .TP .B ESRCH The process whose ID is \fIpid\fP could not be found. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES .PP @@ -116,7 +116,7 @@ Scheduling parameters are in fact per-thread attributes on Linux; see .BR sched_setscheduler (2). -.SH "SEE ALSO" +.SH SEE ALSO .ad l .nh .BR getpriority (2), diff --git a/man2/sched_setscheduler.2 b/man2/sched_setscheduler.2 index b459ceef9..3029bdcd5 100644 --- a/man2/sched_setscheduler.2 +++ b/man2/sched_setscheduler.2 @@ -420,7 +420,7 @@ and are available define .B _POSIX_PRIORITY_SCHEDULING in \fI\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sched_setscheduler () returns zero. @@ -442,7 +442,7 @@ The calling process does not have appropriate privileges. .TP .B ESRCH The process whose ID is \fIpid\fP could not be found. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001 (but see BUGS below). The \fBSCHED_BATCH\fP and \fBSCHED_IDLE\fP policies are Linux-specific. .SH NOTES @@ -536,7 +536,7 @@ Linux .BR sched_setscheduler () does not conform to this requirement, since it always returns 0 on success. -.SH "SEE ALSO" +.SH SEE ALSO .ad l .nh .BR chrt (1), diff --git a/man2/sched_yield.2 b/man2/sched_yield.2 index 834ab4e81..c6c9cb908 100644 --- a/man2/sched_yield.2 +++ b/man2/sched_yield.2 @@ -39,7 +39,7 @@ sched_yield \- yield the processor causes the calling thread to relinquish the CPU. The thread is moved to the end of the queue for its static priority and a new thread gets to run. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sched_yield () returns 0. @@ -50,7 +50,7 @@ is set appropriately. In the Linux implementation, .BR sched_yield () always succeeds. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES If the calling thread is the only thread in the highest @@ -76,7 +76,7 @@ unnecessarily or inappropriately schedulable threads are still held by the caller), since doing so will result in unnecessary context switches, which will degrade system performance. -.SH "SEE ALSO" +.SH SEE ALSO .BR sched_setscheduler (2) for a description of Linux scheduling .PP diff --git a/man2/select.2 b/man2/select.2 index 1db2ef906..0efbb1148 100644 --- a/man2/select.2 +++ b/man2/select.2 @@ -286,7 +286,7 @@ returns. .\" On BSD, when a timeout occurs, the file descriptor bits are not changed. .\" - it is certainly true that: .\" Linux follows SUSv2 and sets the bit masks to zero upon a timeout. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR select () and @@ -328,7 +328,7 @@ was added to Linux in kernel 2.6.16. Prior to this, .BR pselect () was emulated in glibc (but see BUGS). -.SH "CONFORMING TO" +.SH CONFORMING TO .BR select () conforms to POSIX.1-2001 and 4.4BSD @@ -571,7 +571,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR connect (2), .BR poll (2), diff --git a/man2/semctl.2 b/man2/semctl.2 index bf08e4c3a..a71facc0a 100644 --- a/man2/semctl.2 +++ b/man2/semctl.2 @@ -335,7 +335,7 @@ If the changes to semaphore values would permit blocked .BR semop (2) calls in other processes to proceed, then those processes are woken up. The calling process must have alter permission on the semaphore set. -.SH "RETURN VALUE" +.SH RETURN VALUE On failure .BR semctl () returns \-1 @@ -457,7 +457,7 @@ and the value to which is to be set (for some semaphore of the set) is less than 0 or greater than the implementation limit .BR SEMVMX . -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVr4 documents more error conditions EINVAL and EOVERFLOW. .SH NOTES @@ -519,7 +519,7 @@ implementation dependent (32767). For greater portability it is best to always call .BR semctl () with four arguments. -.SH "SEE ALSO" +.SH SEE ALSO .BR ipc (2), .BR semget (2), .BR semop (2), diff --git a/man2/semget.2 b/man2/semget.2 index a216c21a3..48a7483c0 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -152,7 +152,7 @@ and less than or equal to the maximum number of semaphores per semaphore set If the semaphore set already exists, the permissions are verified. .\" and a check is made to see if it is marked for destruction. -.SH "RETURN VALUE" +.SH RETURN VALUE If successful, the return value will be the semaphore set identifier (a nonnegative integer), otherwise \-1 is returned, with @@ -214,7 +214,7 @@ number of semaphore sets or the system wide maximum number of semaphores .RB ( SEMMNS ), would be exceeded. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVr4 documents additional error conditions EFBIG, E2BIG, EAGAIN, .\" ERANGE, EFAULT. @@ -289,7 +289,7 @@ in the associated data structure retrieved by a .BR semctl (2) .B IPC_STAT operation can be used to avoid races.) -.SH "SEE ALSO" +.SH SEE ALSO .BR semctl (2), .BR semop (2), .BR ftok (3), diff --git a/man2/semop.2 b/man2/semop.2 index bdf2ddcb0..74af6e992 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -309,7 +309,7 @@ then .BR semtimedop () behaves exactly like .BR semop (). -.SH "RETURN VALUE" +.SH RETURN VALUE If successful .BR semop () and @@ -397,7 +397,7 @@ and was subsequently backported into kernel 2.4.22. Glibc support for .BR semtimedop () first appeared in version 2.3.3. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVr4 documents additional error conditions EINVAL, EFBIG, ENOSPC. .SH NOTES @@ -526,7 +526,7 @@ and then increment the semaphore value by one. exit(EXIT_FAILURE); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR semctl (2), .BR semget (2), diff --git a/man2/send.2 b/man2/send.2 index 87138f287..5760c1a47 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -270,7 +270,7 @@ see .\" Send file descriptors and user credentials using the .\" msg_control* fields. .\" The flags returned in msg_flags. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these calls return the number of characters sent. On error, \-1 is returned, and .I errno @@ -363,7 +363,7 @@ will also receive a unless .B MSG_NOSIGNAL is set. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, SVr4, POSIX.1-2001. These function calls appeared in 4.2BSD. .LP @@ -419,7 +419,7 @@ An example of the use of .BR sendto () is shown in .BR getaddrinfo (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR fcntl (2), .BR getsockopt (2), .BR recv (2), diff --git a/man2/sendfile.2 b/man2/sendfile.2 index 3cf680f61..ace201d33 100644 --- a/man2/sendfile.2 +++ b/man2/sendfile.2 @@ -101,7 +101,7 @@ Since Linux 2.6.33 it can be any file. If it is a regular file, then .BR sendfile () changes the file offset appropriately. -.SH "RETURN VALUE" +.SH RETURN VALUE If the transfer was successful, the number of bytes written to .I out_fd is returned. @@ -141,7 +141,7 @@ is a new feature in Linux 2.2. The include file .I is present since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO Not specified in POSIX.1-2001, or other standards. Other UNIX systems implement @@ -190,7 +190,7 @@ The Linux-specific .BR splice (2) call supports transferring data between arbitrary files (e.g., a pair of sockets). -.SH "SEE ALSO" +.SH SEE ALSO .BR mmap (2), .BR open (2), .BR socket (2), diff --git a/man2/set_thread_area.2 b/man2/set_thread_area.2 index 7152be7c0..681b5808b 100644 --- a/man2/set_thread_area.2 +++ b/man2/set_thread_area.2 @@ -7,7 +7,7 @@ .TH SET_THREAD_AREA 2 2012-07-13 "Linux" "Linux Programmer's Manual" .SH NAME set_thread_area \- set a thread local storage (TLS) area -.SH "SYNOPSIS" +.SH SYNOPSIS .B #include .br .B #include @@ -16,7 +16,7 @@ set_thread_area \- set a thread local storage (TLS) area .IR Note : There is no glibc wrapper for this system call; see NOTES. -.SH "DESCRIPTION" +.SH DESCRIPTION .BR set_thread_area () sets an entry in the current thread's thread-local storage (TLS) array. The TLS array entry set by @@ -40,12 +40,12 @@ If finds a free TLS entry, the value of .I u_info\->entry_number is set upon return to show which entry was changed. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR set_thread_area () returns 0 on success, and \-1 on failure, with .I errno set appropriately. -.SH "ERRORS" +.SH ERRORS .TP .B EINVAL \fIu_info\->entry_number\fP is out of bounds. @@ -55,11 +55,11 @@ set appropriately. .TP .B ESRCH A free TLS entry could not be located. -.SH "VERSIONS" +.SH VERSIONS A version of .BR set_thread_area () first appeared in Linux 2.5.29. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR set_thread_area () is Linux-specific and should not be used in programs that are intended to be portable. @@ -68,5 +68,5 @@ Glibc does not provide a wrapper for this system call, since it is generally intended only for use by threading libraries. In the unlikely event that you want to call it directly, use .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR get_thread_area (2) diff --git a/man2/set_tid_address.2 b/man2/set_tid_address.2 index d1adc0dbb..e11ac444c 100644 --- a/man2/set_tid_address.2 +++ b/man2/set_tid_address.2 @@ -83,7 +83,7 @@ and the kernel performs the following operation: The effect of this operation is to wake a single process that is performing a futex wait on the memory location. Errors from the futex wake operation are ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR set_tid_address () always returns the PID of the calling process. .SH ERRORS @@ -92,8 +92,8 @@ always succeeds. .SH VERSIONS This call is present since Linux 2.5.48. Details as given here are valid since Linux 2.5.49. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR futex (2) diff --git a/man2/seteuid.2 b/man2/seteuid.2 index b4b76c2f5..7efd7d8ed 100644 --- a/man2/seteuid.2 +++ b/man2/seteuid.2 @@ -62,7 +62,7 @@ with "group" instead of "user". .\" equals \-1, nothing is changed. .\" (This is an artifact of the implementation in glibc of seteuid() .\" using setresuid(2).) -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -86,7 +86,7 @@ and .IR egid ) is not the real user (group) ID, the effective user (group) ID, or the saved set-user-ID (saved set-group-ID). -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH NOTES Setting the effective user (group) ID to the @@ -119,7 +119,7 @@ need not permit .RI ( egid ) to be the same value as the current effective user (group) ID, and some implementations do not permit this. -.SH "SEE ALSO" +.SH SEE ALSO .BR geteuid (2), .BR setresuid (2), .BR setreuid (2), diff --git a/man2/setfsgid.2 b/man2/setfsgid.2 index a5f789a50..09ea41be9 100644 --- a/man2/setfsgid.2 +++ b/man2/setfsgid.2 @@ -64,7 +64,7 @@ will only succeed if the caller is the superuser or if matches either the real group ID, effective group ID, saved set-group-ID, or the current value of .IR fsgid . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the previous value of .I fsgid is returned. @@ -75,7 +75,7 @@ is returned. This system call is present in Linux since version 1.2. .\" This system call is present since Linux 1.1.44 .\" and in libc since libc 4.7.6. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR setfsgid () is Linux-specific and should not be used in programs intended to be portable. @@ -107,7 +107,7 @@ least, should be returned when the call fails (because the caller lacks the .B CAP_SETGID capability). -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR setfsuid (2), .BR capabilities (7), diff --git a/man2/setfsuid.2 b/man2/setfsuid.2 index cda8e2241..7f97eda6a 100644 --- a/man2/setfsuid.2 +++ b/man2/setfsuid.2 @@ -64,7 +64,7 @@ will only succeed if the caller is the superuser or if matches either the real user ID, effective user ID, saved set-user-ID, or the current value of .IR fsuid . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the previous value of .I fsuid is returned. @@ -75,7 +75,7 @@ is returned. This system call is present in Linux since version 1.2. .\" This system call is present since Linux 1.1.44 .\" and in libc since libc 4.7.6. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR setfsuid () is Linux-specific and should not be used in programs intended to be portable. @@ -107,7 +107,7 @@ least, should be returned when the call fails (because the caller lacks the .B CAP_SETUID capability). -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR setfsgid (2), .BR capabilities (7), diff --git a/man2/setgid.2 b/man2/setgid.2 index 1d37b8f33..2bb86c9e3 100644 --- a/man2/setgid.2 +++ b/man2/setgid.2 @@ -48,7 +48,7 @@ This allows a set-group-ID program that is not set-user-ID-root to drop all of its group privileges, do some un-privileged work, and then reengage the original effective group ID in a secure manner. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -61,7 +61,7 @@ The calling process is not privileged (does not have the .I gid does not match the real group ID or saved set-group-ID of the calling process. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .SH NOTES The original Linux @@ -73,7 +73,7 @@ supporting 32-bit IDs. The glibc .BR setgid () wrapper function transparently deals with the variation across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getgid (2), .BR setegid (2), .BR setregid (2), diff --git a/man2/setpgid.2 b/man2/setpgid.2 index c42cf502b..9471cbf1e 100644 --- a/man2/setpgid.2 +++ b/man2/setpgid.2 @@ -167,7 +167,7 @@ call, which takes a single .I pid argument, is equivalent to .IR "getpgid(pid)" . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR setpgid () and @@ -222,7 +222,7 @@ For .BR setpgid (): .I pid is not the calling process and not a child of the calling process. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR setpgid () and the version of .BR getpgrp () @@ -312,7 +312,7 @@ every member of process group is either itself also a member of the process group or is a member of a process group in a different session (see also .BR credentials (7)). -.SH "SEE ALSO" +.SH SEE ALSO .BR getuid (2), .BR setsid (2), .BR tcgetpgrp (3), diff --git a/man2/setresuid.2 b/man2/setresuid.2 index 3dbcbf3a5..274a7e0a0 100644 --- a/man2/setresuid.2 +++ b/man2/setresuid.2 @@ -61,7 +61,7 @@ sets the real GID, effective GID, and saved set-group-ID of the calling process (and always modifies the file system GID to be the same as the effective GID), with the same restrictions for unprivileged processes. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -80,7 +80,7 @@ The calling process is not privileged (did not have the \fBCAP_SETUID\fP capability) and tried to change the IDs to values that are not permitted. .SH VERSIONS These calls are available under Linux since Linux 2.1.44. -.SH "CONFORMING TO" +.SH CONFORMING TO These calls are nonstandard; they also appear on HP-UX and some of the BSDs. .SH NOTES @@ -103,7 +103,7 @@ The glibc and .BR setresgid () wrapper functions transparently deal with the variations across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getresuid (2), .BR getuid (2), .BR setfsgid (2), diff --git a/man2/setreuid.2 b/man2/setreuid.2 index 3b61f461f..495398ccc 100644 --- a/man2/setreuid.2 +++ b/man2/setreuid.2 @@ -86,7 +86,7 @@ Completely analogously, .BR setregid () sets real and effective group ID's of the calling process, and all of the above holds with "group" instead of "user". -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -108,7 +108,7 @@ swapping the effective user (group) ID with the real user (group) ID, or (ii) setting one to the value of the other or (iii) setting the effective user (group) ID to the value of the saved set-user-ID (saved set-group-ID) was specified. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, 4.3BSD (the .BR setreuid () and @@ -154,7 +154,7 @@ The glibc and .BR setregid () wrapper functions transparently deal with the variations across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getgid (2), .BR getuid (2), .BR seteuid (2), diff --git a/man2/setsid.2 b/man2/setsid.2 index f28e9cb35..50350b6e9 100644 --- a/man2/setsid.2 +++ b/man2/setsid.2 @@ -47,7 +47,7 @@ The process group ID and session ID of the calling process are set to the PID of the calling process. The calling process will be the only process in this new process group and in this new session. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the (new) session ID of the calling process is returned. On error, .I "(pid_t)\ \-1" @@ -61,7 +61,7 @@ The process group ID of any process equals the PID of the calling process. Thus, in particular, .BR setsid () fails if the calling process is already a process group leader. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .SH NOTES A child created via @@ -80,7 +80,7 @@ and .BR _exit (2), and have the child do .BR setsid (). -.SH "SEE ALSO" +.SH SEE ALSO .BR setsid (1), .BR getsid (2), .BR setpgid (2), diff --git a/man2/setuid.2 b/man2/setuid.2 index 0a1e1a1d3..739f0ed6e 100644 --- a/man2/setuid.2 +++ b/man2/setuid.2 @@ -65,7 +65,7 @@ root privileges afterward cannot use .BR setuid (). You can accomplish this with .BR seteuid (2). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -87,7 +87,7 @@ The user is not privileged (Linux: does not have the capability) and .I uid does not match the real UID or saved set-user-ID of the calling process. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. Not quite compatible with the 4.4BSD call, which sets all of the real, saved, and effective user IDs. @@ -115,7 +115,7 @@ supporting 32-bit IDs. The glibc .BR setuid () wrapper function transparently deals with the variation across kernel versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR getuid (2), .BR seteuid (2), .BR setfsuid (2), diff --git a/man2/setup.2 b/man2/setup.2 index 8d112dc4d..83ad12091 100644 --- a/man2/setup.2 +++ b/man2/setup.2 @@ -50,7 +50,7 @@ No user process may call Any user process, even a process with superuser permission, will receive .BR EPERM . -.SH "RETURN VALUE" +.SH RETURN VALUE .BR setup () always returns \-1 for a user process. .SH ERRORS @@ -59,7 +59,7 @@ always returns \-1 for a user process. Always, for a user process. .SH VERSIONS Since Linux 2.1.121, no such function exists anymore. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is Linux-specific, and should not be used in programs intended to be portable, or indeed in any programs at all. .SH NOTES diff --git a/man2/setxattr.2 b/man2/setxattr.2 index 2b5e899b5..c64d13858 100644 --- a/man2/setxattr.2 +++ b/man2/setxattr.2 @@ -143,7 +143,7 @@ can also occur. .SH VERSIONS These system calls have been available on Linux since kernel 2.4; glibc support is provided since version 2.3. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls are Linux-specific. .\" .SH AUTHORS .\" Andreas Gruenbacher, diff --git a/man2/shmctl.2 b/man2/shmctl.2 index 25eb9cc1e..928f67f33 100644 --- a/man2/shmctl.2 +++ b/man2/shmctl.2 @@ -269,7 +269,7 @@ resource limit (see .\" be applied to a segment, regardless of ownership of the segment. .\" This was a botch-up in the move to RLIMIT_MEMLOCK, and was fixed .\" in 2.6.10. MTK, May 2005 -.SH "RETURN VALUE" +.SH RETURN VALUE A successful .B IPC_INFO or @@ -363,7 +363,7 @@ capability). (Since Linux 2.6.9, this error can also occur if the .B RLIMIT_MEMLOCK is 0 and the caller is not privileged.) -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVr4 documents additional error conditions EINVAL, .\" ENOENT, ENOSPC, ENOMEM, EEXIST. Neither SVr4 nor SVID documents @@ -413,7 +413,7 @@ a recompilation under glibc-2.1.91 or later should suffice. .B IPC_64 flag in .IR cmd .) -.SH "SEE ALSO" +.SH SEE ALSO .BR mlock (2), .BR setrlimit (2), .BR shmget (2), diff --git a/man2/shmget.2 b/man2/shmget.2 index bb1eaaa44..4e294826e 100644 --- a/man2/shmget.2 +++ b/man2/shmget.2 @@ -175,7 +175,7 @@ is set to the current time. .PP If the shared memory segment already exists, the permissions are verified, and a check is made to see if it is marked for destruction. -.SH "RETURN VALUE" +.SH RETURN VALUE A valid segment identifier, .IR shmid , is returned on success, \-1 on error. @@ -226,7 +226,7 @@ The flag was specified, but the caller was not privileged (did not have the .B CAP_IPC_LOCK capability). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVr4 documents an additional error condition EEXIST. @@ -300,7 +300,7 @@ The name choice was perhaps unfortunate, .B IPC_NEW would more clearly show its function. -.SH "SEE ALSO" +.SH SEE ALSO .BR shmat (2), .BR shmctl (2), .BR shmdt (2), diff --git a/man2/shmop.2 b/man2/shmop.2 index c22ab97d3..c55b267e8 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -166,7 +166,7 @@ all attached shared memory segments are detached from the process. Upon .BR _exit (2) all attached shared memory segments are detached from the process. -.SH "RETURN VALUE" +.SH RETURN VALUE On success .BR shmat () returns the address of the attached shared memory segment; on error @@ -226,7 +226,7 @@ or, .\" The following since 2.6.17-rc1: .I shmaddr is not aligned on a page boundary. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .\" SVr4 documents an additional error condition EMFILE. @@ -282,7 +282,7 @@ value is The implementation places no intrinsic limit on the per-process maximum number of shared memory segments .RB ( SHMSEG ). -.SH "SEE ALSO" +.SH SEE ALSO .BR brk (2), .BR mmap (2), .BR shmctl (2), diff --git a/man2/shutdown.2 b/man2/shutdown.2 index 38c18b3c6..45f48dff5 100644 --- a/man2/shutdown.2 +++ b/man2/shutdown.2 @@ -64,7 +64,7 @@ If is .BR SHUT_RDWR , further receptions and transmissions will be disallowed. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -86,7 +86,7 @@ The specified socket is not connected. .B ENOTSOCK .I sockfd is a file, not a socket. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, 4.4BSD (the .BR shutdown () function call first appeared in 4.2BSD). @@ -108,7 +108,7 @@ are done in domain-specific code, and not all domains perform these checks. .\" https://bugzilla.kernel.org/show_bug.cgi?id=47111 Most notably, UNIX domain sockets simply ignore invalid values; this may change in the future. -.SH "SEE ALSO" +.SH SEE ALSO .BR connect (2), .BR socket (2), .BR socket (7) diff --git a/man2/sigaction.2 b/man2/sigaction.2 index 87ccbcc27..379cc2ccc 100644 --- a/man2/sigaction.2 +++ b/man2/sigaction.2 @@ -655,7 +655,7 @@ high priority input available .B POLL_HUP device disconnected .RE -.SH "RETURN VALUE" +.SH RETURN VALUE .BR sigaction () returns 0 on success and \-1 on error. .SH ERRORS @@ -670,7 +670,7 @@ This will also be generated if an attempt is made to change the action for .BR SIGKILL " or " SIGSTOP ", " which cannot be caught or ignored. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, SVr4. .\" SVr4 does not document the EINTR condition. .SH NOTES @@ -786,7 +786,7 @@ This bug was fixed in kernel 2.6.14. .SH EXAMPLE See .BR mprotect (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (1), .BR kill (2), .BR killpg (2), diff --git a/man2/sigaltstack.2 b/man2/sigaltstack.2 index 235e3accc..30e3cce3a 100644 --- a/man2/sigaltstack.2 +++ b/man2/sigaltstack.2 @@ -128,7 +128,7 @@ currently executing on it.) .TP .B SS_DISABLE The alternate signal stack is currently disabled. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR sigaltstack () returns 0 on success, or \-1 on failure with \fIerrno\fP set to indicate the error. @@ -151,7 +151,7 @@ The specified size of the new alternate signal stack An attempt was made to change the alternate signal stack while it was active (i.e., the process was already executing on the current alternate signal stack). -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv2, SVr4, POSIX.1-2001. .SH NOTES The most common usage of an alternate signal stack is to handle the @@ -227,7 +227,7 @@ if (sigaltstack(&ss, NULL) == \-1) /* Handle error */; .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR execve (2), .BR setrlimit (2), .BR sigaction (2), diff --git a/man2/signal.2 b/man2/signal.2 index 6edb895ab..06477e346 100644 --- a/man2/signal.2 +++ b/man2/signal.2 @@ -92,7 +92,7 @@ The signals and .B SIGSTOP cannot be caught or ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR signal () returns the previous value of the signal handler, or .B SIG_ERR @@ -102,7 +102,7 @@ on error. .B EINVAL .I signum is invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001. .SH NOTES The effects of @@ -270,7 +270,7 @@ instead of then .BR signal () provides BSD semantics. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (1), .BR alarm (2), .BR kill (2), diff --git a/man2/signalfd.2 b/man2/signalfd.2 index 3fb14111b..b2ff84648 100644 --- a/man2/signalfd.2 +++ b/man2/signalfd.2 @@ -247,7 +247,7 @@ itself and the signals that are directed to the process (i.e., the entire thread group). (A thread will not be able to read signals that are directed to other threads in the process.) -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR signalfd () returns a signalfd file descriptor; @@ -429,7 +429,7 @@ main(int argc, char *argv[]) } } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR eventfd (2), .BR poll (2), .BR read (2), diff --git a/man2/sigpending.2 b/man2/sigpending.2 index c17de6868..6fa74fa9e 100644 --- a/man2/sigpending.2 +++ b/man2/sigpending.2 @@ -48,7 +48,7 @@ returns the set of signals that are pending for delivery to the calling thread (i.e., the signals which have been raised while blocked). The mask of pending signals is returned in .IR set . -.SH "RETURN VALUE" +.SH RETURN VALUE .BR sigpending () returns 0 on success and \-1 on error. .SH ERRORS @@ -56,7 +56,7 @@ returns 0 on success and \-1 on error. .B EFAULT .I set points to memory which is not a valid part of the process address space. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES See @@ -79,7 +79,7 @@ there is a bug in the wrapper function for .BR sigpending () which means that information about pending real-time signals is not correctly returned. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR sigaction (2), .BR signal (2), diff --git a/man2/sigprocmask.2 b/man2/sigprocmask.2 index 3f7935610..1fa0bfb27 100644 --- a/man2/sigprocmask.2 +++ b/man2/sigprocmask.2 @@ -88,7 +88,7 @@ The use of .BR sigprocmask () is unspecified in a multithreaded process; see .BR pthread_sigmask (3). -.SH "RETURN VALUE" +.SH RETURN VALUE .BR sigprocmask () returns 0 on success and \-1 on error. .SH ERRORS @@ -104,7 +104,7 @@ argument points outside the process's allocated address space. The value specified in .I how was invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES It is not possible to block @@ -136,7 +136,7 @@ or See .BR sigsetops (3) for details on manipulating signal sets. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR pause (2), .BR sigaction (2), diff --git a/man2/sigreturn.2 b/man2/sigreturn.2 index 67075c0e6..efaa85f87 100644 --- a/man2/sigreturn.2 +++ b/man2/sigreturn.2 @@ -48,14 +48,14 @@ it restores the process's signal mask, switches stacks, and restores the process's context (registers, processor flags), so that the process directly resumes execution at the point where it was interrupted by the signal. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR sigreturn () never returns. .SH FILES /usr/src/linux/arch/i386/kernel/signal.c .br /usr/src/linux/arch/alpha/kernel/entry.S -.SH "CONFORMING TO" +.SH CONFORMING TO .BR sigreturn () is specific to Linux and should not be used in programs intended to be portable. @@ -69,7 +69,7 @@ be called directly. Better yet, the specific use of the .I __unused argument varies depending on the architecture. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR sigaltstack (2), .BR signal (2), diff --git a/man2/sigsuspend.2 b/man2/sigsuspend.2 index cf85ed873..643bce887 100644 --- a/man2/sigsuspend.2 +++ b/man2/sigsuspend.2 @@ -65,7 +65,7 @@ or specifying these signals in .IR mask , has no effect on the process's signal mask. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR sigsuspend () always returns \-1, normally with the error .BR EINTR . @@ -77,7 +77,7 @@ points to memory which is not a valid part of the process address space. .TP .B EINTR The call was interrupted by a signal. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES .PP @@ -101,7 +101,7 @@ argument). See .BR sigsetops (3) for details on manipulating signal sets. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR pause (2), .BR sigaction (2), diff --git a/man2/sigwaitinfo.2 b/man2/sigwaitinfo.2 index 4a783e4ef..5fdd4bf3b 100644 --- a/man2/sigwaitinfo.2 +++ b/man2/sigwaitinfo.2 @@ -100,7 +100,7 @@ was pending for the caller, or with an error if none of the signals in .I set was pending. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, both .BR sigwaitinfo () and @@ -128,7 +128,7 @@ The wait was interrupted by a signal handler; see .B EINVAL .I timeout was invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES In normal usage, the calling program blocks the signals in @@ -182,7 +182,7 @@ On Linux, .BR sigwaitinfo () is a library function implemented on top of .BR sigtimedwait (). -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR sigaction (2), .BR signal (2), diff --git a/man2/socket.2 b/man2/socket.2 index fcc126e0a..319f1819f 100644 --- a/man2/socket.2 +++ b/man2/socket.2 @@ -309,7 +309,7 @@ The functions and .BR getsockopt (2) are used to set and get options, respectively. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, a file descriptor for the new socket is returned. On error, \-1 is returned, and .I errno @@ -347,7 +347,7 @@ The protocol type or the specified protocol is not supported within this domain. .PP Other errors may be generated by the underlying protocol modules. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, POSIX.1-2001. The @@ -385,7 +385,7 @@ An example of the use of .BR socket () is shown in .BR getaddrinfo (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR bind (2), .BR connect (2), diff --git a/man2/socketcall.2 b/man2/socketcall.2 index 55da5b57a..899b99ea0 100644 --- a/man2/socketcall.2 +++ b/man2/socketcall.2 @@ -40,7 +40,7 @@ which are passed through to the appropriate call. User programs should call the appropriate functions by their usual names. Only standard library implementors and kernel hackers need to know about .BR socketcall (). -.SH "CONFORMING TO" +.SH CONFORMING TO This call is specific to Linux, and should not be used in programs intended to be portable. .SH NOTES @@ -51,7 +51,7 @@ system call; instead .BR accept (2), .BR bind (2), and so on really are implemented as separate system calls. -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR bind (2), .BR connect (2), diff --git a/man2/socketpair.2 b/man2/socketpair.2 index e5f2e2bf4..c9905fc30 100644 --- a/man2/socketpair.2 +++ b/man2/socketpair.2 @@ -64,7 +64,7 @@ The descriptors used in referencing the new sockets are returned in and .IR sv [1]. The two sockets are indistinguishable. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -90,7 +90,7 @@ The specified protocol does not support creation of socket pairs. .TP .B EPROTONOSUPPORT The specified protocol is not supported on this machine. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, POSIX.1-2001. The .BR socketpair () @@ -119,7 +119,7 @@ POSIX.1-2001 does not require the inclusion of and this header file is not required on Linux. However, some historical (BSD) implementations required this header file, and portable applications are probably wise to include it. -.SH "SEE ALSO" +.SH SEE ALSO .BR pipe (2), .BR read (2), .BR socket (2), diff --git a/man2/splice.2 b/man2/splice.2 index 244733fdd..9cc75cfe7 100644 --- a/man2/splice.2 +++ b/man2/splice.2 @@ -167,7 +167,7 @@ The .BR splice () system call first appeared in Linux 2.6.17; library support was added to glibc in version 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. .SH NOTES The three system calls diff --git a/man2/stat.2 b/man2/stat.2 index f315c01c4..8bac864d7 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -297,7 +297,7 @@ on a directory means that a file in that directory can be renamed or deleted only by the owner of the file, by the owner of the directory, and by a privileged process. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -358,7 +358,7 @@ calls on a file whose size exceeds .I (1<<31)-1 bytes. -.SH "CONFORMING TO" +.SH CONFORMING TO These system calls conform to SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional .\" .BR fstat () @@ -652,7 +652,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR access (2), .BR chmod (2), .BR chown (2), diff --git a/man2/statfs.2 b/man2/statfs.2 index b292374b9..af310f74f 100644 --- a/man2/statfs.2 +++ b/man2/statfs.2 @@ -124,7 +124,7 @@ Fields that are undefined for a particular file system are set to 0. .BR fstatfs () returns the same information about an open file referenced by descriptor .IR fd . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -185,7 +185,7 @@ is not a directory. .TP .B EOVERFLOW Some values were too large to be represented in the returned struct. -.SH "CONFORMING TO" +.SH CONFORMING TO Linux-specific. The Linux .BR statfs () @@ -272,7 +272,7 @@ Under some operating systems the can be used as second argument to the .BR sysfs (2) system call. -.SH "SEE ALSO" +.SH SEE ALSO .BR stat (2), .BR statvfs (2), .BR path_resolution (7) diff --git a/man2/stime.2 b/man2/stime.2 index 5e7e22619..181623b6c 100644 --- a/man2/stime.2 +++ b/man2/stime.2 @@ -50,7 +50,7 @@ to by \fIt\fP, is measured in seconds since the Epoch, 1970-01-01 00:00:00 +0000 (UTC). .BR stime () may only be executed by the superuser. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -65,9 +65,9 @@ The calling process has insufficient privilege. Under Linux the .B CAP_SYS_TIME privilege is required. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR settimeofday (2), .BR capabilities (7) diff --git a/man2/swapon.2 b/man2/swapon.2 index a4b34f521..deae34c91 100644 --- a/man2/swapon.2 +++ b/man2/swapon.2 @@ -105,7 +105,7 @@ pages are allocated on a round-robin basis between them. .PP As of Linux 1.3.6, the kernel usually follows these rules, but there are exceptions. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -148,7 +148,7 @@ The caller does not have the capability. Alternatively, the maximum number of swap files are already in use; see NOTES below. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are Linux-specific and should not be used in programs intended to be portable. The second @@ -188,7 +188,7 @@ which still discards the entire swap area when .BR swapon () is called, even if that flag bit is not set. -.SH "SEE ALSO" +.SH SEE ALSO .BR mkswap (8), .BR swapoff (8), .BR swapon (8) diff --git a/man2/symlink.2 b/man2/symlink.2 index 701ee4fb5..9e4d4c987 100644 --- a/man2/symlink.2 +++ b/man2/symlink.2 @@ -81,7 +81,7 @@ If exists it will .I not be overwritten. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -146,7 +146,7 @@ does not support the creation of symbolic links. .B EROFS .I newpath is on a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional error codes EDQUOT and ENOSYS. .\" See @@ -161,7 +161,7 @@ Deleting the name referred to by a symlink will actually delete the file (unless it also has other hard links). If this behavior is not desired, use .BR link (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR ln (1), .BR lchown (2), .BR link (2), diff --git a/man2/symlinkat.2 b/man2/symlinkat.2 index 5eed360cc..cbb1874f0 100644 --- a/man2/symlinkat.2 +++ b/man2/symlinkat.2 @@ -87,7 +87,7 @@ If is absolute, then .I newdirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR symlinkat () returns 0. @@ -115,14 +115,14 @@ is a file descriptor referring to a file other than a directory. .BR symlinkat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See .BR openat (2) for an explanation of the need for .BR symlinkat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR openat (2), .BR symlink (2), .BR path_resolution (7), diff --git a/man2/sync.2 b/man2/sync.2 index 7747f86bf..11e16b2cd 100644 --- a/man2/sync.2 +++ b/man2/sync.2 @@ -93,7 +93,7 @@ is not a valid file descriptor. .BR syncfs () first appeared in Linux 2.6.39; library support was added to glibc in version 2.14. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR sync (): SVr4, 4.3BSD, POSIX.1-2001. @@ -116,7 +116,7 @@ writing is done. However, since version 1.3.20 Linux does actually wait. (This still does not guarantee data integrity: modern disks have large caches.) -.SH "SEE ALSO" +.SH SEE ALSO .BR bdflush (2), .BR fdatasync (2), .BR fsync (2), diff --git a/man2/sync_file_range.2 b/man2/sync_file_range.2 index 82ed87898..f7c54f8c4 100644 --- a/man2/sync_file_range.2 +++ b/man2/sync_file_range.2 @@ -177,7 +177,7 @@ a directory, or a symbolic link. .SH VERSIONS .BR sync_file_range () appeared on Linux in kernel 2.6.17. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific, and should be avoided in portable programs. .SH NOTES @@ -214,7 +214,7 @@ glibc transparently wraps .BR sync_file_range2 () under the name .BR sync_file_range (). -.SH "SEE ALSO" +.SH SEE ALSO .BR fdatasync (2), .BR fsync (2), .BR msync (2), diff --git a/man2/sysctl.2 b/man2/sysctl.2 index d1ef53f0d..0f7f8d05b 100644 --- a/man2/sysctl.2 +++ b/man2/sysctl.2 @@ -69,7 +69,7 @@ a directory tree under .IR /proc/sys , and if the requested item is found calls some appropriate routine to read or modify the value. -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion, .BR _sysctl () returns 0. @@ -95,7 +95,7 @@ or no read permission where was nonzero, or no write permission where .I newval was nonzero. -.SH "CONFORMING TO" +.SH CONFORMING TO This call is Linux-specific, and should not be used in programs intended to be portable. A @@ -176,5 +176,5 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR proc (5) diff --git a/man2/sysfs.2 b/man2/sysfs.2 index 366bf5879..b73167199 100644 --- a/man2/sysfs.2 +++ b/man2/sysfs.2 @@ -62,7 +62,7 @@ Return the total number of file system types currently present in the kernel. .PP The numbering of the file-system type indexes begins with zero. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sysfs () returns the file-system index for option @@ -87,7 +87,7 @@ is not a valid file-system type identifier; is out-of-bounds; .I option is invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. .SH NOTES This System-V derived system call is obsolete; don't use it. diff --git a/man2/sysinfo.2 b/man2/sysinfo.2 index 9083996f0..8d2b957a1 100644 --- a/man2/sysinfo.2 +++ b/man2/sysinfo.2 @@ -71,7 +71,7 @@ and the sizes are given as multiples of \fImem_unit\fP bytes. provides a simple way of getting overall system statistics. This is more portable than reading \fI/dev/kmem\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -80,7 +80,7 @@ is set appropriately. .TP .B EFAULT pointer to \fIstruct\ sysinfo\fP is invalid -.SH "CONFORMING TO" +.SH CONFORMING TO This function is Linux-specific, and should not be used in programs intended to be portable. .sp @@ -91,5 +91,5 @@ Linux libc contains a .BR sysinfo () routine since 5.3.5, and glibc has one since 1.90. -.SH "SEE ALSO" +.SH SEE ALSO .BR proc (5) diff --git a/man2/syslog.2 b/man2/syslog.2 index af51fba49..5ecc8002b 100644 --- a/man2/syslog.2 +++ b/man2/syslog.2 @@ -239,7 +239,7 @@ as follows: #define KERN_INFO "<6>" /* informational */ #define KERN_DEBUG "<7>" /* debug-level messages */ .fi -.SH "RETURN VALUE" +.SH RETURN VALUE For \fItype\fP equal to 2, 3, or 4, a successful call to .BR syslog () returns the number @@ -293,7 +293,7 @@ capability). .B ERESTARTSYS System call was interrupted by a signal; nothing was read. (This can be seen only during a trace.) -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific and should not be used in programs intended to be portable. .SH NOTES @@ -304,6 +304,6 @@ different animals. .\" .BR SYS_klog . .\" In glibc 2.0 the syscall is baptized .\" .BR klogctl (). -.SH "SEE ALSO" +.SH SEE ALSO .BR syslog (3), .BR capabilities (7) diff --git a/man2/tee.2 b/man2/tee.2 index a3f412256..a344341b1 100644 --- a/man2/tee.2 +++ b/man2/tee.2 @@ -116,7 +116,7 @@ The .BR tee () system call first appeared in Linux 2.6.17; library support was added to glibc in version 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. .SH NOTES Conceptually, diff --git a/man2/time.2 b/man2/time.2 index a03d0f586..807e7298c 100644 --- a/man2/time.2 +++ b/man2/time.2 @@ -43,7 +43,7 @@ If is non-NULL, the return value is also stored in the memory pointed to by .IR t . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the value of time in seconds since the Epoch is returned. On error, \fI((time_t)\ \-1)\fP is returned, and \fIerrno\fP is set appropriately. @@ -52,7 +52,7 @@ appropriately. .B EFAULT .I t points outside your accessible address space. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, POSIX.1-2001. .\" .br .\" Under 4.3BSD, this call is obsoleted by @@ -73,7 +73,7 @@ and the Epoch, because of leap seconds and because system clocks are not required to be synchronized to a standard reference. The intention is that the interpretation of seconds since the Epoch values be consistent; see POSIX.1-2008 Rationale A.4.15 for further rationale. -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR gettimeofday (2), .BR ctime (3), diff --git a/man2/timerfd_create.2 b/man2/timerfd_create.2 index 2e0e285b3..aee7f7a08 100644 --- a/man2/timerfd_create.2 +++ b/man2/timerfd_create.2 @@ -283,7 +283,7 @@ A file descriptor created by is preserved across .BR execve (2), and continues to generate timer expirations if the timer was armed. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR timerfd_create () returns a new file descriptor. @@ -537,7 +537,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR eventfd (2), .BR poll (2), .BR read (2), diff --git a/man2/times.2 b/man2/times.2 index 24351fed1..bdca549dd 100644 --- a/man2/times.2 +++ b/man2/times.2 @@ -98,7 +98,7 @@ In particular, times of grandchildren that the children did not wait for are never seen. .LP All times reported are in clock ticks. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR times () returns the number of clock ticks that have elapsed since an arbitrary point in the past. @@ -112,7 +112,7 @@ is set appropriately. .B EFAULT .I tms points outside the process's address space. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES The number of clock ticks per second can be obtained using: @@ -205,7 +205,7 @@ the maximum value that can be stored in .\" http://marc.info/?l=linux-kernel&m=119447727031225&w=2 .\" "compat_sys_times() bogus until jiffies >= 0" .\" November 2007 -.SH "SEE ALSO" +.SH SEE ALSO .BR time (1), .BR getrusage (2), .BR wait (2), diff --git a/man2/tkill.2 b/man2/tkill.2 index 5649c4e5d..3b658c003 100644 --- a/man2/tkill.2 +++ b/man2/tkill.2 @@ -92,7 +92,7 @@ is equivalent to These are the raw system call interfaces, meant for internal thread library use. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and \fIerrno\fP is set appropriately. @@ -113,7 +113,7 @@ No process with the specified thread ID (and thread group ID) exists. is supported since Linux 2.4.19 / 2.5.4. .BR tgkill () was added in Linux 2.5.75. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR tkill () and .BR tgkill () @@ -128,7 +128,7 @@ for an explanation of thread groups. Glibc does not provide wrappers for these system calls; call them using .BR syscall (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR gettid (2), .BR kill (2), diff --git a/man2/truncate.2 b/man2/truncate.2 index 276731fd9..ab615b493 100644 --- a/man2/truncate.2 +++ b/man2/truncate.2 @@ -105,7 +105,7 @@ With the file must be open for writing; with .BR truncate (), the file must be writable. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -190,7 +190,7 @@ is not open for writing. .B EINVAL .I fd does not reference a regular file. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, SVr4, POSIX.1-2001 (these calls first appeared in 4.2BSD). .\" POSIX.1-1996 has .\" .BR ftruncate (). @@ -246,7 +246,7 @@ required to expose the declaration of .BR ftruncate () was 200809L instead of 200112L. This has been fixed in later glibc versions. -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2), .BR stat (2), .BR path_resolution (7) diff --git a/man2/umask.2 b/man2/umask.2 index 66447b43c..b1ff7a87d 100644 --- a/man2/umask.2 +++ b/man2/umask.2 @@ -87,10 +87,10 @@ resulting file will be: .fi (because 0666 & ~022 = 0644; i.e., rw\-r\-\-r\-\-). -.SH "RETURN VALUE" +.SH RETURN VALUE This system call always succeeds and the previous value of the mask is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES A child process created via @@ -113,7 +113,7 @@ to System V IPC objects created by the process (using .BR msgget (2), .BR semget (2), .BR shmget (2)). -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (2), .BR mkdir (2), .BR open (2), diff --git a/man2/umount.2 b/man2/umount.2 index f5115abeb..3550879ec 100644 --- a/man2/umount.2 +++ b/man2/umount.2 @@ -96,7 +96,7 @@ Don't dereference if it is a symbolic link. This flag allows security problems to be avoided in set-user-ID-\fIroot\fP programs that allow unprivileged users to unmount file systems. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -153,7 +153,7 @@ and .BR MNT_EXPIRE .\" http://sourceware.org/bugzilla/show_bug.cgi?id=10092 are only available in glibc since version 2.11. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are Linux-specific and should not be used in programs intended to be portable. .SH NOTES @@ -167,7 +167,7 @@ support anonymous devices. In Linux 2.3.99-pre7 the call \fIumount(device)\fP was removed, leaving only \fIumount(dir)\fP (since now devices can be mounted in more than one place, so specifying the device does not suffice). -.SH "SEE ALSO" +.SH SEE ALSO .BR mount (2), .BR path_resolution (7), .BR mount (8), diff --git a/man2/uname.2 b/man2/uname.2 index 7fde910e8..a28e94da6 100644 --- a/man2/uname.2 +++ b/man2/uname.2 @@ -58,7 +58,7 @@ The length of the arrays in a .I struct utsname is unspecified (see NOTES); the fields are terminated by a null byte (\(aq\\0\(aq). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -68,7 +68,7 @@ is set appropriately. .B EFAULT .I buf is not valid. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. There is no .BR uname () @@ -152,7 +152,7 @@ The glibc .BR uname () wrapper function hides these details from applications, invoking the most recent version of the system call provided by the kernel. -.SH "SEE ALSO" +.SH SEE ALSO .BR uname (1), .BR getdomainname (2), .BR gethostname (2) diff --git a/man2/unimplemented.2 b/man2/unimplemented.2 index 40503b889..138823f56 100644 --- a/man2/unimplemented.2 +++ b/man2/unimplemented.2 @@ -33,7 +33,7 @@ stty, tuxcall, ulimit, vserver \- unimplemented system calls Unimplemented system calls. .SH DESCRIPTION These system calls are not implemented in the Linux kernel. -.SH "RETURN VALUE" +.SH RETURN VALUE These system calls always return \-1 and set .I errno to @@ -62,5 +62,5 @@ Some system calls, like and .BR delete_module (2) only exist when the Linux kernel was built with support for them. -.SH "SEE ALSO" +.SH SEE ALSO .BR syscalls (2) diff --git a/man2/unlink.2 b/man2/unlink.2 index 79aaf070f..a84c61b9b 100644 --- a/man2/unlink.2 +++ b/man2/unlink.2 @@ -52,7 +52,7 @@ If the name referred to a symbolic link the link is removed. If the name referred to a socket, fifo or device the name for it is removed but processes which have the object open may continue to use it. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -138,14 +138,14 @@ capability). .B EROFS .I pathname refers to a file on a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional error .\" conditions EINTR, EMULTIHOP, ETXTBSY, ENOLINK. .SH BUGS Infelicities in the protocol underlying NFS can cause the unexpected disappearance of files which are still being used. -.SH "SEE ALSO" +.SH SEE ALSO .BR rm (1), .BR chmod (2), .BR link (2), diff --git a/man2/unlinkat.2 b/man2/unlinkat.2 index 84f940473..2c69bed05 100644 --- a/man2/unlinkat.2 +++ b/man2/unlinkat.2 @@ -118,7 +118,7 @@ performs the equivalent of .BR rmdir (2) on .IR pathname . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR unlinkat () returns 0. @@ -152,7 +152,7 @@ is a file descriptor referring to a file other than a directory. .BR unlinkat () was added to Linux in kernel 2.6.16; library support was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. A similar system call exists on Solaris. .SH NOTES @@ -160,7 +160,7 @@ See .BR openat (2) for an explanation of the need for .BR unlinkat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR openat (2), .BR rmdir (2), .BR unlink (2), diff --git a/man2/uselib.2 b/man2/uselib.2 index 6d4718182..1eb0e6e7d 100644 --- a/man2/uselib.2 +++ b/man2/uselib.2 @@ -45,7 +45,7 @@ The address where to load is found in the library itself. The library can have any recognized binary format. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -73,7 +73,7 @@ The file specified by .I library is not an executable of known type, e.g., does not have the correct magic numbers. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR uselib () is Linux-specific, and should not be used in programs intended to be portable. @@ -99,7 +99,7 @@ so that this dynamic library can load the remaining libraries needed This is also the state of affairs in libc5. .LP glibc2 does not use this call. -.SH "SEE ALSO" +.SH SEE ALSO .BR ar (1), .BR gcc (1), .BR ld (1), diff --git a/man2/ustat.2 b/man2/ustat.2 index 9e763828b..11b14ad2e 100644 --- a/man2/ustat.2 +++ b/man2/ustat.2 @@ -63,7 +63,7 @@ and .IR f_fpack , are not implemented and will always be filled with null bytes (\(aq\\0\(aq). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned and the .I ustat structure pointed to by @@ -87,7 +87,7 @@ The mounted file system referenced by .I dev does not support this operation, or any version of Linux before 1.3.16. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. .\" SVr4 documents additional error conditions ENOLINK, ECOMM, and EINTR .\" but has no ENOSYS condition. @@ -111,6 +111,6 @@ Such file systems will return \-1 in the field .\" underlying file system is NFS. For some file systems, inodes are dynamically allocated. Such file systems will return the current number of free inodes. -.SH "SEE ALSO" +.SH SEE ALSO .BR stat (2), .BR statfs (2) diff --git a/man2/utime.2 b/man2/utime.2 index bb267e8ed..6d842aa17 100644 --- a/man2/utime.2 +++ b/man2/utime.2 @@ -117,7 +117,7 @@ is NULL, then analogously to .BR utime (), the access and modification times of the file are set to the current time. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -159,7 +159,7 @@ capability). .B EROFS .I path resides on a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR utime (): SVr4, POSIX.1-2001. POSIX.1-2008 marks @@ -178,7 +178,7 @@ In libc4 and libc5, is just a wrapper for .BR utime () and hence does not allow a subsecond resolution. -.SH "SEE ALSO" +.SH SEE ALSO .BR chattr (1), .BR futimesat (2), .BR stat (2), diff --git a/man2/utimensat.2 b/man2/utimensat.2 index a281efff9..cc7029343 100644 --- a/man2/utimensat.2 +++ b/man2/utimensat.2 @@ -222,7 +222,7 @@ If .I pathname specifies a symbolic link, then update the timestamps of the link, rather than the file to which it refers. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR utimensat () and @@ -418,7 +418,7 @@ glibc support was added with version 2.6. Support for .BR futimens () first appeared in glibc 2.6. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR futimens () and .BR utimensat () @@ -603,7 +603,7 @@ instead checks whether the .\" conversely, a process with a read-only file descriptor won't .\" be able to update the timestamps of a file, .\" even if it has write permission on the file. -.SH "SEE ALSO" +.SH SEE ALSO .BR chattr (1), .BR futimesat (2), .BR openat (2), diff --git a/man2/vfork.2 b/man2/vfork.2 index c07f6b594..ab850d386 100644 --- a/man2/vfork.2 +++ b/man2/vfork.2 @@ -154,7 +154,7 @@ The use of was tricky: for example, not modifying data in the parent process depended on knowing which variables were held in a register. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD; POSIX.1-2001 (but marked OBSOLETE). POSIX.1-2008 removes the specification of .BR vfork (). @@ -268,7 +268,7 @@ are allowed and input attempts result in an end-of-file indication." .\" cannot follow .\" .BR vfork () .\" and requires a kernel patch. -.SH "SEE ALSO" +.SH SEE ALSO .BR clone (2), .BR execve (2), .BR fork (2), diff --git a/man2/vhangup.2 b/man2/vhangup.2 index 01f7f0167..17c37592f 100644 --- a/man2/vhangup.2 +++ b/man2/vhangup.2 @@ -46,7 +46,7 @@ _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\ <\ 500) simulates a hangup on the current terminal. This call arranges for other users to have a \*(lqclean\*(rq terminal at login time. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -59,9 +59,9 @@ The calling process has insufficient privilege to call the .B CAP_SYS_TTY_CONFIG capability is required. -.SH "CONFORMING TO" +.SH CONFORMING TO This call is Linux-specific, and should not be used in programs intended to be portable. -.SH "SEE ALSO" +.SH SEE ALSO .BR capabilities (7), .BR init (8) diff --git a/man2/vm86.2 b/man2/vm86.2 index b66cad3db..2d8aaad41 100644 --- a/man2/vm86.2 +++ b/man2/vm86.2 @@ -49,7 +49,7 @@ literature), and are used by .BR dosemu . .PP VM86 mode is an emulation of real mode within a protected mode task. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -68,6 +68,6 @@ architecture. Saved kernel stack exists. (This is a kernel sanity check; the saved stack should only exist within vm86 mode itself.) -.SH "CONFORMING TO" +.SH CONFORMING TO This call is specific to Linux on 32-bit Intel processors, and should not be used in programs intended to be portable. diff --git a/man2/vmsplice.2 b/man2/vmsplice.2 index 45a86c4de..3e85b3699 100644 --- a/man2/vmsplice.2 +++ b/man2/vmsplice.2 @@ -140,7 +140,7 @@ The .BR vmsplice () system call first appeared in Linux 2.6.17; library support was added to glibc in version 2.5. -.SH "CONFORMING TO" +.SH CONFORMING TO This system call is Linux-specific. .SH NOTES .BR vmsplice () diff --git a/man2/wait.2 b/man2/wait.2 index f6085e106..7311cdbc4 100644 --- a/man2/wait.2 +++ b/man2/wait.2 @@ -351,7 +351,7 @@ waitable state, zero out the .I si_pid field before the call and check for a nonzero value in this field after the call returns. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wait (): on success, returns the process ID of the terminated child; on error, \-1 is returned. @@ -418,7 +418,7 @@ was caught; see The .I options argument was invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES A child that terminates, but has not been waited for becomes a "zombie". @@ -617,7 +617,7 @@ main(int argc, char *argv[]) } } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR _exit (2), .BR clone (2), .BR fork (2), diff --git a/man2/wait4.2 b/man2/wait4.2 index 217eda14e..a697aa79c 100644 --- a/man2/wait4.2 +++ b/man2/wait4.2 @@ -130,13 +130,13 @@ about the child. See .BR getrusage (2) for details. -.SH "RETURN VALUE" +.SH RETURN VALUE As for .BR waitpid (2). .SH ERRORS As for .BR waitpid (2). -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. SUSv1 included a specification of @@ -163,7 +163,7 @@ On Linux, is a library function implemented on top of the .BR wait4 () system call. -.SH "SEE ALSO" +.SH SEE ALSO .BR fork (2), .BR getrusage (2), .BR sigaction (2), diff --git a/man2/write.2 b/man2/write.2 index caa673a1a..0b85dcaec 100644 --- a/man2/write.2 +++ b/man2/write.2 @@ -86,7 +86,7 @@ which can be proved to occur after a .BR write () has returned returns the new data. Note that not all file systems are POSIX conforming. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the number of bytes written is returned (zero indicates nothing was written). On error, \-1 is returned, and \fIerrno\fP is set @@ -182,7 +182,7 @@ catches, blocks or ignores this signal.) .PP Other errors may occur, depending on the object connected to .IR fd . -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .\" SVr4 documents additional error .\" conditions EDEADLK, ENOLCK, ENOLNK, ENOSR, ENXIO, or ERANGE. @@ -208,7 +208,7 @@ then the call fails with the error .BR EINTR ; if it is interrupted after at least one byte has been written, the call succeeds, and returns the number of bytes written. -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR fcntl (2), .BR fsync (2), diff --git a/man3/CPU_SET.3 b/man3/CPU_SET.3 index c84d8263e..3f6b784e1 100644 --- a/man3/CPU_SET.3 +++ b/man3/CPU_SET.3 @@ -205,7 +205,7 @@ These macros perform the same tasks as their analogs, but operate on the dynamically allocated CPU set(s) whose size is .I setsize bytes. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR CPU_ISSET () and .BR CPU_ISSET_S () @@ -265,7 +265,7 @@ first appeared in glibc 2.6. and .BR CPU_EQUAL_S () first appeared in glibc 2.7. -.SH "CONFORMING TO" +.SH CONFORMING TO These interfaces are Linux-specific. .SH NOTES To duplicate a CPU set, use @@ -351,7 +351,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR sched_setaffinity (2), .BR pthread_attr_setaffinity_np (3), .BR pthread_setaffinity_np (3), diff --git a/man3/INFINITY.3 b/man3/INFINITY.3 index d1af97c39..4b453a5a8 100644 --- a/man3/INFINITY.3 +++ b/man3/INFINITY.3 @@ -64,7 +64,7 @@ The macros expand to constants of types \fIdouble\fP, \fIfloat\fP and \fIlong double\fP, respectively, that represent a large positive value, possibly plus infinity. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH AVAILABILITY On a glibc system, the macro @@ -88,6 +88,6 @@ is defined, or .B __STDC_VERSION__ is defined and has a value not less than 199901L. -.SH "SEE ALSO" +.SH SEE ALSO .BR fpclassify (3), .BR math_error (7) diff --git a/man3/MB_CUR_MAX.3 b/man3/MB_CUR_MAX.3 index 6a5717432..e894600dc 100644 --- a/man3/MB_CUR_MAX.3 +++ b/man3/MB_CUR_MAX.3 @@ -26,13 +26,13 @@ macro defines an integer expression giving the maximum number of bytes needed to represent a single wide character in the current locale. It is locale dependent and therefore not a compile-time constant. -.SH "RETURN VALUE" +.SH RETURN VALUE An integer in the range [1, .BR MB_LEN_MAX ]. The value 1 denotes traditional 8-bit encoded characters. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR MB_LEN_MAX (3), .BR mblen (3), .BR mbstowcs (3), diff --git a/man3/MB_LEN_MAX.3 b/man3/MB_LEN_MAX.3 index 9eac3a6fa..22398486f 100644 --- a/man3/MB_LEN_MAX.3 +++ b/man3/MB_LEN_MAX.3 @@ -24,9 +24,9 @@ The .B MB_LEN_MAX macro is the upper bound for the number of bytes needed to represent a single wide character, across all locales. -.SH "RETURN VALUE" +.SH RETURN VALUE A constant integer greater than zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES The entities @@ -39,5 +39,5 @@ In glibc, is typically 6 while .I sizeof(wchar_t) is 4. -.SH "SEE ALSO" +.SH SEE ALSO .BR MB_CUR_MAX (3) diff --git a/man3/__setfpucw.3 b/man3/__setfpucw.3 index 8afdcbf79..6c0f8f8ae 100644 --- a/man3/__setfpucw.3 +++ b/man3/__setfpucw.3 @@ -55,7 +55,7 @@ Set FPU control word on the i386 architecture to \- rounding to nearest .br \- exceptions on overflow, zero divide and NaN -.SH "SEE ALSO" +.SH SEE ALSO .BR feclearexcept (3) .br .I diff --git a/man3/a64l.3 b/man3/a64l.3 index 6069a1b65..9002d03dc 100644 --- a/man3/a64l.3 +++ b/man3/a64l.3 @@ -56,7 +56,7 @@ a-z represent 38-63 .fi .RE So 123 = 59*64^0 + 1*64^1 = "v/". -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES The value returned by @@ -78,7 +78,7 @@ These functions are broken in glibc before 2.2.5 .LP This is not the encoding used by .BR uuencode (1). -.SH "SEE ALSO" +.SH SEE ALSO .BR uuencode (1), .\" .BR itoa (3), .BR strtoul (3) diff --git a/man3/abort.3 b/man3/abort.3 index 9de707bff..e9291753b 100644 --- a/man3/abort.3 +++ b/man3/abort.3 @@ -63,13 +63,13 @@ function will still terminate the process. It does this by restoring the default disposition for .B SIGABRT and then raising the signal for a second time. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR abort () function never returns. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD, C89, C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR gdb (1), .BR sigaction (2), .BR exit (3), diff --git a/man3/abs.3 b/man3/abs.3 index 46663b99a..4149902e7 100644 --- a/man3/abs.3 +++ b/man3/abs.3 @@ -74,10 +74,10 @@ and .BR imaxabs () functions compute the absolute value of the argument \fIj\fP of the appropriate integer type for the function. -.SH "RETURN VALUE" +.SH RETURN VALUE Returns the absolute value of the integer argument, of the appropriate integer type for the function. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD, C99. .\" POSIX.1 (1996 edition) only requires the .\" .BR abs () @@ -121,7 +121,7 @@ GCC 3.0 also handles and .BR imaxabs () as built-ins. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR ceil (3), .BR fabs (3), diff --git a/man3/acos.3 b/man3/acos.3 index e22860d4f..6f34b9969 100644 --- a/man3/acos.3 +++ b/man3/acos.3 @@ -65,7 +65,7 @@ The .BR acos () function calculates the arc cosine of \fIx\fP; that is the value whose cosine is \fIx\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the arc cosine of .IR x in radians; the return value is in the range [0,\ pi]. @@ -105,13 +105,13 @@ is set to An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR asin (3), .BR atan (3), .BR atan2 (3), diff --git a/man3/acosh.3 b/man3/acosh.3 index cce02f939..473e72475 100644 --- a/man3/acosh.3 +++ b/man3/acosh.3 @@ -77,7 +77,7 @@ The .BR acosh () function calculates the inverse hyperbolic cosine of \fIx\fP; that is the value whose hyperbolic cosine is \fIx\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the inverse hyperbolic cosine of .IR x . @@ -113,13 +113,13 @@ is set to An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR asinh (3), .BR atanh (3), .BR cacosh (3), diff --git a/man3/addseverity.3 b/man3/addseverity.3 index d51b16010..7450f678f 100644 --- a/man3/addseverity.3 +++ b/man3/addseverity.3 @@ -43,7 +43,7 @@ is removed. It is not possible to overwrite or remove one of the default severity classes. The severity value must be nonnegative. -.SH "RETURN VALUE" +.SH RETURN VALUE Upon success, the value .B MM_OK is returned. @@ -54,7 +54,7 @@ nonexistent or default severity class. .SH VERSIONS .BR addseverity () is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is not specified in the X/Open Portability Guide although the .BR fmtmsg (3) @@ -64,5 +64,5 @@ systems. .SH NOTES New severity classes can also be added by setting the environment variable .BR SEV_LEVEL . -.SH "SEE ALSO" +.SH SEE ALSO .BR fmtmsg (3) diff --git a/man3/adjtime.3 b/man3/adjtime.3 index 72434fc68..9e1ca455b 100644 --- a/man3/adjtime.3 +++ b/man3/adjtime.3 @@ -79,7 +79,7 @@ If is not NULL, then the buffer that it points to is used to return the amount of time remaining from any previous adjustment that has not yet been completed. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR adjtime () returns 0. On failure, \-1 is returned, and @@ -136,7 +136,7 @@ This bug is fixed .\" Thanks to the new adjtimex() ADJ_OFFSET_SS_READ flag on systems with glibc 2.8 or later and Linux kernel 2.6.26 or later. -.SH "SEE ALSO" +.SH SEE ALSO .BR adjtimex (2), .BR gettimeofday (2), .BR time (7) diff --git a/man3/aio_cancel.3 b/man3/aio_cancel.3 index c8000752e..74d33fde8 100644 --- a/man3/aio_cancel.3 +++ b/man3/aio_cancel.3 @@ -76,7 +76,7 @@ was initiated, unspecified results occur. .LP Which operations are cancelable is implementation-defined. .\" FreeBSD: not those on raw disk devices. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR aio_cancel () function returns one of the following values: @@ -110,12 +110,12 @@ is not implemented. The .BR aio_cancel () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH EXAMPLE See .BR aio (7). -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_error (3), .BR aio_fsync (3), .BR aio_read (3), diff --git a/man3/aio_error.3 b/man3/aio_error.3 index 4550850e9..ffd29da6b 100644 --- a/man3/aio_error.3 +++ b/man3/aio_error.3 @@ -40,7 +40,7 @@ with control block pointed to by for a description of the .I aiocb structure.) -.SH "RETURN VALUE" +.SH RETURN VALUE This function returns one of the following: .IP * 3 .BR EINPROGRESS , @@ -78,12 +78,12 @@ is not implemented. The .BR aio_error () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH EXAMPLE See .BR aio (7). -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_cancel (3), .BR aio_fsync (3), .BR aio_read (3), diff --git a/man3/aio_fsync.3 b/man3/aio_fsync.3 index 2d4d3761b..9bd004426 100644 --- a/man3/aio_fsync.3 +++ b/man3/aio_fsync.3 @@ -69,7 +69,7 @@ structure, described in .BR sigevent (7)), which indicates the desired type of asynchronous notification at completion. All other fields are ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success (the sync request was successfully queued) this function returns 0. On error \-1 is returned, and @@ -99,9 +99,9 @@ is not implemented. The .BR aio_fsync () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_cancel (3), .BR aio_error (3), .BR aio_read (3), diff --git a/man3/aio_read.3 b/man3/aio_read.3 index 42b45ec3b..ab3366b62 100644 --- a/man3/aio_read.3 +++ b/man3/aio_read.3 @@ -84,7 +84,7 @@ The field is ignored. .LP No data is read from a regular file beyond its maximum offset. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, 0 is returned. On error the request is not enqueued, \-1 is returned, and @@ -128,7 +128,7 @@ the maximum offset for this file. The .BR aio_read () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH NOTES It is a good idea to zero out the control block before use. @@ -145,7 +145,7 @@ structure produce undefined results. .SH EXAMPLE See .BR aio (7). -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_cancel (3), .BR aio_error (3), .BR aio_fsync (3), diff --git a/man3/aio_return.3 b/man3/aio_return.3 index 1bee72835..96ec1b82d 100644 --- a/man3/aio_return.3 +++ b/man3/aio_return.3 @@ -45,7 +45,7 @@ This function should be called only once for any given request, after .BR aio_error (3) returns something other than .BR EINPROGRESS . -.SH "RETURN VALUE" +.SH RETURN VALUE If the asynchronous I/O operation has completed, this function returns the value that would have been returned in case of a synchronous .BR read (2), @@ -73,12 +73,12 @@ is not implemented. The .BR aio_return () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH EXAMPLE See .BR aio (7). -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_cancel (3), .BR aio_error (3), .BR aio_fsync (3), diff --git a/man3/aio_suspend.3 b/man3/aio_suspend.3 index 05d045d96..bbab773d8 100644 --- a/man3/aio_suspend.3 +++ b/man3/aio_suspend.3 @@ -76,7 +76,7 @@ If is supported, this clock is used to measure the timeout interval (see .BR clock_gettime (3)). -.SH "RETURN VALUE" +.SH RETURN VALUE If this function returns after completion of one of the I/O requests specified in .IR aiocb_list , @@ -103,7 +103,7 @@ is not implemented. The .BR aio_suspend () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH NOTES One can achieve polling by using a non-NULL @@ -125,7 +125,7 @@ to scan the list of .I aiocb structures pointed to by .IR aiocb_list . -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_cancel (3), .BR aio_error (3), .BR aio_fsync (3), diff --git a/man3/aio_write.3 b/man3/aio_write.3 index 38c782298..47eeadb5f 100644 --- a/man3/aio_write.3 +++ b/man3/aio_write.3 @@ -91,7 +91,7 @@ The field is ignored. .LP No data is written to a regular file beyond its maximum offset. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, 0 is returned. On error the request is not enqueued, \-1 is returned, and @@ -133,7 +133,7 @@ is not implemented. The .BR aio_write () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH NOTES It is a good idea to zero out the control block before use. @@ -147,7 +147,7 @@ The memory areas involved must remain valid. Simultaneous I/O operations specifying the same .I aiocb structure produce undefined results. -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_cancel (3), .BR aio_error (3), .BR aio_fsync (3), diff --git a/man3/alloca.3 b/man3/alloca.3 index 637d4a248..68513871a 100644 --- a/man3/alloca.3 +++ b/man3/alloca.3 @@ -55,12 +55,12 @@ This temporary space is automatically freed when the function that called .BR alloca () returns to its caller. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR alloca () function returns a pointer to the beginning of the allocated space. If the allocation causes stack overflow, program behavior is undefined. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is not in POSIX.1-2001. There is evidence that the @@ -146,7 +146,7 @@ the stack space reserved by .BR alloca () would appear on the stack in the middle of the space for the function arguments. -.SH "SEE ALSO" +.SH SEE ALSO .BR brk (2), .BR longjmp (3), .BR malloc (3) diff --git a/man3/argz_add.3 b/man3/argz_add.3 index d0e7ba19d..a2d6195a2 100644 --- a/man3/argz_add.3 +++ b/man3/argz_add.3 @@ -191,7 +191,7 @@ is the opposite of It transforms the argz vector into a normal string by replacing all null bytes (\(aq\\0\(aq) except the last by .IR sep . -.SH "RETURN VALUE" +.SH RETURN VALUE All argz functions that do memory allocation have a return type of \fIerror_t\fP, and return 0 for success, and \fBENOMEM\fP if an allocation error occurs. @@ -201,5 +201,5 @@ Handle with care. .SH BUGS Argz vectors without a terminating null byte may lead to Segmentation Faults. -.SH "SEE ALSO" +.SH SEE ALSO .BR envz_add (3) diff --git a/man3/asin.3 b/man3/asin.3 index b1df63adb..1bdd6a683 100644 --- a/man3/asin.3 +++ b/man3/asin.3 @@ -67,7 +67,7 @@ The .BR asin () function calculates the principal value of the arc sine of \fIx\fP; that is the value whose sine is \fIx\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the principal value of the arc sine of .IR x in radians; the return value is in the range [\-pi/2,\ pi/2]. @@ -104,13 +104,13 @@ is set to An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR acos (3), .BR atan (3), .BR atan2 (3), diff --git a/man3/asinh.3 b/man3/asinh.3 index 0966a8dfa..1cd54af92 100644 --- a/man3/asinh.3 +++ b/man3/asinh.3 @@ -77,7 +77,7 @@ The .BR asinh () function calculates the inverse hyperbolic sine of \fIx\fP; that is the value whose hyperbolic sine is \fIx\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the inverse hyperbolic sine of .IR x . @@ -98,13 +98,13 @@ positive infinity (negative infinity) is returned. .\" glibc 2.8 does not do this. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh (3), .BR atanh (3), .BR casinh (3), diff --git a/man3/asprintf.3 b/man3/asprintf.3 index f8989bc32..b0519a69a 100644 --- a/man3/asprintf.3 +++ b/man3/asprintf.3 @@ -48,7 +48,7 @@ and return a pointer to it via the first argument. This pointer should be passed to .BR free (3) to release the allocated storage when it is no longer needed. -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, these functions return the number of bytes printed, just like .BR sprintf (3). @@ -62,7 +62,7 @@ They are also available under *BSD. The FreeBSD implementation sets .I strp to NULL on error. -.SH "SEE ALSO" +.SH SEE ALSO .BR free (3), .BR malloc (3), .BR printf (3) diff --git a/man3/assert.3 b/man3/assert.3 index 73596e97a..d4b55607c 100644 --- a/man3/assert.3 +++ b/man3/assert.3 @@ -52,9 +52,9 @@ The purpose of this macro is to help the programmer find bugs in his program. The message "assertion failed in file foo.c, function do_bar(), line 1287" is of no help at all to a user. -.SH "RETURN VALUE" +.SH RETURN VALUE No value is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, C89, C99. In C89, .I expression @@ -71,7 +71,7 @@ program behavior will be different depending on whether is defined. This may create Heisenbugs which go away when debugging is turned on. -.SH "SEE ALSO" +.SH SEE ALSO .BR abort (3), .BR assert_perror (3), .BR exit (3) diff --git a/man3/assert_perror.3 b/man3/assert_perror.3 index ad5c49378..73994535b 100644 --- a/man3/assert_perror.3 +++ b/man3/assert_perror.3 @@ -52,9 +52,9 @@ is nonzero. The message contains the filename, function name and line number of the macro call, and the output of .IR strerror(errnum) . -.SH "RETURN VALUE" +.SH RETURN VALUE No value is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO This is a GNU extension. .SH BUGS The purpose of the assert macros is to help the programmer find bugs in @@ -66,7 +66,7 @@ Not by an assert, where the test goes away when is defined, but by proper error handling code. Never use this macro. -.SH "SEE ALSO" +.SH SEE ALSO .BR abort (3), .BR assert (3), .BR exit (3), diff --git a/man3/atan.3 b/man3/atan.3 index 96e0415a0..08ed9bd3f 100644 --- a/man3/atan.3 +++ b/man3/atan.3 @@ -67,7 +67,7 @@ The .BR atan () function calculates the principal value of the arc tangent of \fIx\fP; that is the value whose tangent is \fIx\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the principal value of the arc tangent of .IR x in radians; the return value is in the range [\-pi/2,\ pi/2]. @@ -89,13 +89,13 @@ is positive infinity (negative infinity), +pi/2 (\-pi/2) is returned. .\" glibc 2.8 does not do this. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR acos (3), .BR asin (3), .BR atan2 (3), diff --git a/man3/atan2.3 b/man3/atan2.3 index 8f0f1275f..072fdd14d 100644 --- a/man3/atan2.3 +++ b/man3/atan2.3 @@ -67,7 +67,7 @@ function calculates the principal value of the arc tangent of .IR y/x , using the signs of the two arguments to determine the quadrant of the result. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the principal value of the arc tangent of .IR y/x in radians; the return value is in the range [\-pi,\ pi]. @@ -161,13 +161,13 @@ is positive infinity, +pi/4 (\-pi/4) is returned. No errors occur. .\" POSIX.1 documents an optional underflow error .\" glibc 2.8 does not do this. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR acos (3), .BR asin (3), .BR atan (3), diff --git a/man3/atanh.3 b/man3/atanh.3 index 9bcde18ec..808986067 100644 --- a/man3/atanh.3 +++ b/man3/atanh.3 @@ -77,7 +77,7 @@ The .BR atanh () function calculates the inverse hyperbolic tangent of \fIx\fP; that is the value whose hyperbolic tangent is \fIx\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the inverse hyperbolic tangent of .IR x . @@ -132,7 +132,7 @@ is set to A divide-by-zero floating-point exception .RB ( FE_DIVBYZERO ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -149,7 +149,7 @@ as set to instead of the POSIX-mandated .BR ERANGE . Since version 2.10, glibc does the right thing. -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh (3), .BR asinh (3), .BR catanh (3), diff --git a/man3/atexit.3 b/man3/atexit.3 index d5246961c..5e20ffd7b 100644 --- a/man3/atexit.3 +++ b/man3/atexit.3 @@ -63,12 +63,12 @@ Upon a successful call to one of the .BR exec (3) functions, all registrations are removed. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR atexit () function returns the value 0 if successful; otherwise it returns a nonzero value. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, POSIX.1-2001. .SH NOTES Functions registered using @@ -153,7 +153,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR _exit (2), .BR exit (3), .BR on_exit (3) diff --git a/man3/atof.3 b/man3/atof.3 index 029f915e2..f14c41f78 100644 --- a/man3/atof.3 +++ b/man3/atof.3 @@ -50,11 +50,11 @@ strtod(nptr, NULL); except that .BR atof () does not detect errors. -.SH "RETURN VALUE" +.SH RETURN VALUE The converted value. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD, C89, C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR atoi (3), .BR atol (3), .BR strtod (3), diff --git a/man3/atoi.3 b/man3/atoi.3 index 41a4c599d..f96591c51 100644 --- a/man3/atoi.3 +++ b/man3/atoi.3 @@ -86,9 +86,9 @@ string to their return type of \fIlong\fP or \fIlong long\fP. .BR atoq () is an obsolete name for .BR atoll (). -.SH "RETURN VALUE" +.SH RETURN VALUE The converted value. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD, C99. C89 and POSIX.1-1996 include the functions @@ -108,7 +108,7 @@ The .BR atoll () function is present in glibc 2 since version 2.0.2, but not in libc4 or libc5. -.SH "SEE ALSO" +.SH SEE ALSO .BR atof (3), .BR strtod (3), .BR strtol (3), diff --git a/man3/backtrace.3 b/man3/backtrace.3 index 7992825d0..6bc7bcc7b 100644 --- a/man3/backtrace.3 +++ b/man3/backtrace.3 @@ -111,7 +111,7 @@ it writes the strings, one per line, to the file descriptor does not call .BR malloc (3), and so can be employed in situations where the latter function might fail. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR backtrace () returns the number of addresses returned in .IR buffer , diff --git a/man3/basename.3 b/man3/basename.3 index 806d10cca..68e57b65d 100644 --- a/man3/basename.3 +++ b/man3/basename.3 @@ -114,7 +114,7 @@ for different paths: "." "." "." ".." "." ".." .fi -.SH "RETURN VALUE" +.SH RETURN VALUE Both .BR dirname () and @@ -122,7 +122,7 @@ and return pointers to null-terminated strings. (Do not pass these pointers to .BR free (3).) -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES There are two different versions of @@ -170,6 +170,6 @@ bname = basename(basec); printf("dirname=%s, basename=%s\\n", dname, bname); .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR basename (1), .BR dirname (1) diff --git a/man3/bcmp.3 b/man3/bcmp.3 index 7db8c1b45..f5cf99760 100644 --- a/man3/bcmp.3 +++ b/man3/bcmp.3 @@ -51,19 +51,19 @@ is zero, .BR bcmp () returns 0. Otherwise it returns a nonzero result. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR bcmp () function returns 0 if the byte sequences are equal, otherwise a nonzero result is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. This function is deprecated (marked as LEGACY in POSIX.1-2001): use .BR memcmp (3) in new programs. POSIX.1-2008 removes the specification of .BR bcmp (). -.SH "SEE ALSO" +.SH SEE ALSO .BR memcmp (3), .BR strcasecmp (3), .BR strcmp (3), diff --git a/man3/bcopy.3 b/man3/bcopy.3 index 3c87a6c14..eef0526ad 100644 --- a/man3/bcopy.3 +++ b/man3/bcopy.3 @@ -47,9 +47,9 @@ bytes from to .IR dest . The result is correct, even when both areas overlap. -.SH "RETURN VALUE" +.SH RETURN VALUE None. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. This function is deprecated (marked as LEGACY in POSIX.1-2001): use .BR memcpy (3) @@ -63,7 +63,7 @@ and .BR memmove (3). POSIX.1-2008 removes the specification of .BR bcopy (). -.SH "SEE ALSO" +.SH SEE ALSO .BR memccpy (3), .BR memcpy (3), .BR memmove (3), diff --git a/man3/bindresvport.3 b/man3/bindresvport.3 index d58c33de1..91f68cd6a 100644 --- a/man3/bindresvport.3 +++ b/man3/bindresvport.3 @@ -86,7 +86,7 @@ is not NULL and .I sin->sin_family is not .BR AF_INET . -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other systems. .SH NOTES diff --git a/man3/bsd_signal.3 b/man3/bsd_signal.3 index fd94bbba9..660643051 100644 --- a/man3/bsd_signal.3 +++ b/man3/bsd_signal.3 @@ -49,7 +49,7 @@ then the system call is automatically restarted. A portable application cannot rely on .BR signal (2) to provide these guarantees. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR bsd_signal () function returns the previous value of the signal handler, or @@ -58,7 +58,7 @@ on error. .SH ERRORS As for .BR signal (2). -.SH "CONFORMING TO" +.SH CONFORMING TO 4.2BSD, POSIX.1-2001. POSIX.1-2008 removes the specification of .BR bsd_signal (), @@ -89,7 +89,7 @@ is a GNU extension; this type is only defined if the .B _GNU_SOURCE feature test macro is defined. -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction (2), .BR signal (2), .BR sysv_signal (3), diff --git a/man3/bsearch.3 b/man3/bsearch.3 index eca877f23..6f10f544f 100644 --- a/man3/bsearch.3 +++ b/man3/bsearch.3 @@ -54,14 +54,14 @@ object and to an array member, in that order, and should return an integer less than, equal to, or greater than zero if the \fIkey\fP object is found, respectively, to be less than, to match, or be greater than the array member. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR bsearch () function returns a pointer to a matching member of the array, or NULL if no match is found. If there are multiple elements that match the key, the element returned is unspecified. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001, C89, C99. .SH EXAMPLE The example below first sorts an array of structures using @@ -113,7 +113,7 @@ main(int argc, char **argv) } .fi .\" this example referred to in qsort.3 -.SH "SEE ALSO" +.SH SEE ALSO .BR hsearch (3), .BR lsearch (3), .BR qsort (3), diff --git a/man3/bstring.3 b/man3/bstring.3 index ea6298b24..ba2d1584e 100644 --- a/man3/bstring.3 +++ b/man3/bstring.3 @@ -77,7 +77,7 @@ and .BR memset () instead. .\" The old functions are not even available on some non-GNU/Linux systems. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp (3), .BR bcopy (3), .BR bzero (3), diff --git a/man3/btowc.3 b/man3/btowc.3 index 020f887ae..627cc13a1 100644 --- a/man3/btowc.3 +++ b/man3/btowc.3 @@ -34,7 +34,7 @@ the .BR btowc () function returns .BR WEOF . -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR btowc () function returns the wide character @@ -44,7 +44,7 @@ If \fIc\fP is or not a valid multibyte sequence of length 1, it returns .BR WEOF . -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES The behavior of @@ -63,7 +63,7 @@ Use either or the thread-safe .BR mbrtowc (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR mbrtowc (3), .BR mbtowc (3), .BR wctob (3) diff --git a/man3/btree.3 b/man3/btree.3 index e1a4c7c24..dcef6211f 100644 --- a/man3/btree.3 +++ b/man3/btree.3 @@ -235,7 +235,7 @@ for any of the errors specified for the library routine .BR dbopen (3). .SH BUGS Only big and little endian byte order is supported. -.SH "SEE ALSO" +.SH SEE ALSO .BR dbopen (3), .BR hash (3), .BR mpool (3), diff --git a/man3/byteorder.3 b/man3/byteorder.3 index a8c03ec9b..45ae0842b 100644 --- a/man3/byteorder.3 +++ b/man3/byteorder.3 @@ -67,14 +67,14 @@ from network byte order to host byte order. On the i386 the host byte order is Least Significant Byte first, whereas the network byte order, as used on the Internet, is Most Significant Byte first. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. Some systems require the inclusion of .I instead of .IR . -.SH "SEE ALSO" +.SH SEE ALSO .BR endian (3), .BR gethostbyname (3), .BR getservent (3) diff --git a/man3/bzero.3 b/man3/bzero.3 index fe39bdabe..dda31d670 100644 --- a/man3/bzero.3 +++ b/man3/bzero.3 @@ -43,15 +43,15 @@ function sets the first bytes of the area starting at .I s to zero (bytes containing \(aq\\0\(aq). -.SH "RETURN VALUE" +.SH RETURN VALUE None. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. This function is deprecated (marked as LEGACY in POSIX.1-2001): use .BR memset (3) in new programs. POSIX.1-2008 removes the specification of .BR bzero (). -.SH "SEE ALSO" +.SH SEE ALSO .BR memset (3), .BR swab (3) diff --git a/man3/cabs.3 b/man3/cabs.3 index 47d2a3b74..917507778 100644 --- a/man3/cabs.3 +++ b/man3/cabs.3 @@ -22,14 +22,14 @@ function returns the absolute value of the complex number The result is a real number. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The function is actually an alias for .I "hypot(a,\ b)" (or, equivalently, .IR "sqrt(a*a\ +\ b*b)" ). -.SH "SEE ALSO" +.SH SEE ALSO .BR abs (3), .BR cimag (3), .BR hypot (3), diff --git a/man3/cacos.3 b/man3/cacos.3 index 0b275d878..ab83d9ff8 100644 --- a/man3/cacos.3 +++ b/man3/cacos.3 @@ -32,7 +32,7 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH EXAMPLE .nf @@ -67,7 +67,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR ccos (3), .BR clog (3), .BR complex (7) diff --git a/man3/cacosh.3 b/man3/cacosh.3 index 8a894aad4..8b734b394 100644 --- a/man3/cacosh.3 +++ b/man3/cacosh.3 @@ -35,7 +35,7 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH EXAMPLE .nf @@ -67,7 +67,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh (3), .BR cabs (3), .BR ccosh (3), diff --git a/man3/canonicalize_file_name.3 b/man3/canonicalize_file_name.3 index 2f0e372ba..864b606e3 100644 --- a/man3/canonicalize_file_name.3 +++ b/man3/canonicalize_file_name.3 @@ -16,7 +16,7 @@ The call .I canonicalize_file_name(path) is equivalent to the call .IR "realpath(path,\ NULL)" . -.SH "CONFORMING TO" +.SH CONFORMING TO The function is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR realpath (3) diff --git a/man3/carg.3 b/man3/carg.3 index c8ca68c0a..941da2637 100644 --- a/man3/carg.3 +++ b/man3/carg.3 @@ -40,12 +40,12 @@ One has: tan(carg(z)) = cimag(z) / creal(z) .fi -.SH "RETURN VALUE" +.SH RETURN VALUE The return value is the range of [\-pi,pi]. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR complex (7) diff --git a/man3/casin.3 b/man3/casin.3 index d64c489cd..f7aefb71b 100644 --- a/man3/casin.3 +++ b/man3/casin.3 @@ -31,9 +31,9 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR clog (3), .BR csin (3), .BR complex (7) diff --git a/man3/casinh.3 b/man3/casinh.3 index e2a001cdd..f4280dd68 100644 --- a/man3/casinh.3 +++ b/man3/casinh.3 @@ -31,9 +31,9 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR asinh (3), .BR cabs (3), .BR cimag (3), diff --git a/man3/catan.3 b/man3/catan.3 index 680fce2ee..b8e4462c7 100644 --- a/man3/catan.3 +++ b/man3/catan.3 @@ -30,7 +30,7 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH EXAMPLE .nf @@ -63,7 +63,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR ccos (3), .BR clog (3), .BR ctan (3), diff --git a/man3/catanh.3 b/man3/catanh.3 index 5a85d8a67..3f964d33c 100644 --- a/man3/catanh.3 +++ b/man3/catanh.3 @@ -32,7 +32,7 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH EXAMPLE .nf @@ -64,7 +64,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR atanh (3), .BR cabs (3), .BR cimag (3), diff --git a/man3/catgets.3 b/man3/catgets.3 index e252c725b..7992ea743 100644 --- a/man3/catgets.3 +++ b/man3/catgets.3 @@ -54,7 +54,7 @@ message-text is contained in an internal buffer area and should be copied by the application if it is to be saved or modified. The return string is always terminated with a null byte. -.SH "RETURN VALUE" +.SH RETURN VALUE .LP On success, .BR catgets () @@ -64,7 +64,7 @@ On failure, .BR catgets () returns the value .IR message . -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES These functions are only available in libc.so.4.4.4c and above. @@ -79,6 +79,6 @@ the specified message. These two possible error returns seem to be discarded in SUSv2 in favor of always returning .IR message . -.SH "SEE ALSO" +.SH SEE ALSO .BR catopen (3), .BR setlocale (3) diff --git a/man3/catopen.3 b/man3/catopen.3 index 9e5047200..243c71660 100644 --- a/man3/catopen.3 +++ b/man3/catopen.3 @@ -107,7 +107,7 @@ closes the message catalog identified by It invalidates any subsequent references to the message catalog defined by .IR catalog . -.SH "RETURN VALUE" +.SH RETURN VALUE The function .BR catopen () returns a message catalog descriptor of type @@ -140,7 +140,7 @@ is set to The language to use if .I flag is 0. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .\" In XPG 1987, Vol. 3 it says: .\" .I "The flag argument of catopen is reserved for future use" @@ -184,6 +184,6 @@ The default search path varies, but usually looks at a number of places below .I /etc/locale and .IR /usr/lib/locale . -.SH "SEE ALSO" +.SH SEE ALSO .BR catgets (3), .BR setlocale (3) diff --git a/man3/cbrt.3 b/man3/cbrt.3 index 5ec9fe547..b1953a5f9 100644 --- a/man3/cbrt.3 +++ b/man3/cbrt.3 @@ -84,10 +84,10 @@ is +0, \-0, positive infinity, negative infinity, or NaN, is returned. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .\" .BR cbrt () .\" was a GNU extension. It is now a C99 requirement. -.SH "SEE ALSO" +.SH SEE ALSO .BR pow (3), .BR sqrt (3) diff --git a/man3/ccos.3 b/man3/ccos.3 index ce401461f..e00836f60 100644 --- a/man3/ccos.3 +++ b/man3/ccos.3 @@ -22,9 +22,9 @@ The complex cosine function is defined as: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cacos (3), .BR csin (3), diff --git a/man3/ccosh.3 b/man3/ccosh.3 index 179631a15..2dcc9975f 100644 --- a/man3/ccosh.3 +++ b/man3/ccosh.3 @@ -22,9 +22,9 @@ The complex hyperbolic cosine function is defined as: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cacosh (3), .BR csinh (3), diff --git a/man3/ceil.3 b/man3/ceil.3 index ad579123c..9fd56f615 100644 --- a/man3/ceil.3 +++ b/man3/ceil.3 @@ -64,7 +64,7 @@ For example, is 1.0, and .IR ceil(\-0.5) is 0.0. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the ceiling of .IR x . @@ -73,7 +73,7 @@ If \fIx\fP is integral, +0, \-0, NaN, or infinite, .SH ERRORS No errors occur. POSIX.1-2001 documents a range error for overflows, but see NOTES. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -104,7 +104,7 @@ etc.). To avoid an overflow, which will produce undefined results, an application should perform a range check on the returned value before assigning it to an integer type. -.SH "SEE ALSO" +.SH SEE ALSO .BR floor (3), .BR lrint (3), .BR nearbyint (3), diff --git a/man3/cerf.3 b/man3/cerf.3 index 3d7cafced..10c961665 100644 --- a/man3/cerf.3 +++ b/man3/cerf.3 @@ -29,11 +29,11 @@ The function .BR cerfc () is defined as cerfc(z) = 1\-cerf(z). .\" must check 1/sqrt(2*pi) ? -.SH "CONFORMING TO" +.SH CONFORMING TO The function names are reserved for future use in C99. .SH AVAILABILITY Not yet in glibc, as at version 2.12. .\" But reserved in NAMESPACE. -.SH "SEE ALSO" +.SH SEE ALSO .BR erf (3), .BR complex (7) diff --git a/man3/cexp.3 b/man3/cexp.3 index 4ee4a9d1b..f786ba2cb 100644 --- a/man3/cexp.3 +++ b/man3/cexp.3 @@ -26,9 +26,9 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cexp2 (3), .BR clog (3), diff --git a/man3/cexp2.3 b/man3/cexp2.3 index 57092b1ea..6c01bba51 100644 --- a/man3/cexp2.3 +++ b/man3/cexp2.3 @@ -17,12 +17,12 @@ Link with \fI\-lm\fP. .SH DESCRIPTION The function returns 2 raised to the power of .IR z . -.SH "CONFORMING TO" +.SH CONFORMING TO These function names are reserved for future use in C99. .SH AVAILABILITY Not yet in glibc, as at version 2.8. .\" But reserved in NAMESPACE. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cexp (3), .BR clog10 (3), diff --git a/man3/cfree.3 b/man3/cfree.3 index 4c843c5bf..1089f2924 100644 --- a/man3/cfree.3 +++ b/man3/cfree.3 @@ -92,7 +92,7 @@ An SCO manual writes: "The cfree routine is provided for compliance to the iBCSe2 standard and simply calls free. The num and size arguments to cfree are not used." -.SH "RETURN VALUE" +.SH RETURN VALUE The SunOS version of .BR cfree () (which is a synonym for @@ -108,7 +108,7 @@ was not a pointer to a block previously allocated by one of the routines in the .BR malloc (3) family. -.SH "CONFORMING TO" +.SH CONFORMING TO The 3-argument version of .BR cfree () as used by SCO conforms to the iBCSe2 standard: diff --git a/man3/cimag.3 b/man3/cimag.3 index 208505541..e0157d5d3 100644 --- a/man3/cimag.3 +++ b/man3/cimag.3 @@ -27,12 +27,12 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES gcc also supports __imag__. That is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR creal (3), .BR complex (7) diff --git a/man3/clearenv.3 b/man3/clearenv.3 index e7cc1771c..30cf9600d 100644 --- a/man3/clearenv.3 +++ b/man3/clearenv.3 @@ -45,7 +45,7 @@ function clears the environment of all name-value pairs and sets the value of the external variable .I environ to NULL. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR clearenv () function returns zero on success, and a nonzero @@ -55,7 +55,7 @@ value on failure. .SH VERSIONS Not in libc4, libc5. In glibc since glibc 2.0. -.SH "CONFORMING TO" +.SH CONFORMING TO Various UNIX variants (DG/UX, HP-UX, QNX, ...). POSIX.9 (bindings for FORTRAN77). POSIX.1-1996 did not accept @@ -92,7 +92,7 @@ functions, then will return an error and the process environment will remain unchanged. .\" .LP .\" HP-UX has a ENOMEM error return. -.SH "SEE ALSO" +.SH SEE ALSO .BR getenv (3), .BR putenv (3), .BR setenv (3), diff --git a/man3/clock.3 b/man3/clock.3 index c3f05afd5..97a325fc2 100644 --- a/man3/clock.3 +++ b/man3/clock.3 @@ -37,7 +37,7 @@ clock \- determine processor time The .BR clock () function returns an approximation of processor time used by the program. -.SH "RETURN VALUE" +.SH RETURN VALUE The value returned is the CPU time used so far as a .IR clock_t ; to get the number of seconds used, divide by @@ -45,7 +45,7 @@ to get the number of seconds used, divide by If the processor time used is not available or its value cannot be represented, the function returns the value .IR (clock_t)\ \-1 . -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001. POSIX requires that .B CLOCKS_PER_SEC @@ -81,7 +81,7 @@ The .BR times (2) function, which explicitly returns (separate) information about the caller and its children, may be preferable. -.SH "SEE ALSO" +.SH SEE ALSO .BR clock_gettime (2), .BR getrusage (2), .BR times (2) diff --git a/man3/clock_getcpuclockid.3 b/man3/clock_getcpuclockid.3 index 32290052b..b2bdf734d 100644 --- a/man3/clock_getcpuclockid.3 +++ b/man3/clock_getcpuclockid.3 @@ -55,7 +55,7 @@ If .I pid is zero, then the clock ID of the CPU-time clock of the calling process is returned. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR clock_getcpuclockid () returns 0; diff --git a/man3/clog.3 b/man3/clog.3 index c2379dd44..57998abba 100644 --- a/man3/clog.3 +++ b/man3/clog.3 @@ -35,9 +35,9 @@ Note that close to zero will cause an overflow. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cexp (3), .BR clog10 (3), diff --git a/man3/clog10.3 b/man3/clog10.3 index 90213ec0f..8d0ff7848 100644 --- a/man3/clog10.3 +++ b/man3/clog10.3 @@ -31,10 +31,10 @@ Note that close to zero will cause an overflow. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. It is reserved for future use in C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cexp (3), .BR clog (3), diff --git a/man3/clog2.3 b/man3/clog2.3 index 373379430..65f09d130 100644 --- a/man3/clog2.3 +++ b/man3/clog2.3 @@ -28,12 +28,12 @@ and Note that .I z close to zero will cause an overflow. -.SH "CONFORMING TO" +.SH CONFORMING TO These function names are reserved for future use in C99. .SH AVAILABILITY Not yet in glibc, as at version 2.8. .\" But reserved in NAMESPACE. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cexp (3), .BR clog (3), diff --git a/man3/closedir.3 b/man3/closedir.3 index 170d49d6b..d499a6792 100644 --- a/man3/closedir.3 +++ b/man3/closedir.3 @@ -48,7 +48,7 @@ also closes the underlying file descriptor associated with .IR dirp . The directory stream descriptor \fIdirp\fP is not available after this call. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR closedir () function returns 0 on success. @@ -59,9 +59,9 @@ is set appropriately. .TP .B EBADF Invalid directory stream descriptor \fIdirp\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR opendir (3), .BR readdir (3), diff --git a/man3/cmsg.3 b/man3/cmsg.3 index 180683254..cb02d6b72 100644 --- a/man3/cmsg.3 +++ b/man3/cmsg.3 @@ -134,7 +134,7 @@ flag is set in the .I msg_flags member of the .IR msghdr . -.SH "CONFORMING TO" +.SH CONFORMING TO This ancillary data model conforms to the POSIX.1g draft, 4.4BSD-Lite, the IPv6 advanced API described in RFC\ 2292 and the SUSv2. .BR CMSG_ALIGN () @@ -210,7 +210,7 @@ memcpy(fdptr, myfds, NUM_FD * sizeof(int)); msg.msg_controllen = cmsg\->cmsg_len; .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR recvmsg (2), .BR sendmsg (2) .PP diff --git a/man3/confstr.3 b/man3/confstr.3 index cd1182dc1..39f0c18a5 100644 --- a/man3/confstr.3 +++ b/man3/confstr.3 @@ -89,7 +89,7 @@ is zero and is NULL, .BR confstr () just returns the value as defined below. -.SH "RETURN VALUE" +.SH RETURN VALUE If .I name is a valid configuration variable, @@ -122,7 +122,7 @@ is set to If the value of .I name is invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH EXAMPLE The following code fragment determines the path where to find @@ -141,7 +141,7 @@ if (pathbuf == NULL) confstr(_CS_PATH, pathbuf, n); .in .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR sh (1), .BR exec (3), .BR system (3) diff --git a/man3/conj.3 b/man3/conj.3 index 1140027d5..cb46c5534 100644 --- a/man3/conj.3 +++ b/man3/conj.3 @@ -28,9 +28,9 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR csqrt (3), .BR complex (7) diff --git a/man3/copysign.3 b/man3/copysign.3 index cd25defb1..c7aaf296f 100644 --- a/man3/copysign.3 +++ b/man3/copysign.3 @@ -80,7 +80,7 @@ If \fIx\fP is a NaN, a NaN with the sign bit of \fIy\fP is returned. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .\" 4.3BSD. This function is defined in IEC 559 (and the appendix with @@ -90,5 +90,5 @@ On architectures where the floating-point formats are not IEEE 754 compliant, the .BR copysign () functions may treat a negative zero as positive. -.SH "SEE ALSO" +.SH SEE ALSO .BR signbit (3) diff --git a/man3/cos.3 b/man3/cos.3 index bbb1244e5..293a0e859 100644 --- a/man3/cos.3 +++ b/man3/cos.3 @@ -95,7 +95,7 @@ is set to An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -108,7 +108,7 @@ Before version 2.10, the glibc implementation did not set to .B EDOM when a domain error occurred. -.SH "SEE ALSO" +.SH SEE ALSO .BR acos (3), .BR asin (3), .BR atan (3), diff --git a/man3/cosh.3 b/man3/cosh.3 index 26c53a312..a804c14a6 100644 --- a/man3/cosh.3 +++ b/man3/cosh.3 @@ -72,7 +72,7 @@ is defined mathematically as: cosh(x) = (exp(x) + exp(\-x)) / 2 .fi -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the hyperbolic cosine of .IR x . @@ -112,7 +112,7 @@ is set to An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -123,7 +123,7 @@ In glibc version 2.3.4 and earlier, an overflow floating-point .RB ( FE_OVERFLOW ) exception is not raised when an overflow occurs. -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh (3), .BR asinh (3), .BR atanh (3), diff --git a/man3/cpow.3 b/man3/cpow.3 index 1714358b2..672a107ab 100644 --- a/man3/cpow.3 +++ b/man3/cpow.3 @@ -27,9 +27,9 @@ raised to the power along the negative real axis.) .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR pow (3), .BR complex (7) diff --git a/man3/cproj.3 b/man3/cproj.3 index 898e98159..c77f982fd 100644 --- a/man3/cproj.3 +++ b/man3/cproj.3 @@ -26,12 +26,12 @@ Every complex infinite value is projected to a single infinite value, namely to positive infinity on the real axis. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES In glibc 2.11 and earlier, the implementation does something different (a \fIstereographic\fP projection onto a Riemann Sphere). .\" http://sources.redhat.com/bugzilla/show_bug.cgi?id=10401 -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR complex (7) diff --git a/man3/creal.3 b/man3/creal.3 index 3d44c5467..ac2efb875 100644 --- a/man3/creal.3 +++ b/man3/creal.3 @@ -27,12 +27,12 @@ One has: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The gcc supports also __real__. That is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cimag (3), .BR complex (7) diff --git a/man3/crypt.3 b/man3/crypt.3 index e33612f74..c10ee3012 100644 --- a/man3/crypt.3 +++ b/man3/crypt.3 @@ -116,7 +116,7 @@ the only thing that the caller should do with this structure is to set .I data->initialized to zero before the first call to .BR crypt_r (). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, a pointer to the encrypted password is returned. On error, NULL is returned. .SH ERRORS @@ -159,7 +159,7 @@ function was not implemented, probably because of U.S.A. export restrictions. .\" .PP .\" Making encrypted data computed using crypt() publicly available has .\" to be considered insecure for the given reasons. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR crypt (): SVr4, 4.3BSD, POSIX.1-2001. .BR crypt_r () @@ -225,7 +225,7 @@ In the MD5 and SHA implementations the entire .I key is significant (instead of only the first 8 bytes in DES). -.SH "SEE ALSO" +.SH SEE ALSO .BR login (1), .BR passwd (1), .BR encrypt (3), diff --git a/man3/csin.3 b/man3/csin.3 index 2c07d67e6..ebced24fe 100644 --- a/man3/csin.3 +++ b/man3/csin.3 @@ -22,9 +22,9 @@ The complex sine function is defined as: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR casin (3), .BR ccos (3), diff --git a/man3/csinh.3 b/man3/csinh.3 index 31a14092f..b81eb8b9b 100644 --- a/man3/csinh.3 +++ b/man3/csinh.3 @@ -22,9 +22,9 @@ The complex hyperbolic sine function is defined as: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR casinh (3), .BR ccosh (3), diff --git a/man3/csqrt.3 b/man3/csqrt.3 index 22655f3e7..15eba1aaf 100644 --- a/man3/csqrt.3 +++ b/man3/csqrt.3 @@ -23,9 +23,9 @@ with a branch cut along the negative real axis. real number.) .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cexp (3), .BR complex (7) diff --git a/man3/ctan.3 b/man3/ctan.3 index 7964580a9..e705d20b7 100644 --- a/man3/ctan.3 +++ b/man3/ctan.3 @@ -22,9 +22,9 @@ The complex tangent function is defined as: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR catan (3), .BR ccos (3), diff --git a/man3/ctanh.3 b/man3/ctanh.3 index 116476940..0edf3b4c0 100644 --- a/man3/ctanh.3 +++ b/man3/ctanh.3 @@ -23,9 +23,9 @@ mathematically as: .fi .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR catanh (3), .BR ccosh (3), diff --git a/man3/ctermid.3 b/man3/ctermid.3 index a0dc7bf44..4fadb4b9d 100644 --- a/man3/ctermid.3 +++ b/man3/ctermid.3 @@ -54,9 +54,9 @@ points to a buffer used to hold the terminal pathname. The symbolic constant .B L_ctermid is the maximum number of characters in the returned pathname. -.SH "RETURN VALUE" +.SH RETURN VALUE The pointer to the pathname. -.SH "CONFORMING TO" +.SH CONFORMING TO Svr4, POSIX.1-2001. .SH BUGS The path returned may not uniquely identify the controlling @@ -66,5 +66,5 @@ terminal; it may, for example, be It is not assured that the program can open the terminal. .\" in glibc 2.3.x, x >= 4, the glibc headers threw an error .\" if ctermid() was given an argument; fixed in 2.4. -.SH "SEE ALSO" +.SH SEE ALSO .BR ttyname (3) diff --git a/man3/ctime.3 b/man3/ctime.3 index f2da055fc..38552e1ee 100644 --- a/man3/ctime.3 +++ b/man3/ctime.3 @@ -272,12 +272,12 @@ returns .I (time_t)\ \-1 and does not alter the members of the broken-down time structure. -.SH "RETURN VALUE" +.SH RETURN VALUE Each of these functions returns the value described, or NULL (\-1 in case of .BR mktime ()) in case an error was detected. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. C89 and C99 specify .BR asctime (), @@ -357,7 +357,7 @@ For portable code .BR tzset (3) should be called before .BR localtime_r (). -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR gettimeofday (2), .BR time (2), diff --git a/man3/daemon.3 b/man3/daemon.3 index dabe1be8c..eff3ad240 100644 --- a/man3/daemon.3 +++ b/man3/daemon.3 @@ -67,7 +67,7 @@ is zero, redirects standard input, standard output and standard error to \fI/dev/null\fP; otherwise, no changes are made to these file descriptors. -.SH "RETURN VALUE" +.SH RETURN VALUE (This function forks, and if the .BR fork (2) succeeds, the parent calls @@ -99,6 +99,6 @@ major and minor numbers. In this case .I errno need not be set. -.SH "SEE ALSO" +.SH SEE ALSO .BR fork (2), .BR setsid (2) diff --git a/man3/dbopen.3 b/man3/dbopen.3 index ec540325c..7bf02dfcd 100644 --- a/man3/dbopen.3 +++ b/man3/dbopen.3 @@ -549,7 +549,7 @@ future version of the interface. .PP None of the access methods provide any form of concurrent access, locking, or transactions. -.SH "SEE ALSO" +.SH SEE ALSO .BR btree (3), .BR hash (3), .BR mpool (3), diff --git a/man3/des_crypt.3 b/man3/des_crypt.3 index a6f5dbded..c4af8bd18 100644 --- a/man3/des_crypt.3 +++ b/man3/des_crypt.3 @@ -127,10 +127,10 @@ is false only for the first two statuses. .SH VERSIONS These routines are present in libc 4.6.27 and later, and in glibc 2.1 and later. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. Not in POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR des (1), .BR crypt (3), .BR xcrypt (3) diff --git a/man3/difftime.3 b/man3/difftime.3 index 1080faa7c..e8e8eac3a 100644 --- a/man3/difftime.3 +++ b/man3/difftime.3 @@ -43,7 +43,7 @@ between time \fItime1\fP and time \fItime0\fP, represented as a Each of the times is specified in calendar time, which means its value is a measurement (in seconds) relative to the Epoch, 1970-01-01 00:00:00 +0000 (UTC). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. .SH NOTES On a POSIX system, @@ -58,7 +58,7 @@ define .fi .RE when the possible overflow in the subtraction is not a concern. -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR gettimeofday (2), .BR time (2), diff --git a/man3/dirfd.3 b/man3/dirfd.3 index c77b0c68c..928994ef9 100644 --- a/man3/dirfd.3 +++ b/man3/dirfd.3 @@ -80,7 +80,7 @@ does not refer to a valid directory stream. .B ENOTSUP The implementation does not support the association of a file descriptor with a directory. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. This function was a BSD extension, present in 4.3BSD-Reno, not in 4.2BSD. .\" It is present in libc5 (since 5.1.2) and in glibc2. @@ -92,7 +92,7 @@ is only available if or .B _SVID_SOURCE is defined. -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2), .BR closedir (3), .BR opendir (3), diff --git a/man3/div.3 b/man3/div.3 index f14e195eb..630d1d3b0 100644 --- a/man3/div.3 +++ b/man3/div.3 @@ -84,9 +84,9 @@ dividing numbers of the indicated type and returning the result in a structure of the indicated name, in all cases with fields \fIquot\fP and \fIrem\fP of the same type as the function arguments. -.SH "RETURN VALUE" +.SH RETURN VALUE The \fIdiv_t\fP (etc.) structure. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89. C99. The functions .BR lldiv () @@ -101,6 +101,6 @@ After .fi the values \fIq.quot\fP and \fIq.rem\fP are \-1 and \-2, respectively. -.SH "SEE ALSO" +.SH SEE ALSO .BR abs (3), .BR remainder (3) diff --git a/man3/dl_iterate_phdr.3 b/man3/dl_iterate_phdr.3 index fbc30f6ef..a9e9ecf57 100644 --- a/man3/dl_iterate_phdr.3 +++ b/man3/dl_iterate_phdr.3 @@ -154,7 +154,7 @@ function returns whatever value was returned by the last call to .SH VERSIONS .BR dl_iterate_phdr () has been supported in glibc since version 2.2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR dl_iterate_phdr () function is Linux-specific and should be avoided in portable applications. @@ -192,7 +192,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR ldd (1), .BR objdump (1), .BR readelf (1), diff --git a/man3/dlopen.3 b/man3/dlopen.3 index e2a50950d..7fbc1f052 100644 --- a/man3/dlopen.3 +++ b/man3/dlopen.3 @@ -378,7 +378,7 @@ provided by glibc since version 2.1, does the same as .BR dlsym () but takes a version string as an additional argument. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001 describes .BR dlclose (), .BR dlerror (), @@ -504,7 +504,7 @@ follows, using \fIbar.c\fP as the example name: .LP gcc \-shared \-nostartfiles \-o bar bar.c .in -.SH "SEE ALSO" +.SH SEE ALSO .BR ld (1), .BR ldd (1), .BR dl_iterate_phdr (3), diff --git a/man3/dprintf.3 b/man3/dprintf.3 index 4a72516e5..5d339e203 100644 --- a/man3/dprintf.3 +++ b/man3/dprintf.3 @@ -65,7 +65,7 @@ except that they output to a file descriptor instead of to a .I stdio stream. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions that are nowadays specified in POSIX.1-2008. .\" .SH NOTES @@ -91,5 +91,5 @@ POSIX.1-2008. .\" .\" A better name would have been .\" .BR fdprintf (). -.SH "SEE ALSO" +.SH SEE ALSO .BR printf (3) diff --git a/man3/drand48.3 b/man3/drand48.3 index 5242fb340..02e186ea7 100644 --- a/man3/drand48.3 +++ b/man3/drand48.3 @@ -199,12 +199,12 @@ has been called, a subsequent call to either or .BR seed48 () will restore the standard values of \fIa\fP and \fIc\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. .SH NOTES These functions are declared obsolete by SVID 3, which states that .BR rand (3) should be used instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR rand (3), .BR random (3) diff --git a/man3/drand48_r.3 b/man3/drand48_r.3 index ab25da0d3..0ca1a4125 100644 --- a/man3/drand48_r.3 +++ b/man3/drand48_r.3 @@ -91,11 +91,11 @@ by filling it with zeros, or by calling one of the functions .BR seed48_r (), or .BR lcong48_r (). -.SH "RETURN VALUE" +.SH RETURN VALUE The return value is 0. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions and are not portable. -.SH "SEE ALSO" +.SH SEE ALSO .BR drand48 (3), .BR rand (3), .BR random (3) diff --git a/man3/dysize.3 b/man3/dysize.3 index 34fc010a5..77355bc6c 100644 --- a/man3/dysize.3 +++ b/man3/dysize.3 @@ -46,11 +46,11 @@ The formula is defined in the macro .I __isleap(year) also found in .IR . -.SH "CONFORMING TO" +.SH CONFORMING TO This function occurs in SunOS 4.x. .SH NOTES This is a compatibility function only. Don't use it in new programs. .\" The SCO version of this function had a year-2000 problem. -.SH "SEE ALSO" +.SH SEE ALSO .BR strftime (3) diff --git a/man3/ecvt.3 b/man3/ecvt.3 index 0bc2a4fdd..c35879fcc 100644 --- a/man3/ecvt.3 +++ b/man3/ecvt.3 @@ -94,7 +94,7 @@ function is identical to .BR ecvt (), except that \fIndigits\fP specifies the number of digits after the decimal point. -.SH "RETURN VALUE" +.SH RETURN VALUE Both the .BR ecvt () and @@ -105,7 +105,7 @@ The static string is overwritten by each call to .BR ecvt () or .BR fcvt (). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr2; marked as LEGACY in POSIX.1-2001. POSIX.1-2008 removes the specifications of @@ -123,7 +123,7 @@ Linux libc4 and libc5 specified the type of as .IR size_t . Not all locales use a point as the radix character ("decimal point"). -.SH "SEE ALSO" +.SH SEE ALSO .BR ecvt_r (3), .BR gcvt (3), .BR qecvt (3), diff --git a/man3/ecvt_r.3 b/man3/ecvt_r.3 index 73ceea380..36611de2a 100644 --- a/man3/ecvt_r.3 +++ b/man3/ecvt_r.3 @@ -81,16 +81,16 @@ See .BR ecvt (3) and .BR qecvt (3). -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return 0 on success, and \-1 otherwise. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. .SH NOTES These functions are obsolete. Instead, .BR sprintf (3) is recommended. -.SH "SEE ALSO" +.SH SEE ALSO .BR ecvt (3), .BR qecvt (3), .BR sprintf (3) diff --git a/man3/encrypt.3 b/man3/encrypt.3 index 96d214549..a65713dc8 100644 --- a/man3/encrypt.3 +++ b/man3/encrypt.3 @@ -104,7 +104,7 @@ Before calling set .I data\->initialized to zero. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions do not return any value. .SH ERRORS Set @@ -115,7 +115,7 @@ On success, it is unchanged. .B ENOSYS The function is not provided. (For example because of former USA export restrictions.) -.SH "CONFORMING TO" +.SH CONFORMING TO The functions .BR encrypt () and @@ -152,7 +152,7 @@ main(void) encrypt(txt, 1); /* decode */ } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR cbc_crypt (3), .BR crypt (3), .BR ecb_crypt (3), diff --git a/man3/end.3 b/man3/end.3 index ade740208..f502ae259 100644 --- a/man3/end.3 +++ b/man3/end.3 @@ -104,7 +104,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR objdump (1), .BR readelf (1), .BR sbrk (2), diff --git a/man3/endian.3 b/man3/endian.3 index ecd0ff6c3..6399d9288 100644 --- a/man3/endian.3 +++ b/man3/endian.3 @@ -71,7 +71,7 @@ The functions with names of the form "le\fInn\fPtoh" convert from little-endian order to host byte order. .SH VERSIONS These functions were added to glibc in version 2.9. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are nonstandard. Similar functions are present on the BSDs, where the required header file is @@ -146,5 +146,5 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR byteorder (3) diff --git a/man3/envz_add.3 b/man3/envz_add.3 index e720b4d81..96bc4b9e5 100644 --- a/man3/envz_add.3 +++ b/man3/envz_add.3 @@ -106,11 +106,11 @@ if there was one. .LP .BR envz_strip () removes all entries with value NULL. -.SH "RETURN VALUE" +.SH RETURN VALUE All envz functions that do memory allocation have a return type of \fIerror_t\fP, and return 0 for success, and \fBENOMEM\fP if an allocation error occurs. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are a GNU extension. Handle with care. .SH EXAMPLE @@ -135,5 +135,5 @@ main(int argc, char *argv[], char *envp[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR argz_add (3) diff --git a/man3/erf.3 b/man3/erf.3 index 65a058d8f..1a650ff8c 100644 --- a/man3/erf.3 +++ b/man3/erf.3 @@ -119,13 +119,13 @@ These functions do not set .IR errno . .\" FIXME . Is it intentional that these functions do not set errno? .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785 -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR cerf (3), .BR erfc (3), .BR exp (3) diff --git a/man3/erfc.3 b/man3/erfc.3 index 66066fdf3..fde53d217 100644 --- a/man3/erfc.3 +++ b/man3/erfc.3 @@ -117,7 +117,7 @@ These functions do not set .IR errno . .\" FIXME . Is it intentional that these functions do not set errno? .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785 -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -130,7 +130,7 @@ functions are provided to avoid the loss accuracy that would occur for the calculation 1-erf(x) for large values of .IR x (for which the value of erf(x) approaches 1). -.SH "SEE ALSO" +.SH SEE ALSO .BR cerf (3), .BR erf (3), .BR exp (3) diff --git a/man3/err.3 b/man3/err.3 index a3b6bd78a..c4abb41e6 100644 --- a/man3/err.3 +++ b/man3/err.3 @@ -104,7 +104,7 @@ and .BR verrx () functions do not return, but exit with the value of the argument .IR eval . -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are nonstandard BSD extensions. .\" .SH HISTORY .\" The diff --git a/man3/errno.3 b/man3/errno.3 index af08aa7b9..534b1ee43 100644 --- a/man3/errno.3 +++ b/man3/errno.3 @@ -526,7 +526,7 @@ It will not work with modern versions of the C library. However, on (very) old UNIX systems, there may be no .I and the declaration is needed. -.SH "SEE ALSO" +.SH SEE ALSO .BR err (3), .BR error (3), .BR perror (3), diff --git a/man3/error.3 b/man3/error.3 index 95bd57bfc..a04f480e6 100644 --- a/man3/error.3 +++ b/man3/error.3 @@ -119,7 +119,7 @@ is assigned the address of a function instead of prefixing the message with the program name and colon. The function should print a suitable string to .IR stderr . -.SH "CONFORMING TO" +.SH CONFORMING TO These functions and variables are GNU extensions, and should not be used in programs intended to be portable. .SH SEE ALSO diff --git a/man3/ether_aton.3 b/man3/ether_aton.3 index 97116203d..d3a70b430 100644 --- a/man3/ether_aton.3 +++ b/man3/ether_aton.3 @@ -120,11 +120,11 @@ struct ether_addr { } .fi .in -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, SunOS. .SH BUGS The glibc 2.2.5 implementation of .BR ether_line () is broken. -.SH "SEE ALSO" +.SH SEE ALSO .BR ethers (5) diff --git a/man3/euidaccess.3 b/man3/euidaccess.3 index 20d425f94..4588bf97e 100644 --- a/man3/euidaccess.3 +++ b/man3/euidaccess.3 @@ -56,7 +56,7 @@ with the same meanings as for is a synonym for .BR euidaccess (), provided for compatibility with some other systems. -.SH "RETURN VALUE" +.SH RETURN VALUE On success (all requested permissions granted), zero is returned. On error (at least one bit in .I mode @@ -71,7 +71,7 @@ As for The .BR eaccess () function was added to glibc in version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are nonstandard. Some other systems have an .\" e.g., FreeBSD 6.1. @@ -92,7 +92,7 @@ with the flags .BR AT_EACCESS and .BR AT_SYMLINK_NOFOLLOW . -.SH "SEE ALSO" +.SH SEE ALSO .BR access (2), .BR chmod (2), .BR chown (2), diff --git a/man3/exec.3 b/man3/exec.3 index 617ec5c06..ccd0f7eca 100644 --- a/man3/exec.3 +++ b/man3/exec.3 @@ -178,7 +178,7 @@ these functions will execute the shell .RI ( /bin/sh ) with the path of the file as its first argument. (If this attempt fails, no further searching is done.) -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR exec () functions only return if an error has have occurred. @@ -194,7 +194,7 @@ for any of the errors specified for The .BR execvpe () function first appeared in glibc 2.11. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. The @@ -236,7 +236,7 @@ and upon which they returned. They now return if any error other than the ones described above occurs. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh (1), .BR execve (2), .BR fork (2), diff --git a/man3/exit.3 b/man3/exit.3 index 2bac07e5e..218288069 100644 --- a/man3/exit.3 +++ b/man3/exit.3 @@ -77,11 +77,11 @@ that may be passed to .BR exit () to indicate successful or unsuccessful termination, respectively. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR exit () function does not return. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001, C89, C99. .SH NOTES .LP @@ -168,7 +168,7 @@ sent to each process in this process group. See .BR setpgid (2) for an explanation of orphaned process groups. -.SH "SEE ALSO" +.SH SEE ALSO .BR _exit (2), .BR setpgid (2), .BR wait (2), diff --git a/man3/exp.3 b/man3/exp.3 index e95f84dcd..e981ec5bf 100644 --- a/man3/exp.3 +++ b/man3/exp.3 @@ -122,13 +122,13 @@ is set to An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR cexp (3), .BR exp10 (3), diff --git a/man3/exp10.3 b/man3/exp10.3 index 0c294678e..6191e7a6e 100644 --- a/man3/exp10.3 +++ b/man3/exp10.3 @@ -71,9 +71,9 @@ For a discussion of the errors that can occur for these functions, see .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787 .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR exp (3), .BR exp2 (3), diff --git a/man3/exp2.3 b/man3/exp2.3 index 88686131d..e5c4fb66a 100644 --- a/man3/exp2.3 +++ b/man3/exp2.3 @@ -85,13 +85,13 @@ For a discussion of the errors that can occur for these functions, see .BR exp (3). .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR cexp2 (3), .BR exp (3), diff --git a/man3/expm1.3 b/man3/expm1.3 index 87cca3638..45fccd10b 100644 --- a/man3/expm1.3 +++ b/man3/expm1.3 @@ -129,7 +129,7 @@ is raised. .\" .\" POSIX.1 specifies an optional range error (underflow) if .\" x is subnormal. Glibc does not implement this. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .\" BSD. .SH BUGS @@ -163,7 +163,7 @@ the glibc implementation did not set to .B ERANGE when a range error occurred. -.SH "SEE ALSO" +.SH SEE ALSO .BR exp (3), .BR log (3), .BR log1p (3) diff --git a/man3/fabs.3 b/man3/fabs.3 index c94565aa9..f905f8d8b 100644 --- a/man3/fabs.3 +++ b/man3/fabs.3 @@ -81,13 +81,13 @@ If is negative infinity or positive infinity, positive infinity is returned. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR abs (3), .BR cabs (3), .BR ceil (3), diff --git a/man3/fclose.3 b/man3/fclose.3 index ce1361821..7ed1fc942 100644 --- a/man3/fclose.3 +++ b/man3/fclose.3 @@ -54,7 +54,7 @@ function flushes the stream pointed to by (writing any buffered output data using .BR fflush (3)) and closes the underlying file descriptor. -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion 0 is returned. Otherwise, .B EOF @@ -85,7 +85,7 @@ for any of the errors specified for the routines .BR write (2) or .BR fflush (3). -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99. .SH NOTES Note that @@ -97,7 +97,7 @@ on disk the kernel buffers must be flushed too, for example, with .BR sync (2) or .BR fsync (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR fcloseall (3), .BR fflush (3), diff --git a/man3/fcloseall.3 b/man3/fcloseall.3 index cca8754c8..7cb9266e3 100644 --- a/man3/fcloseall.3 +++ b/man3/fcloseall.3 @@ -46,14 +46,14 @@ The standard streams, and .I stderr are also closed. -.SH "RETURN VALUE" +.SH RETURN VALUE This function returns 0 if all files were successfully closed; on error, .B EOF is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR fclose (3), .BR fflush (3), diff --git a/man3/fdim.3 b/man3/fdim.3 index 5db5a131b..afd7e2541 100644 --- a/man3/fdim.3 +++ b/man3/fdim.3 @@ -75,7 +75,7 @@ These functions do not set .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796 .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fmax (3) diff --git a/man3/fenv.3 b/man3/fenv.3 index 4a312ec36..3faab7ae3 100644 --- a/man3/fenv.3 +++ b/man3/fenv.3 @@ -254,14 +254,14 @@ of those previously set with those in As before, the object .I *envp must be known to be valid. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return zero on success and nonzero if an error occurred. .\" Earlier seven of these functions were listed as returning void. .\" This was corrected in Corrigendum 1 (ISO/IEC 9899:1999/Cor.1:2001(E)) .\" of the C99 Standard. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO IEC 60559 (IEC 559:1989), ANSI/IEEE 854, C99, POSIX.1-2001. .SH NOTES .SS Glibc notes @@ -319,5 +319,5 @@ this does not occur: .B FLT_ROUNDS always has the value 1. .\" See http://gcc.gnu.org/ml/gcc/2002-02/msg01535.html -.SH "SEE ALSO" +.SH SEE ALSO .BR math_error (7) diff --git a/man3/ferror.3 b/man3/ferror.3 index 55f2a1a1d..062162abd 100644 --- a/man3/ferror.3 +++ b/man3/ferror.3 @@ -102,14 +102,14 @@ return \-1 and set .I errno to .BR EBADF .) -.SH "CONFORMING TO" +.SH CONFORMING TO The functions .BR clearerr (), .BR feof (), and .BR ferror () conform to C89 and C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2), .BR fdopen (3), .BR stdio (3), diff --git a/man3/fexecve.3 b/man3/fexecve.3 index 99b18ba3f..81c88594d 100644 --- a/man3/fexecve.3 +++ b/man3/fexecve.3 @@ -64,7 +64,7 @@ must be opened read-only, and the caller must have permission to execute the file that it refers to. .\" POSIX.1-2008 specifies the O_EXEC flag for open as an alternative, .\" but Linux doesn't support this flag yet. -.SH "RETURN VALUE" +.SH RETURN VALUE A successful call to .BR fexecve () never returns. @@ -91,7 +91,7 @@ file system could not be accessed. .SH VERSIONS .BR fexecve () is implemented since glibc 2.3.2. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. This function is not specified in POSIX.1-2001, and is not widely available on other systems. @@ -103,5 +103,5 @@ is implemented using the file system, so .I /proc needs to be mounted and available at the time of the call. -.SH "SEE ALSO" +.SH SEE ALSO .BR execve (2) diff --git a/man3/fflush.3 b/man3/fflush.3 index 6545e6e6d..4d93d579b 100644 --- a/man3/fflush.3 +++ b/man3/fflush.3 @@ -69,7 +69,7 @@ open output streams. .PP For a nonlocking counterpart, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion 0 is returned. Otherwise, .B EOF @@ -88,7 +88,7 @@ may also fail and set .I errno for any of the errors specified for .BR write (2). -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001, POSIX.1-2008. The standards do not specify the behavior for input streams. @@ -103,7 +103,7 @@ the kernel buffers must be flushed too, for example, with .BR sync (2) or .BR fsync (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR fsync (2), .BR sync (2), .BR write (2), diff --git a/man3/ffs.3 b/man3/ffs.3 index d0791ef40..93045f3c8 100644 --- a/man3/ffs.3 +++ b/man3/ffs.3 @@ -82,11 +82,11 @@ and .BR ffsl () do the same but take arguments of possibly different size. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the position of the first bit set, or 0 if no bits are set in .IR i . -.SH "CONFORMING TO" +.SH CONFORMING TO .BR ffs (): 4.3BSD, POSIX.1-2001. @@ -98,5 +98,5 @@ functions are glibc extensions. .SH NOTES BSD systems have a prototype in .IR . -.SH "SEE ALSO" +.SH SEE ALSO .BR memchr (3) diff --git a/man3/fgetgrent.3 b/man3/fgetgrent.3 index 95b72d415..37d61e2cc 100644 --- a/man3/fgetgrent.3 +++ b/man3/fgetgrent.3 @@ -71,7 +71,7 @@ struct group { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR fgetgrent () function returns a pointer to a @@ -84,9 +84,9 @@ or NULL if there are no more entries or an error occurs. Insufficient memory to allocate .I group structure. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. -.SH "SEE ALSO" +.SH SEE ALSO .BR endgrent (3), .BR fgetgrent_r (3), .BR fopen (3), diff --git a/man3/fgetpwent.3 b/man3/fgetpwent.3 index ee0a4ba56..65fa1d97d 100644 --- a/man3/fgetpwent.3 +++ b/man3/fgetpwent.3 @@ -76,7 +76,7 @@ struct passwd { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR fgetpwent () function returns a pointer to a @@ -93,9 +93,9 @@ structure. .TP .I /etc/passwd password database file -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. -.SH "SEE ALSO" +.SH SEE ALSO .BR endpwent (3), .BR fgetpwent_r (3), .BR fopen (3), diff --git a/man3/fgetwc.3 b/man3/fgetwc.3 index d4efcb5d4..e98d7419d 100644 --- a/man3/fgetwc.3 +++ b/man3/fgetwc.3 @@ -50,7 +50,7 @@ There is no reason ever to use it. .PP For nonlocking counterparts, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR fgetwc () function returns the next wide-character @@ -62,7 +62,7 @@ Apart from the usual ones, there is .B EILSEQ The data obtained from the input stream does not form a valid character. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES The behavior of @@ -79,7 +79,7 @@ reasonable to expect that .BR fgetwc () will actually read a multibyte sequence from the stream and then convert it to a wide character. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetws (3), .BR fputwc (3), .BR ungetwc (3), diff --git a/man3/fgetws.3 b/man3/fgetws.3 index 1d6366892..e5b1cf751 100644 --- a/man3/fgetws.3 +++ b/man3/fgetws.3 @@ -41,13 +41,13 @@ characters at \fIws\fP. .PP For a nonlocking counterpart, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR fgetws () function, if successful, returns \fIws\fP. If end of stream was already reached or if an error occurred, it returns NULL. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES The behavior of @@ -68,6 +68,6 @@ from the stream and then convert it to a wide-character string. This function is unreliable, because it does not permit to deal properly with null wide characters that may be present in the input. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetwc (3), .BR unlocked_stdio (3) diff --git a/man3/finite.3 b/man3/finite.3 index 1067b6371..f77ff3aaa 100644 --- a/man3/finite.3 +++ b/man3/finite.3 @@ -120,5 +120,5 @@ See .\" .BR finite () .\" function occurs in 4.3BSD. .\" see IEEE.3 in the 4.3BSD manual -.SH "SEE ALSO" +.SH SEE ALSO .BR fpclassify (3) diff --git a/man3/flockfile.3 b/man3/flockfile.3 index 9cb9f02c2..9bf946aea 100644 --- a/man3/flockfile.3 +++ b/man3/flockfile.3 @@ -109,14 +109,14 @@ of It does nothing in case some other thread owns \fI*filehandle\fP, and it obtains ownership and increments the lockcount otherwise. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR ftrylockfile () function returns zero for success (the lock was obtained), and nonzero for failure. .SH ERRORS None. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH AVAILABILITY These functions are available when @@ -124,5 +124,5 @@ These functions are available when is defined. They are in libc since libc 5.1.1 and in glibc since glibc 2.0. -.SH "SEE ALSO" +.SH SEE ALSO .BR unlocked_stdio (3) diff --git a/man3/floor.3 b/man3/floor.3 index 9b91cf3e7..0ae4fea3a 100644 --- a/man3/floor.3 +++ b/man3/floor.3 @@ -63,7 +63,7 @@ For example, is 0.0, and .IR floor(\-0.5) is \-1.0. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the floor of .IR x . @@ -72,7 +72,7 @@ If \fIx\fP is integral, +0, \-0, NaN, or an infinity, .SH ERRORS No errors occur. POSIX.1-2001 documents a range error for overflows, but see NOTES. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -94,7 +94,7 @@ of the exponent is smaller than the number of mantissa bits. For the IEEE-754 standard 32-bit and 64-bit floating-point numbers the maximum value of the exponent is 128 (respectively, 1024), and the number of mantissa bits is 24 (respectively, 53).) -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil (3), .BR lrint (3), .BR nearbyint (3), diff --git a/man3/fma.3 b/man3/fma.3 index 4bc86fbed..b46efb6ee 100644 --- a/man3/fma.3 +++ b/man3/fma.3 @@ -149,8 +149,8 @@ These functions do not set .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801 .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR remainder (3), .BR remquo (3) diff --git a/man3/fmax.3 b/man3/fmax.3 index f0e768a1a..e2dc81a50 100644 --- a/man3/fmax.3 +++ b/man3/fmax.3 @@ -52,7 +52,7 @@ If both arguments are NaN, a NaN is returned. No errors occur. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fmin (3) diff --git a/man3/fmemopen.3 b/man3/fmemopen.3 index 75bef911e..bbfef2b90 100644 --- a/man3/fmemopen.3 +++ b/man3/fmemopen.3 @@ -169,7 +169,7 @@ The is similar to .BR open_memstream (), but operates on wide characters instead of bytes. -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion .BR fmemopen (), .BR open_memstream () @@ -188,7 +188,7 @@ and were already available in glibc 1.0.x. .BR open_wmemstream () is available since glibc 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. These functions are not specified in POSIX.1-2001, and are not widely available on other systems. @@ -269,7 +269,7 @@ silently changed the ABI: previously, .BR fmemopen () ignored \(aqb\(aq in .IR mode . -.SH "EXAMPLE" +.SH EXAMPLE The program below uses .BR fmemopen () to open an input buffer, and @@ -334,6 +334,6 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fopen (3), .BR fopencookie (3) diff --git a/man3/fmin.3 b/man3/fmin.3 index 19256ddc7..b5f994fb1 100644 --- a/man3/fmin.3 +++ b/man3/fmin.3 @@ -52,7 +52,7 @@ If both arguments are NaN, a NaN is returned. No errors occur. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fmax (3) diff --git a/man3/fmod.3 b/man3/fmod.3 index 4909796f6..f80eceeec 100644 --- a/man3/fmod.3 +++ b/man3/fmod.3 @@ -69,7 +69,7 @@ function computes the floating-point remainder of dividing \fIx\fP by \fIy\fP. The return value is \fIx\fP \- \fIn\fP * \fIy\fP, where \fIn\fP is the quotient of \fIx\fP / \fIy\fP, rounded toward zero to an integer. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the value \fIx\fP\ \-\ \fIn\fP*\fIy\fP, for some integer \fIn\fP, @@ -127,7 +127,7 @@ An invalid floating-point exception is raised. .\" POSIX.1 documents an optional underflow error, but AFAICT it doesn't .\" (can't?) occur -- mtk, Jul 2008 -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -141,5 +141,5 @@ to .B EDOM when a domain error occurred for an infinite .IR x . -.SH "SEE ALSO" +.SH SEE ALSO .BR remainder (3) diff --git a/man3/fmtmsg.3 b/man3/fmtmsg.3 index 78f712940..31e48fb8a 100644 --- a/man3/fmtmsg.3 +++ b/man3/fmtmsg.3 @@ -145,7 +145,7 @@ Using or the environment variable .B SEV_LEVEL you can add more levels and strings to print. -.SH "RETURN VALUE" +.SH RETURN VALUE The function can return 4 values: .TP 12n .B MM_OK @@ -218,7 +218,7 @@ is the string printed when a message of this class is processed by .SH VERSIONS .BR fmtmsg () is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO The functions .BR fmtmsg () and @@ -290,6 +290,6 @@ the output becomes: unknown mount option TO FIX: See mount(8). .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR addseverity (3), .BR perror (3) diff --git a/man3/fnmatch.3 b/man3/fnmatch.3 index 3f6b8b686..c400c14ce 100644 --- a/man3/fnmatch.3 +++ b/man3/fnmatch.3 @@ -83,19 +83,19 @@ use of glibc and is only implemented in certain cases. .B FNM_CASEFOLD If this flag (a GNU extension) is set, the pattern is matched case-insensitively. -.SH "RETURN VALUE" +.SH RETURN VALUE Zero if .I string matches .IR pattern , .B FNM_NOMATCH if there is no match or another nonzero value if there is an error. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.2. The .BR FNM_FILE_NAME ", " FNM_LEADING_DIR ", and " FNM_CASEFOLD flags are GNU extensions. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh (1), .BR glob (3), .BR scandir (3), diff --git a/man3/fopen.3 b/man3/fopen.3 index 318a062f6..a3f274754 100644 --- a/man3/fopen.3 +++ b/man3/fopen.3 @@ -184,7 +184,7 @@ The primary use of the .BR freopen () function is to change the file associated with a standard text stream .RI ( stderr ", " stdin ", or " stdout ). -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion .BR fopen (), .BR fdopen () @@ -241,7 +241,7 @@ for any of the errors specified for the routines .BR fclose (3) and .BR fflush (3). -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR fopen () and @@ -343,7 +343,7 @@ The current implementation of .BR fdopen () parses at most 5 characters in .IR mode . -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2), .BR fclose (3), .BR fileno (3), diff --git a/man3/fpathconf.3 b/man3/fpathconf.3 index f2b5a454d..6da419159 100644 --- a/man3/fpathconf.3 +++ b/man3/fpathconf.3 @@ -155,7 +155,7 @@ returns nonzero if special character processing can be disabled, where or .I path must refer to a terminal. -.SH "RETURN VALUE" +.SH RETURN VALUE The limit is returned, if one exists. If the system does not have a limit for the requested resource, \-1 is returned, and @@ -164,7 +164,7 @@ is unchanged. If there is an error, \-1 is returned, and .I errno is set to reflect the nature of the error. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES Files with name lengths longer than the value returned for @@ -175,7 +175,7 @@ may exist in the given directory. .PP Some returned values may be huge; they are not suitable for allocating memory. -.SH "SEE ALSO" +.SH SEE ALSO .BR getconf (1), .BR open (2), .BR statfs (2), diff --git a/man3/fpclassify.3 b/man3/fpclassify.3 index 018062c4c..41dd83fe8 100644 --- a/man3/fpclassify.3 +++ b/man3/fpclassify.3 @@ -111,7 +111,7 @@ returns 1 if is positive infinity, and \-1 if .I x is negative infinity. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1. For @@ -125,7 +125,7 @@ returns a nonzero value (actually: 1) if .I x is positive infinity or negative infinity. (This is all that C99 requires.) -.SH "SEE ALSO" +.SH SEE ALSO .BR finite (3), .BR INFINITY (3), .BR isgreater (3), diff --git a/man3/fpurge.3 b/man3/fpurge.3 index 39a6fccfb..e9bc7250b 100644 --- a/man3/fpurge.3 +++ b/man3/fpurge.3 @@ -53,7 +53,7 @@ See also The function .BR __fpurge () does precisely the same, but without returning a value. -.SH "RETURN VALUE" +.SH RETURN VALUE Upon successful completion .BR fpurge () returns 0. @@ -65,7 +65,7 @@ appropriately. .B EBADF .I stream is not an open stream. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are nonstandard and not portable. The function .BR fpurge () @@ -75,7 +75,7 @@ The function was introduced in Solaris, and is present in glibc 2.1.95 and later. .SH NOTES Usually it is a mistake to want to discard input buffers. -.SH "SEE ALSO" +.SH SEE ALSO .\" .BR fclean (3), .BR fflush (3), .BR setbuf (3), diff --git a/man3/fputwc.3 b/man3/fputwc.3 index 227dcecdd..7d72dd1a4 100644 --- a/man3/fputwc.3 +++ b/man3/fputwc.3 @@ -49,7 +49,7 @@ There is no reason ever to use it. .PP For nonlocking counterparts, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR fputwc () function returns \fIwc\fP if no error occurred, or @@ -60,7 +60,7 @@ Apart from the usual ones, there is .TP .B EILSEQ Conversion of \fIwc\fP to the stream's encoding fails. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES The behavior of @@ -77,7 +77,7 @@ reasonable to expect that .BR fputwc () will actually write the multibyte sequence corresponding to the wide character \fIwc\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetwc (3), .BR fputws (3), .BR unlocked_stdio (3) diff --git a/man3/fputws.3 b/man3/fputws.3 index bfa0b11a2..1ee6ffc51 100644 --- a/man3/fputws.3 +++ b/man3/fputws.3 @@ -32,13 +32,13 @@ not including the terminating null wide character (L\(aq\\0\(aq), to \fIstream\f .PP For a nonlocking counterpart, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR fputws () function returns a nonnegative integer if the operation was successful, or \-1 to indicate an error. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES The behavior of @@ -55,6 +55,6 @@ reasonable to expect that .BR fputws () will actually write the multibyte string corresponding to the wide-character string \fIws\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR fputwc (3), .BR unlocked_stdio (3) diff --git a/man3/fread.3 b/man3/fread.3 index f273bb211..f85066b78 100644 --- a/man3/fread.3 +++ b/man3/fread.3 @@ -78,7 +78,7 @@ obtaining them from the location given by .PP For nonlocking counterparts, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR fread () and @@ -98,9 +98,9 @@ does not distinguish between end-of-file and error, and callers must use and .BR ferror (3) to determine which occurred. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR read (2), .BR write (2), .BR feof (3), diff --git a/man3/frexp.3 b/man3/frexp.3 index 325c8227c..85e2dbbc3 100644 --- a/man3/frexp.3 +++ b/man3/frexp.3 @@ -66,7 +66,7 @@ The .BR frexp () function is used to split the number \fIx\fP into a normalized fraction and an exponent which is stored in \fIexp\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR frexp () function returns the normalized fraction. @@ -93,7 +93,7 @@ positive infinity (negative infinity) is returned, and the value of is unspecified. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -132,6 +132,6 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR ldexp (3), .BR modf (3) diff --git a/man3/fseek.3 b/man3/fseek.3 index f38b601a1..20561fc0b 100644 --- a/man3/fseek.3 +++ b/man3/fseek.3 @@ -116,7 +116,7 @@ On some non-UNIX systems, an .I fpos_t object may be a complex object and these routines may be the only way to portably reposition a text stream. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR rewind () function returns no value. @@ -163,8 +163,8 @@ for any of the errors specified for the routines .BR lseek (2), and .BR malloc (3). -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek (2), .BR fseeko (3) diff --git a/man3/fseeko.3 b/man3/fseeko.3 index 41ed2fcec..c205198d1 100644 --- a/man3/fseeko.3 +++ b/man3/fseeko.3 @@ -72,11 +72,11 @@ is set to indicate the error. .SH ERRORS See the ERRORS in .BR fseek (3). -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv2, POSIX.1-2001. .SH NOTES These functions are found on System V-like systems. They are not present in libc4, libc5, glibc 2.0 but are available since glibc 2.1. -.SH "SEE ALSO" +.SH SEE ALSO .BR fseek (3) diff --git a/man3/ftime.3 b/man3/ftime.3 index a6ad1af60..345ab2860 100644 --- a/man3/ftime.3 +++ b/man3/ftime.3 @@ -65,10 +65,10 @@ applies locally during the appropriate part of the year. .LP POSIX.1-2001 says that the contents of the \fItimezone\fP and \fIdstflag\fP fields are unspecified; avoid relying on them. -.SH "RETURN VALUE" +.SH RETURN VALUE This function always returns 0. (POSIX.1-2001 specifies, and some systems document, a \-1 error return.) -.SH "CONFORMING TO" +.SH CONFORMING TO 4.2BSD, POSIX.1-2001. POSIX.1-2008 removes the specification of .BR ftime (). @@ -92,6 +92,6 @@ glibc 2.1.1 is correct again. .\" The .\" .BR ftime () .\" function appeared in 4.2BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR gettimeofday (2), .BR time (2) diff --git a/man3/ftok.3 b/man3/ftok.3 index 2e2e9d4c4..0e73129fb 100644 --- a/man3/ftok.3 +++ b/man3/ftok.3 @@ -56,7 +56,7 @@ name the same file, when the same value of is used. The value returned should be different when the (simultaneously existing) files or the project IDs differ. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the generated .I key_t value is returned. @@ -65,7 +65,7 @@ On failure \-1 is returned, with indicating the error as for the .BR stat (2) system call. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES Under libc4 and libc5 (and under SunOS 4.x) the prototype was: @@ -96,7 +96,7 @@ Collisions may easily happen, for example between files on .I /dev/hda1 and files on .IR /dev/sda1 . -.SH "SEE ALSO" +.SH SEE ALSO .BR msgget (2), .BR semget (2), .BR shmget (2), diff --git a/man3/fts.3 b/man3/fts.3 index 9f19c05dc..89beeb4fe 100644 --- a/man3/fts.3 +++ b/man3/fts.3 @@ -771,7 +771,7 @@ as follows: The options were invalid. .SH VERSIONS These functions are available in Linux since glibc2. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD. .\" The following statement is years old, and seems no closer to .\" being true -- mtk diff --git a/man3/ftw.3 b/man3/ftw.3 index e3449c54c..9095cd656 100644 --- a/man3/ftw.3 +++ b/man3/ftw.3 @@ -299,7 +299,7 @@ is the depth of in the directory tree, relative to the root of the tree .RI ( dirpath , which has depth 0). -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return 0 on success, and \-1 if an error occurs. If \fIfn\fP() returns nonzero, @@ -316,7 +316,7 @@ then the only nonzero value that should be used by \fIfn\fP() to terminate the tree walk is \fBFTW_STOP\fP, and that value is returned as the result of .BR nftw (). -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, SVr4, SUSv1. POSIX.1-2008 marks .BR ftw () @@ -401,7 +401,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR stat (2), .BR fts (3), .BR readdir (3) diff --git a/man3/futimes.3 b/man3/futimes.3 index f4d34f44e..58094c026 100644 --- a/man3/futimes.3 +++ b/man3/futimes.3 @@ -58,7 +58,7 @@ with the difference that if .I filename refers to a symbolic link, then the link is not dereferenced: instead, the timestamps of the symbolic link are changed. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -84,10 +84,10 @@ is available since glibc 2.3. is available since glibc 2.6, and is implemented using the .BR utimensat (2) system call, which is supported since kernel 2.6.22. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are not specified in any standard. Other than Linux, they are only available on the BSDs. -.SH "SEE ALSO" +.SH SEE ALSO .BR utime (2), .BR utimensat (2), .BR symlink (7) diff --git a/man3/fwide.3 b/man3/fwide.3 index 37b155154..fa3daec61 100644 --- a/man3/fwide.3 +++ b/man3/fwide.3 @@ -66,7 +66,7 @@ if \fImode\fP is greater than 0, or to byte oriented if \fImode\fP is less than 0). It then returns a value denoting the current orientation, as above. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR fwide () function returns the stream's orientation, after possibly @@ -74,7 +74,7 @@ changing it. A positive return value means wide-character oriented. A negative return value means byte oriented. A return value of zero means undecided. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES Wide-character output to a byte oriented stream can be performed through the @@ -93,6 +93,6 @@ function with the and .B %s directives. -.SH "SEE ALSO" +.SH SEE ALSO .BR fprintf (3), .BR fwprintf (3) diff --git a/man3/gamma.3 b/man3/gamma.3 index c2bdbefc7..d4a00b1f8 100644 --- a/man3/gamma.3 +++ b/man3/gamma.3 @@ -59,7 +59,7 @@ See .SH ERRORS See .BR lgamma (3). -.SH "CONFORMING TO" +.SH CONFORMING TO Because of historical variations in behavior across systems, this function is not specified in any standard. .SH NOTES @@ -91,7 +91,7 @@ the "true gamma" function. .\" The FreeBSD man page says about gamma() that it is like lgamma() .\" except that is does not set signgam. .\" Also, that 4.4BSD has a gamma() that computes the true gamma function. -.SH "SEE ALSO" +.SH SEE ALSO .BR lgamma (3), .BR signgam (3), .BR tgamma (3) diff --git a/man3/gcvt.3 b/man3/gcvt.3 index 3afc77817..791826ad5 100644 --- a/man3/gcvt.3 +++ b/man3/gcvt.3 @@ -67,12 +67,12 @@ ASCII string and stores the result in \fIbuf\fP. It produces \fIndigit\fP significant digits in either .BR printf (3) F format or E format. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR gcvt () function returns the address of the string pointed to by \fIbuf\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO Marked as LEGACY in POSIX.1-2001. POSIX.1-2008 removes the specification of .BR gcvt (), @@ -81,7 +81,7 @@ recommending the use of instead (though .BR snprintf (3) may be preferable). -.SH "SEE ALSO" +.SH SEE ALSO .BR ecvt (3), .BR fcvt (3), .BR sprintf (3) diff --git a/man3/getaddrinfo.3 b/man3/getaddrinfo.3 index eb005f1a5..93fdf7041 100644 --- a/man3/getaddrinfo.3 +++ b/man3/getaddrinfo.3 @@ -470,7 +470,7 @@ IDNA_ALLOW_UNASSIGNED (allow unassigned Unicode code points) and IDNA_USE_STD3_ASCII_RULES (check output to make sure it is a STD3 conforming hostname) flags respectively to be used in the IDNA handling. -.SH "RETURN VALUE" +.SH RETURN VALUE .\" FIXME glibc defines the following additional errors, some which .\" can probably be returned by getaddrinfo(); they need to .\" be documented. @@ -577,14 +577,14 @@ The .BR gai_strerror () function translates these error codes to a human readable string, suitable for error reporting. -.SH "FILES" +.SH FILES .I /etc/gai.conf -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. The .BR getaddrinfo () function is documented in RFC\ 2553. -.SH "NOTES" +.SH NOTES .BR getaddrinfo () supports the .IB address % scope-id @@ -812,7 +812,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .\" .BR getipnodebyaddr (3), .\" .BR getipnodebyname (3), .BR getaddrinfo_a (3), diff --git a/man3/getaddrinfo_a.3 b/man3/getaddrinfo_a.3 index 73505f804..ef6c63138 100644 --- a/man3/getaddrinfo_a.3 +++ b/man3/getaddrinfo_a.3 @@ -237,7 +237,7 @@ If .I req is NULL, an attempt is made to cancel all outstanding requests that the process has made. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getaddrinfo_a () function returns 0 if all of the requests have been enqueued successfully, @@ -300,7 +300,7 @@ The .BR gai_strerror (3) function translates these error codes to a human readable string, suitable for error reporting. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions; they first appeared in glibc in version 2.2.3. .SH NOTES @@ -596,7 +596,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getaddrinfo (3), .BR inet (3), .BR lio_listio (3), diff --git a/man3/getauxval.3 b/man3/getauxval.3 index 3b456edff..68c529e53 100755 --- a/man3/getauxval.3 +++ b/man3/getauxval.3 @@ -180,7 +180,7 @@ No errors are diagnosed. The .BR getauxval () function was added to glibc in version 2.16. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a nonstandard glibc extension. .SH NOTES The primary consumer of the information in the auxiliary vector @@ -206,7 +206,7 @@ be obtained via see .BR proc (5) for more information. -.SH "SEE ALSO" +.SH SEE ALSO .BR secure_getenv (3), .BR ld-linux.so (8) diff --git a/man3/getcontext.3 b/man3/getcontext.3 index a04d51b6c..ca43ac7ec 100644 --- a/man3/getcontext.3 +++ b/man3/getcontext.3 @@ -111,7 +111,7 @@ program instruction following the instruction interrupted by the signal". However, this sentence was removed in SUSv2, and the present verdict is "the result is unspecified". -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, .BR getcontext () returns 0 and @@ -121,7 +121,7 @@ On error, both return \-1 and set \fIerrno\fP appropriately. .SH ERRORS None defined. -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv2, POSIX.1-2001. POSIX.1-2008 removes the specification of .BR getcontext (), @@ -155,7 +155,7 @@ Use or .BR setcontext () instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction (2), .BR sigaltstack (2), .BR sigprocmask (2), diff --git a/man3/getcwd.3 b/man3/getcwd.3 index 35f5b1990..486be14bf 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -151,7 +151,7 @@ furthermore, its value may depend on the file system, see For portability and security reasons, use of .BR getwd () is deprecated. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return a pointer to a string containing the pathname of the current working directory. In the case @@ -203,7 +203,7 @@ The argument is less than the length of the absolute pathname of the working directory, including the terminating null byte. You need to allocate a bigger array and try again. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR getcwd () conforms to POSIX.1-2001. Note however that POSIX.1-2001 leaves the behavior of @@ -244,7 +244,7 @@ directory (".") and calling .BR fchdir (2) to return is usually a faster and more reliable alternative when sufficiently many file descriptors are available, especially on platforms other than Linux. -.SH "SEE ALSO" +.SH SEE ALSO .BR chdir (2), .BR fchdir (2), .BR open (2), diff --git a/man3/getdate.3 b/man3/getdate.3 index 7f30f9c5b..e57ea2f54 100644 --- a/man3/getdate.3 +++ b/man3/getdate.3 @@ -129,7 +129,7 @@ it returns errors via the function result value, and returns the resulting broken-down time in the caller-allocated buffer pointed to by the argument .IR res . -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, .BR getdate () returns a pointer to a @@ -190,7 +190,7 @@ File containing format patterns. .BR TZ ", " LC_TIME Variables used by .BR strptime (3). -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES The POSIX.1-2001 specification for @@ -295,7 +295,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR time (2), .BR localtime (3), .BR setlocale (3), diff --git a/man3/getdirentries.3 b/man3/getdirentries.3 index 3feed8f86..49ac82823 100644 --- a/man3/getdirentries.3 +++ b/man3/getdirentries.3 @@ -53,7 +53,7 @@ Reading starts at offset and .I *basep is updated with the new position after reading. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR getdirentries () returns the number of bytes read or zero when at the end of the directory. If an error occurs, \-1 is returned, and @@ -61,7 +61,7 @@ If an error occurs, \-1 is returned, and is set appropriately. .SH ERRORS See the Linux library source code for details. -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs, and a few other systems. Use @@ -69,6 +69,6 @@ Use and .BR readdir (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek (2), .BR open (2) diff --git a/man3/getdtablesize.3 b/man3/getdtablesize.3 index 76a1fddec..00cdf9eb9 100644 --- a/man3/getdtablesize.3 +++ b/man3/getdtablesize.3 @@ -58,7 +58,7 @@ _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED .BR getdtablesize () returns the maximum number of files a process can have open, one more than the largest possible value for a file descriptor. -.SH "RETURN VALUE" +.SH RETURN VALUE The current limit on the number of open files per process. .SH ERRORS On Linux, @@ -66,7 +66,7 @@ On Linux, can return any of the errors described for .BR getrlimit (2); see NOTES below. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.4BSD (the .BR getdtablesize () function first appeared in 4.2BSD). @@ -87,7 +87,7 @@ when that fails. The libc4 and libc5 versions return .B OPEN_MAX (set to 256 since Linux 0.98.4). -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR dup (2), .BR getrlimit (2), diff --git a/man3/getenv.3 b/man3/getenv.3 index d122f78e9..6f85179ed 100644 --- a/man3/getenv.3 +++ b/man3/getenv.3 @@ -83,7 +83,7 @@ function is intended for use in general-purpose libraries to avoid vulnerabilities that could occur if set-user-ID or set-group-ID programs accidentally trusted the environment. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getenv () function returns a pointer to the value in the @@ -91,7 +91,7 @@ environment, or NULL if there is no match. .SH VERSIONS .BR secure_getenv () first appeared in glibc 2.17. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR getenv (): SVr4, POSIX.1-2001, 4.3BSD, C89, C99. @@ -124,7 +124,7 @@ The "secure execution" mode of is controlled by the .B AT_SECURE flag contained in the auxiliary vector passed from the kernel to user space. -.SH "SEE ALSO" +.SH SEE ALSO .BR clearenv (3), .BR getauxval (3), .BR putenv (3), diff --git a/man3/getfsent.3 b/man3/getfsent.3 index 93893c932..bae619f1a 100644 --- a/man3/getfsent.3 +++ b/man3/getfsent.3 @@ -92,7 +92,7 @@ for which the field matches the .I mount_point argument. -.SH "RETURN VALUE" +.SH RETURN VALUE Upon success, the functions .BR getfsent (), .BR getfsfile (), @@ -106,7 +106,7 @@ Upon failure or end-of-file, these functions return NULL and 0, respectively. .\" The .\" .BR getfsent () .\" function appeared in 4.0BSD; the other four functions appeared in 4.3BSD. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are not in POSIX.1-2001. Several operating systems have them, e.g., *BSD, SunOS, Digital UNIX, AIX (which also has a @@ -128,6 +128,6 @@ and .BR getfsspec () only return the first occurrence, these two functions are not suitable for use under Linux. -.SH "SEE ALSO" +.SH SEE ALSO .BR getmntent (3), .BR fstab (5) diff --git a/man3/getgrent.3 b/man3/getgrent.3 index 956b7fab2..c694f6c96 100644 --- a/man3/getgrent.3 +++ b/man3/getgrent.3 @@ -101,7 +101,7 @@ struct group { .PP For more information about the fields of this structure, see .BR group (5). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getgrent () function returns a pointer to a @@ -150,9 +150,9 @@ Insufficient buffer space supplied. .TP .I /etc/group local group database file -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetgrent (3), .BR getgrent_r (3), .BR getgrgid (3), diff --git a/man3/getgrent_r.3 b/man3/getgrent_r.3 index 87d7a8615..4c59b6d4b 100644 --- a/man3/getgrent_r.3 +++ b/man3/getgrent_r.3 @@ -97,7 +97,7 @@ is stored in the provided buffer .IR *gbuf , and a pointer to this \fIstruct group\fP is returned in .IR *gbufp . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return 0 and .I *gbufp is a pointer to the \fIstruct group\fP. @@ -112,7 +112,7 @@ No more entries. .B ERANGE Insufficient buffer space supplied. Try again with larger buffer. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions, done in a style resembling the POSIX version of functions like .BR getpwnam_r (3). @@ -179,7 +179,7 @@ main(void) .\" printf("getgrent_r: %s", strerror(i)); .\" exit(EXIT_FAILURE); .\" } -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetgrent (3), .BR getgrent (3), .BR getgrgid (3), diff --git a/man3/getgrnam.3 b/man3/getgrnam.3 index 62ca333de..08c38c973 100644 --- a/man3/getgrnam.3 +++ b/man3/getgrnam.3 @@ -131,7 +131,7 @@ or an initial suggested size for the call fails with .BR ERANGE , in which case the caller can retry with a larger buffer.) -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getgrnam () and @@ -205,7 +205,7 @@ Insufficient buffer space supplied. .TP .I /etc/group local group database file -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES The formulation given above under "RETURN VALUE" is from POSIX.1-2001. @@ -228,7 +228,7 @@ situation: 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM and probably others. .\" FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 - give EPERM .\" SunOS 5.8 - gives EBADF .\" Tru64 5.1b, HP-UX-11i, SunOS 5.7 - give 0 -.SH "SEE ALSO" +.SH SEE ALSO .BR endgrent (3), .BR fgetgrent (3), .BR getgrent (3), diff --git a/man3/getgrouplist.3 b/man3/getgrouplist.3 index 7c9f33972..92416dc73 100644 --- a/man3/getgrouplist.3 +++ b/man3/getgrouplist.3 @@ -73,7 +73,7 @@ including .IR group ; this value may be greater than the number of groups stored in .IR groups . -.SH "RETURN VALUE" +.SH RETURN VALUE If the number of groups of which .I user is a member is less than or equal to @@ -91,9 +91,9 @@ In this case the value returned in .IR *ngroups can be used to resize the buffer passed to a further call .BR getgrouplist (). -.SH "VERSIONS" +.SH VERSIONS This function is present since glibc 2.2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is nonstandard; it appears on most BSDs. .SH BUGS In glibc versions before 2.3.3, @@ -184,7 +184,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getgroups (2), .BR setgroups (2), .BR getgrent (3), diff --git a/man3/gethostbyname.3 b/man3/gethostbyname.3 index ab27e66a1..0f9687b7c 100644 --- a/man3/gethostbyname.3 +++ b/man3/gethostbyname.3 @@ -261,7 +261,7 @@ order), terminated by a NULL pointer. .TP .I h_addr The first address in \fIh_addr_list\fP for backward compatibility. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR gethostbyname () and @@ -298,7 +298,7 @@ host database file .TP .I /etc/nsswitch.conf name service switch configuration -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001 specifies .BR gethostbyname (), .BR gethostbyaddr (), @@ -424,7 +424,7 @@ is passed in does not recognize components of a dotted IPv4 address string that are expressed in hexadecimal. .\" http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=482973 -.SH "SEE ALSO" +.SH SEE ALSO .BR getaddrinfo (3), .\" .BR getipnodebyaddr (3), .\" .BR getipnodebyname (3), diff --git a/man3/gethostid.3 b/man3/gethostid.3 index 1f4f3813e..937b5e1bb 100644 --- a/man3/gethostid.3 +++ b/man3/gethostid.3 @@ -68,7 +68,7 @@ and thus usually never needs to be set. The .BR sethostid () call is restricted to the superuser. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR gethostid () returns the 32-bit identifier for the current host as set by .BR sethostid (). @@ -89,7 +89,7 @@ to store the host ID. .B EPERM The calling process's effective user or group ID is not the same as its corresponding real ID. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.2BSD; these functions were dropped in 4.4BSD. SVr4 includes .BR gethostid () @@ -121,6 +121,6 @@ and returns a value obtained by bit-twiddling the IPv4 address. (This value may not be unique.) .SH BUGS It is impossible to ensure that the identifier is globally unique. -.SH "SEE ALSO" +.SH SEE ALSO .BR hostid (1), .BR gethostbyname (3) diff --git a/man3/getipnodebyname.3 b/man3/getipnodebyname.3 index ec0dc7a00..3210e846d 100644 --- a/man3/getipnodebyname.3 +++ b/man3/getipnodebyname.3 @@ -181,7 +181,7 @@ and .I len must be set to .IR "sizeof(struct in6_addr)" . -.SH "RETURN VALUE" +.SH RETURN VALUE A NULL pointer is returned if an error occurred, and .I error_num will contain an error code from the following list: @@ -253,7 +253,7 @@ is This is an array of one or more pointers to network address structures for the network host. The array is terminated by a NULL pointer. -.SH "CONFORMING TO" +.SH CONFORMING TO RFC\ 2553. .\" Not in POSIX.1-2001. .SH NOTES @@ -261,7 +261,7 @@ These functions were present in glibc 2.1.91-95, but were removed again. Several UNIX-like systems support them, but all call them deprecated. -.SH "SEE ALSO" +.SH SEE ALSO .BR getaddrinfo (3), .BR getnameinfo (3), .BR inet_ntop (3), diff --git a/man3/getline.3 b/man3/getline.3 index 2e5146d55..f9425ca45 100644 --- a/man3/getline.3 +++ b/man3/getline.3 @@ -105,7 +105,7 @@ As with .BR getline (), a delimiter character is not added if one was not present in the input before end of file was reached. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR getline () and @@ -129,14 +129,14 @@ is NULL, or is not valid). .SH VERSIONS These functions are available since libc 4.6.27. -.SH "CONFORMING TO" +.SH CONFORMING TO Both .BR getline () and .BR getdelim () were originally GNU extensions. They were standardized in POSIX.1-2008. -.SH "EXAMPLE" +.SH EXAMPLE .nf #define _GNU_SOURCE #include @@ -163,7 +163,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR read (2), .BR fgets (3), .BR fopen (3), diff --git a/man3/getloadavg.3 b/man3/getloadavg.3 index 55552cd3b..8cf7ab551 100644 --- a/man3/getloadavg.3 +++ b/man3/getloadavg.3 @@ -60,7 +60,7 @@ the number of samples actually retrieved is returned. .\" 4.3BSD Reno . .SH VERSIONS This function is available in glibc since version 2.2. -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs and Solaris. .\" mdoc seems to have a bug - there must be no newline here diff --git a/man3/getlogin.3 b/man3/getlogin.3 index 2cfd8c8e4..1a3cab5fb 100644 --- a/man3/getlogin.3 +++ b/man3/getlogin.3 @@ -92,7 +92,7 @@ For most purposes, it is more useful to use the environment variable \fBLOGNAME\fP to find out who the user is. This is more flexible precisely because the user can set \fBLOGNAME\fP arbitrarily. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR getlogin () returns a pointer to the username when successful, and NULL on failure. @@ -135,7 +135,7 @@ password database file \fI/var/run/utmp\fP (traditionally \fI/etc/utmp\fP; some libc versions used \fI/var/adm/utmp\fP) -.SH "CONFORMING TO" +.SH CONFORMING TO .BR getlogin () and .BR getlogin_r () @@ -190,7 +190,7 @@ instead, if that is what you meant. .B Do not use .BR cuserid (). -.SH "SEE ALSO" +.SH SEE ALSO .BR geteuid (2), .BR getuid (2), .BR utmp (5) diff --git a/man3/getmntent.3 b/man3/getmntent.3 index 9945d9a4c..8937f4b69 100644 --- a/man3/getmntent.3 +++ b/man3/getmntent.3 @@ -145,7 +145,7 @@ and .BR getmntent () will convert from string representation to escaped representation and back. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getmntent () and @@ -172,7 +172,7 @@ a match is found and NULL otherwise. /etc/fstab file system description file /etc/mtab mounted file system description file .fi -.SH "CONFORMING TO" +.SH CONFORMING TO The nonreentrant functions are from SunOS 4.1.3. A routine .BR getmntent_r () @@ -190,7 +190,7 @@ is used. .BR getmntinfo (), a wrapper around the system call .BR getfsstat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR fopen (3), .BR fstab (5), .BR mount (8) diff --git a/man3/getnameinfo.3 b/man3/getnameinfo.3 index 037c8c01b..781f44a54 100644 --- a/man3/getnameinfo.3 +++ b/man3/getnameinfo.3 @@ -133,7 +133,7 @@ IDNA_ALLOW_UNASSIGNED (allow unassigned Unicode code points) and IDNA_USE_STD3_ASCII_RULES (check output to make sure it is a STD3 conforming hostname) flags respectively to be used in the IDNA handling. -.SH "RETURN VALUE" +.SH RETURN VALUE .\" FIXME glibc defines the following additional errors, some which .\" can probably be returned by getnameinfo(); they need to .\" be documented. @@ -200,7 +200,7 @@ suitable for error reporting. .SH VERSIONS .BR getnameinfo () is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO RFC\ 2553, POSIX.1-2001. .SH NOTES In order to assist the programmer in choosing reasonable sizes @@ -269,7 +269,7 @@ An example program using .BR getnameinfo () can be found in .BR getaddrinfo (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR getpeername (2), .BR getsockname (2), diff --git a/man3/getnetent.3 b/man3/getnetent.3 index e694a2072..f9c251068 100644 --- a/man3/getnetent.3 +++ b/man3/getnetent.3 @@ -108,7 +108,7 @@ The type of the network number; always .TP .I n_net The network number in host byte order. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getnetent (), .BR getnetbyname () @@ -121,7 +121,7 @@ error occurs or the end of the file is reached. .TP .I /etc/networks networks database file -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH NOTES In glibc versions before 2.2, the @@ -130,7 +130,7 @@ argument of .BR getnetbyaddr () was of type .IR long . -.SH "SEE ALSO" +.SH SEE ALSO .BR getnetent_r (3), .BR getprotoent (3), .BR getservent (3) diff --git a/man3/getnetent_r.3 b/man3/getnetent_r.3 index 43b08b792..959b3835f 100644 --- a/man3/getnetent_r.3 +++ b/man3/getnetent_r.3 @@ -113,7 +113,7 @@ is used to return the value that would be stored in the global variable by the nonreentrant versions of these functions. .\" getnetent.3 doesn't document any use of h_errno, but nevertheless .\" the nonreentrant functions no seem to set h_errno. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return 0. On error, they return one of the positive error numbers listed in ERRORS. @@ -136,10 +136,10 @@ is too small. Try again with a larger buffer (and increased .IR buflen ). -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. -.SH "SEE ALSO" +.SH SEE ALSO .BR getnetent (3), .BR networks (5) diff --git a/man3/getopt.3 b/man3/getopt.3 index 494c3d988..6dbdf6345 100644 --- a/man3/getopt.3 +++ b/man3/getopt.3 @@ -269,7 +269,7 @@ as "\-\-" can indicate a long option. If an option that starts with \(aq\-\(aq (not "\-\-") doesn't match a long option, but does match a short option, it is parsed as a short option instead. -.SH "RETURN VALUE" +.SH RETURN VALUE If an option was successfully found, then .BR getopt () returns the option character. @@ -313,7 +313,7 @@ wildcard expansion and so should not be considered as options. This behavior was removed in .BR bash (1) version 2.01, but the support remains in glibc. -.SH "CONFORMING TO" +.SH CONFORMING TO .TP .BR getopt (): POSIX.2 and POSIX.1-2001, @@ -509,5 +509,5 @@ main(int argc, char **argv) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getsubopt (3) diff --git a/man3/getpass.3 b/man3/getpass.3 index d363ec403..d920c39bc 100644 --- a/man3/getpass.3 +++ b/man3/getpass.3 @@ -64,7 +64,7 @@ turns off echoing, reads one line (the "password"), restores the terminal state and closes .I /dev/tty again. -.SH "RETURN VALUE" +.SH RETURN VALUE The function .BR getpass () returns a pointer to a static buffer containing (the first @@ -86,7 +86,7 @@ The process does not have a controlling terminal. .\" A .\" .BR getpass () .\" function appeared in Version 7 AT&T UNIX. -.SH "CONFORMING TO" +.SH CONFORMING TO Present in SUSv2, but marked LEGACY. Removed in POSIX.1-2001. .SH NOTES @@ -144,5 +144,5 @@ and returns .SH BUGS The calling process should zero the password as soon as possible to avoid leaving the cleartext password visible in the process's address space. -.SH "SEE ALSO" +.SH SEE ALSO .BR crypt (3) diff --git a/man3/getprotoent.3 b/man3/getprotoent.3 index 372c52bb8..8cd57445e 100644 --- a/man3/getprotoent.3 +++ b/man3/getprotoent.3 @@ -102,7 +102,7 @@ A NULL-terminated list of alternative names for the protocol. .TP .I p_proto The protocol number. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getprotoent (), .BR getprotobyname () @@ -117,9 +117,9 @@ error occurs or the end of the file is reached. .I /etc/protocols protocol database file .PD -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR getnetent (3), .BR getprotoent_r (3), .BR getservent (3), diff --git a/man3/getprotoent_r.3 b/man3/getprotoent_r.3 index 3bbe2ed0f..2f1fa142b 100644 --- a/man3/getprotoent_r.3 +++ b/man3/getprotoent_r.3 @@ -103,7 +103,7 @@ is set pointing to otherwise, .I *result is set to NULL. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return 0. On error, they return one of the positive error numbers listed in ERRORS. @@ -126,7 +126,7 @@ is too small. Try again with a larger buffer (and increased .IR buflen ). -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. @@ -232,6 +232,6 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getprotoent (3), .BR protocols (5) diff --git a/man3/getpt.3 b/man3/getpt.3 index 2d9893337..16af9cc26 100644 --- a/man3/getpt.3 +++ b/man3/getpt.3 @@ -23,7 +23,7 @@ It is equivalent to .fi on Linux systems, though the pseudoterminal master is located elsewhere on some systems that use GNU Libc. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR getpt () returns an open file descriptor upon successful completion. Otherwise, it @@ -43,7 +43,7 @@ is glibc-specific; use .BR posix_openpt (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR grantpt (3), .BR posix_openpt (3), .BR ptsname (3), diff --git a/man3/getpw.3 b/man3/getpw.3 index 7bc7e06f5..08c94ddd0 100644 --- a/man3/getpw.3 +++ b/man3/getpw.3 @@ -67,7 +67,7 @@ struct passwd { .PP For more information about the fields of this structure, see .BR passwd (5). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getpw () function returns 0 on success; on error, it returns \-1, and @@ -91,7 +91,7 @@ structure. .TP .I /etc/passwd password database file -.SH "CONFORMING TO" +.SH CONFORMING TO SVr2. .SH BUGS The @@ -100,7 +100,7 @@ function is dangerous as it may overflow the provided buffer .IR buf . It is obsoleted by .BR getpwuid (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR endpwent (3), .BR fgetpwent (3), .BR getpwent (3), diff --git a/man3/getpwent.3 b/man3/getpwent.3 index 760c19861..83fcb796b 100644 --- a/man3/getpwent.3 +++ b/man3/getpwent.3 @@ -98,7 +98,7 @@ struct passwd { .PP For more information about the fields of this structure, see .BR passwd (5). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getpwent () function returns a pointer to a @@ -149,12 +149,12 @@ Insufficient buffer space supplied. .TP .I /etc/passwd local password database file -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. The .I pw_gecos field is not specified in POSIX, but is present on most implementations. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent (3), .BR getpw (3), .BR getpwent_r (3), diff --git a/man3/getpwent_r.3 b/man3/getpwent_r.3 index 510643f04..a32ae9dec 100644 --- a/man3/getpwent_r.3 +++ b/man3/getpwent_r.3 @@ -99,7 +99,7 @@ is stored in the provided buffer .IR *pwbuf , and a pointer to this \fIstruct passwd\fP is returned in .IR *pwbufp . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return 0 and .I *pwbufp is a pointer to the \fIstruct passwd\fP. @@ -114,7 +114,7 @@ No more entries. .B ERANGE Insufficient buffer space supplied. Try again with larger buffer. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions, done in a style resembling the POSIX version of functions like .BR getpwnam_r (3). @@ -176,7 +176,7 @@ main(void) .\" printf("getpwent_r: %s", strerror(i)); .\" exit(EXIT_SUCCESS); .\" } -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetpwent (3), .BR getpw (3), .BR getpwent (3), diff --git a/man3/getpwnam.3 b/man3/getpwnam.3 index f9349da70..5439b6532 100644 --- a/man3/getpwnam.3 +++ b/man3/getpwnam.3 @@ -138,7 +138,7 @@ or an initial suggested size for the call fails with .BR ERANGE , in which case the caller can retry with a larger buffer.) -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getpwnam () and @@ -212,7 +212,7 @@ Insufficient buffer space supplied. .TP .I /etc/passwd local password database file -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. The .I pw_gecos @@ -308,7 +308,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR endpwent (3), .BR fgetpwent (3), .BR getgrnam (3), diff --git a/man3/getrpcent.3 b/man3/getrpcent.3 index ddf85e2e4..dc2213beb 100644 --- a/man3/getrpcent.3 +++ b/man3/getrpcent.3 @@ -93,7 +93,7 @@ A NULL pointer is returned on EOF or error. .TP .I /etc/rpc RPC program number database. -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other systems. .SH BUGS @@ -101,7 +101,7 @@ All information is contained in a static area so it must be copied if it is to be saved. -.SH "SEE ALSO" +.SH SEE ALSO .BR getrpcent_r (3), .BR rpc (5), .BR rpcinfo (8), diff --git a/man3/getrpcent_r.3 b/man3/getrpcent_r.3 index 70d107166..74f3b01b9 100644 --- a/man3/getrpcent_r.3 +++ b/man3/getrpcent_r.3 @@ -102,7 +102,7 @@ is set pointing to otherwise, .I *result is set to NULL. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return 0. On error, they return one of the positive error numbers listed in ERRORS. @@ -125,10 +125,10 @@ is too small. Try again with a larger buffer (and increased .IR buflen ). -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. -.SH "SEE ALSO" +.SH SEE ALSO .BR getrpcent (3), .BR rpc (5) diff --git a/man3/getrpcport.3 b/man3/getrpcport.3 index 01c2ab0e4..7d88096f7 100644 --- a/man3/getrpcport.3 +++ b/man3/getrpcport.3 @@ -29,6 +29,6 @@ is registered but not with version it will still return a port number (for some version of the program) indicating that the program is indeed registered. The version mismatch will be detected upon the first call to the service. -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other systems. diff --git a/man3/gets.3 b/man3/gets.3 index 93b1389ec..2eb43d1c5 100644 --- a/man3/gets.3 +++ b/man3/gets.3 @@ -106,7 +106,7 @@ library for the same input stream. .PP For nonlocking counterparts, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE .BR fgetc (), .BR getc () and @@ -133,7 +133,7 @@ returns on success, or .B EOF on error. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001. LSB deprecates @@ -168,7 +168,7 @@ library with low-level calls to .BR read (2) for the file descriptor associated with the input stream; the results will be undefined and very probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR read (2), .BR write (2), .BR ferror (3), diff --git a/man3/getservent.3 b/man3/getservent.3 index eb9940937..3869d4285 100644 --- a/man3/getservent.3 +++ b/man3/getservent.3 @@ -113,7 +113,7 @@ The port number for the service given in network byte order. .TP .I s_proto The name of the protocol to use with this service. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getservent (), .BR getservbyname () @@ -126,9 +126,9 @@ error occurs or the end of the file is reached. .TP .I /etc/services services database file -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR getnetent (3), .BR getprotoent (3), .BR getservent_r (3), diff --git a/man3/getservent_r.3 b/man3/getservent_r.3 index c481e2fcc..e716f6a8d 100644 --- a/man3/getservent_r.3 +++ b/man3/getservent_r.3 @@ -102,7 +102,7 @@ is set pointing to otherwise, .I *result is set to NULL. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return 0. On error, they return one of the positive error numbers listed in errors. @@ -125,7 +125,7 @@ is too small. Try again with a larger buffer (and increased .IR buflen ). -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. Functions with similar names exist on some other systems, though typically with different calling signatures. @@ -236,6 +236,6 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getservent (3), .BR services (5) diff --git a/man3/getspnam.3 b/man3/getspnam.3 index 502543f9d..6644e916c 100644 --- a/man3/getspnam.3 +++ b/man3/getspnam.3 @@ -211,7 +211,7 @@ struct spwd { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The functions that return a pointer return NULL if no more entries are available or if an error occurs during processing. The functions which have \fIint\fP as the return value return 0 for @@ -242,11 +242,11 @@ The include file defines the constant .B _PATH_SHADOW to the pathname of the shadow password file. -.SH "CONFORMING TO" +.SH CONFORMING TO The shadow password database and its associated API are not specified in POSIX.1-2001. However, many other systems provide a similar API. -.SH "SEE ALSO" +.SH SEE ALSO .BR getgrnam (3), .BR getpwnam (3), .BR getpwnam_r (3), diff --git a/man3/getttyent.3 b/man3/getttyent.3 index 3cffe2a2d..99736c9c7 100644 --- a/man3/getttyent.3 +++ b/man3/getttyent.3 @@ -66,13 +66,13 @@ can be: #define TTY_ON 0x01 /* enable logins (start ty_getty program) */ #define TTY_SECURE 0x02 /* allow UID 0 to login */ .fi -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs, and perhaps other systems. .SH NOTES Under Linux the file .IR /etc/ttys , and the functions described above, are not used. -.SH "SEE ALSO" +.SH SEE ALSO .BR ttyname (3), .BR ttyslot (3) diff --git a/man3/getumask.3 b/man3/getumask.3 index 310ed5f51..8c9a022d2 100644 --- a/man3/getumask.3 +++ b/man3/getumask.3 @@ -53,10 +53,10 @@ except that it is documented to be thread-safe (that is, shares a lock with the .BR umask (2) library call). -.SH "CONFORMING TO" +.SH CONFORMING TO This is a vaporware GNU extension. .SH NOTES This function is documented but not implemented yet in glibc, as at version 2.9. -.SH "SEE ALSO" +.SH SEE ALSO .BR umask (2) diff --git a/man3/getusershell.3 b/man3/getusershell.3 index b31e2d6da..db3f6e2a6 100644 --- a/man3/getusershell.3 +++ b/man3/getusershell.3 @@ -72,7 +72,7 @@ function rewinds \fI/etc/shells\fP. The .BR endusershell () function closes \fI/etc/shells\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getusershell () function returns a NULL pointer on end-of-file. @@ -80,7 +80,7 @@ function returns a NULL pointer on end-of-file. .nf /etc/shells .fi -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR shells (5) diff --git a/man3/getutent.3 b/man3/getutent.3 index 3fb359d78..d2c062843 100644 --- a/man3/getutent.3 +++ b/man3/getutent.3 @@ -114,7 +114,7 @@ the new entry. If it cannot find an appropriate slot for \fIut\fP, .BR pututline () will append the new entry to the end of the file. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR getutent (), .BR getutid (), and @@ -150,7 +150,7 @@ functions can also fail for the reasons described in /var/run/utmp database of currently logged-in users .br /var/log/wtmp database of past user logins -.SH "CONFORMING TO" +.SH CONFORMING TO XPG2, SVr4. .LP In XPG2 and SVID 2 the function @@ -284,6 +284,6 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getutmp (3), .BR utmp (5) diff --git a/man3/getw.3 b/man3/getw.3 index 3b96923b0..2060e9f63 100644 --- a/man3/getw.3 +++ b/man3/getw.3 @@ -68,20 +68,20 @@ an \fIint\fP) to \fIstream\fP. It is provided for compatibility with SVr4, but we recommend you use .BR fwrite (3) instead. -.SH "RETURN VALUE" +.SH RETURN VALUE Normally, .BR getw () returns the word read, and .BR putw () returns 0. On error, they return \fBEOF\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, SUSv2. Not present in POSIX.1-2001. .SH BUGS The value returned on error is also a legitimate data value. .BR ferror (3) can be used to distinguish between the two cases. -.SH "SEE ALSO" +.SH SEE ALSO .BR ferror (3), .BR fread (3), .BR fwrite (3), diff --git a/man3/getwchar.3 b/man3/getwchar.3 index 10ad90c30..be1eac854 100644 --- a/man3/getwchar.3 +++ b/man3/getwchar.3 @@ -38,13 +38,13 @@ If a wide-character conversion error occurs, it sets .PP For a nonlocking counterpart, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR getwchar () function returns the next wide-character from standard input, or .BR WEOF . -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -59,6 +59,6 @@ It is reasonable to expect that will actually read a multibyte sequence from standard input and then convert it to a wide character. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetwc (3), .BR unlocked_stdio (3) diff --git a/man3/glob.3 b/man3/glob.3 index 53fbf976f..cc11ae69b 100644 --- a/man3/glob.3 +++ b/man3/glob.3 @@ -254,7 +254,7 @@ As a GNU extension, is set to the flags specified, \fBor\fRed with .B GLOB_MAGCHAR if any metacharacters were found. -.SH "RETURN VALUE" +.SH RETURN VALUE On successful completion, .BR glob () returns zero. @@ -268,7 +268,7 @@ for a read error, and .TP .B GLOB_NOMATCH for no found matches. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.2, POSIX.1-2001. .SH NOTES The structure elements @@ -311,7 +311,7 @@ globbuf.gl_pathv[1] = "\-l"; execvp("ls", &globbuf.gl_pathv[0]); .in .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR ls (1), .BR sh (1), .BR stat (2), diff --git a/man3/grantpt.3 b/man3/grantpt.3 index ab96ad95d..fe6c63746 100644 --- a/man3/grantpt.3 +++ b/man3/grantpt.3 @@ -27,7 +27,7 @@ The behavior of is unspecified if a signal handler is installed to catch .B SIGCHLD signals. -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, .BR grantpt () returns 0. @@ -51,7 +51,7 @@ argument is valid but not associated with a master pseudoterminal. .SH VERSIONS .BR grantpt () is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES This is part of the UNIX 98 pseudoterminal support, see @@ -59,7 +59,7 @@ This is part of the UNIX 98 pseudoterminal support, see Many systems implement this function via a set-user-ID helper binary called "pt_chown". With Linux devpts no such helper binary is required. -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2), .BR posix_openpt (3), .BR ptsname (3), diff --git a/man3/gsignal.3 b/man3/gsignal.3 index a2e97c33d..6103194cb 100644 --- a/man3/gsignal.3 +++ b/man3/gsignal.3 @@ -90,7 +90,7 @@ and returns the value returned by that function. The range of possible values .I signum varies (often 1-15 or 1-17). -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are available under AIX, DG/UX, HP-UX, SCO, Solaris, Tru64. They are called obsolete under most of these systems, and are broken under Linux libc and glibc. @@ -98,7 +98,7 @@ Some systems also have .BR gsignal_r () and .BR ssignal_r (). -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR signal (2), .BR raise (3) diff --git a/man3/hash.3 b/man3/hash.3 index 4af6d1f12..4ee7f2cab 100644 --- a/man3/hash.3 +++ b/man3/hash.3 @@ -155,7 +155,7 @@ for any of the errors specified for the library routine .BR dbopen (3). .SH BUGS Only big and little endian byte order are supported. -.SH "SEE ALSO" +.SH SEE ALSO .BR btree (3), .BR dbopen (3), .BR mpool (3), diff --git a/man3/hsearch.3 b/man3/hsearch.3 index a939b4619..114bcb2b9 100644 --- a/man3/hsearch.3 +++ b/man3/hsearch.3 @@ -171,7 +171,7 @@ function differs from in that a pointer to the found item is returned in .IR *retval , rather than as the function result. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR hcreate () and .BR hcreate_r () @@ -223,7 +223,7 @@ was not found in the table. POSIX.1-2001 only specifies the .B ENOMEM error. -.SH "CONFORMING TO" +.SH CONFORMING TO The functions .BR hcreate (), .BR hsearch (), @@ -320,7 +320,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR bsearch (3), .BR lsearch (3), .BR malloc (3), diff --git a/man3/hypot.3 b/man3/hypot.3 index 58a38b441..1b150a052 100644 --- a/man3/hypot.3 +++ b/man3/hypot.3 @@ -153,12 +153,12 @@ for this case. .\" FIXME . Is it intentional that these functions do not set errno? .\" They do set errno for the overflow case. .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6795 -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR sqrt (3) diff --git a/man3/iconv.3 b/man3/iconv.3 index cd4eaf1b7..abbbb26e0 100644 --- a/man3/iconv.3 +++ b/man3/iconv.3 @@ -117,7 +117,7 @@ A third case is when \fIinbuf\fP is NULL or \fI*inbuf\fP is NULL, and In this case, the .BR iconv () function sets \fIcd\fP's conversion state to the initial state. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iconv () function returns the number of characters converted in a @@ -137,7 +137,7 @@ An invalid multibyte sequence has been encountered in the input. An incomplete multibyte sequence has been encountered in the input. .SH VERSIONS This function is available in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES Although @@ -158,6 +158,6 @@ must ensure that the pointers passed to the function are suitable for accessing characters in the appropriate character set. This includes ensuring correct alignment on platforms that have tight restrictions on alignment. -.SH "SEE ALSO" +.SH SEE ALSO .BR iconv_close (3), .BR iconv_open (3) diff --git a/man3/iconv_close.3 b/man3/iconv_close.3 index 3d6c73b7d..c27ea9913 100644 --- a/man3/iconv_close.3 +++ b/man3/iconv_close.3 @@ -24,7 +24,7 @@ The function deallocates a conversion descriptor \fIcd\fP previously allocated using .BR iconv_open (3). -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, the .BR iconv_close () function returns 0. @@ -33,8 +33,8 @@ In case of error, it sets and returns \-1. .SH VERSIONS This function is available in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO UNIX98, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR iconv (3), .BR iconv_open (3) diff --git a/man3/iconv_open.3 b/man3/iconv_open.3 index 9d4ad4297..6977e4d63 100644 --- a/man3/iconv_open.3 +++ b/man3/iconv_open.3 @@ -66,7 +66,7 @@ descriptor can not be used in multiple threads simultaneously.) To bring the state back to the initial state, use .BR iconv (3) with NULL as \fIinbuf\fP argument. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iconv_open () function returns a freshly allocated conversion @@ -81,9 +81,9 @@ The conversion from \fIfromcode\fP to \fItocode\fP is not supported by the implementation. .SH VERSIONS This function is available in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO UNIX98, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR iconv (1), .BR iconv (3), .BR iconv_close (3) diff --git a/man3/ilogb.3 b/man3/ilogb.3 index 950fe99a8..ae7dacff0 100644 --- a/man3/ilogb.3 +++ b/man3/ilogb.3 @@ -141,9 +141,9 @@ or raise an exception for this case. .\" or raise an exception? .\" log(), log2(), log10() do set errno .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794 -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR log (3), .BR logb (3), .BR significand (3) diff --git a/man3/index.3 b/man3/index.3 index bee15c853..df8876801 100644 --- a/man3/index.3 +++ b/man3/index.3 @@ -50,14 +50,14 @@ of the character \fIc\fP in the string \fIs\fP. .PP The terminating null byte (\(aq\\0\(aq) is considered to be a part of the strings. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR index () and .BR rindex () functions return a pointer to the matched character or NULL if the character is not found. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD; marked as LEGACY in POSIX.1-2001. POSIX.1-2008 removes the specifications of .BR index () @@ -68,7 +68,7 @@ recommending and .BR strrchr (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR memchr (3), .BR strchr (3), .BR string (3), diff --git a/man3/inet.3 b/man3/inet.3 index 51ca8446b..5a6f0ea86 100644 --- a/man3/inet.3 +++ b/man3/inet.3 @@ -207,7 +207,7 @@ struct in_addr { }; .fi .in -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. .BR inet_addr () and @@ -294,7 +294,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR byteorder (3), .BR getaddrinfo (3), .BR gethostbyname (3), diff --git a/man3/inet_ntop.3 b/man3/inet_ntop.3 index 21f1e04be..abe71bbb0 100644 --- a/man3/inet_ntop.3 +++ b/man3/inet_ntop.3 @@ -78,7 +78,7 @@ The buffer must be at least .B INET6_ADDRSTRLEN bytes long. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR inet_ntop () returns a non-NULL pointer to @@ -95,7 +95,7 @@ was not a valid address family. .B ENOSPC The converted address string would exceed the size given by .IR size . -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. Note that RFC\ 2553 defines a prototype where the last argument .I size @@ -113,7 +113,7 @@ converts IPv4-mapped IPv6 addresses into an IPv6 format. .SH EXAMPLE See .BR inet_pton (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR getnameinfo (3), .BR inet (3), .BR inet_pton (3) diff --git a/man3/inet_pton.3 b/man3/inet_pton.3 index a2054cb4e..fe518b633 100644 --- a/man3/inet_pton.3 +++ b/man3/inet_pton.3 @@ -111,7 +111,7 @@ An example of such an address is .RE .IP See RFC 2373 for further details on the representation of IPv6 addresses. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR inet_pton () returns 1 on success (network address was successfully converted). 0 is returned if @@ -124,7 +124,7 @@ does not contain a valid address family, \-1 is returned and .I errno is set to .BR EAFNOSUPPORT . -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES Unlike @@ -210,7 +210,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getaddrinfo (3), .BR inet (3), .BR inet_ntop (3) diff --git a/man3/infnan.3 b/man3/infnan.3 index a0cbbe398..d4abd2303 100644 --- a/man3/infnan.3 +++ b/man3/infnan.3 @@ -49,7 +49,7 @@ The value of \fIerror\fP can be to represent infinity or anything else to represent NaN. \fIerrno\fP is also set. -.SH "RETURN VALUE" +.SH RETURN VALUE If \fIerror\fP is .B ERANGE (Infinity), @@ -66,7 +66,7 @@ The value of \fIerror\fP is "not-a-number" (NaN). .TP .B ERANGE The value of \fIerror\fP is positive infinity or negative infinity. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. .SH NOTES This obsolete function was provided in diff --git a/man3/initgroups.3 b/man3/initgroups.3 index 113f65604..c4dc223c6 100644 --- a/man3/initgroups.3 +++ b/man3/initgroups.3 @@ -57,7 +57,7 @@ also added to the list. The .I user argument must be non-NULL. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR initgroups () function returns 0 on success. @@ -77,9 +77,9 @@ See the underlying system call .nf \fI/etc/group\fP group database file .fi -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR getgroups (2), .BR setgroups (2), .BR credentials (7) diff --git a/man3/insque.3 b/man3/insque.3 index 8bb0f820b..cb9827c33 100644 --- a/man3/insque.3 +++ b/man3/insque.3 @@ -94,9 +94,9 @@ The .BR remque () function removes the element pointed to by \fIelem\fP from the doubly-linked list. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. -.SH "NOTES" +.SH NOTES Traditionally (e.g., SunOS, Linux libc 4 and libc 5), the arguments of these functions were of type \fIstruct qelem *\fP, defined as: diff --git a/man3/intro.3 b/man3/intro.3 index 6abce37d5..b5581b9d8 100644 --- a/man3/intro.3 +++ b/man3/intro.3 @@ -82,7 +82,7 @@ For further information on feature test macros, see .\" .IP (3X) .\" Various special libraries. The manual pages documenting their functions .\" specify the library names. -.SH "CONFORMING TO" +.SH CONFORMING TO Certain terms and abbreviations are used to indicate UNIX variants and standards to which calls in this section conform. See @@ -92,7 +92,7 @@ See Look at the header of the manual page source for the author(s) and copyright conditions. Note that these can be different from page to page! -.SH "SEE ALSO" +.SH SEE ALSO .BR intro (2), .BR errno (3), .BR capabilities (7), diff --git a/man3/isalpha.3 b/man3/isalpha.3 index 4b1cd5b88..efb4e4cd5 100644 --- a/man3/isalpha.3 +++ b/man3/isalpha.3 @@ -156,12 +156,12 @@ checks for an uppercase letter. checks for a hexadecimal digits, that is, one of .br .BR "0 1 2 3 4 5 6 7 8 9 a b c d e f A B C D E F" . -.SH "RETURN VALUE" +.SH RETURN VALUE The values returned are nonzero if the character .I c falls into the tested class, and a zero value if not. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, 4.3BSD. C89 specifies all of these functions except .BR isascii () @@ -184,7 +184,7 @@ For example, will not recognize an A-umlaut (\(:A) as an uppercase letter in the default .B "C" locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswalnum (3), .BR iswalpha (3), .BR iswblank (3), diff --git a/man3/isatty.3 b/man3/isatty.3 index a1c48a7ef..3f7f95b54 100644 --- a/man3/isatty.3 +++ b/man3/isatty.3 @@ -57,8 +57,8 @@ POSIX.1-2001 specifies the error .BR ENOTTY .\" FIXME File a bug for this? for this case. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fstat (2), .BR ttyname (3) diff --git a/man3/isgreater.3 b/man3/isgreater.3 index d99d19357..563e92fd7 100644 --- a/man3/isgreater.3 +++ b/man3/isgreater.3 @@ -88,13 +88,13 @@ these macros return 0 if either argument is a NaN. returns 1 if \fIx\fP or \fIy\fP is NaN and 0 otherwise. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES Not all hardware supports these functions, and where hardware support isn't provided, they will be emulated by macros. This will result in a performance penalty. Don't use these functions if NaN is of no concern for you. -.SH "SEE ALSO" +.SH SEE ALSO .BR fpclassify (3), .BR isnan (3) diff --git a/man3/iswalnum.3 b/man3/iswalnum.3 index 83789d341..9a203bb12 100644 --- a/man3/iswalnum.3 +++ b/man3/iswalnum.3 @@ -50,14 +50,14 @@ As such, it also contains the wide-character class .PP The wide-character class "alnum" always contains at least the letters \(aqA\(aq to \(aqZ\(aq, \(aqa\(aq to \(aqz\(aq and the digits \(aq0\(aq to \(aq9\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswalnum () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "alnum". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -66,6 +66,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR isalnum (3), .BR iswctype (3) diff --git a/man3/iswalpha.3 b/man3/iswalpha.3 index 6bd9ec709..ad90b58e5 100644 --- a/man3/iswalpha.3 +++ b/man3/iswalpha.3 @@ -54,14 +54,14 @@ and "lower". .PP The wide-character class "alpha" always contains at least the letters \(aqA\(aq to \(aqZ\(aq and \(aqa\(aq to \(aqz\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswalpha () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "alpha". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -70,6 +70,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR isalpha (3), .BR iswctype (3) diff --git a/man3/iswblank.3 b/man3/iswblank.3 index beafb5021..e79acff2e 100644 --- a/man3/iswblank.3 +++ b/man3/iswblank.3 @@ -57,14 +57,14 @@ from its subclasses "alnum", "alpha", "upper", "lower", "digit", The wide-character class "blank" always contains at least the space character and the control character \(aq\\t\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswblank () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "blank". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES The behavior of @@ -73,6 +73,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR isblank (3), .BR iswctype (3) diff --git a/man3/iswcntrl.3 b/man3/iswcntrl.3 index 7a1db1581..7a5621248 100644 --- a/man3/iswcntrl.3 +++ b/man3/iswcntrl.3 @@ -36,13 +36,13 @@ The wide-character class "cntrl" is disjoint from the wide-character class For an unsigned char \fIc\fP, \fIiscntrl(c)\fP implies \fIiswcntrl(btowc(c))\fP, but not vice versa. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswcntrl () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "cntrl". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -51,6 +51,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR iscntrl (3), .BR iswctype (3) diff --git a/man3/iswctype.3 b/man3/iswctype.3 index 8532ee9ce..78b89173e 100644 --- a/man3/iswctype.3 +++ b/man3/iswctype.3 @@ -36,14 +36,14 @@ zero is returned. returned by the .BR wctype (3) function. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswctype () function returns nonzero if the \fIwc\fP has the designated property. Otherwise it returns 0. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -52,7 +52,7 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswalnum (3), .BR iswalpha (3), .BR iswblank (3), diff --git a/man3/iswdigit.3 b/man3/iswdigit.3 index 3a05e5997..8b4360ef7 100644 --- a/man3/iswdigit.3 +++ b/man3/iswdigit.3 @@ -53,14 +53,14 @@ disjoint from the wide-character class .PP The wide-character class "digit" always contains exactly the digits \(aq0\(aq to \(aq9\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswdigit () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "digit". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -69,6 +69,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR isdigit (3), .BR iswctype (3) diff --git a/man3/iswgraph.3 b/man3/iswgraph.3 index c98e2ce20..258349c7a 100644 --- a/man3/iswgraph.3 +++ b/man3/iswgraph.3 @@ -46,14 +46,14 @@ The wide-character class "graph" contains all the wide characters from the wide-character class "print" except the space character. It therefore contains the wide-character classes "alnum" and "punct". -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswgraph () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "graph". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -62,6 +62,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR isgraph (3), .BR iswctype (3) diff --git a/man3/iswlower.3 b/man3/iswlower.3 index 666b8301b..c5e06c45b 100644 --- a/man3/iswlower.3 +++ b/man3/iswlower.3 @@ -57,14 +57,14 @@ from \fItowupper(wc)\fP. .PP The wide-character class "lower" always contains at least the letters \(aqa\(aq to \(aqz\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswlower () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "lower". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -76,7 +76,7 @@ current locale. .PP This function is not very appropriate for dealing with Unicode characters, because Unicode knows about three cases: upper, lower and title case. -.SH "SEE ALSO" +.SH SEE ALSO .BR islower (3), .BR iswctype (3), .BR towlower (3) diff --git a/man3/iswprint.3 b/man3/iswprint.3 index 353f9ea44..8a3aecff6 100644 --- a/man3/iswprint.3 +++ b/man3/iswprint.3 @@ -33,13 +33,13 @@ The wide-character class "print" is disjoint from the wide-character class "cntrl". .PP The wide-character class "print" contains the wide-character class "graph". -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswprint () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "print". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -48,6 +48,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR isprint (3), .BR iswctype (3) diff --git a/man3/iswpunct.3 b/man3/iswpunct.3 index 95edda161..6cd1a14f9 100644 --- a/man3/iswpunct.3 +++ b/man3/iswpunct.3 @@ -44,14 +44,14 @@ Being a subclass of the wide-character class "graph", the wide-character class "punct" is disjoint from the wide-character class "space" and its subclass "blank". -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswpunct () function returns nonzero if \fIwc\fP is a wide-character belonging to the wide-character class "punct". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -64,6 +64,6 @@ current locale. This function's name is a misnomer when dealing with Unicode characters, because the wide-character class "punct" contains both punctuation characters and symbol (math, currency, etc.) characters. -.SH "SEE ALSO" +.SH SEE ALSO .BR ispunct (3), .BR iswctype (3) diff --git a/man3/iswspace.3 b/man3/iswspace.3 index 4d912cbc5..fac50ff4c 100644 --- a/man3/iswspace.3 +++ b/man3/iswspace.3 @@ -41,13 +41,13 @@ The wide-character class "space" contains the wide-character class "blank". The wide-character class "space" always contains at least the space character and the control characters \(aq\\f\(aq, \(aq\\n\(aq, \(aq\\r\(aq, \(aq\\t\(aq, \(aq\\v\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswspace () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "space". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -56,6 +56,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR isspace (3), .BR iswctype (3) diff --git a/man3/iswupper.3 b/man3/iswupper.3 index fb1307ef8..39d980d41 100644 --- a/man3/iswupper.3 +++ b/man3/iswupper.3 @@ -51,13 +51,13 @@ which are equal to \fItowupper(wc)\fP and different from \fItowlower(wc)\fP. .PP The wide-character class "upper" always contains at least the letters \(aqA\(aq to \(aqZ\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswupper () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "upper". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -69,7 +69,7 @@ current locale. .PP This function is not very appropriate for dealing with Unicode characters, because Unicode knows about three cases: upper, lower and title case. -.SH "SEE ALSO" +.SH SEE ALSO .BR isupper (3), .BR iswctype (3), .BR towupper (3) diff --git a/man3/iswxdigit.3 b/man3/iswxdigit.3 index 6cc3b0b1a..5e7346968 100644 --- a/man3/iswxdigit.3 +++ b/man3/iswxdigit.3 @@ -46,13 +46,13 @@ Being a subclass of the wide-character class "alnum", the wide-character class The wide-character class "xdigit" always contains at least the letters \(aqA\(aq to \(aqF\(aq, \(aqa\(aq to \(aqf\(aq and the digits \(aq0\(aq to \(aq9\(aq. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR iswxdigit () function returns nonzero if \fIwc\fP is a wide character belonging to the wide-character class "xdigit". Otherwise it returns zero. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -61,6 +61,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswctype (3), .BR isxdigit (3) diff --git a/man3/j0.3 b/man3/j0.3 index 0b206ff72..1f0375971 100644 --- a/man3/j0.3 +++ b/man3/j0.3 @@ -141,7 +141,7 @@ These functions do not raise exceptions for .\" FIXME . Is it intentional that these functions do not raise exceptions? .\" e.g., j0(1.5e16) .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805 -.SH "CONFORMING TO" +.SH CONFORMING TO The functions returning .I double conform to SVr4, 4.3BSD, diff --git a/man3/key_setsecret.3 b/man3/key_setsecret.3 index b7c4d7f4d..4e93106b0 100644 --- a/man3/key_setsecret.3 +++ b/man3/key_setsecret.3 @@ -52,7 +52,7 @@ The function .BR key_secretkey_is_set () can be used to determine whether a key has been set for the effective UID of the calling process. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return 1 on success and 0 on failure. .SH NOTES Note that we talk about two types of encryption here. @@ -61,5 +61,5 @@ The other is symmetric, the 64-bit DES. .PP These routines were part of the Linux/Doors-project, abandoned by now. -.SH "SEE ALSO" +.SH SEE ALSO .BR crypt (3) diff --git a/man3/ldexp.3 b/man3/ldexp.3 index ca03c8783..a3c876837 100644 --- a/man3/ldexp.3 +++ b/man3/ldexp.3 @@ -124,13 +124,13 @@ is set to An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR frexp (3), .BR modf (3), .BR scalbln (3) diff --git a/man3/lgamma.3 b/man3/lgamma.3 index 650ded2f0..ad8ef7739 100644 --- a/man3/lgamma.3 +++ b/man3/lgamma.3 @@ -147,7 +147,7 @@ An overflow floating-point exception is raised. .\" glibc (as at 2.8) also supports an inexact .\" exception for various cases. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR lgamma () functions are specified in C99 and POSIX.1-2001. @@ -166,5 +166,5 @@ is set to instead of the POSIX-mandated .BR ERANGE . Since version 2.10, glibc does the right thing. -.SH "SEE ALSO" +.SH SEE ALSO .BR tgamma (3) diff --git a/man3/lio_listio.3 b/man3/lio_listio.3 index 4cc0833c6..fc134c3c7 100644 --- a/man3/lio_listio.3 +++ b/man3/lio_listio.3 @@ -201,7 +201,7 @@ then none of the I/O operations has been initiated. The .BR lio_listio () function is available since glibc 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001, POSIX.1-2008. .SH NOTES It is a good idea to zero out the control blocks before use. @@ -215,7 +215,7 @@ The memory areas involved must remain valid. Simultaneous I/O operations specifying the same .I aiocb structure produce undefined results. -.SH "SEE ALSO" +.SH SEE ALSO .BR aio_cancel (3), .BR aio_error (3), .BR aio_fsync (3), diff --git a/man3/localeconv.3 b/man3/localeconv.3 index 7b6a1da3f..9a776f8a2 100644 --- a/man3/localeconv.3 +++ b/man3/localeconv.3 @@ -47,13 +47,13 @@ Programs may also use the functions and .BR strfmon (3), which behave according to the actual locale in use. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99. .SH BUGS The .BR printf (3) family of functions may or may not honor the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale (1), .BR localedef (1), .BR isalpha (3), diff --git a/man3/lockf.3 b/man3/lockf.3 index fbebb23dc..06927adcb 100644 --- a/man3/lockf.3 +++ b/man3/lockf.3 @@ -107,7 +107,7 @@ to .RB ( EACCES on some other systems), if another process holds a lock. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -145,9 +145,9 @@ An invalid operation was specified in .TP .B ENOLCK Too many segment locks open, lock table is full. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fcntl (2), .BR flock (2) diff --git a/man3/log.3 b/man3/log.3 index 6d987991c..e42bf9a3f 100644 --- a/man3/log.3 +++ b/man3/log.3 @@ -122,7 +122,7 @@ is set to A divide-by-zero floating-point exception .RB ( FE_DIVBYZERO ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -135,7 +135,7 @@ taking the of a NaN produces a bogus invalid floating-point .RB ( FE_INVALID ) exception. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR clog (3), .BR log10 (3), diff --git a/man3/log10.3 b/man3/log10.3 index 8a1b5b301..258029487 100644 --- a/man3/log10.3 +++ b/man3/log10.3 @@ -83,13 +83,13 @@ when calling these functions. For a discussion of the errors that can occur for these functions, see .BR log (3). -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR clog10 (3), .BR exp10 (3), diff --git a/man3/log1p.3 b/man3/log1p.3 index 86de3ffe7..c36852a92 100644 --- a/man3/log1p.3 +++ b/man3/log1p.3 @@ -135,10 +135,10 @@ These functions do not set .\" FIXME . Is it intentional that these functions do not set errno? .\" log(), log2(), log10() do set errno .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6792 -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .\" BSD -.SH "SEE ALSO" +.SH SEE ALSO .BR exp (3), .BR expm1 (3), .BR log (3) diff --git a/man3/log2.3 b/man3/log2.3 index 056234f35..80e3a073f 100644 --- a/man3/log2.3 +++ b/man3/log2.3 @@ -85,13 +85,13 @@ For a discussion of the errors that can occur for these functions, see .BR log (3). .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR clog2 (3), .BR log (3), diff --git a/man3/logb.3 b/man3/logb.3 index bae02286f..ae9437aa9 100644 --- a/man3/logb.3 +++ b/man3/logb.3 @@ -138,8 +138,8 @@ These functions do not set .\" .BR logb () .\" function occurs in 4.3BSD. .\" see IEEE.3 in the 4.3BSD manual -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR ilogb (3), .BR log (3) diff --git a/man3/login.3 b/man3/login.3 index a7310da91..d6d6a9929 100644 --- a/man3/login.3 +++ b/man3/login.3 @@ -84,7 +84,7 @@ timestamp field and setting .I ut_type (if there is such a field) to .BR DEAD_PROCESS . -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR logout () function returns 1 if the entry was successfully written to the @@ -102,7 +102,7 @@ user accounting log file, configured through .B _PATH_WTMP in .I -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs. .SH NOTES @@ -120,6 +120,6 @@ is defined as an alias for .I ut_user in .IR . -.SH "SEE ALSO" +.SH SEE ALSO .BR getutent (3), .BR utmp (5) diff --git a/man3/longjmp.3 b/man3/longjmp.3 index b512a3bc7..47db16d4b 100644 --- a/man3/longjmp.3 +++ b/man3/longjmp.3 @@ -77,9 +77,9 @@ call that set this .BR siglongjmp () also restores the signal mask that was saved by .BR sigsetjmp (3). -.SH "RETURN VALUE" +.SH RETURN VALUE These functions never return. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, and POSIX.1-2001 specify .BR longjmp (). POSIX.1-2001 specifies @@ -121,6 +121,6 @@ and make programs hard to understand and maintain. If possible an alternative should be used. -.SH "SEE ALSO" +.SH SEE ALSO .BR setjmp (3), .BR sigsetjmp (3) diff --git a/man3/lrint.3 b/man3/lrint.3 index 17f49c3f7..cbec04394 100644 --- a/man3/lrint.3 +++ b/man3/lrint.3 @@ -68,7 +68,7 @@ Note that unlike .BR rint (3), etc., the return type of these functions differs from that of their arguments. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the rounded integer value. If @@ -104,9 +104,9 @@ These functions do not set .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6798 .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil (3), .BR floor (3), .BR lround (3), diff --git a/man3/lround.3 b/man3/lround.3 index 6f8ec28d5..dc8c93337 100644 --- a/man3/lround.3 +++ b/man3/lround.3 @@ -71,7 +71,7 @@ Note that unlike .BR ceil (3), etc., the return type of these functions differs from that of their arguments. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the rounded integer value. If @@ -107,9 +107,9 @@ These functions do not set .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6797 .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil (3), .BR floor (3), .BR lrint (3), diff --git a/man3/lsearch.3 b/man3/lsearch.3 index 9f0476571..58618702e 100644 --- a/man3/lsearch.3 +++ b/man3/lsearch.3 @@ -55,7 +55,7 @@ object is inserted at the end of the table, and \fI*nmemb\fP is incremented. In particular, one should know that a matching element exists, or that more room is available. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR lfind () returns a pointer to a matching member of the array, or NULL if no match is found. @@ -63,12 +63,12 @@ NULL if no match is found. returns a pointer to a matching member of the array, or to the newly added member if no match is found. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. Present in libc since libc-4.6.27. .SH BUGS The naming is unfortunate. -.SH "SEE ALSO" +.SH SEE ALSO .BR bsearch (3), .BR hsearch (3), .BR tsearch (3) diff --git a/man3/lseek64.3 b/man3/lseek64.3 index c8f8cb88e..8a801c89a 100644 --- a/man3/lseek64.3 +++ b/man3/lseek64.3 @@ -154,6 +154,6 @@ The prototype is: .sp For more details, see .BR llseek (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR llseek (2), .BR lseek (2) diff --git a/man3/makecontext.3 b/man3/makecontext.3 index 9020369f1..820ef1a2d 100644 --- a/man3/makecontext.3 +++ b/man3/makecontext.3 @@ -78,7 +78,7 @@ The function saves the current context in the structure pointed to by \fIoucp\fP, and then activates the context pointed to by \fIucp\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, .BR swapcontext () does not return. @@ -99,7 +99,7 @@ Insufficient stack space left. and .BR swapcontext () are provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv2, POSIX.1-2001. POSIX.1-2008 removes the specifications of .BR makecontext () @@ -214,7 +214,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction (2), .BR sigaltstack (2), .BR sigprocmask (2), diff --git a/man3/makedev.3 b/man3/makedev.3 index c493bdf6b..63e9adc7b 100644 --- a/man3/makedev.3 +++ b/man3/makedev.3 @@ -58,7 +58,7 @@ they return, respectively, the major and minor components. These macros can be useful to, for example, decompose the device IDs in the structure returned by .BR stat (2). -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR makedev (), .BR major (), @@ -76,6 +76,6 @@ they have been aliases for three GNU-specific functions: and .BR gnu_dev_minor (). The latter names are exported, but the traditional names are more portable. -.SH "SEE ALSO" +.SH SEE ALSO .BR mknod (2), .BR stat (2) diff --git a/man3/malloc.3 b/man3/malloc.3 index 917a92ed0..9e5c83d82 100644 --- a/man3/malloc.3 +++ b/man3/malloc.3 @@ -124,7 +124,7 @@ or If the area pointed to was moved, a .I free(ptr) is done. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR malloc () and @@ -163,7 +163,7 @@ is returned. If .BR realloc () fails the original block is left untouched; it is not freed or moved. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99. .SH NOTES By default, Linux follows an optimistic memory allocation strategy. @@ -254,7 +254,7 @@ include a implementation which is tunable via environment variables. For details, see .BR mallopt (3). -.SH "SEE ALSO" +.SH SEE ALSO .\" http://g.oswego.edu/dl/html/malloc.html .\" A Memory Allocator - by Doug Lea .\" diff --git a/man3/malloc_hook.3 b/man3/malloc_hook.3 index 791de777b..dbd3ef39b 100644 --- a/man3/malloc_hook.3 +++ b/man3/malloc_hook.3 @@ -73,7 +73,7 @@ The variable points at a function that is called each time after .BR sbrk (2) was asked for more memory. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. .SH NOTES The use of these hook functions is not safe in multithreaded programs, @@ -82,7 +82,7 @@ and they are now deprecated. .\" http://sourceware.org/bugzilla/show_bug.cgi?id=9957 Programmers should instead preempt calls to the relevant functions by defining and exporting functions such as "malloc" and "free". -.SH "EXAMPLE" +.SH EXAMPLE Here is a short example of how to use these variables. .sp .nf @@ -130,7 +130,7 @@ my_malloc_hook(size_t size, const void *caller) return result; } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR mallinfo (3), .BR malloc (3), .BR mcheck (3), diff --git a/man3/mblen.3 b/man3/mblen.3 index 121258535..2794878cc 100644 --- a/man3/mblen.3 +++ b/man3/mblen.3 @@ -55,7 +55,7 @@ function resets the shift state, only known to this function, to the initial state, and returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mblen () function returns the number of @@ -65,7 +65,7 @@ It returns 0, if a null wide character was recognized. It returns \-1, if an invalid multibyte sequence was encountered or if it couldn't parse a complete multibyte character. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -79,5 +79,5 @@ The function .BR mbrlen (3) provides a better interface to the same functionality. -.SH "SEE ALSO" +.SH SEE ALSO .BR mbrlen (3) diff --git a/man3/mbrlen.3 b/man3/mbrlen.3 index e186c0293..6afbac721 100644 --- a/man3/mbrlen.3 +++ b/man3/mbrlen.3 @@ -51,7 +51,7 @@ the effects on \fI*ps\fP are undefined. If \fIps\fP is a NULL pointer, a static anonymous state only known to the .BR mbrlen () function is used instead. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mbrlen () function returns the number of bytes @@ -64,7 +64,7 @@ and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was encountered. It returns \fI(size_t)\ \-2\fP if it couldn't parse a complete multibyte character, meaning that \fIn\fP should be increased. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -73,5 +73,5 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR mbrtowc (3) diff --git a/man3/mbrtowc.3 b/man3/mbrtowc.3 index 3d8393c33..071aad80a 100644 --- a/man3/mbrtowc.3 +++ b/man3/mbrtowc.3 @@ -85,7 +85,7 @@ by zeroing it, for example using .in +4n memset(&a, 0, sizeof(a)); .in -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mbrtowc () function returns the number of bytes parsed from the @@ -98,7 +98,7 @@ and sets \fIerrno\fP to \fBEILSEQ\fP, if an invalid multibyte sequence was encountered. It returns \fI(size_t)\ \-2\fP if it couldn't parse a complete multibyte character, meaning that \fIn\fP should be increased. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -107,5 +107,5 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR mbsrtowcs (3) diff --git a/man3/mbsinit.3 b/man3/mbsinit.3 index 87457e6d7..92da926a3 100644 --- a/man3/mbsinit.3 +++ b/man3/mbsinit.3 @@ -66,12 +66,12 @@ The function .BR mbsinit () tests whether \fI*ps\fP corresponds to an initial state. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR mbsinit () returns nonzero if \fI*ps\fP is an initial state, or if \fIps\fP is a NULL pointer. Otherwise it returns 0. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -80,6 +80,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR mbsrtowcs (3), .BR wcsrtombs (3) diff --git a/man3/mbsnrtowcs.3 b/man3/mbsnrtowcs.3 index bbd1d71c6..ef21974f3 100644 --- a/man3/mbsnrtowcs.3 +++ b/man3/mbsnrtowcs.3 @@ -98,7 +98,7 @@ state only known to the mbsnrtowcs function is used instead. .PP The programmer must ensure that there is room for at least \fIlen\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mbsnrtowcs () function returns the number of wide characters @@ -108,7 +108,7 @@ If an invalid multibyte sequence was encountered, .I (size_t)\ \-1 is returned, and \fIerrno\fP set to \fBEILSEQ\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES The behavior of @@ -119,6 +119,6 @@ category of the current locale. .PP Passing NULL as \fIps\fP is not multithread safe. -.SH "SEE ALSO" +.SH SEE ALSO .BR iconv (3), .BR mbsrtowcs (3) diff --git a/man3/mbsrtowcs.3 b/man3/mbsrtowcs.3 index fcf47caae..9700cc43b 100644 --- a/man3/mbsrtowcs.3 +++ b/man3/mbsrtowcs.3 @@ -71,7 +71,7 @@ function is used instead. .PP The programmer must ensure that there is room for at least \fIlen\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mbsrtowcs () function returns the number of wide characters that make @@ -81,7 +81,7 @@ If an invalid multibyte sequence was encountered, .I (size_t)\ \-1 is returned, and \fIerrno\fP set to \fBEILSEQ\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -92,7 +92,7 @@ category of the current locale. .PP Passing NULL as \fIps\fP is not multithread safe. -.SH "SEE ALSO" +.SH SEE ALSO .BR iconv (3), .BR mbsnrtowcs (3), .BR mbstowcs (3) diff --git a/man3/mbstowcs.3 b/man3/mbstowcs.3 index 9b6c520ab..d76c56b72 100644 --- a/man3/mbstowcs.3 +++ b/man3/mbstowcs.3 @@ -55,7 +55,7 @@ and that no length limit exists. .PP In order to avoid the case 2 above, the programmer should make sure \fIn\fP is greater or equal to \fImbstowcs(NULL,src,0)+1\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mbstowcs () function returns the number of wide characters that make @@ -65,7 +65,7 @@ If an invalid multibyte sequence was encountered, .I (size_t)\ \-1 is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -79,6 +79,6 @@ The function .BR mbsrtowcs (3) provides a better interface to the same functionality. -.SH "SEE ALSO" +.SH SEE ALSO .BR mbsrtowcs (3), .BR wcstombs (3) diff --git a/man3/mbtowc.3 b/man3/mbtowc.3 index 1efb4ebce..057b83291 100644 --- a/man3/mbtowc.3 +++ b/man3/mbtowc.3 @@ -61,7 +61,7 @@ resets the shift state, only known to this function, to the initial state, and returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. -.SH "RETURN VALUE" +.SH RETURN VALUE If \fIs\fP is not NULL, the .BR mbtowc () function returns the number of @@ -73,7 +73,7 @@ If \fIs\fP is NULL, the function returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -88,7 +88,7 @@ The function .BR mbrtowc (3) provides a better interface to the same functionality. -.SH "SEE ALSO" +.SH SEE ALSO .BR MB_CUR_MAX (3), .BR mbrtowc (3), .BR mbstowcs (3) diff --git a/man3/memccpy.3 b/man3/memccpy.3 index c38edabc3..98a3bff8c 100644 --- a/man3/memccpy.3 +++ b/man3/memccpy.3 @@ -42,15 +42,15 @@ memory area \fIsrc\fP to memory area \fIdest\fP, stopping when the character \fIc\fP is found. If the memory areas overlap, the results are undefined. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memccpy () function returns a pointer to the next character in \fIdest\fP after \fIc\fP, or NULL if \fIc\fP was not found in the first \fIn\fP characters of \fIsrc\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy (3), .BR memcpy (3), .BR memmove (3), diff --git a/man3/memchr.3 b/man3/memchr.3 index 82fd5b477..6025558d2 100644 --- a/man3/memchr.3 +++ b/man3/memchr.3 @@ -100,7 +100,7 @@ terminating null byte: char *p = rawmemchr(s,\ \(aq\\0\(aq); .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memchr () and @@ -119,7 +119,7 @@ first appeared in glibc in version 2.1. .BR memrchr () first appeared in glibc in version 2.2. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR memchr () function conforms to SVr4, 4.3BSD, C89, C99, POSIX.1-2001. @@ -131,7 +131,7 @@ function is a GNU extension, available since glibc 2.1.91. The .BR rawmemchr () function is a GNU extension, available since glibc 2.1. -.SH "SEE ALSO" +.SH SEE ALSO .BR ffs (3), .BR index (3), .BR rindex (3), diff --git a/man3/memcmp.3 b/man3/memcmp.3 index c9b0deb0e..dfdb39f65 100644 --- a/man3/memcmp.3 +++ b/man3/memcmp.3 @@ -40,7 +40,7 @@ The function compares the first \fIn\fP bytes (each interpreted as .IR "unsigned char" ) of the memory areas \fIs1\fP and \fIs2\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memcmp () function returns an integer less than, equal to, or @@ -55,9 +55,9 @@ that differ in .I s1 and .IR s2 . -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp (3), .BR strcasecmp (3), .BR strcmp (3), diff --git a/man3/memcpy.3 b/man3/memcpy.3 index 6564e806d..f3840973d 100644 --- a/man3/memcpy.3 +++ b/man3/memcpy.3 @@ -43,13 +43,13 @@ The memory areas must not overlap. Use .BR memmove (3) if the memory areas do overlap. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memcpy () function returns a pointer to \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy (3), .BR memccpy (3), .BR memmove (3), diff --git a/man3/memfrob.3 b/man3/memfrob.3 index ed0903dc5..ab2faf9d9 100644 --- a/man3/memfrob.3 +++ b/man3/memfrob.3 @@ -48,15 +48,15 @@ encrypted memory area. .PP Note that this function is not a proper encryption routine as the XOR constant is fixed, and is only suitable for hiding strings. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memfrob () function returns a pointer to the encrypted memory area. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR memfrob () function is unique to the GNU C Library. -.SH "SEE ALSO" +.SH SEE ALSO .BR strfry (3) diff --git a/man3/memmem.3 b/man3/memmem.3 index 83ef528e2..b62f92182 100644 --- a/man3/memmem.3 +++ b/man3/memmem.3 @@ -42,12 +42,12 @@ The function finds the start of the first occurrence of the substring \fIneedle\fP of length \fIneedlelen\fP in the memory area \fIhaystack\fP of length \fIhaystacklen\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memmem () function returns a pointer to the beginning of the substring, or NULL if the substring is not found. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. .SH BUGS This function was broken in Linux libraries up to and including libc 5.0.9; @@ -60,5 +60,5 @@ Both old and new libc's have the bug that if \fIneedle\fP is empty, And glibc 2.0 makes it worse, returning a pointer to the last byte of \fIhaystack\fP. This is fixed in glibc 2.1. -.SH "SEE ALSO" +.SH SEE ALSO .BR strstr (3) diff --git a/man3/memmove.3 b/man3/memmove.3 index 24c5e7985..b37babf01 100644 --- a/man3/memmove.3 +++ b/man3/memmove.3 @@ -48,13 +48,13 @@ or .IR dest , and the bytes are then copied from the temporary array to .IR dest . -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memmove () function returns a pointer to \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy (3), .BR memccpy (3), .BR memcpy (3), diff --git a/man3/mempcpy.3 b/man3/mempcpy.3 index 869433c74..ac031c74d 100644 --- a/man3/mempcpy.3 +++ b/man3/mempcpy.3 @@ -46,14 +46,14 @@ function is identical but takes type arguments and copies .I n wide characters. -.SH "RETURN VALUE" +.SH RETURN VALUE \fIdest\fP + \fIn\fP. .SH VERSIONS .BR mempcpy () first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. -.SH "EXAMPLE" +.SH EXAMPLE .nf void * combine(void *o1, size_t s1, void *o2, size_t s2) @@ -64,7 +64,7 @@ combine(void *o1, size_t s1, void *o2, size_t s2) return result; } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR memccpy (3), .BR memcpy (3), .BR memmove (3), diff --git a/man3/memset.3 b/man3/memset.3 index 377b34949..c5b9316ba 100644 --- a/man3/memset.3 +++ b/man3/memset.3 @@ -39,14 +39,14 @@ The .BR memset () function fills the first \fIn\fP bytes of the memory area pointed to by \fIs\fP with the constant byte \fIc\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR memset () function returns a pointer to the memory area \fIs\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR bzero (3), .BR swab (3), .BR wmemset (3) diff --git a/man3/mkdtemp.3 b/man3/mkdtemp.3 index 48f7b413e..b7484cc83 100644 --- a/man3/mkdtemp.3 +++ b/man3/mkdtemp.3 @@ -63,7 +63,7 @@ permissions 0700. Since it will be modified, .I template must not be a string constant, but should be declared as a character array. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mkdtemp () function returns a pointer to the modified template @@ -81,12 +81,12 @@ Also see for other possible values for \fIerrno\fP. .SH VERSIONS Available since glibc 2.1.91. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. This function is present on the BSDs. .\" As at 2006, this function is being considered for a revision of POSIX.1 .\" Also in NetBSD 1.4. -.SH "SEE ALSO" +.SH SEE ALSO .BR mkdir (2), .BR mkstemp (3), .BR mktemp (3), diff --git a/man3/mkfifo.3 b/man3/mkfifo.3 index 5fdcd6da4..538811272 100644 --- a/man3/mkfifo.3 +++ b/man3/mkfifo.3 @@ -58,7 +58,7 @@ other process opens the same FIFO for writing, and vice versa. See .BR fifo (7) for nonblocking handling of FIFO special files. -.SH "RETURN VALUE" +.SH RETURN VALUE On success .BR mkfifo () returns 0. @@ -101,9 +101,9 @@ directory. .TP .B EROFS \fIpathname\fP refers to a read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR mkfifo (1), .BR close (2), .BR open (2), diff --git a/man3/mkfifoat.3 b/man3/mkfifoat.3 index 5534dd769..c46473891 100644 --- a/man3/mkfifoat.3 +++ b/man3/mkfifoat.3 @@ -86,7 +86,7 @@ If is absolute, then .I dirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR mkfifoat () returns 0. @@ -116,14 +116,14 @@ was added to glibc in version 2.4. It is implemented using .BR mknod (2), available on Linux since kernel 2.6.16. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES See .BR openat (2) for an explanation of the need for .BR mkfifoat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR openat (2), .BR mkfifo (3), .BR path_resolution (7) diff --git a/man3/mkstemp.3 b/man3/mkstemp.3 index daf69819b..001951d84 100644 --- a/man3/mkstemp.3 +++ b/man3/mkstemp.3 @@ -131,7 +131,7 @@ as .BR mkostemp () is to .BR mkstemp (). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the file descriptor of the temporary file. On error, \-1 is returned, and @@ -171,7 +171,7 @@ is available since glibc 2.7. and .BR mkostemps () are available since glibc 2.11. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR mkstemp (): 4.3BSD, POSIX.1-2001. @@ -209,7 +209,7 @@ is in .I for libc4, libc5, glibc1; glibc2 follows POSIX.1 and has the prototype in .IR . -.SH "SEE ALSO" +.SH SEE ALSO .BR mkdtemp (3), .BR mktemp (3), .BR tempnam (3), diff --git a/man3/mktemp.3 b/man3/mktemp.3 index aa617414a..8e62a2d66 100644 --- a/man3/mktemp.3 +++ b/man3/mktemp.3 @@ -72,7 +72,7 @@ filename unique. Since it will be modified, .I template must not be a string constant, but should be declared as a character array. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR mktemp () function always returns \fItemplate\fP. @@ -85,7 +85,7 @@ If a unique name could not be created, .TP .B EINVAL The last six characters of \fItemplate\fP were not XXXXXX. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. POSIX.1-2008 removes the specification of .BR mktemp (). @@ -108,7 +108,7 @@ opening the file, every use of is a security risk. The race is avoided by .BR mkstemp (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR mkstemp (3), .BR tempnam (3), .BR tmpfile (3), diff --git a/man3/modf.3 b/man3/modf.3 index 4460a2307..d47a360a9 100644 --- a/man3/modf.3 +++ b/man3/modf.3 @@ -67,7 +67,7 @@ The function breaks the argument \fIx\fP into an integral part and a fractional part, each of which has the same sign as \fIx\fP. The integral part is stored in the location pointed to by \fIiptr\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR modf () function returns the fractional part of \fIx\fP. @@ -85,12 +85,12 @@ is positive infinity (negative infinity), +0 (\-0) is returned, and is set to positive infinity (negative infinity). .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR frexp (3), .BR ldexp (3) diff --git a/man3/mpool.3 b/man3/mpool.3 index d14e09a08..460f7b0e8 100644 --- a/man3/mpool.3 +++ b/man3/mpool.3 @@ -222,10 +222,10 @@ function may fail and set .I errno for any of the errors specified for the library routine .BR free (3). -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs. -.SH "SEE ALSO" +.SH SEE ALSO .BR btree (3), .BR dbopen (3), .BR hash (3), diff --git a/man3/mq_close.3 b/man3/mq_close.3 index f33fdbc3f..304642005 100644 --- a/man3/mq_close.3 +++ b/man3/mq_close.3 @@ -62,7 +62,7 @@ POSIX.1-2001. All open message queues are automatically closed on process termination, or upon .BR execve (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_getattr (3), .BR mq_notify (3), .BR mq_open (3), diff --git a/man3/mq_getattr.3 b/man3/mq_getattr.3 index 7f1ce90b9..d2bd66ee0 100644 --- a/man3/mq_getattr.3 +++ b/man3/mq_getattr.3 @@ -144,7 +144,7 @@ and are library functions layered on top of the .BR mq_getsetattr (2) system call. -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_close (3), .BR mq_notify (3), .BR mq_open (3), diff --git a/man3/mq_notify.3 b/man3/mq_notify.3 index 63219b5b7..9bcf8a6d2 100644 --- a/man3/mq_notify.3 +++ b/man3/mq_notify.3 @@ -240,7 +240,7 @@ main(int argc, char *argv[]) pause(); /* Process will be terminated by thread function */ } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_close (3), .BR mq_getattr (3), .BR mq_open (3), diff --git a/man3/mq_open.3 b/man3/mq_open.3 index 514e9c64f..e94336567 100644 --- a/man3/mq_open.3 +++ b/man3/mq_open.3 @@ -227,7 +227,7 @@ POSIX.1-2001. In kernels before 2.6.14, the process umask was not applied to the permissions specified in .IR mode . -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_close (3), .BR mq_getattr (3), .BR mq_notify (3), diff --git a/man3/mq_receive.3 b/man3/mq_receive.3 index 36f49de82..a3289a915 100644 --- a/man3/mq_receive.3 +++ b/man3/mq_receive.3 @@ -161,7 +161,7 @@ On Linux, is a system call, and .BR mq_receive () is a library function layered on top of that system call. -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_close (3), .BR mq_getattr (3), .BR mq_notify (3), diff --git a/man3/mq_send.3 b/man3/mq_send.3 index 02cf77c50..87cb81c24 100644 --- a/man3/mq_send.3 +++ b/man3/mq_send.3 @@ -166,7 +166,7 @@ On Linux, is a system call, and .BR mq_send () is a library function layered on top of that system call. -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_close (3), .BR mq_getattr (3), .BR mq_notify (3), diff --git a/man3/mq_unlink.3 b/man3/mq_unlink.3 index d99ecef85..ae9f99937 100644 --- a/man3/mq_unlink.3 +++ b/man3/mq_unlink.3 @@ -61,7 +61,7 @@ There is no message queue with the given .IR name . .SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR mq_close (3), .BR mq_getattr (3), .BR mq_notify (3), diff --git a/man3/mtrace.3 b/man3/mtrace.3 index 0d0a286a3..3ea4d594e 100644 --- a/man3/mtrace.3 +++ b/man3/mtrace.3 @@ -73,7 +73,7 @@ In set-user-ID and set-group-ID programs, is ignored, and .BR mtrace () has no effect. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are GNU extensions. .SH NOTES In normal usage, @@ -162,7 +162,7 @@ The final message corresponds to the call to .BR calloc (3) (which in turn calls .BR malloc (3)). -.SH "SEE ALSO" +.SH SEE ALSO .BR mtrace (1), .BR malloc (3), .BR malloc_hook (3), diff --git a/man3/nan.3 b/man3/nan.3 index f4a8519f6..a9830458e 100644 --- a/man3/nan.3 +++ b/man3/nan.3 @@ -67,11 +67,11 @@ selects one. On other systems it may do nothing. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. See also IEC 559 and the appendix with recommended functions in IEEE 754/IEEE 854. -.SH "SEE ALSO" +.SH SEE ALSO .BR isnan (3), .BR strtod (3), .BR math_error (7) diff --git a/man3/netlink.3 b/man3/netlink.3 index 20db76002..92cb32e1a 100644 --- a/man3/netlink.3 +++ b/man3/netlink.3 @@ -85,7 +85,7 @@ These macros are nonstandard Linux extensions. It is often better to use netlink via .I libnetlink than via the low-level kernel interface. -.SH "SEE ALSO" +.SH SEE ALSO .BR netlink (7) .UR ftp://ftp.inr.ac.ru\:/ip-routing\:/iproute2* diff --git a/man3/nextafter.3 b/man3/nextafter.3 index d8925c6cb..7aaea5bba 100644 --- a/man3/nextafter.3 +++ b/man3/nextafter.3 @@ -160,7 +160,7 @@ These functions do not set .IR errno . .\" FIXME . Is it intentional that these functions do not set errno? .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6799 -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. This function is defined in IEC 559 (and the appendix with recommended functions in IEEE 754/IEEE 854). @@ -169,5 +169,5 @@ In glibc version 2.5 and earlier, these functions do not raise an underflow floating-point .RB ( FE_UNDERFLOW ) exception when an underflow occurs. -.SH "SEE ALSO" +.SH SEE ALSO .BR nearbyint (3) diff --git a/man3/nl_langinfo.3 b/man3/nl_langinfo.3 index 04ddc6483..240573f97 100644 --- a/man3/nl_langinfo.3 +++ b/man3/nl_langinfo.3 @@ -96,7 +96,7 @@ value, or "." if the symbol should replace the radix character. The above list covers just some examples of items that can be requested. For a more detailed list, consult .IR "The GNU C Library Reference Manual" . -.SH "RETURN VALUE" +.SH RETURN VALUE If no locale has been selected by .BR setlocale (3) for the appropriate category, @@ -111,9 +111,9 @@ next call to .BR nl_langinfo () or .BR setlocale (3). -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv2, POSIX.1-2001. -.SH "EXAMPLE" +.SH EXAMPLE The following program sets the character type locale according to the environment and queries the terminal character set. .LP @@ -131,7 +131,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR locale (1), .BR localeconv (3), .BR setlocale (3), diff --git a/man3/offsetof.3 b/man3/offsetof.3 index 179d63115..331834656 100644 --- a/man3/offsetof.3 +++ b/man3/offsetof.3 @@ -48,14 +48,14 @@ given by the sum of the sizes of the previous elements. A compiler error will result if \fImember\fP is not aligned to a byte boundary (i.e., it is a bit field). -.SH "RETURN VALUE" +.SH RETURN VALUE .BR offsetof () returns the offset of the given .I member within the given .IR type , in units of bytes. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001. .SH EXAMPLE On a Linux/i386 system, when compiled using the default diff --git a/man3/on_exit.3 b/man3/on_exit.3 index b7016e780..345e643ce 100644 --- a/man3/on_exit.3 +++ b/man3/on_exit.3 @@ -64,19 +64,19 @@ it inherits copies of its parent's registrations. Upon a successful call to one of the .BR exec (3) functions, all registrations are removed. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR on_exit () function returns the value 0 if successful; otherwise it returns a nonzero value. -.SH "CONFORMING TO" +.SH CONFORMING TO This function comes from SunOS 4, but is also present in libc4, libc5 and glibc. It no longer occurs in Solaris (SunOS 5). Avoid this function, and use the standard .BR atexit (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR _exit (2), .BR atexit (3), .BR exit (3) diff --git a/man3/opendir.3 b/man3/opendir.3 index ac75acbae..ac637e6f7 100644 --- a/man3/opendir.3 +++ b/man3/opendir.3 @@ -78,7 +78,7 @@ After a successful call to .I fd is used internally by the implementation, and should not otherwise be used by the application. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR opendir () and @@ -113,7 +113,7 @@ Insufficient memory to complete the operation. .SH VERSIONS .BR fdopendir () is available in glibc since version 2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR opendir () is present on SVr4, 4.3BSD, and specified in POSIX.1-2001. .BR fdopendir () @@ -135,7 +135,7 @@ POSIX.1-200x leaves it unspecified whether a successful call to .BR fdopendir () will set the close-on-exec flag for the file descriptor, .IR fd . -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2), .BR closedir (3), .BR dirfd (3), diff --git a/man3/openpty.3 b/man3/openpty.3 index ca1527892..278b58d2e 100644 --- a/man3/openpty.3 +++ b/man3/openpty.3 @@ -108,7 +108,7 @@ and arguments, if not NULL, will determine the terminal attributes and window size of the slave side of the pseudoterminal. -.SH "RETURN VALUE" +.SH RETURN VALUE If a call to .BR openpty (), .BR login_tty (), @@ -145,7 +145,7 @@ will fail if either or .BR fork (2) fails. -.SH "CONFORMING TO" +.SH CONFORMING TO These are BSD functions, present in libc5 and glibc2. They are not standardized in POSIX. .SH NOTES @@ -173,7 +173,7 @@ or with non-NULL .I name may not be secure. -.SH "SEE ALSO" +.SH SEE ALSO .BR fork (2), .BR ttyname (3), .BR pty (7) diff --git a/man3/perror.3 b/man3/perror.3 index 85015f442..e4d6dd273 100644 --- a/man3/perror.3 +++ b/man3/perror.3 @@ -108,7 +108,7 @@ Thus, if a failing call is not immediately followed by a call to the value of .I errno should be saved. -.SH "CONFORMING TO" +.SH CONFORMING TO The function .BR perror () and the external @@ -136,7 +136,7 @@ are defined by glibc, but in .\" and .\" .I _sys_errlist .\" are provided. -.SH "SEE ALSO" +.SH SEE ALSO .BR err (3), .BR errno (3), .BR error (3), diff --git a/man3/popen.3 b/man3/popen.3 index e6c0f31a7..d385a18a9 100644 --- a/man3/popen.3 +++ b/man3/popen.3 @@ -118,7 +118,7 @@ The function waits for the associated process to terminate and returns the exit status of the command as returned by .BR wait4 (2). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR popen () function returns NULL if the @@ -164,7 +164,7 @@ cannot obtain the child status, .I errno is set to .BR ECHILD . -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. The \(aqe\(aq value for @@ -193,7 +193,7 @@ The only hint is an exit status of 127. .\" and a .\" .BR pclose () .\" function appeared in Version 7 AT&T UNIX. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh (1), .BR fork (2), .BR pipe (2), diff --git a/man3/posix_fallocate.3 b/man3/posix_fallocate.3 index 1d3b27382..46a5ba756 100644 --- a/man3/posix_fallocate.3 +++ b/man3/posix_fallocate.3 @@ -61,13 +61,13 @@ If the size of the file is less than .IR offset + len , then the file is increased to this size; otherwise the file size is left unchanged. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR posix_fallocate () returns zero on success, or an error number on failure. Note that .I errno is not set. -.SH "ERRORS" +.SH ERRORS .TP .B EBADF .I fd @@ -98,7 +98,7 @@ refers to a pipe. .SH VERSIONS .BR posix_fallocate () is available since glibc 2.1.94. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. POSIX.1-2008 says that an implementation @@ -123,7 +123,7 @@ was less than 0, and give the error if .I len equals zero. -.SH "SEE ALSO" +.SH SEE ALSO .BR fallocate (1), .BR fallocate (2), .BR lseek (2), diff --git a/man3/posix_memalign.3 b/man3/posix_memalign.3 index 927682c16..540751042 100644 --- a/man3/posix_memalign.3 +++ b/man3/posix_memalign.3 @@ -138,7 +138,7 @@ but rounds the size of the allocation up to the next multiple of the system page size. For all of these functions, the memory is not zeroed. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR aligned_alloc (), .BR memalign (), .BR valloc (), @@ -152,7 +152,7 @@ next section on failure. Note that .I errno is not set. -.SH "ERRORS" +.SH ERRORS .TP .B EINVAL The @@ -177,7 +177,7 @@ was added to glibc in version 2.16. The function .BR posix_memalign () is available since glibc 2.1.91. -.SH "CONFORMING TO" +.SH CONFORMING TO The function .BR valloc () appeared in 3.0BSD. @@ -267,7 +267,7 @@ The glibc .BR malloc (3) always returns 8-byte aligned memory addresses, so these functions are only needed if you require larger alignment values. -.SH "SEE ALSO" +.SH SEE ALSO .BR brk (2), .BR getpagesize (2), .BR free (3), diff --git a/man3/posix_openpt.3 b/man3/posix_openpt.3 index aa81d3c44..578d20d34 100644 --- a/man3/posix_openpt.3 +++ b/man3/posix_openpt.3 @@ -59,7 +59,7 @@ It is usual to specify this flag. .TP .B O_NOCTTY Do not make this device the controlling terminal for the process. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR posix_openpt () returns a nonnegative file descriptor which is the lowest @@ -74,7 +74,7 @@ See Glibc support for .BR posix_openpt () has been provided since version 2.2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR posix_openpt () is part of the UNIX 98 pseudoterminal support (see .BR pts (4)). @@ -103,7 +103,7 @@ creates a pathname for the corresponding pseudoterminal slave device. The pathname of the slave device can be obtained using .BR ptsname (3). The slave device pathname exists only as long as the master device is open. -.SH "SEE ALSO" +.SH SEE ALSO .BR open (2), .BR getpt (3), .BR grantpt (3), diff --git a/man3/pow.3 b/man3/pow.3 index 89ebcdb7e..3c196710a 100644 --- a/man3/pow.3 +++ b/man3/pow.3 @@ -308,7 +308,7 @@ is set to An underflow floating-point exception .RB ( FE_UNDERFLOW ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -357,7 +357,7 @@ when an overflow or underflow error occurs, glibc's generates a bogus invalid floating-point exception .RB ( FE_INVALID ) in addition to the overflow or underflow exception. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR cpow (3), .BR sqrt (3) diff --git a/man3/pow10.3 b/man3/pow10.3 index 170318ad5..e3f050b6b 100644 --- a/man3/pow10.3 +++ b/man3/pow10.3 @@ -43,11 +43,11 @@ function returns the value of 10 raised to the power \fIx\fP. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO This is a GNU extension. .SH NOTES These functions are identical to the functions listed under .BR exp10 (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR exp10 (3), .BR pow (3) diff --git a/man3/printf.3 b/man3/printf.3 index 1d832ca07..a703ff3a0 100644 --- a/man3/printf.3 +++ b/man3/printf.3 @@ -803,7 +803,7 @@ A \(aq%\(aq is written. No argument is converted. The complete conversion specification is \(aq%%\(aq. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR fprintf (), .BR printf (), @@ -1071,7 +1071,7 @@ make_message(const char *fmt, ...) } } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR printf (1), .BR asprintf (3), .BR dprintf (3), diff --git a/man3/profil.3 b/man3/profil.3 index e042161d1..b53a0d0ed 100644 --- a/man3/profil.3 +++ b/man3/profil.3 @@ -63,9 +63,9 @@ is incremented. If .I buf is NULL, profiling is disabled. -.SH "RETURN VALUE" +.SH RETURN VALUE Zero is always returned. -.SH "CONFORMING TO" +.SH CONFORMING TO Similar to a call in SVr4 (but not POSIX.1-2001). .SH BUGS .BR profil () @@ -76,7 +76,7 @@ interval timers (see True kernel profiling provides more accurate results. Libc 4.4 contained a kernel patch providing a system call profil. -.SH "SEE ALSO" +.SH SEE ALSO .BR gprof (1), .BR setitimer (2), .BR sigaction (2), diff --git a/man3/program_invocation_name.3 b/man3/program_invocation_name.3 index 9564756a8..db91141e0 100644 --- a/man3/program_invocation_name.3 +++ b/man3/program_invocation_name.3 @@ -50,7 +50,7 @@ with all text up to and including the final slash (/), if any, removed. These variables are automatically initialized by the glibc run-time startup code. -.SH "CONFORMING TO" +.SH CONFORMING TO These variables are GNU extensions, and should not be used in programs intended to be portable. .SH NOTES diff --git a/man3/psignal.3 b/man3/psignal.3 index 29420afb1..1d0bc4a23 100644 --- a/man3/psignal.3 +++ b/man3/psignal.3 @@ -84,7 +84,7 @@ or The array \fIsys_siglist\fP holds the signal description strings indexed by signal number. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR psignal () and @@ -94,7 +94,7 @@ functions return no value. The .BR psiginfo () function was added to glibc in version 2.10. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008, 4.3BSD. .SH BUGS In glibc versions up to 2.12, @@ -108,7 +108,7 @@ In some circumstances, a trailing newline is not printed. Additional details are not displayed for real-time signals. .\" FIXME http://sourceware.org/bugzilla/show_bug.cgi?id=12108 .\" Reportedly now fixed; check glibc 2.13 -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction (2), .BR perror (3), .BR strsignal (3), diff --git a/man3/pthread_kill_other_threads_np.3 b/man3/pthread_kill_other_threads_np.3 index 824ced32b..9cceca933 100644 --- a/man3/pthread_kill_other_threads_np.3 +++ b/man3/pthread_kill_other_threads_np.3 @@ -61,7 +61,7 @@ exists, but does nothing. (Nothing needs to be done, because the implementation does the right thing during an .BR execve (2).) -.SH "SEE ALSO" +.SH SEE ALSO .BR execve (2), .BR pthread_cancel (3), .BR pthread_setcancelstate (3), diff --git a/man3/ptsname.3 b/man3/ptsname.3 index 4bf418caf..d2bc0c474 100644 --- a/man3/ptsname.3 +++ b/man3/ptsname.3 @@ -38,7 +38,7 @@ The .I buflen argument specifies the number of bytes available in .IR buf . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR ptsname () returns a pointer to a string in static storage which will be @@ -75,7 +75,7 @@ is too small. .SH VERSIONS .BR ptsname () is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR ptsname () is part of the UNIX 98 pseudoterminal support (see .BR pts (4)). @@ -88,7 +88,7 @@ on those implementations, \-1 is returned on error, with .I errno set to indicate the error. Avoid using this function in portable programs. -.SH "SEE ALSO" +.SH SEE ALSO .BR grantpt (3), .BR posix_openpt (3), .BR ttyname (3), diff --git a/man3/putenv.3 b/man3/putenv.3 index a35c7ab0a..c7f1c5a5e 100644 --- a/man3/putenv.3 +++ b/man3/putenv.3 @@ -62,7 +62,7 @@ then the value of \fIname\fP in the environment is changed to \fIvalue\fP. The string pointed to by \fIstring\fP becomes part of the environment, so altering the string changes the environment. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR putenv () function returns zero on success, @@ -71,7 +71,7 @@ or nonzero if an error occurs. .TP .B ENOMEM Insufficient space to allocate new environment. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD. .SH NOTES The @@ -111,7 +111,7 @@ This has been fixed in glibc 2.1.2. The 4.4BSD version, like glibc 2.0, uses a copy. .LP SUSv2 removes the \fIconst\fP from the prototype, and so does glibc 2.1.3. -.SH "SEE ALSO" +.SH SEE ALSO .BR clearenv (3), .BR getenv (3), .BR setenv (3), diff --git a/man3/putgrent.3 b/man3/putgrent.3 index ffad998d1..0b7cf66f9 100644 --- a/man3/putgrent.3 +++ b/man3/putgrent.3 @@ -32,11 +32,11 @@ struct group { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The function returns zero on success, and a nonzero value on error. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetgrent (3), .BR getgrent (3), .BR group (5) diff --git a/man3/putpwent.3 b/man3/putpwent.3 index 2b185f71c..00cf72950 100644 --- a/man3/putpwent.3 +++ b/man3/putpwent.3 @@ -65,7 +65,7 @@ struct passwd { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR putpwent () function returns 0 on success, or \-1 if an error @@ -74,9 +74,9 @@ occurs. .TP .B EINVAL Invalid (NULL) argument given. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. -.SH "SEE ALSO" +.SH SEE ALSO .BR endpwent (3), .BR fgetpwent (3), .BR getpw (3), diff --git a/man3/puts.3 b/man3/puts.3 index 0dd686446..afeee2bbb 100644 --- a/man3/puts.3 +++ b/man3/puts.3 @@ -79,7 +79,7 @@ library for the same output stream. .PP For nonlocking counterparts, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE .BR fputc (), .BR putc () and @@ -98,7 +98,7 @@ and return a nonnegative number on success, or .B EOF on error. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99. .SH BUGS It is not advisable to mix calls to output functions from the @@ -107,7 +107,7 @@ library with low-level calls to .BR write (2) for the file descriptor associated with the same output stream; the results will be undefined and very probably not what you want. -.SH "SEE ALSO" +.SH SEE ALSO .BR write (2), .BR ferror (3), .BR fopen (3), diff --git a/man3/putwchar.3 b/man3/putwchar.3 index 79bb8a88c..a1a48a81a 100644 --- a/man3/putwchar.3 +++ b/man3/putwchar.3 @@ -37,13 +37,13 @@ Otherwise it returns \fIwc\fP. .PP For a nonlocking counterpart, see .BR unlocked_stdio (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR putwchar () function returns \fIwc\fP if no error occurred, or .B WEOF to indicate an error. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -57,6 +57,6 @@ It is reasonable to expect that .BR putwchar () will actually write the multibyte sequence corresponding to the wide character \fIwc\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR fputwc (3), .BR unlocked_stdio (3) diff --git a/man3/qecvt.3 b/man3/qecvt.3 index aae81296b..0fd7fc013 100644 --- a/man3/qecvt.3 +++ b/man3/qecvt.3 @@ -67,7 +67,7 @@ See .BR ecvt (3) and .BR gcvt (3). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4. Not seen in most common UNIX implementations, but occurs in SunOS. @@ -78,7 +78,7 @@ These functions are obsolete. Instead, .BR sprintf (3) is recommended. -.SH "SEE ALSO" +.SH SEE ALSO .BR ecvt (3), .BR ecvt_r (3), .BR gcvt (3), diff --git a/man3/qsort.3 b/man3/qsort.3 index 4c266aa68..e45e5f8a8 100644 --- a/man3/qsort.3 +++ b/man3/qsort.3 @@ -86,7 +86,7 @@ A pointer is passed to the comparison function via In this way, the comparison function does not need to use global variables to pass through arbitrary arguments, and is therefore reentrant and safe to use in threads. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR qsort () and @@ -95,7 +95,7 @@ functions return no value. .SH VERSIONS .BR qsort_r () was added to glibc in version 2.8. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR qsort () function conforms to SVr4, 4.3BSD, C89, C99. @@ -150,7 +150,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR sort (1), .BR alphasort (3), .BR strcmp (3), diff --git a/man3/queue.3 b/man3/queue.3 index a918a3f13..b21e6f37b 100644 --- a/man3/queue.3 +++ b/man3/queue.3 @@ -480,7 +480,7 @@ for (np = head.cqh_last; np != (void *)&head; np = np\->entries.cqe_prev) while (head.cqh_first != (void *)&head) CIRCLEQ_REMOVE(&head, head.cqh_first, entries); .fi -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs. The diff --git a/man3/raise.3 b/man3/raise.3 index 4ea406872..b43412e34 100644 --- a/man3/raise.3 +++ b/man3/raise.3 @@ -56,10 +56,10 @@ pthread_kill(pthread_self(), sig); If the signal causes a handler to be called, .BR raise () will only return after the signal handler has returned. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR raise () returns 0 on success, and nonzero for failure. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001. .SH NOTES Since version 2.3.3, glibc implements @@ -72,7 +72,7 @@ Older glibc versions implemented .BR raise () using .BR kill (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR getpid (2), .BR kill (2), .BR sigaction (2), diff --git a/man3/rand.3 b/man3/rand.3 index 07ba31bf1..c2472cdb5 100644 --- a/man3/rand.3 +++ b/man3/rand.3 @@ -113,7 +113,7 @@ so this function will be a weak pseudo-random generator. Try .BR drand48_r (3) instead. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR rand () and @@ -124,7 +124,7 @@ functions return a value between 0 and The .BR srand () function returns no value. -.SH "CONFORMING TO" +.SH CONFORMING TO The functions .BR rand () and @@ -212,6 +212,6 @@ main(int argc, char *argv[]) } .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR drand48 (3), .BR random (3) diff --git a/man3/random.3 b/man3/random.3 index 5a35e048b..c2be188af 100644 --- a/man3/random.3 +++ b/man3/random.3 @@ -113,7 +113,7 @@ using .BR initstate () or be the result of a previous call of .BR setstate (). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR random () function returns a value between 0 and @@ -132,7 +132,7 @@ function returns a pointer to the previous state array, or NULL on error. .B EINVAL A state array of less than 8 bytes was specified to .BR initstate (). -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH NOTES Current "optimal" values for the size of the state array \fIn\fP are @@ -160,7 +160,7 @@ in depth, see Chapter 3 (Random Numbers) in Donald E. Knuth's .IR "The Art of Computer Programming" , volume 2 (Seminumerical Algorithms), 2nd ed.; Reading, Massachusetts: Addison-Wesley Publishing Company, 1981. -.SH "SEE ALSO" +.SH SEE ALSO .BR drand48 (3), .BR rand (3), .BR random_r (3), diff --git a/man3/random_r.3 b/man3/random_r.3 index 1954a8a8c..5f4f6725b 100644 --- a/man3/random_r.3 +++ b/man3/random_r.3 @@ -95,7 +95,7 @@ function is like except that it modifies the state in the object pointer to by .IR buf , rather than modifying the global state variable. -.SH "RETURN VALUE" +.SH RETURN VALUE All of these functions return 0 on success, or \-1 on error. .SH ERRORS .TP @@ -120,11 +120,11 @@ or argument to .BR random_r () was NULL. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are nonstandard glibc extensions. .\" These functions appear to be on Tru64, but don't seem to be on .\" Solaris, HP-UX, or FreeBSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR drand48 (3), .BR rand (3), .BR random (3) diff --git a/man3/rcmd.3 b/man3/rcmd.3 index d31cda812..bbb958548 100644 --- a/man3/rcmd.3 +++ b/man3/rcmd.3 @@ -265,7 +265,7 @@ The functions and .BR ruserok_af () functions are provide in glibc since version 2.2. -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on the BSDs, Solaris, and many other systems. These diff --git a/man3/re_comp.3 b/man3/re_comp.3 index 04ce94ce3..1c64f825b 100644 --- a/man3/re_comp.3 +++ b/man3/re_comp.3 @@ -53,7 +53,7 @@ is used to assess whether the null-terminated string pointed to by .I string matches the previously compiled .IR regex . -.SH "RETURN VALUE" +.SH RETURN VALUE .BR re_comp () returns NULL on successful compilation of .I regex @@ -61,13 +61,13 @@ otherwise it returns a pointer to an appropriate error message. .BR re_exec () returns 1 for a successful match, zero for failure. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. .SH NOTES These functions are obsolete; the functions documented in .BR regcomp (3) should be used instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR regcomp (3), .BR regex (7), GNU regex manual diff --git a/man3/readdir.3 b/man3/readdir.3 index 90f2ff1f3..c788ba966 100644 --- a/man3/readdir.3 +++ b/man3/readdir.3 @@ -114,7 +114,7 @@ A pointer to the returned item is placed in if the end of the directory stream was encountered, then NULL is instead returned in .IR *result . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR readdir () returns a pointer to a @@ -142,7 +142,7 @@ returns 0, and returns NULL in .TP .B EBADF Invalid directory stream descriptor \fIdirp\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. .SH NOTES Only the fields @@ -238,7 +238,7 @@ entryp = malloc(len); .I d_name is the last field in a .IR "struct dirent" .) -.SH "SEE ALSO" +.SH SEE ALSO .BR getdents (2), .BR read (2), .BR closedir (3), diff --git a/man3/realpath.3 b/man3/realpath.3 index fb8bcc597..027539054 100644 --- a/man3/realpath.3 +++ b/man3/realpath.3 @@ -86,7 +86,7 @@ The caller should deallocate this buffer using .\" The .\" .BR realpath () .\" function first appeared in 4.4BSD, contributed by Jan-Simon Pendry. -.SH "RETURN VALUE" +.SH RETURN VALUE If there is no error, .BR realpath () returns a pointer to the @@ -132,7 +132,7 @@ The named file does not exist. A component of the path prefix is not a directory. .SH VERSIONS On Linux this function appeared in libc 4.5.21. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, POSIX.1-2001. POSIX.1-2001 says that the behavior if @@ -210,7 +210,7 @@ The libc4 and libc5 implementation contained a buffer overflow Thus, set-user-ID programs like .BR mount (8) needed a private version. -.SH "SEE ALSO" +.SH SEE ALSO .BR readlink (2), .BR canonicalize_file_name (3), .BR getcwd (3), diff --git a/man3/recno.3 b/man3/recno.3 index 843ab1efa..56edcba47 100644 --- a/man3/recno.3 +++ b/man3/recno.3 @@ -219,7 +219,7 @@ An attempt was made to add a record to a fixed-length database that was too large to fit. .SH BUGS Only big and little endian byte order is supported. -.SH "SEE ALSO" +.SH SEE ALSO .BR btree (3), .BR dbopen (3), .BR hash (3), diff --git a/man3/regex.3 b/man3/regex.3 index c93dc145e..0f69a27e0 100644 --- a/man3/regex.3 +++ b/man3/regex.3 @@ -246,7 +246,7 @@ with a precompiled pattern buffer, will free the memory allocated to the pattern buffer by the compiling process, .BR regcomp (). -.SH "RETURN VALUE" +.SH RETURN VALUE .BR regcomp () returns zero for a successful compilation or an error code for failure. @@ -303,9 +303,9 @@ The regex routines ran out of memory. .TP .B REG_ESUBREG Invalid back reference to a subexpression. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR grep (1), .BR regex (7) .br diff --git a/man3/remainder.3 b/man3/remainder.3 index 3ed3c8c37..db6993b7c 100644 --- a/man3/remainder.3 +++ b/man3/remainder.3 @@ -113,7 +113,7 @@ These functions are unaffected by the current rounding mode (see The .BR drem () function does precisely the same thing. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the floating-point remainder, \fIx\fP\-\fIn\fP*\fIy\fP. @@ -175,7 +175,7 @@ is set to An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO .\" IEC 60559. The functions .BR remainder (), @@ -210,7 +210,7 @@ it should yield a silent NaN. .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779 .SH EXAMPLE The call "remainder(29.0, 3.0)" returns \-1. -.SH "SEE ALSO" +.SH SEE ALSO .BR div (3), .BR fmod (3), .BR remquo (3) diff --git a/man3/remove.3 b/man3/remove.3 index 6e44dfc3e..9c5760d00 100644 --- a/man3/remove.3 +++ b/man3/remove.3 @@ -57,7 +57,7 @@ If the name referred to a symbolic link, the link is removed. If the name referred to a socket, FIFO, or device, the name is removed, but processes which have the object open may continue to use it. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -67,7 +67,7 @@ The errors that occur are those for .BR unlink (2) and .BR rmdir (2). -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, 4.3BSD, POSIX.1-2001. .SH NOTES Under libc4 and libc5, @@ -78,7 +78,7 @@ was an alias for .SH BUGS Infelicities in the protocol underlying NFS can cause the unexpected disappearance of files which are still being used. -.SH "SEE ALSO" +.SH SEE ALSO .BR rm (1), .BR unlink (1), .BR link (2), diff --git a/man3/remquo.3 b/man3/remquo.3 index 9c4a1fd60..b277a9a0f 100644 --- a/man3/remquo.3 +++ b/man3/remquo.3 @@ -116,9 +116,9 @@ These functions do not set .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6802 .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fmod (3), .BR logb (3), .BR remainder (3) diff --git a/man3/resolver.3 b/man3/resolver.3 index 991b26386..af532f7f8 100644 --- a/man3/resolver.3 +++ b/man3/resolver.3 @@ -235,7 +235,7 @@ This option is used by This list is not complete. You can find some other flags described in .BR resolv.conf (5). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR res_init () function returns 0 on success, or \-1 if an error @@ -262,9 +262,9 @@ of the compressed name, or \-1 if an error occurs. /etc/resolv.conf resolver configuration file /etc/host.conf resolver configuration file .fi -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname (3), .BR resolv.conf (5), .BR resolver (5), diff --git a/man3/rewinddir.3 b/man3/rewinddir.3 index 0ce7ecf2a..6e0d7b7f9 100644 --- a/man3/rewinddir.3 +++ b/man3/rewinddir.3 @@ -42,13 +42,13 @@ The .BR rewinddir () function resets the position of the directory stream \fIdirp\fP to the beginning of the directory. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR rewinddir () function returns no value. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR closedir (3), .BR opendir (3), .BR readdir (3), diff --git a/man3/rexec.3 b/man3/rexec.3 index ca286f9df..6add0bfeb 100644 --- a/man3/rexec.3 +++ b/man3/rexec.3 @@ -137,7 +137,7 @@ or The .BR rexec_af () function was added to glibc in version 2.2. -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are not in POSIX.1-2001. The .BR rexec () diff --git a/man3/rint.3 b/man3/rint.3 index a62778488..1481b81dd 100644 --- a/man3/rint.3 +++ b/man3/rint.3 @@ -100,7 +100,7 @@ exception checkable via .BR fetestexcept (3)) when the result differs in value from the argument. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the rounded integer value. If \fIx\fP is integral, +0, \-0, NaN, or infinite, @@ -108,7 +108,7 @@ If \fIx\fP is integral, +0, \-0, NaN, or infinite, .SH ERRORS No errors occur. POSIX.1-2001 documents a range error for overflows, but see NOTES. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES SUSv2 and POSIX.1-2001 contain text about overflow (which might set @@ -130,7 +130,7 @@ If you want to store the rounded value in an integer type, you probably want to use one of the functions described in .BR lrint (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil (3), .BR floor (3), .BR lrint (3), diff --git a/man3/round.3 b/man3/round.3 index 7894c2fe7..bf1011308 100644 --- a/man3/round.3 +++ b/man3/round.3 @@ -68,7 +68,7 @@ For example, is 1.0, and .IR round(\-0.5) is \-1.0. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the rounded integer value. If \fIx\fP is integral, +0, \-0, NaN, or infinite, @@ -78,7 +78,7 @@ No errors occur. POSIX.1-2001 documents a range error for overflows, but see NOTES. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES POSIX.1-2001 contains text about overflow (which might set @@ -101,7 +101,7 @@ If you want to store the rounded value in an integer type, you probably want to use one of the functions described in .BR lround (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil (3), .BR floor (3), .BR lround (3), diff --git a/man3/rpc.3 b/man3/rpc.3 index e70121e16..3a4bd0a22 100644 --- a/man3/rpc.3 +++ b/man3/rpc.3 @@ -7,7 +7,7 @@ .TH RPC 3 2008-07-17 "" "Linux Programmer's Manual" .SH NAME rpc \- library routines for remote procedure calls -.SH "SYNOPSIS AND DESCRIPTION" +.SH SYNOPSIS AND DESCRIPTION These routines allow C programs to make procedure calls on other machines across the network. First, the client calls a procedure to send a data packet to the server. @@ -1095,7 +1095,7 @@ it should unregister itself with the RPC service package. This routine modifies the global variable .IR svc_fds . Service implementors usually do not need this routine. -.SH "SEE ALSO" +.SH SEE ALSO .\" We don't have an rpc_secure.3 page in the set at the moment -- MTK, 19 Sep 05 .\" .BR rpc_secure (3), .BR xdr (3) diff --git a/man3/rpmatch.3 b/man3/rpmatch.3 index fd3f186f5..cdffc5894 100644 --- a/man3/rpmatch.3 +++ b/man3/rpmatch.3 @@ -61,7 +61,7 @@ to effect their changes. Regardless of the locale, responses matching \fB^[Yy]\fP are always accepted as affirmative, and those matching \fB^[Nn]\fP are always accepted as negative. -.SH "RETURN VALUE" +.SH RETURN VALUE After examining .IR response , .BR rpmatch () @@ -82,7 +82,7 @@ can fail; the cause of the error is not available from \fIerrno\fP or anywhere else, but indicates a failure of the regex engine (but this case is indistinguishable from that of an unrecognized value of \fIresponse\fP). -.SH "CONFORMING TO" +.SH CONFORMING TO .BR rpmatch () is not required by any standard, but is available on a few other systems. diff --git a/man3/rtime.3 b/man3/rtime.3 index e79368e8a..dc188aa49 100644 --- a/man3/rtime.3 +++ b/man3/rtime.3 @@ -29,7 +29,7 @@ When .I timeout is non-NULL, the udp/time socket (port 37) is used. Otherwise, the tcp/time socket (port 37) is used. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, 0 is returned, and the obtained 32-bit time value is stored in .IR timep\->tv_sec . In case of error \-1 is returned, and @@ -50,7 +50,7 @@ The number of returned bytes is not 4. .TP .B ETIMEDOUT The waiting time as defined in timeout has expired. -.SH "NOTES" +.SH NOTES Only IPv4 is supported. .LP Some @@ -68,10 +68,10 @@ and requires .I instead of .IR . -.SH "BUGS" +.SH BUGS .BR rtime () in glibc 2.2.5 and earlier does not work properly on 64-bit machines. -.SH "EXAMPLE" +.SH EXAMPLE This example requires that port 37 is up and open. You may check that the time entry within @@ -119,7 +119,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .\" .BR netdate (1), .BR ntpdate (1), .\" .BR rdate (1), diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3 index 027f668e4..85a9e7fb7 100644 --- a/man3/rtnetlink.3 +++ b/man3/rtnetlink.3 @@ -115,7 +115,7 @@ Creating a rtnetlink message to set the MTU of a device: memcpy(RTA_DATA(rta), &mtu, sizeof(mtu)); send(rtnetlink_sk, &req, req.nh.nlmsg_len); .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR netlink (3), .BR netlink (7), .BR rtnetlink (7) diff --git a/man3/scalb.3 b/man3/scalb.3 index 9af317327..ab7256162 100644 --- a/man3/scalb.3 +++ b/man3/scalb.3 @@ -167,7 +167,7 @@ These functions do not set .\" FIXME . Is it intentional that these functions do not set errno? .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804 -.SH "CONFORMING TO" +.SH CONFORMING TO .BR scalb () is specified in POSIX.1-2001, but marked obsolescent. POSIX.1-2008 removes the specification of @@ -190,6 +190,6 @@ are unstandardized; is nevertheless present on several other systems .\" Looking at header files: scalbf() is present on the .\" BSDs, Tru64, HP-UX 11, Irix 6.5; scalbl() is on HP-UX 11 and Tru64. -.SH "SEE ALSO" +.SH SEE ALSO .BR ldexp (3), .BR scalbln (3) diff --git a/man3/scalbln.3 b/man3/scalbln.3 index 85360eefd..14e68135e 100644 --- a/man3/scalbln.3 +++ b/man3/scalbln.3 @@ -150,7 +150,7 @@ These functions do not set .\" Bug raised: http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803 .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES These functions differ from the obsolete functions described in @@ -168,6 +168,6 @@ equals 2 (which is usual), then .BR scalbn () is equivalent to .BR ldexp (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR ldexp (3), .BR scalb (3) diff --git a/man3/scandir.3 b/man3/scandir.3 index 4526331fc..3f900c39f 100644 --- a/man3/scandir.3 +++ b/man3/scandir.3 @@ -87,7 +87,7 @@ The former sorts directory entries using the latter using .BR strverscmp (3) on the strings \fI(*a)\->d_name\fP and \fI(*b)\->d_name\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR scandir () function returns the number of directory entries @@ -113,7 +113,7 @@ The path in \fIdirp\fR is not a directory. .SH VERSIONS .BR versionsort () was added to glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR alphasort () and .BR scandir () @@ -169,7 +169,7 @@ main(void) } } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR closedir (3), .BR fnmatch (3), .BR opendir (3), diff --git a/man3/scandirat.3 b/man3/scandirat.3 index c3f07373c..ae426d400 100644 --- a/man3/scandirat.3 +++ b/man3/scandirat.3 @@ -76,7 +76,7 @@ If is absolute, then .I dirfd is ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR scandirat () returns the number of directory entries selected. @@ -103,14 +103,14 @@ is a file descriptor referring to a file other than a directory. .SH VERSIONS .BR scandirat () was added to glibc in version 2.15. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. .SH NOTES See .BR openat (2) for an explanation of the need for .BR scandirat (). -.SH "SEE ALSO" +.SH SEE ALSO .BR openat (2), .BR scandir (3), .BR path_resolution (7) diff --git a/man3/scanf.3 b/man3/scanf.3 index 2b3abdec8..8e26fa53e 100644 --- a/man3/scanf.3 +++ b/man3/scanf.3 @@ -526,7 +526,7 @@ Probably it is wise not to make any assumptions on the effect of .B %n conversions on the return value. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the number of input items successfully matched and assigned, which can be fewer than provided for, @@ -573,7 +573,7 @@ Out of memory. .B ERANGE The result of an integer conversion would exceed the size that can be stored in the corresponding integer type. -.SH "CONFORMING TO" +.SH CONFORMING TO The functions .BR fscanf (), .BR scanf (), @@ -711,7 +711,7 @@ As shown in the above example, it is only necessary to call if the .BR scanf () call successfully read a string. -.SH "SEE ALSO" +.SH SEE ALSO .BR getc (3), .BR printf (3), .BR setlocale (3), diff --git a/man3/seekdir.3 b/man3/seekdir.3 index 6286e34c0..3f6adf040 100644 --- a/man3/seekdir.3 +++ b/man3/seekdir.3 @@ -55,11 +55,11 @@ should be used with an .I offset returned by .BR telldir (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR seekdir () function returns no value. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH NOTES In glibc up to version 2.1.1, the type of the @@ -69,7 +69,7 @@ argument was POSIX.1-2001 specifies .IR long , and this is the type used since glibc 2.1.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR lseek (2), .BR closedir (3), .BR opendir (3), diff --git a/man3/sem_close.3 b/man3/sem_close.3 index a6b80f83f..3fdef6a96 100644 --- a/man3/sem_close.3 +++ b/man3/sem_close.3 @@ -57,7 +57,7 @@ POSIX.1-2001. All open named semaphores are automatically closed on process termination, or upon .BR execve (2). -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_getvalue (3), .BR sem_open (3), .BR sem_post (3), diff --git a/man3/sem_destroy.3 b/man3/sem_destroy.3 index f474ea66d..743bdc22c 100644 --- a/man3/sem_destroy.3 +++ b/man3/sem_destroy.3 @@ -71,7 +71,7 @@ An unnamed semaphore should be destroyed with before the memory in which it is located is deallocated. Failure to do this can result in resource leaks on some implementations. .\" But not on NPTL, where sem_destroy () is a no-op.. -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_init (3), .BR sem_post (3), .BR sem_wait (3), diff --git a/man3/sem_getvalue.3 b/man3/sem_getvalue.3 index 65e2d3a0e..407193bf6 100644 --- a/man3/sem_getvalue.3 +++ b/man3/sem_getvalue.3 @@ -68,7 +68,7 @@ POSIX.1-2001. The value of the semaphore may already have changed by the time .BR sem_getvalue () returns. -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_post (3), .BR sem_wait (3), .BR sem_overview (7) diff --git a/man3/sem_init.3 b/man3/sem_init.3 index 87b3dadae..31c1222cc 100644 --- a/man3/sem_init.3 +++ b/man3/sem_init.3 @@ -99,7 +99,7 @@ Bizarrely, POSIX.1-2001 does not specify the value that should be returned by a successful call to .BR sem_init (). POSIX.1-2008 rectifies this, specifying the zero return on success. -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_destroy (3), .BR sem_post (3), .BR sem_wait (3), diff --git a/man3/sem_open.3 b/man3/sem_open.3 index 174e254f4..e7a191be6 100644 --- a/man3/sem_open.3 +++ b/man3/sem_open.3 @@ -169,7 +169,7 @@ wasn't well formed. Insufficient memory. .SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_close (3), .BR sem_getvalue (3), .BR sem_post (3), diff --git a/man3/sem_post.3 b/man3/sem_post.3 index 25010e710..dcfcc6822 100644 --- a/man3/sem_post.3 +++ b/man3/sem_post.3 @@ -67,7 +67,7 @@ it may be safely called within a signal handler. .SH EXAMPLE See .BR sem_wait (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_getvalue (3), .BR sem_wait (3), .BR sem_overview (7) diff --git a/man3/sem_unlink.3 b/man3/sem_unlink.3 index 4add7dc44..2b3d56c8c 100644 --- a/man3/sem_unlink.3 +++ b/man3/sem_unlink.3 @@ -61,7 +61,7 @@ There is no semaphore with the given .IR name . .SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_getvalue (3), .BR sem_open (3), .BR sem_post (3), diff --git a/man3/sem_wait.3 b/man3/sem_wait.3 index 9b795c11e..31bf47846 100644 --- a/man3/sem_wait.3 +++ b/man3/sem_wait.3 @@ -259,7 +259,7 @@ main(int argc, char *argv[]) exit((s == 0) ? EXIT_SUCCESS : EXIT_FAILURE); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR clock_gettime (2), .BR sem_getvalue (3), .BR sem_post (3), diff --git a/man3/setaliasent.3 b/man3/setaliasent.3 index cfa3ef684..425cf2071 100644 --- a/man3/setaliasent.3 +++ b/man3/setaliasent.3 @@ -82,7 +82,7 @@ struct aliasent { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The functions .BR getaliasent_r () and @@ -94,7 +94,7 @@ The default alias database is the file This can be changed in the .I /etc/nsswitch.conf file. -.SH "CONFORMING TO" +.SH CONFORMING TO These routines are glibc-specific. The NeXT system has similar routines: .in +4n @@ -138,7 +138,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR getgrent (3), .BR getpwent (3), .BR getspent (3), diff --git a/man3/setbuf.3 b/man3/setbuf.3 index 49fca4dc7..7f94944ef 100644 --- a/man3/setbuf.3 +++ b/man3/setbuf.3 @@ -147,7 +147,7 @@ function is exactly equivalent to the call: .in +4n setvbuf(stream, NULL, _IOLBF, 0); .in -.SH "RETURN VALUE" +.SH RETURN VALUE The function .BR setvbuf () returns 0 on success. @@ -159,7 +159,7 @@ It may set on failure. The other functions do not return a value. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR setbuf () and @@ -195,7 +195,7 @@ main(void) return 0; } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fclose (3), .BR fflush (3), .BR fopen (3), diff --git a/man3/setenv.3 b/man3/setenv.3 index 2b0381616..607dc09a1 100644 --- a/man3/setenv.3 +++ b/man3/setenv.3 @@ -81,7 +81,7 @@ If .I name does not exist in the environment, then the function succeeds, and the environment is unchanged. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR setenv () function returns zero on success, @@ -95,7 +95,7 @@ function returns zero on success, or \-1 on error, with .I errno set to indicate the cause of the error. -.SH "ERRORS" +.SH ERRORS .TP .B EINVAL .I name @@ -104,9 +104,9 @@ or contains an \(aq=\(aq character. .TP .B ENOMEM Insufficient memory to add a new variable to the environment. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. -.SH "NOTES" +.SH NOTES POSIX.1-2001 does not require .BR setenv () or @@ -127,7 +127,7 @@ should fail with the error .BR EINVAL ; however, versions of glibc before 2.3.4 allowed an \(aq=\(aq sign in .IR name . -.SH "SEE ALSO" +.SH SEE ALSO .BR clearenv (3), .BR getenv (3), .BR putenv (3), diff --git a/man3/setjmp.3 b/man3/setjmp.3 index b2a333fb2..697629050 100644 --- a/man3/setjmp.3 +++ b/man3/setjmp.3 @@ -68,7 +68,7 @@ the process's current signal mask is saved in \fIenv\fP and will be restored if a .BR siglongjmp (3) is later performed with this \fIenv\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR setjmp () and .BR sigsetjmp () @@ -78,7 +78,7 @@ nonzero when returning from or .BR siglongjmp (3) using the saved context. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, and POSIX.1-2001 specify .BR setjmp (). POSIX.1-2001 specifies @@ -114,6 +114,6 @@ and make programs hard to understand and maintain. If possible an alternative should be used. -.SH "SEE ALSO" +.SH SEE ALSO .BR longjmp (3), .BR siglongjmp (3) diff --git a/man3/setlocale.3 b/man3/setlocale.3 index 102187a54..9aafb6bd8 100644 --- a/man3/setlocale.3 +++ b/man3/setlocale.3 @@ -159,7 +159,7 @@ or .BR strxfrm (3), .BR wcsxfrm (3) to compare strings. -.SH "RETURN VALUE" +.SH RETURN VALUE A successful call to .BR setlocale () returns an opaque string that corresponds to the locale set. @@ -168,7 +168,7 @@ The string returned is such that a subsequent call with that string and its associated category will restore that part of the process's locale. The return value is NULL if the request cannot be honored. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001. .SH NOTES Linux (that is, glibc) supports the portable locales @@ -185,7 +185,7 @@ sufficed to make return the right answer. These days non-English speaking Europeans have to work a bit harder, and must install actual locale files. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale (1), .BR localedef (1), .BR isalpha (3), diff --git a/man3/setlogmask.3 b/man3/setlogmask.3 index 77d8d16ce..29b6bc48f 100644 --- a/man3/setlogmask.3 +++ b/man3/setlogmask.3 @@ -58,16 +58,16 @@ and The bit corresponding to a priority \fIp\fP is \fBLOG_MASK\fP(\fIp\fP). Some systems also provide a macro \fBLOG_UPTO\fP(\fIp\fP) for the mask of all priorities in the above list up to and including \fIp\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE This function returns the previous log priority mask. .SH ERRORS None. .\" .SH NOTES .\" The glibc logmask handling was broken in versions before glibc 2.1.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. Note that the description in POSIX.1-2001 is flawed. -.SH "SEE ALSO" +.SH SEE ALSO .BR closelog (3), .BR openlog (3), .BR syslog (3) diff --git a/man3/setnetgrent.3 b/man3/setnetgrent.3 index 72aa5c7b4..bdf94537e 100644 --- a/man3/setnetgrent.3 +++ b/man3/setnetgrent.3 @@ -78,7 +78,7 @@ The function can be used for this without calling the above three functions. Again, a NULL pointer is a wildcard and matches any string. The function is thread-safe. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return 1 on success and 0 for failure. .SH FILES .I /etc/netgroup @@ -99,7 +99,7 @@ is not widely available on other systems. In the BSD implementation, .BR setnetgrent () returns void. -.SH "SEE ALSO" +.SH SEE ALSO .BR sethostent (3), .BR setprotoent (3), .BR setservent (3) diff --git a/man3/shm_open.3 b/man3/shm_open.3 index 00b53fcb2..0160f670f 100644 --- a/man3/shm_open.3 +++ b/man3/shm_open.3 @@ -166,7 +166,7 @@ an object with the same will fail (unless .B O_CREAT was specified, in which case a new, distinct object is created). -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR shm_open () returns a nonnegative file descriptor. @@ -246,13 +246,13 @@ a that does not exist. .SH VERSIONS These functions are provided in glibc 2.2 and later. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .LP POSIX.1-2001 says that the group ownership of a newly created shared memory object is set to either the calling process's effective group ID or "a system default group ID". -.SH "NOTES" +.SH NOTES .LP POSIX leaves the behavior of the combination of .B O_RDONLY @@ -266,7 +266,7 @@ The POSIX shared memory object implementation on Linux 2.4 makes use of a dedicated file system, which is normally mounted under .IR /dev/shm . -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR fchmod (2), .BR fchown (2), diff --git a/man3/siginterrupt.3 b/man3/siginterrupt.3 index e5589d9e7..1322ef4c9 100644 --- a/man3/siginterrupt.3 +++ b/man3/siginterrupt.3 @@ -68,7 +68,7 @@ and \fIerrno\fP will be set to If the \fIflag\fP argument is true (1) and data transfer has started, then the system call will be interrupted and will return the actual amount of data transferred. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR siginterrupt () function returns 0 on success, or \-1 if the @@ -77,7 +77,7 @@ signal number \fIsig\fP is invalid. .TP .B EINVAL The specified signal number is invalid. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. POSIX.1-2008 marks .BR siginterrupt () @@ -86,5 +86,5 @@ as obsolete, recommending the use of with the .B SA_RESTART flag instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR signal (2) diff --git a/man3/signbit.3 b/man3/signbit.3 index 5c3758099..2cdcf098e 100644 --- a/man3/signbit.3 +++ b/man3/signbit.3 @@ -53,9 +53,9 @@ macro returns nonzero if the sign of is negative; otherwise it returns zero. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. This function is defined in IEC 559 (and the appendix with recommended functions in IEEE 754/IEEE 854). -.SH "SEE ALSO" +.SH SEE ALSO .BR copysign (3) diff --git a/man3/significand.3 b/man3/significand.3 index 84f7360c2..445ec80fa 100644 --- a/man3/significand.3 +++ b/man3/significand.3 @@ -49,6 +49,6 @@ These functions are nonstandard; the version is available on a number of other systems. .\" .SH HISTORY .\" This function came from BSD. -.SH "SEE ALSO" +.SH SEE ALSO .BR ilogb (3), .BR scalb (3) diff --git a/man3/sigpause.3 b/man3/sigpause.3 index aa31d2a19..50f8f1350 100644 --- a/man3/sigpause.3 +++ b/man3/sigpause.3 @@ -43,7 +43,7 @@ is designed to wait for some signal. It changes the process's signal mask (set of blocked signals), and then waits for a signal to arrive. Upon arrival of a signal, the original signal mask is restored. -.SH "RETURN VALUE" +.SH RETURN VALUE If .BR sigpause () returns, it was interrupted by a signal and the return value is \-1 @@ -93,7 +93,7 @@ Otherwise, the System V version is used. .\" For the BSD version, one usually uses a zero .\" .I sigmask .\" to indicate that no signals are to be blocked. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR sigaction (2), .BR sigprocmask (2), diff --git a/man3/sigqueue.3 b/man3/sigqueue.3 index 0c9d93384..ae4e32128 100644 --- a/man3/sigqueue.3 +++ b/man3/sigqueue.3 @@ -78,7 +78,7 @@ Furthermore, the .I si_code field of that structure will be set to .BR SI_QUEUE . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR sigqueue () returns 0, indicating that the signal was successfully @@ -109,7 +109,7 @@ No process has a PID matching .IR pid . .SH VERSIONS This system call first appeared in Linux 2.2. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES If this function results in the sending of a signal to the process @@ -144,7 +144,7 @@ uinfo.si_uid = getuid(); /* Real UID of sender */ uinfo.si_value = val; /* argument supplied to sigqueue() */ .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR rt_sigqueueinfo (2), .BR sigaction (2), diff --git a/man3/sigset.3 b/man3/sigset.3 index 5de668a24..4177ff13b 100644 --- a/man3/sigset.3 +++ b/man3/sigset.3 @@ -168,7 +168,7 @@ For .BR sigignore (), see the errors under .BR sigaction (2). -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. These functions are obsolete: do not use them in new programs. POSIX.1-2008 marks @@ -261,7 +261,7 @@ should be Instead, the previous disposition of the signal is returned. These problems have been fixed since glibc 2.5. .\" See http://sourceware.org/bugzilla/show_bug.cgi?id=1951 -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR pause (2), .BR sigaction (2), diff --git a/man3/sigsetops.3 b/man3/sigsetops.3 index 1bfe217da..06525468b 100644 --- a/man3/sigsetops.3 +++ b/man3/sigsetops.3 @@ -102,7 +102,7 @@ or the additional glibc functions described below and .BR sigorset ()). The results are undefined if this is not done. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR sigemptyset (), .BR sigfillset (), .BR sigaddset (), @@ -123,7 +123,7 @@ is not a member, and \-1 on error. .B EINVAL .I sig is not a valid signal. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES .SS Glibc notes @@ -163,7 +163,7 @@ return 0 on success, and \-1 on failure. .PP These functions are nonstandard (a few other systems provide similar functions) and their use should be avoided in portable applications. -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction (2), .BR sigpending (2), .BR sigprocmask (2), diff --git a/man3/sigvec.3 b/man3/sigvec.3 index 95a3c635f..d4ea3b72d 100644 --- a/man3/sigvec.3 +++ b/man3/sigvec.3 @@ -216,7 +216,7 @@ See the ERRORS under .BR sigaction (2) and .BR sigprocmask (2). -.SH "CONFORMING TO" +.SH CONFORMING TO All of these functions were in 4.3BSD, except .BR siggetmask (), @@ -247,7 +247,7 @@ but this function has a different argument on the two systems. See .BR sigpause (3) for details. -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (2), .BR pause (2), .BR sigaction (2), diff --git a/man3/sin.3 b/man3/sin.3 index 366fac49f..84bdb56a1 100644 --- a/man3/sin.3 +++ b/man3/sin.3 @@ -99,7 +99,7 @@ is set to An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -112,7 +112,7 @@ Before version 2.10, the glibc implementation did not set to .B EDOM when a domain error occurred. -.SH "SEE ALSO" +.SH SEE ALSO .BR acos (3), .BR asin (3), .BR atan (3), diff --git a/man3/sincos.3 b/man3/sincos.3 index cafd196a1..ea09d5433 100644 --- a/man3/sincos.3 +++ b/man3/sincos.3 @@ -69,9 +69,9 @@ These functions do not set .\" those functions. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR cos (3), .BR sin (3), .BR tan (3) diff --git a/man3/sinh.3 b/man3/sinh.3 index 916860a44..5e84e9dd1 100644 --- a/man3/sinh.3 +++ b/man3/sinh.3 @@ -72,7 +72,7 @@ is defined mathematically as: sinh(x) = (exp(x) \- exp(\-x)) / 2 .fi -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the hyperbolic sine of .IR x . @@ -117,13 +117,13 @@ is set to An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh (3), .BR asinh (3), .BR atanh (3), diff --git a/man3/sleep.3 b/man3/sleep.3 index 2a0ae2f8d..6c7f4d03f 100644 --- a/man3/sleep.3 +++ b/man3/sleep.3 @@ -35,11 +35,11 @@ sleep \- sleep for the specified number of seconds makes the calling thread sleep until .I seconds seconds have elapsed or a signal arrives which is not ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE Zero if the requested time has elapsed, or the number of seconds left to sleep, if the call was interrupted by a signal handler. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH BUGS .BR sleep () @@ -56,7 +56,7 @@ Using from a signal handler or modifying the handling of .B SIGALRM while sleeping will cause undefined results. -.SH "SEE ALSO" +.SH SEE ALSO .BR alarm (2), .BR nanosleep (2), .BR signal (2), diff --git a/man3/sockatmark.3 b/man3/sockatmark.3 index f0b2efea7..f71a305d0 100644 --- a/man3/sockatmark.3 +++ b/man3/sockatmark.3 @@ -46,7 +46,7 @@ is at the out-of-band mark. If the socket is at the mark, then 1 is returned; if the socket is not at the mark, 0 is returned. This function does not remove the out-of-band mark. -.SH "RETURN VALUE" +.SH RETURN VALUE A successful call to .BR sockatmark () returns 1 if the socket is at the out-of-band mark, or 0 if it is not. @@ -66,7 +66,7 @@ can be applied. .SH VERSIONS .BR sockatmark () was added to glibc in version 2.2.4. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES If @@ -127,7 +127,7 @@ and then read the byte of data at the mark: } } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fcntl (2), .BR recv (2), .BR send (2), diff --git a/man3/sqrt.3 b/man3/sqrt.3 index e89433189..4c53a3ffd 100644 --- a/man3/sqrt.3 +++ b/man3/sqrt.3 @@ -65,7 +65,7 @@ or The .BR sqrt () function returns the nonnegative square root of \fIx\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the square root of .IR x . @@ -101,13 +101,13 @@ is set to An invalid floating-point exception .RB ( FE_INVALID ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbrt (3), .BR csqrt (3), .BR hypot (3) diff --git a/man3/statvfs.3 b/man3/statvfs.3 index 37a76a8b5..10bcf8d3a 100644 --- a/man3/statvfs.3 +++ b/man3/statvfs.3 @@ -91,7 +91,7 @@ have meaningful values on all file systems. .BR fstatvfs () returns the same information about an open file referenced by descriptor .IR fd . -.SH "RETURN VALUE" +.SH RETURN VALUE On success, zero is returned. On error, \-1 is returned, and .I errno @@ -152,7 +152,7 @@ is not a directory. .TP .B EOVERFLOW Some values were too large to be represented in the returned struct. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES The Linux kernel has system calls @@ -176,5 +176,5 @@ and .I f_bsize fields of the return value of .IR "statvfs(path,buf)" . -.SH "SEE ALSO" +.SH SEE ALSO .BR statfs (2) diff --git a/man3/stdarg.3 b/man3/stdarg.3 index cea9085c6..068510b23 100644 --- a/man3/stdarg.3 +++ b/man3/stdarg.3 @@ -207,7 +207,7 @@ Some systems that do not supply have .B __va_copy instead, since that was the name used in the draft proposal. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR va_start (), .BR va_arg (), diff --git a/man3/stdin.3 b/man3/stdin.3 index 9cb66a347..c0960c21f 100644 --- a/man3/stdin.3 +++ b/man3/stdin.3 @@ -106,7 +106,7 @@ and The standard streams are closed by a call to .BR exit (3) and by normal program termination. -.SH "CONFORMING TO" +.SH CONFORMING TO The .IR stdin , .IR stdout , diff --git a/man3/stdio.3 b/man3/stdio.3 index 2381a29c5..13085c93f 100644 --- a/man3/stdio.3 +++ b/man3/stdio.3 @@ -241,11 +241,11 @@ vscanf input format conversion vsprintf formatted output conversion vsscanf input format conversion .TE -.SH "CONFORMING TO" +.SH CONFORMING TO The .I stdio library conforms to C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR close (2), .BR open (2), .BR read (2), diff --git a/man3/stdio_ext.3 b/man3/stdio_ext.3 index 6e58cf856..d09a02b58 100644 --- a/man3/stdio_ext.3 +++ b/man3/stdio_ext.3 @@ -127,6 +127,6 @@ output to a terminal is forced out, say before reading keyboard input.) The .BR __fpurge () function discards the contents of the stream's buffer. -.SH "SEE ALSO" +.SH SEE ALSO .BR flockfile (3), .BR fpurge (3) diff --git a/man3/stpcpy.3 b/man3/stpcpy.3 index 2ef42365a..16db43d08 100644 --- a/man3/stpcpy.3 +++ b/man3/stpcpy.3 @@ -58,12 +58,12 @@ function copies the string pointed to by \fIsrc\fP \fIdest\fP. The strings may not overlap, and the destination string \fIdest\fP must be large enough to receive the copy. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR stpcpy () returns a pointer to the \fBend\fP of the string \fIdest\fP (that is, the address of the terminating null byte) rather than the beginning. -.SH "CONFORMING TO" +.SH CONFORMING TO This function was added to POSIX.1-2008. Before that, it was not part of the C or POSIX.1 standards, nor customary on UNIX systems, but was not a GNU invention either. @@ -96,7 +96,7 @@ main(void) } .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy (3), .BR memccpy (3), .BR memcpy (3), diff --git a/man3/stpncpy.3 b/man3/stpncpy.3 index e2b0ccb71..83412e741 100644 --- a/man3/stpncpy.3 +++ b/man3/stpncpy.3 @@ -56,13 +56,13 @@ The strings may not overlap. .PP The programmer must ensure that there is room for at least \fIn\fP characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR stpncpy () returns a pointer to the terminating null byte in \fIdest\fP, or, if \fIdest\fP is not null-terminated, \fIdest + n\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO This function was added to POSIX.1-2008. Before that, it was a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR strncpy (3), .BR wcpncpy (3) diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3 index 465d2a451..d253959be 100644 --- a/man3/strcasecmp.3 +++ b/man3/strcasecmp.3 @@ -49,7 +49,7 @@ The .BR strncasecmp () function is similar, except it only compares the first \fIn\fP bytes of \fIs1\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strcasecmp () and @@ -58,9 +58,9 @@ functions return an integer less than, equal to, or greater than zero if \fIs1\fP (or the first \fIn\fP bytes thereof) is found, respectively, to be less than, to match, or be greater than \fIs2\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp (3), .BR memcmp (3), .BR strcmp (3), diff --git a/man3/strcat.3 b/man3/strcat.3 index a24528357..be761e1d5 100644 --- a/man3/strcat.3 +++ b/man3/strcat.3 @@ -92,13 +92,13 @@ strncat(char *dest, const char *src, size_t n) } .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strcat () and .BR strncat () functions return a pointer to the resulting string \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. .SH NOTES Some systems (the BSDs, Solaris, and others) provide the following function: @@ -137,7 +137,7 @@ is not present in glibc and is not standardized by POSIX, but is available on Linux via the .IR libbsd library. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy (3), .BR memccpy (3), .BR memcpy (3), diff --git a/man3/strchr.3 b/man3/strchr.3 index 97fd42dbe..9dc5e8f8a 100644 --- a/man3/strchr.3 +++ b/man3/strchr.3 @@ -76,7 +76,7 @@ rather than NULL. .PP Here "character" means "byte"; these functions do not work with wide or multibyte characters. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strchr () and @@ -99,14 +99,14 @@ if the character is not found. .SH VERSIONS .BR strchrnul () first appeared in glibc in version 2.1.1. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR strchr () and .BR strrchr () are in SVr4, 4.3BSD, C89, C99. .BR strchrnul () is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR index (3), .BR memchr (3), .BR rindex (3), diff --git a/man3/strcmp.3 b/man3/strcmp.3 index 7d3ab1b16..9adcecf5c 100644 --- a/man3/strcmp.3 +++ b/man3/strcmp.3 @@ -51,7 +51,7 @@ The .BR strncmp () function is similar, except it only compares the first (at most) \fIn\fP bytes of \fIs1\fP and \fIs2\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strcmp () and @@ -60,9 +60,9 @@ functions return an integer less than, equal to, or greater than zero if \fIs1\fP (or the first \fIn\fP bytes thereof) is found, respectively, to be less than, to match, or be greater than \fIs2\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp (3), .BR memcmp (3), .BR strcasecmp (3), diff --git a/man3/strcoll.3 b/man3/strcoll.3 index cbdd2b37b..5f0fd0b23 100644 --- a/man3/strcoll.3 +++ b/man3/strcoll.3 @@ -46,21 +46,21 @@ The comparison is based on strings interpreted as appropriate for the program's current locale for category \fBLC_COLLATE\fP. (See .BR setlocale (3).) -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strcoll () function returns an integer less than, equal to, or greater than zero if \fIs1\fP is found, respectively, to be less than, to match, or be greater than \fIs2\fP, when both are interpreted as appropriate for the current locale. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. .SH NOTES In the \fI"POSIX"\fP or \fI"C"\fP locales .BR strcoll () is equivalent to .BR strcmp (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp (3), .BR memcmp (3), .BR setlocale (3), diff --git a/man3/strcpy.3 b/man3/strcpy.3 index 54023e54e..f7b0682b9 100644 --- a/man3/strcpy.3 +++ b/man3/strcpy.3 @@ -92,14 +92,14 @@ strncpy(char *dest, const char *src, size_t n) } .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strcpy () and .BR strncpy () functions return a pointer to the destination string \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. .SH NOTES Some programmers consider @@ -189,7 +189,7 @@ the program first needs to check that there's enough space. This may be unnecessary if you can show that overflow is impossible, but be careful: programs can get changed over time, in ways that may make the impossible possible. -.SH "SEE ALSO" +.SH SEE ALSO .BR bcopy (3), .BR memccpy (3), .BR memcpy (3), diff --git a/man3/strdup.3 b/man3/strdup.3 index 3b5c543da..9c4dd28b5 100644 --- a/man3/strdup.3 +++ b/man3/strdup.3 @@ -99,7 +99,7 @@ to allocate the buffer. They are only available when using the GNU GCC suite, and suffer from the same limitations described in .BR alloca (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strdup () function returns a pointer to the duplicated @@ -108,7 +108,7 @@ string, or NULL if insufficient memory was available. .TP .B ENOMEM Insufficient memory available to allocate duplicate string. -.SH "CONFORMING TO" +.SH CONFORMING TO .\" 4.3BSD-Reno, not (first) 4.3BSD. .BR strdup () conforms to SVr4, 4.3BSD, POSIX.1-2001. @@ -118,7 +118,7 @@ conforms to POSIX.1-2008. and .BR strndupa () are GNU extensions. -.SH "SEE ALSO" +.SH SEE ALSO .BR alloca (3), .BR calloc (3), .BR free (3), diff --git a/man3/strerror.3 b/man3/strerror.3 index 0ea3ffee4..33f5bc39e 100644 --- a/man3/strerror.3 +++ b/man3/strerror.3 @@ -131,7 +131,7 @@ is too small and .I errnum is unknown). The string always includes a terminating null byte. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strerror () and the GNU-specific @@ -170,7 +170,7 @@ is not a valid error number. .TP .B ERANGE Insufficient storage was supplied to contain the error description string. -.SH "CONFORMING TO" +.SH CONFORMING TO .BR strerror () is specified by POSIX.1-2001, C89, C99. .BR strerror_r () @@ -199,7 +199,7 @@ to .B EINVAL if the error number is unknown. C99 and POSIX.1-2008 require the return value to be non-NULL. -.SH "SEE ALSO" +.SH SEE ALSO .BR err (3), .BR errno (3), .BR error (3), diff --git a/man3/strfmon.3 b/man3/strfmon.3 index 021349934..f9100186e 100644 --- a/man3/strfmon.3 +++ b/man3/strfmon.3 @@ -113,7 +113,7 @@ is converted using the locale's international currency format. One argument of type .I double is converted using the locale's national currency format. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strfmon () function returns the number of characters placed @@ -124,7 +124,7 @@ Otherwise, it sets to .BR E2BIG , returns \-1, and the contents of the array is undefined. -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on several other systems. .SH EXAMPLE @@ -162,7 +162,7 @@ and Portuguese locales yield .br [ **1234$57Esc] [ **1.234$57PTE ] .in -.SH "SEE ALSO" +.SH SEE ALSO .BR setlocale (3), .BR sprintf (3), .BR locale (7) diff --git a/man3/strfry.3 b/man3/strfry.3 index 0b8db7e75..abbd716a2 100644 --- a/man3/strfry.3 +++ b/man3/strfry.3 @@ -44,16 +44,16 @@ using .BR rand (3) to randomly swap characters in the string. The result is an anagram of \fIstring\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strfry () functions returns a pointer to the randomized string. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR strfry () function is unique to the GNU C Library. -.SH "SEE ALSO" +.SH SEE ALSO .BR memfrob (3), .BR string (3) diff --git a/man3/strftime.3 b/man3/strftime.3 index 69c887a9a..36f6f048b 100644 --- a/man3/strftime.3 +++ b/man3/strftime.3 @@ -306,7 +306,7 @@ E modifier is to use a locale-dependent alternative representation. The broken-down time structure \fItm\fP is defined in \fI\fP. See also .BR ctime (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strftime () function returns the number of bytes placed @@ -327,7 +327,7 @@ The environment variables and .B LC_TIME are used. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, C89, C99. There are strict inclusions between the set of conversions given in ANSI C (unmarked), those given in the Single UNIX Specification @@ -509,7 +509,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR time (2), .BR ctime (3), diff --git a/man3/string.3 b/man3/string.3 index b7a274645..49b3a2492 100644 --- a/man3/string.3 +++ b/man3/string.3 @@ -89,7 +89,7 @@ strrchr, strsep, strspn, strstr, strtok, strxfrm, index, rindex The string functions perform string operations on null-terminated strings. See the individual man pages for descriptions of each function. -.SH "SEE ALSO" +.SH SEE ALSO .BR index (3), .BR rindex (3), .BR stpcpy (3), diff --git a/man3/strlen.3 b/man3/strlen.3 index ec57e8429..e1311281a 100644 --- a/man3/strlen.3 +++ b/man3/strlen.3 @@ -39,13 +39,13 @@ The .BR strlen () function calculates the length of the string \fIs\fP, excluding the terminating null byte (\(aq\\0\(aq). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strlen () function returns the number of bytes in the string \fIs\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR string (3), .BR strnlen (3), .BR wcslen (3), diff --git a/man3/strnlen.3 b/man3/strnlen.3 index c10f57f4e..f5a415740 100644 --- a/man3/strnlen.3 +++ b/man3/strnlen.3 @@ -46,14 +46,14 @@ In doing this, .BR strnlen () looks only at the first \fImaxlen\fP bytes at \fIs\fP and never beyond \fIs+maxlen\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strnlen () function returns \fIstrlen(s)\fP, if that is less than \fImaxlen\fP, or \fImaxlen\fP if there is no null byte (\(aq\\0\(aq) among the first \fImaxlen\fP bytes pointed to by \fIs\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. -.SH "SEE ALSO" +.SH SEE ALSO .BR strlen (3) diff --git a/man3/strpbrk.3 b/man3/strpbrk.3 index 4ebf9deb0..70b736c4f 100644 --- a/man3/strpbrk.3 +++ b/man3/strpbrk.3 @@ -39,15 +39,15 @@ The .BR strpbrk () function locates the first occurrence in the string \fIs\fP of any of the bytes in the string \fIaccept\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strpbrk () function returns a pointer to the byte in \fIs\fP that matches one of the bytes in \fIaccept\fP, or NULL if no such byte is found. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR index (3), .BR memchr (3), .BR rindex (3), diff --git a/man3/strptime.3 b/man3/strptime.3 index 3c92a28a6..8f4c77ef2 100644 --- a/man3/strptime.3 +++ b/man3/strptime.3 @@ -271,7 +271,7 @@ struct tm { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE The return value of the function is a pointer to the first character not processed in this function call. In case the input string @@ -285,7 +285,7 @@ If fails to match all of the format string and therefore an error occurred the function returns NULL. -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv2, POSIX.1-2001. .SH NOTES .LP @@ -405,7 +405,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR time (2), .BR getdate (3), .BR scanf (3), diff --git a/man3/strsep.3 b/man3/strsep.3 index d80b4b259..e03c4ae0a 100644 --- a/man3/strsep.3 +++ b/man3/strsep.3 @@ -58,12 +58,12 @@ with a null byte (\(aq\\0\(aq) and \fI*stringp\fP is updated to point past the token. In case no delimiter was found, the token is taken to be the entire string \fI*stringp\fP, and \fI*stringp\fP is made NULL. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strsep () function returns a pointer to the token, that is, it returns the original value of \fI*stringp\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.4BSD. .SH NOTES The @@ -83,7 +83,7 @@ This function modifies its first argument. This function cannot be used on constant strings. .IP * The identity of the delimiting character is lost. -.SH "SEE ALSO" +.SH SEE ALSO .BR index (3), .BR memchr (3), .BR rindex (3), diff --git a/man3/strsignal.3 b/man3/strsignal.3 index 037d41333..6ae70f750 100644 --- a/man3/strsignal.3 +++ b/man3/strsignal.3 @@ -70,16 +70,16 @@ The .BR strsignal () function should be used if possible instead of this array. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strsignal () function returns the appropriate description string, or an unknown signal message if the signal number is invalid. On some systems (but not on Linux), a NULL pointer may be returned instead for an invalid signal number. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. Present on Solaris and the BSDs. -.SH "SEE ALSO" +.SH SEE ALSO .BR psignal (3), .BR strerror (3) diff --git a/man3/strspn.3 b/man3/strspn.3 index 840fd4a21..d00619f35 100644 --- a/man3/strspn.3 +++ b/man3/strspn.3 @@ -48,7 +48,7 @@ The function calculates the length of the initial segment of \fIs\fP which consists entirely of bytes not in \fIreject\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strspn () function returns the number of bytes in @@ -60,9 +60,9 @@ The function returns the number of bytes in the initial segment of \fIs\fP which are not in the string \fIreject\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR index (3), .BR memchr (3), .BR rindex (3), diff --git a/man3/strstr.3 b/man3/strstr.3 index 3aa9053b8..cc9923af8 100644 --- a/man3/strstr.3 +++ b/man3/strstr.3 @@ -55,10 +55,10 @@ The function is like .BR strstr (), but ignores the case of both arguments. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return a pointer to the beginning of the substring, or NULL if the substring is not found. -.SH "CONFORMING TO" +.SH CONFORMING TO The .BR strstr () function conforms to C89 and C99. @@ -71,7 +71,7 @@ an empty \fIneedle\fP argument for .BR strstr (). Later versions (like 4.6.27) work correctly, and return \fIhaystack\fP when \fIneedle\fP is empty. -.SH "SEE ALSO" +.SH SEE ALSO .BR index (3), .BR memchr (3), .BR rindex (3), diff --git a/man3/strtod.3 b/man3/strtod.3 index 558edad82..18c00b2c9 100644 --- a/man3/strtod.3 +++ b/man3/strtod.3 @@ -123,7 +123,7 @@ way the type of NAN. .\" From glibc 2.8's stdlib/strtod_l.c: .\" We expect it to be a number which is put in the .\" mantissa of the number. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the converted value, if any. If @@ -155,7 +155,7 @@ is stored in .TP .B ERANGE Overflow or underflow occurred. -.SH "CONFORMING TO" +.SH CONFORMING TO C89 describes .BR strtod (), C99 @@ -174,7 +174,7 @@ See the example on the .BR strtol (3) manual page; the use of the functions described in this manual page is similar. -.SH "SEE ALSO" +.SH SEE ALSO .BR atof (3), .BR atoi (3), .BR atol (3), diff --git a/man3/strtoimax.3 b/man3/strtoimax.3 index f83a28a14..35da26cf0 100644 --- a/man3/strtoimax.3 +++ b/man3/strtoimax.3 @@ -41,7 +41,7 @@ except that they return a value of type and .IR uintmax_t , respectively. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the converted value is returned. If nothing was found to convert, zero is returned. On overflow or underflow @@ -54,9 +54,9 @@ is returned, and .I errno is set to .BR ERANGE . -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR imaxabs (3), .BR imaxdiv (3), .BR strtol (3), diff --git a/man3/strtok.3 b/man3/strtok.3 index 39ca06088..13c45ce6f 100644 --- a/man3/strtok.3 +++ b/man3/strtok.3 @@ -101,14 +101,14 @@ In subsequent calls, \fIstr\fP should be NULL, and Different strings may be parsed concurrently using sequences of calls to .BR strtok_r () that specify different \fIsaveptr\fP arguments. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strtok () and .BR strtok_r () functions return a pointer to the next token, or NULL if there are no more tokens. -.SH "CONFORMING TO" +.SH CONFORMING TO .TP .BR strtok () SVr4, POSIX.1-2001, 4.3BSD, C89, C99. @@ -198,7 +198,7 @@ Another example program using .BR strtok () can be found in .BR getaddrinfo_a (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR index (3), .BR memchr (3), .BR rindex (3), diff --git a/man3/strtol.3 b/man3/strtol.3 index c93828a9b..038692f8b 100644 --- a/man3/strtol.3 +++ b/man3/strtol.3 @@ -96,7 +96,7 @@ The function works just like the .BR strtol () function but returns a long long integer value. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strtol () function returns the result of the conversion, @@ -134,7 +134,7 @@ The resulting value was out of range. .LP The implementation may also set \fIerrno\fP to \fBEINVAL\fP in case no conversion was performed (no digits seen, and 0 returned). -.SH "CONFORMING TO" +.SH CONFORMING TO .BR strtol () conforms to SVr4, 4.3BSD, C89, C99 and POSIX.1-2001, and .BR strtoll () @@ -258,7 +258,7 @@ main(int argc, char *argv[]) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR atof (3), .BR atoi (3), .BR atol (3), diff --git a/man3/strtoul.3 b/man3/strtoul.3 index b62e6a82d..e41f3f2d9 100644 --- a/man3/strtoul.3 +++ b/man3/strtoul.3 @@ -105,7 +105,7 @@ function works just like the function but returns an .I "unsigned long long int" value. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strtoul () function returns either the result of the conversion @@ -137,7 +137,7 @@ The resulting value was out of range. .LP The implementation may also set \fIerrno\fP to \fBEINVAL\fP in case no conversion was performed (no digits seen, and 0 returned). -.SH "CONFORMING TO" +.SH CONFORMING TO .BR strtoul () conforms to SVr4, C89, C99 and POSIX-2001, and .BR strtoull () @@ -185,7 +185,7 @@ See the example on the .BR strtol (3) manual page; the use of the functions described in this manual page is similar. -.SH "SEE ALSO" +.SH SEE ALSO .BR atof (3), .BR atoi (3), .BR atol (3), diff --git a/man3/strverscmp.3 b/man3/strverscmp.3 index f41add1fd..a9cbec268 100644 --- a/man3/strverscmp.3 +++ b/man3/strverscmp.3 @@ -76,16 +76,16 @@ in front (so that in particular digit strings with more leading zeros come before digit strings with fewer leading zeros). Thus, the ordering is .IR 000 ", " 00 ", " 01 ", " 010 ", " 09 ", " 0 ", " 1 ", " 9 ", " 10 . -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strverscmp () function returns an integer less than, equal to, or greater than zero if \fIs1\fP is found, respectively, to be earlier than, equal to, or later than \fIs2\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO This function is a GNU extension. -.SH "SEE ALSO" +.SH SEE ALSO .BR rename (1), .BR strcasecmp (3), .BR strcmp (3), diff --git a/man3/strxfrm.3 b/man3/strxfrm.3 index ce6083744..8ad256e01 100644 --- a/man3/strxfrm.3 +++ b/man3/strxfrm.3 @@ -51,7 +51,7 @@ The first \fIn\fP bytes of the transformed string are placed in The transformation is based on the program's current locale for category \fBLC_COLLATE\fP. (See .BR setlocale (3)). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR strxfrm () function returns the number of bytes required to @@ -59,7 +59,7 @@ store the transformed string in \fIdest\fP excluding the terminating null byte (\(aq\\0\(aq). If the value returned is \fIn\fP or more, the contents of \fIdest\fP are indeterminate. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99. .SH NOTES In the \fI"POSIX"\fP or \fI"C"\fP locales @@ -67,7 +67,7 @@ In the \fI"POSIX"\fP or \fI"C"\fP locales is equivalent to copying the string with .BR strncpy (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR bcmp (3), .BR memcmp (3), .BR setlocale (3), diff --git a/man3/swab.3 b/man3/swab.3 index ec8e50a91..c16253bac 100644 --- a/man3/swab.3 +++ b/man3/swab.3 @@ -49,11 +49,11 @@ This function does nothing when \fIn\fP is negative. When \fIn\fP is positive and odd, it handles \fIn\-1\fP bytes as above, and does something unspecified with the last byte. (In other words, \fIn\fP should be even.) -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR swab () function returns no value. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR bstring (3) diff --git a/man3/sysconf.3 b/man3/sysconf.3 index 302793ea5..a7fbf0ef3 100644 --- a/man3/sysconf.3 +++ b/man3/sysconf.3 @@ -306,7 +306,7 @@ The number of processors configured. .TP .BR "" " - " _SC_NPROCESSORS_ONLN The number of processors currently online (available). -.SH "RETURN VALUE" +.SH RETURN VALUE If .I name is invalid, \-1 is returned, and @@ -319,7 +319,7 @@ is not changed. In the case of options, a positive value is returned if a queried option is available, and \-1 if it is not. In the case of limits, \-1 means that there is no definite limit. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH BUGS It is difficult to use @@ -330,7 +330,7 @@ is consumed by the user's environment variables. .PP Some returned values may be huge; they are not suitable for allocating memory. -.SH "SEE ALSO" +.SH SEE ALSO .BR bc (1), .BR expr (1), .BR getconf (1), diff --git a/man3/syslog.3 b/man3/syslog.3 index 546b87be1..f1d046112 100644 --- a/man3/syslog.3 +++ b/man3/syslog.3 @@ -247,7 +247,7 @@ debug-level message The function .BR setlogmask (3) can be used to restrict logging to specified levels only. -.SH "CONFORMING TO" +.SH CONFORMING TO The functions .BR openlog (), .BR closelog (), @@ -310,7 +310,7 @@ use the following instead: syslog(priority, "%s", string); .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR logger (1), .BR setlogmask (3), .BR syslog.conf (5), diff --git a/man3/system.3 b/man3/system.3 index af70a456b..01c9965a5 100644 --- a/man3/system.3 +++ b/man3/system.3 @@ -49,7 +49,7 @@ will be blocked, and and .B SIGQUIT will be ignored. -.SH "RETURN VALUE" +.SH RETURN VALUE The value returned is \-1 on error (e.g., .BR fork (2) failed), @@ -73,7 +73,7 @@ returns nonzero if the shell is available, and zero if not. .PP .BR system () does not affect the wait status of any other children. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, POSIX.1-2001. .SH NOTES .PP @@ -148,7 +148,7 @@ It is possible for the shell command to return 127, so that code is not a sure indication that the .BR execve (2) call failed. -.SH "SEE ALSO" +.SH SEE ALSO .BR sh (1), .BR signal (2), .BR wait (2), diff --git a/man3/sysv_signal.3 b/man3/sysv_signal.3 index 528a8ea61..8dc8011b9 100644 --- a/man3/sysv_signal.3 +++ b/man3/sysv_signal.3 @@ -46,7 +46,7 @@ b) delivery of further instances of the signal is not blocked while the signal handler is executing; and c) if the handler interrupts (certain) blocking system calls, then the system call is not automatically restarted. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR sysv_signal () function returns the previous value of the signal handler, or @@ -55,7 +55,7 @@ on error. .SH ERRORS As for .BR signal (2). -.SH "CONFORMING TO" +.SH CONFORMING TO This function is nonstandard. .SH NOTES Use of @@ -82,7 +82,7 @@ this type is only defined if the .B _GNU_SOURCE feature test macro is defined. -.SH "SEE ALSO" +.SH SEE ALSO .BR sigaction (2), .BR signal (2), .BR bsd_signal (3), diff --git a/man3/tan.3 b/man3/tan.3 index a7d0f454e..69573c3e9 100644 --- a/man3/tan.3 +++ b/man3/tan.3 @@ -124,7 +124,7 @@ Range error: result overflow An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double @@ -137,7 +137,7 @@ Before version 2.10, the glibc implementation did not set to .B EDOM when a domain error occurred. -.SH "SEE ALSO" +.SH SEE ALSO .BR acos (3), .BR asin (3), .BR atan (3), diff --git a/man3/tanh.3 b/man3/tanh.3 index 40dbc5768..e79e042c3 100644 --- a/man3/tanh.3 +++ b/man3/tanh.3 @@ -71,7 +71,7 @@ is defined mathematically as: tanh(x) = sinh(x) / cosh(x) .fi -.SH "RETURN VALUE" +.SH RETURN VALUE On success, these functions return the hyperbolic tangent of .IR x . @@ -93,13 +93,13 @@ is positive infinity (negative infinity), .\" glibc 2.8 does not do this. .SH ERRORS No errors occur. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. The variant returning .I double also conforms to SVr4, 4.3BSD, C89. -.SH "SEE ALSO" +.SH SEE ALSO .BR acosh (3), .BR asinh (3), .BR atanh (3), diff --git a/man3/tcgetpgrp.3 b/man3/tcgetpgrp.3 index d883cfa18..68cad10c2 100644 --- a/man3/tcgetpgrp.3 +++ b/man3/tcgetpgrp.3 @@ -56,7 +56,7 @@ and the calling process is not blocking or ignoring a .B SIGTTOU signal is sent to all members of this background process group. -.SH "RETURN VALUE" +.SH RETURN VALUE When .I fd refers to the controlling terminal of the calling process, @@ -101,7 +101,7 @@ of the calling process. .I pgrp has a supported value, but is not the process group ID of a process in the same session as the calling process. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES These functions are implemented via the @@ -112,7 +112,7 @@ ioctls. .SS History The ioctls appeared in 4.2BSD. The functions are POSIX inventions. -.SH "SEE ALSO" +.SH SEE ALSO .BR setpgid (2), .BR setsid (2), .BR credentials (7) diff --git a/man3/tcgetsid.3 b/man3/tcgetsid.3 index 780020836..8069c2520 100644 --- a/man3/tcgetsid.3 +++ b/man3/tcgetsid.3 @@ -37,7 +37,7 @@ terminal associated to .I fd as controlling terminal. This terminal must be the controlling terminal of the calling process. -.SH "RETURN VALUE" +.SH RETURN VALUE When .I fd refers to the controlling terminal of our session, @@ -60,7 +60,7 @@ it has one but it is not described by .SH VERSIONS .BR tcgetsid () is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES This function is implemented via the @@ -68,5 +68,5 @@ This function is implemented via the .BR ioctl (2), present since Linux 2.1.71. -.SH "SEE ALSO" +.SH SEE ALSO .BR getsid (2) diff --git a/man3/telldir.3 b/man3/telldir.3 index d54779c5d..de30a34ec 100644 --- a/man3/telldir.3 +++ b/man3/telldir.3 @@ -47,7 +47,7 @@ The .BR telldir () function returns the current location associated with the directory stream \fIdirp\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, the .BR telldir () function returns the current location @@ -59,7 +59,7 @@ is set appropriately. .TP .B EBADF Invalid directory stream descriptor \fIdirp\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. .SH NOTES In glibc up to version 2.1.1, the return type of @@ -69,7 +69,7 @@ was POSIX.1-2001 specifies .IR long , and this is the type used since glibc 2.1.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR closedir (3), .BR opendir (3), .BR readdir (3), diff --git a/man3/tempnam.3 b/man3/tempnam.3 index 6275e4d7c..23a8a9abe 100644 --- a/man3/tempnam.3 +++ b/man3/tempnam.3 @@ -82,7 +82,7 @@ is allocated using .BR malloc (3) and hence should be freed by .BR free (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR tempnam () function returns a pointer to a unique temporary @@ -91,7 +91,7 @@ filename, or NULL if a unique name cannot be generated. .TP .B ENOMEM Allocation of storage failed. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, POSIX.1-2001. POSIX.1-2008 marks .BR tempnam () @@ -161,7 +161,7 @@ Use or .BR tmpfile (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR mkstemp (3), .BR mktemp (3), .BR tmpfile (3), diff --git a/man3/termios.3 b/man3/termios.3 index f768d1e85..d03b53cf6 100644 --- a/man3/termios.3 +++ b/man3/termios.3 @@ -903,7 +903,7 @@ is a 4.4BSD extension. It takes the same arguments as .BR cfsetispeed (), and sets both input and output speed. -.SH "RETURN VALUE" +.SH RETURN VALUE .LP .BR cfgetispeed () returns the input baud rate stored in the @@ -974,7 +974,7 @@ behaves like .\" libc4.7.6, libc5, glibc for unix: duration in ms. .\" glibc for bsd: duration in us .\" glibc for sunos4: ignore duration -.SH "SEE ALSO" +.SH SEE ALSO .BR stty (1), .BR console_ioctl (4), .BR tty_ioctl (4), diff --git a/man3/tgamma.3 b/man3/tgamma.3 index 077ddba75..2b4ee15b4 100644 --- a/man3/tgamma.3 +++ b/man3/tgamma.3 @@ -150,7 +150,7 @@ is not set for this case. .\" exception for various cases. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES This function had to be called "true gamma function" @@ -176,6 +176,6 @@ set to and an .B FE_INVALID exception raised), rather than a pole error. -.SH "SEE ALSO" +.SH SEE ALSO .BR gamma (3), .BR lgamma (3) diff --git a/man3/timegm.3 b/man3/timegm.3 index 98a40047b..07dc458a7 100644 --- a/man3/timegm.3 +++ b/man3/timegm.3 @@ -49,7 +49,7 @@ are the inverses of .BR localtime (3) and .BR gmtime (3). -.SH "CONFORMING TO" +.SH CONFORMING TO These functions are nonstandard GNU extensions that are also present on the BSDs. Avoid their use; see NOTES. @@ -94,7 +94,7 @@ my_timegm(struct tm *tm) } .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR gmtime (3), .BR localtime (3), .BR mktime (3), diff --git a/man3/timeradd.3 b/man3/timeradd.3 index 5b288c473..f4454abb8 100644 --- a/man3/timeradd.3 +++ b/man3/timeradd.3 @@ -145,6 +145,6 @@ No errors are defined. .SH CONFORMING TO Not in POSIX.1-2001. Present on most BSD derivatives. -.SH "SEE ALSO" +.SH SEE ALSO .BR gettimeofday (2), .BR time (7) diff --git a/man3/tmpfile.3 b/man3/tmpfile.3 index 88a691bd9..b5821b917 100644 --- a/man3/tmpfile.3 +++ b/man3/tmpfile.3 @@ -42,7 +42,7 @@ function opens a unique temporary file in binary read/write (w+b) mode. The file will be automatically deleted when it is closed or the program terminates. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR tmpfile () function returns a stream descriptor, or NULL if @@ -71,7 +71,7 @@ There was no room in the directory to add the new filename. .TP .B EROFS Read-only file system. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, SUSv2, POSIX.1-2001. .SH NOTES POSIX.1-2001 specifies: @@ -83,7 +83,7 @@ The standard does not specify the directory that will use. Glibc will try the path prefix \fIP_tmpdir\fP defined in \fI\fP, and if that fails the directory \fI/tmp\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR exit (3), .BR mkstemp (3), .BR mktemp (3), diff --git a/man3/tmpnam.3 b/man3/tmpnam.3 index 82234aae8..e38d3d4a1 100644 --- a/man3/tmpnam.3 +++ b/man3/tmpnam.3 @@ -65,14 +65,14 @@ are defined in just like the .B TMP_MAX mentioned below.) -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR tmpnam () function returns a pointer to a unique temporary filename, or NULL if a unique name cannot be generated. .SH ERRORS No errors are defined. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, 4.3BSD, C89, C99, POSIX.1-2001. POSIX.1-2008 marks .BR tmpnam () @@ -148,7 +148,7 @@ Use or .BR tmpfile (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR mkstemp (3), .BR mktemp (3), .BR tempnam (3), diff --git a/man3/toascii.3 b/man3/toascii.3 index f117e3cf9..ed06ffd91 100644 --- a/man3/toascii.3 +++ b/man3/toascii.3 @@ -46,9 +46,9 @@ _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE converts \fIc\fP to a 7-bit \fIunsigned char\fP value that fits into the ASCII character set, by clearing the high-order bits. -.SH "RETURN VALUE" +.SH RETURN VALUE The value returned is that of the converted character. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, BSD, POSIX.1-2001. POSIX.1-2008 marks .BR toascii () @@ -57,7 +57,7 @@ noting that it cannot be use portably in a localized application. .SH BUGS Many people will be unhappy if you use this function. This function will convert accented letters into random characters. -.SH "SEE ALSO" +.SH SEE ALSO .BR isascii (3), .BR tolower (3), .BR toupper (3) diff --git a/man3/toupper.3 b/man3/toupper.3 index 12677b460..bfddcce21 100644 --- a/man3/toupper.3 +++ b/man3/toupper.3 @@ -52,11 +52,11 @@ value, or .BR EOF , the behavior of these functions is undefined. -.SH "RETURN VALUE" +.SH RETURN VALUE The value returned is that of the converted letter, or .I c if the conversion was not possible. -.SH "CONFORMING TO" +.SH CONFORMING TO C89, C99, 4.3BSD. .SH BUGS The details of what constitutes an uppercase or lowercase letter depend @@ -68,7 +68,7 @@ locale does not know about umlauts, so no conversion is done for them. In some non-English locales, there are lowercase letters with no corresponding uppercase equivalent; the German sharp s is one example. -.SH "SEE ALSO" +.SH SEE ALSO .BR isalpha (3), .BR setlocale (3), .BR towlower (3), diff --git a/man3/towctrans.3 b/man3/towctrans.3 index 5892c8b5d..ec59fc008 100644 --- a/man3/towctrans.3 +++ b/man3/towctrans.3 @@ -31,12 +31,12 @@ If \fIwc\fP is \fBWEOF\fP, \fBWEOF\fP is returned. the .BR wctrans (3) function. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR towctrans () function returns the translated wide character, or \fBWEOF\fP if \fIwc\fP is \fBWEOF\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -45,7 +45,7 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR towlower (3), .BR towupper (3), .BR wctrans (3) diff --git a/man3/towlower.3 b/man3/towlower.3 index 51a9d38ec..ec698aa3b 100644 --- a/man3/towlower.3 +++ b/man3/towlower.3 @@ -30,12 +30,12 @@ If \fIwc\fP is a wide character, it is converted to lowercase. Characters which do not have case are returned unchanged. If \fIwc\fP is \fBWEOF\fP, \fBWEOF\fP is returned. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR towlower () function returns the lowercase equivalent of \fIwc\fP, or \fBWEOF\fP if \fIwc\fP is \fBWEOF\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -47,7 +47,7 @@ current locale. .PP This function is not very appropriate for dealing with Unicode characters, because Unicode knows about three cases: upper, lower and title case. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswlower (3), .BR towctrans (3), .BR towupper (3) diff --git a/man3/towupper.3 b/man3/towupper.3 index 0c84230f2..5d6f5ec00 100644 --- a/man3/towupper.3 +++ b/man3/towupper.3 @@ -30,12 +30,12 @@ If \fIwc\fP is a wide character, it is converted to uppercase. Characters which do not have case are returned unchanged. If \fIwc\fP is \fBWEOF\fP, \fBWEOF\fP is returned. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR towupper () function returns the uppercase equivalent of \fIwc\fP, or \fBWEOF\fP if \fIwc\fP is \fBWEOF\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -47,7 +47,7 @@ current locale. .PP This function is not very appropriate for dealing with Unicode characters, because Unicode knows about three cases: upper, lower and title case. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswupper (3), .BR towctrans (3), .BR towlower (3) diff --git a/man3/trunc.3 b/man3/trunc.3 index 454cc6c2f..131a64093 100644 --- a/man3/trunc.3 +++ b/man3/trunc.3 @@ -56,7 +56,7 @@ or .SH DESCRIPTION These functions round \fIx\fP to the nearest integer not larger in absolute value. -.SH "RETURN VALUE" +.SH RETURN VALUE These functions return the rounded integer value. If \fIx\fP is integral, infinite, or NaN, \fIx\fP itself is returned. @@ -64,7 +64,7 @@ If \fIx\fP is integral, infinite, or NaN, \fIx\fP itself is returned. No errors occur. .SH VERSIONS These functions first appeared in glibc in version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO C99, POSIX.1-2001. .SH NOTES The integral value returned by these functions may be too large @@ -75,7 +75,7 @@ etc.). To avoid an overflow, which will produce undefined results, an application should perform a range check on the returned value before assigning it to an integer type. -.SH "SEE ALSO" +.SH SEE ALSO .BR ceil (3), .BR floor (3), .BR lrint (3), diff --git a/man3/tsearch.3 b/man3/tsearch.3 index 0969bdd02..ae69b9f02 100644 --- a/man3/tsearch.3 +++ b/man3/tsearch.3 @@ -163,7 +163,7 @@ If no such work is necessary, .IR free_node must point to a function doing nothing. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR tsearch () returns a pointer to a matching item in the tree, or to the newly added item, or NULL if there was insufficient memory @@ -186,7 +186,7 @@ also return NULL if .IR rootp was NULL on entry. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. The function .BR tdestroy () @@ -285,7 +285,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR bsearch (3), .BR hsearch (3), .BR lsearch (3), diff --git a/man3/ttyname.3 b/man3/ttyname.3 index be3486e72..00a4a763c 100644 --- a/man3/ttyname.3 +++ b/man3/ttyname.3 @@ -48,7 +48,7 @@ stores this pathname in the buffer .I buf of length .IR buflen . -.SH "RETURN VALUE" +.SH RETURN VALUE The function .BR ttyname () returns a pointer to a pathname on success. @@ -70,9 +70,9 @@ File descriptor does not refer to a terminal device. .RB ( ttyname_r ()) .I buflen was too small to allow storing the pathname. -.SH "CONFORMING TO" +.SH CONFORMING TO 4.2BSD, POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR fstat (2), .BR ctermid (3), .BR isatty (3) diff --git a/man3/ttyslot.3 b/man3/ttyslot.3 index 834f49cc6..bcb11a65d 100644 --- a/man3/ttyslot.3 +++ b/man3/ttyslot.3 @@ -112,13 +112,13 @@ file, but System V-like systems do not, and hence cannot refer to it. Thus, on such systems the documentation says that .BR ttyslot () returns the current user's index in the user accounting data base. -.SH "RETURN VALUE" +.SH RETURN VALUE If successful, this function returns the slot number. On error (e.g., if none of the file descriptors 0, 1 or 2 is associated with a terminal that occurs in this data base) it returns 0 on UNIX V6 and V7 and BSD-like systems, but \-1 on System V-like systems. -.SH "CONFORMING TO" +.SH CONFORMING TO SUSv1; marked as LEGACY in SUSv2; removed in POSIX.1-2001. SUSv2 requires \-1 on error. .SH NOTES @@ -141,7 +141,7 @@ Minix also has .\" .SH HISTORY .\" .BR ttyslot () .\" appeared in UNIX V7. -.SH "SEE ALSO" +.SH SEE ALSO .BR getttyent (3), .BR ttyname (3), .BR utmp (5) diff --git a/man3/tzset.3 b/man3/tzset.3 index af1aa2e25..d46dbda0d 100644 --- a/man3/tzset.3 +++ b/man3/tzset.3 @@ -211,7 +211,7 @@ Often is a symlink to the file .I localtime or to the correct timezone file in the system timezone directory. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001, 4.3BSD. .SH NOTES Note that the variable \fIdaylight\fP does not indicate that daylight @@ -228,7 +228,7 @@ name of the timezone corresponding to its first argument (minutes West of UTC). If the second argument was 0, the standard name was used, otherwise the daylight saving time version. -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR gettimeofday (2), .BR time (2), diff --git a/man3/ualarm.3 b/man3/ualarm.3 index 21f1a657f..342679062 100644 --- a/man3/ualarm.3 +++ b/man3/ualarm.3 @@ -77,7 +77,7 @@ argument is nonzero, further signals will be sent every .I interval microseconds after the first. -.SH "RETURN VALUE" +.SH RETURN VALUE This function returns the number of microseconds remaining for any alarm that was previously set, or 0 if no alarm was pending. .SH ERRORS @@ -88,7 +88,7 @@ Interrupted by a signal. .B EINVAL \fIusecs\fP or \fIinterval\fP is not smaller than 1000000. (On systems where that is considered an error.) -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. POSIX.1-2001 marks .BR ualarm () @@ -131,7 +131,7 @@ or POSIX interval timers .RB ( timer_create (2), etc.) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR alarm (2), .BR getitimer (2), .BR nanosleep (2), diff --git a/man3/ulimit.3 b/man3/ulimit.3 index 7c9ad0761..18e8e2640 100644 --- a/man3/ulimit.3 +++ b/man3/ulimit.3 @@ -64,7 +64,7 @@ Return the maximum possible address of the data segment. .B 4 (Implemented but no symbolic constant provided.) Return the maximum number of files that the calling process can open. -.SH "RETURN VALUE" +.SH RETURN VALUE On success, .BR ulimit () returns a nonnegative value. @@ -75,12 +75,12 @@ is set appropriately. .TP .B EPERM A unprivileged process tried to increase a limit. -.SH "CONFORMING TO" +.SH CONFORMING TO SVr4, POSIX.1-2001. POSIX.1-2008 marks .BR ulimit () as obsolete. -.SH "SEE ALSO" +.SH SEE ALSO .BR bash (1), .BR getrlimit (2), .BR setrlimit (2), diff --git a/man3/ungetwc.3 b/man3/ungetwc.3 index fad15fd6f..fb58a36f3 100644 --- a/man3/ungetwc.3 +++ b/man3/ungetwc.3 @@ -45,12 +45,12 @@ it can be any other valid wide character. If the implementation supports multiple push-back operations in a row, the pushed-back wide characters will be read in reverse order; however, only one level of push-back is guaranteed. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR ungetwc () function returns \fIwc\fP when successful, or \fBWEOF\fP upon failure. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -59,5 +59,5 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR fgetwc (3) diff --git a/man3/unlocked_stdio.3 b/man3/unlocked_stdio.3 index 55c0c5140..9af39471a 100644 --- a/man3/unlocked_stdio.3 +++ b/man3/unlocked_stdio.3 @@ -108,7 +108,7 @@ without the "_unlocked" suffix, except that they do not use locking of locks set by others) and hence are thread-unsafe. See .BR flockfile (3). -.SH "CONFORMING TO" +.SH CONFORMING TO The four functions .BR getc_unlocked (), .BR getchar_unlocked (), @@ -131,6 +131,6 @@ variants occur on a few UNIX systems, and are available in recent glibc. .\" putwc_unlocked, putwchar_unlocked, rewind_unlocked, setvbuf_unlocked, .\" ungetc_unlocked, ungetwc_unlocked. They should probably not be used. -.SH "SEE ALSO" +.SH SEE ALSO .BR flockfile (3), .BR stdio (3) diff --git a/man3/unlockpt.3 b/man3/unlockpt.3 index 0b24e7659..1516ee2b9 100644 --- a/man3/unlockpt.3 +++ b/man3/unlockpt.3 @@ -21,7 +21,7 @@ corresponding to the master pseudoterminal referred to by .PP .BR unlockpt () should be called before opening the slave side of a pseudoterminal. -.SH "RETURN VALUE" +.SH RETURN VALUE When successful, .BR unlockpt () returns 0. @@ -42,9 +42,9 @@ argument is not associated with a master pseudoterminal. .SH VERSIONS .BR unlockpt () is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR grantpt (3), .BR posix_openpt (3), .BR ptsname (3), diff --git a/man3/updwtmp.3 b/man3/updwtmp.3 index ce45b27ce..90d080c99 100644 --- a/man3/updwtmp.3 +++ b/man3/updwtmp.3 @@ -49,7 +49,7 @@ to append the structure to the wtmp file. .TP .I /var/log/wtmp database of past user logins -.SH "CONFORMING TO" +.SH CONFORMING TO Not in POSIX.1-2001. Present on Solaris, NetBSD, and perhaps other systems. .SH AVAILABILITY @@ -78,6 +78,6 @@ This function performs the same task as but differs in that it takes a .I utmpx structure as its last argument. -.SH "SEE ALSO" +.SH SEE ALSO .BR getutxent (3), .BR wtmp (5) diff --git a/man3/usleep.3 b/man3/usleep.3 index c3f77cf8e..d7dc7abc8 100644 --- a/man3/usleep.3 +++ b/man3/usleep.3 @@ -70,7 +70,7 @@ function suspends execution of the calling thread for The sleep may be lengthened slightly by any system activity or by the time spent processing the call or by the granularity of system timers. -.SH "RETURN VALUE" +.SH RETURN VALUE 0 on success, \-1 on error. .SH ERRORS .TP @@ -81,7 +81,7 @@ Interrupted by a signal; see .B EINVAL \fIusec\fP is not smaller than 1000000. (On systems where that is considered an error.) -.SH "CONFORMING TO" +.SH CONFORMING TO 4.3BSD, POSIX.1-2001. POSIX.1-2001 declares this function obsolete; use .BR nanosleep (2) @@ -132,7 +132,7 @@ signal, and with other timer functions such as .BR timer_settime (2), .BR ualarm (3) is unspecified. -.SH "SEE ALSO" +.SH SEE ALSO .BR alarm (2), .BR getitimer (2), .BR nanosleep (2), diff --git a/man3/wcpcpy.3 b/man3/wcpcpy.3 index e109003bf..a7ed67ce1 100644 --- a/man3/wcpcpy.3 +++ b/man3/wcpcpy.3 @@ -54,12 +54,12 @@ The strings may not overlap. The programmer must ensure that there is room for at least \fIwcslen(src)+1\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wcpcpy () returns a pointer to the end of the wide-character string \fIdest\fP, that is, a pointer to the terminating null wide character. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. -.SH "SEE ALSO" +.SH SEE ALSO .BR strcpy (3), .BR wcscpy (3) diff --git a/man3/wcpncpy.3 b/man3/wcpncpy.3 index 627e6a3ac..23f5c63ab 100644 --- a/man3/wcpncpy.3 +++ b/man3/wcpncpy.3 @@ -63,12 +63,12 @@ The strings may not overlap. .PP The programmer must ensure that there is room for at least \fIn\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wcpncpy () returns a pointer to the last wide character written, that is, \fIdest + n \- 1\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. -.SH "SEE ALSO" +.SH SEE ALSO .BR stpncpy (3), .BR wcsncpy (3) diff --git a/man3/wcrtomb.3 b/man3/wcrtomb.3 index 0727fbca0..50383cc85 100644 --- a/man3/wcrtomb.3 +++ b/man3/wcrtomb.3 @@ -64,7 +64,7 @@ In all of the above cases, if \fIps\fP is a NULL pointer, a static anonymous state only known to the .BR wcrtomb () function is used instead. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcrtomb () function returns the number of @@ -74,7 +74,7 @@ If \fIwc\fP can not be represented as a multibyte sequence (according to the current locale), .I (size_t)\ \-1 is returned, and \fIerrno\fP set to \fBEILSEQ\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -85,5 +85,5 @@ category of the current locale. .PP Passing NULL as \fIps\fP is not multithread safe. -.SH "SEE ALSO" +.SH SEE ALSO .BR wcsrtombs (3) diff --git a/man3/wcscasecmp.3 b/man3/wcscasecmp.3 index e9c82801f..32ecc359c 100644 --- a/man3/wcscasecmp.3 +++ b/man3/wcscasecmp.3 @@ -49,7 +49,7 @@ by \fIs1\fP and the wide-character string pointed to by \fIs2\fP, ignoring case differences .RB ( towupper (3), .BR towlower (3)). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcscasecmp () function returns zero if the wide-character strings at @@ -63,7 +63,7 @@ than \fIs2\fP, ignoring case. The .BR wcscasecmp () function is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. This function is not specified in POSIX.1-2001, and is not widely available on other systems. @@ -74,6 +74,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR strcasecmp (3), .BR wcscmp (3) diff --git a/man3/wcscat.3 b/man3/wcscat.3 index 580dc86b9..a21b776b7 100644 --- a/man3/wcscat.3 +++ b/man3/wcscat.3 @@ -35,12 +35,12 @@ The strings may not overlap. .PP The programmer must ensure that there is room for at least \fIwcslen(dest) + wcslen(src) + 1\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wcscat () returns \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strcat (3), .BR wcpcpy (3), .BR wcscpy (3), diff --git a/man3/wcschr.3 b/man3/wcschr.3 index 9c837479a..74219306e 100644 --- a/man3/wcschr.3 +++ b/man3/wcschr.3 @@ -29,15 +29,15 @@ of the function. It searches the first occurrence of \fIwc\fP in the wide-character string pointed to by \fIwcs\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcschr () function returns a pointer to the first occurrence of \fIwc\fP in the wide-character string pointed to by \fIwcs\fP, or NULL if \fIwc\fP does not occur in the string. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strchr (3), .BR wcspbrk (3), .BR wcsrchr (3), diff --git a/man3/wcscmp.3 b/man3/wcscmp.3 index 3b902727d..2db16e3f4 100644 --- a/man3/wcscmp.3 +++ b/man3/wcscmp.3 @@ -29,7 +29,7 @@ of the function. It compares the wide-character string pointed to by \fIs1\fP and the wide-character string pointed to by \fIs2\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcscmp () function returns zero if the wide-character strings at @@ -40,9 +40,9 @@ at the first differing position \fIi\fP, the corresponding wide-character It returns an integer less than zero if at the first differing position \fIi\fP, the corresponding wide-character \fIs1[i]\fP is less than \fIs2[i]\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strcmp (3), .BR wcscasecmp (3), .BR wmemcmp (3) diff --git a/man3/wcscpy.3 b/man3/wcscpy.3 index 49541934b..20ea582be 100644 --- a/man3/wcscpy.3 +++ b/man3/wcscpy.3 @@ -37,12 +37,12 @@ The strings may not overlap. The programmer must ensure that there is room for at least \fIwcslen(src)+1\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wcscpy () returns \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strcpy (3), .BR wcpcpy (3), .BR wcscat (3), diff --git a/man3/wcscspn.3 b/man3/wcscspn.3 index e44dfcae5..e339375d4 100644 --- a/man3/wcscspn.3 +++ b/man3/wcscspn.3 @@ -33,7 +33,7 @@ In other words, it searches for the first occurrence in the wide-character string \fIwcs\fP of any of the characters in the wide-character string \fIreject\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcscspn () function returns the number of @@ -45,9 +45,9 @@ occurrence in the wide-character string \fIwcs\fP of any of the characters in the wide-character string \fIreject\fP, or \fIwcslen(wcs)\fP if there is none. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strcspn (3), .BR wcspbrk (3), .BR wcsspn (3) diff --git a/man3/wcsdup.3 b/man3/wcsdup.3 index 761b60b26..a913b9960 100644 --- a/man3/wcsdup.3 +++ b/man3/wcsdup.3 @@ -53,7 +53,7 @@ obtained with .BR malloc (3), and should be freed with .BR free (3). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsdup () function returns a pointer @@ -63,11 +63,11 @@ or NULL if sufficient memory was not available. .TP .B ENOMEM Insufficient memory available to allocate duplicate string. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. This function is not specified in POSIX.1-2001, and is not widely available on other systems. .\" present in libc5 and glibc 2.0 and later -.SH "SEE ALSO" +.SH SEE ALSO .BR strdup (3), .BR wcscpy (3) diff --git a/man3/wcslen.3 b/man3/wcslen.3 index f1e5fd216..78b78d22a 100644 --- a/man3/wcslen.3 +++ b/man3/wcslen.3 @@ -29,12 +29,12 @@ of the function. It determines the length of the wide-character string pointed to by \fIs\fP, excluding the terminating null wide character (L\(aq\\0\(aq). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcslen () function returns the number of wide characters in \fIs\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strlen (3) diff --git a/man3/wcsncasecmp.3 b/man3/wcsncasecmp.3 index 390fc4c8d..5979a18e0 100644 --- a/man3/wcsncasecmp.3 +++ b/man3/wcsncasecmp.3 @@ -50,7 +50,7 @@ pointed to by \fIs2\fP, but at most \fIn\fP wide characters from each string, ignoring case differences .RB ( towupper (3), .BR towlower (3)). -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsncasecmp () function returns zero @@ -66,7 +66,7 @@ if truncated \fIs1\fP is smaller than truncated \fIs2\fP, ignoring case. The .BR wcsncasecmp () function is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. This function is not specified in POSIX.1-2001, and is not widely available on other systems. @@ -77,6 +77,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR strncasecmp (3), .BR wcsncmp (3) diff --git a/man3/wcsncat.3 b/man3/wcsncat.3 index 64c7749bd..2e4242487 100644 --- a/man3/wcsncat.3 +++ b/man3/wcsncat.3 @@ -34,11 +34,11 @@ The strings may not overlap. .PP The programmer must ensure that there is room for at least \fIwcslen(dest) + n + 1\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wcsncat () returns \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strncat (3), .BR wcscat (3) diff --git a/man3/wcsncmp.3 b/man3/wcsncmp.3 index 14a8fbf46..f6fa6d616 100644 --- a/man3/wcsncmp.3 +++ b/man3/wcsncmp.3 @@ -31,7 +31,7 @@ wide-character string pointed to by \fIs2\fP, but at most \fIn\fP wide characters from each string. In each string, the comparison extends only up to the first occurrence of a null wide character (L\(aq\\0\(aq), if any. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsncmp () function returns zero if the wide-character strings at @@ -43,8 +43,8 @@ greater than \fIs2[i]\fP. It returns an integer less than zero if at the first differing position \fIi\fP (\fIi\fP < \fIn\fP), the corresponding wide-character \fIs1[i]\fP is less than \fIs2[i]\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strncmp (3), .BR wcsncasecmp (3) diff --git a/man3/wcsncpy.3 b/man3/wcsncpy.3 index 7ff29ae6e..a98c0dfeb 100644 --- a/man3/wcsncpy.3 +++ b/man3/wcsncpy.3 @@ -44,10 +44,10 @@ The strings may not overlap. .PP The programmer must ensure that there is room for at least \fIn\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wcsncpy () returns \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strncpy (3) diff --git a/man3/wcsnlen.3 b/man3/wcsnlen.3 index 6a125c97b..f667ce077 100644 --- a/man3/wcsnlen.3 +++ b/man3/wcsnlen.3 @@ -54,7 +54,7 @@ In doing this, .BR wcsnlen () looks only at the first \fImaxlen\fP wide characters at \fIs\fP and never beyond \fIs+maxlen\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsnlen () function returns \fIwcslen(s)\fP, if that is less than @@ -64,8 +64,8 @@ first \fImaxlen\fP wide characters pointed to by \fIs\fP. The .BR wcsnlen () function is provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. -.SH "SEE ALSO" +.SH SEE ALSO .BR strnlen (3), .BR wcslen (3) diff --git a/man3/wcsnrtombs.3 b/man3/wcsnrtombs.3 index 2190ea3e7..9ac664d0f 100644 --- a/man3/wcsnrtombs.3 +++ b/man3/wcsnrtombs.3 @@ -101,7 +101,7 @@ state only known to the wcsnrtombs function is used instead. .PP The programmer must ensure that there is room for at least \fIlen\fP bytes at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsnrtombs () function returns @@ -112,7 +112,7 @@ If a wide character was encountered which could not be converted, .I (size_t)\ \-1 is returned, and \fIerrno\fP set to \fBEILSEQ\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2008. .SH NOTES The behavior of @@ -123,6 +123,6 @@ category of the current locale. .PP Passing NULL as \fIps\fP is not multithread safe. -.SH "SEE ALSO" +.SH SEE ALSO .BR iconv (3), .BR wcsrtombs (3) diff --git a/man3/wcspbrk.3 b/man3/wcspbrk.3 index a10e43ff6..b41e19666 100644 --- a/man3/wcspbrk.3 +++ b/man3/wcspbrk.3 @@ -31,16 +31,16 @@ It searches for the first occurrence in the wide-character string pointed to by \fIwcs\fP of any of the characters in the wide-character string pointed to by \fIaccept\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcspbrk () function returns a pointer to the first occurrence in \fIwcs\fP of any of the characters listed in \fIaccept\fP. If \fIwcs\fP contains none of these characters, NULL is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strpbrk (3), .BR wcschr (3), .BR wcscspn (3) diff --git a/man3/wcsrchr.3 b/man3/wcsrchr.3 index 4a979c5e9..7da4fb518 100644 --- a/man3/wcsrchr.3 +++ b/man3/wcsrchr.3 @@ -29,14 +29,14 @@ of the function. It searches the last occurrence of \fIwc\fP in the wide-character string pointed to by \fIwcs\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsrchr () function returns a pointer to the last occurrence of \fIwc\fP in the wide-character string pointed to by \fIwcs\fP, or NULL if \fIwc\fP does not occur in the string. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strrchr (3), .BR wcschr (3) diff --git a/man3/wcsrtombs.3 b/man3/wcsrtombs.3 index b7ab8240d..488e873e5 100644 --- a/man3/wcsrtombs.3 +++ b/man3/wcsrtombs.3 @@ -76,7 +76,7 @@ state only known to the wcsrtombs function is used instead. .PP The programmer must ensure that there is room for at least \fIlen\fP bytes at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsrtombs () function returns @@ -89,7 +89,7 @@ which could not be converted, is returned, and .I errno set to \fBEILSEQ\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -100,7 +100,7 @@ category of the current locale. .PP Passing NULL as \fIps\fP is not multithread safe. -.SH "SEE ALSO" +.SH SEE ALSO .BR iconv (3), .BR wcsnrtombs (3), .BR wcstombs (3) diff --git a/man3/wcsspn.3 b/man3/wcsspn.3 index 6d4b49251..3e46623ff 100644 --- a/man3/wcsspn.3 +++ b/man3/wcsspn.3 @@ -33,7 +33,7 @@ In other words, it searches for the first occurrence in the wide-character string \fIwcs\fP of a wide-character not contained in the wide-character string \fIaccept\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsspn () function returns the number of @@ -44,8 +44,8 @@ In other words, it returns the position of the first occurrence in the wide-character string \fIwcs\fP of a wide-character not contained in the wide-character string \fIaccept\fP, or \fIwcslen(wcs)\fP if there is none. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strspn (3), .BR wcscspn (3) diff --git a/man3/wcsstr.3 b/man3/wcsstr.3 index 242cbaf21..7376205ce 100644 --- a/man3/wcsstr.3 +++ b/man3/wcsstr.3 @@ -29,7 +29,7 @@ function. It searches for the first occurrence of the wide-character string \fIneedle\fP (without its terminating null wide character (L\(aq\\0\(aq)) as a substring in the wide-character string \fIhaystack\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcsstr () function returns a pointer to the first occurrence of @@ -40,8 +40,8 @@ as a substring in \fIhaystack\fP. Note the special case: If \fIneedle\fP is the empty wide-character string, the return value is always \fIhaystack\fP itself. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR strstr (3), .BR wcschr (3) diff --git a/man3/wcstoimax.3 b/man3/wcstoimax.3 index 29d40f2f7..5e70ca3e4 100644 --- a/man3/wcstoimax.3 +++ b/man3/wcstoimax.3 @@ -45,9 +45,9 @@ except that they return a value of type and .IR uintmax_t , respectively. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR imaxabs (3), .BR imaxdiv (3), .BR strtoimax (3), diff --git a/man3/wcstok.3 b/man3/wcstok.3 index aeb3af953..233b775ee 100644 --- a/man3/wcstok.3 +++ b/man3/wcstok.3 @@ -52,12 +52,12 @@ token by replacing the next wide-character which occurs in \fIdelim\fP with a null wide character (L\(aq\\0\(aq), and it updates \fI*ptr\fP so that subsequent calls will continue searching after the end of recognized token. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcstok () function returns a pointer to the next token, or NULL if no further token was found. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The original \fIwcs\fP wide-character string is destructively modified during @@ -75,6 +75,6 @@ for (token = wcstok(wcs, " \\t\\n", &state); ... } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR strtok (3), .BR wcschr (3) diff --git a/man3/wcstombs.3 b/man3/wcstombs.3 index abfc456ec..6c65d602b 100644 --- a/man3/wcstombs.3 +++ b/man3/wcstombs.3 @@ -56,7 +56,7 @@ and that no length limit exists. .PP In order to avoid the case 2 above, the programmer should make sure \fIn\fP is greater or equal to \fIwcstombs(NULL,src,0)+1\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcstombs () function returns the number of bytes that make up the @@ -65,7 +65,7 @@ If a wide character was encountered which could not be converted, .I (size_t)\ \-1 is returned. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -79,6 +79,6 @@ The function .BR wcsrtombs (3) provides a thread safe interface to the same functionality. -.SH "SEE ALSO" +.SH SEE ALSO .BR mbstowcs (3), .BR wcsrtombs (3) diff --git a/man3/wcswidth.3 b/man3/wcswidth.3 index cf16d7662..b5353d1a3 100644 --- a/man3/wcswidth.3 +++ b/man3/wcswidth.3 @@ -29,13 +29,13 @@ the wide-character string pointed to by \fIs\fP, but at most \fIn\fP wide characters. If a nonprintable wide character occurs among these characters, \-1 is returned. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcswidth () function returns the number of column positions for the wide-character string \fIs\fP, truncated to at most length \fIn\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES The behavior of @@ -44,6 +44,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswprint (3), .BR wcwidth (3) diff --git a/man3/wctob.3 b/man3/wctob.3 index 429e46a8b..bf1044aab 100644 --- a/man3/wctob.3 +++ b/man3/wctob.3 @@ -35,12 +35,12 @@ It cannot help you in writing internationalized programs. Internationalized programs must never distinguish single-byte and multibyte characters. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wctob () function returns the single-byte representation of \fIc\fP, if it exists, of \fBEOF\fP otherwise. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -58,7 +58,7 @@ Use either or the thread-safe .BR wcrtomb (3) instead. -.SH "SEE ALSO" +.SH SEE ALSO .BR btowc (3), .BR wcrtomb (3), .BR wctomb (3) diff --git a/man3/wctomb.3 b/man3/wctomb.3 index c5a938378..7da1f20e2 100644 --- a/man3/wctomb.3 +++ b/man3/wctomb.3 @@ -47,7 +47,7 @@ resets the shift state, only known to this function, to the initial state, and returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. -.SH "RETURN VALUE" +.SH RETURN VALUE If \fIs\fP is not NULL, the .BR wctomb () function @@ -61,7 +61,7 @@ If \fIs\fP is NULL, the .BR wctomb () function returns nonzero if the encoding has nontrivial shift state, or zero if the encoding is stateless. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -76,7 +76,7 @@ The function .BR wcrtomb (3) provides a better interface to the same functionality. -.SH "SEE ALSO" +.SH SEE ALSO .BR MB_CUR_MAX (3), .BR wcrtomb (3), .BR wcstombs (3) diff --git a/man3/wctrans.3 b/man3/wctrans.3 index b47e043f7..2971d955f 100644 --- a/man3/wctrans.3 +++ b/man3/wctrans.3 @@ -44,13 +44,13 @@ following names are valid in all locales. "tolower" \- realizes the \fBtolower\fP(3) mapping "toupper" \- realizes the \fBtoupper\fP(3) mapping .fi -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wctrans () function returns a mapping descriptor if the \fIname\fP is valid. Otherwise it returns \fI(wctrans_t) 0\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -59,5 +59,5 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR towctrans (3) diff --git a/man3/wctype.3 b/man3/wctype.3 index c3a770117..15b4a7867 100644 --- a/man3/wctype.3 +++ b/man3/wctype.3 @@ -60,7 +60,7 @@ following names are valid in all locales. "upper" \- realizes the \fBisupper\fP(3) classification function "xdigit" \- realizes the \fBisxdigit\fP(3) classification function .fi -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wctype () function returns a property descriptor @@ -69,7 +69,7 @@ if the is valid. Otherwise it returns .IR "(wctype_t) 0" . -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -78,5 +78,5 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswctype (3) diff --git a/man3/wcwidth.3 b/man3/wcwidth.3 index 2cabe6d60..c3553e0d0 100644 --- a/man3/wcwidth.3 +++ b/man3/wcwidth.3 @@ -29,12 +29,12 @@ If \fIc\fP is a printable wide character, the value is at least 0. If \fIc\fP is null wide character (L\(aq\\0\(aq), the value is 0. Otherwise \-1 is returned. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wcwidth () function returns the number of column positions for \fIc\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. Note that glibc before 2.2.5 used the prototype @@ -49,6 +49,6 @@ depends on the .B LC_CTYPE category of the current locale. -.SH "SEE ALSO" +.SH SEE ALSO .BR iswprint (3), .BR wcswidth (3) diff --git a/man3/wmemchr.3 b/man3/wmemchr.3 index ed8083e2b..9eb1b5726 100644 --- a/man3/wmemchr.3 +++ b/man3/wmemchr.3 @@ -28,14 +28,14 @@ function is the wide-character equivalent of the function. It searches the \fIn\fP wide characters starting at \fIs\fP for the first occurrence of the wide character \fIc\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wmemchr () function returns a pointer to the first occurrence of \fIc\fP among the \fIn\fP wide characters starting at \fIs\fP, or NULL if \fIc\fP does not occur among these. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR memchr (3), .BR wcschr (3) diff --git a/man3/wmemcmp.3 b/man3/wmemcmp.3 index ccaa4c746..277caaf5f 100644 --- a/man3/wmemcmp.3 +++ b/man3/wmemcmp.3 @@ -27,7 +27,7 @@ function is the wide-character equivalent of the function. It compares the \fIn\fP wide-characters starting at \fIs1\fP and the \fIn\fP wide-characters starting at \fIs2\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR wmemcmp () function returns @@ -41,8 +41,8 @@ at the first differing position \fIi\fP (\fIi\fP < \fIn\fP), the corresponding wide-character \fIs1[i]\fP is less than \fIs2[i]\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR memcmp (3), .BR wcscmp (3) diff --git a/man3/wmemcpy.3 b/man3/wmemcpy.3 index 25340d26d..205999441 100644 --- a/man3/wmemcpy.3 +++ b/man3/wmemcpy.3 @@ -36,12 +36,12 @@ arrays. .PP The programmer must ensure that there is room for at least \fIn\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wmemcpy () returns \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR memcpy (3), .BR wcscpy (3), .BR wmemmove (3), diff --git a/man3/wmemmove.3 b/man3/wmemmove.3 index c98b317bd..52b83f77c 100644 --- a/man3/wmemmove.3 +++ b/man3/wmemmove.3 @@ -33,11 +33,11 @@ overlap. .PP The programmer must ensure that there is room for at least \fIn\fP wide characters at \fIdest\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wmemmove () returns \fIdest\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR memmove (3), .BR wmemcpy (3) diff --git a/man3/wmemset.3 b/man3/wmemset.3 index eac225f43..f40958589 100644 --- a/man3/wmemset.3 +++ b/man3/wmemset.3 @@ -28,10 +28,10 @@ function is the wide-character equivalent of the function. It fills the array of \fIn\fP wide-characters starting at \fIwcs\fP with \fIn\fP copies of the wide character \fIwc\fP. -.SH "RETURN VALUE" +.SH RETURN VALUE .BR wmemset () returns \fIwcs\fP. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. -.SH "SEE ALSO" +.SH SEE ALSO .BR memset (3) diff --git a/man3/wordexp.3 b/man3/wordexp.3 index 04902bd3a..bf25eb366 100644 --- a/man3/wordexp.3 +++ b/man3/wordexp.3 @@ -153,7 +153,7 @@ is not to be redirected. .TP .B WRDE_UNDEF Consider it an error if an undefined shell variable is expanded. -.SH "RETURN VALUE" +.SH RETURN VALUE In case of success 0 is returned. In case of error one of the following five values is returned. @@ -183,7 +183,7 @@ unmatched quotes. and .BR wordfree () are provided in glibc since version 2.1. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH EXAMPLE The output of the following example program @@ -209,6 +209,6 @@ main(int argc, char **argv) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR fnmatch (3), .BR glob (3) diff --git a/man3/wprintf.3 b/man3/wprintf.3 index 985b60df7..db8dfe2ef 100644 --- a/man3/wprintf.3 +++ b/man3/wprintf.3 @@ -182,7 +182,7 @@ the number specified are written. The array must contain a terminating null wide character, unless a precision is given and it is smaller than or equal to the number of wide characters in the array. -.SH "RETURN VALUE" +.SH RETURN VALUE The functions return the number of wide characters written, excluding the terminating null wide character in case of the functions @@ -190,7 +190,7 @@ case of the functions and .BR vswprintf (). They return \-1 when an error occurs. -.SH "CONFORMING TO" +.SH CONFORMING TO C99. .SH NOTES The behavior of @@ -226,7 +226,7 @@ or .BR iconv (3), followed by .BR mbstowcs (3)). -.SH "SEE ALSO" +.SH SEE ALSO .BR fprintf (3), .BR fputwc (3), .BR fwide (3), diff --git a/man3/xcrypt.3 b/man3/xcrypt.3 index cc292236f..7ac91a851 100644 --- a/man3/xcrypt.3 +++ b/man3/xcrypt.3 @@ -54,7 +54,7 @@ of the same length. The .BR xdecrypt () function performs the converse operation. -.SH "RETURN VALUE" +.SH RETURN VALUE The functions .BR xencrypt () and @@ -65,5 +65,5 @@ These routines are present in libc 4.6.27 and later, and in glibc 2.1 and later. .SH BUGS The prototypes are missing from the abovementioned include file. -.SH "SEE ALSO" +.SH SEE ALSO .BR cbc_crypt (3) diff --git a/man3/xdr.3 b/man3/xdr.3 index d717e1f46..1829a2597 100644 --- a/man3/xdr.3 +++ b/man3/xdr.3 @@ -7,7 +7,7 @@ .TH XDR 3 2007-12-30 "" "Linux Programmer's Manual" .SH NAME xdr \- library routines for external data representation -.SH "SYNOPSIS AND DESCRIPTION" +.SH SYNOPSIS AND DESCRIPTION .LP These routines allow C programmers to describe arbitrary data structures in a machine-independent fashion. @@ -535,7 +535,7 @@ routines as arguments, and .BR xdr_string (), one of the most frequently used primitives, requires three. Returns one if it succeeds, zero otherwise. -.SH "SEE ALSO" +.SH SEE ALSO .BR rpc (3) .LP diff --git a/man3/y0.3 b/man3/y0.3 index c2be41737..d60d5c708 100644 --- a/man3/y0.3 +++ b/man3/y0.3 @@ -212,7 +212,7 @@ is not set for this case. An overflow floating-point exception .RB ( FE_OVERFLOW ) is raised. -.SH "CONFORMING TO" +.SH CONFORMING TO The functions returning .I double conform to SVr4, 4.3BSD, diff --git a/man4/cciss.4 b/man4/cciss.4 index 37ddc9fab..1e2e5beec 100644 --- a/man4/cciss.4 +++ b/man4/cciss.4 @@ -344,7 +344,7 @@ is issued that positions the tape to a known position. Typically you must rewind the tape (by issuing .I "mt -f /dev/st0 rewind" for example) before I/O can proceed again to a tape drive that was reset. -.SH "SEE ALSO" +.SH SEE ALSO .BR cciss_vol_status (8), .BR hpsa (4), .BR hpacucli (8), diff --git a/man4/console.4 b/man4/console.4 index 30040cd58..0d8b072b4 100644 --- a/man4/console.4 +++ b/man4/console.4 @@ -74,7 +74,7 @@ All escape sequences can be found in .I /dev/console .br .I /dev/tty* -.SH "SEE ALSO" +.SH SEE ALSO .BR chvt (1), .BR deallocvt (1), .BR loadkeys (1), diff --git a/man4/console_codes.4 b/man4/console_codes.4 index 4b7a0c73b..4203bb924 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -637,7 +637,7 @@ set the \fBxterm\fP(1) resource \fBbrokenLinuxOSC\fP to true. An older version of this document implied that Linux recognizes the ECMA-48 control sequence for invisible text. It is ignored. -.SH "SEE ALSO" +.SH SEE ALSO .BR console (4), .BR console_ioctl (4), .BR charsets (7) diff --git a/man4/console_ioctl.4 b/man4/console_ioctl.4 index 4586fca02..c9a0822b6 100644 --- a/man4/console_ioctl.4 +++ b/man4/console_ioctl.4 @@ -570,7 +570,7 @@ blank_timer times out, then you choose this option. (\fICaution:\fP Powering down frequently will damage the monitor.) (Since 1.1.76.) -.SH "RETURN VALUE" +.SH RETURN VALUE On success, 0 is returned. On error \-1 is returned, and \fIerrno\fP is set. .SH ERRORS @@ -610,7 +610,7 @@ of UNIX, will not work on older versions of Linux, and will not work on future versions of Linux. Use POSIX functions. -.SH "SEE ALSO" +.SH SEE ALSO .BR dumpkeys (1), .BR kbd_mode (1), .BR loadkeys (1), diff --git a/man4/dsp56k.4 b/man4/dsp56k.4 index bfece8f64..954c66aa8 100644 --- a/man4/dsp56k.4 +++ b/man4/dsp56k.4 @@ -111,7 +111,7 @@ user-defined command handled by the program running in the DSP56001. .\" .SH AUTHORS .\" Fredrik Noring , lars brinkhoff , .\" Tomas Berndtsson . -.SH "SEE ALSO" +.SH SEE ALSO .IR linux/include/asm-m68k/dsp56k.h , .IR linux/drivers/char/dsp56k.c , .UR http://dsp56k.nocrew.org/ diff --git a/man4/fd.4 b/man4/fd.4 index 7a44ffa44..a142bcb28 100644 --- a/man4/fd.4 +++ b/man4/fd.4 @@ -210,7 +210,7 @@ This used to be common with older 8-inch floppies. .\" .SH AUTHORS .\" Alain Knaff (Alain.Knaff@imag.fr), David Niemi .\" (niemidc@clark.net), Bill Broadhurst (bbroad@netcom.com). -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR floppycontrol (1), .BR getfdprm (1), diff --git a/man4/full.4 b/man4/full.4 index d83d30634..0e0d40b79 100644 --- a/man4/full.4 +++ b/man4/full.4 @@ -48,7 +48,7 @@ Reads from the \fI/dev/full\fP device will return \\0 characters. Seeks on \fI/dev/full\fP will always succeed. .SH FILES /dev/full -.SH "SEE ALSO" +.SH SEE ALSO .BR mknod (1), .BR null (4), .BR zero (4) diff --git a/man4/hd.4 b/man4/hd.4 index 76da22e95..f93baf982 100644 --- a/man4/hd.4 +++ b/man4/hd.4 @@ -93,7 +93,7 @@ chown root:disk /dev/hd* .RE .SH FILES /dev/hd* -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR mknod (1), .BR sd (4), diff --git a/man4/hpsa.4 b/man4/hpsa.4 index fba74090b..967acb11e 100644 --- a/man4/hpsa.4 +++ b/man4/hpsa.4 @@ -174,7 +174,7 @@ at .UR http://cciss.sf.net .UE for some examples. -.SH "SEE ALSO" +.SH SEE ALSO .BR cciss (4), .BR sd (4), .BR st (4), diff --git a/man4/initrd.4 b/man4/initrd.4 index bc179d318..80efeba73 100644 --- a/man4/initrd.4 +++ b/man4/initrd.4 @@ -470,7 +470,7 @@ The behavior may change in future versions of the Linux kernel. .\" The code for .\" .BR initrd .\" was added to the baseline Linux kernel in development version 1.3.73. -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR mknod (1), .BR ram (4), diff --git a/man4/intro.4 b/man4/intro.4 index 641d576eb..03806d87c 100644 --- a/man4/intro.4 +++ b/man4/intro.4 @@ -34,5 +34,5 @@ Section 4 of the manual describes special files (devices). Look at the header of the manual page source for the author(s) and copyright conditions. Note that these can be different from page to page! -.SH "SEE ALSO" +.SH SEE ALSO .BR standards (7) diff --git a/man4/lp.4 b/man4/lp.4 index 89b2b54a5..29a7f5ce9 100644 --- a/man4/lp.4 +++ b/man4/lp.4 @@ -119,7 +119,7 @@ No argument is used. .\" The interrupt code was written by Nigel Gamble. .\" Alan Cox modularized it. .\" LPCAREFUL, LPABORT, LPGETSTATUS were added by Chris Metcalf. -.SH "SEE ALSO" +.SH SEE ALSO .BR chmod (1), .BR chown (1), .BR mknod (1), diff --git a/man4/mem.4 b/man4/mem.4 index 460163d8b..8e751c2a1 100644 --- a/man4/mem.4 +++ b/man4/mem.4 @@ -78,7 +78,7 @@ chown root:mem /dev/port .I /dev/kmem .br .I /dev/port -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR mknod (1), .BR ioperm (2) diff --git a/man4/mouse.4 b/man4/mouse.4 index c701bc45d..e7df38a4d 100644 --- a/man4/mouse.4 +++ b/man4/mouse.4 @@ -149,6 +149,6 @@ byte d7 d6 d5 d4 d3 d2 d1 d0 .TP .I /dev/mouse A commonly used symlink pointing to a mouse device. -.SH "SEE ALSO" +.SH SEE ALSO .BR ttyS (4), .BR gpm (8) diff --git a/man4/null.4 b/man4/null.4 index 0a2068070..a37159701 100644 --- a/man4/null.4 +++ b/man4/null.4 @@ -49,7 +49,7 @@ chown root:root /dev/null /dev/zero .SH NOTES If these devices are not writable and readable for all users, many programs will act strangely. -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR mknod (1), .BR full (4) diff --git a/man4/pts.4 b/man4/pts.4 index ff81c6330..019e75ce9 100644 --- a/man4/pts.4 +++ b/man4/pts.4 @@ -64,7 +64,7 @@ Before this UNIX 98 scheme, master pseudoterminals were called and slave pseudoterminals .IR /dev/ttyp0 ", ..." and one needed lots of preallocated device nodes. -.SH "SEE ALSO" +.SH SEE ALSO .BR getpt (3), .BR grantpt (3), .BR ptsname (3), diff --git a/man4/ram.4 b/man4/ram.4 index 78062eb6a..3bcba4504 100644 --- a/man4/ram.4 +++ b/man4/ram.4 @@ -37,7 +37,7 @@ chown root:disk /dev/ram .RE .SH FILES /dev/ram -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR mknod (1), .BR mount (8) diff --git a/man4/random.4 b/man4/random.4 index 8fb79aa13..170bacc4a 100644 --- a/man4/random.4 +++ b/man4/random.4 @@ -213,7 +213,7 @@ generated once. .\" .SH AUTHOR .\" The kernel's random number generator was written by .\" Theodore Ts'o (tytso@athena.mit.edu). -.SH "SEE ALSO" +.SH SEE ALSO .BR mknod (1) .br RFC\ 1750, "Randomness Recommendations for Security" diff --git a/man4/rtc.4 b/man4/rtc.4 index 4a2502c3b..94b8295b4 100644 --- a/man4/rtc.4 +++ b/man4/rtc.4 @@ -327,7 +327,7 @@ programmable output clock signals; nonvolatile memory; and other hardware capabilities that are not currently exposed by this API. -.SH "SEE ALSO" +.SH SEE ALSO .BR date (1), .BR adjtimex (2), .BR gettimeofday (2), diff --git a/man4/sk98lin.4 b/man4/sk98lin.4 index e120ece80..c3310cd6b 100644 --- a/man4/sk98lin.4 +++ b/man4/sk98lin.4 @@ -606,7 +606,7 @@ Report any bugs to linux@syskonnect.de .\" Ralph Roesler \(em rroesler@syskonnect.de .\" .br .\" Mirko Lindner \(em mlindner@syskonnect.de -.SH "SEE ALSO" +.SH SEE ALSO .BR ifconfig (8), .BR insmod (8), .BR modprobe (8) diff --git a/man4/st.4 b/man4/st.4 index 29185a25a..117a511db 100644 --- a/man4/st.4 +++ b/man4/st.4 @@ -823,7 +823,7 @@ struct mtpos { }; .fi .in -.SH "RETURN VALUE" +.SH RETURN VALUE .TP 14 .TP .B EACCES @@ -949,7 +949,7 @@ If this is not possible, direct transfers can be disabled. .\" manual provided the copyright notice and this permission notice are .\" preserved on all copies. .\" Additional permissions are contained in the header of the source file. -.SH "SEE ALSO" +.SH SEE ALSO .BR mt (1) .PP The file diff --git a/man4/tty.4 b/man4/tty.4 index c7826ba94..c26eebde0 100644 --- a/man4/tty.4 +++ b/man4/tty.4 @@ -62,7 +62,7 @@ open fails, it is obviously not attached to a terminal and does not need to detach itself. .SH FILES /dev/tty -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR mknod (1), .BR ioctl (2), diff --git a/man4/ttyS.4 b/man4/ttyS.4 index fc489c9d2..c6c3ea260 100644 --- a/man4/ttyS.4 +++ b/man4/ttyS.4 @@ -43,7 +43,7 @@ chown root:tty /dev/ttyS[0\-3] .RE .SH FILES /dev/ttyS[0\-3] -.SH "SEE ALSO" +.SH SEE ALSO .BR chown (1), .BR mknod (1), .BR tty (4), diff --git a/man4/tty_ioctl.4 b/man4/tty_ioctl.4 index 1f2d61535..7fc789c46 100644 --- a/man4/tty_ioctl.4 +++ b/man4/tty_ioctl.4 @@ -428,7 +428,7 @@ corresponding to .\" .TP .\" .BI "TIOCSSERIAL const struct serial_struct *" argp .\" Set serial info. -.SH "RETURN VALUE" +.SH RETURN VALUE The .BR ioctl (2) system call returns 0 on success. @@ -471,7 +471,7 @@ main(void) close(fd); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR ioctl (2), .BR termios (3), .BR console_ioctl (4), diff --git a/man4/vcs.4 b/man4/vcs.4 index 6887a44a6..759f2e24c 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -147,7 +147,7 @@ main(void) exit(EXIT_SUCCESS); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR console (4), .BR tty (4), .BR ttyS (4), diff --git a/man4/wavelan.4 b/man4/wavelan.4 index 519d4b569..3e0a39478 100644 --- a/man4/wavelan.4 +++ b/man4/wavelan.4 @@ -128,7 +128,7 @@ them by changing flags in the driver header and recompile. .\" .\" SEE ALSO part .\" -.SH "SEE ALSO" +.SH SEE ALSO .BR wavelan_cs (4), .BR ifconfig (8), .BR insmod (8), diff --git a/man5/acct.5 b/man5/acct.5 index 4da36054b..c14692b30 100644 --- a/man5/acct.5 +++ b/man5/acct.5 @@ -170,7 +170,7 @@ file, described in .BR proc (5), defines settings that control the behavior of process accounting when disk space runs low. -.SH "SEE ALSO" +.SH SEE ALSO .BR lastcomm (1), .BR acct (2), .BR accton (8), diff --git a/man5/charmap.5 b/man5/charmap.5 index b749839a0..da23c29cb 100644 --- a/man5/charmap.5 +++ b/man5/charmap.5 @@ -119,9 +119,9 @@ with an octal number. .I /usr/share/i18n/charmaps/* .\" .SH AUTHOR .\" Jochen Hein (jochen.hein@delphi.central.de) -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.2. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale (1), .BR localedef (1), .BR localeconv (3), diff --git a/man5/dir_colors.5 b/man5/dir_colors.5 index 12302ab08..124259871 100644 --- a/man5/dir_colors.5 +++ b/man5/dir_colors.5 @@ -356,7 +356,7 @@ definitions, which are used by ISO 6429 terminals are: The default .B ENDCODE is undefined. -.SH "SEE ALSO" +.SH SEE ALSO .BR dircolors (1), .BR ls (1), .BR stty (1), diff --git a/man5/filesystems.5 b/man5/filesystems.5 index f2f4ca0c0..dc1132789 100644 --- a/man5/filesystems.5 +++ b/man5/filesystems.5 @@ -189,7 +189,7 @@ To use you need special programs, which can be found at .UR ftp://linux01.gwdg.de\:/pub\:/ncpfs .UE . -.SH "SEE ALSO" +.SH SEE ALSO .BR proc (5), .BR fsck (8), .BR mkfs (8), diff --git a/man5/ftpusers.5 b/man5/ftpusers.5 index df4f3586c..7c64e2bc9 100644 --- a/man5/ftpusers.5 +++ b/man5/ftpusers.5 @@ -44,7 +44,7 @@ There is one account name (or username) per line. Lines starting with a # are ignored. .SH FILES .I /etc/ftpusers -.SH "SEE ALSO" +.SH SEE ALSO .BR passwd (5), .BR proftpd (8), .BR wuftpd (8) diff --git a/man5/group.5 b/man5/group.5 index f83d5fb64..a5676ee20 100644 --- a/man5/group.5 +++ b/man5/group.5 @@ -57,7 +57,7 @@ As the 4.2BSD man page says: No-one seems to keep .I /etc/group up-to-date. -.SH "SEE ALSO" +.SH SEE ALSO .BR login (1), .BR newgrp (1), .BR getgrent (3), diff --git a/man5/host.conf.5 b/man5/host.conf.5 index 189e2e981..5c45af134 100644 --- a/man5/host.conf.5 +++ b/man5/host.conf.5 @@ -196,7 +196,7 @@ and a new environment variable can take arguments like .IR off ", " nowarn " and " warn . Line comments can appear anywhere and not only at the beginning of a line. -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname (3), .BR hostname (7), .BR named (8), diff --git a/man5/hosts.5 b/man5/hosts.5 index b53a7be02..5fb303ad6 100644 --- a/man5/hosts.5 +++ b/man5/hosts.5 @@ -112,7 +112,7 @@ I just found three, from 92, 146.82.138.7 master.debian.org master 209.237.226.90 www.opensource.org .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR hostname (1), .BR resolver (3), .BR resolver (5), diff --git a/man5/hosts.equiv.5 b/man5/hosts.equiv.5 index dfee02350..60c8194cb 100644 --- a/man5/hosts.equiv.5 +++ b/man5/hosts.equiv.5 @@ -59,7 +59,7 @@ character which means "any host" when the word is added to the auth component line in your PAM file for the particular service .RB "(e.g., " rlogin ). -.SH "SEE ALSO" +.SH SEE ALSO .BR rhosts (5), .BR rlogind (8), .BR rshd (8) diff --git a/man5/intro.5 b/man5/intro.5 index fe0cd73e4..8c79261d4 100644 --- a/man5/intro.5 +++ b/man5/intro.5 @@ -34,5 +34,5 @@ and the corresponding C structures, if any. Look at the header of the manual page source for the author(s) and copyright conditions. Note that these can be different from page to page! -.SH "SEE ALSO" +.SH SEE ALSO .BR standards (7) diff --git a/man5/issue.5 b/man5/issue.5 index d890a70fe..d1baca405 100644 --- a/man5/issue.5 +++ b/man5/issue.5 @@ -35,7 +35,7 @@ sequences, if supported by the program employed on the system. .SH FILES /etc/issue -.SH "SEE ALSO" +.SH SEE ALSO .BR motd (5), .BR agetty (8), .BR mingetty (8) diff --git a/man5/locale.5 b/man5/locale.5 index a26e13414..48e1172a1 100644 --- a/man5/locale.5 +++ b/man5/locale.5 @@ -603,13 +603,13 @@ See the POSIX.2 standard for details. \(em database for the current locale setting of that category .br /usr/lib/nls/charmap/* \(em charmap-files -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.2, ISO/IEC 14652. .SH BUGS This manual page isn't complete. .\" .SH AUTHOR .\" Jochen Hein (Hein@Student.TU-Clausthal.de) -.SH "SEE ALSO" +.SH SEE ALSO .BR locale (1), .BR localedef (1), .BR localeconv (3), diff --git a/man5/motd.5 b/man5/motd.5 index cef58771d..22434a5f3 100644 --- a/man5/motd.5 +++ b/man5/motd.5 @@ -36,6 +36,6 @@ has been traditionally used for exactly that (it requires much less disk space than mail to all users). .SH FILES /etc/motd -.SH "SEE ALSO" +.SH SEE ALSO .BR login (1), .BR issue (5) diff --git a/man5/networks.5 b/man5/networks.5 index 6a1914c7a..2b3776e56 100644 --- a/man5/networks.5 +++ b/man5/networks.5 @@ -69,7 +69,7 @@ Only Class A, B or C networks are supported, partitioned networks .TP .I /etc/networks The networks definition file. -.SH "SEE ALSO" +.SH SEE ALSO .BR getnetbyaddr (3), .BR getnetbyname (3), .BR getnetent (3), diff --git a/man5/nologin.5 b/man5/nologin.5 index da55e21f2..82761849e 100644 --- a/man5/nologin.5 +++ b/man5/nologin.5 @@ -34,6 +34,6 @@ Other users will be shown the contents of this file and their logins will be refused. .SH FILES /etc/nologin -.SH "SEE ALSO" +.SH SEE ALSO .BR login (1), .BR shutdown (8) diff --git a/man5/nscd.conf.5 b/man5/nscd.conf.5 index 347d82b43..863ab69af 100644 --- a/man5/nscd.conf.5 +++ b/man5/nscd.conf.5 @@ -230,7 +230,7 @@ This option is valid only for services and .IR group . .RE -.SH "SEE ALSO" +.SH SEE ALSO .BR nscd (8) .\" .SH AUTHOR .\" .B nscd diff --git a/man5/passwd.5 b/man5/passwd.5 index 373912930..8a32b6f1f 100644 --- a/man5/passwd.5 +++ b/man5/passwd.5 @@ -158,7 +158,7 @@ or mail filters, etc. Trying to lock an account by simply changing the shell field yields the same result and additionally allows the use of .BR su (1). -.SH "SEE ALSO" +.SH SEE ALSO .BR login (1), .BR passwd (1), .BR su (1), diff --git a/man5/proc.5 b/man5/proc.5 index 30ca3a94f..91a5a1cbd 100644 --- a/man5/proc.5 +++ b/man5/proc.5 @@ -3254,7 +3254,7 @@ of thing that needs to be updated very often. .\" .SH ACKNOWLEDGEMENTS .\" The material on /proc/sys/fs and /proc/sys/kernel is closely based on .\" kernel source documentation files written by Rik van Riel. -.SH "SEE ALSO" +.SH SEE ALSO .BR cat (1), .BR dmesg (1), .BR find (1), diff --git a/man5/protocols.5 b/man5/protocols.5 index 708caf747..5d50fb304 100644 --- a/man5/protocols.5 +++ b/man5/protocols.5 @@ -77,7 +77,7 @@ naming service like Yellow Pages/NIS or BIND/Hesiod. .TP .I /etc/protocols The protocols definition file. -.SH "SEE ALSO" +.SH SEE ALSO .BR getprotoent (3) .UR http://www.iana.org\:/assignments\:/protocol-numbers diff --git a/man5/resolv.conf.5 b/man5/resolv.conf.5 index ec9624875..a7b45ac73 100644 --- a/man5/resolv.conf.5 +++ b/man5/resolv.conf.5 @@ -279,7 +279,7 @@ in the first column are treated as comments. .SH FILES .IR /etc/resolv.conf , .I -.SH "SEE ALSO" +.SH SEE ALSO .BR gethostbyname (3), .BR resolver (3), .BR hostname (7), diff --git a/man5/rpc.5 b/man5/rpc.5 index f97b67722..f19b4462f 100644 --- a/man5/rpc.5 +++ b/man5/rpc.5 @@ -72,5 +72,5 @@ nsemntd 100039 .TP .I /etc/rpc RPC program number data base -.SH "SEE ALSO" +.SH SEE ALSO .BR getrpcent (3) diff --git a/man5/securetty.5 b/man5/securetty.5 index 29a53116e..be37ccf3a 100644 --- a/man5/securetty.5 +++ b/man5/securetty.5 @@ -39,6 +39,6 @@ See if you use the shadow suite. .SH FILES .I /etc/securetty -.SH "SEE ALSO" +.SH SEE ALSO .BR login (1), .BR login.defs (5) diff --git a/man5/services.5 b/man5/services.5 index 468d53299..fc0bfda1c 100644 --- a/man5/services.5 +++ b/man5/services.5 @@ -206,7 +206,7 @@ Definition of .\" and .\" .BR getservbyport (3). .\" However, this will also cause the next line to be mis-parsed. -.SH "SEE ALSO" +.SH SEE ALSO .BR listen (2), .BR endservent (3), .BR getservbyname (3), diff --git a/man5/shells.5 b/man5/shells.5 index d40bcdd04..ce9af9aab 100644 --- a/man5/shells.5 +++ b/man5/shells.5 @@ -52,6 +52,6 @@ may contain the following paths: .br .I /bin/csh .RE -.SH "SEE ALSO" +.SH SEE ALSO .BR chsh (1), .BR getusershell (3) diff --git a/man5/termcap.5 b/man5/termcap.5 index 822014ab9..82a5027de 100644 --- a/man5/termcap.5 +++ b/man5/termcap.5 @@ -466,7 +466,7 @@ x vertical line (|) .sp The values in parentheses are suggested defaults which are used by curses, if the capabilities are missing. -.SH "SEE ALSO" +.SH SEE ALSO .BR ncurses (3), .BR termcap (3), .BR terminfo (5) diff --git a/man5/ttytype.5 b/man5/ttytype.5 index 7251040df..f4fd8184a 100644 --- a/man5/ttytype.5 +++ b/man5/ttytype.5 @@ -63,7 +63,7 @@ con80x25 tty1 .br vt320 ttys0 .RE -.SH "SEE ALSO" +.SH SEE ALSO .BR termcap (5), .BR terminfo (5), .BR agetty (8), diff --git a/man5/utmp.5 b/man5/utmp.5 index 94a764764..af00dc4c3 100644 --- a/man5/utmp.5 +++ b/man5/utmp.5 @@ -224,7 +224,7 @@ removed, record-keeping is turned off. /var/run/utmp .br /var/log/wtmp -.SH "CONFORMING TO" +.SH CONFORMING TO .PP POSIX.1 does not specify a .I utmp @@ -334,7 +334,7 @@ binaries using the old libc5 struct will corrupt .IR /var/run/utmp " and/or " /var/log/wtmp . .SH BUGS This man page is based on the libc5 one, things may work differently now. -.SH "SEE ALSO" +.SH SEE ALSO .BR ac (1), .BR date (1), .BR last (1), diff --git a/man7/armscii-8.7 b/man7/armscii-8.7 index a3218b1ec..8ec5abafb 100644 --- a/man7/armscii-8.7 +++ b/man7/armscii-8.7 @@ -136,6 +136,6 @@ _ 375 253 FD ý ARMENIAN SMALL LETTER FEH 376 254 FE þ ARMENIAN APOSTROPHE .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/arp.7 b/man7/arp.7 index fd0e1d5cd..ce50cdf3d 100644 --- a/man7/arp.7 +++ b/man7/arp.7 @@ -295,7 +295,7 @@ The same problem applies for some kernel protocols (e.g., NFS over UDP). This man page mashes IPv4 specific and shared between IPv4 and IPv6 functionality together. -.SH "SEE ALSO" +.SH SEE ALSO .BR capabilities (7), .BR ip (7) .PP diff --git a/man7/ascii.7 b/man7/ascii.7 index c9d82450a..b38fe0d53 100644 --- a/man7/ascii.7 +++ b/man7/ascii.7 @@ -181,7 +181,7 @@ Standards Institute (USASI) in 1968. .\" American National Standards Institute (ANSI) in 1969 and is the .\" U.S. member body of ISO; private and nonprofit. .\" -.SH "SEE ALSO" +.SH SEE ALSO .ad l .BR iso_8859-1 (7), .BR iso_8859-10 (7), diff --git a/man7/bootparam.7 b/man7/bootparam.7 index f7b8002e7..d59e1618f 100644 --- a/man7/bootparam.7 +++ b/man7/bootparam.7 @@ -1293,7 +1293,7 @@ It is required by certain Braille machines. .\" .SH AUTHORS .\" Linus Torvalds (and many others) -.SH "SEE ALSO" +.SH SEE ALSO .BR lilo.conf (5), .BR klogd (8), .BR lilo (8), diff --git a/man7/capabilities.7 b/man7/capabilities.7 index c9a2d91c9..f653b2db7 100644 --- a/man7/capabilities.7 +++ b/man7/capabilities.7 @@ -1018,7 +1018,7 @@ prctl(PR_SET_SECUREBITS, SECBIT_NOROOT_LOCKED); .fi .in -.SH "CONFORMING TO" +.SH CONFORMING TO .PP No standards govern capabilities, but the Linux capability implementation is based on the withdrawn POSIX.1e draft standard; see @@ -1073,7 +1073,7 @@ If file capabilities are disabled in the current implementation, then starts out with this capability removed from its per-process bounding set, and that bounding set is inherited by all other processes created on the system. -.SH "SEE ALSO" +.SH SEE ALSO .BR capget (2), .BR prctl (2), .BR setfsuid (2), diff --git a/man7/charsets.7 b/man7/charsets.7 index 8703cad76..6181d4250 100644 --- a/man7/charsets.7 +++ b/man7/charsets.7 @@ -354,7 +354,7 @@ can only be invoked for codes with the high order bit set. In particular, \fB^N\fP and \fB^O\fP are not used anymore, ESC ( xx can be used only with xx=B, and ESC ) xx, ESC * xx, ESC + xx are equivalent to ESC \- xx, ESC . xx, ESC / xx, respectively. -.SH "SEE ALSO" +.SH SEE ALSO .BR console (4), .BR console_codes (4), .BR console_ioctl (4), diff --git a/man7/complex.7 b/man7/complex.7 index 2ae32d746..d59356a04 100644 --- a/man7/complex.7 +++ b/man7/complex.7 @@ -49,7 +49,7 @@ main(void) printf("%f + %f * i\\n", creal(z), cimag(z)); } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR cabs (3), .BR cacos (3), .BR cacosh (3), diff --git a/man7/cp1251.7 b/man7/cp1251.7 index 2f4aea6a3..edb097c9d 100644 --- a/man7/cp1251.7 +++ b/man7/cp1251.7 @@ -171,5 +171,5 @@ _ .TE .SH NOTES CP\ 1251 is also known as Windows Cyrillic. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/credentials.7 b/man7/credentials.7 index de99ca8bb..3b1e089d7 100644 --- a/man7/credentials.7 +++ b/man7/credentials.7 @@ -229,7 +229,7 @@ when checking resource limits; see when checking the limit on the number of inotify instances that the process may create; see .BR inotify (7). -.SH "CONFORMING TO" +.SH CONFORMING TO Process IDs, parent process IDs, process group IDs, and session IDs are specified in POSIX.1-2001. The real, effective, and saved set user and groups IDs, @@ -246,7 +246,7 @@ that any change to user or group credentials .BR setuid (2), .BR setresuid (2)) is carried through to all of the POSIX threads in a process. -.SH "SEE ALSO" +.SH SEE ALSO .BR bash (1), .BR csh (1), .BR ps (1), diff --git a/man7/ddp.7 b/man7/ddp.7 index 167f8627b..1ab673f56 100644 --- a/man7/ddp.7 +++ b/man7/ddp.7 @@ -241,7 +241,7 @@ There are too many inconsistent error values. .PP The ioctls used to configure routing tables, devices, AARP tables and other devices are not yet described. -.SH "SEE ALSO" +.SH SEE ALSO .BR recvmsg (2), .BR sendmsg (2), .BR capabilities (7), diff --git a/man7/environ.7 b/man7/environ.7 index 21c0197df..9c8694d41 100644 --- a/man7/environ.7 +++ b/man7/environ.7 @@ -223,7 +223,7 @@ The authors of .I gzip should consider renaming their option to .BR GZIP_OPT . -.SH "SEE ALSO" +.SH SEE ALSO .BR bash (1), .BR csh (1), .BR login (1), diff --git a/man7/epoll.7 b/man7/epoll.7 index 74bf65bd1..0abe25e5a 100644 --- a/man7/epoll.7 +++ b/man7/epoll.7 @@ -543,7 +543,7 @@ mechanisms, for example, FreeBSD has .IR kqueue , and Solaris has .IR /dev/poll . -.SH "SEE ALSO" +.SH SEE ALSO .BR epoll_create (2), .BR epoll_create1 (2), .BR epoll_ctl (2), diff --git a/man7/fifo.7 b/man7/fifo.7 index e28d0c221..ed251eed2 100644 --- a/man7/fifo.7 +++ b/man7/fifo.7 @@ -59,7 +59,7 @@ FIFO special files can be created by and are indicated by .IR "ls \-l" with the file type \(aqp\(aq. -.SH "SEE ALSO" +.SH SEE ALSO .BR mkfifo (1), .BR open (2), .BR pipe (2), diff --git a/man7/futex.7 b/man7/futex.7 index 98953572f..c6900d001 100644 --- a/man7/futex.7 +++ b/man7/futex.7 @@ -86,12 +86,12 @@ to for more details. The same holds for asynchronous futex waiting. -.SH "VERSIONS" +.SH VERSIONS .PP Initial futex support was merged in Linux 2.5.7 but with different semantics from those described above. Current semantics are available from Linux 2.5.40 onward. -.SH "NOTES" +.SH NOTES .PP To reiterate, bare futexes are not intended as an easy to use abstraction for end-users. @@ -109,7 +109,7 @@ primitives: it is by no means the only one. .\" Matthew Kirkwood, Ingo Molnar (Red Hat) and .\" Rusty Russell (IBM Linux Technology Center). .\" This page written by bert hubert. -.SH "SEE ALSO" +.SH SEE ALSO .BR futex (2) .IR "Fuss, Futexes and Furwocks: Fast Userlevel Locking in Linux" diff --git a/man7/glob.7 b/man7/glob.7 index 2687c502f..104156653 100644 --- a/man7/glob.7 +++ b/man7/glob.7 @@ -204,7 +204,7 @@ current locale. For example, "\fI[[=a=]]\fP" might be equivalent to "\fI[a\('a\(`a\(:a\(^a]\fP", that is, to "\fI[a[.a-acute.][.a-grave.][.a-umlaut.][.a-circumflex.]]\fP". -.SH "SEE ALSO" +.SH SEE ALSO .BR sh (1), .BR fnmatch (3), .BR glob (3), diff --git a/man7/hier.7 b/man7/hier.7 index 43c7564d9..90b51c651 100644 --- a/man7/hier.7 +++ b/man7/hier.7 @@ -489,14 +489,14 @@ this directory holds temporary files stored for an unspecified duration. .TP .I /var/yp Database files for NIS. -.SH "CONFORMING TO" +.SH CONFORMING TO The Filesystem Hierarchy Standard, Version 2.2 .UR http://www.pathname.com\:/fhs/ .UE . .SH BUGS This list is not exhaustive; different systems may be configured differently. -.SH "SEE ALSO" +.SH SEE ALSO .BR find (1), .BR ln (1), .BR proc (5), diff --git a/man7/icmp.7 b/man7/icmp.7 index fe26e381e..8742b9b4b 100644 --- a/man7/icmp.7 +++ b/man7/icmp.7 @@ -182,7 +182,7 @@ Linux ICMP internally uses a raw socket to send ICMPs. This raw socket may appear in .BR netstat (8) output with a zero inode. -.SH "SEE ALSO" +.SH SEE ALSO .BR ip (7) .PP RFC\ 792 for a description of the ICMP protocol. diff --git a/man7/inotify.7 b/man7/inotify.7 index b44b04bd9..6b4e1aed4 100644 --- a/man7/inotify.7 +++ b/man7/inotify.7 @@ -333,7 +333,7 @@ that can be created per real user ID. .I /proc/sys/fs/inotify/max_user_watches This specifies an upper limit on the number of watches that can be created per real user ID. -.SH "VERSIONS" +.SH VERSIONS Inotify was merged into the 2.6.13 Linux kernel. The required library interfaces were added to glibc in version 2.4. .RB ( IN_DONT_FOLLOW , @@ -341,9 +341,9 @@ The required library interfaces were added to glibc in version 2.4. and .B IN_ONLYDIR were only added in version 2.5.) -.SH "CONFORMING TO" +.SH CONFORMING TO The inotify API is Linux-specific. -.SH "NOTES" +.SH NOTES Inotify file descriptors can be monitored using .BR select (2), .BR poll (2), @@ -425,7 +425,7 @@ be aware that by the time you create a watch for the new subdirectory, new files may already have been created in the subdirectory. Therefore, you may want to scan the contents of the subdirectory immediately after adding the watch. -.SH "BUGS" +.SH BUGS In kernels before 2.6.16, the .B IN_ONESHOT .I mask @@ -438,7 +438,7 @@ if the older had not yet been read) instead checked if the most recent event could be coalesced with the .I oldest unread event. -.SH "SEE ALSO" +.SH SEE ALSO .BR inotify_add_watch (2), .BR inotify_init (2), .BR inotify_init1 (2), diff --git a/man7/intro.7 b/man7/intro.7 index 925ef2a7e..0baf0bbdd 100644 --- a/man7/intro.7 +++ b/man7/intro.7 @@ -37,5 +37,5 @@ and miscellaneous other things. Look at the header of the manual page source for the author(s) and copyright conditions. Note that these can be different from page to page! -.SH "SEE ALSO" +.SH SEE ALSO .BR standards (7) diff --git a/man7/ip.7 b/man7/ip.7 index 360f945be..947d70e79 100644 --- a/man7/ip.7 +++ b/man7/ip.7 @@ -1217,7 +1217,7 @@ by does not work in some 2.2 kernels. .\" .SH AUTHORS .\" This man page was written by Andi Kleen. -.SH "SEE ALSO" +.SH SEE ALSO .BR recvmsg (2), .BR sendmsg (2), .BR byteorder (3), diff --git a/man7/ipv6.7 b/man7/ipv6.7 index e588276d1..1c8699abf 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -384,7 +384,7 @@ It is transparently passed/read by the kernel when the passed address length contains it. Some programs that pass a longer address buffer and then check the outgoing address length may break. -.SH "NOTES" +.SH NOTES The .I sockaddr_in6 structure is bigger than the generic @@ -405,7 +405,7 @@ IPSec support for EH and AH headers is missing. Flow label management is not complete and not documented here. .PP This man page is not complete. -.SH "SEE ALSO" +.SH SEE ALSO .BR cmsg (3), .BR ip (7) .PP diff --git a/man7/iso_8859-1.7 b/man7/iso_8859-1.7 index 8c5cdc90d..33b183f9c 100644 --- a/man7/iso_8859-1.7 +++ b/man7/iso_8859-1.7 @@ -177,6 +177,6 @@ See (soft hyphen) and the standard ISO 8859-1 ("shy", paragraph 6.3.3) or the equivalent version from your national standardization body. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7), .BR iso_8859-15 (7) diff --git a/man7/iso_8859-10.7 b/man7/iso_8859-10.7 index 092497293..eedfd9b27 100644 --- a/man7/iso_8859-10.7 +++ b/man7/iso_8859-10.7 @@ -162,5 +162,5 @@ _ .TE .SH NOTES ISO 8859-10 is also known as Latin-6. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-11.7 b/man7/iso_8859-11.7 index 53ce57d66..3480d6bce 100644 --- a/man7/iso_8859-11.7 +++ b/man7/iso_8859-11.7 @@ -156,5 +156,5 @@ ISO 8859-11 is the same as TIS (Thai Industrial Standard) 620-2253, commonly known as TIS-620, except for the character in position a0: ISO 8859-11 defines this as "nonbreaking space", while TIS 620 leaves it undefined. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-13.7 b/man7/iso_8859-13.7 index e01f6b233..6a6893943 100644 --- a/man7/iso_8859-13.7 +++ b/man7/iso_8859-13.7 @@ -160,5 +160,5 @@ _ .TE .SH NOTES ISO 8859-13 is also known as Latin-7. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-14.7 b/man7/iso_8859-14.7 index 74c6739b7..9500baa60 100644 --- a/man7/iso_8859-14.7 +++ b/man7/iso_8859-14.7 @@ -158,5 +158,5 @@ _ .TE .SH NOTES ISO 8859-14 is also known as Latin-8. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-15.7 b/man7/iso_8859-15.7 index a5d89e41e..21f6d6655 100644 --- a/man7/iso_8859-15.7 +++ b/man7/iso_8859-15.7 @@ -171,6 +171,6 @@ _ 376 254 FE þ LATIN SMALL LETTER THORN 377 255 FF ÿ LATIN SMALL LETTER Y WITH DIAERESIS .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7), .BR iso_8859-1 (7) diff --git a/man7/iso_8859-16.7 b/man7/iso_8859-16.7 index d9fb0df19..af21cfcdc 100644 --- a/man7/iso_8859-16.7 +++ b/man7/iso_8859-16.7 @@ -167,7 +167,7 @@ _ 376 254 FE þ LATIN SMALL LETTER T WITH COMMA BELOW 377 255 FF ÿ LATIN SMALL LETTER Y WITH DIAERESIS .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7), .BR iso_8859-1 (7), .BR iso_8859-15 (7), diff --git a/man7/iso_8859-2.7 b/man7/iso_8859-2.7 index 4ec4cf065..5086aa328 100644 --- a/man7/iso_8859-2.7 +++ b/man7/iso_8859-2.7 @@ -170,7 +170,7 @@ _ 376 254 FE þ LATIN SMALL LETTER T WITH CEDILLA 377 255 FF ÿ DOT ABOVE .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7), .BR iso_8859-1 (7), .BR iso_8859-16 (7) diff --git a/man7/iso_8859-3.7 b/man7/iso_8859-3.7 index 564a3c5d6..38b68472c 100644 --- a/man7/iso_8859-3.7 +++ b/man7/iso_8859-3.7 @@ -154,5 +154,5 @@ _ .TE .SH NOTES ISO 8859-3 is also known as Latin-3. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-4.7 b/man7/iso_8859-4.7 index 842330399..a235a16f4 100644 --- a/man7/iso_8859-4.7 +++ b/man7/iso_8859-4.7 @@ -157,5 +157,5 @@ _ 376 254 FE þ LATIN SMALL LETTER U WITH MACRON 377 255 FF ÿ DOT ABOVE (Mandarin Chinese light tone) .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-5.7 b/man7/iso_8859-5.7 index cbc5ad388..ec9b67192 100644 --- a/man7/iso_8859-5.7 +++ b/man7/iso_8859-5.7 @@ -156,6 +156,6 @@ _ 376 254 FE þ CYRILLIC SMALL LETTER SHORT U (Byelorussian) 377 255 FF ÿ CYRILLIC SMALL LETTER DZHE .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7), .BR koi8-r (7) diff --git a/man7/iso_8859-6.7 b/man7/iso_8859-6.7 index 4006bd5f5..26fb6e6eb 100644 --- a/man7/iso_8859-6.7 +++ b/man7/iso_8859-6.7 @@ -114,5 +114,5 @@ _ .SH NOTES ISO 8859-6 lacks the glyphs required for many related languages, such as Urdu and Persian (Farsi). -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-7.7 b/man7/iso_8859-7.7 index bf5fcc278..1bcb9dc53 100644 --- a/man7/iso_8859-7.7 +++ b/man7/iso_8859-7.7 @@ -157,5 +157,5 @@ _ .TE .SH NOTES ISO 8859-7 was formerly known as ELOT-928 or ECMA-118:1986. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-8.7 b/man7/iso_8859-8.7 index 45677fcf7..08f461b19 100644 --- a/man7/iso_8859-8.7 +++ b/man7/iso_8859-8.7 @@ -128,5 +128,5 @@ _ .TE .SH NOTES ISO 8859-8 was also known as ISO-IR-138. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/iso_8859-9.7 b/man7/iso_8859-9.7 index c093d79e0..14eb0b854 100644 --- a/man7/iso_8859-9.7 +++ b/man7/iso_8859-9.7 @@ -158,5 +158,5 @@ _ 376 254 FE þ LATIN SMALL LETTER S WITH CEDILLA 377 255 FF ÿ LATIN SMALL LETTER Y WITH DIAERESIS .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7) diff --git a/man7/koi8-r.7 b/man7/koi8-r.7 index 76b6ef388..ac300d3ca 100644 --- a/man7/koi8-r.7 +++ b/man7/koi8-r.7 @@ -187,7 +187,7 @@ _ 377 255 FF ÿ CYRILLIC CAPITAL LETTER HARD SIGN .TE -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7), .BR iso-8859-5 (7), .BR koi8-u (7) diff --git a/man7/koi8-u.7 b/man7/koi8-u.7 index 9aa21a2ae..e4a939ddc 100644 --- a/man7/koi8-u.7 +++ b/man7/koi8-u.7 @@ -178,6 +178,6 @@ _ .SH NOTES The differences from KOI8-R are in the hex positions A4, A6, A7, AD, B4, B6, B7, and BD. -.SH "SEE ALSO" +.SH SEE ALSO .BR ascii (7), .BR koi8-r (7) diff --git a/man7/locale.7 b/man7/locale.7 index a0a4248c0..14461daa0 100644 --- a/man7/locale.7 +++ b/man7/locale.7 @@ -203,11 +203,11 @@ struct lconv { }; .fi .in -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. The GNU gettext functions are specified in LI18NUX2000. -.SH "SEE ALSO" +.SH SEE ALSO .BR locale (1), .BR localedef (1), .BR gettext (3), diff --git a/man7/mailaddr.7 b/man7/mailaddr.7 index f8eb85701..bd7acb58e 100644 --- a/man7/mailaddr.7 +++ b/man7/mailaddr.7 @@ -113,7 +113,7 @@ The "postmaster" address is not case sensitive. .I /etc/aliases .br .I ~/.forward -.SH "SEE ALSO" +.SH SEE ALSO .BR binmail (1), .BR mail (1), .BR mconnect (1), diff --git a/man7/man.7 b/man7/man.7 index 08f87a18b..eb3c318b6 100644 --- a/man7/man.7 +++ b/man7/man.7 @@ -554,7 +554,7 @@ is not implemented. .\" .IP \(em .\" David A. Wheeler (dwheeler@ida.org) heavily modified this .\" manual page, such as adding detailed information on sections and macros. -.SH "SEE ALSO" +.SH SEE ALSO .BR apropos (1), .BR groff (1), .BR lexgrog (1), diff --git a/man7/mq_overview.7 b/man7/mq_overview.7 index 21130542f..223a1f646 100644 --- a/man7/mq_overview.7 +++ b/man7/mq_overview.7 @@ -260,7 +260,7 @@ and can be monitored using or .BR epoll (7). This is not portable. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES System V message queues @@ -278,7 +278,7 @@ lists (ACLs) for POSIX message queues. .SH EXAMPLE An example of the use of various message queue functions is shown in .BR mq_notify (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR getrlimit (2), .BR mq_getsetattr (2), .BR poll (2), diff --git a/man7/netdevice.7 b/man7/netdevice.7 index 12cb202a5..8a3a21fe4 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -337,7 +337,7 @@ Add the following to your program as a workaround: #endif .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR proc (5), .BR capabilities (7), .BR ip (7), diff --git a/man7/netlink.7 b/man7/netlink.7 index bcf67480b..abf4a31dd 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -461,7 +461,7 @@ for (nh = (struct nlmsghdr *) buf; NLMSG_OK (nh, len); } .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR cmsg (3), .BR netlink (3), .BR capabilities (7), diff --git a/man7/numa.7 b/man7/numa.7 index 4339a454b..f5ab2a6d5 100644 --- a/man7/numa.7 +++ b/man7/numa.7 @@ -143,7 +143,7 @@ removed from memory by the swapper soon. .TP .I writeback= Number of pages that are currently being written out to disk. -.SH "CONFORMING TO" +.SH CONFORMING TO No standards govern NUMA interfaces. .SH NOTES The Linux NUMA system calls and @@ -178,7 +178,7 @@ Some distributions include the development library and header in the separate .I numactl-devel package. -.SH "SEE ALSO" +.SH SEE ALSO .BR get_mempolicy (2), .BR mbind (2), .BR move_pages (2), diff --git a/man7/packet.7 b/man7/packet.7 index c016f9fb9..776882808 100644 --- a/man7/packet.7 +++ b/man7/packet.7 @@ -386,7 +386,7 @@ packets via .\" This man page was written by Andi Kleen with help from Matthew Wilcox. .\" AF_PACKET in Linux 2.2 was implemented .\" by Alexey Kuznetsov, based on code by Alan Cox and others. -.SH "SEE ALSO" +.SH SEE ALSO .BR socket (2), .BR pcap (3), .BR capabilities (7), diff --git a/man7/path_resolution.7 b/man7/path_resolution.7 index 0619e2cdb..2b67ef6fd 100644 --- a/man7/path_resolution.7 +++ b/man7/path_resolution.7 @@ -226,7 +226,7 @@ The \fBCAP_DAC_READ_SEARCH\fP capability grants read and search permission on directories, and read permission on ordinary files. .\" FIXME say something about immutable files .\" FIXME say something about ACLs -.SH "SEE ALSO" +.SH SEE ALSO .BR readlink (2), .BR capabilities (7), .BR credentials (7), diff --git a/man7/pipe.7 b/man7/pipe.7 index 29c773152..f8314e1dd 100644 --- a/man7/pipe.7 +++ b/man7/pipe.7 @@ -229,7 +229,7 @@ data can be transmitted in both directions between the pipe ends. According to POSIX.1-2001, pipes only need to be unidirectional. Portable applications should avoid reliance on bidirectional pipe semantics. -.SH "SEE ALSO" +.SH SEE ALSO .BR dup (2), .BR fcntl (2), .BR open (2), diff --git a/man7/posixoptions.7 b/man7/posixoptions.7 index 8ed53de99..5777ea39e 100644 --- a/man7/posixoptions.7 +++ b/man7/posixoptions.7 @@ -843,13 +843,13 @@ The following functions are present: Always present (probably 0). Value to set a changeable special control character to indicate that it is disabled. -.SH "XOPEN EXTENSIONS" +.SH XOPEN EXTENSIONS .BR _XOPEN_CRYPT , .BR _XOPEN_LEGACY , .BR _XOPEN_REALTIME , .BR _XOPEN_REALTIME_THREADS , .BR _XOPEN_UNIX . .\" To be described. -.SH "SEE ALSO" +.SH SEE ALSO .BR sysconf (3), .BR standards (7) diff --git a/man7/pthreads.7 b/man7/pthreads.7 index a470fdce6..acac44a0e 100644 --- a/man7/pthreads.7 +++ b/man7/pthreads.7 @@ -890,7 +890,7 @@ bash$ $( LD_ASSUME_KERNEL=2.2.5 ldd /bin/ls | grep libc.so | \\ linuxthreads-0.10 by Xavier Leroy .in .fi -.SH "SEE ALSO" +.SH SEE ALSO .ad l .nh .BR clone (2), diff --git a/man7/pty.7 b/man7/pty.7 index 2860b3068..d6dfc0538 100644 --- a/man7/pty.7 +++ b/man7/pty.7 @@ -121,7 +121,7 @@ A process finds an unused pseudoterminal pair by trying to each pseudoterminal master until an open succeeds. The corresponding pseudoterminal slave (substitute "tty" for "pty" in the name of the master) can then be opened. -.SH "FILES" +.SH FILES .I /dev/ptmx (UNIX 98 master clone device) .br @@ -133,7 +133,7 @@ for "pty" in the name of the master) can then be opened. .br .I /dev/tty[p-za-e][0-9a-f] (BSD slave devices) -.SH "NOTES" +.SH NOTES A description of the .B TIOCPKT .BR ioctl (2), @@ -149,7 +149,7 @@ operations and .BR TIOCREMOTE have not been implemented under Linux. -.SH "SEE ALSO" +.SH SEE ALSO .BR select (2), .BR setsid (2), .BR forkpty (3), diff --git a/man7/raw.7 b/man7/raw.7 index 220614da1..6dfb3811e 100644 --- a/man7/raw.7 +++ b/man7/raw.7 @@ -262,7 +262,7 @@ was specified in the initial call is always used. .\" .SH AUTHORS .\" This man page was written by Andi Kleen. -.SH "SEE ALSO" +.SH SEE ALSO .BR recvmsg (2), .BR sendmsg (2), .BR capabilities (7), diff --git a/man7/regex.7 b/man7/regex.7 index c9355717c..58749baec 100644 --- a/man7/regex.7 +++ b/man7/regex.7 @@ -281,7 +281,7 @@ is current consensus among implementors as to the right interpretation. .\" Sigh... The page license means we must have the author's name .\" in the formatted output. This page was taken from Henry Spencer's regex package. -.SH "SEE ALSO" +.SH SEE ALSO .BR grep (1), .BR regex (3) .PP diff --git a/man7/rtld-audit.7 b/man7/rtld-audit.7 index 498af1c0d..e67fdd786 100644 --- a/man7/rtld-audit.7 +++ b/man7/rtld-audit.7 @@ -456,7 +456,7 @@ is ignored. .\" symbol binding should return the value of the 'retval' argument .\" (not provided by GNU, but equivalent to returning outregs->lrv_eax .\" on (say) x86-32). -.SH "CONFORMING TO" +.SH CONFORMING TO This API is nonstandard, but very similar to the Solaris API, described in the Solaris .IR "Linker and Libraries Guide" , @@ -597,7 +597,7 @@ la_i86_gnu_pltenter(Elf32_Sym *sym, unsigned int ndx, return sym\->st_value; } .fi -.SH "SEE ALSO" +.SH SEE ALSO .BR ldd (1), .BR dlopen (3), .BR ld.so (8), diff --git a/man7/rtnetlink.7 b/man7/rtnetlink.7 index 3f22f5290..5ea3f1f3d 100644 --- a/man7/rtnetlink.7 +++ b/man7/rtnetlink.7 @@ -459,7 +459,7 @@ as described above. is a new feature of Linux 2.2. .SH BUGS This manual page is incomplete. -.SH "SEE ALSO" +.SH SEE ALSO .BR cmsg (3), .BR rtnetlink (3), .BR ip (7), diff --git a/man7/sem_overview.7 b/man7/sem_overview.7 index 42a9483ba..6728412d6 100644 --- a/man7/sem_overview.7 +++ b/man7/sem_overview.7 @@ -135,7 +135,7 @@ characters.) Since Linux 2.6.19, ACLs can be placed on files under this directory, to control object permissions on a per-user and per-group basis. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES System V semaphores @@ -149,7 +149,7 @@ on the other hand POSIX semaphores are less widely available .SH EXAMPLE An example of the use of various POSIX semaphore functions is shown in .BR sem_wait (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR sem_close (3), .BR sem_destroy (3), .BR sem_getvalue (3), diff --git a/man7/shm_overview.7 b/man7/shm_overview.7 index 10c4c0064..d9e2db029 100644 --- a/man7/shm_overview.7 +++ b/man7/shm_overview.7 @@ -98,7 +98,7 @@ virtual file system, normally mounted under .IR /dev/shm . Since kernel 2.6.19, Linux supports the use of access control lists (ACLs) to control the permissions of objects in the virtual file system. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1-2001. .SH NOTES Typically, processes must synchronize their access to a shared @@ -111,7 +111,7 @@ etc.) is an older shared memory API. POSIX shared memory provides a simpler, and better designed interface; on the other hand POSIX shared memory is somewhat less widely available (especially on older systems) than System V shared memory. -.SH "SEE ALSO" +.SH SEE ALSO .BR fchmod (2), .BR fchown (2), .BR fstat (2), diff --git a/man7/sigevent.7 b/man7/sigevent.7 index 4d301c1c2..5d11d3cea 100644 --- a/man7/sigevent.7 +++ b/man7/sigevent.7 @@ -127,7 +127,7 @@ Currently used only by POSIX timers; see .BR timer_create (2). .SH CONFORMING TO POSIX.1-2001. -.SH "SEE ALSO" +.SH SEE ALSO .BR timer_create (2), .BR aio_fsync (3), .BR aio_read (3), diff --git a/man7/signal.7 b/man7/signal.7 index 5fea00152..612daa780 100644 --- a/man7/signal.7 +++ b/man7/signal.7 @@ -833,7 +833,7 @@ Linux 2.6.8 and earlier: Linux 2.4 and earlier: .BR nanosleep (2). .RE -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.1, except as noted. .\" It must be a *very* long time since this was true: .\" .SH BUGS @@ -845,7 +845,7 @@ POSIX.1, except as noted. .\" the build process of some software still thinks that .\" signal 29 is .\" .BR SIGLOST . -.SH "SEE ALSO" +.SH SEE ALSO .BR kill (1), .BR getrlimit (2), .BR kill (2), diff --git a/man7/socket.7 b/man7/socket.7 index 8b2931d9c..bc8a8f4de 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -825,7 +825,7 @@ The suggested interface to use them is via the libpcap library. .\" .SH AUTHORS .\" This man page was written by Andi Kleen. -.SH "SEE ALSO" +.SH SEE ALSO .BR getsockopt (2), .BR connect (2), .BR setsockopt (2), diff --git a/man7/standards.7 b/man7/standards.7 index e1dcb882b..8d62f6e88 100644 --- a/man7/standards.7 +++ b/man7/standards.7 @@ -257,7 +257,7 @@ conforms to POSIX.1-2008, unless otherwise noted. Further information can be found on the Austin group web site, .UR http://www.opengroup.org\:/austin/ .UE . -.SH "SEE ALSO" +.SH SEE ALSO .BR feature_test_macros (7), .BR libc (7), .BR posixoptions (7) diff --git a/man7/suffixes.7 b/man7/suffixes.7 index 601e1d1f2..031b3c80a 100644 --- a/man7/suffixes.7 +++ b/man7/suffixes.7 @@ -272,10 +272,10 @@ Suffix File type ~ Emacs or \fBpatch\fP(1) backup file rc startup (`run control') file, e.g., \fI.newsrc\fP .TE -.SH "CONFORMING TO" +.SH CONFORMING TO General UNIX conventions. .SH BUGS This list is not exhaustive. -.SH "SEE ALSO" +.SH SEE ALSO .BR file (1), .BR make (1) diff --git a/man7/svipc.7 b/man7/svipc.7 index 9869ba3d1..462732c70 100644 --- a/man7/svipc.7 +++ b/man7/svipc.7 @@ -313,7 +313,7 @@ Time of the last .BR shmctl (2) system call that changed .IR shmid_ds . -.SH "SEE ALSO" +.SH SEE ALSO .BR ipcmk (1), .BR ipcrm (1), .BR ipcs (1), diff --git a/man7/tcp.7 b/man7/tcp.7 index c1156c1f4..58c598cbf 100644 --- a/man7/tcp.7 +++ b/man7/tcp.7 @@ -1158,7 +1158,7 @@ IPv6 is not described. .\" It was updated for 2.4 by Nivedita Singhvi with input from .\" Alexey Kuznetsov's Documentation/networking/ip-sysctl.txt .\" document. -.SH "SEE ALSO" +.SH SEE ALSO .BR accept (2), .BR bind (2), .BR connect (2), diff --git a/man7/termio.7 b/man7/termio.7 index 107872a95..8fde81deb 100644 --- a/man7/termio.7 +++ b/man7/termio.7 @@ -54,7 +54,7 @@ find most of the information that you seek in either .BR termios (3) or .BR tty_ioctl (4). -.SH "SEE ALSO" +.SH SEE ALSO .BR reset (1), .BR setterm (1), .BR stty (1), diff --git a/man7/time.7 b/man7/time.7 index 9db07cda4..18a31393c 100644 --- a/man7/time.7 +++ b/man7/time.7 @@ -183,7 +183,7 @@ For more details, see the description of .B PR_SET_TIMERSLACK in .BR prctl (2). -.SH "SEE ALSO" +.SH SEE ALSO .ad l .nh .BR date (1), diff --git a/man7/udp.7 b/man7/udp.7 index d55775fca..139793fce 100644 --- a/man7/udp.7 +++ b/man7/udp.7 @@ -243,7 +243,7 @@ This might be caused by a previous packet sent over the socket. is a new feature in Linux 2.2. .\" .SH CREDITS .\" This man page was written by Andi Kleen. -.SH "SEE ALSO" +.SH SEE ALSO .BR ip (7), .BR raw (7), .BR socket (7), diff --git a/man7/udplite.7 b/man7/udplite.7 index f4bc1e3ff..dbbb11c99 100644 --- a/man7/udplite.7 +++ b/man7/udplite.7 @@ -141,7 +141,7 @@ Where glibc support is missing, the following definitions are needed: #define UDPLITE_RECV_CSCOV 11 .fi .in -.SH "SEE ALSO" +.SH SEE ALSO .BR ip (7), .BR ipv6 (7), .BR socket (7), diff --git a/man7/unicode.7 b/man7/unicode.7 index 32e915428..64fcdf339 100644 --- a/man7/unicode.7 +++ b/man7/unicode.7 @@ -308,7 +308,7 @@ supported in certain GUI applications (HTML viewers, word processors) with sophisticated text rendering engines. .\" .SH AUTHOR .\" Markus Kuhn -.SH "SEE ALSO" +.SH SEE ALSO .BR setlocale (3), .BR charsets (7), .BR utf-8 (7) diff --git a/man7/unix.7 b/man7/unix.7 index bc38ca101..a9586a86e 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -437,7 +437,7 @@ For an example of the use of .BR SCM_RIGHTS see .BR cmsg (3). -.SH "SEE ALSO" +.SH SEE ALSO .BR recvmsg (2), .BR sendmsg (2), .BR socket (2), diff --git a/man7/uri.7 b/man7/uri.7 index 1fc7ad0ef..90b8119d3 100644 --- a/man7/uri.7 +++ b/man7/uri.7 @@ -580,7 +580,7 @@ permitted, and can only be used when there is no defined base (such as in dialog boxes). Don't use abbreviated URIs as hypertext links inside a document; use the standard format as described here. -.SH "CONFORMING TO" +.SH CONFORMING TO .PP .UR http://www.ietf.org\:/rfc\:/rfc2396.txt (IETF RFC\ 2396) @@ -702,7 +702,7 @@ desktop environment, local user preferences, and currently executing tools) and invokes the right tool for any URI. .\" .SH AUTHOR .\" David A. Wheeler (dwheeler@dwheeler.com) wrote this man page. -.SH "SEE ALSO" +.SH SEE ALSO .BR lynx (1), .BR man2html (1), .BR mailaddr (7), diff --git a/man7/utf-8.7 b/man7/utf-8.7 index f10b58a21..1ba0b56fa 100644 --- a/man7/utf-8.7 +++ b/man7/utf-8.7 @@ -291,7 +291,7 @@ encoding. ISO/IEC 10646-1:2000, Unicode 3.1, RFC\ 3629, Plan 9. .\" .SH AUTHOR .\" Markus Kuhn -.SH "SEE ALSO" +.SH SEE ALSO .BR nl_langinfo (3), .BR setlocale (3), .BR charsets (7), diff --git a/man7/x25.7 b/man7/x25.7 index 505c68261..08cc89751 100644 --- a/man7/x25.7 +++ b/man7/x25.7 @@ -110,7 +110,7 @@ interface are not binary compatible. X.25 N-Reset events are not propagated to the user process yet. Thus, if a reset occurred, data might be lost without notice. -.SH "SEE ALSO" +.SH SEE ALSO .BR socket (2), .BR socket (7) .PP diff --git a/man8/nscd.8 b/man8/nscd.8 index acc308adf..fd5f52093 100644 --- a/man8/nscd.8 +++ b/man8/nscd.8 @@ -82,7 +82,7 @@ after changing the configuration file of the database so that invalidates its cache: $ \fBnscd -i\fP \fI\fP -.SH "SEE ALSO" +.SH SEE ALSO .BR nscd.conf (5), .BR nsswitch.conf (5) .\" .SH AUTHOR diff --git a/man8/sync.8 b/man8/sync.8 index 584bcf2c2..5f65ab1ea 100644 --- a/man8/sync.8 +++ b/man8/sync.8 @@ -45,7 +45,7 @@ documentation; on some systems one should not call and .BR halt (8) directly.) -.SH "OPTIONS" +.SH OPTIONS .TP .B "\-\-help" Print a usage message on standard output and exit successfully. @@ -58,7 +58,7 @@ Terminate option list. .SH ENVIRONMENT The variables \fBLANG\fP, \fBLC_ALL\fP, \fBLC_CTYPE\fP, and \fBLC_MESSAGES\fP have the usual meaning. -.SH "CONFORMING TO" +.SH CONFORMING TO POSIX.2. .SH NOTES On Linux, @@ -77,7 +77,7 @@ This page describes .B sync as found in the file\%utils-4.0 package; other versions may differ slightly. -.SH "SEE ALSO" +.SH SEE ALSO .BR sync (2), .BR halt (8), .BR reboot (8), diff --git a/man8/tzselect.8 b/man8/tzselect.8 index e8f2a88cc..178a6d9e5 100644 --- a/man8/tzselect.8 +++ b/man8/tzselect.8 @@ -15,7 +15,7 @@ The output is suitable as a value for the environment variable. .PP All interaction with the user is done via standard input and standard error. -.SH "EXIT STATUS" +.SH EXIT STATUS The exit status is zero if a timezone was successfully obtained from the user, nonzero otherwise. .SH ENVIRONMENT @@ -41,7 +41,7 @@ descriptive comments. .TP \fBTZDIR\fP\fI/\fP\fITZ\fP Time zone data file for timezone \fITZ\fP. -.SH "SEE ALSO" +.SH SEE ALSO .BR tzfile (5), .BR zdump (8), .BR zic (8) diff --git a/man8/zdump.8 b/man8/zdump.8 index 3bd32af22..8b7d0c7b1 100644 --- a/man8/zdump.8 +++ b/man8/zdump.8 @@ -49,7 +49,7 @@ Cut off the verbose output near the start of the given year(s). The output still includes the lowest possible time value and one day after it, and the highest possible time value preceded by the time value one day before it. -.SH "SEE ALSO" +.SH SEE ALSO .BR tzfile (5), .BR zic (8) .\" @(#)zdump.8 7.3 diff --git a/man8/zic.8 b/man8/zic.8 index df800cbfc..8786f2d46 100644 --- a/man8/zic.8 +++ b/man8/zic.8 @@ -411,7 +411,7 @@ you may need to use local standard time in the .B AT field of the earliest transition time's rule to ensure that the earliest transition time recorded in the compiled file is correct. -.SH "SEE ALSO" +.SH SEE ALSO .BR tzfile (5), .BR zdump (8) .\" @(#)zic.8 7.19