Return to rpcinfo.8 CVS log

Up to [local] / src / usr.bin / rpcinfo

Annotation of src/usr.bin/rpcinfo/rpcinfo.8, Revision 1.3

1.3     ! aaron       1: .\"    $OpenBSD: rpcinfo.8,v 1.2 1996/06/26 05:38:44 deraadt Exp $
1.1       deraadt     2: .\"    from: @(#)rpcinfo.8c    2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI
                      3: .\"
                      4: .Dd December 17, 1987
                      5: .Dt RPCINFO 8
                      6: .Os
                      7: .Sh NAME
                      8: .Nm rpcinfo
                      9: .Nd report RPC information
                     10: .Sh SYNOPSIS
                     11: .Nm rpcinfo
                     12: .Fl p
                     13: .Op Ar host
                     14: .Nm rpcinfo
                     15: .Op Fl n Ar portnum
                     16: .Fl u Ar host
                     17: .Ar program
                     18: .Op Ar version
                     19: .Nm rpcinfo
                     20: .Op Fl n Ar portnum
                     21: .Fl t Ar host
                     22: .Ar program
                     23: .Op Ar version
                     24: .Nm rpcinfo
                     25: .Fl b
                     26: .Ar program version
                     27: .Nm rpcinfo
                     28: .Fl d
                     29: .Ar program version
                     30: .Sh DESCRIPTION
                     31: .Nm rpcinfo
                     32: makes an
                     33: .Tn RPC
                     34: call to an
                     35: .Tn RPC
                     36: server and reports what it finds.
                     37: .Sh OPTIONS
                     38: .Bl -tag -width indent
                     39: .It Fl p
                     40: Probe the portmapper on
                     41: .Ar host ,
                     42: and print a list of all registered
                     43: .Tn RPC
                     44: programs.  If
                     45: .Ar host
                     46: is not specified, it defaults to the value returned by
                     47: .Xr hostname 1 .
                     48: .It Fl u
                     49: Make an
                     50: .Tn RPC
                     51: call to procedure 0 of
                     52: .Ar program
                     53: on the specified
                     54: .Ar host
                     55: using
                     56: .Tn UDP ,
                     57: and report whether a response was received.
                     58: .It Fl t
                     59: Make an
                     60: .Tn RPC
                     61: call to procedure 0 of
                     62: .Ar program
                     63: on the specified
                     64: .Ar host
                     65: using
                     66: .Tn TCP ,
                     67: and report whether a response was received.
                     68: .It Fl n
                     69: Use
                     70: .Ar portnum
                     71: as the port number for the
                     72: .Fl t
                     73: and
                     74: .Fl u
                     75: options instead of the port number given by the portmapper.
                     76: .It Fl b
                     77: Make an
                     78: .Tn RPC
                     79: broadcast to procedure 0 of the specified
                     80: .Ar program
                     81: and
                     82: .Ar version
                     83: using
                     84: .Tn UDP
                     85: and report all hosts that respond.
                     86: .It Fl d
                     87: Delete registration for the
                     88: .Tn RPC
                     89: service of the specified
                     90: .Ar program
                     91: and
                     92: .Ar version .
                     93: This option can be exercised only by the super-user.
                     94: .El
                     95: .Pp
                     96: The
                     97: .Ar program
                     98: argument can be either a name or a number.
                     99: .Pp
                    100: If a
                    101: .Ar version
                    102: is specified,
                    103: .Nm rpcinfo
                    104: attempts to call that version of the specified
                    105: .Ar program .
                    106: Otherwise,
                    107: .Nm rpcinfo
                    108: attempts to find all the registered version
                    109: numbers for the specified
                    110: .Ar program
                    111: by calling version 0 (which is presumed not
                    112: to exist; if it does exist,
1.3     ! aaron     113: .Nm rpcinfo
1.1       deraadt   114: attempts to obtain this information by calling
                    115: an extremely high version
                    116: number instead) and attempts to call each registered version.
                    117: Note: the version number is required for
                    118: .Fl b
                    119: and
                    120: .Fl d
                    121: options.
                    122: .Sh EXAMPLES
                    123: To show all of the
                    124: .Tn RPC
                    125: services registered on the local machine use:
                    126: .Pp
                    127: .Dl example% rpcinfo -p
                    128: .Pp
                    129: To show all of the
                    130: .Tn RPC
                    131: services registered on the machine named
                    132: .Ar klaxon
                    133: use:
                    134: .Pp
                    135: .Dl example% rpcinfo -p klaxon
                    136: .Pp
                    137: To show all machines on the local net that are running the Yellow Pages
                    138: service use:
                    139: .Pp
                    140: .Dl example% rpcinfo -b ypserv 'version' | uniq
                    141: .Pp
                    142: where 'version' is the current Yellow Pages version obtained from the
                    143: results of the
                    144: .Fl p
                    145: switch above.
                    146: .Pp
                    147: To delete the registration for version 1 of the
                    148: .Nm walld
                    149: service use:
                    150: .Pp
                    151: .Dl example% rpcinfo -d walld 1
                    152: .Sh SEE ALSO
                    153: .Xr rpc 5 ,
                    154: .Xr portmap 8
                    155: .Rs
                    156: .%T "RPC Programming Guide"
                    157: .Re
                    158: .Sh BUGS
                    159: In releases prior to SunOS 3.0, the Network File System (NFS) did not
                    160: register itself with the portmapper;
                    161: .Nm rpcinfo
                    162: cannot be used to make
                    163: .Tn RPC
                    164: calls to the
                    165: .Tn NFS
                    166: server on hosts running such releases.