Content-type: text/html Man page of siad_chg_finger

siad_chg_finger

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

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

LIBRARY

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

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

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  

RELATED INFORMATION

sia_chg_finger(3), matrix.conf(4)

Security delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
siad_chg_finger()
siad_chg_password()
siad_chg_shell()
RETURN VALUES
ERRORS
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:41:44 GMT, October 02, 2010