---
name: "globus_gss_assist_wrap_send"
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.h"
---

# globus\_gss\_assist\_wrap\_send(3)

GSS Assist Header.

Part of [globus\_gss\_assist.h(3)](/globus_gss_assist.h/3.md).

## NAME

globus\_gss\_assist.h - GSS Assist Header.

## SYNOPSIS

`#include 'gssapi.h'`\
 `#include <stdio.h>`\
 `#include <stdlib.h>`\
 `#include 'globus_gss_assist_constants.h'`\

### Macros

\#define **GLOBUS\_GSI\_GSS\_ASSIST\_MODULE**\
 \#define **GlobusGssAssistFreeDNArray**(dn\_a)\
 Free array of distinguished names.

### Functions

int **globus\_gss\_assist\_token\_get\_fd** (void \*arg, void \*\*bufp, size\_t \*sizep)\
 Get token from a FILE \*.  int **globus\_gss\_assist\_token\_send\_fd** (void \*arg, void \*buf, size\_t size)\
 Send token via a FILE \*.  int **globus\_gss\_assist\_token\_send\_fd\_ex** (void \*exp, void \*buf, size\_t size)\
 Send a token to a FILE \*.  int **globus\_gss\_assist\_token\_send\_fd\_without\_length** (void \*arg, void \*buf, size\_t size)\
 Send token to a FILE \*.  OM\_uint32 **globus\_gss\_assist\_acquire\_cred** (OM\_uint32 \*, gss\_cred\_usage\_t, gss\_cred\_id\_t \*)\
 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.  OM\_uint32 **globus\_gss\_assist\_acquire\_cred\_ext** (OM\_uint32 \*, char \*, OM\_uint32, const gss\_OID\_set, gss\_cred\_usage\_t, gss\_cred\_id\_t \*, gss\_OID\_set \*, OM\_uint32 \*)\
 OM\_uint32 **globus\_gss\_assist\_accept\_sec\_context** (OM\_uint32 \*, gss\_ctx\_id\_t \*, const gss\_cred\_id\_t, char \*\*, OM\_uint32 \*, int \*, int \*, gss\_cred\_id\_t \*, int(\*get\_token)(void \*, void \*\*, size\_t \*), void \*get\_context, int(\*send\_token)(void \*, void \*, size\_t), void \*send\_context)\
 Accept a Security Context.  OM\_uint32 **globus\_gss\_assist\_accept\_sec\_context\_async** (OM\_uint32 \*minor\_status, gss\_ctx\_id\_t \*context\_handle, const gss\_cred\_id\_t cred\_handle, char \*\*src\_name\_char, OM\_uint32 \*ret\_flags, int \*user\_to\_user\_flag, void \*input\_buffer, size\_t input\_buffer\_len, void \*\*output\_bufferp, size\_t \*output\_buffer\_lenp, gss\_cred\_id\_t \*delegated\_cred\_handle)\
 Accept a Security Context Without Blocking.  OM\_uint32 **globus\_gss\_assist\_init\_sec\_context** (OM\_uint32 \*, const gss\_cred\_id\_t, gss\_ctx\_id\_t \*, char \*, OM\_uint32, OM\_uint32 \*, int \*, int(\*get\_token)(void \*, void \*\*, size\_t \*), void \*get\_arg, int(\*send\_token)(void \*, void \*, size\_t), void \*send\_arg)\
 OM\_uint32 **globus\_gss\_assist\_init\_sec\_context\_async** (OM\_uint32 \*minor\_status, const gss\_cred\_id\_t cred\_handle, gss\_ctx\_id\_t \*context\_handle, char \*target\_name\_char, OM\_uint32 req\_flags, OM\_uint32 \*ret\_flags, void \*input\_buffer, size\_t input\_buffer\_len, void \*\*output\_bufferp, size\_t \*output\_buffer\_lenp)\
 OM\_uint32 **globus\_gss\_assist\_display\_status** (FILE \*, char \*, OM\_uint32, OM\_uint32, int)\
 OM\_uint32 **globus\_gss\_assist\_display\_status\_str** (char \*\*, char \*, OM\_uint32, OM\_uint32, int)\
 OM\_uint32 **globus\_gss\_assist\_wrap\_send** (OM\_uint32 \*minor\_status, const gss\_ctx\_id\_t context\_handle, char \*data, size\_t length, int \*token\_status, int(\*gss\_assist\_send\_token)(void \*, void \*, size\_t), void \*gss\_assist\_send\_context, FILE \*fperr)\
 Wrap.  OM\_uint32 **globus\_gss\_assist\_get\_unwrap** (OM\_uint32 \*minor\_status, const gss\_ctx\_id\_t context\_handle, char \*\*data, size\_t \*length, int \*token\_status, int(\*gss\_assist\_get\_token)(void \*, void \*\*, size\_t \*), void \*gss\_assist\_get\_context, FILE \*fperr)\
 Get Unwrap.  OM\_uint32 **globus\_gss\_assist\_will\_handle\_restrictions** (OM\_uint32 \*minor\_status, gss\_ctx\_id\_t \*context\_handle)\
 OM\_uint32 **globus\_gss\_assist\_export\_sec\_context** (OM\_uint32 \*minor\_status, gss\_ctx\_id\_t \*context\_handle, int \*token\_status, int fdp, FILE \*fperr)\
 OM\_uint32 **globus\_gss\_assist\_import\_sec\_context** (OM\_uint32 \*minor\_status, gss\_ctx\_id\_t \*context\_handle, int \*token\_status, int fdp, FILE \*fperr)\
 globus\_result\_t **globus\_gss\_assist\_authorization\_host\_name** (char \*hostname, gss\_name\_t \*authorization\_hostname)\
 int **globus\_gss\_assist\_gridmap** (char \*globusidp, char \*\*useridp)\
 Look up the default mapping for a Grid identity in a gridmap file.  int **globus\_gss\_assist\_userok** (char \*globusid, char \*userid)\
 Gridmap entry existence check.  int **globus\_gss\_assist\_map\_local\_user** (char \*local\_user, char \*\*globusidp)\
 Look up the default Grid identity associated with a local user name.  globus\_result\_t **globus\_gss\_assist\_lookup\_all\_globusid** (char \*username, char \*\*dns\[\], int \*dn\_count)\
 Look up all Grid IDs associated with a local user ID.  globus\_result\_t **globus\_gss\_assist\_map\_and\_authorize** (gss\_ctx\_id\_t context, char \*service, char \*desired\_identity, char \*identity\_buffer, unsigned int identity\_buffer\_length)\
 Authorize the peer of a security context to use a service.  globus\_result\_t **globus\_gss\_assist\_map\_and\_authorize\_sharing** (char \*shared\_user\_certificate, gss\_ctx\_id\_t context, char \*desired\_identity, char \*identity\_buffer, unsigned int identity\_buffer\_length)\
 Authorize a particular credential for shared access.

## Detailed Description

GSS Assist Header.

## Function Documentation

### globus\_result\_t globus\_gss\_assist\_authorization\_host\_name (char \* hostname, gss\_name\_t \* authorization\_hostname)

Create a GSS Name structure from the given hostname. This function tries to resolve the given host name string to the canonical DNS name for the host.

**Parameters**

*hostname* The host name or numerical address to be resolved and transform into a GSS Name \
 *authorization\_hostname* The resulting GSS Name

**Returns**

GLOBUS\_SUCCESS on successful completion, a error object otherwise

### OM\_uint32 globus\_gss\_assist\_wrap\_send (OM\_uint32 \* minor\_status, const gss\_ctx\_id\_t context\_handle, char \* data, size\_t length, int \* token\_status, int(\*)(void \*, void \*, size\_t) gss\_assist\_send\_token, void \* gss\_assist\_send\_context, FILE \* fperr)` [extern]`

Wrap.

**Parameters**

*minor\_status* GSSAPI return code. If the call was successful, the minor status is equal to GLOBUS\_SUCCESS. Otherwise, it is an error object ID for which \
\
  globus\_error\_get() and globus\_object\_free() can be used to get and destroy it. \
 *context\_handle* the context. \
 *data* pointer to application data to wrap and send \
 *length* length of the *data* array \
 *token\_status* assist routine get/send token status \
 *gss\_assist\_send\_token* a send\_token routine \
 *gss\_assist\_send\_context* first arg for the send\_token \
 *fperr* file handle to write error message to.

**Returns**

GSS\_S\_COMPLETE on success Other GSSAPI errors on failure. \

**See also**

gss\_wrap()

## Author

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