Index for Section 3

Alphabetical listing for S

Bottom of page

siad_test_newpass(3)
NAME
  siad_test_newpass - test passphrase against rules and policy routine for
  SIA (Security Integration Architecture)

LIBRARY
  Standard C library - libc.so and libc.a

SYNOPSIS
  #include <sia.h>
  #include <siad.h>

  int siad_test_newpass(
	  sia_collect_func_t *collect,
	  SIAENTITY *entity,
	  int *mechind,
	  const char newpass);

PARAMETERS
  collect   This is a pointer to an SIA collection routine that provides the
	    ability for the mechanism to prompt the user for additional
	    information.  If this pointer is NULL no collection is possible.
	    If this parameter is not NULL and the colinput parameter entered
	    during the sia_ses_init() call was zero then this collection
	    routine cannot be used to prompt for input but can be used to
	    display warnings or error messages.

  entity    This is a pointer to the SIAENTITY structure that was allocated
	    and setup by the previous sia_ses_init() call.  It is used to
	    access arguments which have either been collected or derived from
	    the session processing.

  mechind   The mechind parameter is the package index number for the
	    mechanism.	This index can be used to set the mechanism-specific
	    data pointer array element in the SIAENTITY structure pointed to
	    by entity.

  newpass   Pointer to the character string which contains a new password.

DESCRIPTION
  The siad_test_newpass() routine tests and compares the string at *newpass
  against the passphrase rules and policy for the mechanism.

  This routine is called from the sia_chg_password() routine when it is
  determined that the mechanism supports the changing of the passphrase using
  the entity.



RETURN VALUES
  The siad_test_newpass() routine returns a bitmapped value which indicate
  the following status:

  SIADSUCCESS	  A return code of SIADSUCCESS indicates that the proposed
		  new passphrase is acceptable to the mechanism.  All bits
		  set to 0.

  SIADFAIL	  A return code of SIADFAIL indicates that the proposed
		  passphrase is not acceptable by policy to the given
		  mechanism, but that it is possible for the implementation
		  to store it anyway. (This case is allowed for possible
		  administrative overrides to the policy for temporary
		  passphrases. It is only be used for pre-collected new
		  passphrases.) Lowest bit set to 1.

  SIADFAIL|SIADSTOP
		  The mechanism refuses to store at all. Do not continue.
		  Returned when incorrect usage of this routine was detected,
		  meaning either the entity doesn't exist or was set up
		  wrong.  Second lowest bit set to 1.

  SIADSUCCESS|SIADSTOP
		  Reserved for future use.

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_password(3), siad_chk_user(3), siad_update_pass(3), matrix.conf(4)

  Security

Index for Section 3

Alphabetical listing for S

Top of page