varnishd中文man page(1)

HTTP accelerator daemon （HTTP加速进程）

         Author:    Dag-Erling Smørgrav

         Author:    Stig Sandbeck Mathisen

         Author:    Per Buer

  SYNOPSIS （大纲）

                  varnishd [-a address[:port]] [-b host[:port]] [-d] [-F] [-f config]

             [-g group] [-h type[,options]] [-i identity] [-l shmlogsize] [-n name] [-P file] [-p                                  param=value] [-s type[,options]] [-T address[:port]] [-t ttl] [-u user] [-V] [-w    min[,max[,timeout]]]

         DESCRIPTION（描述）

         Varnishd进程接收客户端的 HTTP请求，然后把请求发送给后端服务器，缓存后端    服务器返回的内容，这样更好的满足以后相同的请求。

OPTIONS（选项）

         -a address： [:port][,address]

                   监听指定的 IP地址和端口的请求。地址可以是主机名（“ localhost”），或者一   个 IPV4（“ 127.0.0.1”），和 IPV6（“ [::1]”） ,如果地址没有明确指定， varnishd将监听所   有可用的 IPV4和 IPV6地址。如果端口没有指定，那么 varnishd默认监听 /etc/services   中的 HTTP对应的端口。更多的端口和地址使用逗号分隔。

         -b    host[:port]

                   指定后端服务器的地址和端口，如果没有指定端口，默认的是 8080.

         -C    编译 VCL代码成 C语言，然后退出，指定 VCL文件用 -f参数。

         -d    开启 debug模式。主进程在前段启动，提供一个 CLI界面用于标准输入和输出，子进程必须通过 CLI命令启动。如果结束主进程，那么子进程也会结束。

   -F     在前端运行。

         -f     config  使用指定的 VCL配置文件代替系统默认的。参见 VCL（ 7）

         -g    group  指定 varnishd子进程使用的用户组。

         -h    type[,options]  指定 hash算法。

         -i       identity              指定 varnishd server的身份。

         -l       shmlogsize       指定 shmlogfile的大小，单位可以使用‘ k’和‘ m’，默认是 80M，    如果指定比 8M小，那是不明智的。

         -n      name        为这个实例指定一个名字。

         -P      file    指定 pidfile，用于保存 PID信息。

         -p      param=value   设定指定参数的值，查看运行时的阐述列表

         -S      file    访问管理端口用到的安全认证文件的路径

         -s      type[,options]           使用指定的存储后端，查看存储列表获得支持的存储类型。可以多次使用此选项指定不同的存储类型。

         -T      address[:port]

                   提供一个管理接口的地址和端口，通过管理接口查看管理命令。

         -t      ttl     指定最小的 TTL给 cache中的内容。这是一个捷径设置 default_ttl run-time 选项。

         -u      user 指定运行 varnishd子进程的用户。

   -V     显示 varnishd的版本，然后退出。

         -w     min[,max[,timeout]]

                   指定线程最小和最大空闲时间。这是一个设置 thread_pool_min和 thread_pool_max、 thread_pool_timeout的捷径。

                   如果只有一个值被指定，那么 thread_pool_min和 thread_pool_max都是用这个值。 Thread_poll_timeout会失效。

Hash Algorithms（hash算法）

         以下 hash算法是可用的：

         Simple_list        一个简单的 doubly-linked列表，不推荐生产环境应用。

         Classic[,buckets]      一个标准的 hash表，默认使用这个。

         Critbit       xxx   very nice。

Storage Types（存储类型）

         下面的存储类型是可用的：

         malloc[,size]

                   存储目标分配给 malloc（ 3）。

                   Size参数指定最大分配给 varnishd的内存， size默认的单位是 bytes。除非你指定以下单位

                   K       \\kibibytes

                   M     \\membibytes

                   G      \\gibibytes

                   T       \\tebibytes

                   默认没有限制

         File[,path[,size[,granularity]]]

                   把存储目标分配给一个文件，这个是默认的。

                   Path参数指定文件名和路径，或者 path指定一个目录， varnishd会自己创建文件。默认在 /tmp目录。

                   Size参数指定最大分配给 varnishd的内存， size默认的单位是 bytes。除非你指定以下单位

                   K       \\kibibytes

                   M     \\membibytes

                   G      \\gibibytes

                   T       \\tebibytes

                   %使用所属文件系统空闲空间的百分比。

                   默认是 50%

                   如果文件已经存在，那么 varnishd会缩减或者扩大 backing文件到指定 size。

                   注意：如果 varnishd需要创建或者扩大一个文件，之前没有设置好空间的话，可能会产生碎片，这样会影响性能。在分配文件之前使用 dd命令来创建文件，这                           样可以尽量减少碎片。

                   Granularity参数指定分配的间隔尺寸，默认的单位是字节，你可以自定义单位，除了使用 %。

                   默认的间隔尺寸就是虚拟内存相同。如果有太多的小文件，那么空间就会减少。

Management Interface（管理接口）

         如果指定了-T选项，varnishd将提供一个命令行的管理接口在指定的地址和接口。西面的命令式可以用的：

                   help [command]

                            显示可用命令列表

                   param.set param value

                            给参数设定值，参见参数列表

                   param.show [-l] [param]

                            显示运行时参数和值的列表

                            如果使用 -l选项，列表会对每个参数做一些描述。

                            如果 param被指定，那么只显示指定的 param。

                   ping           [timestamp]

                            Ping varnishd的进程，查看连接是否存活。

                   purge field operator argument [&& field operator argument […]]

                            匹配 purge表达式的内容，马上失效。

                   purge.list

                            显示 purge列表

                            所有在 cache中的请求目标和 purge.list相比，如果 cache中的目标比匹配的 purge list旧，就会考虑清楚这些旧的目标，从后端服务器获取新的代替。

                            如果一个清洗表达式比 cache中的目标就，那么就会从 purge list中删除它们。

                   purge.url          regexp

                            使缓存中匹配表达式的 URL马上失效。

                   quit

                            关闭 varnish admin 的连接。

                   start

                            如果 varnish cache程序没有运行，在这里可以启动这个进程。

                   stats

                            显示简要的统计信息。

                            所有的数据是服务器启动后开始统计，更好的观察方式是使用 varnishstat工具。

                   status

                            检查 varnish cache进程的状态。

                   stop

                            停止 varnish cache进程

                   url.purge           regexp

                            弃用，使用 purge.url代替。

                   vcl.discard        configname

                            丢弃指定的 VCL配置文件。

                   vcl.inline            configname vcl

                            创建一个 vcl配置文件， configname是配置文件的名字， vcl 是配置文件的 VCL代码。

                   vcl.list

                            显示当前可用的 vcl列表， active表示当前使用的配置文件。

                   vcl.load    configname filename

                            创建一个新的配置文件， configname是配置的名字， filename是 vcl配置文件的路径和名字。

                   vcl.show  config

                            显示 vcl配置文件的源代码。

                   vcl.use      configname

                            对所有新的请求指定 vcl配置文件，已经存在的请求使用抵达时的配置文件。