GSS_DISPLAY_STATUS man page on SmartOS

Man page or keyword search:  
man Server   16655 pages
apropos Keyword Search (all sections)
Output format
SmartOS logo
[printable version]

GSS_DISPLAY_STATUS(3GSS)			      GSS_DISPLAY_STATUS(3GSS)

NAME
       gss_display_status - convert a GSS-API status code to text

SYNOPSIS
       cc [ flag... ] file... -lgss  [ library... ]
       #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);

DESCRIPTION
       The  gss_display_status()  function  enables an application to obtain a
       textual representation of a GSS-API status code for display to the user
       or  for logging purposes.  Because some status values may indicate mul‐
       tiple conditions, applications may need	to  call  gss_display_status()
       multiple times, with each call generating a single text string.

       The  message_context  parameter	is used by gss_acquire_cred() to store
       state information on error messages that are  extracted	from  a	 given
       status_value. The message_context parameter must be initialized to 0 by
       the application prior to the first call, and gss_display_status()  will
       return a non-zero value in this parameter if there are further messages
       to extract.

       The message_context parameter contains all state	 information  required
       by  gss_display_status()	 to  extract  further  messages	 from the sta‐
       tus_value.  If a non-zero value is  returned  in	 this  parameter,  the
       application  is	not required to call gss_display_status() again unless
       subsequent messages are desired.

PARAMETERS
       The parameter descriptions for gss_display_status() follow:

       minor_status
			  Status code returned by the underlying mechanism.

       status_value
			  Status value to be converted.

       status_type
			  If the value is GSS_C_GSS_CODE,  status_value	 is  a
			  GSS-API    status    code.	If    the   value   is
			  GSS_C_MECH_CODE, then status_value  is  a  mechanism
			  status code.

       mech_type
			  Underlying  mechanism	 that  is  used to interpret a
			  minor status value. Supply  GSS_C_NO_OID  to	obtain
			  the system default.

       message_context
			  Should  be  initialized  to  zero prior to the first
			  call. On return from	gss_display_status(),  a  non-
			  zero	status_value  parameter	 indicates  that addi‐
			  tional messages may be  extracted  from  the	status
			  code	by  means  of  subsequent  calls  to  gss_dis‐
			  play_status(), passing the same  status_value,  sta‐
			  tus_type, mech_type, and message_contextparameters.

       status_string
			  Textual  representation of the status_value. Storage
			  associated with this parameter must be freed by  the
			  application	 after	  use	 with	 a   call   to
			  gss_release_buffer(3GSS).

ERRORS
       The gss_display_status()	 function  may	return	the  following	status
       codes:

       GSS_S_COMPLETE
			   Successful completion.

       GSS_S_BAD_MECH
			   Indicates  that  translation	 in accordance with an
			   unsupported mechanism type was requested.

       GSS_S_BAD_STATUS
			   The status value was not recognized, or the	status
			   type	    was	    neither	GSS_C_GSS_CODE	   nor
			   GSS_C_MECH_CODE.

       GSS_S_FAILURE
			   The underlying  mechanism  detected	an  error  for
			   which  no specific GSS status code is defined.  The
			   mechanism-specific status code reported by means of
			   the minor_status parameter details the error condi‐
			   tion.

ATTRIBUTES
       See attributes(5)  for descriptions of the following attributes:

       ┌───────────────┬─────────────────┐
       │ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
       ├───────────────┼─────────────────┤
       │MT-Level       │ Safe		 │
       └───────────────┴─────────────────┘

SEE ALSO
       gss_acquire_cred(3GSS), gss_release_buffer(3GSS), attributes(5)

       Solaris Security for Developers Guide

				 Jan 14, 2003	      GSS_DISPLAY_STATUS(3GSS)
[top]

List of man pages available for SmartOS

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net