lcmaps.h Source File

00001 /*                                                                                                            
00002  * Copyright (c) 2001 EU DataGrid.                                                                             
00003  * For license conditions see http://www.eu-datagrid.org/license.html                                          
00004  *
00005  * Copyright (c) 2001, 2002 by 
00006  *     Martijn Steenbakkers <martijn@nikhef.nl>,
00007  *     David Groep <davidg@nikhef.nl>,
00008  *     NIKHEF Amsterdam, the Netherlands
00009  */
00010 
00028 #ifndef LCMAPS_H
00029 #define LCMAPS_H
00030 
00031 /******************************************************************************
00032                              Include header files
00033 ******************************************************************************/
00034 #include <gssapi.h>
00035 #include "lcmaps_types.h"
00036 
00037 /******************************************************************************
00038  *                 Module definition
00039  *****************************************************************************/
00040 
00041 /******************************************************************************
00042 Function:   lcmaps_init
00043 Description:
00044     Initialize LCMAPS module: 
00045     setup logging, error handling
00046     start PluginManager
00047 
00048 Parameters:
00049     fp: file handle for logging (from gatekeeper)
00050 Returns:
00051     0: initialization succeeded
00052     1: initialization failed
00053 ******************************************************************************/
00054 extern int lcmaps_init(
00055         FILE* fp
00056 );
00057 
00058 /******************************************************************************
00059 Function:   lcmaps_term
00060 Description:
00061     Terminate LCMAPS module: 
00062 
00063 Parameters:
00064 Returns:
00065     0: termination succeeded
00066     1: termination failed
00067 ******************************************************************************/
00068 extern int lcmaps_term();
00069 
00070 /******************************************************************************
00071 Function:   lcmaps_run
00072 Description:
00073     do the user mapping
00074 
00075 Parameters:
00076     request: JDL
00077     user_cred : user globus credential handle
00078 Returns:
00079     0: authorization succeeded
00080     1: authorization failed
00081 ******************************************************************************/
00082 #if ALLOW_EMPTY_CREDENTIALS
00083 extern int lcmaps_run(
00084         char * user_dn_tmp,
00085         gss_cred_id_t user_cred,
00086         lcmaps_request_t request
00087 );
00088 #else
00089 extern int lcmaps_run(
00090         gss_cred_id_t user_cred,
00091         lcmaps_request_t request
00092 );
00093 #endif
00094 
00095 /******************************************************************************
00096 Function:   lcmaps_run_and_return_username
00097 Description:
00098     do the user mapping and return user name (needed for e.g. GridFTP)
00099 
00100 Parameters:
00101     request: JDL
00102     user_cred : user globus credential handle
00103     usernamep : pointer to user name
00104 Returns:
00105     0: mapping succeeded
00106     1: mapping failed
00107 ******************************************************************************/
00108 #if ALLOW_EMPTY_CREDENTIALS
00109 extern int lcmaps_run_and_return_username(
00110         char * user_dn_tmp,
00111         gss_cred_id_t user_cred,
00112         lcmaps_request_t request,
00113         char ** usernamep
00114 );
00115 #else
00116 extern int lcmaps_run_and_return_username(
00117         gss_cred_id_t user_cred,
00118         lcmaps_request_t request,
00119         char ** usernamep
00120 );
00121 #endif
00122 /******************************************************************************
00123 Function:   lcmaps_run_without_credentials
00124 Description:
00125     do the user mapping without credentials, only the user DN
00126 
00127 Parameters:
00128     user_dn_tmp: user DN
00129 Returns:
00130     0: mapping succeeded
00131     1: mapping failed
00132 ******************************************************************************/
00133 extern int lcmaps_run_without_credentials(
00134         char * user_dn_tmp
00135 );
00136 #endif /* LCMAPS_H */
00137 
00138 /******************************************************************************
00139 CVS Information:
00140     $Source: /cvs/fabric_mgt/gridification/lcmaps/include/lcmaps.h,v $
00141     $Date: 2004/02/18 15:53:31 $
00142     $Revision: 1.6 $
00143     $Author: martijn $
00144 ******************************************************************************/