← Back to branch summary

~ubuntu-branches/ubuntu/trusty/varnish/trusty-proposed

« back to all changes in this revision

Viewing changes to bin/varnishd/varnishd.1

  • Committer: Package Import Robot
  • Author(s): Stig Sandbeck Mathisen, Stig Sandbeck Mathisen, Tollef Fog Heen
  • Date: 2013-05-05 15:53:14 UTC
  • mfrom: (0.1.16)
  • Revision ID: package-import@ubuntu.com-20130505155314-i99wuol99cfwzrtv
Tags: 3.0.3-1
http://bugs.debian.org/698577
http://bugs.debian.org/698577
[ Stig Sandbeck Mathisen ]
* New upstream release

[ Tollef Fog Heen ]
* Make varnishlog's and varnishncsa's init script exit with the exit
  status of status_of_proc to make them useful.  Fixes upstream trac
  #1226.

[ Stig Sandbeck Mathisen ]
* Do not rewrite /etc/default/varnish on upgrade.
  Thanks to Andreas Beckmann <anbe@debian.org> (Closes: 698577)
* Undo mangling of /etc/default/varnish that happened during lenny->squeeze
  upgrade.
  Thanks to Andreas Beckmann <anbe@debian.org> (Closes: 698577)

Show diffs side-by-side

added added

removed removed

Lines of Context:
bin/varnishd/varnishd.1
34
34
.INDENT 0.0
35
35
.TP
36
36
.B varnishd [\-a address[:port]] [\-b host[:port]] [\-d] [\-F] [\-f config]
37
 
