Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HP-UX Reference > G

gss_canonicalize_name(3)

HP-UX 11i Version 3: February 2007
» 

Technical documentation

» Feedback
Content starts here

 » Table of Contents

 » Index

NAME

gss_canonicalize_name() — convert an internal name to an internal mechanism name (MN) representation of an opaque internal name

SYNOPSIS

#include <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 *output_name)

DESCRIPTION

The gss_canonicalize_name() routine generate a canonical mechanism name (MN) from an arbitrary internal name. The mechanism 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(), specifying an Object Identifier (OID) set containing mech_type as its only member, followed by a call to gss_init_sec_context(), specifying mech_type as the authentication mechanism.

Input Parameters

input_name

Specifies 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 explicitly; no default is provided.

Output Parameters

output_name

The resultant canonical name.

minor_status

Returns a status code from the security mechanism.

STATUS CODES

The following status codes can be returned:

GSS_S_COMPLETE

The routine was completed successfully.

GSS_S_BAD_MECH

The identified mechanism is not supported.

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 routine failed. Check the minor_status parameter for details.

AUTHOR

gss_canonicalize_name() was developed by Sun Microsystems, Inc.

SEE ALSO

gss_compare_name(3), gss_import_name(3), gss_release_name(3).

The manpages for DCE-GSSAPI are included with the DCE-CoreTools product. To see those manpages add /opt/dce/share/man to MANPATH.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 1983-2007 Hewlett-Packard Development Company, L.P.