Manual Pages for UNIX Operating System command usage for man gss_canonicalize_name

Generic Security Services API Library Functions
                                      gss_canonicalize_name(3GSS)



NAME
     gss_canonicalize_name  -  convert  an  internal  name  to  a
     mechanism name

SYNOPSIS
     cc [flag ...] file... -lgss [library ...]
     #include 

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


DESCRIPTION
     The gss_canonicalize_name() function generates  a  canonical
     mechanism name from an arbitrary internal name.  The mechan-
     ism name is the name that would be  returned  to  a  context
     acceptor on successful authentication of a context where the
     initiator used  the  input_name  in  a  successful  call  to
     gss_acquire_cred(3GSS),  specifying  an  OID  set containing
     mech_type  as  its  only  member,  followed  by  a  call  to
     gss_init_sec_context(3GSS),   specifying  mech_type  as  the
     authentication mechanism.

PARAMETERS
     The parameter descriptions for gss_canonicalize_name()  fol-
     low:

     minor_status    Mechanism-specific status code.


     input_name      The name  for  which  a  canonical  form  is
                     desired.


     mech_type       The authentication mechanism for  which  the
                     canonical  form of the name is desired.  The
                     desired mechanism must be  specified  expli-
                     citly; no default is provided.


     output_name     The resultant canonical name.  Storage asso-
                     ciated  with  this name must be freed by the
                     application  after  use  with  a   call   to
                     gss_release_name(3GSS).


ERRORS
     The gss_canonicalize_name() function may return  the  status
     codes:




SunOS 5.11          Last change: 14 Jan 2003                    1






Generic Security Services API Library Functions
                                      gss_canonicalize_name(3GSS)



     GSS_S_COMPLETE        Successful completion.


     GSS_S_BAD_MECH        The identified mechanism is  not  sup-
                           ported.


     GSS_S_BAD_NAMETYPE    The provided internal name contains no
                           elements  that  could  be processed by
                           the specified mechanism.


     GSS_S_BAD_NAME        The provided internal  name  was  ill-
                           formed.


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


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



     ____________________________________________________________________
    |       ATTRIBUTE TYPE        |           ATTRIBUTE VALUE           |
    |_____________________________|_____________________________________|
    | Availability                | system/library/security/gss (32-bit)|
    |_____________________________|_____________________________________|
    |                             | SUNWgssx (64-bit)                   |
    |_____________________________|_____________________________________|
    | MT-Level                    | Safe                                |
    |_____________________________|_____________________________________|


SEE ALSO
     gss_acquire_cred(3GSS),          gss_init_sec_context(3GSS),
     gss_release_name(3GSS), attributes(5)


     Oracle Solaris Security for Developers Guide







SunOS 5.11          Last change: 14 Jan 2003                    2






Generic Security Services API Library Functions
                                      gss_canonicalize_name(3GSS)






















































SunOS 5.11          Last change: 14 Jan 2003                    3