---
name: "globus_gss_assist_credential"
section: "3"
platform: "linux"
package: "libglobus-gss-assist-doc"
version: "12.7-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/globus_gss_assist_credential"
---

# globus\_gss\_assist\_credential(3)

Credential Management - Acquire Credential.

## NAME

globus\_gss\_assist\_credential - Credential Management

 \- Acquire Credential.

## SYNOPSIS

### Functions

OM\_uint32 **globus\_gss\_assist\_acquire\_cred** (OM\_uint32 \*minor\_status, gss\_cred\_usage\_t cred\_usage, gss\_cred\_id\_t \*output\_cred\_handle)\
 OM\_uint32 **globus\_gss\_assist\_acquire\_cred\_ext** (OM\_uint32 \*minor\_status, char \*desired\_name\_char, OM\_uint32 time\_req, const gss\_OID\_set desired\_mechs, gss\_cred\_usage\_t cred\_usage, gss\_cred\_id\_t \*output\_cred\_handle, gss\_OID\_set \*actual\_mechs, OM\_uint32 \*time\_rec)\
 OM\_uint32 **globus\_gss\_assist\_read\_vhost\_cred\_dir** (OM\_uint32 \*minor\_status, const char \*dir, gss\_cred\_id\_t \*\*output\_credentials\_array, size\_t \*output\_credentials\_array\_size)\
 Acquire all GSSAPI credentials in a directory.

## Detailed Description

Acquire Credential.

The functions in this section are used to acquire security credentials.

## Function Documentation

### OM\_uint32 globus\_gss\_assist\_acquire\_cred (OM\_uint32 \* minor\_status, gss\_cred\_usage\_t cred\_usage, gss\_cred\_id\_t \* output\_cred\_handle)

Called once at the start of the process, to obtain the credentials the process is running under. The

**Parameters**

*minor\_status* pointer for return code \
 *cred\_usage* GSS\_C\_INITIATE, GSS\_C\_ACCEPT, or GSS\_C\_BOTH \
 *output\_cred\_handle* Pointer to the returned handle. This needs to be passed to many gss routines.

**Returns**

GSS\_S\_COMPLETE on success Other GSSAPI return codes

### OM\_uint32 globus\_gss\_assist\_acquire\_cred\_ext (OM\_uint32 \* minor\_status, char \* desired\_name\_char, OM\_uint32 time\_req, const gss\_OID\_set desired\_mechs, gss\_cred\_usage\_t cred\_usage, gss\_cred\_id\_t \* output\_cred\_handle, gss\_OID\_set \* actual\_mechs, OM\_uint32 \* time\_rec)

Called once at the start of the process, to obtain the credentials the process is running under. All the parameters of the gss\_acquire\_cred(), except the desired\_name is a string of the form: \[type:\]name. This will be imported with the type.

**Returns**

GSS\_S\_COMPLETE on success Other GSSPI return codes

**See also**

globus\_gss\_acquire\_cred

### OM\_uint32 globus\_gss\_assist\_read\_vhost\_cred\_dir (OM\_uint32 \* minor\_status, const char \* dir, gss\_cred\_id\_t \*\* output\_credentials\_array, size\_t \* output\_credentials\_array\_size)

Acquire all GSSAPI credentials in a directory. This function loads all of the credentials available in the vhost credential directory and returns them in its output parameters.

The credentials directory is expected to contain a directory for each credential, with the directory containing cert.pem and privkey.pem files.

If the dir parameter is NULL, then this function uses the `X509_VHOST_CRED_DIR` environment variable, or the default `/etc/grid-security/vhosts/` if it is not set.

**Parameters**

*minor\_status* Mechanism-specific error code  \
 *dir* Optional directory name to override X509\_VHOST\_CRED\_DIR  \
 *output\_credentials\_array* Pointer to a dynamic array allocated to hold credentials  \
 *output\_credentials\_array\_size* Pointer to be set to the resulting size (in bytes) of the output\_credentials\_array

## Author

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