-
Notifications
You must be signed in to change notification settings - Fork 0
/
mkrootfs.8.html
152 lines (152 loc) · 6.67 KB
/
mkrootfs.8.html
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
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<!DOCTYPE html>
<html>
<!-- This is an automatically generated file. Do not edit.
mkrootfs(8) manual page
See COPYING and COPYRIGHT files for corresponding information.
-->
<head>
<meta charset="utf-8"/>
<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
<link rel="stylesheet" href="mandoc.css" type="text/css" media="all"/>
<title>MKROOTFS(8)</title>
</head>
<body>
<table class="head">
<tr>
<td class="head-ltitle">MKROOTFS(8)</td>
<td class="head-vol">System Manager's Manual</td>
<td class="head-rtitle">MKROOTFS(8)</td>
</tr>
</table>
<div class="manual-text">
<section class="Sh">
<h1 class="Sh" id="NAME"><a class="permalink" href="#NAME">NAME</a></h1>
<p class="Pp"><code class="Nm">mkrootfs</code> — <span class="Nd">make
root filesystem for chroot installation</span></p>
</section>
<section class="Sh">
<h1 class="Sh" id="SYNOPSIS"><a class="permalink" href="#SYNOPSIS">SYNOPSIS</a></h1>
<table class="Nm">
<tr>
<td><code class="Nm">mkrootfs</code></td>
<td>[<code class="Fl">-BCTVhv</code>] [<code class="Fl">-c</code>
<var class="Ar">conffile</var>] [<code class="Fl">-l</code>
<var class="Ar">logfile</var>] [<code class="Fl">-r</code>
<var class="Ar">rootfsdir</var>] [<code class="Fl">-t</code>
<var class="Ar">tarball</var>] [<code class="Fl">-x</code>
<var class="Ar">pkgmk_conffile</var>] [<code class="Fl">-y</code>
<var class="Ar">pkgman_conffile</var>] [<var class="Ar">pkgname
...</var>]</td>
</tr>
</table>
</section>
<section class="Sh">
<h1 class="Sh" id="DESCRIPTION"><a class="permalink" href="#DESCRIPTION">DESCRIPTION</a></h1>
<p class="Pp">The <code class="Nm">mkrootfs</code> utility builds customized
root filesystem for chroot installation. By default,
<code class="Nm">mkrootfs</code> builds and installs all packages from
“core” pkgsrc collection, unless
<var class="Ar">pkgname</var>(s) specified.</p>
<p class="Pp">The options are as follows:</p>
<dl class="Bl-tag">
<dt id="B"><a class="permalink" href="#B"><code class="Fl">-B</code></a></dt>
<dd>Prepare rootfs directory.</dd>
<dt id="C"><a class="permalink" href="#C"><code class="Fl">-C</code></a></dt>
<dd>Check rootfs directory for missing libraries.</dd>
<dt id="T"><a class="permalink" href="#T"><code class="Fl">-T</code></a></dt>
<dd>Compress rootfs directory (prepare tarball).</dd>
<dt id="c"><a class="permalink" href="#c"><code class="Fl">-c</code></a>
<var class="Ar">conffile</var>,
<code class="Fl">--config</code>=<var class="Ar">conffile</var></dt>
<dd>Specify an alternate configuration file instead of the default
<span class="Pa">/etc/mkrootfs/config</span>.</dd>
<dt id="l"><a class="permalink" href="#l"><code class="Fl">-l</code></a>
<var class="Ar">logfile</var>,
<code class="Fl">--log</code>=<var class="Ar">logfile</var></dt>
<dd>Specify an alternate log file for
<a class="Xr" href="pkgman.1.html">pkgman(1)</a> invocations instead of
the default
“/tmp/rootfs-⟨DATE⟩-⟨ARCH⟩.log”.
<p class="Pp">Here and below ⟨DATE⟩ is the output of
“date +%F”, and ⟨ARCH⟩ is the output of
“uname -m” commands.</p>
</dd>
<dt id="r"><a class="permalink" href="#r"><code class="Fl">-r</code></a>
<var class="Ar">rootfsdir</var>,
<code class="Fl">--rootfs</code>=<var class="Ar">rootfsdir</var></dt>
<dd>Specify an alternate rootfs directory instead of the default
“/tmp/rootfs-⟨DATE⟩-⟨ARCH⟩/”.</dd>
<dt id="t"><a class="permalink" href="#t"><code class="Fl">-t</code></a>
<var class="Ar">tarball</var>,
<code class="Fl">--tar</code>=<var class="Ar">tarball</var></dt>
<dd>Specify an alternate compressed rootfs tarball instead of the default
“/tmp/rootfs-⟨DATE⟩-⟨ARCH⟩.tar.xz”.</dd>
<dt id="x"><a class="permalink" href="#x"><code class="Fl">-x</code></a>
<var class="Ar">pkgmk_conffile</var>,
<code class="Fl">--pkgmk-config</code>=<var class="Ar">pkgmk_conffile</var></dt>
<dd>Specify an alternate configuration file for
<a class="Xr" href="pkgmk.8.html">pkgmk(8)</a> invocations instead of the
default <span class="Pa">/etc/pkgmk.conf</span>.</dd>
<dt id="y"><a class="permalink" href="#y"><code class="Fl">-y</code></a>
<var class="Ar">pkgman_conffile</var>,
<code class="Fl">--pkgman-config</code>=<var class="Ar">pkgman_conffile</var></dt>
<dd>Specify an alternate configuration file for
<a class="Xr" href="pkgman.1.html">pkgman(1)</a> invocations instead of
the default <span class="Pa">/etc/pkgman.conf</span>.</dd>
<dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a>,
<code class="Fl">--verbose</code></dt>
<dd>Verbose output.</dd>
<dt id="V"><a class="permalink" href="#V"><code class="Fl">-V</code></a>,
<code class="Fl">--version</code></dt>
<dd>Print version and exit.</dd>
<dt id="h"><a class="permalink" href="#h"><code class="Fl">-h</code></a>,
<code class="Fl">--help</code></dt>
<dd>Print help and exit.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="FILES"><a class="permalink" href="#FILES">FILES</a></h1>
<dl class="Bl-tag">
<dt><span class="Pa">/etc/mkrootfs/config</span></dt>
<dd>Configuration file for <code class="Nm">mkrootfs</code>. See
<a class="Xr" href="mkrootfs.config.5.html">mkrootfs.config(5)</a> for
more information.</dd>
<dt><span class="Pa">/etc/pkgmk.conf</span></dt>
<dd>Configuration file for invoked
<a class="Xr" href="pkgmk.8.html">pkgmk(8)</a>.</dd>
<dt><span class="Pa">/etc/pkgman.conf</span></dt>
<dd>Configuration file for invoked
<a class="Xr" href="pkgman.1.html">pkgman(1)</a>.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT
STATUS</a></h1>
<dl class="Bl-tag">
<dt>0</dt>
<dd>Success.</dd>
<dt>1</dt>
<dd>Generic error code.</dd>
<dt>2</dt>
<dd>Building rootfs directory failed.</dd>
<dt>3</dt>
<dd>Checking rootfs directory for missing libraries failed.</dd>
<dt>4</dt>
<dd>Compressing rootfs directory (preparing the tarball) failed.</dd>
</dl>
</section>
<section class="Sh">
<h1 class="Sh" id="SEE_ALSO"><a class="permalink" href="#SEE_ALSO">SEE
ALSO</a></h1>
<p class="Pp"><a class="Xr" href="mkrootfs.config.5.html">mkrootfs.config(5)</a>,
<a class="Xr" href="mkrootfs.release.7.html">mkrootfs.release(7)</a></p>
</section>
</div>
<table class="foot">
<tr>
<td class="foot-date">September 4, 2023</td>
<td class="foot-os">Zeppe-Lin</td>
</tr>
</table>
</body>
</html>