1
0
mirror of https://github.com/openbsd/src.git synced 2025-01-10 06:47:55 -08:00

When you give command examples and etc., in a manual page prefix them with:

$ command
or
# command

deraadt@ ok
This commit is contained in:
mpech 2002-02-13 08:33:46 +00:00
parent f7c5f52ca2
commit 8be0697955
24 changed files with 80 additions and 81 deletions

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: tcpdmatch.8,v 1.10 2001/09/06 15:04:34 mpech Exp $
.\" $OpenBSD: tcpdmatch.8,v 1.11 2002/02/13 08:33:46 mpech Exp $
.\"
.\" Copyright (c) 1997, Jason Downs. All rights reserved.
.\"
@ -144,13 +144,13 @@ To predict how
would handle a telnet request from the local system:
.Pp
.Bd -unfilled -offset indent
tcpdmatch telnetd localhost
$ tcpdmatch telnetd localhost
.Ed
.Pp
The same request, pretending that hostname lookup failed:
.Pp
.Bd -unfilled -offset indent
tcpdmatch telnetd 127.0.0.1
$ tcpdmatch telnetd 127.0.0.1
.Ed
.Pp
To predict what
@ -158,7 +158,7 @@ To predict what
would do when the client name does not match the client address:
.Pp
.Bd -unfilled -offset indent
tcpdmatch telnetd paranoid
$ tcpdmatch telnetd paranoid
.Ed
.\" .Pp
.\" On some systems, daemon names have no `in.' prefix, or

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: apply.1,v 1.16 2001/05/01 17:58:01 aaron Exp $
.\" $OpenBSD: apply.1,v 1.17 2002/02/13 08:33:46 mpech Exp $
.\" $NetBSD: apply.1,v 1.4 1996/03/18 23:16:57 jtc Exp $
.\"
.\" Copyright (c) 1983, 1990, 1993
@ -98,12 +98,12 @@ Debug mode.
Print commands to the standard output but do not actually execute them.
.El
.Sh EXAMPLES
.Cm "apply echo a*"
.Cm "$ apply echo a*"
.Pp
Similar to
.Xr ls 1 .
.Pp
.Cm "apply \-2 cmp a1 b1 a2 b2 a3 b3"
.Cm "$ apply \-2 cmp a1 b1 a2 b2 a3 b3"
.Pp
Compares the
.Dq a
@ -111,13 +111,13 @@ files to the
.Dq b
files.
.Pp
.Cm "apply \-0 who 1 2 3 4 5"
.Cm "$ apply \-0 who 1 2 3 4 5"
.Pp
Runs
.Xr who 1
5 times.
.Pp
.Cm "apply \'ln %1 /usr/joe\'" *
.Cm "$ apply \'ln %1 /usr/joe\'" *
.Pp
Links all files in the current directory to the directory
.Pa /usr/joe .

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: chpass.1,v 1.26 2001/08/27 02:57:07 millert Exp $
.\" $OpenBSD: chpass.1,v 1.27 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: chpass.1,v 1.7 1996/05/15 21:50:40 jtc Exp $
.\"
.\" Copyright (c) 1988, 1990, 1993
@ -234,7 +234,7 @@ will wait forever trying to lock the password file.
To determine whether a live process is actually holding the lock, the
admin may run the following:
.Bd -literal -offset indent
fstat /etc/ptmp
$ fstat /etc/ptmp
.Ed
.Pp
If no process is listed, it is safe to remove the

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: colcrt.1,v 1.7 2000/11/10 05:10:22 aaron Exp $
.\" $OpenBSD: colcrt.1,v 1.8 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: colcrt.1,v 1.3 1995/03/26 05:30:59 glass Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
@ -77,7 +77,7 @@ A typical use of
.Nm
would be
.Bd -literal
tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
$ tbl exum2.n \&| nroff \-ms \&| colcrt \- \&| more
.Ed
.Sh SEE ALSO
.Xr col 1 ,

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: ctags.1,v 1.10 2000/11/10 05:10:23 aaron Exp $
.\" $OpenBSD: ctags.1,v 1.11 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: ctags.1,v 1.4 1995/03/26 20:14:04 glass Exp $
.\"
.\" Copyright (c) 1987, 1990, 1993
@ -115,8 +115,8 @@ it may be desired to run the output through
.Xr sort 1 .
Sample use:
.Bd -literal -offset indent
ctags \-v files \&| sort \-f > index
vgrind \-x index
$ ctags \-v files \&| sort \-f > index
$ vgrind \-x index
.Ed
.It Fl w
Suppress warning diagnostics.

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: file2c.1,v 1.8 2001/01/29 01:57:58 niklas Exp $
.\" $OpenBSD: file2c.1,v 1.9 2002/02/13 08:33:47 mpech Exp $
.\"----------------------------------------------------------------------------
.\" "THE BEER-WARE LICENSE" (Revision 42):
.\" <phk@freebsd.org> wrote this file. As long as you retain this notice, you
@ -37,7 +37,7 @@ for instance as a
.Sh EXAMPLES
The command:
.Bd -literal -offset indent
date | file2c 'const char date[] = {' ',0};'
$ date | file2c 'const char date[] = {' ',0};'
.Ed
.Pp
will produce:

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: lndir.1,v 1.14 2001/07/04 07:12:38 mickey Exp $
.\" $OpenBSD: lndir.1,v 1.15 2002/02/13 08:33:47 mpech Exp $
.\"
.\" Copyright (c) 1997, Jason Downs. All rights reserved.
.\"
@ -196,13 +196,13 @@ from a shadow directory anyway.
.Pp
You need to use something like
.Bd -unfilled -offset indent
find todir \|\-type l \|\-print \||\| xargs rm
$ find todir \|\-type l \|\-print \||\| xargs rm
.Ed
.Pp
to clear out all files before you can relink (if fromdir moved, for instance).
Something like
.Bd -unfilled -offset indent
find . \|\\! \|\-type d \|\-print
$ find . \|\\! \|\-type d \|\-print
.Ed
.Pp
will find all files that are not directories.

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: logger.1,v 1.8 2000/11/09 17:52:20 aaron Exp $
.\" $OpenBSD: logger.1,v 1.9 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: logger.1,v 1.4 1994/12/22 06:26:59 jtc Exp $
.\"
.\" Copyright (c) 1983, 1990, 1993
@ -92,9 +92,9 @@ The
utility exits 0 on success or >0 if an error occurred.
.Sh EXAMPLES
.Bd -literal -offset indent -compact
logger System rebooted
$ logger System rebooted
logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
$ logger \-p local0.notice \-t HOSTIDM \-f /dev/idmc
.Ed
.Sh SEE ALSO
.Xr syslog 3 ,

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: mkstr.1,v 1.6 2000/11/09 17:52:24 aaron Exp $
.\" $OpenBSD: mkstr.1,v 1.7 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: mkstr.1,v 1.3 1995/09/28 06:22:19 tls Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
@ -68,7 +68,7 @@ A typical usage of
.Nm mkstr
is
.Bd -literal -offset indent
mkstr pistrings xx *.c
$ mkstr pistrings xx *.c
.Ed
.Pp
This command causes all the error messages from the C source

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: passwd.1,v 1.21 2002/01/24 20:33:45 mickey Exp $
.\" $OpenBSD: passwd.1,v 1.22 2002/02/13 08:33:47 mpech Exp $
.\"
.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
@ -162,7 +162,7 @@ will wait forever trying to lock the password file.
To determine whether a live process is actually holding the lock, the
admin may run the following:
.Bd -literal -offset indent
fstat /etc/ptmp
$ fstat /etc/ptmp
.Ed
.Pp
If no process is listed, it is safe to remove the

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: renice.8,v 1.12 2000/11/10 05:10:39 aaron Exp $
.\" $OpenBSD: renice.8,v 1.13 2002/02/13 08:33:47 mpech Exp $
.\"
.\" Copyright (c) 1983, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
@ -90,7 +90,7 @@ interpretation to be (the default) process IDs.
.Pp
For example,
.Bd -literal -offset
renice +1 987 -u daemon root -p 32
# renice +1 987 -u daemon root -p 32
.Ed
.Pp
would change the priority of process IDs 987 and 32, and

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: rs.1,v 1.6 2000/11/09 17:52:34 aaron Exp $
.\" $OpenBSD: rs.1,v 1.7 2002/02/13 08:33:47 mpech Exp $
.\"
.\" Copyright (c) 1993
.\" The Regents of the University of California. All rights reserved.
@ -194,7 +194,7 @@ into a convenient
.Dq window
format, as in
.Bd -literal -offset indent
% who | rs
$ who | rs
.Ed
.Pp
This function has been incorporated into the
@ -205,13 +205,13 @@ suffices.
.Pp
To convert stream input into vector output and back again, use
.Bd -literal -offset indent
% rs 1 0 | rs 0 1
$ rs 1 0 | rs 0 1
.Ed
.Pp
A 10 by 10 array of random numbers from 1 to 100 and
its transpose can be generated with
.Bd -literal -offset indent
% jot \-r 100 | rs 10 10 | tee array | rs \-T > tarray
$ jot \-r 100 | rs 10 10 | tee array | rs \-T > tarray
.Ed
.Pp
In the editor
@ -225,7 +225,7 @@ and then be neatly reshaped into 9 columns with
.Pp
Finally, to sort a database by the first line of each 4-line field, try
.Bd -literal -offset indent
% rs \-eC 0 4 | sort | rs \-c 0 1
$ rs \-eC 0 4 | sort | rs \-c 0 1
.Ed
.Sh SEE ALSO
.Xr jot 1 ,

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: rup.1,v 1.8 2000/11/09 17:52:35 aaron Exp $
.\" $OpenBSD: rup.1,v 1.9 2002/02/13 08:33:47 mpech Exp $
.\"
.\" Copyright (c) 1985, 1991 The Regents of the University of California.
.\" All rights reserved.
@ -74,9 +74,8 @@ work.
uses an RPC protocol defined in /usr/include/rpcsvc/rstat.x.
.Sh EXAMPLES
.Bd -unfilled -offset indent -compact
example% rup otherhost
$ rup otherhost
otherhost up 6 days, 16:45, load average: 0.20, 0.23, 0.18
example%
.Ed
.Sh DIAGNOSTICS
.Bl -tag -width indent

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: shar.1,v 1.6 2000/03/10 20:17:52 aaron Exp $
.\" $OpenBSD: shar.1,v 1.7 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: shar.1,v 1.4 1995/08/18 14:55:40 pk Exp $
.\"
.\" Copyright (c) 1990, 1993
@ -63,18 +63,18 @@ To create a shell archive of the program
.Xr ls 1
and mail it to Rick:
.Bd -literal -offset indent
cd ls
shar `find . -print` \&| mail -s "ls source" rick
$ cd ls
$ shar `find . -print` \&| mail -s "ls source" rick
.Ed
.Pp
To recreate the program directory:
.Bd -literal -offset indent
mkdir ls
cd ls
$ mkdir ls
$ cd ls
\&...
<delete header lines and examine mailed archive>
\&...
sh archive
$ sh archive
.Ed
.Sh SEE ALSO
.Xr compress 1 ,
@ -101,5 +101,5 @@ Archives produced using this implementation of
.Nm shar
may be easily examined with the command:
.Bd -literal -offset indent
egrep -v '^[X#]' shar.file
$ egrep -v '^[X#]' shar.file
.Ed

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: ssh-keyscan.1,v 1.13 2002/02/09 17:37:34 deraadt Exp $
.\" $OpenBSD: ssh-keyscan.1,v 1.14 2002/02/13 08:33:47 mpech Exp $
.\"
.\" Copyright 1995, 1996 by David Mazieres <dm@lcs.mit.edu>.
.\"
@ -104,7 +104,7 @@ Print the
host key for machine
.Pa hostname :
.Bd -literal
ssh-keyscan hostname
$ ssh-keyscan hostname
.Ed
.Pp
Find all hosts from the file
@ -112,7 +112,7 @@ Find all hosts from the file
which have new or different keys from those in the sorted file
.Pa ssh_known_hosts :
.Bd -literal
ssh-keyscan -t rsa,dsa -f ssh_hosts | \e\
$ ssh-keyscan -t rsa,dsa -f ssh_hosts | \e\
sort -u - ssh_known_hosts | diff ssh_known_hosts -
.Ed
.Sh FILES

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: uuencode.1,v 1.7 2000/03/14 14:58:24 aaron Exp $
.\" $OpenBSD: uuencode.1,v 1.8 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: uuencode.1,v 1.4 1994/11/17 07:39:42 jtc Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
@ -94,7 +94,7 @@ will be created which may then be uncompressed and extracted
into the original tree.
.Pp
.Bd -literal -offset indent -compact
tar cf \- src_tree \&| compress \&|
$ tar cf \- src_tree \&| compress \&|
uuencode src_tree.tar.Z \&| mail sys1!sys2!user
.Ed
.Pp

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: whois.1,v 1.15 2002/01/21 00:55:55 stevesk Exp $
.\" $OpenBSD: whois.1,v 1.16 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: whois.1,v 1.5 1995/08/31 21:51:32 jtc Exp $
.\"
.\" Copyright (c) 1985, 1990, 1993
@ -107,11 +107,11 @@ automatically for a large number of TLDs, i.e., all of the following will
.Ql just work :
.Pp
.Bd -literal -offset indent -compact
whois -q patho.gen.nz
whois -q microsoft.com
whois -q nasa.gov
whois -q nic.fr
whois -q demon.co.uk
$ whois -q patho.gen.nz
$ whois -q microsoft.com
$ whois -q nasa.gov
$ whois -q nic.fr
$ whois -q demon.co.uk
.Ed
.Pp
This option is now the default.

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: xstr.1,v 1.9 2000/12/17 21:33:02 millert Exp $
.\" $OpenBSD: xstr.1,v 1.10 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: xstr.1,v 1.4 1994/11/26 09:25:22 jtc Exp $
.\"
.\" Copyright (c) 1980, 1993
@ -93,7 +93,7 @@ declaring the common
.Nm
space can be created by a command of the form
.Bd -literal -offset indent
xstr
$ xstr
.Ed
.Pp
The file
@ -107,7 +107,7 @@ space and swap overhead.
can also be used on a single file.
A command
.Bd -literal -offset indent
xstr name
$ xstr name
.Ed
.Pp
creates files
@ -128,9 +128,9 @@ An appropriate command sequence for running
after the C preprocessor is:
.Pp
.Bd -literal -offset indent -compact
cc \-E name.c | xstr \-c \-
cc \-c x.c
mv x.o name.o
$ cc \-E name.c | xstr \-c \-
$ cc \-c x.c
$ mv x.o name.o
.Ed
.Pp
.Nm

