1PENLOGD(1)                  General Commands Manual                 PENLOGD(1)
2
3
4

NAME

6       penlogd - consolidate web server logs
7
8

SYNOPSIS

10       penlogd [-fd] [-j dir] [-l logfile] [-n N] [-p pidfile] [-u user] port
11
12

EXAMPLE

14       penlogd -l /var/log/access_log -p /var/run/penlogd.pid 10000
15
16

DESCRIPTION

18       Penlogd receives log entries from Pen and from each of the web servers.
19       It consolidates the entries by replacing the source addresses  in  each
20       entry with the "real" client address and writes the result to stdout or
21       to the file given on the command line.   This  completely  removes  the
22       need  for  postprocessing  with  mergelogs,  since the logs are already
23       merged.
24
25       Pen must be instructed to send its log to penlogd. See  HOWTO  and  pen
26       man page for details.
27
28       Sending penlogd a HUP signal will make it close and reopen the logfile,
29       unless it is logging to stdout. Rotate the log like this:
30
31       mv access_log access_log.1 kill -HUP `cat <pidfile>`
32
33       where <pidfile> is the file containing pen's process id.
34
35       Sending penlogd a TERM signal will make it close the log file and  exit
36       cleanly.
37
38

OPTIONS

40       -d     Turn  on  debugging. The output goes to stderr if we are running
41              in the foreground (see -f) and to syslog (facility user,  prior‐
42              ity debug) otherwise.
43
44       -f     Stay in foreground.
45
46       -j dir Run in a chroot environment.
47
48       -l logfile
49              Write output into logfile.
50
51       -n N   Number of pen log entries to cache (default 1000).
52
53       -p pidfile
54              Write process id into pidfile.
55
56       -u user
57              Run as a different user.
58
59       port   The UDP port where penlogd receives log entries.
60
61

SEE ALSO

63       pen(1), penlog(1), webresolve(1)
64
65

AUTHOR

67       Copyright (C) 2002-2015 Ulric Eriksson, <ulric@siag.nu>.
68
69
70
71                                     LOCAL                          PENLOGD(1)