Callout Configuration

Configure Callouts
globus_result_t	globus_callout_read_config (globus_callout_handle_t handle, char *filename)
globus_result_t	globus_callout_register (globus_callout_handle_t handle, char *type, char *library, char *symbol)

Detailed Description

Functions for registering callouts.

This section defines operations for registering callouts. Callouts may be registered either through a configuration file or through calls to globus_callout_register.

Function Documentation

globus_result_t globus_callout_read_config	(	globus_callout_handle_t	handle,
		char *	filename
	)

Read callout configuration from file.

This function read a configuration file with the following format:

• Anything after a '#' is assumed to be a comment
• Blanks lines are ignored
• Lines specifying callouts have the format abstract type library symbol where "abstract type" denotes the type of callout, e.g. globus_gram_jobmanager_authz, "library" denotes the library the callout can be found in and "symbol" denotes the function name of the callout. The library argument can be specified in two forms, libfoo or libfoo_<flavor>. When using the former version the current flavor will automatically be added to the library name.

Parameters

handle	The handle that is to be configured
filename	The file to read configuration from

Returns

GLOBUS_SUCCESS A Globus error object on failure: GLOBUS_CALLOUT_ERROR_OPENING_CONF_FILE GLOBUS_CALLOUT_ERROR_PARSING_CONF_FILE GLOBUS_CALLOUT_ERROR_WITH_HASHTABLE GLOBUS_CALLOUT_ERROR_OUT_OF_MEMORY

References GLOBUS_CALLOUT_ERROR_OPENING_CONF_FILE, GLOBUS_CALLOUT_ERROR_PARSING_CONF_FILE, and GLOBUS_CALLOUT_ERROR_WITH_HASHTABLE.

globus_result_t globus_callout_register	(	globus_callout_handle_t	handle,
		char *	type,
		char *	library,
		char *	symbol
	)

Register callout configurationThis function registers a callout type in the given handle.

Parameters

handle	The handle that is to be configured
type	The abstract type of the callout
library	The location of the library containing the callout
symbol	The symbol (ie function name) for the callout

Returns

GLOBUS_SUCCESS A Globus error object on failure: GLOBUS_CALLOUT_ERROR_WITH_HASHTABLE GLOBUS_CALLOUT_ERROR_OUT_OF_MEMORY

References GLOBUS_CALLOUT_ERROR_WITH_HASHTABLE.