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 / getprojuser.z / getprojuser
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4. ggggeeeettttpppprrrroooojjjjuuuusssseeeerrrr((((3333cccc))))                                                ggggeeeettttpppprrrroooojjjjuuuusssseeeerrrr((((3333cccc))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      getprojuser, fgetprojuser - get a user's project IDs
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<pppprrrroooojjjj....hhhh>>>>
  13.  
  14.      iiiinnnntttt ggggeeeettttpppprrrroooojjjjuuuusssseeeerrrr((((ccccoooonnnnsssstttt cccchhhhaaaarrrr ****nnnnaaaammmmeeee,,,, pppprrrroooojjjjiiiidddd____tttt ****bbbbuuuuffff,,,, iiiinnnntttt lllleeeennnn))));;;;
  15.  
  16.      iiiinnnntttt ffffggggeeeettttpppprrrroooojjjjuuuusssseeeerrrr((((PPPPRRRROOOOJJJJ ttttooookkkkeeeennnn,,,, ccccoooonnnnsssstttt cccchhhhaaaarrrr ****nnnnaaaammmmeeee,,,, pppprrrroooojjjjiiiidddd____tttt ****bbbbuuuuffff,,,, iiiinnnntttt lllleeeennnn))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      The _g_e_t_p_r_o_j_u_s_e_r function searches the pppprrrroooojjjjeeeecccctttt file for the user _n_a_m_e and
  20.      stores information about the projects for which _n_a_m_e is authorized into
  21.      an array of pppprrrroooojjjjiiiidddd____tttt structs.  The array is pointed to by _b_u_f and is
  22.      assumed to have room for a maximum of _l_e_n entries.  The pppprrrroooojjjjiiiidddd____tttt struct
  23.      is defined in <<<<pppprrrroooojjjj....hhhh>>>> and has the following format:
  24.  
  25.           #define MAXPROJNAMELEN 32
  26.           typedef struct projid {
  27.                   char    proj_name[MAXPROJNAMELEN];      /* project name */
  28.                   prid_t  proj_id;                        /* project ID */
  29.           } projid_t;
  30.  
  31.      Note that project names that have more than MMMMAAAAXXXXPPPPRRRROOOOJJJJNNNNAAAAMMMMEEEELLLLEEEENNNN-1 characters
  32.      will be truncated.  The _pppp_rrrr_oooo_jjjj______nnnn_aaaa_mmmm_eeee field is always null-terminated.
  33.  
  34.      The _f_g_e_t_p_r_o_j_u_s_e_r function is a variant of _g_e_t_p_r_o_j_u_s_e_r that uses a PPPPRRRROOOOJJJJ
  35.      token to make it more efficient for repeated use.  Otherwise its
  36.      operation is identical.  For more details on creating a PPPPRRRROOOOJJJJ token, see
  37.      _o_p_e_n_p_r_o_j(3C).
  38.  
  39. FFFFIIIILLLLEEEESSSS
  40.      ////eeeettttcccc////pppprrrroooojjjjiiiidddd    System project name to project ID mappings.
  41.  
  42.      ////eeeettttcccc////pppprrrroooojjjjeeeecccctttt   System project authorization file.
  43.  
  44. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  45.      closeproj(3C), getdfltprojuser(3C), getprojall(3C), openproj(3C),
  46.      projid(4), projects(5).
  47.  
  48. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  49.      _g_e_t_p_r_o_j_u_s_e_r and _f_g_e_t_p_r_o_j_u_s_e_r both return the number of pppprrrroooojjjjiiiidddd____tttt's stored
  50.      (which may be 0 if the user was not found or if the user is not
  51.      authorized for any projects) or -1 if an error occurred.
  52.  
  53. BBBBUUUUGGGGSSSS
  54.      Both functions use _f_o_p_e_n(3S) and are thus subject to its limitations.
  55.  
  56.      Project information should be (optionally) obtained via NIS.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.