741 lines
9.3 KiB
HTML
741 lines
9.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of RPCINFO</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>RPCINFO</H1>
|
|
Section: Maintenance Commands (8)<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
<BR>BSD mandoc<BR>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
<B>rpcinfo</B>
|
|
|
|
- report RPC information
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>rpcinfo</B>
|
|
|
|
[-<B>m | -s</B>
|
|
|
|
|
|
|
|
|
|
|
|
]
|
|
|
|
[<I>host</I>
|
|
|
|
]
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
-<B>p </B>[<I>host</I>
|
|
|
|
]
|
|
|
|
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
-<B>T </B><I>transport</I>
|
|
|
|
|
|
|
|
<I>host prognum</I>
|
|
|
|
|
|
|
|
[<I>versnum</I>
|
|
|
|
]
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
-<B>l</B>
|
|
|
|
[-<B>T </B><I>transport</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
<I>host prognum versnum</I>
|
|
|
|
|
|
|
|
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
[-<B>n </B><I>portnum</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
-<B>u</B>
|
|
|
|
<I>host prognum</I>
|
|
|
|
|
|
|
|
[<I>versnum</I>
|
|
|
|
]
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
[-<B>n </B><I>portnum</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
[-<B>t</B>
|
|
|
|
]
|
|
|
|
<I>host prognum</I>
|
|
|
|
|
|
|
|
[<I>versnum</I>
|
|
|
|
]
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
-<B>a </B><I>serv_address</I>
|
|
|
|
|
|
|
|
-<B>T </B><I>transport</I>
|
|
|
|
|
|
|
|
<I>prognum</I>
|
|
|
|
[<I>versnum</I>
|
|
|
|
]
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
-<B>b</B>
|
|
|
|
[-<B>T </B><I>transport</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
<I>prognum versnum</I>
|
|
|
|
|
|
|
|
<BR><B>rpcinfo</B>
|
|
|
|
-<B>d</B>
|
|
|
|
[-<B>T </B><I>transport</I>
|
|
|
|
|
|
|
|
]
|
|
|
|
<I>prognum versnum</I>
|
|
|
|
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
makes an RPC call to an RPC
|
|
server and reports what it finds.
|
|
<P>
|
|
|
|
In the first synopsis,
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
lists all the registered RPC services with
|
|
<B>rpcbind</B>
|
|
|
|
on
|
|
<I>host</I>
|
|
|
|
|
|
If
|
|
<I>host</I>
|
|
|
|
is not specified, the local host is the default.
|
|
If
|
|
-<B>s</B>
|
|
|
|
is used, the information is displayed in a concise format.
|
|
<P>
|
|
|
|
In the second synopsis,
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
lists all the RPC services registered with
|
|
<B>rpcbind</B>
|
|
|
|
|
|
version 2.
|
|
Also note that the format of the information
|
|
is different in the first and the second synopsis.
|
|
This is because the second synopsis is an older protocol used to
|
|
collect the information displayed (version 2 of the
|
|
<B>rpcbind</B>
|
|
|
|
protocol).
|
|
<P>
|
|
|
|
The third synopsis makes an RPC call to procedure 0
|
|
of
|
|
<I>prognum</I>
|
|
|
|
and
|
|
<I>versnum</I>
|
|
|
|
on the specified
|
|
<I>host</I>
|
|
|
|
and reports whether a response was received.
|
|
<I>transport</I>
|
|
|
|
is the transport which has to be used for contacting the
|
|
given service.
|
|
The remote address of the service is obtained by
|
|
making a call to the remote
|
|
<B>rpcbind</B>
|
|
|
|
|
|
<P>
|
|
|
|
The
|
|
<I>prognum</I>
|
|
|
|
argument is a number that represents an RPC program number.
|
|
If a
|
|
<I>versnum</I>
|
|
|
|
is specified,
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
attempts to call that version of the specified
|
|
<I>prognum</I>
|
|
|
|
|
|
Otherwise,
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
attempts to find all the registered version
|
|
numbers for the specified
|
|
<I>prognum</I>
|
|
|
|
by calling version 0,
|
|
which is presumed not to exist;
|
|
if it does exist,
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
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>b</B>
|
|
|
|
and
|
|
-<B>d</B>
|
|
|
|
options.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<P>
|
|
|
|
<DT id="1"><B>-T </B><I>transport</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Specify the transport on which the service is required.
|
|
If this option is not specified,
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
uses the transport specified in the
|
|
<B>NETPATH</B>
|
|
|
|
environment variable, or if that is unset or null, the transport
|
|
in the
|
|
<A HREF="/cgi-bin/man/man2html?5+netconfig">netconfig</A>(5)
|
|
|
|
|
|
database is used.
|
|
This is a generic option,
|
|
and can be used in conjunction with other options as
|
|
shown in the SYNOPSIS.
|
|
<P>
|
|
|
|
<DT id="2"><B>-a </B><I>serv_address</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Use
|
|
<I>serv_address</I>
|
|
|
|
as the (universal) address for the service on
|
|
<I>transport</I>
|
|
|
|
to ping procedure 0
|
|
of the specified
|
|
<I>prognum</I>
|
|
|
|
and report whether a response was received.
|
|
The
|
|
-<B>T</B>
|
|
|
|
option is required with the
|
|
-<B>a</B>
|
|
|
|
option.
|
|
<P>
|
|
|
|
If
|
|
<I>versnum</I>
|
|
|
|
is not specified,
|
|
<B>rpcinfo</B>
|
|
|
|
|
|
tries to ping all
|
|
available version numbers for that program number.
|
|
This option avoids calls to remote
|
|
<B>rpcbind</B>
|
|
|
|
to find the address of the service.
|
|
The
|
|
<I>serv_address</I>
|
|
|
|
is specified in universal address format of the given transport.
|
|
<P>
|
|
|
|
<DT id="3"><B>-b</B>
|
|
|
|
|
|
<DD>
|
|
Make an RPC broadcast to procedure 0
|
|
of the specified
|
|
<I>prognum</I>
|
|
|
|
and
|
|
<I>versnum</I>
|
|
|
|
and report all hosts that respond.
|
|
If
|
|
<I>transport</I>
|
|
|
|
is specified, it broadcasts its request only on the
|
|
specified transport.
|
|
If broadcasting is not supported by any
|
|
transport,
|
|
an error message is printed.
|
|
Use of broadcasting should be limited because of the potential for adverse
|
|
effect on other systems.
|
|
<P>
|
|
|
|
<DT id="4"><B>-d</B>
|
|
|
|
|
|
<DD>
|
|
Delete registration for the RPC service of the specified
|
|
<I>prognum</I>
|
|
|
|
and
|
|
<I>versnum</I>
|
|
|
|
|
|
If
|
|
<I>transport</I>
|
|
|
|
is specified,
|
|
unregister the service on only that transport,
|
|
otherwise unregister the service on all
|
|
the transports on which it was registered.
|
|
Only the owner of a service can delete a registration, except the
|
|
super-user who can delete any service.
|
|
<P>
|
|
|
|
<DT id="5"><B>-l</B>
|
|
|
|
|
|
<DD>
|
|
Display a list of entries with a given
|
|
<I>prognum</I>
|
|
|
|
and
|
|
<I>versnum</I>
|
|
|
|
on the specified
|
|
<I>host</I>
|
|
|
|
|
|
Entries are returned for all transports
|
|
in the same protocol family as that used to contact the remote
|
|
<B>rpcbind</B>
|
|
|
|
|
|
<P>
|
|
|
|
<DT id="6"><B>-m</B>
|
|
|
|
|
|
<DD>
|
|
Display a table of statistics of
|
|
<B>rpcbind</B>
|
|
|
|
operations on the given
|
|
<I>host</I>
|
|
|
|
|
|
The table shows statistics for each version of
|
|
<B>rpcbind</B>
|
|
|
|
(versions 2, 3 and 4), giving 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 is useful for monitoring RPC activities on
|
|
<I>host</I>
|
|
|
|
|
|
<P>
|
|
|
|
<DT id="7"><B>-n </B><I>portnum</I>
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
Use
|
|
<I>portnum</I>
|
|
|
|
as the port number for the
|
|
-<B>t</B>
|
|
|
|
and
|
|
-<B>u</B>
|
|
|
|
options instead of the port number given by
|
|
<B>rpcbind</B>
|
|
|
|
|
|
Use of this option avoids a call to the remote
|
|
<B>rpcbind</B>
|
|
|
|
to find out the address of the service. This option is made
|
|
obsolete by the
|
|
-<B>a</B>
|
|
|
|
option.
|
|
<P>
|
|
|
|
<DT id="8"><B>-p</B>
|
|
|
|
|
|
<DD>
|
|
Probe
|
|
<B>rpcbind</B>
|
|
|
|
on
|
|
<I>host</I>
|
|
|
|
using version 2 of the
|
|
<B>rpcbind</B>
|
|
|
|
protocol,
|
|
and display a list of all registered RPC programs.
|
|
If
|
|
<I>host</I>
|
|
|
|
is not specified, it defaults to the local host.
|
|
Note: Version 2 of the
|
|
<B>rpcbind</B>
|
|
|
|
protocol was previously known as the portmapper protocol.
|
|
<P>
|
|
|
|
<DT id="9"><B>-s</B>
|
|
|
|
|
|
<DD>
|
|
Display a concise list of all registered RPC programs on
|
|
<I>host</I>
|
|
|
|
|
|
If
|
|
<I>host</I>
|
|
|
|
is not specified, it defaults to the local host.
|
|
<P>
|
|
|
|
<DT id="10"><B>-t</B>
|
|
|
|
|
|
<DD>
|
|
Make an RPC call to procedure 0 of
|
|
<I>prognum</I>
|
|
|
|
on the specified
|
|
<I>host</I>
|
|
|
|
using TCP,
|
|
and report whether a response was received. This option is made
|
|
obsolete by the
|
|
-<B>T</B>
|
|
|
|
option as shown in the third synopsis.
|
|
<P>
|
|
|
|
<DT id="11"><B>-u</B>
|
|
|
|
|
|
<DD>
|
|
Make an RPC call to procedure 0 of
|
|
<I>prognum</I>
|
|
|
|
on the specified
|
|
<I>host</I>
|
|
|
|
using UDP,
|
|
and report whether a response was received. This option is made
|
|
obsolete by the
|
|
-<B>T</B>
|
|
|
|
option as shown in the third synopsis.
|
|
</DL>
|
|
<P>
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
To show all of the RPC services registered on the local machine use:
|
|
<P>
|
|
|
|
|
|
<PRE>
|
|
example% rpcinfo
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
To show all of the RPC
|
|
services registered with
|
|
<B>rpcbind</B>
|
|
|
|
on the machine named
|
|
<B>klaxon</B>
|
|
|
|
use:
|
|
<P>
|
|
|
|
|
|
<PRE>
|
|
example% rpcinfo klaxon
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
The information displayed by the above commands can be quite lengthy.
|
|
Use the
|
|
-<B>s</B>
|
|
|
|
option to display a more concise list:
|
|
<P>
|
|
|
|
|
|
<PRE>
|
|
example$ rpcinfo -s klaxon
|
|
</PRE>
|
|
|
|
<DL COMPACT>
|
|
<P>
|
|
|
|
<DT id="12"><B>program Ta </B>version Ta netid Ta service Ta owner
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="13"><B>100000 Ta </B>2,3,4 Ta local,tcp,udp,tcp6,udp6 Ta rpcbind Ta super-user
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="14"><B>100008 Ta </B>1 Ta udp,tcp,udp6,tcp6 Ta walld Ta super-user
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="15"><B>100002 Ta </B>2,1 Ta udp,udp6 Ta rusersd Ta super-user
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="16"><B>100001 Ta </B>2,3,4 Ta udp,udp6 Ta rstatd Ta super-user
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="17"><B>100012 Ta </B>1 Ta udp,tcp Ta sprayd Ta super-user
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
<DT id="18"><B>100007 Ta </B>3 Ta udp,tcp Ta ypbind Ta super-user
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<DD>
|
|
</DL>
|
|
<P>
|
|
|
|
<P>
|
|
|
|
To show whether the RPC
|
|
service with program number
|
|
<I>prognum</I>
|
|
|
|
and version
|
|
<I>versnum</I>
|
|
|
|
is registered on the machine named
|
|
<B>klaxon</B>
|
|
|
|
for the transport TCP
|
|
use:
|
|
<P>
|
|
|
|
|
|
<PRE>
|
|
example% rpcinfo -T tcp klaxon prognum versnum
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
To show all RPC
|
|
services registered with version 2 of the
|
|
<B>rpcbind</B>
|
|
|
|
protocol on the local machine use:
|
|
|
|
<PRE>
|
|
example% rpcinfo -p
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
To delete the registration for version
|
|
1 of the
|
|
<B>walld</B>
|
|
|
|
(program number 100008 )
|
|
service for all transports use:
|
|
|
|
<PRE>
|
|
example# rpcinfo -d 100008 1
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
or
|
|
|
|
<PRE>
|
|
example# rpcinfo -d walld 1
|
|
</PRE>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<A HREF="/cgi-bin/man/man2html?3+rpc">rpc</A>(3),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?5+netconfig">netconfig</A>(5),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?5+rpc">rpc</A>(5),
|
|
|
|
|
|
<A HREF="/cgi-bin/man/man2html?8+rpcbind">rpcbind</A>(8)
|
|
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="19"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="20"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="21"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="22"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="23"><A HREF="#lbAF">EXAMPLES</A><DD>
|
|
<DT id="24"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:15 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|