set_id(3I)                                                set_id(3I)


       NAME
             set_id - set the user's identity

       SYNOPSIS
             cc [options] file -liaf
             #include <ia.h>
             #include <iaf.h>
             int set_id(char *namep);

       DESCRIPTION
             The set_id routine sets the user's identity which consists of
             user ID, group ID, supplemental group IDs, and audit mask (if
             the Auditing Utilities are installed).

             The routine checks the value of namep to determine where to
             get the above information; if namep is non-NULL (that is, a
             login name), then it is used with the ia_openinfo routine to
             access namep's information from the file
             /etc/security/ia/master.

             If namep is NULL then the information is assumed to have been
             passed via the Identification and Authentication Facility
             module and is retrieved via the getava routine.

          Files
             /etc/security/ia/master

          Return Values
             The routine returns zero on success and non-zero if an error
             occurs.

       REFERENCES
             getava(3I), ia_uinfo(3I)















                           Copyright 1994 Novell, Inc.               Page 1