Man pages sections > man8 > ltsp-update-image

ltsp-update-image - generate an NBD image from an LTSP chroot

LTSP-UPDATE-IMAGE(8) System Administration Utilities LTSP-UPDATE-IMAGE(8)

NAME

ltsp-update-image - generate an NBD image from an LTSP chroot

SYNOPSIS

ltsp-update-image [ OPTION] [CHROOT...]

DESCRIPTION

Generates a compressed squashfs NBD image from an LTSP chroot and exports it with nbd-server. Chroot can be a full path or a subdirectory of the LTSP base directory, and it defaults to the host architecture if unset.

OPTIONS

-b, --base[=PATH]
The LTSP base directory Defaults to /opt/ltsp if unspecified.
-c, --cleanup
Temporarily remove user accounts, logs, caches etc from the chroot before exporting the image. The chroot arch is required to be compatible with the server arch.
-e, --exclude[=LIST]
List of dirs/files to exclude from the image. This is in addition to /etc/ltsp/ltsp-update-image.excludes.
-f, --config-nbd
Generate appropriate nbd-server configuration files. It's automatically set if NFS isn't used or if other LTSP generated nbd-server configuration files already exist.
-h, --help
Displays the ltsp-update-image help message.
-m, --no-compress
Don't compress the generated image.
-n, --no-backup
Don't backup chroot.img to chroot.img.old.
-r, --revert
Swap chroot.img with chroot.img.old and update kernels.
--version
Output version information and exit.

AVAILABILITY

Part of the ltsp package and the latest versions are available in source form from https://launchpad.net/products/ltsp.

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.

AUTHOR

Autogenerated from the script source code with help2man. Distributed under the terms of the GNU General Public License version 2 or any later version.

REPORTING BUGS

Report bugs to https://bugs.launchpad.net/ltsp.

SEE ALSO

ltsp-build-client(8), ltsp-update-kernels(8), ltsp-update-sshkeys(8), mksquashfs(1), nbd-server(1)
January 2017 ltsp-update-image 5.5.9-2