Aren/NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

use Dq as appropriate

Browse Source
This commit is contained in:
lukem 2000-11-17 10:14:16 +00:00
parent 18a3e2e22d
commit 71e62d7ddb
19 changed files with 186 additions and 97 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
share/man/man5/ar.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ar.5,v 1.1 1998/08/22 05:29:57 tv Exp $
.\" $NetBSD: ar.5,v 1.2 2000/11/17 10:14:16 lukem Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -51,7 +51,10 @@ loaded using the link-editor
.Pp
A file created with
.Nm
begins with the ``magic'' string "!<arch>\en".
begins with the
.Dq magic
string
.Dq Li "!<arch>\en" .
The rest of the archive is made up of objects, each of which is composed
of a header for a file, a possible file name, and the file contents.
The header is portable between machine architectures, and, if the file
@ -102,7 +105,8 @@ If any fields are their particular maximum number of characters in
length, there will be no separation between the fields.
.Pp
Objects in the archive are always an even number of bytes long; files
which are an odd number of bytes long are padded with a newline (``\en'')
which are an odd number of bytes long are padded with a newline
.Pq Dq \en
character, although the size in the header does not reflect this.
.Sh SEE ALSO
.Xr ar 1 ,
@ -111,8 +115,9 @@ character, although the size in the header does not reflect this.
There have been at least four
.Nm
formats.
The first was denoted by the leading ``magic'' number 0177555 (stored as
type int).
The first was denoted by the leading
.Dq magic
number 0177555 (stored as type int).
These archives were almost certainly created on a 16-bit machine, and
contain headers made up of five fields.
The fields are the object name (8 characters), the file last modification
@ -120,8 +125,9 @@ time (type long), the user id (type char), the file mode (type char) and
the file size (type unsigned int).
Files were padded to an even number of bytes.
.Pp
The second was denoted by the leading ``magic'' number 0177545 (stored as
type int).
The second was denoted by the leading
.Dq magic
number 0177545 (stored as type int).
These archives may have been created on either 16 or 32-bit machines, and
contain headers made up of six fields.
The fields are the object name (14 characters), the file last modification

22
share/man/man5/core.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: core.5,v 1.12 2000/10/07 17:45:26 nathanw Exp $
.\" $NetBSD: core.5,v 1.13 2000/11/17 10:14:17 lukem Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -47,6 +47,7 @@ also cause a record of the process's in-core state to be written
to disk for later examination by one of the available debuggers
(see
.Xr signal 7 ).
.Pp
This memory image is written to a file named from a per-process template;
provided the terminated process had write permission, and provided the
abnormality did not cause a system crash.
@ -58,15 +59,20 @@ variable
(where <pid> has to be replaced by the pid in decimal format of the
process).
This template is either an absolute or relative path name, in which format
characters can be used, preceeded by the percent character (``%'').
The following characters are recognised as format and subsitued:
.Bl -column "cAA" "The process's creation date (in seconds)xxx" -offset indent
.It Li n The process's name
.It Li p The PID of the process (in decimal)
.It Li t The process's creation date (a la
characters can be used, preceeded by the percent character
.Pq Dq \&% .
The following characters are recognised as format and subsituted:
.Bl -tag -width 4n -offset indent -compact
.It Sy n
The process's name
.It Sy p
The PID of the process (in decimal)
.It Sy t
The process's creation date (a la
.Xr time 3 ,
in decimal)
.It Li u The login name, as returned by
.It Sy u
The login name, as returned by
.Xr getlogin 2
.El
.Pp

22
share/man/man5/daily.conf.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: daily.conf.5,v 1.6 2000/08/25 01:11:43 hubertf Exp $
.\" $NetBSD: daily.conf.5,v 1.7 2000/11/17 10:14:17 lukem Exp $
.\"
.\" Copyright (c) 1996 Matthew R. Green
.\" All rights reserved.
@ -52,7 +52,9 @@ over the entire local filesystem, looking for core files.
.It Sy run_msgs
This runs
.Xr msgs 1
with the ``-c'' argument.
with the
.Fl c
argument.
.It Sy expire_news
This runs the
.Pa /etc/expire.news
@ -63,13 +65,17 @@ This ages accounting files in
.It Sy run_calendar
This runs
.Xr calendar 1
with the ``-a'' argument.
with the
.Fl a
argument.
.It Sy check_uucp
This runs the
.Pa /etc/uuclean.daily
script, as the daemon user, and runs
.Xr uustat 1
with the ``-a'' argument.
with the
.Fl a
argument.
.It Sy check_disks
This uses the
.Xr df 1
@ -82,7 +88,9 @@ This runs
.It Sy check_network
This runs
.Xr netstat 1
with the ``-i'' argument, and also checks the
with the
.Fl i
argument, and also checks the
.Xr rwhod 8
database, and runs
.Xr ruptime 1
@ -91,7 +99,9 @@ if there are hosts in
.It Sy run_fsck
This runs
.Xr fsck 8
with the ``-n'' option.
with the
.Fl n
option.
.It Sy run_rdist
This runs
.Xr rdist 1

