~rousskov/squid/IcapLog3p0

« back to all changes in this revision

Viewing changes to doc/release-notes/release-3.0.html

  • Committer: Alex Rousskov
  • Date: 2008-12-03 22:02:49 UTC
  • mfrom: (8899.1.36 SQUID_3_0)
  • Revision ID: rousskov@measurement-factory.com-20081203220249-mzqlhnjq5yw0nmg2
Merged from v3.0 branch at r8935.

Show diffs side-by-side

added added

removed removed

Lines of Context:
2
2
<HTML>
3
3
<HEAD>
4
4
 <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.50">
5
 
 <TITLE>Squid 3.0.STABLE9 release notes</TITLE>
 
5
 <TITLE>Squid 3.0.STABLE11-RC1 release notes</TITLE>
6
6
</HEAD>
7
7
<BODY>
8
 
<H1>Squid 3.0.STABLE9 release notes</H1>
 
8
<H1>Squid 3.0.STABLE11-RC1 release notes</H1>
9
9
 
10
 
<H2>Squid Developers</H2>$Id: release-3.0.sgml,v 1.30.2.5 2008/02/28 00:26:31 amosjeffries Exp $
 
10
<H2>Squid Developers</H2>
11
11
<HR>
12
12
<EM>This document contains the release notes for version 3.0 of Squid.
13
13
Squid is a WWW Cache application developed by the National Laboratory
15
15
<HR>
16
16
<H2><A NAME="s1">1. Notice</A></H2>
17
17
 
18
 
<P>The Squid Team are pleased to announce the release of Squid-3.0.STABLE9.</P>
 
18
<P>The Squid Team are pleased to announce the release of Squid-3.0.STABLE11-RC1.</P>
19
19
<P>This new release is available for download from 
20
20
<A HREF="http://www.squid-cache.org/Versions/v3/3.0/">http://www.squid-cache.org/Versions/v3/3.0/</A> or the 
21
21
<A HREF="http://www.squid-cache.org/Mirrors/http-mirrors.html">mirrors</A>.</P>
123
123
</P>
124
124
<P>See 
125
125
<A HREF="http://www.squid-cache.org/Doc/FAQ/FAQ-6.html#ss6.7">http://www.squid-cache.org/Doc/FAQ/FAQ-6.html#ss6.7</A> for a definition of all log types.</P>
 
126
 
 
127
 
126
128
<H2><A NAME="s5">5. Windows support</A></H2>
127
129
 
128
130
<P>This Squid version can run on Windows as a system service using the Cygwin emulation environment, 
345
347
 
346
348
 
347
349
 
348
 
<H2><A NAME="ss5.1">5.1 Changes to squid.conf</A>
349
 
</H2>
 
350
<H2><A NAME="s6">6. Changes to squid.conf since Squid-2.6</A></H2>
350
351
 
351
352
<P>There have been many changes to Squid's configuration file since Squid-2.6.</P>
352
 
<P>This section gives a thorough account of those changes in three categories:</P>
 
353
 
 
354
<P>This section gives a detailed account of those changes in three categories:</P>
353
355
<P>
354
356
<UL>
355
357
<LI>
362
364
</P>
363
365
 
364
366
 
365
 
 
366
 
 
367
 
 
368
 
<H3><A NAME="newtags"></A> New tags</H3>
 
367
<H2><A NAME="newtags"></A> <A NAME="ss6.1">6.1 New tags</A>
 
368
</H2>
369
369
 
370
370
<P>
371
371
<DL>
384
384
        
385
385
</PRE>
386
386
</P>
 
387
 
387
388
<DT><B>background_ping_rate</B><DD>
388
389
<P>
389
390
<PRE>
654
655
</P>
655
656
 
656
657
 
657
 
<H3><A NAME="modifiedtags"></A> Changes to existing tags</H3>
 
658
<H2><A NAME="modifiedtags"></A> <A NAME="ss6.2">6.2 Changes to existing tags</A>
 
659
</H2>
658
660
 
659
661
<P>
660
662
<DL>
677
679
        
678
680
</PRE>
679
681
</P>
680
 
<P>Removed options:
681
 
<PRE>
682
 
    urlgroup=, not yet ported to Squid-3.
683
 
    
684
 
    no-connection-auth, not yet ported to Squid-3.
685
 
        
686
 
</PRE>
687
 
        </P>
688
 
<DT><B> https_port</B><DD>
689
 
<P>Removed options:
690
 
