gss_display_status(3)gss_display_status(3)NAMEgss_display_status() - provide an application with the textual repre‐
sentation of a GSSAPI status code that can be displayed to a user or
used for logging
SYNOPSISDESCRIPTION
The routine provides the context initiator with a textual representa‐
tion of a status code so that the application can display the message
to a user or log the message. Because some status values can indicate
more than one error, the routine enables the calling application to
process status codes with multiple messages.
The message_context parameter indicates which error message the appli‐
cation should extract from the status_value parameter. The first time
an application calls the routine, it should initialize the message_con‐
text parameter to 0 (zero) and return the first message. If there are
additional messages to read, the routine returns a nonzero value. The
application can call repeatedly to generate a single text string for
each call.
Input Parameters
status_value Specifies the status value to convert.
status_type Specifies one of the following status types:
Major status - GSS status code
Minor status - mechanism status code eg. Kerberos
mech_type Specifies the underlying security mechanism. Sup‐
ply to obtain the system default.
Input/Output
message_context Indicates whether the status code has multiple
messages to read. The first time an application
calls the routine, you initialize the parameter
to 0 (zero). The routine returns the first mes‐
sage. If there are more messages, the routine
sets the parameter to a nonzero value. The
application calls the routine repeatedly to get
the next message, until the message_context
parameter is zero again.
Output
status_string Returns the status value as a text message.
minor_status Returns a status code from the security mecha‐
nism.
STATUS CODES
The following status codes can be returned:
The routine was completed successfully.
The translation requires a mechanism that is unsupported
or unavailable.
Indicates either the status value was not recognized or
the status type was something other than or
The routine failed. Check the
minor_status for details.
AUTHOR
was developed by Sun Microsystems, Inc.
SEE ALSO
The manpages for DCE-GSSAPI are included with the DCE-CoreTools prod‐
uct. To see those manpages add to
gss_display_status(3)