Return to rpcinfo.8 CVS log

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

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

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