.\" Version: 1.2
.\" Author: Christopher Rath
.\" Time-stamp: <2002/07/23 17:41:58 crath>
.TH REFRESHSG "1" "JULY 2002" "Christopher Rath"
.SH NAME
refreshSG \- refresh the squidGuard Blacklist
.SH SYNOPSIS
.B refreshSG
.SH DESCRIPTION
.PP
Read the configuration from \fBrefreshSG.conf\fR and refresh the
squidGuard Blacklist database files.
.PP
\fBrefreshSG\fR uses wget to retrieve a compressed tarfile containing
the current Blacklist. It then moves that Blacklist into place one
directory at a time, removing the old directory just before moving the
new one into place. \fBrefreshSG\fR only removes directories which
are contained in the compressed tarfile; thus, any locally created and
populated directories will not be changed by \fBrefreshSG\fR.
.PP
The refreshSG script does not accept any command line paramaters;
rather, it reads its configuration values from \fBrefreshSG.conf\fR.
\fBrefreshSG.conf\fR may contain the following variables in order to
tune refreshSG's behaviour:
.TP
.B BL_URL
the Blacklist's URL (it must be a URL wget is capable of dealing
with); this is the variable that the ClarkConfig PHP module edits.
.TP
.B DB_PATH
where squidGuard's Blacklist database is stored.
.TP
.B SG_UGID
the userid and group which must ``own'' the Blacklist
database files (format: ``:'').
.PP
\fBrefreshSG\fR looks for the \fBrefresh.conf\fR file in the directory
the \fBrefreshSG\fR script itself is located in. If it doesn't find
the \fBrefreshSG.conf\fR there then it attempts to open the file
\fB/usr/local/refreshSG/refreshSG.conf\fR.
.PP
.SH AUTHOR
Written by Christopher Rath. The initial version was inspired by a
script posted anonymously to one of the ClarkConnect user forums and
written by a sysadmin named Mike; however, this current version is
much more ambitious and anal retentive than that version.
.SH "REPORTING BUGS"
Report bugs to .
.SH COPYRIGHT
Public Domain. No copyright retained.
.br
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
.SH "SEE ALSO"
squidGuard(1), squid(1)
.SH FILES
refreshSG.conf