*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->HP-UX 11i man pages -> gss_display_status (3)              


 gss_display_status(3)                                 gss_display_status(3)

 NAME    [Toc]    [Back]
      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    [Toc]    [Back]
      #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    [Toc]    [Back]
      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    [Toc]    [Back]
      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

      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

 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003

 gss_display_status(3)                                 gss_display_status(3)

                            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    [Toc]    [Back]
      status_string         Returns the status value as a text message.

      minor_status          Returns a status code from the security

 STATUS CODES    [Toc]    [Back]
      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    [Toc]    [Back]
      gss_display_status() was developed by Sun Microsystems, Inc.

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

 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003
[ Back ]
 Similar pages
Name OS Title
gss_display_name HP-UX provide textual representation of an opaque internal name to an application
tt_status_message HP-UX provide a message for a problem status code
acl_from_text Tru64 Converts the textual representation of an ACL to an internal representation
libgss HP-UX shared library for GSSAPI (Generic Security Service Application Programming Interface)
DtActionCallbackProc HP-UX notify application that the status of an application has changed
EvmStatusTextGet Tru64 Formats text version of EVM status code
gss_inquire_cred HP-UX provide the calling application information about a credential
gss_inquire_cred_by_mech HP-UX provide the calling application permechanism information about a credential
sact Tru64 Displays current Source Code Control System (SCCS) file editing status
gss_release_name HP-UX free storage associated with an internal name allocated by a GSSAPI routine
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service