File: arch-chroot.8.asciidoc

package info (click to toggle)
arch-install-scripts 28-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, forky, sid, trixie
  • size: 184 kB
  • sloc: sh: 537; makefile: 41
file content (51 lines) | stat: -rw-r--r-- 1,208 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
arch-chroot(8)
==============

Name
----
arch-chroot - enhanced chroot command

Synopsis
--------
arch-chroot [options] chroot-dir [command] [arguments...]

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'
======


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.

*-h*::
	Output syntax and command line options.

See Also
--------

linkman:pacman[8]

include::footer.asciidoc[]