HP-UX Reference (11i v1 00/12) - 3 Library Functions A-M (vol 6)

__________________________________________________________________________________________________________________________________________________________________________________________________
__________________________________________________________________________________________________________________________________________________________________________________________________
STANDARD Printed by: Nora Chuang [nchuang] STANDARD
/build/1111/BRICK/man3/!!!intro.3c
________________________________________________________________
___ ___
g
gss_display_status(3) gss_display_status(3)
NAME
gss_display_status() - provide an application with the textual representation of a GSSAPI status code that
can be displayed to a user or used for logging
SYNOPSIS
#include <gssapi.h>
OM_uint32 gss_display_status (
OM_uint32 *minor_status,
int status_value,
int status_type,
const gss_OID mech_type,
int *message_context,
gss_buffer_t status_string)
DESCRIPTION
The gss_display_status( ) routine provides the context initiator with a textual representation 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 application should extract from the
status_value parameter. The first time an application calls the routine, it should initialize the
message_context parameter to 0 (zero) and return the first message. If there are additional messages to
read, the gss_display_status( )
routine returns a nonzero value. The application can call
gss_display_status( )
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:
GSS_C_GSS_CODE Major status - GSS status code
GSS_C_MECH_CODE Minor status - mechanism status code eg. Kerberos
mech_type Specifies the underlying security mechanism. Supply
GSS_C_NULL_OID
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 message. If there are more messages, the routine sets the parame-
ter 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 mechanism.
STATUS CODES
The following status codes can be returned:
GSS_S_COMPLETE The routine was completed successfully.
GSS_S_BAD_MECH The translation requires a mechanism that is unsupported or unavailable.
GSS_S_BAD_STATUS Indicates either the status value was not recognized or the status type was some-
thing other than GSS_C_GSS_CODE or GSS_C_MECH_CODE.
GSS_S_FAILURE The routine failed. Check the minor_status for details.
AUTHOR
gss_display_status() was developed by Sun Microsystems, Inc.
Section 3−−392 − 1 − HP-UX Release 11i: December 2000
___
___