View File

@ -27,7 +27,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $Id: ac.8,v 1.8 2000/11/09 17:53:10 aaron Exp $
.\" $Id: ac.8,v 1.9 2002/02/13 08:33:47 mpech Exp $
.\"
.Dd March 15, 1994
.Dt AC 8
@ -114,8 +114,8 @@ does not exist.
.Pp
For example,
.Bd -literal -offset
ac -p -t "ttyd*" > modems
ac -p -t "!ttyd*" > other
$ ac -p -t "ttyd*" > modems
$ ac -p -t "!ttyd*" > other
.Ed
.Pp
allows times recorded in

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: arp.8,v 1.11 2001/06/10 17:46:20 dugsong Exp $
.\" $OpenBSD: arp.8,v 1.12 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: arp.8,v 1.7 1995/03/01 11:50:59 chopps Exp $
.\"
.\" Copyright (c) 1985, 1991, 1993
@ -142,14 +142,14 @@ To view the current
.Nm
table:
.Pp
.Dl arp -a
.Dl $ arp -a
.Pp
To create a
.Em permanent
.Nm entry
(One that cannot be overwritten by other network traffic):
.Pp
.Dl arp -s 10.0.0.2 00:90:27:bb:cc:dd permanent
.Dl # arp -s 10.0.0.2 00:90:27:bb:cc:dd permanent
.Pp
To create
.Em proxy arp
@ -157,8 +157,8 @@ entries on an interface, fxp0,
for the IP Addresses 204.1.2.3 and 204.1.2.4, do a:
.Pp
.Bd -unfilled -offset indent -compact
arp -s 209.1.2.3 00:90:27:bb:cc:dd pub
arp -s 209.1.2.4 00:90:27:bb:cc:dd pub
# arp -s 209.1.2.3 00:90:27:bb:cc:dd pub
# arp -s 209.1.2.4 00:90:27:bb:cc:dd pub
.Ed
.Pp
(where 00:90:27:bb:cc:dd is the MAC address of fxp0)

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: lpr.1,v 1.3 2000/03/19 17:57:06 aaron Exp $
.\" $OpenBSD: lpr.1,v 1.4 2002/02/13 08:33:47 mpech Exp $
.\"
.\" Copyright (c) 1980, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
@ -142,14 +142,14 @@ The quantity
is the number of copies desired of each file named.
For example,
.Bd -literal -offset indent
lpr \-#3 foo.c bar.c more.c
$ lpr \-#3 foo.c bar.c more.c
.Ed
.Pp
would result in 3 copies of the file foo.c, followed by 3 copies
of the file bar.c, etc.
On the other hand,
.Bd -literal -offset indent
cat foo.c bar.c more.c \&| lpr \-#3
$ cat foo.c bar.c more.c \&| lpr \-#3
.Ed
.Pp
will give three copies of the concatenation of the files.
@ -172,7 +172,7 @@ Job classification
to use on the burst page.
For example,
.Bd -literal -offset indent
lpr \-C EECS foo.c
$ lpr \-C EECS foo.c
.Ed
.Pp
causes the system name (the name returned by

View File

@ -27,7 +27,7 @@
.\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
.\" ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $Id: quot.8,v 1.9 2000/03/19 17:57:12 aaron Exp $
.\" $Id: quot.8,v 1.10 2002/02/13 08:33:47 mpech Exp $
.\"
.Dd February 8, 1994
.Dt QUOT 8
@ -69,7 +69,7 @@ in the standard input, for each file print out the owner (plus
the remainder of the input line).
This is traditionally used in the pipe:
.Bd -literal -offset indent
ncheck filesystem | sort +0n | quot -n filesystem
# ncheck filesystem | sort +0n | quot -n filesystem
.Ed
.Pp
to get a report of files and their owners.

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: wsconscfg.8,v 1.10 2001/08/25 19:35:56 aaron Exp $
.\" $OpenBSD: wsconscfg.8,v 1.11 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: wsconscfg.8,v 1.5 1999/05/15 14:45:06 drochner Exp $
.\"
.Dd January 12, 1999
@ -94,7 +94,7 @@ script, controlled by the
.Pa /etc/wscons.conf
configuration file.
.Sh EXAMPLES
.Cm wsconscfg -t 80x50 -e vt100 1
.Cm # wsconscfg -t 80x50 -e vt100 1
.br
.Pp
Configure screen 1 (i.e., the second) for type
@ -110,7 +110,7 @@ screen useful.
See
.Xr wsfontload 8 . )
.Pp
.Cm wsconscfg -k
.Cm # wsconscfg -k
.Pp
Connect the first unconnected keyboard to the display.
.\" .Sh FILES

View File

@ -1,4 +1,4 @@
.\" $OpenBSD: wsfontload.8,v 1.8 2001/05/18 17:03:53 mickey Exp $
.\" $OpenBSD: wsfontload.8,v 1.9 2002/02/13 08:33:47 mpech Exp $
.\" $NetBSD: wsfontload.8,v 1.5 1999/04/06 04:54:22 cgd Exp $
.\"
.Dd January 13, 1999
@ -103,7 +103,7 @@ No font files are provided with the wscons framework.
The fonts installed by PCVT can be used instead, as can raw font files from
other operating system distributions.
.Sh EXAMPLES
.Cm "wsfontload -N myname -h 8 -e ibm /usr/share/misc/pcvtfonts/vt220l.808"
.Cm "# wsfontload -N myname -h 8 -e ibm /usr/share/misc/pcvtfonts/vt220l.808"
.Pp
Load the IBM-encoded 8x8-font from the PCVT distribution.
This (or another 8x8-font) is necessary to use the 50-line screen type on