Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

gss_display_name(3) [debian man page]

gss_display_name(3)							gss						       gss_display_name(3)

NAME

       gss_display_name - API function

SYNOPSIS

       #include <gss.h>

       OM_uint32  gss_display_name(OM_uint32  *  minor_status,	const  gss_name_t  input_name,	gss_buffer_t  output_name_buffer,  gss_OID  * out-
       put_name_type);

ARGUMENTS

       OM_uint32 * minor_status
		   (Integer, modify) Mechanism specific status code.

       const gss_name_t input_name
		   (gss_name_t, read) Name to be displayed.

       gss_buffer_t output_name_buffer
		   (buffer, character-string, modify) Buffer to
		     receive textual name string.  The application must free storage
		     associated with this name after use with a call to
		     gss_release_buffer().

       gss_OID * output_name_type
		   (Object ID, modify, optional) 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 not required.

DESCRIPTION

       Allows an application to obtain a textual representation of an opaque internal-form name for display purposes.  The syntax of  a  printable
       name is defined by the GSS-API implementation.

       If  input_name  denotes	an  anonymous  principal,  the	implementation	should	return	the  gss_OID  value GSS_C_NT_ANONYMOUS as the out-
       put_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, specifying GSS_C_NO_OID as the name-type, implementations that employ lazy  conver-
       sion between name types may return GSS_C_NO_OID via the output_name_type parameter.

RETURN VALUE

       `GSS_S_COMPLETE`: Successful completion.

       `GSS_S_BAD_NAME`: input_name was ill-formed.

REPORTING BUGS

       Report  bugs  to  <bug-gss@gnu.org>.  GNU Generic Security Service home page: http://www.gnu.org/software/gss/ General help using GNU soft-
       ware: http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright (C) 2003-2011 Simon Josefsson.
       Copying and distribution of this file, with or without modification, are permitted in any medium without  royalty  provided  the  copyright
       notice and this notice are preserved.

SEE ALSO

       The  full  documentation  for gss is maintained as a Texinfo manual.  If the info and gss programs are properly installed at your site, the
       command

	      info gss

       should give you access to the complete manual.

gss								       1.0.2						       gss_display_name(3)

Check Out this Related Man Page

gss_import_name(3)							gss							gss_import_name(3)

NAME

       gss_import_name - API function

SYNOPSIS

       #include <gss.h>

       OM_uint32  gss_import_name(OM_uint32 * minor_status, const gss_buffer_t input_name_buffer, const gss_OID input_name_type, gss_name_t * out-
       put_name);

ARGUMENTS

       OM_uint32 * minor_status
		   (Integer, modify) Mechanism specific status code.

       const gss_buffer_t input_name_buffer
		   (buffer, octet-string, read) Buffer containing
		     contiguous string name to convert.

       const gss_OID input_name_type
		   (Object ID, read, optional) Object ID specifying
		     type of printable name.  Applications may specify either
		     GSS_C_NO_OID to use a mechanism-specific default printable
		     syntax, or an OID recognized by the GSS-API implementation to
		     name a specific namespace.

       gss_name_t * output_name
		   (gss_name_t, modify) Returned name in internal form.
		     Storage associated with this name must be freed by the
		     application after use with a call to gss_release_name().

DESCRIPTION

       Convert a contiguous string name to internal form.  In general, the internal name returned (via the output_name parameter) will not  be	an
       MN; the exception to this is if the input_name_type indicates that the contiguous string provided via the input_name_buffer parameter is of
       type GSS_C_NT_EXPORT_NAME, in which case the returned internal name will be an MN for the mechanism that exported the name.

RETURN VALUE

       `GSS_S_COMPLETE`: Successful completion.

       `GSS_S_BAD_NAMETYPE`: The input_name_type was unrecognized.

       `GSS_S_BAD_NAME`: The input_name parameter could not be interpreted as a name of the specified type.

       `GSS_S_BAD_MECH`: The input name-type was GSS_C_NT_EXPORT_NAME, but the mechanism contained within the input-name is not supported.

REPORTING BUGS

       Report bugs to <bug-gss@gnu.org>.  GNU Generic Security Service home page: http://www.gnu.org/software/gss/ General help  using	GNU  soft-
       ware: http://www.gnu.org/gethelp/

COPYRIGHT

       Copyright (C) 2003-2011 Simon Josefsson.
       Copying	and  distribution  of  this file, with or without modification, are permitted in any medium without royalty provided the copyright
       notice and this notice are preserved.

SEE ALSO

       The full documentation for gss is maintained as a Texinfo manual.  If the info and gss programs are properly installed at  your	site,  the
       command

	      info gss

       should give you access to the complete manual.

gss								       1.0.2							gss_import_name(3)
Man Page