name forms

git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@24789 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
Love Hörnquist Åstrand
2009-02-22 23:27:18 +00:00
parent 72dcbd8bbe
commit 0db289777b

View File

@@ -38,9 +38,30 @@
/**
* @page internalVSmechname Internal names and mechanism names
* @section api_INvsMN Kerberos 5 API Overview
* @section api_INvsMN Name forms
*
* Describe relationship between import_name, canonicalize_name, export_name and friends.
* There are two forms of name in GSS-API, Internal form and
* Contiguous string ("flat") form. gss_export_name() and
* gss_import_name() can be used to convert between the two forms.
*
* - The contiguous string form is described by an oid specificing the
* type and an octet string. A special form of the contiguous
* string form is the exported name object. The exported name
* defined for each mechanism, is something that can be stored and
* complared later. The exported name is what should be used for
* ACLs comparisons.
*
* - The Internal form
*
* There is also special form of the Internal Name (IN), and that is
* the Mechanism Name (MN). In the mechanism name all the generic
* information is stripped of and only contain the information for
* one mechanism. In GSS-API some function return MN and some
* require MN as input. Each of these function is marked up as such.
*
*
* Describe relationship between import_name, canonicalize_name,
* export_name and friends.
*/
/** @defgroup gssapi Heimdal GSS-API functions */