squid(8)						      System Manager's Manual							  squid(8)

NAME

       squid - proxy caching server

SYNOPSIS

       squid [ -dhirsvzCDFINRVYX ] [ -l facility ] [ -f config-file ] [ -[ au ] port ] [ -k  signal ] [ -n service-name ] [ -O cmd-line ]

DESCRIPTION

       squid  is  a  high-performance  proxy  caching  server  for web clients, supporting FTP, gopher, and HTTP data objects.	Unlike traditional
       caching software, squid handles all requests in a single, non-blocking, I/O-driven process.

       squid keeps meta data and especially hot objects cached in RAM, caches DNS lookups, supports non-blocking DNS lookups, and implements nega-
       tive caching of failed requests.

       squid  supports	SSL,  extensive access controls, and full request logging.  By using the lightweight Internet Cache Protocol, squid caches
       can be arranged in a hierarchy or mesh for additional bandwidth savings.

       squid consists of a main server program squid, a Domain Name System lookup program dnsserver, some optional programs for rewriting requests
       and  performing	authentication,  and some management and client tools.	When squid starts up, it spawns a configurable number of dnsserver
       processes, each of which can perform a single, blocking Domain Name System (DNS) lookup.  This reduces the amount of time the  cache  waits
       for DNS lookups.

       squid is derived from the ARPA-funded Harvest Project http://harvest.cs.colorado.edu/

       This  manual  page  only  lists	the command line arguments.  For details on how to configure squid see the file /etc/squid/squid.conf, the
       Squid FAQ and the documentation at the squid home page http://www.squid-cache.org

OPTIONS

       -d level
	      Write debugging to stderr also.

       -f file
	      Use the given config-file instead of /etc/squid/squid.conf

       -h     Print help message.

       -i     Install as a Windows Service (see -n option).

       -k reconfigure | rotate | shutdown | interrupt | kill | debug | check | parse
	      Parse configuration file, then send signal to running copy (except -k parse) and exit.

       -n name
	      Specify Windows Service name to use for service operations, default is: Squid

       -r     Remove a Windows Service (see -n option).

       -s     Enable logging to syslog.

       -l facility
	      Use specified syslog facility. implies -s

       -u port
	      Specify ICP port number (default: 3130), disable with 0.

       -v     Print version.

       -z     Create swap directories

       -C     Do not catch fatal signals.

       -D     Disable initial DNS tests.

       -F     Don't serve any requests until store is rebuilt.

       -I     Override first HTTP port with the bound socket passed in on standard input.

       -N     No daemon mode.

       -O options
	      Set Windows Service Command line options in Registry.

       -R     Do not set REUSEADDR on port.

       -X     Force full debugging.

       -Y     Only return UDP_HIT or UDP_MISS_NOFETCH during fast reload.

FILES

       /etc/squid/squid.conf
	      The main configuration file.  You must initially make changes to this file for squid to work.  For example, the  default	configura-
	      tion does not allow access from any browser.

       /usr/share/doc/squid/examples/squid.conf
	      Reference  copy  of the configuration file. Always kept up to date with the version of Squid you are using. Use this to look up con-
	      figuration syntax after upgrading.

       /usr/share/squid/mime.conf (mime_table)
	      MIME type mappings for FTP gatewaying

       /usr/share/squid/errors/en (error_directory)
	      Error page templates

SEE ALSO

       cachemgr.cgi(8), ncsa_auth(8), pam_auth(8), squid_ldap_auth(8), squid_ldap_group(8), squid_session(8), squid_unix_group(8),
       The Squid FAQ

Squid Web Proxy 2.7.STABLE9					    2006-05-29								  squid(8)