summaryrefslogtreecommitdiff
path: root/libre/virt-manager/libre-docs.patch
blob: b25476c3dbdb48944a5d0ea9390b2a4232854f2f (plain)
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
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
diff --git a/man/virt-install.rst b/man/virt-install.rst
index 963f956..f762237 100644
--- a/man/virt-install.rst
+++ b/man/virt-install.rst
@@ -627,17 +627,11 @@ DIRECTORY
 
 Some distro specific url samples:
 
-Fedora/Red Hat Based
-    https://download.fedoraproject.org/pub/fedora/linux/releases/29/Server/x86_64/os
+Parabola GNU/Linux-libre
+    https://redirector.parabola.nu/iso/x86_64-mini-latest
 
-Debian
-    https://ftp.us.debian.org/debian/dists/stable/main/installer-amd64/
-
-Ubuntu
-    https://us.archive.ubuntu.com/ubuntu/dists/wily/main/installer-amd64/
-
-Suse
-    https://download.opensuse.org/pub/opensuse/distribution/leap/42.3/repo/oss/
+Trisquel
+    http://mirror.fsf.org/trisquel-images/trisquel-mini_8.0_amd64.iso
 
 Additionally, --location can take 'kernel' and 'initrd' sub options. These paths
 relative to the specified location URL/ISO that allow selecting specific files
@@ -702,11 +696,11 @@ command has multiple subarguments, similar to --disk and friends. This
 option is strictly for VM install operations, essentially configuring the
 first boot.
 
-The simplest usage to ex: install fedora29 is:
+The simplest usage to ex: install parabola is:
 
 .. code-block::
 
-    --install fedora29
+    --install parabola
 
 And virt-install will fetch a --location URL from libosinfo, and populate
 defaults from there.
@@ -715,7 +709,7 @@ Available suboptions:
 
 ``os=``
     This is os install option described above. The explicit way to specify that
-    would be ``--install os=fedora29`` . os= is the default option if none is
+    would be ``--install os=parabola`` . os= is the default option if none is
     specified
 
 ``kernel=``, ``initrd=``
@@ -784,19 +778,11 @@ device will be added.
 
 Perform an unattended install using libosinfo's install script support.
 This is essentially a database of auto install scripts for various
-distros: Red Hat kickstarts, Debian installer scripting, Windows
-unattended installs, and potentially others. The simplest invocation
-is to combine it with --install like:
+distros. The simplest invocation is to combine it with --install.
 
 .. code-block::
 
-    --install fedora29 --unattended
-
-A Windows install will look like
-
-.. code-block::
-
-    --cdrom /path/to/my/windows.iso --unattended
+    --install parabola --unattended
 
 Sub options are:
 
@@ -827,9 +813,6 @@ Sub options are:
     Note that only the first line of the file will be considered, including
     any whitespace characters and excluding new-line.
 
-``product-key=``
-    Set a Windows product key
-
 
 
 ``--cloud-init``
@@ -972,20 +955,20 @@ GUEST OS OPTIONS
 **Syntax:** ``--os-variant`` [OS_VARIANT|OPT1=VAL1,...]
 
 Optimize the guest configuration for a specific operating system (ex.
-'fedora29', 'rhel7', 'win10'). While not required, specifying this
+'parabola', 'trisquel8'). While not required, specifying this
 options is HIGHLY RECOMMENDED, as it can greatly increase performance
 by specifying virtio among other guest tweaks.
 
 The simplest usage is ``--os-variant OS-NAME``, for example
-``--os-variant fedora32``. ``--os-variant`` supports explicit suboption
+``--os-variant systemd-cli``. ``--os-variant`` supports explicit suboption
 syntax as well:
 
 ``name=``, ``short-id=``
-    The OS name/short-id from libosinfo. Examples: ``fedora32``, ``win10``
+    The OS name/short-id from libosinfo. Examples: ``parabola``, ``trisquel8``
 
 ``id=``
-    The full URL style libosinfo ID. For example, ``name=win10`` is
-    the same as ``id=http://microsoft.com/win/10``
+    The full URL style libosinfo ID. For example, ``name=parabola`` is
+    the same as ``id=https://parabola.nu/parabola/rolling``
 
 ``detect=on|off``
     Whether virt-install should attempt OS detection from the specified
