-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathqemuconf.1
101 lines (99 loc) · 2.21 KB
/
qemuconf.1
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
.\" qemuconf(1) manual page
.\" See LICENSE file for copyright and license details.
.Dd August 11, 2023
.Dt QEMUCONF 1
.Os
.\" ==================================================================
.Sh NAME
.Nm qemuconf
.Nd simple qemu launcher with configuration files support
.\" ==================================================================
.Sh SYNOPSIS
.Nm
.Op Fl nv
.Op Fl q Ar exec
.Aq Ar config
.Op Fl - Ar qemu_options ...
.\" ==================================================================
.Sh DESCRIPTION
.Nm
executes
.Xr qemu 1
with arguments compiled from a
.Aq Ar config
configuration file.
.Pp
The options are as follows:
.Bl -tag -width XXXXXXX
.It Fl n
Dry-run.
Print the produced argument list to stdout, instead of executing.
Useful for diagnostic purposes.
.It Fl q Ar exec
Set the default qemu binary.
This option may be overwritten by the
.Aq Ar qemubin
option in the configuration file.
.It Fl v
Print version and exit.
.El
.\" ==================================================================
.Sh EXAMPLES
Lets say we have the following configuration file:
.Bd -literal -offset indent
#
# /etc/qemuconf.d/main.conf: configuration file for qemuconf(1)
#
qemubin /usr/bin/qemu-system-x86_64
cwd /var/qemu/main
smp 2
m 1024
enable-kvm
drive:
if virtio
file hda.img
net nic:
vlan 0
model virtio
macaddr 82:82:9D:AF:F0:1C
net user:
vlan 0
vnc 127.0.0.1:1
# End of file.
.Ed
.Pp
This configuration file will be translated by
.Nm
into the following command:
.Bd -literal -offset indent
/usr/bin/qemu-system-x86_64 -smp 2 -m 1024 -enable-kvm \\
-drive if=virtio,file=hda.img \\
-net nic,vlan=0,model=virtio,macaddr=82:82:9D:AF:F0:1C \\
-net user,vlan=0 \\
-vnc 127.0.0.1:1
.Ed
.Pp
The
.Aq Ar cwd
option instructs
.Nm
to
.Xr chdir 2
into
.Pa /var/qemu/main
before executing a
.Xr qemu 1
instance.
.\" ==================================================================
.Sh SEE ALSO
.Xr qemu 1 ,
.Xr qemuconf-import 1
.\" ==================================================================
.Sh AUTHORS
Originally written by
.An Enno T. Boland Aq Mt [email protected] .
.Pp
This implementation was re-worked by
.An Alexandr Savca Aq Mt [email protected] .
.\" vim: cc=72 tw=70
.\" End of file.