1wLog(7)                               2.0                              wLog(7)
2
3
4

NAME

6       wLog - WinPR logging facility
7
8

DESCRIPTION

10       wLog  is  a  configurable  and  flexible logging system used throughout
11       WinPR and FreeRDP.
12
13       The primary concept is to have a hierarchy of loggers that  can  be  be
14       configured independently.
15
16

Appenders

18       WLog  uses  different appenders that define where the log output should
19       be written to. If the  application  doesn't  explicitly  configure  the
20       appenders  the  below  described  variable WLOG_APPENDER can be used to
21       choose one appender.
22
23       The following kind of appenders are available:
24
25
26       Binary Write the log data into a binary format file.
27
28
29       Console
30              The console appender writes to the  console.  Depending  of  the
31              operating  system  the  application runs on, the output might be
32              handled differently. For example on android log print  would  be
33              used.
34
35
36       File   The file appender writes the textual output to a file.
37
38
39       Udp    This appender sends the logging messages to a pre-defined remote
40              host via UDP.
41
42              If no target is set the default one 127.0.0.1:20000 is used.  To
43              receive  the  log  messages  one  can use netcat. To receive the
44              default  target  the  following  command  can  be  used:  nc  -u
45              127.0.0.1 -p 20000 -l
46
47       Syslog Use syslog for outputting the debug messages.
48
49       Journald
50              This appender outputs messages to journald.
51
52

Levels

54       The  WLog are complementary, the higher level always includes the lower
55       ones.  The level list below is top down. Top the highest level.
56
57
58       TRACE  print everything including packets dumps
59
60       DEBUG  debug messages
61
62       INFO   general information
63
64       WARN   warnings
65
66       ERROR  errors
67
68       FATAL  fatal problems
69
70       OFF    completely disable the wlog output
71
72

Formats

74       The format a logger prints has the following possible options:
75
76
77       lv     log level
78
79       mn     module name
80
81       fl     file name
82
83       fn     function
84
85       ln     line number
86
87       pid    process id
88
89       tid    thread id
90
91       yr     year
92
93       mo     month
94
95       dw     day of week
96
97       hr     hour
98
99       mi     minute
100
101       se     second
102
103       ml     millisecond
104
105       A maximum of 16 options can be used per format string.
106
107       An example that generally sets the WLOG_PREFIX for xfreerdp would  look
108       like: WLOG_PREFIX="pid=%pid:tid=%tid:fn=%fn -" xfreerdp /v:xxx
109
110
111

ENVIRONMENT

113       WLOG_APPENDER
114              The  kind  of  appender, the accepted values are: CONSOLE, FILE,
115              BINARY, SYSLOG, JOURNALD or UDP
116
117
118       WLOG_PREFIX
119              configure the prefix used for outputting the message (see Format
120              for more details and examples)
121
122
123       WLOG_LEVEL
124              the level to output messages for
125
126
127       WLOG_FILTER
128              sets  a filter for WLog messages. Only the filtered messages are
129              printed. The format  of  the  filter  is  a  series  of  <logger
130              name>:<level> separated by comas
131
132              example: WLOG_FILTER=core.channel:DEBUG,dummy:TRACE will display
133              debug messages for the core.channel logger and trace  level  for
134              the dummy logger
135
136
137       WLOG_FILEAPPENDER_OUTPUT_FILE_PATH
138              When  using  the  file  appender  it may contains the output log
139              file's path
140
141
142       WLOG_FILEAPPENDER_OUTPUT_FILE_NAME
143              When using the file appender it  may  contains  the  output  log
144              file's name
145
146
147       WLOG_JOURNALD_ID
148              When  using the systemd journal appender, this variable contains
149              the id used with the journal (by default the executable's name)
150
151
152       WLOG_UDP_TARGET
153              target to use for the UDP appender in the format host:port
154
155

BUGS

157       Please report any bugs using the bug reporting form on the FreeRDP  web
158       site
159
160

SEE ALSO

162       Additional  information  and the latest version is available at the web
163       site: http://www.freerdp.com
164
165

AUTHOR

167       David Fort <contact@hardening-consulting.com> wrote this  manpage  from
168       materials   written   by   Bernhard  Miklautz  <bernhard.miklautz@thin‐
169       cast.com>.
170
171
172
173
174Version                            June 2016                           wLog(7)
Impressum