Annotation of src/usr.bin/rpcinfo/rpcinfo.8, Revision 1.1
1.1 ! deraadt 1: .\" from: @(#)rpcinfo.8c 2.2 88/08/03 4.0 RPCSRC; from 1.24 88/02/25 SMI
! 2: .\" $Id: rpcinfo.8,v 1.3 1993/08/01 07:29:21 mycroft Exp $
! 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,
! 113: .Ar rpcinfo
! 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.