ACE Subsets

Proposal for Splitting ACE into Multiple Libraries

The following is a draft of our proposal for spliting ACE into multiple libraries, each of which will contain a smaller subset of the overall ACE functionality. The primary motivations for subsetting ACE are:

Principle of parsimony -- i.e., developers should incur time/space overhead for components they use, rather than for all the components in the ACE framework.
Simplify the learning curve -- i.e., developers only need to learn how to program components that they actually use.

The main design goals of this proposal are as follows:

Support the original libACE as before. Thus, for users who want to use the existing ACE library as is, there will be no changes, i.e., just link with libACE as usual.
Allow ACE (and TAO) programmers to use smaller subsets of the entire libACE library. These subsets will include the following libraries:

libACE_OS -- This library contains the OS adaptation layer and its supporting classes. All other ACE libraries will depend on libACE_OS and it will depend on no other ACE libraries.

libACE_Utils -- This library contains the various ACE container classes and other miscellaneous classes, such as Singleton, auto_ptr, timers, etc. This library will depend only on libACE_OS.

libACE_Logging -- This library contains the various ACE logging and tracing classes. This library will depend only on libACE_OS.

libACE_Threads -- This library contains the ACE thread/process management and synchronization classes. This library will depend only on libACE_OS.

libACE_Demux -- This library contains the ACE Reactor and Proactor classes. This library will depend on libACE_OS and libACE_Thread.

libACE_Connection -- This library contains the ACE Connection components, i.e., Acceptor, Connector, and Svc_Handler. This library will depend on libACE_OS, libACE_Thread, and libACE_Demux.

libACE_Sockets -- This library contains the ACE C++ wrappers for sockets. This library will depend on libACE_OS.

libACE_IPC -- This library contains all the ACE C++ wrappers for the other types of IPC and FILE I/O other than sockets. This library will depend on libACE_OS and libACE_Sockets.

libACE_Svcconf -- This library contains the ACE C++ wrappers for the Service Configurator. This library will depend on libACE_OS, libACE_Demux, libACE_Thread, and libACE_Sockets.

libACE_Streams -- This library contains the ACE Streams classes. This library will depend on libACE_OS, libACE_Demux, and libACE_Thread.

libACE_Memory -- This library contains the ACE C++ wrappers for shared memory and memory-mapped files. This library will depend on libACE_OS.

In addition, we will create libACE_TAO, which contains just the core set of components in ACE that are required to support TAO. This library is targeted at embedded systems developers who want to minimize the footprint of ACE+TAO.

Note that the ACE library subsets described above are intended as a guideline, not a complete specification. The actual partitioning of files in the final ACE library subsets may differ somewhat in order to improve footprint and simplify common use-cases.

Configuration Management

Configuration management for the ACE library subsets described above will be organized as follows:

A single source tree with a single "version" for the source tree.
Releases of libACE and its "subsets" will be atomic, i.e., all or nothing.

Classes in Each ACE Library Subset

Below, we describe the classes in each ACE library subset.

libACE_OS

This library contains the OS adaptation layer and its supporting classes. The classes in this library should not depend on any other ACE library subsets. All of the other libraries will depend on this library. The following classes are included in this library.


ACE.cpp
ACE.h
ACE.i
config.h
Basic_Types.cpp
Basic_Types.h
Basic_Types.i
OS.cpp
OS.h
OS.i
Version.h

libACE_Utils

This library contains the following ACE container classes and other miscellaneous classes.


