1gss_release_cred(G3eGnSeSr)ic Security Services API Library Fungcstsi_orneslease_cred(3GSS)
2
3
4
6 gss_release_cred - discard a credential handle
7
9 cc [ flag... ] file... -lgss [ library... ]
10 #include <gssapi/gssapi.h>
11
12 OM_uint32 gss_release_cred(OM_uint32 *minor_status,
13 gss_cred_id_t *cred_handle);
14
15
17 The gss_release_cred() function informs the GSS-API that the specified
18 credential handle is no longer required by the application and frees
19 the associated resources. The cred_handle parameter is set to
20 GSS_C_NO_CREDENTIAL when this call completes successfully.
21
23 The parameter descriptions for gss_release_cred() follow:
24
25 minor_status A mechanism specific status code.
26
27
28 cred_handle An opaque handle that identifies the credential to be
29 released. If GSS_C_NO_CREDENTIAL is specified, the
30 gss_release_cred() function will complete successfully,
31 but it will do nothing.
32
33
35 gss_release_cred() may return the following status codes:
36
37 GSS_S_COMPLETE Successful completion.
38
39
40 GSS_S_NO_CRED The referenced credentials cannot be accessed.
41
42
43 GSS_S_FAILURE The underlying mechanism detected an error for which
44 no specific GSS status code is defined. The mecha‐
45 nism-specific status code reported by means of the
46 minor_status parameter details the error condition.
47
48
50 See attributes(5) for descriptions of the following attributes:
51
52
53
54
55 ┌─────────────────────────────┬─────────────────────────────┐
56 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
57 ├─────────────────────────────┼─────────────────────────────┤
58 │Availability │SUNWgss (32-bit) │
59 ├─────────────────────────────┼─────────────────────────────┤
60 │ │SUNWgssx (64-bit) │
61 ├─────────────────────────────┼─────────────────────────────┤
62 │MT-Level │Safe │
63 └─────────────────────────────┴─────────────────────────────┘
64
66 attributes(5)
67
68
69 Solaris Security for Developers Guide
70
71
72
73SunOS 5.11 15 Jan 2003 gss_release_cred(3GSS)