Commands Reference, Volume 4

rpcinfo Command

Purpose

Reports the status of Remote Procedure Call (RPC) servers.

Syntax

To Display a List of Statistics

/usr/bin/rpcinfo [ -m | -s ] [ Host ]

To Display a List of Registered RPC Programs

/usr/bin/rpcinfo -p [ Host ]

To Report Transport

/usr/bin/rpcinfo -T transport Host Prognum [ Versnum ]

To Display a List of Entries

/usr/bin/rpcinfo -l [ -T transport ] Host Prognum Versnum

To Report Program Status

/usr/bin/rpcinfo [ -n PortNum ] -u Host Prognum [ Versnum ]

To Report Response Status

/usr/bin/rpcinfo [ -n PortNum ] -t Host Prognum [ Versnum ]

To Display All Hosts Running a Specified Program Version

/usr/bin/rpcinfo [ -b ] [ -T transport ] Prognum Versnum

To Delete Registration of a Service

/usr/bin/rpcinfo [ -d ] [ -T transport ] Prognum Versnum

Description

The rpcinfo command makes an RPC call to an RPC server and reports the status of the server. For instance, this command reports whether the server is ready and waiting or not available.

The program parameter can be either a name or a number. If you specify a version, the rpcinfo command attempts to call that version of the specified program. Otherwise, the rpcinfo command attempts to find all the registered version numbers for the program you specify by calling version 0 (zero) and then attempts to call each registered version. (Version 0 is presumed not to exist. If it does exist, the rpcinfo command attempts to obtain this information by calling an extremely high version number instead.)

Flags

-b	Makes an RPC broadcast to procedure 0 of the specified prognum and versnum and reports all hosts that respond. If transport is specified, it broadcasts its request only on the specified transport. If broadcasting is not supported by any transport, an error message is printed. Using broadcasting (-b flag) should be limited because of the possible adverse effect on other systems.
-d	Deletes registration for the RPC service of the specified prognum and versnum. If transport is used, unregister the service only on that transport, otherwise unregister the service on all the transports where it was registered. This option can be exercised only by the root user.
-l	Displays a list of entries with the specified prognum and versnum on the specified host. Entries are returned for all transports in the same protocol family as those used to contact the remote portmap daemon. This flag only applies to AIX 4.2.1 or later.
-m	Displays a table of portmap operations statistics on the specified host. The table contains statistics for each version of portmap (Versions 2, 3, and 4), the number of times each procedure was requested and successfully serviced, the number and type of remote call requests that were made, and information about RPC address lookups that were handled. This information is used for monitoring RPC activities on the host. This flag only applies to AIX 4.2.1 or later.
-n Portnum	Use the Portnum parameter as the port number for the -t and -u options instead of the port number given by the portmap. Using the -n options avoids a call to the remote portmap to find out the address of the service. This option is made obsolete by the -a option.
-p	Probes the portmap service on the host using Version 2 of the portmap protocol and displays a list of all registered RPC programs. If a host is not specified, it defaults to the local host.
-s	Displays a concise list of all registered RPC programs on the host. If host is not specified, the default is the local host. This flag only applies to AIX 4.2.1 or later.
-t	Makes an RPC call to procedure 0 of prognum on the specified host using TCP, and reports whether a response was received. This option is made obsolete when using the -T option as shown in the third syntax.
-T	Specifies the transport where the service is required. This flag only applies to AIX 4.2.1 or later.
-u	Makes an RPC call to procedure 0 of prognum on the specified host using UDP, and reports whether a response was received. This option is made obsolete when using the -T option as shown in the third syntax.

Examples

To show all of the RPC services registered on a local machine, enter:
rpcinfo -p
To show all of the RPC services registered on a specific machine, enter:
rpcinfo -p zelda
In this example, the rpcinfo command shows all RPC services registered on a machine named zelda.
To show all machines on the local network that are running a certain version of a specific server, enter:
rpcinfo -b ypserv 2
In this example, the rpcinfo command shows a list of all machines that are running version 2 of the ypserv daemon.
To delete the registration of a service, enter:
rpcinfo -d sprayd 1
In this example, the rpcinfo command deletes version 1 of the sprayd daemon.

Files

/etc/rpc
	Contains a list of server names and their corresponding RPC program numbers and aliases.
/etc/services
	Contains an entry for each service available through the Internet network.

Related Information

The portmap daemon.

Network File System (NFS) Overview for System Management in AIX 5L Version 5.2 System Management Guide: Communications and Networks.

List of NFS Commands.