squidclient(1)

📦
version 6.14 · 6 versions
, in fedora 43, opensuse-leap 16.0, ubuntu noble, ubuntu questing

💖 squidclient(1) 💖

okay bestie, welcome to the General Commands Manual entry for squidclient — yes, that's section 1, we're in the big leagues now ✨

🌸 NAME 🌸

squidclient — a simple HTTP web client tool 🦋

✨ 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

Ping options: [ -g count ] [ -I interval ]

TLS options: [ --anonymous-tls ] [ --trusted-ca CA certificates file
...] [ --cert client X.509 certificate file ] [ --params TLS session
parameters ]

👑 DESCRIPTION 👑

So like. squidclient is a tool that gives you a whole command line interface for grabbing URLs. fr fr. It was literally designed for testing any HTTP 0.9, 1.0, or 1.1 web server or proxy 🫶

And the way that it can be combined with scripts to perform any basic HTTP operation? iconic. It's giving "I'm the main character of your shell pipeline" 💅

Plus there's bonus content: some extra features for access to the squid proxy object cache and management information are provided 🌈

💅 OPTIONS 💅

  • -a — Do NOT include the Accept: header. nope, not today 🙈
  • -A 'string' — Send string as the User-Agent: header. And if you wanna omit the header completely, set string to empty (''). bye bestie 👋
  • -h | --host host — Retrieve the URL from server host. Default is localhost. (very homebody of it, honestly)
  • -H 'string' — Extra headers to send. Use '\n' for new lines.
  • -i time — If-Modified-Since time (in Epoch seconds). ⏰
  • -j hosthdr — Host header content.
  • -k — Keep the connection active. Default is to do only one request then close. lowkey clingy but we respect it 💜
  • -l | --local host — Specify a local IP address to bind to. Default is none.
  • -m method — 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.
  • -p port — Port number of cache. Default is 3128.
  • -P file — Request body. Using the named file as data.
  • -r — Force cache to reload URL. ✨ refresh era ✨
  • -s — Silent. Do not print data to stdout. shhh 🤫
  • -t count — Trace count HTTP relay or proxy hops.
  • -T timeout — Timeout value (seconds) for read/write operations.
  • -u user — Proxy authentication username.
  • -U user — WWW authentication username.
  • -v — Verbose. Print outgoing message to stderr.
  • -V version — HTTP Version. Use '-' for HTTP/0.9 omitted case.
  • -w password — Proxy authentication password.
  • -W password — WWW authentication password.
  • --https — Use Transport Layer Security on the HTTP connection. secure girl summer 🔐
  • --anonymous-tls — Use TLS with unauthenticated (anonymous) certificate.
  • --cert file — File containing client X.509 certificate in PEM format. May be repeated to load several client certificates. the more the merrier 🎀
  • --trusted-ca file — File containing trusted Certificate Authority (CA) certificates in PEM format. May be repeated to load any number of files.
  • --params values — 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. (so like, don't bother repeating it, bestie, only the last one counts 💀)
  • --ping [options] — Enable ping mode. Optional -g and -I parameters must follow immediately if used. Repeated use resets to default ping settings.
  • -g count — Ping mode, perform count iterations (default is to loop until interrupted). 🏓
  • -I interval — Ping interval in seconds (default 1 second).

🫶 AUTHOR 🫶

This program and manual was written by Amos Jeffries <amosjeffries@squid-cache.org> 🥹

Based on original code derived from Harvest and further developed by numerous individuals from the internet community. a whole village, no cap 🌍

 * Copyright (C) 1996-2025 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.

🙋 QUESTIONS 🙋

Questions on the usage of this program can be sent to the Squid Users mailing list <squid-users@lists.squid-cache.org> — they don't bite, fr fr 💌

🐛 REPORTING BUGS 🐛

See https://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report. (read it before you send it, bestie, please 😭)

Report bugs or bug fixes using https://bugs.squid-cache.org/

Report serious security bugs to Squid Bugs <squid-bugs@lists.squid-cache.org> 🔥

Report ideas for new improvements to the Squid Developers mailing list <squid-dev@lists.squid-cache.org> 🌈

🌟 SEE ALSO 🌟

squid(8), cachemgr.cgi(8)

and that's the whole thing, bestie!! you just read squidclient(1) from the General Commands Manual top to bottom and honestly? slay 💖✨ go ping something 🏓💅

📦 where this page comes from