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> 31 Functions</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> 458 Generated 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
Indexes created Sat Jun 06 00:24:59 UTC 2026