squidclient(1)

1squidclient(1)              General Commands Manual             squidclient(1)
2
3
4

NAME

6       squidclient - A simple HTTP web client tool
7

SYNOPSIS

9       squidclient  [ -aknNrsv ] [ --ping [ping-options] ] [ --https] [tls-op‐
10       tions] [ -A string ] [ -h | --host remote host ] [ -H ' string ' ] [ -i
11       IMS ] [ -j ' Host header ' ] [ -l | --local host ] [ -m method ] [ -p |
12       --port port ] [ -P file ] [ -t count ] [ -T timeout ] [ -u user ] [  -U
13       user ] [ -V version ] [ -w password ] [ -W password ] url
14
15       Ping options: [ -g count ] [ -I interval ]
16
17       TLS  options:  [  --anonymous-tls ] [ --trusted-ca CA certificates file
18       ...] [ --cert client X.509 certificate file ] [  --params  TLS  session
19       parameters ]
20

DESCRIPTION

22       squidclient is a tool providing a command line interface for retrieving
23       URLs.  Designed for testing any HTTP 0.9, 1.0, or  1.1  web  server  or
24       proxy.   This  tool  can  be combined with scripts to perform any basic
25       HTTP operation.  Some additional features for access to the squid proxy
26       object cache and management information are provided.
27

OPTIONS

29       -a          Do NOT include Accept: header.
30
31       -A 'string' Send  string as User-Agent: header. To omit the header com‐
32                   pletely set string to empty ('').
33
34       -h | --host host
35                   Retrieve URL from server host.  Default is localhost
36
37       -H 'string' Extra headers to send. Use '\n' for new lines.
38
39       -i time     If-Modified-Since time (in Epoch seconds).
40
41       -j hosthdr  Host header content
42
43       -k          Keep the connection active. Default is to do only  one  re‐
44                   quest then close.
45
46       -l | --local host
47                   Specify a local IP address to bind to.  Default is none.
48
49       -m method   Request method, default is GET.  Squid also supports a non-
50                   standard method called PURGE.  You can use that to purge  a
51                   specific URL from the cache.  You need to have purge access
52                   setup in squid.conf similar to manager access. Here  is  an
53                   example:
54                   acl purge method PURGE
55                   http_access deny purge !localhost
56
57       -n          Proxy Negotiate(Kerberos) authentication.
58                   Use kinit username@DOMAIN first to get initial TGS.
59
60       -N          WWW Negotiate(Kerberos) authentication.
61                   Use kinit username@DOMAIN first to get initial TGS.
62
63       -p port     Port number of cache.  Default is 3128.
64
65       -P file     Request body. Using the named file as data.
66
67       -r          Force cache to reload URL.
68
69       -s          Silent.  Do not print data to stdout.
70
71       -t count    Trace count HTTP relay or proxy hops
72
73       -T timeout  Timeout value (seconds) for read/write operations.
74
75       -u user     Proxy authentication username
76
77       -U user     WWW authentication username
78
79       -v          Verbose. Print outgoing message to stderr.
80
81       -V version  HTTP Version. Use '-' for HTTP/0.9 omitted case
82
83       -w password Proxy authentication password
84
85       -W password WWW authentication password
86
87       --https     Use Transport Layer Security on the HTTP connection.
88
89       --anonymous-tls
90                   Use TLS with unauthenticated (anonymous) certificate.
91
92       --cert file File  containing  client  X.509  certificate in PEM format.
93                   May be repeated to load several client certificates.
94
95       --trusted-ca file
96                   File containing trusted Certificate Authority (CA) certifi‐
97                   cates in PEM format.  May be repeated to load any number of
98                   files.
99
100       --params values
101                   TLS library specific parameters for the communication  ses‐
102                   sion.   See  the library documentation for details on valid
103                   parameters.          GnuTLS:         http://gnutls.org/man‐
104                   ual/html_node/Priority-Strings.html  If  repeated  only the
105                   last value will have effect.
106
107       --ping [options]
108                   Enable ping mode. Optional -g and -I parameters must follow
109                   immediately  if  used.  Repeated use resets to default ping
110                   settings.
111
112       -g count    Ping mode, perform count iterations (default is to loop un‐
113                   til interrupted).
114
115       -I interval Ping interval in seconds (default 1 second).
116

AUTHOR

118       This  program  and  manual  was  written  by  Amos  Jeffries  <amosjef‐
119       fries@squid-cache.org>
120
121       Based on original code derived from Harvest and  further  developed  by
122       numerous individuals from the internet community.
123

COPYRIGHT

125        *  Copyright (C) 1996-2023 The Squid Software Foundation and contribu‐
126       tors
127        *
128        * Squid software is distributed under GPLv2+ license and includes
129        * contributions from numerous individuals and organizations.
130        * Please see the COPYING and CONTRIBUTORS files for details.
131

QUESTIONS

133       Questions on the usage of this program can be sent to the  Squid  Users
134       mailing list <squid-users@lists.squid-cache.org>
135

REPORTING BUGS

137       See  https://wiki.squid-cache.org/SquidFaq/BugReporting  for details of
138       what you need to include with your bug report.
139
140       Report bugs or bug fixes using https://bugs.squid-cache.org/
141
142       Report serious security bugs  to  Squid  Bugs  <squid-bugs@lists.squid-
143       cache.org>
144
145       Report  ideas for new improvements to the Squid Developers mailing list
146       <squid-dev@lists.squid-cache.org>
147