siad_chg_finger(3)siad_chg_finger(3)NAME
siad_chg_finger, siad_chg_password, siad_chg_shell - Dependent SIA
change routines (Security Integration Architecture)
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[] );
LIBRARY
Standard C library (libc.so and libc.a)
PARAMETERS
The collect parameter is a pointer to an SIA collection routine. If
this pointer is NULL, no collection is possible. The collect 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. 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. The argc parameter is the number of
arguments used when invoking the calling command or utility.
This parameter are read only. 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.
DESCRIPTIONsiad_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 mech‐
anisms 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 mechanisms
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: Indicates unconditional success. All bits set to 0.
Indicates conditional failure. Lowest bit set to 1. If other security
mechanism are in place, continue. 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
SEE ALSOsia_chg_finger(3), matrix.conf(4)
Security
siad_chg_finger(3)