From: Guus Sliepen Date: Wed, 11 Oct 2017 17:30:17 +0000 (+0200) Subject: Add some information about the requirements of a chroot environment. X-Git-Tag: release-1.0.33~11 X-Git-Url: https://git.librecmc.org/?p=oweals%2Ftinc.git;a=commitdiff_plain;h=e4ae9c4b0dc4735dde5b0944a1ca6994075a2478 Add some information about the requirements of a chroot environment. --- diff --git a/doc/tinc.texi b/doc/tinc.texi index cdccea5..db35b4a 100644 --- a/doc/tinc.texi +++ b/doc/tinc.texi @@ -1743,10 +1743,14 @@ located (@file{@value{sysconfdir}/tinc/@var{netname}/} as determined by The chroot is performed after all the initialization is done, after writing pid files and opening network sockets. -Note that this option alone does not do any good without -U/--user, below. - -Note also that tinc can't run scripts anymore (such as tinc-down or host-up), -unless it's setup to be runnable inside chroot environment. +This option is best used in combination with the -U/--user option described below. + +You will need to ensure the chroot environment contains all the files necessary +for tinc to run correctly. +Most importantly, for tinc to be able to resolve hostnames inside the chroot environment, +you must copy @file{/etc/resolv.conf} into the chroot directory. +If you want to be able to run scripts other than @file{tinc-up} in the chroot, +you must ensure the appropriate shell is also installed in the chroot, along with all its dependencies. @item -U, --user=@var{user} Switch to the given @var{user} after initialization, at the same time as