← Back to branch summary

~ubuntu-branches/ubuntu/saucy/varnish/saucy

« back to all changes in this revision

Viewing changes to bin/varnishsizes/varnishsizes.1

  • Committer: Bazaar Package Importer
  • Author(s): Stig Sandbeck Mathisen
  • Date: 2011-03-21 10:16:07 UTC
  • mfrom: (24.1.2 experimental)
  • Revision ID: james.westby@ubuntu.com-20110321101607-528fzl583fqanas5
Tags: 2.1.5-2
Release for unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/varnishsizes/varnishsizes.1
1
 
.\"-
2
 
.\" Copyright (c) 2006 Verdens Gang AS
3
 
.\" Copyright (c) 2006-2009 Linpro AS
4
 
.\" All rights reserved.
5
 
.\"
6
 
.\" Author: Dag-Erling Smørgrav <des@des.no>
7
 
.\"
8
 
.\" Redistribution and use in source and binary forms, with or without
9
 
.\" modification, are permitted provided that the following conditions
10
 
.\" are met:
11
 
.\" 1. Redistributions of source code must retain the above copyright
12
 
.\"    notice, this list of conditions and the following disclaimer.
13
 
.\" 2. Redistributions in binary form must reproduce the above copyright
14
 
.\"    notice, this list of conditions and the following disclaimer in the
15
 
.\"    documentation and/or other materials provided with the distribution.
16
 
.\"
17
 
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
18
 
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19
 
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20
 
.\" ARE DISCLAIMED.  IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
21
 
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22
 
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23
 
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24
 
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25
 
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26
 
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27
 
.\" SUCH DAMAGE.
28
 
.\"
29
 
.\" $Id: varnishsizes.1 4709 2010-04-21 10:40:27Z tfheen $
30
 
.\"
31
 
.Dd June 28, 2007
32
 
.Dt VARNISHSIZES 1
33
 
.Os
34
 
.Sh NAME
35
 
.Nm varnishsizes
36
 
.Nd Varnish request histogram
37
 
.Sh SYNOPSIS
38
 
.Nm
39
 
.Op Fl b
40
 
.Op Fl C
41
 
.Op Fl c
42
 
.Op Fl d
43
 
.Op Fl I Ar regex
44
 
.Op Fl i Ar tag
45
 
.Op Fl n Ar varnish_name
46
 
.Op Fl r Ar file
47
 
.Op Fl V
48
 
.Op Fl w Ar delay
49
 
.Op Fl X Ar regex
50
 
.Op Fl x Ar tag
51
 
.Sh DESCRIPTION
52
 
The
53
 
.Nm
54
 
utility reads
55
 
.Xr varnishd 1
56
 
shared memory logs and presents a continuously updated histogram
57
 
showing the distribution of the last
58
 
.Va N
59
 
requests by their processing.
60
 
The value of
61
 
.Va N
62
 
and the vertical scale are displayed in the top left corner.
63
 
The horizontal scale is logarithmic.
64
 
Hits are marked with a pipe character ("|"), and misses are marked
65
 
with a hash character ("#").
66
 
.Pp
67
 
The following options are available:
68
 
.Bl -tag -width Fl
69
 
.It Fl b
70
 
Include log entries which result from communication with a backend
71
 
server.
72
 
If neither
73
 
.Fl b
74
 
nor
75
 
.Fl c
76
 
is specified,
77
 
.Nm
78
 
acts as if they both were.
79
 
.It Fl C
80
 
Ignore case when matching regular expressions.
81
 
.It Fl c
82
 
Include log entries which result from communication with a client.
83
 
If neither
84
 
.Fl b
85
 
nor
86
 
.Fl c
87
 
is specified,
88
 
.Nm
89
 
acts as if they both were.
90
 
.It Fl d
91
 
Process old log entries on startup.
92
 
Normally,
93
 
.Nm
94
 
will only process entries which are written to the log after it
95
 
starts.
96
 
.It Fl I Ar regex
97
 
Include log entries which match the specified regular expression.
98
 
If neither
99
 
.Fl I
100
 
nor
101
 
.Fl i
102
 
is specified, all log entries are included.
103
 
.It Fl i Ar tag
104
 
Include log entries with the specified tag.
105
 
If neither
106
 
.Fl I
107
 
nor
108
 
.Fl i
109
 
is specified, all log entries are included.
110
 
.It Fl n
111
 
Specifies the name of the
112
 
.Nm varnishd
113
 
instance to get logs from.
114
 
If
115
 
.Fl n
116
 
is not specified, the host name is used.
117
 
.It Fl r Ar file
118
 
Read log entries from
119
 
.Ar file
120
 
instead of shared memory.
121
 
.It Fl V
122
 
Display the version number and exit.
123
 
.It Fl w Ar delay
124
 
Wait at least
125
 
.Ar delay
126
 
seconds between each update.
127
 
The default is 1.
128
 
.Ar file
129
 
instead of displaying them.
130
 
The file will be overwritten unless the
131
 
.Fl a
132
 
option was specified.
133
 
.It Fl X Ar regex
134
 
Exclude log entries which match the specified regular expression.
135
 
.It Fl x Ar tag
136
 
Exclude log entries with the specified tag.
137
 
.El
138
 
.Sh SEE ALSO
139
 
.Xr varnishd 1 ,
140
 
.Xr varnishlog 1 ,
141
 
.Xr varnishncsa 1 ,
142
 
.Xr varnishstat 1 ,
143
 
.Xr varnishtop 1
144
 
.Sh SIZESORY
145
 
The
146
 
.Nm
147
 
utility was developed by
148
 
.An Poul-Henning Kamp Aq phk@phk.freebsd.dk
149
 
in cooperation with Verdens Gang AS and Linpro AS.
150
 
This manual page was written by
151
 
.An Dag-Erling Sm\(/orgrav Aq des@des.no .