The file and directory organization for TAO services can be confusing at first glance (and even on subsequent ones to be honest), so we felt like some rationale and explanation of the directory hierarchy was needed.
For general sanity all TAO services files are located under
$TAO_ROOT/orbsvcs.
It is expected that clients use more
than one service at the same time
(in fact some of the services already do, for instance the
Event Service uses the Naming Service and the
Scheduling Service).
Every service is put together as a library. These libraries are
located in $TAO_ROOT/orbsvcs/orbsvcs.
Usually the include path is $TAO_ROOT,
so files are included like this:
#include "orbsvcs/CosNamingC.h"
To simplify the IDL generation the skeletons are also on the library, this is not a problem for client programs and most services need to link the library anyway (since they use other services.) Further, the current support for collocation requires that clients link the skeleton files anyway.
In the future we intend to use ACE Service Configurator to give
the users control over collocation of the services implementation.
As a first cut all the service implementations are included in the
orbsvcs library $TAO_ROOT/orbsvcs/orbsvcs.
Since there are serveral services and each one is implemented
using several files we have given a different directory to each
service.
This structure could also simplify a future split into several
libraries (if it proves necessary).
The complete list of directories is:
| Service | Implementation Sub-directory | Maitainer/Point-of-Contact |
|---|---|---|
| A/V Streams Service | orbsvcs/orbsvcs/AV |
Yamuna Krishnamurthy |
| Concurrency Service | orbsvcs/orbsvcs/Concurrency |
None |
| Event Service | orbsvcs/orbsvcs/CosEvent |
Pradeep Gore |
| Real-time Event Service | orbsvcs/orbsvcs/Event |
Johnny Willemsen |
| LifeCycle Service | orbsvcs/orbsvcs/LifeCycle |
None |
| Load Balancing Service | orbsvcs/orbsvcs/LoadBalancing |
Ossama Othman |
| Logging Service | orbsvcs/orbsvcs/Log |
D A Hanvey |
| Naming Service | orbsvcs/orbsvcs/Naming |
DOC group |
| Property Service | orbsvcs/orbsvcs/Property |
None |
| Scheduling Service | orbsvcs/orbsvcs/Sched |
Venkita Subromianian |
| Security Service | orbsvcs/orbsvcs/Security |
Ossama Othman |
| SSLIOP Pluggable Protocol | orbsvcs/orbsvcs/SSLIOP |
Ossama Othman |
| Trading Service | orbsvcs/orbsvcs/Trader |
None |
| Time Service | orbsvcs/orbsvcs/Time |
None |
| Notification Service | orbsvcs/orbsvcs/Notify |
Pradeep Gore |
| FtRt Event Service | orbsvcs/orbsvcs/FtRtEvent |
Huang-huang Min |
| FaultTolerance | orbsvcs/orbsvcs/FaultTolerance |
Bala Natarajan |
| IFRService | orbsvcs/orbsvcs/IFRservice |
Jeff parsons |
| PortableGroup | orbsvcs/orbsvcs/PortableGroup |
Frank Hunleth |
| RTCoSScheduling | orbsvcs/orbsvcs/RTCOSScheduling |
Kevin Bryan |
Note that in the current version of TAO we still have standalone
binaries for some of the services. However, some applications
may want to control what process implements a particular service.
Therefore, it has proved useful for
debugging purposes to keep the most used services
separated. Users are highly encouraged to write their own
executables if they want any changes in CORBA policies or would
like to set their own bits when running a service. The
executables that are packed with the TAO distribution should be
viewed as an executable with a basic subset of features.
The binaries in question are located in
$TAO_ROOT/orbsvcs, and the list includes:
In the future we plan to use a single binary and ACE Service Configurator and keep a single binary.
The Implementation Repository is a unique service in that it
starts server executables, and it doesn't make sense to collocate
it in another server. Because of this, only the IDL files are
located in $TAO_ROOT/orbsvcs/orbsvcs. The other
files are all located in
$TAO_ROOT/orbsvcs/ImplRepo_Service.
Finally the tests and example programs are located in
$TAO_ROOT/orbsvcs/tests;
once more each may involve more than a single binary,
so each one is kept in its own directory;
the following list describes the contents of each one:
You may want to check TAO release notes for up to date information on status, changes, future work, etc.