Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, March 14, 2019
 
 

squidclient (1)

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

squidclient(1)              General Commands Manual             squidclient(1)



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
       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.

OPTIONS
       -a          Do NOT include Accept: header.

       -A 'string' Send  string as User-Agent: header. To omit the header com-
                   pletely set string to empty ('').

       -h | --host host
                   Retrieve URL from server host.  Default is localhost

       -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.

       -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.

       -s          Silent.  Do not print data to stdout.

       -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.

       --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.

       --trusted-ca file
                   File containing trusted Certificate Authority (CA) certifi-
                   cates in PEM format.  May be repeated to load any number of
                   files.

       --params values
                   TLS library specific parameters for the communication  ses-
                   sion.   See  the library documentation for details on valid
                   parameters.          GnuTLS:         http://gnutls.org/man-
                   ual/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.

       -g count    Ping mode, perform.I 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  <amosjef-
       fries@squid-cache.org>

       Based on original code derived from Harvest and  further  developed  by
       numerous individuals from the internet community.

COPYRIGHT
        *  Copyright (C) 1996-2017 The Squid Software Foundation and contribu-
       tors
        *
        * 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@squid-cache.org>

REPORTING BUGS
       See  http://wiki.squid-cache.org/SquidFaq/BugReporting  for  details of
       what you need to include with your bug report.

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

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

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


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/proxy/squid  |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       squid(8), cachemgr.cgi(8)



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded    from     http://www.squid-cache.org/Ver-
       sions/v3/3.5/squid-3.5.27.tar.xz

       Further information about this software can be found on the open source
       community website at http://www.squid-cache.org/.



                                                                squidclient(1)