.TH "globus_callout" 3 "Tue Jul 5 2022" "Version 4.3" "globus_callout" \" -*- nroff -*-
.ad l
.nh
.SH NAME
globus_callout \- Globus Callout API
.PP
 \- Globus Callout API\&.  

.SH SYNOPSIS
.br
.PP
.SS "Modules"

.in +1c
.ti -1c
.RI "\fBActivation\fP"
.br
.RI "Callback API Activation\&. "
.ti -1c
.RI "\fBCallout Handle Operations\fP"
.br
.RI "Manage a Globus Callout Handle structure\&. "
.ti -1c
.RI "\fBCallout Configuration\fP"
.br
.RI "Register callouts\&. "
.ti -1c
.RI "\fBCallout Invocation\fP"
.br
.RI "Invoke callouts\&. "
.ti -1c
.RI "\fBCallout Constants\fP"
.br
.RI "Constants\&. "
.in -1c
.SH "Detailed Description"
.PP 
Globus Callout API\&. 

This API is intended to ease integration of configurable callouts into the Grid Community Toolkit and to provide a platform independent way of dealing with runtime loadable functions\&. It (hopefully) achieves this goal by providing the following functionality:
.PP
.IP "\(bu" 2
It provides a function for reading callout configuration files\&. Files are assumed to have the following format:
.IP "  \(bu" 4
Anything after a \fC#\fP is assumed to be a comment
.IP "  \(bu" 4
Blanks lines are ignored
.IP "  \(bu" 4
Lines specifying callouts have the format 
.PP
.nf
       abstract type           library         symbol

.fi
.PP

.IP "  \(bu" 4
where \fIabstract type\fP denotes the type of callout, e\&.g\&. globus_gram_jobmanager_authz, \fIlibrary\fP denotes the library the callout can be found in and \fIsymbol\fP denotes the function name of the callout\&.
.PP

.IP "\(bu" 2
It provides a API function for registering callouts
.IP "\(bu" 2
All callouts are assumed to have the function signature globus_result_t callout_func(va_list ap)
.IP "\(bu" 2
It provides a function for calling a callout given an abstract type\&. If multiple callouts are defined for the same abstract type then all callouts for the abstract type will be called\&. Implementers should not rely on any correlation between the order of configuration and the order of invocation of callouts of the same abstract type\&.
.PP
.PP
Any program that uses Globus Callout functions must include the \fBglobus_callout\&.h\fP header
.PP
Function Categories
.IP "\(bu" 2
\fBActivation\fP
.IP "\(bu" 2
\fBCallout Handle Operations\fP
.IP "\(bu" 2
\fBCallout Configuration\fP
.IP "\(bu" 2
\fBCallout Invocation\fP
.IP "\(bu" 2
\fBCallout Constants\fP 
.PP

.SH "Author"
.PP 
Generated automatically by Doxygen for globus_callout from the source code\&.