1gss_release_cred(G3eGnSeSr)ic Security Services API Library Fungcstsi_orneslease_cred(3GSS)
2
3
4

NAME

6       gss_release_cred - discard a credential handle
7

SYNOPSIS

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

DESCRIPTION

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

PARAMETERS

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

ERRORS

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

ATTRIBUTES

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

SEE ALSO

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