---
name: "globus_net_manager"
section: "3"
platform: "linux"
package: "libglobus-net-manager-doc"
version: "1.7-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/globus_net_manager"
---

# globus\_net\_manager(3)

Net Manager - Net Manager API.

## NAME

globus\_net\_manager - Net Manager

 \- Net Manager API.

## SYNOPSIS

### Modules

**Attributes**\
 Net Manager Attribute Management Functions.  **Context**\
 Net Manager Context Management Functions.  **Net Manager Data Types**\
 Net Manager Data Types.  **Function Signatures**\
 Net Manager Function Signatures.  **Python Module**\
 Net Manager Python Module.  **Globus XIO Net Manager Driver**\
 Net Manager XIO Driver.

### Macros

\#define **GLOBUS\_NET\_MANAGER\_MODULE**\
 Module descriptor.

### Functions

globus\_result\_t **globus\_net\_manager\_register** (**globus\_net\_manager\_t** \*manager, globus\_module\_descriptor\_t \*module)\
 Register a network manager.  globus\_result\_t **globus\_net\_manager\_unregister** (**globus\_net\_manager\_t** \*manager)\
 Unregister a network manager.

## Detailed Description

Net Manager API.

This API defines the plug-in points for network manager functionality, as well as functions for registering a particular network manager implementation so that it can be invoked during network events.

To implement a network manager, define a struct **globus\_net\_manager\_s** with the functions you want called, and register it by calling **globus\_net\_manager\_register()**. More details are included in **globus\_net\_manager\_tutorial**

## Macro Definition Documentation

### #define GLOBUS\_NET\_MANAGER\_MODULE

Module descriptor. The Globus Net Manager uses Grid Community Toolkit module activation and deactivation. Before any Net Manager functions can be called, the module must be activated, like this:

```
globus_module_activate(GLOBUS_NET_MANAGER_MODULE);
```

This function returns GLOBUS\_SUCCESS if the library is successfully initialized. Otherwise, an error code is returned, and Net Manager functions should not be subsequently called.

Activations are reference counted, so it is safe to activate the module multiple times or in different modules.

To deactivate Net Manager, call

```
globus_module_deactivate(GLOBUS_NET_MANAGER_MODULE);
```

This function should be done once for each time the Net Manager was activated.

## Function Documentation

### globus\_result\_t globus\_net\_manager\_register (globus\_net\_manager\_t \* manager, globus\_module\_descriptor\_t \* module)

Register a network manager. The **globus\_net\_manager\_register()** function adds this network manager to those which will be called by the network manager interface when network events occur. This is typically called by the network manager when its module is activated.

**Parameters**

*manager* Manager information to register. \
 *module* Module descriptor to register. Use GlobusExtensionMyModule(module name)

### globus\_result\_t globus\_net\_manager\_unregister (globus\_net\_manager\_t \* manager)

Unregister a network manager. The **globus\_net\_manager\_unregister()** function removes this network manager from those which will be called by the network manager interface when network events occur. This is typically called by the network manager when its module is deactivated.

**Parameters**

*manager* Manager information to unregister.

## Author

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