1226031Sstas<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2226031Sstas<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"> 3226031Sstas<title>HeimdalKerberos5library: Heimdal Kerberos 5 credential handing functions</title> 4226031Sstas<link href="doxygen.css" rel="stylesheet" type="text/css"> 5226031Sstas<link href="tabs.css" rel="stylesheet" type="text/css"> 6226031Sstas</head><body> 7226031Sstas<p> 8226031Sstas<a href="http://www.h5l.org/"><img src="http://www.h5l.org/keyhole-heimdal.png" alt="keyhole logo"/></a> 9226031Sstas</p> 10226031Sstas<!-- end of header marker --> 11226031Sstas<!-- Generated by Doxygen 1.5.6 --> 12226031Sstas<div class="navigation" id="top"> 13226031Sstas <div class="tabs"> 14226031Sstas <ul> 15226031Sstas <li><a href="index.html"><span>Main Page</span></a></li> 16226031Sstas <li><a href="pages.html"><span>Related Pages</span></a></li> 17226031Sstas <li><a href="modules.html"><span>Modules</span></a></li> 18226031Sstas <li><a href="annotated.html"><span>Data Structures</span></a></li> 19226031Sstas </ul> 20226031Sstas </div> 21226031Sstas</div> 22226031Sstas<div class="contents"> 23226031Sstas<h1>Heimdal Kerberos 5 credential handing functions</h1><table border="0" cellpadding="0" cellspacing="0"> 24226031Sstas<tr><td></td></tr> 25226031Sstas<tr><td colspan="2"><br><h2>Functions</h2></td></tr> 26226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 27226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g7335efb74572151bb521c367c39b7a4a">krb5_fwd_tgt_creds</a> (krb5_context context, krb5_auth_context auth_context, const char *hostname, krb5_principal client, krb5_principal server, krb5_ccache ccache, int forwardable, krb5_data *out_data)</td></tr> 28226031Sstas 29226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 30226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g6429a273ae5ed0d9333a22f5b5f1f42a">krb5_get_forwarded_creds</a> (krb5_context context, krb5_auth_context auth_context, krb5_ccache ccache, krb5_flags flags, const char *hostname, krb5_creds *in_creds, krb5_data *out_data)</td></tr> 31226031Sstas 32226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 33226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#gbc0922393cb5c5eecec2d83f1851c21b">krb5_get_init_creds_opt_alloc</a> (krb5_context context, krb5_get_init_creds_opt **opt)</td></tr> 34226031Sstas 35226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION void <br> 36226031SstasKRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g2be2f013c88153be9535c17a2b16f336">krb5_get_init_creds_opt_free</a> (krb5_context context, krb5_get_init_creds_opt *opt)</td></tr> 37226031Sstas 38226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 39226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g1a610bb2706e4048e8220225da110033">krb5_init_creds_init</a> (krb5_context context, krb5_principal client, krb5_prompter_fct prompter, void *prompter_data, krb5_deltat start_time, krb5_get_init_creds_opt *options, krb5_init_creds_context *rctx)</td></tr> 40226031Sstas 41226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 42226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g71f386b20c42540d4e733eeb7c0cb18e">krb5_init_creds_set_service</a> (krb5_context context, krb5_init_creds_context ctx, const char *service)</td></tr> 43226031Sstas 44226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 45226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g0a1d093a3c43b57b5e84206e73441d68">krb5_init_creds_set_password</a> (krb5_context context, krb5_init_creds_context ctx, const char *password)</td></tr> 46226031Sstas 47226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 48226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#gb80179f38c8cc87627752d5db22c8203">krb5_init_creds_set_keytab</a> (krb5_context context, krb5_init_creds_context ctx, krb5_keytab keytab)</td></tr> 49226031Sstas 50226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 51226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g9b1f54a05b9e7b60bef0c7d5f40b351b">krb5_init_creds_step</a> (krb5_context context, krb5_init_creds_context ctx, krb5_data *in, krb5_data *out, krb5_krbhst_info *hostinfo, unsigned int *flags)</td></tr> 52226031Sstas 53226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 54226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#gb5b9ab4698f5af99c06dbcc015c39e27">krb5_init_creds_get_error</a> (krb5_context context, krb5_init_creds_context ctx, KRB_ERROR *error)</td></tr> 55226031Sstas 56226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION void <br> 57226031SstasKRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#gf878f5715a3048995f175c09e95a3a71">krb5_init_creds_free</a> (krb5_context context, krb5_init_creds_context ctx)</td></tr> 58226031Sstas 59226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 60226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#gb1716df7cb25ebea9bbf652094970bce">krb5_init_creds_get</a> (krb5_context context, krb5_init_creds_context ctx)</td></tr> 61226031Sstas 62226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 63226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#ge7e4852f19e7f83bd743952491d1f4b1">krb5_get_init_creds_password</a> (krb5_context context, krb5_creds *creds, krb5_principal client, const char *password, krb5_prompter_fct prompter, void *data, krb5_deltat start_time, const char *in_tkt_service, krb5_get_init_creds_opt *options)</td></tr> 64226031Sstas 65226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 66226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g32573c317cca5198b04550d753b369a1">krb5_get_init_creds_keyblock</a> (krb5_context context, krb5_creds *creds, krb5_principal client, krb5_keyblock *keyblock, krb5_deltat start_time, const char *in_tkt_service, krb5_get_init_creds_opt *options)</td></tr> 67226031Sstas 68226031Sstas<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 69226031Sstaskrb5_error_code KRB5_LIB_CALL </td><td class="memItemRight" valign="bottom"><a class="el" href="group__krb5__credential.html#g83e4a8a74b08522bd778c2d59ef1f2b6">krb5_get_init_creds_keytab</a> (krb5_context context, krb5_creds *creds, krb5_principal client, krb5_keytab keytab, krb5_deltat start_time, const char *in_tkt_service, krb5_get_init_creds_opt *options)</td></tr> 70226031Sstas 71226031Sstas</table> 72226031Sstas<hr><a name="_details"></a><h2>Detailed Description</h2> 73226031Sstas<hr><h2>Function Documentation</h2> 74226031Sstas<a class="anchor" name="g7335efb74572151bb521c367c39b7a4a"></a><!-- doxytag: member="get_for_creds.c::krb5_fwd_tgt_creds" ref="g7335efb74572151bb521c367c39b7a4a" args="(krb5_context context, krb5_auth_context auth_context, const char *hostname, krb5_principal client, krb5_principal server, krb5_ccache ccache, int forwardable, krb5_data *out_data)" --> 75226031Sstas<div class="memitem"> 76226031Sstas<div class="memproto"> 77226031Sstas <table class="memname"> 78226031Sstas <tr> 79226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_fwd_tgt_creds </td> 80226031Sstas <td>(</td> 81226031Sstas <td class="paramtype">krb5_context </td> 82226031Sstas <td class="paramname"> <em>context</em>, </td> 83226031Sstas </tr> 84226031Sstas <tr> 85226031Sstas <td class="paramkey"></td> 86226031Sstas <td></td> 87226031Sstas <td class="paramtype">krb5_auth_context </td> 88226031Sstas <td class="paramname"> <em>auth_context</em>, </td> 89226031Sstas </tr> 90226031Sstas <tr> 91226031Sstas <td class="paramkey"></td> 92226031Sstas <td></td> 93226031Sstas <td class="paramtype">const char * </td> 94226031Sstas <td class="paramname"> <em>hostname</em>, </td> 95226031Sstas </tr> 96226031Sstas <tr> 97226031Sstas <td class="paramkey"></td> 98226031Sstas <td></td> 99226031Sstas <td class="paramtype">krb5_principal </td> 100226031Sstas <td class="paramname"> <em>client</em>, </td> 101226031Sstas </tr> 102226031Sstas <tr> 103226031Sstas <td class="paramkey"></td> 104226031Sstas <td></td> 105226031Sstas <td class="paramtype">krb5_principal </td> 106226031Sstas <td class="paramname"> <em>server</em>, </td> 107226031Sstas </tr> 108226031Sstas <tr> 109226031Sstas <td class="paramkey"></td> 110226031Sstas <td></td> 111226031Sstas <td class="paramtype">krb5_ccache </td> 112226031Sstas <td class="paramname"> <em>ccache</em>, </td> 113226031Sstas </tr> 114226031Sstas <tr> 115226031Sstas <td class="paramkey"></td> 116226031Sstas <td></td> 117226031Sstas <td class="paramtype">int </td> 118226031Sstas <td class="paramname"> <em>forwardable</em>, </td> 119226031Sstas </tr> 120226031Sstas <tr> 121226031Sstas <td class="paramkey"></td> 122226031Sstas <td></td> 123226031Sstas <td class="paramtype">krb5_data * </td> 124226031Sstas <td class="paramname"> <em>out_data</em></td><td> </td> 125226031Sstas </tr> 126226031Sstas <tr> 127226031Sstas <td></td> 128226031Sstas <td>)</td> 129226031Sstas <td></td><td></td><td></td> 130226031Sstas </tr> 131226031Sstas </table> 132226031Sstas</div> 133226031Sstas<div class="memdoc"> 134226031Sstas 135226031Sstas<p> 136226031SstasForward credentials for client to host hostname , making them forwardable if forwardable, and returning the blob of data to sent in out_data. If hostname == NULL, pick it from server.<p> 137226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 138226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 139226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A kerberos 5 context. </td></tr> 140226031Sstas <tr><td valign="top"></td><td valign="top"><em>auth_context</em> </td><td>the auth context with the key to encrypt the out_data. </td></tr> 141226031Sstas <tr><td valign="top"></td><td valign="top"><em>hostname</em> </td><td>the host to forward the tickets too. </td></tr> 142226031Sstas <tr><td valign="top"></td><td valign="top"><em>client</em> </td><td>the client to delegate from. </td></tr> 143226031Sstas <tr><td valign="top"></td><td valign="top"><em>server</em> </td><td>the server to delegate the credential too. </td></tr> 144226031Sstas <tr><td valign="top"></td><td valign="top"><em>ccache</em> </td><td>credential cache to use. </td></tr> 145226031Sstas <tr><td valign="top"></td><td valign="top"><em>forwardable</em> </td><td>make the forwarded ticket forwabledable. </td></tr> 146226031Sstas <tr><td valign="top"></td><td valign="top"><em>out_data</em> </td><td>the resulting credential.</td></tr> 147226031Sstas </table> 148226031Sstas</dl> 149226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>Return an error code or 0. </dd></dl> 150226031Sstas 151226031Sstas</div> 152226031Sstas</div><p> 153226031Sstas<a class="anchor" name="g6429a273ae5ed0d9333a22f5b5f1f42a"></a><!-- doxytag: member="get_for_creds.c::krb5_get_forwarded_creds" ref="g6429a273ae5ed0d9333a22f5b5f1f42a" args="(krb5_context context, krb5_auth_context auth_context, krb5_ccache ccache, krb5_flags flags, const char *hostname, krb5_creds *in_creds, krb5_data *out_data)" --> 154226031Sstas<div class="memitem"> 155226031Sstas<div class="memproto"> 156226031Sstas <table class="memname"> 157226031Sstas <tr> 158226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_forwarded_creds </td> 159226031Sstas <td>(</td> 160226031Sstas <td class="paramtype">krb5_context </td> 161226031Sstas <td class="paramname"> <em>context</em>, </td> 162226031Sstas </tr> 163226031Sstas <tr> 164226031Sstas <td class="paramkey"></td> 165226031Sstas <td></td> 166226031Sstas <td class="paramtype">krb5_auth_context </td> 167226031Sstas <td class="paramname"> <em>auth_context</em>, </td> 168226031Sstas </tr> 169226031Sstas <tr> 170226031Sstas <td class="paramkey"></td> 171226031Sstas <td></td> 172226031Sstas <td class="paramtype">krb5_ccache </td> 173226031Sstas <td class="paramname"> <em>ccache</em>, </td> 174226031Sstas </tr> 175226031Sstas <tr> 176226031Sstas <td class="paramkey"></td> 177226031Sstas <td></td> 178226031Sstas <td class="paramtype">krb5_flags </td> 179226031Sstas <td class="paramname"> <em>flags</em>, </td> 180226031Sstas </tr> 181226031Sstas <tr> 182226031Sstas <td class="paramkey"></td> 183226031Sstas <td></td> 184226031Sstas <td class="paramtype">const char * </td> 185226031Sstas <td class="paramname"> <em>hostname</em>, </td> 186226031Sstas </tr> 187226031Sstas <tr> 188226031Sstas <td class="paramkey"></td> 189226031Sstas <td></td> 190226031Sstas <td class="paramtype">krb5_creds * </td> 191226031Sstas <td class="paramname"> <em>in_creds</em>, </td> 192226031Sstas </tr> 193226031Sstas <tr> 194226031Sstas <td class="paramkey"></td> 195226031Sstas <td></td> 196226031Sstas <td class="paramtype">krb5_data * </td> 197226031Sstas <td class="paramname"> <em>out_data</em></td><td> </td> 198226031Sstas </tr> 199226031Sstas <tr> 200226031Sstas <td></td> 201226031Sstas <td>)</td> 202226031Sstas <td></td><td></td><td></td> 203226031Sstas </tr> 204226031Sstas </table> 205226031Sstas</div> 206226031Sstas<div class="memdoc"> 207226031Sstas 208226031Sstas<p> 209226031SstasGets tickets forwarded to hostname. If the tickets that are forwarded are address-less, the forwarded tickets will also be address-less.<p> 210226031SstasIf the ticket have any address, hostname will be used for figure out the address to forward the ticket too. This since this might use DNS, its insecure and also doesn't represent configured all addresses of the host. For example, the host might have two adresses, one IPv4 and one IPv6 address where the later is not published in DNS. This IPv6 address might be used communications and thus the resulting ticket useless.<p> 211226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 212226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 213226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A kerberos 5 context. </td></tr> 214226031Sstas <tr><td valign="top"></td><td valign="top"><em>auth_context</em> </td><td>the auth context with the key to encrypt the out_data. </td></tr> 215226031Sstas <tr><td valign="top"></td><td valign="top"><em>ccache</em> </td><td>credential cache to use </td></tr> 216226031Sstas <tr><td valign="top"></td><td valign="top"><em>flags</em> </td><td>the flags to control the resulting ticket flags </td></tr> 217226031Sstas <tr><td valign="top"></td><td valign="top"><em>hostname</em> </td><td>the host to forward the tickets too. </td></tr> 218226031Sstas <tr><td valign="top"></td><td valign="top"><em>in_creds</em> </td><td>the in client and server ticket names. The client and server components forwarded to the remote host. </td></tr> 219226031Sstas <tr><td valign="top"></td><td valign="top"><em>out_data</em> </td><td>the resulting credential.</td></tr> 220226031Sstas </table> 221226031Sstas</dl> 222226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>Return an error code or 0. </dd></dl> 223226031Sstas 224226031Sstas<p> 225226031SstasSome older of the MIT gssapi library used clear-text tickets (warped inside AP-REQ encryption), use the krb5_auth_context flag KRB5_AUTH_CONTEXT_CLEAR_FORWARDED_CRED to support those tickets. The session key is used otherwise to encrypt the forwarded ticket. 226226031Sstas</div> 227226031Sstas</div><p> 228226031Sstas<a class="anchor" name="g32573c317cca5198b04550d753b369a1"></a><!-- doxytag: member="init_creds_pw.c::krb5_get_init_creds_keyblock" ref="g32573c317cca5198b04550d753b369a1" args="(krb5_context context, krb5_creds *creds, krb5_principal client, krb5_keyblock *keyblock, krb5_deltat start_time, const char *in_tkt_service, krb5_get_init_creds_opt *options)" --> 229226031Sstas<div class="memitem"> 230226031Sstas<div class="memproto"> 231226031Sstas <table class="memname"> 232226031Sstas <tr> 233226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_keyblock </td> 234226031Sstas <td>(</td> 235226031Sstas <td class="paramtype">krb5_context </td> 236226031Sstas <td class="paramname"> <em>context</em>, </td> 237226031Sstas </tr> 238226031Sstas <tr> 239226031Sstas <td class="paramkey"></td> 240226031Sstas <td></td> 241226031Sstas <td class="paramtype">krb5_creds * </td> 242226031Sstas <td class="paramname"> <em>creds</em>, </td> 243226031Sstas </tr> 244226031Sstas <tr> 245226031Sstas <td class="paramkey"></td> 246226031Sstas <td></td> 247226031Sstas <td class="paramtype">krb5_principal </td> 248226031Sstas <td class="paramname"> <em>client</em>, </td> 249226031Sstas </tr> 250226031Sstas <tr> 251226031Sstas <td class="paramkey"></td> 252226031Sstas <td></td> 253226031Sstas <td class="paramtype">krb5_keyblock * </td> 254226031Sstas <td class="paramname"> <em>keyblock</em>, </td> 255226031Sstas </tr> 256226031Sstas <tr> 257226031Sstas <td class="paramkey"></td> 258226031Sstas <td></td> 259226031Sstas <td class="paramtype">krb5_deltat </td> 260226031Sstas <td class="paramname"> <em>start_time</em>, </td> 261226031Sstas </tr> 262226031Sstas <tr> 263226031Sstas <td class="paramkey"></td> 264226031Sstas <td></td> 265226031Sstas <td class="paramtype">const char * </td> 266226031Sstas <td class="paramname"> <em>in_tkt_service</em>, </td> 267226031Sstas </tr> 268226031Sstas <tr> 269226031Sstas <td class="paramkey"></td> 270226031Sstas <td></td> 271226031Sstas <td class="paramtype">krb5_get_init_creds_opt * </td> 272226031Sstas <td class="paramname"> <em>options</em></td><td> </td> 273226031Sstas </tr> 274226031Sstas <tr> 275226031Sstas <td></td> 276226031Sstas <td>)</td> 277226031Sstas <td></td><td></td><td></td> 278226031Sstas </tr> 279226031Sstas </table> 280226031Sstas</div> 281226031Sstas<div class="memdoc"> 282226031Sstas 283226031Sstas<p> 284226031SstasGet new credentials using keyblock. 285226031Sstas</div> 286226031Sstas</div><p> 287226031Sstas<a class="anchor" name="g83e4a8a74b08522bd778c2d59ef1f2b6"></a><!-- doxytag: member="init_creds_pw.c::krb5_get_init_creds_keytab" ref="g83e4a8a74b08522bd778c2d59ef1f2b6" args="(krb5_context context, krb5_creds *creds, krb5_principal client, krb5_keytab keytab, krb5_deltat start_time, const char *in_tkt_service, krb5_get_init_creds_opt *options)" --> 288226031Sstas<div class="memitem"> 289226031Sstas<div class="memproto"> 290226031Sstas <table class="memname"> 291226031Sstas <tr> 292226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_keytab </td> 293226031Sstas <td>(</td> 294226031Sstas <td class="paramtype">krb5_context </td> 295226031Sstas <td class="paramname"> <em>context</em>, </td> 296226031Sstas </tr> 297226031Sstas <tr> 298226031Sstas <td class="paramkey"></td> 299226031Sstas <td></td> 300226031Sstas <td class="paramtype">krb5_creds * </td> 301226031Sstas <td class="paramname"> <em>creds</em>, </td> 302226031Sstas </tr> 303226031Sstas <tr> 304226031Sstas <td class="paramkey"></td> 305226031Sstas <td></td> 306226031Sstas <td class="paramtype">krb5_principal </td> 307226031Sstas <td class="paramname"> <em>client</em>, </td> 308226031Sstas </tr> 309226031Sstas <tr> 310226031Sstas <td class="paramkey"></td> 311226031Sstas <td></td> 312226031Sstas <td class="paramtype">krb5_keytab </td> 313226031Sstas <td class="paramname"> <em>keytab</em>, </td> 314226031Sstas </tr> 315226031Sstas <tr> 316226031Sstas <td class="paramkey"></td> 317226031Sstas <td></td> 318226031Sstas <td class="paramtype">krb5_deltat </td> 319226031Sstas <td class="paramname"> <em>start_time</em>, </td> 320226031Sstas </tr> 321226031Sstas <tr> 322226031Sstas <td class="paramkey"></td> 323226031Sstas <td></td> 324226031Sstas <td class="paramtype">const char * </td> 325226031Sstas <td class="paramname"> <em>in_tkt_service</em>, </td> 326226031Sstas </tr> 327226031Sstas <tr> 328226031Sstas <td class="paramkey"></td> 329226031Sstas <td></td> 330226031Sstas <td class="paramtype">krb5_get_init_creds_opt * </td> 331226031Sstas <td class="paramname"> <em>options</em></td><td> </td> 332226031Sstas </tr> 333226031Sstas <tr> 334226031Sstas <td></td> 335226031Sstas <td>)</td> 336226031Sstas <td></td><td></td><td></td> 337226031Sstas </tr> 338226031Sstas </table> 339226031Sstas</div> 340226031Sstas<div class="memdoc"> 341226031Sstas 342226031Sstas<p> 343226031SstasGet new credentials using keytab. 344226031Sstas</div> 345226031Sstas</div><p> 346226031Sstas<a class="anchor" name="gbc0922393cb5c5eecec2d83f1851c21b"></a><!-- doxytag: member="init_creds.c::krb5_get_init_creds_opt_alloc" ref="gbc0922393cb5c5eecec2d83f1851c21b" args="(krb5_context context, krb5_get_init_creds_opt **opt)" --> 347226031Sstas<div class="memitem"> 348226031Sstas<div class="memproto"> 349226031Sstas <table class="memname"> 350226031Sstas <tr> 351226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_opt_alloc </td> 352226031Sstas <td>(</td> 353226031Sstas <td class="paramtype">krb5_context </td> 354226031Sstas <td class="paramname"> <em>context</em>, </td> 355226031Sstas </tr> 356226031Sstas <tr> 357226031Sstas <td class="paramkey"></td> 358226031Sstas <td></td> 359226031Sstas <td class="paramtype">krb5_get_init_creds_opt ** </td> 360226031Sstas <td class="paramname"> <em>opt</em></td><td> </td> 361226031Sstas </tr> 362226031Sstas <tr> 363226031Sstas <td></td> 364226031Sstas <td>)</td> 365226031Sstas <td></td><td></td><td></td> 366226031Sstas </tr> 367226031Sstas </table> 368226031Sstas</div> 369226031Sstas<div class="memdoc"> 370226031Sstas 371226031Sstas<p> 372226031SstasAllocate a new krb5_get_init_creds_opt structure, free with <a class="el" href="group__krb5__credential.html#g2be2f013c88153be9535c17a2b16f336">krb5_get_init_creds_opt_free()</a>. 373226031Sstas</div> 374226031Sstas</div><p> 375226031Sstas<a class="anchor" name="g2be2f013c88153be9535c17a2b16f336"></a><!-- doxytag: member="init_creds.c::krb5_get_init_creds_opt_free" ref="g2be2f013c88153be9535c17a2b16f336" args="(krb5_context context, krb5_get_init_creds_opt *opt)" --> 376226031Sstas<div class="memitem"> 377226031Sstas<div class="memproto"> 378226031Sstas <table class="memname"> 379226031Sstas <tr> 380226031Sstas <td class="memname">KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_get_init_creds_opt_free </td> 381226031Sstas <td>(</td> 382226031Sstas <td class="paramtype">krb5_context </td> 383226031Sstas <td class="paramname"> <em>context</em>, </td> 384226031Sstas </tr> 385226031Sstas <tr> 386226031Sstas <td class="paramkey"></td> 387226031Sstas <td></td> 388226031Sstas <td class="paramtype">krb5_get_init_creds_opt * </td> 389226031Sstas <td class="paramname"> <em>opt</em></td><td> </td> 390226031Sstas </tr> 391226031Sstas <tr> 392226031Sstas <td></td> 393226031Sstas <td>)</td> 394226031Sstas <td></td><td></td><td></td> 395226031Sstas </tr> 396226031Sstas </table> 397226031Sstas</div> 398226031Sstas<div class="memdoc"> 399226031Sstas 400226031Sstas<p> 401226031SstasFree krb5_get_init_creds_opt structure. 402226031Sstas</div> 403226031Sstas</div><p> 404226031Sstas<a class="anchor" name="ge7e4852f19e7f83bd743952491d1f4b1"></a><!-- doxytag: member="init_creds_pw.c::krb5_get_init_creds_password" ref="ge7e4852f19e7f83bd743952491d1f4b1" args="(krb5_context context, krb5_creds *creds, krb5_principal client, const char *password, krb5_prompter_fct prompter, void *data, krb5_deltat start_time, const char *in_tkt_service, krb5_get_init_creds_opt *options)" --> 405226031Sstas<div class="memitem"> 406226031Sstas<div class="memproto"> 407226031Sstas <table class="memname"> 408226031Sstas <tr> 409226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_password </td> 410226031Sstas <td>(</td> 411226031Sstas <td class="paramtype">krb5_context </td> 412226031Sstas <td class="paramname"> <em>context</em>, </td> 413226031Sstas </tr> 414226031Sstas <tr> 415226031Sstas <td class="paramkey"></td> 416226031Sstas <td></td> 417226031Sstas <td class="paramtype">krb5_creds * </td> 418226031Sstas <td class="paramname"> <em>creds</em>, </td> 419226031Sstas </tr> 420226031Sstas <tr> 421226031Sstas <td class="paramkey"></td> 422226031Sstas <td></td> 423226031Sstas <td class="paramtype">krb5_principal </td> 424226031Sstas <td class="paramname"> <em>client</em>, </td> 425226031Sstas </tr> 426226031Sstas <tr> 427226031Sstas <td class="paramkey"></td> 428226031Sstas <td></td> 429226031Sstas <td class="paramtype">const char * </td> 430226031Sstas <td class="paramname"> <em>password</em>, </td> 431226031Sstas </tr> 432226031Sstas <tr> 433226031Sstas <td class="paramkey"></td> 434226031Sstas <td></td> 435226031Sstas <td class="paramtype">krb5_prompter_fct </td> 436226031Sstas <td class="paramname"> <em>prompter</em>, </td> 437226031Sstas </tr> 438226031Sstas <tr> 439226031Sstas <td class="paramkey"></td> 440226031Sstas <td></td> 441226031Sstas <td class="paramtype">void * </td> 442226031Sstas <td class="paramname"> <em>data</em>, </td> 443226031Sstas </tr> 444226031Sstas <tr> 445226031Sstas <td class="paramkey"></td> 446226031Sstas <td></td> 447226031Sstas <td class="paramtype">krb5_deltat </td> 448226031Sstas <td class="paramname"> <em>start_time</em>, </td> 449226031Sstas </tr> 450226031Sstas <tr> 451226031Sstas <td class="paramkey"></td> 452226031Sstas <td></td> 453226031Sstas <td class="paramtype">const char * </td> 454226031Sstas <td class="paramname"> <em>in_tkt_service</em>, </td> 455226031Sstas </tr> 456226031Sstas <tr> 457226031Sstas <td class="paramkey"></td> 458226031Sstas <td></td> 459226031Sstas <td class="paramtype">krb5_get_init_creds_opt * </td> 460226031Sstas <td class="paramname"> <em>options</em></td><td> </td> 461226031Sstas </tr> 462226031Sstas <tr> 463226031Sstas <td></td> 464226031Sstas <td>)</td> 465226031Sstas <td></td><td></td><td></td> 466226031Sstas </tr> 467226031Sstas </table> 468226031Sstas</div> 469226031Sstas<div class="memdoc"> 470226031Sstas 471226031Sstas<p> 472226031SstasGet new credentials using password. 473226031Sstas</div> 474226031Sstas</div><p> 475226031Sstas<a class="anchor" name="gf878f5715a3048995f175c09e95a3a71"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_free" ref="gf878f5715a3048995f175c09e95a3a71" args="(krb5_context context, krb5_init_creds_context ctx)" --> 476226031Sstas<div class="memitem"> 477226031Sstas<div class="memproto"> 478226031Sstas <table class="memname"> 479226031Sstas <tr> 480226031Sstas <td class="memname">KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_init_creds_free </td> 481226031Sstas <td>(</td> 482226031Sstas <td class="paramtype">krb5_context </td> 483226031Sstas <td class="paramname"> <em>context</em>, </td> 484226031Sstas </tr> 485226031Sstas <tr> 486226031Sstas <td class="paramkey"></td> 487226031Sstas <td></td> 488226031Sstas <td class="paramtype">krb5_init_creds_context </td> 489226031Sstas <td class="paramname"> <em>ctx</em></td><td> </td> 490226031Sstas </tr> 491226031Sstas <tr> 492226031Sstas <td></td> 493226031Sstas <td>)</td> 494226031Sstas <td></td><td></td><td></td> 495226031Sstas </tr> 496226031Sstas </table> 497226031Sstas</div> 498226031Sstas<div class="memdoc"> 499226031Sstas 500226031Sstas<p> 501226031SstasFree the krb5_init_creds_context allocated by <a class="el" href="group__krb5__credential.html#g1a610bb2706e4048e8220225da110033">krb5_init_creds_init()</a>.<p> 502226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 503226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 504226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A Kerberos 5 context. </td></tr> 505226031Sstas <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>The krb5_init_creds_context to free. </td></tr> 506226031Sstas </table> 507226031Sstas</dl> 508226031Sstas 509226031Sstas</div> 510226031Sstas</div><p> 511226031Sstas<a class="anchor" name="gb1716df7cb25ebea9bbf652094970bce"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_get" ref="gb1716df7cb25ebea9bbf652094970bce" args="(krb5_context context, krb5_init_creds_context ctx)" --> 512226031Sstas<div class="memitem"> 513226031Sstas<div class="memproto"> 514226031Sstas <table class="memname"> 515226031Sstas <tr> 516226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_get </td> 517226031Sstas <td>(</td> 518226031Sstas <td class="paramtype">krb5_context </td> 519226031Sstas <td class="paramname"> <em>context</em>, </td> 520226031Sstas </tr> 521226031Sstas <tr> 522226031Sstas <td class="paramkey"></td> 523226031Sstas <td></td> 524226031Sstas <td class="paramtype">krb5_init_creds_context </td> 525226031Sstas <td class="paramname"> <em>ctx</em></td><td> </td> 526226031Sstas </tr> 527226031Sstas <tr> 528226031Sstas <td></td> 529226031Sstas <td>)</td> 530226031Sstas <td></td><td></td><td></td> 531226031Sstas </tr> 532226031Sstas </table> 533226031Sstas</div> 534226031Sstas<div class="memdoc"> 535226031Sstas 536226031Sstas<p> 537226031SstasGet new credentials as setup by the krb5_init_creds_context.<p> 538226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 539226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 540226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A Kerberos 5 context. </td></tr> 541226031Sstas <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>The krb5_init_creds_context to process. </td></tr> 542226031Sstas </table> 543226031Sstas</dl> 544226031Sstas 545226031Sstas</div> 546226031Sstas</div><p> 547226031Sstas<a class="anchor" name="gb5b9ab4698f5af99c06dbcc015c39e27"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_get_error" ref="gb5b9ab4698f5af99c06dbcc015c39e27" args="(krb5_context context, krb5_init_creds_context ctx, KRB_ERROR *error)" --> 548226031Sstas<div class="memitem"> 549226031Sstas<div class="memproto"> 550226031Sstas <table class="memname"> 551226031Sstas <tr> 552226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_get_error </td> 553226031Sstas <td>(</td> 554226031Sstas <td class="paramtype">krb5_context </td> 555226031Sstas <td class="paramname"> <em>context</em>, </td> 556226031Sstas </tr> 557226031Sstas <tr> 558226031Sstas <td class="paramkey"></td> 559226031Sstas <td></td> 560226031Sstas <td class="paramtype">krb5_init_creds_context </td> 561226031Sstas <td class="paramname"> <em>ctx</em>, </td> 562226031Sstas </tr> 563226031Sstas <tr> 564226031Sstas <td class="paramkey"></td> 565226031Sstas <td></td> 566226031Sstas <td class="paramtype">KRB_ERROR * </td> 567226031Sstas <td class="paramname"> <em>error</em></td><td> </td> 568226031Sstas </tr> 569226031Sstas <tr> 570226031Sstas <td></td> 571226031Sstas <td>)</td> 572226031Sstas <td></td><td></td><td></td> 573226031Sstas </tr> 574226031Sstas </table> 575226031Sstas</div> 576226031Sstas<div class="memdoc"> 577226031Sstas 578226031Sstas<p> 579226031SstasGet the last error from the transaction.<p> 580226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns 0 or an error code </dd></dl> 581226031Sstas 582226031Sstas</div> 583226031Sstas</div><p> 584226031Sstas<a class="anchor" name="g1a610bb2706e4048e8220225da110033"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_init" ref="g1a610bb2706e4048e8220225da110033" args="(krb5_context context, krb5_principal client, krb5_prompter_fct prompter, void *prompter_data, krb5_deltat start_time, krb5_get_init_creds_opt *options, krb5_init_creds_context *rctx)" --> 585226031Sstas<div class="memitem"> 586226031Sstas<div class="memproto"> 587226031Sstas <table class="memname"> 588226031Sstas <tr> 589226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_init </td> 590226031Sstas <td>(</td> 591226031Sstas <td class="paramtype">krb5_context </td> 592226031Sstas <td class="paramname"> <em>context</em>, </td> 593226031Sstas </tr> 594226031Sstas <tr> 595226031Sstas <td class="paramkey"></td> 596226031Sstas <td></td> 597226031Sstas <td class="paramtype">krb5_principal </td> 598226031Sstas <td class="paramname"> <em>client</em>, </td> 599226031Sstas </tr> 600226031Sstas <tr> 601226031Sstas <td class="paramkey"></td> 602226031Sstas <td></td> 603226031Sstas <td class="paramtype">krb5_prompter_fct </td> 604226031Sstas <td class="paramname"> <em>prompter</em>, </td> 605226031Sstas </tr> 606226031Sstas <tr> 607226031Sstas <td class="paramkey"></td> 608226031Sstas <td></td> 609226031Sstas <td class="paramtype">void * </td> 610226031Sstas <td class="paramname"> <em>prompter_data</em>, </td> 611226031Sstas </tr> 612226031Sstas <tr> 613226031Sstas <td class="paramkey"></td> 614226031Sstas <td></td> 615226031Sstas <td class="paramtype">krb5_deltat </td> 616226031Sstas <td class="paramname"> <em>start_time</em>, </td> 617226031Sstas </tr> 618226031Sstas <tr> 619226031Sstas <td class="paramkey"></td> 620226031Sstas <td></td> 621226031Sstas <td class="paramtype">krb5_get_init_creds_opt * </td> 622226031Sstas <td class="paramname"> <em>options</em>, </td> 623226031Sstas </tr> 624226031Sstas <tr> 625226031Sstas <td class="paramkey"></td> 626226031Sstas <td></td> 627226031Sstas <td class="paramtype">krb5_init_creds_context * </td> 628226031Sstas <td class="paramname"> <em>rctx</em></td><td> </td> 629226031Sstas </tr> 630226031Sstas <tr> 631226031Sstas <td></td> 632226031Sstas <td>)</td> 633226031Sstas <td></td><td></td><td></td> 634226031Sstas </tr> 635226031Sstas </table> 636226031Sstas</div> 637226031Sstas<div class="memdoc"> 638226031Sstas 639226031Sstas<p> 640226031SstasStart a new context to get a new initial credential.<p> 641226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 642226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 643226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A Kerberos 5 context. </td></tr> 644226031Sstas <tr><td valign="top"></td><td valign="top"><em>client</em> </td><td>The Kerberos principal to get the credential for, if NULL is given, the default principal is used as determined by krb5_get_default_principal(). </td></tr> 645226031Sstas <tr><td valign="top"></td><td valign="top"><em>prompter</em> </td><td></td></tr> 646226031Sstas <tr><td valign="top"></td><td valign="top"><em>prompter_data</em> </td><td></td></tr> 647226031Sstas <tr><td valign="top"></td><td valign="top"><em>start_time</em> </td><td>the time the ticket should start to be valid or 0 for now. </td></tr> 648226031Sstas <tr><td valign="top"></td><td valign="top"><em>options</em> </td><td>a options structure, can be NULL for default options. </td></tr> 649226031Sstas <tr><td valign="top"></td><td valign="top"><em>rctx</em> </td><td>A new allocated free with <a class="el" href="group__krb5__credential.html#gf878f5715a3048995f175c09e95a3a71">krb5_init_creds_free()</a>.</td></tr> 650226031Sstas </table> 651226031Sstas</dl> 652226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success or an Kerberos 5 error code, see krb5_get_error_message(). </dd></dl> 653226031Sstas 654226031Sstas</div> 655226031Sstas</div><p> 656226031Sstas<a class="anchor" name="gb80179f38c8cc87627752d5db22c8203"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_set_keytab" ref="gb80179f38c8cc87627752d5db22c8203" args="(krb5_context context, krb5_init_creds_context ctx, krb5_keytab keytab)" --> 657226031Sstas<div class="memitem"> 658226031Sstas<div class="memproto"> 659226031Sstas <table class="memname"> 660226031Sstas <tr> 661226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_set_keytab </td> 662226031Sstas <td>(</td> 663226031Sstas <td class="paramtype">krb5_context </td> 664226031Sstas <td class="paramname"> <em>context</em>, </td> 665226031Sstas </tr> 666226031Sstas <tr> 667226031Sstas <td class="paramkey"></td> 668226031Sstas <td></td> 669226031Sstas <td class="paramtype">krb5_init_creds_context </td> 670226031Sstas <td class="paramname"> <em>ctx</em>, </td> 671226031Sstas </tr> 672226031Sstas <tr> 673226031Sstas <td class="paramkey"></td> 674226031Sstas <td></td> 675226031Sstas <td class="paramtype">krb5_keytab </td> 676226031Sstas <td class="paramname"> <em>keytab</em></td><td> </td> 677226031Sstas </tr> 678226031Sstas <tr> 679226031Sstas <td></td> 680226031Sstas <td>)</td> 681226031Sstas <td></td><td></td><td></td> 682226031Sstas </tr> 683226031Sstas </table> 684226031Sstas</div> 685226031Sstas<div class="memdoc"> 686226031Sstas 687226031Sstas<p> 688226031SstasSet the keytab to use for authentication.<p> 689226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 690226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 691226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 692226031Sstas <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>ctx krb5_init_creds_context context. </td></tr> 693226031Sstas <tr><td valign="top"></td><td valign="top"><em>keytab</em> </td><td>the keytab to read the key from.</td></tr> 694226031Sstas </table> 695226031Sstas</dl> 696226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success, or an Kerberos 5 error code, see krb5_get_error_message(). </dd></dl> 697226031Sstas 698226031Sstas</div> 699226031Sstas</div><p> 700226031Sstas<a class="anchor" name="g0a1d093a3c43b57b5e84206e73441d68"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_set_password" ref="g0a1d093a3c43b57b5e84206e73441d68" args="(krb5_context context, krb5_init_creds_context ctx, const char *password)" --> 701226031Sstas<div class="memitem"> 702226031Sstas<div class="memproto"> 703226031Sstas <table class="memname"> 704226031Sstas <tr> 705226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_set_password </td> 706226031Sstas <td>(</td> 707226031Sstas <td class="paramtype">krb5_context </td> 708226031Sstas <td class="paramname"> <em>context</em>, </td> 709226031Sstas </tr> 710226031Sstas <tr> 711226031Sstas <td class="paramkey"></td> 712226031Sstas <td></td> 713226031Sstas <td class="paramtype">krb5_init_creds_context </td> 714226031Sstas <td class="paramname"> <em>ctx</em>, </td> 715226031Sstas </tr> 716226031Sstas <tr> 717226031Sstas <td class="paramkey"></td> 718226031Sstas <td></td> 719226031Sstas <td class="paramtype">const char * </td> 720226031Sstas <td class="paramname"> <em>password</em></td><td> </td> 721226031Sstas </tr> 722226031Sstas <tr> 723226031Sstas <td></td> 724226031Sstas <td>)</td> 725226031Sstas <td></td><td></td><td></td> 726226031Sstas </tr> 727226031Sstas </table> 728226031Sstas</div> 729226031Sstas<div class="memdoc"> 730226031Sstas 731226031Sstas<p> 732226031SstasSets the password that will use for the request.<p> 733226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 734226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 735226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 736226031Sstas <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>ctx krb5_init_creds_context context. </td></tr> 737226031Sstas <tr><td valign="top"></td><td valign="top"><em>password</em> </td><td>the password to use.</td></tr> 738226031Sstas </table> 739226031Sstas</dl> 740226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success, or an Kerberos 5 error code, see krb5_get_error_message(). </dd></dl> 741226031Sstas 742226031Sstas</div> 743226031Sstas</div><p> 744226031Sstas<a class="anchor" name="g71f386b20c42540d4e733eeb7c0cb18e"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_set_service" ref="g71f386b20c42540d4e733eeb7c0cb18e" args="(krb5_context context, krb5_init_creds_context ctx, const char *service)" --> 745226031Sstas<div class="memitem"> 746226031Sstas<div class="memproto"> 747226031Sstas <table class="memname"> 748226031Sstas <tr> 749226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_set_service </td> 750226031Sstas <td>(</td> 751226031Sstas <td class="paramtype">krb5_context </td> 752226031Sstas <td class="paramname"> <em>context</em>, </td> 753226031Sstas </tr> 754226031Sstas <tr> 755226031Sstas <td class="paramkey"></td> 756226031Sstas <td></td> 757226031Sstas <td class="paramtype">krb5_init_creds_context </td> 758226031Sstas <td class="paramname"> <em>ctx</em>, </td> 759226031Sstas </tr> 760226031Sstas <tr> 761226031Sstas <td class="paramkey"></td> 762226031Sstas <td></td> 763226031Sstas <td class="paramtype">const char * </td> 764226031Sstas <td class="paramname"> <em>service</em></td><td> </td> 765226031Sstas </tr> 766226031Sstas <tr> 767226031Sstas <td></td> 768226031Sstas <td>)</td> 769226031Sstas <td></td><td></td><td></td> 770226031Sstas </tr> 771226031Sstas </table> 772226031Sstas</div> 773226031Sstas<div class="memdoc"> 774226031Sstas 775226031Sstas<p> 776226031SstasSets the service that the is requested. This call is only neede for special initial tickets, by default the a krbtgt is fetched in the default realm.<p> 777226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 778226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 779226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 780226031Sstas <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>a krb5_init_creds_context context. </td></tr> 781226031Sstas <tr><td valign="top"></td><td valign="top"><em>service</em> </td><td>the service given as a string, for example "kadmind/admin". If NULL, the default krbtgt in the clients realm is set.</td></tr> 782226031Sstas </table> 783226031Sstas</dl> 784226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success, or an Kerberos 5 error code, see krb5_get_error_message(). </dd></dl> 785226031Sstas 786226031Sstas</div> 787226031Sstas</div><p> 788226031Sstas<a class="anchor" name="g9b1f54a05b9e7b60bef0c7d5f40b351b"></a><!-- doxytag: member="init_creds_pw.c::krb5_init_creds_step" ref="g9b1f54a05b9e7b60bef0c7d5f40b351b" args="(krb5_context context, krb5_init_creds_context ctx, krb5_data *in, krb5_data *out, krb5_krbhst_info *hostinfo, unsigned int *flags)" --> 789226031Sstas<div class="memitem"> 790226031Sstas<div class="memproto"> 791226031Sstas <table class="memname"> 792226031Sstas <tr> 793226031Sstas <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_step </td> 794226031Sstas <td>(</td> 795226031Sstas <td class="paramtype">krb5_context </td> 796226031Sstas <td class="paramname"> <em>context</em>, </td> 797226031Sstas </tr> 798226031Sstas <tr> 799226031Sstas <td class="paramkey"></td> 800226031Sstas <td></td> 801226031Sstas <td class="paramtype">krb5_init_creds_context </td> 802226031Sstas <td class="paramname"> <em>ctx</em>, </td> 803226031Sstas </tr> 804226031Sstas <tr> 805226031Sstas <td class="paramkey"></td> 806226031Sstas <td></td> 807226031Sstas <td class="paramtype">krb5_data * </td> 808226031Sstas <td class="paramname"> <em>in</em>, </td> 809226031Sstas </tr> 810226031Sstas <tr> 811226031Sstas <td class="paramkey"></td> 812226031Sstas <td></td> 813226031Sstas <td class="paramtype">krb5_data * </td> 814226031Sstas <td class="paramname"> <em>out</em>, </td> 815226031Sstas </tr> 816226031Sstas <tr> 817226031Sstas <td class="paramkey"></td> 818226031Sstas <td></td> 819226031Sstas <td class="paramtype">krb5_krbhst_info * </td> 820226031Sstas <td class="paramname"> <em>hostinfo</em>, </td> 821226031Sstas </tr> 822226031Sstas <tr> 823226031Sstas <td class="paramkey"></td> 824226031Sstas <td></td> 825226031Sstas <td class="paramtype">unsigned int * </td> 826226031Sstas <td class="paramname"> <em>flags</em></td><td> </td> 827226031Sstas </tr> 828226031Sstas <tr> 829226031Sstas <td></td> 830226031Sstas <td>)</td> 831226031Sstas <td></td><td></td><td></td> 832226031Sstas </tr> 833226031Sstas </table> 834226031Sstas</div> 835226031Sstas<div class="memdoc"> 836226031Sstas 837226031Sstas<p> 838226031SstasThe core loop if krb5_get_init_creds() function family. Create the packets and have the caller send them off to the KDC.<p> 839226031SstasIf the caller want all work been done for them, use <a class="el" href="group__krb5__credential.html#gb1716df7cb25ebea9bbf652094970bce">krb5_init_creds_get()</a> instead.<p> 840226031Sstas<dl compact><dt><b>Parameters:</b></dt><dd> 841226031Sstas <table border="0" cellspacing="2" cellpadding="0"> 842226031Sstas <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 843226031Sstas <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>ctx krb5_init_creds_context context. </td></tr> 844226031Sstas <tr><td valign="top"></td><td valign="top"><em>in</em> </td><td>input data from KDC, first round it should be reset by krb5_data_zer(). </td></tr> 845226031Sstas <tr><td valign="top"></td><td valign="top"><em>out</em> </td><td>reply to KDC. </td></tr> 846226031Sstas <tr><td valign="top"></td><td valign="top"><em>hostinfo</em> </td><td>KDC address info, first round it can be NULL. </td></tr> 847226031Sstas <tr><td valign="top"></td><td valign="top"><em>flags</em> </td><td>status of the round, if KRB5_INIT_CREDS_STEP_FLAG_CONTINUE is set, continue one more round.</td></tr> 848226031Sstas </table> 849226031Sstas</dl> 850226031Sstas<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 for success, or an Kerberos 5 error code, see krb5_get_error_message(). </dd></dl> 851226031Sstas 852226031Sstas</div> 853226031Sstas</div><p> 854226031Sstas</div> 855226031Sstas<hr size="1"><address style="text-align: right;"><small> 856234027SstasGenerated on Wed Jan 11 14:07:49 2012 for HeimdalKerberos5library by <a href="http://www.doxygen.org/index.html"><img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.6</small></address> 857226031Sstas</body> 858226031Sstas</html> 859