<PRE>
691
 
    urlgroup=, not yet ported to Squid-3.
692
 
        
693
 
</PRE>
694
 
</P>
 
682
 
695
683
<DT><B>cache_peer</B><DD>
696
684
<P>New options:
697
685
<PRE>
717
705
     frequency of each parent being based on the round trip
718
706
     time. Closer parents are used more often.
719
707
     Usually used for background-ping parents.
720
 
 
721
 
        
722
 
</PRE>
723
 
</P>
724
 
<P>Removed options:
725
 
<PRE>
726
 
    monitorurl, monitorsize etc, not yet ported to Squid-3
727
 
 
728
 
    connection-auth=, not yet ported to Squid-3
729
 
        
730
 
</PRE>
731
 
</P>
 
708
        
 
709
</PRE>
 
710
</P>
 
711
 
732
712
<DT><B>cache_dir</B><DD>
733
 
<P>Common options
734
 
<PRE>
735
 
    no-store, replaces the older read-only option
736
 
 
737
 
    min-size, not yet ported to Squid-3
738
 
        
739
 
</PRE>
740
 
</P>
741
 
<P>COSS file system:
742
 
<PRE>
743
 
    The coss file store is experimental, and still lacks much
744
 
    of the functionality found in 2.6.
745
 
 
746
 
    overwrite-percent=n, not yet ported to Squid-3.
747
 
 
748
 
    max-stripe-waste=n, not yet ported to Squid-3.
749
 
 
750
 
    membufs=n, not yet ported to Squid-3.
751
 
 
752
 
    maxfullbufs=n, not yet ported to Squid-3.
753
 
        
754
 
</PRE>
755
 
</P>
 
713
<P>Common options <EM>no-store</EM>, replaces the older <EM>read-only</EM> option</P>
 
714
 
756
715
<DT><B>auth_param</B><DD>
757
716
<P>Removed Basic auth option
758
717
<PRE>
761
720
        
762
721
</PRE>
763
722
</P>
764
 
<P>Removed digest options:
765
 
<PRE>
766
 
    concurrency, not yet ported to Squid-3.
767
 
        
768
 
</PRE>
769
 
</P>
770
723
 
771
724
<DT><B>external_acl_type</B><DD>
772
725
<P>New format specifications:
777
730
        
778
731
</PRE>
779
732
</P>
780
 
<P>Removed format specifications:
781
 
<PRE>
782
 
    %ACL, not yet ported to Squid-3
783
 
 
784
 
    %DATA, not yet ported to Squid-3
785
 
        
786
 
</PRE>
787
 
</P>
788
733
<P>New result keywords:
789
734
<PRE>
790
735
     tag=  Apply a tag to a request (for both ERR and OK results)
817
762
<P>New types:
818
763
<PRE>
819
764
    acl aclname http_status 200 301 500- 400-403 ...     # status code in reply
820
 
 
821
 
        
822
 
</PRE>
823
 
</P>
824
 
<P>Removed types:
825
 
<PRE>
826
 
    acl aclname urllogin [-i] [^a-zA-Z0-9] ...      # regex matching on URL login field
827
 
 
828
 
    acl urlgroup group1 ...
829
 
        # match against the urlgroup as indicated by redirectors
830
 
 
831
765
        
832
766
</PRE>
833
767
</P>
906
840
<P>allow/deny no longer used.</P>
907
841
 
908
842
<DT><B>url_rewrite_program</B><DD>
909
 
<P>No urlgroup support in either requests or responese</P>
 
843
<P>No urlgroup support in either requests or response</P>
910
844
 
911
845
<DT><B>auth_param</B><DD>
912
846
<P>fake_auth helper for NTLM now accepts the '-S' parameter to strip NTLM domain off the username string.
915
849
</DL>
916
850
</P>
917
851
 
918
 
 
919
 
 
920
 
 
921
 
<H3><A NAME="removedtags"></A> Removed tags</H3>
 
852
<H2><A NAME="removedtags"></A> <A NAME="ss6.3">6.3 Removed tags</A>
 
853
</H2>
922
854
 
923
855
<P>
924
856
<DL>
925
 
<DT><B>broken_vary_encoding</B><DD>
926
 
<P>Not yet ported to Squid-3.</P>
927
 
<DT><B>cache_vary</B><DD>
928
 
<P>Not yet ported to Squid-3.</P>
929
 
<DT><B>collapsed_forwarding</B><DD>
930
 
<P>Not yet ported to Squid-3.</P>
931
 
