# DarkForge Linux — Chapter 8 Build Scripts, Batch 3 (128-154)

**Created:** 2026-03-20
**Phase:** Phase 3 (Chroot Environment)
**Reference:** LFS 13.0 §8.31 through §8.59
**Status:** All 27 scripts created, syntax-validated, executable

## Overview

This batch completes the LFS Chapter 8 build sequence inside the chroot environment. These scripts build the full base system packages needed for a functional Linux distribution. All scripts are designed to run in the chroot environment where:

- The system compiler is the native compiler (targeting znver5)
- Environment sourced from `/sources/toolchain-scripts/100-chroot-env.sh` which sets:
  - `CFLAGS="-march=znver5 -O2 -pipe -fomit-frame-pointer"`
  - `MAKEFLAGS="-j32"` (32 threads on 16-core CPU)
  - `LDFLAGS="-Wl,-O1,--as-needed"`

## Script Index (27 scripts)

| Script | Package | Version | Purpose | LFS Ref |
|--------|---------|---------|---------|---------|
| 128-ncurses.sh | ncurses | auto-detected | Terminal library with wide-char support | §8.31 |
| 129-sed.sh | sed | 4.9 | Stream editor | §8.32 |
| 130-psmisc.sh | psmisc | 23.7 | Process utilities (killall, pstree, fuser) | §8.33 |
| 131-gettext.sh | gettext | 1.0 | Internationalization + msgfmt | §8.34 |
| 132-bison.sh | bison | 3.8.2 | Parser generator | §8.35 |
| 133-grep.sh | grep | 3.12 | Text search utility | §8.36 |
| 134-bash.sh | bash | 5.3 | Final shell + /bin/sh symlink | §8.37 |
| 135-libtool.sh | libtool | 2.5.4 | Generic library support script | §8.38 |
| 136-gdbm.sh | gdbm | 1.24 | GNU database manager | §8.39 |
| 137-gperf.sh | gperf | 3.1 | Perfect hash generator | §8.40 |
| 138-expat.sh | expat | 2.7.1 | XML parsing library | §8.41 |
| 139-inetutils.sh | inetutils | 2.6 | Network utilities (no systemd) | §8.42 |
| 140-less.sh | less | 668 | Text pager | §8.43 |
| 141-perl.sh | perl | 5.40.2 | Final Perl + full modules | §8.44 |
| 142-xml-parser.sh | XML-Parser | 2.47 | Perl XML::Parser module | §8.45 |
| 143-intltool.sh | intltool | 0.51.0 | Internationalization tools | §8.46 |
| 144-autoconf.sh | autoconf | 2.72 | Source configuration automation | §8.47 |
| 145-automake.sh | automake | 1.17 | Makefile generator | §8.48 |
| 146-openssl.sh | openssl | 3.5.0 | Crypto + TLS (shared + PIC) | §8.49 |
| 147-libelf.sh | elfutils | 0.192 | ELF binary library | §8.50 |
| 148-libffi.sh | libffi | 3.4.7 | Foreign function interface | §8.51 |
| 149-python.sh | Python | 3.13.3 | Final Python 3 + SQLite | §8.52-53 |
| 150-flit-core.sh | flit-core | 3.11.0 | Python PEP 517 backend | §8.54 |
| 151-wheel.sh | wheel | 0.45.1 | Python wheel format | §8.55-56 |
| 152-setuptools.sh | setuptools | 78.1.0 | Python package build | §8.57 |
| 153-ninja.sh | ninja | 1.12.1 | Fast build system | §8.58 |
| 154-meson.sh | meson | 1.7.0 | Modern build system | §8.59 |

## Key Design Decisions

### Error Handling
All scripts use `set -euo pipefail` for strict error handling:
- `set -e` — Exit on any command failure
- `set -u` — Exit on undefined variable reference
- `set -o pipefail` — Propagate pipe failures

### Environment Management
All scripts source `/sources/toolchain-scripts/100-chroot-env.sh` which provides:
- Hardware-specific compiler flags for AMD Zen 5 (znver5)
- Build parallelization (`MAKEFLAGS=-j32`)
- Helper functions: `pkg_extract()`, `pkg_cleanup()`

### Configuration Pattern
Standard configuration approach:
```bash
./configure \
    --prefix=/usr \
    --disable-static \      # Use shared libraries where possible
    [package-specific-flags]

make
make install
```

### Library Symlinks
Some scripts create compatibility symlinks (e.g., `libcrypto.so` → `libcrypto.so.3`) to support packages expecting older library naming.

### Special Cases

#### 149-python.sh
- Builds SQLite as a dependency (sqlite-autoconf-3490100) before Python
- Enables optimizations and sqlite3 extensions
- Creates `/usr/bin/python` symlink to `python3`

#### 141-perl.sh
- Uses Perl's Configure script (not standard autotools)
- Sets `BUILD_ZLIB=False` and `BUILD_BZIP2=0` to use system libs
- Installs full module set for system-wide Perl

#### 150-152 (Python packages: flit-core, wheel, setuptools)
- Use `python3 -m pip install` instead of traditional `./configure; make`
- These are Python packages being installed into Python

#### 146-openssl.sh
- Uses `./config` instead of `./configure`
- Enables both `/lib64` and `/lib` symlinks for compatibility
- Sets `zlib-dynamic` flag for compression support

#### 139-inetutils.sh
- Explicitly disabled: logger, syslogd, ifdconfig, servers (systemd alternatives)
- Moves some utilities to `/usr/sbin` per FHS

## Execution Order

These scripts must run in numerical order (128-154) because of dependencies:

1. **128-148**: Core libraries and utilities needed by subsequent packages
2. **141**: Perl (dependency for intltool, XML-Parser)
3. **142**: XML-Parser (dependency for intltool)
4. **143**: intltool (needs Perl and XML-Parser)
5. **149**: Python (dependency for ninja, meson, and Python packages)
6. **150-152**: Python packages (build tools for Python ecosystem)
7. **153**: ninja (build system for meson)
8. **154**: meson (final build system)

## Testing Notes

These scripts have been syntax-validated but **not yet tested in a chroot environment**. Before first use:

1. Verify source tarballs are present in `/sources/`
2. Test in a VM or container first
3. Monitor build logs for unexpected warnings or errors
4. Some packages may have platform-specific quirks not covered by the basic scripts

## Integration with Other Phases

These scripts are part of **Phase 3 (Chroot)** and follow Phase 0 (Toolchain) and Phase 1 (First Entry into Chroot).

After successful execution of scripts 128-154, the system should have:
- Complete base system utilities
- Compilers and build tools (gcc, autotools, meson, ninja)
- Programming language support (Perl, Python)
- Cryptography libraries (OpenSSL)
- XML and internationalization support
- All prerequisites for Phase 4 (Kernel Configuration)

## File Locations

All 27 scripts are located in:
```
/sessions/awesome-gallant-bell/mnt/lfs_auto_install/toolchain/scripts/
```

Filename pattern: `NNN-package-name.sh` where NNN is 128-154.

## References

- **LFS Book:** /sessions/awesome-gallant-bell/mnt/lfs_auto_install/reference/LFS-BOOK-r13.0-4-NOCHUNKS.html
- **Download script:** 100-download-phase3.sh (contains version manifest)
- **Environment setup:** 100-chroot-env.sh (sourced by all scripts)
- **Project directive:** /sessions/awesome-gallant-bell/mnt/lfs_auto_install/CLAUDE.md
- **Changelog:** /sessions/awesome-gallant-bell/mnt/lfs_auto_install/docs/CHANGELOG.md

---

**Next Steps:**
1. Verify all source tarballs are downloaded via `100-download-phase3.sh`
2. Enter chroot environment
3. Execute scripts 128-154 in order
4. Monitor logs for failures
5. After all 27 complete, proceed to Phase 4 (Kernel Configuration)