--------------------- PatchSet 8296 Date: 2006/06/25 12:00:09 Author: serassio Branch: nt Tag: (none) Log: Merged all Windows specific release notes into release-2.6.* files Members: doc/Makefile.am:1.5.8.2->1.5.8.3 doc/win32-relnotes.html:1.1.20.1->1.1.20.2(DEAD) doc/release-notes/release-2.6.html:1.2.4.10->1.2.4.11 doc/release-notes/release-2.6.sgml:1.2.4.11->1.2.4.12 Index: squid/doc/Makefile.am =================================================================== RCS file: /cvsroot/squid-sf//squid/doc/Makefile.am,v retrieving revision 1.5.8.2 retrieving revision 1.5.8.3 diff -u -r1.5.8.2 -r1.5.8.3 --- squid/doc/Makefile.am 31 May 2006 10:20:00 -0000 1.5.8.2 +++ squid/doc/Makefile.am 25 Jun 2006 12:00:09 -0000 1.5.8.3 @@ -32,8 +32,7 @@ EXTRA_DIST = \ squid.8.in \ cachemgr.cgi.8.in \ - debug-sections.txt \ - win32-relnotes.html + debug-sections.txt CLEANFILES = \ squid.8 \ --- squid/doc/win32-relnotes.html Wed Feb 14 01:16:31 2007 +++ /dev/null Wed Feb 14 01:16:31 2007 @@ -1,156 +0,0 @@ - - - -WIN32 Squid Release Notes - - - - -

WIN32 Squid Release Notes

-
-

Windows Service run mode

- -

When Squid is compiled as a Windows service, the -N command line switch is disabled, and default run mode of -Squid is no daemon (=no service) mode, so is possible to run Squid from command line -for debug purpose with all command line options available.

-

On Windows 2000/XP/2003 the service is configured to use the Windows Service Recovery option restarting -automatically after 60 seconds.

- -

Usage

- -

The squid -? command gives the following output: - -

Usage: squid [-dhirsvzCDFRVYX] [-f config-file] [-[au] port] [-k signal] [-n nam
-e] [-O CommandLine]
-       -a port   Specify HTTP port number (default: 3128).
-       -d level  Write debugging to stderr also.
-       -f file   Use given config-file instead of
-                 c:/squid/etc/squid.conf
-       -h        Print help message.
-       -i        Installs 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: SquidNT.
-       -r        Removes a Windows Service (see -n option).
-       -s        Enable logging to syslog.
-       -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.
-       -O options
-                 Set Windows Service Command line options in Registry.
-       -R        Do not set REUSEADDR on port.
-       -S        Double-check swap during rebuild.
-       -V        Virtual host httpd-accelerator.
-       -X        Force full debugging.
-       -Y        Only return UDP_HIT or UDP_MISS_NOFETCH during fast reload.
-
- -

The service installation is made with -i command line switch, it's possible to use --f switch at the same time for specify a different config-file settings for the Squid -Service that is stored on Registry.

-

A new -n switch specify the Windows Service Name, so multiple Squid instance are allowed. -"SquidNT" is the default when the switch is not used.

- -

So the install service syntax is: -

squid -i [-f file] [-n name]
-

-

To start as service is used a "hidden" --ntservice:service-name command line switch, -where service-name is the name specified with -n options at service install time.

- -

Service uninstallation is made with -r command line switch plus the appropriate --n switch.

- -

The -k switch family must be used with the appropriate -f and -n switches, so the syntax is: - -

squid -k command [-f file] -n service-name
-where service-name is the name specified with -n options at service install time.

- -

To use Squid original command line, the new -O switch must be used ONCE, the sintax is: - -

squid -O cmdline [-n service-name]
- -If multiple service command line options must be specified, use quote. The -n switch is -needed only when non default service name is in use.

-Don't use the "Start parameters" in the Windows 2000/XP/2003 Service applet: they are specific to -Windows services functionality and Squid is not designed for understand they

- -

Example: - -

squid -O "-D -a 8080" -n squidsvc

- - -

PSAPI.DLL (Process Status Helper) Considerations

- -

The process status helper functions make it easier for you to obtain information about -processes and device drivers running on Microsoft® Windows NT®/Windows® 2000. These -functions are available in PSAPI.DLL, which is distributed in the Microsoft® Platform -Software Development Kit (SDK). The same information is generally available through the -performance data in the registry, but it is more difficult to get to it. PSAPI.DLL is -freely redistributable.

