*** UNIX MANUAL PAGE BROWSER ***

sia_chg_finger(3) Library Functions Manual sia_chg_finger(3) NAME sia_chg_finger, sia_chg_password, sia_chg_shell - SIA change routines (Security Integration Architecture) LIBRARY Standard C library (libc.so and libc.a) SYNOPSIS #include <sia.h> #include <siad.h> int sia_chg_finger( int (*collect)(), char *username, int argc, char *argv[]); int sia_chg_password( int (*collect)(), char *username, int argc, char *argv[]); int sia_chg_shell( int (*collect)(), char *username, int argc, char *argv[]); PARAMETERS collect The collect parameter is a pointer to an SIA collection routine. If this pointer is NULL, no collection is possi- ble. The collect parameter should never be NULL. This pa- rameter is read only. Further information on the SIA change routines is available from the interface specifications in /usr/in- clude/{sia,siad}.h. username The username parameter is used when a precollected username is available. The username parameter either points to the precollected username or is set to NULL if no username ex- ists. This parameter is read only. argc The argc parameter is the number of arguments used when in- voking the calling command or utility. This parameter are read only. argv The argv parameter is the array of arguments used when in- voking the calling command or utility. The argv[0] vari- able must always be set to the calling commands name. This is used for logging or auditing of the password change function. DESCRIPTION sia_chg_finger() The sia_chg_finger() routine is used to change information about users in the \tcasswd file. This information is used by the finger program, among others. The user is offered a menu to choose which security mechanism is rele- vant to this invocation. If only one choice is available that security mechanism is called directly. sia_chg_password() The sia_chg_password() routine is used to change the password in the prpasswd file. The routine assumes that the user might be registered with multiple security mechanisms and that those security mechanisms do not support a common distributed transaction update capability. Conse- quently the sia_chg_password() routine first calls the siad_chk_user() security dependent routine to obtain a list of relevant security mecha- nisms to offer to the calling user. The user is offered a menu to choose which security mechanism is relevant to this invocation of password change. If only one choice is available that security mecha- nism is called directly. sia_chg_shell() The sia_chg_shell() routine is used to change the login shell field of the /etc/passwd file. The user is offered a menu to choose which secu- rity mechanism is relevant. If only one choice is available that secu- rity mechanism is called directly. RETURN VALUES The sia_chg_*() routines return SIASUCCESS when the are successful and SIAFAIL when they are not successful. ERRORS The errno value is not (normally) set explicitly by sia_* routines. The errno values are those returned from the dynamic loader interface, from dependent (siad_*) routines, or from malloc. Possible errors in- clude resource constraints (no memory) and various authentication fail- ures. FILES /etc/passwd /etc/sia/matrix.conf RELATED INFORMATION chfn(1), chsh(1), passwd(1) siad_chg_finger(3), matrix.conf(4) Security delim off sia_chg_finger(3)