Translated using Weblate (Spanish)

Currently translated at 100.0% (1459 of 1459 strings)

Translation: virt-manager/virt-manager
Translate-URL: https://translate.fedoraproject.org/projects/virt-manager/virt-manager/es/

.codespellrc

@@ -0,0 +1,3 @@
+[codespell]
+ignore-words = tests/data/codespell_dict.txt
+skip = *.pyc,*.iso,*.xml,*/po/*

.github/ISSUE_TEMPLATE.md

@@ -1,19 +0,0 @@
-<!--
-If you are using distro provided packages and you have not confirmed
-the bug exists in this repo with the latest code, then please file a
-bug with your distro instead. Testing the code in this repo is
-pretty easy, see CONTRIBUTING.md for details.
-
-If your bug involves connecting to the VM graphical console, please
-help us out and run through these debugging steps to help narrow
-down where the issue may be:
-https://github.com/virt-manager/virt-manager/wiki/Debugging-VM-graphical-display-issues
-
-If you are requesting a feature or UI change, please read DESIGN.md
-first, especially the section at the end about previously rejected
-features.
-
-Thank you!
--->
-
-**Distro**: <!-- FILL ME IN PLEASE -->

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+<!--
+If you are using distro provided packages and you have not confirmed
+the bug exists in this repo with the latest code, then please file a
+bug with your distro instead. Testing the code in this repo is
+pretty easy, see CONTRIBUTING.md for details.
+
+If your bug involves connecting to the VM graphical console, please
+help us out and run through these debugging steps to help narrow
+down where the issue may be:
+https://github.com/virt-manager/virt-manager/wiki/Debugging-VM-graphical-display-issues
+
+Thank you!
+-->
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '...'
+3. Run command '...'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**System (please complete the following information):**
+ - Distribution: [e.g. Fedora 40]
+ - virt-manager version:
+ - libvirt version:
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,25 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+
+---
+
+<!--
+If you are requesting a feature or UI change, please read DESIGN.md
+first, especially the section at the end about previously rejected
+features.
+
+Thank you!
+-->
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

.github/dependabot.yml

@@ -0,0 +1,9 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    target-branch: "main"
+    commit-message:
+      prefix: "ci"

.github/workflows/black.yml

@@ -0,0 +1,17 @@
+name: Check code formatting with black
+
+on:
+  pull_request:
+  workflow_dispatch:
+  push:
+
+jobs:
+  black:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+      - uses: pre-commit/action@v3.0.1
+        with:
+          extra_args: black --all-files

.github/workflows/ci.yml

@@ -1,42 +1,55 @@
-name: CI
+name: Test on fedora:latest
 
 on: [push, pull_request]
 
 jobs:
-  # Setup latest Fedora with latest libvirt from virt-preview, build
-  # the RPM, verify it installs, run test suite, upload coverage
+  # Test on fedora:latest with stock distro packages
   test:
     runs-on: ubuntu-latest
     container:
       image: fedora:latest
 
     steps:
-    - uses: actions/checkout@v2
-
-    - name: Install RPM build deps
+    - name: Install base RPM packages
       run: |
         # glibc-langpacks-en needed to work around python locale issues
+        # git-core needed for codecov/codecov-action
         dnf install -y \
+          git-core \
           rpm-build \
           dnf-plugins-core \
           glibc-langpack-en \
           python3-pytest python3-pytest-cov
 
-        dnf builddep -y ./virt-manager.spec
+    - uses: actions/checkout@v4
+
+    - name: Install RPM build deps
+      run: |
+        dnf install -y \
+          gettext \
+          python3-devel \
+          python3-docutils \
+          meson
 
     - name: Build RPM and test install
       run: |
-        ./setup.py rpm
+        git config --global --add safe.directory $PWD
+
+        meson setup build \
+          -Dupdate-icon-cache=false \
+          -Dcompile-schemas=false \
+          -Dtests=disabled
+        meson dist -C build
+        rpmbuild -tb build/meson-dist/virt-manager*.tar.xz
         dnf install -y \
-          noarch/virt-install*.rpm \
-          noarch/virt-manager-common*.rpm
+          ~/rpmbuild/RPMS/noarch/virt-install*.rpm \
+          ~/rpmbuild/RPMS/noarch/virt-manager-common*.rpm
 
     - name: Run test suite and generate coverage report
       run: |
         pytest --cov --cov-report=xml
 
     - name: Upload coverage to Codecov
-      uses: codecov/codecov-action@v1
+      uses: codecov/codecov-action@v5
       with:
-        file: ./coverage.xml
-        flags: unittests
+        token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/codespell.yml

@@ -0,0 +1,14 @@
+name: Scan with codespell
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  codespell:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: codespell-project/actions-codespell@v2

.github/workflows/test-against-libvirt-git.yml

@@ -0,0 +1,63 @@
+name: Test against libvirt.git
+
+on:
+  # Run every 3 days at midnight
+  schedule:
+    - cron: '0 0 */3 * *'
+
+jobs:
+  test-against-libvirt-git:
+    # Only run this if on the main 'virt-manager/virt-manager' repo, not forks
+    if: "contains(github.repository, 'virt-manager/virt-manager')"
+
+    runs-on: ubuntu-latest
+    container:
+      image: fedora:latest
+
+    steps:
+    - name: Install RPM build and libvirt deps
+      run: |
+        # glibc-langpacks-en needed to work around python locale issues
+        dnf install -y \
+          rpm-build \
+          dnf-plugins-core \
+          glibc-langpack-en \
+          python3-pytest \
+          python3-pytest-error-for-skips
+
+        dnf install -y \
+          gettext \
+          python3-devel \
+          python3-docutils \
+          meson
+
+        dnf builddep -y libvirt
+
+    - uses: actions/checkout@v4
+
+    - name: Build RPM and test install
+      run: |
+        git config --global --add safe.directory $PWD
+        meson setup build \
+          -Dupdate-icon-cache=false \
+          -Dcompile-schemas=false \
+          -Dtests=disabled
+        meson dist -C build
+        rpmbuild -tb build/meson-dist/virt-manager*.tar.xz
+        dnf install -y \
+          ~/rpmbuild/RPMS/noarch/virt-install*.rpm \
+          ~/rpmbuild/RPMS/noarch/virt-manager-common*.rpm
+
+    - name: checkout and build libvirt
+      run: |
+        git clone --depth=1 https://gitlab.com/libvirt/libvirt
+        cd libvirt
+        meson build
+        ninja -C build
+        cd ..
+
+    - name: Run test suite
+      run: |
+        # Treat any `skips` as `errors`. We should only be
+        # skipping tests on old libvirt versions
+        ./libvirt/build/run pytest --error-for-skips

.github/workflows/translations.yml

@@ -8,7 +8,7 @@ on:
 
 jobs:
 
-  # This job will run ./setup.py extract_messages on top of git main
+  # This job will run meson compile -C build virt-manager-pot on top of git main
   # and force push that to the 'translations' branch. That branch will
   # always have an up to date .pot file for use in weblate
   update-translation-pot:
@@ -22,9 +22,15 @@ jobs:
     steps:
     - name: Install deps
       run: |
-        dnf install -y python3-setuptools gettext git diffutils
+        dnf install -y \
+        git \
+        diffutils \
+        gettext \
+        python3-devel \
+        python3-docutils \
+        meson
 
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v4
       with:
         # This fetches full git history. We need that for proper
         # branch updating
@@ -39,7 +45,11 @@ jobs:
         git rebase remotes/origin/translations
 
         cp po/virt-manager.pot old.pot
-        ./setup.py extract_messages
+        meson setup build \
+          -Dupdate-icon-cache=false \
+          -Dcompile-schemas=false \
+          -Dtests=disabled
+        meson compile -C build virt-manager-pot
         ec=0
         diff -q -I 'POT-Creation-Date' old.pot po/virt-manager.pot || ec=$?
         case "${ec}" in

