Gentoo Stage 4 Utilities Suite
Find a file
2023-05-23 19:22:59 -04:00
.github/workflows Updated bats environment 2023-03-12 01:18:40 -05:00
tests Removed debugging print call from teardown 2023-05-23 19:07:51 -04:00
.gitignore Initial commit 2014-05-18 23:52:33 +02:00
cpstage4.sh Nomenclature update, SOURCE is clearer than TARGET 2023-05-23 19:22:59 -04:00
exstage4.sh Avoid globbing 2023-03-12 01:21:19 -05:00
LICENSE Initial commit 2014-05-18 23:52:33 +02:00
mkstage4.sh Splitting occurs implicitly 2023-05-23 19:16:41 -04:00
README.md Shorter badges 2023-03-12 17:36:13 -04:00

mkstage4

CI GitHub release Gentoo package LiGurOS package

This is a Bash script which creates “stage 4” tarballs (i.e. system archives) either for the running system, or a system at a specified mount point. The script was inspired by an earlier mkstage4 script by Greg Fitzgerald (unmaintained as of 2012) which itself was a revamped edition of the original mkstage4 by Reto Glauser (unmaintained as of 2009).

Installation

The script can be run directly from its containing folder (and thus, is installed simply by downloading or cloning it from here - and adding run permissions):

git clone https://github.com/TheChymera/mkstage4.git /your/mkstage4/directory
cd /your/mkstage4/directory
chmod +x mkstage4.sh exstage4.sh

For Gentoo Linux and Derivatives, mkstage4 is also available in Portage via the base Gentoo overlay. On any Gentoo system, just run the following command:

emerge app-backup/mkstage4

Usage

If you are running the script from the containing folder (first install method) please make sure you use the e.g. ./mkstage4.sh command instead of just mkstage4!

Note that the extension (e.g. .tar.xz) will be automatically appended to the archive_name string which you specify in calling the mkstage4 command. This is done based on the compression type, which can be specifiled via the -C parameter, if another compression than the default (bz2, creating files ending in .tar.bz2) is desired.

Examples

Archive your current system (mounted at /):

mkstage4 -s archive_name

Archive a system located at a custom mount point:

mkstage4 -t /custom/mount/point archive_name

Command line arguments

Usage:
	mkstage4.sh [-b -c -k -l -q] [-C <compression-type>] [-s || -t <target-mountpoint>] [-e <additional excludes dir*>] [-i <additional include target>] <archive-filename> [custom-tar-options]
	-b: excludes boot directory.
	-c: excludes some confidential files (currently only .bash_history and connman network lists).
	-k: separately save current kernel modules and src (creates smaller archives and saves decompression time).
	-l: excludes lost+found directory.
	-q: activates quiet mode (no confirmation).
	-C: specify tar compression (default: bz2, available: lz4 xz bz2 zst gz).
	-s: makes tarball of current system.
	-t: makes tarball of system located at the <target-mountpoint>.
	-e: an additional excludes directory (one dir one -e, donot use it with *).
	-i: an additional target to include. This has higher precedence than -e, -t, and -s.
	-h: displays help message.

System Tarball Extraction

Automatic (Multi-threaded)

We provide a script for convenient extraction, exstage4, which is shipped with this package. Currently it simply automates the Multi-threaded extraction selection listed below and otherwise has no functionality except checking that the file name looks sane. If in doubt, use one of the explicit extraction methods described below.

Explicit Single-threaded

Tarballs created with mkstage4 can be extracted with:

To preserve binary attributes and use numeric owner identifiers (considered good practice on Gentoo), you can simply append the relevant flags to the respective tar commands, e.g.:

tar xvjpf archive_name.tar.bz2 --xattrs-include='*.*' --numeric-owner

If you use the -k option, extract the src and modules archives separately:

tar xvjpf archive_name.tar.bz2.kmod
tar xvjpf archive_name.tar.bz2.ksrc

Explicit Multi-threaded

If you have a parallel de/compressor installed, you can extract the archive with one of the respective commands:

pbzip2

tar -I pbzip2 -xvf archive_name.tar.bz2 --xattrs-include='*.*' --numeric-owner

xz

tar -I 'xz -T0' -xvf archive_name.tar.xz --xattrs-include='*.*' --numeric-owner

gzip

Similarly to other compressors, gzip uses a separate binary for parallel decompression:

tar -I unpigz -xvf archive_name.tar.gz --xattrs-include='*.*' --numeric-owner

Dependencies

Please note that these are very basic dependencies and should already be included in any Linux system.

Optionals: If one the following is installed the archive will be compressed using multiple parallel threads when available, in order of succession: