squidclient(1) General Commands Manual squidclient(1)NAME
squidclient -- a simple HTTP web client
SYNOPSIS
squidclient [-arsv][-A string ][-g count] [-h remote-host] [-H 'string'] [-i IMS] [-I ping-interval] [-j 'Host-header'] [-l local-host] [-m
method] [-p port] [-P file] [-t count] [-T timeout] [-u proxy-user] [-U www-user] [-V version] [-w proxy-password] [-W www-password] url
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 completely set string to empty ('').
-g count
Ping mode, perform count iterations (0 to loop until interrupted).
-h host
Retrieve URL from cache on hostname. Default is localhost.
-H 'string'
Extra headers to send. Use '
' for new lines.
-i time
If-Modified-Since time (in Epoch seconds).
-I interval
Ping interval in seconds (default 1 second).
-j hosthdr
Host header content
-l 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
-p port
Port number of cache. Default is 3128.
-P file
PUT request. Using the named file.
-r Force cache to reload URL.
-s Silent. Do not print data to stdout.
-t count
Trace count cache-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.
-w password
Proxy authentication password
-W password
WWW authentication password
-V version
HTTP Version. Use '-' for HTTP/0.9 omitted case
SEE ALSO cachemgr.cgi(8), squid(8)AUTHOR
Derived from Harvest. Further developed by by numerous individuals from the internet community. Development is led by Duane Wessels of the
National Laboratory for Applied Network Research and funded by the National Science Foundation.
Squid Web Client Tool squidclient(1)
Check Out this Related Man Page
wwwoffle(1) General Commands Manual wwwoffle(1)NAME
wwwoffle - A program to control the World Wide Web Offline Explorer.
SYNOPSIS
wwwoffle -h | --help --version
wwwoffle -online [-p <host>[:<port>] | -c <config-file>]
wwwoffle -autodial [-p <host>[:<port>] | -c <config-file>]
wwwoffle -offline [-p <host>[:<port>] | -c <config-file>]
wwwoffle -fetch [-p <host>[:<port>] | -c <config-file>]
wwwoffle -config [-p <host>[:<port>] | -c <config-file>]
wwwoffle -dump [-p <host>[:<port>] | -c <config-file>]
wwwoffle -cyclelog [-p <host>[:<port>] | -c <config-file>]
wwwoffle -purge [-p <host>[:<port>] | -c <config-file>]
wwwoffle -status [-p <host>[:<port>] | -c <config-file>]
wwwoffle -kill [-p <host>[:<port>] | -c <config-file>]
wwwoffle [-o|-O] [-p <host>[:<port>] | -c <config-file>] URL
wwwoffle [-d[<depth>] | -r[<depth>] | -R[<depth>]] [-g[Sisfo]] [-F] [-p <host>[:<port>] | -c <config-file>] URL1 [URL2 [... URL]]
wwwoffle [-d[<depth>] | -r[<depth>] | -R[<depth>]] [-g[Sisfo]] [-F] [-p <host>[:<port>] | -c <config-file>] file1 [file2 [... file]]
wwwoffle -post [-p <host>[:<port>] | -c <config-file>] URL
wwwoffle -put [-p <host>[:<port>] | -c <config-file>] URL
DESCRIPTION
wwwoffle controls the World Wide Web Offline Explorer proxy HTTP server.
The wwwoffle program is used to control the wwwoffled program, to tell it when the computer is online or offline, and which URLs to get and
when to fetch them.
The control options are also available from the server on an interactive control web page at http://localhost:8080/control/.
OPTIONS
The command line options available for the program are described below.
-h | --help
A help message is printed giving a brief description of the usage of the program.
--version
The version number of the program is printed.
-online
Tell the wwwoffled proxy server that the computer is online to the internet and that requests are to be fetched immediately.
-autodial
Tell the wwwoffled proxy server that the computer can become online to the internet if required for requests that are not already
cached, but that pages that are in the cache do not require any network access. This is intended for use with dial-on-demand sys-
tems (using diald for example).
-offline
Tell the wwwoffled proxy server that the computer is not online to the internet and that requests are to be cached until they are
fetched later.
-fetch Tell the wwwoffled proxy server to fetch all of the requests that have been cached. (The proxy server must be online for this to
work.) The program will wait until all of the requests have been met before exiting.
-config
Tell the wwwoffled proxy server to re-read the configuration file.
-dump Tell the wwwoffled proxy server to dump out the current program configuration. This is equivalent to the most recently read config-
uration file and the built-in default options.
-cyclelog
Tell the wwwoffled proxy server to close and then re-open the log file.
-purge Tell the wwwoffled proxy server that the cache is to be purged. The configuration file wwwoffle.conf(5) specifies the maximum age
of the pages to keep. If a maximum cache size is specified then the oldest pages are deleted until the size is not exceeded.
-status
Request from the wwwoffled proxy server the current status of the program. The online or offline mode, the fetch and purge sta-
tuses, the number of current processes and their PIDs are displayed.
-kill Tell the wwwoffled proxy server to exit cleanly at the next convenient point.
URL The URL of a web page that is to be fetched. This is the same as using a browser and entering the URL if not already in the cache
or pressing the refresh button in the index if it is in the cache.
file The name of an HTML file that is to be parsed and the links in it are to be fetched as if the URLs had been specified on the command
line.
-o Fetch the specified URL (from the cache or request it if not already cached when offline, or get it when online) and output it on
standard output. This is an easy way of getting an image out of the cache to be used in other programs. The contents of the Modi-
fyHTML section of the configuration file are ignored and the unmodified data is output.
-O Fetch the specified URL (from the cache or request it if not already cached when offline, or get it when online) and output it on
standard output including the HTTP header. The contents of the ModifyHTML section of the configuration file are ignored and the
unmodified data is output.
-F Force the specified URLs to be refreshed. Without this option, the page will not be fetched unless newer than the version on the
server.
-r[<depth>]
Causes the pages linked to by the specified URLs also to be fetched if they are on the same host. This recursion works for a number
of links specified by the depth parameter, a depth of 0 means only the specified page, a depth of 2 means all linked pages and all
links from them.
-R[<depth>]
The same as -r above, but it also works for links that are not on the same host.
-d[<depth>]
The same as -r above, but is limited to links in the same directory or a sub-directory.
-gS Also fetches the stylesheets that are included in the specified URLs.
-gi Also fetches the images that are included in the specified URLs.
-gf Also fetches the frames that are included in the specified URLs.
-gs Also fetches the scripts that are included in the specified URLs.
-go Also fetches the objects that are included in the specified URLs.
-post Create a request using the POST method, the data is read from stdin, and appended to the request. The user must ensure that the
format of the data is valid for a POST request. Any of the characters '&', '=' or ';' that are not being used for their reserved
purpose must be URL-encoded in the input, other characters will be URL-encoded.
-put Create a request using the PUT method, the data is read from stdin and appended to the request.
-c <config-file>
Specifies the name of the configuration file that contains the server host name, port numbers and authorisation password. This is
required for the -online, -autodial, -offline, -fetch, -config, -dump, -purge, -status and -kill options if a password is set. The
user must have read access to the configuration file to be able to use the command if a password is set. (See the StartUp and
LocalHost section of wwwoffle.conf(5) for more information on setting the server host name, ports and password.)
-p <host>[:<port>]
Sets the hostname and port number that is to be used for the connection to the proxy server. For the -online, -autodial, -offline,
-fetch, -config, -dump, -purge, -status and -kill options this must be the WWWOFFLE control port, for the URL options it must be the
WWWOFFLE HTTP proxy server port. If no -p option is specified then the compile-time defaults are used.
When the -F , -R[<depth>] , -r[<depth>] , -d[<depth>] or -g[Sisfo] options are given then they will override the options that are set in
the FetchOptions section of the configuration and not fetch any other contents of the specified URL. For example if the fetch options nor-
mally include images and frames then using the -gi option will only fetch images and not frames. All page contents to be fetched must be
specified as command line options. Specifying -g without any options will fetch only the specified URL without any of the options.
ENVIRONMENT VARIABLE
The WWWOFFLE_PROXY environment variable can be used instead of the -c or -p options. There are three ways that the variable can be used.
1. When the variable is set to absolute pathname of a file, then that file is used as the configuration file like the -c option (for
example /etc/wwwoffle/wwwoffle.conf).
2. The WWWOFFLE_PROXY variable can also be set to the hostname and the port number that would be used with the -p option (for example
localhost:8080).
3. The third possibility is to set the variable to the hostname and the two port numbers for the WWWOFFLE HTTP proxy port and the
WWWOFFLE control port (for example localhost:8080:8081). This way it will work with both types of commands (proxy access and con-
trol).
SEE ALSO wwwoffled(8), wwwoffle.conf(5), diald(8).
AUTHOR
Andrew M. Bishop 1996-2009 (amb@gedanken.demon.co.uk)
March 13, 2009 wwwoffle(1)