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 / getnetpath.z / getnetpath
Encoding:
Text File  |  1998-10-20  |  7.1 KB  |  66 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttnnnneeeettttppppaaaatttthhhh((((3333NNNN))))                                                  ggggeeeettttnnnneeeettttppppaaaatttthhhh((((3333NNNN))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh - get netconfig entry corresponding to _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH component
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _####_iiii_nnnn_cccc_llll_uuuu_dddd_eeee _<<<<_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg_...._hhhh_>>>>
  13.      _vvvv_oooo_iiii_dddd _****_ssss_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh_((((_vvvv_oooo_iiii_dddd_))))_;;;;
  14.      _ssss_tttt_rrrr_uuuu_cccc_tttt _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg _****_gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh_((((_vvvv_oooo_iiii_dddd _****_hhhh_aaaa_nnnn_dddd_llll_eeee_pppp_))))_;;;;
  15.      _iiii_nnnn_tttt _eeee_nnnn_dddd_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh_((((_vvvv_oooo_iiii_dddd _****_hhhh_aaaa_nnnn_dddd_llll_eeee_pppp_))))_;;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      The three routines described on this page are part of the UNIX System V
  19.      Network Selection component.  They provide application access to the
  20.      system network configuration database, _////_eeee_tttt_cccc_////_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg, as it is
  21.      ``filtered'' by the _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH environment variable [see _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)].
  22.      Network Selection also includes routines that access the network
  23.      configuration database directly [see _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg(3N)].
  24.  
  25.      A call to _ssss_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh ``binds'' or ``rewinds'' _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH.  _ssss_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh must
  26.      be called before the first call to _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh and may be called at any
  27.      other time.  It returns a handle that is used by _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh.  _ssss_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh
  28.      will fail if the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database is not present.  If _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH is unset,
  29.      _ssss_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh returns the number of ``visible'' networks in the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg
  30.      file.  The set of visible networks constitutes a default _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH.
  31.  
  32.      When first called, _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh returns a pointer to the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database
  33.      entry corresponding to the first valid _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH component.  The _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg
  34.      entry is formatted as a netconfig structure.  On each subsequent call,
  35.      _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh returns a pointer to the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg entry that corresponds to
  36.      the next valid _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH component.  _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh can thus be used to search
  37.      the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database for all networks included in the _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH variable.
  38.      When _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH has been exhausted, _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh returns _NNNN_UUUU_LLLL_LLLL.
  39.  
  40.      _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh silently ignores invalid _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH components.  A _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH
  41.      component is invalid if there is no corresponding entry in the _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg
  42.      database.
  43.  
  44.      If the _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH variable is unset, _gggg_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh behaves as if _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH were
  45.      set to the sequence of ``default'' or ``visible'' networks in the
  46.      _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg database, in the order in which they are listed.
  47.  
  48.      _eeee_nnnn_dddd_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh may be called to ``unbind'' _NNNN_EEEE_TTTT_PPPP_AAAA_TTTT_HHHH when processing is
  49.      complete, releasing resources for reuse.  Programmer's should be aware,
  50.      however, that _eeee_nnnn_dddd_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh frees all memory allocated by _ssss_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh.
  51.      _eeee_nnnn_dddd_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh returns _0000 on success and _----_1111 on failure (for example, if
  52.      _ssss_eeee_tttt_nnnn_eeee_tttt_pppp_aaaa_tttt_hhhh was not called previously).
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      _nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg(4), _gggg_eeee_tttt_nnnn_eeee_tttt_cccc_oooo_nnnn_ffff_iiii_gggg(3N), _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)
  56.  
  57.  
  58.  
  60.  
  61.  
  62.                                                                         PPPPaaaaggggeeee 1111
  63.  
  64.  
  65.  
  66.