README.mknative revision 1.10
1 1.10 skrll $NetBSD: README.mknative,v 1.10 2012/09/16 15:09:55 skrll 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.10 skrll This will create just enough glue in src/external/gpl3/gcc/lib/libgcc/arch 29 1.10 skrll to make it possible to build, based on the toolchain built in 30 1.10 skrll ${.OBJDIR}/build. 31 1.2 skrll Because the files generated in this step contain things like 32 1.4 martin -DCROSS_COMPILE, they are not suitable for committing. Step 8 below 33 1.2 skrll will regenerate the "proper" libgcc config files. 34 1.2 skrll 35 1.2 skrll 4. At top level, do 36 1.7 skrll "nbmake-MACHINE do-distrib-dirs obj includes MKGCC=no MKBINUTILS=no". 37 1.2 skrll 38 1.10 skrll 5. In src/external/gpl3/gcc/lib/libgcc, do "nbmake-MACHINE obj includes". 39 1.10 skrll 40 1.10 skrll 6. If the platform sets USE_COMPILERCRTSTUFF=yes, then in 41 1.10 skrll src/external/gpl3/gcc/lib/crtstuff/ do "nbmake-MACHINE dependall install" 42 1.2 skrll 43 1.10 skrll 7. In each of src/lib/csu, src/external/gpl3/gcc/lib/libgcc, 44 1.10 skrll src/external/lgpl3/gmp/lib/libgmp, src/external/lgpl3/mpfr/lib/libmpfr, 45 1.10 skrll src/external/lgpl2/mpc/lib/libmpc and src/lib, 46 1.10 skrll do "nbmake-MACHINE includes dependall install". 47 1.4 martin 48 1.10 skrll It is important to have LIBISPRIVATE=no while doing src/external/lgpl[23]/* 49 1.2 skrll 50 1.2 skrll Optionally, all of the following may be set in the environment to reduce 51 1.2 skrll the amount of code needed to build at this step. Basically, it must be 52 1.2 skrll possible for static binaries to build and base system libs to exist so 53 1.2 skrll that "configure" can do its job for the target--these MK* options omit 54 1.2 skrll the rest for this stage of the build. 55 1.2 skrll 56 1.2 skrll MKCRYPTO=no 57 1.2 skrll MKLINT=no 58 1.2 skrll MKPROFILE=no 59 1.2 skrll MKSHARE=no 60 1.2 skrll 61 1.4 martin 8. In src/tools/gcc, do "nbmake-MACHINE native-gcc". 62 1.2 skrll 63 1.2 skrll This will do a full configury in ${.OBJDIR}/.native that is a "Canadian" 64 1.2 skrll cross toolchain (--build reflects the host platform, but --host and 65 1.2 skrll --target are the target). The result is a tree that would build a 66 1.2 skrll native-to-NetBSD compiler on a cross host, and mknative pulls glue data 67 1.2 skrll from this. 68 1.2 skrll 69 1.4 martin 9. Try out a full build using "nbmake-MACHINE"; the result should include 70 1.2 skrll a native compiler. 71 1.2 skrll 72 1.4 martin 10. If all is well, commit the glue files added to src/gnu/{lib,usr.bin}/*. 73
Indexes created Sat Nov 08 00:09:40 GMT 2025