38 .fi
  39 
  40 .LP
  41 .nf
  42 \fBint\fR \fBchkauthattr\fR(\fBconst char *\fR\fIauthname\fR, \fBconst char *\fR\fIusername\fR);
  43 .fi
  44 
  45 .SH DESCRIPTION
  46 .LP
  47 The \fBgetauthattr()\fR and \fBgetauthnam()\fR functions each return an
  48 \fBauth_attr\fR(4) entry. Entries can come from any of the sources specified in
  49 the \fBnsswitch.conf\fR(4) file.
  50 .sp
  51 .LP
  52 The \fBgetauthattr()\fR function enumerates \fBauth_attr\fR entries. The
  53 \fBgetauthnam()\fR function searches for an \fBauth_attr\fR entry with a given
  54 authorization name \fIname\fR. Successive calls to these functions return
  55 either successive \fBauth_attr\fR entries or \fINULL\fR.
  56 .sp
  57 .LP
  58 Th internal representation of an \fBauth_attr\fR entry is an \fBauthattr_t\fR
  59 structure defined in  <\fBauth_attr.h\fR> with the following members:
  60 .sp
  61 .in +2
  62 .nf
  63 char   *name;        /* name of the authorization */
  64 char   *res1;        /* reserved for future use */
  65 char   *res2;        /* reserved for future use */
  66 char   *short_desc;  /* short description */
  67 char   *long_desc;   /* long description */
  68 kva_t  *attr;        /* array of key-value pair attributes */
  69 .fi
  70 .in -2
  71 
  72 .sp
  73 .LP
  74 The \fBsetauthattr()\fR function "rewinds" to the beginning of the enumeration
  75 of \fBauth_attr\fR entries.  Calls to \fBgetauthnam()\fR can leave the
  76 enumeration in an indeterminate state. Therefore, \fBsetauthattr()\fR should be
  77 called before the first call to \fBgetauthattr()\fR.
  78 .sp

  38 .fi
  39 
  40 .LP
  41 .nf
  42 \fBint\fR \fBchkauthattr\fR(\fBconst char *\fR\fIauthname\fR, \fBconst char *\fR\fIusername\fR);
  43 .fi
  44 
  45 .SH DESCRIPTION
  46 .LP
  47 The \fBgetauthattr()\fR and \fBgetauthnam()\fR functions each return an
  48 \fBauth_attr\fR(4) entry. Entries can come from any of the sources specified in
  49 the \fBnsswitch.conf\fR(4) file.
  50 .sp
  51 .LP
  52 The \fBgetauthattr()\fR function enumerates \fBauth_attr\fR entries. The
  53 \fBgetauthnam()\fR function searches for an \fBauth_attr\fR entry with a given
  54 authorization name \fIname\fR. Successive calls to these functions return
  55 either successive \fBauth_attr\fR entries or \fINULL\fR.
  56 .sp
  57 .LP
  58 The internal representation of an \fBauth_attr\fR entry is an \fBauthattr_t\fR
  59 structure defined in  <\fBauth_attr.h\fR> with the following members:
  60 .sp
  61 .in +2
  62 .nf
  63 char   *name;        /* name of the authorization */
  64 char   *res1;        /* reserved for future use */
  65 char   *res2;        /* reserved for future use */
  66 char   *short_desc;  /* short description */
  67 char   *long_desc;   /* long description */
  68 kva_t  *attr;        /* array of key-value pair attributes */
  69 .fi
  70 .in -2
  71 
  72 .sp
  73 .LP
  74 The \fBsetauthattr()\fR function "rewinds" to the beginning of the enumeration
  75 of \fBauth_attr\fR entries.  Calls to \fBgetauthnam()\fR can leave the
  76 enumeration in an indeterminate state. Therefore, \fBsetauthattr()\fR should be
  77 called before the first call to \fBgetauthattr()\fR.
  78 .sp