Skip to content

Commit

Permalink
The .Nm utility
Browse files Browse the repository at this point in the history
  • Loading branch information
Philippe Charnier authored and Philippe Charnier committed Jul 6, 2002
1 parent 4690560 commit 3f162cb
Show file tree
Hide file tree
Showing 26 changed files with 195 additions and 130 deletions.
9 changes: 6 additions & 3 deletions libexec/bootpd/bootpd.8
Original file line number Diff line number Diff line change
Expand Up @@ -26,11 +26,14 @@
.Op Fl d Ar level
.Ar server
.Sh DESCRIPTION
.Nm Bootpd
The
.Nm
utility
implements an Internet Bootstrap Protocol (BOOTP) server as defined in
RFC951, RFC1532, and RFC1533.
.Nm Bootpgw
implements a simple BOOTP gateway which can be used to forward
The
.Nm bootpgw
utility implements a simple BOOTP gateway which can be used to forward
requests and responses between clients on one subnet and a
BOOTP server (i.e.\&
.Nm )
Expand Down
3 changes: 2 additions & 1 deletion libexec/bootpd/tools/bootpef/bootpef.8
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@
.Op Ar client\-name ...
.Ek
.Sh DESCRIPTION
The
.Nm
builds the
utility builds the
.Em "Extension Path"
files described by
.%T "RFC 1497"
Expand Down
5 changes: 3 additions & 2 deletions libexec/bootpd/tools/bootptest/bootptest.8
Original file line number Diff line number Diff line change
Expand Up @@ -15,8 +15,9 @@
.Ar server\-name
.Op Ar template\-file
.Sh DESCRIPTION
The
.Nm
sends BOOTP requests to the host specified as
utility sends BOOTP requests to the host specified as
.Ar server\-name
at one\-second intervals until either a response is received,
or until ten requests have gone unanswered.
Expand Down Expand Up @@ -47,7 +48,7 @@ area of the request packet.
.Sh AUTHORS
The
.Nm
program is a combination of original and derived works.
utility is a combination of original and derived works.
The main program module
.Pq Pa bootptest.c
is original work by
Expand Down
12 changes: 7 additions & 5 deletions libexec/comsat/comsat.8
Original file line number Diff line number Diff line change
Expand Up @@ -41,11 +41,13 @@
.Sh SYNOPSIS
.Nm
.Sh DESCRIPTION
.Nm Comsat
is the server process which receives reports of incoming mail
The
.Nm
utility is the server process which receives reports of incoming mail
and notifies users if they have requested this service.
.Nm Comsat
receives messages on a datagram port associated with the
The
.Nm
utility receives messages on a datagram port associated with the
.Dq biff
service
specification (see
Expand Down Expand Up @@ -97,5 +99,5 @@ does not mess up the screen.
.Sh HISTORY
The
.Nm
command appeared in
utility appeared in
.Bx 4.2 .
24 changes: 14 additions & 10 deletions libexec/fingerd/fingerd.8
Original file line number Diff line number Diff line change
Expand Up @@ -44,8 +44,9 @@
.Op Fl l
.Op Fl p Ar filename
.Sh DESCRIPTION
.Nm Fingerd
is a simple protocol based on
The
.Nm
utility is a simple protocol based on
.%T RFC1196
that provides an interface to the
Name and Finger programs at several network sites.
Expand All @@ -56,8 +57,9 @@ There is no required format and the
protocol consists mostly of specifying a single
.Dq command line .
.Pp
.Nm Fingerd
is started by
The
.Nm
utility is started by
.Xr inetd 8 ,
which listens for
.Tn TCP
Expand All @@ -67,13 +69,14 @@ terminated by a
.Aq Tn CRLF
which is passed to
.Xr finger 1 .
.Nm Fingerd
closes its connections as soon as the output is finished.
The
.Nm
utility closes its connections as soon as the output is finished.
.Pp
If the line is null (i.e. just a
.Aq Tn CRLF
is sent) then
.Xr finger
.Xr finger 1
returns a
.Dq default
report that lists all people logged into
Expand Down Expand Up @@ -136,8 +139,9 @@ or an equally narrow-minded
user program can result
in meaningless attempts at option negotiation being sent to the
server, which will foul up the command line interpretation.
.Nm Fingerd
should be taught to filter out
The
.Nm
utility should be taught to filter out
.Tn IAC Ns \'s
and perhaps even respond
negatively
Expand All @@ -146,5 +150,5 @@ to all option commands received.
.Sh HISTORY
The
.Nm
command appeared in
utility appeared in
.Bx 4.3 .
22 changes: 13 additions & 9 deletions libexec/ftpd/ftpd.8
Original file line number Diff line number Diff line change
Expand Up @@ -47,8 +47,9 @@
.Op Fl p Ar file
.Op Fl t Ar timeout
.Sh DESCRIPTION
.Nm Ftpd
is the
The
.Nm
utility is the
Internet File Transfer Protocol
server process. The server uses the
.Tn TCP
Expand Down Expand Up @@ -281,16 +282,18 @@ STAT
command is received during a data transfer, preceded by a Telnet IP
and Synch, transfer status will be returned.
.Pp
.Nm Ftpd
interprets file names according to the
The
.Nm
utility interprets file names according to the
.Dq globbing
conventions used by
.Xr csh 1 .
This allows users to utilize the metacharacters
.Dq Li \&*?[]{}~ .
.Pp
.Nm Ftpd
authenticates users according to six rules.
The
.Nm
utility authenticates users according to six rules.
.Pp
.Bl -enum -offset indent
.It
Expand Down Expand Up @@ -383,7 +386,7 @@ The files pwd.db (see
and
.Xr group 5
must be present for the
.Xr ls
.Xr ls 1
command to be able to produce owner names rather than numbers.
The password field in
.Xr passwd
Expand Down Expand Up @@ -452,8 +455,9 @@ value is to be used.
As with any anonymous login configuration, due care must be given
to setup and maintenance to guard against security related problems.
.Pp
The
.Nm
has internal support for handling remote requests to list
utility has internal support for handling remote requests to list
files, and will not execute
.Pa /bin/ls
in either a chrooted or non-chrooted environment. The
Expand Down Expand Up @@ -495,6 +499,6 @@ scrutinized, but are possibly incomplete.
.Sh HISTORY
The
.Nm
command appeared in
utility appeared in
.Bx 4.2 .
IPv6 support was added in WIDE Hydrangea IPv6 stack kit.
8 changes: 3 additions & 5 deletions libexec/getty/getty.8
Original file line number Diff line number Diff line change
Expand Up @@ -47,8 +47,7 @@
.Sh DESCRIPTION
The
.Nm
program
is called by
utility is called by
.Xr init 8
to open and initialize the tty line, read a login name, and invoke
.Xr login 1 .
Expand Down Expand Up @@ -92,8 +91,7 @@ table.
.Pp
The
.Nm
program
can be set to timeout after some interval,
utility can be set to timeout after some interval,
which will cause dial up lines to hang up
if the login name is not entered reasonably quickly.
.Sh DIAGNOSTICS
Expand Down Expand Up @@ -126,5 +124,5 @@ does not exist.
.Sh HISTORY
A
.Nm
program appeared in
utility appeared in
.At v6 .
7 changes: 4 additions & 3 deletions libexec/makekey/makekey.8
Original file line number Diff line number Diff line change
Expand Up @@ -41,8 +41,9 @@
.Sh SYNOPSIS
.Nm
.Sh DESCRIPTION
.Nm Makekey
encrypts a key and salt which it reads from the standard input
The
.Nm
utility encrypts a key and salt which it reads from the standard input
and writes the result to the standard output.
The key is expected to be
eight bytes; the salt is expected to be two bytes.
Expand All @@ -57,5 +58,5 @@ and how the encrypted value is calculated.
.Sh HISTORY
A
.Nm
command appeared in
utility appeared in
.At v7 .
13 changes: 7 additions & 6 deletions libexec/mknetid/mknetid.8
Original file line number Diff line number Diff line change
Expand Up @@ -45,8 +45,9 @@
.Op Fl n Ar netid_file
.Op Fl d Ar domain
.Sh DESCRIPTION
.Nm Mknetid
processes the contents of the
The
.Nm
utility processes the contents of the
.Xr group 5 ,
.Xr passwd 5 ,
.Xr hosts 5
Expand All @@ -61,12 +62,12 @@ and hosts in a operating system independent format.
.Pp
The
.Nm
command checks for duplicate occurrences of netids and filters
utility checks for duplicate occurrences of netids and filters
them out.
.Pp
The
.Nm
command prints its results on the standard output.
utility prints its results on the standard output.
It is usually called
only by
.Pa /var/yp/Makefile
Expand All @@ -76,7 +77,7 @@ maps.
.Sh OPTIONS
The
.Nm
command supports the following options:
utility supports the following options:
.Bl -tag -width indent
.It Fl q
Normally,
Expand Down Expand Up @@ -115,7 +116,7 @@ support is added to
.It Fl d Ar domain
By default, the
.Nm
command uses the system domainname when generating netid records.
utility uses the system domainname when generating netid records.
If
the system domainname is not set, the domain must be specified on the
command line with the
Expand Down
6 changes: 4 additions & 2 deletions libexec/pppoed/pppoed.8
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,7 @@
.Sh DESCRIPTION
The
.Nm
program listens to the given
utility listens to the given
.Ar interface
for PPP over Ethernet (PPPoE) service request packets, and actions them
by negotiating a session then invoking a
Expand All @@ -56,7 +56,9 @@ See
.Xr ng_pppoe 4
for details.
.Pp
The
.Nm
utility
will only offer services to clients requesting services from the given
.Ar provider ,
which is taken as an empty name if not provided.
Expand Down Expand Up @@ -211,7 +213,7 @@ This may change in the future.
.Sh HISTORY
The
.Nm
program was written by
utility was written by
.An Brian Somers Aq [email protected]
and first appeared in
.Fx 3.4 .
5 changes: 3 additions & 2 deletions libexec/rbootd/rbootd.8
Original file line number Diff line number Diff line change
Expand Up @@ -112,8 +112,9 @@ Here is a sample configuration file:
.It "8::9:1:C6:75 SYSHPBSD,SYSHPUX # jaguar (either)
.El
.Pp
.Nm Rbootd
logs status and error messages via
The
.Nm
utility logs status and error messages via
.Xr syslog 3 .
A startup message is always logged, and in the case of fatal errors (or
deadly signals) a message is logged announcing the server's termination.
Expand Down
11 changes: 6 additions & 5 deletions libexec/revnetgroup/revnetgroup.8
Original file line number Diff line number Diff line change
Expand Up @@ -44,8 +44,9 @@
.Fl h
.Op Fl f Ar netgroup_file
.Sh DESCRIPTION
.Nm Revnetgroup
processes the contents of a file in
The
.Nm
utility processes the contents of a file in
.Xr netgroup 5
format into what is called
.Pa reverse netgroup
Expand Down Expand Up @@ -88,7 +89,7 @@ to process very large netgroup databases.
.Pp
The
.Nm
command prints its results on the standard output. It is usually called
utility prints its results on the standard output. It is usually called
only by
.Pa /var/yp/Makefile
when rebuilding the
Expand All @@ -97,7 +98,7 @@ netgroup maps.
.Sh OPTIONS
The
.Nm
command supports the following options:
utility supports the following options:
.Bl -tag -width indent
.It Fl u
Generate
Expand All @@ -116,7 +117,7 @@ flags must be specified.)
.It Op Fl f Ar netgroup_file
The
.Nm
command uses
utility uses
.Pa /etc/netgroup
as its default input file. The
.Fl f
Expand Down
Loading

0 comments on commit 3f162cb

Please sign in to comment.