NAME    [Toc]    [Back]

       siad_chg_finger,   siad_chg_password,   siad_chg_shell   -
       Dependent SIA change routines (Security Integration Architecture)

SYNOPSIS    [Toc]    [Back]

       #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    [Toc]    [Back]

       Standard C library (libc.so and libc.a)

PARAMETERS    [Toc]    [Back]

       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 precollected
  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.

DESCRIPTION    [Toc]    [Back]

   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 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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       /etc/passwd

       /etc/sia/matrix.conf

SEE ALSO    [Toc]    [Back]

       sia_chg_finger(3), matrix.conf(4)

       Security



                                               siad_chg_finger(3)