From: Amos Jeffries <squid3@treenet.co.nz>
Date: Thu, 9 Jul 2009 22:33:18 +0000 (+1200)
Subject: Author: Luigi Gangitano <luigi@debian.org>
X-Git-Tag: SQUID_3_2_0_1~901
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=06952d613a80ac4a748d1228d1667cde56a3f684;p=thirdparty%2Fsquid.git

Author: Luigi Gangitano <luigi@debian.org>
squidclient man(1) page

A little out of date now, but its a start and better than nothing.
---

diff --git a/tools/Makefile.am b/tools/Makefile.am
index e1ddf8c894..550183280e 100644
--- a/tools/Makefile.am
+++ b/tools/Makefile.am
@@ -20,6 +20,9 @@ bin_PROGRAMS = \
 libexec_PROGRAMS = \
 	cachemgr$(CGIEXT)
 
+man_MANS = \
+	squidclient.1
+
 DEFAULT_CACHEMGR_CONFIG = $(sysconfdir)/cachemgr.conf
 
 squidclient_SOURCES = squidclient.cc
@@ -33,7 +36,8 @@ LDADD = \
 	$(XTRA_LIBS)
 
 EXTRA_DIST = \
-	cachemgr.conf
+	cachemgr.conf \
+	squidclient.1
 
 $(OBJS): $(top_srcdir)/include/version.h ../include/autoconf.h
 
diff --git a/tools/squidclient.1 b/tools/squidclient.1
new file mode 100644
index 0000000000..391bfc3d0b
--- /dev/null
+++ b/tools/squidclient.1
@@ -0,0 +1,48 @@
+.TH SQUIDCLIENT 1 "Mar 1998" "Squid Cache" "Debian Linux"
+.SH NAME
+squidclient -- client interface to the squid cache
+.SH SYNOPSIS
+.B squidclient
+.RB [ \-r ]
+.RB [ \-s ]
+.RB [ \-i
+.IR IMS ]
+.RB [ \-h
+.IR host ]
+.RB [ \-p
+.IR port ]
+.RB [ \-m
+.IR method ]
+.B url
+.SH DESCRIPTION
+.B Squidclient
+is a command line interface to retrieve URLs through the squid object cache.
+.SH OPTIONS
+.IP -r
+Force cache to reload URL.
+.IP -s
+Silent.  Do not print data to stdout.
+.IP "\-i \fItime\fP"
+If-Modified-Since time (in Epoch seconds).
+.IP "\-h \fIhost\fP"
+Retrieve URL from cache on hostname.  Default is localhost.
+.IP "\-p \fIport\fP"
+Port number of cache.  Default is 3128.
+.IP "\-m \fImethod\fP"
+Request method, default is GET. Squid also supports a non-standard method
+called \fBPURGE\fP. You can use that to purge a specific URL from the cache.
+You need to have \fIpurge\fP access setup in squid.conf similar to
+\fImanager\fP access. Here is an example:
+.nf
+
+      acl purge method PURGE
+      http_access deny  purge !localhost
+.fi
+
+.SH SEE ALSO
+squid(8).
+.SH 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.