INSTALLED-TO-LIVE(1)

NAME
installed-to-live - build or clean a live-system bind-root from the installed system

SYNOPSIS
installed-to-live [options] [commands...]

DESCRIPTION
installed-to-live creates and manages the bind-mounted filesystem tree that mx-remaster uses when it copies an installed system into a live-style layout. It can mount selected files and directories from the real root into a working bind root, populate live-file templates, generate exclude lists, and clean up what it created when the remaster workflow is finished. The script is used heavily by the live remaster tools, but it can also be run manually when you want to inspect or reproduce the bind-root layout. It creates a cleanup file in /tmp/installed-to-live/cleanup.conf so the changes can be undone later.

COMMANDS

start
    Do the main bind-mount setup and create the cleanup configuration.

status
    Show status information, including the generated cleanup configuration.

live-files
    Bind-mount files from /usr/share/live-files/files into the working bind-root.

general-files
    Bind-mount files from /usr/share/live-files/general-files into the working bind-root.

read-only
    Remount the bind-root as read-only.

read-write
    Remount the bind-root as read-write.

passwd
    Create general-purpose passwd, shadow, group, and related account files.

add=DIR1,DIR2,...
    Add files from the named template directories.

bind=DIR1,DIR2,...
    Bind-mount each directory if it is already a mount point.

general
    Perform the normal general-purpose bind setup, including emptying selected configuration directories, copying live files, and resetting repo and timezone settings.

adjtime
    Reset the adjtime file while keeping the UTC/local clock choice.

cleanup
    Undo the bind-root setup and remove temporary files.

repo[=COUNTRY]
    Reset the APT repository configuration to the given country. The default country is us when no argument is supplied.

timezone[=ZONE]
    Reset the timezone configuration. If no zone is supplied, the default live timezone is used.

empty=DIR1,DIR2,...
    Bind-mount empty directories at the named paths.

exclude[=PREFIX] FILE1 FILE2 ...
    Generate an exclude list from the named files. If PREFIX is supplied, it is prepended to each generated entry. This is mainly a convenience helper for squashfs creation.

version-file[=TITLE]
    Create a standard linuxfs.ver file and bind-mount it at the expected live version-file location.

populate-live-files FROM_DIR [TO_DIR]
    Populate the live-files template tree from a mounted live filesystem. The optional TO_DIR controls the top-level directory under which the template tree is written.

OPTIONS

-b ROOT, --bind-root=ROOT
    Set the root of the new bind-mounted filesystem. The default is /.bind-root.

-e DIR, --excludes-dir=DIR
    Set the directory used to store generated exclude files. The default is /usr/share/excludes.

-f DIR, --from=DIR
    Set the source directory copied into the bind-root. The default is /.

-F, --Force
    Delete the working directory when starting.

-h, --help
    Show help and exit.

-o FILE, --output=FILE
    Write exclude-command output to FILE instead of standard output.

-P, --pretend
    Do not make changes; show what would be done.

-r USER:PASS, --root=USER:PASS
    Set the default root account name and optional password used for generated files. If the password is omitted, the username is used as the password.

-t DIR, --template=DIR
    Use an alternate template directory instead of /usr/share/live-files.

-u USER:PASS, --user=USER:PASS
    Set the default non-root account name and optional password used for generated files. If the password is omitted, the username is used as the password.

-w DIR, --work=DIR
    Use an alternate temporary working directory. The default is /tmp/installed-to-live.

-v, --verbose
    Print additional progress information.

NOTES
The command parser accepts multiple commands in sequence, which lets the script combine setup, template population, and cleanup tasks in one invocation.

SEE ALSO
live-remaster(1), persist-makefs(1), mksquashfs(1)

AUTHOR
mx-remaster maintainers