home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3c / openproj.z / openproj
Encoding:
Text File  |  2002-10-03  |  4.9 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ooooppppeeeennnnpppprrrroooojjjj((((3333cccc))))                                                      ooooppppeeeennnnpppprrrroooojjjj((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      openproj, closeproj - create/destroy a PPPPRRRROOOOJJJJ token
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<pppprrrroooojjjj....hhhh>>>>
  13.  
  14.      PPPPRRRROOOOJJJJ ooooppppeeeennnnpppprrrroooojjjj((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****pppprrrroooojjjjeeeecccctttt,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****pppprrrroooojjjjiiiidddd))));;;;
  15.  
  16.      vvvvooooiiiidddd cccclllloooosssseeeepppprrrroooojjjj((((PPPPRRRROOOOJJJJ ttttooookkkkeeeennnn))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The _o_p_e_n_d_i_r function is used to create a PPPPRRRROOOOJJJJ token.  The _c_l_o_s_e_d_i_r
  20.      function is used to destroy it when it is no longer needed.
  21.  
  22.      The _g_e_t_p_r_o_j_u_s_e_r family of functions (including _p_r_o_j_i_d, _p_r_o_j_n_a_m_e,
  23.      _g_e_t_p_r_o_j_a_l_l, _g_e_t_p_r_o_j_u_s_e_r, _g_e_t_d_f_l_t_p_r_o_j_u_s_e_r and _v_a_l_i_d_a_t_e_p_r_o_j) is used to
  24.      extract information from the pppprrrroooojjjjeeeecccctttt and pppprrrroooojjjjiiiidddd files.  Because these
  25.      functions open, read, and close the pppprrrroooojjjjeeeecccctttt and pppprrrroooojjjjiiiidddd files, they can be
  26.      inefficient if it is necessary to use them repeatedly in the same
  27.      program.  Therefore, a second set of parallel functions is provided that
  28.      is slightly more complex to use but runs more efficiently and is
  29.      appropriate when repeated queries to the pppprrrroooojjjjeeeecccctttt and pppprrrroooojjjjiiiidddd files are
  30.      required.
  31.  
  32.      The second set of functions makes use of a PPPPRRRROOOOJJJJ token to maintain various
  33.      state information that reduces the overhead associated with repeated
  34.      accesses to the pppprrrroooojjjjeeeecccctttt and pppprrrroooojjjjiiiidddd files.  These functions are identical
  35.      to their "simple" counterparts with the following exceptions:
  36.  
  37.           The function names are prefixed with the letter "f".
  38.  
  39.           An additional argument, the PPPPRRRROOOOJJJJ token itself, is included at the
  40.           beginning of each function's argument list.
  41.  
  42.      The _o_p_e_n_p_r_o_j function is used to create the PPPPRRRROOOOJJJJ token.  It takes two
  43.      arguments, the pathnames to the pppprrrroooojjjjeeeecccctttt and pppprrrroooojjjjiiiidddd files.  NULL can be
  44.      specified for either or both of these arguments, in which case the system
  45.      default pathnames (////eeeettttcccc////pppprrrroooojjjjeeeecccctttt and ////eeeettttcccc////pppprrrroooojjjjiiiidddd, respectively) will be
  46.      used.  The _c_l_o_s_e_p_r_o_j function can be used to delete the PPPPRRRROOOOJJJJ token and
  47.      release any resources associated with it when processing is finished.
  48.  
  49. FFFFIIIILLLLEEEESSSS
  50.      ////eeeettttcccc////pppprrrroooojjjjeeeecccctttt   System project authorization file.
  51.  
  52.      ////eeeettttcccc////pppprrrroooojjjjiiiidddd    System project name to project ID mappings.
  53.  
  54. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  55.      getdfltprojuser(3C), getprojall(3C), getprojuser(3C), projid(3C),
  56.      validateproj(3C), project(4), projid(4), projects(5).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ooooppppeeeennnnpppprrrroooojjjj((((3333cccc))))                                                      ooooppppeeeennnnpppprrrroooojjjj((((3333cccc))))
  71.  
  72.  
  73.  
  74. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  75.      _o_p_e_n_p_r_o_j returns a PPPPRRRROOOOJJJJ token if successful, or NULL if not.
  76.  
  77. BBBBUUUUGGGGSSSS
  78.      Both functions use _f_o_p_e_n(3S) and are thus subject to its limitations.
  79.  
  80.      Project information should be (optionally) obtained via NIS.
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  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.