| Linux / Unix Command: rpcinfo |
NAME
rpcinfo - report RPC informationSYNOPSIS
rpcinfo -p [host ]rpcinfo [-n portnum ] -u host program [version ]
rpcinfo [-n portnum ] -t host program [version ]
rpcinfo -b program version
rpcinfo -d program version
DESCRIPTION
rpcinfo makes an RPC call to an RPC server and reports what it finds.OPTIONS
- -p
- Probe the portmapper on host and print a list of all registered RPC programs. If host is not specified, it defaults to the value returned by hostname(1).
- -u
- Make an RPC call to procedure 0 of program on the specified host using UDP and report whether a response was received.
- -t
- Make an RPC call to procedure 0 of program on the specified host using 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 RPC broadcast to procedure 0 of the specified program and version using UDP and report all hosts that respond.
- -d
- Delete registration for the 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.
EXAMPLES
To show all of the RPC services registered on the local machine use:
example% rpcinfo -p
To show all of the RPC services registered on the machine named klaxon use:
example% rpcinfo -p klaxon
To show all machines on the local net that are running the Yellow Pages service use:
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:
example% rpcinfo -d walld 1
SEE ALSO
rpc(5), portmap(8)- "RPC Programming Guide"
Important: Use the man command (% man) to see how a command is used on your particular computer.
