diff options
author | 2000-03-19 19:25:21 +0000 | |
---|---|---|
committer | 2000-03-19 19:25:21 +0000 | |
commit | 1f53fde168acc1d0dd0875ec542fe363338e18f8 (patch) | |
tree | 5a98000f94a8db3b6356bfd716250a1ae13fa5e3 /share/man/man5 | |
parent | Remove hard sentence breaks. Add $OpenBSD$ tags where appropriate. Some other (diff) | |
download | wireguard-openbsd-1f53fde168acc1d0dd0875ec542fe363338e18f8.tar.xz wireguard-openbsd-1f53fde168acc1d0dd0875ec542fe363338e18f8.zip |
Various cleanups.
Diffstat (limited to 'share/man/man5')
-rw-r--r-- | share/man/man5/a.out.5 | 13 | ||||
-rw-r--r-- | share/man/man5/acct.5 | 6 | ||||
-rw-r--r-- | share/man/man5/core.5 | 5 | ||||
-rw-r--r-- | share/man/man5/disktab.5 | 12 | ||||
-rw-r--r-- | share/man/man5/ethers.5 | 8 | ||||
-rw-r--r-- | share/man/man5/fbtab.5 | 5 | ||||
-rw-r--r-- | share/man/man5/fs.5 | 30 | ||||
-rw-r--r-- | share/man/man5/group.5 | 5 | ||||
-rw-r--r-- | share/man/man5/hostname.if.5 | 12 | ||||
-rw-r--r-- | share/man/man5/hosts.5 | 13 | ||||
-rw-r--r-- | share/man/man5/hosts.equiv.5 | 20 | ||||
-rw-r--r-- | share/man/man5/link.5 | 87 | ||||
-rw-r--r-- | share/man/man5/netgroup.5 | 5 | ||||
-rw-r--r-- | share/man/man5/passwd.5 | 5 | ||||
-rw-r--r-- | share/man/man5/passwd.conf.5 | 36 | ||||
-rw-r--r-- | share/man/man5/phones.5 | 9 | ||||
-rw-r--r-- | share/man/man5/protocols.5 | 8 | ||||
-rw-r--r-- | share/man/man5/remote.5 | 36 | ||||
-rw-r--r-- | share/man/man5/resolv.conf.5 | 6 | ||||
-rw-r--r-- | share/man/man5/services.5 | 10 |
20 files changed, 196 insertions, 135 deletions
diff --git a/share/man/man5/a.out.5 b/share/man/man5/a.out.5 index 5631505eba5..fcf7de3b480 100644 --- a/share/man/man5/a.out.5 +++ b/share/man/man5/a.out.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: a.out.5,v 1.6 1999/09/23 04:12:06 alex Exp $ +.\" $OpenBSD: a.out.5,v 1.7 2000/03/19 19:25:26 aaron Exp $ .\" $NetBSD: a.out.5,v 1.8 1994/11/30 19:31:09 jtc Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -119,8 +119,8 @@ returns a few flags: .It Dv EX_DYNAMIC Indicates that the executable requires the services of the run-time link editor. .It Dv EX_PIC -Indicates that the object contains position independent code. This flag is -set by +Indicates that the object contains position independent code. +This flag is set by .Xr as 1 when given the .Fl k @@ -287,8 +287,8 @@ If set, the symbol, as identified by the field, is to be relocated to an offset into the Procedure Linkage Table. .It Fa r_relative If set, this relocation is relative to the (run-time) load address of the -image this object file is going to be a part of. This type of relocation -only occurs in shared objects. +image this object file is going to be a part of. +This type of relocation only occurs in shared objects. .It Fa r_copy If set, this relocation record identifies a symbol whose contents should be copied to the location given in @@ -399,7 +399,8 @@ the values are described in This field provides information on the nature of the symbol independent of the symbol's location in terms of segments as determined by the .Fa n_type -field. Currently, the lower 4 bits of the +field. +Currently, the lower 4 bits of the .Fa n_other field hold one of two values: .Dv AUX_FUNC diff --git a/share/man/man5/acct.5 b/share/man/man5/acct.5 index 96ee91ec52b..f4858861d6e 100644 --- a/share/man/man5/acct.5 +++ b/share/man/man5/acct.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: acct.5,v 1.5 1998/11/26 04:25:58 aaron Exp $ +.\" $OpenBSD: acct.5,v 1.6 2000/03/19 19:25:26 aaron Exp $ .\" $NetBSD: acct.5,v 1.4 1995/10/22 01:40:10 ghudson Exp $ .\" .\" Copyright (c) 1991, 1993 @@ -46,8 +46,8 @@ The kernel maintains the following .Fa acct information structure for all -processes. If a process terminates, and accounting is enabled, -the kernel calls the +processes. +If a process terminates, and accounting is enabled, the kernel calls the .Xr acct 2 function call to prepare and append the record to the accounting file. diff --git a/share/man/man5/core.5 b/share/man/man5/core.5 index 9c9014f0519..fd6894bdb90 100644 --- a/share/man/man5/core.5 +++ b/share/man/man5/core.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: core.5,v 1.6 1999/07/09 13:35:38 aaron Exp $ +.\" $OpenBSD: core.5,v 1.7 2000/03/19 19:25:26 aaron Exp $ .\" $NetBSD: core.5,v 1.4 1994/11/30 19:31:11 jtc Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -71,7 +71,8 @@ defined by the .Dv UPAGES manifest in the .Aq Pa sys/param.h -file. The +file. +The .Fa u . area starts with a .Fa user diff --git a/share/man/man5/disktab.5 b/share/man/man5/disktab.5 index e65ee872c96..9558d6defa6 100644 --- a/share/man/man5/disktab.5 +++ b/share/man/man5/disktab.5 @@ -1,3 +1,4 @@ +.\" $OpenBSD: disktab.5,v 1.6 2000/03/19 19:25:27 aaron Exp $ .\" $NetBSD: disktab.5,v 1.4 1994/11/30 19:31:15 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -53,16 +54,17 @@ to initialize the disk label on the disk. The format is patterned after the .Xr termcap 5 -terminal database. Entries in +terminal database. +Entries in .Nm consist of a number of colon .Pq Sq \&: -separated fields. The -first entry for each disk gives the names which are +separated fields. +The first entry for each disk gives the names which are known for the disk, separated by .Dq \&| -characters. The -last name given should be a long name fully identifying +characters. +The last name given should be a long name fully identifying the disk. .Pp The following list indicates the normal values diff --git a/share/man/man5/ethers.5 b/share/man/man5/ethers.5 index 02a7021d68d..eeafd7b7226 100644 --- a/share/man/man5/ethers.5 +++ b/share/man/man5/ethers.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ethers.5,v 1.10 1999/07/09 13:35:38 aaron Exp $ +.\" $OpenBSD: ethers.5,v 1.11 2000/03/19 19:25:27 aaron Exp $ .\" $NetBSD: ethers.5,v 1.2 1994/11/30 19:31:16 jtc Exp $ .\" .\" Written by Roland McGrath <roland@frob.com>. Public domain. @@ -20,7 +20,8 @@ indicates the beginning of a comment; characters up to the end of the line are not interpreted by routines which search the file. .Pp Ethernet addresses are expressed as six hexadecimal numbers separated by -colons. The functions described in +colons. +The functions described in .Xr ethers 3 can read and produce this format. .Pp @@ -41,7 +42,8 @@ Lines in .Pa /etc/ethers are limited to .Dv BUFSIZE -characters (currently 1024). Longer lines will be ignored. +characters (currently 1024). +Longer lines will be ignored. .Sh HISTORY The .Nm diff --git a/share/man/man5/fbtab.5 b/share/man/man5/fbtab.5 index 5dec81633fe..5141cbc17f4 100644 --- a/share/man/man5/fbtab.5 +++ b/share/man/man5/fbtab.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fbtab.5,v 1.5 1999/11/11 06:33:27 ericj Exp $ +.\" $OpenBSD: fbtab.5,v 1.6 2000/03/19 19:25:28 aaron Exp $ .\" .Dd August 22, 1994 .Dt FBTAB 5 @@ -47,7 +47,8 @@ file is used by .Xr login 1 to .Xr chown 2 -the specified files to the user who has performed a login. As well, +the specified files to the user who has performed a login. +As well, .Xr chmod 2 is used to set the devices to the specified permission. When a user logs out, diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5 index 27fd7130108..a60de210abe 100644 --- a/share/man/man5/fs.5 +++ b/share/man/man5/fs.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: fs.5,v 1.7 1999/07/09 13:35:38 aaron Exp $ +.\" $OpenBSD: fs.5,v 1.8 2000/03/19 19:25:28 aaron Exp $ .\" $NetBSD: fs.5,v 1.3 1994/11/30 19:31:17 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -165,10 +165,11 @@ A file system consists of a number of cylinder groups. Each cylinder group has inodes and data. .Pp A file system is described by its super-block, which in turn -describes the cylinder groups. The super-block is critical +describes the cylinder groups. +The super-block is critical data and is replicated in each cylinder group to protect against -catastrophic loss. This is done at file system creation -time and the critical +catastrophic loss. +This is done at file system creation time and the critical super-block data does not change, so the copies need not be referenced further unless disaster strikes. .Pp @@ -185,12 +186,14 @@ or some multiple of a .Dv DEV_BSIZE unit. .Pp -Large files consist of exclusively large data blocks. To avoid -undue wasted disk space, the last data block of a small file is +Large files consist of exclusively large data blocks. +To avoid undue wasted disk space, the last data block of a small file is allocated as only as many fragments of a large block as are -necessary. The file system format retains only a single pointer +necessary. +The file system format retains only a single pointer to such a fragment, which is a piece of a single large block that -has been divided. The size of such a fragment is determinable from +has been divided. +The size of such a fragment is determinable from information in the inode, using the .Fn blksize macro. @@ -209,8 +212,9 @@ Thus the root inode is 2. The .Fa fs_minfree element gives the minimum acceptable percentage of file system -blocks that may be free. If the freelist drops below this level -only the super-user may continue to allocate blocks. +blocks that may be free. +If the freelist drops below this level +only the superuser may continue to allocate blocks. The .Fa fs_minfree element @@ -245,7 +249,8 @@ the file system defaults to optimizing for time. .Ss Cylinder group related limits Each cylinder keeps track of the availability of blocks at different rotational positions, so that sequential blocks can be laid out -with minimum rotational latency. With the default of 8 distinguished +with minimum rotational latency. +With the default of 8 distinguished rotational positions, the resolution of the summary information is 2ms for a typical 3600 rpm drive. .Pp @@ -313,7 +318,8 @@ is limited by the fact that the super-block is of size .Dv SBSIZE . The size of these tables is inversely proportional to the block -size of the file system. The size of the tables is +size of the file system. +The size of the tables is increased when sector sizes are not powers of two, as this increases the number of cylinders included before the rotational pattern repeats diff --git a/share/man/man5/group.5 b/share/man/man5/group.5 index 498e6dcbceb..85058a52f94 100644 --- a/share/man/man5/group.5 +++ b/share/man/man5/group.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: group.5,v 1.5 1999/10/05 20:53:11 aaron Exp $ +.\" $OpenBSD: group.5,v 1.6 2000/03/19 19:25:28 aaron Exp $ .\" $NetBSD: group.5,v 1.4 1995/07/28 06:41:39 phil Exp $ .\" .\" Copyright (c) 1980, 1991, 1993 @@ -48,7 +48,8 @@ consists of newline separated .Tn ASCII records, one per group, containing four colon .Pq Sq \&: -separated fields. These fields are as follows: +separated fields. +These fields are as follows: .Pp .Bl -tag -width password -offset indent -compact .It group diff --git a/share/man/man5/hostname.if.5 b/share/man/man5/hostname.if.5 index 70a46e13ccd..a2ec1554d22 100644 --- a/share/man/man5/hostname.if.5 +++ b/share/man/man5/hostname.if.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: hostname.if.5,v 1.18 2000/01/18 21:49:00 aaron Exp $ +.\" $OpenBSD: hostname.if.5,v 1.19 2000/03/19 19:25:29 aaron Exp $ .\" $NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -143,8 +143,8 @@ library routines. The prefixlen number, or number of bits in the netmask, to be set on the interface, such as 64. .It Va # -Comments are allowed. Anything following a comment -character is treated as a comment. +Comments are allowed. +Anything following a comment character is treated as a comment. .It Va ! Ar command-line Arbitrary shell commands can be executed using this directive. Useful for doing interface specific configuration using commands like @@ -257,8 +257,10 @@ The options are as follows: .Bl -tag -width indent -offset xxxx .It Va brconfig-arguments .Xr brconfig 8 -is called for each successive line. Comments starting with # are -permitted. +is called for each successive line. +Comments starting with +.Ql # +are permitted .El .Sh SEE ALSO .Xr hosts 5 , diff --git a/share/man/man5/hosts.5 b/share/man/man5/hosts.5 index 16c9b043414..b6bcd4b523e 100644 --- a/share/man/man5/hosts.5 +++ b/share/man/man5/hosts.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: hosts.5,v 1.8 2000/01/05 01:04:14 deraadt Exp $ +.\" $OpenBSD: hosts.5,v 1.9 2000/03/19 19:25:29 aaron Exp $ .\" $NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -54,8 +54,9 @@ Aliases .Ed .Pp Items are separated by any number of blanks and/or -tab characters. A -.Dq # +tab characters. +A +.Ql # indicates the beginning of a comment; characters up to the end of the line are not interpreted by routines which search the file. @@ -87,7 +88,8 @@ Center .Pq Tn NIC , though local changes may be required to bring it up to date regarding unofficial aliases -and/or unknown hosts. As the data base maintained at +and/or unknown hosts. +As the data base maintained at .Tn NIC is incomplete, use of the name server is recommended for sites on the @@ -125,7 +127,8 @@ Lines in .Pa /etc/hosts are limited to .Dv BUFSIZE -characters (currently 1024). Longer lines will be ignored. +characters (currently 1024). +Longer lines will be ignored. .Sh HISTORY The .Nm diff --git a/share/man/man5/hosts.equiv.5 b/share/man/man5/hosts.equiv.5 index 760fc3194ee..3e0d9162f0c 100644 --- a/share/man/man5/hosts.equiv.5 +++ b/share/man/man5/hosts.equiv.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: hosts.equiv.5,v 1.3 1998/11/29 15:47:24 aaron Exp $ +.\" $OpenBSD: hosts.equiv.5,v 1.4 2000/03/19 19:25:29 aaron Exp $ .\" .\" Copyright (c) 1997 Todd Vierling .\" Copyright (c) 1997 The NetBSD Foundation, Inc. @@ -84,7 +84,8 @@ wildcard (allow all remote users). If a .Ar username is specified, only that user from the specified host may login to the -local machine. If a +local machine. +If a .Ar username is not specified, any user may login with the same user name. .Sh EXAMPLES @@ -100,7 +101,8 @@ The user .Ar username on .Ar somehost -may login to the local host. If specified in +may login to the local host. +If specified in .Pa /etc/hosts.equiv , the user may login with only the same user name. .Ed @@ -116,8 +118,10 @@ may login to the local host from any machine listed in the netgroup + + .Ed .Bd -filled -offset indent -compact -Two severe security hazards. In the first case, allows a user on any -machine to login to the local host as the same user name. In the second +Two severe security hazards. +In the first case, allows a user on any +machine to login to the local host as the same user name. +In the second case, allows any user on any machine to login to the local host (as any user, if in .Pa /etc/hosts.equiv ) . @@ -126,7 +130,8 @@ user, if in The user name checks provided by this mechanism are .Em not secure, as the remote user name is received by the server unchecked -for validity. Therefore this mechanism should only be used +for validity. +Therefore this mechanism should only be used in an environment where all hosts are completely trusted. .Pp A numeric host address instead of a host name can help security @@ -153,7 +158,8 @@ Logins as root only check root's .Pa .rhosts file; the .Pa /etc/hosts.equiv -file is not checked for security. Access permitted through root's +file is not checked for security. +Access permitted through root's .Pa .rhosts file is typically only for .Xr rsh 1 , diff --git a/share/man/man5/link.5 b/share/man/man5/link.5 index 7f0d6cf4524..0e966ab9b9b 100644 --- a/share/man/man5/link.5 +++ b/share/man/man5/link.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: link.5,v 1.6 1998/11/26 04:25:58 aaron Exp $ +.\" $OpenBSD: link.5,v 1.7 2000/03/19 19:25:30 aaron Exp $ .\" $NetBSD: link.5,v 1.5 1996/01/09 00:14:32 pk Exp $ .\" .\" Copyright (c) 1993 Paul Kranenburg @@ -43,14 +43,17 @@ The include file declares several structures that are present in dynamically linked programs and libraries. The structures define the interface between several components of the -link editor and loader mechanism. The layout of a number of these +link editor and loader mechanism. +The layout of a number of these structures within the binaries resembles the .Xr a.out 5 format in many places as it serves such similar functions as symbol definitions (including the accompanying string table) and relocation records needed to resolve -references to external entities. It also records a number of data structures -unique to the dynamic loading and linking process. These include references +references to external entities. +It also records a number of data structures +unique to the dynamic loading and linking process. +These include references to other objects that are required to complete the link-editing process and indirection tables to facilitate .Em Position Independent Code @@ -64,39 +67,47 @@ format offers no room for it elsewhere. .Pp Several utilities co-operate to ensure that the task of getting a program ready to run can complete successfully in a way that optimizes the use -of system resources. The compiler emits PIC code from which shared libraries -can be built by +of system resources. +The compiler emits PIC code from which shared libraries can be built by .Xr ld 1 . The compiler also includes size information of any initialized data items through the .Dq .size -assembler directive. PIC code differs from conventional code +assembler directive. +PIC code differs from conventional code in that it accesses data variables through an indirection table, the Global Offset Table, by convention accessible by the reserved name .Dv _GLOBAL_OFFSET_TABLE_ . The exact mechanism used for this is machine dependent, usually a machine -register is reserved for the purpose. The rational behind this construct -is to generate code that is independent of the actual load address. Only +register is reserved for the purpose. +The rational behind this construct +is to generate code that is independent of the actual load address. +Only the values contained in the Global Offset Table may need updating at run-time depending on the load addresses of the various shared objects in the address space. .Pp Likewise, procedure calls to globally defined functions are redirected through the Procedure Linkage Table (PLT) residing in the data segment of the core -image. Again, this is done to avoid run-time modifications to the text segment. +image. +Again, this is done to avoid run-time modifications to the text segment. .Pp The linker-editor allocates the Global Offset Table and Procedure Linkage Table when combining PIC object files into an image suitable for mapping into the -process address space. It also collects all symbols that may be needed by the +process address space. +It also collects all symbols that may be needed by the run-time link editor and stores these along with the image's text and data bits. Another reserved symbol, .Dv _DYNAMIC -is used to indicate the presence of the run-time linker structures. Whenever +is used to indicate the presence of the run-time linker structures. +Whenever .Dv _DYNAMIC is relocated to 0, there is no need to invoke the run-time -link editor. If this symbol is non-zero, it points at a data structure from +link editor. +If this symbol is non-zero, it points at a data structure from which the location of the necessary relocation and symbol information can -be derived. This is most notably used by the start-up module, +be derived. +This is most notably used by the start-up module, .Em crt0 . The .Dv _DYNAMIC @@ -118,17 +129,18 @@ structure: .Bd -literal -offset indent struct _dynamic { int d_version; - struct so_debug *d_debug; + struct so_debug *d_debug; union { struct section_dispatch_table *d_sdt; } d_un; - struct ld_entry *d_entry; + struct ld_entry *d_entry; }; .Ed .Bl -tag -width d_version .It Fa d_version This field provides for different versions of the dynamic linking -implementation. The current version numbers understood by ld and +implementation. +The current version numbers understood by ld and .Xr ld.so are LD_VERSION_SUN(3), which is used by the SunOS 4.x releases, and LD_VERSION_BSD(8), @@ -177,7 +189,8 @@ struct section_dispatch_table { .Pp .Bl -tag -width sdt_loaded .It Fa sdt_loaded -A pointer to the first link map loaded (see below). This field is set by +A pointer to the first link map loaded (see below). +This field is set by .Xr ld.so for the benefit of debuggers that may use it to load a shared object's symbol table. @@ -185,8 +198,8 @@ symbol table. The start of a (linked) list of shared object descriptors needed by this object. .It Fa sdt_paths -Library search rules. A colon separated list of directories corresponding -to the +Library search rules. +A colon separated list of directories corresponding to the .Fl R option of .Xr ld 1 . @@ -316,12 +329,15 @@ structure. Hook for attaching private data maintained by the run-time link editor. .El .Pp -Symbol description with size. This is simply an +Symbol description with size. +This is simply an .Fa nlist structure with one field .Pq Fa nz_size -added. Used to convey size information on items in the data segment -of shared objects. An array of these lives in the shared object's +added. +Used to convey size information on items in the data segment +of shared objects. +An array of these lives in the shared object's text segment and is addressed by the .Fa sdt_nzlist field of @@ -370,14 +386,15 @@ The index of the symbol in the shared object's symbol table (as given by the field). .It Fa rh_next In case of collisions, this field is the offset of the next entry in this -hash table bucket. It is zero for the last bucket element. +hash table bucket. +It is zero for the last bucket element. .El .Pp The .Fa rt_symbol structure is used to keep track of run-time allocated commons -and data items copied from shared objects. These items are kept on linked list -and is exported through the +and data items copied from shared objects. +These items are kept on linked list and is exported through the .Fa dd_cc field in the .Fa so_debug @@ -399,7 +416,8 @@ The symbol description. Virtual address of next .Fa rt_symbol . .It Fa rt_link -Next in hash bucket. Used by internally by +Next in hash bucket. +Used by internally by .Xr ld.so . .It Fa rt_srcaddr Location of the source of initialized data within a shared object. @@ -412,7 +430,8 @@ The .Fa so_debug structure is used by debuggers to gain knowledge of any shared objects that have been loaded in the process's address space as a result of run-time -link-editing. Since the run-time link editor runs as a part of process +link-editing. +Since the run-time link editor runs as a part of process initialization, a debugger that wishes to access symbols from shared objects can only do so after the link editor has been called from .Em crt0 . @@ -427,7 +446,7 @@ struct so_debug { int dd_version; int dd_in_debugger; int dd_sym_loaded; - char *dd_bpt_addr; + char *dd_bpt_addr; int dd_bpt_shadow; struct rt_symbol *dd_cc; }; @@ -443,8 +462,8 @@ run under control of a debugger. Set by the run-time linker whenever it adds symbols by loading shared objects. .It Fa dd_bpt_addr The address where a breakpoint will be set by the run-time linker to -divert control to the debugger. This address is determined by the start-up -module, +divert control to the debugger. +This address is determined by the start-up module, .Em crt0.o , to be some convenient place before the call to .Fa _main . @@ -507,7 +526,8 @@ was loaded by .It Fa crt_dzfd On SunOS systems, this field contains an open file descriptor to .Pa /dev/zero -used to get demand paged zeroed pages. On +used to get demand paged zeroed pages. +On .Ox systems it contains -1. .It Fa crt_ldfd @@ -584,7 +604,8 @@ Size of strings. Maximum usable offset in hints file. .It Fa hh_dirlist Offset in string table of a colon-separated list of directories that was -used in constructing the hints file. See also +used in constructing the hints file. +See also .Xr ldconfig 8 . This field is only available with interface version number .Dv LD_HINTS_VERSION_2 diff --git a/share/man/man5/netgroup.5 b/share/man/man5/netgroup.5 index 59169ce0b69..ff61e9a9e52 100644 --- a/share/man/man5/netgroup.5 +++ b/share/man/man5/netgroup.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: netgroup.5,v 1.7 1999/07/09 13:35:38 aaron Exp $ +.\" $OpenBSD: netgroup.5,v 1.8 2000/03/19 19:25:30 aaron Exp $ .\" $NetBSD: netgroup.5,v 1.3 1995/03/18 14:58:34 cgd Exp $ .\" .\" Copyright (c) 1992, 1993 @@ -92,7 +92,8 @@ file which can be generated using .Xr netgroup_mkdb . If that file is not present, and the system supports NIS, then the .Nm -NIS maps are used. The NIS maps are also used if the +NIS maps are used. +The NIS maps are also used if the .Nm file contains a .Dq + diff --git a/share/man/man5/passwd.5 b/share/man/man5/passwd.5 index c1f7b8c3b6b..4385223ab55 100644 --- a/share/man/man5/passwd.5 +++ b/share/man/man5/passwd.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: passwd.5,v 1.13 2000/03/01 18:01:22 aaron Exp $ +.\" $OpenBSD: passwd.5,v 1.14 2000/03/19 19:25:31 aaron Exp $ .\" $NetBSD: passwd.5,v 1.4 1995/07/28 06:46:05 phil Exp $ .\" .\" Copyright (c) 1988, 1991, 1993 @@ -47,7 +47,8 @@ The file, readable only by root, consists of newline-separated records, one per user, containing ten colon .Pq Sq \&: -separated fields. These fields are as follows: +separated fields. +These fields are as follows: .Pp .Bl -tag -width password -offset indent -compact .It name diff --git a/share/man/man5/passwd.conf.5 b/share/man/man5/passwd.conf.5 index ca45ef801c2..d215df0a0a2 100644 --- a/share/man/man5/passwd.conf.5 +++ b/share/man/man5/passwd.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: passwd.conf.5,v 1.8 1999/07/09 13:35:38 aaron Exp $ +.\" $OpenBSD: passwd.conf.5,v 1.9 2000/03/19 19:25:31 aaron Exp $ .\" .\" Copyright 1997 Niels Provos <provos@physnet.uni-hamburg.de> .\" All rights reserved. @@ -42,8 +42,8 @@ file, consisting of describes the configuration of the password cipher used to encrypt local or YP passwords. .Pp -There are default, user and group specific stanzas. If no user -or group +There are default, user and group specific stanzas. +If no user or group stanza to a specific option is available, the default stanza is used. .Pp @@ -51,12 +51,11 @@ To differentiate between user and group stanzas, groups are prefixed with a single dot .Pq Sq \&. . .Pp -Some of the fields and their possible values that can appear in -this file are: -.Pp -.Bl -tag -width localcipher -offset indent -.It localcipher -The cipher to use for local passwords. Possible values are: +Some fields and their possible values that can appear in this file are: +.Bl -tag -width localcipher +.It Sy localcipher +The cipher to use for local passwords. +Possible values are: .Dq old , .Dq newsalt,<rounds> , .Dq md5 , @@ -67,19 +66,20 @@ For the value of rounds is a 24-bit integer with a minmum of 7250 rounds. For .Dq blowfish -the value can be between 4 and 31. It specifies the base 2 logarithm of -the number of rounds. -.It ypcipher -The cipher to use for YP passwords. The possible values are the same as -for localcipher. +the value can be between 4 and 31. +It specifies the base 2 logarithm of the number of rounds. +.It Sy ypcipher +The cipher to use for YP passwords. +The possible values are the same as for localcipher. .El .Pp To retrieve information from this file use .Xr pw_getconf 3 . .Pp -.Sh EXAMPLE +.Sh EXAMPLES Use blowfish as the local cipher; add some more rounds for root and wheel -members. The old Unix crypt is used as YP cipher: +members. +The old Unix crypt is used as YP cipher: .Bd -literal default: localcipher = blowfish,4 @@ -91,6 +91,10 @@ members. The old Unix crypt is used as YP cipher: .wheel: localcipher = blowfish,5 .Ed +.Sh FILES +.Bl -tag -width /etc/passwd.conf -compact +.It Pa /etc/passwd.conf +.El .Sh SEE ALSO .Xr passwd 1 , .Xr pw_getconf 3 , diff --git a/share/man/man5/phones.5 b/share/man/man5/phones.5 index 0279ca42368..c161b137649 100644 --- a/share/man/man5/phones.5 +++ b/share/man/man5/phones.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: phones.5,v 1.4 2000/03/01 18:01:21 aaron Exp $ +.\" $OpenBSD: phones.5,v 1.5 2000/03/19 19:25:31 aaron Exp $ .\" $NetBSD: phones.5,v 1.3 1994/11/30 19:31:25 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -56,10 +56,11 @@ The system name is one of those defined in the file and the phone number is constructed from any sequence of characters terminated only by .Ql \&, -or the end of the line. The +or the end of the line. +The .Ql = and -.Ql \&* +.Ql * characters are indicators to the auto call units to pause and wait for a second dial tone (when going through an exchange). @@ -68,7 +69,7 @@ The is required by the .Tn DF02-AC and the -.Ql \&* +.Ql * is required by the .Tn BIZCOMP 1030. diff --git a/share/man/man5/protocols.5 b/share/man/man5/protocols.5 index 242652afacf..ed5693c5983 100644 --- a/share/man/man5/protocols.5 +++ b/share/man/man5/protocols.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: protocols.5,v 1.6 2000/02/29 04:48:39 aaron Exp $ +.\" $OpenBSD: protocols.5,v 1.7 2000/03/19 19:25:32 aaron Exp $ .\" $NetBSD: protocols.5,v 1.3 1994/11/30 19:31:27 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -45,7 +45,8 @@ The .Nm file contains information regarding the known protocols used in the .Tn DARPA -Internet. For each protocol a single line should be present +Internet. +For each protocol a single line should be present with the following information: .Bd -unfilled -offset indent official protocol name @@ -77,7 +78,8 @@ Lines in .Pa /etc/protocols are limited to .Dv BUFSIZ -characters (currently 1024). Longer lines will be ignored. +characters (currently 1024). +Longer lines will be ignored. .Sh HISTORY The .Nm diff --git a/share/man/man5/remote.5 b/share/man/man5/remote.5 index e4012183fae..1030ef93058 100644 --- a/share/man/man5/remote.5 +++ b/share/man/man5/remote.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: remote.5,v 1.6 2000/02/29 04:48:39 aaron Exp $ +.\" $OpenBSD: remote.5,v 1.7 2000/03/19 19:25:32 aaron Exp $ .\" $NetBSD: remote.5,v 1.4 1997/04/20 00:05:27 mellon Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -48,7 +48,8 @@ and their attributes are stored in an file which is structured somewhat like the .Xr termcap 5 -file. Each line in the file provides a description for a single +file. +Each line in the file provides a description for a single .Xr system . Fields are separated by a colon .Pq Sq \&: . @@ -57,14 +58,15 @@ Lines ending with a character immediately followed by a newline are continued on the next line. .Pp -The first entry is the name(s) of the host system. If there is more +The first entry is the name(s) of the host system. +If there is more than one name for a system, the names are separated by vertical bars .Pq Sq \&| . -After the name of the system comes the fields of the description. A -field name followed by an equal sign +After the name of the system comes the fields of the description. +A field name followed by an equal sign .Pq Sq = -indicates a string value follows. A field -name followed by a pound sign +indicates a string value follows. +A field name followed by a pound sign .Pq Sq # indicates a following numeric value. .Pp @@ -78,20 +80,23 @@ and the .Xr cu interface to .Xr tip , -as follows. When +as follows. +When .Xr tip is invoked with only a phone number, it looks for an entry of the form .Dq tip300 , where 300 is the baud rate with -which the connection is to be made. When the +which the connection is to be made. +When the .Xr cu interface is used, entries of the form .Dq cu300 are used. .Sh CAPABILITIES Capabilities are either strings (str), numbers (num), or boolean -flags (bool). A string capability is specified by +flags (bool). +A string capability is specified by .Em capability Ns Ar = Ns Em value ; for example, .Dq dv=/dev/harris . @@ -114,8 +119,8 @@ The default baud rate is 300 baud. .It Sy \&cm (str) An initial connection message to be sent -to the remote host. For example, if a -host is reached through port selector, this +to the remote host. +For example, if a host is reached through port selector, this might be set to the appropriate sequence required to switch to the host. .It Sy \&cu @@ -181,7 +186,8 @@ string is sent at end-of-file. .It Sy \&pa (str) The type of parity to use when sending data -to the host. This may be one of +to the host. +This may be one of .Dq even , .Dq odd , .Dq none , @@ -204,8 +210,8 @@ file for a list of telephone numbers (see .It Sy \&tc (str) Indicates that the list of capabilities is continued -in the named description. This is used -primarily to share common capability information. +in the named description. +This is used primarily to share common capability information. .El .Pp Here is a short example showing the use of the capability continuation diff --git a/share/man/man5/resolv.conf.5 b/share/man/man5/resolv.conf.5 index e44011e261d..af28bc4872d 100644 --- a/share/man/man5/resolv.conf.5 +++ b/share/man/man5/resolv.conf.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: resolv.conf.5,v 1.11 2000/02/14 13:23:54 itojun Exp $ +.\" $OpenBSD: resolv.conf.5,v 1.12 2000/03/19 19:25:33 aaron Exp $ .\" $NetBSD: resolv.conf.5,v 1.7 1996/03/06 18:22:16 scottr Exp $ .\" .\" Copyright (c) 1986, 1991 The Regents of the University of California. @@ -213,8 +213,8 @@ to a space-separated list of resolver options as explained above. The keyword and value must appear on a single line, and the keyword (e.g., .Sy nameserver ) -must start the line. The value follows -the keyword, separated by whitespace. +must start the line. +The value follows the keyword, separated by whitespace. .Sh FILES .Bl -tag -width /etc/resolv.conf -compact .It Pa /etc/resolv.conf diff --git a/share/man/man5/services.5 b/share/man/man5/services.5 index ff81e755ba8..898fd7a9ca9 100644 --- a/share/man/man5/services.5 +++ b/share/man/man5/services.5 @@ -1,4 +1,4 @@ -.\" $OpenBSD: services.5,v 1.7 2000/02/29 04:48:39 aaron Exp $ +.\" $OpenBSD: services.5,v 1.8 2000/03/19 19:25:33 aaron Exp $ .\" $NetBSD: services.5,v 1.3 1994/11/30 19:31:31 jtc Exp $ .\" .\" Copyright (c) 1983, 1991, 1993 @@ -56,9 +56,8 @@ protocol name aliases .Ed .Pp -Items are separated by any number of blanks and/or -tab characters. The port number and protocol name -are considered a single item; +Items are separated by any number of blanks and/or tab characters. +The port number and protocol name are considered a single item; a slash .Pq Ql / is used to @@ -86,7 +85,8 @@ Lines in .Pa /etc/services are limited to .Dv BUFSIZ -characters (currently 1024). Longer lines will be ignored. +characters (currently 1024). +Longer lines will be ignored. .Sh HISTORY The .Nm |