gcc/INSTALL - annotate

Return to INSTALL CVS log

Up to [GCC 2.x] / gcc

Annotation of gcc/INSTALL, revision 1.1.1.11

1.1.1.5 root 1: This file documents the installation of the GNU compiler. Copyright
1.1.1.8 root 2: (C) 1988, 1989, 1992, 1994, 1995 Free Software Foundation, Inc. You
3: may copy, distribute, and modify it freely as long as you preserve this
4: copyright notice and permission notice.
1.1 root 5:
6: Installing GNU CC
1.1.1.5 root 7: *****************
1.1 root 8:
1.1.1.7 root 9: Here is the procedure for installing GNU CC on a Unix system. See
10: *Note VMS Install::, for VMS systems. In this section we assume you
11: compile in the same directory that contains the source files; see *Note
12: Other Dir::, to find out how to compile in a separate directory on Unix
13: systems.
1.1 root 14:
1.1.1.6 root 15: You cannot install GNU C by itself on MSDOS; it will not compile
16: under any MSDOS compiler except itself. You need to get the complete
17: compilation package DJGPP, which includes binaries as well as sources,
18: and includes all the necessary compilation tools and libraries.
19:
1.1 root 20: 1. If you have built GNU CC previously in the same directory for a
1.1.1.2 root 21: different target machine, do `make distclean' to delete all files
1.1.1.4 root 22: that might be invalid. One of the files this deletes is
23: `Makefile'; if `make distclean' complains that `Makefile' does not
24: exist, it probably means that the directory is already suitably
25: clean.
1.1 root 26:
1.1.1.3 root 27: 2. On a System V release 4 system, make sure `/usr/bin' precedes
1.1 root 28: `/usr/ucb' in `PATH'. The `cc' command in `/usr/ucb' uses
29: libraries which have bugs.
30:
1.1.1.7 root 31: 3. Specify the host, build and target machine configurations. You do
32: this by running the file `configure'.
33:
34: The "build" machine is the system which you are using, the "host"
35: machine is the system where you want to run the resulting compiler
36: (normally the build machine), and the "target" machine is the
37: system for which you want the compiler to generate code.
1.1 root 38:
1.1.1.3 root 39: If you are building a compiler to produce code for the machine it
1.1.1.7 root 40: runs on (a native compiler), you normally do not need to specify
41: any operands to `configure'; it will try to guess the type of
42: machine you are on and use that as the build, host and target
43: machines. So you don't need to specify a configuration when
44: building a native compiler unless `configure' cannot figure out
45: what your configuration is or guesses wrong.
46:
47: In those cases, specify the build machine's "configuration name"
48: with the `--build' option; the host and target will default to be
49: the same as the build machine. (If you are building a
50: cross-compiler, see *Note Cross-Compiler::.)
51:
52: Here is an example:
53:
54: ./configure --build=sparc-sun-sunos4.1
1.1.1.6 root 55:
1.1.1.3 root 56: A configuration name may be canonical or it may be more or less
1.1 root 57: abbreviated.
58:
1.1.1.3 root 59: A canonical configuration name has three parts, separated by
1.1.1.5 root 60: dashes. It looks like this: `CPU-COMPANY-SYSTEM'. (The three
61: parts may themselves contain dashes; `configure' can figure out
62: which dashes serve which purpose.) For example,
63: `m68k-sun-sunos4.1' specifies a Sun 3.
1.1 root 64:
1.1.1.3 root 65: You can also replace parts of the configuration by nicknames or
1.1.1.5 root 66: aliases. For example, `sun3' stands for `m68k-sun', so
1.1 root 67: `sun3-sunos4.1' is another way to specify a Sun 3. You can also
1.1.1.2 root 68: use simply `sun3-sunos', since the version of SunOS is assumed by
1.1.1.3 root 69: default to be version 4. `sun3-bsd' also works, since `configure'
70: knows that the only BSD variant on a Sun 3 is SunOS.
71:
72: You can specify a version number after any of the system types,
73: and some of the CPU types. In most cases, the version is
74: irrelevant, and will be ignored. So you might as well specify the
75: version if you know it.
1.1 root 76:
1.1.1.7 root 77: See *Note Configurations::, for a list of supported configuration
78: names and notes on many of the configurations. You should check
1.1.1.8 root 79: the notes in that section before proceeding any further with the
1.1.1.7 root 80: installation of GNU CC.
1.1 root 81:
1.1.1.4 root 82: There are four additional options you can specify independently to
1.1.1.3 root 83: describe variant hardware and software configurations. These are
1.1.1.4 root 84: `--with-gnu-as', `--with-gnu-ld', `--with-stabs' and `--nfp'.
1.1.1.3 root 85:
86: `--with-gnu-as'
1.1.1.5 root 87: If you will use GNU CC with the GNU assembler (GAS), you
88: should declare this by using the `--with-gnu-as' option when
89: you run `configure'.
90:
91: Using this option does not install GAS. It only modifies the
92: output of GNU CC to work with GAS. Building and installing
93: GAS is up to you.
94:
1.1.1.6 root 95: Conversely, if you *do not* wish to use GAS and do not specify
96: `--with-gnu-as' when building GNU CC, it is up to you to make
97: sure that GAS is not installed. GNU CC searches for a
98: program named `as' in various directories; if the program it
99: finds is GAS, then it runs GAS. If you are not sure where
100: GNU CC finds the assembler it is using, try specifying `-v'
101: when you run it.
1.1.1.5 root 102:
1.1.1.6 root 103: The systems where it makes a difference whether you use GAS
104: are
105: `hppa1.0-ANY-ANY', `hppa1.1-ANY-ANY', `i386-ANY-sysv',
106: `i386-ANY-isc',
107: `i860-ANY-bsd', `m68k-bull-sysv', `m68k-hp-hpux',
108: `m68k-sony-bsd',
1.1.1.8 root 109: `m68k-altos-sysv', `m68000-hp-hpux', `m68000-att-sysv',
110: `ANY-lynx-lynxos', and `mips-ANY'). On any other system,
111: `--with-gnu-as' has no effect.
1.1.1.6 root 112:
1.1.1.7 root 113: On the systems listed above (except for the HP-PA, for ISC on
114: the 386, and for `mips-sgi-irix5.*'), if you use GAS, you
115: should also use the GNU linker (and specify `--with-gnu-ld').
1.1.1.3 root 116:
117: `--with-gnu-ld'
118: Specify the option `--with-gnu-ld' if you plan to use the GNU
1.1.1.5 root 119: linker with GNU CC.
120:
121: This option does not cause the GNU linker to be installed; it
122: just modifies the behavior of GNU CC to work with the GNU
123: linker. Specifically, it inhibits the installation of
124: `collect2', a program which otherwise serves as a front-end
125: for the system's linker on most configurations.
1.1.1.3 root 126:
1.1.1.4 root 127: `--with-stabs'
1.1.1.6 root 128: On MIPS based systems and on Alphas, you must specify whether
129: you want GNU CC to create the normal ECOFF debugging format,
130: or to use BSD-style stabs passed through the ECOFF symbol
131: table. The normal ECOFF debug format cannot fully handle
132: languages other than C. BSD stabs format can handle other
133: languages, but it only works with the GNU debugger GDB.
1.1.1.4 root 134:
135: Normally, GNU CC uses the ECOFF debugging format by default;
136: if you prefer BSD stabs, specify `--with-stabs' when you
137: configure GNU CC.
138:
139: No matter which default you choose when you configure GNU CC,
140: the user can use the `-gcoff' and `-gstabs+' options to
141: specify explicitly the debug format for a particular
142: compilation.
143:
1.1.1.6 root 144: `--with-stabs' is meaningful on the ISC system on the 386,
145: also, if `--with-gas' is used. It selects use of stabs
146: debugging information embedded in COFF output. This kind of
147: debugging information supports C++ well; ordinary COFF
148: debugging information does not.
149:
1.1.1.7 root 150: `--with-stabs' is also meaningful on 386 systems running
151: SVR4. It selects use of stabs debugging information embedded
152: in ELF output. The C++ compiler currently (2.6.0) does not
153: support the DWARF debugging information normally used on 386
154: SVR4 platforms; stabs provide a workable alternative. This
155: requires gas and gdb, as the normal SVR4 tools can not
156: generate or interpret stabs.
157:
1.1.1.3 root 158: `--nfp'
159: On certain systems, you must specify whether the machine has
1.1.1.5 root 160: a floating point unit. These systems include
161: `m68k-sun-sunosN' and `m68k-isi-bsd'. On any other system,
162: `--nfp' currently has no effect, though perhaps there are
163: other systems where it could usefully make a difference.
1.1.1.3 root 164:
1.1.1.7 root 165: The `configure' script searches subdirectories of the source
166: directory for other compilers that are to be integrated into GNU
167: CC. The GNU compiler for C++, called G++ is in a subdirectory
168: named `cp'. `configure' inserts rules into `Makefile' to build
169: all of those compilers.
1.1 root 170:
1.1.1.5 root 171: Here we spell out what files will be set up by `configure'.
1.1 root 172: Normally you need not be concerned with these files.
173:
1.1.1.8 root 174: * A file named `config.h' is created that contains a `#include'
175: of the top-level config file for the machine you will run the
176: compiler on (*note The Configuration File:
177: (gcc.info)Config.). This file is responsible for defining
178: information about the host machine. It includes `tm.h'.
1.1 root 179:
180: The top-level config file is located in the subdirectory
1.1.1.5 root 181: `config'. Its name is always `xm-SOMETHING.h'; usually
1.1 root 182: `xm-MACHINE.h', but there are some exceptions.
183:
184: If your system does not support symbolic links, you might
185: want to set up `config.h' to contain a `#include' command
186: which refers to the appropriate file.
187:
1.1.1.8 root 188: * A file named `tconfig.h' is created which includes the
189: top-level config file for your target machine. This is used
190: for compiling certain programs to run on that machine.
1.1 root 191:
1.1.1.8 root 192: * A file named `tm.h' is created which includes the
1.1 root 193: machine-description macro file for your target machine. It
194: should be in the subdirectory `config' and its name is often
195: `MACHINE.h'.
196:
1.1.1.5 root 197: * The command file `configure' also constructs the file
198: `Makefile' by adding some text to the template file
199: `Makefile.in'. The additional text comes from files in the
200: `config' directory, named `t-TARGET' and `x-HOST'. If these
201: files do not exist, it means nothing needs to be added for a
202: given target or host.
203:
204: 4. The standard directory for installing GNU CC is `/usr/local/lib'.
205: If you want to install its files somewhere else, specify
206: `--prefix=DIR' when you run `configure'. Here DIR is a directory
207: name to use instead of `/usr/local' for all purposes with one
208: exception: the directory `/usr/local/include' is searched for
1.1.1.7 root 209: header files no matter where you install the compiler. To override
210: this name, use the `--local-prefix' option below.
1.1.1.5 root 211:
212: 5. Specify `--local-prefix=DIR' if you want the compiler to search
1.1.1.7 root 213: directory `DIR/include' for locally installed header files
214: *instead* of `/usr/local/include'.
1.1 root 215:
1.1.1.7 root 216: You should specify `--local-prefix' *only* if your site has a
217: different convention (not `/usr/local') for where to put
218: site-specific files.
219:
220: *Do not* specify `/usr' as the `--local-prefix'! The directory
221: you use for `--local-prefix' *must not* contain any of the
222: system's standard header files. If it did contain them, certain
223: programs would be miscompiled (including GNU Emacs, on certain
224: targets), because this would override and nullify the header file
225: corrections made by the `fixincludes' script.
1.1.1.6 root 226:
1.1.1.5 root 227: 6. Make sure the Bison parser generator is installed. (This is
1.1.1.3 root 228: unnecessary if the Bison output files `c-parse.c' and `cexp.c' are
229: more recent than `c-parse.y' and `cexp.y' and you do not plan to
230: change the `.y' files.)
1.1 root 231:
1.1.1.3 root 232: Bison versions older than Sept 8, 1988 will produce incorrect
1.1 root 233: output for `c-parse.c'.
234:
1.1.1.6 root 235: 7. If you have chosen a configuration for GNU CC which requires other
236: GNU tools (such as GAS or the GNU linker) instead of the standard
237: system tools, install the required tools in the build directory
238: under the names `as', `ld' or whatever is appropriate. This will
239: enable the compiler to find the proper tools for compilation of
240: the program `enquire'.
241:
242: Alternatively, you can do subsequent compilation using a value of
243: the `PATH' environment variable such that the necessary GNU tools
244: come before the standard system tools.
245:
246: 8. Build the compiler. Just type `make LANGUAGES=c' in the compiler
1.1 root 247: directory.
248:
1.1.1.3 root 249: `LANGUAGES=c' specifies that only the C compiler should be
1.1 root 250: compiled. The makefile normally builds compilers for all the
251: supported languages; currently, C, C++ and Objective C. However,
252: C is the only language that is sure to work when you build with
253: other non-GNU C compilers. In addition, building anything but C
254: at this stage is a waste of time.
255:
1.1.1.3 root 256: In general, you can specify the languages to build by typing the
257: argument `LANGUAGES="LIST"', where LIST is one or more words from
1.1.1.7 root 258: the list `c', `c++', and `objective-c'. If you have any
259: additional GNU compilers as subdirectories of the GNU CC source
260: directory, you may also specify their names in this list.
1.1.1.3 root 261:
262: Ignore any warnings you may see about "statement not reached" in
1.1.1.5 root 263: `insn-emit.c'; they are normal. Also, warnings about "unknown
264: escape sequence" are normal in `genopinit.c' and perhaps some
1.1.1.7 root 265: other files. Likewise, you should ignore warnings about "constant
266: is so large that it is unsigned" in `insn-emit.c' and
1.1.1.8 root 267: `insn-recog.c' and a warning about a comparison always being zero
268: in `enquire.o'. Any other compilation errors may represent bugs in
1.1.1.5 root 269: the port to your machine or operating system, and should be
270: investigated and reported.
1.1.1.3 root 271:
272: Some commercial compilers fail to compile GNU CC because they have
273: bugs or limitations. For example, the Microsoft compiler is said
274: to run out of macro space. Some Ultrix compilers run out of
1.1 root 275: expression space; then you need to break up the statement where
276: the problem happens.
277:
1.1.1.6 root 278: 9. If you are building a cross-compiler, stop here. *Note
1.1.1.3 root 279: Cross-Compiler::.
1.1 root 280:
1.1.1.6 root 281: 10. Move the first-stage object files and executables into a
1.1 root 282: subdirectory with this command:
283:
284: make stage1
285:
1.1.1.5 root 286: The files are moved into a subdirectory named `stage1'. Once
1.1 root 287: installation is complete, you may wish to delete these files with
288: `rm -r stage1'.
289:
1.1.1.6 root 290: 11. If you have chosen a configuration for GNU CC which requires other
1.1.1.5 root 291: GNU tools (such as GAS or the GNU linker) instead of the standard
292: system tools, install the required tools in the `stage1'
293: subdirectory under the names `as', `ld' or whatever is
294: appropriate. This will enable the stage 1 compiler to find the
295: proper tools in the following stage.
296:
297: Alternatively, you can do subsequent compilation using a value of
298: the `PATH' environment variable such that the necessary GNU tools
299: come before the standard system tools.
300:
1.1.1.6 root 301: 12. Recompile the compiler with itself, with this command:
1.1 root 302:
1.1.1.8 root 303: make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O2"
1.1 root 304:
1.1.1.3 root 305: This is called making the stage 2 compiler.
1.1 root 306:
1.1.1.3 root 307: The command shown above builds compilers for all the supported
1.1 root 308: languages. If you don't want them all, you can specify the
1.1.1.3 root 309: languages to build by typing the argument `LANGUAGES="LIST"'. LIST
310: should contain one or more words from the list `c', `c++',
311: `objective-c', and `proto'. Separate the words with spaces.
312: `proto' stands for the programs `protoize' and `unprotoize'; they
313: are not a separate language, but you use `LANGUAGES' to enable or
314: disable their installation.
315:
316: If you are going to build the stage 3 compiler, then you might
317: want to build only the C language in stage 2.
318:
319: Once you have built the stage 2 compiler, if you are short of disk
320: space, you can delete the subdirectory `stage1'.
321:
322: On a 68000 or 68020 system lacking floating point hardware, unless
323: you have selected a `tm.h' file that expects by default that there
324: is no such hardware, do this instead:
1.1 root 325:
1.1.1.8 root 326: make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O2 -msoft-float"
1.1 root 327:
1.1.1.6 root 328: 13. If you wish to test the compiler by compiling it with itself one
1.1.1.5 root 329: more time, install any other necessary GNU tools (such as GAS or
330: the GNU linker) in the `stage2' subdirectory as you did in the
331: `stage1' subdirectory, then do this:
1.1 root 332:
333: make stage2
1.1.1.8 root 334: make CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O2"
1.1 root 335:
336: This is called making the stage 3 compiler. Aside from the `-B'
1.1.1.4 root 337: option, the compiler options should be the same as when you made
338: the stage 2 compiler. But the `LANGUAGES' option need not be the
339: same. The command shown above builds compilers for all the
340: supported languages; if you don't want them all, you can specify
341: the languages to build by typing the argument `LANGUAGES="LIST"',
342: as described above.
1.1 root 343:
1.1.1.7 root 344: If you do not have to install any additional GNU tools, you may
345: use the command
346:
347: make bootstrap LANGUAGES=LANGUAGE-LIST BOOT_CFLAGS=OPTION-LIST
348:
349: instead of making `stage1', `stage2', and performing the two
350: compiler builds.
351:
352: 14. Then compare the latest object files with the stage 2 object
1.1.1.6 root 353: files--they ought to be identical, aside from time stamps (if any).
354:
355: On some systems, meaningful comparison of object files is
356: impossible; they always appear "different." This is currently
1.1.1.8 root 357: true on Solaris and some systems that use ELF object file format.
358: On some versions of Irix on SGI machines and DEC Unix (OSF/1) on
359: Alpha systems, you will not be able to compare the files without
360: specifying `-save-temps'; see the description of individual
361: systems above to see if you get comparison failures. You may have
362: similar problems on other systems.
1.1.1.6 root 363:
364: Use this command to compare the files:
1.1.1.3 root 365:
366: make compare
367:
368: This will mention any object files that differ between stage 2 and
369: stage 3. Any difference, no matter how innocuous, indicates that
370: the stage 2 compiler has compiled GNU CC incorrectly, and is
1.1 root 371: therefore a potentially serious bug which you should investigate
1.1.1.3 root 372: and report.
1.1 root 373:
1.1.1.3 root 374: If your system does not put time stamps in the object files, then
375: this is a faster way to compare them (using the Bourne shell):
1.1 root 376:
377: for file in *.o; do
1.1.1.3 root 378: cmp $file stage2/$file
1.1 root 379: done
380:
1.1.1.3 root 381: If you have built the compiler with the `-mno-mips-tfile' option on
382: MIPS machines, you will not be able to compare the files.
1.1 root 383:
1.1.1.8 root 384: 15. Install the compiler driver, the compiler's passes and run-time
1.1.1.5 root 385: support with `make install'. Use the same value for `CC',
386: `CFLAGS' and `LANGUAGES' that you used when compiling the files
387: that are being installed. One reason this is necessary is that
388: some versions of Make have bugs and recompile files gratuitously
389: when you do this step. If you use the same variable values, those
390: files will be recompiled properly.
1.1 root 391:
1.1.1.5 root 392: For example, if you have built the stage 2 compiler, you can use
393: the following command:
1.1 root 394:
1.1.1.5 root 395: make install CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O" LANGUAGES="LIST"
1.1 root 396:
1.1.1.3 root 397: This copies the files `cc1', `cpp' and `libgcc.a' to files `cc1',
1.1.1.5 root 398: `cpp' and `libgcc.a' in the directory
1.1.1.2 root 399: `/usr/local/lib/gcc-lib/TARGET/VERSION', which is where the
400: compiler driver program looks for them. Here TARGET is the target
401: machine type specified when you ran `configure', and VERSION is
402: the version number of GNU CC. This naming scheme permits various
1.1 root 403: versions and/or cross-compilers to coexist.
404:
1.1.1.5 root 405: This also copies the driver program `xgcc' into
406: `/usr/local/bin/gcc', so that it appears in typical execution
407: search paths.
408:
409: On some systems, this command causes recompilation of some files.
410: This is usually due to bugs in `make'. You should either ignore
411: this problem, or use GNU Make.
1.1.1.3 root 412:
413: *Warning: there is a bug in `alloca' in the Sun library. To avoid
414: this bug, be sure to install the executables of GNU CC that were
415: compiled by GNU CC. (That is, the executables from stage 2 or 3,
416: not stage 1.) They use `alloca' as a built-in function and never
417: the one in the library.*
1.1.1.2 root 418:
1.1.1.3 root 419: (It is usually better to install GNU CC executables from stage 2
420: or 3, since they usually run faster than the ones compiled with
1.1.1.2 root 421: some other compiler.)
1.1 root 422:
1.1.1.8 root 423: 16. If you're going to use C++, it's likely that you need to also
1.1.1.5 root 424: install the libg++ distribution. It should be available from the
425: same place where you got the GNU C distribution. Just as GNU C
1.1.1.4 root 426: does not distribute a C runtime library, it also does not include
427: a C++ run-time library. All I/O functionality, special class
1.1.1.5 root 428: libraries, etc., are available in the libg++ distribution.
1.1 root 429:
1.1.1.7 root 430: Configurations Supported by GNU CC
431: ==================================
432:
433: Here are the possible CPU types:
434:
435: 1750a, a29k, alpha, arm, cN, clipper, dsp16xx, elxsi, h8300,
1.1.1.8 root 436: hppa1.0, hppa1.1, i370, i386, i486, i586, i860, i960, m68000, m68k,
437: m88k, mips, mipsel, mips64, mips64el, ns32k, powerpc, powerpcle,
438: pyramid, romp, rs6000, sh, sparc, sparclite, sparc64, vax, we32k.
1.1.1.7 root 439:
440: Here are the recognized company names. As you can see, customary
441: abbreviations are used rather than the longer official names.
442:
443: acorn, alliant, altos, apollo, att, bull, cbm, convergent, convex,
444: crds, dec, dg, dolphin, elxsi, encore, harris, hitachi, hp, ibm,
445: intergraph, isi, mips, motorola, ncr, next, ns, omron, plexus,
1.1.1.8 root 446: sequent, sgi, sony, sun, tti, unicom, wrs.
1.1.1.7 root 447:
448: The company name is meaningful only to disambiguate when the rest of
449: the information supplied is insufficient. You can omit it, writing
450: just `CPU-SYSTEM', if it is not needed. For example, `vax-ultrix4.2'
451: is equivalent to `vax-dec-ultrix4.2'.
452:
453: Here is a list of system types:
454:
1.1.1.8 root 455: 386bsd, aix, acis, amigados, aos, aout, bosx, bsd, clix, coff,
456: ctix, cxux, dgux, dynix, ebmon, ecoff, elf, esix, freebsd, hms,
457: genix, gnu, gnu/linux, hiux, hpux, iris, irix, isc, luna, lynxos,
458: mach, minix, msdos, mvs, netbsd, newsos, nindy, ns, osf, osfrose,
459: ptx, riscix, riscos, rtu, sco, sim, solaris, sunos, sym, sysv,
460: udi, ultrix, unicos, uniplus, unos, vms, vsta, vxworks, winnt,
461: xenix.
1.1.1.7 root 462:
463: You can omit the system type; then `configure' guesses the operating
464: system from the CPU and company.
465:
466: You can add a version number to the system type; this may or may not
467: make a difference. For example, you can write `bsd4.3' or `bsd4.4' to
468: distinguish versions of BSD. In practice, the version number is most
469: needed for `sysv3' and `sysv4', which are often treated differently.
470:
471: If you specify an impossible combination such as `i860-dg-vms', then
472: you may get an error message from `configure', or it may ignore part of
473: the information and do the best it can with the rest. `configure'
474: always prints the canonical name for the alternative that it used. GNU
475: CC does not support all possible alternatives.
476:
477: Often a particular model of machine has a name. Many machine names
478: are recognized as aliases for CPU/company combinations. Thus, the
479: machine name `sun3', mentioned above, is an alias for `m68k-sun'.
480: Sometimes we accept a company name as a machine name, when the name is
481: popularly used for a particular machine. Here is a table of the known
482: machine names:
483:
484: 3300, 3b1, 3bN, 7300, altos3068, altos, apollo68, att-7300,
485: balance, convex-cN, crds, decstation-3100, decstation, delta,
486: encore, fx2800, gmicro, hp7NN, hp8NN, hp9k2NN, hp9k3NN, hp9k7NN,
487: hp9k8NN, iris4d, iris, isi68, m3230, magnum, merlin, miniframe,
488: mmax, news-3600, news800, news, next, pbd, pc532, pmax, powerpc,
1.1.1.8 root 489: powerpcle, ps2, risc-news, rtpc, sun2, sun386i, sun386, sun3,
490: sun4, symmetry, tower-32, tower.
1.1.1.7 root 491:
492: Remember that a machine name specifies both the cpu type and the company
493: name. If you want to install your own homemade configuration files,
494: you can use `local' as the company name to access them. If you use
495: configuration `CPU-local', the configuration name without the cpu prefix
496: is used to form the configuration file names.
497:
498: Thus, if you specify `m68k-local', configuration uses files
499: `m68k.md', `local.h', `m68k.c', `xm-local.h', `t-local', and `x-local',
500: all in the directory `config/m68k'.
501:
502: Here is a list of configurations that have special treatment or
503: special things you must know:
504:
505: `1750a-*-*'
506: MIL-STD-1750A processors.
507:
508: Starting with GCC 2.6.1, the MIL-STD-1750A cross configuration no
509: longer supports the Tektronix Assembler, but instead produces
510: output for `as1750', an assembler/linker available under the GNU
1.1.1.8 root 511: Public License for the 1750A. Contact *[email protected]*
1.1.1.7 root 512: for more details on obtaining `as1750'. A similarly licensed
513: simulator for the 1750A is available from same address.
514:
515: You should ignore a fatal error during the building of libgcc
516: (libgcc is not yet implemented for the 1750A.)
517:
518: The `as1750' assembler requires the file `ms1750.inc', which is
519: found in the directory `config/1750a'.
520:
521: GNU CC produced the same sections as the Fairchild F9450 C
522: Compiler, namely:
523:
1.1.1.8 root 524: `Normal'
1.1.1.7 root 525: The program code section.
526:
1.1.1.8 root 527: `Static'
1.1.1.7 root 528: The read/write (RAM) data section.
529:
1.1.1.8 root 530: `Konst'
1.1.1.7 root 531: The read-only (ROM) constants section.
532:
1.1.1.8 root 533: `Init'
1.1.1.7 root 534: Initialization section (code to copy KREL to SREL).
535:
536: The smallest addressable unit is 16 bits (BITS_PER_UNIT is 16).
537: This means that type `char' is represented with a 16-bit word per
538: character. The 1750A's "Load/Store Upper/Lower Byte" instructions
539: are not used by GNU CC.
540:
541: `alpha-*-osf1'
542: Systems using processors that implement the DEC Alpha architecture
1.1.1.8 root 543: and are running the DEC Unix (OSF/1) operating system, for example
544: the DEC Alpha AXP systems. (VMS on the Alpha is not currently
545: supported by GNU CC.)
1.1.1.7 root 546:
547: GNU CC writes a `.verstamp' directive to the assembler output file
548: unless it is built as a cross-compiler. It gets the version to
549: use from the system header file `/usr/include/stamp.h'. If you
1.1.1.8 root 550: install a new version of DEC Unix, you should rebuild GCC to pick
551: up the new version stamp.
1.1.1.7 root 552:
553: Note that since the Alpha is a 64-bit architecture,
554: cross-compilers from 32-bit machines will not generate code as
555: efficient as that generated when the compiler is running on a
556: 64-bit machine because many optimizations that depend on being
557: able to represent a word on the target in an integral value on the
558: host cannot be performed. Building cross-compilers on the Alpha
559: for 32-bit machines has only been tested in a few cases and may
560: not work properly.
561:
1.1.1.8 root 562: `make compare' may fail on old versions of DEC Unix unless you add
1.1.1.7 root 563: `-save-temps' to `CFLAGS'. On these systems, the name of the
564: assembler input file is stored in the object file, and that makes
565: comparison fail if it differs between the `stage1' and `stage2'
566: compilations. The option `-save-temps' forces a fixed name to be
567: used for the assembler input file, instead of a randomly chosen
568: name in `/tmp'. Do not add `-save-temps' unless the comparisons
569: fail without that option. If you add `-save-temps', you will have
570: to manually delete the `.i' and `.s' files after each series of
571: compilations.
572:
573: GNU CC now supports both the native (ECOFF) debugging format used
574: by DBX and GDB and an encapsulated STABS format for use only with
575: GDB. See the discussion of the `--with-stabs' option of
576: `configure' above for more information on these formats and how to
577: select them.
578:
579: There is a bug in DEC's assembler that produces incorrect line
580: numbers for ECOFF format when the `.align' directive is used. To
581: work around this problem, GNU CC will not emit such alignment
582: directives while writing ECOFF format debugging information even
583: if optimization is being performed. Unfortunately, this has the
584: very undesirable side-effect that code addresses when `-O' is
585: specified are different depending on whether or not `-g' is also
586: specified.
587:
588: To avoid this behavior, specify `-gstabs+' and use GDB instead of
589: DBX. DEC is now aware of this problem with the assembler and
590: hopes to provide a fix shortly.
591:
592: `arm'
593: Advanced RISC Machines ARM-family processors. These are often
594: used in embedded applications. There are no standard Unix
595: configurations. This configuration corresponds to the basic
596: instruction sequences and will produce a.out format object modules.
597:
598: You may need to make a variant of the file `arm.h' for your
599: particular configuration.
600:
601: `arm-*-riscix'
602: The ARM2 or ARM3 processor running RISC iX, Acorn's port of BSD
603: Unix. If you are running a version of RISC iX prior to 1.2 then
604: you must specify the version number during configuration. Note
605: that the assembler shipped with RISC iX does not support stabs
606: debugging information; a new version of the assembler, with stabs
607: support included, is now available from Acorn.
608:
609: `a29k'
610: AMD Am29k-family processors. These are normally used in embedded
611: applications. There are no standard Unix configurations. This
612: configuration corresponds to AMD's standard calling sequence and
613: binary interface and is compatible with other 29k tools.
614:
615: You may need to make a variant of the file `a29k.h' for your
616: particular configuration.
617:
618: `a29k-*-bsd'
619: AMD Am29050 used in a system running a variant of BSD Unix.
620:
621: `decstation-*'
622: DECstations can support three different personalities: Ultrix, DEC
623: OSF/1, and OSF/rose. To configure GCC for these platforms use the
624: following configurations:
625:
626: `decstation-ultrix'
627: Ultrix configuration.
628:
629: `decstation-osf1'
630: Dec's version of OSF/1.
631:
632: `decstation-osfrose'
633: Open Software Foundation reference port of OSF/1 which uses
634: the OSF/rose object file format instead of ECOFF. Normally,
635: you would not select this configuration.
636:
637: The MIPS C compiler needs to be told to increase its table size
638: for switch statements with the `-Wf,-XNg1500' option in order to
639: compile `cp/parse.c'. If you use the `-O2' optimization option,
640: you also need to use `-Olimit 3000'. Both of these options are
641: automatically generated in the `Makefile' that the shell script
642: `configure' builds. If you override the `CC' make variable and
643: use the MIPS compilers, you may need to add `-Wf,-XNg1500 -Olimit
644: 3000'.
645:
646: `elxsi-elxsi-bsd'
647: The Elxsi's C compiler has known limitations that prevent it from
648: compiling GNU C. Please contact `[email protected]' for more details.
649:
650: `dsp16xx'
651: A port to the AT&T DSP1610 family of processors.
652:
653: `h8300-*-*'
654: The calling convention and structure layout has changed in release
655: 2.6. All code must be recompiled. The calling convention now
656: passes the first three arguments in function calls in registers.
657: Structures are no longer a multiple of 2 bytes.
658:
659: `hppa*-*-*'
1.1.1.9 root 660: There are several variants of the HP-PA processor which run a
661: variety of operating systems. GNU CC must be configured to use
662: the correct processor type and operating system, or GNU CC will
663: not function correctly. The easiest way to handle this problem is
664: to *not* specify a target when configuring GNU CC, the `configure'
665: script will try to automatically determine the right processor
666: type and operating system.
1.1.1.7 root 667:
668: `-g' does not work on HP-UX, since that system uses a peculiar
669: debugging format which GNU CC does not know about. However, `-g'
670: will work if you also use GAS and GDB in conjunction with GCC. We
671: highly recommend using GAS for all HP-PA configurations.
672:
1.1.1.9 root 673: You should be using GAS-2.6 (or later) along with GDB-4.16 (or
1.1.1.7 root 674: later). These can be retrieved from all the traditional GNU ftp
675: archive sites.
676:
1.1.1.9 root 677: GAS will need to be installed into a directory before `/bin',
678: `/usr/bin', and `/usr/ccs/bin' in your search path. You should
679: install GAS before you build GNU CC.
1.1.1.7 root 680:
1.1.1.9 root 681: To enable debugging, you must configure GNU CC with the
682: `--with-gnu-as' option before building.
1.1.1.7 root 683:
684: `i370-*-*'
685: This port is very preliminary and has many known bugs. We hope to
686: have a higher-quality port for this machine soon.
687:
1.1.1.8 root 688: `i386-*-linuxoldld'
1.1.1.9 root 689: Use this configuration to generate a.out binaries on Linux-based
690: GNU systems, if you do not have gas/binutils version 2.5.2 or later
691: installed. This is an obsolete configuration.
1.1.1.8 root 692:
693: `i386-*-linuxaout'
1.1.1.9 root 694: Use this configuration to generate a.out binaries on Linux-based
695: GNU systems. This configuration is being superseded. You must use
696: gas/binutils version 2.5.2 or later.
1.1.1.8 root 697:
1.1.1.11! root 698: `i386-*-linux-gnulibc1'
1.1.1.10 root 699: Use this configuration to generate ELF binaries on Linux-based GNU
1.1.1.11! root 700: systems using the Linux libc version 5. You must use gas/binutils
! 701: version 2.5.2 or later.
1.1.1.10 root 702:
1.1.1.8 root 703: `i386-*-linux'
1.1.1.9 root 704: Use this configuration to generate ELF binaries on Linux-based GNU
1.1.1.11! root 705: systems using glibc 2. You must use gas/binutils version 2.8.1 or
! 706: later.
1.1.1.7 root 707:
708: `i386-*-sco'
709: Compilation with RCC is recommended. Also, it may be a good idea
710: to link with GNU malloc instead of the malloc that comes with the
711: system.
712:
1.1.1.8 root 713: `i386-*-sco3.2v4'
1.1.1.7 root 714: Use this configuration for SCO release 3.2 version 4.
715:
716: `i386-*-isc'
717: It may be a good idea to link with GNU malloc instead of the
718: malloc that comes with the system.
719:
720: In ISC version 4.1, `sed' core dumps when building `deduced.h'.
721: Use the version of `sed' from version 4.0.
722:
723: `i386-*-esix'
724: It may be good idea to link with GNU malloc instead of the malloc
725: that comes with the system.
726:
727: `i386-ibm-aix'
728: You need to use GAS version 2.1 or later, and and LD from GNU
729: binutils version 2.2 or later.
730:
731: `i386-sequent-bsd'
732: Go to the Berkeley universe before compiling. In addition, you
733: probably need to create a file named `string.h' containing just
734: one line: `#include <strings.h>'.
735:
736: `i386-sequent-ptx1*'
737: Sequent DYNIX/ptx 1.x.
738:
739: `i386-sequent-ptx2*'
740: Sequent DYNIX/ptx 2.x.
741:
742: `i386-sun-sunos4'
743: You may find that you need another version of GNU CC to begin
744: bootstrapping with, since the current version when built with the
745: system's own compiler seems to get an infinite loop compiling part
746: of `libgcc2.c'. GNU CC version 2 compiled with GNU CC (any
747: version) seems not to have this problem.
748:
749: See *Note Sun Install::, for information on installing GNU CC on
750: Sun systems.
751:
1.1.1.8 root 752: `i[345]86-*-winnt3.5'
753: This version requires a GAS that has not let been released. Until
754: it is, you can get a prebuilt binary version via anonymous ftp from
755: `cs.washington.edu:pub/gnat' or `cs.nyu.edu:pub/gnat'. You must
756: also use the Microsoft header files from the Windows NT 3.5 SDK.
757: Find these on the CDROM in the `/mstools/h' directory dated
758: 9/4/94. You must use a fixed version of Microsoft linker made
759: especially for NT 3.5, which is also is available on the NT 3.5
760: SDK CDROM. If you do not have this linker, can you also use the
761: linker from Visual C/C++ 1.0 or 2.0.
762:
763: Installing GNU CC for NT builds a wrapper linker, called `ld.exe',
764: which mimics the behaviour of Unix `ld' in the specification of
765: libraries (`-L' and `-l'). `ld.exe' looks for both Unix and
766: Microsoft named libraries. For example, if you specify `-lfoo',
767: `ld.exe' will look first for `libfoo.a' and then for `foo.lib'.
768:
769: You may install GNU CC for Windows NT in one of two ways,
770: depending on whether or not you have a Unix-like shell and various
771: Unix-like utilities.
772:
773: 1. If you do not have a Unix-like shell and few Unix-like
774: utilities, you will use a DOS style batch script called
775: `configure.bat'. Invoke it as `configure winnt' from an
776: MSDOS console window or from the program manager dialog box.
777: `configure.bat' assumes you have already installed and have
778: in your path a Unix-like `sed' program which is used to
779: create a working `Makefile' from `Makefile.in'.
780:
781: `Makefile' uses the Microsoft Nmake program maintenance
782: utility and the Visual C/C++ V8.00 compiler to build GNU CC.
783: You need only have the utilities `sed' and `touch' to use
784: this installation method, which only automatically builds the
785: compiler itself. You must then examine what `fixinc.winnt'
786: does, edit the header files by hand and build `libgcc.a'
787: manually.
788:
789: 2. The second type of installation assumes you are running a
790: Unix-like shell, have a complete suite of Unix-like utilities
791: in your path, and have a previous version of GNU CC already
792: installed, either through building it via the above
793: installation method or acquiring a pre-built binary. In this
794: case, use the `configure' script in the normal fashion.
795:
1.1.1.7 root 796: `i860-intel-osf1'
797: This is the Paragon. If you have version 1.0 of the operating
798: system, you need to take special steps to build GNU CC due to
799: peculiarities of the system. Newer system versions have no
800: problem. See the section `Installation Problems' in the GNU CC
801: Manual.
802:
1.1.1.8 root 803: `*-lynx-lynxos'
804: LynxOS 2.2 and earlier comes with GNU CC 1.x already installed as
805: `/bin/gcc'. You should compile with this instead of `/bin/cc'.
806: You can tell GNU CC to use the GNU assembler and linker, by
807: specifying `--with-gnu-as --with-gnu-ld' when configuring. These
808: will produce COFF format object files and executables; otherwise
809: GNU CC will use the installed tools, which produce a.out format
810: executables.
811:
1.1.1.7 root 812: `m68000-hp-bsd'
813: HP 9000 series 200 running BSD. Note that the C compiler that
814: comes with this system cannot compile GNU CC; contact
815: `[email protected]' to get binaries of GNU CC for bootstrapping.
816:
1.1.1.11! root 817: `m68k-*-linuxaout'
! 818: Use this configuration to generate a.out binaries on Linux. This
! 819: configuration is being superseded. You must use gas/binutils
! 820: version 2.5.2 or later.
! 821:
! 822: `m68k-*-linux-gnulibc1'
! 823: Use this configuration to generate ELF binaries on Linux with the
! 824: Linux C library 5.x.x. You must use gas/binutils version 2.8.1
! 825: later.
! 826:
! 827: `m68k-*-linux'
! 828: Use this configuration to generate ELF binaries on Linux-based GNU
! 829: systems with the GNU C library 2. You must use gas/binutils version
! 830: 2.8.1 or later.
! 831:
1.1.1.7 root 832: `m68k-altos'
833: Altos 3068. You must use the GNU assembler, linker and debugger.
834: Also, you must fix a kernel bug. Details in the file
835: `README.ALTOS'.
836:
837: `m68k-att-sysv'
838: AT&T 3b1, a.k.a. 7300 PC. Special procedures are needed to
839: compile GNU CC with this machine's standard C compiler, due to
840: bugs in that compiler. You can bootstrap it more easily with
841: previous versions of GNU CC if you have them.
842:
843: Installing GNU CC on the 3b1 is difficult if you do not already
844: have GNU CC running, due to bugs in the installed C compiler.
845: However, the following procedure might work. We are unable to
846: test it.
847:
848: 1. Comment out the `#include "config.h"' line on line 37 of
849: `cccp.c' and do `make cpp'. This makes a preliminary version
850: of GNU cpp.
851:
852: 2. Save the old `/lib/cpp' and copy the preliminary GNU cpp to
853: that file name.
854:
855: 3. Undo your change in `cccp.c', or reinstall the original
856: version, and do `make cpp' again.
857:
858: 4. Copy this final version of GNU cpp into `/lib/cpp'.
859:
860: 5. Replace every occurrence of `obstack_free' in the file
861: `tree.c' with `_obstack_free'.
862:
863: 6. Run `make' to get the first-stage GNU CC.
864:
865: 7. Reinstall the original version of `/lib/cpp'.
866:
867: 8. Now you can compile GNU CC with itself and install it in the
868: normal fashion.
869:
870: `m68k-bull-sysv'
871: Bull DPX/2 series 200 and 300 with BOS-2.00.45 up to BOS-2.01. GNU
872: CC works either with native assembler or GNU assembler. You can use
873: GNU assembler with native coff generation by providing
874: `--with-gnu-as' to the configure script or use GNU assembler with
875: dbx-in-coff encapsulation by providing `--with-gnu-as --stabs'.
876: For any problem with native assembler or for availability of the
877: DPX/2 port of GAS, contact `[email protected]'.
878:
879: `m68k-crds-unox'
880: Use `configure unos' for building on Unos.
881:
882: The Unos assembler is named `casm' instead of `as'. For some
883: strange reason linking `/bin/as' to `/bin/casm' changes the
884: behavior, and does not work. So, when installing GNU CC, you
885: should install the following script as `as' in the subdirectory
886: where the passes of GCC are installed:
887:
888: #!/bin/sh
889: casm $*
890:
891: The default Unos library is named `libunos.a' instead of `libc.a'.
892: To allow GNU CC to function, either change all references to
893: `-lc' in `gcc.c' to `-lunos' or link `/lib/libc.a' to
894: `/lib/libunos.a'.
895:
896: When compiling GNU CC with the standard compiler, to overcome bugs
897: in the support of `alloca', do not use `-O' when making stage 2.
898: Then use the stage 2 compiler with `-O' to make the stage 3
899: compiler. This compiler will have the same characteristics as the
900: usual stage 2 compiler on other systems. Use it to make a stage 4
901: compiler and compare that with stage 3 to verify proper
902: compilation.
903:
904: (Perhaps simply defining `ALLOCA' in `x-crds' as described in the
905: comments there will make the above paragraph superfluous. Please
906: inform us of whether this works.)
907:
908: Unos uses memory segmentation instead of demand paging, so you
909: will need a lot of memory. 5 Mb is barely enough if no other
910: tasks are running. If linking `cc1' fails, try putting the object
911: files into a library and linking from that library.
912:
913: `m68k-hp-hpux'
914: HP 9000 series 300 or 400 running HP-UX. HP-UX version 8.0 has a
915: bug in the assembler that prevents compilation of GNU CC. To fix
916: it, get patch PHCO_4484 from HP.
917:
918: In addition, if you wish to use gas `--with-gnu-as' you must use
919: gas version 2.1 or later, and you must use the GNU linker version
920: 2.1 or later. Earlier versions of gas relied upon a program which
921: converted the gas output into the native HP/UX format, but that
922: program has not been kept up to date. gdb does not understand
923: that native HP/UX format, so you must use gas if you wish to use
924: gdb.
925:
926: `m68k-sun'
927: Sun 3. We do not provide a configuration file to use the Sun FPA
928: by default, because programs that establish signal handlers for
929: floating point traps inherently cannot work with the FPA.
930:
931: See *Note Sun Install::, for information on installing GNU CC on
932: Sun systems.
933:
934: `m88k-*-svr3'
935: Motorola m88k running the AT&T/Unisoft/Motorola V.3 reference port.
936: These systems tend to use the Green Hills C, revision 1.8.5, as the
937: standard C compiler. There are apparently bugs in this compiler
938: that result in object files differences between stage 2 and stage
939: 3. If this happens, make the stage 4 compiler and compare it to
940: the stage 3 compiler. If the stage 3 and stage 4 object files are
941: identical, this suggests you encountered a problem with the
942: standard C compiler; the stage 3 and 4 compilers may be usable.
943:
944: It is best, however, to use an older version of GNU CC for
945: bootstrapping if you have one.
946:
947: `m88k-*-dgux'
948: Motorola m88k running DG/UX. To build 88open BCS native or cross
949: compilers on DG/UX, specify the configuration name as
950: `m88k-*-dguxbcs' and build in the 88open BCS software development
951: environment. To build ELF native or cross compilers on DG/UX,
952: specify `m88k-*-dgux' and build in the DG/UX ELF development
953: environment. You set the software development environment by
954: issuing `sde-target' command and specifying either `m88kbcs' or
955: `m88kdguxelf' as the operand.
956:
957: If you do not specify a configuration name, `configure' guesses the
958: configuration based on the current software development
959: environment.
960:
961: `m88k-tektronix-sysv3'
962: Tektronix XD88 running UTekV 3.2e. Do not turn on optimization
963: while building stage1 if you bootstrap with the buggy Green Hills
964: compiler. Also, The bundled LAI System V NFS is buggy so if you
965: build in an NFS mounted directory, start from a fresh reboot, or
966: avoid NFS all together. Otherwise you may have trouble getting
967: clean comparisons between stages.
968:
969: `mips-mips-bsd'
970: MIPS machines running the MIPS operating system in BSD mode. It's
971: possible that some old versions of the system lack the functions
972: `memcpy', `memcmp', and `memset'. If your system lacks these, you
973: must remove or undo the definition of `TARGET_MEM_FUNCTIONS' in
974: `mips-bsd.h'.
975:
976: The MIPS C compiler needs to be told to increase its table size
977: for switch statements with the `-Wf,-XNg1500' option in order to
978: compile `cp/parse.c'. If you use the `-O2' optimization option,
979: you also need to use `-Olimit 3000'. Both of these options are
980: automatically generated in the `Makefile' that the shell script
981: `configure' builds. If you override the `CC' make variable and
982: use the MIPS compilers, you may need to add `-Wf,-XNg1500 -Olimit
983: 3000'.
984:
985: `mips-mips-riscos*'
986: The MIPS C compiler needs to be told to increase its table size
987: for switch statements with the `-Wf,-XNg1500' option in order to
988: compile `cp/parse.c'. If you use the `-O2' optimization option,
989: you also need to use `-Olimit 3000'. Both of these options are
990: automatically generated in the `Makefile' that the shell script
991: `configure' builds. If you override the `CC' make variable and
992: use the MIPS compilers, you may need to add `-Wf,-XNg1500 -Olimit
993: 3000'.
994:
995: MIPS computers running RISC-OS can support four different
996: personalities: default, BSD 4.3, System V.3, and System V.4 (older
997: versions of RISC-OS don't support V.4). To configure GCC for
998: these platforms use the following configurations:
999:
1000: `mips-mips-riscos`rev''
1001: Default configuration for RISC-OS, revision `rev'.
1002:
1003: `mips-mips-riscos`rev'bsd'
1004: BSD 4.3 configuration for RISC-OS, revision `rev'.
1005:
1006: `mips-mips-riscos`rev'sysv4'
1007: System V.4 configuration for RISC-OS, revision `rev'.
1008:
1009: `mips-mips-riscos`rev'sysv'
1010: System V.3 configuration for RISC-OS, revision `rev'.
1011:
1012: The revision `rev' mentioned above is the revision of RISC-OS to
1013: use. You must reconfigure GCC when going from a RISC-OS revision
1014: 4 to RISC-OS revision 5. This has the effect of avoiding a linker
1015: bug.
1016:
1017: `mips-sgi-*'
1018: In order to compile GCC on an SGI running IRIX 4, the "c.hdr.lib"
1019: option must be installed from the CD-ROM supplied from Silicon
1020: Graphics. This is found on the 2nd CD in release 4.0.1.
1021:
1.1.1.8 root 1022: In order to compile GCC on an SGI running IRIX 5, the
1023: "compiler_dev.hdr" subsystem must be installed from the IDO CD-ROM
1024: supplied by Silicon Graphics.
1025:
1.1.1.7 root 1026: `make compare' may fail on version 5 of IRIX unless you add
1027: `-save-temps' to `CFLAGS'. On these systems, the name of the
1028: assembler input file is stored in the object file, and that makes
1029: comparison fail if it differs between the `stage1' and `stage2'
1030: compilations. The option `-save-temps' forces a fixed name to be
1031: used for the assembler input file, instead of a randomly chosen
1032: name in `/tmp'. Do not add `-save-temps' unless the comparisons
1033: fail without that option. If you do you `-save-temps', you will
1034: have to manually delete the `.i' and `.s' files after each series
1035: of compilations.
1036:
1037: The MIPS C compiler needs to be told to increase its table size
1038: for switch statements with the `-Wf,-XNg1500' option in order to
1039: compile `cp/parse.c'. If you use the `-O2' optimization option,
1040: you also need to use `-Olimit 3000'. Both of these options are
1041: automatically generated in the `Makefile' that the shell script
1042: `configure' builds. If you override the `CC' make variable and
1043: use the MIPS compilers, you may need to add `-Wf,-XNg1500 -Olimit
1044: 3000'.
1045:
1046: On Irix version 4.0.5F, and perhaps on some other versions as well,
1047: there is an assembler bug that reorders instructions incorrectly.
1048: To work around it, specify the target configuration
1049: `mips-sgi-irix4loser'. This configuration inhibits assembler
1050: optimization.
1051:
1052: In a compiler configured with target `mips-sgi-irix4', you can turn
1053: off assembler optimization by using the `-noasmopt' option. This
1054: compiler option passes the option `-O0' to the assembler, to
1055: inhibit reordering.
1056:
1057: The `-noasmopt' option can be useful for testing whether a problem
1058: is due to erroneous assembler reordering. Even if a problem does
1059: not go away with `-noasmopt', it may still be due to assembler
1060: reordering--perhaps GNU CC itself was miscompiled as a result.
1061:
1062: To enable debugging under Irix 5, you must use GNU as 2.5 or later,
1.1.1.8 root 1063: and use the `--with-gnu-as' configure option when configuring gcc.
1.1.1.7 root 1064: GNU as is distributed as part of the binutils package.
1065:
1066: `mips-sony-sysv'
1067: Sony MIPS NEWS. This works in NEWSOS 5.0.1, but not in 5.0.2
1068: (which uses ELF instead of COFF). Support for 5.0.2 will probably
1069: be provided soon by volunteers. In particular, the linker does
1070: not like the code generated by GCC when shared libraries are
1071: linked in.
1072:
1073: `ns32k-encore'
1074: Encore ns32000 system. Encore systems are supported only under
1075: BSD.
1076:
1077: `ns32k-*-genix'
1078: National Semiconductor ns32000 system. Genix has bugs in `alloca'
1079: and `malloc'; you must get the compiled versions of these from GNU
1080: Emacs.
1081:
1082: `ns32k-sequent'
1083: Go to the Berkeley universe before compiling. In addition, you
1084: probably need to create a file named `string.h' containing just
1085: one line: `#include <strings.h>'.
1086:
1087: `ns32k-utek'
1088: UTEK ns32000 system ("merlin"). The C compiler that comes with
1089: this system cannot compile GNU CC; contact `tektronix!reed!mason'
1090: to get binaries of GNU CC for bootstrapping.
1091:
1092: `romp-*-aos'
1093: `romp-*-mach'
1094: The only operating systems supported for the IBM RT PC are AOS and
1095: MACH. GNU CC does not support AIX running on the RT. We
1096: recommend you compile GNU CC with an earlier version of itself; if
1097: you compile GNU CC with `hc', the Metaware compiler, it will work,
1098: but you will get mismatches between the stage 2 and stage 3
1099: compilers in various files. These errors are minor differences in
1100: some floating-point constants and can be safely ignored; the stage
1101: 3 compiler is correct.
1102:
1103: `rs6000-*-aix'
1104: `powerpc-*-aix'
1105: Various early versions of each release of the IBM XLC compiler
1106: will not bootstrap GNU CC. Symptoms include differences between
1107: the stage2 and stage3 object files, and errors when compiling
1108: `libgcc.a' or `enquire'. Known problematic releases include:
1109: xlc-1.2.1.8, xlc-1.3.0.0 (distributed with AIX 3.2.5), and
1110: xlc-1.3.0.19. Both xlc-1.2.1.28 and xlc-1.3.0.24 (PTF 432238) are
1111: known to produce working versions of GNU CC, but most other recent
1112: releases correctly bootstrap GNU CC. Also, releases of AIX prior
1113: to AIX 3.2.4 include a version of the IBM assembler which does not
1114: accept debugging directives: assembler updates are available as
1.1.1.8 root 1115: PTFs. Also, if you are using AIX 3.2.5 or greater and the GNU
1116: assembler, you must have a version modified after October 16th,
1117: 1995 in order for the GNU C compiler to build. See the file
1118: `README.RS6000' for more details on of these problems.
1.1.1.7 root 1119:
1.1.1.8 root 1120: GNU CC does not yet support the 64-bit PowerPC instructions.
1.1.1.7 root 1121:
1.1.1.8 root 1122: Objective C does not work on this architecture because it makes
1123: assumptions that are incompatible with the calling conventions.
1.1.1.7 root 1124:
1125: AIX on the RS/6000 provides support (NLS) for environments outside
1126: of the United States. Compilers and assemblers use NLS to support
1127: locale-specific representations of various objects including
1128: floating-point numbers ("." vs "," for separating decimal
1129: fractions). There have been problems reported where the library
1130: linked with GNU CC does not produce the same floating-point
1131: formats that the assembler accepts. If you have this problem, set
1132: the LANG environment variable to "C" or "En_US".
1133:
1.1.1.8 root 1134: Due to changes in the way that GNU CC invokes the binder (linker)
1135: for AIX 4.1, you may now receive warnings of duplicate symbols
1136: from the link step that were not reported before. The assembly
1137: files generated by GNU CC for AIX have always included multiple
1138: symbol definitions for certain global variable and function
1139: declarations in the original program. The warnings should not
1140: prevent the linker from producing a correct library or runnable
1141: executable.
1142:
1143: `powerpc-*-elf'
1144: `powerpc-*-sysv4'
1145: PowerPC system in big endian mode, running System V.4.
1146:
1147: This configuration is currently under development.
1148:
1149: `powerpc-*-eabiaix'
1150: Embedded PowerPC system in big endian mode with -mcall-aix
1151: selected as the default. This system is currently under
1152: development.
1153:
1154: `powerpc-*-eabisim'
1155: Embedded PowerPC system in big endian mode for use in running
1156: under the PSIM simulator. This system is currently under
1157: development.
1158:
1159: `powerpc-*-eabi'
1160: Embedded PowerPC system in big endian mode.
1161:
1162: This configuration is currently under development.
1163:
1164: `powerpcle-*-elf'
1165: `powerpcle-*-sysv4'
1166: PowerPC system in little endian mode, running System V.4.
1167:
1168: This configuration is currently under development.
1169:
1170: `powerpcle-*-sysv4'
1171: Embedded PowerPC system in little endian mode.
1172:
1173: This system is currently under development.
1174:
1175: `powerpcle-*-eabisim'
1176: Embedded PowerPC system in little endian mode for use in running
1177: under the PSIM simulator.
1178:
1179: This system is currently under development.
1180:
1181: `powerpcle-*-eabi'
1182: Embedded PowerPC system in little endian mode.
1183:
1184: This configuration is currently under development.
1185:
1.1.1.7 root 1186: `vax-dec-ultrix'
1187: Don't try compiling with Vax C (`vcc'). It produces incorrect code
1188: in some cases (for example, when `alloca' is used).
1189:
1190: Meanwhile, compiling `cp/parse.c' with pcc does not work because of
1191: an internal table size limitation in that compiler. To avoid this
1192: problem, compile just the GNU C compiler first, and use it to
1193: recompile building all the languages that you want to run.
1194:
1195: `sparc-sun-*'
1196: See *Note Sun Install::, for information on installing GNU CC on
1197: Sun systems.
1198:
1199: `vax-dec-vms'
1200: See *Note VMS Install::, for details on how to install GNU CC on
1201: VMS.
1202:
1203: `we32k-*-*'
1204: These computers are also known as the 3b2, 3b5, 3b20 and other
1205: similar names. (However, the 3b1 is actually a 68000; see *Note
1206: Configurations::.)
1207:
1208: Don't use `-g' when compiling with the system's compiler. The
1209: system's linker seems to be unable to handle such a large program
1210: with debugging information.
1211:
1212: The system's compiler runs out of capacity when compiling `stmt.c'
1213: in GNU CC. You can work around this by building `cpp' in GNU CC
1214: first, then use that instead of the system's preprocessor with the
1215: system's C compiler to compile `stmt.c'. Here is how:
1216:
1217: mv /lib/cpp /lib/cpp.att
1218: cp cpp /lib/cpp.gnu
1219: echo '/lib/cpp.gnu -traditional ${1+"$@"}' > /lib/cpp
1220: chmod +x /lib/cpp
1221:
1222: The system's compiler produces bad code for some of the GNU CC
1223: optimization files. So you must build the stage 2 compiler without
1224: optimization. Then build a stage 3 compiler with optimization.
1225: That executable should work. Here are the necessary commands:
1226:
1227: make LANGUAGES=c CC=stage1/xgcc CFLAGS="-Bstage1/ -g"
1228: make stage2
1229: make CC=stage2/xgcc CFLAGS="-Bstage2/ -g -O"
1230:
1231: You may need to raise the ULIMIT setting to build a C++ compiler,
1232: as the file `cc1plus' is larger than one megabyte.
1233:
1.1 root 1234: Compilation in a Separate Directory
1.1.1.5 root 1235: ===================================
1.1 root 1236:
1237: If you wish to build the object files and executables in a directory
1238: other than the one containing the source files, here is what you must
1239: do differently:
1240:
1241: 1. Make sure you have a version of Make that supports the `VPATH'
1242: feature. (GNU Make supports it, as do Make versions on most BSD
1243: systems.)
1244:
1.1.1.3 root 1245: 2. If you have ever run `configure' in the source directory, you must
1246: undo the configuration. Do this by running:
1.1.1.2 root 1247:
1.1.1.3 root 1248: make distclean
1.1.1.2 root 1249:
1250: 3. Go to the directory in which you want to build the compiler before
1251: running `configure':
1.1 root 1252:
1253: mkdir gcc-sun3
1254: cd gcc-sun3
1255:
1.1.1.3 root 1256: On systems that do not support symbolic links, this directory must
1257: be on the same file system as the source code directory.
1.1 root 1258:
1.1.1.2 root 1259: 4. Specify where to find `configure' when you run it:
1.1 root 1260:
1.1.1.3 root 1261: ../gcc/configure ...
1.1 root 1262:
1.1.1.3 root 1263: This also tells `configure' where to find the compiler sources;
1264: `configure' takes the directory from the file name that was used to
1265: invoke it. But if you want to be sure, you can specify the source
1266: directory with the `--srcdir' option, like this:
1.1 root 1267:
1.1.1.7 root 1268: ../gcc/configure --srcdir=../gcc OTHER OPTIONS
1.1 root 1269:
1.1.1.3 root 1270: The directory you specify with `--srcdir' need not be the same as
1271: the one that `configure' is found in.
1.1 root 1272:
1273: Now, you can run `make' in that directory. You need not repeat the
1.1.1.3 root 1274: configuration steps shown above, when ordinary source files change. You
1275: must, however, run `configure' again when the configuration files
1.1 root 1276: change, if your system does not support symbolic links.
1277:
1.1.1.3 root 1278: Building and Installing a Cross-Compiler
1.1.1.5 root 1279: ========================================
1.1.1.3 root 1280:
1281: GNU CC can function as a cross-compiler for many machines, but not
1282: all.
1283:
1.1.1.6 root 1284: * Cross-compilers for the Mips as target using the Mips assembler
1285: currently do not work, because the auxiliary programs
1286: `mips-tdump.c' and `mips-tfile.c' can't be compiled on anything
1287: but a Mips. It does work to cross compile for a Mips if you use
1288: the GNU assembler and linker.
1289:
1290: * Cross-compilers between machines with different floating point
1291: formats have not all been made to work. GNU CC now has a floating
1292: point emulator with which these can work, but each target machine
1293: description needs to be updated to take advantage of it.
1294:
1.1.1.7 root 1295: * Cross-compilation between machines of different word sizes is
1296: somewhat problematic and sometimes does not work.
1.1.1.3 root 1297:
1298: Since GNU CC generates assembler code, you probably need a
1299: cross-assembler that GNU CC can run, in order to produce object files.
1300: If you want to link on other than the target machine, you need a
1301: cross-linker as well. You also need header files and libraries suitable
1302: for the target machine that you can install on the host machine.
1303:
1.1.1.6 root 1304: Steps of Cross-Compilation
1305: --------------------------
1306:
1307: To compile and run a program using a cross-compiler involves several
1308: steps:
1309:
1310: * Run the cross-compiler on the host machine to produce assembler
1311: files for the target machine. This requires header files for the
1312: target machine.
1313:
1314: * Assemble the files produced by the cross-compiler. You can do this
1315: either with an assembler on the target machine, or with a
1316: cross-assembler on the host machine.
1317:
1318: * Link those files to make an executable. You can do this either
1319: with a linker on the target machine, or with a cross-linker on the
1320: host machine. Whichever machine you use, you need libraries and
1321: certain startup files (typically `crt....o') for the target
1322: machine.
1323:
1324: It is most convenient to do all of these steps on the same host
1325: machine, since then you can do it all with a single invocation of GNU
1326: CC. This requires a suitable cross-assembler and cross-linker. For
1327: some targets, the GNU assembler and linker are available.
1328:
1329: Configuring a Cross-Compiler
1330: ----------------------------
1331:
1.1.1.3 root 1332: To build GNU CC as a cross-compiler, you start out by running
1.1.1.7 root 1333: `configure'. Use the `--target=TARGET' to specify the target type. If
1334: `configure' was unable to correctly identify the system you are running
1335: on, also specify the `--build=BUILD' option. For example, here is how
1336: to configure for a cross-compiler that produces code for an HP 68030
1337: system running BSD on a system that `configure' can correctly identify:
1.1.1.3 root 1338:
1.1.1.7 root 1339: ./configure --target=m68k-hp-bsd4.3
1.1.1.3 root 1340:
1.1.1.6 root 1341: Tools and Libraries for a Cross-Compiler
1342: ----------------------------------------
1343:
1344: If you have a cross-assembler and cross-linker available, you should
1345: install them now. Put them in the directory `/usr/local/TARGET/bin'.
1346: Here is a table of the tools you should put in this directory:
1347:
1348: `as'
1349: This should be the cross-assembler.
1350:
1351: `ld'
1352: This should be the cross-linker.
1353:
1354: `ar'
1355: This should be the cross-archiver: a program which can manipulate
1356: archive files (linker libraries) in the target machine's format.
1357:
1358: `ranlib'
1359: This should be a program to construct a symbol table in an archive
1360: file.
1361:
1362: The installation of GNU CC will find these programs in that
1363: directory, and copy or link them to the proper place to for the
1364: cross-compiler to find them when run later.
1365:
1366: The easiest way to provide these files is to build the Binutils
1367: package and GAS. Configure them with the same `--host' and `--target'
1368: options that you use for configuring GNU CC, then build and install
1369: them. They install their executables automatically into the proper
1370: directory. Alas, they do not support all the targets that GNU CC
1371: supports.
1372:
1373: If you want to install libraries to use with the cross-compiler,
1374: such as a standard C library, put them in the directory
1375: `/usr/local/TARGET/lib'; installation of GNU CC copies all all the
1376: files in that subdirectory into the proper place for GNU CC to find
1377: them and link with them. Here's an example of copying some libraries
1378: from a target machine:
1379:
1380: ftp TARGET-MACHINE
1381: lcd /usr/local/TARGET/lib
1382: cd /lib
1383: get libc.a
1384: cd /usr/lib
1385: get libg.a
1386: get libm.a
1387: quit
1388:
1389: The precise set of libraries you'll need, and their locations on the
1390: target machine, vary depending on its operating system.
1391:
1392: Many targets require "start files" such as `crt0.o' and `crtn.o'
1393: which are linked into each executable; these too should be placed in
1394: `/usr/local/TARGET/lib'. There may be several alternatives for
1395: `crt0.o', for use with profiling or other compilation options. Check
1396: your target's definition of `STARTFILE_SPEC' to find out what start
1397: files it uses. Here's an example of copying these files from a target
1398: machine:
1399:
1400: ftp TARGET-MACHINE
1401: lcd /usr/local/TARGET/lib
1402: prompt
1403: cd /lib
1404: mget *crt*.o
1405: cd /usr/lib
1406: mget *crt*.o
1407: quit
1408:
1409: `libgcc.a' and Cross-Compilers
1410: ------------------------------
1411:
1412: Code compiled by GNU CC uses certain runtime support functions
1413: implicitly. Some of these functions can be compiled successfully with
1414: GNU CC itself, but a few cannot be. These problem functions are in the
1415: source file `libgcc1.c'; the library made from them is called
1416: `libgcc1.a'.
1417:
1418: When you build a native compiler, these functions are compiled with
1419: some other compiler-the one that you use for bootstrapping GNU CC.
1420: Presumably it knows how to open code these operations, or else knows how
1421: to call the run-time emulation facilities that the machine comes with.
1422: But this approach doesn't work for building a cross-compiler. The
1423: compiler that you use for building knows about the host system, not the
1424: target system.
1425:
1426: So, when you build a cross-compiler you have to supply a suitable
1427: library `libgcc1.a' that does the job it is expected to do.
1428:
1429: To compile `libgcc1.c' with the cross-compiler itself does not work.
1430: The functions in this file are supposed to implement arithmetic
1.1.1.8 root 1431: operations that GNU CC does not know how to open code for your target
1.1.1.6 root 1432: machine. If these functions are compiled with GNU CC itself, they will
1433: compile into infinite recursion.
1434:
1435: On any given target, most of these functions are not needed. If GNU
1436: CC can open code an arithmetic operation, it will not call these
1437: functions to perform the operation. It is possible that on your target
1438: machine, none of these functions is needed. If so, you can supply an
1439: empty library as `libgcc1.a'.
1440:
1441: Many targets need library support only for multiplication and
1442: division. If you are linking with a library that contains functions for
1443: multiplication and division, you can tell GNU CC to call them directly
1444: by defining the macros `MULSI3_LIBCALL', and the like. These macros
1445: need to be defined in the target description macro file. For some
1446: targets, they are defined already. This may be sufficient to avoid the
1447: need for libgcc1.a; if so, you can supply an empty library.
1448:
1449: Some targets do not have floating point instructions; they need other
1450: functions in `libgcc1.a', which do floating arithmetic. Recent
1451: versions of GNU CC have a file which emulates floating point. With a
1452: certain amount of work, you should be able to construct a floating
1453: point emulator that can be used as `libgcc1.a'. Perhaps future
1454: versions will contain code to do this automatically and conveniently.
1455: That depends on whether someone wants to implement it.
1456:
1.1.1.8 root 1457: Some embedded targets come with all the necessary `libgcc1.a'
1458: routines written in C or assembler. These targets build `libgcc1.a'
1459: automatically and you do not need to do anything special for them.
1460: Other embedded targets do not need any `libgcc1.a' routines since all
1461: the necessary operations are supported by the hardware.
1462:
1.1.1.6 root 1463: If your target system has another C compiler, you can configure GNU
1464: CC as a native compiler on that machine, build just `libgcc1.a' with
1465: `make libgcc1.a' on that machine, and use the resulting file with the
1466: cross-compiler. To do this, execute the following on the target
1467: machine:
1468:
1469: cd TARGET-BUILD-DIR
1.1.1.7 root 1470: ./configure --host=sparc --target=sun3
1.1.1.6 root 1471: make libgcc1.a
1472:
1473: And then this on the host machine:
1474:
1475: ftp TARGET-MACHINE
1476: binary
1477: cd TARGET-BUILD-DIR
1478: get libgcc1.a
1479: quit
1480:
1481: Another way to provide the functions you need in `libgcc1.a' is to
1482: define the appropriate `perform_...' macros for those functions. If
1483: these definitions do not use the C arithmetic operators that they are
1484: meant to implement, you should be able to compile them with the
1485: cross-compiler you are building. (If these definitions already exist
1486: for your target file, then you are all set.)
1487:
1488: To build `libgcc1.a' using the perform macros, use
1489: `LIBGCC1=libgcc1.a OLDCC=./xgcc' when building the compiler.
1490: Otherwise, you should place your replacement library under the name
1491: `libgcc1.a' in the directory in which you will build the
1492: cross-compiler, before you run `make'.
1493:
1494: Cross-Compilers and Header Files
1495: --------------------------------
1496:
1497: If you are cross-compiling a standalone program or a program for an
1498: embedded system, then you may not need any header files except the few
1499: that are part of GNU CC (and those of your program). However, if you
1500: intend to link your program with a standard C library such as `libc.a',
1501: then you probably need to compile with the header files that go with
1502: the library you use.
1503:
1504: The GNU C compiler does not come with these files, because (1) they
1505: are system-specific, and (2) they belong in a C library, not in a
1.1.1.4 root 1506: compiler.
1507:
1.1.1.6 root 1508: If the GNU C library supports your target machine, then you can get
1509: the header files from there (assuming you actually use the GNU library
1510: when you link your program).
1511:
1512: If your target machine comes with a C compiler, it probably comes
1513: with suitable header files also. If you make these files accessible
1514: from the host machine, the cross-compiler can use them also.
1515:
1516: Otherwise, you're on your own in finding header files to use when
1517: cross-compiling.
1518:
1519: When you have found suitable header files, put them in
1520: `/usr/local/TARGET/include', before building the cross compiler. Then
1521: installation will run fixincludes properly and install the corrected
1522: versions of the header files where the compiler will use them.
1523:
1524: Provide the header files before you build the cross-compiler, because
1525: the build stage actually runs the cross-compiler to produce parts of
1526: `libgcc.a'. (These are the parts that *can* be compiled with GNU CC.)
1527: Some of them need suitable header files.
1528:
1529: Here's an example showing how to copy the header files from a target
1530: machine. On the target machine, do this:
1531:
1532: (cd /usr/include; tar cf - .) > tarfile
1533:
1534: Then, on the host machine, do this:
1535:
1536: ftp TARGET-MACHINE
1537: lcd /usr/local/TARGET/include
1538: get tarfile
1539: quit
1540: tar xf tarfile
1541:
1542: Actually Building the Cross-Compiler
1543: ------------------------------------
1544:
1.1.1.4 root 1545: Now you can proceed just as for compiling a single-machine compiler
1546: through the step of building stage 1. If you have not provided some
1547: sort of `libgcc1.a', then compilation will give up at the point where
1548: it needs that file, printing a suitable error message. If you do
1549: provide `libgcc1.a', then building the compiler will automatically
1.1.1.8 root 1550: compile and link a test program called `libgcc1-test'; if you get
1551: errors in the linking, it means that not all of the necessary routines
1552: in `libgcc1.a' are available.
1553:
1554: You must provide the header file `float.h'. One way to do this is
1555: to compile `enquire' and run it on your target machine. The job of
1556: `enquire' is to run on the target machine and figure out by experiment
1557: the nature of its floating point representation. `enquire' records its
1558: findings in the header file `float.h'. If you can't produce this file
1559: by running `enquire' on the target machine, then you will need to come
1560: up with a suitable `float.h' in some other way (or else, avoid using it
1561: in your programs).
1.1.1.3 root 1562:
1563: Do not try to build stage 2 for a cross-compiler. It doesn't work to
1564: rebuild GNU CC as a cross-compiler using the cross-compiler, because
1565: that would produce a program that runs on the target machine, not on the
1566: host. For example, if you compile a 386-to-68030 cross-compiler with
1567: itself, the result will not be right either for the 386 (because it was
1568: compiled into 68030 code) or for the 68030 (because it was configured
1569: for a 386 as the host). If you want to compile GNU CC into 68030 code,
1570: whether you compile it on a 68030 or with a cross-compiler on a 386, you
1571: must specify a 68030 as the host when you configure it.
1572:
1.1.1.6 root 1573: To install the cross-compiler, use `make install', as usual.
1574:
1.1 root 1575: Installing GNU CC on the Sun
1.1.1.5 root 1576: ============================
1577:
1578: On Solaris (version 2.1), do not use the linker or other tools in
1579: `/usr/ucb' to build GNU CC. Use `/usr/ccs/bin'.
1.1 root 1580:
1581: Make sure the environment variable `FLOAT_OPTION' is not set when
1582: you compile `libgcc.a'. If this option were set to `f68881' when
1583: `libgcc.a' is compiled, the resulting code would demand to be linked
1.1.1.3 root 1584: with a special startup file and would not link properly without special
1585: pains.
1.1 root 1586:
1.1.1.3 root 1587: There is a bug in `alloca' in certain versions of the Sun library.
1.1 root 1588: To avoid this bug, install the binaries of GNU CC that were compiled by
1589: GNU CC. They use `alloca' as a built-in function and never the one in
1590: the library.
1591:
1592: Some versions of the Sun compiler crash when compiling GNU CC. The
1.1.1.3 root 1593: problem is a segmentation fault in cpp. This problem seems to be due to
1594: the bulk of data in the environment variables. You may be able to avoid
1595: it by using the following command to compile GNU CC with Sun CC:
1.1 root 1596:
1597: make CC="TERMCAP=x OBJS=x LIBFUNCS=x STAGESTUFF=x cc"
1598:
1599: Installing GNU CC on VMS
1.1.1.5 root 1600: ========================
1.1 root 1601:
1602: The VMS version of GNU CC is distributed in a backup saveset
1603: containing both source code and precompiled binaries.
1604:
1605: To install the `gcc' command so you can use the compiler easily, in
1.1.1.3 root 1606: the same manner as you use the VMS C compiler, you must install the VMS
1607: CLD file for GNU CC as follows:
1.1 root 1608:
1609: 1. Define the VMS logical names `GNU_CC' and `GNU_CC_INCLUDE' to
1.1.1.4 root 1610: point to the directories where the GNU CC executables
1611: (`gcc-cpp.exe', `gcc-cc1.exe', etc.) and the C include files are
1612: kept respectively. This should be done with the commands:
1.1 root 1613:
1.1.1.2 root 1614: $ assign /system /translation=concealed -
1615: disk:[gcc.] gnu_cc
1616: $ assign /system /translation=concealed -
1617: disk:[gcc.include.] gnu_cc_include
1.1 root 1618:
1.1.1.3 root 1619: with the appropriate disk and directory names. These commands can
1620: be placed in your system startup file so they will be executed
1621: whenever the machine is rebooted. You may, if you choose, do this
1622: via the `GCC_INSTALL.COM' script in the `[GCC]' directory.
1.1 root 1623:
1624: 2. Install the `GCC' command with the command line:
1625:
1.1.1.2 root 1626: $ set command /table=sys$common:[syslib]dcltables -
1627: /output=sys$common:[syslib]dcltables gnu_cc:[000000]gcc
1628: $ install replace sys$common:[syslib]dcltables
1.1 root 1629:
1630: 3. To install the help file, do the following:
1631:
1.1.1.4 root 1632: $ library/help sys$library:helplib.hlb gcc.hlp
1.1 root 1633:
1634: Now you can invoke the compiler with a command like `gcc /verbose
1635: file.c', which is equivalent to the command `gcc -v -c file.c' in
1636: Unix.
1637:
1638: If you wish to use GNU C++ you must first install GNU CC, and then
1639: perform the following steps:
1640:
1641: 1. Define the VMS logical name `GNU_GXX_INCLUDE' to point to the
1642: directory where the preprocessor will search for the C++ header
1.1.1.5 root 1643: files. This can be done with the command:
1.1 root 1644:
1.1.1.2 root 1645: $ assign /system /translation=concealed -
1646: disk:[gcc.gxx_include.] gnu_gxx_include
1.1 root 1647:
1.1.1.3 root 1648: with the appropriate disk and directory name. If you are going to
1649: be using libg++, this is where the libg++ install procedure will
1650: install the libg++ header files.
1.1 root 1651:
1652: 2. Obtain the file `gcc-cc1plus.exe', and place this in the same
1653: directory that `gcc-cc1.exe' is kept.
1654:
1.1.1.3 root 1655: The GNU C++ compiler can be invoked with a command like `gcc /plus
1656: /verbose file.cc', which is equivalent to the command `g++ -v -c
1657: file.cc' in Unix.
1.1 root 1658:
1659: We try to put corresponding binaries and sources on the VMS
1660: distribution tape. But sometimes the binaries will be from an older
1.1.1.4 root 1661: version than the sources, because we don't always have time to update
1.1 root 1662: them. (Use the `/version' option to determine the version number of
1663: the binaries and compare it with the source file `version.c' to tell
1.1.1.3 root 1664: whether this is so.) In this case, you should use the binaries you get
1665: to recompile the sources. If you must recompile, here is how:
1.1 root 1666:
1.1.1.5 root 1667: 1. Execute the command procedure `vmsconfig.com' to set up the files
1668: `tm.h', `config.h', `aux-output.c', and `md.', and to create files
1669: `tconfig.h' and `hconfig.h'. This procedure also creates several
1670: linker option files used by `make-cc1.com' and a data file used by
1671: `make-l2.com'.
1.1.1.4 root 1672:
1673: $ @vmsconfig.com
1.1 root 1674:
1675: 2. Setup the logical names and command tables as defined above. In
1676: addition, define the VMS logical name `GNU_BISON' to point at the
1677: to the directories where the Bison executable is kept. This
1678: should be done with the command:
1679:
1.1.1.2 root 1680: $ assign /system /translation=concealed -
1681: disk:[bison.] gnu_bison
1.1 root 1682:
1.1.1.3 root 1683: You may, if you choose, use the `INSTALL_BISON.COM' script in the
1684: `[BISON]' directory.
1.1 root 1685:
1686: 3. Install the `BISON' command with the command line:
1687:
1.1.1.2 root 1688: $ set command /table=sys$common:[syslib]dcltables -
1689: /output=sys$common:[syslib]dcltables -
1690: gnu_bison:[000000]bison
1691: $ install replace sys$common:[syslib]dcltables
1.1 root 1692:
1.1.1.5 root 1693: 4. Type `@make-gcc' to recompile everything (alternatively, submit
1694: the file `make-gcc.com' to a batch queue). If you wish to build
1695: the GNU C++ compiler as well as the GNU CC compiler, you must
1.1.1.3 root 1696: first edit `make-gcc.com' and follow the instructions that appear
1697: in the comments.
1.1 root 1698:
1.1.1.2 root 1699: 5. In order to use GCC, you need a library of functions which GCC
1700: compiled code will call to perform certain tasks, and these
1701: functions are defined in the file `libgcc2.c'. To compile this
1702: you should use the command procedure `make-l2.com', which will
1.1.1.5 root 1703: generate the library `libgcc2.olb'. `libgcc2.olb' should be built
1.1.1.3 root 1704: using the compiler built from the same distribution that
1.1.1.2 root 1705: `libgcc2.c' came from, and `make-gcc.com' will automatically do
1706: all of this for you.
1707:
1.1.1.3 root 1708: To install the library, use the following commands:
1.1.1.2 root 1709:
1.1.1.4 root 1710: $ library gnu_cc:[000000]gcclib/delete=(new,eprintf)
1.1.1.5 root 1711: $ library gnu_cc:[000000]gcclib/delete=L_*
1.1.1.4 root 1712: $ library libgcc2/extract=*/output=libgcc2.obj
1713: $ library gnu_cc:[000000]gcclib libgcc2.obj
1.1.1.2 root 1714:
1.1.1.3 root 1715: The first command simply removes old modules that will be replaced
1.1.1.5 root 1716: with modules from `libgcc2' under different module names. The
1717: modules `new' and `eprintf' may not actually be present in your
1718: `gcclib.olb'--if the VMS librarian complains about those modules
1719: not being present, simply ignore the message and continue on with
1720: the next command. The second command removes the modules that
1721: came from the previous version of the library `libgcc2.c'.
1.1.1.3 root 1722:
1723: Whenever you update the compiler on your system, you should also
1724: update the library with the above procedure.
1725:
1.1.1.4 root 1726: 6. You may wish to build GCC in such a way that no files are written
1.1.1.3 root 1727: to the directory where the source files reside. An example would
1728: be the when the source files are on a read-only disk. In these
1729: cases, execute the following DCL commands (substituting your
1730: actual path names):
1731:
1.1.1.4 root 1732: $ assign dua0:[gcc.build_dir.]/translation=concealed, -
1733: dua1:[gcc.source_dir.]/translation=concealed gcc_build
1.1.1.3 root 1734: $ set default gcc_build:[000000]
1735:
1.1.1.5 root 1736: where the directory `dua1:[gcc.source_dir]' contains the source
1737: code, and the directory `dua0:[gcc.build_dir]' is meant to contain
1738: all of the generated object files and executables. Once you have
1739: done this, you can proceed building GCC as described above. (Keep
1740: in mind that `gcc_build' is a rooted logical name, and thus the
1741: device names in each element of the search list must be an actual
1742: physical device name rather than another rooted logical name).
1.1.1.3 root 1743:
1.1.1.4 root 1744: 7. *If you are building GNU CC with a previous version of GNU CC, you
1.1.1.3 root 1745: also should check to see that you have the newest version of the
1746: assembler*. In particular, GNU CC version 2 treats global constant
1747: variables slightly differently from GNU CC version 1, and GAS
1748: version 1.38.1 does not have the patches required to work with GCC
1.1.1.5 root 1749: version 2. If you use GAS 1.38.1, then `extern const' variables
1.1.1.3 root 1750: will not have the read-only bit set, and the linker will generate
1751: warning messages about mismatched psect attributes for these
1752: variables. These warning messages are merely a nuisance, and can
1753: safely be ignored.
1.1 root 1754:
1.1.1.3 root 1755: If you are compiling with a version of GNU CC older than 1.33,
1.1 root 1756: specify `/DEFINE=("inline=")' as an option in all the
1757: compilations. This requires editing all the `gcc' commands in
1.1.1.5 root 1758: `make-cc1.com'. (The older versions had problems supporting
1.1 root 1759: `inline'.) Once you have a working 1.33 or newer GNU CC, you can
1760: change this file back.
1761:
1.1.1.4 root 1762: 8. If you want to build GNU CC with the VAX C compiler, you will need
1763: to make minor changes in `make-cccp.com' and `make-cc1.com' to
1764: choose alternate definitions of `CC', `CFLAGS', and `LIBS'. See
1765: comments in those files. However, you must also have a working
1766: version of the GNU assembler (GNU as, aka GAS) as it is used as
1767: the back-end for GNU CC to produce binary object modules and is
1768: not included in the GNU CC sources. GAS is also needed to compile
1769: `libgcc2' in order to build `gcclib' (see above); `make-l2.com'
1770: expects to be able to find it operational in
1771: `gnu_cc:[000000]gnu-as.exe'.
1772:
1773: To use GNU CC on VMS, you need the VMS driver programs `gcc.exe',
1774: `gcc.com', and `gcc.cld'. They are distributed with the VMS
1775: binaries (`gcc-vms') rather than the GNU CC sources. GAS is also
1776: included in `gcc-vms', as is Bison.
1777:
1778: Once you have successfully built GNU CC with VAX C, you should use
1779: the resulting compiler to rebuild itself. Before doing this, be
1780: sure to restore the `CC', `CFLAGS', and `LIBS' definitions in
1781: `make-cccp.com' and `make-cc1.com'. The second generation
1782: compiler will be able to take advantage of many optimizations that
1783: must be suppressed when building with other compilers.
1784:
1.1 root 1785: Under previous versions of GNU CC, the generated code would
1.1.1.4 root 1786: occasionally give strange results when linked with the sharable
1.1.1.5 root 1787: `VAXCRTL' library. Now this should work.
1.1 root 1788:
1789: Even with this version, however, GNU CC itself should not be linked
1.1.1.4 root 1790: with the sharable `VAXCRTL'. The version of `qsort' in `VAXCRTL' has a
1791: bug (known to be present in VMS versions V4.6 through V5.5) which
1792: causes the compiler to fail.
1.1 root 1793:
1.1.1.5 root 1794: The executables are generated by `make-cc1.com' and `make-cccp.com'
1795: use the object library version of `VAXCRTL' in order to make use of the
1796: `qsort' routine in `gcclib.olb'. If you wish to link the compiler
1797: executables with the shareable image version of `VAXCRTL', you should
1798: edit the file `tm.h' (created by `vmsconfig.com') to define the macro
1799: `QSORT_WORKAROUND'.
1.1.1.4 root 1800:
1801: `QSORT_WORKAROUND' is always defined when GNU CC is compiled with
1802: VAX C, to avoid a problem in case `gcclib.olb' is not yet available.
1803:
1.1.1.5 root 1804: `collect2'
1805: ==========
1806:
1807: Many target systems do not have support in the assembler and linker
1808: for "constructors"--initialization functions to be called before the
1809: official "start" of `main'. On such systems, GNU CC uses a utility
1810: called `collect2' to arrange to call these functions at start time.
1811:
1812: The program `collect2' works by linking the program once and looking
1813: through the linker output file for symbols with particular names
1814: indicating they are constructor functions. If it finds any, it creates
1815: a new temporary `.c' file containing a table of them, compiles it, and
1816: links the program a second time including that file.
1817:
1818: The actual calls to the constructors are carried out by a subroutine
1819: called `__main', which is called (automatically) at the beginning of
1.1.1.7 root 1820: the body of `main' (provided `main' was compiled with GNU CC). Calling
1821: `__main' is necessary, even when compiling C code, to allow linking C
1822: and C++ object code together. (If you use `-nostdlib', you get an
1823: unresolved reference to `__main', since it's defined in the standard
1824: GCC library. Include `-lgcc' at the end of your compiler command line
1825: to resolve this reference.)
1.1.1.5 root 1826:
1827: The program `collect2' is installed as `ld' in the directory where
1828: the passes of the compiler are installed. When `collect2' needs to
1829: find the *real* `ld', it tries the following file names:
1830:
1.1.1.7 root 1831: * `real-ld' in the directories listed in the compiler's search
1.1.1.5 root 1832: directories.
1833:
1.1.1.7 root 1834: * `real-ld' in the directories listed in the environment variable
1835: `PATH'.
1.1.1.5 root 1836:
1.1.1.7 root 1837: * The file specified in the `REAL_LD_FILE_NAME' configuration macro,
1838: if specified.
1.1.1.5 root 1839:
1.1.1.7 root 1840: * `ld' in the compiler's search directories, except that `collect2'
1841: will not execute itself recursively.
1.1.1.5 root 1842:
1843: * `ld' in `PATH'.
1844:
1845: "The compiler's search directories" means all the directories where
1846: `gcc' searches for passes of the compiler. This includes directories
1847: that you specify with `-B'.
1848:
1.1.1.6 root 1849: Cross-compilers search a little differently:
1.1.1.5 root 1850:
1851: * `real-ld' in the compiler's search directories.
1852:
1853: * `TARGET-real-ld' in `PATH'.
1854:
1.1.1.7 root 1855: * The file specified in the `REAL_LD_FILE_NAME' configuration macro,
1856: if specified.
1857:
1858: * `ld' in the compiler's search directories.
1859:
1.1.1.5 root 1860: * `TARGET-ld' in `PATH'.
1861:
1.1.1.7 root 1862: `collect2' explicitly avoids running `ld' using the file name under
1863: which `collect2' itself was invoked. In fact, it remembers up a list
1864: of such names--in case one copy of `collect2' finds another copy (or
1865: version) of `collect2' installed as `ld' in a second place in the
1866: search path.
1.1.1.5 root 1867:
1.1.1.7 root 1868: `collect2' searches for the utilities `nm' and `strip' using the
1869: same algorithm as above for `ld'.
1.1.1.5 root 1870:
1.1.1.6 root 1871: Standard Header File Directories
1872: ================================
1873:
1874: `GCC_INCLUDE_DIR' means the same thing for native and cross. It is
1875: where GNU CC stores its private include files, and also where GNU CC
1876: stores the fixed include files. A cross compiled GNU CC runs
1877: `fixincludes' on the header files in `$(tooldir)/include'. (If the
1878: cross compilation header files need to be fixed, they must be installed
1879: before GNU CC is built. If the cross compilation header files are
1880: already suitable for ANSI C and GNU CC, nothing special need be done).
1881:
1882: `GPLUS_INCLUDE_DIR' means the same thing for native and cross. It
1883: is where `g++' looks first for header files. `libg++' installs only
1884: target independent header files in that directory.
1885:
1886: `LOCAL_INCLUDE_DIR' is used only for a native compiler. It is
1887: normally `/usr/local/include'. GNU CC searches this directory so that
1888: users can install header files in `/usr/local/include'.
1889:
1890: `CROSS_INCLUDE_DIR' is used only for a cross compiler. GNU CC
1891: doesn't install anything there.
1892:
1893: `TOOL_INCLUDE_DIR' is used for both native and cross compilers. It
1894: is the place for other packages to install header files that GNU CC will
1895: use. For a cross-compiler, this is the equivalent of `/usr/include'.
1896: When you build a cross-compiler, `fixincludes' processes any header
1897: files in this directory.
1898:

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.