NetBSD/usr.bin/rpcinfo/rpcinfo.8

167 lines
2.9 KiB
Groff
Raw Normal View History

1993-04-03 04:52:27 +04:00
.\" @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI
1993-06-10 23:15:08 +04:00
.\" converted to -mdoc macros by J.T. Conklin <jtc@wimsey.com>
.\"
.Dd December 17, 1987
.Dt RPCINFO 8
.Os
.Sh NAME
.Nm rpcinfo
.Nd report RPC information
.Sh SYNOPSIS
.Nm rpcinfo
.Fl p
.Op Ar host
.Nm rpcinfo
.Op Fl n Ar portnum
.Fl u Ar host
.Ar program
.Op Ar version
.Nm rpcinfo
.Op Fl n Ar portnum
.Fl t Ar host
.Ar program
.Op Ar version
.Nm rpcinfo
.Fl b
.Ar program version
.Nm rpcinfo
.Fl d
.Ar program version
.Sh DESCRIPTION
.Nm rpcinfo
1993-04-03 04:52:27 +04:00
makes an
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
call to an
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
server and reports what it finds.
1993-06-10 23:15:08 +04:00
.Sh OPTIONS
.Bl -tag -width indent
.It Fl p
1993-04-03 04:52:27 +04:00
Probe the portmapper on
1993-06-10 23:15:08 +04:00
.Ar host ,
1993-04-03 04:52:27 +04:00
and print a list of all registered
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
programs. If
1993-06-10 23:15:08 +04:00
.Ar host
1993-04-03 04:52:27 +04:00
is not specified, it defaults to the value returned by
1993-06-10 23:15:08 +04:00
.Xr hostname 1 .
.It Fl u
1993-04-03 04:52:27 +04:00
Make an
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
call to procedure 0 of
1993-06-10 23:15:08 +04:00
.Ar program
1993-04-03 04:52:27 +04:00
on the specified
1993-06-10 23:15:08 +04:00
.Ar host
1993-04-03 04:52:27 +04:00
using
1993-06-10 23:15:08 +04:00
.Tn UDP ,
1993-04-03 04:52:27 +04:00
and report whether a response was received.
1993-06-10 23:15:08 +04:00
.It Fl t
1993-04-03 04:52:27 +04:00
Make an
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
call to procedure 0 of
1993-06-10 23:15:08 +04:00
.Ar program
1993-04-03 04:52:27 +04:00
on the specified
1993-06-10 23:15:08 +04:00
.Ar host
1993-04-03 04:52:27 +04:00
using
1993-06-10 23:15:08 +04:00
.Tn TCP ,
1993-04-03 04:52:27 +04:00
and report whether a response was received.
1993-06-10 23:15:08 +04:00
.It Fl n
1993-04-03 04:52:27 +04:00
Use
1993-06-10 23:15:08 +04:00
.Ar portnum
1993-04-03 04:52:27 +04:00
as the port number for the
1993-06-10 23:15:08 +04:00
.Fl t
1993-04-03 04:52:27 +04:00
and
1993-06-10 23:15:08 +04:00
.Fl u
1993-04-03 04:52:27 +04:00
options instead of the port number given by the portmapper.
1993-06-10 23:15:08 +04:00
.It Fl b
1993-04-03 04:52:27 +04:00
Make an
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
broadcast to procedure 0 of the specified
1993-06-10 23:15:08 +04:00
.Ar program
1993-04-03 04:52:27 +04:00
and
1993-06-10 23:15:08 +04:00
.Ar version
1993-04-03 04:52:27 +04:00
using
1993-06-10 23:15:08 +04:00
.Tn UDP
1993-04-03 04:52:27 +04:00
and report all hosts that respond.
1993-06-10 23:15:08 +04:00
.It Fl d
1993-04-03 04:52:27 +04:00
Delete registration for the
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
service of the specified
1993-06-10 23:15:08 +04:00
.Ar program
1993-04-03 04:52:27 +04:00
and
1993-06-10 23:15:08 +04:00
.Ar version .
1993-04-03 04:52:27 +04:00
This option can be exercised only by the super-user.
1993-06-10 23:15:08 +04:00
.El
.Pp
1993-04-03 04:52:27 +04:00
The
1993-06-10 23:15:08 +04:00
.Ar program
1993-04-03 04:52:27 +04:00
argument can be either a name or a number.
1993-06-10 23:15:08 +04:00
.Pp
1993-04-03 04:52:27 +04:00
If a
1993-06-10 23:15:08 +04:00
.Ar version
1993-04-03 04:52:27 +04:00
is specified,
1993-06-10 23:15:08 +04:00
.Nm rpcinfo
1993-04-03 04:52:27 +04:00
attempts to call that version of the specified
1993-06-10 23:15:08 +04:00
.Ar program .
1993-04-03 04:52:27 +04:00
Otherwise,
1993-06-10 23:15:08 +04:00
.Nm rpcinfo
1993-04-03 04:52:27 +04:00
attempts to find all the registered version
numbers for the specified
1993-06-10 23:15:08 +04:00
.Ar program
1993-04-03 04:52:27 +04:00
by calling version 0 (which is presumed not
to exist; if it does exist,
1993-06-10 23:15:08 +04:00
.Ar rpcinfo
1993-04-03 04:52:27 +04:00
attempts to obtain this information by calling
an extremely high version
number instead) and attempts to call each registered version.
Note: the version number is required for
1993-06-10 23:15:08 +04:00
.Fl b
1993-04-03 04:52:27 +04:00
and
1993-06-10 23:15:08 +04:00
.Fl d
1993-04-03 04:52:27 +04:00
options.
1993-06-10 23:15:08 +04:00
.Sh EXAMPLES
1993-04-03 04:52:27 +04:00
To show all of the
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
services registered on the local machine use:
1993-06-10 23:15:08 +04:00
.Pp
.Dl example% rpcinfo -p
.Pp
1993-04-03 04:52:27 +04:00
To show all of the
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
services registered on the machine named
1993-06-10 23:15:08 +04:00
.Ar klaxon
1993-04-03 04:52:27 +04:00
use:
1993-06-10 23:15:08 +04:00
.Pp
.Dl example% rpcinfo -p klaxon
.Pp
1993-04-03 04:52:27 +04:00
To show all machines on the local net that are running the Yellow Pages
service use:
1993-06-10 23:15:08 +04:00
.Pp
.Dl example% rpcinfo -b ypserv 'version' | uniq
.Pp
1993-04-03 04:52:27 +04:00
where 'version' is the current Yellow Pages version obtained from the
results of the
1993-06-10 23:15:08 +04:00
.Fl p
1993-04-03 04:52:27 +04:00
switch above.
1993-06-10 23:15:08 +04:00
.Pp
1993-04-03 04:52:27 +04:00
To delete the registration for version 1 of the
1993-06-10 23:15:08 +04:00
.Nm walld
1993-04-03 04:52:27 +04:00
service use:
1993-06-10 23:15:08 +04:00
.Pp
.Dl example% rpcinfo -d walld 1
.Sh SEE ALSO
.Xr rpc 5 ,
.Xr portmap 8
.Rs
.%T "RPC Programming Guide"
.Re
.Sh BUGS
In releases prior to SunOS 3.0, the Network File System (NFS) did not
register itself with the portmapper;
.Nm rpcinfo
1993-04-03 04:52:27 +04:00
cannot be used to make
1993-06-10 23:15:08 +04:00
.Tn RPC
1993-04-03 04:52:27 +04:00
calls to the
1993-06-10 23:15:08 +04:00
.Tn NFS
1993-04-03 04:52:27 +04:00
server on hosts running such releases.