This function works as 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 of 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 chroot to $_.