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