- -

PSAPI.DLL is available only on Windows NT, 2000, XP and .NET. The implementation in Squid is -aware of this, and try to use it only on the rigth platform.

- -

On Windows NT PSAPI.DLL can be found as component of many applications, if you need it, -you can find it on Windows NT Resource KIT. If you have problem, it can be -downloaded from here: -http://download.microsoft.com/download/platformsdk/Redist/4.0.1371.1/NT4/EN-US/psinst.EXE

- -

On Windows 2000 and later it is available installing the Windows Support Tools, located on the -Support\Tools folder of the installation Windows CD-ROM.

- - -

Registry DNS lookup

- -

On Windows platforms, if no value is specified in the dns_nameservers option on -squid.conf or in the /etc/resolv.conf file, the list of DNS name servers are -taken from the Windows registry, both static and dynamic DHCP configurations -are supported.

- - -

Awin32 fs module

- -

awin32 is a native WIN32 Async I/O Squid fs module derived from aufs. Configuration -in squid.conf is identical to aufs, but You nedd to specify 'awin32' instead 'aufs' as -cache type.

- -

Compatibility Notes -

- -

Known Limitations:

- -
-To report a BUG, e-mail on squidnt@acmeconsulting.it.
-The latest version and documentation can be found on http://www.acmeconsulting.it/SquidNT.htm.
-
- - Index: squid/doc/release-notes/release-2.6.html =================================================================== RCS file: /cvsroot/squid-sf//squid/doc/release-notes/release-2.6.html,v retrieving revision 1.2.4.10 retrieving revision 1.2.4.11 diff -u -r1.2.4.10 -r1.2.4.11 --- squid/doc/release-notes/release-2.6.html 25 Jun 2006 11:36:53 -0000 1.2.4.10 +++ squid/doc/release-notes/release-2.6.html 25 Jun 2006 12:00:10 -0000 1.2.4.11 @@ -7,7 +7,7 @@

Squid 2.6.STABLE1 release notes

-

Squid Developers

$Id: release-2.6.html,v 1.2.4.10 2006/06/25 11:36:53 serassio Exp $ +

Squid Developers

$Id: release-2.6.html,v 1.2.4.11 2006/06/25 12:00:10 serassio Exp $
This document contains the release notes for version 2.6 of Squid. Squid is a WWW Cache application developed by the Web Caching community. @@ -204,7 +204,39 @@ restarting automatically after 60 seconds.
-
Usage

Some new command line options was added for the Windows service support:

+
Usage

The "squid -?" command gives the following output:

+

+

+Usage: squid [-hirvzCDFRYX] [-d level] [-s | -l facility] [-f config-file] [-u port] [-k signal] [-n name] [-O command-line]
+       -d level  Write debugging to stderr also.
+       -f file   Use given config-file instead of
+                 c:/squid/etc/squid.conf
+       -h        Print help message.
+       -i        Installs 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        Removes a Windows Service (see -n option).
+       -s | -l facility
+                 Enable logging to syslog.
+       -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.
+       -N        No daemon mode.
+       -O "options"
+                 Set Windows Service Command line options in Registry.
+       -R        Do not set REUSEADDR on port.
+       -S        Double-check swap during rebuild.
+       -X        Force full debugging.
+       -Y        Only return UDP_HIT or UDP_MISS_NOFETCH during fast reload.
+
+

+

Some new command line options was added for the Windows service support:

The service installation is made with -i command line switch, it's possible to use -f switch at the same time for specify a different config-file settings for the Squid Service that will be stored on the Windows Registry.

@@ -244,6 +276,24 @@

+
PSAPI.DLL (Process Status Helper) Considerations

The process status helper functions make it easier for you to obtain information about +processes and device drivers running on Microsoft® Windows NT®/Windows® 2000. These +functions are available in PSAPI.DLL, which is distributed in the Microsoft® Platform +Software Development Kit (SDK). The same information is generally available through the +performance data in the registry, but it is more difficult to get to it. PSAPI.DLL is +freely redistributable.

+

PSAPI.DLL is available only on Windows NT, 2000, XP and .NET. The implementation in Squid is +aware of this, and try to use it only on the rigth platform.

+

