better document the TMPDIR env var

This commit is contained in:
Johannes Schauer Marin Rodrigues 2021-03-08 19:33:51 +01:00
parent 4cd69d444a
commit 4c17f36072
Signed by: josch
GPG key ID: F2CBA5C78FBD83E1

View file

@ -6470,7 +6470,7 @@ argument. Otherwise, I<command> is executed under I<sh> and the chroot
directory can be accessed via I<$1>. All environment variables set by directory can be accessed via I<$1>. All environment variables set by
B<mmdebstrap> (like C<APT_CONFIG>, C<DEBIAN_FRONTEND>, C<LC_ALL> and C<PATH>) B<mmdebstrap> (like C<APT_CONFIG>, C<DEBIAN_FRONTEND>, C<LC_ALL> and C<PATH>)
are preserved. All environment variables set by the user are preserved, except are preserved. All environment variables set by the user are preserved, except
for C<TMPDIR> which is cleared. for C<TMPDIR> which is cleared. See section B<TMPDIR>.
The paths inside the chroot are relative to the root directory of the chroot. The paths inside the chroot are relative to the root directory of the chroot.
The path on the outside is relative to current directory of the original The path on the outside is relative to current directory of the original
@ -6844,6 +6844,10 @@ before the tarball is packed. The location of that temporary directory will be
in F</tmp> or the location pointed to by C<TMPDIR> if that environment variable in F</tmp> or the location pointed to by C<TMPDIR> if that environment variable
is set. is set.
Since C<TMPDIR> is only valid outside the chroot, the variable is being unset
when running hook scripts. If you need a valid temporary directory in a hook,
consider using F</tmp> inside your target directory.
=back =back
=head1 DEBOOTSTRAP =head1 DEBOOTSTRAP