]> git.ipfire.org Git - thirdparty/gnutls.git/commitdiff
Added more text on interoperability
authorNikos Mavrogiannopoulos <nmav@gnutls.org>
Mon, 23 Jan 2012 22:13:30 +0000 (23:13 +0100)
committerNikos Mavrogiannopoulos <nmav@gnutls.org>
Tue, 24 Jan 2012 17:33:59 +0000 (18:33 +0100)
doc/cha-gtls-app.texi

index c9d8e8e95db96371b44845c8991da3f931315ae6..b9c7e693044ce4e741019042bb862ba22ea9bc44 100644 (file)
@@ -873,7 +873,9 @@ structure by the server (see @ref{Parameter generation}).
 @item %COMPAT @tab
 will enable compatibility mode. It might mean that violations
 of the protocols are allowed as long as maximum compatibility with
-problematic clients and servers is achieved.
+problematic clients and servers is achieved. More specifically this
+string would disable TLS record random padding and tolerate packets
+over the maximum allowed TLS record.
 
 @item %NO_EXTENSIONS @tab
 will prevent the sending of any TLS extensions in client side. Note
@@ -1130,15 +1132,20 @@ Because there is no way to achieve maximum interoperability with broken peers
 without sacrificing security, @acronym{GnuTLS} ignores such peers by default. 
 This might not be acceptable in cases where maximum compatibility
 is required. Thus we allow enabling compatibility with broken peers using
-priority strings (see @ref{Priority Strings}). An example priority string that
-is known to provide wide compatibility even with broken peers
-is shown below:
+priority strings (see @ref{Priority Strings}). A conservative priority
+string that would disable certain @acronym{TLS} protocol
+options that are known to cause compatibility problems, is shown below. 
+@verbatim
+NORMAL:%COMPAT
+@end verbatim
+
+For broken peers that do not tolerate TLS version numbers over TLS 1.0
+another priority string is:
 @verbatim
 NORMAL:-VERS-TLS-ALL:+VERS-TLS1.0:+VERS-SSL3.0:%COMPAT
 @end verbatim
-This priority string will only enable SSL 3.0 and TLS 1.0 as protocols and
-will disable, via the @code{%COMPAT} keyword, several @acronym{TLS} protocol
-options that are known to cause compatibility problems. Note however that
+This priority string will in addition to above, only enable SSL 3.0 and 
+TLS 1.0 as protocols. Note however that
 there are known attacks against those protocol versions and
 this mode trades security for compatibility.