6
share/man/man5/ethers.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ethers.5,v 1.6 2000/11/07 07:17:13 lukem Exp $
.\" $NetBSD: ethers.5,v 1.7 2000/11/17 10:14:17 lukem Exp $
.\"
.\" Written by Roland McGrath <roland@frob.com>. Public domain.
.\"
@ -14,7 +14,9 @@ The
file maps Ethernet MAC addresses to host names.
Lines consist of an address and a host name, separated by any number
of blanks and/or tab characters.
A ``#'' character indicates the beginning of a comment;
A
.Sq \&#
character indicates the beginning of a comment;
characters up to the end of
the line are not interpreted by routines which search the file.
.Pp

12
share/man/man5/group.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: group.5,v 1.11 2000/11/17 09:43:06 lukem Exp $
.\" $NetBSD: group.5,v 1.12 2000/11/17 10:14:17 lukem Exp $
.\"
.\" Copyright (c) 1980, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -175,7 +175,9 @@ or the
.Tn NIS
map (respectively).
.Pp
If no group name is specified, or the ``+'' (plus sign) appears alone
If no group name is specified, or the plus sign
.Pq Dq \&+
appears alone
on line, all groups are included from the
Hesiod domain or the
.Tn NIS
@ -183,8 +185,10 @@ map.
.Pp
Hesiod or
.Tn NIS
compat references may appear anywhere in the file, but the single ``+'' form
should be on the last line, for historical reasons.
compat references may appear anywhere in the file, but the single
plus sign
.Pq Dq \&+
form should be on the last line, for historical reasons.
Only the first group with a specific name encountered, whether in the
.Nm
file itself, or included via Hesiod or

11
share/man/man5/hosts.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: hosts.5,v 1.10 2000/11/17 09:43:06 lukem Exp $
.\" $NetBSD: hosts.5,v 1.11 2000/11/17 10:14:18 lukem Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -67,7 +67,9 @@ Alias host name
.El
.Pp
Items are separated by any number of blanks and/or
tab characters. A ``#'' indicates the beginning of
tab characters. A hash sign
.Pq Dq \&#
indicates the beginning of
a comment; characters up to the end of the line are
not interpreted by routines which search the file.
.Pp
@ -97,8 +99,9 @@ sites on the
Internet.
.Pp
As network addresses, both IPv4 and IPv6 addresses are allowed.
IPv4 addresses are specified in the conventional
``.'' (dot) notation using the
IPv4 addresses are specified in the conventional dot
.Pq Dq \&.
notation using the
.Xr inet_pton 3
routine
from the Internet address manipulation library,

22
share/man/man5/hosts.equiv.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: hosts.equiv.5,v 1.3 1999/04/06 02:52:40 tv Exp $
.\" $NetBSD: hosts.equiv.5,v 1.4 2000/11/17 10:14:18 lukem Exp $
.\"
.\" Copyright (c) 1997 The NetBSD Foundation, Inc.
.\" All rights reserved.
@ -43,8 +43,9 @@ The
.Nm hosts.equiv
and
.Nm .rhosts
files list hosts and users which are ``trusted'' by the local host when a
connection is made via
files list hosts and users which are
.Dq trusted
by the local host when a connection is made via
.Xr rlogind 8 ,
.Xr rshd 8 ,
or any other server that uses
@ -62,16 +63,20 @@ The
.Em hostname
may be specified as a host name (typically a fully qualified host
name in a DNS environment) or address,
.Em +@netgroup
.Dq Li +@netgroup
(from which only the host names are checked),
or a ``+'' wildcard (allow all hosts).
or a
.Dq Li \&+
wildcard (allow all hosts).
.Pp
The
.Em username ,
if specified, may be given as a user name on the remote host,
.Em +@netgroup
.Dq Li +@netgroup
(from which only the user names are checked),
or a ``+'' wildcard (allow all remote users).
or a
.Dq Li \&+
wildcard (allow all remote users).
.Pp
If a
.Em username
@ -173,4 +178,5 @@ file format appeared in
The
.Xr ruserok 3
implementation currently skips negative entries (preceded with a
``-'' sign) and does not treat them as ``short-circuit'' negative entries.
.Dq Li \&-
sign) and does not treat them as ``short-circuit'' negative entries.

