NAME    [Toc]    [Back]

       gss_export_name  - Produce a contiguous string representation
 of a mechanism name.

SYNOPSIS    [Toc]    [Back]

       #include <gssapi/gssapi.h>

       OM_uint32 gss_export_name(
               OM_uint32 * minor_status,
               const gss_name_t input_name,
               gss_buffer_t exported_name );

PARAMETERS    [Toc]    [Back]

       Kerberos  5  error  code.   Mechanism  name  (MN)  to   be
       exported.   The  contiguous  string  form of the mechanism
       name.

              Storage associated with this string must  be  freed
              by     the     application     after    use    with
              gss_release_buffer().

DESCRIPTION    [Toc]    [Back]

       The  gss_export_name()  function  produces  a   contiguous
       string  representation of a mechanism name. The input_name
       parameter must specify a valid MN (that  is,  an  internal
       form  name  generated  by  gss_accept_sec_context()  or by
       gss_canonicalize_name()). The gss_import_name()  call  may
       also  be  used  since the HP Application Security SDK supports
 a single mechanism -- Kerberos 5.

       The exported name may be used for direct comparisons  such
       as with memcmp in authorization functions such as matching
       entries in an access-control list. An exported name can be
       imported using the gss_import_name() call.

       Storage associated with this name must freed by the application
 after use with gss_release_buffer().

RETURN VALUES    [Toc]    [Back]

       GSS_S_BAD_NAME                  xx02xxxx
       GSS_S_BAD_NAMETYPE              xx03xxxx
       GSS_S_CALL_INACCESSIBLE_READ    01xxxxxx
       GSS_S_CALL_INACCESSIBLE_WRITE   02xxxxxx
       GSS_S_COMPLETE                  00000000
       GSS_S_FAILURE                   xx0Dxxxx
       GSS_S_NAME_NOT_MN               xx12xxxx

SEE ALSO    [Toc]    [Back]

       Functions:  gss_accept_sec_context(3),      gss_canonicalize_name(3), gss_import_name(3), gss_release_buffer(3)



                                               gss_export_name(3)