1gss_release_buffeGre(n3eGrSiSc)Security Services API Library Fgusnsc_trieolnesase_buffer(3GSS)
2
3
4

NAME

6       gss_release_buffer  -  free buffer storage allocated by a GSS-API func‐
7       tion
8

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

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

ERRORS

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

ATTRIBUTES

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

SEE ALSO

65       attributes(5)
66
67
68       Solaris Security for Developers Guide
69
70
71
72SunOS 5.11                        15 Jan 2003         gss_release_buffer(3GSS)
Impressum