diff options
Diffstat (limited to 'files')
| -rw-r--r-- | files/installiso-0.1.0.tar.gz | bin | 0 -> 4733 bytes | |||
| -rw-r--r-- | files/installiso.8-0.1.0.html | 180 |
2 files changed, 180 insertions, 0 deletions
diff --git a/files/installiso-0.1.0.tar.gz b/files/installiso-0.1.0.tar.gz Binary files differnew file mode 100644 index 0000000..e063852 --- /dev/null +++ b/files/installiso-0.1.0.tar.gz diff --git a/files/installiso.8-0.1.0.html b/files/installiso.8-0.1.0.html new file mode 100644 index 0000000..31c06af --- /dev/null +++ b/files/installiso.8-0.1.0.html @@ -0,0 +1,180 @@ +<!DOCTYPE html> +<html> +<!-- This is an automatically generated file. Do not edit. + Copyright (c) 2021 Stefan Kreutz <mail@skreutz.com> + + Permission to use, copy, modify, and distribute this software for any + purpose with or without fee is hereby granted, provided that the above + copyright notice and this permission notice appear in all copies. + + THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES + WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF + MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR + ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES + WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN + ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF + OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. + --> +<head> + <meta charset="utf-8"/> + <meta name="viewport" content="width=device-width, initial-scale=1.0"/> + <style> + table.head, table.foot { width: 100%; } + td.head-rtitle, td.foot-os { text-align: right; } + td.head-vol { text-align: center; } + .Nd, .Bf, .Op { display: inline; } + .Pa, .Ad { font-style: italic; } + .Ms { font-weight: bold; } + .Bl-diag > dt { font-weight: bold; } + code.Nm, .Fl, .Cm, .Ic, code.In, .Fd, .Fn, .Cd { font-weight: bold; + font-family: inherit; } + </style> + <title>INSTALLISO(8)</title> +</head> +<body> +<table class="head"> + <tr> + <td class="head-ltitle">INSTALLISO(8)</td> + <td class="head-vol">System Manager's Manual</td> + <td class="head-rtitle">INSTALLISO(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">installiso</code> — + <span class="Nd">Customize OpenBSD installation images</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">installiso</code></td> + <td>[<code class="Fl">-v</code>] <var class="Ar">command</var> + [<var class="Ar">arg ...</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">installiso</code> utility facilitates + creating custom ISO 9660 installation images for the unattended installation + of <span class="Ux">OpenBSD</span>.</p> +<p class="Pp">The common options are as follows:</p> +<dl class="Bl-tag"> + <dt id="v"><a class="permalink" href="#v"><code class="Fl">-v</code></a></dt> + <dd>Verbose mode. Causes <code class="Nm">installiso</code> to print + informative messages. Multiple <code class="Fl">-v</code> options increase + the verbosity. The maximum is 2. By default, + <code class="Nm">installiso</code> is quiet.</dd> +</dl> +<p class="Pp">The commands are as follows:</p> +<dl class="Bl-tag"> + <dt id="fetch"><a class="permalink" href="#fetch"><code class="Cm">fetch</code></a> + [<code class="Fl">-f</code>] [<code class="Fl">-m</code> + <var class="Ar">mirror</var>] [<code class="Fl">-r</code> + <var class="Ar">release</var>] [<code class="Fl">-p</code> + <var class="Ar">key</var>] [<code class="Fl">-o</code> + <var class="Ar">output</var>]</dt> + <dd>Download and verify an official ISO 9660 installation image. + <dl class="Bl-tag"> + <dt id="f"><a class="permalink" href="#f"><code class="Fl">-f</code></a></dt> + <dd>Force overwriting existing files. By default, + <code class="Cm">fetch</code> will not overwrite existing files.</dd> + <dt id="m"><a class="permalink" href="#m"><code class="Fl">-m</code></a> + <var class="Ar">mirror</var></dt> + <dd>The HTTP(S) <span class="Ux">OpenBSD</span> + <var class="Ar">mirror</var> to use. Defaults to the mirror specified + by <a class="Xr">installurl(5)</a> or else + <a class="Lk" href="https://cdn.openbsd.org/pub/OpenBSD/">https://cdn.openbsd.org/pub/OpenBSD/</a>.</dd> + <dt id="r"><a class="permalink" href="#r"><code class="Fl">-r</code></a> + <var class="Ar">release</var></dt> + <dd>The <span class="Ux">OpenBSD</span> <var class="Ar">release</var>. + Defaults to the latest development snapshot of -current.</dd> + <dt id="p"><a class="permalink" href="#p"><code class="Fl">-p</code></a> + <var class="Ar">key</var></dt> + <dd>The public <a class="Xr">signify(1)</a> <var class="Ar">key</var> used + to verify the downloaded installation image. Defaults to the key + <span class="Pa">/etc/signify/openbsd-*-base.pub</span> corresponding + to the downloaded release.</dd> + </dl> + </dd> + <dt id="patch"><a class="permalink" href="#patch"><code class="Cm">patch</code></a> + [<code class="Fl">-f</code>] [<code class="Fl">-i</code> + <var class="Ar">install_conf</var>] [<code class="Fl">-u</code> + <var class="Ar">upgrade_conf</var>] [<code class="Fl">-s</code> + <var class="Ar">site_dir</var>] <var class="Ar">input</var> + <var class="Ar">output</var></dt> + <dd>Patch an ISO 9660 installation image. + <dl class="Bl-tag"> + <dt id="f~2"><a class="permalink" href="#f~2"><code class="Fl">-f</code></a></dt> + <dd>Force overwriting existing files. By default, + <code class="Cm">patch</code> will not overwrite existing files.</dd> + <dt id="i"><a class="permalink" href="#i"><code class="Fl">-i</code></a> + <var class="Ar">install_conf</var></dt> + <dd>Insert an <a class="Xr">autoinstall(8)</a> response file for + unattended installation.</dd> + <dt id="u"><a class="permalink" href="#u"><code class="Fl">-u</code></a> + <var class="Ar">upgrade_conf</var></dt> + <dd>Insert an <a class="Xr">autoinstall(8)</a> response file for + unattended upgrade.</dd> + <dt id="s"><a class="permalink" href="#s"><code class="Fl">-s</code></a> + <var class="Ar">site</var></dt> + <dd>Package and insert the directory <var class="Ar">site</var> as a + site-specific file set.</dd> + <dt><var class="Ar">input</var></dt> + <dd>The <var class="Ar">input</var> installation image file.</dd> + <dt><var class="Ar">output</var></dt> + <dd>The <var class="Ar">output</var> installation image file.</dd> + </dl> + </dd> +</dl> +</section> +<section class="Sh"> +<h1 class="Sh" id="EXIT_STATUS"><a class="permalink" href="#EXIT_STATUS">EXIT + STATUS</a></h1> +<p class="Pp">The <code class="Nm">installiso</code> utility exits 0 on + success, and >0 if an error occurs.</p> +</section> +<section class="Sh"> +<h1 class="Sh" id="EXAMPLES"><a class="permalink" href="#EXAMPLES">EXAMPLES</a></h1> +<p class="Pp">Fetch the latest development snapshot:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>$ installiso -v fetch</pre> +</div> +<p class="Pp">Fetch a specific release:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>$ installiso -v fetch -r 6.9</pre> +</div> +<p class="Pp">Create a custom image for unattended installation:</p> +<div class="Bd Pp Bd-indent Li"> +<pre>$ doas installiso -v patch -i install.conf install69.iso custom.iso</pre> +</div> +</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">autoinstall(8)</a>, <a class="Xr">mkhybrid(8)</a>, + <a class="Xr">rdsetroot(8)</a>, <a class="Xr">sysupgrade(8)</a>, + <a class="Xr">vnconfig(8)</a></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="AUTHORS"><a class="permalink" href="#AUTHORS">AUTHORS</a></h1> +<p class="Pp"><span class="An">Stefan Kreutz</span> + <<a class="Mt" href="mailto:mail@skreutz.com">mail@skreutz.com</a>></p> +</section> +<section class="Sh"> +<h1 class="Sh" id="BUGS"><a class="permalink" href="#BUGS">BUGS</a></h1> +<p class="Pp">The <code class="Nm">installiso</code> utility is currently + limited to the amd64 architecture because it wasn't tested on any other + architecture.</p> +</section> +</div> +<table class="foot"> + <tr> + <td class="foot-date">July 24, 2021</td> + <td class="foot-os">OpenBSD 6.9</td> + </tr> +</table> +</body> +</html> |