.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH LTSP-CHROOT "8" "January 2017" "ltsp-chroot 5.5.9-2" "System Administration Utilities"
.SH NAME
ltsp-chroot \- chroot into a specific LTSP thin client chroot
.SH SYNOPSIS
.B ltsp-chroot
[\fI\,OPTION\/\fR] \fI\,command\/\fR
.SH DESCRIPTION
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 \fI\,/etc/ltsp/ltsp\-chroot.conf\/\fP, and overwritten with used
command line options.
.SH OPTIONS
.TP
\fB\-a\fR, \fB\-\-arch\fR[=\fI\,ARCH\/\fR]
Sets the architecture of the target chroot. Defaults vary by distribution.
.TP
\fB\-b\fR, \fB\-\-base\fR[=\fI\,PATH\/\fR]
Sets base of target chroot. Defaults to \fI\,/opt/ltsp\/\fP if unspecified.
.TP
\fB\-c\fR, \fB\-\-mount\-package\-cache\fR
If set, mounts the server package directories to the chroot previous
to chrooting. Settings vary by distribution.
.TP
\fB\-d\fR, \fB\-\-mount\-dev\fR
If set, mounts the server dev and devpts directories to the chroot
previous to chrooting.
.TP
\fB\-h\fR, \fB\-\-help\fR
Displays the ltsp\-chroot help message.
.TP
\fB\-p\fR, \fB\-\-mount\-proc\fR
If set, mounts the server \fI\,/proc\/\fP to the chroot previous to chrooting.
.TP
\fB\-m\fR, \fB\-\-mount\-all\fR
If set, mounts the \fI\,/proc\/\fP, \fI\,/dev\/\fP and package directories to the chroot
before chrooting.
.TP
\fB\-r\fR, \fB\-\-copy\-resolv\-conf\fR
If set, copies the server resolv.conf to the chroot previous to chrooting.
.TP
\fB\-\-version\fR
Output version information and exit.
.SH AVAILABILITY
Part of the \fBltsp\fP package and the latest versions are available in source form from 
\fIhttps://launchpad.net/products/ltsp\fR.
.SH FILES
\fI/etc/ltsp/<tool>.conf\fR: 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"

\fI/etc/ltsp/ltsp-server.conf\fR: 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.
.SH AUTHOR
Autogenerated from the script source code with \fBhelp2man\fP. Distributed under the
terms of the GNU General Public License version 2 or any later version.
.SH "REPORTING BUGS"
Report bugs to \fIhttps://bugs.launchpad.net/ltsp\fR.
.SH "SEE ALSO"
\fBltsp\-build\-client\fP(8), \fBchroot\fP(1)