1ae771770SStanislav Sedov<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 2ae771770SStanislav Sedov<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"> 3ae771770SStanislav Sedov<title>HeimdalKerberos5library: Heimdal Kerberos 5 credential handing functions</title> 4ae771770SStanislav Sedov<link href="doxygen.css" rel="stylesheet" type="text/css"> 5ae771770SStanislav Sedov<link href="tabs.css" rel="stylesheet" type="text/css"> 6ae771770SStanislav Sedov</head><body> 7ae771770SStanislav Sedov<p> 8ae771770SStanislav Sedov<a href="http://www.h5l.org/"><img src="http://www.h5l.org/keyhole-heimdal.png" alt="keyhole logo"/></a> 9ae771770SStanislav Sedov</p> 10ae771770SStanislav Sedov<!-- end of header marker --> 11ae771770SStanislav Sedov<!-- Generated by Doxygen 1.5.6 --> 12ae771770SStanislav Sedov<div class="navigation" id="top"> 13ae771770SStanislav Sedov <div class="tabs"> 14ae771770SStanislav Sedov <ul> 15ae771770SStanislav Sedov <li><a href="index.html"><span>Main Page</span></a></li> 16ae771770SStanislav Sedov <li><a href="pages.html"><span>Related Pages</span></a></li> 17ae771770SStanislav Sedov <li><a href="modules.html"><span>Modules</span></a></li> 18ae771770SStanislav Sedov <li><a href="annotated.html"><span>Data Structures</span></a></li> 19ae771770SStanislav Sedov </ul> 20ae771770SStanislav Sedov </div> 21ae771770SStanislav Sedov</div> 22ae771770SStanislav Sedov<div class="contents"> 23ae771770SStanislav Sedov<h1>Heimdal Kerberos 5 credential handing functions</h1><table border="0" cellpadding="0" cellspacing="0"> 24ae771770SStanislav Sedov<tr><td></td></tr> 25ae771770SStanislav Sedov<tr><td colspan="2"><br><h2>Functions</h2></td></tr> 26ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 27ae771770SStanislav Sedovkrb5_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> 28ae771770SStanislav Sedov 29ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 30ae771770SStanislav Sedovkrb5_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> 31ae771770SStanislav Sedov 32ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 33ae771770SStanislav Sedovkrb5_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> 34ae771770SStanislav Sedov 35ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION void <br> 36ae771770SStanislav SedovKRB5_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> 37ae771770SStanislav Sedov 38ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 39ae771770SStanislav Sedovkrb5_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> 40ae771770SStanislav Sedov 41ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 42ae771770SStanislav Sedovkrb5_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> 43ae771770SStanislav Sedov 44ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 45ae771770SStanislav Sedovkrb5_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> 46ae771770SStanislav Sedov 47ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 48ae771770SStanislav Sedovkrb5_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> 49ae771770SStanislav Sedov 50ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 51ae771770SStanislav Sedovkrb5_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> 52ae771770SStanislav Sedov 53ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 54ae771770SStanislav Sedovkrb5_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> 55ae771770SStanislav Sedov 56ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION void <br> 57ae771770SStanislav SedovKRB5_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> 58ae771770SStanislav Sedov 59ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 60ae771770SStanislav Sedovkrb5_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> 61ae771770SStanislav Sedov 62ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 63ae771770SStanislav Sedovkrb5_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> 64ae771770SStanislav Sedov 65ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 66ae771770SStanislav Sedovkrb5_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> 67ae771770SStanislav Sedov 68ae771770SStanislav Sedov<tr><td class="memItemLeft" nowrap align="right" valign="top">KRB5_LIB_FUNCTION <br> 69ae771770SStanislav Sedovkrb5_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> 70ae771770SStanislav Sedov 71ae771770SStanislav Sedov</table> 72ae771770SStanislav Sedov<hr><a name="_details"></a><h2>Detailed Description</h2> 73ae771770SStanislav Sedov<hr><h2>Function Documentation</h2> 74ae771770SStanislav Sedov<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)" --> 75ae771770SStanislav Sedov<div class="memitem"> 76ae771770SStanislav Sedov<div class="memproto"> 77ae771770SStanislav Sedov <table class="memname"> 78ae771770SStanislav Sedov <tr> 79ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_fwd_tgt_creds </td> 80ae771770SStanislav Sedov <td>(</td> 81ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 82ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 83ae771770SStanislav Sedov </tr> 84ae771770SStanislav Sedov <tr> 85ae771770SStanislav Sedov <td class="paramkey"></td> 86ae771770SStanislav Sedov <td></td> 87ae771770SStanislav Sedov <td class="paramtype">krb5_auth_context </td> 88ae771770SStanislav Sedov <td class="paramname"> <em>auth_context</em>, </td> 89ae771770SStanislav Sedov </tr> 90ae771770SStanislav Sedov <tr> 91ae771770SStanislav Sedov <td class="paramkey"></td> 92ae771770SStanislav Sedov <td></td> 93ae771770SStanislav Sedov <td class="paramtype">const char * </td> 94ae771770SStanislav Sedov <td class="paramname"> <em>hostname</em>, </td> 95ae771770SStanislav Sedov </tr> 96ae771770SStanislav Sedov <tr> 97ae771770SStanislav Sedov <td class="paramkey"></td> 98ae771770SStanislav Sedov <td></td> 99ae771770SStanislav Sedov <td class="paramtype">krb5_principal </td> 100ae771770SStanislav Sedov <td class="paramname"> <em>client</em>, </td> 101ae771770SStanislav Sedov </tr> 102ae771770SStanislav Sedov <tr> 103ae771770SStanislav Sedov <td class="paramkey"></td> 104ae771770SStanislav Sedov <td></td> 105ae771770SStanislav Sedov <td class="paramtype">krb5_principal </td> 106ae771770SStanislav Sedov <td class="paramname"> <em>server</em>, </td> 107ae771770SStanislav Sedov </tr> 108ae771770SStanislav Sedov <tr> 109ae771770SStanislav Sedov <td class="paramkey"></td> 110ae771770SStanislav Sedov <td></td> 111ae771770SStanislav Sedov <td class="paramtype">krb5_ccache </td> 112ae771770SStanislav Sedov <td class="paramname"> <em>ccache</em>, </td> 113ae771770SStanislav Sedov </tr> 114ae771770SStanislav Sedov <tr> 115ae771770SStanislav Sedov <td class="paramkey"></td> 116ae771770SStanislav Sedov <td></td> 117ae771770SStanislav Sedov <td class="paramtype">int </td> 118ae771770SStanislav Sedov <td class="paramname"> <em>forwardable</em>, </td> 119ae771770SStanislav Sedov </tr> 120ae771770SStanislav Sedov <tr> 121ae771770SStanislav Sedov <td class="paramkey"></td> 122ae771770SStanislav Sedov <td></td> 123ae771770SStanislav Sedov <td class="paramtype">krb5_data * </td> 124ae771770SStanislav Sedov <td class="paramname"> <em>out_data</em></td><td> </td> 125ae771770SStanislav Sedov </tr> 126ae771770SStanislav Sedov <tr> 127ae771770SStanislav Sedov <td></td> 128ae771770SStanislav Sedov <td>)</td> 129ae771770SStanislav Sedov <td></td><td></td><td></td> 130ae771770SStanislav Sedov </tr> 131ae771770SStanislav Sedov </table> 132ae771770SStanislav Sedov</div> 133ae771770SStanislav Sedov<div class="memdoc"> 134ae771770SStanislav Sedov 135ae771770SStanislav Sedov<p> 136ae771770SStanislav SedovForward 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> 137ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 138ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 139ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A kerberos 5 context. </td></tr> 140ae771770SStanislav Sedov <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> 141ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>hostname</em> </td><td>the host to forward the tickets too. </td></tr> 142ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>client</em> </td><td>the client to delegate from. </td></tr> 143ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>server</em> </td><td>the server to delegate the credential too. </td></tr> 144ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ccache</em> </td><td>credential cache to use. </td></tr> 145ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>forwardable</em> </td><td>make the forwarded ticket forwabledable. </td></tr> 146ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>out_data</em> </td><td>the resulting credential.</td></tr> 147ae771770SStanislav Sedov </table> 148ae771770SStanislav Sedov</dl> 149ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>Return an error code or 0. </dd></dl> 150ae771770SStanislav Sedov 151ae771770SStanislav Sedov</div> 152ae771770SStanislav Sedov</div><p> 153ae771770SStanislav Sedov<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)" --> 154ae771770SStanislav Sedov<div class="memitem"> 155ae771770SStanislav Sedov<div class="memproto"> 156ae771770SStanislav Sedov <table class="memname"> 157ae771770SStanislav Sedov <tr> 158ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_forwarded_creds </td> 159ae771770SStanislav Sedov <td>(</td> 160ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 161ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 162ae771770SStanislav Sedov </tr> 163ae771770SStanislav Sedov <tr> 164ae771770SStanislav Sedov <td class="paramkey"></td> 165ae771770SStanislav Sedov <td></td> 166ae771770SStanislav Sedov <td class="paramtype">krb5_auth_context </td> 167ae771770SStanislav Sedov <td class="paramname"> <em>auth_context</em>, </td> 168ae771770SStanislav Sedov </tr> 169ae771770SStanislav Sedov <tr> 170ae771770SStanislav Sedov <td class="paramkey"></td> 171ae771770SStanislav Sedov <td></td> 172ae771770SStanislav Sedov <td class="paramtype">krb5_ccache </td> 173ae771770SStanislav Sedov <td class="paramname"> <em>ccache</em>, </td> 174ae771770SStanislav Sedov </tr> 175ae771770SStanislav Sedov <tr> 176ae771770SStanislav Sedov <td class="paramkey"></td> 177ae771770SStanislav Sedov <td></td> 178ae771770SStanislav Sedov <td class="paramtype">krb5_flags </td> 179ae771770SStanislav Sedov <td class="paramname"> <em>flags</em>, </td> 180ae771770SStanislav Sedov </tr> 181ae771770SStanislav Sedov <tr> 182ae771770SStanislav Sedov <td class="paramkey"></td> 183ae771770SStanislav Sedov <td></td> 184ae771770SStanislav Sedov <td class="paramtype">const char * </td> 185ae771770SStanislav Sedov <td class="paramname"> <em>hostname</em>, </td> 186ae771770SStanislav Sedov </tr> 187ae771770SStanislav Sedov <tr> 188ae771770SStanislav Sedov <td class="paramkey"></td> 189ae771770SStanislav Sedov <td></td> 190ae771770SStanislav Sedov <td class="paramtype">krb5_creds * </td> 191ae771770SStanislav Sedov <td class="paramname"> <em>in_creds</em>, </td> 192ae771770SStanislav Sedov </tr> 193ae771770SStanislav Sedov <tr> 194ae771770SStanislav Sedov <td class="paramkey"></td> 195ae771770SStanislav Sedov <td></td> 196ae771770SStanislav Sedov <td class="paramtype">krb5_data * </td> 197ae771770SStanislav Sedov <td class="paramname"> <em>out_data</em></td><td> </td> 198ae771770SStanislav Sedov </tr> 199ae771770SStanislav Sedov <tr> 200ae771770SStanislav Sedov <td></td> 201ae771770SStanislav Sedov <td>)</td> 202ae771770SStanislav Sedov <td></td><td></td><td></td> 203ae771770SStanislav Sedov </tr> 204ae771770SStanislav Sedov </table> 205ae771770SStanislav Sedov</div> 206ae771770SStanislav Sedov<div class="memdoc"> 207ae771770SStanislav Sedov 208ae771770SStanislav Sedov<p> 209ae771770SStanislav SedovGets tickets forwarded to hostname. If the tickets that are forwarded are address-less, the forwarded tickets will also be address-less.<p> 210ae771770SStanislav SedovIf 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> 211ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 212ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 213ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A kerberos 5 context. </td></tr> 214ae771770SStanislav Sedov <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> 215ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ccache</em> </td><td>credential cache to use </td></tr> 216ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>flags</em> </td><td>the flags to control the resulting ticket flags </td></tr> 217ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>hostname</em> </td><td>the host to forward the tickets too. </td></tr> 218ae771770SStanislav Sedov <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> 219ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>out_data</em> </td><td>the resulting credential.</td></tr> 220ae771770SStanislav Sedov </table> 221ae771770SStanislav Sedov</dl> 222ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>Return an error code or 0. </dd></dl> 223ae771770SStanislav Sedov 224ae771770SStanislav Sedov<p> 225ae771770SStanislav SedovSome 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. 226ae771770SStanislav Sedov</div> 227ae771770SStanislav Sedov</div><p> 228ae771770SStanislav Sedov<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)" --> 229ae771770SStanislav Sedov<div class="memitem"> 230ae771770SStanislav Sedov<div class="memproto"> 231ae771770SStanislav Sedov <table class="memname"> 232ae771770SStanislav Sedov <tr> 233ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_keyblock </td> 234ae771770SStanislav Sedov <td>(</td> 235ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 236ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 237ae771770SStanislav Sedov </tr> 238ae771770SStanislav Sedov <tr> 239ae771770SStanislav Sedov <td class="paramkey"></td> 240ae771770SStanislav Sedov <td></td> 241ae771770SStanislav Sedov <td class="paramtype">krb5_creds * </td> 242ae771770SStanislav Sedov <td class="paramname"> <em>creds</em>, </td> 243ae771770SStanislav Sedov </tr> 244ae771770SStanislav Sedov <tr> 245ae771770SStanislav Sedov <td class="paramkey"></td> 246ae771770SStanislav Sedov <td></td> 247ae771770SStanislav Sedov <td class="paramtype">krb5_principal </td> 248ae771770SStanislav Sedov <td class="paramname"> <em>client</em>, </td> 249ae771770SStanislav Sedov </tr> 250ae771770SStanislav Sedov <tr> 251ae771770SStanislav Sedov <td class="paramkey"></td> 252ae771770SStanislav Sedov <td></td> 253ae771770SStanislav Sedov <td class="paramtype">krb5_keyblock * </td> 254ae771770SStanislav Sedov <td class="paramname"> <em>keyblock</em>, </td> 255ae771770SStanislav Sedov </tr> 256ae771770SStanislav Sedov <tr> 257ae771770SStanislav Sedov <td class="paramkey"></td> 258ae771770SStanislav Sedov <td></td> 259ae771770SStanislav Sedov <td class="paramtype">krb5_deltat </td> 260ae771770SStanislav Sedov <td class="paramname"> <em>start_time</em>, </td> 261ae771770SStanislav Sedov </tr> 262ae771770SStanislav Sedov <tr> 263ae771770SStanislav Sedov <td class="paramkey"></td> 264ae771770SStanislav Sedov <td></td> 265ae771770SStanislav Sedov <td class="paramtype">const char * </td> 266ae771770SStanislav Sedov <td class="paramname"> <em>in_tkt_service</em>, </td> 267ae771770SStanislav Sedov </tr> 268ae771770SStanislav Sedov <tr> 269ae771770SStanislav Sedov <td class="paramkey"></td> 270ae771770SStanislav Sedov <td></td> 271ae771770SStanislav Sedov <td class="paramtype">krb5_get_init_creds_opt * </td> 272ae771770SStanislav Sedov <td class="paramname"> <em>options</em></td><td> </td> 273ae771770SStanislav Sedov </tr> 274ae771770SStanislav Sedov <tr> 275ae771770SStanislav Sedov <td></td> 276ae771770SStanislav Sedov <td>)</td> 277ae771770SStanislav Sedov <td></td><td></td><td></td> 278ae771770SStanislav Sedov </tr> 279ae771770SStanislav Sedov </table> 280ae771770SStanislav Sedov</div> 281ae771770SStanislav Sedov<div class="memdoc"> 282ae771770SStanislav Sedov 283ae771770SStanislav Sedov<p> 284ae771770SStanislav SedovGet new credentials using keyblock. 285ae771770SStanislav Sedov</div> 286ae771770SStanislav Sedov</div><p> 287ae771770SStanislav Sedov<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)" --> 288ae771770SStanislav Sedov<div class="memitem"> 289ae771770SStanislav Sedov<div class="memproto"> 290ae771770SStanislav Sedov <table class="memname"> 291ae771770SStanislav Sedov <tr> 292ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_keytab </td> 293ae771770SStanislav Sedov <td>(</td> 294ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 295ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 296ae771770SStanislav Sedov </tr> 297ae771770SStanislav Sedov <tr> 298ae771770SStanislav Sedov <td class="paramkey"></td> 299ae771770SStanislav Sedov <td></td> 300ae771770SStanislav Sedov <td class="paramtype">krb5_creds * </td> 301ae771770SStanislav Sedov <td class="paramname"> <em>creds</em>, </td> 302ae771770SStanislav Sedov </tr> 303ae771770SStanislav Sedov <tr> 304ae771770SStanislav Sedov <td class="paramkey"></td> 305ae771770SStanislav Sedov <td></td> 306ae771770SStanislav Sedov <td class="paramtype">krb5_principal </td> 307ae771770SStanislav Sedov <td class="paramname"> <em>client</em>, </td> 308ae771770SStanislav Sedov </tr> 309ae771770SStanislav Sedov <tr> 310ae771770SStanislav Sedov <td class="paramkey"></td> 311ae771770SStanislav Sedov <td></td> 312ae771770SStanislav Sedov <td class="paramtype">krb5_keytab </td> 313ae771770SStanislav Sedov <td class="paramname"> <em>keytab</em>, </td> 314ae771770SStanislav Sedov </tr> 315ae771770SStanislav Sedov <tr> 316ae771770SStanislav Sedov <td class="paramkey"></td> 317ae771770SStanislav Sedov <td></td> 318ae771770SStanislav Sedov <td class="paramtype">krb5_deltat </td> 319ae771770SStanislav Sedov <td class="paramname"> <em>start_time</em>, </td> 320ae771770SStanislav Sedov </tr> 321ae771770SStanislav Sedov <tr> 322ae771770SStanislav Sedov <td class="paramkey"></td> 323ae771770SStanislav Sedov <td></td> 324ae771770SStanislav Sedov <td class="paramtype">const char * </td> 325ae771770SStanislav Sedov <td class="paramname"> <em>in_tkt_service</em>, </td> 326ae771770SStanislav Sedov </tr> 327ae771770SStanislav Sedov <tr> 328ae771770SStanislav Sedov <td class="paramkey"></td> 329ae771770SStanislav Sedov <td></td> 330ae771770SStanislav Sedov <td class="paramtype">krb5_get_init_creds_opt * </td> 331ae771770SStanislav Sedov <td class="paramname"> <em>options</em></td><td> </td> 332ae771770SStanislav Sedov </tr> 333ae771770SStanislav Sedov <tr> 334ae771770SStanislav Sedov <td></td> 335ae771770SStanislav Sedov <td>)</td> 336ae771770SStanislav Sedov <td></td><td></td><td></td> 337ae771770SStanislav Sedov </tr> 338ae771770SStanislav Sedov </table> 339ae771770SStanislav Sedov</div> 340ae771770SStanislav Sedov<div class="memdoc"> 341ae771770SStanislav Sedov 342ae771770SStanislav Sedov<p> 343ae771770SStanislav SedovGet new credentials using keytab. 344ae771770SStanislav Sedov</div> 345ae771770SStanislav Sedov</div><p> 346ae771770SStanislav Sedov<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)" --> 347ae771770SStanislav Sedov<div class="memitem"> 348ae771770SStanislav Sedov<div class="memproto"> 349ae771770SStanislav Sedov <table class="memname"> 350ae771770SStanislav Sedov <tr> 351ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_opt_alloc </td> 352ae771770SStanislav Sedov <td>(</td> 353ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 354ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 355ae771770SStanislav Sedov </tr> 356ae771770SStanislav Sedov <tr> 357ae771770SStanislav Sedov <td class="paramkey"></td> 358ae771770SStanislav Sedov <td></td> 359ae771770SStanislav Sedov <td class="paramtype">krb5_get_init_creds_opt ** </td> 360ae771770SStanislav Sedov <td class="paramname"> <em>opt</em></td><td> </td> 361ae771770SStanislav Sedov </tr> 362ae771770SStanislav Sedov <tr> 363ae771770SStanislav Sedov <td></td> 364ae771770SStanislav Sedov <td>)</td> 365ae771770SStanislav Sedov <td></td><td></td><td></td> 366ae771770SStanislav Sedov </tr> 367ae771770SStanislav Sedov </table> 368ae771770SStanislav Sedov</div> 369ae771770SStanislav Sedov<div class="memdoc"> 370ae771770SStanislav Sedov 371ae771770SStanislav Sedov<p> 372ae771770SStanislav SedovAllocate 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>. 373ae771770SStanislav Sedov</div> 374ae771770SStanislav Sedov</div><p> 375ae771770SStanislav Sedov<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)" --> 376ae771770SStanislav Sedov<div class="memitem"> 377ae771770SStanislav Sedov<div class="memproto"> 378ae771770SStanislav Sedov <table class="memname"> 379ae771770SStanislav Sedov <tr> 380ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_get_init_creds_opt_free </td> 381ae771770SStanislav Sedov <td>(</td> 382ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 383ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 384ae771770SStanislav Sedov </tr> 385ae771770SStanislav Sedov <tr> 386ae771770SStanislav Sedov <td class="paramkey"></td> 387ae771770SStanislav Sedov <td></td> 388ae771770SStanislav Sedov <td class="paramtype">krb5_get_init_creds_opt * </td> 389ae771770SStanislav Sedov <td class="paramname"> <em>opt</em></td><td> </td> 390ae771770SStanislav Sedov </tr> 391ae771770SStanislav Sedov <tr> 392ae771770SStanislav Sedov <td></td> 393ae771770SStanislav Sedov <td>)</td> 394ae771770SStanislav Sedov <td></td><td></td><td></td> 395ae771770SStanislav Sedov </tr> 396ae771770SStanislav Sedov </table> 397ae771770SStanislav Sedov</div> 398ae771770SStanislav Sedov<div class="memdoc"> 399ae771770SStanislav Sedov 400ae771770SStanislav Sedov<p> 401ae771770SStanislav SedovFree krb5_get_init_creds_opt structure. 402ae771770SStanislav Sedov</div> 403ae771770SStanislav Sedov</div><p> 404ae771770SStanislav Sedov<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)" --> 405ae771770SStanislav Sedov<div class="memitem"> 406ae771770SStanislav Sedov<div class="memproto"> 407ae771770SStanislav Sedov <table class="memname"> 408ae771770SStanislav Sedov <tr> 409ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_get_init_creds_password </td> 410ae771770SStanislav Sedov <td>(</td> 411ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 412ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 413ae771770SStanislav Sedov </tr> 414ae771770SStanislav Sedov <tr> 415ae771770SStanislav Sedov <td class="paramkey"></td> 416ae771770SStanislav Sedov <td></td> 417ae771770SStanislav Sedov <td class="paramtype">krb5_creds * </td> 418ae771770SStanislav Sedov <td class="paramname"> <em>creds</em>, </td> 419ae771770SStanislav Sedov </tr> 420ae771770SStanislav Sedov <tr> 421ae771770SStanislav Sedov <td class="paramkey"></td> 422ae771770SStanislav Sedov <td></td> 423ae771770SStanislav Sedov <td class="paramtype">krb5_principal </td> 424ae771770SStanislav Sedov <td class="paramname"> <em>client</em>, </td> 425ae771770SStanislav Sedov </tr> 426ae771770SStanislav Sedov <tr> 427ae771770SStanislav Sedov <td class="paramkey"></td> 428ae771770SStanislav Sedov <td></td> 429ae771770SStanislav Sedov <td class="paramtype">const char * </td> 430ae771770SStanislav Sedov <td class="paramname"> <em>password</em>, </td> 431ae771770SStanislav Sedov </tr> 432ae771770SStanislav Sedov <tr> 433ae771770SStanislav Sedov <td class="paramkey"></td> 434ae771770SStanislav Sedov <td></td> 435ae771770SStanislav Sedov <td class="paramtype">krb5_prompter_fct </td> 436ae771770SStanislav Sedov <td class="paramname"> <em>prompter</em>, </td> 437ae771770SStanislav Sedov </tr> 438ae771770SStanislav Sedov <tr> 439ae771770SStanislav Sedov <td class="paramkey"></td> 440ae771770SStanislav Sedov <td></td> 441ae771770SStanislav Sedov <td class="paramtype">void * </td> 442ae771770SStanislav Sedov <td class="paramname"> <em>data</em>, </td> 443ae771770SStanislav Sedov </tr> 444ae771770SStanislav Sedov <tr> 445ae771770SStanislav Sedov <td class="paramkey"></td> 446ae771770SStanislav Sedov <td></td> 447ae771770SStanislav Sedov <td class="paramtype">krb5_deltat </td> 448ae771770SStanislav Sedov <td class="paramname"> <em>start_time</em>, </td> 449ae771770SStanislav Sedov </tr> 450ae771770SStanislav Sedov <tr> 451ae771770SStanislav Sedov <td class="paramkey"></td> 452ae771770SStanislav Sedov <td></td> 453ae771770SStanislav Sedov <td class="paramtype">const char * </td> 454ae771770SStanislav Sedov <td class="paramname"> <em>in_tkt_service</em>, </td> 455ae771770SStanislav Sedov </tr> 456ae771770SStanislav Sedov <tr> 457ae771770SStanislav Sedov <td class="paramkey"></td> 458ae771770SStanislav Sedov <td></td> 459ae771770SStanislav Sedov <td class="paramtype">krb5_get_init_creds_opt * </td> 460ae771770SStanislav Sedov <td class="paramname"> <em>options</em></td><td> </td> 461ae771770SStanislav Sedov </tr> 462ae771770SStanislav Sedov <tr> 463ae771770SStanislav Sedov <td></td> 464ae771770SStanislav Sedov <td>)</td> 465ae771770SStanislav Sedov <td></td><td></td><td></td> 466ae771770SStanislav Sedov </tr> 467ae771770SStanislav Sedov </table> 468ae771770SStanislav Sedov</div> 469ae771770SStanislav Sedov<div class="memdoc"> 470ae771770SStanislav Sedov 471ae771770SStanislav Sedov<p> 472ae771770SStanislav SedovGet new credentials using password. 473ae771770SStanislav Sedov</div> 474ae771770SStanislav Sedov</div><p> 475ae771770SStanislav Sedov<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)" --> 476ae771770SStanislav Sedov<div class="memitem"> 477ae771770SStanislav Sedov<div class="memproto"> 478ae771770SStanislav Sedov <table class="memname"> 479ae771770SStanislav Sedov <tr> 480ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION void KRB5_LIB_CALL krb5_init_creds_free </td> 481ae771770SStanislav Sedov <td>(</td> 482ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 483ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 484ae771770SStanislav Sedov </tr> 485ae771770SStanislav Sedov <tr> 486ae771770SStanislav Sedov <td class="paramkey"></td> 487ae771770SStanislav Sedov <td></td> 488ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context </td> 489ae771770SStanislav Sedov <td class="paramname"> <em>ctx</em></td><td> </td> 490ae771770SStanislav Sedov </tr> 491ae771770SStanislav Sedov <tr> 492ae771770SStanislav Sedov <td></td> 493ae771770SStanislav Sedov <td>)</td> 494ae771770SStanislav Sedov <td></td><td></td><td></td> 495ae771770SStanislav Sedov </tr> 496ae771770SStanislav Sedov </table> 497ae771770SStanislav Sedov</div> 498ae771770SStanislav Sedov<div class="memdoc"> 499ae771770SStanislav Sedov 500ae771770SStanislav Sedov<p> 501ae771770SStanislav SedovFree the krb5_init_creds_context allocated by <a class="el" href="group__krb5__credential.html#g1a610bb2706e4048e8220225da110033">krb5_init_creds_init()</a>.<p> 502ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 503ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 504ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A Kerberos 5 context. </td></tr> 505ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>The krb5_init_creds_context to free. </td></tr> 506ae771770SStanislav Sedov </table> 507ae771770SStanislav Sedov</dl> 508ae771770SStanislav Sedov 509ae771770SStanislav Sedov</div> 510ae771770SStanislav Sedov</div><p> 511ae771770SStanislav Sedov<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)" --> 512ae771770SStanislav Sedov<div class="memitem"> 513ae771770SStanislav Sedov<div class="memproto"> 514ae771770SStanislav Sedov <table class="memname"> 515ae771770SStanislav Sedov <tr> 516ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_get </td> 517ae771770SStanislav Sedov <td>(</td> 518ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 519ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 520ae771770SStanislav Sedov </tr> 521ae771770SStanislav Sedov <tr> 522ae771770SStanislav Sedov <td class="paramkey"></td> 523ae771770SStanislav Sedov <td></td> 524ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context </td> 525ae771770SStanislav Sedov <td class="paramname"> <em>ctx</em></td><td> </td> 526ae771770SStanislav Sedov </tr> 527ae771770SStanislav Sedov <tr> 528ae771770SStanislav Sedov <td></td> 529ae771770SStanislav Sedov <td>)</td> 530ae771770SStanislav Sedov <td></td><td></td><td></td> 531ae771770SStanislav Sedov </tr> 532ae771770SStanislav Sedov </table> 533ae771770SStanislav Sedov</div> 534ae771770SStanislav Sedov<div class="memdoc"> 535ae771770SStanislav Sedov 536ae771770SStanislav Sedov<p> 537ae771770SStanislav SedovGet new credentials as setup by the krb5_init_creds_context.<p> 538ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 539ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 540ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A Kerberos 5 context. </td></tr> 541ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>The krb5_init_creds_context to process. </td></tr> 542ae771770SStanislav Sedov </table> 543ae771770SStanislav Sedov</dl> 544ae771770SStanislav Sedov 545ae771770SStanislav Sedov</div> 546ae771770SStanislav Sedov</div><p> 547ae771770SStanislav Sedov<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)" --> 548ae771770SStanislav Sedov<div class="memitem"> 549ae771770SStanislav Sedov<div class="memproto"> 550ae771770SStanislav Sedov <table class="memname"> 551ae771770SStanislav Sedov <tr> 552ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_get_error </td> 553ae771770SStanislav Sedov <td>(</td> 554ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 555ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 556ae771770SStanislav Sedov </tr> 557ae771770SStanislav Sedov <tr> 558ae771770SStanislav Sedov <td class="paramkey"></td> 559ae771770SStanislav Sedov <td></td> 560ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context </td> 561ae771770SStanislav Sedov <td class="paramname"> <em>ctx</em>, </td> 562ae771770SStanislav Sedov </tr> 563ae771770SStanislav Sedov <tr> 564ae771770SStanislav Sedov <td class="paramkey"></td> 565ae771770SStanislav Sedov <td></td> 566ae771770SStanislav Sedov <td class="paramtype">KRB_ERROR * </td> 567ae771770SStanislav Sedov <td class="paramname"> <em>error</em></td><td> </td> 568ae771770SStanislav Sedov </tr> 569ae771770SStanislav Sedov <tr> 570ae771770SStanislav Sedov <td></td> 571ae771770SStanislav Sedov <td>)</td> 572ae771770SStanislav Sedov <td></td><td></td><td></td> 573ae771770SStanislav Sedov </tr> 574ae771770SStanislav Sedov </table> 575ae771770SStanislav Sedov</div> 576ae771770SStanislav Sedov<div class="memdoc"> 577ae771770SStanislav Sedov 578ae771770SStanislav Sedov<p> 579ae771770SStanislav SedovGet the last error from the transaction.<p> 580ae771770SStanislav Sedov<dl class="return" compact><dt><b>Returns:</b></dt><dd>Returns 0 or an error code </dd></dl> 581ae771770SStanislav Sedov 582ae771770SStanislav Sedov</div> 583ae771770SStanislav Sedov</div><p> 584ae771770SStanislav Sedov<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)" --> 585ae771770SStanislav Sedov<div class="memitem"> 586ae771770SStanislav Sedov<div class="memproto"> 587ae771770SStanislav Sedov <table class="memname"> 588ae771770SStanislav Sedov <tr> 589ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_init </td> 590ae771770SStanislav Sedov <td>(</td> 591ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 592ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 593ae771770SStanislav Sedov </tr> 594ae771770SStanislav Sedov <tr> 595ae771770SStanislav Sedov <td class="paramkey"></td> 596ae771770SStanislav Sedov <td></td> 597ae771770SStanislav Sedov <td class="paramtype">krb5_principal </td> 598ae771770SStanislav Sedov <td class="paramname"> <em>client</em>, </td> 599ae771770SStanislav Sedov </tr> 600ae771770SStanislav Sedov <tr> 601ae771770SStanislav Sedov <td class="paramkey"></td> 602ae771770SStanislav Sedov <td></td> 603ae771770SStanislav Sedov <td class="paramtype">krb5_prompter_fct </td> 604ae771770SStanislav Sedov <td class="paramname"> <em>prompter</em>, </td> 605ae771770SStanislav Sedov </tr> 606ae771770SStanislav Sedov <tr> 607ae771770SStanislav Sedov <td class="paramkey"></td> 608ae771770SStanislav Sedov <td></td> 609ae771770SStanislav Sedov <td class="paramtype">void * </td> 610ae771770SStanislav Sedov <td class="paramname"> <em>prompter_data</em>, </td> 611ae771770SStanislav Sedov </tr> 612ae771770SStanislav Sedov <tr> 613ae771770SStanislav Sedov <td class="paramkey"></td> 614ae771770SStanislav Sedov <td></td> 615ae771770SStanislav Sedov <td class="paramtype">krb5_deltat </td> 616ae771770SStanislav Sedov <td class="paramname"> <em>start_time</em>, </td> 617ae771770SStanislav Sedov </tr> 618ae771770SStanislav Sedov <tr> 619ae771770SStanislav Sedov <td class="paramkey"></td> 620ae771770SStanislav Sedov <td></td> 621ae771770SStanislav Sedov <td class="paramtype">krb5_get_init_creds_opt * </td> 622ae771770SStanislav Sedov <td class="paramname"> <em>options</em>, </td> 623ae771770SStanislav Sedov </tr> 624ae771770SStanislav Sedov <tr> 625ae771770SStanislav Sedov <td class="paramkey"></td> 626ae771770SStanislav Sedov <td></td> 627ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context * </td> 628ae771770SStanislav Sedov <td class="paramname"> <em>rctx</em></td><td> </td> 629ae771770SStanislav Sedov </tr> 630ae771770SStanislav Sedov <tr> 631ae771770SStanislav Sedov <td></td> 632ae771770SStanislav Sedov <td>)</td> 633ae771770SStanislav Sedov <td></td><td></td><td></td> 634ae771770SStanislav Sedov </tr> 635ae771770SStanislav Sedov </table> 636ae771770SStanislav Sedov</div> 637ae771770SStanislav Sedov<div class="memdoc"> 638ae771770SStanislav Sedov 639ae771770SStanislav Sedov<p> 640ae771770SStanislav SedovStart a new context to get a new initial credential.<p> 641ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 642ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 643ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>A Kerberos 5 context. </td></tr> 644ae771770SStanislav Sedov <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> 645ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>prompter</em> </td><td></td></tr> 646ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>prompter_data</em> </td><td></td></tr> 647ae771770SStanislav Sedov <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> 648ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>options</em> </td><td>a options structure, can be NULL for default options. </td></tr> 649ae771770SStanislav Sedov <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> 650ae771770SStanislav Sedov </table> 651ae771770SStanislav Sedov</dl> 652ae771770SStanislav Sedov<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> 653ae771770SStanislav Sedov 654ae771770SStanislav Sedov</div> 655ae771770SStanislav Sedov</div><p> 656ae771770SStanislav Sedov<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)" --> 657ae771770SStanislav Sedov<div class="memitem"> 658ae771770SStanislav Sedov<div class="memproto"> 659ae771770SStanislav Sedov <table class="memname"> 660ae771770SStanislav Sedov <tr> 661ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_set_keytab </td> 662ae771770SStanislav Sedov <td>(</td> 663ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 664ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 665ae771770SStanislav Sedov </tr> 666ae771770SStanislav Sedov <tr> 667ae771770SStanislav Sedov <td class="paramkey"></td> 668ae771770SStanislav Sedov <td></td> 669ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context </td> 670ae771770SStanislav Sedov <td class="paramname"> <em>ctx</em>, </td> 671ae771770SStanislav Sedov </tr> 672ae771770SStanislav Sedov <tr> 673ae771770SStanislav Sedov <td class="paramkey"></td> 674ae771770SStanislav Sedov <td></td> 675ae771770SStanislav Sedov <td class="paramtype">krb5_keytab </td> 676ae771770SStanislav Sedov <td class="paramname"> <em>keytab</em></td><td> </td> 677ae771770SStanislav Sedov </tr> 678ae771770SStanislav Sedov <tr> 679ae771770SStanislav Sedov <td></td> 680ae771770SStanislav Sedov <td>)</td> 681ae771770SStanislav Sedov <td></td><td></td><td></td> 682ae771770SStanislav Sedov </tr> 683ae771770SStanislav Sedov </table> 684ae771770SStanislav Sedov</div> 685ae771770SStanislav Sedov<div class="memdoc"> 686ae771770SStanislav Sedov 687ae771770SStanislav Sedov<p> 688ae771770SStanislav SedovSet the keytab to use for authentication.<p> 689ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 690ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 691ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 692ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>ctx krb5_init_creds_context context. </td></tr> 693ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>keytab</em> </td><td>the keytab to read the key from.</td></tr> 694ae771770SStanislav Sedov </table> 695ae771770SStanislav Sedov</dl> 696ae771770SStanislav Sedov<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> 697ae771770SStanislav Sedov 698ae771770SStanislav Sedov</div> 699ae771770SStanislav Sedov</div><p> 700ae771770SStanislav Sedov<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)" --> 701ae771770SStanislav Sedov<div class="memitem"> 702ae771770SStanislav Sedov<div class="memproto"> 703ae771770SStanislav Sedov <table class="memname"> 704ae771770SStanislav Sedov <tr> 705ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_set_password </td> 706ae771770SStanislav Sedov <td>(</td> 707ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 708ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 709ae771770SStanislav Sedov </tr> 710ae771770SStanislav Sedov <tr> 711ae771770SStanislav Sedov <td class="paramkey"></td> 712ae771770SStanislav Sedov <td></td> 713ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context </td> 714ae771770SStanislav Sedov <td class="paramname"> <em>ctx</em>, </td> 715ae771770SStanislav Sedov </tr> 716ae771770SStanislav Sedov <tr> 717ae771770SStanislav Sedov <td class="paramkey"></td> 718ae771770SStanislav Sedov <td></td> 719ae771770SStanislav Sedov <td class="paramtype">const char * </td> 720ae771770SStanislav Sedov <td class="paramname"> <em>password</em></td><td> </td> 721ae771770SStanislav Sedov </tr> 722ae771770SStanislav Sedov <tr> 723ae771770SStanislav Sedov <td></td> 724ae771770SStanislav Sedov <td>)</td> 725ae771770SStanislav Sedov <td></td><td></td><td></td> 726ae771770SStanislav Sedov </tr> 727ae771770SStanislav Sedov </table> 728ae771770SStanislav Sedov</div> 729ae771770SStanislav Sedov<div class="memdoc"> 730ae771770SStanislav Sedov 731ae771770SStanislav Sedov<p> 732ae771770SStanislav SedovSets the password that will use for the request.<p> 733ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 734ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 735ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 736ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>ctx krb5_init_creds_context context. </td></tr> 737ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>password</em> </td><td>the password to use.</td></tr> 738ae771770SStanislav Sedov </table> 739ae771770SStanislav Sedov</dl> 740ae771770SStanislav Sedov<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> 741ae771770SStanislav Sedov 742ae771770SStanislav Sedov</div> 743ae771770SStanislav Sedov</div><p> 744ae771770SStanislav Sedov<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)" --> 745ae771770SStanislav Sedov<div class="memitem"> 746ae771770SStanislav Sedov<div class="memproto"> 747ae771770SStanislav Sedov <table class="memname"> 748ae771770SStanislav Sedov <tr> 749ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_set_service </td> 750ae771770SStanislav Sedov <td>(</td> 751ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 752ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 753ae771770SStanislav Sedov </tr> 754ae771770SStanislav Sedov <tr> 755ae771770SStanislav Sedov <td class="paramkey"></td> 756ae771770SStanislav Sedov <td></td> 757ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context </td> 758ae771770SStanislav Sedov <td class="paramname"> <em>ctx</em>, </td> 759ae771770SStanislav Sedov </tr> 760ae771770SStanislav Sedov <tr> 761ae771770SStanislav Sedov <td class="paramkey"></td> 762ae771770SStanislav Sedov <td></td> 763ae771770SStanislav Sedov <td class="paramtype">const char * </td> 764ae771770SStanislav Sedov <td class="paramname"> <em>service</em></td><td> </td> 765ae771770SStanislav Sedov </tr> 766ae771770SStanislav Sedov <tr> 767ae771770SStanislav Sedov <td></td> 768ae771770SStanislav Sedov <td>)</td> 769ae771770SStanislav Sedov <td></td><td></td><td></td> 770ae771770SStanislav Sedov </tr> 771ae771770SStanislav Sedov </table> 772ae771770SStanislav Sedov</div> 773ae771770SStanislav Sedov<div class="memdoc"> 774ae771770SStanislav Sedov 775ae771770SStanislav Sedov<p> 776ae771770SStanislav SedovSets 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> 777ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 778ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 779ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 780ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>a krb5_init_creds_context context. </td></tr> 781ae771770SStanislav Sedov <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> 782ae771770SStanislav Sedov </table> 783ae771770SStanislav Sedov</dl> 784ae771770SStanislav Sedov<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> 785ae771770SStanislav Sedov 786ae771770SStanislav Sedov</div> 787ae771770SStanislav Sedov</div><p> 788ae771770SStanislav Sedov<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)" --> 789ae771770SStanislav Sedov<div class="memitem"> 790ae771770SStanislav Sedov<div class="memproto"> 791ae771770SStanislav Sedov <table class="memname"> 792ae771770SStanislav Sedov <tr> 793ae771770SStanislav Sedov <td class="memname">KRB5_LIB_FUNCTION krb5_error_code KRB5_LIB_CALL krb5_init_creds_step </td> 794ae771770SStanislav Sedov <td>(</td> 795ae771770SStanislav Sedov <td class="paramtype">krb5_context </td> 796ae771770SStanislav Sedov <td class="paramname"> <em>context</em>, </td> 797ae771770SStanislav Sedov </tr> 798ae771770SStanislav Sedov <tr> 799ae771770SStanislav Sedov <td class="paramkey"></td> 800ae771770SStanislav Sedov <td></td> 801ae771770SStanislav Sedov <td class="paramtype">krb5_init_creds_context </td> 802ae771770SStanislav Sedov <td class="paramname"> <em>ctx</em>, </td> 803ae771770SStanislav Sedov </tr> 804ae771770SStanislav Sedov <tr> 805ae771770SStanislav Sedov <td class="paramkey"></td> 806ae771770SStanislav Sedov <td></td> 807ae771770SStanislav Sedov <td class="paramtype">krb5_data * </td> 808ae771770SStanislav Sedov <td class="paramname"> <em>in</em>, </td> 809ae771770SStanislav Sedov </tr> 810ae771770SStanislav Sedov <tr> 811ae771770SStanislav Sedov <td class="paramkey"></td> 812ae771770SStanislav Sedov <td></td> 813ae771770SStanislav Sedov <td class="paramtype">krb5_data * </td> 814ae771770SStanislav Sedov <td class="paramname"> <em>out</em>, </td> 815ae771770SStanislav Sedov </tr> 816ae771770SStanislav Sedov <tr> 817ae771770SStanislav Sedov <td class="paramkey"></td> 818ae771770SStanislav Sedov <td></td> 819ae771770SStanislav Sedov <td class="paramtype">krb5_krbhst_info * </td> 820ae771770SStanislav Sedov <td class="paramname"> <em>hostinfo</em>, </td> 821ae771770SStanislav Sedov </tr> 822ae771770SStanislav Sedov <tr> 823ae771770SStanislav Sedov <td class="paramkey"></td> 824ae771770SStanislav Sedov <td></td> 825ae771770SStanislav Sedov <td class="paramtype">unsigned int * </td> 826ae771770SStanislav Sedov <td class="paramname"> <em>flags</em></td><td> </td> 827ae771770SStanislav Sedov </tr> 828ae771770SStanislav Sedov <tr> 829ae771770SStanislav Sedov <td></td> 830ae771770SStanislav Sedov <td>)</td> 831ae771770SStanislav Sedov <td></td><td></td><td></td> 832ae771770SStanislav Sedov </tr> 833ae771770SStanislav Sedov </table> 834ae771770SStanislav Sedov</div> 835ae771770SStanislav Sedov<div class="memdoc"> 836ae771770SStanislav Sedov 837ae771770SStanislav Sedov<p> 838ae771770SStanislav SedovThe core loop if krb5_get_init_creds() function family. Create the packets and have the caller send them off to the KDC.<p> 839ae771770SStanislav SedovIf 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> 840ae771770SStanislav Sedov<dl compact><dt><b>Parameters:</b></dt><dd> 841ae771770SStanislav Sedov <table border="0" cellspacing="2" cellpadding="0"> 842ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>context</em> </td><td>a Kerberos 5 context. </td></tr> 843ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>ctx</em> </td><td>ctx krb5_init_creds_context context. </td></tr> 844ae771770SStanislav Sedov <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> 845ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>out</em> </td><td>reply to KDC. </td></tr> 846ae771770SStanislav Sedov <tr><td valign="top"></td><td valign="top"><em>hostinfo</em> </td><td>KDC address info, first round it can be NULL. </td></tr> 847ae771770SStanislav Sedov <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> 848ae771770SStanislav Sedov </table> 849ae771770SStanislav Sedov</dl> 850ae771770SStanislav Sedov<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> 851ae771770SStanislav Sedov 852ae771770SStanislav Sedov</div> 853ae771770SStanislav Sedov</div><p> 854ae771770SStanislav Sedov</div> 855ae771770SStanislav Sedov<hr size="1"><address style="text-align: right;"><small> 856*cf771f22SStanislav SedovGenerated 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> 857ae771770SStanislav Sedov</body> 858ae771770SStanislav Sedov</html> 859
