Repository files navigation

This repo contain scripts to automate LFS (Linux From Scratch) build, manage, updates, rolling and etc. Yeah its bunch of scripts. Its basically almost whole tools to maintain a Linux distribution. These what I use on my main system as daily use on my main computer. If you want to use LFS as main OS and be able to maintain it, you can use it. But keep in mind, these scripts is not 100% follow LFS, because thats the main point of LFS, you build it yourself and customize it as you want. Your distro your rules, but this one follow my rules.

Heres is important point oflfs-scripts that follow my rules;

• bootstrap usingLFS v9.1 way.
• multilib. all 32bit libraries is thrown into/usr/lib32 directory.
• usingCRUX's pkgutils to build packages from ports + my own extension script.
• usingCRUX's prt-get to manage packages and dependencies.
• writing port is damn easy, a very minimal port only required url to source tarball, compiling is automatically handled.
• dependencies handled by prt-get.
• /usr/libexec/ not use, use/usr/lib/ instead.
• userunit as main init by default.
• consolekit2 is used instead of elogind.
• no systemd stuff.

So there, my rules. If you encounter error or bugs when usinglfs-scripts, open issue here, dont report to LFS dev, they just gonna ignore you.

So i will explain most of these scripts does, else you have to read on top of each script of what it does and how to use it.

Like its name, this script is to bootstrap main system of LFS. Theres a few stages to bootsrap base system:

1 - build temporary toolchain2 - build base system (using temporary toolchain)3 - rebuild base system (without depending on temporary toolchain)4 - compress base rootfs

Stage 1 need to run as regular user to build temporary toolchain. Temporary toolchain is build inside/tmp directory so, when reboot, your system might wipe completely the toolchain. But dont worry, at the end of stage 1 the temporary toolchain will get compress as backup incase you wanna reuse it.

$ ./bootstrap 1

Stage 2 need to run as root to build base LFS system. You can usesudo ordoas. Also, base LFS system is build inside/tmp directory, and also, you can compress LFS base system to use it anytime you want without bootstrap again.

# ./bootstrap 2

Stage 3 also need to run as root to rebuild base system. This stage is completely optional if you wanna skip it. This stage is rebuild base without using temporary toolchain that build on stage 1, but it use its own toolchain instead. Its not in any LFS book but this is my way to make sure my base system is working completely. So if everything is rebuild fine, then i'm assure you that your LFS system is working 100%.

# ./bootstrap 3

Stage 4 is for compressing your base system intolfs-rootfs.tar.xz file, temporary toolchain is excluded. See installing from existing tarball below.

$ ./bootstrap 4

Okay thats all for bootstrapping LFS base. Just keeplfs-rootfs.tar.xz to reuse in the future or share with your friends.

First thing to do is making partition and mount it but i will not teach it here, i assume you already know if you come for LFS stuff. I assume you mount the partition into/mnt/lfs directory.

Extract compressed base file system into/mnt/lfs

# tar -xvf lfs-rootfs.tar.xz -C /mnt/lfs

Chroot into new extracted system

# mount --bind /dev /mnt/lfs/dev# mount -t devpts devpts /mnt/lfs/dev/pts -o gid=5,mode=620# mount -t proc proc /mnt/lfs/proc# mount -t sysfs sysfs /mnt/lfs/sys# mount -t tmpfs tmpfs /mnt/lfs/run# test -h /mnt/lfs/dev/shm && mkdir -p /mnt/lfs/$(readlink /mnt/lfs/dev/shm)(UEFI)# mkdir -p /mnt/lfs/boot/efi# mount /dev/<efi partition> /mnt/lfs/boot/efi# chroot /mnt/lfs env PS1="(chroot)# " /bin/bash

Setting hostname

# echo myhostname > /etc/hostname

Setting timezone (change XXX and YYY to your choice of timezone)

# ln -svf /usr/share/zoneinfo/XXX/YYY /etc/localtime

Setting user and password

# useradd -m -G users,wheel,audio,video -s /bin/bash <your user># passwd <your user>

Setting locales

# vim /etc/locales# genlocales# echo "LANG=xx_YY.UTF-8" > /etc/locale.conf

Setting /etc/fstab

# echo '/dev/sdXY / ext4 defaults 0 1' >> /etc/fstab# echo '/dev/sdXY swap swap defaults 0 0' >> /etc/fstab

Sync ports

# ports -u

Install grub

(BIOS)# prt-get depinst grub# grub-install /dev/sdX(UEFI)# prt-get depinst grub-efi# grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=LFS-GRUB# grub-mkconfig -o /boot/grub/grub.cfg

