From 9fb1a27800d0f45e794f33d95d982a3af6603312 Mon Sep 17 00:00:00 2001 From: mkubecek Date: Wed, 12 Nov 2014 17:32:42 +0000 Subject: [PATCH] Improvement CORE-3226: IPv6 support (9/9) add README.IPv6 describing IPv6 related changes --- doc/README.IPv6 | 42 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 doc/README.IPv6 diff --git a/doc/README.IPv6 b/doc/README.IPv6 new file mode 100644 index 0000000000..5c7e40fe1d --- /dev/null +++ b/doc/README.IPv6 @@ -0,0 +1,42 @@ +IPv6 support in Firebird 3.0 +---------------------------- + +Starting with version 3.0, Firebird can use IPv6 connections, both on client +and server side. + + +Client +------ + +As standard text form of an IPv6 address uses colons which Firebird uses to +separate host and database in connection strings, IPv6 address needs to be +enclosed in brackets. Examples: + + connect '[2014:1234::5]:test'; + connect '[2014:1234::5]/3049:/srv/firebird/test.fdb'; + +For consistency, (optional) square brackets can be also used around an IPv4 +address or a domain name. + +If a domain name is used in connection string, all addresses (IPv4 and IPv6) +are tried in the order returned by resolver until a connection is established. +Only if all attempts fail, the client fails to connect. + + +Server +------ + +By default, Firebird server listens on zero IPv6 address (::) and accepts all +incoming connections, IPv4 and IPv6. This behaviour can be changed by config +directive IPv6V6Only. If it is set to true, server listening on zero IPv6 +address (implicitely or explicitely) will accept only IPv6 connections. + +Different listening address (IPv4 or IPv6) can be set using RemoteBindAddress +directive. If an IPv4 address or non-zero IPv6 address is used, IPv6V6Only +directive has no effect. + +Note: on POSIX platforms, server started in Classic mode via (x)inetd ignores +the RemoteBindAddress, RemoteServicePort and RemoteServiceName directives as +the listening socket is set up by (x)inetd. Listening address and/or port need +to be set in (x)inetd configuration in this mode. +