xref: /freebsd/crypto/krb5/doc/html/_sources/appdev/refs/api/krb5_set_trace_filename.rst.txt (revision 7f2fe78b9dd5f51c821d771b63d2e096f6fd49e9)
1krb5_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
33Open *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
62