1. NAME▲
rpcinfo - report RPC information
2. SYNOPSIS ▲
rpcinfo - p [host] rpcinfo [-n portnum ] - u Ar host program [version] rpcinfo [-n portnum ] - t Ar host program [version] rpcinfo - b program version rpcinfo - d program version
3. DESCRIPTION ▲
rpcinfo makes an .Tn RPC call to an .Tn RPC server and reports what it finds.
4. OPTIONS ▲
-tag -width indent
-p Probe the portmapper on host , and print a list of all registered .Tn RPC programs. If host is not specified, it defaults to the value returned by hostname(1) .
-u Make an .Tn RPC call to procedure 0 of program on the specified host using .Tn UDP , and report whether a response was received.
-t Make an .Tn RPC call to procedure 0 of program on the specified host using .Tn TCP , and report whether a response was received.
-n Use portnum as the port number for the - t and - u options instead of the port number given by the portmapper.
-b Make an .Tn RPC broadcast to procedure 0 of the specified program and version using .Tn UDP and report all hosts that respond.
-d Delete registration for the .Tn RPC service of the specified program and version . This option can be exercised only by the super-user.
The program argument can be either a name or a number.
If a version is specified, rpcinfo attempts to call that version of the specified program . Otherwise, rpcinfo attempts to find all the registered version numbers for the specified program by calling version 0 (which is presumed not to exist; if it does exist, rpcinfo 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 - b and - d options.
5. EXAMPLES ▲
To show all of the .Tn RPC services registered on the local machine use:
.Dl example% rpcinfo -p
To show all of the .Tn RPC services registered on the machine named klaxon use:
.Dl example% rpcinfo -p klaxon
To show all machines on the local net that are running the Yellow Pages service use:
.Dl example% rpcinfo -b ypserv 'version' | uniq
where 'version' is the current Yellow Pages version obtained from the results of the - p switch above.
To delete the registration for version 1 of the walld service use:
.Dl example% rpcinfo -d walld 1
6. SEE ALSO ▲
7. BUGS ▲
In releases prior to SunOS 3.0, the Network File System (NFS) did not register itself with the portmapper; rpcinfo cannot be used to make .Tn RPC calls to the .Tn NFS server on hosts running such releases.