summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRoger Leigh <rleigh@debian.org>2012-10-14 22:56:17 +0100
committerRoger Leigh <rleigh@debian.org>2012-10-14 23:00:35 +0100
commitfb5bc26ad64a2deba05bcf3acfd1d28608c1be95 (patch)
tree64ba44ddcbbc8983ddbf8cf9e0acca14343e68ce
parent0996519314df9c6049b7b79d5a513fcde73a412d (diff)
downloadschroot-fb5bc26ad64a2deba05bcf3acfd1d28608c1be95.tar.gz
man: Document symlink mountpoint canonicalisation
-rw-r--r--man/schroot-script-config.5.man5
-rw-r--r--man/schroot.conf.5.man5
2 files changed, 8 insertions, 2 deletions
diff --git a/man/schroot-script-config.5.man b/man/schroot-script-config.5.man
index 3ad7dea7..bc4cd7f8 100644
--- a/man/schroot-script-config.5.man
+++ b/man/schroot-script-config.5.man
@@ -52,7 +52,10 @@ The format of this file is the same as for \fI/etc/fstab\fP, documented in
.BR fstab (5).
The only difference is that the mountpoint path \fIfs_dir\fP is relative to the
chroot, rather than the root. Note that this is settable using the
-\f[CI]setup.fstab\fP key.
+\f[CI]setup.fstab\fP key. Also note that mountpoints are canonicalised on the
+host, which will ensure that absolute symlinks point inside the chroot, but
+complex paths containing multiple symlinks may be resolved incorrectly; it is
+advised to not use nested symlinks as mountpoints.
.TP
SETUP_NSSDATABASES
A file listing the system databases to copy into the chroot. The default
diff --git a/man/schroot.conf.5.man b/man/schroot.conf.5.man
index 6d85d9f2..7b5d23dd 100644
--- a/man/schroot.conf.5.man
+++ b/man/schroot.conf.5.man
@@ -170,7 +170,10 @@ The filesystem table file to be used to mount filesystems within the chroot.
The format of this file is the same as for \fI/etc/fstab\fP, documented in
.BR fstab (5).
The only difference is that the mountpoint path \fIfs_dir\fP is relative to the
-chroot, rather than the root.
+chroot, rather than the root. Also note that mountpoints are canonicalised on
+the host, which will ensure that absolute symlinks point inside the chroot, but
+complex paths containing multiple symlinks may be resolved incorrectly; it is
+inadvisable to use nested symlinks as mountpoints.
.TP
\f[CBI]setup.nssdatabases=\fP\f[CI]filename\fP
A file listing the system databases to copy into the chroot. The default