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

  man pages->Tru64 Unix man pages -> gss_display_status (3)              



NAME    [Toc]    [Back]

       gss_display_status - Convert GSS-API return codes to text.

SYNOPSIS    [Toc]    [Back]

       #include <gssapi/gssapi.h>

       OM_uint32 gss_display_status(
               OM_uint32 * minor_status,
               OM_uint32 status_value,
               int status_type,
               const gss_OID mech_type,
               OM_uint32 * message_context,
               gss_buffer_t status_string );

PARAMETERS    [Toc]    [Back]

       Kerberos 5 error code.  Status value to  be  converted  to
       text.  GSS_C_GSS_CODE -- GSS-API major status code.

              GSS_C_MECH_CODE  --  Kerberos  5 minor status code.
              Object identifier (OID) of the  security  mechanism
              used  to  interpret  a  minor status value. Specify
              GSS_C_NO_OID to  obtain  the  Kerberos  5  default.
              Output  indicator  for  displaying  multiple status
              codes. Specify zero on the first call to this function.
 If further messages are contained in the status_value
 parameter, this parameter  is  set  to  a
              non-zero value. This parameter must be specified in
              subsequent calls, along with the  same  values  for
              the status_value, status_type, and mech_type parameters.
  Text  interpretation  of  the  status_value
              parameter. All returned strings are terminated with
              a NULL character. The length of  the  status_string
              parameter does not include the NULL.

              The  application must release this buffer after use
              with a call to gss_release_buffer().

DESCRIPTION    [Toc]    [Back]

       The gss_display_status() function returns text representations
  of  GSS-API status codes for display to the user or
       for logging purposes. Since some status codes may indicate
       multiple  errors, applications may need to call this function
 multiple times until the message_context parameter is
       set  to  zero.  Each  call  always  returns  a single text

       Storage associated with the text strings must be freed  by
       the    application    after    use    with   a   call   to

RETURN VALUES    [Toc]    [Back]

       GSS_S_BAD_MECH                  xx01xxxx
       GSS_S_BAD_STATUS                xx05xxxx
       GSS_S_CALL_BAD_STRUCTURE        03xxxxxx
       GSS_S_COMPLETE                  00000000
       GSS_S_FAILURE                   xx0Dxxxx

SEE ALSO    [Toc]    [Back]

       Functions:  gss_release_buffer(3)

[ Back ]
 Similar pages
Name OS Title
mvGetErrno IRIX return information for Movie Library error codes
DTsbtoa IRIX convert six-bit country and owner codes to ASCII string
CDsbtoa IRIX convert six-bit country and owner codes to ASCII string
acl_to_text FreeBSD convert an ACL to text
pr Linux convert text files for printing
gss_import_name Tru64 Convert text name to internal form name.
mac_to_text FreeBSD convert MAC label to/from text representation
mac_from_text FreeBSD convert MAC label to/from text representation
mac_text FreeBSD convert MAC label to/from text representation
pod2text OpenBSD Convert POD data to formatted ASCII text
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service