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)