---
name: "globus_callout_read_config"
section: "3"
platform: "linux"
package: "libglobus-callout-doc"
version: "4.3-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/globus_callout_config"
---

# globus\_callout\_read\_config(3)

Callout Configuration - Register callouts.

Part of [globus\_callout\_config(3)](/globus_callout_config/3.md).

## NAME

globus\_callout\_config - Callout Configuration

 \- Register callouts.

## SYNOPSIS

### Functions

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

Register 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 if needed.

**Parameters**

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

**Returns**

This function returns GLOBUS\_SUCCESS or a globus\_result\_t referring to an error object of one of the following types

**Return values**

*GLOBUS\_CALLOUT\_ERROR\_OPENING\_CONF\_FILE* Error opening filename \
 *GLOBUS\_CALLOUT\_ERROR\_PARSING\_CONF\_FILE* Error parsing file \
 *GLOBUS\_CALLOUT\_ERROR\_OUT\_OF\_MEMORY* Out of memory

### globus\_result\_t globus\_callout\_register (globus\_callout\_handle\_t handle, char \* type, char \* library, char \* symbol)

Register callout configuration

This 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**

This function returns GLOBUS\_SUCCESS or a globus\_result\_t referring to an error object of one of the following types

**Return values**

*GLOBUS\_CALLOUT\_ERROR\_OUT\_OF\_MEMORY* Out of memory

## Author

Generated automatically by Doxygen for globus\_callout from the source code.