calamares/data/example-root/README.md

# Example Filesystem

<!-- SPDX-FileCopyrightText: no
     SPDX-License-Identifier: CC0-1.0
-->

This is a filesystem that will be used as / in an example distro,
*if* you build the `example-distro` target and use the default
unpackfs configuration. It should hold files and configuration
bits that need to be on the target system for example purposes.

It should *not* have a bin/, lib/, sbin/ or lib64/ directory,
since those are copied into the example-distro filesystem
from the build host.
Create example distro squashfs (from build host) - Add a target 'example-distro' which must be manually invoked This creates an example.sqfs with a minimal binary distro based on the build hosts's /bin and /lib. The purpose is to provide a simple test image which the default configuration of the unpackfs module can use to create a system within which the other steps of the installation can run. Example files are some zoneinfo's (remember to choose an existing zone when using the example distro), groups and sudoers files, etc .. The example distro has a special /xbin which contains bogus binaries for many system-administration tasks (e.g. useradd which would otherwise come from /usr/sbin). 2017-08-23 15:31:15 +02:00			`# Example Filesystem`

REUSE: Remainder of data/ - AppImage example config: this is old AppImage configuration, basically unmaintained, but copied from the other example config files which are CC0-1.0 as well. - Sample Linux distro: The example Linux distro has a handful of trivial files, a bogus `/etc/issue`, that kind of thing. - The bash completions are GPL-3.0-or-later - FreeBSD packaging information is BSD-2-Clause 2020-08-25 13:04:50 +02:00			`<!-- SPDX-FileCopyrightText: no`
			`SPDX-License-Identifier: CC0-1.0`
			`-->`

Create example distro squashfs (from build host) - Add a target 'example-distro' which must be manually invoked This creates an example.sqfs with a minimal binary distro based on the build hosts's /bin and /lib. The purpose is to provide a simple test image which the default configuration of the unpackfs module can use to create a system within which the other steps of the installation can run. Example files are some zoneinfo's (remember to choose an existing zone when using the example distro), groups and sudoers files, etc .. The example distro has a special /xbin which contains bogus binaries for many system-administration tasks (e.g. useradd which would otherwise come from /usr/sbin). 2017-08-23 15:31:15 +02:00			`This is a filesystem that will be used as / in an example distro,`
			if you build the `example-distro` target and use the default
			`unpackfs configuration. It should hold files and configuration`
			`bits that need to be on the target system for example purposes.`

			`It should not have a bin/, lib/, sbin/ or lib64/ directory,`
			`since those are copied into the example-distro filesystem`
			`from the build host.`