73        file, deallocate any internal storage, and so forth.
  74 
  75 RETURN VALUES
  76        The getuserattr() function returns a pointer to a userattr_t if it
  77        successfully enumerates an entry; otherwise it returns NULL, indicating
  78        the end of the enumeration.
  79 
  80 
  81        The getusernam() function returns a pointer to a userattr_t if it
  82        successfully locates the requested entry; otherwise it returns NULL.
  83 
  84 USAGE
  85        The getuserattr() and getusernam() functions both allocate memory for
  86        the pointers they return. This memory should be deallocated with the
  87        free_userattr() function.
  88 
  89 
  90        Individual attributes can be referenced in the attr structure by
  91        calling the kva_match(3SECDB) function.
  92 
  93 WARININGS
  94        Because the list of legal keys is likely to expand, code  must be
  95        written to ignore unknown key-value pairs without error.
  96 
  97 FILES
  98        /etc/user_attr
  99                              extended user attributes
 100 
 101 
 102        /etc/nsswitch.conf
 103                              configuration file lookup information for the
 104                              name server switch
 105 
 106 
 107 ATTRIBUTES
 108        See attributes(5) for descriptions of the following attributes:
 109 
 110 
 111 
 112 
 113        +---------------+-----------------+
 114        |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
 115        +---------------+-----------------+
 116        |MT-Level       | MT-Safe         |
 117        +---------------+-----------------+
 118 
 119 SEE ALSO
 120        getauthattr(3SECDB), getexecattr(3SECDB), getprofattr(3SECDB),
 121        user_attr(4), attributes(5)
 122 
 123 
 124 
 125                                 March 31, 2005             GETUSERATTR(3SECDB)

  73        file, deallocate any internal storage, and so forth.
  74 
  75 RETURN VALUES
  76        The getuserattr() function returns a pointer to a userattr_t if it
  77        successfully enumerates an entry; otherwise it returns NULL, indicating
  78        the end of the enumeration.
  79 
  80 
  81        The getusernam() function returns a pointer to a userattr_t if it
  82        successfully locates the requested entry; otherwise it returns NULL.
  83 
  84 USAGE
  85        The getuserattr() and getusernam() functions both allocate memory for
  86        the pointers they return. This memory should be deallocated with the
  87        free_userattr() function.
  88 
  89 
  90        Individual attributes can be referenced in the attr structure by
  91        calling the kva_match(3SECDB) function.
  92 
  93 WARNINGS
  94        Because the list of legal keys is likely to expand, code must be
  95        written to ignore unknown key-value pairs without error.
  96 
  97 FILES
  98        /etc/user_attr
  99                              extended user attributes
 100 
 101 
 102        /etc/nsswitch.conf
 103                              configuration file lookup information for the
 104                              name service switch
 105 
 106 
 107 ATTRIBUTES
 108        See attributes(5) for descriptions of the following attributes:
 109 
 110 
 111 
 112 
 113        +---------------+-----------------+
 114        |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
 115        +---------------+-----------------+
 116        |MT-Level       | MT-Safe         |
 117        +---------------+-----------------+
 118 
 119 SEE ALSO
 120        getauthattr(3SECDB), getexecattr(3SECDB), getprofattr(3SECDB),
 121        kva_match(3SECDB), user_attr(4), attributes(5)
 122 
 123 
 124 
 125                                 August 13, 2018            GETUSERATTR(3SECDB)