<DT><B>follow_x_forwarded_for</B><DD>
932
 
<P>Not yet ported to Squid-3.</P>
933
 
<DT><B>*_uses_indirect_client</B><DD>
934
 
<P>Not yet ported to Squid-3.</P>
935
 
<DT><B>error_map</B><DD>
936
 
<P>Not yet ported to Squid-3.</P>
937
857
<DT><B>header_access</B><DD>
938
858
<P>This has been replaced by request_header_access and reply_header_access</P>
939
 
<DT><B>http_access2</B><DD>
940
 
<P>Not yet ported to Squid-3.</P>
 
859
 
941
860
<DT><B>httpd_accel_no_pmtu_disc</B><DD>
942
861
<P>Replaced by disable-pmtu-discovery http_port option</P>
943
 
<DT><B>location_rewrite_*</B><DD>
944
 
<P>Not yet ported to Squid-3.</P>
945
 
<DT><B>refresh_stale_hit</B><DD>
946
 
<P>Not yet ported to Squid-3.</P>
 
862
 
947
863
<DT><B>wais_relay_*</B><DD>
948
864
<P>equivalent to cache_peer + cache_peer_access.</P>
 
865
 
949
866
</DL>
950
867
</P>
951
868
 
952
869
 
953
 
<H2><A NAME="ss5.2">5.2 Changes to ./configure Options</A>
954
 
</H2>
 
870
<H2><A NAME="s7">7. Changes to ./configure Options since Squid-2.6</A></H2>
955
871
 
956
872
<P>There have been some changes to Squid's build configuration since Squid-2.6.</P>
 
873
 
957
874
<P>This section gives an account of those changes in three categories:</P>
958
875
<P>
959
876
<UL>
962
879
<LI>
963
880
<A HREF="#modifiedoptions">Changes to existing options</A></LI>
964
881
<LI>
965
 
<A HREF="#notportedoptions">Not yet available options</A></LI>
966
 
<LI>
967
882
<A HREF="#removedoptions">Removed options</A></LI>
968
883
</UL>
969
884
</P>
970
885
 
971
886
 
972
887
 
973
 
<H3><A NAME="newoptions"></A> New options</H3>
 
888
<H2><A NAME="newoptions"></A> <A NAME="ss7.1">7.1 New options</A>
 
889
</H2>
974
890
 
975
891
<P>
976
892
<DL>
1084
1000
 
1085
1001
</DL>
1086
1002
</P>
1087
 
<H3><A NAME="modifiedoptions"></A> Changes to existing options</H3>
 
1003
<H2><A NAME="modifiedoptions"></A> <A NAME="ss7.2">7.2 Changes to existing options</A>
 
1004
</H2>
1088
1005
 
1089
1006
<P>
1090
1007
<DL>
1127
1044
 
1128
1045
</DL>
1129
1046
</P>
1130
 
<H3><A NAME="notportedoptions"></A> Not yet available options</H3>
1131
 
 
1132
 
<P>These configure options have not yet been ported to Squid-3. If you need something to do then
1133
 
porting one of these from Squid-2 to Squid-3 is most welcome.</P>
1134
 
<P>
1135
 
<DL>
1136
 
<DT><B>--enable-devpoll</B><DD>
1137
 
<P>Support for Solaris /dev/poll</P>
1138
 
 
1139
 
<DT><B>--enable-select-simple</B><DD>
1140
 
<P>Basic POSIX select() loop without any binary fd_set optimizations.</P>
1141
 
 
1142
 
<DT><B>--enable-follow-x-forwarded-for</B><DD>
1143
 
<P>Support following the X-Forwarded-For HTTP header for determining the
1144
 
client IP address</P>
1145
 
</DL>
1146
 
</P>
1147
 
 
1148
 
<H3><A NAME="removedoptions"></A> Removed options</H3>
 
1047
<H2><A NAME="removedoptions"></A> <A NAME="ss7.3">7.3 Removed options</A>
 
1048
</H2>
1149
1049
 
1150
1050
<P>The following configure options have been removed.</P>
1151
1051
<P>
1168
1068
</DL>
1169
1069
</P>
1170
1070
 
 
1071
 
 
1072
<H2><A NAME="s8">8. Regressions since Squid-2.7</A></H2>
 
1073
 
 
1074
<P>Some squid.conf and ./configure options which were available in Squid-2.7 are not yet available in Squid-3.0</P>
 
