AUX(3C)								       AUX(3C)

NAME    [Toc]    [Back]

     initauxgroup - initialize auxiliary identification	and authentication
     information

SYNOPSIS    [Toc]    [Back]

     #include <di_aux.h>

     int initauxgroup(const char *uname, gid_t gid, FILE *display);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     ssdi(4), ssdi(3C)

DIAGNOSTICS    [Toc]    [Back]

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


									PPPPaaaaggggeeee 1111