1gss_release_buffeGre(n3eGrSiSc)Security Services API Library Fgusnsc_trieolnesase_buffer(3GSS)
2
3
4
6 gss_release_buffer - free buffer storage allocated by a GSS-API func‐
7 tion
8
10 cc [ flag... ] file... -lgss [ library... ]
11 #include <gssapi/gssapi.h>
12
13 OM_uint32 gss_release_buffer(OM_uint32 *minor_status, gss_buffer_tbuffer);
14
15
17 The gss_release_buffer() function frees buffer storage allocated by a
18 GSS-API function. The gss_release_buffer() function also zeros the
19 length field in the descriptor to which the buffer parameter refers,
20 while the GSS-API function sets the pointer field in the descriptor to
21 NULL. Any buffer object returned by a GSS-API function may be passed to
22 gss_release_buffer(), even if no storage is associated with the buffer.
23
25 The parameter descriptions for gss_release_buffer() follow:
26
27 minor_status Mechanism-specific status code.
28
29
30 buffer The storage associated with the buffer will be deleted.
31 The gss_buffer_desc() object will not be freed; how‐
32 ever, its length field will be zeroed.
33
34
36 The gss_release_buffer() function may return the following status
37 codes:
38
39 GSS_S_COMPLETE Successful completion
40
41
42 GSS_S_FAILURE The underlying mechanism detected an error for which
43 no specific GSS status code is defined. The mecha‐
44 nism-specific status code reported by means of the
45 minor_status parameter details the error condition.
46
47
49 See attributes(5) for descriptions of the following attributes:
50
51
52
53
54 ┌─────────────────────────────┬─────────────────────────────┐
55 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
56 ├─────────────────────────────┼─────────────────────────────┤
57 │Availability │SUNWgss (32-bit) │
58 ├─────────────────────────────┼─────────────────────────────┤
59 │ │SUNWgssx (64-bit) │
60 ├─────────────────────────────┼─────────────────────────────┤
61 │MT-Level │Safe │
62 └─────────────────────────────┴─────────────────────────────┘
63
65 attributes(5)
66
67
68 Solaris Security for Developers Guide
69
70
71
72SunOS 5.11 15 Jan 2003 gss_release_buffer(3GSS)