← Back to branch summary

~hartmans/ubuntu/trusty/krb5/gss-infinite-loop

« back to all changes in this revision

Viewing changes to doc/html/_sources/appdev/refs/api/krb5_mk_priv.txt

  • Committer: Package Import Robot
  • Author(s): Dmitrijs Ledkovs
  • Date: 2013-11-10 02:20:12 UTC
  • mfrom: (53.1.3 trusty-proposed)
  • Revision ID: package-import@ubuntu.com-20131110022012-b8ojkqhcxos55kln
Tags: 1.11.3+dfsg-3ubuntu2
Add alternate dependency on libverto-libevent1 as that's the package
ABI name in ubuntu.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/_sources/appdev/refs/api/krb5_mk_priv.txt
 
1
krb5_mk_priv -  Format a KRB-PRIV message. 
 
2
===========================================
 
3
 
 
4
..
 
5
 
 
6
.. c:function:: krb5_error_code krb5_mk_priv(krb5_context context, krb5_auth_context auth_context, const krb5_data * userdata, krb5_data * outbuf, krb5_replay_data * outdata)
 
7
 
 
8
..
 
9
 
 
10
 
 
11
:param:
 
12
 
 
13
                  **[in]** **context** - Library context
 
14
 
 
15
                  **[inout]** **auth_context** - Authentication context
 
16
 
 
17
                  **[in]** **userdata** - User data for **KRB-PRIV** message
 
18
 
 
19
                  **[out]** **outbuf** - Formatted **KRB-PRIV** message
 
20
 
 
21
                  **[out]** **outdata** - Replay cache handle (NULL if not needed)
 
22
 
 
23
 
 
24
..
 
25
 
 
26
 
 
27
:retval:
 
28
         -   0   Success; otherwise - Kerberos error codes
 
29
 
 
30
 
 
31
..
 
32
 
 
33
 
 
34
 
 
35
 
 
36
 
 
37
 
 
38
 
 
39
This function is similar to :c:func:`krb5_mk_safe()` , but the message is encrypted and integrity-protected, not just integrity-protected.
 
40
 
 
41
 
 
42
 
 
43
The local address in *auth_context* must be set, and is used to form the sender address used in the KRB-SAFE message. The remote address is optional; if specified, it will be used to form the receiver address used in the message.
 
44
 
 
45
 
 
46
 
 
47
 
 
48
 
 
49
         - :data:`KRB5_AUTH_CONTEXT_DO_TIME` - Use timestamps in *outdata* 
 
50
 
 
51
 
 
52
         - :data:`KRB5_AUTH_CONTEXT_RET_TIME` - Copy timestamp to *outdata* .
 
53
 
 
54
 
 
55
         - :data:`KRB5_AUTH_CONTEXT_DO_SEQUENCE` - Use local sequence numbers from *auth_context* in replay cache.
 
56
 
 
57
 
 
58
         - :data:`KRB5_AUTH_CONTEXT_RET_SEQUENCE` - Use local sequence numbers from *auth_context* as a sequence number in the encrypted message *outbuf* .
 
59
 
 
60
 
 
61
 
 
62
 
 
63
 
 
64
 
 
65
 
 
66
 
 
67
..
 
68
 
 
69
 
 
70
 
 
71
 
 
72
 
 
73
 
 
74
.. note::
 
75
 
 
76
         If the :data:`KRB5_AUTH_CONTEXT_RET_TIME` or :data:`KRB5_AUTH_CONTEXT_RET_SEQUENCE` flag is set in *auth_context* , the *outdata* is required.
 
77
 
 
78
         The flags from *auth_context* specify whether sequence numbers or timestamps will be used to identify the message. Valid values are:
 
79
 
 
80
 
 
81
 
 
82