README.mknative revision 1.8
1 1.8 mrg $NetBSD: README.mknative,v 1.8 2011/06/21 04:11:12 mrg 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.6 mrg This will create just enough glue in src/gnu/lib/libgcc4/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.4 martin -DCROSS_COMPILE, they are not suitable for committing. Step 8 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.7 skrll "nbmake-MACHINE do-distrib-dirs obj includes MKGCC=no MKBINUTILS=no". 36 1.2 skrll 37 1.6 mrg 5. In src/gnu/lib/libgcc4, do "nbmake-MACHINE obj includes". 38 1.2 skrll 39 1.8 mrg 6. If the platform sets USE_COMPILERCRTSTUFF=yes, then in src/gnu/lib/crtstuff4 40 1.8 mrg do "nbmake-MACHINE dependall install" 41 1.4 martin 42 1.8 mrg 7. In each of src/lib/csu, src/gnu/lib/libgcc4, and src/lib, 43 1.8 mrg do "nbmake-MACHINE dependall install". 44 1.2 skrll 45 1.2 skrll Optionally, all of the following may be set in the environment to reduce 46 1.2 skrll the amount of code needed to build at this step. Basically, it must be 47 1.2 skrll possible for static binaries to build and base system libs to exist so 48 1.2 skrll that "configure" can do its job for the target--these MK* options omit 49 1.2 skrll the rest for this stage of the build. 50 1.2 skrll 51 1.2 skrll MKCRYPTO=no 52 1.2 skrll MKLINT=no 53 1.2 skrll MKPROFILE=no 54 1.2 skrll MKSHARE=no 55 1.2 skrll 56 1.4 martin 8. In src/tools/gcc, do "nbmake-MACHINE native-gcc". 57 1.2 skrll 58 1.2 skrll This will do a full configury in ${.OBJDIR}/.native that is a "Canadian" 59 1.2 skrll cross toolchain (--build reflects the host platform, but --host and 60 1.2 skrll --target are the target). The result is a tree that would build a 61 1.2 skrll native-to-NetBSD compiler on a cross host, and mknative pulls glue data 62 1.2 skrll from this. 63 1.2 skrll 64 1.4 martin 9. Try out a full build using "nbmake-MACHINE"; the result should include 65 1.2 skrll a native compiler. 66 1.2 skrll 67 1.4 martin 10. If all is well, commit the glue files added to src/gnu/{lib,usr.bin}/*. 68
Indexes created Sat Nov 08 08:10:09 GMT 2025