19
share/man/man5/netgroup.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: netgroup.5,v 1.6 1999/01/16 14:16:42 lukem Exp $
.\" $NetBSD: netgroup.5,v 1.7 2000/11/17 10:14:18 lukem Exp $
.\"
.\" Copyright (c) 1992, 1993
.\" The Regents of the University of California. All rights reserved.
@ -45,7 +45,9 @@
The
.Nm netgroup
file
specifies ``netgroups'', which are sets of
specifies
.Dq netgroups ,
which are sets of
.Sy (host, user, domain)
tuples that are to be given similar network access.
.Pp
@ -64,10 +66,17 @@ where the
and
.Sy domain
are character string names for the corresponding component.
Any of the comma separated fields may be empty to specify a ``wildcard'' value
or may consist of the string ``-'' to specify ``no valid value''.
Any of the comma separated fields may be empty to specify a
.Dq wildcard
value
or may consist of the string
.Dq Li -
to specify
.Dq no valid value .
The members of the list may be separated by whitespace;
the ``\e'' character may be used at the end of a line to specify
the
.Dq \e
character may be used at the end of a line to specify
line continuation.
The functions specified in
.Xr getnetgrent 3

11
share/man/man5/networks.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: networks.5,v 1.11 2000/11/17 09:43:54 lukem Exp $
.\" $NetBSD: networks.5,v 1.12 2000/11/17 10:14:18 lukem Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -83,11 +83,14 @@ Network alias
.El
.Pp
Items are separated by any number of blanks and/or tab characters.
A ``#'' indicates the beginning of a comment; characters up to the end of
A
.Dq \&#
indicates the beginning of a comment; characters up to the end of
the line are not interpreted by routines which search the file.
.Pp
Network number may be specified in the conventional
``.'' (dot) notation using the
Network number may be specified in the conventional dot
.Pq Dq \&.
notation using the
.Xr inet_network 3
routine
from the

20
share/man/man5/phones.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: phones.5,v 1.4 1999/03/17 20:19:47 garbled Exp $
.\" $NetBSD: phones.5,v 1.5 2000/11/17 10:14:19 lukem Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -51,12 +51,22 @@ 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
characters terminated only by a comma
.Pq Dq \&,
or the end of the line.
The equals
.Pq Dq \&=
and asterisk
.Pq Dq \&*
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
.Dq \&=
' is required by the
.Tn DF02-AC
and the ``*'' is required by the
and the
.Dq \&*
is required by the
.Tn BIZCOMP
1030.
.Pp

10
share/man/man5/printcap.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: printcap.5,v 1.9 1999/03/17 20:19:47 garbled Exp $
.\" $NetBSD: printcap.5,v 1.10 2000/11/17 10:14:19 lukem Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -181,8 +181,7 @@ flag (pass control characters literally)
is specified to
.Xr lpr 1 .
The
.Ar Width
function
.Ar width
and
.Ar length
specify the page width and length
@ -198,9 +197,8 @@ and
parameters specify the login name and host name of the owner
of the job respectively.
The
.Ar Acct-file
function
is passed from the
.Ar acct-file
option is passed from the
.Cm af
.Nm printcap
entry.

6
share/man/man5/protocols.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: protocols.5,v 1.4 1999/03/17 20:19:47 garbled Exp $
.\" $NetBSD: protocols.5,v 1.5 2000/11/17 10:14:19 lukem Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -53,7 +53,9 @@ aliases
.Ed
.Pp
Items are separated by any number of blanks and/or
tab characters. A ``#'' indicates the beginning of
tab characters. A hash
.Pq Dq \&#
indicates the beginning of
a comment; characters up to the end of the line are
not interpreted by routines which search the file.
.Pp

