Generic Security Services API Library Functions
gssgetmic(3GS)
NAME
gssgetmic - calculate a cryptographic message
SYNOPSIS
cc [ flag... ] file... -lgss [ library... ]
#include
OMuint32 gssgetmic(OMuint32 *minorstatus,
const gssctxidt contexthandle, gssqopt qopreq,
const gssbuffert messagebuffer, gssbuffert msgtoken);
DESCRIPTION
The gssgetmic() function generates a cryptographic MIC for
the supplied message, and places the MIC in a token for
transfer to the peer application. The qopreq parameter
allows a choice between several cryptographic algorithms, if
supported by the chosen mechanism.
Since some application-level protocols may wish to use
tokens emitted by gsswrap(3GS) to provide secure framing,
the GS-API allows MICs to be derived from zero-length mes-
sages.
PARAMETERS
The parameter descriptions for gssgetmic() follow:
minorstatus The status code returned by the underlying
mechanism.
contexthandle Identifies the context on which the mes-
sage will be sent.
qopreq Specifies the requested quality of protec-
tion. Callers are encouraged, on portabil-
ity grounds, to accept the default quality
of protection offered by the chosen
mechanism, which may be requested by
specifying GSCQOPDEFAULT for this
parameter. If an unsupported protection
strength is requested, gssgetmic() will
return a majorstatus of GSBADQOP.
messagebuffer The message to be protected.
SunOS 5.11 Last change: 14 Jan 2003 1
Generic Security Services API Library Functions
gssgetmic(3GS)
msgtoken The buffer to receive the token. Storage
associated with this message must be freed
by the application after use with a call
to gssreleasebuffer(3GS).
ERORS
gssgetmic() may return the following status codes:
GSCOMPLETE Successful completion.
GSCONTEXTEXPIRED The context has already expired.
GSNOCONTEXT The contexthandle parameter did
not identify a valid context.
GSBADQOP The specified QOP is not supported
by the mechanism.
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.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 14 Jan 2003 2
Generic Security Services API Library Functions
gssgetmic(3GS)
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWgss (32-bit)
SUNWgssx (64-bit)
MT-Level Safe
SEE ALSO
gssreleasebuffer(3GS), gsswrap(3GS), attributes(5)
Solaris Security for Developers Guide
SunOS 5.11 Last change: 14 Jan 2003 3
Generic Security Services API Library Functions
gssgetmic(3GS)
SunOS 5.11 Last change: 14 Jan 2003 4
|