.gitignore

@@ -3,17 +3,9 @@
 *.gmo
 
 /build
-/dist
 
 /.coverage
-/MANIFEST
 
 /data/gschemas.compiled
 
-/man/virt-manager.1
-/man/virt-install.1
-/man/virt-clone.1
-/man/virt-xml.1
-
-/virt-manager.spec
-/virtinst/build.cfg
+/coverage.xml

.gitpublish

@@ -1,4 +0,0 @@
-[gitpublishprofile "default"]
-base = main
-to = virt-tools-list@redhat.com
-prefix = virt-manager PATCH

.packit.yaml

@@ -0,0 +1,25 @@
+# See the documentation for more information:
+# https://packit.dev/docs/configuration/
+
+upstream_package_name: virt-manager
+downstream_package_name: virt-manager
+
+specfile_path: build/virt-manager.spec
+
+srpm_build_deps:
+  - gettext
+  - python3-devel
+  - python3-docutils
+  - meson
+
+actions:
+  post-upstream-clone:
+    - meson setup build -Dupdate-icon-cache=false -Dcompile-schemas=false -Dtests=disabled
+
+jobs:
+  - job: copr_build
+    # Run on every PR
+    trigger: pull_request
+    # Defaults to x86_64 unless architecture is explicitly specified
+    targets:
+      - fedora-all

.pre-commit-config.yaml

@@ -0,0 +1,10 @@
+repos:
+-    repo: https://github.com/pre-commit/pre-commit-hooks
+     rev: v5.0.0
+     hooks:
+     -    id: check-yaml
+
+-    repo: https://github.com/psf/black
+     rev: 25.1.0
+     hooks:
+     -    id: black

.pylintrc

@@ -3,7 +3,7 @@
 # can either give multiple identifier separated by comma (,) or put this option
 # multiple time (only on the command line, not in the configuration file where
 # it should appear only once).
-disable=Design,Similarities,invalid-name,missing-docstring,line-too-long,too-many-lines,superfluous-parens,bad-whitespace,locally-disabled,no-self-use,unnecessary-lambda,star-args,fixme,global-statement,bare-except,anomalous-backslash-in-string,broad-except,cyclic-import,bad-continuation,locally-enabled,unidiomatic-typecheck,redefined-variable-type,bad-option-value,wrong-import-position,consider-using-ternary,no-else-return,len-as-condition,inconsistent-return-statements,useless-object-inheritance,consider-using-in,useless-return,assignment-from-none,chained-comparison,import-outside-toplevel,use-a-generator,consider-using-with,consider-using-f-string,unspecified-encoding,use-maxsplit-arg
+disable=Design,Similarities,invalid-name,missing-docstring,line-too-long,too-many-lines,superfluous-parens,bad-whitespace,locally-disabled,no-self-use,unnecessary-lambda,star-args,fixme,global-statement,bare-except,anomalous-backslash-in-string,broad-except,cyclic-import,bad-continuation,locally-enabled,unidiomatic-typecheck,redefined-variable-type,bad-option-value,wrong-import-position,consider-using-ternary,no-else-return,len-as-condition,inconsistent-return-statements,useless-object-inheritance,consider-using-in,useless-return,assignment-from-none,chained-comparison,import-outside-toplevel,use-a-generator,consider-using-with,consider-using-f-string,unspecified-encoding,use-maxsplit-arg,possibly-used-before-assignment
 enable=fixme
 
 

CONTRIBUTING.md

@@ -34,8 +34,7 @@ it by running the latest code using the steps above.
 The following commands will be useful for anyone writing patches:
 
 ```sh
-pytest               # Run local unit test suite
-./setup.py pylint    # Run pylint/pycodestyle checking
+meson test -C build
 ```
 
 Any patches shouldn't change the output of 'pytest' or 'pylint'. Depending
@@ -43,8 +42,9 @@ on what version of libvirt or pylint is installed, you may see some
 pre-existing errors from these commands. The important thing is that
 any changes you make do not add additional errors.
 
