--- gcc/INSTALL 2018/04/24 16:41:07 1.1.1.3 +++ gcc/INSTALL 2018/04/24 17:00:53 1.1.1.17 @@ -1,124 +1,444 @@ -This is a copy of one node from the Info file internals-1. +This is a copy of one node from the Info file gcc.info-3. For full information on installing and porting GCC, refer to the -internals manual: +GCC manual: - Info file internals - TeX output internals.dvi - TeX source internals.texinfo + Info file gcc.info + TeX output gcc.dvi + TeX source gcc.texinfo Installing GNU CC ***************** -Here is the procedure for installing GNU CC on a Unix system. + Here is the procedure for installing GNU CC on a Unix system. * Menu: +* Other Dir:: Compiling in a separate directory (not where the source is). +* Sun Install:: See below for installation on the Sun. +* 3B1 Install:: See below for installation on the 3B1. +* SCO Install:: See below for installation on SCO System V 3.2. (Or ESIX.) * VMS Install:: See below for installation on VMS. +* HPUX Install:: See below for installation on HPUX. +* Tower Install:: See below for installation on an NCR Tower. - - 1. Edit `Makefile'. If you are using HPUX, or any form of system V, you - must make a few changes described in comments at the beginning of the - file. + 1. Edit `Makefile'. If you are using HPUX, or any form of system V, + you must make a few changes described in comments at the beginning + of the file. Genix requires changes also, and so does the Pyramid. 2. On a Sequent system, go to the Berkeley universe. - 3. Choose configuration files. + 3. Choose configuration files. The easy way to do this is to run the + command file `config.gcc' with a single argument, which specifies + the type of machine (and in some cases which operating system). + + Here is a list of the possible arguments: + + `vax' + Vaxes running BSD. + + `vms' + Vaxes running VMS. + + `vax-sysv' + Vaxes running system V. + + `i386-sysv' + Intel 386 PCs running system V. + + `i386-sysv-gas' + Intel 386 PCs running system V, using the GNU assembler and + GNU linker. + + `i386-sysv4' + Intel 386 PCs running system V.4. You must run the shell + script `fixincludes-V4' in order for GNU CC to work properly. + You must also uncomment some lines in `Makefile'. + + `sequent-i386' + Sequent with Intel 386 processors. + + `i386-aix' + Intel 386 PCs or PS/2s running AIX. + + `sun2' + Sun 2 running system version 2 or 3. + + `sun3' + Sun 3 running system version 4, with 68881. Note there we do + not provide a configuration file to use an FPA by default, + because programs that establish signal handlers for floating + point traps inherently cannot work with the FPA. + + `sun3-nfp' + Sun 3 running system version 4, without 68881. + + `sun4' + Sun 4 running system version 4. *Note Incompatibilities::, + for calling convention incompatibilities on the Sun 4 (sparc). + + `sun2-os4' + Sun 2 running system version 4. + + `sun3-os3' + Sun 3 running system version 2 or 3, with 68881. + + `sun3-nfp-os3' + Sun 3 running system version 2 or 3, without 68881. + + `sun4-os3' + Sun 4 running system version 2 or 3. *Note + Incompatibilities::, for calling convention incompatibilities + on the Sun 4 (sparc). + + `sun386' + Sun 386 ("roadrunner"). + + `alliant' + Alliant FX/8 computer. Note that the standard installed C + compiler in Concentrix 5.0 has a bug which prevent it from + compiling GNU CC correctly. You can patch the compiler bug + as follows: + + cp /bin/pcc ./pcc + adb -w ./pcc - << EOF + 15f6?w 6610 + EOF + + Then you must use the `-ip12' option when compiling GNU CC + with the patched compiler, as shown here: + + make CC="./pcc -ip12" CFLAGS=-w + + Note also that Alliant's version of DBX does not manage to + work with the output from GNU CC. + + `tahoe' + The tahoe computer (running BSD, and using DBX). + + `decstation' + The DEC 3100 Mips machine ("pmax"). Note that GNU CC cannot + generate debugging information in the unusual format used on + the Mips. + + `mips-sysv-os5' + The Mips computer, RS series, with the System V environment + running on revision 5.00 of RISC-OS as default. Note that GNU + CC cannot generate debugging information in the unusual + format used on the Mips, and also cannot be used to create + programs that use shared libraries. + + `mips-sysv' + The Mips computer, RS series, with the System V environment + as default. Note that GNU CC cannot generate debugging + information in the unusual format used on the Mips. + + `mips-bsd43-os5' + The Mips computer, RS series, with the BSD 4.3 environment + running revision 5.00 of RISC-OS as default. Note that GNU CC + cannot generate debugging information in the unusual format + used on the Mips, and also cannot be used to create programs + that use shared libraries. + + `mips-bsd43' + The Mips computer, RS series, with the BSD 4.3 environment as + default. Note that GNU CC cannot generate debugging + information in the unusual format used on the Mips. + + `mips-os5' + The Mips computer, M series running revision 5.00 of RISC-OS. + Note that GNU CC cannot generate debugging information in the + unusual format used on the Mips, and also cannot be used to + create programs that use shared libraries. + + `mips' + The Mips computer, M series. Note that GNU CC cannot + generate debugging information in the unusual format used on + the Mips. + + `iris' + Another variant of the Mips computer, the Silicon Graphics + Iris 4D. Note that GNU CC cannot generate debugging + information in the unusual format used on the Mips. + + `convex-c1' + Convex C1 computer. With operating system version 9, use `cc + -pcc' as the compilation command when building stage 1 of GNU + CC. + + `convex-c2' + Convex C2 computer. With operating system version 9, use `cc + -pcc' as the compilation command when building stage 1 of GNU + CC. + + `pyramid' + Pyramid computer. + + `hp9k320' + HP 9000 series 300 using HPUX assembler. Note there is no + support in GNU CC for HP's debugger; thus, `-g' is not + available in this configuration. + + `hp9k320-gas' + HP 9000 series 300 using GNU assembler, linker and debugger. + This requires the HP-adapt package, which is available along + with the GNU linker as part of the "binutils" distribution. + This is on the GNU CC distribution tape. + + `hp9k320-old' + HP 9000 series 300 using HPUX assembler, in operating system + versions older than 6.5. Note there is no support in GNU CC + for HP's debugger; thus, `-g' is not available in this + configuration. + + `hp9k320-bsd' + HP 9000 series 300 running BSD. + + `hp9k200-bsd' + HP 9000 series 200 running BSD. Note that the C compiler + that comes with this system cannot compile GNU CC; contact + `law@super.org' to get binaries of GNU CC for bootstrapping. + Additionally, a minor patch is necessary if you wish to build + kernels with GNU CC; contact `law@super.org' to get a copy of + the patch. + + `isi68' + ISI 68000 or 68020 system with a 68881. + + `isi68-nfp' + ISI 68000 or 68020 system without a 68881. + + `news800' + Sony NEWS 68020 system. + + `next' + NeXT system. + + `tower' + NCR Tower 32 system. + + `altos' + Altos 3068. Note that you must use the GNU assembler, linker + and debugger, with COFF-encapsulation. Also, you must fix a + kernel bug. Details in the file `ALTOS-README'. + + `3b1' + AT&T 3b1, a.k.a. 7300 PC. Note that special procedures are + needed to compile GNU CC with this machine's standard C + compiler, due to bugs in that compiler. *Note 3b1 Install::. + You can bootstrap it more easily with previous versions of + GNU CC if you have them. + + `3b1-gas' + AT&T 3b1 using the GNU assembler. + + `sequent-ns32k' + Sequent containing ns32000 processors. + + `encore' + Encore ns32000 system. + + `genix' + National Semiconductor ns32000 system. + + `88000' + Motorola 88000 processor. This port is not finished. + + Here we spell out what files need to be set up: * Make a symbolic link named `config.h' to the top-level config - file for the machine you are using (*Note Config::.). This file - is responsible for defining information about the host machine. - It includes `tm.h'. - - The file's name should be `config-MACHINE.h'. On VMS, use - `config-vms.h' rather than `config-vax.h'. On the HP 9000 series - 300, use `config-hp9k3.h' rather than `config-m68k.h'. - - If your system does not support symbolic links, you might want to - set up `config.h' to contain a `#include' command which refers to - the appropriate file. + file for the machine you are using (*note Config::.). This + file is responsible for defining information about the host + machine. It includes `tm.h'. + + The file is located in the subdirectory `config'. Its name + should be `xm-MACHINE.h', with these exceptions: + + `xm-vms.h' + for vaxen running VMS. + + `xm-vaxv.h' + for vaxen running system V. + + `xm-i386v.h' + for Intel 80386's running system V. + + `xm-sun386i.h' + for Sun roadrunner running any version of the operating + system. + + `xm-hp9k320.h' + for the HP 9000 series 300. + + `xm-genix.h' + for the ns32000 running Genix + + If your system does not support symbolic links, you might + want to set up `config.h' to contain a `#include' command + which refers to the appropriate file. * Make a symbolic link named `tm.h' to the machine-description - macro file for your machine (its name should be `tm-MACHINE.h'). + macro file for your machine. It should be in the subdirectory + `config' and its name should be `tm-MACHINE.h'. - For the 68000/68020, do not use `tm-m68k.h' directly; instead use - one of the files `tm-sun3.h', `tm-sun2.h', `tm-isi68.h', - `tm-news800.h' or `tm-3b1.h'. Each of those files includes - `tm-m68k.h' but sets up a few things differently as appropriate - to the specific model of machine. - - There are two files you can use for a 680x0 running HPUX: - `tm-hp9k320.h' and `tm-hp9k320g.h'. Use the former if you are - installing GNU CC alone. The latter is for another option where - GNU CC together with the GNU assembler, linker, debugger and - other utilities are used to replace all of HPUX that deals with - compilation. Not all of the pieces of GNU software needed for - this mode of operation are as yet in distribution; full - instructions will appear here in the future. + If your system is a 68000, don't use the file `tm-m68k.h' + directly. Instead, use one of these files: - For the vax, use `tm-vax.h' on Unix, or `tm-vms.h' on VMS. + `tm-sun3.h' + for Sun 3 machines with 68881. - For the SPARC, use `tm-sparc.h'. Note that the SPARC support - *has a fatal bug*; to use it, you will have to debug it. + `tm-sun3-nfp.h' + for Sun 3 machines with no hardware floating point. + + `tm-sun3os3.h' + for Sun 3 machines with 68881, running Sunos version 3. + + `tm-sun3os3nf.h' + for Sun 3 machines with no hardware floating point, + running Sunos version 3. + + `tm-sun2.h' + for Sun 2 machines. + + `tm-3b1.h' + for AT&T 3b1 (aka 7300 Unix PC). + + `tm-isi68.h' + for Integrated Solutions systems. This file assumes you + use the GNU assembler. + + `tm-isi68-nfp.h' + for Integrated Solutions systems without a 68881. This + file assumes you use the GNU assembler. + + `tm-news800.h' + for Sony NEWS systems. + + `tm-hp9k320.h' + for HPUX systems, if you are using GNU CC with the + system's assembler and linker. + + `tm-hp9k320g.h' + for HPUX systems, if you are using the GNU assembler, + linker and other utilities. Not all of the pieces of + GNU software needed for this mode of operation are as + yet in distribution; full instructions will appear here + in the future. + + `tm-tower-as.h' + for NCR Tower 32 systems, using the standard system + assembler. + + For the vax, use `tm-vax.h' on BSD Unix, `tm-vaxv.h' on + system V, or `tm-vms.h' on VMS. + + For the Motorola 88000, use `tm-m88k.h'. The support for the + 88000 does not currently work; it requires extensive changes + which we hope to reconcile in version 2. + + For the 80386, don't use `tm-i386.h' directly. Use + `tm-i386v.h' if the target machine is running system V, + `tm-i386gas.h' if it is running system V but you are using the + GNU assembler and linker, `tm-seq386.h' for a Sequent 386 + system, or `tm-compaq.h' for a Compaq, or `tm-sun386i.h' for + a Sun 386 system. + + For the Mips computer, there are five choices: `tm-mips.h' + for the M series, `tm-mips-bsd.h' for the RS series with BSD, + `tm-mips-sysv.h' for the RS series with System V, `tm-iris.h' + for the Iris version of the machine, and `tm-decstatn.h' for + the Decstation. For the 32000, use `tm-sequent.h' if you are using a Sequent - machine, or `tm-encore.h' for an Encore machine; otherwise, - perhaps `tm-ns32k.h' will work for you. If you are trying to use - GNU CC on GENIX, you may need to get the version of `malloc' from - GNU Emacs instead of the system library version, and you probably - need to cause the following assembler code to be executed in - `crt0.o' in order to run the GNU CC output: - - lprd sb,$0 - sprd mod,r0 - movqd $0,0(r0) + machine, or `tm-encore.h' for an Encore machine, or + `tm-genix.h' if you are using Genix version 3; otherwise, + perhaps `tm-ns32k.h' will work for you. + + Note that Genix has bugs in `alloca' and `malloc'; you must + get the compiled versions of these from GNU Emacs and edit + GNU CC's `Makefile' to use them. Note that Encore systems are supported only under BSD. + For Sparc (Sun 4) machines, use `tm-sparc.h' with operating + system version 4, and `tm-sun4os3.h' with system version 3. + + For Convex systems before version 8.1, use `tm-conv1os7.h' or + `tm-conv2os7.h'. For versions 8.1 and greater, use + `tm-convex1.h' or `tm-convex2.h'. You should also bootstrap + GCC with `pcc' rather than `cc'; one way to do this is with + the following commands. + + ln -s /bin/pcc ./cc + set path = (. $path) + * Make a symbolic link named `md' to the machine description - pattern file (its name should be `MACHINE.md'). + pattern file. It should be in the `config' subdirectory and + its name should be `MACHINE.md'; but MACHINE is often not the + same as the name used in the `tm.h' file because the `md' + files are more general. * Make a symbolic link named `aux-output.c' to the output - subroutine file for your machine (its name should be - `OUTPUT-MACHINE.c'). + subroutine file for your machine. It should be in the + `config' subdirectory and its name should be `out-MACHINE.c'. + + 4. Make sure the Bison parser generator is installed. (This is + unnecessary if the Bison output files `c-parse.tab.c' and `cexp.c' + are more recent than `c-parse.y' and `cexp.y' and you do not plan + to change the `.y' files.) - 4. Make sure the Bison parser generator is installed. (This is unnecessary - if the Bison output files `parse.tab.c' and `cexp.c' are more recent - than `parse.y' and `cexp.y' and you do not plan to change the `.y' - files.) - - Note that if you have an old version of Bison you may get an error - from the line with the `%expect' directive. If so, simply remove that - line from `parse.y' and proceed. - - 5. If you are using a Sun, make sure the environment variable - `FLOAT_OPTION' is not set. If this option were set to `f68881' when - `gnulib' is compiled, the resulting code would demand to be linked - with a special startup file and will not link properly without special - pains. + Bison versions older than Sept 8, 1988 will produce incorrect + output for `c-parse.tab.c'. + + 5. If you have a previous version of GCC installed, then chances are + you can compile the new version with that. Do the following: + + make CC="gcc -O" + + Since this produces an optimized executable right away, there is + no need to bootstrap the result with itself except to test it. + Therefore, you can skip directly to the `make install' step below. 6. Build the compiler. Just type `make' in the compiler directory. - 7. Move the first-stage object files and executables into a subdirectory - with this command: + Ignore any warnings you may see about "statement not reached" in + the `insn-emit.c'; they are normal. Any other compilation errors + may represent bugs in the port to your machine or operating + system, and should be investigated and reported (*note Bugs::.). + + Some commercial compilers fail to compile GNU CC because they have + bugs or limitations. For example, the Microsoft compiler is said + to run out of macro space. Some Ultrix compilers run out of + expression space; then you need to break up the statement where + the problem happens. + + 7. If you are using COFF-encapsulation, you must convert `gnulib' to + a GNU-format library at this point. See the file `README-ENCAP' + in the directory containing the GNU binary file utilities, for + directions. + + 8. Move the first-stage object files and executables into a + subdirectory with this command: make stage1 - The files are moved into a subdirectory named `stage1'. Once - installation is complete, you may wish to delete these files with `rm - -r stage1'. + The files are moved into a subdirectory named `stage1'. Once + installation is complete, you may wish to delete these files with + `rm -r stage1'. - 8. Recompile the compiler with itself, with this command: + 9. Recompile the compiler with itself, with this command: make CC=stage1/gcc CFLAGS="-g -O -Bstage1/" - On a 68000 or 68020 system lacking floating point hardware, unless you - have selected a `tm.h' file that expects by default that there is no - such hardware, do this instead: + This is called making the stage 2 compiler. + + On a 68000 or 68020 system lacking floating point hardware, unless + you have selected a `tm.h' file that expects by default that there + is no such hardware, do this instead: make CC=stage1/gcc CFLAGS="-g -O -Bstage1/ -msoft-float" - 9. If you wish to test the compiler by compiling it with itself one more - time, do this: + 10. If you wish to test the compiler by compiling it with itself one + more time, do this (in C shell): make stage2 make CC=stage2/gcc CFLAGS="-g -O -Bstage2/" @@ -126,96 +446,433 @@ Here is the procedure for installing GNU cmp $file stage2/$file end - This will notify you if any of these stage 3 object files differs from - those of stage 2. Any difference, no matter how innocuous, indicates + This is called making the stage 3 compiler. Aside from the `-B' + option, the options should be the same as when you made the stage 2 + compiler. + + The `foreach' command (written in C shell) will notify you if any + of these stage 3 object files differs from those of stage 2. On + BSD systems, any difference, no matter how innocuous, indicates that the stage 2 compiler has compiled GNU CC incorrectly, and is - therefore a potentially serious bug which you should investigate and - report (*Note Bugs::.). + therefore a potentially serious bug which you should investigate + and report (*note Bugs::.). - 10. Install the compiler driver, the compiler's passes and run-time support. - You can use the following command: + On systems that use COFF object files, bytes 5 to 8 will always be + different, since it is a timestamp. On these systems, you can do + the comparison as follows (in Bourne shell): + + for file in *.o; do + echo $file + tail +10c $file > foo1 + tail +10c stage2/$file > foo2 + cmp foo1 foo2 + done + + On MIPS machines, you should use the shell script `ecoff-cmp' to + compare two object files. + + 11. Install the compiler driver, the compiler's passes and run-time + support. You can use the following command: make install - This copies the files `cc1', `cpp' and `gnulib' to files `gcc-cc1', - `gcc-cpp' and `gcc-gnulib' in directory `/usr/local/lib', which is - where the compiler driver program looks for them. It also copies the - driver program `gcc' into the directory `/usr/local', so that it - appears in typical execution search paths. + This copies the files `cc1', `cpp' and `gnulib' to files + `gcc-cc1', `gcc-cpp' and `gcc-gnulib' in directory + `/usr/local/lib', which is where the compiler driver program looks + for them. It also copies the driver program `gcc' into the + directory `/usr/local/bin', so that it appears in typical + execution search paths. + + *Warning: there is a bug in `alloca' in the Sun library. To avoid + this bug, install the binaries of GNU CC that were compiled by GNU + CC. They use `alloca' as a built-in function and never the one in + the library.* *Warning: the GNU CPP may not work for `ioctl.h', `ttychars.h' and - other system header files unless the `-traditional' option is used.* - The bug is in the header files: at least on some machines, they rely - on behavior that is incompatible with ANSI C. This behavior consists - of substituting for macro argument names when they appear inside of - character constants. The `-traditional' option tells GNU CC to behave - the way these headers expect. + other system header files unless the `-traditional' option is + used.* The bug is in the header files: at least on some machines, + they rely on behavior that is incompatible with ANSI C. This + behavior consists of substituting for macro argument names when + they appear inside of character constants. The `-traditional' + option tells GNU CC to behave the way these headers expect. - Because of this problem, you might prefer to configure GNU CC to use - the system's own C preprocessor. To do so, make the file + Because of this problem, you might prefer to configure GNU CC to + use the system's own C preprocessor. To do so, make the file `/usr/local/lib/gcc-cpp' a link to `/lib/cpp'. - Alternatively, on Sun systems and 4.3BSD at least, you can correct the - include files by running the shell script `fixincludes'. This + Alternatively, on Sun systems and 4.3BSD at least, you can correct + the include files by running the shell script `fixincludes'. This installs modified, corrected copies of the files `ioctl.h', - `ttychars.h' and many others, in a special directory where only GNU CC - will normally look for them. + `ttychars.h' and many others, in a special directory where only + GNU CC will normally look for them. This script will work on + various systems because it chooses the files by searching all the + system headers for the problem cases that we know about. + + Use the following command to do this: + + make includes + + If you selected a different directory for GNU CC installation when + you installed it, by specifying the Make variable `prefix' or + `libdir', specify it the same way in this command. + + Note that some systems are starting to come with ANSI C system + header files. On these systems, don't run `fixincludes'; it may + not work, and is certainly not necessary. + + *Warning:* `fixincludes' does not work on many MIPS systems, + because those systems come with circular symbolic links which cause + `ls -lR' to go into an infinite loop. + + If you cannot install the compiler's passes and run-time support in +`/usr/local/lib', you can alternatively use the `-B' option to specify +a prefix by which they may be found. The compiler concatenates the +prefix with the names `cpp', `cc1' and `gnulib'. Thus, you can put the +files in a directory `/usr/foo/gcc' and specify `-B/usr/foo/gcc/' when +you run GNU CC. + + Also, you can specify an alternative default directory for these +files by setting the Make variable `libdir' when you make GNU CC. + + +File: gcc.info, Node: Other Dir, Next: Sun Install, Prev: Installation, Up: Installation + +Compilation in a Separate Directory +=================================== + + If you wish to build the object files and executables in a directory +other than the one containing the source files, here is what you must +do differently: + + 1. Go to that directory before running `config.gcc': + + mkdir gcc-sun3 + cd gcc-sun3 + + On systems that do not support symbolic links, this directory must + be on the same file system as the source code directory. + + 2. Specify where to find `config.gcc' when you run it: - See the file `fixincludes' for a list of all the files we know to - require correction. + ../gcc-1.36/config.gcc ... -If you cannot install the compiler's passes and run-time support in -`/usr/local/lib', you can alternatively use the `-B' option to specify a -prefix by which they may be found. The compiler concatenates the prefix -with the names `cpp', `cc1' and `gnulib'. Thus, you can put the files in -a directory `/usr/foo/gcc' and specify `-B/usr/foo/gcc/' when you run GNU CC. + 3. Specify where to find the sources, as an argument to `config.gcc': -Also, you can specify an alternative default directory for these files by -setting the Make variable `libdir' when you make GNU CC. + ../gcc-1.36/config.gcc -srcdir=../gcc-1.36 sun3 + + The `-srcdir=DIR' option is not needed when the source directory + is the parent of the current directory, because `config.gcc' + detects that case automatically. + + Now, you can run `make' in that directory. You need not repeat the +configuration steps shown above, when ordinary source files change. You +must, however, run `config.gcc' again when the configuration files +change, if your system does not support symbolic links. + + +File: gcc.info, Node: Sun Install, Next: 3b1 Install, Prev: Other Dir, Up: Installation + +Installing GNU CC on the Sun +============================ + + Make sure the environment variable `FLOAT_OPTION' is not set when +you compile `gnulib'. If this option were set to `f68881' when +`gnulib' is compiled, the resulting code would demand to be linked with +a special startup file and would not link properly without special +pains. + + There is a bug in `alloca' in certain versions of the Sun library. +To avoid this bug, install the binaries of GNU CC that were compiled by +GNU CC. They use `alloca' as a built-in function and never the one in +the library. + + Some versions of the Sun compiler crash when compiling GNU CC, with a +segmentation fault in cpp. This can sometimes be due to the bulk of +data in the environment variables. You may be able to avoid it by using +the following command to compile GNU CC with Sun CC: + + make CC="TERMCAP=x OBJS=x LIBFUNCS=x STAGESTUFF=x cc" + + Another problem that often happens on Suns is that you get a crash +when building stage 2, when `genflags' is run. + + One reason for such as crash is if you configured GNU CC for the +wrong version of SunOS. Starting with version 1.38, configurations +`sun3' and `sun4' are for SunOS 4, so this problem should no longer +happen. + + Another cause of the same symptom is having installed the GNU linker +with an earlier version of SunOS. The version that worked before +stopped working due to a change in the format of executables in SunOS +4.1. Many sites have installed the GNU linker as +`/usr/local/lib/gcc-ld', often as part of installing GNU C++. So if +you get such crashes and you have used the proper configuration, try +deleting `/usr/local/lib/gcc-ld'. + + The current version of the GNU linker, found in the current binutils +release, does work with SunOS 4.1.  -File: internals, Node: VMS Install, Prev: Installation, Up: Installation +File: gcc.info, Node: 3b1 Install, Next: SCO Install, Prev: Sun Install, Up: Installation + +Installing GNU CC on the 3b1 +============================ + + Installing GNU CC on the 3b1 is difficult if you do not already have +GNU CC running, due to bugs in the installed C compiler. However, the +following procedure might work. We are unable to test it. + + 1. Comment out the `#include "config.h"' line on line 37 of `cccp.c' + and do `make cpp'. This makes a preliminary version of GNU cpp. + + 2. Save the old `/lib/cpp' and copy the preliminary GNU cpp to that + file name. + + 3. Undo your change in `cccp.c', or reinstall the original version, + and do `make cpp' again. + + 4. Copy this final version of GNU cpp into `/lib/cpp'. + + 5. Replace every occurrence of `obstack_free' in `tree.c' with + `_obstack_free'. + + 6. Run `make' to get the first-stage GNU CC. + + 7. Reinstall the original version of `/lib/cpp'. + + 8. Now you can compile GNU CC with itself and install it in the normal + fashion. + + If you have installed an earlier version of GCC, you can compile the +newer version with that. However, you will run into trouble compiling +`gnulib', since that is normally compiled with CC. To solve the +problem, uncomment this line in `Makefile': + + CCLIBFLAGS = -B/usr/local/lib/gcc- -tp -Wp,-traditional + + +File: gcc.info, Node: SCO Install, Next: VMS Install, Prev: 3B1 Install, Up: Installation + +Installing GNU CC on SCO System V 3.2 +===================================== + + The compiler that comes with this system does not work properly with +`-O'. Therefore, you should redefine the Make variable `CCLIBFLAGS' +not to use `-O'. + + You should also edit `Makefile' to enable the lines that set `CLIB' +to `-lPW', and the ones specifically labeled as being for SCO, that set +`RANLIB', and that set `CC' and `OLDCC' to `rcc -Di386 -DM_UNIX +-DM_I386 -DM_SYSV -DM_COFF'. + + Also, edit the definition of `USER_H' to remove the file `limits.h'. + + Then you can run `config.gcc i386-sco' and finish building GNU CC +normally. + + Note that the function `memmove' is broken in 3.2v2; it clobbers +register `%ebx'. See the file `sco-memmove.s'. + + The same recipe should work on ESIX, but use `config.gcc i386-esix' +instead. + + +File: gcc.info, Node: VMS Install, Next: HPUX Install, Prev: SCO Install, Up: Installation Installing GNU CC on VMS ======================== -The VMS version of GNU CC is distributed in an unusual tape format which -consists of several tape files. The first is a command file; the second is -an executable program which reads Unix tar format; the third is another -command file which uses this program to read the remainder of the tape. - -To load the tape, it suffices to mount it `/foreign' and then do `@mta0:' -to execute the command file at the beginning of the tape. - -The tape contains executables and object files as well as sources, so no -compilation is necessary unless you change the sources. (This is a good -thing, since you probably don't have any other C compiler.) If you must -recompile, here is how: - - 1. Copy the file `tm-vms.h' to `tm.h', `config-vms.h' to `config.h', - `vax.md' to `md.' and `output-vax.c' to `aux-output.c'. - - 2. Type `@make' to do recompile everything. - -To install the `GCC' command so you can use the compiler easily, in the -same manner as you use the VMS C compiler, you must install the VMS CLD -file for GNU CC as follows: - - 1. Define the VMS logical names `GNU_CC' and `GNU_CC_INCLUDE' to point to - the directories where the GNU CC executables (`gcc-cpp', `gcc-cc1', - etc.) and the C include files are kept. This should be done with the - commands: - - $ assign /super /system disk:[gcc] gnu_cc - $ assign /super /system disk:[gcc.include] gnu_cc_include - - with the appropriate disk and directory names. These commands can be - placed in your system startup file so they will be executed whenever - the machine is rebooted. + The VMS version of GNU CC is distributed in a backup saveset +containing both source code and precompiled binaries. + + To install the `gcc' command so you can use the compiler easily, in +the same manner as you use the VMS C compiler, you must install the VMS +CLD file for GNU CC as follows: + + 1. Define the VMS logical names `GNU_CC' and `GNU_CC_INCLUDE' to + point to the directories where the GNU CC executables (`gcc-cpp', + `gcc-cc1', etc.) and the C include files are kept. This should be + done with the commands: + + $ assign /super /system disk:[gcc.] gnu_cc + $ assign /super /system disk:[gcc.include.] gnu_cc_include + + with the appropriate disk and directory names. These commands can + be placed in your system startup file so they will be executed + whenever the machine is rebooted. You may, if you choose, do this + via the `GCC_INSTALL.COM' script in the `[GCC]' directory. 2. Install the `GCC' command with the command line: - $ set command /table=sys$library:dcltables gnu_cc:gcc + $ set command /table=sys$library:dcltables gnu_cc:[000000]gcc + + 3. To install the help file, do the following: + + $ lib/help sys$library:helplib.hlb gcc.hlp Now you can invoke the compiler with a command like `gcc /verbose - file.c', which is equivalent to the command `gcc -v -c file.c' in Unix. + file.c', which is equivalent to the command `gcc -v -c file.c' in + Unix. + + We try to put corresponding binaries and sources on the VMS +distribution tape. But sometimes the binaries will be from an older +version that the sources, because we don't always have time to update +them. (Use the `/verbose' option to determine the version number of +the binaries and compare it with the source file `version.c' to tell +whether this is so.) In this case, you should use the binaries you get +to recompile the sources. If you must recompile, here is how: + + 1. Copy the file `tm-vms.h' to `tm.h', `xm-vms.h' to `config.h', + `vax.md' to `md.' and `out-vax.c' to `aux-output.c'. The files to + be copied are found in the subdirectory named `config'; they + should be copied to the main directory of GNU CC. + + 2. Setup the logical names and command tables as defined above. In + addition, define the vms logical name `GNU_BISON' to point at the + to the directories where the Bison executable is kept. This + should be done with the command: + + $ assign /super /system disk:[bison.] gnu_bison + + You may, if you choose, use the `INSTALL_BISON.COM' script in the + `[BISON]' directory. + + 3. Install the `BISON' command with the command line: + + $ set command /table=sys$library:dcltables gnu_bison:[000000]bison + + 4. Type `@make' to do recompile everything. + + If you are compiling with a version of GNU CC older than 1.33, + specify `/DEFINE=("inline=")' as an option in all the + compilations. This requires editing all the `gcc' commands in + `make-cc1.com'. (The older versions had problems supporting + `inline'.) Once you have a working 1.33 or newer GNU CC, you can + change this file back. + + Due to the differences between the filesystems of Unix and VMS, the +preprocessor attempts to translate the names of include files into +something that VMS will understand. The basic strategy is to prepend a +prefix to the specification of the include file, convert the whole +filename to a VMS filename, and then try to open the file. The +preprocessor tries various prefixes until one of them succeeds. + + The first prefix is the `GNU_CC_INCLUDE:' logical name: this is +where GNU_C header files are traditionally stored. If a header file is +not found there, `SYS$SYSROOT:[SYSLIB.]' is tried next. If the +preprocessor is still unable to locate the file, it then assumes that +the include file specification is a valid VMS filename all by itself, +and it uses this filename to attempt to open the include file. If none +of these strategies succeeds, the preprocessor reports an error. + + If you wish to store header files in non-standard locations, then you +can assign the logical `GNU_CC_INCLUDE' to be a search list, where each +element of the list is suitable for use with a rooted logical. + + With this version of GNU CC, `const' global variables now work +properly. Unless, however, the `const' modifier is also specified in +every external declaration of the variable in all of the source files +that use that variable, the linker will issue warnings about conflicting +attributes for the variable, since the linker does not know if the +variable should be read-only. The program will still work, but the +variable will be placed in writable storage. + + Due to an assembler bug, offsets to static constants are sometimes +incorrectly evaluated. This bug is present in GAS 1.38.1, and should be +fixed in the next version. + + Under previous versions of GNU CC, the generated code would +occasionally give strange results when linked to the sharable `VAXCRTL' +library. Now this should work. + + Even with this version, however, GNU CC itself should not be linked +to the sharable `VAXCRTL'. The `qsort' routine supplied with `VAXCRTL' +has a bug which can cause a compiler crash. + + Similarly, the preprocessor should not be linked to the sharable +`VAXCRTL'. The `strncat' routine supplied with `VAXCRTL' has a bug +which can cause the preprocessor to go into an infinite loop. + + It should be pointed out that if you attempt to link to the sharable +`VAXCRTL', the VMS linker will strongly resist any effort to force it +to use the `qsort' and `strncat' routines from `gcclib'. Until the +bugs in `VAXCRTL' have been fixed, linking any of the compiler +components to the sharable VAXCRTL is not recommended. (These routines +can be bypassed by placing duplicate copies of `qsort' and `strncat' in +`gcclib' under different names, and patching the compiler sources to +use these routines). Both of the bugs in `VAXCRTL' are still present +in VMS version 5.4-1, which is the most recent version as of this +writing. + + The executables that are generated by `make-cc1.com' and +`make-cccp.com' use the non-shared version of `VAXCRTL' (and thus use +the `qsort' and `strncat' routines from `gcclib.olb'). + + Note that GNU CC on VMS now generates debugging information to +describe the programs symbols to the VMS debugger. However, you need +version 1.37 or later of GAS in order to output them properly in the +object file. + + The VMS linker does not distinguish between upper and lower case +letters in function and variable names. However, usual practice in C +is to distinguish case. Normally GNU C (by means of the assembler GAS) +implements usual C behavior by augmenting each name that is not all +lower-case. A name is augmented by truncating it to at most 23 +characters and then adding more characters at the end which encode the +case pattern the rest. + + Name augmentation yields bad results for programs that use +precompiled libraries (such as Xlib) which were generated by another +compiler. Use the compiler option `/NOCASE_HACK' to inhibits +augmentation; it makes external C functions and variables +case-independent as is usual on VMS. Alternatively, you could write +all references to the functions and variables in such libraries using +lower case; this will work on VMS, but is not portable to other +systems. In cases where you need to selectively inhibit augmentation, +you can define a macro for each mixed case symbol for which you wish to +inhibit augmentation, where the macro expands into the lower case +equivalent of the name. + + +File: gcc.info, Node: HPUX Install, Next: Tower Install, Prev: VMS Install, Up: Installation + +Installing GNU CC on HPUX +========================= + + To install GNU CC on HPUX, you must start by editing the file +`Makefile'. Search for the string `HPUX' to find comments saying what +to change. You need to change some variable definitions and (if you +are using GAS) some lines in the rule for the target `gnulib'. + + To avoid errors when linking programs with `-g', create an empty +library named `libg.a'. An easy way to do this is: + + ar rc /usr/local/lib/libg.a + + To compile with the HPUX C compiler, you must specify get the file +`alloca.c' from GNU Emacs. Then, when you run `make', use this +argument: + + make ALLOCA=alloca.o + + When recompiling GNU CC with itself, do not define `ALLOCA'. +Instead, an `-I' option needs to be added to `CFLAGS' as follows: + + make CC=stage1/gcc CFLAGS="-g -O -Bstage1/ -I../binutils/hp-include" + + +File: gcc.info, Node: Tower Install, Prev: HPUX Install, Up: Installation + +Installing GNU CC on an NCR Tower +================================= + + On an NCR Tower model 4x0 or 6x0, you may have trouble because the +default maximum virtual address size of a process is just 1 Mb. Most +often you will find this problem while compiling GNU CC with itself. + + The only way to solve the problem is to reconfigure the kernel. Add +a line such as this to the configuration file: + + MAXUMEM = 4096 + +and then relink the kernel and reboot the machine.