home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / rpcbind.z / rpcbind
Encoding:
Text File  |  2002-10-03  |  6.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrrppppccccbbbbiiiinnnndddd((((1111MMMM))))                                                        rrrrppppccccbbbbiiiinnnndddd((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd - universal addresses to RPC program number mapper
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////eeeettttcccc////rrrrppppccccbbbbiiiinnnndddd [ ----mmmmvvvvCCCC ] [ ----ffff _f_o_r_k_c_n_t ] [ ----aaaa _m_a_s_k,_m_a_t_c_h | ----aaaa _m_a_t_c_h ]
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd is a server that converts RPC program numbers into universal
  16.      addresses.  It must be running to make RPC calls.
  17.  
  18.      When an RPC service is started, it will tell _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd at what address it
  19.      is listening, and what RPC program numbers it is prepared to serve.  When
  20.      a client wishes to make an RPC call to a given program number, it will
  21.      first contact _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd on the server machine to determine the address
  22.      where RPC packets should be sent.
  23.  
  24.      Normally, standard RPC servers are started by port monitors, so _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd
  25.      must be started before port monitors are invoked.
  26.  
  27.      _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd is restricted to users with the _rrrr_oooo_oooo_tttt user ID.
  28.  
  29.      Options to customize _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd's behavior are read from the file
  30.      /_e_t_c/_c_o_n_f_i_g/_r_p_c_b_i_n_d._o_p_t_i_o_n_s during system initialization.  The options
  31.      are:
  32.  
  33.      ----mmmm   Enable reception of RPC requests sent to _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd's multicast
  34.           address.
  35.  
  36.      ----vvvv   Turn on verbose mode.  In this mode, additional debugging and error
  37.           information is printed to stderr.
  38.  
  39.      ----CCCC   Turn on compatibility mode.  This will allow local applications to
  40.           register with _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd using a network address other than the
  41.           loopback address.  Applications that do not use the SGI-provided RPC
  42.           interfaces to register with rpcbind may require this option to
  43.           function properly.  However, use of this option will also introduce
  44.           a known _ssss_eeee_cccc_uuuu_rrrr_iiii_tttt_yyyy problem.
  45.  
  46.      ----ffff  _f_o_r_k_c_n_t
  47.           Ignored by _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd. It is supplied to provide command line
  48.           compatibility with ppppoooorrrrttttmmmmaaaapppp.
  49.  
  50.      _----_wwww   When _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd receives a SIGINT signal, it saves a copy of its
  51.           configuration in /tmp/rpcbind.file and /tmp/portmap.file. The _----_wwww
  52.           switch causes _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd to warm start and preconfigure itself from
  53.           these files when it is started.
  54.  
  55.      ----aaaa  _m_a_s_k,_m_a_t_c_h
  57.      ----aaaa  _m_a_t_c_h
  58.           This option permits restriction of most of the _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd services to a
  59.           subset of hosts or networks. (The _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd null procedure is not
  60.           restricted.)  The _m_a_s_k, and _m_a_t_c_h arguments are IP addresses in
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrrppppccccbbbbiiiinnnndddd((((1111MMMM))))                                                        rrrrppppccccbbbbiiiinnnndddd((((1111MMMM))))
  71.  
  72.  
  73.  
  74.           Internet dot notation (see _i_n_e_t(3N)) that represent masks, hosts or
  75.           networks.  The _m_a_s_k and _m_a_t_c_h arguments must be separated by a comma
  76.           with no intervening whitespace.  If _m_a_s_k and the comma are missing,
  77.           the argument is interpreted as a Class A, B, or C network number and
  78.           the mask is set to the value appropriate for the network's class.
  79.  
  80.           The ----aaaa option can be repeated up to 50 times.  For each mask and
  81.           match specified, the requesting client host's address is logically-
  82.           ANDed with _m_a_s_k; if the result equals _m_a_t_c_h, the client's request is
  83.           processed.  If none of the mask-match comparisons succeed, the
  84.           request is rejected.  Requests from all of the local host's
  85.           addresses are always permitted.
  86.  
  87.      ----AAAA   This option is equivalent to a series of ----aaaa options listing all of
  88.           the addresses of interfaces on the machine, with their netmasks.  It
  89.           is convenient for authorizing hosts on directly connected networks
  90.           and point-to-point links without explicitly enumerating the
  91.           networks.  The restrictions defined by ----AAAA do not count against the
  92.           limit of 50 ----aaaa options.
  93.  
  94.      For example, if /_e_t_c/_c_o_n_f_i_g/_r_p_c_b_i_n_d._o_p_t_i_o_n_s contains
  95.  
  96.           -a 255.255.255.0,128.32.199.0
  97.           -a 192.0.2.0
  98.           -a 255.255.255.255,192.26.51.3
  99.  
  100.      access is restricted to any host on the Class B 128.32.199 subnet or the
  101.      Class C 192.0.2 network or to the host with the 192.26.51.3 address.
  102.      Requests from clients on any other networks will be rejected.
  103.  
  104. FFFFIIIILLLLEEEESSSS
  105.      /tmp/rpcbind.file
  106.      /tmp/portmap.file
  107.  
  108. NNNNOOOOTTTTEEEESSSS
  109.      If _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd crashes, all RPC servers must be restarted.
  110.  
  111. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.      rpcinfo(1M), portmap(1M)
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.