libre-docs.patch 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327
  1. diff --git a/man/virt-install.rst b/man/virt-install.rst
  2. index 3a6e8dc..078f859 100644
  3. --- a/man/virt-install.rst
  4. +++ b/man/virt-install.rst
  5. @@ -647,17 +647,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/parabola-2021.08.11/parabola-2021.08.11-dual.iso
  11. -Debian
  12. - https://debian.osuosl.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. + https://mirror.fsf.org/trisquel-images/trisquel_10.0.1_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. @@ -722,11 +716,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. @@ -735,7 +729,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. @@ -804,19 +798,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. -
  47. -.. code-block::
  48. -
  49. - --install fedora29 --unattended
  50. -
  51. -A Windows install will look like
  52. +distros. The simplest invocation is to combine it with --install.
  53. .. code-block::
  54. - --cdrom /path/to/my/windows.iso --unattended
  55. + --install parabola --unattended
  56. Sub options are:
  57. @@ -847,9 +833,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. @@ -1005,14 +988,14 @@ For most cases, an OS must be specified or detected from the install
  65. media so performance critical features like virtio can be enabled.
  66. The simplest usage is ``--os-variant OSNAME`` or ``--osinfo OSNAME``,
  67. -for example ``--osinfo fedora32``. The supported suboptions are:
  68. +for example ``--osinfo parabola``. The supported suboptions are:
  69. ``name=``, ``short-id=``
  70. - The OS name/short-id from libosinfo. Examples: ``fedora32``, ``win10``
  71. + The OS name/short-id from libosinfo. Examples: ``parabola``
  72. ``id=``
  73. - The full URL style libosinfo ID. For example, ``name=win10`` is
  74. - the same as ``id=http://microsoft.com/win/10``
  75. + The full URL style libosinfo ID. For example, ``name=parabola`` is
  76. + the same as ``id=https://parabola.nu/parabola/rolling``
  77. ``detect=on|off``
  78. Whether virt-install should attempt OS detection from the specified
  79. @@ -1061,7 +1044,7 @@ STORAGE OPTIONS
  80. ``--disk``
  81. ^^^^^^^^^^
  82. -**Syntax:** ``--disk`` OPTIONS
  83. +````Syntax:** ``--disk`` OPTIONS
  84. Specifies media to use as storage for the guest, with various options. The
  85. general format of a disk string is
  86. @@ -1190,7 +1173,7 @@ Some example device configuration suboptions:
  87. "stop", "ignore", or "enospace"
  88. ``serial``
  89. - Serial number of the emulated disk device. This is used in linux guests
  90. + Serial number of the emulated disk device. This is used in GNU/Linux guests
  91. to set /dev/disk/by-id symlinks. An example serial number might be:
  92. WD-WMAP9A966149
  93. @@ -1218,7 +1201,7 @@ invocation is:
  94. --filesystem /source/on/host,/target/point/in/guest
  95. -Which will work for recent QEMU and linux guest OS or LXC containers. For
  96. +Which will work for recent QEMU and GNU/Linux guest OS or LXC containers. For
  97. QEMU, the target point is just a mounting hint in sysfs, so will not be
  98. automatically mounted.
  99. @@ -2125,66 +2108,22 @@ The debugging information is also stored in
  100. EXAMPLES
  101. ========
  102. -The simplest invocation to interactively install a Fedora 29 KVM VM
  103. +The simplest invocation to interactively install a Parabola KVM VM
  104. with recommended defaults. virt-viewer(1) will be launched to
  105. graphically interact with the VM install
  106. .. code-block::
  107. - # sudo virt-install --install fedora29
  108. + # sudo virt-install --install parabola
  109. Similar, but use libosinfo's unattended install support, which will
  110. -perform the fedora29 install automatically without user intervention:
  111. +perform the parabola install automatically without user intervention:
  112. .. code-block::
  113. - # sudo virt-install --install fedora29 --unattended
  114. -
  115. -
  116. -
  117. -Install a Windows 10 VM, using 40GiB storage in the default location
  118. -and 4096MiB of ram, and ensure we are connecting to the system libvirtd
  119. -instance:
  120. -
  121. -.. code-block::
  122. -
  123. - # virt-install \
  124. - --connect qemu:///system \
  125. - --name my-win10-vm \
  126. - --memory 4096 \
  127. - --disk size=40 \
  128. - --osinfo win10 \
  129. - --cdrom /path/to/my/win10.iso
  130. -
  131. -
  132. -
  133. -Install a CentOS 7 KVM from a URL, with recommended device defaults and
  134. -default required storage, but specifically request VNC graphics instead
  135. -of the default SPICE, and request 8 virtual CPUs and 8192 MiB of memory:
  136. -
  137. -.. code-block::
  138. -
  139. - # virt-install \
  140. - --connect qemu:///system \
  141. - --memory 8192 \
  142. - --vcpus 8 \
  143. - --graphics vnc \
  144. - --osinfo centos7.0 \
  145. - --location http://mirror.centos.org/centos-7/7/os/x86_64/
  146. -
  147. -
  148. -
  149. -Create a VM around an existing debian9 disk image:
  150. -
  151. -.. code-block::
  152. -
  153. - # virt-install \
  154. - --import \
  155. - --memory 512 \
  156. - --disk /home/user/VMs/my-debian9.img \
  157. - --osinfo debian9
  158. + # sudo virt-install --install parabola --unattended
  159. diff --git a/man/virt-xml.rst b/man/virt-xml.rst
  160. index ddd586b..102743a 100644
  161. --- a/man/virt-xml.rst
  162. +++ b/man/virt-xml.rst
  163. @@ -182,7 +182,7 @@ GUEST OS OPTIONS
  164. ``--os-variant``, ``--osinfo`` OS_VARIANT
  165. Optimize the guest configuration for a specific operating system (ex.
  166. - 'fedora29', 'rhel7', 'win10'). While not required, specifying this
  167. + 'parabola', 'trisquel'). While not required, specifying this
  168. options is HIGHLY RECOMMENDED, as it can greatly increase performance
  169. by specifying virtio among other guest tweaks.
  170. @@ -312,32 +312,32 @@ Change the <description> of domain 'EXAMPLE':
  171. # virt-xml EXAMPLE --edit --boot menu=on
  172. -Clear the previous <cpu> definition of domain 'winxp', change it to 'host-model', but interactively confirm the diff before saving:
  173. +Clear the previous <cpu> definition of domain 'parabola', change it to 'host-model', but interactively confirm the diff before saving:
  174. .. code-block::
  175. - # virt-xml winxp --edit --cpu host-model,clearxml=yes --confirm
  176. + # virt-xml parabola --edit --cpu host-model,clearxml=yes --confirm
  177. -Change the second sound card to model=ich6 on 'fedora19', but only output the diff:
  178. +Change the second sound card to model=ich6 on 'parabola', but only output the diff:
  179. .. code-block::
  180. - # virt-xml fedora19 --edit 2 --sound model=ich6 --print-diff
  181. + # virt-xml parabola --edit 2 --sound model=ich6 --print-diff
  182. -Update the every graphics device password to 'foo' of the running VM 'rhel6':
  183. +Update the every graphics device password to 'foo' of the running VM 'parabola':
  184. .. code-block::
  185. - # virt-xml rhel6 --edit all --graphics password=foo --update
  186. + # virt-xml parabola --edit all --graphics password=foo --update
  187. Remove the disk path from disk device hdc:
  188. .. code-block::
  189. - # virt-xml rhel6 --edit target=hdc --disk path=
  190. + # virt-xml parabola --edit target=hdc --disk path=
  191. Change all disk devices of type 'disk' to use cache=none, using XML from stdin, printing the new XML to stdout.
  192. @@ -351,37 +351,37 @@ Change disk 'hda' IO to native and use startup policy as 'optional'.
  193. .. code-block::
  194. - # virt-xml fedora20 --edit target=hda \
  195. + # virt-xml parabola --edit target=hda \
  196. --disk io=native,startup_policy=optional
  197. -Change all host devices to use driver_name=vfio for VM 'fedora20' on the remote connection
  198. +Change all host devices to use driver_name=vfio for VM 'parabola' on the remote connection
  199. .. code-block::
  200. # virt-xml --connect qemu+ssh://remotehost/system \
  201. - fedora20 --edit all --hostdev driver_name=vfio
  202. + parabola --edit all --hostdev driver_name=vfio
  203. -Hotplug host USB device 001.003 to running domain 'fedora19':
  204. +Hotplug host USB device 001.003 to running domain 'parabola':
  205. .. code-block::
  206. - # virt-xml fedora19 --update --add-device --hostdev 001.003
  207. + # virt-xml parabola --update --add-device --hostdev 001.003
  208. -Add a spicevmc channel to the domain 'winxp', that will be available after the next VM shutdown.
  209. +Add a spicevmc channel to the domain 'parabola', that will be available after the next VM shutdown.
  210. .. code-block::
  211. - # virt-xml winxp --add-device --channel spicevmc
  212. + # virt-xml parabola --add-device --channel spicevmc
  213. -Create a 10G qcow2 disk image and attach it to 'fedora18' for the next VM startup:
  214. +Create a 10G qcow2 disk image and attach it to 'parabola' for the next VM startup:
  215. .. code-block::
  216. - # virt-xml fedora18 --add-device \
  217. + # virt-xml parabola --add-device \
  218. --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
  219. @@ -390,22 +390,22 @@ for the guest OS by providing information about it on the command line:
  220. .. code-block::
  221. - # virt-xml fedora18 --osinfo fedora18 --add-device \
  222. + # virt-xml parabola --osinfo parabola --add-device \
  223. --disk /var/lib/libvirt/images/newimage.qcow2,format=qcow2,size=10
  224. -Hotunplug the disk vdb from the running domain 'rhel7':
  225. +Hotunplug the disk vdb from the running domain 'parabola':
  226. .. code-block::
  227. - # virt-xml rhel7 --update --remove-device --disk target=vdb
  228. + # virt-xml parabola --update --remove-device --disk target=vdb
  229. -Remove all graphics devices from the VM 'rhel7' after the next shutdown:
  230. +Remove all graphics devices from the VM 'parabola' after the next shutdown:
  231. .. code-block::
  232. - # virt-xml rhel7 --remove-device --graphics all
  233. + # virt-xml parabola --remove-device --graphics all
  234. Generate XML for a virtio console device and print it to stdout: