Main Page   Modules   Data Structures   File List   Data Fields   Globals   Related Pages   Examples  

Authentication

Communicate with the AUS. More...

Functions

int macs_logout (macs_session *sess)
 Log out a MACS session.

int macs_login (macs_session *sess, const char *method, const void *login, const int login_len, const void *pwd, const int pwd_len, const int timeout)
 Log in a MACS session.

int macs_auth_sess (macs_session *sess)
 Authenticate a logged-in session.


Detailed Description

Communicate with the AUS.

The Authentication routines determine and toggle a session pointer's state.


Function Documentation

int macs_logout macs_session   sess
 

Log out a MACS session.

Parameters:
sess A MACS session
Returns:
1 on success, 0 on failure
Removes a session from the AUS, logging it out of MACS.

int macs_login macs_session   sess,
const char *    method,
const void *    login,
const int    login_len,
const void *    pwd,
const int    pwd_len,
const int    timeout
 

Log in a MACS session.

Parameters:
sess A MACS session
method The login method to verify with. If NULL, the MACS default method is used.
login The username to verify
login_len The length of the username
pwd The password/token to verify
pwd_len The length of the password/token
timeout The idle time before the session is closed. -1 for default, 0 for no session.
Returns:
1 on success, 0 on failure
Logs a session into the AUS, so that it can be verified with macs_auth_sess(), replace any identity information already in the session pointer.
Examples:
sample.c.

int macs_auth_sess macs_session   sess
 

Authenticate a logged-in session.

Parameters:
sess A MACS session
Returns:
1 if session is logged in, 0 otherwise
Queries an AUS as to the validity of a session's logged-in status.


Generated on Fri Aug 8 09:53:44 2003 for MACS Client C API by doxygen1.3-rc3