This directory contains scripts that automate installation and configuration of various distros.
autoinst.sh: main installation scriptautoconf.sh: main configuration scriptcommon: scripts that can be used for multiple distrosdistro: scripts specific to a particular distro (e.g.,slackware)common/diskinit.sh: shared disk layout constants and fdisk command generation
If a distro supports automated installation and/or configuration, it should:
-
Call the
autoinst_prepfunction from itsextract.shscript to copy the appropriate scripts to the distro's installation media. -
Supply an
autoinst.shmanifest which sets install-time variables and calls the install helper functions in the correct order. -
Supply an
autoconf.shmanifest which sets post-install variables and calls the configuration helper functions in the correct order. -
Keep helper logic under
autoinst/common,autoinst/debian, orautoinst/slakwareas function-only scripts so the main runners can source them up front.
-
Install scripts will run from the installation root floppy so the commands available are very limited.
sedandcutare typically available, but other commands such asgrep,awk, etc. are missing.sedcan be used to simulate many grep commands. -
Config scripts run after the base system has been installed so most commands should be available, but they are old versions and likely to be missing some new features.
-
Some distro directories have their own README files with additional implementation notes. For Debian-specific script layout and generation notes, see debian/README.md.
-
The main runners source the helper trees from
autoinst.d, then sourceautoinst.d/config/autoinst.shorautoinst.d/config/autoconf.shto set variables and call the desired helper functions. -
Helper trees such as
common/,debian/, andslakware/are copied recursively intoautoinst.drather than symlinked. This matters for old installers that see the staged disk through a DOS-backed filesystem export. -
Some older installers mount the staged disk as plain
msdos, so helper filenames and directory layout need to remain DOS-friendly.