arch-chroot(1)
==============
:doctype: manpage

NAME
----
arch-chroot - script to mount API filesystems like /proc and make /etc/resolv.conf available in a chroot


SYNOPSIS
--------
*arch-chroot* ['option'] 'chroot-dir' ['command']


OPTIONS
-------
*-h*::
 Print the help message

*-u* '<user>[:group]'::
 Specify non-root user and optional group to use


DESCRIPTION
-----------
Before *arch-chroot* runs */usr/bin/chroot*, the script mounts API filesystems
like '/proc' and makes '/etc/resolv.conf' available in a chroot.

The Debian version of this script also sets up '/usr/sbin/policy-rc.d' to
disable autostart of daemons.

If 'command' is unspecified, arch-chroot will launch */bin/bash*.


EXAMPLES
--------
=== Enter a chroot ===

Run arch-chroot with the new root directory as first argument:

```
arch-chroot /location/of/new/root
```

To exit the chroot simply use:

```
exit
```

=== Run a single command and exit ===

To run a command in the chroot and exit again, append the command to the end of the line:

```
arch-chroot /location/of/new/root command
```

For example, to run *dpkg-configure -a* for a chroot located at '/media/testing' do:

```
arch-chroot /media/testing dpkg-configure -a
```