manual/netkit/original/man8/rpcinfo.8

   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.12 2000/07/30 23:57:03 dholland Exp $
   3 .\"
   4 .Dd December 17, 1987
   5 .Dt RPCINFO 8
   6 .Os "Linux NetKit (0.17)"
   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.