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

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



NAME    [Toc]    [Back]

       gss_canonicalize_name - Extract single mechanism name from
       multi-mechanism internal form name

SYNOPSIS    [Toc]    [Back]

       #include <gssapi/gssapi.h>

       OM_uint32 gss_canonicalize_name(
               OM_uint32 * minor_status,
               const gss_name_t input_name,
               const gss_OID mech_type,
               gss_name_t * const output_name );

PARAMETERS    [Toc]    [Back]

       Kerberos 5 error code.  Internal form  name  for  which  a
       canonical form is desired. The application must obtain the
       internal  form  name  beforehand  using  a  call  such  as
       gss_import_name().    Security  mechanism  for  which  the
       canonical form of the name is desired. The mechanism  must
       be  specified  explicitly.  No  default  is provided.  The
       resulting canonical name.  Storage  associated  with  this
       name  must  be  freed  by the application after use with a
       call to gss_release_name().

DESCRIPTION    [Toc]    [Back]

       The gss_canonicalize_name() function reduces  an  internal
       form name that contains elements corresponding to multiple
       security mechanisms, to a  mechanism  name  (MN)  that  is
       mechanism-specific.  This  function is useful for portable
       applications that use multiple security mechanisms.

       The internal name is unaffected. References to the canonical
 name remain valid until it is released, independent of
       whether or not the internal name is released.

       Storage associated with the output_name parameter must  be
       freed  by  the  application  after  use  with  a  call  to

RETURN VALUES    [Toc]    [Back]

       GSS_S_BAD_MECH                  xx01xxxx
       GSS_S_BAD_NAME                  xx02xxxx
       GSS_S_BAD_NAMETYPE              xx03xxxx
       GSS_S_COMPLETE                  00000000
       GSS_S_FAILURE                   xx0Dxxxx

SEE ALSO    [Toc]    [Back]

       Functions:  gss_import_name(3), gss_release_name(3)

[ Back ]
 Similar pages
Name OS Title
resource_int_value FreeBSD get a value from the hints mechanism
capabilities IRIX Capability Mechanism
resource_string_value FreeBSD get a value from the hints mechanism
resource_long_value FreeBSD get a value from the hints mechanism
postwait HP-UX lightweight synchronization mechanism
pw_getukid HP-UX lightweight synchronization mechanism
pw_post HP-UX lightweight synchronization mechanism
pw_postv HP-UX lightweight synchronization mechanism
pw_wait HP-UX lightweight synchronization mechanism
pw_getvmax HP-UX lightweight synchronization mechanism
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service