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

47 lines
1.0 KiB
Plaintext
Raw Normal View History

2019-06-04 14:02:52 +08:00
arch-chroot(8)
==============
Name
----
arch-chroot - enhanced chroot command
Synopsis
--------
arch-chroot [options] chroot-dir [command]
Description
-----------
arch-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, arch-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'
======
2019-06-04 14:02:52 +08:00
Options
-------
*-u <user>[:group]*::
Specify non-root user and optional group to use.
*-h*::
Output syntax and command line options.
See Also
--------
linkman:pacman[1]
include::footer.asciidoc[]