---
name: "globus_gass_transfer_listenerattr"
section: "3"
platform: "linux"
package: "libglobus-gass-transfer-doc"
version: "9.4-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/globus_gass_transfer_listenerattr"
---

# globus\_gass\_transfer\_listenerattr(3)

Listener attributes - Listener attributes.

## NAME

globus\_gass\_transfer\_listenerattr - Listener attributes

 \- Listener attributes.

## SYNOPSIS

### Authorization

int **globus\_gass\_transfer\_listenerattr\_init** (globus\_gass\_transfer\_listenerattr\_t \*attr, char \*url\_scheme)\

### Listener Backlog

int **globus\_gass\_transfer\_listenerattr\_set\_backlog** (globus\_gass\_transfer\_listenerattr\_t \*attr, int backlog)\

### Listener Port

int **globus\_gass\_transfer\_listenerattr\_set\_port** (globus\_gass\_transfer\_listenerattr\_t \*attr, unsigned short port)\

## Detailed Description

Listener attributes.

## Function Documentation

### int globus\_gass\_transfer\_listenerattr\_init (globus\_gass\_transfer\_listenerattr\_t \* attr, char \* url\_scheme)

Initialize a listener attribute.

This function initializes the *attr* to contain a new protocol-specific listener attribute.

**Parameters**

*attr* The attribute set to be initialized. \
 *url\_scheme* The scheme which which the attribute will be used for.

**Return values**

*GLOBUS\_SUCCESS* The attribute was successfully initialized. \
 *GLOBUS\_GASS\_TRANSFER\_ERROR\_NULL\_POINTER* Either *attr* or *url\_scheme* was GLOBUS\_NULL. \
 *GLOBUS\_GASS\_TRANSFER\_ERROR\_NOT\_IMPLEMENTED* No protocol module currently registered with GASS Transfer Library handles URLs with the specified *url\_scheme*.

### int globus\_gass\_transfer\_listenerattr\_set\_backlog (globus\_gass\_transfer\_listenerattr\_t \* attr, int backlog)

Set/Get the backlog attribute for a GASS transfer attribute set.

This attribute allows the user to control then number of pending connections which may exist for this listener.

**Parameters**

*attr* The attribute set to query or modify. \
 *backlog* The number of outstanding connections to allow.

**Return values**

*GLOBUS\_SUCCESS* The attribute was successfully updated. \
 *GLOBUS\_GASS\_TRANSFER\_ERROR\_NULL\_POINTER* The *attr* was GLOBUS\_NULL.

### int globus\_gass\_transfer\_listenerattr\_set\_port (globus\_gass\_transfer\_listenerattr\_t \* attr, unsigned short port)

Set/Get the port attribute for a GASS transfer attribute set.

This attribute allows the user to set the port to be used by a GASS Transfer listener.

**Parameters**

*attr* The attribute set to query or modify. \
 *port* The TCP or UDP port number to use.

**Return values**

*GLOBUS\_SUCCESS* The attribute was successfully updated. \
 *GLOBUS\_GASS\_TRANSFER\_ERROR\_NULL\_POINTER* The *attr* was GLOBUS\_NULL.

## Author

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