Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
building-snacklinux [2022/12/18 09:19] – snacsnocbuilding-snacklinux [2022/12/19 05:05] (current) – snacsnoc
Line 1: Line 1:
-(adapted from Github readme) +See [[https://github.com/snacsnoc/snacklinux/blob/master/README.md|README on Github]]
- +
-# Build system +
- +
-* Linux is preferable to build with +
-  +
-**Debian** +
-``` +
-apt-get install build-essential git libgmp-dev libmpc-dev flex bison bc  +
-```  +
-Optional: +
-``` +
-apt-get install genisoimage #used for generating x86 ISO images +
-``` +
- +
-**Mac OS*** +
-* Mac OS is **incredibly** difficult to get working alone to build the kernel, otherwise cross-compiling packages works +
-* An alternative to a tradtional VM is to use something like [krunvm](https://github.com/containers/krunvm) +
- +
-#### gcc +
-``` +
-arch -arm64 brew install gcc@12 +
-``` +
- +
-If you have an alternate version of gcc installed, create symlinks: +
-``` +
-cd /opt/homebrew/bin +
-ln -s gcc-12 gcc  +
-ln -s g++-12 g++ +
-``` +
- +
-# Toolchain +
- +
- +
-## Build your own  +
-Compile your own toolchain with [musl-cross-make](https://github.com/richfelker/musl-cross-make.git) +
- +
-`git clone https://github.com/richfelker/musl-cross-make.git` +
- +
-### arm64 +
- +
-``` +
-TARGET=aarch64-linux-musl make +
-TARGET=aarch64-linux-musl make install +
-``` +
- +
-### x86 +
- +
-``` +
-TARGET=i486-linux-musl make +
-TARGET=i486-linux-musl make install +
-``` +
- +
- +
-### TODO:x86_64 +
- +
- +
-Installs to `output/`  +
-Add the toolchain to your shell's PATH: +
-`export PATH=$PATH:/path/to/out/bin` +
- +
-# Building SnackLinux +
- +
-## Environment vars +
- +
-`JOBS` Set number of parallel jobs to create, defaults to -j8 +
-Example +
-`make busybox JOBS=-j12` +
- +
-### Architechtures +
-Change target arch by using switches with make: +
-``` +
-arch=aarch64 +
-arch=x86 +
-arch=x86_64 +
-``` +
- +
-Building for arm64: +
- +
-Example +
-`make busybox arch=aarch64 JOBS=-j4` +
- +
-Defaults to x86 +
- +
- +
- +
- +
- +
-## Versions +
-See `defs.sh` for kernel and package versions +
- +
- +
-## Getting started +
- +
- +
-Download source tars and link +
- +
-`bash ./download_prereq.sh ` +
- +
-Set the amount of parallel jobs to run when using make +
-``` +
-export JOBS=j16 +
-``` +
- +
-Compile the kernel +
- +
-``` +
-make kernel +
-``` +
- +
-Build musl, Bash and BusyBox +
-``` +
-make system +
-``` +
- +
-Install to `/opt/snacklinux_rootfs` directory +
- +
-``` +
-make install +
-``` +
- +
-Next step: [booting](#Booting) +
- +
- +
-#### Compile individual packages +
- +
- +
-#### Linux -  +
- +
-``` +
-make kernel +
-``` +
- +
-#### musl -  +
-``` +
-make musl +
-``` +
-#### BusyBox -  +
- +
-``` +
-make busybox +
-``` +
-  +
-#### Bash -  +
- +
-``` +
-make bash +
-``` +
-#### Binutils (optional) +
- +
-``` +
-make binutils +
-``` +
- +
-#### Syslinux +
- +
-``` +
-make syslinux +
-``` +
- +
- +
-If you would also like to install binutils, use: +
- +
-``` +
-make binutils-install +
-``` +
- +
-#### stripping symbols +
- +
-This target strips all debug symbols files matching LSB executable, shared object or ar archive  +
-``` +
-make arch=arm64 strip-fs +
-``` +
-# Booting +
-Prerequisites: +
-``` +
-#Base files (/etc) +
-git clone https://github.com/snacsnoc/snacklinux-base.git +
-cp -R snacklinux-base/rootfs/* /opt/snacklinux_rootfs/ +
- +
-#Create ./dev files +
-./createdev.sh +
- +
-#fbpkg (package manager) +
-git clone https://github.com/snacsnoc/fbpkg.git +
-cp fbpkg/src/fbpkg /opt/snacklinux_rootfs/usr/bin +
-``` +
-## ISO +
- +
-Run `make iso`. The output ISO will be in `iso/` +
- +
-Note: you do not have to have the toolchain to create the ISO +
- +
-## qemu +
-Create a gzipped rootfs by running: +
-``` +
-cd /opt/snacklinux_rootfs/; find . -print | cpio -o -H newc --quiet | gzip -6 > ~/rootfs.gz  +
-``` +
- +
-Packages +
-------- +
-Read the [Packages page](http://snacklinux.org/packages) for building packages. +
-For SnackLinux's package manager fbpkg, see [here](https://github.com/snacsnoc/fbpkg). +
- +
-Hacking +
-------- +
-Edit anything in `/opt/snacklinux_rootfs`, it is the root filesystem. +
-The kernel can also be recompiled to fit your needs.  +
- +
-The `boot/isolinux` directory is where ISOLINUX resides, edit the menu to adjust to your needs. +