Generic Security Services API Library Functions
gssinquirecredbymech(3GS)
NAME
gssinquirecredbymech - obtain per-mechanism information
about a credential
SYNOPSIS
cc [ flag... ] file... -lgss [ library... ]
#include
OMuint32 gssinquirecredbymech(OMuint32 *minorstatus,
const gsscredidt credhandle,const gssOID mechtype,
gssnamet *name, OMuint32 *initiatorlifetime,
OMuint32 *acceptorlifetime, gsscredusaget *credusage);
PARAMETERS
acceptorlifetime The number of seconds that the creden-
tial is capable of accepting security
contexts under the specified mechan-
ism. If the credential can no longer
be used to accept contexts, or if the
credential usage for this mechanism is
GSCINITIATE, this parameter will be
set to 0. Specify NUL if this parame-
ter is not required.
credhandle A handle that refers to the target
credential. Specify
GSCNOCREDENTIAL to inquire about
the default initiator principal.
credusage How the credential may be used with
the specified mechanism. The
credusage parameter may contain one
of the following values:
GSCINITIATE, GSCACEPT, or
GSCBOTH. Specify NUL if this
parameter is not required.
initiatorlifetime The number of seconds that the creden-
tial is capable of initiating security
contexts under the specified mechan-
ism. If the credential can no longer
be used to initiate contexts, or if
the credential usage for this mechan-
ism is GSCACEPT, this parameter
will be set to 0. Specify NUL if this
parameter is not required.
SunOS 5.11 Last change: 15 Aug 2007 1
Generic Security Services API Library Functions
gssinquirecredbymech(3GS)
mechtype The mechanism for which the informa-
tion should be returned.
minorstatus A mechanism specific status code.
name The name whose identity the credential
asserts. Any storage associated with
this name must be freed by the appli-
cation after use by a call to
gssreleasename(3GS).
DESCRIPTION
The gssinquirecredbymech() function obtains per-
mechanism information about a credential.
ERORS
The gssinquirecredbymech() function can return the fol-
lowing status codes:
GSCOMPLETE Successful completion.
GSCREDENTIALSEXPIRED The credentials cannot be
added because they have
expired.
GSDEFECTIVECREDENTIAL The referenced credentials are
invalid.
GSFAILURE The underlying mechanism
detected an error for which no
specific GS status code is
defined. The mechanism-
specific status code reported
by means of the minorstatus
parameter details the error
condition.
GSNOCRED The referenced credentials
cannot be accessed.
GSUNAVAILABLE The gssinquirecredbymech()
function is not available for
the specified mechanism type.
SunOS 5.11 Last change: 15 Aug 2007 2
Generic Security Services API Library Functions
gssinquirecredbymech(3GS)
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWgss (32-bit)
SUNWgssx (64-bit)
MT-Level Safe
SEE ALSO
gssreleasename(3GS), attributes(5)
Solaris Security for Developers Guide
SunOS 5.11 Last change: 15 Aug 2007 3
Generic Security Services API Library Functions
gssinquirecredbymech(3GS)
SunOS 5.11 Last change: 15 Aug 2007 4
|
