24 
  25 
  26        void endauthattr(void);
  27 
  28 
  29        int chkauthattr(const char *authname, const char *username);
  30 
  31 
  32 DESCRIPTION
  33        The getauthattr() and getauthnam() functions each return an
  34        auth_attr(4) entry. Entries can come from any of the sources specified
  35        in the nsswitch.conf(4) file.
  36 
  37 
  38        The getauthattr() function enumerates auth_attr entries. The
  39        getauthnam() function searches for an auth_attr entry with a given
  40        authorization name name. Successive calls to these functions return
  41        either successive auth_attr entries or NULL.
  42 
  43 
  44        Th internal representation of an auth_attr entry is an authattr_t
  45        structure defined in  <auth_attr.h> with   the following members:
  46 
  47          char   *name;        /* name of the authorization */
  48          char   *res1;        /* reserved for future use */
  49          char   *res2;        /* reserved for future use */
  50          char   *short_desc;  /* short description */
  51          char   *long_desc;   /* long description */
  52          kva_t  *attr;        /* array of key-value pair attributes */
  53 
  54 
  55 
  56        The setauthattr() function "rewinds" to the beginning of the
  57        enumeration of auth_attr entries.  Calls to getauthnam() can leave the
  58        enumeration in an indeterminate state. Therefore, setauthattr() should
  59        be called before the first call to getauthattr().
  60 
  61 
  62        The endauthattr() function may be called to indicate that auth_attr
  63        processing is complete; the system may then close any open auth_attr
  64        file, deallocate storage, and so forth.

  24 
  25 
  26        void endauthattr(void);
  27 
  28 
  29        int chkauthattr(const char *authname, const char *username);
  30 
  31 
  32 DESCRIPTION
  33        The getauthattr() and getauthnam() functions each return an
  34        auth_attr(4) entry. Entries can come from any of the sources specified
  35        in the nsswitch.conf(4) file.
  36 
  37 
  38        The getauthattr() function enumerates auth_attr entries. The
  39        getauthnam() function searches for an auth_attr entry with a given
  40        authorization name name. Successive calls to these functions return
  41        either successive auth_attr entries or NULL.
  42 
  43 
  44        The internal representation of an auth_attr entry is an authattr_t
  45        structure defined in  <auth_attr.h> with   the following members:
  46 
  47          char   *name;        /* name of the authorization */
  48          char   *res1;        /* reserved for future use */
  49          char   *res2;        /* reserved for future use */
  50          char   *short_desc;  /* short description */
  51          char   *long_desc;   /* long description */
  52          kva_t  *attr;        /* array of key-value pair attributes */
  53 
  54 
  55 
  56        The setauthattr() function "rewinds" to the beginning of the
  57        enumeration of auth_attr entries.  Calls to getauthnam() can leave the
  58        enumeration in an indeterminate state. Therefore, setauthattr() should
  59        be called before the first call to getauthattr().
  60 
  61 
  62        The endauthattr() function may be called to indicate that auth_attr
  63        processing is complete; the system may then close any open auth_attr
  64        file, deallocate storage, and so forth.