Initial Port Bootstrap Scripts ============================== These scripts automate the bootstrapping of an initial port of ProteanOS. Prerequisites ------------- To bootstrap ProteanOS, you'll need a modern UNIX-like system. These scripts only support natively bootstrapping an any-linux-eglibc architecture such as core-linux-eglibc. Therefore, you'll need a system running Linux (or a compatible variant such as Linux-libre) and glibc (or a compatible variant such as EGLIBC) on a CPU that matches the target CPU of the ProteanOS architecture to be bootstrapped. You'll need to have the following software installed on your system: * opkbuild (version 3.0.0-alpha4 or later), * opkhelper (version 3.0.0-beta3 or later), * Sudo, * GNU Binutils, * GCC, * GNU Make, * Headers for your C library and Linux libc, * zlib (library and headers), * GNU Gettext, * GMP (library and headers), * GNU MPFR (library and headers), and * GNU MPC (library and headers, version 1.0 or later), * GNU M4, * GNU Autoconf, * GNU Automake, and * GNU Libtool. After installing opkbuild, be sure to run its mksysconf makefile with ARCH and PLAT macros to install ProteanOS system configuration files on your system. For example, to bootstrap the core-linux-eglibc dev port, run: ./mksysconf ARCH=core-linux-eglibc PLAT=dev These scripts assume that opkbuild is built with the default sysconfdir (/etc) and datadir (/usr/local/share). If you've installed opkbuild with different directories, you'll need to edit these scripts. Binutils, GCC, Make, and the libc headers can be installed on Debian GNU/Linux by installing the build-essential package. These scripts have been tested on Debian GNU/Linux 7.0 (wheezy) with the libmpc3 and libmpc-dev packages from Debian's jessie suite. Running ------- Following is an overview of the initial port bootstrap scripts: Name Description ---------------------------------------------------------------------------- bootstrap-main.sh Runs the other scripts to perform a full bootstrap. bootstrap-prepare.sh Downloads, configures, and patches packages to be built. bootstrap-stage1-build.sh Builds packages in stage 1 of the bootstrap. bootstrap-stage1-install.sh Installs built stage 1 packages into a bootstrap system directory. bootstrap-stage1-test.sh Tests the installed bootstrap system in a changed file system root. bootstrap-stage2-build.sh Builds packages in stage 2 of the bootstrap. bootstrap-stage2-install.sh Installs built stage 2 packages into a bootstrap system directory. To perform a full bootstrap, simply run bootstrap-main.sh. To perform just one step of the process, run one of the other scripts. The scripts can (and should) be run from a separate directory.