ARGV.cpp
ARGV.h
ARGV.i
Array.cpp
Array.h
Array.i
Auto_Ptr.cpp
Auto_Ptr.h
Auto_Ptr.i
Containers.cpp
Containers.i
Containers.h
Date_Time.cpp
Date_Time.h
Date_Time.i
Dynamic.cpp
Dynamic.h
Dynamic.i
Filecache.cpp
Filecache.h
Free_List.cpp
Free_List.i
Free_List.h
Get_Opt.cpp
Get_Opt.h
Get_Opt.i
Hash_Map_Manager.cpp
Hash_Map_Manager.h
High_Res_Timer.cpp
High_Res_Timer.h
High_Res_Timer.i
Managed_Object.cpp
Managed_Object.h
Managed_Object.i
Map_Manager.cpp
Map_Manager.h
Map_Manager.i
Object_Manager.cpp
Object_Manager.i
Object_Manager.h
Profile_Timer.cpp
Profile_Timer.h
Profile_Timer.i
Registry.cpp
Registry.h
Singleton.cpp
Singleton.h
Singleton.i
SString.cpp
SString.h
SString.i
System_Time.cpp
System_Time.h
Time_Request_Reply.cpp
Time_Request_Reply.h
Time_Value.cpp
Time_Value.h
Time_Value.i
Timer_Hash.cpp
Timer_Hash.h
Timer_Hash_T.cpp
Timer_Hash_T.h
Timer_Heap.cpp
Timer_Heap.h
Timer_Heap.i
Timer_Heap_T.cpp
Timer_Heap_T.h
Timer_Heap_T.i
Timer_List.cpp
Timer_List.h
Timer_List.i
Timer_List_T.cpp
Timer_List_T.h
Timer_List_T.i
Timer_Queue.cpp
Timer_Queue.h
Timer_Queue.i
Timer_Queue_Adapters.cpp
Timer_Queue_Adapters.h
Timer_Queue_Adapters.i
Timer_Queue_T.cpp
Timer_Queue_T.h
Timer_Queue_T.i
Timer_Wheel.cpp
Timer_Wheel.h
Timer_Wheel.i
Timer_Wheel_T.cpp
Timer_Wheel_T.h
Timer_Wheel_T.i

libACE_Logging

This library contains the various ACE logging and tracing classes.


Dump.cpp
Dump.h
Dump_T.cpp
Dump_T.h
Log_Msg.cpp
Log_Msg.h
Log_Msg.i
Log_Priority.h
Log_Record.cpp
Log_Record.h
Log_Record.i
Trace.cpp
Trace.h
Trace.i

libACE_Threads

This library contains the ACE thread/process management and synchronization classes.


Activation_Queue.h
Activation_Queue.cpp
Atomic_Op.i
Future.h
Future.cpp
Method_Object.h
Method_Object.cpp
Process.cpp
Process.h
Process.i
Process_Manager.cpp
Process_Manager.h
Process_Manager.i
Sched_Params.cpp
Sched_Params.h
Sched_Params.i
Synch.cpp
Synch.h
Synch.i
Synch_Options.cpp
Synch_Options.h
Synch_Options.i
Synch_T.cpp
Synch_T.h
Synch_T.i
Thread.cpp
Thread.h
Thread.i
Thread_Manager.cpp
Thread_Manager.h
Thread_Manager.i
Token.cpp
Token.h
Token.i

libACE_Demux

This library contains the ACE Reactor and its associated classes, including the ACE Connection components.


Event_Handler.cpp
Event_Handler.h
Event_Handler.i
Event_Handler_T.cpp
Event_Handler_T.h
Event_Handler_T.i
Handle_Set.cpp
Handle_Set.h
Handle_Set.i
Priority_Reactor.cpp
Priority_Reactor.i
Priority_Reactor.h
Proactor.h
Proactor.i
Proactor.cpp
Reactor.cpp
Reactor.h
Reactor.i
Reactor_Impl.h
Select_Reactor.cpp
Select_Reactor.h
Select_Reactor.i
WFMO_Reactor.cpp
WFMO_Reactor.h
WFMO_Reactor.i
XtReactor.cpp
XtReactor.h

libACE_Connection

This library contains the ACE Connection components, i.e., Acceptor, Connector, and Svc_Handler.


