1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"> 3<title>Internal names and mechanism names</title> 4<link href="doxygen.css" rel="stylesheet" type="text/css"> 5<link href="tabs.css" rel="stylesheet" type="text/css"> 6</head><body> 7<p> 8<a href="http://www.h5l.org/"><img src="http://www.h5l.org/keyhole-heimdal.png" alt="keyhole logo"/></a> 9</p> 10<!-- end of header marker --> 11<!-- Generated by Doxygen 1.9.1 --> 12<script type="text/javascript" src="menudata.js"></script> 13<script type="text/javascript" src="menu.js"></script> 14<script type="text/javascript"> 15/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */ 16$(function() { 17 initMenu('',false,false,'search.php','Search'); 18}); 19/* @license-end */</script> 20<div id="main-nav"></div> 21</div><!-- top --> 22<div class="PageDoc"><div class="header"> 23 <div class="headertitle"> 24<div class="title">Internal names and mechanism names </div> </div> 25</div><!--header--> 26<div class="contents"> 27<div class="textblock"><h1><a class="anchor" id="gssapi_api_INvsMN"></a> 28Name forms</h1> 29<p>There are two name representations in GSS-API: Internal form and Contiguous string ("flat") form. Functions <a class="el" href="group__gssapi.html#ga353814c7de38c9e2894ca66f0c15c8eb">gss_export_name()</a> and <a class="el" href="group__gssapi.html#ga0afe06fd5264ebfb93ecca4bcc70895b">gss_import_name()</a> can be used to convert between the two forms.</p> 30<ul> 31<li>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 compared later. The exported name is what should be used for ACLs comparisons.</li> 32<li>The Internal form is opaque to the application programmer and is implementation-dependent.</li> 33<li>There is also a 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.</li> 34</ul> 35<p>@FIXME Describe relationship between import_name, canonicalize_name, export_name and friends. Also, update for RFC2743 language ("contiguous" and "flat" are gone, leaving just "exported name 36token", "internal", and "MN"). </p> 37</div></div><!-- contents --> 38</div><!-- PageDoc --> 39<hr size="1"><address style="text-align: right;"><small> 40Generated on Tue Nov 15 2022 14:04:25 for Heimdal GSS-API library by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.9.1</small></address> 41</body> 42</html> 43
