TAO/performance-tests/POA/Demux/README

   1
   2
   3 This test directory tests various demultiplexing strategies used in
   4 TAO for POA, object, and operation name lookups
   5
   6 Description of various files:
   7
   8 CodeGen         Directory containing the code generator
   9
  10 server.cpp      server main program
  11 demux_test_server.{h, cpp}: Server-side implementation details
  12
  13 client.cpp      client main program
  14 demux_test_client.{h, cpp}: Client-side implementation details
  15 demux_test_macros.h: Some constants used by both the client and the server
  16
  17
  18 Generated Files:
  19 ----------------
  20
  21 Must run ./CodeGen/demux tool to generate the following files. See
  22 CodeGen/README for command line options.
  23
  24
  25 demux_test.idl: The Demux_Test IDL interface
  26 demux_test_i.{h, cpp}: Implementation of the Interface
  27 demux_test_client.i: Code to be included with the client
  28 poa_names.dat: Names for all the POAs to be used
  29
  30
  31 Command Line options
  32 --------------------
  33
  34 server -d  (for debugging)
  35        -p <num POAs>
  36        -o <num objects>
  37        -f <IOR file>  default is ior.dat
  38
  39 client -d  (for debugging)
  40        -p <num POAs>
  41        -o <num objs>
  42        -m <num methods>
  43        -f <IOR file>  default is ior.dat
  44        -n <loop count>
  45        -i <invoke strategy> (L = linear
  46                              R = random
  47                              B = best w.r.t linear
  48                              W = worst w.r.t linear)
  49
  50
  51 ------
  52 *NOTE*
  53 ------
  54 The num_POAs, num_objs, and num_ops must match on the client
  55 and server side.
  56
  57 Use the svc.conf file and change the -ORBsystemidpolicydemuxstrategy
  58 option to use the desired object lookup strategy. For system ID
  59 policy, active demuxing in the default.
  60
  61 Use the desired options to the TAO_IDL compiler so that it will
  62 generate the right lookup strategy for operation name
  63 demultiplexing.
  64
  65
  66 THE POA LATENCY TEST
  67 --------------------
  68
  69 Make the following changes in Object_Adapter.cpp :
  70
  71 #define ACE_ENABLE_TIMEPROBES
  72
  73 Comment out all ACE_FUNCTION_TIMEPROBE calls except the one
  74 in  locate_poa  ACE_FUNCTION_TIMEPROBE
  75 (TAO_OBJECT_ADAPTER_FIND_POA_START);
  76
  77
  78 In the demux_test_client : The object loop increments by one.
  79 In gen_names.cpp :
  80 > Codegen/demux -p 25
  81 > make
  82 > ./server -p 25
  83 > ./client -p 25
  84
  85 The results will reveal themselves !!
  86
  87
  88 THE SERVANT DEMUX TEST :
  89 ------------------------
  90
  91 In the demux_test_client : The object loop increments by 5.
  92
  93
  94
  95
  96
  97
  98