| blob | e9c10edd761dff3fba64920a8dcf2d06f3ccd7be |
3 <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"><title>Building and Installing ACE and Its Auxiliary Libraries and Services</title>
7 <style>
8 body {
9 background-color: #ffffff;
10 color: #000000;
11 }
12 table, th, td {
13 border: 1px solid black;
14 }
15 .indent {
16 margin-left: 2em;
17 }
18 .boxed {
19 border: 1px solid black;
20 border-radius: 0.3em;
21 padding-right: 0.5em;
22 padding-left: 0.5em;
23 margin: 0.5em;
24 }
25 pre, code {
26 background-color: #e3e3e3;
27 border-radius: 0.2em;
28 padding-right: 0.2em;
29 padding-left: 0.2em;
30 }
31 </style>
32 </head>
34 <body>
36 <hr>
41 The file explains how to build and install ACE, its Network Services,
42 test suite and examples on the various OS platforms and compilers that
45 to the release will affect your code. In addition, you should check
46 out our <a
48 process</a>. As you start working with ACE, we suggest you get copies
49 of the <a
53 guide you after you've built and installed ACE. You should also
54 consult the <a
56 Frequently Made Mistakes page</a>. If you encounter any problems or
57 would like to request an enhancement, then use <a
65 <ul>
80 </li></ul>
83 <p></p><hr><p>
86 <p>ACE has been ported to a large number of platforms using many different
87 compilers over the years.
92 user community have all contributed ports to make ACE the successful
93 and far-reaching toolkit it is today. Any UNIX/POSIX/Windows
94 variation is probably an easy target platform for ACE. If you have
96 compiling the ACE source distribution, please contact one of the
97 commercial support companies, or send a copy of the
100 mailing list</a> or create a <a href="https://github.com/DOCGroup/ACE_TAO/issues">github issue</a>.
101 The DOC groups at Washington University, UC Irvine, and Vanderbilt
102 University provide only "best effort" support for non-sponsors for the
104 docs/ACE-bug-process.html</a>.
105 Thus, if you need more "predictable" help, or help with earlier versions of
106 ACE, it's recommend that you check out the
108 commercial support companies</a> for additional assistance.
109 </p>
110 <p>The responsibility for maintaining ACE across the wide range of
111 supported platforms is divided among a few different groups:
112 <ul>
113 <li>The DOC group maintains platforms used in the course of their research
114 and sponsored work</li>
115 <li>Companies that provide support (Riverace, OCI, and Remedy IT), maintain
116 platforms they support in the course of their various service offerings</li>
118 </ul>
120 build scoreboard</a>
121 records the current status of build and regression testing during
122 development by all of the above groups. It is available to all users wishing
123 to provide build results. Members of the ACE community that maintain ACE on
124 platforms not maintained by the DOC group, Riverace, OCI, or Remedy IT are
125 encouraged to provide build and regression test results for the scoreboard
126 to ensure that all in-use platforms are represented.
127 See the <a href="https://raw.githubusercontent.com/DOCGroup/autobuild/master/README" target="_blank">autobuild README</a> for more information about
128 how to set up a build; contact one of the above groups to inquire about how
129 to get your build results recorded on the scoreboard.</p>
130 <p>Because older
131 platforms that are not maintained tend to fall into a broken state and
132 clutter the ACE sources with code that is no longer used, the development
133 team reserves the right to remove ACE configuration files and source code
134 specific to inactive platform configurations that are not
135 listed on the scoreboard.</p>
136 <p>The table below summarizes each group's role and where you can get more
137 detailed information. For information on TAO's platform coverage and
143 <thead>
148 </tr>
149 </thead><tbody>
150 <tr>
152 <td>
153 </td>
157 </td>
158 </tr>
159 <tr>
161 <td>Offers ACE
165 for many platforms including AIX, HP-UX, Linux, Solaris, and Windows.
166 </td>
169 </tr>
170 <tr>
172 <td>Maintains ACE on certain platforms required for their TAO
173 software and service offerings.
174 </td>
175 <td>
179 </tr>
180 <tr>
182 <td>Maintains ACE on many platforms required for their ACE and
183 TAO service offerings. We support AIX,
184 Embarcadero C++ Builder,
185 Windows CE, MinGW, Microsoft Visual C++, GCC,
186 Cygwin, VxWorks 6.x (kernel and rtp), OpenVMS on IA64,
187 BlueCAT Linux, RedHat Linux, Fedora, MacOSX, Solaris,
188 Tru64, SuSE Linux on Alpha/IA32/EM64T/IA64, RTEMS, QNX, LynxOS,
189 HPUX on IA64, and Android.
190 The Intel C++ compiler is supported on
192 </td>
195 </td>
196 </tr>
197 <tr>
199 <td>Maintains ACE on certain platforms required for their TAO
200 software and service offerings, including LynxOS.
201 </td>
203 </tr>
204 <tr>
206 <td>Responsible for continued maintenance and testing of platforms
207 to which ACE has been ported, but aren't supported by the
208 above groups. These include
211 Linux on PPC; OpenMVS;
212 Tandem; SCO; FreeBSD; NetBSD; OpenBSD;
214 QNX RTP and Neutrino 2.0; Interix (Windows Services for Unix)
215 </td>
216 </tr><tr>
218 <td>The following platforms have been ported to in the past but are
219 no longer maintained and may be removed from ACE at any time.
220 If you want to have support for these environments contact one
221 of the commercial support organisations. The platforms include:
225 For up-to-date listings on platform that are deprecated and pending
227 </td>
228 </tr>
229 </tbody></table></p><p>
231 </p><p>Although the DOC group has provided outstanding support for ACE
232 over the years, ACE's success has greatly increased the amount of
233 effort required to keep up with its maintenance, answer users'
234 questions, and give design guidance. Riverace offers world-class
235 commercial services to support ACE users. OCI, PrismTech, and Remedy
236 offer similar services for ACE and TAO, allowing the DOC group's primary focus
238 fundamentally focused on (and <a
241 intimately involved in ACE+TAO development and maintenance, but with
242 revised priorities for maintenance. The <a
244 fixing policies</a> followed by the DOC group are designed to strike a
245 balance between their many <a
249 community</a>. Naturally, we will be happy to accept well-tested
250 patches from the ACE+TAO user community for any platforms that aren't
251 supported by the DOC group, Riverace, OCI or Remedy IT. </p><p>
253 </p><p></p><hr><p>
257 HREF="http://htmlpreview.github.io/?https://github.com/DOCGroup/MPC/blob/master/docs/html/MakeProjectCreator.html">MPC</A>
258 (MakeProjectCreator) to generate files used by all supported build
259 tools (such as GNUmakefiles for UNIX based platforms, sln and vcproj
260 files for Visual Studio and Embarcadero makefiles) on various platforms. To
261 help new users to bootstrap quickly the release bundles of ACE (as
262 well as TAO) include all needed files to use the build
263 instructions in this document.
265 </p>
266 <p>
267 If it is necessary to generate
268 files for build tools for other compilers, one must
269 run MPC to generate the
273 details. The options that have been used to generate the above build
274 files can be found in <a
276 global.features</a> file.
277 </p>
279 <hr>
282 The following sections explain how to build ACE on:
283 <ul>
290 </ul>
293 <ul>
294 <li><p>Many features in ACE can be modified by defining some macros in
297 your platform specific config file.</p>
298 </li><li><p>However, if you want to undefine/redefine macros defined in the
301 </li><li> If you're planning to build ACE on multiple platforms, you may
303 before you start. <p>
304 </p></li></ul>
309 As of ACE 6.0.6, you can building ACE on
310 UNIX with:
311 <ol>
313 </ol>
315 the UNIX methods.
318 <p>
319 Here's what you need to do to build ACE using GNU Make and ACE's traditional
320 per-platform configuration method:</p>
322 <ol>
328 per-platform configuration method or ACE won't compile.
329 </li>
330 <li>Add an environment variable called ACE_ROOT that contains the
331 name of the root of the directory where you keep the ACE wrapper
332 source tree. The ACE recursive Makefile scheme needs this information.
333 There are several ways to set the ACE_ROOT variable. For example:
334 <blockquote>
335 TSCH/CSH:
337 </blockquote>
338 <blockquote>
339 BASH or Bourne Shell:
340 <code>export ACE_ROOT=/home/cs/faculty/schmidt/ACE_wrappers
341 </code>
342 </blockquote>
343 <p>
344 If you're building a number of versions of ACE, however, (e.g., for
345 different OS platforms or for different releases of ACE) you might use
346 the following approach (assuming TCSH/CSH):
347 <blockquote>
349 </blockquote>
350 </li>
352 that includes the appropriate platform/compiler-specific
353 header configurations from the ACE source directory. For example:
354 <blockquote><code>
355 #include "ace/config-linux.h"
356 </code></blockquote>
357 The platform/compiler-specific configuration file
358 contains the #defines that are used throughout ACE to indicate
359 which features your system supports. See the
361 macro settings. If you desire to add some site-specific or build-specific
362 changes, you can add them to your config.h file; place them
364 header file.
365 <p>
366 There are config files for most versions of UNIX. If there
367 isn't a version of this file that matches your
368 platform/compiler, you'll need to make one. Please send email
370 if you get it working so it can be added to the master ACE
371 release.</p>
372 </li>
374 <li>Create a build configuration file,
376 that contains the appropriate platform/compiler-specific
377 Makefile configurations, e.g.,
378 <blockquote><code>
379 include $(ACE_ROOT)/include/makeinclude/platform_linux.GNU
380 </code></blockquote>
381 This file contains the compiler and Makefile directives that are
382 platform/compiler-specific. If you'd like to add make options, you
383 can add them before including the platform-specific configuration.<p>
384 NOTE! There really is not a # character before 'include' in the
385 platform_macros.GNU file. # is a comment character.
386 </li>
388 installation prefix in platform_macros.GNU.
389 <blockquote><code>
390 INSTALL_PREFIX = /usr/local
391 </code></blockquote>
392 Headers will be installed to $INSTALL_PREFIX/include, executables to
393 $INSTALL_PREFIX/bin, documentation and build system files to
394 $INSTALL_PREFIX/share and libraries to $INSTALL_PREFIX/lib. The library
395 directory can be customized by setting INSTALL_LIB (for example,
396 INSTALL_LIB=lib64). With INSTALL_PREFIX set, RPATH will be enabled for
397 all executables and shared libraries. To disable RPATH (for example,
398 if $INSTALL_PREFIX/$INSTALL_LIB is already a system-known location for
399 shared libraries such as those listed in /etc/ld.so.conf), set the make
401 </li>
402 <li>Note that because ACE builds shared libraries, you'll need to set
403 LD_LIBRARY_PATH (or equivalent for your platform) to the directory
404 where binary version of the ACE library is built into. For example,
405 you probably want to do something like the following:
406 <blockquote>
408 </blockquote>
409 or
410 <blockquote>
412 </blockquote>
413 </li>
414 <li>When all this is done, hopefully all you'll need to do is type:
415 <blockquote>
417 at the ACE_ROOT directory. This will build the ACE
418 library, tests, the examples, and the sample applications.
419 Building the entire ACE release can take a long time and consume
420 lots of disk space, however. Therefore, you might consider
423 As a sanity check, you might also want to build and run the
428 perfect hash function generator application in
430 </li>
431 <li>If you've set the INSTALL_PREFIX before building, now run
433 </li>
435 you'll need to
437 However, you should rarely, if ever, need to do this.
438 </li>
439 </ol>
445 <p>This section contains instructions for building ACE on Microsoft
446 Windows with a variety of compilers and development environments.</p>
448 <p>First, if you are upgrading from an older release, the recommended practice
449 is to start with a clean directory. Unpacking the newer release over an older
450 one will not clean up any old files, and trying to use the environment's
453 <p>For using MPC and our perl based test framework we recommend
457 <ul>
462 </ul>
466 Microsoft Visual Studio</a></h3>
468 <p>ACE contains project files for
472 environments, ACE supplies files with different names for the different
473 development and target platforms. The platform/name mapping is shown below.
479 <thead>
483 </tr>
484 </thead><tbody>
485 <tr>
488 </td>
489 </tr>
490 <tr>
493 </td>
494 </tr>
495 <tr>
498 </td>
499 </tr>
500 </tbody></table>
502 <p>The VC++ compiler and linker can now be invoked from GNU make just like
504 ACE/GNU Configuration</a> sections and see the additional information in the
505 comments of
507 </p>
509 <p>If you happen to open an older file Visual Studio solution from a newer one, it will offer to convert
510 the file to the newer format for you
512 <ol>
513 <li>Uncompress the ACE distribution into a directory, where it will
514 create a ACE_wrappers directory containing the distribution. The
515 ACE_wrappers directory will be referred to as ACE_ROOT in the
516 following steps -- so ACE_ROOT\ace would be C:\ACE_wrappers\ace if
517 you uncompressed into the root directory.<br>
518 <br>
520 directory that contains: <br>
521 <br>
523 <br>
525 </li><li>The static, DLL and MFC library builds are kept in
526 different workspaces. Files with names *_Static contain project
527 files for static builds. Workspaces for static and DLL builds will be
528 available through the stock release at DOC group's website. The
529 workspaces for MFC are not available and have to be generated using
531 details.<br><br>
533 <br>
534 </li><li>Make sure you are building the configuration (i.e, Debug/Release)
535 the one you'll use (for example, the debug tests need the debug
536 version of ACE, and so on). All these different configurations are
537 provided for your convenience. You can either adopt the scheme to
538 build your applications with different configurations, or use
541 make sure you include ACE_ROOT\lib in your PATH whenever you run
542 programs that uses ACE. Otherwise you may experience problems
543 finding ace.dll or aced.dll.<br>
544 <br>
545 </li><li>To use ACE with MFC libraries, also add the following to
547 spawn a new thread with CWinThread, make sure you spawn the
548 thread with THR_USE_AFX flag set.<br>
549 <br>
551 <br>
552 By default, all of the ACE projects use the DLL versions of the
553 MSVC run-time libraries. You can still choose use the static (LIB)
554 versions of ACE libraries regardless of run-time libraries. The
555 reason we chose to link only the dynamic run-time library is that
556 almost every NT box has these library installed and to save disk
557 space. If you prefer to link MFC as a static library into ACE, you
560 everything (including the MSVC run-time libraries) statically,
561 you'll need to modify the project files in ACE yourself.<p>
562 </p></li><li>Static version of ACE libraries are built with
564 also be used in application projects that link to static ACE
565 libraries<br>
566 <br>
567 Optionally you can also add the line <br>
568 <br>
570 <br>
571 before the #include statement in ACE_ROOT\ace\config.h to disable
572 inline function and reduce the size of static libraries (and your
573 executables.)<br>
574 <br>
576 <br>
577 We use the following rules to name the DLL and LIB files in ACE
578 when using MSVC.<br>
579 <br>
583 <br>
584 </li></ol>
586 <p>More information for ACE/TAO on MSVC can be found
588 document is available under Related Topics in the ACE Library.</p>
592 The tests are located in ACE_ROOT\tests. There is also a solution in
593 that directory to build all the tests (tests.sln)</p><p>
595 Once you build all the tests (Batch Build works well for this), you
603 install TCP/IP and configure it to ignore the absence of a network
604 card. This is one method:
606 </a></p><ol>
608 </li><li>Choose Network from Control Panel
609 </li><li>Add Adapter: MS Loopback Adapter
611 </li><li>Add Protocol: TCP/IP Protocol
612 </li><li>Configure TCP/IP Protocol with a valid IP address and subnet mask.
613 Leave everything else at the default settings.
614 </li><li>Add Service: Workstation
615 </li><li>Exit and Restart System
616 </li><li>Run Control Panel again
617 </li><li>Choose Services from Control Panel
618 </li><li>The following services are not necessary and may
619 be set to Disabled Startup: <br>
620 Alerter<br>
621 Computer Browser<br>
622 Net logon<br>
623 Messanger<br>
624 </li><li>Choose Network from Control Panel
626 Installed Software:<br>
627 Computer Browser<br>
628 MS Loopback Adapter Driver<br>
629 TCP/IP Protocol<br>
630 Workstation<br>
631 Installed Adapter Cards:<br>
632 MS Loopback Adapter<p>
633 </p></li></a></ol>
638 If you are building for a machine without a network card, you may want
641 </p><ol>
642 <li>Uncompress the ACE distribution into a directory, where it will
643 create an
644 ACE_wrappers directory containing the source. The ACE_wrappers
645 directory will be referred to as ACE_ROOT in the following steps -- so
646 <code>ACE_ROOT\ace</code> would be <code>C:\ACE_wrappers\ace</code> when you uncompressed into the
647 root directory.<br>
648 <br>
650 directory that contains at least: <br>
651 <br>
653 <br>
655 <br>
656 </li><li>Set the ACE_ROOT environment variable to point to the ACE_wrappers
657 directory. For example:<br>
658 <br>
660 <br>
662 <br>
664 <br>
666 <br>
668 <br>
669 </li><li>Generate the bmake makefiles using <a href="#MPC">MPC</a>. Use the <code>bmake</code> project type for C++ Builder:<br>
670 <br>
672 <br>
673 </li><li>You can build several different versions of ACE by setting the following optional environment
674 variables before you run make:<br>
675 <br>
676 Set the environment variable below to build a debug version of ACE<br>
678 <br>
679 Set the environment variable below to build a unicode version of ACE<br>
681 <br>
682 Set the environment variable below to build a version of ACE with
683 Codeguard support. Should only be used when DEBUG is also set<br>
685 <br>
686 By default we are using the clang based compilers. At the moment you
687 want to compile using the old bcc32 compiler set the CLASIC environment variable<br>
689 <br>
690 Set the environment variable below to build a version of ACE optimized
691 for a certain CPU. For this there are special compiler flags
694 <br>
695 You can then start the build with the command
697 <br>
698 You may also enable the options by passing them as command line options to make, for example:<br>
700 <br>
702 <br>
704 <br>
705 </li></ol>
707 <p>
709 Note that when you run <code>make</code> in a sub directory you give <code>make -f Makefile.bmak all</code>. The <code>all</code> is needed to make sure the complete project is build.<p>
711 The C++ Builder port has been done by Jody Hagins, <a href="mailto:chris@kohlhoff.com">Christopher Kohlhoff</a> and <a href="mailto:jwillemsen@remedy.nl">Johnny Willemsen</a>. </p><p>
715 Before you can build the tests you need to build the protocols directory.
716 Change the directory to ACE_ROOT\protocols and start: </p><p>
717 </p><blockquote><code>
718 %ACE_ROOT%\bin\mwc.pl -type bmake<br>
719 make -f Makefile.bmak all
720 </code></blockquote><p>
722 The tests are located in ACE_ROOT\tests, change to this directory.
723 You build then the tests with the following commands:</p><p>
724 </p><blockquote><code>
725 %ACE_ROOT%\bin\mwc.pl -type bmake<br>
726 make -f Makefile.bmak all
727 </code></blockquote><p>
729 Once you build all the tests, you can run the automated test script using:</p><p>
732 sure the ACE bin and lib directory (in this case
734 are on the path before you try to run the tests. If your executables are
736 command.</p><p>
741 <p>
742 If you are building for a machine without a network card, you may want
745 </p><p>
749 Also, as MinGW uses GNU g++, you may want to take
752 </p><p>
753 You will need the MinGW build tools and libraries, downloable from
756 <br>
757 For our build we require the packages
760 </p><ol>
762 <li> Install the MinGW tools (including the MinGW Development toolkit) into a common directory, say c:/mingw.
763 <br><br>
765 </li><li> Install the MSYS tools into a common directory, say c:/msys.
766 <br><br>
771 <blockquote><pre> % export PATH=/c/mingw/bin:$PATH
772 </pre></blockquote>
775 root of your ACE wrappers source tree:
777 <blockquote><pre> % export ACE_ROOT=/c/work/mingw/ACE_wrappers
778 </pre></blockquote>
780 From now on, we will refer to the root directory of the ACE
782 <br><br>
788 </pre></blockquote>
793 <blockquote><pre> include $(ACE_ROOT)/include/makeinclude/platform_mingw32.GNU
794 </pre></blockquote>
797 actual directory, GNU make will take the value from the
798 environment variable you defined previously.
800 <p>
801 If you lack Winsock 2, add the line
804 </pre></blockquote>
806 before the previous one.
807 <br><br>
809 <p>
810 If you want to install ACE (using "make install") and want all the <tt>.pc</tt> files generated,
811 set the installation prefix in platform_macros.GNU.
812 </p><blockquote><pre> INSTALL_PREFIX=/c/ACE
813 </pre></blockquote>
814 Headers will be installed to $INSTALL_PREFIX/include, documentation and
815 build system files to $INSTALL_PREFIX/share and libraries to $INSTALL_PREFIX/lib. With INSTALL_PREFIX set, RPATH will be enabled.
816 To disable RPATH (for example, if $INSTALL_PREFIX/$INSTALL_LIB is already
817 a system-known location for shared libraries), set the make macro
820 <br><br>
822 </li><li> In the MSYS shell, change to the $ACE_ROOT/ace directory and
823 run make:
825 <blockquote><pre> % cd $ACE_ROOT/ace
826 % make
827 </pre></blockquote>
829 <p>
832 Note that the name for the ACE DLL follows the MinGW convention, which itself
833 resembles UNIX.
835 </p><p>
836 If you want static libs also, you may run:
839 </pre></blockquote>
841 </li><li> Run make install:
843 <blockquote><pre> % make install
844 </pre></blockquote>
845 <p>
847 </p>
850 The same rules for Win32 search of DLLs apply for MinGW. If you
851 want to run some ACE programs from the MSYS shell, you may
855 </a></pre></blockquote>
857 </li></ol>
862 After building the library, you can change to that directory and run
863 make:
866 % make
867 </a></pre></blockquote>
869 <p>
875 </a></pre></blockquote>
877 <p>
881 </p><p>
883 of the various tests on MinGW and the different Windows flavors.
888 <p>
889 If you are building for a machine without a network card, you may want
892 </p><p>
895 Also, as Cygwin uses GNU g++, you may want to take
898 </p><p>
899 You will need the Cygwin build tools and libraries, downloable from
901 For our build we require the following packages besides the packages the
902 setup selects by default:
904 </a></p><blockquote>
906 </a></blockquote>
908 <ol>
912 from the Cygwin site). For working with ACE we recommend
914 <br><br>
919 <blockquote><pre> % export PATH=//c/cygwin/bin:$PATH
920 </pre></blockquote>
922 or
924 <blockquote><pre> % export PATH=/cygdrive/c/cygwin/bin:$PATH
925 </pre></blockquote>
927 <p>
931 because, for Cygwin,
933 <br><br>
936 root of your ACE wrappers source tree (in this example c:/work/cygwin/ACE_wrappers):
938 <blockquote><pre> % export ACE_ROOT=/cygdrive/c/work/cygwin/ACE_wrappers
939 </pre></blockquote>
941 <p>
943 notation as this is seen by Cygwin's compiler and it doesn't
945 separator however).
947 </p><p>
948 From now on, we will refer to the root directory of the ACE
950 <br><br>
956 </pre></blockquote>
961 <blockquote><pre> include $(ACE_ROOT)/include/makeinclude/platform_cygwin32.GNU
962 </pre></blockquote>
965 actual directory, GNU make will take the value from the
966 environment variable you defined previously.
968 </li><li> On the Cygwin shell, change to the $ACE_ROOT/ace directory and
969 run make:
971 <blockquote><pre> % cd $ACE_ROOT/ace
972 % make
973 </pre></blockquote>
975 <p>
978 Note the name for the ACE DLL on Cygwin follows the UNIX convention.
979 <br><br>
981 </p><p>
982 If you want static libs also, you may run:
985 </pre></blockquote>
988 The same rules for Win32 search of DLLs apply for Cygwin. If you
989 want to run some ACE programs from the Cygwin shell, you may
992 </a><blockquote><pre><a name="cygwinrunpath"> # export PATH=//c/work/cygwin/ACE_wrappers/ace:$PATH
993 </a></pre></blockquote>
996 placed in the lib directory instead of ace and thus your PATH
997 addition would need to look like this:
999 </a><blockquote><pre><a name="cygwinrunpath"> # export PATH=//c/work/mingw/ACE_wrappers/lib:$PATH
1000 </a></pre></blockquote>
1003 </li></ol>
1008 After building the library, you can change to that directory and run
1009 make:
1012 % make
1013 </a></pre></blockquote>
1015 <p>
1021 </a></pre></blockquote>
1023 <p>
1027 </p><p>
1029 of the various tests on Cygwin and the different Windows flavors.
1030 </p>
1032 <p></P>
1035 <p>
1037 <P>Interix comes with a BSD style make; you need GNU make.
1038 Make builds easily under Interix or there is a prebuilt
1039 package at: </P>
1040 <P><A
1041 href="http://www.interopsystems.com/tools/warehouse.htm">http://www.interopsystems.com/tools/warehouse.htm</A> </P>
1042 <P>If you are building for a machine without a network
1043 card, you may want to check <A href="#win32nonic" ><FONT color=#0000ff>here</FONT></A> first. </P>
1049 <P><TT>#include
1053 <P><TT>include
1054 $(ACE_ROOT)/include/makeinclude/platform_win32_interix.GNU</TT></P>
1058 other options may not work.</P>
1061 change to that directory and run make: </P>
1063 <p>Once you build all the tests, you can run <code>run_test.pl</CODE> in the <code>tests</CODE> directory to try all the tests: </P>
1065 <p>If you are using ACE as a shared library, you will need
1066 to modify your LD_LIBRARY_PATH as explained in<A href="#unix_traditional" ><FONT color=#800080>Traditional ACE/GNU Make Configuration</FONT></A>. </P>
1067 <p></P>
1071 For the most part, you should be able to follow the instructions above
1072 to build ACE and applications that use it. Start with the
1074 applications that use it. Please see below for more information on
1077 A few notes on VxWorks builds (thanks to
1080 <p>
1081 </p><ul>
1082 <li>VxWorks builds are done with a cross compiler, i.e., the compiles
1083 are done on a workstation creating object modules which are
1084 downloaded and loaded into the VxWorks target system.<p>
1085 </p></li><li>C++ object modules must be post-processed by a VxWorks
1086 utility called "munch" to set up calls to static constructors and destructors.
1087 ACE integrates the makefile includes/rules files
1088 distributed with VxWorks to achieve maximum compatibility and reuse the target
1089 specifications and buildcommands defined by Windriver itself.
1090 The original ACE support for VxWorks included a perl script called
1092 which was called from the Makefiles, replacing
1094 available it is not used anymore.<BR>
1097 perl.exe), either in your
1099 or in your environment.<p>
1100 </p></li><li>Wind River provides GCC/G++ cross-compilers for the
1103 targets.<p>
1104 </p></li></ul>
1106 You'll have to let ACE know the target type at compile time. There
1107 are several ways to do this; please see the
1109 platform file for detailed information.<p>
1111 The VxWorks platform_vxworks*.GNU files are set up so that shared
1112 libraries are not built on VxWorks, by default. Only static
1113 libraries, with .a extension, are built. Therefore, it's not
1114 necessary to set the LD_LIBRARY_PATH environment variable on your host
1115 system when building for VxWorks targets. Please note, however, if
1116 you use TAO on VxWorks that you will need to set your LD_LIBRARY_PATH
1117 to find the TAO IDL compiler libraries (installed in the ace
1118 directory) on the host.</p><p>
1121 are required with ACE:</p><p>
1123 </p><pre>#define INCLUDE_CPLUS /* include C++ support */
1124 #define INCLUDE_CPLUS_IOSTREAMS /* include iostreams classes */
1125 #define INCLUDE_POSIX_ALL /* include all available POSIX functions */
1126 </pre>
1131 <pre>#define INCLUDE_CPLUS /* include C++ support */
1132 #define INCLUDE_CPLUS_IOSTREAMS /* include iostreams classes */
1133 #define INCLUDE_CONFIGURATION_5_2 /* pre-tornado tools */
1134 #define INCLUDE_DEBUG /* pre-tornado debugging */
1135 #define INCLUDE_LOADER /* object module loading */
1136 #define INCLUDE_NET_SYM_TBL /* load symbol table from network */
1137 #define INCLUDE_SYM_TBL_SYNC /* synchronize host and target symbol tables */
1138 #define INCLUDE_NFS /* nfs package */
1139 #define INCLUDE_PING /* ping() utility */
1140 #define INCLUDE_POSIX_ALL /* include all available POSIX functions */
1141 #define INCLUDE_RDB /* remote debugging package */
1142 #define INCLUDE_RLOGIN /* remote login */
1143 #define INCLUDE_RPC /* rpc package */
1144 #define INCLUDE_SECURITY /* shell security for network access */
1145 #define INCLUDE_SHELL /* interactive c-expression interpreter */
1146 #define INCLUDE_SHOW_ROUTINES /* show routines for system facilities*/
1147 #define INCLUDE_SPY /* spyLib for task monitoring */
1148 #define INCLUDE_STARTUP_SCRIPT /* execute start-up script */
1149 #define INCLUDE_STAT_SYM_TBL /* create user-readable error status */
1150 #define INCLUDE_SYM_TBL /* symbol table package */
1151 #define INCLUDE_UNLOADER /* object module unloading */
1152 #define INCLUDE_WINDVIEW /* WindView command server */
1153 </pre>
1155 Also, automatic construction/destruction of static objects
1156 should be enabled.<p>
1158 If you use TAO, it's also a good idea to increase the
1162 Please note that those VxWorks kernel configuration parameters
1163 are set in the VxWorks configAll.h file. You must rebuild your
1164 VxWorks kernel after modifying that file.</p><p>
1166 If you're first getting started with ACE and/or VxWorks, I recommend
1167 just building the ACE library and tests first. (Some of the ACE
1168 examples, in System_V_IPC, don't build on VxWorks yet.) Then try
1169 running the tests. Please see $ACE_ROOT/tests/README for the latest
1170 status of the ACE tests on VxWorks.</p><p>
1175 In addition, ACE_HAS_NONSTATIC_OBJECT_MANAGER is enabled by default
1176 to cleanly support construction and destruction of static objects.
1178 ACE_Object_Manager</a> discussion for the important implication
1179 of this feature.</p><p>
1181 ACE threads (VxWorks tasks) can be named, for example, by supplying a
1182 non-null argument to the Thread_Manager spawn routines. However,
1184 that prefix is used internally by ACE.</p><p>
1191 </p><pre><code>
1192 spa ace_main, "arg1" [, ...]
1193 </code></pre>
1195 All arguments must be quoted, even numbers. You can start also ace_main
1196 without spawning another thread by using:<p>
1198 </p><pre><code>
1199 spaef ace_main, "arg1" [, ...]
1200 </code></pre>
1206 <pre><code>
1208 </code></pre>
1209 <p>
1210 You could call this from the VxWorks shell like:
1211 </p>
1212 <pre><code>
1213 my_rc = vx_execae ace_main, "-o server.ior -ORBDottedDecimalAddresses 1"
1214 </code></pre><p>
1224 shell argc will be zero and argv* will also be zero. Using <code>argv[0]</code> will not return
1225 the program name, but will result in a crash.<br>
1226 The ACE helper functions <code>spa</code>, <code>spaef</code> and <code>vx_execae</code> prevent
1227 this problem by building a regular <code>argc</code> and <code>argv</code> which also contain a
1233 an initial focus on static builds the support for shared builds is momentarily
1234 broken. This will be remedied(!) as soon as possible.<p>
1236 ACE supports shared libraries for VxWorks, but only with the g++
1237 compiler. To build shared libraries instead of the default static
1241 any other) shared library before loading your executable(s).</p><p>
1243 A shared library for VxWorks uses the same code as for a static
1244 (non-shared) library. However, calls to static constructors/
1246 be reentrant if you shared it between programs (tasks). The
1247 ACE library meets this requirement.</p><p>
1249 Shared libraries reduce build time, executable size, and load
1250 time of the executable. But, you must manually load the shared
1251 library before loading your executable(s) with a command such as:
1252 </p><pre><code>
1254 </code></pre>
1255 Shared libraries can be unloaded the same way an executable
1256 (module) is unloaded.<p>
1259 shared libraries on other operating systems. In particular, there is
1260 no support for creating copies of writeable global (static) data in
1261 the shared library. This includes the singleton ACE_Object_Manager
1262 instance pointer. If you share global data between separate programs,
1263 they may not work properly. See the discussion of shared code and
1266 Instead of trying to run separate programs onto a VxWorks target, we
1267 recommend creating just one program, and spawning a thread for each
1268 task. The TAO IDL_Cubit test <a href="TAO/performance-tests/Cubit/TAO/IDL_Cubit/collocation_test.cpp">collocation
1271 </p><h3><a name="VxWorks/LinkToKernel">Linking ACE and/or TAO Libraries into the VxWorks Kernel</a>.</h3>
1273 It's easy to link your ACE and/or TAO libraries into the VxWorks kernel.
1275 disable the munch step. The easiest way to do that is to set the
1277 example, to build a libACE.so for PowerPC that can be linked into
1278 the kernel:
1279 <pre>% cd $ACE_ROOT/ace
1280 % make LD=ldppc shared_libs_only=1
1281 </pre>
1282 After building the shared lib, link it into the kernel by setting
1288 It is possible to generate a script to execute all ACE tests. You can do this by executing
1290 </a></pre></blockquote>
1292 The ACE tests write their output files in a directory named
1294 </p>
1295 <p>
1296 To run the tests from the build directory on an NT host where you crossbuild your
1297 VxWorks ACE/TAO you can set up the Target Server File System (TSFS) in your Target Server
1298 configuration. If you f.i. set the root for the TSFS to the root directory of your builddisk
1299 you can set the default directory for the target by issueing the following command
1300 from a Host shell: '@cd "/tgtsvr/{path to ACE}/ACE_wrappers/tests"'.
1301 The '@' addition makes sure this command is executed for the target environment and not the
1302 local host shell environment.
1303 If you also issue the command 'cd {path to ACE}/ACE_wrappers/tests' you can execute the
1304 generated one button testscript like: '< run_test.vxworks'.
1305 </p>
1306 <p>
1307 Running the ACE tests automatically from the ACE autobuild tool using Target Server and Host
1308 shell options is also supported.
1309 </p>
1310 <p>
1311 If you don't have NFS included in your VxWorks kernel, you can use these steps, provided by
1313 to run the tests and capture their output:</p><p>
1314 </p><ol>
1315 <li>What I did was create a log directory on the boot NT host of my VxWorks
1316 target.<p>
1317 </p></li><li>I copied all the test applications and the run_test.vxworks script to
1318 the parent of the log directory.<p>
1320 containing the script and test programs.<p>
1321 </p></li><li>Invoked the script using <code>< run_test.vxworks</code> from this target shell.<p>
1322 </p></li></ol>
1325 approach for running the ACE tests on Tornado II:
1327 <ul>
1328 <li>Under Tornado II, I set up the Target Server File System (TSFS), and
1329 the test logs get written to the log subdirectory under that.<p>
1330 </p></li><li>You have to set an environment variable before running the tests:
1332 </pre><p>
1333 </p></li></ul>
1336 The following, very useful information was contributed by
1339 Please submit corrections, additions, or clarifications to the
1343 Tornado 2.2 cannot be used to build ACE. A working version is available
1344 from the WindRiver support site, download the
1345 <a href="https://secure.windriver.com/cgi-bin/windsurf/downloads/view_binary.cgi?binaryid=838">
1346 make3_80.gvk_patches</a> and the
1347 <a href="https://secure.windriver.com/cgi-bin/windsurf/downloads/view_binary.cgi?binaryid=100340">
1350 Using the Cygnus tools, this approach works:
1351 </p><ul>
1352 <li>You'll build both your NT and VxWorks executables in the same
1353 workspace (directory hierarchy). This works because the NT
1354 compiler and ACE's Makefiles put their output in different
1355 directories.<p>
1356 </p></li><li>Set up your
1358 as usual for VxWorks. See
1362 something like the following.
1363 <pre>#if defined (_MSC_VER) || defined (__BORLANDC__)
1364 # include "ace/config-win32.h"
1365 #else
1366 # include "ace/config-vxworks5.x.h"
1367 #endif
1368 </pre><p>
1371 variables.<p>
1373 </p></li></ul>
1375 A few additional Windows Notes, from Paul von Behren:<p>
1376 </p><ul>
1377 <li>Cygnus has created a Win32 API which is compatible with a
1378 "generic" Unix environment. Using this library, they have ported a
1379 large collection of GNU tools to WinNT/95 - including a port of
1380 gcc/g++. See <a href="http://www.cygnus.com/misc/gnu-win32/">http://www.cygnus.com/misc/gnu-win32/</a>
1381 A related link is <a href="ftp://ftp.cygnus.com/pub/gnu-win32/latest/">ftp://ftp.cygnus.com/pub/gnu-win32/latest/</a><p>
1382 </p></li><li>To set up the command-prompt build environment, run
1384 implicitly within the Tornado IDE.<p>
1388 </p></li><li>The Tornado IDE will use a standard Makefile for project
1389 builds, but does not have a GUI interface for managing the
1390 Makefile. By default, it will use rules from Makefile in the current
1391 directory and you can configure it to add certain Makefile
1393 before starting Tornado, you can specify an ACE Makefile as a Tornado
1394 target and Tornado will then call make from the menu.<p>
1395 </p></li></ul>
1397 And Chris Ryan's instructions for building for VxWorks targets
1398 on Windows NT hosts:
1400 <ol>
1402 </p><pre> /tornado/host/x86-win32/bin:
1404 /tornado/host/x86-win32/i386-wrs-vxworks/bin:
1405 /ace/ace_wrappers/bin:
1406 /gnuwin32/b18/H-i386-cygwin32/bin:
1407 /gnuwin32/b18/tcl/bin:
1408 /WINNT/system32:
1409 /WINNT:
1410 /WINNT/system32/nls/ENGLISH:
1411 /bin
1412 </pre>
1414 Other environment variables:<p>
1415 </p><pre> WIND_BASE=/tornado
1416 SHELL=/bin/sh.exe
1417 TERM=pcbios
1418 TAO_ROOT=/ace/ACE_wrappers.vxworks/TAO
1419 CPP_LOCATION=/Program Files/DevStudio/VC/bin/CL.EXE
1420 GCC_EXEC_PREFIX=/tornado/host/x86-win32/lib/gcc-lib/
1421 WIND_HOST_TYPE=x86-win32
1422 ACE_ROOT=/ace/ACE_wrappers.vxworks
1423 </pre>
1431 </p><pre> aced.dll
1432 cygwin.dll
1433 perl.exe
1434 rm.exe
1435 sh.exe
1436 true
1437 </pre>
1440 documented procedure for Windows VC++ ACE build.
1444 </li><li>Basically, follow documented procedure for ACE build/install on UNIX
1446 like:<p>
1448 </pre>
1450 And create a
1452 that looks like:<p>
1453 </p><pre>
1454 WIND_BASE = /tornado
1455 WIND_HOST_TYPE = x86-win32
1456 CPU = I80486
1457 include $(ACE_ROOT)/include/makeinclude/platform_vxworks5.5.x.GNU
1458 </pre>
1460 </li><li>When using cygnus windows GNUTools on WinNT you have to start
1461 make with "--unix" option, otherwise WinNT shell cmd.exe is responded and
1462 not sh.exe, i.e.,
1464 </pre>
1465 </li></ol>
1469 <ol>
1470 <li>Build ACE and TAO_IDL in the NT tree as already documented.
1471 Be sure to build ACE's gperf on NT, in
1474 </p></li><li>Build $TAO_ROOT/tao
1475 <pre> CPP_LOCATION=/Program Files/DevStudio/VC/bin/CL.exe
1476 cd $TAO_ROOT/tao
1477 /gnuwin32/b18/H-i386-cygwin32/bin/make
1478 </pre>
1480 </li><li>Build orbsvcs.
1481 <pre> CPP_LOCATION=/Program Files/DevStudio/VC/bin/CL.exe
1482 cd $TAO_ROOT/orbsvcs/orbsvcs
1483 /gnuwin32/b18/H-i386-cygwin32/bin/make
1484 </pre>
1487 </p></li></ol>
1491 Notes for Building ACE and TAO for VxWorks on NT host</h3>
1493 on NT. The target system was a PPC860 based chassis and another a NT
1494 host based card.</p>
1501 </p>
1511 </b><p>On NT the environment Variables are set as follows, (from
1515 <pre>
1516 C:\Perl\bin\;
1517 C:\tornado\host\x86-win32\bin;
1518 C:\tornado\host\x86-win32\powerpc-wrs-vxworks\bin;
1520 C:\Corba\Ace_wrappers\bin;
1521 C:\Cygwin\bin;
1522 C:\Cygwin\usr\bin;
1523 C:\bin
1524 </pre>
1527 <pre>
1528 CPU=PPC860
1529 LD_LIBRARY_PATH=
1530 SHELL=/bin/sh.exe
1531 ACE_ROOT=/Corba/ACE_wrappers
1532 WIND_BASE=/tornado
1533 SHELL=/bin/sh.exe
1534 TERM=pcbios
1535 TAO_ROOT=/Corba/ACE_wrapper/Tao
1536 CPP_LOCATION=/Program Files/Microsoft Visual Studio/VC98/Bin/CL.exe
1537 GCC_EXEC_PREFIX=/tornado/host/x86-win32/lib/gcc-lib/
1538 WIND_HOST_TYPE=x86-win32
1539 PERL_PATH=/perl/bin/perl.exe
1540 </pre>
1558 <pre>
1559 #if defined (_MSC_VER) || (__BORLANDC__)
1560 #include "ace/config-win32.h"
1561 #else
1562 #define ACE_HAS_IP_MULTICAST
1563 #include "ace/config-vxworks5.x.h"
1564 #endif
1565 </pre>
1568 <pre>
1569 WIND_BASE = /tornado
1570 WIND_HOST_TYPE = x86-win32
1571 include $(ACE_ROOT)/include/makeinclude/platform_vxworks5.5.x.GNU
1572 ACE_COMPONENTS=FOR_TAO (you may choose this option to build ACE library that supports TAO)
1573 </pre>
1575 <p></p>
1578 <p>In MS Visual C++ open C:\Corba\ACE_wrappers\ace.sln And build Ace
1579 DLL</p>
1583 <p>In MS Visual C++ open
1584 C:\Corba\ACE_wrappers\apps\gperf\src\gperf.sln. Build gperf.exe</p>
1593 /Corba</p>
1605 <p>This will build your ace library libACE.a for VxWorks. If you use
1606 option shared_libs_only=1 then the build will be libACE.so. The other
1607 options are same as follows.</p>
1612 </p>
1624 <p>You may play around with above options to find suitable build for
1625 your needs. For example when you give option debug=1 all the debug
1626 symbols will be created and the build will huge in size. The debug
1627 symbols are necessary when you want to debug your code.</p>
1633 <ul>
1641 </ul>
1645 (NDK)</a>. This is different than the standard way of writing Android
1646 applications in Java which run the on the Android Runtime or the older Dalvik
1647 Virtual Machine. Applications and libraries built using the NDK are native
1648 Linux applications written in C or C++ specifically compiled to run on Android
1649 systems and libraries can be included in normal Android apps. In addition,
1650 applications and libraries built using the NDK have access to Android-specific
1651 APIs much like the ones available to Java-based Android applications.
1652 </p>
1656 platform like Linux, but can also be used on Windows. If you are using an
1657 virtualized Linux environment like Windows Subsystem for Linux (WSL), Docker,
1658 or a traditional VM, then you can use the Linux version of the NDK and ignore
1659 rest of this note and all the other Windows specific notes.
1660 </p>
1662 <p>If that is not the case, you should also pay attention to the notes marked
1663 with "<b>Windows Users:</b>" in addition to the rest of the instructions. In
1664 addition to the Windows version of the Android NDK, you will also need
1666 </div>
1668 After downloading the NDK, you will have to decide on what target you want to
1669 build for, which is covered in the next section, then decide if you want to
1670 build directly using the NDK or using
1672 toolchain is optional and only really makes sense if you're building for just
1673 one architecture/API level pair and don't need to keep the entire NDK around.
1674 Using the NDK directly requires Android NDK r19 or later.
1678 <p>To build ACE for Android you need to know the specific Android target you
1679 want. The specific target is defined by two things:</p>
1683 <dd>A lower level means larger amount of potential users but also
1684 potentially less features. Android has <a
1686 to target</a>. They roughly correspond to the versions of Android.
1687 </dd>
1688 <dt>- The CPU architecture to target (Also called the Application Binary
1689 Interface or ABI by the NDK documentation).</dt>
1690 <dd>In addition to ARM, Android also supports x86 and MIPS,
1691 although support for MIPS has been dropped from the NDK. <a
1693 documentation on the ABIs</a>. These are the ABIs that ACE supports at the
1695 <!-- Check to see if any architectures have been added or removed. If so
1696 update this list and the table below as well-->
1708 </dl>
1709 <p><b>
1710 It should be noted that starting in August 2019, the Google Play
1711 Store will require new apps to have 64-bit libraries if they have native
1712 libraries. 32-bit native libraries will still be supported but apps must
1713 also have 64-bit libraries. Look up any restrictions that may affect apps
1714 you want to publish on the Play Store, including targeted API level
1715 requirements.
1716 </b></p>
1717 </dd>
1718 </li>
1719 </dl>
1723 <p>To generate a toolchain, one use must use
1729 </p>
1731 applications using ACE.</p>
1736 <tr>
1739 </tr>
1740 <tr>
1743 </tr>
1744 <tr>
1747 </tr>
1748 <tr>
1751 </tr>
1752 <tr>
1755 </tr>
1756 <tr>
1759 </tr>
1760 </table>
1767 toolchain, run this command instead:</p>
1770 <code>
1771 %NDK%\prebuilt\windows-x86_64\bin\python.exe
1772 %NDK%\build\tools\make_standalone_toolchain.py
1773 --arch arm --api 24
1774 --install-dir %TOOLCHAIN%</code>
1775 </p>
1780 </div>
1782 <!-- Remove this section if these NDKs can be considered not supported anymore -->
1787 <p>
1789 that it works with ACE. It is possible to use NDKs older than r18, but these
1790 have caveats:
1791 </p>
1792 <ul>
1793 <li>
1799 The scheme works like this:
1801 <tr>
1805 </tr>
1806 <tr>
1810 </tr>
1811 <tr>
1815 </tr>
1816 <tr>
1820 </tr>
1821 </table>
1822 </li>
1823 <li>
1824 As of NDK r18, the only compiler that comes with the NDK is clang and by
1825 default the build system assumes that clang is available and will use it.
1826 However there was a transitional period between r12 and r17 where GCC and
1827 clang both exist in the NDK. In some cases GCC should be used if linking
1828 errors occur with these NDKs (For example missing references to
1833 </li>
1834 <li>
1835 ACE does not support using the NDK directly before r18.
1836 </li>
1837 <li>
1838 There are probably unknown conflicts, especially in the minor revisions
1839 before the last minor revision of a NDK revision.
1840 </li>
1841 </ul>
1845 <ul>
1846 <li>
1850 in TAO-INSTALL.html</a>.
1855 will need to use it as a C preprocessor.
1856 </div>
1857 </li>
1861 <ul>
1862 <li>
1865 If using a standalone toolchain this must match the
1868 </li>
1871 level desired.</li>
1874 <li>Must include <code>include $(ACE_ROOT)/include/makeinclude/platform_android.GNU</code>.</li>
1875 <li>
1878 </li>
1879 </ul>
1880 </ul>
1881 </li>
1882 </li>
1884 <li>Build with GNU make. If using a standalone toolchain, make sure you
1890 If you are cross compiling TAO you will also need a preprocessor for
1892 </div>
1893 </li>
1894 </ul>
1895 </p>
1899 <p>Native applications using the ACE library can be installed onto devices by
1900 several different methods. The files can be include as assets of Java
1901 application and can be written by the Java application into it's executable
1902 program directory. The native application can be downloaded by a Java
1903 application and written into the Java applications executable program
1904 directory. The native application can also be uploaded using the Software
1905 Development Kit's ADB tool. This method requires uploading the native
1906 application to a directory that allows execution and having any output
1907 directed to a writable directory.</p>
1910 <p>
1915 at runtime, run:
1916 </p>
1919 ACE_LOG_MSG->clr_flags (ACE_Log_Msg::SYSLOG);
1920 </pre>
1925 #define ACE_DEFAULT_LOG_FLAGS ACE_Log_Msg::STDERR
1926 #define ACE_DEFAULT_LOG_BACKEND_FLAGS 0
1927 </pre>
1930 <p>
1931 Depending on the features of ACE, TAO, or other software desired, you might need
1932 OpenSSL. On Android, OpenSSL isn't part of the NDK Library and Android
1933 preloads the system SSL library (either OpenSSL or BoringSSL) for the Java
1935 conflicts with the almost certianly incompatible system SSL library.
1938 with OpenSSL's source code. The static libraries will used if the shared
1939 libraries are not found. This can be accomplished by either disabling the
1942 building OpenSSL.
1943 </p>
1945 <hr>
1948 The following explains how to build the ACE <a href="http://www.dre.vanderbilt.edu/~schmidt/ACE-netsvcs.html">network services</a> on <a href="#unixsvcs">UNIX</a> and <a href="#win32svcs">Win32</a>.
1953 Building and installing ACE Network Services on UNIX is relatively
1955 Here's what you need to do:<p>
1957 </p><ol>
1959 <li>Build and install ACE on UNIX as described <a href="#unix">earlier</a>. If ACE is built at the root of the ACE
1960 source tree (and ACE has been ported to your platform, of course) the
1961 netsvcs static and shared object libraries should be built
1962 automatically. In addition, the server driver program
1963 (<code>main</code>) contained in <a href="netsvcs/servers/main.cpp">$ACE_ROOT/netsvcs/servers/main.cpp</a>
1964 should also be compiled and ready to run.<p>
1967 where the binary version of the ACE netsvcs library. For
1968 example, you probably want to do something like the following<p>
1970 </p><pre><code>
1971 % setenv LD_LIBRARY_PATH $ACE_ROOT/ace:$ACE_ROOT/lib:$LD_LIBRARY_PATH
1972 </code></pre><p>
1974 </p></li><li>By default, if the shared object library is built, the services
1976 To specify which services should be linked in and executed, edit the
1978 file. During your editing, you should update information (such as the
1979 default service port numbers) that affects the initialization of
1980 services in this file. Refer to the
1981 <a href="http://www.dre.vanderbilt.edu/~schmidt/ACE-papers.html#config">Service Configurator</a>
1982 documentation to learn how the configuration file is parsed and
1983 how the services are dynamically linked and executed. In
1984 addition, refer to the <a href="http://www.dre.vanderbilt.edu/~schmidt/ACE-netsvcs.html">Network
1985 Services</a> documentation to learn more about how to configure
1986 each network service.<p>
1988 </p></li><li>If you only want to link the services statically, simply remove
1989 or rename the svc.conf file.<p>
1990 </p></li></ol>
1995 Once again, there are supplied project for Visual C++ 7.1 or later for
1996 the Network Services.<p>
1998 </p><hr>
2001 <p>The first step for all platforms is to build and install the
2003 ACE_SSL library must then be built according to the instructions
2004 below.</p>
2006 <ol>
2007 <li>Make sure the OpenSSL header file directory is in your compiler's
2008 include path, and that OpenSSL libraries are in your library link/load
2010 installed OpenSSL into a set of directories unknown by the compiler,
2012 top level directory of your OpenSSL distribution, i.e. the one
2014 directories.</li>
2015 <li>Build ACE as described above. When building ACE, add
2018 command line invocation, or add it to your
2022 prior to this point.</li>
2023 </ol>
2025 <ol>
2032 <li>At the moment you are using OpenSSL v1.1 or
2036 <li>Re-run MPC to add
2037 support for building the ACE_SSL library to your MSVC++
2038 workspaces and projects.
2040 and installation instructions above for details on creating a
2044 </ol>
2046 <p>Support for building ACE's ACE_SSL library and TAO's SSLIOP
2047 pluggable protocol with Embarcadero C++ does exist.
2048 <ol>
2055 support for building the ACE_SSL library to your Embarcadero C++ makefiles.
2056 <li>Build ACE and TAO.
2057 </ol>
2058 </p>
2060 <hr><p>
2063 libraries.
2065 <ol>
2066 <li>Try to generate build files using MPC. Inspect the output of MPC to find out which features are
2067 necessary to build given reactor. Add these features to
2069 using <code>-features</code> command line option. For example, for <code>FlReactor</code> the procedure
2070 consists of five steps
2071 <ol>
2073 <code>$ mwc.pl -type gnuace
2074 Skipping ACE_FlReactor (ace_flreactor.mpc), it requires x11.
2075 </code></li>
2076 Ensure that <code>X11</code> libraries are installed, then pass <code>x11=1</code> feature to MPC.
2079 Skipping ACE_FlReactor (ace_flreactor.mpc), it requires gl.
2080 </code></li>
2081 Ensure that <code>OpenGL</code> libraries are installed, then pass <code>gl=1</code> feature to MPC.
2084 Skipping ACE_FlReactor (ace_flreactor.mpc), it requires fl.
2085 </code></li>
2086 Ensure that <code>Fast Light Toolkit</code> libraries are installed, then pass <code>fl=1</code>
2087 feature to MPC.
2090 Skipping ACE_FlReactor (ace_flreactor.mpc), it requires ace_flreactor.
2091 </code></li>
2092 Allow MPC to generate makefiles for <code>FlReactor</code> by setting <code>ace_flreactor=1</code> feature.
2095 </code></li>
2096 </ol>
2097 Currently to simplify MPC generation some of features are turned on by default in
2099 files related with Fl one has to provide only fl=1 feature. To obtain a more fine grained controll
2100 over MPC generation process one may modify <code>ACE_wrappers/bin/MakeProjectCreator/*.features</code>
2101 files.
2102 </li>
2103 <li> Required build files are generated now, it is enough then to invoke build tool.
2106 encoded in generated project files, thus it is enough to compile ACE using MSVC.
2107 </li>
2108 </ol>
2109 The build procedure leads to a specific GUI Reactor library. For example, for
2113 When compiling TAO also GUI related libraries are created like <code>libTAO_QtResource.so</code>.
2115 Here one has at least three use cases:
2116 <ol>
2118 To use ACE support for GUI one has to include specific GUI headers and
2119 link with specific <code>ACE_[GUI]Reactor</code> library. When using TAO support for GUI one has
2122 In general, it is better to create specific base projects for using ACE GUI support in such application.
2123 Base projects provided by ACE <code>ACE_wrappers/bin/MakeProjectCreator/[ace,tao]_[gui][reactor,resource].mpb</code>
2124 may be an examples of how to do this.</li>
2126 MPC project for internal ACE application using GUI support should be derived from
2127 <code>ace_[gui]reactor.mpb</code> base projects. To employ TAO support for GUI one should derive
2128 the project from <code>tao_[gui]resource.mpb</code> These base projects ensure that all necessary libraries
2129 are linked to the application, specifies features necessary to build a project and moreover impose a
2130 build order consistant with ACE. For example, the application project using <code>XtReactor</code> should be
2132 </ol>
2134 <ul>
2137 To build this reactor one has to provide feature <code>qt</code> [0 by default] (Qt library). Moreover,
2143 To build this reactor one has to provide the following features: <code>x11</code> [1 by default]
2146 needs additionall features namely either <code>motif</code> [0 by default] (Motif/Lesstif libraries) or
2151 The is controlled by <code>ace_tkreactor</code> [1 by default] feature. To build this reactor one has to provide
2157 [1 by default] (X11 libraries),
2159 [0 by default] (Fast Light Toolkit). To build TAO
2163 should be setup manually for succesfull compilation. Obviosuly,
2165 </ul>
2167 <hr>
2170 <ul>
2179 up-to-date information about ACE on Windows CE and Windows Mobile.
2183 later.</b><p>
2185 All the source code and tests should build and run without any
2187 Sun C++ compilers.
2189 There are likely to be build problems with older versions or
2190 different patchlevels of Sun C++. Likewise, on
2191 Solaris with g++ you may need to use GNU as instead of
2192 /usr/ccs/bin/as, if you want -gstabs+ and -pipe support.
2195 for providing the following useful information:</p><p>
2197 By default, ACE uses both the Solaris and POSIX thread
2198 interface. To disable use of the Solaris thread interface, add
2204 To disable ACE thread support completely, build with the
2205 <code>threads=0</code> make flag. See the <a href="#flags">Makefile Flags</a> section below for more
2206 information on make flags.</p><p>
2208 If you use g++ on Solaris 7, you might need to rebuild
2210 provide replacements for system header files. The
2211 replacements on older SunOS systems are not compatible with the
2216 ACE is currently supported on AIX 5.2 and higher using IBM's
2220 compilers on all AIX 5L versions. The Asynchronous I/O functionality
2221 is disabled by default because its use requires the system administrator
2222 to explicitly enable it in the kernel using SMIT. If this has been
2223 done and you want to enable asynchronous I/O support in ACE, add:
2228 them unusable for building TAO. TAO has been tested with 6.0.0.12 and
2229 had no problems with that version.</p><p>
2234 with g++.</p><p>
2236 BTW, here's a technique from Rob Jordan <<a href="mailto:jordan@hursley.ibm.com">jordan@hursley.ibm.com</a>>
2237 that can reduce the size of the ACE libraries by about one
2238 third, and can also be applied to applications. It works by
2239 optimising the sharing of template functions, which are created
2240 in an "unusual" way under AIX. It also speeds up
2241 compilation.</p><p>
2243 Here's how to optimise the ACE library generation:</p><p>
2248 each of the source files
2251 and add a line to #include each of the .h files listed under
2253 GNUmakefile so that
2259 ACE has been ported to Linux on
2260 Intel, Alpha, and PowerPC platforms. If you use a RedHat 5.x
2261 distribution, it's best to use RedHat 5.1 or later. ACE works
2262 without any modifications on RedHat 5.1 and later, and on
2263 Debian 2.1 on both Intel and Alpha. Use the
2267 files can be used on PowerPC, with LinuxPPC
2270 If you run out of memory, it's easy to add virtual memory on
2274 Resource Requirements section</a> has some suggestions on how
2275 to reduce the memory requirement.</p><p>
2277 The glibc 2.0 dynamic loader isn't thread safe. If you want to
2278 use the Invocation API you'll have to set
2284 by default, though it is not required. IP multicast on Linux
2285 requires the following:</p><p>
2287 </p><ul>
2288 <li>Enable IP multicast in the Linux kernel. It is enabled in
2289 the default RedHat 5.1 kernel. In older distributions, you
2290 can enable it by rebuilding your kernel with CONFIG_IP_MULTICAST
2291 enabled.<p>
2292 </p></li><li>Enable IP multicast in ACE. It is enabled by default in
2296 </p></li><li>There must be a network interface that is up and supports
2297 multicast. If you have linuxconf, it's easiest to use that
2298 to add a network route for multicast (224.0.0.0) on one of
2300 you don't have or use linuxconf, try adding a multicast
2301 routing table entry using something like this:<p>
2303 </pre><p>
2304 </p></li></ul>
2306 Some of the ACE tests fail on older, pre-glibc2 Linux platforms,
2307 such as RedHat 4.2. The problems are with threads and
2308 thread-specific storage.</p><p>
2312 ACE has been ported to SCO UNIX using the GNU g++ 2.7.2
2313 compiler. Arturo Montes <<a href="mailto:mitosys@colomsat.net.co">mitosys@colomsat.net.co</a>>
2314 maintains this code. In addition, he also maintains a version
2315 of <a href="http://www.cs.wustl.edu/%7Eschmidt/ACE_wrappers/FSU-threads.tar.gz">FSU pthreads</a>.</p><p>
2319 ACE used to build fine using the SGI C++ and GNU GCC compilers
2322 number of patches that have to be installed and exceptions
2323 appear to fail with the O32 ABI. Please check the config files
2324 for the details.</p><p>
2329 with ACE's templates. They compile the lib and most of the test
2330 programs, although they warn about template usage. Most tests
2331 run, some dump core. If you use a 5.x version of cxx, be sure
2332 to set the CXX_VER variable to CXX_5, either on your make
2333 command line or in an environment variable. The ACE Makefiles
2337 and later build all of ACE cleanly. All of the tests in
2339 Please note that problems have been reported with some versions
2346 can be used for all supported compilers on any version of
2354 FreeBSD is a fast evolving platform. However, it has the
2355 advantage of having standard releases. At this moment, ACE is
2356 only perodically tested against -stable (3.1R) and we rely a lot
2357 on FreeBSD users' feedbacks. </p><p>
2361 create symlinks for most shared libraries if
2364 However, this does not work for libACE.so itself so you have to
2365 create it manually (If you figure out how to do this, please let
2366 us know) like this: </p><p>
2375 versioned .so files.</p><p>
2381 As with FreeBSD and NetBSD, OpenBSD requires versioned .so
2382 files. This is currently handled by the build files and no
2383 additional work is needed.</p><p>
2385 ACE has been ported to OpenBSD with and without pthreads
2386 enabled. When using pthreads, though, C++ exceptions must be
2387 disabled. This is a known problem with the current release of
2388 OpenBSD (see www.openbsd.org, bug #1750). ACE emulated
2389 exceptions work fine.</p><p>
2391 Compiling TAO may require the user data segment size
2392 restrictions and possibly other options to be increased. This
2393 is done by modifying the default user class in /etc/login.conf
2394 or by adding a new class and modifying the master passwer file
2395 accordingly.</p><p>
2407 UnixWare 7.1.0, with help from Michael Meissnitzer
2413 Building ACE (and TAO) on Unixware 7.1.0 requires a very specific
2414 g++ build environment. In particular, you must build and install
2416 of configuration) is extremely important. Using the gcc compiler
2417 provided on the Skunkware CD on a pentium system, here is the recipe
2418 I used to build a working environment (as root):<br>
2419 </p><pre> mkdir /usr/local/newgnu
2422 mkdir -p build/binutils build/gcc
2423 cd build/binutils
2424 ../../binutils-2.9.1/configure i386-sco-sysv4
2425 gmake # takes a long time
2426 gmake install # this creates /usr/local/i386-sco-sysv4/...
2427 mkdir /usr/local/i486-pc-sysv5/bin
2428 cd /usr/local/i486-pc-sysv5/bin
2429 for a in /usr/local/i386-sco-sysv4/bin/*; do ln -s $a .; done
2430 #links all the newly installed utilities
2432 cd /usr/local/newgnu/build/gcc
2433 ../../gcc-2.95.2/configure --with-gnu-as --with-gnu-ld
2434 gmake bootstrap # takes a long time
2435 gmake install
2436 mkdir /usr/local/i586-UnixWare7.1.0-sysv5/bin
2437 for a in /usr/local/i386-sco-sysv4/bin/*; do ln -s $a .; done
2438 </pre>
2439 Once done, ACE and TAO will successfully build and link.<p>
2443 ACE builds and runs properly on LynxOS 4.0 for Intel
2446 If you run out of memory on LynxOS, these might help:</p><p>
2448 </p><ul>
2450 then reboot system. We use these limits:
2451 <pre># Data, stack, and core file limits (in Kbytes)
2452 80000
2453 16000
2455 </p></li><li>Enable or expand virtual memory, with something like:
2460 </p></li></ul>
2462 Please see the comments in the
2464 platform_lynxos.GNU file</a> for information on, and an
2465 example of, tailoring for your particular platform.<p>
2467 NOTE: if you want to use IP multicast on LynxOS, be sure to add
2469 </p><pre><code>
2471 </code></pre>
2475 David Levine has
2478 VxWorks/Tornado. It is not possible to use VxWorks 5.4
2479 and earlier with ACE anymore because the compilers delivered with
2484 Since the existing support for previous VxWorks version has been unsupported
2485 and broken for some time and most (potential) users seem to have upgraded to
2487 </p><p>
2490 by default in ACE for VxWorks, because it depends on your
2491 kernel configuration. To enable it, add
2495 NOTE: In order for the ACE Broadcast and Multicast tests to work the VxWorks kernel
2496 should receive the packages it sends out locally. By default this is not supported.
2497 To enable this behaviour you need to include the IFF_SIMPLEX flag for your required
2498 NIC driver. See the following Windriver <a href="https://secure.windriver.com/cgi-bin/windsurf/techtips/public/viewSum.cgi?4542">SPR 4542</a>
2499 for more information.</p><p>
2501 In addition to all of the other benefits of ACE, it helps work
2502 around some deficiencies with VxWorks. The problems are:</p>
2504 <p>
2505 </p><ol>
2507 renames it to "ace_main" (configurable via ACE_MAIN) on VxWorks.
2508 While this may seem trivial, it is important with legacy code.
2509 ACE itself ran into this problem.<p>
2511 </p></li><li>argc/argv isn't used with VxWorks entry points. ACE provides
2512 a wrapper function that transparently converts shell command
2514 for details.<p>
2516 </p></li></ol>
2518 Please note that ACE uses one of the spare fields in the Wind
2519 River task control block, spare4, for thread-specific storage.
2520 This field is specified in only one place, in ace/OS_NS_Thread.inl, so it
2521 can easily be changed to one of the other spare fields, if
2522 necessary.</p><p>
2524 ACE destroys dynamically
2525 allocated singletons in the ACE library. But, they may not
2526 properly destroy some static objects. If you have trouble
2527 running a program multiple times, it may be necessary to unload
2528 the module, using unld, and reload it between runs.
2534 All of ACE has been ported to OpenEdition by Chuck Gehr <<a href="mailto:gehr@sweng.stortek.com">gehr@sweng.stortek.com</a>>.
2535 The ACE library, all the tests and most of the examples and apps
2536 build clean. There are still some problems that need to be
2537 ironed out:</p><p>
2539 MVS does not support the dynamic linking dl...() calls that the
2540 Service Configurator uses to dynamically link services at run
2541 time. As a result, all the examples and apps that use a svc.conf
2542 file (for dynamically configuring service objects) do not work,
2543 however, most of these apps can be built/run statically. Also,
2544 the Svc_Conf_l.cpp and Svc_Conf_y.cpp files are generated using
2545 flex and yacc on a ascii (not ebcdic) machine and as a result
2546 they don't work very well with ebcdic svc.conf files. We should
2547 be able to regenerate these files on MVS but MVS doesn't have
2548 flex. This is something that needs to be done.</p><p>
2550 Some of the tests do not execute properly. This is a minority
2553 The make scheme for some of the apps still doesn't work
2554 perfectly on MVS. This is mainly due to the way shared
2563 and <a href="include/makeinclude/platform_qnx_neutrino.GNU">include/makeinclude/platform_qnx_neutrino.GNU</a>
2564 configuration files. Many of the ACE tests succeed, though some
2565 fail. As the porting effort progresses, we hope to eliminate
2566 these failures. If you know of fixes, please send them to
2567 us.</p><p>
2571 </a>. We compile for QNX RTP using the GCC compiler shipped with the
2573 and <a href="include/makeinclude/platform_qnx_rtp_gcc.GNU">include/makeinclude/platform_qnx_rtp_gcc.GNU</a>
2574 configuration files.
2575 Many of the ACE tests succeed, though some
2576 fail. As the porting effort progresses, we hope to eliminate
2577 these failures. If you know of fixes, please send them to
2578 us.</p><p>
2580 Under the current version of QNX RTP ACE fails if compiled with
2585 The support for RTEMS has been revived from version x.5.4. This version
2586 was the first version that build again out of the box on RTEMS. Compilation
2587 and testing was done for RTEMS with and without networking support. The
2588 ACE GNU makefiles do automatically detect whether networking support
2589 is available or not.
2591 Besides the standard config.h/platform_macros.GNU file you will need
2593 of your RTEMS installation, see below for an example.</p>
2595 <p>
2596 When building without network support you will need the ace_for_tao
2603 ACE has been ported to Ardence's
2607 (VC7.1).</p><p> To build for PharLap, you'll need to use MPC to
2608 generate .sln/.vcproj files with the ETS configurations. For example:
2609 <pre>
2610 cd \ace\ACE_wrappers
2611 perl bin/mwc.pl -type vc71 -relative ACE_ROOT=C:/ace/ACE_wrappers -relative TAO_ROOT=C:/ace/ACE_wrappers/TAO -value_template configurations='"ETS Debug"' -value_template configurations+='"ETS Release"' -name_modifier *_ETS TAO_ACE.mwc
2612 </pre>
2613 That command will generate the same .sln and .vproj files as for
2614 regular Windows builds with VC7.1, but they'll have names with an
2617 After generating the needed VC7.1 files, use the ace/config-pharlap.h
2618 configuration file, and the instructions
2619 for building on Windows. Building the ACE library is the same as
2620 for regular Windows platforms, except you choose one of the PharLap
2621 ETS configurations to build within Visual Studio.
2622 For an example of how to build binaries, see the tests directory.
2623 The tests_pharlap_msvc.lnk file is a LinkLoc commands file that the
2624 ACE tests are built with. It is likely that local sites may need
2625 to adjust this file for their target environment.
2626 </p><p>
2627 When executing programs on the target system, it is possible that not
2628 all of the VC++ support DLLs are resident on the target. In particular,
2629 the debug-supporting DLLs may not be present. If you require these, be
2630 sure to add those needed. For example, on the standard LabVIEW RT 8.2
2631 distribution using Pharlap ETS, the following DLLs must be copied to
2632 the target before being able to run Debug programs:
2633 <ul>
2636 </ul>
2637 </p><p>
2638 <note>To build ACE for National Instruments' LabVIEW RT, use
2639 the Pharlap ETS information above, but add the following line to your
2640 config.h file:
2641 <pre>
2642 #define ACE_PHARLAP_LABVIEW_RT
2643 </pre>
2644 This setting makes the necessary adjustments for LabVIEW's implementation
2645 of Pharlap ETS.</note>
2647 <note>By default, the ACE tests log their output/results to the
2648 system console on Pharlap ETS. To change this behavior and make the
2650 current working directory while executing, add the following line to
2651 your config.h file:
2652 <pre>
2653 #define ACE_PHARLAP_TESTLOG_TO_FILE
2654 </pre>
2655 This setting has no affect on TAO tests which always write test output
2656 to stdout.
2657 </note>
2662 needed to build it:</p>
2667 SourceForge)</p>
2669 <p>When creating $ACE_ROOT/ace/config.h for Mac OS X, you need
2670 to add the following if you obtained dlcompat via Fink:</p>
2679 <p>Currently, all ACE tests pass except Process_Mutex_Test and
2680 MEM_Stream_Test. Also, Mac OS X doesn't yet support *nix
2681 aio_* calls, and ACE does not know anything about Mach.</p>
2683 <p>The work to port ACE to Mac OS X was done by several people,
2684 John Zorko
2686 only one of them.</p>
2690 </p><p>ACE builds and runs on the iPhone/iPod Touch/iPad Hardware
2691 and Simulator. Keep in mind that ACE/TAO needs to be built
2692 statically since Apple does not allow third party dynamic libraries
2693 to be deployed on the hardware. The following are needed to build ACE:</p>
2697 config-macosx-iphone-hardware.h if you want to deploy on the
2698 hardware, include config-macosx-iphone-simulator.h if you want
2699 to deploy on the simulator. Even though those includes are named
2700 after the iPhone, the includes work for iPhone/iPod Touch, and iPad.</p>
2702 IPHONE_TARGET. Set IPHONE_TARGET to SIMULATOR if you want to deploy
2703 on SIMULATOR. Set IPHONE_TARGET to HARDWARE if you want to deploy on
2704 the hardware device.</p>
2706 include 'include $(ACE_ROOT)/include/makeinclude/platform_macosx_iphone.GNU'
2707 in the file.</p>
2711 </li></ul>
2714 <hr>
2717 If you use the GNU GCC g++ compiler please note the following:
2719 <ul>
2723 file. This file is produced when installing gcc; it specifies
2724 where to install the binary files that gcc uses. For example,
2726 binary utils or GNU binary utils. The
2730 of hacking its output.<p>
2732 </p></li><li>If you are getting weird link errors when building libACE
2733 on Solaris you are probably using the GNU linker. Try using the
2734 Sun linker (/usr/ccs/bin/ld) instead. Note that gcc first looks
2735 for the GNU linker if it is installed along with gcc. The only
2736 way to not use the GNU linker is to delete it from the
2737 installation or to build your own compiler with no linker. Be
2738 aware that you still need the libraries and includes of gcc.<p>
2740 NOTE: if you do use the GNU linker, you might need to change
2745 </p></li><li>Don't get too confused about contradictory statements in
2746 the gcc documentation. It was written by different
2747 people...<p>
2749 </p></li><li>Make sure that the linker invoked by gcc produces code
2750 that initializes static objects. Please see gcc's
2753 </p></li></ul>
2756 <hr><p>
2759 just what's needed for (a subset of) TAO:<p>
2761 I usually make:
2762 </p><pre> $ACE_ROOT/ace,
2763 $ACE_ROOT/apps/gperf,
2764 $TAO_ROOT/tao,
2765 $TAO_ROOT/TAO_IDL, and
2766 $TAO_ROOT/orbsvcs/orbsvcs
2767 </pre>
2768 and the whole make takes less than an hour on my Solaris 7 for intel,
2770 renice the 'make' process to the highest priority, -20... ;-)
2772 To save time and space, I set
2773 <pre> TAO_ORBSVCS = Naming Time Trader ImplRepo
2774 </pre>
2781 Requirements</a></h2> The amount of system resources required to build
2782 ACE and TAO varies greatly. The required system resources are
2783 influenced by OS and compiler platform, build options, and component
2784 configurations. As a rough guide, the typical peak memory requirement
2785 can be well over 512 MB (notably, for TAO's orbsvcs). Depending on
2787 of ACE and TAO can use well over 4 GB of disk space. It's usually not
2790 Much less disk space is required for just the libraries. For example,
2794 If you run out of memory when building, you might consider trying
2795 some or all of these suggestions:</p><p>
2796 </p><ul>
2797 <li>Enable or increase virtual memory. If you're on a <a href="#Linux">Linux</a> or <a href="#LynxOS">LynxOS</a> platform,
2798 please see the appropriate sections above.<p>
2799 </p></li><li>Disable/enable optimization and/or debugging. See the
2801 on how to do that via ACE's Makefiles.<p>
2805 </p></li><li>Restrict the components that you build. For ACE and TAO, see the
2809 <a href="TAO/docs/configurations.html#orbsvcs">orbsvcs Library configuration information</a>.<p>
2811 If disk space is a problem, disabling debugging should greatly
2812 reduce object code, and therefore, library size. This is especially
2813 true with g++.</p><p>
2816 disk space usage:</p><p>
2818 To save space on a Unix machine, I usually run
2819 'find . -name \*.sln -o -name \*.vcproj -o -name \*.bmak | xargs rm -f'
2820 in $ACE_ROOT at first after I untar the distribution. They are
2821 meaningless in my environment (Files named '*.sln' and '*.vcproj' are
2822 used for MSVC++ and files named '*.bmak' are for Embarcadero C++
2823 Builder.)</p><p>
2825 Finally, to save space, may want to run 'make clean' after 'make'. It
2826 removes generated object files and leaves libraries/executables
2827 intact. If you want to remove any of the libraries/executables, as
2828 well, try 'make realclean'.</p><p>
2830 </p></li></ul>
2832 <p></p><hr><p>
2835 <p>
2837 http://htmlpreview.github.io/?https://github.com/DOCGroup/MPC/blob/master/docs/html/MakeProjectCreator.html">
2838 Makefile Project Creator (MPC)</A> is a tool that takes platform and
2839 building tool generic files (mpc files) as input, which describe basic
2840 information needed to generate a "project" file for various build
2844 </p>
2846 <p>
2847 A common usage for creating a Windows workspace containing just the
2848 core ACE and TAO libraries and executables is the following:
2849 </p>
2851 <pre><code>
2852 C:> cd %TAO_ROOT%
2853 C:> %ACE_ROOT%\bin\mwc.pl -type vc71 TAO_ACE.mwc
2854 </pre></code>
2856 <p>
2857 Replace vc71 with whatever project type you want to use. On Linux and
2858 other UNIX platform use the gnuace type:
2859 </p>
2861 <pre><code>
2862 % cd $TAO_ROOT
2863 % $ACE_ROOT/bin/mwc.pl -type gnuace TAO_ACE.mwc
2864 </pre></code>
2866 <p>
2867 This creates the appropriate GNUmakefiles. Additional information on
2868 how to obtain, configuration, and build ACE+TAO using MPC appear at
2869 the OCI <A
2871 </p>
2873 <p>
2874 If you are attempting to generate project files using MPC, and you get
2875 the following error message:
2876 </p>
2878 <pre>ERROR: Unable to find the MPC modules in /builds/ACE_wrappers/MPC.
2879 You can set the MPC_ROOT environment variable to the location of MPC.
2880 </pre>
2882 <p>
2883 You need to do one of the following:
2884 </p>
2886 <ol>
2887 <li>If you have already obtained MPC, either move it underneath the
2888 ACE_wrappers directory or set your MPC_ROOT environment variable to point
2889 to the full path of MPC.</li>
2890 <li>Check out MPC from the DOC Group git repository
2891 and set your MPC_ROOT environment variable.</li>
2892 </ol>
2894 <p>
2895 You can check
2896 out MPC from the DOCGroup git repository using the following command.
2897 </p>
2899 <pre>git clone https://github.com/DOCGroup/MPC.git MPC
2900 </pre>
2902 <p>
2903 The <A HREF="MPC/docs/README">README</A> and <A HREF="MPC/docs/USAGE">USAGE</A> files in the MPC/docs directory are an up-to-date
2904 source of documentation, however it is not a complete set of
2905 documentation. The TAO Developer's Guide from OCI starting with the
2906 1.3a version contains more information about MPC.
2907 </p>
2909 <p>
2910 The MPC chapter from the TAO Developer's Guide is available at <a
2912 http://downloads.ociweb.com/MPC/</a>. Some of MPC has changed since
2913 this version, but it is largely accurate. An updated version will be
2914 available as newer versions of the TAO Developer's Guide are released.
2915 In the meantime, please see the README and USAGE files in the MPC
2916 directory.
2917 </p>
2919 <p>
2923 <p>
2924 The Eclipse CDT C++ development environment can be used to develop ACE applications. You can configure a new CDT project to build ACE using either a local source distribution or checking out ACE from CVS in Eclipse. These are the steps to create the CDT project to build ACE.
2925 </p>
2927 <p>
2929 <ol>
2931 <li>Checkout the module using "Check Out As" and select the "project configured using the New Project Wizard" option.</li>
2933 <li>Follow the steps outlined above, up to the point of running make, for building ACE on your platform. Use "path_to_your_eclipse_workspace"/"project_name" as your $ACE_ROOT.
2934 <li>If you had to regenerate the makefiles using MPC, select the root folder for your poject and use the import wizard to add them to your project.</li>
2935 <li>Select the root folder for the project and use the "Create Make Target" wizard to setup the appropriate make command and options.</li>
2937 </ol>
2938 </p>
2942 <p>
2944 <ol>
2947 <li>On the project name page, uncheck the "use default" location option and replace the default path with the path to your source distribution.</li>
2948 <li>Follow the steps, up to the point of running make, for building ACE on your platform.
2949 <li>If you had to regenerate the makefiles using MPC, select the root folder for your poject and use the import wizard to add them to your project.</li>
2950 <li>Select the root folder for the project and use the "Create Make Target" wizard to setup the appropriate make command and options.</li>
2954 </ol>
2955 </p>
2957 </p>
2959 <hr><p>
2962 <ul>
2969 </li></ul>
2973 ACE_Object_Manager</a></h2> The ACE_Object_Manager can be instantiated
2974 as a static object, can be instantiated on the stack of the main
2975 program thread, or can be explicitly instantiated and destroyed by the
2977 ()</code>. The comments in the header file,
2978 <a href="ace/Object_Manager.h"><code>ace/Object_Manager.h</code></a>, as well as Section 1.6.3 in
2980 provide more detail.<p>
2983 Special requirements are imposed on applications if the
2984 ACE_Object_Manager is instantiated, by ACE, on the stack of the main
2985 thread. This behavior is selected by defining
2988 <a href="ace/Object_Manager.h"><code>ace/Object_Manager.h</code></a> for more information. One of
2989 these requirements is discussed here, because it is so important.
2992 VxWorks and Win32.</p><p>
2998 </p><pre><code>
2999 int
3000 main (int, char *[])
3001 </code></pre>
3005 undefined.<p>
3007 Alternatively, this feature can be disabled by commenting out the
3008 #define ACE_HAS_NONSTATIC_OBJECT_MANAGER in the
3010 difficult on VxWorks. And, you'd either have to call static
3011 constructors and destructors manually or unload/load the program
3012 between runs. On Win32, disabling the feature can possibly lead to
3013 shutdown difficulties.</p><p>
3018 of this assumption is at your peril. If you really need to call your
3020 construct and destroy the ACE_Object_Manager. The best way to do that
3029 On UNIX platforms, we typically like to support multiple platform
3030 builds using the same ACE source tree. This idiom is supported by ACE
3031 using the $ACE_ROOT/bin/create_ace_build.pl script.
3033 To clone the source tree, create ./build and ./build/{your build name}
3034 subdirectories under the ACE_wrappers directory.
3035 Then invoke the create_ace_build.pl script to clone the source tree using
3036 soft links from your build directory back to the actual sources.
3037 Here is an example:</p><p>
3039 </p><pre>% cd ACE_wrappers
3040 % mkdir build build/build-SunOS5
3041 % perl bin/create_ace_build.pl -a -v build-SunOS5
3042 % cd build/build-SunOS5
3043 % setenv ACE_ROOT $cwd
3044 % make
3045 </pre><p>
3047 This will establish a complete tree of links. In addition, make sure
3050 platforms.</p><p>
3052 When you do a make in the $ACE_ROOT directory you will be producing
3053 object code that is not stored in the same place as the original
3054 source tree. This way, you can easily build another platform in a
3055 parallel tree structure.</p><p>
3057 See the comments at the top of the create_ace_build.pl script for
3058 further usage information.
3063 For all intents and purpose, MVS OpenEdition (OE) is another flavor of
3065 and Installing ACE on Unix</a> can be used along with the following
3066 additional tips:<p>
3068 You can get a copy of GNU make that has been ported to MVS OpenEdition from
3070 ACE's make scheme generates compile commands that have options and
3071 operands interspersed. By default, the c89/cc/c++ compiler expects all options to
3072 precede all operands. To get around this, you must set a special
3073 compiler environment variable (_CXX_CCMODE) to 1 which tells the compiler
3074 to allow options and operands to be interspersed.</p><p>
3079 Shared objects are built a little different on MVS than on
3080 other UNIX implementations. This has been accounted for in the makefiles
3081 that come with ACE When the linker (via the cxx command) builds the
3082 libACE.so file it will also create a file called libACE.x. This is a
3083 side-deck file and it must be included in subsequent link edits with
3084 application code. For more information on this see the C/C++ MVS
3085 Programming Guide. If you want to build your application statically,
3086 i.e., using libACE.a instead of libACE.so, you can set ACELIB to
3087 ACELIB_STATIC in platform_mvs.GNU.</p><p>
3089 When the libACE.so file is built (via the MVS pre-linker and binder), you
3090 will get a rc=4 from the pre-linker. This is ok. This is due to some
3091 warnings about unresolved references which should get resolved during the
3092 link step. Note, however, there shouldn't be any unresolved references
3093 from the binder (linkage editor). You can get pre-link and link maps by
3094 uncommenting the PMAP and LMAP lines in the platform_mvs.GNU file.
3099 GNU make provides many options to customize its operation. See its
3100 documentation for more information. One example is that for multi-cpu
3101 UNIX machines you will be able to build faster if you use:<p>
3103 </p><pre><code>
3105 </code></pre><p>
3108 typically be the number of CPUs. It is likely that builds will be
3109 faster even on single-CPU UNIX machines with <code>make -j
3112 ACE further supports the following flags. They can be enabled either
3113 on the command line, e.g., "make purify=1", or added to your
3115 set the flag to null,
3118 released with ACE.</p><p>
3120 Please note that the effects of a flag may be platform specific.
3121 Also, combinations of certain flags may or may not be allowed on
3123 not all other C++ compilers.</p><p>
3130 directory for your instrumented libraries.</p><p>
3132 </p><pre>Flag Description
3133 ---- -----------
3134 debug Enable debugging; see DCFLAGS and DCCFLAGS.
3135 exceptions Enable exception handling (not supported by all platforms).
3136 include_env Support old-style ACE_TRY_ENV declarations in methods.
3137 This switch is necessary for compiling TAO applications
3138 in the native exception configuration that were written
3139 for TAO versions before 1.2.2.
3140 In TAO 1.2.2, new macros were introduced that supercede
3141 the direct ACE_TRY_ENV declarations. These are the
3142 ACE_ENV_ARG macros that are defined in ace/CORBA_macros.h
3143 and are documented in docs/exceptions.html.
3144 This switch only affects the exceptions=1 configuration.
3145 It is for backward compatibility only.
3146 There will be warnings about unused _ACE_environment_variable
3147 parameters when using include_env=1.
3148 If possible, do not use it, but instead change your TAO
3149 applications to use the ACE_ENV_ARG macros.
3150 fast Enable -fast option, e.g., with Sun C++.
3151 inline Enable ACE inlining. Some platforms enable inlining by
3152 default, others do not.
3153 optimize Enable optimization; see OCFLAGS and OCCFLAGS.
3154 pace Enable PACE as the underpinnings of ACE_OS.
3155 probe Enable ACE_Timeprobes.
3156 profile Enable profiling; see PCFLAGS and PCCFLAGS.
3157 purify Purify all executables.
3158 quantify Quantify all executables.
3159 repo Use GNU template repository (g++ with repo patches only).
3160 rtti Enable run-time type identification. On some platforms,
3161 it is enabled by default, so this is ignored.
3164 shared_libs_only Only build shared libraries. Ignored if no SHLIBs are
3165 specified by the Makefile, as in performance-tests/Misc.
3166 static_libs_only Only build static libraries.
3167 threads Build with thread support.
3168 xt Build with Xt (X11 Toolkit) support.
3169 fl Build with FlTk (Fast Light Toolkit) support.
3170 tk Build with Tk (Tcl/Tk) support.
3171 qt Build with Qt (Trolltech Qt) support.
3172 ssl Build with OpenSSL support.
3173 rapi Build with RAPI
3174 split Build the library by first splitting up the ACE source
3175 to several files, with one object code entity for each
3176 source file. This allows an application that is linked
3177 with ACE to extract _exactly_ what it needs from the
3178 library, resulting in a smaller executable. Setting this
3181 Usually, users do not need to be concerned with make targets.
3182 Just enter "make" on the command line to build. A few notable
3183 targets are listed below.
3185 Target Description
3186 ------ -----------
3187 show_statics Lists all static objects in object files built for
3188 current directory. Only supported for g++.
3189 show_uninit Lists all uninitialized in object files built for
3190 current directory. Only supported for g++.
3192 </pre>
3194 </p><hr>
3198 If users are building from our <a href="https://github.com/DOCGroup/ACE_TAO">Git repository</a> the
3199 GNUmakefiles, and project files for building on various platforms will
3201 using <a href="https://raw.githubusercontent.com/DOCGroup/MPC/master/docs/README">MPC</a> before building ACE, TAO or
3202 CIAO. We point out some suggestions below to get bootstrapped
3203 quickly.
3205 <ul>
3206 <li>You can clone all code easily from our git repository.
3207 <ul>
3209 </ul>
3211 perl</a> installed, preferably perl
3212 5.8 or higher. Users on Win32 based platforms are recommended to use
3215 We use both perl versions without problems. We have
3216 ran into problems trying to use the cygwin version of perl on Win32
3217 based platforms. <p>
3218 </p></li>
3220 <li>To build ACE and associated tests, examples,
3221 and associated utility libraries with GNUmakefiles, you must
3222 generate GNUmakefiles with MPC:<p>
3224 <p>On Windows, with Visual Studio 2015, you must generate solution and project files with MPC:<p>
3233 </li><li>If you want to build TAO and its associated libraries
3235 </li></ul>
3237 <hr><p>
3239 home page.
3240 </p><p>
3241 <!--<EM>
3242 Visitor #
3243 from
3244 <EM><br> -->
3246 <!-- hhmts start -->
3248 <!-- hhmts end -->
3251 </p></body></html>