diff --git a/libexec/bootpd/bootpd.8 b/libexec/bootpd/bootpd.8 index b06b4f6ec8fe..e6ab9a8baf66 100644 --- a/libexec/bootpd/bootpd.8 +++ b/libexec/bootpd/bootpd.8 @@ -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 ) diff --git a/libexec/bootpd/tools/bootpef/bootpef.8 b/libexec/bootpd/tools/bootpef/bootpef.8 index 78fc41b02513..841b01cd4ff6 100644 --- a/libexec/bootpd/tools/bootpef/bootpef.8 +++ b/libexec/bootpd/tools/bootpef/bootpef.8 @@ -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" diff --git a/libexec/bootpd/tools/bootptest/bootptest.8 b/libexec/bootpd/tools/bootptest/bootptest.8 index 08e19a32917d..e6e48843f437 100644 --- a/libexec/bootpd/tools/bootptest/bootptest.8 +++ b/libexec/bootpd/tools/bootptest/bootptest.8 @@ -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. @@ -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 diff --git a/libexec/comsat/comsat.8 b/libexec/comsat/comsat.8 index c0e3117c047b..0b660352cd70 100644 --- a/libexec/comsat/comsat.8 +++ b/libexec/comsat/comsat.8 @@ -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 @@ -97,5 +99,5 @@ does not mess up the screen. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Bx 4.2 . diff --git a/libexec/fingerd/fingerd.8 b/libexec/fingerd/fingerd.8 index 31efd82b123b..511388e6bbc3 100644 --- a/libexec/fingerd/fingerd.8 +++ b/libexec/fingerd/fingerd.8 @@ -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. @@ -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 @@ -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 @@ -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 @@ -146,5 +150,5 @@ to all option commands received. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Bx 4.3 . diff --git a/libexec/ftpd/ftpd.8 b/libexec/ftpd/ftpd.8 index e28376bd5812..da6adf266875 100644 --- a/libexec/ftpd/ftpd.8 +++ b/libexec/ftpd/ftpd.8 @@ -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 @@ -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 @@ -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 @@ -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 @@ -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. diff --git a/libexec/getty/getty.8 b/libexec/getty/getty.8 index fe9d8798388e..bd16017ba3dc 100644 --- a/libexec/getty/getty.8 +++ b/libexec/getty/getty.8 @@ -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 . @@ -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 @@ -126,5 +124,5 @@ does not exist. .Sh HISTORY A .Nm -program appeared in +utility appeared in .At v6 . diff --git a/libexec/makekey/makekey.8 b/libexec/makekey/makekey.8 index 07518b1f66b9..90107d95ac2e 100644 --- a/libexec/makekey/makekey.8 +++ b/libexec/makekey/makekey.8 @@ -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. @@ -57,5 +58,5 @@ and how the encrypted value is calculated. .Sh HISTORY A .Nm -command appeared in +utility appeared in .At v7 . diff --git a/libexec/mknetid/mknetid.8 b/libexec/mknetid/mknetid.8 index 8a2e3ab1a512..ce27e899312d 100644 --- a/libexec/mknetid/mknetid.8 +++ b/libexec/mknetid/mknetid.8 @@ -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 @@ -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 @@ -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, @@ -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 diff --git a/libexec/pppoed/pppoed.8 b/libexec/pppoed/pppoed.8 index eedaa4a91d8d..9e0aeea725ab 100644 --- a/libexec/pppoed/pppoed.8 +++ b/libexec/pppoed/pppoed.8 @@ -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 @@ -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. @@ -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 brian@Awfulhak.org and first appeared in .Fx 3.4 . diff --git a/libexec/rbootd/rbootd.8 b/libexec/rbootd/rbootd.8 index 254d8539f123..91f52fd729d2 100644 --- a/libexec/rbootd/rbootd.8 +++ b/libexec/rbootd/rbootd.8 @@ -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. diff --git a/libexec/revnetgroup/revnetgroup.8 b/libexec/revnetgroup/revnetgroup.8 index 3bf4691e1229..d806acf45c54 100644 --- a/libexec/revnetgroup/revnetgroup.8 +++ b/libexec/revnetgroup/revnetgroup.8 @@ -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 @@ -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 @@ -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 @@ -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 diff --git a/libexec/rexecd/rexecd.8 b/libexec/rexecd/rexecd.8 index 753c06d95d6a..70318dd4507b 100644 --- a/libexec/rexecd/rexecd.8 +++ b/libexec/rexecd/rexecd.8 @@ -42,15 +42,17 @@ .Nm .Op Fl i .Sh DESCRIPTION -.Nm Rexecd -is the server for the +The +.Nm +utility is the server for the .Xr rexec 3 routine. The server provides remote execution facilities with authentication based on user names and passwords. .Pp -.Nm Rexecd -listens for service requests at the port indicated in +The +.Nm +utility listens for service requests at the port indicated in the ``exec'' service specification; see .Xr services 5 . When a service request is received the following protocol @@ -83,8 +85,9 @@ shell is retrieved on the initial socket. The length of the command is limited by the upper bound on the size of the system's argument list. .It -.Nm Rexecd -then validates the user as is done at login time +The +.Nm +utility then validates the user as is done at login time and, if the authentication was successful, changes to the user's home directory, and establishes the user and group protections of the user. @@ -99,8 +102,9 @@ by .Nm . .El .Sh CAVEATS -.Nm Rexecd -will not allow root logins unless the +The +.Nm +utility will not allow root logins unless the .Fl i option is given on the command line (typically in .Pa /etc/inetd.conf ) . @@ -109,8 +113,9 @@ It will also disallow access for users listed in or users with no passwords, which were all serious security holes. The entire concept of rexec/rexecd is a major security hole and an example of how not to do things. -.Nm Rexecd -is disabled by default in +The +.Nm +utility is disabled by default in .Pa /etc/inetd.conf . .Sh DIAGNOSTICS Except for the last one listed below, @@ -156,5 +161,5 @@ present. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Bx 4.2 . diff --git a/libexec/rlogind/rlogind.8 b/libexec/rlogind/rlogind.8 index 9f30fd813ef1..39a7444ec0cc 100644 --- a/libexec/rlogind/rlogind.8 +++ b/libexec/rlogind/rlogind.8 @@ -42,8 +42,9 @@ .Nm .Op Fl Daln .Sh DESCRIPTION -.Nm Rlogind -is the server for the +The +.Nm +utility is the server for the .Xr rlogin 1 program. The server provides a remote login facility with authentication based on privileged port numbers from trusted hosts. @@ -80,8 +81,9 @@ and utilization, but provides increased security. .El .Pp -.Nm Rlogind -listens for service requests at the port indicated in +The +.Nm +utility listens for service requests at the port indicated in the .Dq login service specification; see @@ -200,7 +202,7 @@ A more extensible protocol should be used. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Bx 4.2 . .Pp IPv6 support was added by WIDE/KAME project. diff --git a/libexec/rpc.rquotad/rpc.rquotad.8 b/libexec/rpc.rquotad/rpc.rquotad.8 index 9d3c8af88556..a779c3eadf20 100644 --- a/libexec/rpc.rquotad/rpc.rquotad.8 +++ b/libexec/rpc.rquotad/rpc.rquotad.8 @@ -38,19 +38,23 @@ .Sh SYNOPSIS .Nm /usr/libexec/rpc.rquotad .Sh DESCRIPTION -.Nm Rpc.rquotad -is a +The +.Nm +utility is a .Xr rpc 3 server which returns quotas for a user of a local filesystem which is NFS-mounted onto a remote machine. -.Xr Quota 1 -uses the results to display user quotas for remote filesystems. -.Nm Rpc.rquotad -is normally invoked by +The +.Xr quota 1 +utility uses the results to display user quotas for remote filesystems. +The +.Nm +utility is normally invoked by .Xr inetd 8 . .Pp -.Nm Rpc.rquotad -uses an +The +.Nm +utility uses an .Tn RPC protocol defined in .Pa /usr/include/rpcsvc/rquota.x . diff --git a/libexec/rpc.rstatd/rpc.rstatd.8 b/libexec/rpc.rstatd/rpc.rstatd.8 index ade5bbdec76d..ebaa766efd88 100644 --- a/libexec/rpc.rstatd/rpc.rstatd.8 +++ b/libexec/rpc.rstatd/rpc.rstatd.8 @@ -42,7 +42,9 @@ .Sh SYNOPSIS .Nm /usr/libexec/rpc.rstatd .Sh DESCRIPTION -.Nm Rpc.rstatd +The +.Nm +utility is a server which returns performance statistics obtained from the kernel. These statistics are read using the .Xr rup 1 @@ -52,8 +54,9 @@ The daemon is normally invoked by .Xr inetd 8 . .Pp -.Nm Rpc.rstatd -uses an +The +.Nm +utility uses an .Tn RPC protocol defined in .Pa /usr/include/rpcsvc/rstat.x . diff --git a/libexec/rpc.rusersd/rpc.rusersd.8 b/libexec/rpc.rusersd/rpc.rusersd.8 index e5bbe2fe96e1..6efd47de9ede 100644 --- a/libexec/rpc.rusersd/rpc.rusersd.8 +++ b/libexec/rpc.rusersd/rpc.rusersd.8 @@ -42,8 +42,9 @@ .Sh SYNOPSIS .Nm /usr/libexec/rpc.rusersd .Sh DESCRIPTION -.Nm Rpc.rusersd -is a server which returns information about users +The +.Nm +utility is a server which returns information about users currently logged in to the system. .Pp The currently logged in users are queried using the @@ -54,8 +55,9 @@ The daemon is normally invoked by .Xr inetd 8 . .Pp -.Nm Rpc.rusersd -uses an +The +.Nm +utility uses an .Tn RPC protocol defined in .Pa /usr/include/rpcsvc/rnusers.x . diff --git a/libexec/rpc.rwalld/rpc.rwalld.8 b/libexec/rpc.rwalld/rpc.rwalld.8 index 6846e2ee9555..79a02b11b89c 100644 --- a/libexec/rpc.rwalld/rpc.rwalld.8 +++ b/libexec/rpc.rwalld/rpc.rwalld.8 @@ -43,8 +43,9 @@ .Nm /usr/libexec/rpc.rwalld .Op Fl n .Sh DESCRIPTION -.Nm Rpc.rwalld -is a server which will send a message to users +The +.Nm +utility is a server which will send a message to users currently logged in to the system. This server invokes the .Xr wall 1 @@ -68,8 +69,9 @@ The daemon is normally invoked by .Xr inetd 8 . .Pp -.Nm Rpc.rwalld -uses an +The +.Nm +utility uses an .Tn RPC protocol defined in .Pa /usr/include/rpcsvc/rwall.x . diff --git a/libexec/rpc.sprayd/rpc.sprayd.8 b/libexec/rpc.sprayd/rpc.sprayd.8 index 5ca9d889c727..8840043e5ed2 100644 --- a/libexec/rpc.sprayd/rpc.sprayd.8 +++ b/libexec/rpc.sprayd/rpc.sprayd.8 @@ -38,7 +38,9 @@ .Sh SYNOPSIS .Nm /usr/libexec/rpc.sprayd .Sh DESCRIPTION -.Nm Rpc.sprayd +The +.Nm +utility is a server which records packets sent by the .Xr spray 8 command and sends a traffic report to the originator of the packets. @@ -47,8 +49,9 @@ The daemon is normally invoked by .Xr inetd 8 . .Pp -.Nm Rpc.sprayd -uses an +The +.Nm +utility uses an .Tn RPC protocol defined in .Pa /usr/include/rpcsvc/spray.x . diff --git a/libexec/rshd/rshd.8 b/libexec/rshd/rshd.8 index 76db9e9ad9c7..b6c9c2ba6217 100644 --- a/libexec/rshd/rshd.8 +++ b/libexec/rshd/rshd.8 @@ -44,7 +44,7 @@ .Sh DESCRIPTION The .Nm -server +utility is the server for the .Xr rcmd 3 routine and, consequently, for the @@ -54,8 +54,7 @@ with authentication based on privileged port numbers from trusted hosts. .Pp The .Nm -server -listens for service requests at the port indicated in +utility listens for service requests at the port indicated in the .Dq cmd service specification; see @@ -111,8 +110,9 @@ shell is retrieved on the initial socket. The length of the command is limited by the upper bound on the size of the system's argument list. .It -.Nm Rshd -then validates the user using +The +.Nm +utility then validates the user using .Xr ruserok 3 , which uses the file .Pa /etc/hosts.equiv diff --git a/libexec/rtld-elf/rtld.1 b/libexec/rtld-elf/rtld.1 index dad1a6306615..8b1c6a9c9c13 100644 --- a/libexec/rtld-elf/rtld.1 +++ b/libexec/rtld-elf/rtld.1 @@ -36,8 +36,9 @@ .Nm rtld .Nd run-time link-editor .Sh DESCRIPTION +The .Nm -is a self-contained shared object providing run-time +utility is a self-contained shared object providing run-time support for loading and link-editing shared objects into a process' address space. It is also commonly known as the dynamic linker. @@ -56,8 +57,9 @@ to be called on a per-object basis, giving a shared object an opportunity to perform any extra set-up before execution of the program proper begins. This is useful for C++ libraries that contain static constructors. .Pp +The .Nm -itself is loaded by the kernel together with any dynamically-linked +utility itself is loaded by the kernel together with any dynamically-linked program that is to be executed. The kernel transfers control to the dynamic linker. @@ -73,7 +75,9 @@ file prepared by the .Xr ldconfig 8 utility. .Pp +The .Nm +utility recognizes a number of environment variables that can be used to modify its behaviour as follows: .Pp diff --git a/libexec/talkd/talkd.8 b/libexec/talkd/talkd.8 index 82413b2a7ed7..671a5e1389c4 100644 --- a/libexec/talkd/talkd.8 +++ b/libexec/talkd/talkd.8 @@ -41,7 +41,9 @@ .Sh SYNOPSIS .Nm .Sh DESCRIPTION -.Nm Talkd +The +.Nm +utility is the server that notifies a user that someone else wants to initiate a conversation. It acts as a repository of invitations, responding to requests @@ -74,5 +76,5 @@ stream connection through which the conversation takes place. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Bx 4.3 . diff --git a/libexec/telnetd/telnetd.8 b/libexec/telnetd/telnetd.8 index b11fbac76059..306e15eb0a52 100644 --- a/libexec/telnetd/telnetd.8 +++ b/libexec/telnetd/telnetd.8 @@ -54,13 +54,14 @@ protocol server .Sh DESCRIPTION The .Nm -command is a server which supports the +utility is a server which supports the .Tn DARPA standard .Tn TELNET virtual terminal protocol. -.Nm Telnetd -is normally invoked by the internet server (see +The +.Nm +utility is normally invoked by the internet server (see .Xr inetd 8 ) for requests to connect to the .Tn TELNET @@ -84,7 +85,7 @@ port number. .Pp The .Nm -command accepts the following options: +utility accepts the following options: .Bl -tag -width indent .It Fl a Ar authmode This option may be used for specifying what mode should @@ -279,8 +280,9 @@ a specific authentication type without having to recompile .Nm . .El .Pp -.Nm Telnetd -operates by allocating a pseudo-terminal device (see +The +.Nm +utility operates by allocating a pseudo-terminal device (see .Xr pty 4 ) for a client, then creating a login process which has the slave side of the pseudo-terminal as @@ -288,8 +290,9 @@ the slave side of the pseudo-terminal as .Dv stdout and .Dv stderr . -.Nm Telnetd -manipulates the master side of the pseudo-terminal, +The +.Nm +utility manipulates the master side of the pseudo-terminal, implementing the .Tn TELNET protocol and passing characters @@ -332,8 +335,9 @@ mode, and with enabled (see .Xr tty 4 ) . .Pp -.Nm Telnetd -has support for enabling locally the following +The +.Nm +utility has support for enabling locally the following .Tn TELNET options: .Bl -tag -width "DO AUTHENTICATION" @@ -393,8 +397,9 @@ indicates a willingness to decrypt the data stream. .El .Pp -.Nm Telnetd -has support for enabling remotely the following +The +.Nm +utility has support for enabling remotely the following .Tn TELNET options: .Bl -tag -width "DO AUTHENTICATION" @@ -578,8 +583,9 @@ has no common interpretation except between similar operating systems The terminal type name received from the remote client is converted to lower case. .Pp -.Nm Telnetd -never sends +The +.Nm +utility never sends .Tn TELNET .Dv IAC GA (go ahead) commands. diff --git a/libexec/tftpd/tftpd.8 b/libexec/tftpd/tftpd.8 index ef8be4a651de..953dff7569f2 100644 --- a/libexec/tftpd/tftpd.8 +++ b/libexec/tftpd/tftpd.8 @@ -45,8 +45,9 @@ .Op Fl u Ar user .Op Ar directory ... .Sh DESCRIPTION -.Nm Tftpd -is a server which supports the +The +.Nm +utility is a server which supports the Internet Trivial File Transfer Protocol .Pq Tn RFC 1350 . @@ -177,7 +178,7 @@ The user must be specified by name, not a numeric UID. .Sh HISTORY The .Nm -command appeared in +utility appeared in .Bx 4.2 ; the .Fl s diff --git a/libexec/xtend/xtend.8 b/libexec/xtend/xtend.8 index 75f23b3d0f7a..411edb2a14ba 100644 --- a/libexec/xtend/xtend.8 +++ b/libexec/xtend/xtend.8 @@ -38,7 +38,9 @@ .Sh SYNOPSIS .Nm /usr/libexec/xtend .Sh DESCRIPTION -.Nm Xtend +The +.Nm +utility interfaces between user-level programs and the TW523 X-10 controller. It logs all packets received from the TW523, attempts to track the status of all X-10 devices, and accepts socket connections from user-level @@ -51,8 +53,9 @@ its log file, where it subsequently records all X-10 activity and diagnostic messages. It then begins processing packets received from the TW523 and accepting connections one at a time from clients wishing to issue X-10 commands. -.Nm Xtend -is started from +The +.Nm +utility is started from .Pa /etc/rc.i386 startup script if enabled in .Pa /etc/rc.conf @@ -76,13 +79,16 @@ causes .Nm to abort the current client connection. .Pp -.Nm Xtend +The +.Nm +utility communicates with client processes by a simple protocol in which a one-line command is sent by the client, and is acknowledged by a one-line response from the daemon. .Pp -.Nm Xtend -understands four types of commands: +The +.Nm +utility understands four types of commands: .Bl -tag -width "monitor H U .It Ic status Ar H U where @@ -133,7 +139,9 @@ is returned if the maximum (currently 5) number of such clients was not exceeded, otherwise .Sy ERROR is returned. -.Nm Xtend +The +.Nm +utility then returns to its normal mode of accepting connections from clients. However, each subsequent change in the status of the specified device will cause @@ -170,7 +178,9 @@ dump of device status There is currently no timeout on client socket connections, so a hung client program can prevent other clients from accessing the daemon. .Pp -.Nm Xtend +The +.Nm +utility does the best it can at trying to track device status, but there is usually no way it can tell when a device has been operated manually. This is due to the fact that most X-10 devices are not able to diff --git a/libexec/ypxfr/ypxfr.8 b/libexec/ypxfr/ypxfr.8 index cdb7bf6ddf82..c5fdc44e2366 100644 --- a/libexec/ypxfr/ypxfr.8 +++ b/libexec/ypxfr/ypxfr.8 @@ -47,8 +47,9 @@ .Op Fl C Ar taskid program-number ipaddr port .Ar mapname .Sh DESCRIPTION -.Nm Ypxfr -copies an +The +.Nm +utility copies an .Tn NIS database (or .Pa map ) @@ -63,8 +64,9 @@ is generally invoked by .Xr ypserv 8 when it receives a map transfer request from .Xr yppush 8 . -.Nm Ypxfr -is used primarily in environments where several +The +.Nm +utility is used primarily in environments where several .Tn NIS servers are in use in a single domain. One server, the .Tn NIS @@ -160,7 +162,7 @@ transfer method, particularly for very large .Tn NIS maps. The .Nm -command will check to see if the +utility will check to see if the .Xr rpc.ypxfrd 8 server is registered on the .Tn NIS