squidclient - A simple HTTP web client tool
Contents
Copyright
* Copyright (C) 1996-2024 The Squid Software Foundation and contributors
*
* Squid software is distributed under GPLv2+ license and includes
* contributions from numerous individuals and organizations.
* Please see the COPYING and CONTRIBUTORS files for details.
Description
squidclient is a tool providing a command line interface for retrieving URLs. Designed for testing any
HTTP 0.9, 1.0, or 1.1 web server or proxy. This tool can be combined with scripts to perform any basic
HTTP operation. Some additional features for access to the squid proxy object cache and management
information are provided.
Name
squidclient - A simple HTTP web client tool
Options
-a Do NOT include Accept: header.
-A'string' Send string as User-Agent: header. To omit the header completely set string to empty ('').
-h|--hosthost
Retrieve URL from server host. Default is localhost-H'string' Extra headers to send. Use '\n' for new lines.
-itime If-Modified-Since time (in Epoch seconds).
-jhosthdr Host header content
-k Keep the connection active. Default is to do only one request then close.
-l|--localhost
Specify a local IP address to bind to. Default is none.
-mmethod Request method, default is GET. Squid also supports a non-standard method called PURGE. You
can use that to purge a specific URL from the cache. You need to have purge access setup in
squid.conf similar to manager access. Here is an example:
acl purge method PURGE
http_access deny purge !localhost
-n Proxy Negotiate(Kerberos) authentication.
Use kinit username@DOMAIN first to get initial TGS.
-N WWW Negotiate(Kerberos) authentication.
Use kinit username@DOMAIN first to get initial TGS.
-pport Port number of cache. Default is 3128.
-Pfile Request body. Using the named file as data.
-r Force cache to reload URL.
-s Silent. Do not print data to stdout.
-tcount Trace count HTTP relay or proxy hops
-Ttimeout Timeout value (seconds) for read/write operations.
-uuser Proxy authentication username
-Uuser WWW authentication username
-v Verbose. Print outgoing message to stderr.
-Vversion HTTP Version. Use '-' for HTTP/0.9 omitted case
-wpassword Proxy authentication password
-Wpassword WWW authentication password
--https Use Transport Layer Security on the HTTP connection.
--anonymous-tls
Use TLS with unauthenticated (anonymous) certificate.
--certfile File containing client X.509 certificate in PEM format. May be repeated to load several
client certificates.
--trusted-cafile
File containing trusted Certificate Authority (CA) certificates in PEM format. May be
repeated to load any number of files.
--paramsvalues
TLS library specific parameters for the communication session. See the library documentation
for details on valid parameters. GnuTLS:http://gnutls.org/manual/html_node/Priority-Strings.html If repeated only the last value will
have effect.
--ping[options]
Enable ping mode. Optional -g and -I parameters must follow immediately if used. Repeated
use resets to default ping settings.
-gcount Ping mode, perform count iterations (default is to loop until interrupted).
-Iinterval Ping interval in seconds (default 1 second).
Questions
Questions on the usage of this program can be sent to the SquidUsersmailinglist <squid-
users@lists.squid-cache.org>
Reporting Bugs
See https://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your
bug report.
Report bugs or bug fixes using https://bugs.squid-cache.org/
Report serious security bugs to SquidBugs<squid-bugs@lists.squid-cache.org>
Report ideas for new improvements to the SquidDevelopersmailinglist <squid-dev@lists.squid-cache.org>
See Also
squid(8), cachemgr.cgi(8) squidclient(1)
Synopsis
squidclient[-aknNrsv][--ping[ping-options]][--https][tls-options][-A string ][-h|--host
remote host ][-H' string '][-i IMS ][-j' Host header '][-l|--local host ][-m method ][-p|--port port ][-P file ][-t count ][-T timeout ][-u user ][-U user ][-V version ][-w
password ][-W password ] url
Pingoptions:[-g count ][-I interval ]TLSoptions:[--anonymous-tls][--trusted-ca CA certificates file ...][--cert client X.509
certificate file ][--params TLS session parameters ]