ltsp-chroot8

Usage

Overview

Chroots into a specified LTSP chroot. Optional arguments can be provided to customize the chroot location as well as extra mounts. If present, default arguments will be read from the configuration file /etc/ltsp/ltsp-chroot.conf, and overwritten with used command line options.

Options

-a, --arch[=ARCH]

Sets the architecture of the target chroot. Defaults vary by distribution.

-b, --base[=PATH]

Sets base of target chroot. Defaults to /opt/ltsp if unspecified.

-c, --mount-package-cache

If set, mounts the server package directories to the chroot previous to chrooting. Settings vary by distribution.

-d, --mount-dev

If set, mounts the server dev and devpts directories to the chroot previous to chrooting.

-h, --help

Displays the ltsp-chroot help message.

-p, --mount-proc

If set, mounts the server /proc to the chroot previous to chrooting.

-m, --mount-all

If set, mounts the /proc, /dev and package directories to the chroot before chrooting.

-r, --copy-resolv-conf

If set, copies the server resolv.conf to the chroot previous to chrooting.

--version

Output version information and exit.

Files

/etc/ltsp/<tool>.conf: Upon execution the tool will read a configuration file to override built-in defaults.

Values are NAME="VALUE" pairs, with # representing commented lines. most commandline options have an equivalent. an example Debian based system with an alternate base location, architecture, and distribution:

# set alternate default location for ltsp chroot (--base)
BASE="/srv/ltsp"
# build an amd64 chroot by default (--arch)
ARCH="amd64"
# build a Debian sid environment (--dist)
DIST="sid"

/etc/ltsp/ltsp-server.conf: Each LTSP server tool will read a generic configuration file. This file is typically used for setting BASE, TFTP_DIRS and TFTP_BOOT_DIR. These settings are overwritten by those set in specific tool configs.