lcas.h

Go to the documentation of this file.

/*                                                                                                            
 * Copyright (c) Members of the EGEE Collaboration. 2004.
 * See http://eu-egee.org/partners/ for details on the copyright holders.
 * For license conditions see the license file or
 * http://eu-egee.org/license.html
 */

/*                                                                                                            
 * Copyright (c) 2001 EU DataGrid.                                                                             
 * For license conditions see http://www.eu-datagrid.org/license.html                                          
 *
 * Copyright (c) 2001, 2002 by 
 *     Martijn Steenbakkers <martijn@nikhef.nl>,
 *     David Groep <davidg@nikhef.nl>,
 *     NIKHEF Amsterdam, the Netherlands
 */

#ifndef LCAS_H
#define LCAS_H

/******************************************************************************
                             Include header files
******************************************************************************/
#include <gssapi.h>
#include "lcas_types.h"

/******************************************************************************
 *                 Module definition
 *****************************************************************************/

/******************************************************************************
Function:   lcas_init
Description:
    Initialize LCAS module: 
    setup logging, error handling
    read from LCAS database the plugins to be loaded

Parameters:
    fp: file handle for logging (from gatekeeper)
Returns:
    0: initialization succeeded
    1: initialization failed
******************************************************************************/
extern int lcas_init(
        FILE* fp
);

/******************************************************************************
Function:   lcas_init_and_log
Description:
    Select logging type
    Setup logging, error handling (not yet).
    Read from LCAS database the plugins to be loaded.
    Initialize the plugins

Parameters:
    fp: file handle for logging (from gatekeeper or other previously opened file handle)
        If the file handle is zero, assume that only syslogging is requested
    logtype: type of logging (usrlog and/or syslog)

Returns:
    0: initialization succeeded
    1: initialization failed
******************************************************************************/
extern int lcas_init_and_log(
        FILE* fp,
        unsigned short logtype
);

/******************************************************************************
Function:   lcas_init_and_logfile
Description:
    Select logging type
    Setup logging by providing a file handle or file name, error handling (not yet).
    Read from LCAS database the plugins to be loaded.
    Initialize the plugins

Parameters:
    logfile: name of logfile 
    fp: file handle for logging (from gatekeeper or other previously opened file handle)
        If the file handle is zero, assume that only syslogging is requested
    logtype: type of logging (usrlog and/or syslog)

Returns:
    0: initialization succeeded
    1: initialization failed
******************************************************************************/
extern int lcas_init_and_logfile(
        char * logfile,
        FILE* fp,
        unsigned short logtype
);

/******************************************************************************
Function:   lcas_term
Description:
    Terminate LCAS module: 

Parameters:
Returns:
    0: termination succeeded
    1: termination failed
******************************************************************************/
extern int lcas_term();

/******************************************************************************
Function:   lcas_get_fabric_authorization
Description:
    Call LCAS in order to get authorization on the local fabric

Parameters:
    request: RSL string
    user_cred : user globus credential handle
Returns:
    0: authorization succeeded
    1: authorization failed
******************************************************************************/
#if ALLOW_EMPTY_CREDENTIALS

extern int lcas_get_fabric_authorization(
        char * user_dn_tmp,
        gss_cred_id_t user_cred,
        lcas_request_t request
);
#else

extern int lcas_get_fabric_authorization(
        gss_cred_id_t user_cred,
        lcas_request_t request
);
#endif

extern int getMajorVersionNumber();
extern int getMinorVersionNumber();
extern int getPatchVersionNumber();

#endif /* LCAS_H */

/******************************************************************************
CVS Information:
    $Source: /cvs/jra1mw/org.glite.security.lcas-interface/interface/lcas.h,v $
    $Date: 2005/04/04 15:23:57 $
    $Revision: 1.4 $
    $Author: msteenba $
******************************************************************************/

---