libre-docs.patch 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332
  1. diff --git a/man/virt-install.rst b/man/virt-install.rst
  2. index 963f956..f762237 100644
  3. --- a/man/virt-install.rst
  4. +++ b/man/virt-install.rst
  5. @@ -627,17 +627,11 @@ DIRECTORY
  6. Some distro specific url samples:
  7. -Fedora/Red Hat Based
  8. - https://download.fedoraproject.org/pub/fedora/linux/releases/29/Server/x86_64/os
  9. +Parabola GNU/Linux-libre
  10. + https://redirector.parabola.nu/iso/x86_64-mini-latest
  11. -Debian
  12. - https://ftp.us.debian.org/debian/dists/stable/main/installer-amd64/
  13. -
  14. -Ubuntu
  15. - https://us.archive.ubuntu.com/ubuntu/dists/wily/main/installer-amd64/
  16. -
  17. -Suse
  18. - https://download.opensuse.org/pub/opensuse/distribution/leap/42.3/repo/oss/
  19. +Trisquel
  20. + http://mirror.fsf.org/trisquel-images/trisquel-mini_8.0_amd64.iso
  21. Additionally, --location can take 'kernel' and 'initrd' sub options. These paths
  22. relative to the specified location URL/ISO that allow selecting specific files
  23. @@ -702,11 +696,11 @@ command has multiple subarguments, similar to --disk and friends. This
  24. option is strictly for VM install operations, essentially configuring the
  25. first boot.
  26. -The simplest usage to ex: install fedora29 is:
  27. +The simplest usage to ex: install parabola is:
  28. .. code-block::
  29. - --install fedora29
  30. + --install parabola
  31. And virt-install will fetch a --location URL from libosinfo, and populate
  32. defaults from there.
  33. @@ -715,7 +709,7 @@ Available suboptions:
  34. ``os=``
  35. This is os install option described above. The explicit way to specify that
  36. - would be ``--install os=fedora29`` . os= is the default option if none is
  37. + would be ``--install os=parabola`` . os= is the default option if none is
  38. specified
  39. ``kernel=``, ``initrd=``
  40. @@ -784,19 +778,11 @@ device will be added.
  41. Perform an unattended install using libosinfo's install script support.
  42. This is essentially a database of auto install scripts for various
  43. -distros: Red Hat kickstarts, Debian installer scripting, Windows
  44. -unattended installs, and potentially others. The simplest invocation
  45. -is to combine it with --install like:
  46. +distros. The simplest invocation is to combine it with --install.
  47. .. code-block::
  48. - --install fedora29 --unattended
  49. -
  50. -A Windows install will look like
  51. -
  52. -.. code-block::
  53. -
  54. - --cdrom /path/to/my/windows.iso --unattended
  55. + --install parabola --unattended
  56. Sub options are:
  57. @@ -827,9 +813,6 @@ Sub options are:
  58. Note that only the first line of the file will be considered, including
  59. any whitespace characters and excluding new-line.
  60. -``product-key=``
  61. - Set a Windows product key
  62. -
  63. ``--cloud-init``
  64. @@ -972,20 +955,20 @@ GUEST OS OPTIONS
  65. **Syntax:** ``--os-variant`` [OS_VARIANT|OPT1=VAL1,...]
  66. Optimize the guest configuration for a specific operating system (ex.
  67. -'fedora29', 'rhel7', 'win10'). While not required, specifying this
  68. +'parabola', 'trisquel8'). While not required, specifying this
  69. options is HIGHLY RECOMMENDED, as it can greatly increase performance
  70. by specifying virtio among other guest tweaks.
  71. The simplest usage is ``--os-variant OS-NAME``, for example
  72. -``--os-variant fedora32``. ``--os-variant`` supports explicit suboption
  73. +``--os-variant systemd-cli``. ``--os-variant`` supports explicit suboption
  74. syntax as well:
  75. ``name=``, ``short-id=``
  76. - The OS name/short-id from libosinfo. Examples: ``fedora32``, ``win10``
  77. + The OS name/short-id from libosinfo. Examples: ``parabola``, ``trisquel8``
  78. ``id=``
  79. - The full URL style libosinfo ID. For example, ``name=win10`` is
  80. - the same as ``id=http://microsoft.com/win/10``
  81. + The full URL style libosinfo ID. For example, ``name=parabola`` is
  82. + the same as ``id=https://parabola.nu/parabola/rolling``
  83. ``detect=on|off``
  84. Whether virt-install should attempt OS detection from the specified
  85. @@ -1157,7 +1140,7 @@ Some example device configuration suboptions:
  86. "stop", "ignore", or "enospace"
  87. ``serial``
  88. - Serial number of the emulated disk device. This is used in linux guests
  89. + Serial number of the emulated disk device. This is used in GNU/Linux guests
  90. to set /dev/disk/by-id symlinks. An example serial number might be:
  91. WD-WMAP9A966149
  92. @@ -1185,7 +1168,7 @@ invocation is:
  93. --filesystem /source/on/host,/target/point/in/guest
  94. -Which will work for recent QEMU and linux guest OS or LXC containers. For
  95. +Which will work for recent QEMU and GNU/Linux guest OS or LXC containers. For
  96. QEMU, the target point is just a mounting hint in sysfs, so will not be
  97. automatically mounted.
  98. @@ -2052,26 +2035,26 @@ The debugging information is also stored in
  99. EXAMPLES
  100. ========
  101. -The simplest invocation to interactively install a Fedora 29 KVM VM
  102. +The simplest invocation to interactively install a Parabola KVM VM
  103. with recommended defaults. virt-viewer(1) will be launched to
  104. graphically interact with the VM install
  105. .. code-block::
  106. - # sudo virt-install --install fedora29
  107. + # sudo virt-install --install parabola
  108. Similar, but use libosinfo's unattended install support, which will
  109. -perform the fedora29 install automatically without user intervention:
  110. +perform the parabola install automatically without user intervention:
  111. .. code-block::
  112. - # sudo virt-install --install fedora29 --unattended
  113. + # sudo virt-install --install parabola --unattended
  114. -Install a Windows 10 VM, using 40GiB storage in the default location
  115. +Install a Parabola VM, using 40GiB storage in the default location
  116. and 4096MiB of ram, and ensure we are connecting to the system libvirtd
  117. instance:
  118. @@ -2079,15 +2062,15 @@ instance:
  119. # virt-install \
  120. --connect qemu:///system \
  121. - --name my-win10-vm \
  122. + --name my-parabola-vm \
  123. --memory 4096 \
  124. --disk size=40 \
  125. - --os-variant win10 \
  126. - --cdrom /path/to/my/win10.iso
  127. + --os-variant parabola \
  128. + --cdrom /path/to/parabola.iso
  129. -Install a CentOS 7 KVM from a URL, with recommended device defaults and
  130. +Install a Parabola KVM from a URL, with recommended device defaults and
  131. default required storage, but specifically request VNC graphics instead
  132. of the default SPICE, and request 8 virtual CPUs and 8192 MiB of memory:
  133. @@ -2098,20 +2081,20 @@ of the default SPICE, and request 8 virtual CPUs and 8192 MiB of memory:
  134. --memory 8192 \
  135. --vcpus 8 \
  136. --graphics vnc \
  137. - --os-variant centos7.0 \
  138. - --location http://mirror.centos.org/centos-7/7/os/x86_64/
  139. + --os-variant systemd-cli \
  140. + --location https://redirector.parabola.nu/iso/x86_64-systemd-cli-latest
  141. -Create a VM around an existing debian9 disk image:
  142. +Create a VM around an existing Parabola disk image:
  143. .. code-block::
  144. # virt-install \
  145. --import \
  146. --memory 512 \
  147. - --disk /home/user/VMs/my-debian9.img \
  148. - --os-variant debian9
  149. + --disk /path/to/parabola.img \
  150. + --os-variant systemd-cli
  151. diff --git a/man/virt-xml.rst b/man/virt-xml.rst
  152. index 7ff7cec..b4313f7 100644
  153. --- a/man/virt-xml.rst
  154. +++ b/man/virt-xml.rst
  155. @@ -182,7 +182,7 @@ GUEST OS OPTIONS
  156. ``--os-variant``, ``--osinfo`` OS_VARIANT
  157. Optimize the guest configuration for a specific operating system (ex.
  158. - 'fedora29', 'rhel7', 'win10'). While not required, specifying this
  159. + 'parabola', 'trisquel8'). While not required, specifying this
  160. options is HIGHLY RECOMMENDED, as it can greatly increase performance
  161. by specifying virtio among other guest tweaks.
  162. @@ -299,32 +299,32 @@ Change the <description> of domain 'EXAMPLE':
  163. # virt-xml EXAMPLE --edit --boot menu=on
  164. -Clear the previous <cpu> definition of domain 'winxp', change it to 'host-model', but interactively confirm the diff before saving:
  165. +Clear the previous <cpu> definition of domain 'parabola', change it to 'host-model', but interactively confirm the diff before saving:
  166. .. code-block::
  167. - # virt-xml winxp --edit --cpu host-model,clearxml=yes --confirm
  168. + # virt-xml parabola --edit --cpu host-model,clearxml=yes --confirm
  169. -Change the second sound card to model=ich6 on 'fedora19', but only output the diff:
  170. +Change the second sound card to model=ich6 on 'parabola', but only output the diff:
  171. .. code-block::
  172. - # virt-xml fedora19 --edit 2 --sound model=ich6 --print-diff
  173. + # virt-xml parabola --edit 2 --sound model=ich6 --print-diff
  174. -Update the every graphics device password to 'foo' of the running VM 'rhel6':
  175. +Update the every graphics device password to 'foo' of the running VM 'parabola':
  176. .. code-block::
  177. - # virt-xml rhel6 --edit all --graphics password=foo --update
  178. + # virt-xml parabola --edit all --graphics password=foo --update
  179. Remove the disk path from disk device hdc:
  180. .. code-block::
  181. - # virt-xml rhel6 --edit target=hdc --disk path=
  182. + # virt-xml parabola --edit target=hdc --disk path=
  183. Change all disk devices of type 'disk' to use cache=none, using XML from stdin, printing the new XML to stdout.
  184. @@ -338,37 +338,37 @@ Change disk 'hda' IO to native and use startup policy as 'optional'.
  185. .. code-block::
  186. - # virt-xml fedora20 --edit target=hda \
  187. + # virt-xml parabola --edit target=hda \
  188. --disk io=native,startup_policy=optional
  189. -Change all host devices to use driver_name=vfio for VM 'fedora20' on the remote connection
  190. +Change all host devices to use driver_name=vfio for VM 'parabola' on the remote connection
  191. .. code-block::
  192. # virt-xml --connect qemu+ssh://remotehost/system \
  193. - fedora20 --edit all --hostdev driver_name=vfio
  194. + parabola --edit all --hostdev driver_name=vfio
  195. -Hotplug host USB device 001.003 to running domain 'fedora19':
  196. +Hotplug host USB device 001.003 to running domain 'parabola':
  197. .. code-block::
  198. - # virt-xml fedora19 --update --add-device --hostdev 001.003
  199. + # virt-xml parabola --update --add-device --hostdev 001.003
  200. -Add a spicevmc channel to the domain 'winxp', that will be available after the next VM shutdown.
  201. +Add a spicevmc channel to the domain 'parabola', that will be available after the next VM shutdown.
  202. .. code-block::
  203. - # virt-xml winxp --add-device --channel spicevmc
  204. + # virt-xml parabola --add-device --channel spicevmc
  205. -Create a 10G qcow2 disk image and attach it to 'fedora18' for the next VM startup:
  206. +Create a 10G qcow2 disk image and attach it to 'parabola' for the next VM startup:
  207. .. code-block::
  208. - # virt-xml fedora18 --add-device \
  209. + # virt-xml parabola --add-device \
  210. --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
  211. @@ -377,22 +377,22 @@ for the guest OS by providing information about it on the command line:
  212. .. code-block::
  213. - # virt-xml fedora18 --os-variant fedora18 --add-device \
  214. + # virt-xml parabola --os-variant systemd-cli --add-device \
  215. --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
  216. -Hotunplug the disk vdb from the running domain 'rhel7':
  217. +Hotunplug the disk vdb from the running domain 'parabola':
  218. .. code-block::
  219. - # virt-xml rhel7 --update --remove-device --disk target=vdb
  220. + # virt-xml parabola --update --remove-device --disk target=vdb
  221. -Remove all graphics devices from the VM 'rhel7' after the next shutdown:
  222. +Remove all graphics devices from the VM 'parabola' after the next shutdown:
  223. .. code-block::
  224. - # virt-xml rhel7 --remove-device --graphics all
  225. + # virt-xml parabola --remove-device --graphics all
  226. Generate XML for a virtio console device and print it to stdout: