1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
|
.TH squid 8 2006-05-29 "@PACKAGE_STRING@"
.\" Copyright and licensing information
.\" goes here.
.SH NAME
squid \- proxy caching server
.SH SYNOPSIS
.B squid
[
.B \-dhirsvzCDFNRVYX
] [
.BI \-l " facility"
] [
.BI \-f " config-file"
] [
\-[
.B au
]
.I port
] [
.B \-k " signal"
] [
.BI \-n " service-name"
] [
.BI \-O " cmd-line"
]
.SH DESCRIPTION
.B squid
is a high-performance proxy caching server for web clients,
supporting FTP, gopher, and HTTP data objects. Unlike traditional
caching software,
.B squid
handles all requests in a single, non-blocking, I/O-driven process.
.PP
.B squid
keeps meta data and especially hot objects cached in RAM,
caches DNS lookups, supports non-blocking DNS lookups, and implements
negative caching of failed requests.
.PP
.B squid
supports SSL, extensive access controls, and full request
logging. By using the lightweight Internet Cache Protocol,
.B squid
caches can be arranged in a hierarchy or mesh for additional
bandwidth savings.
.PP
.B squid
consists of a main server program squid, a Domain Name System
lookup program dnsserver, some optional programs for rewriting
requests and performing authentication, and some management and client
tools. When squid starts up, it spawns a configurable number of
dnsserver processes, each of which can perform a single, blocking
Domain Name System (DNS) lookup. This reduces the amount of time the
cache waits for DNS lookups.
.PP
.B squid
is derived from the ARPA-funded Harvest Project
http://harvest.cs.colorado.edu/
.PP
This manual page only lists the command line arguments. For details
on how to configure
.B squid
see the file
.BI @DEFAULT_CONFIG_FILE@,
the Squid FAQ and the documentation at the
.B squid
home page http://www.squid-cache.org
.PP
.SH OPTIONS
.IP "-d level"
Write debugging to stderr also.
.IP "-f file"
Use the given config-file instead of
.I @DEFAULT_CONFIG_FILE@
.IP -h
Print help message.
.IP -i
Install as a Windows Service (see -n option).
.IP "-k reconfigure | rotate | shutdown | interrupt | kill | debug | check | parse"
Parse configuration file, then send signal to running copy
(except -k parse) and exit.
.IP "-n name"
Specify Windows Service name to use for service operations, default is:
.BI Squid
.
.IP -r
Remove a Windows Service (see -n option).
.IP -s
Enable logging to syslog.
.IP "-l facility"
Use specified syslog facility. implies -s
.IP "-u port"
Specify ICP port number (default: 3130), disable with 0.
.IP -v
Print version.
.IP -z
Create swap directories
.IP -C
Do not catch fatal signals.
.IP -D
Disable initial DNS tests.
.IP -F
Don't serve any requests until store is rebuilt.
.IP -N
No daemon mode.
.IP "-O options"
Set Windows Service Command line options in Registry.
.IP -R
Do not set REUSEADDR on port.
.IP -X
Force full debugging.
.IP -Y
Only return UDP_HIT or UDP_MISS_NOFETCH during fast reload.
.SH FILES
.I @DEFAULT_CONFIG_FILE@
.RS
The main configuration file. You must initially make
changes to this file for
.B squid
to work. For example, the default configuration does not
allow access from any browser.
.RE
.I @DEFAULT_CONFIG_FILE@.default
.RS
Reference copy of the configuration file. Always kept up to date with
the version of Squid you are using. Use this to look up configuration
syntax after upgrading.
.RE
.I @DEFAULT_MIME_TABLE@ (mime_table)
.RS
MIME type mappings for FTP gatewaying
.RE
.I @DEFAULT_ERROR_DIR@ (error_directory)
.RS
Error page templates
.RE
.SH SEE ALSO
.BR cachemgr.cgi "(8), "
.BR ncsa_auth "(8), "
.BR pam_auth "(8), "
.BR squid_ldap_auth "(8), "
.BR squid_ldap_group "(8), "
.BR squid_session "(8), "
.BR squid_unix_group "(8), "
.br
.B The Squid FAQ
.\" Could add the following sections:
.\" .SH ENVIRONMENT
.\" .SH DIAGNOSTICS
.\" .SH BUGS
.\" .SH AUTHOR
.\" .SH SEE ALSO
|
