Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
squid(8)							      squid(8)

       squid - HTTP web	proxy caching server

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

       squid is	a high-performance proxy caching server	for web	clients,  sup-
       porting	FTP,  gopher,  ICAP,  ICP, HTCP	and HTTP data objects.	Unlike
       traditional caching software, Squid handles all requests	in  a  single,
       non-blocking process.

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

       Squid  supports	SSL,  extensive	access controls, and full request log-
       ging.  By using the lightweight Internet	Cache Protocols	ICP,  HTCP  or
       CARP,  Squid  caches  can  be arranged in a hierarchy or	mesh for addi-
       tional bandwidth	savings.

       Squid consists of a main	server program squid , some optional  programs
       for  custom  processing	and  authentication,  and  some	management and
       client tools.  When squid starts	up, it spawns a	configurable number of
       helper  processes,  each	 of  which can perform parallel	lookups.  This
       reduces the amount of time the cache waits for results.

       Squid is	derived	from the ARPA-funded Harvest Project.

       This manual page	only lists the command line arguments.	For details on
       how	 to	  configure	  Squid	      see	the	  file
       /usr/local/etc/squid/squid.conf.documented,  the	 Squid	wiki  FAQ  and
       examples	 at , or the configuration	manual
       on the Squid home page

       -a port	   Specify HTTP	port number  where  Squid  should  listen  for
		   requests,  in  addition  to any http_port specifications in

       -C	   Do not catch	fatal signals.

       -d level	   Write debugging to stderr also.

       -f file	   Use	   the	   given      config-file      instead	    of
		   /usr/local/etc/squid/squid.conf  .  If the file name	starts
		   with	a !  or	| then it is assumed to	be an external command
		   or  command	line.	Can for	example	be used	to pre-process
		   the configuration before it is being	 read  by  Squid.   To
		   facilitate  this  Squid  also  understands the common #line
		   notion to indicate the real source file.

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

       -h	   Print help message.

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

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

       -l facility Use specified syslog	facility. Implies -s

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

       -N	   No daemon mode.

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

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

       -R	   Do not set REUSEADDR	on port.

       -s	   Enable   logging   to   syslog.   Also   configurable    in

       -S	   Double-check	swap during rebuild.

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

       -v	   Print version and build details.

       -X	   Force full debugging.

       -Y	   Only	return UDP_HIT or UDP_MISS_NOFETCH during fast reload.

       -z	   Create missing swap directories and other missing cache_dir
		   structures,	then exit. All cache_dir types create the con-
		   figured top-level directory if it is	missing. Other actions
		   are	type-specific.	For example, ufs-based storage systems
		   create missing L1 and L2 directories	while Rock creates the
		   missing database file.

		   This	 option	does not enable	validation of any present swap
		   structures. Its focus is on creation	of missing pieces.  If
		   nothing  is	missing,  squid	 -z just exits.	If you suspect
		   cache_dir  corruption,  you	must  delete   the   top-level
		   cache_dir directory before running squid -z.

		   By  default,	squid -z runs in daemon	mode (so that configu-
		   ration macros and other SMP features	work as	expected). Use
		   -N option to	overwrite this.

       Squid configuration files located in /usr/local/etc/squid/:

	      The  main	configuration file. You	must initially make changes to
	      this file	for squid to work. For example,	the default configura-
	      tion  only  allows  access  from RFC private LAN networks.  Some
	      packaging	distributions block even that.

	      Reference	copy of	the configuration file.	Always kept up to date
	      with the version of Squid	you are	using.

	      Use  this	to look	up the default configuration settings and syn-
	      tax after	upgrading.

	      Reference	copy of	the configuration file.	Always kept up to date
	      with the version of Squid	you are	using.

	      Use  this	 to  read  the documentation for configuration options
	      available	in your	build of Squid.	The online configuration  man-
	      ual  is  also  available	for a full reference of	options.  see-

	      The main configuration file for the web cachemgr.cgi tools.

	      The main configuration file for the Sample MSNT authenticator.

	      CSS Stylesheet to	control	the display of generated error	pages.
	      Use  this	to set any company branding you	need, it will apply to
	      every language Squid provides error pages	for.

       Some files also located elsewhere:

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

	      Location of Squid	error pages and	templates.

       Squid was written over many years by a changing team of developers  and
       maintained  in  turn  by	 Duane	Wessels	_duane@squid-cache.org_	Henrik
       Nordstrom  _hno@squid-cache.org_	 Amos  Jeffries	  _amosjeffries@squid-

       With  contributions  from many others in	the Squid community.  see CON-
       TRIBUTORS for a full list of individuals	 who  contributed  code.   see
       CREDITS for a list of major code	contributing copyright holders.

	*  Copyright (C) 1996-2015 The Squid Software Foundation and contribu-
	* Squid	software is distributed	under GPLv2+ license and includes
	* contributions	from numerous individuals and organizations.
	* Please see the COPYING and CONTRIBUTORS files	for details.

       Questions on the	usage of this program can be sent to the  Squid	 Users
       mailing list <>

       Bug  reports  need  to  be  made	 in  English.	See http://wiki.squid- for details of what you need to include
       with your bug report.

       Report bugs or bug fixes	using

       Report serious security bugs to Squid Bugs _squid-bugs@squid-cache.org_

       Report ideas for	new improvements to the	Squid Developers mailing  list

       cachemgr.cgi  (8),  squidclient (1), pam_auth (8), squid_ldap_auth (8),
       squid_ldap_group	(8), ext_session_acl (8), squid_unix_group (8),
       The Squid FAQ wiki
       The Squid Configuration Manual



Want to link to this manual page? Use this URL:

home | help