File: krb5_tkt_creds_step.rst.txt

package info (click to toggle)
krb5 1.17-3%2Bdeb10u4
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 53,236 kB
  • sloc: ansic: 305,293; exp: 13,345; cpp: 9,731; javascript: 9,118; python: 8,980; makefile: 7,216; sh: 6,279; perl: 2,391; asm: 1,460; yacc: 1,005; awk: 396; csh: 147; xml: 135; lisp: 104; sed: 41
file content (69 lines) | stat: -rw-r--r-- 1,543 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
krb5_tkt_creds_step -  Get the next KDC request in a TGS exchange. 
===================================================================

..

.. c:function:: krb5_error_code krb5_tkt_creds_step(krb5_context context, krb5_tkt_creds_context ctx, krb5_data * in, krb5_data * out, krb5_data * realm, unsigned int * flags)

..


:param:

	          **[in]** **context** - Library context

	          **[in]** **ctx** - TGS request context

	          **[in]** **in** - KDC response (empty on the first call)

	          **[out]** **out** - Next KDC request

	          **[out]** **realm** - Realm for next KDC request

	          **[out]** **flags** - Output flags


..


:retval:
         -   0   Success; otherwise - Kerberos error codes


..







This function constructs the next KDC request for a TGS exchange, allowing the caller to control the transport of KDC requests and replies. On the first call, *in* should be set to an empty buffer; on subsequent calls, it should be set to the KDC's reply to the previous request.



If more requests are needed, *flags* will be set to :data:`KRB5_TKT_CREDS_STEP_FLAG_CONTINUE` and the next request will be placed in *out* . If no more requests are needed, *flags* will not contain :data:`KRB5_TKT_CREDS_STEP_FLAG_CONTINUE` and *out* will be empty.



If this function returns **KRB5KRB_ERR_RESPONSE_TOO_BIG** , the caller should transmit the next request using TCP rather than UDP. If this function returns any other error, the TGS exchange has failed.










..




.. note::

	 New in 1.9