10
share/man/man5/ranlib.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: ranlib.5,v 1.1 1998/08/22 05:36:32 tv Exp $
.\" $NetBSD: ranlib.5,v 1.2 2000/11/17 10:14:19 lukem Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -57,7 +57,9 @@ prepends a new file to the archive which has three separate parts.
The first part is a standard archive header, which has a special name
field, "__.SYMDEF".
.Pp
The second part is a ``long'' followed by a list of ranlib structures.
The second part is a
.Dq long
followed by a list of ranlib structures.
The long is the size, in bytes, of the list of ranlib structures.
Each of the ranlib structures consists of a zero based offset into the
next section (a string table of symbols) and an offset from the beginning
@ -65,7 +67,9 @@ of the archive to the start of the archive file which defines the symbol.
The actual number of ranlib structures is this number divided by the size
of an individual ranlib structure.
.Pp
The third part is a ``long'' followed by a string table.
The third part is a
.Dq long
followed by a string table.
The long is the size, in bytes of the string table.
.Sh SEE ALSO
.Xr ar 1 ,

20
share/man/man5/rc.conf.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: rc.conf.5,v 1.39 2000/10/01 06:04:43 lukem Exp $
.\" $NetBSD: rc.conf.5,v 1.40 2000/11/17 10:14:20 lukem Exp $
.\"
.\" Copyright (c) 1996 Matthew R. Green
.\" Copyright (c) 1997 Curt J. Sampson
@ -250,7 +250,7 @@ Sets the
variable (see below) to the output of
.Xr ifconfig 8
with the
.Ar -l
.Dq Li -l
flag and suppresses warnings about interfaces in this list that
do not have an ifconfig file or variable.
.It Sy net_interfaces
@ -268,14 +268,14 @@ is set to "NO" and neither the file nor the variable is found,
a warning is printed.
.It Sy ifaliases_*
List of
.Sq Ar "address netmask"
.Sq Em "address netmask"
pairs to configure additional network addresses for the given
configured interface
.Dq *
(e.g.
.Sy ifaliases_le0 ) .
If
.Ar netmask
.Em netmask
is
.Dq - ,
then use the default netmask for the interface.
@ -386,7 +386,7 @@ You may want to check
and
.Sy rtsold
as well, if you set the variable to
.Li autohost .
.Dq Li autohost .
.It Sy rtsol
.Sq YES
or
@ -417,7 +417,7 @@ as necessary.
Passes
.Sy inetd_flags .
The
.Ar -l
.Dq Li -l
flag turns on libwrap connection logging.
.It Sy rpcbind
.Sq YES
@ -469,14 +469,14 @@ Runs
and passes
.Sy timed_flags .
The
.Ar -M
.Dq Li -M
option allows
.Xr timed 8
to be a master time source as well as a slave.
If you are also running
.Xr ntpd 8 ,
only one machine running both should have the
.Ar -M
.Dq Li -M
flag given to
.Xr timed 8 .
.It Sy ntpd
@ -511,7 +511,7 @@ Runs
and passes
.Sy lpd_flags .
The
.Ar -l
.Dq Li -l
flag will turn on extra logging.
.It Sy sshd
.Sq YES
@ -741,7 +741,7 @@ the
Passes
.Sy ypserv_flags .
The
.Ar -d
.Dq Li -d
flag causes it to use DNS for lookups in
.Pa /etc/hosts
that fail.

