---
name: "globus_gsi_cred_handle_attrs_get_ca_cert_dir"
section: "3"
platform: "linux"
package: "libglobus-gsi-credential-doc"
version: "8.4-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/globus_gsi_cred_handle_attrs"
---

# globus\_gsi\_cred\_handle\_attrs\_get\_ca\_cert\_dir(3)

Credential Handle Attributes - Credential Handle Attributes.

Part of [globus\_gsi\_cred\_handle\_attrs(3)](/globus_gsi_cred_handle_attrs/3.md).

## NAME

globus\_gsi\_cred\_handle\_attrs - Credential Handle Attributes

 \- Credential Handle Attributes.

## SYNOPSIS

### Typedefs

typedef struct globus\_l\_gsi\_cred\_handle\_attrs\_s \* **globus\_gsi\_cred\_handle\_attrs\_t**\

### Functions

globus\_result\_t **globus\_gsi\_cred\_handle\_attrs\_init** (**globus\_gsi\_cred\_handle\_attrs\_t** \*handle\_attrs)\
 Initialize credential handle attributes.  globus\_result\_t **globus\_gsi\_cred\_handle\_attrs\_destroy** (**globus\_gsi\_cred\_handle\_attrs\_t** handle\_attrs)\
 Destroy credential handle attributes.  globus\_result\_t **globus\_gsi\_cred\_handle\_attrs\_copy** (**globus\_gsi\_cred\_handle\_attrs\_t** source, **globus\_gsi\_cred\_handle\_attrs\_t** \*dest)\
 Copy credential handle attributes.  globus\_result\_t **globus\_gsi\_cred\_handle\_attrs\_set\_ca\_cert\_dir** (**globus\_gsi\_cred\_handle\_attrs\_t** handle\_attrs, const char \*ca\_cert\_dir)\
 Set the CA certificate directory.  globus\_result\_t **globus\_gsi\_cred\_handle\_attrs\_get\_ca\_cert\_dir** (**globus\_gsi\_cred\_handle\_attrs\_t** handle\_attrs, char \*\*ca\_cert\_dir)\
 Get the CA certificate directory.  globus\_result\_t **globus\_gsi\_cred\_handle\_attrs\_set\_search\_order** (**globus\_gsi\_cred\_handle\_attrs\_t** handle\_attrs, **globus\_gsi\_cred\_type\_t** search\_order\[\])\
 Set the search order.  globus\_result\_t **globus\_gsi\_cred\_handle\_attrs\_get\_search\_order** (**globus\_gsi\_cred\_handle\_attrs\_t** handle\_attrs, **globus\_gsi\_cred\_type\_t** \*\*search\_order)\
 Get the search order.

## Detailed Description

Credential Handle Attributes.

Create/Destroy/Modify GSI Credential Handle Attributes.

Within the Globus GSI Credential Library, all credential handles contain a attribute structure, which in turn contains handle instance independent attributes.

This section defines operations to create, modify and destroy GSI Credential handle attributes.

## Typedef Documentation

### typedef struct globus\_l\_gsi\_cred\_handle\_attrs\_s\* globus\_gsi\_cred\_handle\_attrs\_t

Credential Handle Attributes.

Credential handle attributes provide a set of immutable parameters for a credential handle

**See also**

**globus\_gsi\_cred\_handle\_init**

## Function Documentation

### globus\_result\_t globus\_gsi\_cred\_handle\_attrs\_copy (globus\_gsi\_cred\_handle\_attrs\_t source, globus\_gsi\_cred\_handle\_attrs\_t \* dest)

Copy credential handle attributes. Copy the Credential Handle Attributes.

**Parameters**

*source* The handle attribute to be copied \
 *dest* The copy

**Returns**

GLOBUS\_SUCESS unless there was an error, in which case an error object is returned.

### globus\_result\_t globus\_gsi\_cred\_handle\_attrs\_destroy (globus\_gsi\_cred\_handle\_attrs\_t handle\_attrs)

Destroy credential handle attributes. Destroy the Credential Handle Attributes. This function does some cleanup and deallocation of the handle attributes.

**Parameters**

*handle\_attrs* The handle attributes to destroy

**Returns**

GLOBUS\_SUCCESS

### globus\_result\_t globus\_gsi\_cred\_handle\_attrs\_get\_ca\_cert\_dir (globus\_gsi\_cred\_handle\_attrs\_t handle\_attrs, char \*\* ca\_cert\_dir)

Get the CA certificate directory. Get the trusted CA certificate directory

**Parameters**

*handle\_attrs* the credential handle attributes to get the trusted ca cert directory from \
 *ca\_cert\_dir* the trusted ca certificates directory

**Returns**

GLOBUS\_SUCCESS if no errors occurred. In case of a null handle\_attrs or pointer to ca\_cert\_dir, an error object id is returned

### globus\_result\_t globus\_gsi\_cred\_handle\_attrs\_get\_search\_order (globus\_gsi\_cred\_handle\_attrs\_t handle\_attrs, globus\_gsi\_cred\_type\_t \*\* search\_order)

Get the search order. Get the search order of the handle attributes

**Parameters**

*handle\_attrs* The handle attributes to get the search order from \
 *search\_order* The search\_order of the handle attributes

**Returns**

GLOBUS\_SUCCESS unless handle\_attrs is null

### globus\_result\_t globus\_gsi\_cred\_handle\_attrs\_init (globus\_gsi\_cred\_handle\_attrs\_t \* handle\_attrs)

Initialize credential handle attributes. Initializes the immutable Credential Handle Attributes The handle attributes are initialized as follows:

- •

  The search order is set to SERVICE, HOST, PROXY, USER

- •

  All other attributes are set to 0/NULL

**Parameters**

*handle\_attrs* the attributes to be initialized

**Returns**

GLOBUS\_SUCCESS if initialization was successful, otherwise an error is returned

### globus\_result\_t globus\_gsi\_cred\_handle\_attrs\_set\_ca\_cert\_dir (globus\_gsi\_cred\_handle\_attrs\_t handle\_attrs, const char \* ca\_cert\_dir)

Set the CA certificate directory. Set the Trusted CA Certificate Directory Location

**Parameters**

*handle\_attrs* the credential handle attributes to set \
 *ca\_cert\_dir* the trusted ca certificates directory

**Returns**

GLOBUS\_SUCCESS if no errors occurred. In case of a null handle\_attrs, an error object id is returned

### globus\_result\_t globus\_gsi\_cred\_handle\_attrs\_set\_search\_order (globus\_gsi\_cred\_handle\_attrs\_t handle\_attrs, globus\_gsi\_cred\_type\_t search\_order\[\])

Set the search order. Set the search order for finding a user certificate. The default value is {SERVICE, HOST, PROXY, USER}

**Parameters**

*handle\_attrs* The handle attributes to set the search order of \
 *search\_order* The search order. Should be a three element array containing in some order PROXY, USER, HOST, SERVICE. The array should be terminated by the value GLOBUS\_SO\_END.

**Returns**

GLOBUS\_SUCCESS unless handle\_attrs is null

## Author

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