]>
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 AJ |
9 | .if !'po4a'hide' .B squidclient |
10 | .if !'po4a'hide' .B "[ \-arsv ] [ \-g" | |
11 | count | |
12 | .if !'po4a'hide' .B "] [ \-h" | |
92a0c1e0 | 13 | remote host |
83915266 AJ |
14 | .if !'po4a'hide' .B "] [ \-H '" |
15 | string | |
16 | .if !'po4a'hide' .B "' ] [ \-i" | |
17 | IMS | |
18 | .if !'po4a'hide' .B "] [ \-I" | |
92a0c1e0 | 19 | ping interval |
83915266 | 20 | .if !'po4a'hide' .B "] [ \-j '" |
92a0c1e0 | 21 | Host header |
83915266 | 22 | .if !'po4a'hide' .B "' ] [ \-l" |
92a0c1e0 | 23 | local host |
83915266 AJ |
24 | .if !'po4a'hide' .B "] [ \-m" |
25 | method | |
26 | .if !'po4a'hide' .B "] [ \-p" | |
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 | . | |
06952d61 | 47 | .SH DESCRIPTION |
4f16e7af AJ |
48 | .B squidclient |
49 | is a tool providing a command line interface for retrieving URLs. | |
50 | Designed for testing any HTTP 0.9, 1.0, or 1.1 web server or proxy. | |
d5b26acf | 51 | This tool can be combined with scripts to perform any basic HTTP operation. |
4f16e7af | 52 | Some additional features for access to the |
83915266 | 53 | .B squid |
4f16e7af | 54 | proxy object cache and management information are provided. |
83915266 | 55 | . |
06952d61 | 56 | .SH OPTIONS |
83915266 AJ |
57 | .if !'po4a'hide' .TP 12 |
58 | .if !'po4a'hide' .B "\-a" | |
4f16e7af | 59 | Do NOT include Accept: header. |
83915266 AJ |
60 | . |
61 | .if !'po4a'hide' .TP | |
62 | .if !'po4a'hide' .B "\-g count" | |
4f16e7af AJ |
63 | Ping mode, perform |
64 | .I count | |
65 | iterations (0 to loop until interrupted). | |
83915266 AJ |
66 | . |
67 | .if !'po4a'hide' .TP | |
68 | .if !'po4a'hide' .IP "\-h host" | |
69 | Retrieve URL from cache on hostname. Default is | |
70 | .B localhost | |
71 | . | |
72 | .if !'po4a'hide' .TP | |
73 | .if !'po4a'hide' .B "\-H 'string'" | |
92a0c1e0 AJ |
74 | Extra headers to send. Use |
75 | .B '\\n' | |
76 | for new lines. | |
83915266 AJ |
77 | . |
78 | .if !'po4a'hide' .TP | |
79 | .if !'po4a'hide' .B "\-i time" | |
92a0c1e0 | 80 | If\-Modified\-Since time (in Epoch seconds). |
83915266 AJ |
81 | . |
82 | .if !'po4a'hide' .TP | |
83 | .if !'po4a'hide' .B "\-I interval" | |
4f16e7af | 84 | Ping interval in seconds (default 1 second). |
83915266 AJ |
85 | . |
86 | .if !'po4a'hide' .TP | |
87 | .if !'po4a'hide' .B "\-j hosthdr" | |
4f16e7af | 88 | Host header content |
83915266 AJ |
89 | . |
90 | .if !'po4a'hide' .TP | |
91 | .if !'po4a'hide' .B "\-l host" | |
4f16e7af | 92 | Specify a local IP address to bind to. Default is none. |
83915266 AJ |
93 | . |
94 | .if !'po4a'hide' .TP | |
95 | .if !'po4a'hide' .B "\-m method" | |
96 | Request method, default is | |
97 | .I GET. | |
98 | Squid also supports a non-standard method called | |
99 | .I PURGE. | |
100 | You can use that to purge a specific URL from the cache. | |
101 | You need to have | |
102 | .I purge | |
103 | access setup in | |
104 | .B squid.conf | |
105 | similar to | |
106 | .I manager | |
107 | access. Here is an example: | |
108 | .if !'po4a'hide' .nf | |
ef8d9073 AJ |
109 | .if !'po4a'hide' acl purge method PURGE |
110 | .if !'po4a'hide' http_access deny purge !localhost | |
83915266 AJ |
111 | .if !'po4a'hide' .fi |
112 | . | |
113 | .if !'po4a'hide' .TP | |
114 | .if !'po4a'hide' .B "\-p port" | |
4f16e7af | 115 | Port number of cache. Default is 3128. |
83915266 AJ |
116 | . |
117 | .if !'po4a'hide' .TP | |
118 | .if !'po4a'hide' .B "\-P file" | |
92a0c1e0 | 119 | Request body. Using the named file as data. |
83915266 AJ |
120 | . |
121 | .if !'po4a'hide' .TP | |
122 | .if !'po4a'hide' .B "\-r" | |
4f16e7af | 123 | Force cache to reload URL. |
83915266 AJ |
124 | . |
125 | .if !'po4a'hide' .TP | |
126 | .if !'po4a'hide' .B "\-s" | |
4f16e7af | 127 | Silent. Do not print data to stdout. |
83915266 AJ |
128 | . |
129 | .if !'po4a'hide' .TP | |
130 | .if !'po4a'hide' .B "\-t count" | |
92a0c1e0 AJ |
131 | Trace |
132 | .I count | |
133 | HTTP relay or proxy hops | |
83915266 AJ |
134 | . |
135 | .if !'po4a'hide' .TP | |
136 | .if !'po4a'hide' .B "\-T timeout" | |
4f16e7af | 137 | Timeout value (seconds) for read/write operations. |
83915266 AJ |
138 | . |
139 | .if !'po4a'hide' .TP | |
140 | .if !'po4a'hide' .B "\-u user" | |
4f16e7af | 141 | Proxy authentication username |
83915266 AJ |
142 | . |
143 | .if !'po4a'hide' .TP | |
144 | .if !'po4a'hide' .B "\-U user" | |
4f16e7af | 145 | WWW authentication username |
83915266 AJ |
146 | . |
147 | .if !'po4a'hide' .TP | |
148 | .if !'po4a'hide' .B "\-v" | |
4f16e7af | 149 | Verbose. Print outgoing message to stderr. |
83915266 AJ |
150 | . |
151 | .if !'po4a'hide' .TP | |
152 | .if !'po4a'hide' .B "\-V version" | |
153 | HTTP Version. Use '\-' for HTTP/0.9 omitted case | |
154 | . | |
155 | .if !'po4a'hide' .TP | |
156 | .if !'po4a'hide' .B "\-w password" | |
4f16e7af | 157 | Proxy authentication password |
83915266 AJ |
158 | . |
159 | .if !'po4a'hide' .TP | |
160 | .if !'po4a'hide' .B "\-W password" | |
4f16e7af | 161 | WWW authentication password |
83915266 | 162 | . |
06952d61 AJ |
163 | .SH AUTHOR |
164 | Derived from Harvest. Further developed by by numerous individuals from | |
165 | the internet community. Development is led by Duane Wessels of the | |
166 | National Laboratory for Applied Network Research and funded by | |
167 | the National Science Foundation. | |
83915266 AJ |
168 | . |
169 | .SH COPYRIGHT | |
c871f41e | 170 | Distributed under the GNU General Public License (GNU GPL) version 2 or later (GPLv2+). |
83915266 AJ |
171 | . |
172 | .SH QUESTIONS | |
173 | Questions on the usage of this program can be sent to the | |
174 | .I Squid Users mailing list | |
175 | .if !'po4a'hide' <squid-users@squid-cache.org> | |
176 | . | |
177 | .SH REPORTING BUGS | |
c871f41e AJ |
178 | See http://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. |
179 | .PP | |
83915266 AJ |
180 | Report bugs or bug fixes using http://bugs.squid-cache.org/ |
181 | .PP | |
182 | Report serious security bugs to | |
183 | .I Squid Bugs <squid-bugs@squid-cache.org> | |
184 | .PP | |
185 | Report ideas for new improvements to the | |
186 | .I Squid Developers mailing list | |
187 | .if !'po4a'hide' <squid-dev@squid-cache.org> | |
188 | . | |
189 | .SH SEE ALSO | |
190 | .if !'po4a'hide' .BR squid "(8), " | |
191 | .if !'po4a'hide' .BR cachemgr.cgi "(8)" |