varnishadm(1) [centos man page]
VARNISHADM(1) VARNISHADM(1) NAME
varnishadm - Control a running varnish instance SYNOPSIS
varnishadm [-t timeout] [-S secret_file] [-T address:port] [-n name] [command [...]] DESCRIPTION
The varnishadm utility establishes a CLI connection to varnishd either using -n name or using the -T and -S arguments. If -n name is given the location of the secret file and the address:port is looked up in shared memory. If neither is given varnishadm will look for an instance without a given name. If a command is given, the command and arguments are sent over the CLI connection and the result returned on stdout. If no command argument is given varnishadm will pass commands and replies between the CLI socket and stdin/stdout. OPTIONS
-t timeout Wait no longer than this many seconds for an operation to finish. -S secret_file Specify the authentication secret file. This should be the same -S argument as was given to varnishd. Only processes which can read the contents of this file, will be able to authenticate the CLI connection. -T address:port Connect to the management interface at the specified address and port. -n name Connect to the instance of varnishd with this name. The syntax and operation of the actual CLI interface is described in the varnish-cli(7) manual page. Parameteres are described in var- nishd(1) manual page. Additionally, a summary of commands can be obtained by issuing the help command, and a summary of parameters can be obtained by issuing the param.show command. EXIT STATUS
If a command is given, the exit status of the varnishadm utility is zero if the command succeeded, and non-zero otherwise. EXAMPLES
Some ways you can use varnishadm:: varnishadm -T localhost:999 -S /var/db/secret vcl.use foo echo vcl.use foo | varnishadm -T localhost:999 -S /var/db/secret echo vcl.use foo | ssh vhost varnishadm -T localhost:999 -S /var/db/secret SEE ALSO
o varnishd(1) HISTORY
The varnishadm utility and this manual page were written by Cecilie Fritzvold. Converted to reStructured and updated in 2010 by Per Buer. COPYRIGHT
This document is licensed under the same licence as Varnish itself. See LICENCE for details. o Copyright (c) 2007-2011 Varnish Software AS AUTHOR
Cecilie Fritzvold, Per Buer 0.3 2010-05-31 VARNISHADM(1)
Check Out this Related Man Page
VARNISHLOG(1) VARNISHLOG(1) NAME
varnishlog - Display Varnish logs SYNOPSIS
varnishlog [-a] [-b] [-C] [-c] [-D] [-d] [-I regex] [-i tag] [-k keep] [-n varnish_name] [-o] [-O] [-m tag:regex ...] [-P file] [-r file] [-s num] [-u] [-V] [-w file] [-X regex] [-x tag] DESCRIPTION
The varnishlog utility reads and presents varnishd(1) shared memory logs. The following options are available: -a When writing to a file, append to it rather than overwrite it. -b Include log entries which result from communication with a backend server. If neither -b nor -c is specified, varnishlog acts as if they both were. -C Ignore case when matching regular expressions. -c Include log entries which result from communication with a client. If neither -b nor -c is specified, varnishlog acts as if they both were. -D Daemonize. -d Process old log entries on startup. Normally, varnishlog will only process entries which are written to the log after it starts. -I regex Include log entries which match the specified regular expression. If neither -I nor -i is specified, all log entries are included. -i tag Include log entries with the specified tag. If neither -I nor -i is specified, all log entries are included. -k num Only show the first num log records. -m tag:regex only list transactions where tag matches regex. Multiple -m options are AND-ed together. Can not be combined with -O -n Specifies the name of the varnishd instance to get logs from. If -n is not specified, the host name is used. -o Ignored for compatibility with earlier versions. -O Do not group log entries by request ID. Can not be combined with -m. -P file Write the process's PID to the specified file. -r file Read log entries from file instead of shared memory. -s num Skip the first num log records. -u Unbuffered output. -V Display the version number and exit. -w file Write log entries to file instead of displaying them. The file will be overwritten unless the -a option was specified. If var- nishlog receives a SIGHUP while writing to a file, it will reopen the file, allowing the old one to be rotated away. -X regex Exclude log entries which match the specified regular expression. -x tag Exclude log entries with the specified tag. TAGS
The following log entry tags are currently defined: o Backend o BackendClose o BackendOpen o BackendReuse o BackendXID o CLI o ClientAddr o Debug o Error o ExpBan o ExpKill o ExpPick o Hit o HitPass o HttpError o HttpGarbage o Length o ObjHeader o ObjLostHeader o ObjProtocol o ObjRequest o ObjResponse o ObjStatus o ObjURL o ReqEnd o ReqStart o RxHeader o RxLostHeader o RxProtocol o RxRequest o RxResponse o RxStatus o RxURL o SessionClose o SessionOpen o StatAddr o StatSess o TTL o TxHeader o TxLostHeader o TxProtocol o TxRequest o TxResponse o TxStatus o TxURL o VCL_acl o VCL_call o VCL_return o VCL_trace o WorkThread EXAMPLES
The following command line simply copies all log entries to a log file:: $ varnishlog -w /var/log/varnish.log The following command line reads that same log file and displays requests for the front page:: $ varnishlog -r /var/log/varnish.log -c -m 'RxURL:^/$' SEE ALSO
o varnishd(1) o varnishhist(1) o varnishncsa(1) o varnishstat(1) o varnishtop(1) HISTORY
The varnishlog utility was developed by Poul-Henning Kamp <phk@phk.freebsd.dk> in cooperation with Verdens Gang AS, Varnish Software AS and Varnish Software. This manual page was initially written by Dag-Erling Smorgrav. COPYRIGHT
This document is licensed under the same licence as Varnish itself. See LICENCE for details. o Copyright (c) 2006 Verdens Gang AS o Copyright (c) 2006-2011 Varnish Software AS AUTHOR
Dag-Erling Smorgrav, Per Buer 0.2 2010-05-31 VARNISHLOG(1)