Index Index for
Section 3
Index Alphabetical
listing for S
Bottom of page Bottom of
page		 

sia_chg_finger(3)


NAME

  sia_chg_finger, sia_chg_password, sia_chg_shell - SIA change routines
  (Security Integration Architecture)


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[] );


LIBRARY

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


PARAMETERS

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


SEE ALSO

  chfn(1), chsh(1), passwd(1) siad_chg_finger(3), matrix.conf(4)

  Security

Index Index for
Section 3
Index Alphabetical
listing for S
Top of page Top of
page