1075
 
 
1076
<P>If you need something to do then porting one of these from Squid-2 to Squid-3 is most welcome.</P>
 
1077
 
 
1078
<H2><A NAME="ss8.1">8.1 Missing squid.conf options available in Squid-2.7</A>
 
1079
</H2>
 
1080
 
 
1081
<P>
 
1082
<DL>
 
1083
<DT><B>acl</B><DD>
 
1084
<P><EM>urllogin</EM> option not yet ported from 2.6</P>
 
1085
<P><EM>urlgroup</EM> option not yet ported from 2.6</P>
 
1086
 
 
1087
<DT><B>acl_uses_indirect_client</B><DD>
 
1088
<P>Not yet ported from 2.6</P>
 
1089
 
 
1090
<DT><B>auth_param digest</B><DD>
 
1091
<P><EM>concurrency</EM> option not yet ported from Squid-2</P>
 
1092
 
 
1093
<DT><B>authenticate_ip_shortcircuit_access</B><DD>
 
1094
<P>Not yet ported from 2.7</P>
 
1095
 
 
1096
<DT><B>authenticate_ip_shortcircuit_ttl</B><DD>
 
1097
<P>Not yet ported from 2.7</P>
 
1098
 
 
1099
<DT><B>broken_vary_encoding</B><DD>
 
1100
<P>Not yet ported from 2.6</P>
 
1101
 
 
1102
<DT><B>cache_dir</B><DD>
 
1103
<P><EM>min-size</EM> option not yet ported from Squid-2</P>
 
1104
<P><EM>COSS</EM> storage type is lacking stability fixes from 2.6</P>
 
1105
<P>COSS <EM>overwrite-percent=</EM> option not yet ported from 2.6</P>
 
1106
<P>COSS <EM>max-stripe-waste=</EM> option not yet ported from 2.6</P>
 
1107
<P>COSS <EM>membufs=</EM> option not yet ported from 2.6</P>
 
1108
<P>COSS <EM>maxfullbufs=</EM> option not yet ported from 2.6</P>
 
1109
 
 
1110
<DT><B>cache_peer</B><DD>
 
1111
<P><EM>multicast-siblings</EM> not yet ported from 2.7</P>
 
1112
<P><EM>idle=</EM> not yet ported from 2.7</P>
 
1113
<P><EM>http11</EM> not yet ported from 2.7</P>
 
1114
<P><EM>connection-auth=</EM> not yet ported from 2.6</P>
 
1115
<P><EM>monitorinterval=</EM> not yet ported from 2.6</P>
 
1116
<P><EM>monitorsize=</EM> not yet ported from 2.6</P>
 
1117
<P><EM>monitortimeout=</EM> not yet ported from 2.6</P>
 
1118
<P><EM>monitorurl=</EM> not yet ported from 2.6</P>
 
1119
 
 
1120
<DT><B>cache_vary</B><DD>
 
1121
<P>Not yet ported from 2.6</P>
 
1122
 
 
1123
<DT><B>collapsed_forwarding</B><DD>
 
1124
<P>Not yet ported from 2.6</P>
 
1125
 
 
1126
<DT><B>delay_pool_uses_indirect_client</B><DD>
 
1127
<P>Not yet ported from 2.6</P>
 
1128
 
 
1129
<DT><B>error_map</B><DD>
 
1130
<P>Not yet ported from 2.6</P>
 
1131
 
 
1132
<DT><B>external_acl_type</B><DD>
 
1133
<P><EM>%ACL</EM> format tag not yet ported from 2.6</P>
 
1134
<P><EM>%DATA</EM> format tag not yet ported from 2.6</P>
 
1135
 
 
1136
<DT><B>external_refresh_check</B><DD>
 
1137
<P>Not yet ported from 2.7</P>
 
1138
 
 
1139
<DT><B>follow_x_forwarded_for</B><DD>
 
1140
<P>Not yet ported from 2.6</P>
 
1141
 
 
1142
<DT><B>http_access2</B><DD>
 
1143
<P>Not yet ported from 2.6</P>
 
1144
 
 
1145
<DT><B>http_port</B><DD>
 
1146
<P><EM>act-as-origin</EM> not yet ported from 2.7</P>
 
1147
<P><EM>allow-direct</EM> not yet ported from 2.7</P>
 
1148
<P><EM>http11</EM> not yet ported from 2.7</P>
 
1149
<P><EM>urlgroup=</EM> not yet ported from 2.6</P>
 
1150
<P><EM>no-connection-auth</EM> not yet ported from 2.6</P>
 