@@ -1157,7 +1140,7 @@ Some example device configuration suboptions:
     "stop", "ignore", or "enospace"
 
 ``serial``
-    Serial number of the emulated disk device. This is used in linux guests
+    Serial number of the emulated disk device. This is used in GNU/Linux guests
     to set /dev/disk/by-id symlinks. An example serial number might be:
     WD-WMAP9A966149
 
@@ -1185,7 +1168,7 @@ invocation is:
 
       --filesystem /source/on/host,/target/point/in/guest
 
-Which will work for recent QEMU and linux guest OS or LXC containers. For
+Which will work for recent QEMU and GNU/Linux guest OS or LXC containers. For
 QEMU, the target point is just a mounting hint in sysfs, so will not be
 automatically mounted.
 
@@ -2052,26 +2035,26 @@ The debugging information is also stored in
 EXAMPLES
 ========
 
-The simplest invocation to interactively install a Fedora 29 KVM VM
+The simplest invocation to interactively install a Parabola KVM VM
 with recommended defaults. virt-viewer(1) will be launched to
 graphically interact with the VM install
 
 .. code-block::
 
-    # sudo virt-install --install fedora29
+    # sudo virt-install --install parabola
 
 
 
 Similar, but use libosinfo's unattended install support, which will
-perform the fedora29 install automatically without user intervention:
+perform the parabola install automatically without user intervention:
 
 .. code-block::
 
-    # sudo virt-install --install fedora29 --unattended
+    # sudo virt-install --install parabola --unattended
 
 
 
-Install a Windows 10 VM, using 40GiB storage in the default location
+Install a Parabola VM, using 40GiB storage in the default location
 and 4096MiB of ram, and ensure we are connecting to the system libvirtd
 instance:
 
@@ -2079,15 +2062,15 @@ instance:
 
     # virt-install \
        --connect qemu:///system \
-       --name my-win10-vm \
+       --name my-parabola-vm \
        --memory 4096 \
        --disk size=40 \
-       --os-variant win10 \
-       --cdrom /path/to/my/win10.iso
+       --os-variant parabola \
+       --cdrom /path/to/parabola.iso
 
 
 
-Install a CentOS 7 KVM from a URL, with recommended device defaults and
+Install a Parabola KVM from a URL, with recommended device defaults and
 default required storage, but specifically request VNC graphics instead
 of the default SPICE, and request 8 virtual CPUs and 8192 MiB of memory:
 
@@ -2098,20 +2081,20 @@ of the default SPICE, and request 8 virtual CPUs and 8192 MiB of memory:
         --memory 8192 \
         --vcpus 8 \
         --graphics vnc \
-        --os-variant centos7.0 \
-        --location http://mirror.centos.org/centos-7/7/os/x86_64/
+        --os-variant systemd-cli \
+        --location https://redirector.parabola.nu/iso/x86_64-systemd-cli-latest
 
 
 
-Create a VM around an existing debian9 disk image:
+Create a VM around an existing Parabola disk image:
 
 .. code-block::
 
     # virt-install \
         --import \
         --memory 512 \
-        --disk /home/user/VMs/my-debian9.img \
-        --os-variant debian9
+        --disk /path/to/parabola.img \
+        --os-variant systemd-cli
 
 
 
diff --git a/man/virt-xml.rst b/man/virt-xml.rst
index 7ff7cec..b4313f7 100644
--- a/man/virt-xml.rst
+++ b/man/virt-xml.rst
@@ -182,7 +182,7 @@ GUEST OS OPTIONS
 
 ``--os-variant``, ``--osinfo`` OS_VARIANT
     Optimize the guest configuration for a specific operating system (ex.
-    'fedora29', 'rhel7', 'win10'). While not required, specifying this
+    'parabola', 'trisquel8'). While not required, specifying this
     options is HIGHLY RECOMMENDED, as it can greatly increase performance
     by specifying virtio among other guest tweaks.
 
@@ -299,32 +299,32 @@ Change the <description> of domain 'EXAMPLE':
    # virt-xml EXAMPLE --edit --boot menu=on
 
 
