Generic Security Services API Library Functions
gss_release_buffer(3GSS)
NAME
gss_release_buffer - free buffer storage allocated by a
GSS-API function
SYNOPSIS
cc [ flag... ] file... -lgss [ library... ]
#include
OM_uint32 gss_release_buffer(OM_uint32 *minor_status, gss_buffer_tbuffer);
DESCRIPTION
The gss_release_buffer() function frees buffer storage
allocated by a GSS-API function. The gss_release_buffer()
function also zeros the length field in the descriptor towhich the buffer parameter refers, while the GSS-API func-
tion sets the pointer field in the descriptor to NULL. Anybuffer object returned by a GSS-API function may be passed
to gss_release_buffer(), even if no storage is associated
with the buffer.PARAMETERS
The parameter descriptions for gss_release_buffer() follow:
minor_status Mechanism-specific status code.
buffer The storage associated with the buffer willbe deleted. The gss_buffer_desc() object
will not be freed; however, its length field will be zeroed.ERRORS
The gss_release_buffer() function may return the following
status codes:GSS_S_COMPLETE Successful completion
GSS_S_FAILURE The underlying mechanism detected an error
for which no specific GSS status code isdefined. The mechanism-specific status
code reported by means of the minor_status
parameter details the error condition.ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:SunOS 5.11 Last change: 15 Jan 2003 1
Generic Security Services API Library Functionsgss_release_buffer(3GSS)
____________________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________________|
| Availability | system/library/security/gss (32-bit)|
|_____________________________|_____________________________________|
| | SUNWgssx (64-bit) |
|_____________________________|_____________________________________|
| MT-Level | Safe |
|_____________________________|_____________________________________|
SEE ALSO
attributes(5) Oracle Solaris Security for Developers GuideSunOS 5.11 Last change: 15 Jan 2003 2
Generic Security Services API Library Functionsgss_release_buffer(3GSS)
SunOS 5.11 Last change: 15 Jan 2003 3