'\"
'\" Copyright (c) 1994-1996 Technical University of Braunschweig.
'\" Copyright (c) 1996-1997 University of Twente.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\" 
.so man.macros
.TH Tnm::sunrpc n "December 1997" Tnm "Tnm Tcl Extension"
.BS
'\" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
Tnm::sunrpc \- Call and probe selected Sun RPC services.
.BE

.SH DESCRIPTION
The Tnm::sunrpc command allows to call and probe selected Sun RPC
(RFC 1831, RFC 1832) services.

.SH SUNRPC COMMAND
.TP
.B Tnm::sunrpc info \fIhost\fR
The \fBTnm::sunrpc info\fR command returns a list of all registered Sun RPC
services on \fIhost\fR. Each list element contains the program number,
the program version, the protocol name, the port number and the name
of the RPC service. The command fails, if \fIhost\fR is unknown or if
the portmapper does not respond to our request.
.TP
.B sunrpc probe \fIhost\fR \fIprogram\fR \fIversion\fR \fIprotocol\fR
The \fBTnm::sunrpc probe\fR command tests a Sun RPC service identified by
\fIprogram\fR \fIversion\fR \fIprotocol\fR on \fIhost\fR by calling
procedure 0. This command returns a list of two elements. The first
element is the time needed to complete the RPC call and the second
element is a string which describes if the probe was successful.
.TP
.B Tnm::sunrpc stat \fIhost\fR
The \fBTnm::sunrpc stat\fR command makes an rstat RPC call to \fIhost\fR
and returns a list of name type value triples describing the status of
the remote machine. This command fails if \fIhost\fR is not reachable
or does not support the rstat service.
.TP
.B Tnm::sunrpc mount \fIhost\fR
The \fBTnm::sunrpc mount\fR command retrieves a list of all NFS file systems 
currently mounted from \fIhost\fR. Each element of the list includes
the directory name and the host which serves the directory.
.TP
.B Tnm::sunrpc exports \fIhost\fR
The \fBTnm::sunrpc exports\fR command retrieves a list of all NFS file
systems exported by \fIhost\fR. Each element of this list contains the
exported directory name and the list of hosts that are allowed to
mount the exported directory. An empty host list means that an
exported directory can be mounted by everyone.
.TP
.B Tnm::sunrpc ether \fIhost\fR \fBopen
.ns
.TP
.B Tnm::sunrpc ether \fIhost\fR
.ns
.TP
.B Tnm::sunrpc ether \fIhost\fR \fBclose
The \fBTnm::sunrpc ether\fR command allows to query an etherd daemon for
ethernet statistics. You first have to register at the remote etherd
using the \fBopen\fR command option. Afterwards, you can query the
etherd which will return a list of name type value triples describing
the packets counted since the last query. You should unregister at the
remote etherd using the \fBclose\fR option once you are no longer
interested in ethernet statistics.
.TP
.B Tnm::sunrpc pcnfs \fIhost\fB info \fR[\fIarray\fR]
.ns
.TP
.B Tnm::sunrpc pcnfs \fIhost\fB list \fR[\fIarray\fR]
.ns
.TP
.B Tnm::sunrpc pcnfs \fIhost\fB queue \fIprinter\fB \fR[\fIarray\fR]
.ns
.TP
.B Tnm::sunrpc pcnfs \fIhost\fB status \fIprinter\fB \fIarray\fR
The \fBTnm::sunrpc pcnfs\fR command allows to retrieve printer status
information provided by the pcnfsd daemon. The first command retrieves
the daemon identification. The optional \fIarray\fR variable will be
filled with details about the supported procedures. The second command
returns the list of all printer names known by the pcnsfd daemon on
\fIhost\fR. The optional \fIarray\fR is indexed by printer name and
contains additional information about each printer. The queue
subcommand retrieves the \fIprinter\fR queue and returns the actual
queue length. Information about queued print jobs is written to the
\fIarray\fR variable if given. The array is indexed by the queue
position and contains information about the print job in key value
pairs. The last pcnfs command retrieves \fIprinter\fR specific status
information about the printer itself. The status is written into the
\fIarray\fR variable.

.SH SEE ALSO
scotty(1), Tnm(n), Tcl(n)

.SH AUTHORS
Juergen Schoenwaelder <schoenw@ibr.cs.tu-bs.de>
.br