.
38
37
[\-g group] [\-h type[,options]] [\-i identity]
39
38
[\-l shmlogsize] [\-n name] [\-P file] [\-p param=value]
40
39
[\-s type[,options]] [\-T address[:port]] [\-t ttl]
48
47
.INDENT 0.0
49
48
.TP
50
49
.B \-a address[:port][,address[:port][...]
51
 
.
52
50
Listen for client requests on the specified address and port.  The address can be a host
53
51
name (“localhost”), an IPv4 dotted\-quad (“127.0.0.1”), or an IPv6 address enclosed in
54
52
square brackets (“[::1]”).  If address is not specified, varnishd will listen on all
57
55
fied as a whitespace\- or comma\-separated list.
58
56
.TP
59
57
.B \-b host[:port]
60
 
.
61
58
Use the specified host as backend server.  If port is not specified,
62
59
the default is 8080.
63
60
.UNINDENT
64
61
.INDENT 0.0
65
62
.TP
66
63
.B \-C
67
 
.
68
64
Print VCL code compiled to C language and exit. Specify the VCL file
69
65
to compile with the \-f option.
70
66
.TP
71
67
.B \-d
72
 
.
73
68
Enables debugging mode: The parent process runs in the foreground with a CLI connection
74
69
on stdin/stdout, and the child process must be started explicitly with a CLI command.
75
70
Terminating the parent process will also terminate the child.
76
71
.TP
77
72
.B \-F
78
 
.
79
73
Run in the foreground.
80
74
.TP
81
75
.BI \-f \ config
82
 
.
83
76
Use the specified VCL configuration file instead of the
84
77
builtin default.  See vcl(7) for details on VCL
85
78
syntax. When no configuration is supplied varnishd will
86
79
not start the cache process.
87
80
.TP
88
81
.BI \-g \ group
89
 
.
90
82
Specifies the name of an unprivileged group to which the child process should switch
91
83
before it starts accepting connections.  This is a shortcut for specifying the group
92
84
run\-time parameter.
94
86
.INDENT 0.0
95
87
.TP
96
88
.B \-h type[,options]
97
 
.
98
89
Specifies the hash algorithm.  See Hash Algorithms for a list of supported algorithms.
99
90
.UNINDENT
100
91
.INDENT 0.0
101
92
.TP
102
93
.BI \-i \ identity
103
 
.
104
94
Specify the identity of the varnish server.  This can be accessed using server.identity
105
95
from VCL
106
96
.TP
107
97
.BI \-l \ shmlogsize
108
 
.
109
98
Specify size of shmlog file.  Scaling suffixes like \(aqk\(aq, \(aqm\(aq can be used up to
110
99
(e)tabytes.  Default is 80 Megabytes.  Specifying less than 8 Megabytes is unwise.
111
100
.TP
112
101
.BI \-n \ name
113
 
.
114
102
Specify a name for this instance.  Amonst other things, this name is used to construct
115
103
the name of the directory in which varnishd keeps temporary files and persistent state.
116
104
If the specified name begins with a forward slash, it is interpreted as the absolute
117
105
path to the directory which should be used for this purpose.
118
106
.TP
119
107
.BI \-P \ file
120
 
.
121
108
Write the process\(aqs PID to the specified file.
122
109
.UNINDENT
123
110
.INDENT 0.0
124
111
.TP
125
112
.B \-p param=value
126
 
.
127
113
Set the parameter specified by param to the specified value.  See Run\-Time
128
114
Parameters for a list of parameters. This option can be used multiple
129
115
times to specify multiple parameters.
131
117
.INDENT 0.0
132
118
.TP
133
119
.BI \-S \ file
134
 
.
135
120
Path to a file containing a secret used for authorizing access to the management port.
136
121
.UNINDENT
137
122
.INDENT 0.0
138
123
.TP
139
124
.B \-s [name=]type[,options]
140
 
.
141
125
Use the specified storage backend.  See Storage Types for a list of supported storage
142
126
types.  This option can be used multiple times to specify multiple storage files. You
143
127
can name the different backends. Varnish will then reference that backend with the
144
128
given name in logs, statistics, etc.
145
129
.TP
146
130
.B \-T address[:port]
147
 
.
148
131
Offer a management interface on the specified address and port.  See Management
149
132
Interface for a list of management commands.
150
133
.TP
151
134
.B \-M address:port
152
 
.
153
135
Connect to this port and offer the command line
154
136
interface. Think of it as a reverse shell. When running with
155
137
\-M and there is no backend defined the child process (the cache)
158
140
.INDENT 0.0
159
141
.TP
160
142
.BI \-t \ ttl
161
 
.
162
143
Specifies a hard minimum time to live for cached
163
144
documents.  This is a shortcut for specifying the
164
145
default_ttl run\-time parameter.
165
146
.TP
166
147
.BI \-u \ user
167
 
.
168
148
Specifies the name of an unprivileged user to which the child
169
149
process should switch before it starts accepting
170
150
connections.  This is a shortcut for specifying the user
174
154
specified first.
175
155
.TP
176
156
.B \-V
177
 
.
178
157
Display the version number and exit.
179
158
.UNINDENT
180
159
.sp
181
160
\-w min[,max[,timeout]]
182
161
.INDENT 0.0
183
162
.INDENT 3.5
184
 
.sp
185
163
Start at least min but no more than max worker threads
186
164
with the specified idle timeout.  This is a shortcut for
187
165
specifying the thread_pool_min, thread_pool_max and
198
176
.INDENT 0.0
199
177
.TP
200
178
.B simple_list
201
 
.
202
179
A simple doubly\-linked list.  Not recommended for production use.
203
180
.TP
204
181
.B classic[,buckets]
205
 
.
206
182
A standard hash table.  This is the default.  The hash key is the
207
183
CRC32 of the object\(aqs URL modulo the size of the hash table.  Each
208
184
table entry points to a list of elements which share the same hash
210
186
hash table.  The default is 16383.
211
187
.TP
212
188
.B critbit
213
 
.
214
189
A self\-scaling tree structure. The default hash algorithm in 2.1. In
215
190
comparison to a more traditional B tree the critbit tree is almost
216
191
completely lockless.
221
196
.INDENT 0.0
222
197
.TP
223
198
.B malloc[,size]
224
 
.
225
199
Storage for each object is allocated with malloc(3).
226
200
.sp
227
201
The size parameter specifies the maximum amount of memory varnishd will allocate.  The size is assumed to
238
212
The default size is unlimited.
239
213
.TP
240
214
.B file[,path[,size[,granularity]]]
241
 
.
242
215
Storage for each object is allocated from an arena backed by a file.  This is the default.
243
216
.sp
244
217
The path parameter specifies either the path to the backing file or the path to a directory in which
275
248
persistent,path,size {experimental}
276
249
.INDENT 0.0
277
250
.INDENT 3.5
278
 
.sp
279
251
Persistent storage. Varnish will store objects in a file in a
280
252
manner that will secure the survival of \fImost\fP of the objects in
281
253
the event of a planned or unplanned shutdown of Varnish.
305
277
.SS Transient Storage
306
278
.INDENT 0.0
307
279
.INDENT 3.5
308
 
.sp
309
280
If you name any of your storage backend "Transient" it will be
310
281
used for transient (short lived) objects. By default Varnish
311
282
would use an unlimited malloc backend for this.
324
295
.INDENT 0.0
325
296
.TP
326
297
.B experimental
327
 
.
328
298
We have no solid information about good/bad/optimal values for this parameter.  Feedback with experience
329
299
and observations are most welcome.
330
300
.TP
331
301
.B delayed
332
 
.
333
302
This parameter can be changed on the fly, but will not take effect immediately.
334
303
.TP
335
304
.B restart
336
 
.
337
305
The worker process must be stopped and restarted, before this parameter takes effect.
338
306
.TP
339
307
.B reload
340
 
.
341
308
The VCL programs must be reloaded for this parameter to take effect.
342
309
.UNINDENT
343
310
.sp
352
319
.B acceptor_sleep_decay
353
320
.INDENT 7.0
354
321
.IP \(bu 2
355
 
.
356
322
Default: 0.900
357
323
.IP \(bu 2
358
 
.
359
324
Flags: experimental
360
325
.UNINDENT
361
326
.sp
365
330
.B acceptor_sleep_incr
366
331
.INDENT 7.0
367
332
.IP \(bu 2
368
 
.
369
333
Units: s
370
334
.IP \(bu 2
371
 
.
372
335
Default: 0.001
373
336
.IP \(bu 2
374
 
.
375
337
Flags: experimental
376
338
.UNINDENT
377
339
.sp
381
343
.B acceptor_sleep_max
382
344
.INDENT 7.0
383
345
.IP \(bu 2
384
 
.
385
346
Units: s
386
347
.IP \(bu 2
387
 
.
388
348
Default: 0.050
389
349
.IP \(bu 2
390
 
.
391
350
Flags: experimental
392
351
.UNINDENT
393
352
.sp
397
356
.B auto_restart
398
357
.INDENT 7.0
399
358
.IP \(bu 2
400
 
.
401
359
Units: bool
402
360
.IP \(bu 2
403
 
.
404
361
Default: on
405
362
.UNINDENT
406
363
.sp
409
366
.B ban_dups
410
367
.INDENT 7.0
411
368
.IP \(bu 2
412
 
.
413
369
Units: bool
414
370
.IP \(bu 2
415
 
.
416
371
Default: on
417
372
.UNINDENT
418
373
.sp
421
376
.B ban_lurker_sleep
422
377
.INDENT 7.0
423
378
.IP \(bu 2
424
 
.
425
379
Units: s
426
380
.IP \(bu 2
427
 
.
428
381
Default: 0.01
429
382
.UNINDENT
430
383
.sp
434
387
.B between_bytes_timeout
435
388
.INDENT 7.0
436
389
.IP \(bu 2
437
 
.
438
390
Units: s
439
391
.IP \(bu 2
440
 
.
441
392
Default: 60
442
393
.UNINDENT
443
394
.sp
446
397
.B cc_command
447
398
.INDENT 7.0
448
399
.IP \(bu 2
449
 
.
450
400
Default: exec gcc \-std=gnu99  \-pthread \-fpic \-shared \-Wl,\-x \-o %o %s
451
401
.IP \(bu 2
452
 
.
453
402
Flags: must_reload
454
403
.UNINDENT
455
404
.sp
458
407
.B cli_buffer
459
408
.INDENT 7.0
460
409
.IP \(bu 2
461
 
.
462
410
Units: bytes
463
411
.IP \(bu 2
464
 
.
465
412
Default: 8192
466
413
.UNINDENT
467
414
.sp
472
419
.B cli_timeout
473
420
.INDENT 7.0
474
421
.IP \(bu 2
475
 
.
476
422
Units: seconds
477
423
.IP \(bu 2
478
 
.
479
424
Default: 10
480
425
.UNINDENT
481
426
.sp
484
429
.B clock_skew
485
430
.INDENT 7.0
486
431
.IP \(bu 2
487
 
.
488
432
Units: s
489
433
.IP \(bu 2
490
 
.
491
434
Default: 10
492
435
.UNINDENT
493
436
.sp
496
439
.B connect_timeout
497
440
.INDENT 7.0
498
441
.IP \(bu 2
499
 
.
500
442
Units: s
501
443
.IP \(bu 2
502
 
.
503
444
Default: 0.7
504
445
.UNINDENT
505
446
.sp
508
449
.B critbit_cooloff
509
450
.INDENT 7.0
510
451
.IP \(bu 2
511
 
.
512
452
Units: s
513
453
.IP \(bu 2
514
 
.
515
454
Default: 180.0
516
455
.IP \(bu 2
517
 
.
518
456
Flags:
519
457
.UNINDENT
520
458
.sp
523
461
.B default_grace
524
462
.INDENT 7.0
525
463
.IP \(bu 2
526
 
.
527
464
Units: seconds
528
465
.IP \(bu 2
529
 
.
530
466
Default: 10
531
467
.IP \(bu 2
532
 
.
533
468
Flags: delayed
534
469
.UNINDENT
535
470
.sp
539
474
.B default_keep
540
475
.INDENT 7.0
541
476
.IP \(bu 2
542
 
.
543
477
Units: seconds
544
478
.IP \(bu 2
545
 
.
546
479
Default: 0
547
480
.IP \(bu 2
548
 
.
549
481
Flags: delayed
550
482
.UNINDENT
551
483
.sp
554
486
.B default_ttl
555
487
.INDENT 7.0
556
488
.IP \(bu 2
557
 
.
558
489
Units: seconds
559
490
.IP \(bu 2
560
 
.
561
491
Default: 120
562
492
.UNINDENT
563
493
.sp
568
498
.B diag_bitmap
569
499
.INDENT 7.0
570
500
.IP \(bu 2
571
 
.
572
501
Units: bitmap
573
502
.IP \(bu 2
574
 
.
575
503
Default: 0
576
504
.UNINDENT
577
505
.sp
592
520
0x00010000 \- synchronize shmlog.
593
521
0x00020000 \- synchronous start of persistence.
594
522
0x00040000 \- release VCL early.
 
523
0x00080000 \- ban\-lurker debugging.
595
524
0x80000000 \- do edge\-detection on digest.
596
525
.ft P
597
526
.fi
598
 
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 131)"
599
 
.
 
527
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 132)"
600
528
Literal block ends without a blank line; unexpected unindent.
601
529
.sp
602
530
Use 0x notation and do the bitor in your head :\-)
604
532
.B esi_syntax
605
533
.INDENT 7.0
606
534
.IP \(bu 2
607
 
.
608
535
Units: bitmap
609
536
.IP \(bu 2
610
 
.
611
537
Default: 0
612
538
.UNINDENT
613
539
.sp
621
547
0x00000008 \- Force\-split parser input (debugging)
622
548
.ft P
623
549
.fi
624
 
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 143)"
625
 
.
 
550
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 144)"
626
551
Literal block ends without a blank line; unexpected unindent.
627
552
.sp
628
553
Use 0x notation and do the bitor in your head :\-)
630
555
.B expiry_sleep
631
556
.INDENT 7.0
632
557
.IP \(bu 2
633
 
.
634
558
Units: seconds
635
559
.IP \(bu 2
636
 
.
637
560
Default: 1
638
561
.UNINDENT
639
562
.sp
642
565
.B fetch_chunksize
643
566
.INDENT 7.0
644
567
.IP \(bu 2
645
 
.
646
568
Units: kilobytes
647
569
.IP \(bu 2
648
 
.
649
570
Default: 128
650
571
.IP \(bu 2
651
 
.
652
572
Flags: experimental
653
573
.UNINDENT
654
574
.sp
658
578
.B fetch_maxchunksize
659
579
.INDENT 7.0
660
580
.IP \(bu 2
661
 
.
662
581
Units: kilobytes
663
582
.IP \(bu 2
664
 
.
665
583
Default: 262144
666
584
.IP \(bu 2
667
 
.
668
585
Flags: experimental
669
586
.UNINDENT
670
587
.sp
673
590
.B first_byte_timeout
674
591
.INDENT 7.0
675
592
.IP \(bu 2
676
 
.
677
593
Units: s
678
594
.IP \(bu 2
679
 
.
680
595
Default: 60
681
596
.UNINDENT
682
597
.sp
685
600
.B group
686
601
.INDENT 7.0
687
602
.IP \(bu 2
688
 
.
689
603
Default: magic
690
604
.IP \(bu 2
691
 
.
692
605
Flags: must_restart
693
606
.UNINDENT
694
607
.sp
697
610
.B gzip_level
698
611
.INDENT 7.0
699
612
.IP \(bu 2
700
 
.
701
613
Default: 6
702
614
.UNINDENT
703
615
.sp
706
618
.B gzip_memlevel
707
619
.INDENT 7.0
708
620
.IP \(bu 2
709
 
.
710
621
Default: 8
711
622
.UNINDENT
712
623
.sp
716
627
.B gzip_stack_buffer
717
628
.INDENT 7.0
718
629
.IP \(bu 2
719
 
.
720
630
Units: Bytes
721
631
.IP \(bu 2
722
 
.
723
632
Default: 32768
724
633
.IP \(bu 2
725
 
.
726
634
Flags: experimental
727
635
.UNINDENT
728
636
.sp
732
640
.B gzip_tmp_space
733
641
.INDENT 7.0
734
642
.IP \(bu 2
735
 
.
736
643
Default: 0
737
644
.IP \(bu 2
738
 
.
739
645
Flags: experimental
740
646
.UNINDENT
741
647
.sp
748
654
2 \- thread workspace
749
655
.ft P
750
656
.fi
751
 
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 206)"
752
 
.
 
657
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 207)"
753
658
Literal block ends without a blank line; unexpected unindent.
754
659
.sp
755
660
If you have much gzip/gunzip activity, it may be an advantage to use workspace for these allocations to reduce malloc activity.  Be aware that gzip needs 256+KB and gunzip needs 32+KB of workspace (64+KB if ESI processing).
757
662
.B gzip_window
758
663
.INDENT 7.0
759
664
.IP \(bu 2
760
 
.
761
665
Default: 15
762
666
.UNINDENT
763
667
.sp
767
671
.B http_gzip_support
768
672
.INDENT 7.0
769
673
.IP \(bu 2
770
 
.
771
674
Units: bool
772
675
.IP \(bu 2
773
 
.
774
676
Default: on
775
677
.IP \(bu 2
776
 
.
777
678
Flags: experimental
778
679
.UNINDENT
779
680
.sp
780
681
Enable gzip support. When enabled Varnish will compress uncompressed objects before they are stored in the cache. If a client does not support gzip encoding Varnish will uncompress compressed objects on demand. Varnish will also rewrite the Accept\-Encoding header of clients indicating support for gzip to:
781
 
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 221)"
782
 
.
 
682
.IP "System Message: WARNING/2 (../../doc/sphinx/reference/params.rst:, line 222)"
783
683
Literal block expected; none found.
784
684
.sp
785
685
Accept\-Encoding: gzip
789
689
.B http_max_hdr
790
690
.INDENT 7.0
791
691
.IP \(bu 2
792
 
.
793
692
Units: header lines
794
693
.IP \(bu 2
795
 
.
796
694
Default: 64
797
695
.UNINDENT
798
696
.sp
802
700
.B http_range_support
803
701
.INDENT 7.0
804
702
.IP \(bu 2
805
 
.
806
703
Units: bool
807
704
.IP \(bu 2
808
 
.
809
705
Default: on
810
 
.IP \(bu 2
811
 
.
812
 
Flags: experimental
813
706
.UNINDENT
814
707
.sp
815
708
Enable support for HTTP Range headers.
817
710
.B http_req_hdr_len
818
711
.INDENT 7.0
819
712
.IP \(bu 2
820
 
.
821
713
Units: bytes
822
714
.IP \(bu 2
823
 
.
824
 
Default: 4096
 
715
Default: 8192
825
716
.UNINDENT
826
717
.sp
827
718
Maximum length of any HTTP client request header we will allow.  The limit is inclusive its continuation lines.
829
720
.B http_req_size
830
721
.INDENT 7.0
831
722
.IP \(bu 2
832
 
.
833
723
Units: bytes
834
724
.IP \(bu 2
835
 
.
836
725
Default: 32768
837
726
.UNINDENT
838
727
.sp
842
731
.B http_resp_hdr_len
843
732
.INDENT 7.0
844
733
.IP \(bu 2
845
 
.
846
734
Units: bytes
847
735
.IP \(bu 2
848
 
.
849
 
Default: 4096
 
736
Default: 8192
850
737
.UNINDENT
851
738
.sp
852
739
Maximum length of any HTTP backend response header we will allow.  The limit is inclusive its continuation lines.
854
741
.B http_resp_size
855
742
.INDENT 7.0
856
743
.IP \(bu 2
857
 
.
858
744
Units: bytes
859
745
.IP \(bu 2
860
 
.
861
746
Default: 32768
862
747
.UNINDENT
863
748
.sp
864
749
Maximum number of bytes of HTTP backend resonse we will deal with.  This is a limit on all bytes up to the double blank line which ends the HTTP request.
865
750
The memory for the request is allocated from the worker workspace (param: sess_workspace) and this parameter limits how much of that the request is allowed to take up.
866
751
.TP
 
752
.B idle_send_timeout
 
753
.INDENT 7.0
 
754
.IP \(bu 2
 
755
Units: seconds
 
756
.IP \(bu 2
 
757
Default: 60
 
758
.IP \(bu 2
 
759
Flags: delayed
 
760
.UNINDENT
 
761
.sp
 
762
Time to wait with no data sent. If no data has been transmitted in this many
 
763
seconds the session is closed.
 
764
See setsockopt(2) under SO_SNDTIMEO for more information.
 
765
.TP
867
766
.B listen_address
868
767
.INDENT 7.0
869
768
.IP \(bu 2
870
 
.
871
769
Default: :80
872
770
.IP \(bu 2
873
 
.
874
771
Flags: must_restart
875
772
.UNINDENT
876
773
.sp
880
777
.B listen_depth
881
778
.INDENT 7.0
882
779
.IP \(bu 2
883
 
.
884
780
Units: connections
885
781
.IP \(bu 2
886
 
.
887
782
Default: 1024
888
783
.IP \(bu 2
889
 
.
890
784
Flags: must_restart
891
785
.UNINDENT
892
786
.sp
895
789
.B log_hashstring
896
790
.INDENT 7.0
897
791
.IP \(bu 2
898
 
.
899
792
Units: bool
900
793
.IP \(bu 2
901
 
.
902
794
Default: on
903
795
.UNINDENT
904
796
.sp
907
799
.B log_local_address
908
800
.INDENT 7.0
909
801
.IP \(bu 2
910
 
.
911
802
Units: bool
912
803
.IP \(bu 2
913
 
.
914
804
Default: off
915
805
.UNINDENT
916
806
.sp
919
809
.B lru_interval
920
810
.INDENT 7.0
921
811
.IP \(bu 2
922
 
.
923
812
Units: seconds
924
813
.IP \(bu 2
925
 
.
926
814
Default: 2
927
815
.IP \(bu 2
928
 
.
929
816
Flags: experimental
930
817
.UNINDENT
931
818
.sp
935
822
.B max_esi_depth
936
823
.INDENT 7.0
937
824
.IP \(bu 2
938
 
.
939
825
Units: levels
940
826
.IP \(bu 2
941
 
.
942
827
Default: 5
943
828
.UNINDENT
944
829
.sp
947
832
.B max_restarts
948
833
.INDENT 7.0
949
834
.IP \(bu 2
950
 
.
951
835
Units: restarts
952
836
.IP \(bu 2
953
 
.
954
837
Default: 4
955
838
.UNINDENT
956
839
.sp
960
843
.B nuke_limit
961
844
.INDENT 7.0
962
845
.IP \(bu 2
963
 
.
964
846
Units: allocations
965
847
.IP \(bu 2
966
 
.
967
 
Default: 10
 
848
Default: 50
968
849
.IP \(bu 2
969
 
.
970
850
Flags: experimental
971
851
.UNINDENT
972
852
.sp
973
853
Maximum number of objects we attempt to nuke in orderto make space for a object body.
974
854
.TP
 
855
.B pcre_match_limit
 
856
.INDENT 7.0
 
857
.IP \(bu 2
 
858
Default: 10000
 
859
.UNINDENT
 
860
.sp
 
861
The limit for the  number of internal matching function calls in a pcre_exec() execution.
 
862
.TP
 
863
.B pcre_match_limit_recursion
 
864
.INDENT 7.0
 
865
.IP \(bu 2
 
866
Default: 10000
 
867
.UNINDENT
 
868
.sp
 
869
The limit for the  number of internal matching function recursions in a pcre_exec() execution.
 
870
.TP
975
871
.B ping_interval
976
872
.INDENT 7.0
977
873
.IP \(bu 2
978
 
.
979
874
Units: seconds
980
875
.IP \(bu 2
981
 
.
982
876
Default: 3
983
877
.IP \(bu 2
984
 
.
985
878
Flags: must_restart
986
879
.UNINDENT
987
880
.sp
991
884
.B pipe_timeout
992
885
.INDENT 7.0
993
886
.IP \(bu 2
994
 
.
995
887
Units: seconds
996
888
.IP \(bu 2
997
 
.
998
889
Default: 60
999
890
.UNINDENT
1000
891
.sp
1003
894
.B prefer_ipv6
1004
895
.INDENT 7.0
1005
896
.IP \(bu 2
1006
 
.
1007
897
Units: bool
1008
898
.IP \(bu 2
1009
 
.
1010
899
Default: off
1011
900
.UNINDENT
1012
901
.sp
1015
904
.B queue_max
1016
905
.INDENT 7.0
1017
906
.IP \(bu 2
1018
 
.
1019
907
Units: %
1020
908
.IP \(bu 2
1021
 
.
1022
909
Default: 100
1023
910
.IP \(bu 2
1024
 
.
1025
911
Flags: experimental
1026
912
.UNINDENT
1027
913
.sp
1032
918
.B rush_exponent
1033
919
.INDENT 7.0
1034
920
.IP \(bu 2
1035
 
.
1036
921
Units: requests per request
1037
922
.IP \(bu 2
1038
 
.
1039
923
Default: 3
1040
924
.IP \(bu 2
1041
 
.
1042
925
Flags: experimental
1043
926
.UNINDENT
1044
927
.sp
1048
931
.B saintmode_threshold
1049
932
.INDENT 7.0
1050
933
.IP \(bu 2
1051
 
.
1052
934
Units: objects
1053
935
.IP \(bu 2
1054
 
.
1055
936
Default: 10
1056
937
.IP \(bu 2
1057
 
.
1058
938
Flags: experimental
1059
939
.UNINDENT
1060
940
.sp
1063
943
.B send_timeout
1064
944
.INDENT 7.0
1065
945
.IP \(bu 2
1066
 
.
1067
946
Units: seconds
1068
947
.IP \(bu 2
1069
 
.
1070
 
Default: 60
 
948
Default: 600
1071
949
.IP \(bu 2
1072
 
.
1073
950
Flags: delayed
1074
951
.UNINDENT
1075
952
.sp
1080
957
.B sess_timeout
1081
958
.INDENT 7.0
1082
959
.IP \(bu 2
1083
 
.
1084
960
Units: seconds
1085
961
.IP \(bu 2
1086
 
.
1087
962
Default: 5
1088
963
.UNINDENT
1089
964
.sp
1092
967
.B sess_workspace
1093
968
.INDENT 7.0
1094
969
.IP \(bu 2
1095
 
.
1096
970
Units: bytes
1097
971
.IP \(bu 2
1098
 
.
1099
972
Default: 65536
1100
973
.IP \(bu 2
1101
 
.
1102
974
Flags: delayed
1103
975
.UNINDENT
1104
976
.sp
1108
980
.B session_linger
1109
981
.INDENT 7.0
1110
982
.IP \(bu 2
1111
 
.
1112
983
Units: ms
1113
984
.IP \(bu 2
1114
 
.
1115
985
Default: 50
1116
986
.IP \(bu 2
1117
 
.
1118
987
Flags: experimental
1119
988
.UNINDENT
1120
989
.sp
1125
994
.B session_max
1126
995
.INDENT 7.0
1127
996
.IP \(bu 2
1128
 
.
1129
997
Units: sessions
1130
998
.IP \(bu 2
1131
 
.
1132
999
Default: 100000
1133
1000
.UNINDENT
1134
1001
.sp
1138
1005
.B shm_reclen
1139
1006
.INDENT 7.0
1140
1007
.IP \(bu 2
1141
 
.
1142
1008
Units: bytes
1143
1009
.IP \(bu 2
1144
 
.
1145
1010
Default: 255
1146
1011
.UNINDENT
1147
1012
.sp
1151
1016
.B shm_workspace
1152
1017
.INDENT 7.0
1153
1018
.IP \(bu 2
1154
 
.
1155
1019
Units: bytes
1156
1020
.IP \(bu 2
1157
 
.
1158
1021
Default: 8192
1159
1022
.IP \(bu 2
1160
 
.
1161
1023
Flags: delayed
1162
1024
.UNINDENT
1163
1025
.sp
1168
1030
.B shortlived
1169
1031
.INDENT 7.0
1170
1032
.IP \(bu 2
1171
 
.
1172
1033
Units: s
1173
1034
.IP \(bu 2
1174
 
.
1175
1035
Default: 10.0
1176
1036
.UNINDENT
1177
1037
.sp
1180
1040
.B syslog_cli_traffic
1181
1041
.INDENT 7.0
1182
1042
.IP \(bu 2
1183
 
.
1184
1043
Units: bool
1185
1044
.IP \(bu 2
1186
 
.
1187
1045
Default: on
1188
1046
.UNINDENT
1189
1047
.sp
1192
1050
.B thread_pool_add_delay
1193
1051
.INDENT 7.0
1194
1052
.IP \(bu 2
1195
 
.
1196
1053
Units: milliseconds
1197
1054
.IP \(bu 2
1198
 
.
1199
1055
Default: 2
1200
1056
.UNINDENT
1201
1057
.sp
1208
1064
.B thread_pool_add_threshold
1209
1065
.INDENT 7.0
1210
1066
.IP \(bu 2
1211
 
.
1212
1067
Units: requests
1213
1068
.IP \(bu 2
1214
 
.
1215
1069
Default: 2
1216
1070
.IP \(bu 2
1217
 
.
1218
1071
Flags: experimental
1219
1072
.UNINDENT
1220
1073
.sp
1227
1080
.B thread_pool_fail_delay
1228
1081
.INDENT 7.0
1229
1082
.IP \(bu 2
1230
 
.
1231
1083
Units: milliseconds
1232
1084
.IP \(bu 2
1233
 
.
1234
1085
Default: 200
1235
1086
.IP \(bu 2
1236
 
.
1237
1087
Flags: experimental
1238
1088
.UNINDENT
1239
1089
.sp
1249
1099
.B thread_pool_max
1250
1100
.INDENT 7.0
1251
1101
.IP \(bu 2
1252
 
.
1253
1102
Units: threads
1254
1103
.IP \(bu 2
1255
 
.
1256
1104
Default: 500
1257
1105
.IP \(bu 2
1258
 
.
1259
1106
Flags: delayed, experimental
1260
1107
.UNINDENT
1261
1108
.sp
1266
1113
.B thread_pool_min
1267
1114
.INDENT 7.0
1268
1115
.IP \(bu 2
1269
 
.
1270
1116
Units: threads
1271
1117
.IP \(bu 2
1272
 
.
1273
1118
Default: 5
1274
1119
.IP \(bu 2
1275
 
.
1276
1120
Flags: delayed, experimental
1277
1121
.UNINDENT
1278
1122
.sp
1285
1129
.B thread_pool_purge_delay
1286
1130
.INDENT 7.0
1287
1131
.IP \(bu 2
1288
 
.
1289
1132
Units: milliseconds
1290
1133
.IP \(bu 2
1291
 
.
1292
1134
Default: 1000
1293
1135
.IP \(bu 2
1294
 
.
1295
1136
Flags: delayed, experimental
1296
1137
.UNINDENT
1297
1138
.sp
1304
1145
.B thread_pool_stack
1305
1146
.INDENT 7.0
1306
1147
.IP \(bu 2
1307
 
.
1308
1148
Units: bytes
1309
1149
.IP \(bu 2
1310
 
.
1311
1150
Default: \-1
1312
1151
.IP \(bu 2
1313
 
.
1314
1152
Flags: experimental
1315
1153
.UNINDENT
1316
1154
.sp
1320
1158
.B thread_pool_timeout
1321
1159
.INDENT 7.0
1322
1160
.IP \(bu 2
1323
 
.
1324
1161
Units: seconds
1325
1162
.IP \(bu 2
1326
 
.
1327
1163
Default: 300
1328
1164
.IP \(bu 2
1329
 
.
1330
1165
Flags: delayed, experimental
1331
1166
.UNINDENT
1332
1167
.sp
1339
1174
.B thread_pool_workspace
1340
1175
.INDENT 7.0
1341
1176
.IP \(bu 2
1342
 
.
1343
1177
Units: bytes
1344
1178
.IP \(bu 2
1345
 
.
1346
1179
Default: 65536
1347
1180
.IP \(bu 2
1348
 
.
1349
1181
Flags: delayed
1350
1182
.UNINDENT
1351
1183
.sp
1354
1186
.B thread_pools
1355
1187
.INDENT 7.0
1356
1188
.IP \(bu 2
1357
 
.
1358
1189
Units: pools
1359
1190
.IP \(bu 2
1360
 
.
1361
1191
Default: 2
1362
1192
.IP \(bu 2
1363
 
.
1364
1193
Flags: delayed, experimental
1365
1194
.UNINDENT
1366
1195
.sp
1375
1204
.B thread_stats_rate
1376
1205
.INDENT 7.0
1377
1206
.IP \(bu 2
1378
 
.
1379
1207
Units: requests
1380
1208
.IP \(bu 2
1381
 
.
1382
1209
Default: 10
1383
1210
.IP \(bu 2
1384
 
.
1385
1211
Flags: experimental
1386
1212
.UNINDENT
1387
1213
.sp
1391
1217
.B user
1392
1218
.INDENT 7.0
1393
1219
.IP \(bu 2
1394
 
.
1395
1220
Default: magic
1396
1221
.IP \(bu 2
1397
 
.
1398
1222
Flags: must_restart
1399
1223
.UNINDENT
1400
1224
.sp
1403
1227
.B vcc_err_unref
1404
1228
.INDENT 7.0
1405
1229
.IP \(bu 2
1406
 
.
1407
1230
Units: bool
1408
1231
.IP \(bu 2
1409
 
.
1410
1232
Default: on
1411
1233
.UNINDENT
1412
1234
.sp
1415
1237
.B vcl_dir
1416
1238
.INDENT 7.0
1417
1239
.IP \(bu 2
1418
 
.
1419
1240
Default: /usr/local/etc/varnish
1420
1241
.UNINDENT
1421
1242
.sp
1424
1245
.B vcl_trace
1425
1246
.INDENT 7.0
1426
1247
.IP \(bu 2
1427
 
.
1428
1248
Units: bool
1429
1249
.IP \(bu 2
1430
 
.
1431
1250
Default: off
1432
1251
.UNINDENT
1433
1252
.sp
1438
1257
.B vmod_dir
1439
1258
.INDENT 7.0
1440
1259
.IP \(bu 2
1441
 
.
1442
1260
Default: /usr/local/lib/varnish/vmods
1443
1261
.UNINDENT
1444
1262
.sp
1447
1265
.B waiter
1448
1266
.INDENT 7.0
1449
1267
.IP \(bu 2
1450
 
.
1451
1268
Default: default
1452
1269
.IP \(bu 2
1453
 
.
1454
1270
Flags: must_restart, experimental
1455
1271
.UNINDENT
1456
1272
.sp
1459
1275
.SH SEE ALSO
1460
1276
.INDENT 0.0
1461
1277
.IP \(bu 2
1462
 
.
1463
1278
varnish\-cli(7)
1464
1279
.IP \(bu 2
1465
 
.
1466
1280
varnishlog(1)
1467
1281
.IP \(bu 2
1468
 
.
1469
1282
varnishhist(1)
1470
1283
.IP \(bu 2
1471
 
.
1472
1284
varnishncsa(1)
1473
1285
.IP \(bu 2
1474
 
.
1475
1286
varnishstat(1)
1476
1287
.IP \(bu 2
1477
 
.
1478
1288
varnishtop(1)
1479
1289
.IP \(bu 2
1480
 
.
1481
1290
vcl(7)
1482
1291
.UNINDENT
1483
1292
.SH HISTORY
1493
1302
itself. See LICENCE for details.
1494
1303
.INDENT 0.0
1495
1304
.IP \(bu 2
1496
 
.
1497
1305
Copyright (c) 2007\-2011 Varnish Software AS
1498
1306
.UNINDENT
1499
1307
.SH AUTHOR