]>
Commit | Line | Data |
---|---|---|
83915266 AJ |
1 | .if !'po4a'hide' .TH squidclient 1 |
2 | . | |
06952d61 | 3 | .SH NAME |
83915266 AJ |
4 | .if !'po4a'hide' .B squidclient |
5 | .if !'po4a'hide' \- | |
6 | A simple HTTP web client tool | |
7 | . | |
06952d61 | 8 | .SH SYNOPSIS |
83915266 | 9 | .if !'po4a'hide' .B squidclient |
b4f805f6 AJ |
10 | .if !'po4a'hide' .B "[ \-aknNrsv ] " |
11 | .if !'po4a'hide' .B "[ \-\-ping [ping\-options] ] " | |
9958ebee | 12 | .if !'po4a'hide' .B "[ \-\-https] [tls\-options] [ \-A" |
ba7ce724 | 13 | string |
b4f805f6 | 14 | .if !'po4a'hide' .B "] [ \-h | \-\-host" |
92a0c1e0 | 15 | remote host |
83915266 AJ |
16 | .if !'po4a'hide' .B "] [ \-H '" |
17 | string | |
18 | .if !'po4a'hide' .B "' ] [ \-i" | |
19 | IMS | |
83915266 | 20 | .if !'po4a'hide' .B "] [ \-j '" |
92a0c1e0 | 21 | Host header |
b4f805f6 AJ |
22 | .if !'po4a'hide' .B "' ] [ \-l | \-\-local" |
23 | host | |
83915266 AJ |
24 | .if !'po4a'hide' .B "] [ \-m" |
25 | method | |
b4f805f6 | 26 | .if !'po4a'hide' .B "] [ \-p | \-\-port" |
83915266 AJ |
27 | port |
28 | .if !'po4a'hide' .B "] [ \-P" | |
29 | file | |
30 | .if !'po4a'hide' .B "] [ \-t" | |
31 | count | |
32 | .if !'po4a'hide' .B "] [ \-T" | |
33 | timeout | |
34 | .if !'po4a'hide' .B "] [ \-u" | |
92a0c1e0 | 35 | user |
83915266 | 36 | .if !'po4a'hide' .B "] [ \-U" |
92a0c1e0 | 37 | user |
83915266 AJ |
38 | .if !'po4a'hide' .B "] [ \-V" |
39 | version | |
40 | .if !'po4a'hide' .B "] [ \-w" | |
92a0c1e0 | 41 | password |
83915266 | 42 | .if !'po4a'hide' .B "] [ \-W" |
92a0c1e0 | 43 | password |
83915266 AJ |
44 | .if !'po4a'hide' .B "] " |
45 | url | |
46 | . | |
842cd45a AJ |
47 | .if !'po4a'hide' .B "Ping options: [ \-g" |
48 | count | |
49 | .if !'po4a'hide' .B "] [ \-I" | |
50 | interval | |
51 | .if !'po4a'hide' .B "] " | |
52 | . | |
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 AJ |
88 | Extra headers to send. Use |
89 | .B '\\n' | |
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 | |
121 | access. Here is an example: | |
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. | |
138 | . | |
139 | .if !'po4a'hide' .TP | |
83915266 | 140 | .if !'po4a'hide' .B "\-p port" |
4f16e7af | 141 | Port number of cache. Default is 3128. |
83915266 AJ |
142 | . |
143 | .if !'po4a'hide' .TP | |
144 | .if !'po4a'hide' .B "\-P file" | |
92a0c1e0 | 145 | Request body. Using the named file as data. |
83915266 AJ |
146 | . |
147 | .if !'po4a'hide' .TP | |
148 | .if !'po4a'hide' .B "\-r" | |
4f16e7af | 149 | Force cache to reload URL. |
83915266 AJ |
150 | . |
151 | .if !'po4a'hide' .TP | |
152 | .if !'po4a'hide' .B "\-s" | |
4f16e7af | 153 | Silent. Do not print data to stdout. |
83915266 AJ |
154 | . |
155 | .if !'po4a'hide' .TP | |
156 | .if !'po4a'hide' .B "\-t count" | |
92a0c1e0 AJ |
157 | Trace |
158 | .I count | |
159 | HTTP relay or proxy hops | |
83915266 AJ |
160 | . |
161 | .if !'po4a'hide' .TP | |
162 | .if !'po4a'hide' .B "\-T timeout" | |
4f16e7af | 163 | Timeout value (seconds) for read/write operations. |
83915266 AJ |
164 | . |
165 | .if !'po4a'hide' .TP | |
166 | .if !'po4a'hide' .B "\-u user" | |
4f16e7af | 167 | Proxy authentication username |
83915266 AJ |
168 | . |
169 | .if !'po4a'hide' .TP | |
170 | .if !'po4a'hide' .B "\-U user" | |
4f16e7af | 171 | WWW authentication username |
83915266 AJ |
172 | . |
173 | .if !'po4a'hide' .TP | |
174 | .if !'po4a'hide' .B "\-v" | |
4f16e7af | 175 | Verbose. Print outgoing message to stderr. |
83915266 AJ |
176 | . |
177 | .if !'po4a'hide' .TP | |
178 | .if !'po4a'hide' .B "\-V version" | |
179 | HTTP Version. Use '\-' for HTTP/0.9 omitted case | |
180 | . | |
181 | .if !'po4a'hide' .TP | |
182 | .if !'po4a'hide' .B "\-w password" | |
4f16e7af | 183 | Proxy authentication password |
83915266 AJ |
184 | . |
185 | .if !'po4a'hide' .TP | |
186 | .if !'po4a'hide' .B "\-W password" | |
4f16e7af | 187 | WWW authentication password |
83915266 | 188 | . |
842cd45a | 189 | .if !'po4a'hide' .TP |
9958ebee AJ |
190 | .if !'po4a'hide' .B "\-\-https" |
191 | Use Transport Layer Security on the HTTP connection. | |
842cd45a | 192 | . |
9958ebee AJ |
193 | .if !'po4a'hide' .TP |
194 | .if !'po4a'hide' .B "\-\-anonymous\-tls" | |
b4f805f6 AJ |
195 | Use TLS with unauthenticated (anonymous) certificate. |
196 | . | |
197 | .if !'po4a'hide' .TP | |
198 | .if !'po4a'hide' .B "\-\-cert file" | |
199 | File containing client X.509 certificate in PEM format. | |
200 | May be repeated to load several client certificates. | |
201 | . | |
9958ebee | 202 | .if !'po4a'hide' .TP |
b4f805f6 AJ |
203 | .if !'po4a'hide' .B "\-\-trusted-ca file" |
204 | File containing trusted Certificate Authority (CA) certificates in PEM format. | |
205 | May be repeated to load any number of files. | |
206 | . | |
9958ebee | 207 | .if !'po4a'hide' .TP |
b4f805f6 AJ |
208 | .if !'po4a'hide' .B "\-\-params values" |
209 | TLS library specific parameters for the communication session. | |
210 | See the library documentation for details on valid parameters. | |
211 | .if !'po4a'hide' .I "GnuTLS: http://gnutls.org/manual/html_node/Priority\-Strings.html" | |
212 | If repeated only the last value will have effect. | |
213 | . | |
9958ebee AJ |
214 | .if !'po4a'hide' .TP 10 |
215 | .if !'po4a'hide' .B "\-\-ping [options]" | |
216 | Enable ping mode. Optional \-g and \-I parameters must follow immediately if used. | |
217 | Repeated use resets to default ping settings. | |
218 | . | |
219 | .if !'po4a'hide' .TP 12 | |
220 | .if !'po4a'hide' .B "\-g count" | |
221 | Ping mode, perform | |
222 | .I count | |
223 | iterations (default is to loop until interrupted). | |
224 | . | |
225 | .if !'po4a'hide' .TP | |
226 | .if !'po4a'hide' .B "\-I interval" | |
227 | Ping interval in seconds (default 1 second). | |
228 | . | |
06952d61 AJ |
229 | .SH AUTHOR |
230 | Derived from Harvest. Further developed by by numerous individuals from | |
231 | the internet community. Development is led by Duane Wessels of the | |
232 | National Laboratory for Applied Network Research and funded by | |
233 | the National Science Foundation. | |
83915266 AJ |
234 | . |
235 | .SH COPYRIGHT | |
c871f41e | 236 | Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+). |
83915266 AJ |
237 | . |
238 | .SH QUESTIONS | |
239 | Questions on the usage of this program can be sent to the | |
240 | .I Squid Users mailing list | |
241 | .if !'po4a'hide' <squid-users@squid-cache.org> | |
242 | . | |
243 | .SH REPORTING BUGS | |
c871f41e AJ |
244 | See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. |
245 | .PP | |
83915266 AJ |
246 | Report bugs or bug fixes using http://bugs.squid-cache.org/ |
247 | .PP | |
248 | Report serious security bugs to | |
249 | .I Squid Bugs <squid-bugs@squid-cache.org> | |
250 | .PP | |
251 | Report ideas for new improvements to the | |
252 | .I Squid Developers mailing list | |
253 | .if !'po4a'hide' <squid-dev@squid-cache.org> | |
254 | . | |
255 | .SH SEE ALSO | |
256 | .if !'po4a'hide' .BR squid "(8), " | |
257 | .if !'po4a'hide' .BR cachemgr.cgi "(8)" |