set_id(3iac)

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 /etc/security/ia/master file.

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(3iac), ia_uinfo(3iac)