aux(3C)

NAME
     initauxgroup - initialize auxiliary identification and authentication
     information

SYNOPSIS
     #include <di_aux.h>
     int initauxgroup(const char *uname, gid_t gid, FILE *display);

DESCRIPTION
     The initauxgroup function provides the means for auxiliary identification
     and authentication (I&A).  uname and gid are the name and group id of the
     user that is to be subject to auxiliary I&A.  display is a handle to the
     output file stream where any messages (informative or error indicating)
     may be printed.  display is NULL if there is no associated output stream.

     Usually, initauxgroup is used by various system programs such as login,
     rshd, etc. that perform I&A functions.  When used in conjunction with a
     dynamic source (see ssdi(4) and ssdi(3c)) initauxgroup allows for
     customizable I&A modules.

     By default, no auxiliary I&A functions are supported. In other words, if
     no dynamic sources are configured, then initauxgroup always succeeds.

SEE ALSO
     ssdi(4), ssdi(3C)

DIAGNOSTICS
     initauxgroup returns -1 if auxiliary I&A failed. A return value of
     anything other than -1 indicates a success.