Imported Upstream version 1.15.2
[platform/upstream/krb5.git] / doc / html / _sources / appdev / refs / api / krb5_set_trace_filename.txt
1 krb5_set_trace_filename -  Specify a file name for directing trace events. 
2 ===========================================================================
3
4 ..
5
6 .. c:function:: krb5_error_code krb5_set_trace_filename(krb5_context context, const char * filename)
7
8 ..
9
10
11 :param:
12
13                   **[in]** **context** - Library context
14
15                   **[in]** **filename** - File name
16
17
18 ..
19
20
21 :retval:
22          -   KRB5_TRACE_NOSUPP   Tracing is not supported in the library.
23
24
25 ..
26
27
28
29
30
31
32
33 Open *filename* for appending (creating it, if necessary) and set up a callback to write trace events to it.
34
35
36
37
38
39
40
41
42
43
44 ..
45
46
47
48
49
50
51 .. note::
52
53          This function overrides the information passed through the *KRB5_TRACE* environment variable.
54  
55
56
57 .. note::
58
59          New in 1.9
60  
61