TAO/tests/RTCORBA/Explicit_Binding/README

   1
   2
   3 This is a test for <Object::_validate_connection> method, i.e.,
   4 explicit binding functionality.
   5
   6 Description.
   7 --------
   8 The goal of this test is to check that <validate_connection>
   9 establishes connections appropriate for the effective policy
  10 overrides, and that it detects policy misconfigurations and reports
  11 them back to the client via <inconsistent_policies> parameter.
  12
  13 The server creates an object, which can be used through IIOP or SHMIOP,
  14 and publishes its IOR.  The client performs three tests:
  15
  16 1) Set ClientProtocolPolicy override to SHMIOP, and invoke
  17 <validate_connection> on the object.  This should return TRUE, and one
  18 SHMIOP connection should get established.
  19
  20 2) Invoke <test_method> on the object.  The invocation should succeed
  21 and NO new connections should get established (connection from step 1
  22 should get used).
  23
  24 3) Now set ClientProtocolPolicy override to UIOP, and invoke
  25 <validate_connection> on the object.  It should return FALSE (because
  26 the server is not reachable through UIOP), and <inconsistent_policies>
  27 should contain the problematic override: ClientProtocolPolicy we
  28 specified.
  29
  30
  31 To run (on Unix):
  32 -------
  33 $./server [-o <ior_output_file>] -ORBendpoint iiop:// -ORBendpoint shmiop://
  34 $./client [-o <ior>] -ORBdebuglevel 1
  35
  36
  37 Options:
  38 --------
  39         Server:
  40
  41 -o <ior_output_file>       Default: test.ior
  42                            Filename for output of the server IOR.
  43
  44 -ORBendpoint iiop://       Default: none
  45 -ORBendpoint shmiop://     Need to open server endpoints for several
  46                            protocols.  Client is hardcoded to use
  47                            SHMIOP, so these options must be specified
  48                            for the test to work.
  49
  50         Client:
  51
  52 -o <ior>                   Default: file://test.ior
  53                            IOR of the test object.
  54
  55 -ORBdebuglevel 1           Default: none
  56                            Recommended debug level for monitoring of
  57                            connection establishment.
  58
  59 Expected output:
  60 ----------------
  61 Below is a sample output from run_test.pl on NT.  Please note that
  62 since in this test we are using ORB debug option
  63
  64 1) test output may look different from that shown below as ORB debug
  65    messages are modified by developers
  66 2) the output may contain some debug information irrelevant to this
  67    test
  68
  69
  70 ********** RTCORBA Explicit Binding Unit Test
  71
  72 <IOR:010000000d00000049444c3a546573743a312e300000000002000000000000007e000000010
  73 102cd050000006865726100cd37081b00000014010f005253547078283a180e0c000000000001000
  74 00001000000cd03000000000000000800000001cdcdcd004f4154010000001400000001cdcdcd010
  75 00100000000000901010000000000024f41541600000001cdcdcd01000000050000006865726100c
  76 d3708ffff0000024f41547e000000010102cd050000006865726100cd38081b00000014010f00525
  77 3547078283a180e0c00000000000100000001000000cd03000000000000000800000001cdcdcd004
  78 f4154010000001400000001cdcdcd01000100000000000901010000000000024f41541600000001c
  79 dcdcd01000000050000006865726100cd3808ffff>
  80
  81 TAO (964|300) Loaded default protocol <IIOP_Factory>
  82 TAO (964|300) Loaded default protocol <SHMIOP_Factory>
  83
  84      Test 1
  85 TAO (964|300) Connector::connect - looking for SHMIOP connection.
  86 TAO (964|300) SHMIOP connection to server <127.0.0.1:2104> on 320
  87
  88      Test 2
  89 TAO (964|300) Connector::connect - looking for SHMIOP connection.
  90 Server: test_method invoked.
  91
  92      Test 3
  93 Inconsistent policies contain ClientProtocolPolicy, as expected.
  94
  95   Testing over - shutting down
  96 TAO (964|300) Connector::connect - looking for SHMIOP connection.
  97 Server ORB event loop finished
  98 TAO (964|300) SHMIOP_Client_Connection_Handler::handle_close (320, 511)
  99