Squid_ The Definitive Guide - Duane Wessels [23]
bin/RunAccel
The RunAccel script is nearly identical to RunCache, except that it adds a command-line argument that tells Squid where to listen for HTTP requests.
bin/squidclient
squidclient is a simple HTTP client you can use to test Squid. It also has some special features for making management requests to a running Squid process.
libexec
The libexec directory traditionally contains helper programs. These are commands that you wouldn't normally run yourself. Rather, these programs are normally started by other programs.
libexec/unlinkd
unlinkd is a helper program that removes files from the cache directories. As you'll see later, file deletion can be a significant bottleneck. By implementing the delete operation in an external process, Squid achieves some performance gain.
libexec/cachemgr.cgi
cachemgr.cgi is a CGI interface to Squid's management functions. To use it, you'll probably need to copy this program to your HTTP server's cgi-bin directory. You'll see more about this in Section 14.2.
libexec/diskd (optional)
You get this only if you specify —enable-storeio=diskd.
libexec/pinger (optional)
You get this only if you specify —enable-icmp.
etc
The etc directory contains Squid's configuration files.
etc/squid.conf
This is the primary configuration file for Squid. Initially, this file contains a lot of comments to explain what each option does. After you understand the configuration directives, it's a good idea to remove the comments to make the configuration file smaller and easier to read. Note that the installation procedure doesn't overwrite this file if it already exists.
etc/squid.conf.default
This is a copy of the default configuration file from the source distribution. You may find it useful to have a copy of the current default configuration file after upgrading your Squid installation. New configuration directives may be added, and some of the existing directives may have changed.
etc/mime.conf
The mime.conf file tells Squid which MIME types to use for data retrieved from FTP and Gopher servers. The file is a table that correlates filename extensions to MIME types. Normally, you won't need to edit this file. However, you may need to add entries for special file types used within your organization.
etc/mime.conf.default
This is the default mime.conf file from the source distribution.
share
The share directory normally contains read-only data files used by Squid.
share/mib.txt
This is the SNMP Management Information Base (MIB) file for Squid. Squid doesn't use this file itself. Rather, your SNMP agent software (such as snmpget and Multi-Router Traffic Grapher (MRTG)) needs this file to understand the SNMP objects available from Squid.
share/icons
The share/icons directory contains a number of small icon files Squid uses in FTP and Gopher directory listings. Normally, you won't need to worry about these files, but you can change them if you want.
share/errors
The share/errors directory contains templates for the error messages Squid shows to users. These files are copied from the source directory when you install Squid. You can edit them if you like. However, the installation procedure always overwrites these files every time you run make install. So if you want to have customized error messages, it's a good idea to put them in a different directory.
var
The var directory contains files that aren't critical and that change frequently. These are the sort of files you don't normally back up.
var/logs
The var/logs directory is the default location for Squid's various log files. It is empty when you first install Squid. Once Squid gets running, you can expect to find files here named access.log, cache.log, and store.log.
var/cache
This is the default cache directory (cache_dir) if