gss_display_name man page on OpenIndiana

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

gss_display_nameGeneric Security Services API Library Fugss_display_name(3GSS)

NAME
       gss_display_name - convert internal-form name to text

SYNOPSIS
       cc [flag ...]  file... -lgss [library ...]
       #include <gssapi/gssapi.h>

       OM_uint32 gss_display_name(OM_uint32 *minor_status,
	    const gss_name_t input_name, gss_buffer_t output_name_buffer,
	    gss_OID *output_name_type);

DESCRIPTION
       The  gss_display_name() function allows an application to obtain a tex‐
       tual representation of an opaque internal-form  name for	 display  pur‐
       poses.

       If  input_name  denotes an anonymous principal, the GSS-API returns the
       gss_OID value GSS_C_NT_ANONYMOUS as the output_name_type, and a textual
       name  that is syntactically distinct from all valid supported printable
       names in output_name_buffer.

       If input_name was created by a call to gss_import_name(3GSS),  specify‐
       ing  GSS_C_NO_OID as the name-type, the GSS-API returns GSS_C_NO_OID by
       means of the output_name_type parameter.

PARAMETERS
       The parameter descriptions for gss_display_name() follow:

       minor_status	     Mechanism-specific status code.

       input_name	     Name in internal form.

       output_name_buffer    Buffer to receive textual name string. The appli‐
			     cation  must  free	 storage  associated with this
			     name after use with a  call  to  gss_release_buf‐
			     fer(3GSS).

       output_name_type	     The  type	of  the	 returned  name.  The returned
			     gss_OID will be a pointer into static storage and
			     should  be treated as read-only by the caller. In
			     particular, the application should not attempt to
			     free  it.	Specify	 NULL if this parameter is not
			     required.

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

       GSS_S_COMPLETE	 Successful completion.

       GSS_S_BAD_NAME	 The input_name was ill-formed.

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

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

       ┌─────────────────────────────┬─────────────────────────────────────┐
       │      ATTRIBUTE TYPE	     │		ATTRIBUTE VALUE		   │
       ├─────────────────────────────┼─────────────────────────────────────┤
       │Availability		     │system/library/security/gss (32-bit) │
       ├─────────────────────────────┼─────────────────────────────────────┤
       │			     │SUNWgssx (64-bit)			   │
       ├─────────────────────────────┼─────────────────────────────────────┤
       │MT-Level		     │Safe				   │
       └─────────────────────────────┴─────────────────────────────────────┘

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

       Solaris Security for Developers Guide

SunOS 5.11			  14 Jan 2003		gss_display_name(3GSS)
[top]

List of man pages available for OpenIndiana

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