Imported Upstream version 1.15.2
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / api / krb5_c_random_os_entropy.txt
1 krb5_c_random_os_entropy -  Collect entropy from the OS if possible. 
2 =====================================================================
3
4 ..
5
6 .. c:function:: krb5_error_code krb5_c_random_os_entropy(krb5_context context, int strong, int * success)
7
8 ..
9
10
11 :param:
12
13                   **[in]** **context** - Library context
14
15                   **[in]** **strong** - Strongest available source of entropy
16
17                   **[out]** **success** - 1 if OS provides entropy, 0 otherwise
18
19
20 ..
21
22
23 :retval:
24          -   0   Success; otherwise - Kerberos error codes
25
26
27 ..
28
29
30
31
32
33
34
35 If *strong* is non-zero, this function attempts to use the strongest available source of entropy. Setting this flag may cause the function to block on some operating systems. Good uses include seeding the PRNG for kadmind and realm setup.
36
37
38
39
40
41
42
43
44
45
46 ..
47
48
49
50
51