home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3n / rpcbind.z / rpcbind
Encoding:
Text File  |  2001-04-17  |  13.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. rrrrppppccccbbbbiiiinnnndddd((((3333NNNN))))                                                        rrrrppppccccbbbbiiiinnnndddd((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd:   _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_mmmm_aaaa_pppp_ssss, _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_aaaa_dddd_dddd_rrrr, _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_tttt_iiii_mmmm_eeee, _rrrr_pppp_cccc_bbbb______rrrr_mmmm_tttt_cccc_aaaa_llll_llll,
  10.      _rrrr_pppp_cccc_bbbb______ssss_eeee_tttt, _rrrr_pppp_cccc_bbbb______uuuu_nnnn_ssss_eeee_tttt - library routines for RPC bind service
  11.  
  12. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  13.      These routines allow client C programs to make procedure calls to the RPC
  14.      binder service.  _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd [see _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd(1M)] maintains a list of mappings
  15.      between programs and their universal addresses.
  16.  
  17.    RRRRoooouuuuttttiiiinnnneeeessss
  18.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_rrrr_pppp_cccc_////_rrrr_pppp_cccc_...._hhhh_>>>>
  19.  
  20.      _ssss_tttt_rrrr_uuuu_cccc_tttt _rrrr_pppp_cccc_bbbb_llll_iiii_ssss_tttt _****
  21.      _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_mmmm_aaaa_pppp_ssss_((((_cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_hhhh_oooo_ssss_tttt_))))_;;;;
  22.  
  23.           A user interface to the _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service, which returns a list of the
  24.           current RPC program-to-address mappings on the host named.  It uses
  25.           the transport specified through _n_e_t_c_o_n_f to contact the remote
  26.           _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service on host _h_o_s_t.  This routine will return _NNNN_UUUU_LLLL_LLLL, if the
  27.           remote _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd could not be contacted.
  28.  
  29.      _bbbb_oooo_oooo_llll______tttt
  30.      _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_aaaa_dddd_dddd_rrrr_((((_cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _pppp_rrrr_oooo_gggg_nnnn_uuuu_mmmm_,,,, _cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _vvvv_eeee_rrrr_ssss_nnnn_uuuu_mmmm_,,,,
  31.           _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _****_ssss_vvvv_cccc_aaaa_dddd_dddd_rrrr_,,,,
  32.           _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_hhhh_oooo_ssss_tttt_))))_;;;;
  33.  
  34.           A user interface to the _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service, which finds the address of
  35.           the service on _h_o_s_t that is registered with program number _p_r_o_g_n_u_m,
  36.           version _v_e_r_s_n_u_m, and speaks the transport protocol associated with
  37.           _n_e_t_c_o_n_f.  The address found is returned in _s_v_c_a_d_d_r.  _s_v_c_a_d_d_r should
  38.           be preallocated.  This routine returns _1111 if it succeeds.  A return
  39.           value of _0000 means that the mapping does not exist or that the RPC
  40.           system failed to contact the remote _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service.  In the latter
  41.           case, the global variable _rrrr_pppp_cccc______cccc_rrrr_eeee_aaaa_tttt_eeee_eeee_rrrr_rrrr contains the RPC status.
  42.  
  43.      _bbbb_oooo_oooo_llll______tttt
  44.      _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_tttt_iiii_mmmm_eeee_((((_cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_hhhh_oooo_ssss_tttt_,,,, _tttt_iiii_mmmm_eeee______tttt _****_tttt_iiii_mmmm_eeee_pppp_))))_;;;;
  45.  
  46.           This routine returns the time on _h_o_s_t in _t_i_m_e_p.  If _h_o_s_t is _NNNN_UUUU_LLLL_LLLL,
  47.           _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_tttt_iiii_mmmm_eeee returns the time on its own machine.  This routine
  48.           returns _1111 if it succeeds, _0000 if it fails.  _rrrr_pppp_cccc_bbbb______gggg_eeee_tttt_tttt_iiii_mmmm_eeee can be used
  49.           to synchronize the time between the client and the remote server.
  50.           This routine is particularly useful for secure RPC.
  51.  
  52.      _eeee_nnnn_uuuu_mmmm _cccc_llll_nnnn_tttt______ssss_tttt_aaaa_tttt
  53.      _rrrr_pppp_cccc_bbbb______rrrr_mmmm_tttt_cccc_aaaa_llll_llll_((((_cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_hhhh_aaaa_rrrr _****_hhhh_oooo_ssss_tttt_,,,,
  54.           _cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _pppp_rrrr_oooo_gggg_nnnn_uuuu_mmmm_,,,, _cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _vvvv_eeee_rrrr_ssss_nnnn_uuuu_mmmm_,,,, _cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _pppp_rrrr_oooo_cccc_nnnn_uuuu_mmmm_,,,,
  55.           _cccc_oooo_nnnn_ssss_tttt _xxxx_dddd_rrrr_pppp_rrrr_oooo_cccc______tttt _iiii_nnnn_pppp_rrrr_oooo_cccc_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_aaaa_dddd_dddd_rrrr______tttt _iiii_nnnn_,,,,
  56.           _cccc_oooo_nnnn_ssss_tttt _xxxx_dddd_rrrr_pppp_rrrr_oooo_cccc______tttt _oooo_uuuu_tttt_pppp_rrrr_oooo_cccc_,,,, _cccc_oooo_nnnn_ssss_tttt _cccc_aaaa_dddd_dddd_rrrr______tttt _oooo_uuuu_tttt_,,,,
  57.           _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _tttt_iiii_mmmm_eeee_vvvv_aaaa_llll _tttt_oooo_uuuu_tttt_,,,, _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff  _****_ssss_vvvv_cccc_aaaa_dddd_dddd_rrrr_))))_;;;;
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. rrrrppppccccbbbbiiiinnnndddd((((3333NNNN))))                                                        rrrrppppccccbbbbiiiinnnndddd((((3333NNNN))))
  71.  
  72.  
  73.  
  74.           A user interface to the _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service, which instructs _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd on
  75.           _h_o_s_t to make an RPC call on your behalf to a procedure on that host.
  76.           The parameter *_s_v_c_a_d_d_r will be modified to the server's address if
  77.           the procedure succeeds [see _rrrr_pppp_cccc______cccc_aaaa_llll_llll and _cccc_llll_nnnn_tttt______cccc_aaaa_llll_llll in
  78.           _rrrr_pppp_cccc______cccc_llll_nnnn_tttt______cccc_aaaa_llll_llll_ssss(3N) for the definitions of other parameters].  This
  79.           procedure should normally be used for a ping and nothing else [see
  80.           _rrrr_pppp_cccc______bbbb_rrrr_oooo_aaaa_dddd_cccc_aaaa_ssss_tttt in _rrrr_pppp_cccc______cccc_llll_nnnn_tttt______cccc_aaaa_llll_llll_ssss(3N)].  This routine allows programs
  81.           to do lookup and call, all in one step.
  82.  
  83.      _bbbb_oooo_oooo_llll______tttt
  84.      _rrrr_pppp_cccc_bbbb______ssss_eeee_tttt_((((_cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _pppp_rrrr_oooo_gggg_nnnn_uuuu_mmmm_,,,, _cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _vvvv_eeee_rrrr_ssss_nnnn_uuuu_mmmm_,,,,
  85.           _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_,,,, _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_bbbb_uuuu_ffff _****_ssss_vvvv_cccc_aaaa_dddd_dddd_rrrr_))))_;;;;
  86.  
  87.           A user interface to the _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service, which establishes a mapping
  88.           between the triple [_p_r_o_g_n_u_m, _v_e_r_s_n_u_m, _n_e_t_c_o_n_f_----_>>>>_nnnn_cccc______nnnn_eeee_tttt_iiii_dddd] and _s_v_c_a_d_d_r
  89.           on the machine's _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service.  The value of _t_r_a_n_s_p_o_r_t must
  90.           correspond to a network token that is defined by the netconfig
  91.           database.  This routine returns _1111 if it succeeds, _0000 otherwise.  [See
  92.           also _ssss_vvvv_cccc______rrrr_eeee_gggg in _rrrr_pppp_cccc______ssss_vvvv_cccc______cccc_aaaa_llll_llll_ssss(3N)].
  93.  
  94.      _bbbb_oooo_oooo_llll______tttt
  95.      _rrrr_pppp_cccc_bbbb______uuuu_nnnn_ssss_eeee_tttt_((((_cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _pppp_rrrr_oooo_gggg_nnnn_uuuu_mmmm_,,,, _cccc_oooo_nnnn_ssss_tttt _uuuu______llll_oooo_nnnn_gggg _vvvv_eeee_rrrr_ssss_nnnn_uuuu_mmmm_,,,,
  96.           _cccc_oooo_nnnn_ssss_tttt _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_))))_;;;;
  97.  
  98.           A user interface to the _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service, which destroys all mapping
  99.           between the triple [_p_r_o_g_n_u_m, _v_e_r_s_n_u_m, _n_e_t_c_o_n_f_----_>>>>_nnnn_cccc______nnnn_eeee_tttt_iiii_dddd] and the
  100.           address on the machine's _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service.  If _n_e_t_c_o_n_f is _NNNN_UUUU_LLLL_LLLL,
  101.           _rrrr_pppp_cccc_bbbb______uuuu_nnnn_ssss_eeee_tttt destroys all mapping between the triple [_p_r_o_g_n_u_m,
  102.           _v_e_r_s_n_u_m, _****] and the addresses on the machine's _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd service.
  103.           This routine returns _1111 if it succeeds, _0000 otherwise.  [See also
  104.           _ssss_vvvv_cccc______uuuu_nnnn_rrrr_eeee_gggg in _rrrr_pppp_cccc______ssss_vvvv_cccc______cccc_aaaa_llll_llll_ssss(3N)].
  105.  
  106. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  107.      _rrrr_pppp_cccc______cccc_llll_nnnn_tttt______cccc_aaaa_llll_llll_ssss(3N), _rrrr_pppp_cccc______ssss_vvvv_cccc______cccc_aaaa_llll_llll_ssss(3N), _rrrr_pppp_cccc_bbbb_iiii_nnnn_dddd(1M), _rrrr_pppp_cccc_iiii_nnnn_ffff_oooo(1M)
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.