Debian Codegraph @

doc/reference/html/gss-ext.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>ext: GNU Generic Security Service (GSS) API Reference Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
7 <link rel="home" href="index.html" title="GNU Generic Security Service (GSS) API Reference Manual">
8 <link rel="up" href="intro.html" title="GNU Generic Security Service (GSS) API Reference Manual">
9 <link rel="prev" href="gss-api.html" title="api">
10 <link rel="next" href="gss-krb5.html" title="krb5">
11 <meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts">
17 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18 <a href="#gss-ext.description" class="shortcut">Description</a></span>
19 </td>
20 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
21 <td><a accesskey="u" href="intro.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
22 <td><a accesskey="p" href="gss-api.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
23 <td><a accesskey="n" href="gss-krb5.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
24 </tr></table>
25 <div class="refentry">
26 <a name="gss-ext"></a><div class="titlepage"></div>
27 <div class="refnamediv"><table width="100%"><tr>
28 <td valign="top">
29 <h2><span class="refentrytitle"><a name="gss-ext.top_of_page"></a>ext</span></h2>
30 <p>ext</p>
31 </td>
32 <td class="gallery_image" valign="top" align="right"></td>
33 </tr></table></div>
34 <div class="refsect1">
35 <a name="gss-ext.functions"></a><h2>Functions</h2>
36 <div class="informaltable"><table class="informaltable" width="100%" border="0">
37 <colgroup>
38 <col width="150px" class="functions_proto_type">
39 <col class="functions_proto_name">
40 </colgroup>
41 <tbody>
42 <tr>
43 <td class="function_type">const <span class="returnvalue">char</span> *
44 </td>
45 <td class="function_name">
46 <a class="link" href="gss-ext.html#gss-check-version" title="gss_check_version ()">gss_check_version</a> <span class="c_punctuation">()</span>
47 </td>
48 </tr>
49 <tr>
50 <td class="function_type">
51 <span class="returnvalue">int</span>
52 </td>
53 <td class="function_name">
54 <a class="link" href="gss-ext.html#gss-userok" title="gss_userok ()">gss_userok</a> <span class="c_punctuation">()</span>
55 </td>
56 </tr>
57 </tbody>
58 </table></div>
59 </div>
60 <div class="refsect1">
61 <a name="gss-ext.other"></a><h2>Types and Values</h2>
62 <div class="informaltable"><table class="informaltable" width="100%" border="0">
63 <colgroup>
64 <col width="150px" class="other_proto_type">
65 <col class="other_proto_name">
66 </colgroup>
67 <tbody>
68 <tr>
69 <td class="variable_type">extern gss_OID_desc </td>
70 <td class="function_name"><a class="link" href="gss-ext.html#GSS-C-NT-USER-NAME-static" title="GSS_C_NT_USER_NAME_static">GSS_C_NT_USER_NAME_static</a></td>
71 </tr>
72 <tr>
73 <td class="variable_type">extern gss_OID_desc </td>
74 <td class="function_name"><a class="link" href="gss-ext.html#GSS-C-NT-MACHINE-UID-NAME-static" title="GSS_C_NT_MACHINE_UID_NAME_static">GSS_C_NT_MACHINE_UID_NAME_static</a></td>
75 </tr>
76 <tr>
77 <td class="variable_type">extern gss_OID_desc </td>
78 <td class="function_name"><a class="link" href="gss-ext.html#GSS-C-NT-STRING-UID-NAME-static" title="GSS_C_NT_STRING_UID_NAME_static">GSS_C_NT_STRING_UID_NAME_static</a></td>
79 </tr>
80 <tr>
81 <td class="variable_type">extern gss_OID_desc </td>
82 <td class="function_name"><a class="link" href="gss-ext.html#GSS-C-NT-HOSTBASED-SERVICE-X-static" title="GSS_C_NT_HOSTBASED_SERVICE_X_static">GSS_C_NT_HOSTBASED_SERVICE_X_static</a></td>
83 </tr>
84 <tr>
85 <td class="variable_type">extern gss_OID_desc </td>
86 <td class="function_name"><a class="link" href="gss-ext.html#GSS-C-NT-HOSTBASED-SERVICE-static" title="GSS_C_NT_HOSTBASED_SERVICE_static">GSS_C_NT_HOSTBASED_SERVICE_static</a></td>
87 </tr>
88 <tr>
89 <td class="variable_type">extern gss_OID_desc </td>
90 <td class="function_name"><a class="link" href="gss-ext.html#GSS-C-NT-ANONYMOUS-static" title="GSS_C_NT_ANONYMOUS_static">GSS_C_NT_ANONYMOUS_static</a></td>
91 </tr>
92 <tr>
93 <td class="variable_type">extern gss_OID_desc </td>
94 <td class="function_name"><a class="link" href="gss-ext.html#GSS-C-NT-EXPORT-NAME-static" title="GSS_C_NT_EXPORT_NAME_static">GSS_C_NT_EXPORT_NAME_static</a></td>
95 </tr>
96 </tbody>
97 </table></div>
98 </div>
99 <div class="refsect1">
100 <a name="gss-ext.description"></a><h2>Description</h2>
101 </div>
102 <div class="refsect1">
103 <a name="gss-ext.functions_details"></a><h2>Functions</h2>
104 <div class="refsect2">
105 <a name="gss-check-version"></a><h3>gss_check_version ()</h3>
106 <pre class="programlisting">const <span class="returnvalue">char</span> *
107 gss_check_version (<em class="parameter"><code>const <span class="type">char</span> *req_version</code></em>);</pre>
108 <p>Check that the version of the library is at minimum the one
109 given as a string in <em class="parameter"><code>req_version</code></em>
110 .</p>
111 <p>WARNING: This function is a GNU GSS specific extension, and is not
112 part of the official GSS API.</p>
113 <div class="refsect3">
114 <a name="gss-check-version.parameters"></a><h4>Parameters</h4>
115 <div class="informaltable"><table class="informaltable" width="100%" border="0">
116 <colgroup>
117 <col width="150px" class="parameters_name">
118 <col class="parameters_description">
119 <col width="200px" class="parameters_annotations">
120 </colgroup>
121 <tbody><tr>
122 <td class="parameter_name"><p>req_version</p></td>
123 <td class="parameter_description"><p>version string to compare with, or NULL</p></td>
124 <td class="parameter_annotations"> </td>
125 </tr></tbody>
126 </table></div>
127 </div>
128 <div class="refsect3">
129 <a name="gss-check-version.returns"></a><h4>Returns</h4>
130 <p> The actual version string of the library; NULL if the
131 condition is not met. If NULL is passed to this function no
132 check is done and only the version string is returned.</p>
133 </div>
134 </div>
135 <hr>
136 <div class="refsect2">
137 <a name="gss-userok"></a><h3>gss_userok ()</h3>
138 <pre class="programlisting"><span class="returnvalue">int</span>
139 gss_userok (<em class="parameter"><code>const <a class="link" href="gss-api.html#gss-name-t" title="gss_name_t"><span class="type">gss_name_t</span></a> name</code></em>,
140 <em class="parameter"><code>const <span class="type">char</span> *username</code></em>);</pre>
141 <p>Compare the username against the output from <a class="link" href="gss-api.html#gss-export-name" title="gss_export_name ()"><code class="function">gss_export_name()</code></a>
142 invoked on <em class="parameter"><code>name</code></em>
143 , after removing the leading OID. This answers the
144 question whether the particular mechanism would authenticate them
145 as the same principal</p>
146 <p>WARNING: This function is a GNU GSS specific extension, and is not
147 part of the official GSS API.</p>
148 <div class="refsect3">
149 <a name="gss-userok.parameters"></a><h4>Parameters</h4>
150 <div class="informaltable"><table class="informaltable" width="100%" border="0">
151 <colgroup>
152 <col width="150px" class="parameters_name">
153 <col class="parameters_description">
154 <col width="200px" class="parameters_annotations">
155 </colgroup>
156 <tbody>
157 <tr>
158 <td class="parameter_name"><p>name</p></td>
159 <td class="parameter_description"><p>(gss_name_t, read) Name to be compared.</p></td>
160 <td class="parameter_annotations"> </td>
161 </tr>
162 <tr>
163 <td class="parameter_name"><p>username</p></td>
164 <td class="parameter_description"><p>Zero terminated string with username.</p></td>
165 <td class="parameter_annotations"> </td>
166 </tr>
167 </tbody>
168 </table></div>
169 </div>
170 <div class="refsect3">
171 <a name="gss-userok.returns"></a><h4>Returns</h4>
172 <p> Returns 0 if the names match, non-0 otherwise.</p>
173 </div>
174 </div>
175 </div>
176 <div class="refsect1">
177 <a name="gss-ext.other_details"></a><h2>Types and Values</h2>
178 <div class="refsect2">
179 <a name="GSS-C-NT-USER-NAME-static"></a><h3>GSS_C_NT_USER_NAME_static</h3>
180 <pre class="programlisting">extern gss_OID_desc GSS_C_NT_USER_NAME_static;
181 </pre>
182 </div>
183 <hr>
184 <div class="refsect2">
185 <a name="GSS-C-NT-MACHINE-UID-NAME-static"></a><h3>GSS_C_NT_MACHINE_UID_NAME_static</h3>
186 <pre class="programlisting">extern gss_OID_desc GSS_C_NT_MACHINE_UID_NAME_static;
187 </pre>
188 </div>
189 <hr>
190 <div class="refsect2">
191 <a name="GSS-C-NT-STRING-UID-NAME-static"></a><h3>GSS_C_NT_STRING_UID_NAME_static</h3>
192 <pre class="programlisting">extern gss_OID_desc GSS_C_NT_STRING_UID_NAME_static;
193 </pre>
194 </div>
195 <hr>
196 <div class="refsect2">
197 <a name="GSS-C-NT-HOSTBASED-SERVICE-X-static"></a><h3>GSS_C_NT_HOSTBASED_SERVICE_X_static</h3>
198 <pre class="programlisting">extern gss_OID_desc GSS_C_NT_HOSTBASED_SERVICE_X_static;
199 </pre>
200 </div>
201 <hr>
202 <div class="refsect2">
203 <a name="GSS-C-NT-HOSTBASED-SERVICE-static"></a><h3>GSS_C_NT_HOSTBASED_SERVICE_static</h3>
204 <pre class="programlisting">extern gss_OID_desc GSS_C_NT_HOSTBASED_SERVICE_static;
205 </pre>
206 </div>
207 <hr>
208 <div class="refsect2">
209 <a name="GSS-C-NT-ANONYMOUS-static"></a><h3>GSS_C_NT_ANONYMOUS_static</h3>
210 <pre class="programlisting">extern gss_OID_desc GSS_C_NT_ANONYMOUS_static;
211 </pre>
212 </div>
213 <hr>
214 <div class="refsect2">
215 <a name="GSS-C-NT-EXPORT-NAME-static"></a><h3>GSS_C_NT_EXPORT_NAME_static</h3>
216 <pre class="programlisting">extern gss_OID_desc GSS_C_NT_EXPORT_NAME_static;
217 </pre>
218 </div>
219 </div>
220 </div>
221 <div class="footer">
222 <hr>Generated by GTK-Doc V1.33.1</div>
223 </body>
224 </html>