1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
|
<HTML>
<!-- $Id$ -->
<HEAD>
<TITLE>Building and Installing ACE and Its Network Services</TITLE>
<BODY text = "#000000"
link="#000fff"
vlink="#ff0f0f"
bgcolor="#ffffff">
<HR>
<H3>Building and Installing ACE and Its Network Services</H3>
<H4>Synopsis</H4>
The file explains how to build and install ACE and its Network
Services on the various OS platforms and compilers that it has been
ported to. Please consult the <A HREF="ChangeLog">ChangeLog</A> file
to see whether any recent changes to the release will affect your
code. In addition, you might want to read the ACE <A
HREF="ACE.FAQ.html">FAQ</A> before building and installing ACE.
<H4>Document Index</H4>
<UL>
<LI><A HREF="#platforms">Supported Platforms and Compilers</A>
<LI><A HREF="#aceinstall">Building and Installing ACE</A>
<LI><A HREF="#svcsinstall">Building and Installing ACE Network Services</A>
<LI><A HREF="#advanced">Advanced Topics</A>
</UL>
<P><HR><P>
<A NAME="platforms">
<H3>Supported Platforms and Compilers</H3>
The ADAPTIVE Communication Environment has been ported and tested
extensively on a wide range of C++ compilers and uni-processor and
multi-process OS platforms including Win32 (i.e., WinNT and Win95),
most versions of UNIX (e.g., SunOS 4.x and 5.x, SGI IRIX, HP-UX,
OSF/1, AIX, Linux, and SCO), VxWorks, and MVS OpenEdition. If you
have a problem compiling the ACE wrappers on the platforms shown below
please send email to the <A HREF="mailto:ace-users@cs.wustl.edu">ACE
mailing list</A> and we'll try to fix it for you.
<DL>
<DT> <B>Win32 (Windows NT and Windows '95) </B><P>
<DD> All of ACE has been ported to the Win32 API (which includes
Windows NT and Windows '95). The entire release now
compiles using the Microsoft Visual C++ 4.0 compiler (the
2.0 compiler should also work, but I haven't tested it
recently). ACE can be built as both a static and dynamic
library, using the Win32 installation process described
below. <P>
<DT> <B> Sun OS 5.x/4.x (a.k.a. Solaris 2.x/1.x) using Sun CC 3.0.1, Sun
C++ 4.0.x, Centerline C++ 2.x, and GNU gcc 2.7.x. </B> <P>
<DD> All the source code and tests should build and run without
any problems on the Solaris and SunOS platforms using the
Sun C++ compilers. <P>
<DT> <B> Sun OS 4.1.x using Centerline C++ 2.x, Sun CC 3.x, and Lucid
Energize 3.2. </B> <P>
<DD> Note that shared libraries do not interact very well with
Centerline C++ or Sun C++ on SunOS 4.1.x. This is due to
odd behavior of the SunOS 4.1.x linker, which (1) does not
properly call constructors of global objects within shared
libraries and (2) does not call the init() and fini()
functions in shared libraries, even though the manual claims
that these functions are called! In particular, this means
that the tests in the directory
$(WRAPPER_ROOT)/tests/Service_Configurator/IPC-tests/server/
will not work for statically linked services... <P>
Some versions of SunOS 4.1.x do not contain the
/usr/lib/libnsl.a library. This library seems to be
optional since System V Transport Layer Interface (TLI)
support is optional on SunOS 4.1.x (in contrast, it's the
"preferred" transport interface on Solaris). <P>
The best work-around for now is probably to either add a
dummy libnsl.a in /lib (which may not be feasible) or simply
comment out the line: <P>
LIBS += -lnsl <P>
in the $WRAPPER_ROOT/include/makeinclude/wrapper_macros.GNU
file. Naturally, any programs (e.g., the TLI_SAP tests)
that use the TLI wrappers aren't going to work! <P>
Note that on SunOS 4.x you may get warnings from the linker
that "archive has no table of contents; add one using
ranlib(1)" for certain libraries (e.g., libASX.a,
libThreads.a, and libSPIPE.a). This occurs since SunOS 4.x
does not support these features. <P>
<DT> <B> AIX </B> <P>
<DD> The ACE port to AIX assumes that the user has installed the
AIX patch containing the dl*() APIs. To use these APIs, IBM
has created a separate product (free to AIX licensees)
called shared library hookable symbols (or slhs/6000). If
you don't have this patch, the sv* commands for compiling
and linking will not be present on the system. <P>
<DT> <B> Linux and SCO 4.2 </B> <P>
<DD> ACE has been ported to <A
HREF="http://www.deltanet.com/users/slg/ACE">Linux</A> and SCO UNIX
using the GNU G++
2.7.2 compiler. <P>
<DT> <B> SGI IRIX 5.x </B> <P>
<DD> ACE builds fine using the SGI C++ and GNU GCC compilers for
IRIX 5.x. I haven't tried this on IRIX 6.x, but I assume
that will work too. If anyone can get ACE working with
IRIX 6.x pthreads please let me know.<P>
<DT> <B> HP-UX 9.x and 10.x </B> <P>
<DD> The current HP/UX C++ compiler is incredibly lame and has
problems compiling ACE templates and achieving template
closure. I've heard that the next release is better...
In the meantime, you might try using GNU GCC or SunC++
on HP/UX. <P>
<DT> <B> OSF/1 3.2 and 4.0 (a.k.a. Digital UNIX 4.0a) </B> <P>
<DD> The current OSF/1 C++ 5.4 compiler still seems to have problems
with ACE's templates. It compiles the lib and test programs, although
giving warnings about template usage. Most tests run, some dump core.
Hopefully newer compiler releases will alleviate these problems. <P>
GNU gcc 2.7.2.1 compiles without problems. All tests run (besides
minor problems). Thanks to Thilo Kielmann <<A
HREF="mailto:kielmann@informatik.uni-siegen.de">
kielmann@informatik.uni-siegen.de</A>> and David Trumble <<A
HREF="mailto:trumble@cvg.enet.dec.com">trumble@cvg.enet.dec.com</A>>
for help with this port. <P>
<DT><B> UnixWare 2.01 </B> <P>
<DD>
Steve Huston <<A HREF="mailto:shuston@ultranet.com">shuston@ultranet.com</A>>
has ported ACE to work with UnixWare 2.01 and
its standard C++ compiler.
</DL>
<DT><B>VxWorks</B> <P>
<DD>
<A HREF="http://www.cs.wustl.edu/~levine/">David Levine</A> <<A HREF="mailto:levine@cs.wustl.edu">levine@cs.wustl.edu</A>> has ported ACE to VxWorks 5.2 and 5.3 using the GreenHills 1.8.8 compiler.
</DL>
<DT><B>MVS OpenEdition</B> <P>
<DD>
Chuck Gehr <<A HREF="mailto:gehr@sweng.stortek.com">gehr@sweng.stortek.com</A>>
has ported ACE to IBM MVS.
</DL>
<HR>
<H4>Compiling ACE with GNU C++</H4>
If you use the GNU GCC C++ compiler please note the following: <P>
<UL>
<LI> Earlier versions of G++ may not compile certain
parts of ACE correctly due to compiler bugs. Please
upgrade to G++ 2.7.2 or greater. <P>
<LI> Make sure to update your gcc "config.status" file -
this specifies whether your gcc install uses, for
example, Solaris's "/usr/ccs/bin" binary utils or
GNU binary utils. <P>
<LI> Make sure that the linker invoked by GCC produces code
that initializes static objects. Please see GCC's
documentation for using <CODE>collect2</CODE>.<P>
</UL>
<P><HR><P>
<A NAME="aceinstall">
<H3>Building and Installing ACE</H3>
The following explains how to build the ACE on <A
HREF="#unixsvcs">UNIX</A> and <A HREF="#win32svcs">Win32</A>.
<A NAME="unix">
<H4>Building and Installing ACE on UNIX</H3>
Building and installing ACE on UNIX is relatively simple (the <A
HREF="#win32">process</A> for Win32 is different). Here's what you
need to do: <P>
<OL>
<LI> Install GNU make 3.7 or greater on your system (available via
anonymous ftp from prep.ai.mit.edu in the pub/gnu directory). <P>
<LI> Add an environment variable called WRAPPER_ROOT that contains the
name of the root of the directory where you keep the ACE wrapper
source tree. The ACE recursive Makefile scheme needs this information.
There are several ways to set the WRAPPER_ROOT variable. For
instance, in my .login file I have the following entry: <P>
<pre><code>
% setenv WRAPPER_ROOT /home/cs/faculty/schmidt/ACE_wrappers <P>
</pre></code>
However, if you're building a number of versions of ACE (e.g., for
different OS platforms or for different releases of ACE) you might use
the following approach:
<pre><code>
% setenv WRAPPER_ROOT $cwd
</pre></code>
<LI> Edit the $WRAPPER_ROOT/ace/OS.h file to update things like default
hostname and port numbers you'd like the programs in the
$WRAPPER_ROOT/{apps,tests} directories to use by default. <P>
<LI> Set the $WRAPPER_ROOT/ace/config.h file to point to the appropriate
platform/compiler-specific header configurations (such as
config-sunos5-sunc++-4.x.h). This file contains the #defines that
are used throughout ACE to indicate which features your system
supports (see the $WRAPPER_ROOT/ace/OS.h file for many
examples of how the ACE build configuration is affected by these
macro settings). <P>
There are config files for most versions of UNIX. If there isn't a
version of this file that matches your platform/compiler, you'll
need to make one. Please send me email if you get it working so I
can add it to the master ACE release. <P>
<LI> Set the $WRAPPER_ROOT/include/makeinclude/platform_macros.GNU file
to point to the appropriate platform/compiler-specific Makefile
configurations (e.g., platform_sunos5_sunc++.GNU). This file
contains the compiler and Makefile directives that are
platform/compiler-specific <P>
<LI> Note that since ACE builds shared libraries, you'll need to set
LD_LIBRARY_PATH to whereever you put the binary version of the
ACE library. For example, you probably want to do something like
the following <P>
<pre><code>
% setenv LD_LIBRARY_PATH $WRAPPER_ROOT/ace:$LD_LIBRARY_PATH <P>
</pre></code>
<LI> When all this is done, hopefully all you'll need to do is type:<P>
<pre><code>
% make <P>
</pre></code>
at the root of the ACE source tree. This will build the static and
shared object libraries and build the tests and the sample
applications. <P>
</OL>
<P><HR><P>
<A NAME="win32">
<H4>Building and Installing ACE on Win32</H3>
The installation process for NT is a bit different than UNIX. We
assume you're using MSVC++ 4.x (things are a little different for the
2.0 version...). <P>
<UL>
<LI> <B>SET UP THE ACE FILES</B>. <P>
Create a directory accessible via Windows NT (e.g., C:\ACE) and
copy all of ACE into it. This directory will be $WRAPPER_ROOT in
the following discussion. Then copy config-win32.h to
config.h. Note that files like ChangeLog may do strange things on
NT since they are symbolic links (which aren't supported under NT). <P>
The easiest thing to do is just use the default ace.mpd and ace.mak
files distributed with the release. Open workspace ace.mpd to
build ACE as a DLL. This included project assumes that you have
set the "global" include path to include $WRAPPER_ROOT. This can
be done via the following MSDEV menu item: <P>
Tools/Options/Directories/Show_Directories_For:Include_Files. <P>
If you choose not to use the given project, then the following
bullets explain how to build ACE with MSDEV. <P>
<OL>
<LI> CREATE A PROJECT WORKSPACE. <P>
Start by making a new project. It should be rooted at
$WRAPPER_ROOT. We normally browse to $WRAPPER_ROOT, and select
"ace" as the project name. This will cause MSDEV to use the
$WRAPPER_ROOT/ace directory to store the project files. The actual
directory and project name are unimportant, but we'll assume you
named the project "ace." Select the dynamic link library option
and say "ok." By default, the config-win32*.h files are set up to
build DLLs. If you choose to build ACE as a static library you'll
need to unset ACE_HAS_DLL in the config-win32*.h file and select
the static link library option when creating a project workspace.<P>
<LI> INSERT FILES INTO PROJECT. <P>
Go into the Insert menu and select "Files into project". If you're
building a static library, select all the *.cpp files in
$WRAPPER_ROOT/ace into the project. If you're building a dll, you
need to omit the files in ACE which contain template class
definitions. You can find out which files this is by looking at
the TEMPLATE_FILES target in the $WRAPPER_ROOT/ace/Makefile.<P>
Once you've selected the files and pressed "ok" it should take a
few seconds or so to for MSDEV to create the project. (Note that
in MSVC2.0 there isn't an Insert menu, so go into the Project Menu
and then "Files" and from there insert all the *.cpp files.) When
including the files on windows 95, it may ask you to select fewer
files than *.cpp. Just do A-M and N-Z or something similar. <P>
<LI> SET THE INCLUDE PATH. <P>
Go into Options section of the Tools menu. Add the $WRAPPER_ROOT
directory to the default directory search path. This is necessary
since all ACE #include files refer to themselves via ace/Foo.h.
Then add $WRAPPER_ROOT\ace to the default library search path.
This means that you can now use relative paths for linking apps
with ace.lib. You may skip this step if you have set
Tools/Options/Directories/Include_Files to include
$WRAPPER_ROOT. <P>
If you are going to compile ACE with UNICODE on, please add UNICODE
to the pre-processor definitions through: <P>
Build -> Settings -> C/C++ -> Preprocessor -> Preprocessor
definitions <P>
<LI> SET UP THE LINKER. <P>
You might want to link with the wsock32.lib into the ACE project,
as well, so that you don't have to include it with every
applications link setup. Do this by including wsock32.lib in the
project through Insert/Files_into_project. <P>
When building a DLL we must ensure that both dll and exe are using
the same libraries In order to allow standard C library functions
to share common variables (particular <TT>errno</TT>) across dll
and exe boundaries. Go to
Build/Settings/C++/Category:Code_Generation. Set Use run-time
library to "Multithreaded DLL" or "Debug Multithreaded DLL"
depending on whether you're building a release or a debug version
respectively.<P>
When building a static lib: Go to
Build/Settings/C++/Category:Code_Generation and set run-time
library to "Debug Multithreaded" (or just "Multithreaded"). <P>
<LI> BUILD. <P>
Go to the Build menu and select "Build ace.{lib,dll}". The first
time this happens it will rebuild all the dependencies. This may
take a while (i.e., 3 to 15 minutes, depending on whether you use
Samba, PC-NFS, native NTFS, etc.). Eventually, this process
will stop and from you won't have to rebuild the dependencies then
on (thank God...).<P>
At this point, the compiler should be happily chugging away on the
ACE files. <P>
<LI> USING ace.lib. <P>
When it's done, you should have a static or dynamic library
called ace.lib. You can use this to link with test applications
(such as those in the $WRAPPER_ROOT/examples directory). This
process is described below. <P><P>
</OL>
<LI> <B>MAKING TEST APPLICATIONS FOR WIN32</B> <P>
<OL>
<LI> CREATE THE PROJECT. <P>
As before, make a new project for each application. We've been
using Console Applications. Insert the appropriate .cpp files into
the project. <P>
<LI> SET THE INCLUDE PATH.<P>
In Build/Settings/C++/Category:Preprocessor, add $WRAPPER_ROOT to
"Additional include directories". If you've set the
Tools/Options/Directories/Include_Files to include $WRAPPER_ROOT,
then you don't need to do this.<P>
<LI> MODIFY SETTINGS. <P>
To enable MSVC++ to handle both SEH and destructors together in the
same code, we need to remove the /GX flag. Go to
Build/Settings/C++/Category:C++ Language. By default, the flag
"Enable Exception Handling" should be checked. Click on it to mark
it unchecked. The flag /GX will disappear from Project_Options. <P>
<LI> SET UP THE LINKER. <P>
You'll also need to tell MSVC++ what libraries to link with. In
Build/Settings/Link, add "$WRAPPER_ROOT/ace/Debug/ace.lib" to the
Object/library modules. If you've set
Tools/Options/Directories/Library_Files to include
$WRAPPER_ROOT/ace, you can just add "ace.lib" to the Object/library
modules instead of the complete path. <P>
When using ACE as a DLL: Go to
Build/Settings/C++/Category:Code_Generation. Set Use run-time
library to "Multithreaded DLL" or "Debug Multithreaded DLL"
depending on whether you're building a release or a debug version
respectively.<P>
When using ACE as a static lib: Go to
Build/Settings/C++/Category:Code_Generation and set the run-time
library to "Debug Multithreaded" (or just "Multithreaded"). <P>
If you're using WinSock, you will also need to add wsock32.lib to
this line if you haven't inserted into the ACE project already.<P>
<LI> BUILD.
You should now be able to build the .exe. <P>
</OL>
<LI> <B> BUILDING ACE ON A WIN32 MACHINE THAT LACKS A NETWORK CARD </B><P>
You may want to run ACE on a non-networked machine. To do so, you must
install TCP/IP and configure it to ignore the absence of a network
card. This is one method: <P>
<OL>
<LI> Run Control Panel
<LI> Choose Network from Control Panel
<LI> Add Adapter: MS Loopback Adapter
<LI> Configure MS Loopback Adapter with 802.3 (default)
<LI> Add Software: TCP/IP Protocol
<LI> Configure TCP/IP Protocol with a valid IP address and subnet mask.
Leave everything else at the default settings.
<LI> Add Software: Workstation
<LI> Exit and Restart System
<LI> Run Control Panel again
<LI> Choose Services from Control Panel
<LI> The following services are not necessary and may
be set to Disabled Startup: <BR>
Alerter<BR>
Computer Browser<BR>
Net logon<BR>
Messanger<BR>
<LI> Choose Network from Control Panel
<LI> Confirm the following setup. This is all you need to run ACE:<BR>
Installed Software:<BR>
Computer Browser<BR>
MS Loopback Adapter Driver<BR>
TCP/IP Protocol<BR>
Workstation<BR>
Installed Adapter Cards:<BR>
MS Loopback Adapter<P>
</OL>
</UL>
<HR>
<A NAME="svcsinstall">
<H3>Building and Installing ACE Network Services</H3>
The following explains how to build the ACE <A
HREF="ACE-netsvcs.html">network services</A> on <A
HREF="#unixsvcs">UNIX</A> and <A HREF="#win32svcs">Win32</A>.
<A NAME="unixsvcs">
<H4>Building and Installing ACE Network Services on UNIX</H3>
Building and installing ACE Network Services on UNIX is relatively
simple (the <A HREF="#win32svcs">process</A> for Win32 is different).
Here's what you need to do: <P>
<OL>
<LI> Build and install ACE on UNIX as described <A
HREF="#unix">earlier</A>. If ACE is built at the root of the ACE
source tree (and ACE has been ported to your platform, of course) the
netsvcs static and shared object libraries should be built
automatically. In addition, the server driver program
(<CODE>main</CODE>) contained in <A
HREF="http://www.cs.wustl.edu/~schmidt/ACE_wrappers/netsvcs/servers/main.cpp">
$WRAPPER_ROOT/netsvcs/servers/main.cpp</A> should also be compiled and ready to run.<P>
<LI> Set your LD_LIBRARY_PATH environment variable to where the binary
version of the ACE netsvcs library. For example, you probably
want to do something like the following <P>
<pre><code>
% setenv LD_LIBRARY_PATH $WRAPPER_ROOT/ace:$LD_LIBRARY_PATH <P>
</pre></code>
<LI> By default, if the shared object library is built, the services
are linked into the <CODE>main</CODE> driver program dynamically.
To specify which services should be linked in and executed, edit the
<A
HREF="http://www.cs.wustl.edu/~schmidt/ACE_wrappers/netsvcs/servers/svc.conf">
$WRAPPER_ROOT/netsvcs/servers/svc.conf</A> file. During your editing,
you should update information (such as the default service port
numbers) that affects the initialization of services in this
file. Refer to the <A HREF="ACE-papers.html#config">Service Configurator</A>
documentation to learn how the configuration file is parsed and
how the services are dynamically linked and executed. In
addition, refer to the <A HREF="ACE-netsvcs.html">Network
Services</A> documentation to learn more about how to configure
each network service. <P>
<LI> If you only want to link the services statically, simply remove
or rename the svc.conf file. <P>
</OL>
<A NAME="win32svcs">
<H4>Building and Installing ACE Network Services on Win32</H3>
The installation process for ACE network services on Win32 is a bit
different than UNIX. We assume you're using MSVC++ 4.x (things are a
little different for the 2.0 version...). <P>
<UL>
<LI> Build and install ACE on Win32 as described <A
HREF="#win32">earlier</A>. <P>
<LI> Just like installing the ace directory under ACE_wrappers,
install the new netsvcs directory under ACE_wrappers by copying
all the appropriate files, include netsvcs.mdp and netsvcs.mak. <P>
<LI> The easiest thing to do is to use the default netsvcs.mdp and
netsvcs.mak files distributed with the release. Open the
netsvcs.mdp workspace to build netsvcs as a DLL. This project
assumes that you have set the ``global'' include path to include
$WRAPPER_ROOT/netsvcs/lib. This can be done via the following
MSDEV menu item:
Tools/Options/Directories/Show_Directories_For:Include_Files. <P>
<LI> If you choose not to use the given project, the following bullets
explain how to build the ACE netsvcs DLL with MSDEV.<P>
<OL>
<LI> CREATE A PROJECT WORKSPACE. <P>
Start by making a new project. It should be rooted at
$WRAPPER_ROOT/netsvcs/lib. We normally browse to
$WRAPPER_ROOT/netsvcs, and select "netsvcs" as the project name.
This will cause MSDEV to use the $WRAPPER_ROOT/netsvcs/lib
directory to store the project files. The actual directory and
project name are unimportant, but we'll assume you
named the project "netsvcs." Select the dynamic link library option
and say "ok." By default, the config-win32*.h files are set up to
build DLLs. If you choose to build ACE as a static library you'll
need to unset ACE_HAS_DLL in the config-win32*.h file and select
the static link library option when creating a project workspace.<P>
<LI> INSERT FILES INTO PROJECT. <P>
Go into the Insert menu and select "Files into project". If you're
building a static library, select all the *.cpp files in
$WRAPPER_ROOT/netsvcs/lib into the project.<P>
Once you've selected the files and pressed "ok" it should take a
few seconds or so to for MSDEV to create the project. (Note that
in MSVC2.0 there isn't an Insert menu, so go into the Project Menu
and then "Files" and from there insert all the *.cpp files.) When
including the files on windows 95, it may ask you to select fewer
files than *.cpp. Just do A-M and N-Z or something similar. <P>
<LI> SET THE INCLUDE PATH. <P>
Go into Options section of the Tools menu. Add the $WRAPPER_ROOT/netsvcs/lib
directory to the default directory search path.
Then add $WRAPPER_ROOT\netsvcs to the default library search path.
This means that you can now use relative paths for linking apps
with netsvcs.lib. You may skip this step if you have set
Tools/Options/Directories/Include_Files to include
$WRAPPER_ROOT. <P>
If you are going to compile ACE with UNICODE on, please add UNICODE
to the pre-processor definitions through: <P>
Build -> Settings -> C/C++ -> Preprocessor -> Preprocessor
definitions <P>
<LI> SET UP THE LINKER. <P>
When building a DLL we must ensure that both dll and exe are using
the same libraries in order to allow standard C library functions
to share common variables (particular <TT>errno</TT>) across dll
and exe boundaries. Go to
Build/Settings/C++/Category:Code_Generation. Set Use run-time
library to "Multithreaded DLL" or "Debug Multithreaded DLL"
depending on whether you're building a release or a debug version
respectively.<P>
When building a static lib: Go to
Build/Settings/C++/Category:Code_Generation and set run-time
library to "Debug Multithreaded" (or just "Multithreaded"). <P>
<LI> BUILD. <P>
Go to the Build menu and select "Build netsvcs.{lib,dll}". The first
time this happens it will rebuild all the dependencies. This may
take a while (i.e., 3 to 15 minutes, depending on whether you use
Samba, PC-NFS, native NTFS, etc.). Eventually, this process
will stop and from you won't have to rebuild the dependencies then
on (thank God...).<P>
At this point, the compiler should be happily chugging away on
the netsvcs files. <P>
<LI> USING netsvcs.lib. <P>
When it's done, you should have a static or dynamic library
called netsvcs.lib. You can use this to link with test applications,
including the server driver program. <P>
</OL>
</UL>
<P><HR><P>
<A NAME="advanced">
<H3>Advanced Topics</H3>
<UL>
<LI><A HREF="#cloning">Cloning the Source Tree</A>
<LI><A HREF="#corba">Building CORBA Versions of ACE</A>
<LI><A HREF="http://www.cs.wustl.edu/~levine/CVS.html">Version Control</A>
</UL>
<H4><A NAME="cloning">Cloning the Source Tree</H4>
On UNIX platforms, I typically like to support multiple platform
builds using the same ACE source tree. This idiom is supported by ACE
using the $(WRAPPER_ROOT)/bin/clone.c program. To build clone,
perform the following steps: <P>
<pre>
% cd $WRAPPER_ROOT/bin
% make
% mv clone ~/bin
% rehash
</pre><P>
Then create a ./build subdirectory someplace (e.g., under
$WRAPPER_ROOT), and then invoke the top-level Makefile with the
"clone" target, e.g.: <P>
<pre>
% cd $WRAPPER_ROOT
% mkdir build-SunOS5
% cd build-SunOS5
% make -f ../Makefile clone
% setenv WRAPPER_ROOT $cwd
% make
</pre><P>
This will establish a complete tree of links. When you do a make in
this directory you will be producing object code that is not stored in
the same place as the original source tree. This way, you can easily
build another platform in a parallel tree structure. <P>
<B> VERY IMPORTANT! </B> <P>
If you use the "clone trick" discussed above, make sure that the
symbolic links are correctly in place before starting the build. In
particular, if you plan to clone the tree, it is preferable to do so
before you start a build procedure on the original tree. This is
because the build procedure create object directories (.obj and
.shobj) and the cloning procedure will clone these directories also.
You would end up with links pointing to object files of another
platform. If you clone the tree after you've done a build on the
original tree, make sure to remove all ".obj", ".shobj" and (any other
files or directories) in all subdirectories before starting the build
on your cloned tree. <P>
<P><HR><P>
<A NAME="corba">
<H4>Building CORBA Versions of ACE</H4>
Note that if you are compiling with IONA's Orbix implementation of
CORBA or Visigenix's implementation of CORBA, you'll also need to set
ORBIX_ROOT to point to the root of the Orbix source tree and
ORBELINE_ROOT to point to the root of the ORBeline source tree. Since
many platforms don't have these CORBA tools the default for ACE does
*not* incorporate them. Thus, if you are compiling with Orbix or
ORBeline, make sure that you set the symbolic links for
$WRAPPER_ROOT/include/makeinclude/platform_macros.GNU and
$WRAPPER_ROOT/ace/config.h to point to the the config* and platform*
files that have "-orbix" in them!
<P><HR><P>
Back to the <A HREF="http://www.cs.wustl.edu/~schmidt/ACE.html">
ACE</A> home page.
<!--#include virtual="/~schmidt/cgi-sig.html" -->
</BODY>
</HTML>
|