1151
 
 
1152
<DT><B>ignore_expect_100</B><DD>
 
1153
<P>Not yet ported from 2.7</P>
 
1154
 
 
1155
<DT><B>ignore_ims_on_miss</B><DD>
 
1156
<P>Not yet ported from 2.7</P>
 
1157
 
 
1158
<DT><B>location_rewrite_access</B><DD>
 
1159
<P>Not yet ported from 2.6</P>
 
1160
 
 
1161
<DT><B>location_rewrite_children</B><DD>
 
1162
<P>Not yet ported from 2.6</P>
 
1163
 
 
1164
<DT><B>location_rewrite_concurrency</B><DD>
 
1165
<P>Not yet ported from 2.6</P>
 
1166
 
 
1167
<DT><B>location_rewrite_program</B><DD>
 
1168
<P>Not yet ported from 2.6</P>
 
1169
 
 
1170
<DT><B>log_uses_indirect_client</B><DD>
 
1171
<P>Not yet ported from 2.6</P>
 
1172
 
 
1173
<DT><B>logfile_daemon</B><DD>
 
1174
<P>Not yet ported from 2.7</P>
 
1175
 
 
1176
<DT><B>logformat</B><DD>
 
1177
<P><EM>%oa</EM> tag not yet ported from 2.7</P>
 
1178
<P><EM>%sn</EM> tag not yet ported from 2.7</P>
 
1179
 
 
1180
<DT><B>max_filedescriptors</B><DD>
 
1181
<P>Not yet ported from 2.7</P>
 
1182
 
 
1183
<DT><B>max_stale</B><DD>
 
1184
<P>Not yet ported from 2.7</P>
 
1185
 
 
1186
<DT><B>refresh_pattern</B><DD>
 
1187
<P><EM>stale-while-revalidate=</EM> not yet ported from 2.7</P>
 
1188
<P><EM>ignore-stale-while-revalidate=</EM> not yet ported from 2.7</P>
 
1189
<P><EM>max-stale=</EM> not yet ported from 2.7</P>
 
1190
<P><EM>negative-ttl=</EM> not yet ported from 2.7</P>
 
1191
 
 
1192
<DT><B>refresh_stale_hit</B><DD>
 
1193
<P>Not yet ported from 2.7</P>
 
1194
 
 
1195
<DT><B>server_http11</B><DD>
 
1196
<P>Not yet ported from 2.7</P>
 
1197
 
 
1198
<DT><B>storeurl_access</B><DD>
 
1199
<P>Not yet ported from 2.7</P>
 
1200
 
 
1201
<DT><B>storeurl_rewrite_children</B><DD>
 
1202
<P>Not yet ported from 2.7</P>
 
1203
 
 
1204
<DT><B>storeurl_rewrite_concurrency</B><DD>
 
1205
<P>Not yet ported from 2.7</P>
 
1206
 
 
1207
<DT><B>storeurl_rewrite_program</B><DD>
 
1208
<P>Not yet ported from 2.7</P>
 
1209
 
 
1210
<DT><B>update_headers</B><DD>
 
1211
<P>Not yet ported from 2.7</P>
 
1212
 
 
1213
<DT><B>upgrade_http0.9</B><DD>
 
1214
<P>Not yet ported from 2.7</P>
 
1215
 
 
1216
<DT><B>zero_buffers</B><DD>
 
1217
<P>Not yet ported from 2.7</P>
 
1218
 
 
1219
</DL>
 
1220
</P>
 
1221
 
 
1222
<H2><A NAME="ss8.2">8.2 Missing ./configure options available in Squid-2.7</A>
 
1223
</H2>
 
1224
 
 
1225
<P>
 
1226
<DL>
 
1227
<DT><B>--enable-devpoll</B><DD>
 
1228
<P>Support for Solaris /dev/poll</P>
 
1229
 
 
1230
<DT><B>--enable-select-simple</B><DD>
 
1231
<P>Basic POSIX select() loop without any binary fd_set optimizations.</P>
 
1232
 
 
1233
<DT><B>--enable-follow-x-forwarded-for</B><DD>
 
1234
<P>Support following the X-Forwarded-For HTTP header for determining the
 
1235
client IP address</P>
 
1236
 
 
1237
<DT><B>--without-system-md5</B><DD>
 
1238
 
 
1239
</DL>
 
1240
</P>
 
1241
 
1171
1242
</BODY>
1172
1243
</HTML>