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 of lfs-scripts that follow my rules;
- bootstrap using LFS v9.1 way.
- multilib. all 32bit libraries is thrown into
/usr/lib32directory. - using CRUX's pkgutils to build packages from ports + my own extension script.
- using CRUX'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.- use
runitas main init by default. - consolekit2 is used instead of elogind.
- no systemd stuff.
So there, my rules. If you encounter error or bugs when using lfs-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 toolchain
2 - 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 use sudo or doas. 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 into lfs-rootfs.tar.xz file, temporary toolchain is excluded. See installing from existing tarball below.
$ ./bootstrap 4
Okay thats all for bootstrapping LFS base. Just keep lfs-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 use runit 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 of runit 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 use gentemplate.sh script to generate a very basic port.
Change to contrib directory to make new port. If you want to contribute your port, add it to contrib directory then make PR.
$ cd ports/contrib
$ ../gentemplate.sh http://dl.suckless.org/dwm/dwm-6.4.tar.gz
# Depends on:
name=dwm
version=6.4
release=1
source=(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 is Pkgfile with all options available to use:
# dependencies
# Depends on: pkg1 pkg2 pkg3
# port's name, make sure same as port directory
name=dwm
# port's version
version=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 files
source=(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=()' array
sv=(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_build
build_type=
# by default common build opts is already set, use this to add extra build opts
build_opt="-Denablethis=yes -Ddisablethat=no"
# patch (*.patch and *.diff files) is automatically applied using '-Np1' option.
# use this to use other patch options
patch_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=1
pre_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