You are viewing the version of this documentation from Perl blead. This is the main development branch of Perl. (git commit 815d0d1337a0f328fa38b1a08c31a0c1a8253a1b)
chroot FILENAME
chroot

This function works like the system call by the same name: it makes the named directory the new root directory for all further pathnames that begin with a / by your process and all its children. (It doesn't change your current working directory, which is unaffected.) For security reasons, this call is restricted to the superuser. If FILENAME is omitted, does a chroot to $_.

NOTE: It is mandatory for security to chdir("/") (chdir to the root directory) immediately after a chroot, otherwise the current working directory may be outside of the new root.

Portability issues: "chroot" in perlport.