]>
Commit | Line | Data |
---|---|---|
83915266 AJ |
1 | .if !'po4a'hide' .TH squidclient 1 |
2 | . | |
06952d61 | 3 | .SH NAME |
d632afde | 4 | squidclient \- A simple HTTP web client tool |
83915266 | 5 | . |
06952d61 | 6 | .SH SYNOPSIS |
83915266 | 7 | .if !'po4a'hide' .B squidclient |
b4f805f6 AJ |
8 | .if !'po4a'hide' .B "[ \-aknNrsv ] " |
9 | .if !'po4a'hide' .B "[ \-\-ping [ping\-options] ] " | |
9958ebee | 10 | .if !'po4a'hide' .B "[ \-\-https] [tls\-options] [ \-A" |
ba7ce724 | 11 | string |
b4f805f6 | 12 | .if !'po4a'hide' .B "] [ \-h | \-\-host" |
92a0c1e0 | 13 | remote host |
83915266 AJ |
14 | .if !'po4a'hide' .B "] [ \-H '" |
15 | string | |
16 | .if !'po4a'hide' .B "' ] [ \-i" | |
17 | IMS | |
83915266 | 18 | .if !'po4a'hide' .B "] [ \-j '" |
92a0c1e0 | 19 | Host header |
b4f805f6 AJ |
20 | .if !'po4a'hide' .B "' ] [ \-l | \-\-local" |
21 | host | |
83915266 AJ |
22 | .if !'po4a'hide' .B "] [ \-m" |
23 | method | |
b4f805f6 | 24 | .if !'po4a'hide' .B "] [ \-p | \-\-port" |
83915266 AJ |
25 | port |
26 | .if !'po4a'hide' .B "] [ \-P" | |
27 | file | |
28 | .if !'po4a'hide' .B "] [ \-t" | |
29 | count | |
30 | .if !'po4a'hide' .B "] [ \-T" | |
31 | timeout | |
32 | .if !'po4a'hide' .B "] [ \-u" | |
92a0c1e0 | 33 | user |
83915266 | 34 | .if !'po4a'hide' .B "] [ \-U" |
92a0c1e0 | 35 | user |
83915266 AJ |
36 | .if !'po4a'hide' .B "] [ \-V" |
37 | version | |
38 | .if !'po4a'hide' .B "] [ \-w" | |
92a0c1e0 | 39 | password |
83915266 | 40 | .if !'po4a'hide' .B "] [ \-W" |
92a0c1e0 | 41 | password |
83915266 AJ |
42 | .if !'po4a'hide' .B "] " |
43 | url | |
44 | . | |
08c73d14 | 45 | .PP |
842cd45a AJ |
46 | .if !'po4a'hide' .B "Ping options: [ \-g" |
47 | count | |
48 | .if !'po4a'hide' .B "] [ \-I" | |
49 | interval | |
50 | .if !'po4a'hide' .B "] " | |
51 | . | |
08c73d14 | 52 | .PP |
9958ebee | 53 | .if !'po4a'hide' .B "TLS options: [ \-\-anonymous\-tls ] [ \-\-trusted\-ca" |
b4f805f6 AJ |
54 | CA certificates file |
55 | .if !'po4a'hide' .B "...] [ \-\-cert" | |
56 | client X.509 certificate file | |
57 | .if !'po4a'hide' .B "] [ \-\-params" | |
58 | TLS session parameters | |
59 | .if !'po4a'hide' .B "] " | |
60 | . | |
06952d61 | 61 | .SH DESCRIPTION |
4f16e7af AJ |
62 | .B squidclient |
63 | is a tool providing a command line interface for retrieving URLs. | |
64 | Designed for testing any HTTP 0.9, 1.0, or 1.1 web server or proxy. | |
d5b26acf | 65 | This tool can be combined with scripts to perform any basic HTTP operation. |
4f16e7af | 66 | Some additional features for access to the |
83915266 | 67 | .B squid |
4f16e7af | 68 | proxy object cache and management information are provided. |
83915266 | 69 | . |
06952d61 | 70 | .SH OPTIONS |
83915266 AJ |
71 | .if !'po4a'hide' .TP 12 |
72 | .if !'po4a'hide' .B "\-a" | |
4f16e7af | 73 | Do NOT include Accept: header. |
83915266 AJ |
74 | . |
75 | .if !'po4a'hide' .TP | |
ba7ce724 AJ |
76 | .if !'po4a'hide' .B "\-A 'string'" |
77 | Send | |
78 | .B string | |
79 | as User-Agent: header. To omit the header completely set string to empty (''). | |
80 | . | |
81 | .if !'po4a'hide' .TP | |
b4f805f6 AJ |
82 | .if !'po4a'hide' .B "\-h | \-\-host host" |
83 | Retrieve URL from server host. Default is | |
83915266 AJ |
84 | .B localhost |
85 | . | |
86 | .if !'po4a'hide' .TP | |
87 | .if !'po4a'hide' .B "\-H 'string'" | |
92a0c1e0 | 88 | Extra headers to send. Use |
53b87566 | 89 | .B '\en' |
92a0c1e0 | 90 | for new lines. |
83915266 AJ |
91 | . |
92 | .if !'po4a'hide' .TP | |
93 | .if !'po4a'hide' .B "\-i time" | |
92a0c1e0 | 94 | If\-Modified\-Since time (in Epoch seconds). |
83915266 AJ |
95 | . |
96 | .if !'po4a'hide' .TP | |
83915266 | 97 | .if !'po4a'hide' .B "\-j hosthdr" |
4f16e7af | 98 | Host header content |
83915266 AJ |
99 | . |
100 | .if !'po4a'hide' .TP | |
d0e46669 AJ |
101 | .if !'po4a'hide' .B "\-k" |
102 | Keep the connection active. Default is to do only one request then close. | |
103 | . | |
104 | .if !'po4a'hide' .TP | |
b4f805f6 | 105 | .if !'po4a'hide' .B "\-l | \-\-local host" |
4f16e7af | 106 | Specify a local IP address to bind to. Default is none. |
83915266 AJ |
107 | . |
108 | .if !'po4a'hide' .TP | |
109 | .if !'po4a'hide' .B "\-m method" | |
110 | Request method, default is | |
111 | .I GET. | |
112 | Squid also supports a non-standard method called | |
113 | .I PURGE. | |
114 | You can use that to purge a specific URL from the cache. | |
115 | You need to have | |
116 | .I purge | |
117 | access setup in | |
118 | .B squid.conf | |
119 | similar to | |
120 | .I manager | |
08c73d14 | 121 | access. Here is an example: |
83915266 | 122 | .if !'po4a'hide' .nf |
ef8d9073 AJ |
123 | .if !'po4a'hide' acl purge method PURGE |
124 | .if !'po4a'hide' http_access deny purge !localhost | |
83915266 AJ |
125 | .if !'po4a'hide' .fi |
126 | . | |
127 | .if !'po4a'hide' .TP | |
823d23e4 AJ |
128 | .if !'po4a'hide' .B "\-n" |
129 | Proxy Negotiate(Kerberos) authentication. | |
130 | .if !'po4a'hide' .nf | |
131 | Use kinit username@DOMAIN first to get initial TGS. | |
132 | . | |
133 | .if !'po4a'hide' .TP | |
134 | .if !'po4a'hide' .B "\-N" | |
135 | WWW Negotiate(Kerberos) authentication. | |
136 | .if !'po4a'hide' .nf | |
137 | Use kinit username@DOMAIN first to get initial TGS. | |
08c73d14 | 138 | .if !'po4a'hide' .fi |
823d23e4 AJ |
139 | . |
140 | .if !'po4a'hide' .TP | |
83915266 | 141 | .if !'po4a'hide' .B "\-p port" |
4f16e7af | 142 | Port number of cache. Default is 3128. |
83915266 AJ |
143 | . |
144 | .if !'po4a'hide' .TP | |
145 | .if !'po4a'hide' .B "\-P file" | |
92a0c1e0 | 146 | Request body. Using the named file as data. |
83915266 AJ |
147 | . |
148 | .if !'po4a'hide' .TP | |
149 | .if !'po4a'hide' .B "\-r" | |
4f16e7af | 150 | Force cache to reload URL. |
83915266 AJ |
151 | . |
152 | .if !'po4a'hide' .TP | |
153 | .if !'po4a'hide' .B "\-s" | |
4f16e7af | 154 | Silent. Do not print data to stdout. |
83915266 AJ |
155 | . |
156 | .if !'po4a'hide' .TP | |
157 | .if !'po4a'hide' .B "\-t count" | |
92a0c1e0 AJ |
158 | Trace |
159 | .I count | |
160 | HTTP relay or proxy hops | |
83915266 AJ |
161 | . |
162 | .if !'po4a'hide' .TP | |
163 | .if !'po4a'hide' .B "\-T timeout" | |
4f16e7af | 164 | Timeout value (seconds) for read/write operations. |
83915266 AJ |
165 | . |
166 | .if !'po4a'hide' .TP | |
167 | .if !'po4a'hide' .B "\-u user" | |
4f16e7af | 168 | Proxy authentication username |
83915266 AJ |
169 | . |
170 | .if !'po4a'hide' .TP | |
171 | .if !'po4a'hide' .B "\-U user" | |
4f16e7af | 172 | WWW authentication username |
83915266 AJ |
173 | . |
174 | .if !'po4a'hide' .TP | |
175 | .if !'po4a'hide' .B "\-v" | |
4f16e7af | 176 | Verbose. Print outgoing message to stderr. |
83915266 AJ |
177 | . |
178 | .if !'po4a'hide' .TP | |
179 | .if !'po4a'hide' .B "\-V version" | |
180 | HTTP Version. Use '\-' for HTTP/0.9 omitted case | |
181 | . | |
182 | .if !'po4a'hide' .TP | |
183 | .if !'po4a'hide' .B "\-w password" | |
4f16e7af | 184 | Proxy authentication password |
83915266 AJ |
185 | . |
186 | .if !'po4a'hide' .TP | |
187 | .if !'po4a'hide' .B "\-W password" | |
4f16e7af | 188 | WWW authentication password |
83915266 | 189 | . |
842cd45a | 190 | .if !'po4a'hide' .TP |
9958ebee AJ |
191 | .if !'po4a'hide' .B "\-\-https" |
192 | Use Transport Layer Security on the HTTP connection. | |
842cd45a | 193 | . |
9958ebee AJ |
194 | .if !'po4a'hide' .TP |
195 | .if !'po4a'hide' .B "\-\-anonymous\-tls" | |
b4f805f6 AJ |
196 | Use TLS with unauthenticated (anonymous) certificate. |
197 | . | |
198 | .if !'po4a'hide' .TP | |
199 | .if !'po4a'hide' .B "\-\-cert file" | |
200 | File containing client X.509 certificate in PEM format. | |
201 | May be repeated to load several client certificates. | |
202 | . | |
9958ebee | 203 | .if !'po4a'hide' .TP |
cb4a4288 | 204 | .if !'po4a'hide' .B "\-\-trusted\-ca file" |
b4f805f6 AJ |
205 | File containing trusted Certificate Authority (CA) certificates in PEM format. |
206 | May be repeated to load any number of files. | |
207 | . | |
9958ebee | 208 | .if !'po4a'hide' .TP |
b4f805f6 AJ |
209 | .if !'po4a'hide' .B "\-\-params values" |
210 | TLS library specific parameters for the communication session. | |
211 | See the library documentation for details on valid parameters. | |
212 | .if !'po4a'hide' .I "GnuTLS: http://gnutls.org/manual/html_node/Priority\-Strings.html" | |
213 | If repeated only the last value will have effect. | |
214 | . | |
08c73d14 | 215 | .if !'po4a'hide' .TP |
9958ebee AJ |
216 | .if !'po4a'hide' .B "\-\-ping [options]" |
217 | Enable ping mode. Optional \-g and \-I parameters must follow immediately if used. | |
218 | Repeated use resets to default ping settings. | |
219 | . | |
08c73d14 | 220 | .if !'po4a'hide' .TP |
9958ebee | 221 | .if !'po4a'hide' .B "\-g count" |
52aaae40 | 222 | Ping mode, perform |
9958ebee AJ |
223 | .I count |
224 | iterations (default is to loop until interrupted). | |
225 | . | |
226 | .if !'po4a'hide' .TP | |
227 | .if !'po4a'hide' .B "\-I interval" | |
228 | Ping interval in seconds (default 1 second). | |
229 | . | |
06952d61 | 230 | .SH AUTHOR |
d632afde AJ |
231 | This program and manual was written by |
232 | .if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org> | |
233 | .PP | |
234 | Based on original code derived from Harvest and further developed by | |
235 | numerous individuals from the internet community. | |
83915266 AJ |
236 | . |
237 | .SH COPYRIGHT | |
5f623035 | 238 | .PP |
f70aedc4 | 239 | * Copyright (C) 1996-2021 The Squid Software Foundation and contributors |
5f623035 AJ |
240 | * |
241 | * Squid software is distributed under GPLv2+ license and includes | |
242 | * contributions from numerous individuals and organizations. | |
243 | * Please see the COPYING and CONTRIBUTORS files for details. | |
83915266 AJ |
244 | . |
245 | .SH QUESTIONS | |
246 | Questions on the usage of this program can be sent to the | |
247 | .I Squid Users mailing list | |
8311b837 | 248 | .if !'po4a'hide' <squid-users@lists.squid-cache.org> |
83915266 AJ |
249 | . |
250 | .SH REPORTING BUGS | |
c871f41e AJ |
251 | See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. |
252 | .PP | |
83915266 AJ |
253 | Report bugs or bug fixes using http://bugs.squid-cache.org/ |
254 | .PP | |
255 | Report serious security bugs to | |
8311b837 | 256 | .I Squid Bugs <squid-bugs@lists.squid-cache.org> |
83915266 AJ |
257 | .PP |
258 | Report ideas for new improvements to the | |
259 | .I Squid Developers mailing list | |
8311b837 | 260 | .if !'po4a'hide' <squid-dev@lists.squid-cache.org> |
83915266 AJ |
261 | . |
262 | .SH SEE ALSO | |
263 | .if !'po4a'hide' .BR squid "(8), " | |
264 | .if !'po4a'hide' .BR cachemgr.cgi "(8)" |