1VARNISHNCSA(1)                                                  VARNISHNCSA(1)
2
3
4

NAME

6       varnishncsa - Display Varnish logs in Apache / NCSA combined log format
7

SYNOPSIS

9       varnishncsa  [-a] [-b] [-C] [-c] [-D] [-d] [-f] [-I regex] [-i tag] [-n
10       varnish_name] [-P file] [-r file] [-V] [-w file] [-X regex] [-x tag]
11

DESCRIPTION

13       The varnishncsa  utility  reads  varnishd(1)  shared  memory  logs  and
14       presents them in the Apache / NCSA "combined" log format.
15
16       The following options are available:
17
18       -a     When writing to a file, append to it rather than overwrite it.
19
20       -b     Include log entries which result from communication with a back‐
21              end server.  If neither -b nor -c is specified, varnishncsa acts
22              as if they both were.
23
24       -C     Ignore case when matching regular expressions.
25
26       -c     Include  log  entries  which  result  from  communication with a
27              client.  If neither -b nor -c is specified, varnishncsa acts  as
28              if they both were.
29
30       -D     Daemonize.
31
32       -d     Process  old log entries on startup.  Normally, varnishncsa will
33              only process entries which are  written  to  the  log  after  it
34              starts.
35
36       -f     Prefer the X-Forwarded-For HTTP header over client.ip in the log
37              output.
38
39       -I regex
40              Include log entries which match the  specified  regular  expres‐
41              sion.   If  neither  -I nor -i is specified, all log entries are
42              included.
43
44       -i tag Include log entries with the specified tag.  If neither  -I  nor
45              -i is specified, all log entries are included.
46
47       -n     Specifies  the  name  of the varnishd instance to get logs from.
48              If -n is not specified, the host name is used.
49
50       -P file
51              Write the process's PID to the specified file.
52
53       -r file
54              Read log entries from file instead of shared memory.
55
56       -V     Display the version number and exit.
57
58       -w file
59              Write log entries to file instead of displaying them.  The  file
60              will be overwritten unless the -a option was specified.
61
62              If  varnishncsa  receives  a  SIGHUP while writing to a file, it
63              will reopen the file, allowing the old one to be rotated away.
64
65       -X regex
66              Exclude log entries which match the  specified  regular  expres‐
67              sion.
68
69       -x tag Exclude log entries with the specified tag.
70

SEE ALSO

72       · varnishd(1)
73
74       · varnishhist(1)
75
76       · varnishlog(1)
77
78       · varnishstat(1)
79
80       · varnishtop(1)
81

HISTORY

83       The  varnishncsa utility was developed by Poul-Henning Kamp in coopera‐
84       tion with Verdens Gang AS and Linpro AS.  This manual page was  written
85       by Dag-Erling Smørgrav ⟨des@des.no⟩.
86

88       This document is licensed under the same licence as Varnish itself. See
89       LICENCE for details.
90
91       · Copyright (c) 2006 Verdens Gang AS
92
93       · Copyright (c) 2006-2008 Linpro AS
94
95       · Copyright (c) 2008-2010 Redpill Linpro AS
96
97       · Copyright (c) 2010 Varnish Software AS
98

AUTHOR

100       Dag-Erling Smørgrav
101
102
103
104
1051.0                               2010-05-31                    VARNISHNCSA(1)
Impressum