-The 'pylint' command requires [`pylint`](https://github.com/PyCQA/pylint)
-and [`pycodestyle`](https://github.com/pycqa/pycodestyle) to be installed.
+The 'test' command requires [`pylint`](https://github.com/PyCQA/pylint),
+[`pycodestyle`](https://github.com/pycqa/pycodestyle) and
+['pytest'](https://github.com/pytest-dev/pytest/) to be installed.
 If [`codespell`](https://github.com/codespell-project/codespell) is installed,
 it will be invoked as well.
 
@@ -79,12 +79,7 @@ UI. See the files in the ui/ directory.
 ## Submitting patches
 
 The [virt-manager git repo](https://github.com/virt-manager/virt-manager)
-is hosted on github. Small patches are acceptable via github pull-request,
-but anything non-trivial should be sent to the
-[virt-tools-list mailing list](https://www.redhat.com/mailman/listinfo/virt-tools-list).
-
-Sending patches using `git send-email` is preferred, but `git format-patch`
-output attached to an email is also fine.
+is hosted on github. All patches should be submitted there.
 
 
 ## UI design
@@ -110,7 +105,10 @@ Translations are handled through the Weblate instance hosted by the Fedora Proje
 
 * https://translate.fedoraproject.org/projects/virt-manager/virt-manager/
 * More info about translating as part of Fedora: https://fedoraproject.org/wiki/L10N/Translate_on_Weblate
-* The up to date translation `.pot` template is stored in the [`translations` branch](https://github.com/virt-manager/virt-manager/tree/translations) and synced with the `main` branch before release.
+* The up to date translation `.pot` template is stored in the `main` branch
+* Translations are submitted by Weblate as pull requests, usually merged to the
+  `main` branch before release and whenever needed (e.g. before updating the
+  `.pot` template)
 
 
 ## Advanced testing

INSTALL.md

@@ -11,24 +11,14 @@ For more details on that, see [CONTRIBUTING.md](CONTRIBUTING.md)
 
 To install the software into `/usr/local` (usually), you can do:
 ```sh
-./setup.py install
+meson setup build
+meson install -C build
 ```
 
-To build an RPM, you can run:
-```sh
-./setup.py rpm
-```
-
-`setup.py` generally has all the build and install commands, for more info see:
-
-   - `./setup.py --help-commands`
-   - `./setup.py install --help`
-   - [Python Standard Build and Install](https://docs.python.org/3/install/#standard-build-and-install)
-
 
 ## Pre-requisite software
 
-A detailed dependency list can be found in [virt-manager.spec](virt-manager.spec) file.
+A detailed dependency list can be found in [virt-manager.spec.in](virt-manager.spec.in) file.
 
 Minimum version requirements of major components:
 

MANIFEST.in

@@ -1,14 +0,0 @@
-# to be included/excluded from the tarball produced by sdist
-include COPYING CONTRIBUTING.md DESIGN.md INSTALL.md NEWS.md README.md
-include MANIFEST.in
-include setup.py
-include virt-*
-recursive-include data *
-exclude data/gschemas.compiled
-recursive-include man *
-recursive-include po *
-recursive-include tests *
-recursive-include ui *
-recursive-include virtManager *
-recursive-include virtinst *
-global-exclude *.pyc

NEWS.md

@@ -1,5 +1,33 @@
 # Virtual Machine Manager News
 
+## Release 5.0.0 (November 26, 2024)
+- virt-clone: colne serial files (Oleg Vasilev)
+- virt-clone: Copy disk permissions as well (Martin Kletzander)
+- virt-install: Add properties for AMD SEV-SNP (Daniel P. Berrangé)
+- virt-install: Add passt backend for user network interface
+- virt-install: Add support for --sound multichannel,stream (Lin Ma)
+- virt-install: Add support for --tpm backend.debug,backend.source (Lin Ma)
+- virt-xml: add --edit --convert-to-q35
+- virt-xml: add --edit --convert-to-vnc
+- virt-xml: Add --edit --boot uefi
+- virt-manager: Fix opening graphical console with egl-headless (Feng Jiang)
+- virt-manager: Add support to create external snapshots
+- virt-manager: Default to scaling=Always for consoles
+- virt-manager: switch to not forking by default
+- cli: Add more --disk options (Lin Ma)
+- cli: Add --memdev target.address_base for virtio-mem and virtio-pmem (Lin Ma)
+- cli: Add --features kvm.pv-ipi.state=on|off (Lin Ma)
+- cli: Add --video model.blob=on|off (Lin Ma)
+- Add missing Hyper-V features and enable most of them by default
+- Add loongarch support (Xianglai Li)
+- Add support for hvf domain type (Mohamed Akram)
+- Support creating sparse volumes on ZFS pools (Iain Buclaw)
+- UEFI improvements for riscv64 and loongarch64 VMs (Andrea Bolognani)
+- Add graphics to riscv64 and aarch64
+- build: switch from setuptools to meson
+- diskbackend: Drop support for sheepdog (Lin Ma)
+- cli: Deprecate --cpu host in favor of --cpu host-model (Andrea Bolognani)
+
 ## Release 4.1.0 (August 04, 2022)
 - Fix build with setuptools-61 (Peter Alfredsen, Miro Hrončok)
 - add UI and cli support for qemu-vdagent channel (Jonathon Jongsma)
@@ -17,7 +45,7 @@
 - Fill in all --cputune, --cpu, --shmem, --input, and --boot suboptions
   (Hugues Fafard)
 - virt-* mdev improvements (Shalini Chellathurai Saroja)
-- bhyve improvments (Roman Bogorodskiy)
+- bhyve improvements (Roman Bogorodskiy)
 - Revive network portgroup UI
 - enable a TPM by default when UEFI is used (Daniel P. Berrangé)
 - Use cpu host-passthrough by default on qemu x86

README.md

@@ -21,9 +21,6 @@ code from a git checkout, you can launch any of the commands like:
 
 ## Contact
 
- - Discussions and big patch series should go to the
-   [virt-tools-list](https://www.redhat.com/mailman/listinfo/virt-tools-list)
-   mailing list.
  - For IRC we use #virt on OFTC.
  - For bug reporting info, see
    [virt-manager bug reporting](https://virt-manager.org/bugs).

data/bash-completion.sh.in

@@ -32,4 +32,4 @@ _python_argcomplete() {
         compopt -o nospace
     fi
 }
-complete -o nospace -o default -F _python_argcomplete ::SCRIPTNAME::
+complete -o nospace -o default -F _python_argcomplete @SCRIPTNAME@

data/icons/16x16/actions/meson.build

@@ -0,0 +1,8 @@
+icons = files(
+  'icon_console.png',
+  'vm_new.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '16x16', 'cat': 'actions'}
+endforeach

data/icons/16x16/apps/meson.build

@@ -0,0 +1,7 @@
+icons = files(
+  'virt-manager.png'
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '16x16', 'cat': 'apps'}
+endforeach

data/icons/16x16/meson.build

@@ -0,0 +1,2 @@
+subdir('actions')
+subdir('apps')

data/icons/22x22/actions/meson.build

@@ -0,0 +1,9 @@
+icons = files(
+  'icon_console.png',
+  'icon_details.png',
+  'vm_new.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '22x22', 'cat': 'actions'}
+endforeach

data/icons/22x22/apps/meson.build

@@ -0,0 +1,7 @@
+icons = files(
+  'virt-manager.png'
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '22x22', 'cat': 'apps'}
+endforeach

data/icons/22x22/devices/meson.build

@@ -0,0 +1,11 @@
+icons = files(
+  'device_cpu.png',
+  'device_mem.png',
+  'device_pci.png',
+  'device_serial.png',
+  'device_usb.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '22x22', 'cat': 'devices'}
+endforeach

data/icons/22x22/meson.build

@@ -0,0 +1,4 @@
+subdir('actions')
+subdir('apps')
+subdir('devices')
+subdir('status')

data/icons/22x22/status/meson.build

@@ -0,0 +1,9 @@
+icons = files(
+  'state_paused.png',
+  'state_running.png',
+  'state_shutoff.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '22x22', 'cat': 'status'}
+endforeach

data/icons/24x24/actions/meson.build

@@ -0,0 +1,9 @@
+icons = files(
+  'icon_console.png',
+  'vm_clone_wizard.png',
+  'vm_new.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '24x24', 'cat': 'actions'}
+endforeach

data/icons/24x24/apps/meson.build

@@ -0,0 +1,7 @@
+icons = files(
+  'virt-manager.png'
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '24x24', 'cat': 'apps'}
+endforeach

data/icons/24x24/meson.build

@@ -0,0 +1,2 @@
+subdir('actions')
+subdir('apps')

data/icons/256x256/apps/meson.build

@@ -0,0 +1,7 @@
+icons = files(
+  'virt-manager.png'
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '256x256', 'cat': 'apps'}
+endforeach

data/icons/256x256/meson.build

@@ -0,0 +1 @@
+subdir('apps')

data/icons/32x32/actions/meson.build

@@ -0,0 +1,8 @@
+icons = files(
+  'icon_console.png',
+  'vm_new.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '32x32', 'cat': 'actions'}
+endforeach

data/icons/32x32/apps/meson.build

@@ -0,0 +1,7 @@
+icons = files(
+  'virt-manager.png'
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '32x32', 'cat': 'apps'}
+endforeach

data/icons/32x32/meson.build

@@ -0,0 +1,3 @@
+subdir('actions')
+subdir('apps')
+subdir('status')

data/icons/32x32/status/meson.build

@@ -0,0 +1,9 @@
+icons = files(
+  'state_paused.png',
+  'state_running.png',
+  'state_shutoff.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '32x32', 'cat': 'status'}
+endforeach

data/icons/48x48/actions/meson.build

@@ -0,0 +1,10 @@
+icons = files(
+  'vm_clone_wizard.png',
+  'vm_delete_wizard.png',
+  'vm_import_wizard.png',
+  'vm_new_wizard.png',
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '48x48', 'cat': 'actions'}
+endforeach

data/icons/48x48/apps/meson.build

@@ -0,0 +1,7 @@
+icons = files(
+  'virt-manager.png'
+)
+
+foreach icon : icons
+  install_icons += {'file': icon, 'size': '48x48', 'cat': 'apps'}
+endforeach

data/icons/48x48/meson.build

@@ -0,0 +1,2 @@
+subdir('actions')
+subdir('apps')

data/icons/meson.build

@@ -0,0 +1,20 @@
+install_icons = []
+
+subdir('16x16')
+subdir('22x22')
+subdir('24x24')
+subdir('32x32')
+subdir('48x48')
+subdir('256x256')
+
+foreach icon : install_icons
+  if icon['cat'] == 'apps'
+    icon_dir = datadir / 'icons' / 'hicolor' / icon['size'] / 'apps'
+  else
+    icon_dir = pkgdir / 'icons' / 'hicolor' / icon['size'] / icon['cat']
+  endif
+  install_data(
+    icon['file'],
+    install_dir: icon_dir,
+  )
+endforeach

data/meson.build

@@ -0,0 +1,25 @@
+fs = import('fs')
+
+desktop_file = files('virt-manager.desktop.in')
+
+appdata_file = files('virt-manager.appdata.xml.in')
+
+install_data(
+  'org.virt-manager.virt-manager.gschema.xml',
+  install_dir: datadir / 'glib-2.0' / 'schemas',
+)
+
+bash_completion_template = files('bash-completion.sh.in')
+
+foreach script: ['virt-install', 'virt-clone', 'virt-xml']
+  name = fs.name(script)
+  configure_file(
+    input: bash_completion_template,
+    output: name,
+    configuration: {'SCRIPTNAME': name},
+    install: true,
+    install_dir: datadir / 'bash-completion' / 'completions',
+  )
+endforeach
+
+subdir('icons')

data/org.virt-manager.virt-manager.gschema.xml

@@ -206,7 +206,7 @@
   <schema id="org.virt-manager.virt-manager.console"
           path="/org/virt-manager/virt-manager/console/">
     <key name="scaling" type="i">
-      <default>1</default>
+      <default>2</default>
       <summary>When to scale the VM graphical console</summary>
       <description>When to scale the VM graphical console. 0 = never, 1 = only when in full screen mode, 2 = Always</description>
     </key>

data/virt-manager.appdata.xml.in

@@ -31,7 +31,6 @@
   <url type="homepage">https://www.virt-manager.org/</url>
   <url type="bugtracker">https://github.com/virt-manager/virt-manager/issues/new/choose</url>
   <url type="translate">https://translate.fedoraproject.org/projects/virt-manager/virt-manager/</url>
-  <update_contact>virt-tools-list@redhat.com</update_contact>
   <translation type="gettext">virt-manager</translation>
   <keywords>
     <keyword>virtualization</keyword>
@@ -40,7 +39,9 @@
     <keyword>kvm</keyword>
   </keywords>
   <content_rating type="oars-1.1"/>
+  <launchable type="desktop-id">virt-manager.desktop</launchable>
   <releases>
+    <release version="5.0.0" date="2024-11-26"/>
     <release version="4.1.0" date="2022-08-04"/>
     <release version="4.0.0" date="2022-03-02"/>
     <release version="3.2.0" date="2020-11-14"/>

man/meson.build

@@ -0,0 +1,18 @@
+rst_files = files(
+  'virt-install.rst',
+  'virt-clone.rst',
+  'virt-xml.rst',
+  'virt-manager.rst',
+)
+
+rst2man_prog = find_program(['rst2man', 'rst2man.py'], required: true)
+
+foreach rst_file : rst_files
+  man_page = custom_target(
+    input: rst_file,
+    output: '@BASENAME@.1',
+    command: [ rst2man_prog, '--strict', '@INPUT@', '@OUTPUT@'],
+    install: true,
+    install_dir: datadir / 'man' / 'man1',
+  )
+endforeach

man/virt-clone.rst

@@ -121,15 +121,15 @@ storage options via -file.
 
 
 ``--preserve-data``
-    No storage is cloned: disk images specific by --file are preserved as is,
+    No storage is cloned: disk images specified by --file are preserved as is,
     and referenced in the new clone XML. This is useful if you want to clone
     a VM XML template, but not the storage contents.
 
 
 ``--reflink``
-    When --reflink is specified, perform a lightweight copy. This is much faster
-    if source images and destination images are all on the same btrfs filesystem.
-    If COW copy is not possible, then virt-clone fails.
+    Perform a lightweight copy. This is much faster if source images and destination
+    images are all on the same btrfs filesystem. This only works for raw format disk
+    images, any non-raw images will not attempt to use refink
 
 
 ``-m``, ``--mac`` MAC
@@ -144,8 +144,10 @@ storage options via -file.
 
 
 ``--replace``
-    Shutdown and remove any existing guest with the passed ``--name`` before
-    cloning the original guest.
+    Before cloning, try a simple ``virsh destroy`` and ``virsh undefine`` on
+    any existing VM with the passed ``--name``. If those operations fail (like
+    when ``virsh undefine`` requires ``--nvram`` flag), the clone will fail
+    and you will need to manually remove the existing VM.
 
 
 ``-h``, ``--help``

man/virt-install.rst

@@ -117,7 +117,7 @@ maps to the <memory> element.
 To configure memory modules which can be hotunplugged see ``--memdev`` description.
 
 Use --memory=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsMemoryAllocation
+Complete details at https://libvirt.org/formatdomain.html#memory-allocation
 
 
 
@@ -129,7 +129,7 @@ Complete details at https://libvirt.org/formatdomain.html#elementsMemoryAllocati
 This option will influence how virtual memory pages are backed by host pages.
 
 Use --memorybacking=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsMemoryBacking
+Complete details at https://libvirt.org/formatdomain.html#memory-backing
 
 
 
@@ -163,7 +163,7 @@ Specify metadata values for the guest. Possible options include name, uuid,
 title, and description. This option deprecates -u/--uuid and --description.
 
 Use --metadata=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsMetadata
+Complete details at https://libvirt.org/formatdomain.html#general-metadata
 
 
 
@@ -176,7 +176,7 @@ Specify events values for the guest. Possible options include
 on_poweroff, on_reboot, and on_crash.
 
 Use --events=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsEvents
+Complete details at https://libvirt.org/formatdomain.html#events-configuration
 
 
 
@@ -188,7 +188,7 @@ Complete details at https://libvirt.org/formatdomain.html#elementsEvents
 Specify resource partitioning for the guest.
 
 Use --resource=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#resPartition
+Complete details at https://libvirt.org/formatdomain.html#resource-partitioning
 
 
 
@@ -210,8 +210,10 @@ Configure sysinfo/SMBIOS values exposed to the VM OS. Examples:
 
 Use --sysinfo=? to see a list of all available sub options.
 
-Complete details at https://libvirt.org/formatdomain.html#elementsSysinfo
-and https://libvirt.org/formatdomain.html#elementsOSBIOS for ``smbios`` XML element.
+Complete details at
+https://libvirt.org/formatdomain.html#operating-system-booting and
+https://libvirt.org/formatdomain.html#smbios-system-information for ``smbios``
+XML element.
 
 
 
@@ -294,7 +296,8 @@ Environment variables are specified with 'env', for example:
 
     --qemu-commandline=env=DISPLAY=:0.1
 
-Complete details about the libvirt feature: https://libvirt.org/drvqemu.html#qemucommand
+Complete details about the libvirt feature:
+https://libvirt.org/drvqemu.html#pass-through-of-arbitrary-qemu-commands
 
 
 
@@ -326,7 +329,7 @@ If the value 'auto' is passed, virt-install attempts to automatically determine
 an optimal cpu pinning using NUMA data, if available.
 
 Use --vcpus=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsCPUAllocation
+Complete details at https://libvirt.org/formatdomain.html#cpu-allocation
 
 
 
@@ -349,7 +352,7 @@ as ``--vcpus cpuset=`` option. mode can be one of 'interleave', 'preferred', or
 mode.
 
 Use --numatune=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsNUMATuning
+Complete details at https://libvirt.org/formatdomain.html#numa-node-tuning
 
 
 
@@ -366,7 +369,7 @@ Tune memory policy for the domain process. Example invocations
     --memtune hard_limit=100,soft_limit=60,swap_hard_limit=150,min_guarantee=80
 
 Use --memtune=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsMemoryTuning
+Complete details at https://libvirt.org/formatdomain.html#memory-tuning
 
 
 
@@ -383,7 +386,7 @@ Tune blkio policy for the domain process. Example invocations
     --blkiotune weight=100,device.path=/dev/sdc,device.weight=200
 
 Use --blkiotune=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsBlockTuning
+Complete details at https://libvirt.org/formatdomain.html#block-i-o-tuning
 
 
 
@@ -414,7 +417,7 @@ Some examples:
 ``--cpu core2duo,+x2apic,disable=vmx``
     Expose the core2duo CPU model, force enable x2apic, but do not expose vmx
 
-``--cpu host``
+``--cpu host-model``
     Expose the host CPUs configuration to the guest. This enables the guest to
     take advantage of many of the host CPUs features (better performance), but
     may cause issues if migrating the guest to a host without an identical CPU.
@@ -435,8 +438,13 @@ Some examples:
 ``--cpu host-passthrough,cache.mode=passthrough``
     Example of passing through the host cpu's cache information.
 
+``--cpu maximum``
+    Expose the most feature-rich CPU possible. Useful when running a foreign
+    architecture guest, for example a riscv64 guest on an x86_64 host. Not
+    recommended when using KVM to run a same-architecture guest.
+
 Use --cpu=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsCPU
+Complete details at https://libvirt.org/formatdomain.html#cpu-model-and-topology
 
 
 
@@ -455,7 +463,7 @@ Example invocation
     --cputune vcpupin0.vcpu=0,vcpupin0.cpuset=0-3,vcpupin1.vcpu=1,vcpupin1.cpuset=4-7
 
 Use --cputune=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsCPUTuning
+Complete details at https://libvirt.org/formatdomain.html#cpu-tuning
 
 
 
@@ -469,7 +477,7 @@ Configure domain seclabel domain settings. Type can be either 'static' or
 LABEL without TYPE implies static configuration.
 
 Use --security=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#seclabel
+Complete details at https://libvirt.org/formatdomain.html#security-label
 
 
 
@@ -481,7 +489,7 @@ Complete details at https://libvirt.org/formatdomain.html#seclabel
 Specify domain <keywrap> XML, used for S390 cryptographic key management operations.
 
 Use --keywrap=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#keywrap
+Complete details at https://libvirt.org/formatdomain.html#key-wrap
 
 
 
@@ -494,7 +502,7 @@ Specify domain <iothreads> and/or <iothreadids> XML.
 For example, to configure ``<iothreads>4</iothreads>``, use ``--iothreads 4``
 
 Use --iothreads=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsIOThreadsAllocation
+Complete details at https://libvirt.org/formatdomain.html#iothreads-allocation
 
 
 
@@ -529,7 +537,7 @@ apic, eoi, privnet, and hyperv features. Some examples:
     type.)
 
 Use --features=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsFeatures
+Complete details at https://libvirt.org/formatdomain.html#hypervisor-features
 
 
 
@@ -551,7 +559,7 @@ Configure the guest's <clock> XML. Some supported options:
     might be catchup, delay, etc. Refer to the libvirt docs for all values.
 
 Use --clock=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsTime
+Complete details at https://libvirt.org/formatdomain.html#time-keeping
 
 
 
@@ -567,7 +575,7 @@ Configure guest power management features. Example:
       --pm suspend_to_memi.enabled=on,suspend_to_disk.enabled=off
 
 Use --pm=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsPowerManagement
+Complete details at https://libvirt.org/formatdomain.html#power-management
 
 
 
@@ -596,7 +604,7 @@ SEV has further implications on usage of virtio devices, so refer to EXAMPLES
 section to see a full invocation of virt-install with --launchSecurity.
 
 Use --launchSecurity=? to see a list of all available sub options. Complete
-details at https://libvirt.org/formatdomain.html#launchSecurity
+details at https://libvirt.org/formatdomain.html#launch-security
 
 
 
@@ -929,6 +937,8 @@ Some examples:
 ``--boot cdrom,fd,hd,network``
     Set the boot device priority as first cdrom, first floppy, first harddisk,
     network PXE boot.
+    Note: s390x guests only support one boot device, so everything except
+    the first device type will be ignored.
 
 ``--boot kernel=KERNEL,initrd=INITRD,kernel_args="console=/dev/ttyS0"``
     Have guest permanently boot off a local kernel/initrd pair, with the
@@ -951,22 +961,39 @@ Some examples:
     has been specified, virt-install will default to /sbin/init, otherwise
     will default to /bin/sh.
 
-``--boot uefi``
+``--boot uefi``, ``--boot uefi=on``
     Configure the VM to boot from UEFI. In order for virt-install to know the
     correct UEFI parameters, libvirt needs to be advertising known UEFI binaries
     via domcapabilities XML, so this will likely only work if using properly
-    configured distro packages.
+    configured distro packages. This is the recommended UEFI setup.
+
+``--boot uefi=off``
+    Do not use UEFI if the VM would normally default to it.
+
+``--boot uefi,firmware.feature0.name=secure-boot,firmware.feature0.enabled=yes,firmware.feature1.name=enrolled-keys,firmware.feature1.enabled=yes``
+    Configure the VM to boot from UEFI with Secure Boot support enabled.
+    Only signed operating systems will be able to boot with this configuration.
+
+``--boot uefi,firmware.feature0.name=secure-boot,firmware.feature0.enabled=no``
+    Configure the VM to boot from UEFI with Secure Boot support disabled.
+    This configuration allows both signed and unsigned operating systems to
+    run.
+
+    Additional information about the ``secure-boot`` and
+    ``enrolled-keys`` firmware features and how they can be used to
+    influence firmware selection is available at
+    https://libvirt.org/kbase/secureboot.html
 
 ``--boot loader=/.../OVMF_CODE.fd,loader.readonly=yes,loader.type=pflash,nvram.template=/.../OVMF_VARS.fd,loader_secure=no``
     Specify that the virtual machine use the custom OVMF binary as boot firmware,
     mapped as a virtual flash chip. In addition, request that libvirt instantiate
     the VM-specific UEFI varstore from the custom "/.../OVMF_VARS.fd" varstore
-    template. This is the recommended UEFI setup, and should be used if
-    --boot uefi doesn't know about your UEFI binaries. If your UEFI firmware
-    supports Secure boot feature you can enable it via loader_secure.
+    template. This setup is not recommended, and should only be used if
+    --boot uefi doesn't know about your UEFI binaries.
 
 Use --boot=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsOS
+Complete details at
+https://libvirt.org/formatdomain.html#operating-system-booting
 
 
 
@@ -987,7 +1014,7 @@ make containers secure, in the absence of sVirt confinement.
       --idmap uid.start=0,uid.target=1000,uid.count=10,gid.start=0,gid.target=1000,gid.count=10
 
 Use --idmap=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsOSContainer
+Complete details at https://libvirt.org/formatdomain.html#container-boot
 
 
 
@@ -995,7 +1022,7 @@ GUEST OS OPTIONS
 ================
 
 
-``--os-variant``, ``--osinfo``
+``--osinfo``, ``--os-variant``
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 **Syntax:** ``--osinfo`` [OSNAME|OPT1=VAL1,...]
@@ -1004,7 +1031,7 @@ Optimize the guest configuration for a specific operating system.
 For most cases, an OS must be specified or detected from the install
 media so performance critical features like virtio can be enabled.
 
-The simplest usage is ``--os-variant OSNAME`` or ``--osinfo OSNAME``,
+The simplest usage is ``--osinfo OSNAME`` or ``--os-variant OSNAME``,
 for example ``--osinfo fedora32``. The supported suboptions are:
 
 ``name=``, ``short-id=``
@@ -1049,7 +1076,7 @@ VIRTINSTALL_OSINFO_DISABLE_REQUIRE=1.
 Use the command ``virt-install --osinfo list`` to get the list of the
 accepted OS variants. See ``osinfo-query os`` for even more output.
 
-Note: ``--os-variant`` and ``--osinfo`` are aliases for one another.
+Note: ``--osinfo`` and ``--os-variant`` are aliases for one another.
 ``--osinfo`` is the preferred new style naming.
 
 
@@ -1204,7 +1231,8 @@ See the examples section for some uses. This option deprecates -f/--file,
 -s/--file-size, --nonsparse, and --nodisks.
 
 Use --disk=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsDisks
+Complete details at
+https://libvirt.org/formatdomain.html#hard-drives-floppy-disks-cdroms
 
 
 
@@ -1240,7 +1268,7 @@ Some example suboptions:
     The mount location to use in the guest.
 
 Use --filesystem=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsFilesystems
+Complete details at https://libvirt.org/formatdomain.html#filesystems
 
 
 
@@ -1308,10 +1336,29 @@ Some example suboptions:
     midonet, and openvswitch config.
 
     Use --network=? to see a list of all available sub options.
-    Complete details at https://libvirt.org/formatdomain.html#elementsNICS
+    Complete details at https://libvirt.org/formatdomain.html#network-interfaces
 
     This option deprecates -m/--mac, -b/--bridge, and --nonetworks
 
+``hostdev=HOSTDEV``
+    Use the referenced nodedev device as the source for ``type=hostdev``
+    as described here: https://libvirt.org/formatdomain.html#pci-passthrough
+
+    For ``HOSTDEV`` format, see ``--hostdev`` documentation
+
+``portForward=[ADDRESS:]HOSTPORT[:GUESTPORT][/PROTO]``
+    Simpler option for specifying port forwarding with
+    ``--network passt`` networks. Roughly matches ``podman run -p``
+    syntax. HOSTPORT can be a represented as a range like ``7000-8000``, but
+    GUESTPORT can only be a single port. If GUESTPORT is not provided, host
+    and guest ports are assumed to match.
+
+    Examples:
+
+    .. code-block::
+
+           --network passt,portForward=8080:80 \
+           --network passt,portForward0=7000-8000/udp,portForward1=127.0.0.1:2222:22 \
 
 
 GRAPHICS OPTIONS
@@ -1417,7 +1464,7 @@ Some supported suboptions:
     DRM render node path to use. This is used when 'gl' is enabled.
 
 Use --graphics=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsGraphics
+Complete details at https://libvirt.org/formatdomain.html#graphical-framebuffers
 
 This deprecates the following options:
 --vnc, --vncport, --vnclisten, -k/--keymap, --sdl, --nographics
@@ -1504,7 +1551,7 @@ DEVICE OPTIONS
 
 All devices have a set of ``address.*`` options for configuring the
 particulars of the device's address on its parent controller or bus.
-See ``https://libvirt.org/formatdomain.html#elementsAddress`` for details.
+See ``https://libvirt.org/formatdomain.html#device-addresses`` for details.
 
 
 
@@ -1534,7 +1581,7 @@ Some example invocations:
     we add to the new VM by default, if the VM will use PCIe by default.
 
 Use --controller=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsControllers
+Complete details at https://libvirt.org/formatdomain.html#controllers
 
 
 
@@ -1546,7 +1593,7 @@ Complete details at https://libvirt.org/formatdomain.html#elementsControllers
 Attach an input device to the guest. Example input device types are mouse, tablet, or keyboard.
 
 Use --input=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsInput
+Complete details at https://libvirt.org/formatdomain.html#input-devices
 
 
 
@@ -1579,7 +1626,7 @@ Attach a physical host device to the guest. Some example values for HOSTDEV:
     Block device (in LXC container).
 
 Use --hostdev=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsHostDev
+Complete details at https://libvirt.org/formatdomain.html#host-device-assignment
 
 
 
@@ -1595,7 +1642,7 @@ OS supports.
 
 This deprecates the old --soundhw option.
 Use --sound=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsSound
+Complete details at https://libvirt.org/formatdomain.html#sound-devices
 
 
 
@@ -1645,7 +1692,7 @@ Some examples:
     Use the i6300esb with the 'poweroff' action
 
 Use --watchdog=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsWatchdog
+Complete details at https://libvirt.org/formatdomain.html#watchdog-devices
 
 
 
@@ -1716,7 +1763,8 @@ noted. Some of the types of character device redirection are:
     --serial tcp,mode=MODE
 
 Use --serial=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsCharSerial
+Complete details at
+https://libvirt.org/formatdomain.html#consoles-serial-parallel-channel-devices
 
 
 
@@ -1729,7 +1777,7 @@ Specify a parallel device. The format and options are largely identical
 to ``serial``
 
 Use --parallel=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsCharParallel
+Complete details at https://libvirt.org/formatdomain.html#parallel-port
 
 
 
@@ -1772,7 +1820,7 @@ Some of the types of character device redirection are:
 
 
 Use --channel=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsCharChannel
+Complete details at https://libvirt.org/formatdomain.html#channel
 
 
 
@@ -1794,7 +1842,7 @@ Example:
 
 
 Use --console=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsCharConsole
+Complete details at https://libvirt.org/formatdomain.html#console
 
 
 
@@ -1807,7 +1855,7 @@ Specify what video device model will be attached to the guest. Valid values
 for VIDEO are hypervisor specific, but some options for recent kvm are
 cirrus, vga, qxl, virtio, or vmvga (vmware).
 Use --video=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsVideo
+Complete details at https://libvirt.org/formatdomain.html#video-devices
 
 
 
@@ -1832,7 +1880,7 @@ An example invocation:
     to the guest
 
 Use --smartcard=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsSmartcard
+Complete details at https://libvirt.org/formatdomain.html#smartcard-devices
 
 
 
@@ -1860,7 +1908,7 @@ Examples invocations:
 
 
 Use --redirdev=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsRedir
+Complete details at https://libvirt.org/formatdomain.html#redirected-devices
 
 
 
@@ -1882,7 +1930,7 @@ MODEL is the type of memballoon device provided. The value can be 'virtio',
     Disable the memballoon device
 
 Use --memballoon=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsMemBalloon
+Complete details at https://libvirt.org/formatdomain.html#memory-balloon-device
 
 
 
@@ -1900,10 +1948,13 @@ Configure a virtual TPM device. Examples:
     Request an emulated TPM device.
 
 ``--tpm default``
-    Request virt-install to fill in a modern recommended default
+    Request virt-install to fill in a modern recommended default.
+
+``--tpm none``
+    Request virt-install to disable TPM device.
 
 Use --tpm=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsTpm
+Complete details at https://libvirt.org/formatdomain.html#tpm-device
 
 
 
@@ -1929,7 +1980,8 @@ Example invocations:
     Connect to localhost to the TCP port 8000 to get entropy data.
 
 Use --rng=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsRng
+Complete details at
+https://libvirt.org/formatdomain.html#random-number-generator-device
 
 
 
@@ -1942,7 +1994,7 @@ Attach a panic notifier device to the guest.
 For the recommended settings, use: ``--panic default``
 
 Use --panic=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsPanic
+Complete details at https://libvirt.org/formatdomain.html#panic-device
 
 
 
@@ -1968,7 +2020,7 @@ Add a memory module to a guest which can be hotunplugged. To add a memdev you ne
 to configure hotplugmemory and NUMA for a guest.
 
 Use --memdev=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#elementsMemory.
+Complete details at https://libvirt.org/formatdomain.html#memory-devices
 
 
 
@@ -1984,7 +2036,7 @@ Configure a vsock host/guest interface. A typical configuration would be
     --vsock cid.auto=yes
 
 Use --vsock=? to see a list of all available sub options.
-Complete details at https://libvirt.org/formatdomain.html#vsock.
+Complete details at https://libvirt.org/formatdomain.html#vsock
 
 
 
@@ -1996,7 +2048,19 @@ Complete details at https://libvirt.org/formatdomain.html#vsock.
 Add an IOMMU device to the guest.
 
 Use --iommu=? to see a list of all available options.
-Complete details at https://libvirt.org/formatdomain.html#elementsIommu.
+Complete details at https://libvirt.org/formatdomain.html#iommu-devices
+
+
+
+``--pstore``
+^^^^^^^^^^^^
+
+**Syntax:** ``--pstore`` OPT=VAL,[...]
+
+Add a pstore device to a guest for storing oops/panic logs before it crashes.
+
+Use --pstore=? to see a list of all available options.
+Complete details at https://libvirt.org/formatdomain.html#pstore
 
 
 

man/virt-manager.rst

@@ -54,8 +54,14 @@ The following options are accepted when running ``virt-manager``
 
 
 ``--no-fork``
-    Don't fork ``virt-manager`` off into the background: run it blocking the
-    current terminal. Useful for seeing possible errors dumped to stdout/stderr.
+    Don't fork ``virt-manager`` off into the background.
+    See ``VIRT-MANAGER, SSH, AND FORKING`` section for more info.
+
+
+``--fork``
+    Force forking ``virt-manager`` off into the background.
+    This is the default behavior.
+    See ``VIRT-MANAGER, SSH, AND FORKING`` section for more info.
 
 
 DIALOG WINDOW OPTIONS
@@ -89,6 +95,42 @@ URI.
     Display the host/connection details window.
 
 
+SYSTEM TRAY OPTION
+==================
+
+Connection autostart will not be disabled and thus don't require specifying a
+manual ``--connect`` URI. But it supports ``--connect`` URI as well:
+
+``--show-systray``
+    Launch virt-manager only in system tray
+
+
+VIRT-MANAGER, SSH, AND FORKING
+==============================
+
+Historically, on startup virt-manager would detach from the running
+terminal and fork into the background. This was to force any usage of
+ssh to call ssh-askpass when it needed a password, rather than silently
+asking on a terminal the user probably isn't watching.
+
+openssh 8.4p1 released in Sep 2020 added the SSH_ASKPASS_REQUIRE
+environment variable that saves us from having to do the fork dance.
+https://man.openbsd.org/ssh.1#SSH_ASKPASS_REQUIRE
+
+virt-manager now sets SSH_ASKPASS_REQUIRE=force.
+However to get this to work with libvirt ssh connections, you'll need
+libvirt 10.8.0 released in October 1st 2024.
+
+virt-manager no longer forks by defaults.
+
+You can get the old forking behavior with the ``--fork`` option,
+or by setting the ``VIRT_MANAGER_DEFAULT_FORK=yes`` environment variable.
+
+However if you find you need forking for a usecase other than temporarily
+working around libvirt version issues, please let the virt-manager developers
+know by filing a bug report.
+
+
 BUGS
 ====
 

man/virt-xml.rst

@@ -180,7 +180,7 @@ These options decide what action to take after altering the XML. In the common c
 GUEST OS OPTIONS
 ================
 
-``--os-variant``, ``--osinfo`` OS_VARIANT
+``--osinfo``, ``--os-variant`` OS_VARIANT
     Optimize the guest configuration for a specific operating system (ex.
     'fedora29', 'rhel7', 'win10'). While not required, specifying this
     options is HIGHLY RECOMMENDED, as it can greatly increase performance
@@ -194,7 +194,54 @@ GUEST OS OPTIONS
     Use the command ``virt-xml --osinfo list`` to get the list of the
     accepted OS variants. See ``osinfo-query os`` for even more output.
 
-    See virt-install(1) documentation for more details about ``--os-variant/--osinfo``
+    See virt-install(1) documentation for more details about ``--osinfo/--os-variant``
+
+
+CONVERSION OPTIONS
+==================
+
+``--convert-to-q35``
+^^^^^^^^^^^^^^^^^^^^
+
+**Syntax:** ``--convert-to-q35`` [OPTIONS]
+
+Convert an existing VM config from PC/i440FX to Q35 machine type.
+This largely consists of:
+
+* Convert device topology from PCI to PCIe
+* Convert any IDE storage to SATA
+
+You may need to make config changes inside the VM to handle this as well.
+For example, Windows 10 may not find the boot device after IDE to SATA conversion.
+But booting into safe mode once may fix it.
+
+Sub options are:
+
+``num_pcie_root_ports=NUM``
+    Control the number of default ``pcie-root-port`` controller devices
+    we add to the VM by default.
+
+
+``--convert-to-vnc``
+^^^^^^^^^^^^^^^^^^^^
+
+**Syntax:** ``--convert-to-vnc`` [OPTIONS]
+
+Convert an existing VM to exclusively use a single VNC graphics device.
+
+It will attempt to remove all references to any non-VNC graphics config, like
+Spice. For example:
+
+* ``qxl`` devices will be replaced
+* all ``spicevmc`` and ``spiceport`` devices will be removed
+* spice GL will be converted to ``egl-headless``
+
+Sub options are:
+
+``qemu-vdagent=on|off``
+    Add a ``qemu-vdagent`` device if one is not already configured.
+    This replaces some functionality of the spice vdagent.
+    This defaults to ``off`` but that could change in the future.
 
 
 XML OPTIONS

meson.build

@@ -0,0 +1,73 @@
+project('virt-manager',
+  version: '5.0.0',
+  meson_version: '>=0.63.0',
+)
+
+python = import('python')
+python3 = python.find_installation('python3')
+
+prefix = get_option('prefix')
+datadir = prefix / get_option('datadir')
+bindir = prefix / get_option('bindir')
+pkgdir = datadir / 'virt-manager'
+
+# figure out if we are building from git
+git = run_command('test', '-e', '.git', check: false).returncode() == 0
+
+subdir('scripts')
+subdir('man')
+subdir('data')
+subdir('ui')
+subdir('virtinst')
+subdir('virtManager')
+subdir('po')
+
+bin_data = [
+  {'pkgname': 'virtinst', 'filename': 'virtinstall', 'toolname': 'virt-install'},
+  {'pkgname': 'virtinst', 'filename': 'virtclone', 'toolname': 'virt-clone'},
+  {'pkgname': 'virtinst', 'filename': 'virtxml', 'toolname': 'virt-xml'},
+  {'pkgname': 'virtManager', 'filename': 'virtmanager', 'toolname': 'virt-manager'},
+]
+
+foreach bin : bin_data
+  custom_target(
+    command: [make_bin_wrapper_prog, pkgdir, bin['pkgname'], bin['filename']],
+    capture: true,
+    output: bin['toolname'],
+    install: true,
+    install_dir: bindir,
+    install_mode: 'rwxr-xr-x',
+  )
+endforeach
+
+gnome = import('gnome')
+gnome.post_install(
+  glib_compile_schemas: get_option('compile-schemas'),
+  gtk_update_icon_cache: get_option('update-icon-cache'),
+)
+
+if git
+  spec_conf = configuration_data({
+    'VERSION': meson.project_version(),
+  })
+
+  spec_file = configure_file(
+    input: 'virt-manager.spec.in',
+    output: '@BASENAME@',
+    configuration: spec_conf,
+  )
+
+  meson.add_dist_script(meson_dist_prog.full_path(), spec_file)
+endif
+
+if get_option('tests').auto()
+  use_tests = git
+elif get_option('tests').enabled()
+  use_tests = true
+else
+  use_tests = false
+endif
+
+if use_tests
+  subdir('tests')
+endif

meson_options.txt

@@ -0,0 +1,7 @@
+option('update-icon-cache', type: 'boolean', value: true, description: 'whether to run gtk-update-icon-cache')
+option('compile-schemas', type: 'boolean', value: true, description: 'whether to compile gsettings schemas')
+
+option('default-graphics', type: 'combo', choices: ['spice', 'vnc'], value: 'spice', description: 'default graphics type')
+option('default-hvs', type: 'array', choices: ['qemu', 'xen', 'lxc', 'bhyve', 'vz'], description: 'list of hypervisors shown in "Open Connection" wizard')
+
+option('tests', type: 'feature', value: 'auto', description: 'whether to run tests')

po/LINGUAS

@@ -1,3 +1,4 @@
+ar
 as
 bg
 bn_IN
@@ -8,17 +9,22 @@ da
 de
 en_GB
 es
+fa
 fi
 fr
 fur
+gl
 gu
 hi
 hr
 hu
 id
+ie
 is
 it
 ja
+ka
+kab
 kn
 ko
 ml
@@ -29,20 +35,19 @@ nl
 or
 pa
 pl
-pt_BR
 pt
+pt_BR
 ro
 ru
+si
 sk
-sr@latin
 sr
+sr@latin
 sv
 ta
 te
 tr
 uk
+vi
 zh_CN
 zh_TW
-kab
-si
-ka

po/POTFILES

@@ -0,0 +1,174 @@
+data/virt-manager.appdata.xml.in
+data/virt-manager.desktop.in
+ui/about.ui
+ui/addhardware.ui
+ui/addstorage.ui
+ui/asyncjob.ui
+ui/clone.ui
+ui/connectauth.ui
+ui/console.ui
+ui/createconn.ui
+ui/createnet.ui
+ui/createpool.ui
+ui/createvm.ui
+ui/createvol.ui
+ui/delete.ui
+ui/details.ui
+ui/fsdetails.ui
+ui/gfxdetails.ui
+ui/hostnets.ui
+ui/hoststorage.ui
+ui/host.ui
+ui/manager.ui
+ui/migrate.ui
+ui/netlist.ui
+ui/oslist.ui
+ui/preferences.ui
+ui/snapshotsnew.ui
+ui/snapshots.ui
+ui/storagebrowse.ui
+ui/tpmdetails.ui
+ui/vmwindow.ui
+ui/vsockdetails.ui
+ui/xmleditor.ui
+virtinst/buildconfig.py
+virtinst/capabilities.py
+virtinst/cli.py
+virtinst/cloner.py
+virtinst/connection.py
+virtinst/devices/audio.py
+virtinst/devices/char.py
+virtinst/devices/controller.py
+virtinst/devices/device.py
+virtinst/devices/disk.py
+virtinst/devices/filesystem.py
+virtinst/devices/graphics.py
+virtinst/devices/hostdev.py
+virtinst/devices/__init__.py
+virtinst/devices/input.py
+virtinst/devices/interface.py
+virtinst/devices/iommu.py
+virtinst/devices/memballoon.py
+virtinst/devices/memory.py
+virtinst/devices/panic.py
+virtinst/devices/redirdev.py
+virtinst/devices/rng.py
+virtinst/devices/shmem.py
+virtinst/devices/smartcard.py
+virtinst/devices/sound.py
+virtinst/devices/tpm.py
+virtinst/devices/video.py
+virtinst/devices/vsock.py
+virtinst/devices/watchdog.py
+virtinst/diskbackend.py
+virtinst/domain/blkiotune.py
+virtinst/domain/clock.py
+virtinst/domain/cpu.py
+virtinst/domain/cputune.py
+virtinst/domain/features.py
+virtinst/domain/idmap.py
+virtinst/domain/__init__.py
+virtinst/domain/keywrap.py
+virtinst/domain/launch_security.py
+virtinst/domain/memorybacking.py
+virtinst/domain/memtune.py
+virtinst/domain/metadata.py
+virtinst/domain/numatune.py
+virtinst/domain/os.py
+virtinst/domain/pm.py
+virtinst/domain/resource.py
+virtinst/domain/seclabel.py
+virtinst/domain/sysinfo.py
+virtinst/domain/vcpus.py
+virtinst/domain/xmlnsqemu.py
+virtinst/domcapabilities.py
+virtinst/generatename.py
+virtinst/guest.py
+virtinst/__init__.py
+virtinst/install/cloudinit.py
+virtinst/install/__init__.py
+virtinst/install/installerinject.py
+virtinst/install/installer.py
+virtinst/install/installertreemedia.py
+virtinst/install/unattended.py
+virtinst/install/urldetect.py
+virtinst/install/urlfetcher.py
+virtinst/install/volumeupload.py
+virtinst/logger.py
+virtinst/network.py
+virtinst/nodedev.py
+virtinst/osdict.py
+virtinst/pollhelpers.py
+virtinst/_progresspriv.py
+virtinst/progress.py
+virtinst/snapshot.py
+virtinst/storage.py
+virtinst/support.py
+virtinst/uri.py
+virtinst/virtclone.py
+virtinst/virtinstall.py
+virtinst/virtxml.py
+virtinst/xmlapi.py
+virtinst/xmlbuilder.py
+virtinst/xmlutil.py
+virtManager/about.py
+virtManager/addhardware.py
+virtManager/asyncjob.py
+virtManager/baseclass.py
+virtManager/clone.py
+virtManager/config.py
+virtManager/connection.py
+virtManager/connmanager.py
+virtManager/createconn.py
+virtManager/createnet.py
+virtManager/createpool.py
+virtManager/createvm.py
+virtManager/createvol.py
+virtManager/delete.py
+virtManager/details/console.py
+virtManager/details/details.py
+virtManager/details/__init__.py
+virtManager/details/serialcon.py
+virtManager/details/snapshots.py
+virtManager/details/sshtunnels.py
+virtManager/details/viewers.py
+virtManager/device/addstorage.py
+virtManager/device/fsdetails.py
+virtManager/device/gfxdetails.py
+virtManager/device/__init__.py
+virtManager/device/mediacombo.py
+virtManager/device/netlist.py
+virtManager/device/tpmdetails.py
+virtManager/device/vsockdetails.py
+virtManager/engine.py
+virtManager/error.py
+virtManager/hostnets.py
+virtManager/host.py
+virtManager/hoststorage.py
+virtManager/__init__.py
+virtManager/lib/connectauth.py
+virtManager/lib/graphwidgets.py
+virtManager/lib/__init__.py
+virtManager/lib/inspection.py
+virtManager/lib/keyring.py
+virtManager/lib/libvirtenummap.py
+virtManager/lib/module_trace.py
+virtManager/lib/statsmanager.py
+virtManager/lib/testmock.py
+virtManager/lib/uiutil.py
+virtManager/manager.py
+virtManager/migrate.py
+virtManager/object/domain.py
+virtManager/object/__init__.py
+virtManager/object/libvirtobject.py
+virtManager/object/network.py
+virtManager/object/nodedev.py
+virtManager/object/storagepool.py
+virtManager/oslist.py
+virtManager/preferences.py
+virtManager/storagebrowse.py
+virtManager/systray.py
+virtManager/virtmanager.py
+virtManager/vmmenu.py
+virtManager/vmwindow.py
+virtManager/xmleditor.py

po/meson.build

@@ -0,0 +1,33 @@
+i18n = import('i18n')
+
+i18n.merge_file(
+  input: desktop_file,
+  output: '@BASENAME@',
+  type: 'desktop',
+  po_dir: meson.current_source_dir(),
+  install: true,
+  install_dir: datadir / 'applications',
+)
+
+i18n.merge_file(
+  input: appdata_file,
+  output: '@BASENAME@',
+  type: 'xml',
+  po_dir: meson.current_source_dir(),
+  install: true,
+  install_dir: datadir / 'metainfo',
+)
+
+i18n.gettext(
+  meson.project_name(),
+  args: [
+    '--from-code=UTF-8',
+    '--keyword=_',
+    '--add-comments=translators',
+    '--directory=@0@'.format(meson.project_source_root()),
+    '--files-from=@0@'.format(meson.current_source_dir() / 'POTFILES'),
+    '--msgid-bugs-address=https://github.com/virt-manager/virt-manager/issues',
+    '--package-version=@0@'.format(meson.project_version()),
+    '--sort-by-file',
+  ],
+)