You might wanna install packages before rebooting to your installed lfs like 'xorg', 'networkmanager'?

# prt-get depinst xorg lxdm lxde networkmanager

Enable some needed services

# ln -sv /etc/sv/dbus /var/service# ln -sv /etc/sv/networkmanager /var/service# ln -sv /etc/sv/lxdm /var/service

You can run 'prt-get' to see the options on how to use it

# prt-get help

You can reboot now

# exit# reboot

lfs-scripts is userunit as default init. Basically the initscripts is almost same as the one used in Void Linux, so no need headache to figure out how to use it. I will point some important point ofrunit used:

• theres no runit config file (/etc/runit/rc.conf)
• to enable service, just make symlink from/etc/sv/<service> to/var/service
• ...

Writing ports is so damn easy, you can learn from existing ports or usegentemplate.sh script to generate a very basic port.

Change tocontrib directory to make new port. If you want to contribute your port, add it tocontrib directory then make PR.

$ cd ports/contrib$ ../gentemplate.sh http://dl.suckless.org/dwm/dwm-6.4.tar.gz# Depends on: name=dwmversion=6.4release=1source=(http://dl.suckless.org/${name}/${name}-${version}.tar.gz)

Here you can see port created for dwm (dwm/Pkgfile). Now lets build it. Always build new ports using fakeroot to make sure port not broken and pollute the system.

$ cd dwm$ fakeroot pkgmk...=======> Build result:drwxr-xr-x  0 root   root        0 Nov 19 00:45 usr/drwxr-xr-x  0 root   root        0 Nov 19 00:45 usr/bin/drwxr-xr-x  0 root   root        0 Nov 19 00:45 usr/share/drwxr-xr-x  0 root   root        0 Nov 19 00:45 usr/share/man/drwxr-xr-x  0 root   root        0 Nov 19 00:45 usr/share/man/man1/-rw-r--r--  0 root   root     1874 Nov 19 00:45 usr/share/man/man1/dwm.1.gz-rwxr-xr-x  0 root   root    56608 Nov 19 00:45 usr/bin/dwm=======> WARNING: Footprint not found, creating new.=======> Building '/var/cache/pkg/packages/dwm#6.4-1.pkg.tar.xz' succeeded.

When package is built, you can install it as root.

$ sudo pkgmk -i

Ok then the package is installed.

Here isPkgfile with all options available to use:

# dependencies# Depends on: pkg1 pkg2 pkg3# port's name, make sure same as port directoryname=dwm# port's versionversion=6.4# port's release, used for bump package, start with '1'. Always revert back to '1' when 'version=' is updated.release=1# port's source url, patch and needed filessource=(http://dl.suckless.org/${name}/${name}-${version}.tar.gz examplepatch.patch)# for runit services, you can use 'run' or '<name>.run' and 'finish' or '<name>.finish' to install service into '/etc/sv/<name>/run' or '/etc/sv/<name>/finish'# use '<name>.file' to install into '/etc/sv/<name>/file'# use 'file' to install into '/etc/sv/<port name>/file'# this runit files required in 'source=()' arraysv=(run finish name.run name.finish conf)# by default build type is automatically detected but you can force it to use certain build type# available build type is: meson_build, configure_build, cmake_build, python3_build, makefile_build and perlmodule_buildbuild_type=# by default common build opts is already set, use this to add extra build optsbuild_opt="-Denablethis=yes -Ddisablethat=no"# patch (*.patch and *.diff files) is automatically applied using '-Np1' option.# use this to use other patch optionspatch_opt=""# use this to keep static libraries (*.a)keep_static=1# use this to keep libtool files (*.la)keep_libtool=1# use this to keep locale files (/usr/share/locale/??)keep_locale=1pre_build() {  # executed before package is build. Eg:  ./autogen.sh}post_build() {  # executed after package is built. Eg:  mv -v $PKG/etc/X11/xinit/xinitrc.d/90-consolekit \    $PKG/etc/X11/xinit/xinitrc.d/90-consolekit.sh}pre_build() {  # this is replacement for regular 'build()' function.  # if this function is used, both 'pre_build()' and 'pre_build()' is completely ignored.  ./autogen.sh  ./configure --prefix=/usr  make  # DESTDIR=$PKG is needed, but sometimes not, already handled by automated extension script  # thats why build package using fakeroot very recommended for new ports  make install}

Thats some explanation for writing ports. For unused options, remove it. Keep it simple!.

Since the package manager and some utilities is used from CRUX, you can check CRUX wiki for extra info:https://crux.nu/Wiki/HomePage