Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

gss_display_status(3)					 gss_display_status(3)

NAME
       gss_display_status()  -	provide an application with the textual repre‐
       sentation of a GSSAPI status code that can be displayed to  a  user  or
       used for logging

SYNOPSIS

DESCRIPTION
       The  routine  provides the context initiator with a textual representa‐
       tion 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 appli‐
       cation should extract from the status_value parameter.  The first  time
       an application calls the routine, it should initialize the message_con‐
       text parameter to 0 (zero) and return the first message.	 If there  are
       additional  messages  to read, the routine returns a nonzero value. The
       application can call 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:
			     Major status - GSS status code

			     Minor status - mechanism status code eg. Kerberos

       mech_type	     Specifies the underlying security mechanism. Sup‐
			     ply 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 mes‐
			     sage.  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	mecha‐
			     nism.

STATUS CODES
       The following status codes can be returned:

       The routine was completed successfully.

       The translation requires a mechanism that is unsupported
				or unavailable.

       Indicates either the status value was not recognized or
				the status type was something other than or

       The routine failed.  Check the
				minor_status for details.

AUTHOR
       was developed by Sun Microsystems, Inc.

SEE ALSO
       The  manpages  for DCE-GSSAPI are included with the DCE-CoreTools prod‐
       uct.  To see those manpages add to

							 gss_display_status(3)

Vote for polarhome