From 603280480adac3ff698db538d26966ecfb46d499 Mon Sep 17 00:00:00 2001 From: Lars Thorsen Date: Thu, 26 Jun 2014 14:22:45 +0200 Subject: [orber] Update documentation and fix testcase for IPv4/IPv6 --- lib/orber/doc/src/ch_naming_service.xml | 41 ++++++++++++++++++--------------- lib/orber/doc/src/corba.xml | 11 ++++++--- lib/orber/doc/src/orber.xml | 9 +++++--- 3 files changed, 36 insertions(+), 25 deletions(-) (limited to 'lib/orber/doc') diff --git a/lib/orber/doc/src/ch_naming_service.xml b/lib/orber/doc/src/ch_naming_service.xml index b735629a14..e355db2edb 100644 --- a/lib/orber/doc/src/ch_naming_service.xml +++ b/lib/orber/doc/src/ch_naming_service.xml @@ -273,25 +273,28 @@ lists:foreach(fun({{Id, Kind},BindingType}) -> case BindingType of

The notation of this scheme is similar to the more well known URL HTTP, and the full corbaloc BNF is:

= "corbaloc:"["/"] - = [","]* - = | - = | - = ":" - = rir - = - = ":" - = - = | ":" - = ":" - = "iiop" - = [":"] - = DNS-style Host Name | ip_address - = ".""@" | empty_string - = number - = number - = number - = for example NameService + = "corbaloc:"["/"] + = [","]* + = | + = | + = ":" + = rir + = + = ":" + = + = | ":" + = ":" + = "iiop" + = [":"] + = | | "[""]" + = ".""@" | empty_string + = number + = number + = number + = string + = string + = string + = for example NameService ]]>

The corbaloc scheme consists of 3 parts:

diff --git a/lib/orber/doc/src/corba.xml b/lib/orber/doc/src/corba.xml index 004c7fb9b0..685b497e09 100644 --- a/lib/orber/doc/src/corba.xml +++ b/lib/orber/doc/src/corba.xml @@ -294,7 +294,9 @@ Example:

This function returns the object reference for the object id asked for. The remote modifier string has the following format: - "iiop://host:port".

+ "iiop://"<host>":"<port> where <host> = <DNS hostname> | + <IPv4 address> | "["<IPv6 address>"]". +

The configuration context is used to override the global SSL client side configuration.

@@ -322,8 +324,11 @@ Example: ObjectId = string() -

This function returns a list of allowed object id's. The remote modifier - string has the following format: "iiop://host:port".

+

This function returns a list of allowed object id's. + The remote modifier string has the following format: + "iiop://"<host>":"<port> where <host> = <DNS hostname> | + <IPv4 address> | "["<IPv6 address>"]". +

The configuration context is used to override the global SSL client side configuration.

diff --git a/lib/orber/doc/src/orber.xml b/lib/orber/doc/src/orber.xml index 16781059c7..a182a56972 100644 --- a/lib/orber/doc/src/orber.xml +++ b/lib/orber/doc/src/orber.xml @@ -356,8 +356,8 @@ Type = normal | ssl Port = integer() > 0 ConfigurationParameters = [{Key, Value}] - Key = flags | iiop_in_connection_timeout | iiop_max_fragments | iiop_max_in_requests | interceptors | iiop_port | iiop_ssl_port | ssl_server_options - Value = as described in the User's Guide + Key = flags | ip_family | iiop_in_connection_timeout | iiop_max_fragments | iiop_max_in_requests | interceptors | iiop_port | iiop_ssl_port | ssl_server_options + Value = as described in the User's Guide or below Result = {ok, Ref} | {error, Reason} | {'EXCEPTION', #'BAD_PARAM'{}} Ref = #Ref Reason = string() @@ -383,6 +383,9 @@ flags - currently it is only possible to override the global setting for the Use Current Interface in IOR and Exclude CodeSet Component flags. + ip_family - can be set to inet or inet6 and is + used to get a listen interface that uses another IP version than the default + set with flags at startup. iiop_port - requires that Use Current Interface in IOR is activated and the supplied Type is normal. If so, exported IOR:s will contain the IIOP port defined by this configuration @@ -390,7 +393,7 @@ iiop_ssl_port - almost equivalent to iiop_port. The difference is that Type shall be ssl and that exported IOR:s will contain the IIOP via SSL port defined by this configuration - parameter. + parameter.

If it is not possible to add a listener based on the supplied interface and port, the error message is one of the ones described in inet -- cgit v1.2.3 From a47a3615418893dc95c0f49d7926bcd5f23fe091 Mon Sep 17 00:00:00 2001 From: Lars Thorsen Date: Thu, 31 Jul 2014 12:44:37 +0200 Subject: [orber] Add test suite for ORB with dual ipv4/ipv6 configuration --- lib/orber/doc/src/corba.xml | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) (limited to 'lib/orber/doc') diff --git a/lib/orber/doc/src/corba.xml b/lib/orber/doc/src/corba.xml index 685b497e09..4a11b271b4 100644 --- a/lib/orber/doc/src/corba.xml +++ b/lib/orber/doc/src/corba.xml @@ -370,9 +370,11 @@ Example:

This function takes a corbaname, corbaloc or an IOR on the external string representation and returns the object reference.

To lookup the NameService reference, simply use - "corbaloc:iiop:1.2@123.0.0.012:4001/NameService"

+ "corbaloc:iiop:1.2@123.0.0.12:4001/NameService"

We can also resolve an object from the NameService by using - "corbaname:iiop:1.2@123.0.0.012:4001/NameService#org/Erlang/MyObj"

+ "corbaname:iiop:1.2@123.0.0.12:4001/NameService#org/Erlang/MyObj"

+

To lookup the NameService reference with an IPv6 address, simply use + "corbaloc:iiop:1.2@[FEC1:0:3:0:0312:44AF:FAB1:3D01]:4001/NameService"

For more information about corbaname and corbaloc, see the User's Guide (Interoperable Naming Service).

The configuration context is used to override the global -- cgit v1.2.3 From 3e871d69871fd30b4a3f97766bdaf6ea6b3cc092 Mon Sep 17 00:00:00 2001 From: Erlang/OTP Date: Thu, 7 Aug 2014 17:36:36 +0200 Subject: Update release notes --- lib/orber/doc/src/notes.xml | 41 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 40 insertions(+), 1 deletion(-) (limited to 'lib/orber/doc') diff --git a/lib/orber/doc/src/notes.xml b/lib/orber/doc/src/notes.xml index 93dc403c47..141d306740 100644 --- a/lib/orber/doc/src/notes.xml +++ b/lib/orber/doc/src/notes.xml @@ -33,7 +33,46 @@ -

Orber 3.6.27 +
Orber 3.7 + +
Fixed Bugs and Malfunctions + + +

The following functions have been corrected so they + work properly with IPv6 addresses.

+ corba:resolve_initial_references_remote/2/3 + corba:list_initial_references_remote/1/2 + corba:string_to_object/1/2 +

+ Own Id: OTP-12016

+ + +

A couple of macros were malformed, missing commas: + PROFILEBODY_1_1_TYPEDEF and PROFILEBODY_1_2_TYPEDEF. + Thanks to Vlad Dumitrescu.

+

+ Own Id: OTP-12062

+ + +
+ + +
Improvements and New Features + + +

It is now possible to add listen interfaces for IPv6 + when orber is default configured for IPv4 and the other + way around. For more information, consult the User's + Guide and the orber module Reference Manual.

+

+ Own Id: OTP-12007

+ + +
+ +
+ +
Orber 3.6.27
Fixed Bugs and Malfunctions -- cgit v1.2.3