From 8b5b8ec6a76033148b7266d572cd6e0ec6ddd60b Mon Sep 17 00:00:00 2001 From: ru Date: Sun, 23 Feb 2003 01:47:49 +0000 Subject: mdoc(7) police: markup laundry. --- lib/libc/gen/stringlist.3 | 2 +- lib/libc/stdio/ferror.3 | 2 +- lib/libc/stdio/getc.3 | 6 +++--- lib/libc/stdio/putc.3 | 4 +++- lib/libc/stdio/stdio.3 | 10 +++++----- lib/libc/sys/mincore.2 | 10 +++++----- lib/libc/sys/mount.2 | 13 +++++++------ lib/libc/sys/mprotect.2 | 11 ++++++----- lib/libc/sys/rfork.2 | 16 ++++++++-------- lib/libpam/modules/pam_opieaccess/pam_opieaccess.8 | 2 +- lib/libpam/modules/pam_ssh/pam_ssh.8 | 2 +- lib/libutil/realhostname_sa.3 | 4 +++- 12 files changed, 44 insertions(+), 38 deletions(-) (limited to 'lib') diff --git a/lib/libc/gen/stringlist.3 b/lib/libc/gen/stringlist.3 index 4665176..d75407c 100644 --- a/lib/libc/gen/stringlist.3 +++ b/lib/libc/gen/stringlist.3 @@ -115,7 +115,7 @@ at .Fa sl->sl_cur , extending the size of .Fa sl->sl_str . -Returns zero upon success, -1 upon failure. +Returns zero upon success, \-1 upon failure. .It Fn sl_find Find .Fa item diff --git a/lib/libc/stdio/ferror.3 b/lib/libc/stdio/ferror.3 index cb170a4..3fe2839 100644 --- a/lib/libc/stdio/ferror.3 +++ b/lib/libc/stdio/ferror.3 @@ -113,7 +113,7 @@ and .Fn fileno respectively, except that the caller is responsible for locking the stream with -.Fn flockfile +.Xr flockfile 3 before calling them. These functions may be used to avoid the overhead of locking the stream and to prevent races when multiple threads are operating on the same stream. diff --git a/lib/libc/stdio/getc.3 b/lib/libc/stdio/getc.3 index 022521f..570867b 100644 --- a/lib/libc/stdio/getc.3 +++ b/lib/libc/stdio/getc.3 @@ -42,9 +42,9 @@ .Sh NAME .Nm fgetc , .Nm getc , -.Nm getc_unlocked +.Nm getc_unlocked , .Nm getchar , -.Nm getchar_unlocked +.Nm getchar_unlocked , .Nm getw .Nd get next character or word from input stream .Sh LIBRARY @@ -104,7 +104,7 @@ and respectively, except that the caller is responsible for locking the stream with -.Fn flockfile +.Xr flockfile 3 before calling them. These functions may be used to avoid the overhead of locking the stream for each character, and to avoid input being dispersed among multiple diff --git a/lib/libc/stdio/putc.3 b/lib/libc/stdio/putc.3 index bd51c10..2476f5f 100644 --- a/lib/libc/stdio/putc.3 +++ b/lib/libc/stdio/putc.3 @@ -42,7 +42,9 @@ .Sh NAME .Nm fputc , .Nm putc , +.Nm putc_unlocked , .Nm putchar , +.Nm putchar_unlocked , .Nm putw .Nd output a character or word to a stream .Sh LIBRARY @@ -103,7 +105,7 @@ and respectively, except that the caller is responsible for locking the stream with -.Fn flockfile +.Xr flockfile 3 before calling them. These functions may be used to avoid the overhead of locking the stream for each character, and to avoid output being interspersed from multiple diff --git a/lib/libc/stdio/stdio.3 b/lib/libc/stdio/stdio.3 index 71626f4..7a0d2f9 100644 --- a/lib/libc/stdio/stdio.3 +++ b/lib/libc/stdio/stdio.3 @@ -172,13 +172,13 @@ looks like and which external variables are of interest. The following are defined as macros; these names may not be re-used without first removing their current definitions with -.Dv #undef : +.Ic #undef : .Dv BUFSIZ , .Dv EOF , .Dv FILENAME_MAX , .Dv FOPEN_MAX , -.Dv L_cuserid , .Dv L_ctermid , +.Dv L_cuserid , .Dv L_tmpnam , .Dv NULL , .Dv P_tmpdir , @@ -190,12 +190,12 @@ without first removing their current definitions with .Dv feof_unlocked , .Dv ferror_unlocked , .Dv fileno_unlocked , +.Dv fropen , +.Dv fwopen , .Dv getc_unlocked , .Dv getchar_unlocked , .Dv putc_unlocked , .Dv putchar_unlocked , -.Dv fropen , -.Dv fwopen , .Dv stderr , .Dv stdin and @@ -209,7 +209,7 @@ Function versions of the macro functions .Dv getchar_unlocked , .Dv putc_unlocked and -.Dv putchar_unlocked , +.Dv putchar_unlocked exist and will be used if the macro definitions are explicitly removed. .Sh SEE ALSO diff --git a/lib/libc/sys/mincore.2 b/lib/libc/sys/mincore.2 index c3a5e32..836f846 100644 --- a/lib/libc/sys/mincore.2 +++ b/lib/libc/sys/mincore.2 @@ -55,7 +55,7 @@ bytes is resident. .\"The beginning address, .\".Fa addr , .\"is first rounded down to a multiple of the page size (see -.\".Xr getpagesize 3 Ns ). +.\".Xr getpagesize 3 ) . .\"The end address, .\".Fa addr No + Fa len , .\"is rounded up to a multiple of the page size. @@ -64,7 +64,7 @@ The status is returned in the array, one character per page. Each character is either 0 if the page is not resident, or a combination of the following flags (defined in -.Sy Ns No ) Ns : +.Aq Pa sys/mman.h ) : .Bl -tag -width ".Dv MINCORE_REFERENCED_OTHER" .It Dv MINCORE_INCORE Page is in core (resident). @@ -80,17 +80,17 @@ Page has been modified. .Pp The information returned by .Fn mincore -may be out of date by the time the function returns. +may be out of date by the time the system call returns. The only way to ensure that a page is resident is to lock it into memory with the .Xr mlock 2 -function. +system call. .Sh RETURN VALUES .Rv -std mincore .Sh ERRORS The .Fn mincore -function will fail if: +system call will fail if: .Bl -tag -width Er .It Bq Er EINVAL The virtual address range specified by the diff --git a/lib/libc/sys/mount.2 b/lib/libc/sys/mount.2 index dae53d6..bd3b7e4 100644 --- a/lib/libc/sys/mount.2 +++ b/lib/libc/sys/mount.2 @@ -76,9 +76,11 @@ are unavailable until the file system is unmounted. .Pp By default only the super-user may call the .Fn mount -function. -This restriction can be removed by setting the sysctl -.Em vfs.usermount +system call. +This restriction can be removed by setting the +.Va vfs.usermount +.Xr sysctl 8 +variable to a non-zero value. .Pp The following @@ -188,7 +190,7 @@ system call will fail when one of the following occurs: .Bl -tag -width Er .It Bq Er EPERM The caller is neither the super-user nor the owner of -.Ar dir . +.Fa dir . .It Bq Er ENAMETOOLONG A component of a pathname exceeded 255 characters, or the entire length of a path name exceeded 1023 characters. @@ -272,7 +274,7 @@ system call may fail with one of the following errors: .Bl -tag -width Er .It Bq Er EPERM The caller is neither the super-user nor the user who issued the corresponding -.Xr mount 2 +.Fn mount call. .It Bq Er ENOTDIR A component of the path is not a directory. @@ -302,7 +304,6 @@ mounted. .Sh SEE ALSO .Xr lsvfs 1 , .Xr mount 8 , -.Xr sysctl 8 , .Xr umount 8 .Sh BUGS Some of the error codes need translation to more obvious messages. diff --git a/lib/libc/sys/mprotect.2 b/lib/libc/sys/mprotect.2 index 312950f..909b240 100644 --- a/lib/libc/sys/mprotect.2 +++ b/lib/libc/sys/mprotect.2 @@ -58,14 +58,15 @@ and end addresses of a .Pp Currently these protection bits are known, which can be combined, OR'd together: -.Bl -tag width "PROT_WRITE" -.It PROT_NONE +.Pp +.Bl -tag -width ".Dv PROT_WRITE" -compact +.It Dv PROT_NONE No permissions at all. -.It PROT_READ +.It Dv PROT_READ The pages can be read. -.It PROT_WRITE +.It Dv PROT_WRITE The pages can be written. -.It PROT_EXEC +.It Dv PROT_EXEC The pages can be executed. .El .Sh RETURN VALUES diff --git a/lib/libc/sys/rfork.2 b/lib/libc/sys/rfork.2 index 1081b6b..88f8144 100644 --- a/lib/libc/sys/rfork.2 +++ b/lib/libc/sys/rfork.2 @@ -35,26 +35,26 @@ The .Fa flags argument is the logical OR of some subset of: -.Bl -tag -width "RFLINUXTHPN" -offset indent -.It RFPROC +.Bl -tag -width ".Dv RFLINUXTHPN" +.It Dv RFPROC If set a new process is created; otherwise changes affect the current process. -.It RFNOWAIT +.It Dv RFNOWAIT If set, the child process will be dissociated from the parent. Upon exit the child will not leave a status for the parent to collect. See .Xr wait 2 . -.It RFFDG +.It Dv RFFDG If set, the invoker's file descriptor table (see .Xr intro 2 ) is copied; otherwise the two processes share a single table. -.It RFCFDG +.It Dv RFCFDG If set, the new process starts with a clean file descriptor table. Is mutually exclusive with .Dv RFFDG . -.It RFMEM +.It Dv RFMEM If set, the kernel will force sharing of the entire address space, typically by sharing the hardware page table directly. The child @@ -70,10 +70,10 @@ A helper function is provided to assist with this problem and will cause the new process to run on the provided stack. See .Xr rfork_thread 3 for information. -.It RFSIGSHARE +.It Dv RFSIGSHARE If set, the kernel will force sharing the sigacts structure between the child and the parent. -.It RFLINUXTHPN +.It Dv RFLINUXTHPN If set, the kernel will return SIGUSR1 instead of SIGCHILD upon thread exit for the child. This is intended to mimic certain Linux clone behaviour. .El diff --git a/lib/libpam/modules/pam_opieaccess/pam_opieaccess.8 b/lib/libpam/modules/pam_opieaccess/pam_opieaccess.8 index 93f01c1..034ace5 100644 --- a/lib/libpam/modules/pam_opieaccess/pam_opieaccess.8 +++ b/lib/libpam/modules/pam_opieaccess/pam_opieaccess.8 @@ -117,7 +117,7 @@ These messages include reasons why the user's authentication attempt was declined. .El .Sh FILES -.Bl -tag -width Ds +.Bl -tag -width ".Pa /etc/opieaccess" .It Pa /etc/opieaccess List of trusted hosts or networks. See diff --git a/lib/libpam/modules/pam_ssh/pam_ssh.8 b/lib/libpam/modules/pam_ssh/pam_ssh.8 index 9fe1ec4..b6efc6e 100644 --- a/lib/libpam/modules/pam_ssh/pam_ssh.8 +++ b/lib/libpam/modules/pam_ssh/pam_ssh.8 @@ -149,4 +149,4 @@ Associates, Inc. under DARPA/SPAWAR contract N66001-01-C-8035 .Pq Dq CBOSS , as part of the DARPA CHATS research program. This manual page was written by -.An "Mark R V Murray" Aq markm@FreeBSD.ORG . +.An "Mark R V Murray" Aq markm@FreeBSD.org . diff --git a/lib/libutil/realhostname_sa.3 b/lib/libutil/realhostname_sa.3 index 19a17f4..fdeb099 100644 --- a/lib/libutil/realhostname_sa.3 +++ b/lib/libutil/realhostname_sa.3 @@ -56,7 +56,9 @@ .Dt REALHOSTNAME_SA 3 .Sh NAME .Nm realhostname_sa -.Nd "convert a struct sockaddr to the real host name" +.Nd "convert a" +.Vt "struct sockaddr" +to the real host name .Sh LIBRARY .Lb libutil .Sh SYNOPSIS -- cgit v1.1