future-install-scripts/doc/future-chroot.8.asciidoc

54 lines
1.3 KiB
Plaintext

future-chroot(8)
==============
Name
----
future-chroot - enhanced chroot command
Synopsis
--------
future-chroot [options] chroot-dir [command] [arguments...]
Description
-----------
future-chroot wraps the linkman:chroot[1] command while ensuring that important
functionality is available, e.g. mounting '/dev/', '/proc' and other API
filesystems, or exposing linkman:resolv.conf[5] to the chroot.
If 'command' is unspecified, future-chroot will launch */bin/bash*.
[NOTE]
======
The target chroot-dir *should* be a mountpoint. This ensures that tools such as
linkman:pacman[8] or linkman:findmnt[8] have an accurate hierarchy of the
mounted filesystems within the chroot. If your chroot target is not a
mountpoint, you can bind mount the directory on itself to make it a mountpoint,
i.e.:
'mount --bind /your/chroot /your/chroot'
======
Options
-------
*-N*::
Run in unshare mode. This will use linkman:unshare[1] to create a new
mount and user namespace, allowing regular users to create new system
installations.
*-u <user>[:group]*::
Specify non-root user and optional group to use.
*-r*::
Do not change the resolv.conf within the chroot. This means that the resolver
might not work in the chroot, which could be the required state.
*-h*::
Output syntax and command line options.
See Also
--------
linkman:pacman[8]