-Clear the previous <cpu> definition of domain 'winxp', change it to 'host-model', but interactively confirm the diff before saving:
+Clear the previous <cpu> definition of domain 'parabola', change it to 'host-model', but interactively confirm the diff before saving:
 
 .. code-block::
 
-   # virt-xml winxp --edit --cpu host-model,clearxml=yes --confirm
+   # virt-xml parabola --edit --cpu host-model,clearxml=yes --confirm
 
 
-Change the second sound card to model=ich6 on 'fedora19', but only output the diff:
+Change the second sound card to model=ich6 on 'parabola', but only output the diff:
 
 .. code-block::
 
-   # virt-xml fedora19 --edit 2 --sound model=ich6 --print-diff
+   # virt-xml parabola --edit 2 --sound model=ich6 --print-diff
 
 
-Update the every graphics device password to 'foo' of the running VM 'rhel6':
+Update the every graphics device password to 'foo' of the running VM 'parabola':
 
 .. code-block::
 
-   # virt-xml rhel6 --edit all --graphics password=foo --update
+   # virt-xml parabola --edit all --graphics password=foo --update
 
 
 Remove the disk path from disk device hdc:
 
 .. code-block::
 
-   # virt-xml rhel6 --edit target=hdc --disk path=
+   # virt-xml parabola --edit target=hdc --disk path=
 
 
 Change all disk devices of type 'disk' to use cache=none, using XML from stdin, printing the new XML to stdout.
@@ -338,37 +338,37 @@ Change disk 'hda' IO to native and use startup policy as 'optional'.
 
 .. code-block::
 
-   # virt-xml fedora20 --edit target=hda \
+   # virt-xml parabola --edit target=hda \
               --disk io=native,startup_policy=optional
 
 
-Change all host devices to use driver_name=vfio for VM 'fedora20' on the remote connection
+Change all host devices to use driver_name=vfio for VM 'parabola' on the remote connection
 
 .. code-block::
 
    # virt-xml --connect qemu+ssh://remotehost/system \
-              fedora20 --edit all --hostdev driver_name=vfio
+              parabola --edit all --hostdev driver_name=vfio
 
 
-Hotplug host USB device 001.003 to running domain 'fedora19':
+Hotplug host USB device 001.003 to running domain 'parabola':
 
 .. code-block::
 
-   # virt-xml fedora19 --update --add-device --hostdev 001.003
+   # virt-xml parabola --update --add-device --hostdev 001.003
 
 
-Add a spicevmc channel to the domain 'winxp', that will be available after the next VM shutdown.
+Add a spicevmc channel to the domain 'parabola', that will be available after the next VM shutdown.
 
 .. code-block::
 
-   # virt-xml winxp --add-device --channel spicevmc
+   # virt-xml parabola --add-device --channel spicevmc
 
 
-Create a 10G qcow2 disk image and attach it to 'fedora18' for the next VM startup:
+Create a 10G qcow2 disk image and attach it to 'parabola' for the next VM startup:
 
 .. code-block::
 
-   # virt-xml fedora18 --add-device \
+   # virt-xml parabola --add-device \
      --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
 
 
@@ -377,22 +377,22 @@ for the guest OS by providing information about it on the command line:
 
 .. code-block::
 
-   # virt-xml fedora18 --os-variant fedora18 --add-device \
+   # virt-xml parabola --os-variant systemd-cli --add-device \
      --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
 
 
-Hotunplug the disk vdb from the running domain 'rhel7':
+Hotunplug the disk vdb from the running domain 'parabola':
 
 .. code-block::
 
-   # virt-xml rhel7 --update --remove-device --disk target=vdb
+   # virt-xml parabola --update --remove-device --disk target=vdb
 
 
-Remove all graphics devices from the VM 'rhel7' after the next shutdown:
+Remove all graphics devices from the VM 'parabola' after the next shutdown:
 
 .. code-block::
 
-   # virt-xml rhel7 --remove-device --graphics all
+   # virt-xml parabola --remove-device --graphics all
 
 
 Generate XML for a virtio console device and print it to stdout: