Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > G

gss_display_status(3)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

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 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 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 something 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.

SEE ALSO

The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add /opt/dce/share/man to MANPATH.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.