On Windows NT PSAPI.DLL can be found as component of many applications, if you need it, +you can find it on Windows NT Resource KIT. If you have problem, it can be +downloaded from here: +http://download.microsoft.com/download/platformsdk/Redist/4.0.1371.1/NT4/EN-US/psinst.EXE

+

On Windows 2000 and later it is available installing the Windows Support Tools, located on the +Support\Tools folder of the installation Windows CD-ROM.

+
+

+

+

Registry DNS lookup

On Windows platforms, if no value is specified in the dns_nameservers option on squid.conf or in the /etc/resolv.conf file, the list of DNS name servers are taken from the Windows registry, both static and dynamic DHCP configurations @@ -252,6 +302,14 @@

+
Awin32 fs module

awin32 is a native WIN32 Async I/O Squid fs module derived from aufs. Configuration +in squid.conf is identical to aufs, but You nedd to specify 'awin32' instead 'aufs' as +cache type.

+
+

+ +

+

Compatibility Notes

  • It's recommended to use '/' char in Squid paths instead of '\'
  • @@ -292,6 +350,7 @@
  • Some code sections can make blocking calls.
  • Some external helpers may not work.
  • +
  • File Descriptors number hard-limited to 2048.

Index: squid/doc/release-notes/release-2.6.sgml =================================================================== RCS file: /cvsroot/squid-sf//squid/doc/release-notes/release-2.6.sgml,v retrieving revision 1.2.4.11 retrieving revision 1.2.4.12 diff -u -r1.2.4.11 -r1.2.4.12 --- squid/doc/release-notes/release-2.6.sgml 25 Jun 2006 11:36:53 -0000 1.2.4.11 +++ squid/doc/release-notes/release-2.6.sgml 25 Jun 2006 12:00:10 -0000 1.2.4.12 @@ -2,7 +2,7 @@
Squid 2.6.STABLE1 release notes Squid Developers -$Id: release-2.6.sgml,v 1.2.4.11 2006/06/25 11:36:53 serassio Exp $ +$Id: release-2.6.sgml,v 1.2.4.12 2006/06/25 12:00:10 serassio Exp $ This document contains the release notes for version 2.6 of Squid. @@ -177,6 +177,37 @@ Usage +The "squid -?" command gives the following output: + +Usage: squid [-hirvzCDFRYX] [-d level] [-s | -l facility] [-f config-file] [-u port] [-k signal] [-n name] [-O command-line] + -d level Write debugging to stderr also. + -f file Use given config-file instead of + c:/squid/etc/squid.conf + -h Print help message. + -i Installs 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 Removes a Windows Service (see -n option). + -s | -l facility + Enable logging to syslog. + -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. + -N No daemon mode. + -O "options" + Set Windows Service Command line options in Registry. + -R Do not set REUSEADDR on port. + -S Double-check swap during rebuild. + -X Force full debugging. + -Y Only return UDP_HIT or UDP_MISS_NOFETCH during fast reload. + + Some new command line options was added for the Windows service support: The service installation is made with -i command line switch, it's possible to use -f switch at @@ -212,6 +243,28 @@ +PSAPI.DLL (Process Status Helper) Considerations + +The process status helper functions make it easier for you to obtain information about +processes and device drivers running on Microsoft® Windows NT®/Windows® 2000. These +functions are available in PSAPI.DLL, which is distributed in the Microsoft® Platform +Software Development Kit (SDK). The same information is generally available through the +performance data in the registry, but it is more difficult to get to it. PSAPI.DLL is +freely redistributable. + +PSAPI.DLL is available only on Windows NT, 2000, XP and .NET. The implementation in Squid is +aware of this, and try to use it only on the rigth platform. + +On Windows NT PSAPI.DLL can be found as component of many applications, if you need it, +you can find it on Windows NT Resource KIT. If you have problem, it can be +downloaded from here: + + +On Windows 2000 and later it is available installing the Windows Support Tools, located on the +Support\Tools folder of the installation Windows CD-ROM. + + + Registry DNS lookup On Windows platforms, if no value is specified in the +Awin32 fs module + +awin32 is a native WIN32 Async I/O Squid fs module derived from aufs. Configuration +in squid.conf is identical to aufs, but You nedd to specify 'awin32' instead 'aufs' as +cache type. + + + + Compatibility Notes It's recommended to use '/' char in Squid paths instead of '\' @@ -251,6 +313,7 @@ Some code sections can make blocking calls. Some external helpers may not work. +File Descriptors number hard-limited to 2048.