diff options
Diffstat (limited to 'share/man/man5')
-rw-r--r-- | share/man/man5/a.out.5 | 2 | ||||
-rw-r--r-- | share/man/man5/devfs.5 | 3 | ||||
-rw-r--r-- | share/man/man5/disktab.5 | 9 | ||||
-rw-r--r-- | share/man/man5/elf.5 | 6 | ||||
-rw-r--r-- | share/man/man5/forward.5 | 9 | ||||
-rw-r--r-- | share/man/man5/fs.5 | 18 | ||||
-rw-r--r-- | share/man/man5/fstab.5 | 11 | ||||
-rw-r--r-- | share/man/man5/hosts.5 | 6 | ||||
-rw-r--r-- | share/man/man5/hosts.equiv.5 | 6 | ||||
-rw-r--r-- | share/man/man5/link.5 | 3 | ||||
-rw-r--r-- | share/man/man5/mailer.conf.5 | 11 | ||||
-rw-r--r-- | share/man/man5/networks.5 | 2 | ||||
-rw-r--r-- | share/man/man5/passwd.5 | 21 | ||||
-rw-r--r-- | share/man/man5/pbm.5 | 3 | ||||
-rw-r--r-- | share/man/man5/phones.5 | 15 | ||||
-rw-r--r-- | share/man/man5/procfs.5 | 9 | ||||
-rw-r--r-- | share/man/man5/protocols.5 | 6 | ||||
-rw-r--r-- | share/man/man5/rc.conf.5 | 4 | ||||
-rw-r--r-- | share/man/man5/remote.5 | 3 | ||||
-rw-r--r-- | share/man/man5/services.5 | 2 | ||||
-rw-r--r-- | share/man/man5/stab.5 | 2 | ||||
-rw-r--r-- | share/man/man5/sysctl.conf.5 | 6 |
22 files changed, 102 insertions, 55 deletions
diff --git a/share/man/man5/a.out.5 b/share/man/man5/a.out.5 index ac186d53ad4c..e816a57a38e2 100644 --- a/share/man/man5/a.out.5 +++ b/share/man/man5/a.out.5 @@ -129,7 +129,7 @@ if necessary. .El .Pp If both EX_DYNAMIC and EX_PIC are set, the object file is a position independent -executable image (eg. a shared library), which is to be loaded into the +executable image (e.g.\& a shared library), which is to be loaded into the process address space by the run-time link editor. .Pp The macro diff --git a/share/man/man5/devfs.5 b/share/man/man5/devfs.5 index 2d882043a7b4..173ab19d74f7 100644 --- a/share/man/man5/devfs.5 +++ b/share/man/man5/devfs.5 @@ -57,7 +57,8 @@ The conventional mount point is .Pa /dev . .Pp The file system includes several directories, links, symbolic links -and devices, some of which can also be written. In a chroot'ed +and devices, some of which can also be written. +In a chroot'ed environment, .Nm can be used to create a new diff --git a/share/man/man5/disktab.5 b/share/man/man5/disktab.5 index ab9bef8bfd45..cf33790c5d99 100644 --- a/share/man/man5/disktab.5 +++ b/share/man/man5/disktab.5 @@ -52,11 +52,14 @@ to initialize the disk label on the disk. The format is patterned after the .Xr termcap 5 -terminal data base. Entries in +terminal data base. +Entries in .Nm -consist of a number of `:'-separated fields. The +consist of a number of `:'-separated fields. +The first field for each entry gives the names by which a -disk's entry may be selected, separated by `|' characters. The +disk's entry may be selected, separated by `|' characters. +The last name given should be a long name fully identifying the disk. .Pp diff --git a/share/man/man5/elf.5 b/share/man/man5/elf.5 index 01792c433a2e..5f52875e76ca 100644 --- a/share/man/man5/elf.5 +++ b/share/man/man5/elf.5 @@ -351,7 +351,8 @@ file has no section header table this member holds zero. .It Dv e_flags This member holds processor-specific flags associated with the file. Flag -names take the form EF_`machine_flag'. Currently no flags have been defined. +names take the form EF_`machine_flag'. +Currently no flags have been defined. .It Dv e_ehsize This member holds the ELF header's size in bytes. .It Dv e_phentsize @@ -475,7 +476,8 @@ The array element specifies dynamic linking information. The array element specifies the location and size of a null-terminated path name to invoke as an interpreter. This segment type is meaningful -only for executable files (though it may occur for shared objects). However +only for executable files (though it may occur for shared objects). +However it may not occur more than once in a file. If it is present it must precede any loadable segment entry. diff --git a/share/man/man5/forward.5 b/share/man/man5/forward.5 index b6d0e46894ed..2234ff359091 100644 --- a/share/man/man5/forward.5 +++ b/share/man/man5/forward.5 @@ -41,13 +41,16 @@ The .Nm .forward file contains a list of mail addresses or programs -that the user's mail should be redirected to. If the +that the user's mail should be redirected to. +If the file is not present, then no mail forwarding will be done. Mail may also be forwarded as the standard input to a program by prefixing the line -with the normal shell pipe symbol (|). If arguments +with the normal shell pipe symbol (|). +If arguments are to be passed to the command, then the entire line -should be enclosed in quotes. For security reasons, the +should be enclosed in quotes. +For security reasons, the .Nm .forward file must be owned by the user the mail is being sent to, or by root, and the user's shell must be listed in diff --git a/share/man/man5/fs.5 b/share/man/man5/fs.5 index 48b4c1b56e73..368f11cffc8c 100644 --- a/share/man/man5/fs.5 +++ b/share/man/man5/fs.5 @@ -203,15 +203,18 @@ 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 +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 Addresses stored in inodes are capable of addressing fragments -of `blocks'. File system blocks of at most size +of `blocks'. +File system blocks of at most size .Dv MAXBSIZE can be optionally broken into 2, 4, or 8 pieces, each of which is @@ -222,12 +225,15 @@ a .Dv DEV_BSIZE unit. .Pp -Large files consist of exclusively large data blocks. To avoid +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 fs ip lbn macro. diff --git a/share/man/man5/fstab.5 b/share/man/man5/fstab.5 index e2a90adff46c..7e8f10ca85cb 100644 --- a/share/man/man5/fstab.5 +++ b/share/man/man5/fstab.5 @@ -86,8 +86,10 @@ The system can support various file system types. Only the root, /usr, and /tmp file systems need be statically compiled into the kernel; everything else will be automatically loaded at mount -time. (Exception: the UFS family - FFS and LFS cannot -currently be demand-loaded.) Some people still prefer to statically +time. +(Exception: the UFS family - FFS and LFS cannot +currently be demand-loaded.) +Some people still prefer to statically compile other file systems as well. .Pp The fourth field, @@ -97,7 +99,8 @@ It is formatted as a comma separated list of options. It contains at least the type of mount (see .Fa fs_type below) plus any additional options -appropriate to the file system type. See the options flag +appropriate to the file system type. +See the options flag .Pq Fl o in the .Xr mount 8 @@ -131,7 +134,7 @@ If the option ``noauto'' is specified, the file system will not be automatically mounted at system startup. Note that, for network file systems of third party types -(i.e. types supported by additional software +(i.e., types supported by additional software not included in the base system) to be automatically mounted at system startup, the diff --git a/share/man/man5/hosts.5 b/share/man/man5/hosts.5 index 79b20c327541..218a4df37196 100644 --- a/share/man/man5/hosts.5 +++ b/share/man/man5/hosts.5 @@ -55,7 +55,8 @@ aliases .Ed .Pp Items are separated by any number of blanks and/or -tab characters. A ``#'' indicates the beginning of +tab characters. +A ``#'' indicates the beginning of a comment; characters up to the end of the line are not interpreted by routines which search the file. .Pp @@ -75,7 +76,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 diff --git a/share/man/man5/hosts.equiv.5 b/share/man/man5/hosts.equiv.5 index e824e51dedd3..c180d2a73ea6 100644 --- a/share/man/man5/hosts.equiv.5 +++ b/share/man/man5/hosts.equiv.5 @@ -63,7 +63,8 @@ A indicates a host by netgroup or user by netgroup. A single .Dq + -matches all hosts or users. A host name with a leading +matches all hosts or users. +A host name with a leading .Dq - will reject all matching hosts and all their users. @@ -72,7 +73,8 @@ A user name with leading will reject all matching users from matching hosts. .Pp Items are separated by any number of blanks and/or -tab characters. A +tab characters. +A .Dq # indicates the beginning of a comment; characters up to the end of the line are diff --git a/share/man/man5/link.5 b/share/man/man5/link.5 index 8d443d8287cc..73f0a4555357 100644 --- a/share/man/man5/link.5 +++ b/share/man/man5/link.5 @@ -180,7 +180,8 @@ struct section_dispatch_table { .Pp .Bl -tag -width sdt_filler1 .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 .Nm ld.so .It Fa sdt_sods The start of a (linked) list of shared object descriptors needed by diff --git a/share/man/man5/mailer.conf.5 b/share/man/man5/mailer.conf.5 index b6971da04a86..87c12499ce12 100644 --- a/share/man/man5/mailer.conf.5 +++ b/share/man/man5/mailer.conf.5 @@ -41,7 +41,8 @@ .Sh DESCRIPTION The file .Pa /etc/mail/mailer.conf -contains a series of pairs. The first member of each pair is the name +contains a series of pairs. +The first member of each pair is the name of a program invoking .Xr mailwrapper 8 which is typically a symbolic link to @@ -52,7 +53,8 @@ and .Xr mailq 1 would be set up this way.) The second member of each pair is the name of the program to -actually execute when the first name is invoked. The file may also +actually execute when the first name is invoked. +The file may also contain comments, denoted by a # mark in the first column of any line. .Sh EXAMPLES The following is an example of how to set up an @@ -88,9 +90,10 @@ newaliases /usr/local/sbin/sendmail appeared in .Nx 1.4 . .Sh AUTHORS -Perry E. Metzger <perry@piermont.com> +.An Perry E. Metzger Aq perry@piermont.com .Sh BUGS -The entire reason this program exists is a crock. Instead, a command +The entire reason this program exists is a crock. +Instead, a command for how to submit mail should be standardized, and all the "behave differently if invoked with a different name" behavior of things like .Xr mailq 1 diff --git a/share/man/man5/networks.5 b/share/man/man5/networks.5 index 04ec15b5179d..ff622674b7a0 100644 --- a/share/man/man5/networks.5 +++ b/share/man/man5/networks.5 @@ -63,7 +63,7 @@ changes may be required to bring it up to date regarding unofficial aliases and/or unknown networks. .Pp Network numbers may be specified in the conventional -``.'' (dot) notation using the +``.'' (dot) notation using the .Xr inet_network 3 routine from the Internet address manipulation library, diff --git a/share/man/man5/passwd.5 b/share/man/man5/passwd.5 index e1a4ac328a72..9476ec05d8f3 100644 --- a/share/man/man5/passwd.5 +++ b/share/man/man5/passwd.5 @@ -65,7 +65,8 @@ The .Nm master.passwd file is readable only by root, and consists of newline separated records, one per user, containing ten colon (``:'') separated -fields. These fields are as follows: +fields. +These fields are as follows: .Pp .Bl -tag -width password -offset indent .It name @@ -105,18 +106,21 @@ The .Ar name field is the login used to access the computer account, and the .Ar uid -field is the number associated with it. They should both be unique +field is the number associated with it. +They should both be unique across the system (and often across a group of systems) since they control file access. .Pp While it is possible to have multiple entries with identical login names -and/or identical user id's, it is usually a mistake to do so. Routines +and/or identical user id's, it is usually a mistake to do so. +Routines that manipulate these files will often return only one of the multiple entries, and that one by random selection. .Pp The login name must never begin with a hyphen (``-''); also, it is strongly suggested that neither upper-case characters or dots (``.'') be part -of the name, as this tends to confuse mailers. No field may contain a +of the name, as this tends to confuse mailers. +No field may contain a colon (``:'') as this has been used historically to separate the fields in the user database. .Pp @@ -126,7 +130,8 @@ form of the password. If the .Ar password field is empty, no password will be required to gain access to the -machine. This is almost invariably a mistake. +machine. +This is almost invariably a mistake. Because these files contain the encrypted user passwords, they should not be readable by anyone without appropriate privileges. .Pp @@ -137,7 +142,8 @@ this field currently has little special meaning. .Pp The .Ar class -field is a key for a user's login class. Login classes +field is a key for a user's login class. +Login classes are defined in .Xr login.conf 5 , which is a @@ -280,7 +286,8 @@ or fields, the specified numbers will override the information retrieved from the Hesiod domain or the .Tn NIS -maps. As well, if the +maps. +As well, if the .Ar gecos , .Ar dir or diff --git a/share/man/man5/pbm.5 b/share/man/man5/pbm.5 index 228315b9f86f..55d2c5c1be39 100644 --- a/share/man/man5/pbm.5 +++ b/share/man/man5/pbm.5 @@ -62,7 +62,8 @@ Programs that read this format should be as lenient as possible, accepting anything that looks remotely like a bitmap. .Pp There is also a variant on the format, available -by setting the RAWBITS option at compile time. This variant is +by setting the RAWBITS option at compile time. +This variant is different in the following ways: .Pp .Bl -bullet -compact diff --git a/share/man/man5/phones.5 b/share/man/man5/phones.5 index f3360c3d2385..59b491b61eb9 100644 --- a/share/man/man5/phones.5 +++ b/share/man/man5/phones.5 @@ -44,22 +44,27 @@ The file contains the system-wide private phone numbers for the .Xr tip 1 -program. This file is normally unreadable, and so may contain -privileged information. The format of the file is a series of lines -of the form: <system-name>[\ \et]*<phone-number>. The system name is +program. +This file is normally unreadable, and so may contain +privileged information. +The format of the file is a series of lines +of the form: <system-name>[\ \et]*<phone-number>. +The system name is one of those defined in the .Xr remote 5 file and the phone number is constructed from any sequence of characters terminated only by ``,'' or the end of the line. The ``='' and ``*'' characters are indicators to the auto call units to pause and wait for a second dial -tone (when going through an exchange). The ``='' is required by the +tone (when going through an exchange). +The ``='' is required by the .Tn DF02-AC and the ``*'' is required by the .Tn BIZCOMP 1030. .Pp -Only one phone number per line is permitted. However, if more than +Only one phone number per line is permitted. +However, if more than one line in the file contains the same system name .Xr tip 1 will attempt to dial each one in turn, until it establishes a connection. diff --git a/share/man/man5/procfs.5 b/share/man/man5/procfs.5 index 169421e3cd80..47f5f9addfa0 100644 --- a/share/man/man5/procfs.5 +++ b/share/man/man5/procfs.5 @@ -30,7 +30,8 @@ provides a two-level view of process space, unlike the previous .Nm implementation. At the highest level, processes themselves are named, according to -their process ids in decimal, with no leading zeros. There is also a +their process ids in decimal, with no leading zeros. +There is also a special node called .Pa curproc which always refers to the process making the lookup request. @@ -107,9 +108,11 @@ Only those address which exist in the process can be accessed. Reads and writes to this file modify the process. Writes to the text segment remain private to the process. .It Pa note -Used for sending signals to the process. Not implemented. +Used for sending signals to the process. +Not implemented. .It Pa notepg -Used for sending signal to the process group. Not implemented. +Used for sending signal to the process group. +Not implemented. .It Pa regs Allows read and write access to the process' register set. This file contains a binary data structure diff --git a/share/man/man5/protocols.5 b/share/man/man5/protocols.5 index a8ad7a46153f..fb9577e8da34 100644 --- a/share/man/man5/protocols.5 +++ b/share/man/man5/protocols.5 @@ -43,7 +43,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 @@ -52,7 +53,8 @@ aliases .Ed .Pp Items are separated by any number of blanks and/or -tab characters. A ``#'' indicates the beginning of +tab characters. +A ``#'' indicates the beginning of a comment; characters up to the end of the line are not interpreted by routines which search the file. .Pp diff --git a/share/man/man5/rc.conf.5 b/share/man/man5/rc.conf.5 index eb999e9c5be7..6aa9820597e0 100644 --- a/share/man/man5/rc.conf.5 +++ b/share/man/man5/rc.conf.5 @@ -1728,7 +1728,7 @@ operation. .Pq Vt bool If set to .Dq Li YES , -configure host to act as an IP router, e.g. to forward packets +configure host to act as an IP router, e.g.\& to forward packets between interfaces. .It Va ipv6_gateway_enable .Pq Vt bool @@ -2227,7 +2227,7 @@ Microsoft mouse (serial) .It Li intellimouse Microsoft IntelliMouse (serial) .It Li mousesystems -Mouse systems Corp. mouse (serial) +Mouse systems Corp.\& mouse (serial) .It Li mmseries MM Series mouse (serial) .It Li logitech diff --git a/share/man/man5/remote.5 b/share/man/man5/remote.5 index e50f1f3a6613..edc3e1786cec 100644 --- a/share/man/man5/remote.5 +++ b/share/man/man5/remote.5 @@ -77,7 +77,8 @@ When the interface is used, entries of the form ``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, ``dv=/dev/harris''. A numeric capability is specified by diff --git a/share/man/man5/services.5 b/share/man/man5/services.5 index 18e3ed8708e6..738573dd5a76 100644 --- a/share/man/man5/services.5 +++ b/share/man/man5/services.5 @@ -57,7 +57,7 @@ Items are separated by any number of blanks and/or tab characters. The port number and protocol name are considered a single .Em item ; a ``/'' is used to -separate the port and protocol (e.g. ``512/tcp''). +separate the port and protocol (e.g.\& ``512/tcp''). A ``#'' indicates the beginning of a comment; subsequent characters up to the end of the line are not interpreted by the routines which search the file. diff --git a/share/man/man5/stab.5 b/share/man/man5/stab.5 index 14eeef521e25..397a58b218c9 100644 --- a/share/man/man5/stab.5 +++ b/share/man/man5/stab.5 @@ -46,7 +46,7 @@ The file defines some of the symbol table .Fa n_type field values for a.out files. -These are the types for permanent symbols (i.e. not local labels, etc.) +These are the types for permanent symbols (i.e., not local labels, etc.) used by the old debugger .Em sdb and the Berkeley Pascal compiler diff --git a/share/man/man5/sysctl.conf.5 b/share/man/man5/sysctl.conf.5 index d302d6b476fd..0e69bcc13859 100644 --- a/share/man/man5/sysctl.conf.5 +++ b/share/man/man5/sysctl.conf.5 @@ -34,7 +34,8 @@ The .Pa /etc/sysctl.conf file is read in when the system goes into multi-user mode to set default -settings for the kernel. The +settings for the kernel. +The .Pa /etc/sysctl.conf is in the format of the .Xr sysctl 8 @@ -45,7 +46,8 @@ sysctl_mib=value .Pp Comments are denoted by a .Dq # -at the beginning of a line. Comments can also exist at the end of a line, +at the beginning of a line. +Comments can also exist at the end of a line, as seen in the .Sx EXAMPLES section, below. |