38
share/man/man5/remote.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: remote.5,v 1.9 2000/10/05 12:35:33 ad Exp $
.\" $NetBSD: remote.5,v 1.10 2000/11/17 10:14:20 lukem Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -50,7 +50,8 @@ is structured somewhat like the
file.
Each line in the file provides a description for a single
.Em system .
Fields are separated by a colon (``:'').
Fields are separated by a colon
.Pq Dq \&: .
Lines ending in a \e character with an immediately following newline are
continued on the next line.
.Pp
@ -61,7 +62,10 @@ After the name of the system comes the fields of the description.
A field name followed by an `=' sign indicates a string value follows.
A field name followed by a `#' sign indicates a following numeric value.
.Pp
Entries named ``tip*'' and ``cu*''
Entries named
.Dq tip*
and
.Dq cu*
are used as default entries by
.Xr tip 1 ,
and the
@ -72,19 +76,25 @@ as follows.
When
.Xr tip 1
is invoked with only a phone number, it looks for an entry
of the form ``tip300'', where 300 is the baud rate with
of the form
.Dq tip300 ,
where 300 is the baud rate with
which the connection is to be made.
When the
.Xr cu 1
interface is used, entries of the form ``cu300'' are used.
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
.Em capability Ns Ar = Ns Em value ;
for example, ``dv=/dev/harris''.
.Em "capability=value" ;
for example,
.Dq Li dv=/dev/harris .
A numeric capability is specified by
.Em capability Ns Ar # Ns Em value ;
for example, ``xa#99''.
.Em "capability#value" ;
for example,
.Dq Li xa#99 .
A boolean capability is specified by simply listing the capability.
.Bl -tag -width indent
.It Cm \&at
@ -164,8 +174,14 @@ string is sent at end-of-file.
(str)
The type of parity to use when sending data
to the host.
This may be one of ``even'', ``odd'', ``none'', ``zero'' (always
set bit 8 to zero), ``one'' (always set bit 8 to 1).
This may be one of
.Sy even ,
.Sy odd ,
.Sy none ,
.Sy zero
(always set bit 8 to zero),
.Sy one
(always set bit 8 to one).
The default is even parity.
.It Cm \&pn
(str)

6
share/man/man5/rpc.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: rpc.5,v 1.3 2000/06/15 20:05:54 fvdl Exp $
.\" $NetBSD: rpc.5,v 1.4 2000/11/17 10:14:20 lukem Exp $
.\" @(#)rpc.4 1.17 93/08/30 SMI; from SVr4
.\" Copyright 1989 AT&T
.Dd December 10, 1991
@ -21,7 +21,9 @@ program name. The line has the following format:
.Pp
Items are separated by any number of blanks and/or
tab characters.
A ``#'' indicates the beginning of a comment;
A hash
.Pq Dq \&#
indicates the beginning of a comment;
characters up to the end of the line are not interpreted
by routines which search the file.
.Sh EXAMPLES

12
share/man/man5/services.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: services.5,v 1.4 1999/03/17 20:19:48 garbled Exp $
.\" $NetBSD: services.5,v 1.5 2000/11/17 10:14:20 lukem Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -59,9 +59,13 @@ 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'').
A ``#'' indicates the beginning of
a slash
.Pq Dq /
is used to separate the port and protocol (e.g.
.Dq 512/tcp ) .
A hash
.Pq Dq \&#
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.
.Pp

6
share/man/man5/shells.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: shells.5,v 1.5 1999/03/17 20:19:48 garbled Exp $
.\" $NetBSD: shells.5,v 1.6 2000/11/17 10:14:20 lukem Exp $
.\"
.\" Copyright (c) 1986, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -55,7 +55,9 @@ as controlled by
For each shell a single line should be present, consisting of the
shell's path, relative to root.
.Pp
A hash mark (``#'') indicates the beginning of a comment; subsequent
A hash
.Pq Dq \&#
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.
Blank lines are also ignored.

10
share/man/man5/wscons.conf.5
View File

@ -1,4 +1,4 @@
.\" $NetBSD: wscons.conf.5,v 1.2 2000/09/12 09:53:41 drochner Exp $
.\" $NetBSD: wscons.conf.5,v 1.3 2000/11/17 10:14:21 lukem Exp $
.\"
.\" Copyright notice
.\"
@ -16,7 +16,8 @@ The
.Nm
file defines parameters regarding to the workstation console (wscons).
The file consists of lines starting with a keyword, and one or more arguments.
Empty lines and lines starting with a ``#'' sign are ignored.
Empty lines and lines starting with a hash
.Pq Dq \&# are ignored.
The following keywords and arguments are recognized:
.Pp
@ -44,7 +45,7 @@ is the same, just for the font characters' height.
.Sy enc
is used to declare the font's encoding, see the description on
.Xr wsfontload 8 's
.Ar -e
.Fl e
option for more detail.
.Sy file
gives the absolute path to the font file.
@ -54,7 +55,8 @@ for more information.
.Pp
.It Sy keyboard <wsconscfg -k args>
The given argument(s) are handed off to
``wsconscfg -k'' for attaching and configuration of keyboards. See
.Dq Li "wsconscfg -k"
for attaching and configuration of keyboards. See
.Xr wsconscfg 8
for more information.
.Pp