2010-10-29 Paolo Bonzini <bonzini@gnu.org>
[official-gcc.git] / boehm-gc / Makefile.dist
blob20fa40a9a08ce365de46adbf440afbec2560bee6
1 # This is the original manually generated Makefile.  It may still be used
2 # to build the collector.
4 # Primary targets:
5 # gc.a - builds basic library
6 # c++ - adds C++ interface to library
7 # cords - adds cords (heavyweight strings) to library
8 # test - prints porting information, then builds basic version of gc.a,
9 #        and runs some tests of collector and cords.  Does not add cords or
10 #        c++ interface to gc.a
11 # cord/de - builds dumb editor based on cords.
12 ABI_FLAG= 
13 # ABI_FLAG should be the cc flag that specifies the ABI.  On most
14 # platforms this will be the empty string.  Possible values:
15 # +DD64 for 64-bit executable on HP/UX.
16 # -n32, -n64, -o32 for SGI/MIPS ABIs.
18 AS_ABI_FLAG=$(ABI_FLAG)
19 # ABI flag for assembler.  On HP/UX this is +A64 for 64 bit
20 # executables.
22 CC=cc $(ABI_FLAG)
23 CXX=g++ $(ABI_FLAG)
24 AS=as $(AS_ABI_FLAG)
25 #  The above doesn't work with gas, which doesn't run cpp.
26 #  Define AS as `gcc -c -x assembler-with-cpp' instead.
28 # Redefining srcdir allows object code for the nonPCR version of the collector
29 # to be generated in different directories.
30 srcdir= .
31 VPATH= $(srcdir)
33 CFLAGS= -O -I$(srcdir)/include -DATOMIC_UNCOLLECTABLE -DNO_SIGNALS -DNO_EXECUTE_PERMISSION -DSILENT -DALL_INTERIOR_POINTERS
35 # To build the parallel collector on Linux, add to the above:
36 # -DGC_LINUX_THREADS -DPARALLEL_MARK -DTHREAD_LOCAL_ALLOC
37 # To build the parallel collector in a static library on HP/UX,
38 # add to the above:
39 # -DGC_HPUX_THREADS -DPARALLEL_MARK -DTHREAD_LOCAL_ALLOC -D_POSIX_C_SOURCE=199506L
40 # To build the thread-safe collector on Tru64, add to the above:
41 # -pthread -DGC_OSF1_THREADS
43 # HOSTCC and HOSTCFLAGS are used to build executables that will be run as
44 # part of the build process, i.e. on the build machine.  These will usually
45 # be the same as CC and CFLAGS, except in a cross-compilation environment.
46 # Note that HOSTCFLAGS should include any -D flags that affect thread support.
47 HOSTCC=$(CC)
48 HOSTCFLAGS=$(CFLAGS)
50 # For dynamic library builds, it may be necessary to add flags to generate
51 # PIC code, e.g. -fPIC on Linux.
53 # Setjmp_test may yield overly optimistic results when compiled
54 # without optimization.
56 # These define arguments influence the collector configuration:
57 # -DSILENT disables statistics printing, and improves performance.
58 # -DFIND_LEAK causes GC_find_leak to be initially set.
59 #   This causes the collector to assume that all inaccessible
60 #   objects should have been explicitly deallocated, and reports exceptions.
61 #   Finalization and the test program are not usable in this mode.
62 # -DGC_SOLARIS_THREADS enables support for Solaris (thr_) threads.
63 #   (Clients should also define GC_SOLARIS_THREADS and then include
64 #   gc.h before performing thr_ or dl* or GC_ operations.)
65 #   Must also define -D_REENTRANT.
66 # -DGC_SOLARIS_PTHREADS enables support for Solaris pthreads.
67 #   (Internally this define GC_SOLARIS_THREADS as well.)
68 # -DGC_IRIX_THREADS enables support for Irix pthreads.  See README.irix.
69 # -DGC_HPUX_THREADS enables support for HP/UX 11 pthreads.
70 #   Also requires -D_REENTRANT or -D_POSIX_C_SOURCE=199506L. See README.hp.
71 # -DGC_LINUX_THREADS enables support for Xavier Leroy's Linux threads.
72 #   see README.linux.  -D_REENTRANT may also be required.
73 # -DGC_OSF1_THREADS enables support for Tru64 pthreads.  Untested.
74 # -DGC_FREEBSD_THREADS enables support for FreeBSD pthreads.  Untested.
75 #   Appeared to run into some underlying thread problems.
76 # -DGC_DARWIN_THREADS enables support for Mac OS X pthreads.  Untested.
77 # -DGC_DGUX386_THREADS enables support for DB/UX on I386 threads.
78 #   See README.DGUX386.
79 # -DGC_WIN32_THREADS enables support for win32 threads.  That makes sense
80 #   for this Makefile only under Cygwin.
81 # -DGC_THREADS should set the appropriate one of the above macros.
82 #   It assumes pthreads for Solaris.
83 # -DALL_INTERIOR_POINTERS allows all pointers to the interior
84 #   of objects to be recognized.  (See gc_priv.h for consequences.)
85 #   Alternatively, GC_all_interior_pointers can be set at process
86 #   initialization time.
87 # -DSMALL_CONFIG tries to tune the collector for small heap sizes,
88 #   usually causing it to use less space in such situations.
89 #   Incremental collection no longer works in this case.
90 # -DLARGE_CONFIG tunes the collector for unusually large heaps.
91 #   Necessary for heaps larger than about 500 MB on most machines.
92 #   Recommended for heaps larger than about 64 MB.
93 # -DDONT_ADD_BYTE_AT_END is meaningful only with -DALL_INTERIOR_POINTERS or
94 #   GC_all_interior_pointers = 1.  Normally -DALL_INTERIOR_POINTERS
95 #   causes all objects to be padded so that pointers just past the end of
96 #   an object can be recognized.  This can be expensive.  (The padding
97 #   is normally more than one byte due to alignment constraints.)
98 #   -DDONT_ADD_BYTE_AT_END disables the padding.
99 # -DNO_SIGNALS does not disable signals during critical parts of
100 #   the GC process.  This is no less correct than many malloc 
101 #   implementations, and it sometimes has a significant performance
102 #   impact.  However, it is dangerous for many not-quite-ANSI C
103 #   programs that call things like printf in asynchronous signal handlers.
104 #   This is on by default.  Turning it off has not been extensively tested with
105 #   compilers that reorder stores.  It should have been.
106 # -DNO_EXECUTE_PERMISSION may cause some or all of the heap to not
107 #   have execute permission, i.e. it may be impossible to execute
108 #   code from the heap.  Currently this only affects the incremental
109 #   collector on UNIX machines.  It may greatly improve its performance,
110 #   since this may avoid some expensive cache synchronization.
111 # -DGC_NO_OPERATOR_NEW_ARRAY declares that the C++ compiler does not support
112 #   the  new syntax "operator new[]" for allocating and deleting arrays.
113 #   See gc_cpp.h for details.  No effect on the C part of the collector.
114 #   This is defined implicitly in a few environments.  Must also be defined
115 #   by clients that use gc_cpp.h.
116 # -DREDIRECT_MALLOC=X causes malloc to be defined as alias for X.
117 #   Unless the following macros are defined, realloc is also redirected
118 #   to GC_realloc, and free is redirected to GC_free.
119 #   Calloc and strdup are redefined in terms of the new malloc.  X should
120 #   be either GC_malloc or GC_malloc_uncollectable, or
121 #   GC_debug_malloc_replacement.  (The latter invokes GC_debug_malloc
122 #   with dummy source location information, but still results in
123 #   properly remembered call stacks on Linux/X86 and Solaris/SPARC.
124 #   It requires that the following two macros also be used.)
125 #   The former is occasionally useful for working around leaks in code
126 #   you don't want to (or can't) look at.  It may not work for
127 #   existing code, but it often does.  Neither works on all platforms,
128 #   since some ports use malloc or calloc to obtain system memory.
129 #   (Probably works for UNIX, and win32.)  If you build with DBG_HDRS_ALL,
130 #   you should only use GC_debug_malloc_replacement as a malloc
131 #   replacement.
132 # -DREDIRECT_REALLOC=X causes GC_realloc to be redirected to X.
133 #   The canonical use is -DREDIRECT_REALLOC=GC_debug_realloc_replacement,
134 #   together with -DREDIRECT_MALLOC=GC_debug_malloc_replacement to
135 #   generate leak reports with call stacks for both malloc and realloc.
136 #   This also requires the following:
137 # -DREDIRECT_FREE=X causes free to be redirected to X.  The
138 #   canonical use is -DREDIRECT_FREE=GC_debug_free.
139 # -DIGNORE_FREE turns calls to free into a noop.  Only useful with
140 #   -DREDIRECT_MALLOC.
141 # -DNO_DEBUGGING removes GC_dump and the debugging routines it calls.
142 #   Reduces code size slightly at the expense of debuggability.
143 # -DJAVA_FINALIZATION makes it somewhat safer to finalize objects out of
144 #   order by specifying a nonstandard finalization mark procedure  (see
145 #   finalize.c).  Objects reachable from finalizable objects will be marked
146 #   in a sepearte postpass, and hence their memory won't be reclaimed.
147 #   Not recommended unless you are implementing a language that specifies
148 #   these semantics.  Since 5.0, determines only only the initial value
149 #   of GC_java_finalization variable.
150 # -DFINALIZE_ON_DEMAND causes finalizers to be run only in response
151 #   to explicit GC_invoke_finalizers() calls.
152 #   In 5.0 this became runtime adjustable, and this only determines the
153 #   initial value of GC_finalize_on_demand.
154 # -DATOMIC_UNCOLLECTABLE includes code for GC_malloc_atomic_uncollectable.
155 #   This is useful if either the vendor malloc implementation is poor,
156 #   or if REDIRECT_MALLOC is used.
157 # -DHBLKSIZE=ddd, where ddd is a power of 2 between 512 and 16384, explicitly
158 #   sets the heap block size.  Each heap block is devoted to a single size and
159 #   kind of object.  For the incremental collector it makes sense to match
160 #   the most likely page size.  Otherwise large values result in more
161 #   fragmentation, but generally better performance for large heaps.
162 # -DUSE_MMAP use MMAP instead of sbrk to get new memory.
163 #   Works for Solaris and Irix.
164 # -DUSE_MUNMAP causes memory to be returned to the OS under the right
165 #   circumstances.  This currently disables VM-based incremental collection.
166 #   This is currently experimental, and works only under some Unix,
167 #   Linux and Windows versions.
168 # -DMMAP_STACKS (for Solaris threads) Use mmap from /dev/zero rather than
169 #   GC_scratch_alloc() to get stack memory.
170 # -DPRINT_BLACK_LIST Whenever a black list entry is added, i.e. whenever
171 #   the garbage collector detects a value that looks almost, but not quite,
172 #   like a pointer, print both the address containing the value, and the
173 #   value of the near-bogus-pointer.  Can be used to identifiy regions of
174 #   memory that are likely to contribute misidentified pointers.
175 # -DKEEP_BACK_PTRS Add code to save back pointers in debugging headers
176 #   for objects allocated with the debugging allocator.  If all objects
177 #   through GC_MALLOC with GC_DEBUG defined, this allows the client
178 #   to determine how particular or randomly chosen objects are reachable
179 #   for debugging/profiling purposes.  The gc_backptr.h interface is
180 #   implemented only if this is defined.
181 # -DGC_ASSERTIONS Enable some internal GC assertion checking.  Currently
182 #   this facility is only used in a few places.  It is intended primarily
183 #   for debugging of the garbage collector itself, but could also
184 # -DDBG_HDRS_ALL Make sure that all objects have debug headers.  Increases
185 #   the reliability (from 99.9999% to 100% mod. bugs) of some of the debugging
186 #   code (especially KEEP_BACK_PTRS).  Makes -DSHORT_DBG_HDRS possible.
187 #   Assumes that all client allocation is done through debugging
188 #   allocators.
189 # -DSHORT_DBG_HDRS Assume that all objects have debug headers.  Shorten
190 #   the headers to minimize object size, at the expense of checking for
191 #   writes past the end of an object.  This is intended for environments
192 #   in which most client code is written in a "safe" language, such as
193 #   Scheme or Java.  Assumes that all client allocation is done using
194 #   the GC_debug_ functions, or through the macros that expand to these,
195 #   or by redirecting malloc to GC_debug_malloc_replacement.
196 #   (Also eliminates the field for the requested object size.)
197 #   occasionally be useful for debugging of client code.  Slows down the
198 #   collector somewhat, but not drastically.
199 # -DSAVE_CALL_COUNT=<n> Set the number of call frames saved with objects
200 #   allocated through the debugging interface.  Affects the amount of
201 #   information generated in leak reports.  Only matters on platforms
202 #   on which we can quickly generate call stacks, currently Linux/(X86 & SPARC)
203 #   and Solaris/SPARC and platforms that provide execinfo.h.
204 #   Default is zero.  On X86, client
205 #   code should NOT be compiled with -fomit-frame-pointer.
206 # -DSAVE_CALL_NARGS=<n> Set the number of functions arguments to be
207 #   saved with each call frame.  Default is zero.  Ignored if we
208 #   don't know how to retrieve arguments on the platform.
209 # -DCHECKSUMS reports on erroneously clear dirty bits, and unexpectedly
210 #   altered stubborn objects, at substantial performance cost.
211 #   Use only for debugging of the incremental collector.
212 # -DGC_GCJ_SUPPORT includes support for gcj (and possibly other systems
213 #   that include a pointer to a type descriptor in each allocated object).
214 #   Building this way requires an ANSI C compiler.
215 # -DUSE_I686_PREFETCH causes the collector to issue Pentium III style
216 #   prefetch instructions.  No effect except on X86 Linux platforms.
217 #   Assumes a very recent gcc-compatible compiler and assembler.
218 #   (Gas prefetcht0 support was added around May 1999.)
219 #   Empirically the code appears to still run correctly on Pentium II
220 #   processors, though with no performance benefit.  May not run on other
221 #   X86 processors?  In some cases this improves performance by
222 #   15% or so.
223 # -DUSE_3DNOW_PREFETCH causes the collector to issue AMD 3DNow style
224 #   prefetch instructions.  Same restrictions as USE_I686_PREFETCH.
225 #   Minimally tested.  Didn't appear to be an obvious win on a K6-2/500.
226 # -DUSE_PPC_PREFETCH causes the collector to issue PowerPC style
227 #   prefetch instructions.  No effect except on PowerPC OS X platforms.
228 #   Performance impact untested.
229 # -DGC_USE_LD_WRAP in combination with the old flags listed in README.linux
230 #   causes the collector some system and pthread calls in a more transparent
231 #   fashion than the usual macro-based approach.  Requires GNU ld, and
232 #   currently probably works only with Linux.
233 # -DTHREAD_LOCAL_ALLOC defines GC_local_malloc(), GC_local_malloc_atomic()
234 #   and GC_local_gcj_malloc().  Needed for gc_gcj.h interface.  These allocate
235 #   in a way that usually does not involve acquisition of a global lock.
236 #   Currently requires -DGC_LINUX_THREADS, but should be easy to port to
237 #   other pthreads environments.  Recommended for multiprocessors.
238 # -DUSE_COMPILER_TLS causes thread local allocation to use compiler-supported
239 #   "__thread" thread-local variables.  This is the default in HP/UX.  It
240 #   may help performance on recent Linux installations.  (It failed for
241 #   me on RedHat 8, but appears to work on RedHat 9.)
242 # -DPARALLEL_MARK allows the marker to run in multiple threads.  Recommended
243 #   for multiprocessors.  Currently requires Linux on X86 or IA64, though
244 #   support for other Posix platforms should be fairly easy to add,
245 #   if the thread implementation is otherwise supported.
246 # -DNO_GETENV prevents the collector from looking at environment variables.
247 #   These may otherwise alter its configuration, or turn off GC altogether.
248 #   I don't know of a reason to disable this, except possibly if the
249 #   resulting process runs as a privileged user?
250 # -DUSE_GLOBAL_ALLOC.  Win32 only.  Use GlobalAlloc instead of
251 #   VirtualAlloc to allocate the heap.  May be needed to work around
252 #   a Windows NT/2000 issue.  Incompatible with USE_MUNMAP.
253 #   See README.win32 for details.
254 # -DMAKE_BACK_GRAPH. Enable GC_PRINT_BACK_HEIGHT environment variable.
255 #   See README.environment for details.  Experimental. Limited platform
256 #   support.  Implies DBG_HDRS_ALL.  All allocation should be done using
257 #   the debug interface.
258 # -DSTUBBORN_ALLOC allows allocation of "hard to change" objects, and thus
259 #   makes incremental collection easier.  Was enabled by default until 6.0.
260 #   Rarely used, to my knowledge.
261 # -DHANDLE_FORK attempts to make GC_malloc() work in a child process fork()ed
262 #   from a multithreaded parent.  Currently only supported by pthread_support.c.
263 #   (Similar code should work on Solaris or Irix, but it hasn't been tried.)
264 # -DTEST_WITH_SYSTEM_MALLOC causes gctest to allocate (and leak) large chunks
265 #   of memory with the standard system malloc.  This will cause the root
266 #   set and collected heap to grow significantly if malloced memory is
267 #   somehow getting traced by the collector.  This has no impact on the
268 #   generated library; it only affects the test.
269 # -DPOINTER_MASK=0x... causes candidate pointers to be ANDed with the
270 #   given mask before being considered.  If either this or the following
271 #   macro is defined, it will be assumed that all pointers stored in
272 #   the heap need to be processed this way.  Stack and register pointers
273 #   will be considered both with and without processing.
274 #   These macros are normally needed only to support systems that use
275 #   high-order pointer tags. EXPERIMENTAL.
276 # -DPOINTER_SHIFT=n causes the collector to left shift candidate pointers
277 #   by the indicated amount before trying to interpret them.  Applied
278 #   after POINTER_MASK. EXPERIMENTAL.  See also the preceding macro.
281 CXXFLAGS= $(CFLAGS) 
282 AR= ar
283 RANLIB= ranlib
286 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 aix_irix_threads.o pthread_support.o pthread_stop_world.o darwin_stop_world.o typd_mlc.o ptr_chck.o mallocx.o solaris_pthreads.o gcj_mlc.o specific.o gc_dlopen.o backgraph.o win32_threads.o
288 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 aix_irix_threads.c pthread_support.c pthread_stop_world.c darwin_stop_world.c typd_mlc.c ptr_chck.c mallocx.c solaris_pthreads.c gcj_mlc.c specific.c gc_dlopen.c backgraph.c win32_threads.c
290 CORD_SRCS=  cord/cordbscs.c cord/cordxtra.c cord/cordprnt.c cord/de.c cord/cordtest.c include/cord.h include/ec.h include/private/cord_pos.h cord/de_win.c cord/de_win.h cord/de_cmds.h cord/de_win.ICO cord/de_win.RC
292 CORD_OBJS=  cord/cordbscs.o cord/cordxtra.o cord/cordprnt.o
294 SRCS= $(CSRCS) mips_sgi_mach_dep.s rs6000_mach_dep.s alpha_mach_dep.S \
295     sparc_mach_dep.S include/gc.h include/gc_typed.h \
296     include/private/gc_hdrs.h include/private/gc_priv.h \
297     include/private/gcconfig.h include/private/gc_pmark.h \
298     include/gc_inl.h include/gc_inline.h include/gc_mark.h \
299     threadlibs.c if_mach.c if_not_there.c gc_cpp.cc include/gc_cpp.h \
300     gcname.c include/weakpointer.h include/private/gc_locks.h \
301     gcc_support.c mips_ultrix_mach_dep.s include/gc_alloc.h \
302     include/new_gc_alloc.h include/gc_allocator.h \
303     include/javaxfc.h sparc_sunos4_mach_dep.s sparc_netbsd_mach_dep.s \
304     include/private/solaris_threads.h include/gc_backptr.h \
305     hpux_test_and_clear.s include/gc_gcj.h \
306     include/gc_local_alloc.h include/private/dbg_mlc.h \
307     include/private/specific.h powerpc_darwin_mach_dep.s \
308     include/leak_detector.h include/gc_amiga_redirects.h \
309     include/gc_pthread_redirects.h ia64_save_regs_in_stack.s \
310     include/gc_config_macros.h include/private/pthread_support.h \
311     include/private/pthread_stop_world.h include/private/darwin_semaphore.h \
312     include/private/darwin_stop_world.h $(CORD_SRCS)
314 DOC_FILES= README.QUICK doc/README.Mac doc/README.MacOSX doc/README.OS2 \
315         doc/README.amiga doc/README.cords doc/debugging.html \
316         doc/README.dj doc/README.hp doc/README.linux doc/README.rs6000 \
317         doc/README.sgi doc/README.solaris2 doc/README.uts \
318         doc/README.win32 doc/barrett_diagram doc/README \
319         doc/README.contributors doc/README.changes doc/gc.man \
320         doc/README.environment doc/tree.html doc/gcdescr.html \
321         doc/README.autoconf doc/README.macros doc/README.ews4800 \
322         doc/README.DGUX386 doc/README.arm.cross doc/leak.html \
323         doc/scale.html doc/gcinterface.html doc/README.darwin \
324         doc/simple_example.html
326 TESTS= tests/test.c tests/test_cpp.cc tests/trace_test.c \
327         tests/leak_test.c tests/thread_leak_test.c tests/middle.c
329 GNU_BUILD_FILES= configure.in Makefile.am configure acinclude.m4 \
330                  libtool.m4 install-sh configure.host Makefile.in \
331                  aclocal.m4 config.sub config.guess \
332                  include/Makefile.am include/Makefile.in \
333                  doc/Makefile.am doc/Makefile.in \
334                  ltmain.sh mkinstalldirs depcomp missing
336 OTHER_MAKEFILES= OS2_MAKEFILE NT_MAKEFILE NT_THREADS_MAKEFILE gc.mak \
337                  BCC_MAKEFILE EMX_MAKEFILE WCC_MAKEFILE Makefile.dj \
338                  PCR-Makefile SMakefile.amiga Makefile.DLLs \
339                  digimars.mak Makefile.direct NT_STATIC_THREADS_MAKEFILE
340 #       Makefile and Makefile.direct are copies of each other.
342 OTHER_FILES= Makefile setjmp_t.c callprocs pc_excludes \
343            MacProjects.sit.hqx MacOS.c \
344            Mac_files/datastart.c Mac_files/dataend.c \
345            Mac_files/MacOS_config.h Mac_files/MacOS_Test_config.h \
346            add_gc_prefix.c gc_cpp.cpp \
347            version.h AmigaOS.c \
348            $(TESTS) $(GNU_BUILD_FILES) $(OTHER_MAKEFILES)
350 CORD_INCLUDE_FILES= $(srcdir)/include/gc.h $(srcdir)/include/cord.h \
351         $(srcdir)/include/ec.h $(srcdir)/include/private/cord_pos.h
353 UTILS= if_mach if_not_there threadlibs
355 # Libraries needed for curses applications.  Only needed for de.
356 CURSES= -lcurses -ltermlib
358 # The following is irrelevant on most systems.  But a few
359 # versions of make otherwise fork the shell specified in
360 # the SHELL environment variable.
361 SHELL= /bin/sh
363 SPECIALCFLAGS = -I$(srcdir)/include
364 # Alternative flags to the C compiler for mach_dep.c.
365 # Mach_dep.c often doesn't like optimization, and it's
366 # not time-critical anyway.
367 # Set SPECIALCFLAGS to -q nodirect_code on Encore.
369 all: gc.a gctest
371 LEAKFLAGS=$(CFLAGS) -DFIND_LEAK
373 BSD-pkg-all: bsd-libgc.a bsd-libleak.a
375 bsd-libgc.a:
376         $(MAKE) CFLAGS="$(CFLAGS)" clean c++-t
377         mv gc.a bsd-libgc.a
379 bsd-libleak.a:
380         $(MAKE) -f Makefile.direct CFLAGS="$(LEAKFLAGS)" clean c++-nt
381         mv gc.a bsd-libleak.a
383 BSD-pkg-install: BSD-pkg-all
384         ${CP} bsd-libgc.a libgc.a
385         ${INSTALL_DATA} libgc.a ${PREFIX}/lib
386         ${INSTALL_DATA} gc.h gc_cpp.h ${PREFIX}/include
387         ${INSTALL_MAN} doc/gc.man ${PREFIX}/man/man3/gc.3
389 pcr: PCR-Makefile include/private/gc_private.h include/private/gc_hdrs.h \
390 include/private/gc_locks.h include/gc.h include/private/gcconfig.h \
391 mach_dep.o $(SRCS)
392         $(MAKE) -f PCR-Makefile depend
393         $(MAKE) -f PCR-Makefile
395 $(OBJS) tests/test.o dyn_load.o dyn_load_sunos53.o: \
396     $(srcdir)/include/private/gc_priv.h \
397     $(srcdir)/include/private/gc_hdrs.h $(srcdir)/include/private/gc_locks.h \
398     $(srcdir)/include/gc.h $(srcdir)/include/gc_pthread_redirects.h \
399     $(srcdir)/include/private/gcconfig.h $(srcdir)/include/gc_typed.h \
400     $(srcdir)/include/gc_config_macros.h Makefile
401 # The dependency on Makefile is needed.  Changing
402 # options such as -DSILENT affects the size of GC_arrays,
403 # invalidating all .o files that rely on gc_priv.h
405 mark.o typd_mlc.o finalize.o ptr_chck.o: $(srcdir)/include/gc_mark.h $(srcdir)/include/private/gc_pmark.h
407 specific.o pthread_support.o: $(srcdir)/include/private/specific.h
409 solaris_threads.o solaris_pthreads.o: $(srcdir)/include/private/solaris_threads.h
411 dbg_mlc.o gcj_mlc.o: $(srcdir)/include/private/dbg_mlc.h
413 tests/test.o: tests $(srcdir)/tests/test.c
414         $(CC) $(CFLAGS) -c $(srcdir)/tests/test.c
415         mv test.o tests/test.o
417 tests:
418         mkdir tests
420 base_lib gc.a: $(OBJS) dyn_load.o $(UTILS)
421         echo > base_lib
422         rm -f dont_ar_1
423         ./if_mach SPARC SUNOS5 touch dont_ar_1
424         ./if_mach SPARC SUNOS5 $(AR) rus gc.a $(OBJS) dyn_load.o
425         ./if_mach M68K AMIGA touch dont_ar_1
426         ./if_mach M68K AMIGA $(AR) -vrus gc.a $(OBJS) dyn_load.o
427         ./if_not_there dont_ar_1 $(AR) ru gc.a $(OBJS) dyn_load.o
428         ./if_not_there dont_ar_1 $(RANLIB) gc.a || cat /dev/null
429 #       ignore ranlib failure; that usually means it doesn't exist, and isn't needed
431 cords: $(CORD_OBJS) cord/cordtest $(UTILS)
432         rm -f dont_ar_3
433         ./if_mach SPARC SUNOS5 touch dont_ar_3
434         ./if_mach SPARC SUNOS5 $(AR) rus gc.a $(CORD_OBJS)
435         ./if_mach M68K AMIGA touch dont_ar_3
436         ./if_mach M68K AMIGA $(AR) -vrus gc.a $(CORD_OBJS)
437         ./if_not_there dont_ar_3 $(AR) ru gc.a $(CORD_OBJS)
438         ./if_not_there dont_ar_3 $(RANLIB) gc.a || cat /dev/null
440 gc_cpp.o: $(srcdir)/gc_cpp.cc $(srcdir)/include/gc_cpp.h $(srcdir)/include/gc.h Makefile
441         $(CXX) -c $(CXXFLAGS) $(srcdir)/gc_cpp.cc
443 test_cpp: $(srcdir)/tests/test_cpp.cc $(srcdir)/include/gc_cpp.h gc_cpp.o $(srcdir)/include/gc.h \
444 base_lib $(UTILS)
445         rm -f test_cpp
446         ./if_mach HP_PA HPUX $(CXX) $(CXXFLAGS) -o test_cpp $(srcdir)/tests/test_cpp.cc gc_cpp.o gc.a -ldld `./threadlibs`
447         ./if_not_there test_cpp $(CXX) $(CXXFLAGS) -o test_cpp $(srcdir)/tests/test_cpp.cc gc_cpp.o gc.a `./threadlibs`
449 c++-t: c++
450         ./test_cpp 1
452 c++-nt: c++
453         @echo "Use ./test_cpp 1 to test the leak library"
455 c++: gc_cpp.o $(srcdir)/include/gc_cpp.h test_cpp
456         rm -f dont_ar_4
457         ./if_mach SPARC SUNOS5 touch dont_ar_4
458         ./if_mach SPARC SUNOS5 $(AR) rus gc.a gc_cpp.o
459         ./if_mach M68K AMIGA touch dont_ar_4
460         ./if_mach M68K AMIGA $(AR) -vrus gc.a gc_cpp.o
461         ./if_not_there dont_ar_4 $(AR) ru gc.a gc_cpp.o
462         ./if_not_there dont_ar_4 $(RANLIB) gc.a || cat /dev/null
463         ./test_cpp 1
464         echo > c++
466 dyn_load_sunos53.o: dyn_load.c
467         $(CC) $(CFLAGS) -DSUNOS53_SHARED_LIB -c $(srcdir)/dyn_load.c -o $@
469 # SunOS5 shared library version of the collector
470 sunos5gc.so: $(OBJS) dyn_load_sunos53.o
471         $(CC) -G -o sunos5gc.so $(OBJS) dyn_load_sunos53.o -ldl
472         ln sunos5gc.so libgc.so
474 # Alpha/OSF shared library version of the collector
475 libalphagc.so: $(OBJS)
476         ld -shared -o libalphagc.so $(OBJS) dyn_load.o -lc
477         ln libalphagc.so libgc.so
479 # IRIX shared library version of the collector
480 libirixgc.so: $(OBJS) dyn_load.o
481         ld -shared $(ABI_FLAG) -o libirixgc.so $(OBJS) dyn_load.o -lc
482         ln libirixgc.so libgc.so
484 # Linux shared library version of the collector
485 liblinuxgc.so: $(OBJS) dyn_load.o
486         gcc -shared -o liblinuxgc.so $(OBJS) dyn_load.o
487         ln liblinuxgc.so libgc.so
489 # Alternative Linux rule.  This is preferable, but is likely to break the
490 # Makefile for some non-linux platforms.
491 # LIBOBJS= $(patsubst %.o, %.lo, $(OBJS))
493 #.SUFFIXES: .lo $(SUFFIXES)
495 #.c.lo:
496 #       $(CC) $(CFLAGS) $(CPPFLAGS) -fPIC -c $< -o $@
498 # liblinuxgc.so: $(LIBOBJS) dyn_load.lo
499 #       gcc -shared -Wl,-soname=libgc.so.0 -o libgc.so.0 $(LIBOBJS) dyn_load.lo
500 #       touch liblinuxgc.so
502 mach_dep.o: $(srcdir)/mach_dep.c $(srcdir)/mips_sgi_mach_dep.s \
503             $(srcdir)/mips_ultrix_mach_dep.s \
504             $(srcdir)/rs6000_mach_dep.s $(srcdir)/powerpc_darwin_mach_dep.s \
505             $(srcdir)/sparc_mach_dep.S $(srcdir)/sparc_sunos4_mach_dep.s \
506             $(srcdir)/ia64_save_regs_in_stack.s \
507             $(srcdir)/sparc_netbsd_mach_dep.s $(UTILS)
508         rm -f mach_dep.o
509         ./if_mach MIPS IRIX5 $(CC) -c -o mach_dep.o $(srcdir)/mips_sgi_mach_dep.s
510         ./if_mach MIPS RISCOS $(AS) -o mach_dep.o $(srcdir)/mips_ultrix_mach_dep.s
511         ./if_mach MIPS ULTRIX $(AS) -o mach_dep.o $(srcdir)/mips_ultrix_mach_dep.s
512         ./if_mach POWERPC DARWIN $(AS) -o mach_dep.o $(srcdir)/powerpc_darwin_mach_dep.s
513         ./if_mach ALPHA LINUX $(CC) -c -o mach_dep.o $(srcdir)/alpha_mach_dep.S
514         ./if_mach SPARC SUNOS5 $(CC) -c -o mach_dep.o $(srcdir)/sparc_mach_dep.S
515         ./if_mach SPARC SUNOS4 $(AS) -o mach_dep.o $(srcdir)/sparc_sunos4_mach_dep.s
516         ./if_mach SPARC OPENBSD $(AS) -o mach_dep.o $(srcdir)/sparc_sunos4_mach_dep.s
517         ./if_mach SPARC NETBSD $(AS) -o mach_dep.o $(srcdir)/sparc_netbsd_mach_dep.s
518         ./if_mach IA64 "" as $(AS_ABI_FLAG) -o ia64_save_regs_in_stack.o $(srcdir)/ia64_save_regs_in_stack.s
519         ./if_mach IA64 "" $(CC) -c -o mach_dep1.o $(SPECIALCFLAGS) $(srcdir)/mach_dep.c
520         ./if_mach IA64 "" ld -r -o mach_dep.o mach_dep1.o ia64_save_regs_in_stack.o
521         ./if_not_there mach_dep.o $(CC) -c $(SPECIALCFLAGS) $(srcdir)/mach_dep.c
523 mark_rts.o: $(srcdir)/mark_rts.c $(UTILS)
524         rm -f mark_rts.o
525         -./if_mach ALPHA OSF1 $(CC) -c $(CFLAGS) -Wo,-notail $(srcdir)/mark_rts.c
526         ./if_not_there mark_rts.o $(CC) -c $(CFLAGS) $(srcdir)/mark_rts.c
527 #       Work-around for DEC optimizer tail recursion elimination bug.
528 #  The ALPHA-specific line should be removed if gcc is used.
530 alloc.o: version.h
532 cord:
533         mkdir cord
535 cord/cordbscs.o: cord $(srcdir)/cord/cordbscs.c $(CORD_INCLUDE_FILES)
536         $(CC) $(CFLAGS) -c -I$(srcdir) $(srcdir)/cord/cordbscs.c
537         mv cordbscs.o cord/cordbscs.o
538 #  not all compilers understand -o filename
540 cord/cordxtra.o: cord $(srcdir)/cord/cordxtra.c $(CORD_INCLUDE_FILES)
541         $(CC) $(CFLAGS) -c -I$(srcdir) $(srcdir)/cord/cordxtra.c
542         mv cordxtra.o cord/cordxtra.o
544 cord/cordprnt.o: cord $(srcdir)/cord/cordprnt.c $(CORD_INCLUDE_FILES)
545         $(CC) $(CFLAGS) -c -I$(srcdir) $(srcdir)/cord/cordprnt.c
546         mv cordprnt.o cord/cordprnt.o
548 cord/cordtest: $(srcdir)/cord/cordtest.c $(CORD_OBJS) gc.a $(UTILS)
549         rm -f cord/cordtest
550         ./if_mach SPARC DRSNX $(CC) $(CFLAGS) -o cord/cordtest $(srcdir)/cord/cordtest.c $(CORD_OBJS) gc.a -lucb
551         ./if_mach HP_PA HPUX $(CC) $(CFLAGS) -o cord/cordtest $(srcdir)/cord/cordtest.c $(CORD_OBJS) gc.a -ldld `./threadlibs`
552         ./if_mach M68K AMIGA $(CC) $(CFLAGS) -UGC_AMIGA_MAKINGLIB -o cord/cordtest $(srcdir)/cord/cordtest.c $(CORD_OBJS) gc.a `./threadlibs`
553         ./if_not_there cord/cordtest $(CC) $(CFLAGS) -o cord/cordtest $(srcdir)/cord/cordtest.c $(CORD_OBJS) gc.a `./threadlibs`
555 cord/de: $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a $(UTILS)
556         rm -f cord/de
557         ./if_mach SPARC DRSNX $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a $(CURSES) -lucb `./threadlibs`
558         ./if_mach HP_PA HPUX $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a $(CURSES) -ldld `./threadlibs`
559         ./if_mach RS6000 "" $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a -lcurses
560         ./if_mach POWERPC DARWIN $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a
561         ./if_mach I386 LINUX $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a -lcurses `./threadlibs`
562         ./if_mach ALPHA LINUX $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a -lcurses `./threadlibs`
563         ./if_mach IA64 LINUX $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a -lcurses `./threadlibs`
564         ./if_mach M68K AMIGA $(CC) $(CFLAGS) -UGC_AMIGA_MAKINGLIB -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a -lcurses
565         ./if_not_there cord/de $(CC) $(CFLAGS) -o cord/de $(srcdir)/cord/de.c cord/cordbscs.o cord/cordxtra.o gc.a $(CURSES) `./threadlibs`
567 if_mach: $(srcdir)/if_mach.c $(srcdir)/include/private/gcconfig.h
568         $(HOSTCC) $(HOSTCFLAGS) -o if_mach $(srcdir)/if_mach.c
570 threadlibs: $(srcdir)/threadlibs.c $(srcdir)/include/private/gcconfig.h Makefile
571         $(HOSTCC) $(HOSTCFLAGS) -o threadlibs $(srcdir)/threadlibs.c
573 if_not_there: $(srcdir)/if_not_there.c
574         $(HOSTCC) $(HOSTCFLAGS) -o if_not_there $(srcdir)/if_not_there.c
576 clean: 
577         rm -f gc.a *.o *.exe tests/*.o gctest gctest_dyn_link test_cpp \
578               setjmp_test  mon.out gmon.out a.out core if_not_there if_mach \
579               threadlibs $(CORD_OBJS) cord/cordtest cord/de 
580         -rm -f *~
582 gctest: tests/test.o gc.a $(UTILS)
583         rm -f gctest
584         ./if_mach SPARC DRSNX $(CC) $(CFLAGS) -o gctest  tests/test.o gc.a -lucb
585         ./if_mach HP_PA HPUX $(CC) $(CFLAGS) -o gctest  tests/test.o gc.a -ldld `./threadlibs`
586         ./if_mach M68K AMIGA $(CC) $(CFLAGS) -UGC_AMIGA_MAKINGLIB -o gctest  tests/test.o gc.a `./threadlibs`
587         ./if_not_there gctest $(CC) $(CFLAGS) -o gctest tests/test.o gc.a `./threadlibs`
589 # If an optimized setjmp_test generates a segmentation fault,
590 # odds are your compiler is broken.  Gctest may still work.
591 # Try compiling setjmp_t.c unoptimized.
592 setjmp_test: $(srcdir)/setjmp_t.c $(srcdir)/include/gc.h $(UTILS)
593         $(CC) $(CFLAGS) -o setjmp_test $(srcdir)/setjmp_t.c
595 test:  KandRtest cord/cordtest
596         cord/cordtest
598 # Those tests that work even with a K&R C compiler:
599 KandRtest: setjmp_test gctest
600         ./setjmp_test
601         ./gctest
603 add_gc_prefix: $(srcdir)/add_gc_prefix.c $(srcdir)/version.h
604         $(CC) -o add_gc_prefix $(srcdir)/add_gc_prefix.c
606 gcname: $(srcdir)/gcname.c $(srcdir)/version.h
607         $(CC) -o gcname $(srcdir)/gcname.c
609 gc.tar: $(SRCS) $(DOC_FILES) $(OTHER_FILES) add_gc_prefix gcname
610         cp Makefile Makefile.old
611         cp Makefile.direct Makefile
612         rm -f `./gcname`
613         ln -s . `./gcname`
614         ./add_gc_prefix $(SRCS) $(DOC_FILES) $(OTHER_FILES) > /tmp/gc.tar-files
615         tar cvfh gc.tar `cat /tmp/gc.tar-files`
616         cp gc.tar `./gcname`.tar
617         gzip `./gcname`.tar
618         rm `./gcname`
620 pc_gc.tar: $(SRCS) $(OTHER_FILES)
621         tar cvfX pc_gc.tar pc_excludes $(SRCS) $(OTHER_FILES)
623 floppy: pc_gc.tar
624         -mmd a:/cord
625         -mmd a:/cord/private
626         -mmd a:/include
627         -mmd a:/include/private
628         mkdir /tmp/pc_gc
629         cat pc_gc.tar | (cd /tmp/pc_gc; tar xvf -)
630         -mcopy -tmn /tmp/pc_gc/* a:
631         -mcopy -tmn /tmp/pc_gc/cord/* a:/cord
632         -mcopy -mn /tmp/pc_gc/cord/de_win.ICO a:/cord
633         -mcopy -tmn /tmp/pc_gc/cord/private/* a:/cord/private
634         -mcopy -tmn /tmp/pc_gc/include/* a:/include
635         -mcopy -tmn /tmp/pc_gc/include/private/* a:/include/private
636         rm -r /tmp/pc_gc
638 gc.tar.Z: gc.tar
639         compress gc.tar
641 gc.tar.gz: gc.tar
642         gzip gc.tar
644 lint: $(CSRCS) tests/test.c
645         lint -DLINT $(CSRCS) tests/test.c | egrep -v "possible pointer alignment problem|abort|exit|sbrk|mprotect|syscall|change in ANSI|improper alignment"
647 # BTL: added to test shared library version of collector.
648 # Currently works only under SunOS5.  Requires GC_INIT call from statically
649 # loaded client code.
650 ABSDIR = `pwd`
651 gctest_dyn_link: tests/test.o libgc.so
652         $(CC) -L$(ABSDIR) -R$(ABSDIR) -o gctest_dyn_link tests/test.o -lgc -ldl -lthread
654 gctest_irix_dyn_link: tests/test.o libirixgc.so
655         $(CC) -L$(ABSDIR) -o gctest_irix_dyn_link tests/test.o -lirixgc
657 # The following appear to be dead, especially since libgc_globals.h
658 # is apparently lost.
659 test_dll.o: tests/test.c libgc_globals.h
660         $(CC) $(CFLAGS) -DGC_USE_DLL -c tests/test.c -o test_dll.o
662 test_dll: test_dll.o libgc_dll.a libgc.dll
663         $(CC) test_dll.o -L$(ABSDIR) -lgc_dll -o test_dll
665 SYM_PREFIX-libgc=GC
667 # Uncomment the following line to build a GNU win32 DLL
668 # include Makefile.DLLs
670 reserved_namespace: $(SRCS)
671         for file in $(SRCS) tests/test.c tests/test_cpp.cc; do \
672                 sed s/GC_/_GC_/g < $$file > tmp; \
673                 cp tmp $$file; \
674                 done
676 user_namespace: $(SRCS)
677         for file in $(SRCS) tests/test.c tests/test_cpp.cc; do \
678                 sed s/_GC_/GC_/g < $$file > tmp; \
679                 cp tmp $$file; \
680                 done