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>hx509 printing functions</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="header"> 23 <div class="summary"> 24<a href="#func-members">Functions</a> </div> 25 <div class="headertitle"> 26<div class="title">hx509 printing functions</div> </div> 27</div><!--header--> 28<div class="contents"> 29<table class="memberdecls"> 30<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a> 31Functions</h2></td></tr> 32<tr class="memitem:gae27c328d203e88c87cf81b6eb1d1fe66"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#gae27c328d203e88c87cf81b6eb1d1fe66">hx509_print_stdout</a> (void *ctx, const char *fmt, va_list va)</td></tr> 33<tr class="separator:gae27c328d203e88c87cf81b6eb1d1fe66"><td class="memSeparator" colspan="2"> </td></tr> 34<tr class="memitem:gac116d19332498d183eb055452d682d81"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#gac116d19332498d183eb055452d682d81">hx509_oid_sprint</a> (const heim_oid *oid, char **str)</td></tr> 35<tr class="separator:gac116d19332498d183eb055452d682d81"><td class="memSeparator" colspan="2"> </td></tr> 36<tr class="memitem:ga984e34629525e8c301b237c158c34d23"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#ga984e34629525e8c301b237c158c34d23">hx509_oid_print</a> (const heim_oid *oid, hx509_vprint_func func, void *ctx)</td></tr> 37<tr class="separator:ga984e34629525e8c301b237c158c34d23"><td class="memSeparator" colspan="2"> </td></tr> 38<tr class="memitem:ga274370b840dec6de699577e3d203e6b2"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#ga274370b840dec6de699577e3d203e6b2">hx509_bitstring_print</a> (const heim_bit_string *b, hx509_vprint_func func, void *ctx)</td></tr> 39<tr class="separator:ga274370b840dec6de699577e3d203e6b2"><td class="memSeparator" colspan="2"> </td></tr> 40<tr class="memitem:gaafcf2f11a60a1f9b6ccabaacef0e697f"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#gaafcf2f11a60a1f9b6ccabaacef0e697f">hx509_cert_keyusage_print</a> (hx509_context context, hx509_cert c, char **s)</td></tr> 41<tr class="separator:gaafcf2f11a60a1f9b6ccabaacef0e697f"><td class="memSeparator" colspan="2"> </td></tr> 42<tr class="memitem:ga582e93c29a1becbe5c2ac1ac758e09f4"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#ga582e93c29a1becbe5c2ac1ac758e09f4">hx509_validate_ctx_init</a> (hx509_context context, hx509_validate_ctx *ctx)</td></tr> 43<tr class="separator:ga582e93c29a1becbe5c2ac1ac758e09f4"><td class="memSeparator" colspan="2"> </td></tr> 44<tr class="memitem:ga2fab228a24716340f368fa729b5722b1"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#ga2fab228a24716340f368fa729b5722b1">hx509_validate_ctx_set_print</a> (hx509_validate_ctx ctx, hx509_vprint_func func, void *c)</td></tr> 45<tr class="separator:ga2fab228a24716340f368fa729b5722b1"><td class="memSeparator" colspan="2"> </td></tr> 46<tr class="memitem:gadfc4c934e63c8c7b10661520de70411e"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#gadfc4c934e63c8c7b10661520de70411e">hx509_validate_ctx_add_flags</a> (hx509_validate_ctx ctx, int flags)</td></tr> 47<tr class="separator:gadfc4c934e63c8c7b10661520de70411e"><td class="memSeparator" colspan="2"> </td></tr> 48<tr class="memitem:ga72409ecab29eec94cc0215ed21ecca8e"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#ga72409ecab29eec94cc0215ed21ecca8e">hx509_validate_ctx_free</a> (hx509_validate_ctx ctx)</td></tr> 49<tr class="separator:ga72409ecab29eec94cc0215ed21ecca8e"><td class="memSeparator" colspan="2"> </td></tr> 50<tr class="memitem:ga5e3ded9ba5c466a2c6f80b9d233b69c3"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__hx509__print.html#ga5e3ded9ba5c466a2c6f80b9d233b69c3">hx509_validate_cert</a> (hx509_context context, hx509_validate_ctx ctx, hx509_cert cert)</td></tr> 51<tr class="separator:ga5e3ded9ba5c466a2c6f80b9d233b69c3"><td class="memSeparator" colspan="2"> </td></tr> 52</table> 53<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> 54<h2 class="groupheader">Function Documentation</h2> 55<a id="ga274370b840dec6de699577e3d203e6b2"></a> 56<h2 class="memtitle"><span class="permalink"><a href="#ga274370b840dec6de699577e3d203e6b2">◆ </a></span>hx509_bitstring_print()</h2> 57 58<div class="memitem"> 59<div class="memproto"> 60 <table class="memname"> 61 <tr> 62 <td class="memname">void hx509_bitstring_print </td> 63 <td>(</td> 64 <td class="paramtype">const heim_bit_string * </td> 65 <td class="paramname"><em>b</em>, </td> 66 </tr> 67 <tr> 68 <td class="paramkey"></td> 69 <td></td> 70 <td class="paramtype">hx509_vprint_func </td> 71 <td class="paramname"><em>func</em>, </td> 72 </tr> 73 <tr> 74 <td class="paramkey"></td> 75 <td></td> 76 <td class="paramtype">void * </td> 77 <td class="paramname"><em>ctx</em> </td> 78 </tr> 79 <tr> 80 <td></td> 81 <td>)</td> 82 <td></td><td></td> 83 </tr> 84 </table> 85</div><div class="memdoc"> 86<p>Print a bitstring using a hx509_vprint_func function. To print to stdout use <a class="el" href="group__hx509__print.html#gae27c328d203e88c87cf81b6eb1d1fe66">hx509_print_stdout()</a>.</p> 87<dl class="params"><dt>Parameters</dt><dd> 88 <table class="params"> 89 <tr><td class="paramname">b</td><td>bit string to print. </td></tr> 90 <tr><td class="paramname">func</td><td>hx509_vprint_func to print with. </td></tr> 91 <tr><td class="paramname">ctx</td><td>context variable to hx509_vprint_func function. </td></tr> 92 </table> 93 </dd> 94</dl> 95 96</div> 97</div> 98<a id="gaafcf2f11a60a1f9b6ccabaacef0e697f"></a> 99<h2 class="memtitle"><span class="permalink"><a href="#gaafcf2f11a60a1f9b6ccabaacef0e697f">◆ </a></span>hx509_cert_keyusage_print()</h2> 100 101<div class="memitem"> 102<div class="memproto"> 103 <table class="memname"> 104 <tr> 105 <td class="memname">int hx509_cert_keyusage_print </td> 106 <td>(</td> 107 <td class="paramtype">hx509_context </td> 108 <td class="paramname"><em>context</em>, </td> 109 </tr> 110 <tr> 111 <td class="paramkey"></td> 112 <td></td> 113 <td class="paramtype">hx509_cert </td> 114 <td class="paramname"><em>c</em>, </td> 115 </tr> 116 <tr> 117 <td class="paramkey"></td> 118 <td></td> 119 <td class="paramtype">char ** </td> 120 <td class="paramname"><em>s</em> </td> 121 </tr> 122 <tr> 123 <td></td> 124 <td>)</td> 125 <td></td><td></td> 126 </tr> 127 </table> 128</div><div class="memdoc"> 129<p>Print certificate usage for a certificate to a string.</p> 130<dl class="params"><dt>Parameters</dt><dd> 131 <table class="params"> 132 <tr><td class="paramname">context</td><td>A hx509 context. </td></tr> 133 <tr><td class="paramname">c</td><td>a certificate print the keyusage for. </td></tr> 134 <tr><td class="paramname">s</td><td>the return string with the keysage printed in to, free with <a class="el" href="group__hx509__misc.html#gaba6d3eb6abde539a3191269f785e3e61">hx509_xfree()</a>.</td></tr> 135 </table> 136 </dd> 137</dl> 138<dl class="section return"><dt>Returns</dt><dd>An hx509 error code, see <a class="el" href="group__hx509__error.html#ga15791abff76719acb531223fdcbcac87">hx509_get_error_string()</a>. </dd></dl> 139 140</div> 141</div> 142<a id="ga984e34629525e8c301b237c158c34d23"></a> 143<h2 class="memtitle"><span class="permalink"><a href="#ga984e34629525e8c301b237c158c34d23">◆ </a></span>hx509_oid_print()</h2> 144 145<div class="memitem"> 146<div class="memproto"> 147 <table class="memname"> 148 <tr> 149 <td class="memname">void hx509_oid_print </td> 150 <td>(</td> 151 <td class="paramtype">const heim_oid * </td> 152 <td class="paramname"><em>oid</em>, </td> 153 </tr> 154 <tr> 155 <td class="paramkey"></td> 156 <td></td> 157 <td class="paramtype">hx509_vprint_func </td> 158 <td class="paramname"><em>func</em>, </td> 159 </tr> 160 <tr> 161 <td class="paramkey"></td> 162 <td></td> 163 <td class="paramtype">void * </td> 164 <td class="paramname"><em>ctx</em> </td> 165 </tr> 166 <tr> 167 <td></td> 168 <td>)</td> 169 <td></td><td></td> 170 </tr> 171 </table> 172</div><div class="memdoc"> 173<p>Print a oid using a hx509_vprint_func function. To print to stdout use <a class="el" href="group__hx509__print.html#gae27c328d203e88c87cf81b6eb1d1fe66">hx509_print_stdout()</a>.</p> 174<dl class="params"><dt>Parameters</dt><dd> 175 <table class="params"> 176 <tr><td class="paramname">oid</td><td>oid to print </td></tr> 177 <tr><td class="paramname">func</td><td>hx509_vprint_func to print with. </td></tr> 178 <tr><td class="paramname">ctx</td><td>context variable to hx509_vprint_func function. </td></tr> 179 </table> 180 </dd> 181</dl> 182 183</div> 184</div> 185<a id="gac116d19332498d183eb055452d682d81"></a> 186<h2 class="memtitle"><span class="permalink"><a href="#gac116d19332498d183eb055452d682d81">◆ </a></span>hx509_oid_sprint()</h2> 187 188<div class="memitem"> 189<div class="memproto"> 190 <table class="memname"> 191 <tr> 192 <td class="memname">int hx509_oid_sprint </td> 193 <td>(</td> 194 <td class="paramtype">const heim_oid * </td> 195 <td class="paramname"><em>oid</em>, </td> 196 </tr> 197 <tr> 198 <td class="paramkey"></td> 199 <td></td> 200 <td class="paramtype">char ** </td> 201 <td class="paramname"><em>str</em> </td> 202 </tr> 203 <tr> 204 <td></td> 205 <td>)</td> 206 <td></td><td></td> 207 </tr> 208 </table> 209</div><div class="memdoc"> 210<p>Print a oid to a string.</p> 211<dl class="params"><dt>Parameters</dt><dd> 212 <table class="params"> 213 <tr><td class="paramname">oid</td><td>oid to print </td></tr> 214 <tr><td class="paramname">str</td><td>allocated string, free with <a class="el" href="group__hx509__misc.html#gaba6d3eb6abde539a3191269f785e3e61">hx509_xfree()</a>.</td></tr> 215 </table> 216 </dd> 217</dl> 218<dl class="section return"><dt>Returns</dt><dd>An hx509 error code, see <a class="el" href="group__hx509__error.html#ga15791abff76719acb531223fdcbcac87">hx509_get_error_string()</a>. </dd></dl> 219 220</div> 221</div> 222<a id="gae27c328d203e88c87cf81b6eb1d1fe66"></a> 223<h2 class="memtitle"><span class="permalink"><a href="#gae27c328d203e88c87cf81b6eb1d1fe66">◆ </a></span>hx509_print_stdout()</h2> 224 225<div class="memitem"> 226<div class="memproto"> 227 <table class="memname"> 228 <tr> 229 <td class="memname">void hx509_print_stdout </td> 230 <td>(</td> 231 <td class="paramtype">void * </td> 232 <td class="paramname"><em>ctx</em>, </td> 233 </tr> 234 <tr> 235 <td class="paramkey"></td> 236 <td></td> 237 <td class="paramtype">const char * </td> 238 <td class="paramname"><em>fmt</em>, </td> 239 </tr> 240 <tr> 241 <td class="paramkey"></td> 242 <td></td> 243 <td class="paramtype">va_list </td> 244 <td class="paramname"><em>va</em> </td> 245 </tr> 246 <tr> 247 <td></td> 248 <td>)</td> 249 <td></td><td></td> 250 </tr> 251 </table> 252</div><div class="memdoc"> 253<p>Helper function to print on stdout for:</p><ul> 254<li><a class="el" href="group__hx509__print.html#ga984e34629525e8c301b237c158c34d23">hx509_oid_print()</a>,</li> 255<li><a class="el" href="group__hx509__print.html#ga274370b840dec6de699577e3d203e6b2">hx509_bitstring_print()</a>,</li> 256<li><a class="el" href="group__hx509__print.html#ga2fab228a24716340f368fa729b5722b1">hx509_validate_ctx_set_print()</a>.</li> 257</ul> 258<dl class="params"><dt>Parameters</dt><dd> 259 <table class="params"> 260 <tr><td class="paramname">ctx</td><td>the context to the print function. If the ctx is NULL, stdout is used. </td></tr> 261 <tr><td class="paramname">fmt</td><td>the printing format. </td></tr> 262 <tr><td class="paramname">va</td><td>the argumet list. </td></tr> 263 </table> 264 </dd> 265</dl> 266 267</div> 268</div> 269<a id="ga5e3ded9ba5c466a2c6f80b9d233b69c3"></a> 270<h2 class="memtitle"><span class="permalink"><a href="#ga5e3ded9ba5c466a2c6f80b9d233b69c3">◆ </a></span>hx509_validate_cert()</h2> 271 272<div class="memitem"> 273<div class="memproto"> 274 <table class="memname"> 275 <tr> 276 <td class="memname">int hx509_validate_cert </td> 277 <td>(</td> 278 <td class="paramtype">hx509_context </td> 279 <td class="paramname"><em>context</em>, </td> 280 </tr> 281 <tr> 282 <td class="paramkey"></td> 283 <td></td> 284 <td class="paramtype">hx509_validate_ctx </td> 285 <td class="paramname"><em>ctx</em>, </td> 286 </tr> 287 <tr> 288 <td class="paramkey"></td> 289 <td></td> 290 <td class="paramtype">hx509_cert </td> 291 <td class="paramname"><em>cert</em> </td> 292 </tr> 293 <tr> 294 <td></td> 295 <td>)</td> 296 <td></td><td></td> 297 </tr> 298 </table> 299</div><div class="memdoc"> 300<p>Validate/Print the status of the certificate.</p> 301<dl class="params"><dt>Parameters</dt><dd> 302 <table class="params"> 303 <tr><td class="paramname">context</td><td>A hx509 context. </td></tr> 304 <tr><td class="paramname">ctx</td><td>A hx509 validation context. </td></tr> 305 <tr><td class="paramname">cert</td><td>the cerificate to validate/print.</td></tr> 306 </table> 307 </dd> 308</dl> 309<dl class="section return"><dt>Returns</dt><dd>An hx509 error code, see <a class="el" href="group__hx509__error.html#ga15791abff76719acb531223fdcbcac87">hx509_get_error_string()</a>. </dd></dl> 310 311</div> 312</div> 313<a id="gadfc4c934e63c8c7b10661520de70411e"></a> 314<h2 class="memtitle"><span class="permalink"><a href="#gadfc4c934e63c8c7b10661520de70411e">◆ </a></span>hx509_validate_ctx_add_flags()</h2> 315 316<div class="memitem"> 317<div class="memproto"> 318 <table class="memname"> 319 <tr> 320 <td class="memname">void hx509_validate_ctx_add_flags </td> 321 <td>(</td> 322 <td class="paramtype">hx509_validate_ctx </td> 323 <td class="paramname"><em>ctx</em>, </td> 324 </tr> 325 <tr> 326 <td class="paramkey"></td> 327 <td></td> 328 <td class="paramtype">int </td> 329 <td class="paramname"><em>flags</em> </td> 330 </tr> 331 <tr> 332 <td></td> 333 <td>)</td> 334 <td></td><td></td> 335 </tr> 336 </table> 337</div><div class="memdoc"> 338<p>Add flags to control the behaivor of the <a class="el" href="group__hx509__print.html#ga5e3ded9ba5c466a2c6f80b9d233b69c3">hx509_validate_cert()</a> function.</p> 339<dl class="params"><dt>Parameters</dt><dd> 340 <table class="params"> 341 <tr><td class="paramname">ctx</td><td>A hx509 validation context. </td></tr> 342 <tr><td class="paramname">flags</td><td>flags to add to the validation context.</td></tr> 343 </table> 344 </dd> 345</dl> 346<dl class="section return"><dt>Returns</dt><dd>An hx509 error code, see <a class="el" href="group__hx509__error.html#ga15791abff76719acb531223fdcbcac87">hx509_get_error_string()</a>. </dd></dl> 347 348</div> 349</div> 350<a id="ga72409ecab29eec94cc0215ed21ecca8e"></a> 351<h2 class="memtitle"><span class="permalink"><a href="#ga72409ecab29eec94cc0215ed21ecca8e">◆ </a></span>hx509_validate_ctx_free()</h2> 352 353<div class="memitem"> 354<div class="memproto"> 355 <table class="memname"> 356 <tr> 357 <td class="memname">void hx509_validate_ctx_free </td> 358 <td>(</td> 359 <td class="paramtype">hx509_validate_ctx </td> 360 <td class="paramname"><em>ctx</em></td><td>)</td> 361 <td></td> 362 </tr> 363 </table> 364</div><div class="memdoc"> 365<p>Free an hx509 validate context.</p> 366<dl class="params"><dt>Parameters</dt><dd> 367 <table class="params"> 368 <tr><td class="paramname">ctx</td><td>the hx509 validate context to free. </td></tr> 369 </table> 370 </dd> 371</dl> 372 373</div> 374</div> 375<a id="ga582e93c29a1becbe5c2ac1ac758e09f4"></a> 376<h2 class="memtitle"><span class="permalink"><a href="#ga582e93c29a1becbe5c2ac1ac758e09f4">◆ </a></span>hx509_validate_ctx_init()</h2> 377 378<div class="memitem"> 379<div class="memproto"> 380 <table class="memname"> 381 <tr> 382 <td class="memname">int hx509_validate_ctx_init </td> 383 <td>(</td> 384 <td class="paramtype">hx509_context </td> 385 <td class="paramname"><em>context</em>, </td> 386 </tr> 387 <tr> 388 <td class="paramkey"></td> 389 <td></td> 390 <td class="paramtype">hx509_validate_ctx * </td> 391 <td class="paramname"><em>ctx</em> </td> 392 </tr> 393 <tr> 394 <td></td> 395 <td>)</td> 396 <td></td><td></td> 397 </tr> 398 </table> 399</div><div class="memdoc"> 400<p>Allocate a hx509 validation/printing context.</p> 401<dl class="params"><dt>Parameters</dt><dd> 402 <table class="params"> 403 <tr><td class="paramname">context</td><td>A hx509 context. </td></tr> 404 <tr><td class="paramname">ctx</td><td>a new allocated hx509 validation context, free with <a class="el" href="group__hx509__print.html#ga72409ecab29eec94cc0215ed21ecca8e">hx509_validate_ctx_free()</a>.</td></tr> 405 </table> 406 </dd> 407</dl> 408<dl class="section return"><dt>Returns</dt><dd>An hx509 error code, see <a class="el" href="group__hx509__error.html#ga15791abff76719acb531223fdcbcac87">hx509_get_error_string()</a>. </dd></dl> 409 410</div> 411</div> 412<a id="ga2fab228a24716340f368fa729b5722b1"></a> 413<h2 class="memtitle"><span class="permalink"><a href="#ga2fab228a24716340f368fa729b5722b1">◆ </a></span>hx509_validate_ctx_set_print()</h2> 414 415<div class="memitem"> 416<div class="memproto"> 417 <table class="memname"> 418 <tr> 419 <td class="memname">void hx509_validate_ctx_set_print </td> 420 <td>(</td> 421 <td class="paramtype">hx509_validate_ctx </td> 422 <td class="paramname"><em>ctx</em>, </td> 423 </tr> 424 <tr> 425 <td class="paramkey"></td> 426 <td></td> 427 <td class="paramtype">hx509_vprint_func </td> 428 <td class="paramname"><em>func</em>, </td> 429 </tr> 430 <tr> 431 <td class="paramkey"></td> 432 <td></td> 433 <td class="paramtype">void * </td> 434 <td class="paramname"><em>c</em> </td> 435 </tr> 436 <tr> 437 <td></td> 438 <td>)</td> 439 <td></td><td></td> 440 </tr> 441 </table> 442</div><div class="memdoc"> 443<p>Set the printing functions for the validation context.</p> 444<dl class="params"><dt>Parameters</dt><dd> 445 <table class="params"> 446 <tr><td class="paramname">ctx</td><td>a hx509 valication context. </td></tr> 447 <tr><td class="paramname">func</td><td>the printing function to usea. </td></tr> 448 <tr><td class="paramname">c</td><td>the context variable to the printing function.</td></tr> 449 </table> 450 </dd> 451</dl> 452<dl class="section return"><dt>Returns</dt><dd>An hx509 error code, see <a class="el" href="group__hx509__error.html#ga15791abff76719acb531223fdcbcac87">hx509_get_error_string()</a>. </dd></dl> 453 454</div> 455</div> 456</div><!-- contents --> 457<hr size="1"><address style="text-align: right;"><small> 458Generated on Tue Nov 15 2022 14:04:25 for Heimdal x509 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> 459</body> 460</html> 461
