2 # gc.a - builds basic library
3 # libgc.a - builds library for use with g++ "-fgc-keyword" extension
4 # c++ - adds C++ interface to library
5 # cords - adds cords (heavyweight strings) to library
6 # test - prints porting information, then builds basic version of gc.a,
7 # and runs some tests of collector and cords. Does not add cords or
8 # c++ interface to gc.a
9 # cord/de - builds dumb editor based on cords.
12 CXX = @CXX@ $(ABI_FLAG)
16 # The above doesn't work with gas, which doesn't run cpp.
17 # Define AS as `gcc -c -x assembler-with-cpp' instead.
18 # Under Irix 6, you will have to specify the ABI for as if you specify
19 # it for the C compiler.
21 CFLAGS= -O2 -DATOMIC_UNCOLLECTABLE -DNO_SIGNALS -DALL_INTERIOR_POINTERS -DNO_EXECUTE_PERMISSION -DSILENT -I /usr/local/include
23 # For dynamic library builds, it may be necessary to add flags to generate
24 # PIC code, e.g. -fPIC on Linux.
26 # Setjmp_test may yield overly optimistic results when compiled
27 # without optimization.
28 # -DSILENT disables statistics printing, and improves performance.
29 # -DCHECKSUMS reports on erroneously clear dirty bits, and unexpectedly
30 # altered stubborn objects, at substantial performance cost.
31 # Use only for incremental collector debugging.
32 # -DFIND_LEAK causes the collector to assume that all inaccessible
33 # objects should have been explicitly deallocated, and reports exceptions.
34 # Finalization and the test program are not usable in this mode.
35 # -DSOLARIS_THREADS enables support for Solaris (thr_) threads.
36 # (Clients should also define SOLARIS_THREADS and then include
37 # gc.h before performing thr_ or dl* or GC_ operations.)
38 # Must also define -D_REENTRANT.
39 # -D_SOLARIS_PTHREADS enables support for Solaris pthreads.
40 # Define SOLARIS_THREADS as well.
41 # -DIRIX_THREADS enables support for Irix pthreads. See README.irix.
42 # _DLINUX_THREADS enables support for Xavier Leroy's Linux threads.
43 # see README.linux. -D_REENTRANT may also be required.
44 # -DALL_INTERIOR_POINTERS allows all pointers to the interior
45 # of objects to be recognized. (See gc_priv.h for consequences.)
46 # -DSMALL_CONFIG tries to tune the collector for small heap sizes,
47 # usually causing it to use less space in such situations.
48 # Incremental collection no longer works in this case.
49 # -DLARGE_CONFIG tunes the collector for unusually large heaps.
50 # Necessary for heaps larger than about 500 MB on most machines.
51 # Recommended for heaps larger than about 64 MB.
52 # -DDONT_ADD_BYTE_AT_END is meaningful only with
53 # -DALL_INTERIOR_POINTERS. Normally -DALL_INTERIOR_POINTERS
54 # causes all objects to be padded so that pointers just past the end of
55 # an object can be recognized. This can be expensive. (The padding
56 # is normally more than one byte due to alignment constraints.)
57 # -DDONT_ADD_BYTE_AT_END disables the padding.
58 # -DNO_SIGNALS does not disable signals during critical parts of
59 # the GC process. This is no less correct than many malloc
60 # implementations, and it sometimes has a significant performance
61 # impact. However, it is dangerous for many not-quite-ANSI C
62 # programs that call things like printf in asynchronous signal handlers.
63 # -DNO_EXECUTE_PERMISSION may cause some or all of the heap to not
64 # have execute permission, i.e. it may be impossible to execute
65 # code from the heap. Currently this only affects the incremental
66 # collector on UNIX machines. It may greatly improve its performance,
67 # since this may avoid some expensive cache synchronization.
68 # -DOPERATOR_NEW_ARRAY declares that the C++ compiler supports the
69 # new syntax "operator new[]" for allocating and deleting arrays.
70 # See gc_cpp.h for details. No effect on the C part of the collector.
71 # This is defined implicitly in a few environments.
72 # -DREDIRECT_MALLOC=X causes malloc, realloc, and free to be defined
73 # as aliases for X, GC_realloc, and GC_free, respectively.
74 # Calloc is redefined in terms of the new malloc. X should
75 # be either GC_malloc or GC_malloc_uncollectable.
76 # The former is occasionally useful for working around leaks in code
77 # you don't want to (or can't) look at. It may not work for
78 # existing code, but it often does. Neither works on all platforms,
79 # since some ports use malloc or calloc to obtain system memory.
80 # (Probably works for UNIX, and win32.)
81 # -DIGNORE_FREE turns calls to free into a noop. Only useful with
83 # -DNO_DEBUGGING removes GC_dump and the debugging routines it calls.
84 # Reduces code size slightly at the expense of debuggability.
85 # -DJAVA_FINALIZATION makes it somewhat safer to finalize objects out of
86 # order by specifying a nonstandard finalization mark procedure (see
87 # finalize.c). Objects reachable from finalizable objects will be marked
88 # in a sepearte postpass, and hence their memory won't be reclaimed.
89 # Not recommended unless you are implementing a language that specifies
91 # -DFINALIZE_ON_DEMAND causes finalizers to be run only in response
92 # to explicit GC_invoke_finalizers() calls.
93 # -DATOMIC_UNCOLLECTABLE includes code for GC_malloc_atomic_uncollectable.
94 # This is useful if either the vendor malloc implementation is poor,
95 # or if REDIRECT_MALLOC is used.
96 # -DHBLKSIZE=ddd, where ddd is a power of 2 between 512 and 16384, explicitly
97 # sets the heap block size. Each heap block is devoted to a single size and
98 # kind of object. For the incremental collector it makes sense to match
99 # the most likely page size. Otherwise large values result in more
100 # fragmentation, but generally better performance for large heaps.
101 # -DUSE_MMAP use MMAP instead of sbrk to get new memory.
102 # Works for Solaris and Irix.
103 # -DMMAP_STACKS (for Solaris threads) Use mmap from /dev/zero rather than
104 # GC_scratch_alloc() to get stack memory.
105 # -DPRINT_BLACK_LIST Whenever a black list entry is added, i.e. whenever
106 # the garbage collector detects a value that looks almost, but not quite,
107 # like a pointer, print both the address containing the value, and the
108 # value of the near-bogus-pointer. Can be used to identifiy regions of
109 # memory that are likely to contribute misidentified pointers.
110 # -DOLD_BLOCK_ALLOC Use the old, possibly faster, large block
111 # allocation strategy. The new strategy tries harder to minimize
112 # fragmentation, sometimes at the expense of spending more time in the
113 # large block allocator and/or collecting more frequently.
114 # If you expect the allocator to promtly use an explicitly expanded
115 # heap, this is highly recommended.
120 LIBGC_CFLAGS= -O -DNO_SIGNALS -DSILENT \
121 -DREDIRECT_MALLOC=GC_malloc_uncollectable \
122 -DDONT_ADD_BYTE_AT_END -DALL_INTERIOR_POINTERS
123 # Flags for building libgc.a -- the last two are required.
129 # Redefining srcdir allows object code for the nonPCR version of the collector
130 # to be generated in different directories. In this case, the destination directory
131 # should contain a copy of the original include directory.
135 OBJS= alloc.o reclaim.o allchblk.o misc.o mach_dep.o os_dep.o mark_rts.o headers.o mark.o obj_map.o blacklst.o finalize.o new_hblk.o dbg_mlc.o malloc.o stubborn.o checksums.o solaris_threads.o irix_threads.o linux_threads.o typd_mlc.o ptr_chck.o mallocx.o solaris_pthreads.o
137 CSRCS= reclaim.c allchblk.c misc.c alloc.c mach_dep.c os_dep.c mark_rts.c headers.c mark.c obj_map.c pcr_interface.c blacklst.c finalize.c new_hblk.c real_malloc.c dyn_load.c dbg_mlc.c malloc.c stubborn.c checksums.c solaris_threads.c irix_threads.c linux_threads.c typd_mlc.c ptr_chck.c mallocx.c solaris_pthreads.c
139 CORD_SRCS= cord/cordbscs.c cord/cordxtra.c cord/cordprnt.c cord/de.c cord/cordtest.c cord/cord.h cord/ec.h cord/private/cord_pos.h cord/de_win.c cord/de_win.h cord/de_cmds.h cord/de_win.ICO cord/de_win.RC cord/SCOPTIONS.amiga cord/SMakefile.amiga
141 CORD_OBJS= cord/cordbscs.o cord/cordxtra.o cord/cordprnt.o
143 SRCS= $(CSRCS) mips_sgi_mach_dep.s rs6000_mach_dep.s alpha_mach_dep.s \
144 sparc_mach_dep.s gc.h gc_typed.h gc_hdrs.h gc_priv.h gc_private.h \
145 gcconfig.h gc_mark.h include/gc_inl.h include/gc_inline.h gc.man \
146 threadlibs.c if_mach.c if_not_there.c gc_cpp.cc gc_cpp.h weakpointer.h \
147 gcc_support.c mips_ultrix_mach_dep.s include/gc_alloc.h gc_alloc.h \
148 include/new_gc_alloc.h include/javaxfc.h sparc_sunos4_mach_dep.s \
149 solaris_threads.h $(CORD_SRCS)
151 OTHER_FILES= Makefile PCR-Makefile OS2_MAKEFILE NT_MAKEFILE BCC_MAKEFILE \
152 README test.c test_cpp.cc setjmp_t.c SMakefile.amiga \
153 SCoptions.amiga README.amiga README.win32 cord/README \
154 cord/gc.h include/gc.h include/gc_typed.h include/cord.h \
155 include/ec.h include/private/cord_pos.h include/private/gcconfig.h \
156 include/private/gc_hdrs.h include/private/gc_priv.h \
157 include/gc_cpp.h README.rs6000 \
158 include/weakpointer.h README.QUICK callprocs pc_excludes \
159 barrett_diagram README.OS2 README.Mac MacProjects.sit.hqx \
160 MacOS.c EMX_MAKEFILE makefile.depend README.debugging \
161 include/gc_cpp.h Mac_files/datastart.c Mac_files/dataend.c \
162 Mac_files/MacOS_config.h Mac_files/MacOS_Test_config.h \
163 add_gc_prefix.c README.solaris2 README.sgi README.hp README.uts \
164 win32_threads.c NT_THREADS_MAKEFILE gc.mak README.dj Makefile.dj \
165 README.alpha README.linux version.h Makefile.DLLs gc_watcom.asm \
168 CORD_INCLUDE_FILES= $(srcdir)/gc.h $(srcdir)/cord/cord.h $(srcdir)/cord/ec.h \
169 $(srcdir)/cord/private/cord_pos.h
171 UTILS= if_mach if_not_there threadlibs
173 # Libraries needed for curses applications. Only needed for de.
174 CURSES= -lcurses -ltermlib
176 # The following is irrelevant on most systems. But a few
177 # versions of make otherwise fork the shell specified in
178 # the SHELL environment variable.
182 # Alternative flags to the C compiler for mach_dep.c.
183 # Mach_dep.c often doesn't like optimization, and it's
184 # not time-critical anyway.
185 # Set SPECIALCFLAGS to -q nodirect_code on Encore.
187 #all: checkconf libgc.a gctest
188 all: checkconf libgc.a
190 pcr: PCR-Makefile gc_private.h gc_hdrs.h gc.h gcconfig.h mach_dep.o $(SRCS)
191 make -f PCR-Makefile depend
194 $(OBJS) test.o dyn_load.o dyn_load_sunos53.o: $(srcdir)/gc_priv.h $(srcdir)/gc_hdrs.h $(srcdir)/gc.h \
195 $(srcdir)/gcconfig.h $(srcdir)/gc_typed.h Makefile
196 # The dependency on Makefile is needed. Changing
197 # options such as -DSILENT affects the size of GC_arrays,
198 # invalidating all .o files that rely on gc_priv.h
200 mark.o typd_mlc.o finalize.o: $(srcdir)/gc_mark.h
202 base_lib libgc.a: $(OBJS) dyn_load.o $(UTILS)
204 rm -f on_sparc_sunos5_1
205 $(AR) ru libgc.a $(OBJS) dyn_load.o
206 $(RANLIB) libgc.a || cat /dev/null
207 # ignore ranlib failure; that usually means it doesn't exist, and isn't needed
209 cords: $(CORD_OBJS) cord/cordtest $(UTILS)
210 rm -f on_sparc_sunos5_3
211 $(AR) ru libgc.a $(CORD_OBJS)
212 $(RANLIB) libgc.a || cat /dev/null
214 gc_cpp.o: $(srcdir)/gc_cpp.cc $(srcdir)/gc_cpp.h $(srcdir)/gc.h Makefile
215 $(CXX) -c $(CXXFLAGS) $(srcdir)/gc_cpp.cc
217 test_cpp: $(srcdir)/test_cpp.cc $(srcdir)/gc_cpp.h gc_cpp.o $(srcdir)/gc.h \
220 $(CXX) $(CXXFLAGS) -o test_cpp $(srcdir)/test_cpp.cc gc_cpp.o libgc.a `./threadlibs`
222 c++: gc_cpp.o $(srcdir)/gc_cpp.h test_cpp
223 rm -f on_sparc_sunos5_4
224 $(AR) ru libgc.a gc_cpp.o
225 $(RANLIB) libgc.a || cat /dev/null
229 dyn_load_sunos53.o: dyn_load.c
230 $(CC) $(CFLAGS) -DSUNOS53_SHARED_LIB -c $(srcdir)/dyn_load.c -o $@
232 # SunOS5 shared library version of the collector
233 sunos5gc.so: $(OBJS) dyn_load_sunos53.o
234 $(CC) -G -o sunos5gc.so $(OBJS) dyn_load_sunos53.o -ldl
235 ln sunos5gc.so libgc.so
237 # Alpha/OSF shared library version of the collector
238 libalphagc.so: $(OBJS)
239 ld -shared -o libalphagc.so $(OBJS) dyn_load.o -lc
240 ln libalphagc.so libgc.so
242 # IRIX shared library version of the collector
243 libirixgc.so: $(OBJS) dyn_load.o
244 ld -shared $(ABI_FLAG) -o libirixgc.so $(OBJS) dyn_load.o -lc
245 ln libirixgc.so libgc.so
247 # Linux shared library version of the collector
248 liblinuxgc.so: $(OBJS) dyn_load.o
249 gcc -shared -o liblinuxgc.so $(OBJS) dyn_load.o -lo
250 ln liblinuxgc.so libgc.so
252 mach_dep.o: $(srcdir)/mach_dep.c $(srcdir)/mips_sgi_mach_dep.s $(srcdir)/mips_ultrix_mach_dep.s $(srcdir)/rs6000_mach_dep.s $(UTILS)
254 $(CC) -c $(SPECIALCFLAGS) $(srcdir)/mach_dep.c
256 mark_rts.o: $(srcdir)/mark_rts.c if_mach if_not_there $(UTILS)
258 $(CC) -c $(CFLAGS) $(srcdir)/mark_rts.c
259 # Work-around for DEC optimizer tail recursion elimination bug.
260 # The ALPHA-specific line should be removed if gcc is used.
264 cord/cordbscs.o: $(srcdir)/cord/cordbscs.c $(CORD_INCLUDE_FILES)
265 $(CC) $(CFLAGS) -c $(srcdir)/cord/cordbscs.c
266 mv cordbscs.o cord/cordbscs.o
267 # not all compilers understand -o filename
269 cord/cordxtra.o: $(srcdir)/cord/cordxtra.c $(CORD_INCLUDE_FILES)
270 $(CC) $(CFLAGS) -c $(srcdir)/cord/cordxtra.c
271 mv cordxtra.o cord/cordxtra.o
273 cord/cordprnt.o: $(srcdir)/cord/cordprnt.c $(CORD_INCLUDE_FILES)
274 $(CC) $(CFLAGS) -c $(srcdir)/cord/cordprnt.c
275 mv cordprnt.o cord/cordprnt.o
277 cord/cordtest: $(srcdir)/cord/cordtest.c $(CORD_OBJS) libgc.a $(UTILS)
279 $(CC) $(CFLAGS) -o cord/cordtest $(srcdir)/cord/cordtest.c $(CORD_OBJS) libgc.a `./threadlibs`
281 cord/de: $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o libgc.a $(UTILS)
283 $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o libgc.a $(CURSES) `./threadlibs`
285 if_mach: $(srcdir)/if_mach.c $(srcdir)/gcconfig.h
286 $(CC) $(CFLAGS) -o if_mach $(srcdir)/if_mach.c
288 threadlibs: $(srcdir)/threadlibs.c $(srcdir)/gcconfig.h Makefile
289 $(CC) $(CFLAGS) -o threadlibs $(srcdir)/threadlibs.c
291 if_not_there: $(srcdir)/if_not_there.c
292 $(CC) $(CFLAGS) -o if_not_there $(srcdir)/if_not_there.c
295 rm -f libgc.a *.o gctest gctest_dyn_link test_cpp \
296 setjmp_test mon.out gmon.out a.out core if_not_there if_mach \
297 threadlibs $(CORD_OBJS) cord/cordtest cord/de
300 gctest: test.o libgc.a if_mach if_not_there
302 $(CC) $(CFLAGS) -o gctest test.o libgc.a `./threadlibs`
304 # If an optimized setjmp_test generates a segmentation fault,
305 # odds are your compiler is broken. Gctest may still work.
306 # Try compiling setjmp_t.c unoptimized.
307 setjmp_test: $(srcdir)/setjmp_t.c $(srcdir)/gc.h if_mach if_not_there
308 $(CC) $(CFLAGS) -o setjmp_test $(srcdir)/setjmp_t.c
310 test: KandRtest cord/cordtest
313 # Those tests that work even with a K&R C compiler:
314 KandRtest: setjmp_test gctest
318 add_gc_prefix: add_gc_prefix.c
319 $(CC) -o add_gc_prefix $(srcdir)/add_gc_prefix.c
321 gc.tar: $(SRCS) $(OTHER_FILES) add_gc_prefix
322 ./add_gc_prefix $(SRCS) $(OTHER_FILES) > /tmp/gc.tar-files
323 (cd $(srcdir)/.. ; tar cvfh - `cat /tmp/gc.tar-files`) > gc.tar
325 pc_gc.tar: $(SRCS) $(OTHER_FILES)
326 tar cvfX pc_gc.tar pc_excludes $(SRCS) $(OTHER_FILES)
332 -mmd a:/include/private
334 cat pc_gc.tar | (cd /tmp/pc_gc; tar xvf -)
335 -mcopy -tmn /tmp/pc_gc/* a:
336 -mcopy -tmn /tmp/pc_gc/cord/* a:/cord
337 -mcopy -mn /tmp/pc_gc/cord/de_win.ICO a:/cord
338 -mcopy -tmn /tmp/pc_gc/cord/private/* a:/cord/private
339 -mcopy -tmn /tmp/pc_gc/include/* a:/include
340 -mcopy -tmn /tmp/pc_gc/include/private/* a:/include/private
349 lint: $(CSRCS) test.c
350 lint -DLINT $(CSRCS) test.c | egrep -v "possible pointer alignment problem|abort|exit|sbrk|mprotect|syscall"
352 # BTL: added to test shared library version of collector.
353 # Currently works only under SunOS5. Requires GC_INIT call from statically
354 # loaded client code.
356 gctest_dyn_link: test.o libgc.so
357 $(CC) -L$(ABSDIR) -R$(ABSDIR) -o gctest_dyn_link test.o -lgc -ldl -lthread
359 gctest_irix_dyn_link: test.o libirixgc.so
360 $(CC) -L$(ABSDIR) -o gctest_irix_dyn_link test.o -lirixgc
362 test_dll.o: test.c libgc_globals.h
363 $(CC) $(CFLAGS) -DGC_USE_DLL -c test.c -o test_dll.o
365 test_dll: test_dll.o libgc_dll.a libgc.dll
366 $(CC) test_dll.o -L$(ABSDIR) -lgc_dll -o test_dll
370 # Uncomment the following line to build a GNU win32 DLL
371 # include Makefile.DLLs
373 reserved_namespace: $(SRCS)
374 for file in $(SRCS) test.c test_cpp.cc; do \
375 sed s/GC_/_GC_/g < $$file > tmp; \
379 user_namespace: $(SRCS)
380 for file in $(SRCS) test.c test_cpp.cc; do \
381 sed s/_GC_/GC_/g < $$file > tmp; \
385 # Remake configuration
387 @if [ -f $(srcdir)/../devel ]; then \
388 $(MAKE) -f $(srcdir)/conf.mk freshconf \
389 srcdir="$(srcdir)" PRJDIR="$(PRJDIR)"; \