xref: /openbsd-src/usr.sbin/rdsetroot/rdsetroot.8 (revision a17b2361ce87dfbf3d5e3df72c4d77d0df1d35eb)
1.\"	$OpenBSD: rdsetroot.8,v 1.4 2023/04/24 14:06:01 krw Exp $
2.\"
3.\" Copyright (c) 2019 Theo de Raadt
4.\"
5.\" Permission to use, copy, modify, and distribute this software for any
6.\" purpose with or without fee is hereby granted, provided that the above
7.\" copyright notice and this permission notice appear in all copies.
8.\"
9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16.\"
17.Dd $Mdocdate: April 24 2023 $
18.Dt RDSETROOT 8
19.Os
20.Sh NAME
21.Nm rdsetroot
22.Nd insert disk image into RAMDISK kernel
23.Sh SYNOPSIS
24.Nm rdsetroot
25.Fl s
26.Ar kernel
27.Nm rdsetroot
28.Op Fl dx
29.Ar kernel
30.Op Ar disk.fs
31.Sh DESCRIPTION
32The
33.Nm
34utility inserts the file
35.Ar disk.fs
36into the reserved space inside a RAMDISK kernel.
37If
38.Ar disk.fs
39is not specified,
40.Nm
41reads from standard input.
42.Pp
43The options are as follows:
44.Bl -tag -width Ds
45.It Fl d
46Debug.
47.It Fl s
48Print the size in bytes of the reserved space in the RAMDISK kernel.
49No insertion or extraction is attempted.
50.It Fl x
51Rather than inserting, extract the
52.Ar disk.fs
53image.
54If
55.Ar disk.fs
56is not specified,
57.Nm
58writes to standard output.
59The disk can be made accessible using
60.Xr vnconfig 8 ,
61filesystems can be manipulated, and finally re-inserted into the RAMDISK kernel.
62.El
63.Sh SEE ALSO
64.Xr config 8 ,
65.Xr disklabel 8 ,
66.Xr vnconfig 8
67