_lcmaps_pluginmanager.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 _LCMAPS_PLUGINMANAGER_H
#define _LCMAPS_PLUGINMANAGER_H

/******************************************************************************
                             Include header files
******************************************************************************/
#include "lcmaps_types.h"
#include "_lcmaps_credential.h"

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

/******************************************************************************
Function:   startPluginManager
Description:
    Initialize PluginManager module: 
    read from LCMAPS config file, the plugins to be loaded
    Initialize evaluation manager (get policy)

Parameters:
Returns:
    0: succes
    1: failure
******************************************************************************/
extern int startPluginManager();

/******************************************************************************
Function:   stopPluginManager
Description:
    Terminate PluginManager module.

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

/******************************************************************************
Function:   runPluginManager
Description:
    Run PluginManager:
    Contact Evaluation Manager with list of possible policies --> runs plugins

Parameters:
    request     : RSL request
    lcmaps_cred : user credential
    npols       : number of policies to be considered for evaluation
    policynames : the names of the policies to be considered for evaluation

Returns:
    0: user mapping succeeded
    1: user mapping failed
******************************************************************************/
extern int runPluginManager(
        lcmaps_request_t request,
        lcmaps_cred_id_t lcmaps_cred,
        int npols,
        char ** policynames
);

/******************************************************************************
Function:   runPlugin
Description:
    Run a plugin for the Evaluation Manager
    the result (succes or not will be passed to the Evaluation Manager)

Parameters:
    pluginname: the name of the plugin module
Returns:
    0: plugin run succeeded
    1: plugin run failed
******************************************************************************/
extern int runPlugin(
        const char * pluginname
);

/******************************************************************************
Function:   resetCredentialData
Description:
    Reset the Credential data.
    Wrapper around cleanCredentialData() to be used
    by the Evaluation Manager, before a new policy is
    evaluated

Parameters:
    none
Returns:
    the return value of cleanCredentialData()
******************************************************************************/
extern int resetCredentialData();

#endif /* _LCMAPS_PLUGINMANAGER_H */

/******************************************************************************
CVS Information:
    $Source: /cvs/jra1mw/org.glite.security.lcmaps/src/pluginmanager/_lcmaps_pluginmanager.h,v $
    $Date: 2004/12/02 17:14:22 $
    $Revision: 1.8 $
    $Author: msteenba $
******************************************************************************/

---