Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

sia_chg_password(3) [osf1 man page]

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 possible. The col- lect parameter should never be NULL. This parameter is read only. Further information on the SIA change routines is available from the interface specifications in /usr/include/{sia,siad}.h. username The username parameter is used when a precollected username is available. The username parameter either points to the precol- lected username or is set to NULL if no username exists. This parameter is read only. argc The argc parameter is the number of arguments used when invoking the calling command or utility. This parameter are read only. argv The argv parameter is the array of arguments used when invoking the calling command or utility. The argv[0] variable 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 /etc/passwd file. This information is used by the finger program, among others. The user is offered a menu to choose which security mechanism is relevant 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 security mechanism's database; for base security, its /etc/passwd and for enhanced security its auth.db. If NIS is running, the password change is made in /var/yp/src/passwd or /var/yp/src/prpasswd files. 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. Consequently the sia_chg_password() routine first calls the siad_chk_user() security dependent routine to obtain a list of relevant security mechanisms 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 mechanism 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 security mechanism is relevant. If only one choice is available that security 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 include resource constraints (no memory) and various authentication failures. 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)

Check Out this Related Man Page

siad_chg_finger(3)					     Library Functions Manual						siad_chg_finger(3)

NAME
siad_chg_finger, siad_chg_password, siad_chg_shell - Dependent SIA change routines (Security Integration Architecture) LIBRARY
Standard C library (libc.so and libc.a) SYNOPSIS
#include <sia.h> #include <siad.h> int siad_chg_finger( int (*collect)(), char *username, int argc, char *argv[]); int siad_chg_password( int (*collect)(), char *username, int argc, char *argv[]); int siad_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 possible. The col- lect parameter should never be NULL. This parameter is read only. Further input on SIA collection routines is available from the interface specifications in /usr/include/{sia,siad}.h. username The username parameter is used when a precollected username is available. The username parameter either points to the precol- lected username or is set to NULL if no username exists. This parameter is read only. argc The argc parameter is the number of arguments used when invoking the calling command or utility. This parameter are read only. argv The argv parameter is the array of arguments used when invoking the calling command or utility. The argv[0] variable must always be set to the calling commands name. This is used for logging or auditing of the password change function. DESCRIPTION
siad_chg_finger() This routine is called by sia_chg_finger() to accomplish processing associated with the chfn command with respect to a specific security mechanism. Only one siad_chg_finger() routine is called. No sequencing of multiple security mechanisms is attempted. siad_chg_password() This routine is called by sia_chg_password() to invoke a specific mechanisms change password function. Only one siad_chg_password() routine is called. This routine accomplishes the process commonly associated with the passwd command. No sequencing of multiple security mecha- nisms is attempted. siad_chg_shell() This routine is called by sia_chg_shell() to accomplish processing associated with the chsh command with respect to a specific security mechanism. Only one siad_chg_shell() routine is called. No sequencing of multiple security mechanisms is attempted. RETURN VALUES
The siad_ses_*() routines return bitmapped values which indicate the following status: SIADSUCCESS Indicates unconditional success. All bits set to 0. SIADFAIL Indicates conditional failure. Lowest bit set to 1. If other security mechanism are in place, continue. SIADSTOP Indicates unconditional failure. Do not continue. Second lowest bit set to 1. ERRORS
The errno values are those returned from the dynamic loader interface, from the (siad_*) routines, or from malloc. Possible errors include resource constraints (no memory) and various authentication failures. FILES
/etc/passwd /etc/sia/matrix.conf RELATED INFORMATION
sia_chg_finger(3), matrix.conf(4) Security delim off siad_chg_finger(3)
Man Page