1gss_inquire_cred(G3eGnSeSr)ic Security Services API Library Fungcstsi_oinnsquire_cred(3GSS)
2
3
4

NAME

6       gss_inquire_cred - obtain information about a credential
7

SYNOPSIS

9       cc [ flag... ] file... -lgss [ library... ]
10       #include <gssapi/gssapi.h>
11
12       OM_uint32 gss_inquire_cred(OM_uint32 *minor_status,
13            const gss_cred_id_t cred_handle,gss_name_t *name,
14            OM_uint32 *lifetime, gss_cred_usage_t *cred_usage,
15            gss_OID_set *mechanisms);
16
17

PARAMETERS

19       The parameter descriptions for gss_inquire_cred() follow:
20
21       minor_status    Mechanism specific status code.
22
23
24       cred_handle     Handle  that  refers  to the target credential. Specify
25                       GSS_C_NO_CREDENTIAL to inquire about the  default  ini‐
26                       tiator principal.
27
28
29       name            Name  of  the  identity asserted by the credential. Any
30                       storage associated with this name should  be  freed  by
31                       the    application    after    use   by   a   call   to
32                       gss_release_name(3GSS).
33
34
35       lifetime        Number of seconds  for  which  the  credential  remains
36                       valid.  If  the  credential has expired, this parameter
37                       will be set to zero. Specify NULL if the  parameter  is
38                       not required.
39
40
41       cred_usage      Flag  that  indicates  how  a  credential  is used. The
42                       cred_usage parameter may contain one of  the  following
43                       values:  GSS_C_INITIATE,  GSS_C_ACCEPT,  or GSS_C_BOTH.
44                       Specify NULL if this parameter is not required.
45
46
47       mechanisms      Set of mechanisms supported by the credential.  Storage
48                       for  the returned OID-set must be freed by the applica‐
49                       tion after use by a call to  gss_release_oid_set(3GSS).
50                       Specify NULL if this parameter is not required.
51
52

DESCRIPTION

54       Use  the gss_inquire_cred() function to obtain information about a cre‐
55       dential.
56

RETURN VALUES

58       The gss_inquire_cred() function can return the following status codes:
59
60       GSS_S_COMPLETE                Successful completion.
61
62
63       GSS_S_NO_CRED                 The referenced credentials could  not  be
64                                     accessed.
65
66
67       GSS_S_DEFECTIVE_CREDENTIAL    The referenced credentials were invalid.
68
69
70       GSS_S_CREDENTIALS_EXPIRED     The  referenced credentials have expired.
71                                     If the lifetime parameter was not  passed
72                                     as NULL, it will be set to 0.
73
74
75       GSS_S_FAILURE                 The   underlying  mechanism  detected  an
76                                     error for which no  specific  GSS  status
77                                     code  is  defined. The mechanism-specific
78                                     status code  reported  by  means  of  the
79                                     minor_status  parameter details the error
80                                     condition.
81
82

ATTRIBUTES

84       See attributes(5) for descriptions of the following attributes:
85
86
87
88
89       ┌─────────────────────────────┬─────────────────────────────┐
90       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
91       ├─────────────────────────────┼─────────────────────────────┤
92       │MT-Level                     │Safe                         │
93       └─────────────────────────────┴─────────────────────────────┘
94

SEE ALSO

96       gss_release_name(3GSS),    gss_release_oid_set(3GSS),     libgss(3LIB),
97       attributes(5)
98
99
100       Solaris Security for Developers Guide
101
102
103
104SunOS 5.11                        30 Jan 2004           gss_inquire_cred(3GSS)
Impressum