README.mknative revision 1.3.6.1
1 1.3.6.1 tron $NetBSD: README.mknative,v 1.3.6.1 2006/02/20 13:41:58 tron Exp $ 2 1.1 mrg 3 1.2 skrll This file describes how to bootstrap the native toolchain on a new NetBSD 4 1.2 skrll platform (and how to update the new toolchain files, if needed). These 5 1.2 skrll files may be generated on a cross-compile host without problems. 6 1.1 mrg 7 1.2 skrll NOTE: DO NOT RUN "mknative" BY HAND! It requires the Makefile in this 8 1.2 skrll directory to set up certain environments first. 9 1.2 skrll 10 1.2 skrll Since libc's features change over time, the config.h files can change as a 11 1.2 skrll result; thus the instructions below are the same no matter whether 12 1.2 skrll bootstrapping on a cross or native host. This is important: even on a 13 1.2 skrll "native" host, you should bootstrap the toolchain by building from an 14 1.2 skrll up-to-date source tree to a $DESTDIR using the exact same instructions. 15 1.2 skrll 16 1.2 skrll In these notes, MACHINE is the $MACHINE of the target. These files can be 17 1.2 skrll cross-generated. Though a $MACHINE_ARCH all uses the same config files, you 18 1.2 skrll must pick a specific $MACHINE so that building the requisite bits below will 19 1.2 skrll work. 20 1.2 skrll 21 1.2 skrll 1. Set MKMAINTAINERTOOLS=yes in mk.conf. (Needed so that src/tools/gettext 22 1.2 skrll gets built, eliciting proper HAVE_*GETTEXT* defns in config.h files.) 23 1.2 skrll 24 1.2 skrll 2. Build and install a cross toolchain (via "build.sh -m MACHINE tools"). 25 1.2 skrll 26 1.2 skrll 3. In src/tools/gcc, do "nbmake-MACHINE bootstrap-libgcc". 27 1.2 skrll 28 1.2 skrll This will create just enough glue in src/gnu/lib/libgcc3/arch to make it 29 1.2 skrll possible to build, based on the toolchain built in ${.OBJDIR}/build. 30 1.2 skrll Because the files generated in this step contain things like 31 1.2 skrll -DCROSS_COMPILE, they are not suitable for committing. Step 7 below 32 1.2 skrll will regenerate the "proper" libgcc config files. 33 1.2 skrll 34 1.2 skrll 4. At top level, do 35 1.2 skrll "nbmake-MACHINE do-distrib-dirs obj includes MKGCC=no MKBFD=no". 36 1.2 skrll 37 1.3 simonb 5. In src/gnu/lib/libgcc3, do "nbmake-MACHINE obj includes". 38 1.2 skrll 39 1.3 simonb 6. In each of src/lib/csu, src/gnu/lib/libgcc3, src/lib/libdes, and src/lib, 40 1.3 simonb do "nbmake-MACHINE all install". 41 1.2 skrll 42 1.2 skrll Optionally, all of the following may be set in the environment to reduce 43 1.2 skrll the amount of code needed to build at this step. Basically, it must be 44 1.2 skrll possible for static binaries to build and base system libs to exist so 45 1.2 skrll that "configure" can do its job for the target--these MK* options omit 46 1.2 skrll the rest for this stage of the build. 47 1.2 skrll 48 1.2 skrll MKCRYPTO=no 49 1.2 skrll MKLINT=no 50 1.2 skrll MKPROFILE=no 51 1.2 skrll MKSHARE=no 52 1.2 skrll 53 1.2 skrll 7. In src/tools/gcc, do "nbmake-MACHINE native-gcc". 54 1.2 skrll 55 1.2 skrll This will do a full configury in ${.OBJDIR}/.native that is a "Canadian" 56 1.2 skrll cross toolchain (--build reflects the host platform, but --host and 57 1.2 skrll --target are the target). The result is a tree that would build a 58 1.2 skrll native-to-NetBSD compiler on a cross host, and mknative pulls glue data 59 1.2 skrll from this. 60 1.2 skrll 61 1.2 skrll 8. Try out a full build using "nbmake-MACHINE"; the result should include 62 1.2 skrll a native compiler. 63 1.2 skrll 64 1.2 skrll 9. If all is well, commit the glue files added to src/gnu/{lib,usr.bin}/*. 65
Indexes created Sat Nov 08 00:09:40 GMT 2025