Acceptor.cpp
Acceptor.h
Acceptor.i
Asynch_Acceptor.cpp
Asynch_Acceptor.h
Asynch_Acceptor.i
Asynch_IO.cpp
Asynch_IO.h
Asynch_IO.i
Connector.cpp
Connector.h
Connector.i
Dynamic_Service.cpp
Dynamic_Service.h
Dynamic_Service.i
Strategies.cpp
Strategies.h
Strategies.i
Strategies_T.cpp
Strategies_T.h
Strategies_T.i
Svc_Handler.cpp
Svc_Handler.h
Svc_Handler.i

libACE_Sockets

This library contains the ACE C++ wrappers for sockets.


IPC_SAP.cpp
IPC_SAP.h
IPC_SAP.i
LOCK_SOCK_Acceptor.cpp
LOCK_SOCK_Acceptor.h
LSOCK.cpp
LSOCK.h
LSOCK.i
LSOCK_Acceptor.cpp
LSOCK_Acceptor.h
LSOCK_Acceptor.i
LSOCK_CODgram.cpp
LSOCK_CODgram.h
LSOCK_CODgram.i
LSOCK_Connector.cpp
LSOCK_Connector.h
LSOCK_Connector.i
LSOCK_Dgram.cpp
LSOCK_Dgram.h
LSOCK_Dgram.i
LSOCK_Stream.cpp
LSOCK_Stream.h
LSOCK_Stream.i
SOCK.cpp
SOCK.h
SOCK.i
SOCK_Acceptor.cpp
SOCK_Acceptor.h
SOCK_Acceptor.i
SOCK_CODgram.cpp
SOCK_CODgram.h
SOCK_CODgram.i
SOCK_Connector.cpp
SOCK_Connector.h
SOCK_Connector.i
SOCK_Dgram.cpp
SOCK_Dgram.h
SOCK_Dgram.i
SOCK_Dgram_Bcast.cpp
SOCK_Dgram_Bcast.h
SOCK_Dgram_Bcast.i
SOCK_Dgram_Mcast.cpp
SOCK_Dgram_Mcast.h
SOCK_Dgram_Mcast.i
SOCK_IO.cpp
SOCK_IO.h
SOCK_IO.i
SOCK_Stream.cpp
SOCK_Stream.h
SOCK_Stream.i

libACE_IPC

This library contains all the ACE C++ wrappers for the other types of IPC and FILE I/O other than sockets. This library will depend on the libACE_Socket library.



Addr.cpp
Addr.h
Addr.i
DEV.cpp
DEV.h
DEV.i
DEV_Addr.cpp
DEV_Addr.h
DEV_Addr.i
DEV_Connector.cpp
DEV_Connector.h
DEV_Connector.i
DEV_IO.cpp
DEV_IO.h
DEV_IO.i
FIFO.cpp
FIFO.h
FIFO.i
FIFO_Recv.cpp
FIFO_Recv.h
FIFO_Recv.i
FIFO_Recv_Msg.cpp
FIFO_Recv_Msg.h
FIFO_Recv_Msg.i
FIFO_Send.cpp
FIFO_Send.h
FIFO_Send.i
FIFO_Send_Msg.cpp
FIFO_Send_Msg.h
FIFO_Send_Msg.i
FILE_Addr.cpp
FILE_Addr.h
FILE_Addr.i
FILE.cpp
FILE.h
FILE.i
FILE_Connector.cpp
FILE_Connector.h
FILE_Connector.i
FILE_IO.cpp
FILE_IO.h
FILE_IO.i
INET_Addr.cpp
INET_Addr.h
INET_Addr.i
IO_SAP.cpp
IO_SAP.h
IO_SAP.i
IOStream.cpp
IOStream.h
IOStream_T.cpp
IOStream_T.h
IOStream_T.i
Pipe.cpp
Pipe.h
Pipe.i
Signal.cpp
Signal.h
Signal.i

