Index for Section 3

Alphabetical listing for S

Bottom of page

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

SEE ALSO
  sia_chg_finger(3), matrix.conf(4)

  Security

Index for Section 3

Alphabetical listing for S

Top of page