From 66ee0c7e89fe01348878638515edb8b2a51b9a2e Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Sat, 23 Jun 2007 07:19:07 +0000 Subject: [PATCH] ffix --- man1/time.1 | 2 +- man2/capget.2 | 4 ++-- man2/connect.2 | 4 ++-- man2/getsockopt.2 | 4 +++- man2/gettimeofday.2 | 10 +++++----- man2/listen.2 | 2 +- man2/mknod.2 | 4 ++-- man2/open.2 | 4 ++-- man2/ptrace.2 | 2 +- man2/recv.2 | 8 ++++---- man2/semget.2 | 2 +- man2/semop.2 | 2 +- man2/send.2 | 2 +- man2/setuid.2 | 2 +- man2/shmop.2 | 2 +- man2/signal.2 | 2 +- man2/stat.2 | 28 ++++++++++++++-------------- man2/statvfs.2 | 4 ++-- man3/alloca.3 | 2 +- man3/bsd_signal.3 | 5 ++--- man3/catopen.3 | 2 +- man3/clock.3 | 5 +++-- man3/getpass.3 | 2 +- man3/setlocale.3 | 8 ++++---- 24 files changed, 57 insertions(+), 55 deletions(-) diff --git a/man1/time.1 b/man1/time.1 index 0b7fe9bef5..baf0ab0254 100644 --- a/man1/time.1 +++ b/man1/time.1 @@ -63,7 +63,7 @@ and some other non-zero value (1-125) if something else went wrong. .SH ENVIRONMENT The variables .BR LANG , -.BR LC_ALL , +.BR LC_ALL , .BR LC_CTYPE , .BR LC_MESSAGES , .BR LC_NUMERIC , diff --git a/man2/capget.2 b/man2/capget.2 index 13aa63bc64..6fca40c967 100644 --- a/man2/capget.2 +++ b/man2/capget.2 @@ -148,10 +148,10 @@ These system calls are Linux specific. .SH NOTES The portable interface to the capability querying and setting functions is provided by the -.B libcap +.I libcap library and is available from here: .br -.B ftp://ftp.kernel.org/pub/linux/libs/security/linux-privs +.I ftp://ftp.kernel.org/pub/linux/libs/security/linux-privs .SH "SEE ALSO" .BR clone (2), .BR gettid (2), diff --git a/man2/connect.2 b/man2/connect.2 index e674ddd426..1fc52c7808 100644 --- a/man2/connect.2 +++ b/man2/connect.2 @@ -118,7 +118,7 @@ Connectionless sockets may dissolve the association by connecting to an address with the .I sa_family member of -.B sockaddr +.I sockaddr set to .BR AF_UNSPEC . .SH "RETURN VALUE" @@ -156,7 +156,7 @@ No more free local ports or insufficient entries in the routing cache. For .B PF_INET see the -.B net.ipv4.ip_local_port_range +.I net.ipv4.ip_local_port_range sysctl in .BR ip (7) on how to increase the number of local ports. diff --git a/man2/getsockopt.2 b/man2/getsockopt.2 index 17801caab1..1add278480 100644 --- a/man2/getsockopt.2 +++ b/man2/getsockopt.2 @@ -180,7 +180,9 @@ file, and portable applications are probably wise to include it. The .I optlen argument of -.BR getsockopt " and " setsockopt +.BR getsockopt () +and +.BR setsockopt () is in reality an .I "int [*]" (and this is what 4.x BSD and libc4 and libc5 have). diff --git a/man2/gettimeofday.2 b/man2/gettimeofday.2 index b6bdb3c4af..03fe5a9e80 100644 --- a/man2/gettimeofday.2 +++ b/man2/gettimeofday.2 @@ -222,11 +222,11 @@ but not The prototype for .BR settimeofday () and the defines for -.BR timercmp , -.BR timerisset , -.BR timerclear , -.BR timeradd , -.BR timersub +.BR timercmp (), +.BR timerisset (), +.BR timerclear (), +.BR timeradd (), +.BR timersub () are (since glibc 2.2.2) only available if .B _BSD_SOURCE is defined. diff --git a/man2/listen.2 b/man2/listen.2 index 891fce7836..4a2d181bd6 100644 --- a/man2/listen.2 +++ b/man2/listen.2 @@ -119,7 +119,7 @@ established sockets waiting to be accepted, instead of the number of incomplete connection requests. The maximum length of the queue for incomplete sockets can be set using the -.B tcp_max_syn_backlog +.I tcp_max_syn_backlog sysctl. When syncookies are enabled there is no logical maximum length and this sysctl setting is ignored. diff --git a/man2/mknod.2 b/man2/mknod.2 index 93bd823c87..8bd8da7765 100644 --- a/man2/mknod.2 +++ b/man2/mknod.2 @@ -41,9 +41,9 @@ It should be a combination (using bitwise OR) of one of the file types listed below and the permissions for the new node. The permissions are modified by the process's -.BR umask +.IR umask in the usual way: the permissions of the created node are -.BR "(mode & ~umask)" . +.IR "(mode & ~umask)" . The file type must be one of .BR S_IFREG , diff --git a/man2/open.2 b/man2/open.2 index 8f0e1aab8f..56fcc6d4c4 100644 --- a/man2/open.2 +++ b/man2/open.2 @@ -308,9 +308,9 @@ The argument specifies the permissions to use in case a new file is created. It is modified by the process's -.BR umask +.IR umask in the usual way: the permissions of the created file are -.BR "(mode & ~umask)" . +.IR "(mode & ~umask)" . Note that this mode only applies to future accesses of the newly created file; the .BR open () diff --git a/man2/ptrace.2 b/man2/ptrace.2 index cb8c146f34..6a86193273 100644 --- a/man2/ptrace.2 +++ b/man2/ptrace.2 @@ -426,7 +426,7 @@ non-root processes cannot trace processes that they cannot send signals to or those running set-user-ID/set-group-ID programs, for obvious reasons. Alternatively, the process may already be being traced, or be -.BR init +.BR init (8) (PID 1). .TP .B ESRCH diff --git a/man2/recv.2 b/man2/recv.2 index 185d1cb8da..c1c7ff3eeb 100644 --- a/man2/recv.2 +++ b/man2/recv.2 @@ -191,11 +191,11 @@ struct sockaddr *SO_EE_OFFENDER(struct sock_extended_err *); .fi .in -0.25i .IP -.B ee_errno +.I ee_errno contains the .I errno number of the queued error. -.B ee_origin +.I ee_origin is the origin code of where the error originated. The other fields are protocol specific. The macro @@ -205,11 +205,11 @@ where the error originated from given a pointer to the ancillary message. If this address is not known, the .I sa_family member of the -.B sockaddr +.I sockaddr contains .B AF_UNSPEC and the other fields of the -.B sockaddr +.I sockaddr are undefined. The payload of the packet that caused the error is passed as normal data. .IP diff --git a/man2/semget.2 b/man2/semget.2 index e6ecc39883..f0ec731007 100644 --- a/man2/semget.2 +++ b/man2/semget.2 @@ -176,7 +176,7 @@ capability. .TP .B EEXIST A semaphore set exists for -.B key +.I key and .I semflg specified both diff --git a/man2/semop.2 b/man2/semop.2 index 940a9e12fc..98ce1d52d6 100644 --- a/man2/semop.2 +++ b/man2/semop.2 @@ -280,7 +280,7 @@ behaves identically to except that in those cases were the calling process would sleep, the duration of that sleep is limited by the amount of elapsed time specified by the -.B timespec +.I timespec structure whose address is passed in the .I timeout parameter. diff --git a/man2/send.2 b/man2/send.2 index 393211ddea..fd9b2f3071 100644 --- a/man2/send.2 +++ b/man2/send.2 @@ -256,7 +256,7 @@ and members. The maximum control buffer length the kernel can process is limited per socket by the -.B net.core.optmem_max +.I net.core.optmem_max sysctl; see .BR socket (7). .\" Still to be documented: diff --git a/man2/setuid.2 b/man2/setuid.2 index 19f105018e..e54577db69 100644 --- a/man2/setuid.2 +++ b/man2/setuid.2 @@ -75,7 +75,7 @@ The .I uid does not match the current uid and .I uid -brings process over its +brings process over its .BR RLIMIT_NPROC resource limit. .TP diff --git a/man2/shmop.2 b/man2/shmop.2 index 5679a0d3f1..ffc4defca4 100644 --- a/man2/shmop.2 +++ b/man2/shmop.2 @@ -115,7 +115,7 @@ one, and more than once, in the process's address space. A successful .BR shmat () call updates the members of the -.B shmid_ds +.I shmid_ds structure (see .BR shmctl (2)) associated with the shared memory segment as follows: diff --git a/man2/signal.2 b/man2/signal.2 index e74f3b9cfa..f7dd0f129e 100644 --- a/man2/signal.2 +++ b/man2/signal.2 @@ -137,7 +137,7 @@ for a list of the async-signal-safe functions that can be safely called inside from inside a signal handler. .PP The use of -.B sighandler_t +.I sighandler_t is a GNU extension. Various versions of libc predefine this type; libc4 and libc5 define .IR SignalHandler , diff --git a/man2/stat.2 b/man2/stat.2 index 33a3b16da0..b52a387ea1 100644 --- a/man2/stat.2 +++ b/man2/stat.2 @@ -250,7 +250,7 @@ the directory, not from the effective group ID of the creating process, and directories created there will also get the .B S_ISGID bit set. -For a file that does not have the group execution bit +For a file that does not have the group execution bit .RB ( S_IXGRP ) set, the set-group-ID bit indicates mandatory file/record locking. @@ -319,14 +319,14 @@ The interpretation differs between systems, and possibly on a single system when NFS mounts are involved.) .LP POSIX does not describe the -.BR S_IFMT , -.BR S_IFSOCK , -.BR S_IFLNK , -.BR S_IFREG , +.BR S_IFMT , +.BR S_IFSOCK , +.BR S_IFLNK , +.BR S_IFREG , .BR S_IFBLK , -.BR S_IFDIR , -.BR S_IFCHR , -.BR S_IFIFO , +.BR S_IFDIR , +.BR S_IFCHR , +.BR S_IFIFO , .BR S_ISVTX bits, but instead demands the use of the macros @@ -340,14 +340,14 @@ macros are not in POSIX.1-1996, but both are present in POSIX.1-2001; the former is from SVID 4, the latter from SUSv2. .LP -Unix V7 (and later systems) had -.BR S_IREAD , -.BR S_IWRITE , +Unix V7 (and later systems) had +.BR S_IREAD , +.BR S_IWRITE , .BR S_IEXEC , where POSIX -prescribes the synonyms -.BR S_IRUSR , -.BR S_IWUSR , +prescribes the synonyms +.BR S_IRUSR , +.BR S_IWUSR , .BR S_IXUSR . .SS "Other Systems" Values that have been (or are) in use on various systems: diff --git a/man2/statvfs.2 b/man2/statvfs.2 index 0c21de9355..0619cf17a0 100644 --- a/man2/statvfs.2 +++ b/man2/statvfs.2 @@ -62,9 +62,9 @@ struct statvfs { .fi Here the types -.B fsblkcnt_t +.I fsblkcnt_t and -.B fsfilcnt_t +.I fsfilcnt_t are defined in .IR . Both used to be diff --git a/man3/alloca.3 b/man3/alloca.3 index f459f16ab7..6ef487ac63 100644 --- a/man3/alloca.3 +++ b/man3/alloca.3 @@ -67,7 +67,7 @@ This function is not in POSIX.1-2001. .SH NOTES .SS Notes on the GNU Version Normally, -.B gcc +.B gcc (1) translates calls to .BR alloca () by inlined code. diff --git a/man3/bsd_signal.3 b/man3/bsd_signal.3 index 9aa4a3abe3..81cdd9c9b2 100644 --- a/man3/bsd_signal.3 +++ b/man3/bsd_signal.3 @@ -79,10 +79,9 @@ provided unreliable signal semantics; see for details. The use of -.B sighandler_t +.I sighandler_t is a GNU extension; -this type is only defined if -the +this type is only defined if the .B _GNU_SOURCE feature test macro is defined. .SH "SEE ALSO" diff --git a/man3/catopen.3 b/man3/catopen.3 index 69637dfd67..fae0b787c1 100644 --- a/man3/catopen.3 +++ b/man3/catopen.3 @@ -147,7 +147,7 @@ POSIX.1-2001. .\" .IR "and should be set to 0" . It is unclear what the source was for the constants .B MCLoadBySet -and +and .B MCLoadAll (see below). .SH NOTES diff --git a/man3/clock.3 b/man3/clock.3 index 8eb917485f..820e3eb0c3 100644 --- a/man3/clock.3 +++ b/man3/clock.3 @@ -39,11 +39,12 @@ The function returns an approximation of processor time used by the program. .SH "RETURN VALUE" The value returned is the CPU time used so far as a -.BR clock_t ; +.IR clock_t ; to get the number of seconds used, divide by .BR CLOCKS_PER_SEC . If the processor time used is not available or its value cannot -be represented, the function returns the value (clock_t)\-1. +be represented, the function returns the value +.BR (clock_t)\-1 . .SH "CONFORMING TO" C89, C99, POSIX.1-2001. POSIX requires that CLOCKS_PER_SEC equals 1000000 independent diff --git a/man3/getpass.3 b/man3/getpass.3 index 3353139a58..15aa60e216 100644 --- a/man3/getpass.3 +++ b/man3/getpass.3 @@ -115,7 +115,7 @@ or .BR _SC_PASS_MAX . Glibc2 accepts .BR _SC_PASS_MAX -and returns +and returns .B BUFSIZ (e.g., 8192). .SH BUGS diff --git a/man3/setlocale.3 b/man3/setlocale.3 index c793b0d64b..efe5891707 100644 --- a/man3/setlocale.3 +++ b/man3/setlocale.3 @@ -101,10 +101,10 @@ the environment variable is inspected, next the environment variable with the same name as the category .RM ( LC_COLLATE , -.BR LC_CTYPE , -.BR LC_MESSAGES , -.BR LC_MONETARY , -.BR LC_NUMERIC , +.BR LC_CTYPE , +.BR LC_MESSAGES , +.BR LC_MONETARY , +.BR LC_NUMERIC , .BR LC_TIME ) and finally the environment variable .BR LANG . -- 2.39.5