SPIPE_Addr.cpp
SPIPE_Addr.h
SPIPE_Addr.i
SPIPE.cpp
SPIPE.h
SPIPE.i
SPIPE_Acceptor.cpp
SPIPE_Acceptor.h
SPIPE_Acceptor.i
SPIPE_Connector.cpp
SPIPE_Connector.h
SPIPE_Connector.i
SPIPE_Stream.cpp
SPIPE_Stream.h
SPIPE_Stream.i
SV_Message.cpp
SV_Message.h
SV_Message.i
SV_Message_Queue.cpp
SV_Message_Queue.h
SV_Message_Queue.i
SV_Semaphore_Complex.cpp
SV_Semaphore_Complex.h
SV_Semaphore_Complex.i
SV_Semaphore_Simple.cpp
SV_Semaphore_Simple.h
SV_Semaphore_Simple.i
SV_Shared_Memory.cpp
SV_Shared_Memory.h
SV_Shared_Memory.i
TLI.cpp
TLI.h
TLI.i
TLI_Acceptor.cpp
TLI_Acceptor.h
TLI_Acceptor.i
TLI_Connector.cpp
TLI_Connector.h
TLI_Connector.i
TLI_Stream.cpp
TLI_Stream.h
TLI_Stream.i
TTY_IO.cpp
TTY_IO.h
Typed_SV_Message.cpp
Typed_SV_Message.h
Typed_SV_Message.i
Typed_SV_Message_Queue.cpp
Typed_SV_Message_Queue.h
Typed_SV_Message_Queue.i
UNIX_Addr.cpp
UNIX_Addr.h
UNIX_Addr.i
UPIPE_Addr.h
UPIPE_Acceptor.cpp
UPIPE_Acceptor.h
UPIPE_Acceptor.i
UPIPE_Connector.cpp
UPIPE_Connector.h
UPIPE_Connector.i
UPIPE_Stream.cpp
UPIPE_Stream.h
UPIPE_Stream.i

libACE_Svcconf

This library contains the ACE C++ wrappers for the Service Configurator component.


Parse_Node.cpp
Parse_Node.h
Parse_Node.i
Service_Config.cpp
Service_Config.h
Service_Config.i
Service_Main.cpp
Service_Manager.cpp
Service_Manager.h
Service_Manager.i
Service_Object.cpp
Service_Object.h
Service_Object.i
Service_Record.cpp
Service_Record.h
Service_Record.i
Service_Repository.cpp
Service_Repository.h
Service_Repository.i
Service_Types.cpp
Service_Types.i
Service_Types.h
Shared_Object.cpp
Shared_Object.h
Shared_Object.i
Svc_Conf.h
Svc_Conf_l.cpp
Svc_Conf_y.cpp
Svc_Conf_Tokens.h

libACE_Streams

This library contains the ACE Streams classes.


IO_Cntl_Msg.cpp
IO_Cntl_Msg.h
IO_Cntl_Msg.i
Message_Block.cpp
Message_Block.h
Message_Block.i
Message_Queue.cpp
Message_Queue.h
Message_Queue.i
Message_Queue_T.cpp
Message_Queue_T.h
Message_Queue_T.i
Module.cpp
Module.h
Module.i
Multiplexor.cpp
Multiplexor.h
Multiplexor.i
Stream.cpp
Stream.h
Stream.i
Stream_Modules.cpp
Stream_Modules.h
Stream_Modules.i
Task.cpp
Task.h
Task.i
Task_T.cpp
Task_T.h
Task_T.i

libACE_Memory

This library contains the ACE C++ wrappers for shared memory and memory-mapped files.


Malloc.cpp
Malloc.h
Malloc.i
Malloc_T.cpp
Malloc_T.h
Malloc_T.i
Mem_Map.cpp
Mem_Map.h
Mem_Map.i
Memory_Pool.cpp
Memory_Pool.h
Memory_Pool.i
Obstack.cpp
Obstack.h
Read_Buffer.cpp
Read_Buffer.h
Read_Buffer.i
Shared_Memory.h
Shared_Memory_MM.cpp
Shared_Memory_MM.h
Shared_Memory_MM.i
Shared_Memory_SV.cpp
Shared_Memory_SV.h
Shared_Memory_SV.i

Back to the ACE home page.