From nobody Tue May 7 00:28:12 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1601044834; cv=none; d=zohomail.com; s=zohoarc; b=DRJoIMdXAFRHQ366HjStzhX8tU2SDr4CP8uPNiXzbYFpUxMbxcFAgNiwduIuyNk/RorFTELkivuRXcbyBISXtK3zKH0gy6DfSGeOOJaYqFwAiJYaT95lNE2wzPJliodw/R2u6vh8Xx0x6EgakVSsn74+Z1cXpc4PTxGBhknYRvQ= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1601044834; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=tw4K4vAEt26S+i51HKQSJrIO7/2anicl8M2Gm9onSgU=; b=AEa68tWtWqWgjw+lGck2qCO3LGzXCxPFno+7/5pBICjJadFQ2F4CAyhfEp9a8FKzVjP64+pQJPVBZUlRbWQzISdUK9V25ptClUNIK/MoroW9HARthKQNFp91gRAInKRJEOgtI3qXT+7shRqWIq39TR5arVMqUDfg6nj2tojROCY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1601044834222834.3415059852604; Fri, 25 Sep 2020 07:40:34 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-449-Ptzoji8KNcWvVhuXuL8FHA-1; Fri, 25 Sep 2020 10:40:29 -0400 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 8789D104D3EF; Fri, 25 Sep 2020 14:40:23 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 573F95C1BB; Fri, 25 Sep 2020 14:40:23 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 174DE1826D31; Fri, 25 Sep 2020 14:40:23 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 08PEeLRV017410 for ; Fri, 25 Sep 2020 10:40:21 -0400 Received: by smtp.corp.redhat.com (Postfix) id C465D5576F; Fri, 25 Sep 2020 14:40:21 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-114-208.ams2.redhat.com [10.36.114.208]) by smtp.corp.redhat.com (Postfix) with ESMTP id D109655786; Fri, 25 Sep 2020 14:40:20 +0000 (UTC) Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1601044832; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=tw4K4vAEt26S+i51HKQSJrIO7/2anicl8M2Gm9onSgU=; b=DC7RgQtYMryrKJ11vFdsfKQE5iTQPBq3KSjRs97FWH8M52qiLtcnAlVouBrJc45KpqxsUu qRQanKHvJ6VrbvgTuvdOVanEJ+z+sIIGqcqY8kLzZyP2vsdf6kPUg902KtebSZfCJBR3co FZSfcJOltCrLwl5NKonVQwUkq9aHRmk= X-MC-Unique: Ptzoji8KNcWvVhuXuL8FHA-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: libvir-list@redhat.com Subject: [libvirt PATCH 1/2] ci: introduce pygments package to install Date: Fri, 25 Sep 2020 15:40:13 +0100 Message-Id: <20200925144014.2223835-2-berrange@redhat.com> In-Reply-To: <20200925144014.2223835-1-berrange@redhat.com> References: <20200925144014.2223835-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) The pygments package is required by docutils when specifying a language for the "code-block" directive. Signed-off-by: Daniel P. Berrang=C3=A9 --- .gitlab-ci.yml | 2 +- ci/cirrus/build.yml | 6 ++++-- ci/cirrus/libvirt-freebsd-11.vars | 5 ++--- ci/cirrus/libvirt-freebsd-12.vars | 5 ++--- ci/cirrus/libvirt-macos-1015.vars | 6 +++--- ci/cirrus/refresh | 2 +- ci/containers/libvirt-centos-7.Dockerfile | 1 + ci/containers/libvirt-centos-8.Dockerfile | 1 + ci/containers/libvirt-centos-stream.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-aarch64.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-armv6l.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-armv7l.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-i686.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-mips.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-mips64el.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-mipsel.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-ppc64le.Dockerfile | 1 + ci/containers/libvirt-debian-10-cross-s390x.Dockerfile | 1 + ci/containers/libvirt-debian-10.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-aarch64.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-armv6l.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-armv7l.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-i686.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-mips64el.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-mipsel.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-ppc64le.Dockerfile | 1 + ci/containers/libvirt-debian-sid-cross-s390x.Dockerfile | 1 + ci/containers/libvirt-debian-sid.Dockerfile | 1 + ci/containers/libvirt-fedora-31.Dockerfile | 1 + ci/containers/libvirt-fedora-32.Dockerfile | 1 + .../libvirt-fedora-rawhide-cross-mingw32.Dockerfile | 1 + .../libvirt-fedora-rawhide-cross-mingw64.Dockerfile | 1 + ci/containers/libvirt-fedora-rawhide.Dockerfile | 1 + ci/containers/libvirt-opensuse-151.Dockerfile | 1 + ci/containers/libvirt-ubuntu-1804.Dockerfile | 1 + ci/containers/libvirt-ubuntu-2004.Dockerfile | 1 + 36 files changed, 43 insertions(+), 13 deletions(-) diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml index ee404bf50a..e4af3303ee 100644 --- a/.gitlab-ci.yml +++ b/.gitlab-ci.yml @@ -100,7 +100,7 @@ stages: -e "s|[@]PKGS@|$PKGS|g" -e "s|[@]MAKE@|$MAKE|g" -e "s|[@]PYTHON@|$PYTHON|g" - -e "s|[@]PIP@|$PIP|g" + -e "s|[@]PIP3@|$PIP3|g" -e "s|[@]PYPI_PKGS@|$PYPI_PKGS|g" ci/cirrus/$NAME.yml - cat ci/cirrus/$NAME.yml diff --git a/ci/cirrus/build.yml b/ci/cirrus/build.yml index 912284b906..22666771ba 100644 --- a/ci/cirrus/build.yml +++ b/ci/cirrus/build.yml @@ -9,11 +9,13 @@ env: PKG_CONFIG_PATH: "@PKG_CONFIG_PATH@" PYTHON: "@PYTHON@" MAKE: "@MAKE@" + PKGS: "@PKGS@" + PYPI_PKGS: "@PYPI_PKGS@" =20 build_task: install_script: - - @INSTALL_COMMAND@ @PKGS@ - - @PIP@ install @PYPI_PKGS@ + - @INSTALL_COMMAND@ $PKGS + - test -z "$PYPI_PKGS" || @PIP3@ install $PYPI_PKGS clone_script: - git clone --depth 100 "$CI_REPOSITORY_URL" . - git fetch origin "$CI_COMMIT_REF_NAME" diff --git a/ci/cirrus/libvirt-freebsd-11.vars b/ci/cirrus/libvirt-freebsd-= 11.vars index 7c29c6f899..26ae7b6e10 100644 --- a/ci/cirrus/libvirt-freebsd-11.vars +++ b/ci/cirrus/libvirt-freebsd-11.vars @@ -4,6 +4,5 @@ CCACHE=3D'/usr/local/bin/ccache' MAKE=3D'/usr/local/bin/gmake' NINJA=3D'/usr/local/bin/ninja' PYTHON=3D'/usr/local/bin/python3' -PIP=3D'/usr/local/bin/pip-3.7' -PKGS=3D'augeas autoconf automake avahi bash bash-completion ca_root_nss cc= ache chrony cppi curl cyrus-sasl dbus diskscrub dnsmasq fusefs-libs gdb get= text gettext-tools git glib gmake gnutls hal libpcap libpciaccess libssh li= bssh2 libtool libxml2 libxslt lsof ncurses ninja p5-App-cpanminus patch per= l5 pkgconf polkit py37-docutils py37-flake8 py37-pip py37-setuptools py37-w= heel python3 qemu-utils radvd readline screen sudo vim yajl' -PYPI_PKGS=3D'meson=3D=3D0.54.0' +PIP3=3D'/usr/local/bin/pip-3.7' +PKGS=3D'augeas autoconf automake avahi bash bash-completion ca_root_nss cc= ache chrony cppi curl cyrus-sasl dbus diskscrub dnsmasq fusefs-libs gdb get= text gettext-tools git glib gmake gnutls hal libpcap libpciaccess libssh li= bssh2 libtool libxml2 libxslt lsof meson ninja p5-App-cpanminus patch perl5= pkgconf polkit py37-docutils py37-flake8 py37-pip py37-pygments py37-setup= tools py37-wheel python3 qemu-utils radvd readline screen sudo vim yajl' diff --git a/ci/cirrus/libvirt-freebsd-12.vars b/ci/cirrus/libvirt-freebsd-= 12.vars index 7c29c6f899..26ae7b6e10 100644 --- a/ci/cirrus/libvirt-freebsd-12.vars +++ b/ci/cirrus/libvirt-freebsd-12.vars @@ -4,6 +4,5 @@ CCACHE=3D'/usr/local/bin/ccache' MAKE=3D'/usr/local/bin/gmake' NINJA=3D'/usr/local/bin/ninja' PYTHON=3D'/usr/local/bin/python3' -PIP=3D'/usr/local/bin/pip-3.7' -PKGS=3D'augeas autoconf automake avahi bash bash-completion ca_root_nss cc= ache chrony cppi curl cyrus-sasl dbus diskscrub dnsmasq fusefs-libs gdb get= text gettext-tools git glib gmake gnutls hal libpcap libpciaccess libssh li= bssh2 libtool libxml2 libxslt lsof ncurses ninja p5-App-cpanminus patch per= l5 pkgconf polkit py37-docutils py37-flake8 py37-pip py37-setuptools py37-w= heel python3 qemu-utils radvd readline screen sudo vim yajl' -PYPI_PKGS=3D'meson=3D=3D0.54.0' +PIP3=3D'/usr/local/bin/pip-3.7' +PKGS=3D'augeas autoconf automake avahi bash bash-completion ca_root_nss cc= ache chrony cppi curl cyrus-sasl dbus diskscrub dnsmasq fusefs-libs gdb get= text gettext-tools git glib gmake gnutls hal libpcap libpciaccess libssh li= bssh2 libtool libxml2 libxslt lsof meson ninja p5-App-cpanminus patch perl5= pkgconf polkit py37-docutils py37-flake8 py37-pip py37-pygments py37-setup= tools py37-wheel python3 qemu-utils radvd readline screen sudo vim yajl' diff --git a/ci/cirrus/libvirt-macos-1015.vars b/ci/cirrus/libvirt-macos-10= 15.vars index 7704d747df..db4c2809ad 100644 --- a/ci/cirrus/libvirt-macos-1015.vars +++ b/ci/cirrus/libvirt-macos-1015.vars @@ -4,6 +4,6 @@ CCACHE=3D'/usr/local/bin/ccache' MAKE=3D'/usr/local/bin/gmake' NINJA=3D'/usr/local/bin/ninja' PYTHON=3D'/usr/local/bin/python3' -PIP=3D'/usr/local/bin/pip3' -PKGS=3D'augeas autoconf automake bash bash-completion ccache cpanminus cpp= i curl dbus dnsmasq docutils flake8 gdb gettext git glib gnutls gpatch libi= scsi libpcap libssh libssh2 libtool libxml2 libxslt lsof make ncurses ninja= perl pkg-config python3 qemu readline rpcgen screen scrub vim xz yajl' -PYPI_PKGS=3D'meson=3D=3D0.54.0' +PIP3=3D'/usr/local/bin/pip3' +PKGS=3D'augeas autoconf automake bash bash-completion ccache cpanminus cpp= i curl dbus dnsmasq docutils flake8 gdb gettext git glib gnutls gpatch libi= scsi libpcap libssh libssh2 libtool libxml2 libxslt lsof make meson ninja p= erl pkg-config python3 qemu readline rpcgen screen scrub vim xz yajl' +PYPI_PKGS=3D'pygments' diff --git a/ci/cirrus/refresh b/ci/cirrus/refresh index 3a178909f8..d373d87ea2 100755 --- a/ci/cirrus/refresh +++ b/ci/cirrus/refresh @@ -14,7 +14,7 @@ then exit 1 fi =20 -HOSTS=3D$($LCITOOL hosts | grep -E 'freebsd-12|macos') +HOSTS=3D$($LCITOOL hosts | grep -E 'freebsd-11|freebsd-12|macos') =20 for host in $HOSTS do diff --git a/ci/containers/libvirt-centos-7.Dockerfile b/ci/containers/libv= irt-centos-7.Dockerfile index 165368ed9a..ee6e3f5b7a 100644 --- a/ci/containers/libvirt-centos-7.Dockerfile +++ b/ci/containers/libvirt-centos-7.Dockerfile @@ -106,6 +106,7 @@ WEiJKtQrZDJloqtyi/mmRa1VsV7RYR0VPJjhK/R8EQ7Ysshy\n\ python3-setuptools \ python3-wheel \ python36-docutils \ + python36-pygments \ qemu-img \ radvd \ readline-devel \ diff --git a/ci/containers/libvirt-centos-8.Dockerfile b/ci/containers/libv= irt-centos-8.Dockerfile index 7fd793580c..f30491b7d1 100644 --- a/ci/containers/libvirt-centos-8.Dockerfile +++ b/ci/containers/libvirt-centos-8.Dockerfile @@ -77,6 +77,7 @@ RUN dnf install 'dnf-command(config-manager)' -y && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-img \ diff --git a/ci/containers/libvirt-centos-stream.Dockerfile b/ci/containers= /libvirt-centos-stream.Dockerfile index 70db325cc1..bf8864fb51 100644 --- a/ci/containers/libvirt-centos-stream.Dockerfile +++ b/ci/containers/libvirt-centos-stream.Dockerfile @@ -78,6 +78,7 @@ RUN dnf install -y centos-release-stream && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-img \ diff --git a/ci/containers/libvirt-debian-10-cross-aarch64.Dockerfile b/ci/= containers/libvirt-debian-10-cross-aarch64.Dockerfile index 0eb01468dd..e026a9f600 100644 --- a/ci/containers/libvirt-debian-10-cross-aarch64.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-aarch64.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-armv6l.Dockerfile b/ci/c= ontainers/libvirt-debian-10-cross-armv6l.Dockerfile index b7f434f75f..b8d2482e9c 100644 --- a/ci/containers/libvirt-debian-10-cross-armv6l.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-armv6l.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-armv7l.Dockerfile b/ci/c= ontainers/libvirt-debian-10-cross-armv7l.Dockerfile index d5388bf214..41be7e9afd 100644 --- a/ci/containers/libvirt-debian-10-cross-armv7l.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-armv7l.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-i686.Dockerfile b/ci/con= tainers/libvirt-debian-10-cross-i686.Dockerfile index 24f69ac6d4..26bcaf87e4 100644 --- a/ci/containers/libvirt-debian-10-cross-i686.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-i686.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-mips.Dockerfile b/ci/con= tainers/libvirt-debian-10-cross-mips.Dockerfile index c0db737669..dab136aed7 100644 --- a/ci/containers/libvirt-debian-10-cross-mips.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-mips.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-mips64el.Dockerfile b/ci= /containers/libvirt-debian-10-cross-mips64el.Dockerfile index d6c51f58ca..8dff853601 100644 --- a/ci/containers/libvirt-debian-10-cross-mips64el.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-mips64el.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-mipsel.Dockerfile b/ci/c= ontainers/libvirt-debian-10-cross-mipsel.Dockerfile index 342de4270b..2c757ae196 100644 --- a/ci/containers/libvirt-debian-10-cross-mipsel.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-mipsel.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-ppc64le.Dockerfile b/ci/= containers/libvirt-debian-10-cross-ppc64le.Dockerfile index 037adfe4eb..c298502521 100644 --- a/ci/containers/libvirt-debian-10-cross-ppc64le.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-ppc64le.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10-cross-s390x.Dockerfile b/ci/co= ntainers/libvirt-debian-10-cross-s390x.Dockerfile index 60012de8f0..9c42bcbaf1 100644 --- a/ci/containers/libvirt-debian-10-cross-s390x.Dockerfile +++ b/ci/containers/libvirt-debian-10-cross-s390x.Dockerfile @@ -47,6 +47,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-10.Dockerfile b/ci/containers/lib= virt-debian-10.Dockerfile index e1d606ace5..d5e085800e 100644 --- a/ci/containers/libvirt-debian-10.Dockerfile +++ b/ci/containers/libvirt-debian-10.Dockerfile @@ -82,6 +82,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-aarch64.Dockerfile b/ci= /containers/libvirt-debian-sid-cross-aarch64.Dockerfile index 2efb849c7b..b42cef4ab5 100644 --- a/ci/containers/libvirt-debian-sid-cross-aarch64.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-aarch64.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-armv6l.Dockerfile b/ci/= containers/libvirt-debian-sid-cross-armv6l.Dockerfile index 88334eec16..7d3839fd38 100644 --- a/ci/containers/libvirt-debian-sid-cross-armv6l.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-armv6l.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-armv7l.Dockerfile b/ci/= containers/libvirt-debian-sid-cross-armv7l.Dockerfile index cae9101676..ff8ef300dc 100644 --- a/ci/containers/libvirt-debian-sid-cross-armv7l.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-armv7l.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-i686.Dockerfile b/ci/co= ntainers/libvirt-debian-sid-cross-i686.Dockerfile index 8aea704897..84f428dc97 100644 --- a/ci/containers/libvirt-debian-sid-cross-i686.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-i686.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-mips64el.Dockerfile b/c= i/containers/libvirt-debian-sid-cross-mips64el.Dockerfile index 713dc16470..d06bfb92aa 100644 --- a/ci/containers/libvirt-debian-sid-cross-mips64el.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-mips64el.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-mipsel.Dockerfile b/ci/= containers/libvirt-debian-sid-cross-mipsel.Dockerfile index c566ab19ae..4f9ed42f33 100644 --- a/ci/containers/libvirt-debian-sid-cross-mipsel.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-mipsel.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-ppc64le.Dockerfile b/ci= /containers/libvirt-debian-sid-cross-ppc64le.Dockerfile index ba3ee5ad70..bbc7a7b5e1 100644 --- a/ci/containers/libvirt-debian-sid-cross-ppc64le.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-ppc64le.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid-cross-s390x.Dockerfile b/ci/c= ontainers/libvirt-debian-sid-cross-s390x.Dockerfile index 9ac88c469a..036bef97da 100644 --- a/ci/containers/libvirt-debian-sid-cross-s390x.Dockerfile +++ b/ci/containers/libvirt-debian-sid-cross-s390x.Dockerfile @@ -48,6 +48,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-debian-sid.Dockerfile b/ci/containers/li= bvirt-debian-sid.Dockerfile index fd9b46706f..fc6ee4f77c 100644 --- a/ci/containers/libvirt-debian-sid.Dockerfile +++ b/ci/containers/libvirt-debian-sid.Dockerfile @@ -83,6 +83,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-fedora-31.Dockerfile b/ci/containers/lib= virt-fedora-31.Dockerfile index 36adde5101..7f7820e617 100644 --- a/ci/containers/libvirt-fedora-31.Dockerfile +++ b/ci/containers/libvirt-fedora-31.Dockerfile @@ -75,6 +75,7 @@ RUN dnf update -y && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-img \ diff --git a/ci/containers/libvirt-fedora-32.Dockerfile b/ci/containers/lib= virt-fedora-32.Dockerfile index bbd7ff87a4..bb36df49bb 100644 --- a/ci/containers/libvirt-fedora-32.Dockerfile +++ b/ci/containers/libvirt-fedora-32.Dockerfile @@ -76,6 +76,7 @@ RUN dnf update -y && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-img \ diff --git a/ci/containers/libvirt-fedora-rawhide-cross-mingw32.Dockerfile = b/ci/containers/libvirt-fedora-rawhide-cross-mingw32.Dockerfile index cf70e5939b..298df86341 100644 --- a/ci/containers/libvirt-fedora-rawhide-cross-mingw32.Dockerfile +++ b/ci/containers/libvirt-fedora-rawhide-cross-mingw32.Dockerfile @@ -46,6 +46,7 @@ RUN dnf update -y --nogpgcheck fedora-gpg-keys && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-img \ diff --git a/ci/containers/libvirt-fedora-rawhide-cross-mingw64.Dockerfile = b/ci/containers/libvirt-fedora-rawhide-cross-mingw64.Dockerfile index 92a5b991c9..f48cf71653 100644 --- a/ci/containers/libvirt-fedora-rawhide-cross-mingw64.Dockerfile +++ b/ci/containers/libvirt-fedora-rawhide-cross-mingw64.Dockerfile @@ -46,6 +46,7 @@ RUN dnf update -y --nogpgcheck fedora-gpg-keys && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-img \ diff --git a/ci/containers/libvirt-fedora-rawhide.Dockerfile b/ci/container= s/libvirt-fedora-rawhide.Dockerfile index d362662f35..04f2740000 100644 --- a/ci/containers/libvirt-fedora-rawhide.Dockerfile +++ b/ci/containers/libvirt-fedora-rawhide.Dockerfile @@ -77,6 +77,7 @@ RUN dnf update -y --nogpgcheck fedora-gpg-keys && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-img \ diff --git a/ci/containers/libvirt-opensuse-151.Dockerfile b/ci/containers/= libvirt-opensuse-151.Dockerfile index 7332b1f9fb..d99e6e9453 100644 --- a/ci/containers/libvirt-opensuse-151.Dockerfile +++ b/ci/containers/libvirt-opensuse-151.Dockerfile @@ -76,6 +76,7 @@ RUN zypper update -y && \ python3-docutils \ python3-flake8 \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-tools \ diff --git a/ci/containers/libvirt-ubuntu-1804.Dockerfile b/ci/containers/l= ibvirt-ubuntu-1804.Dockerfile index 83ac7ea6ad..003c2b4e78 100644 --- a/ci/containers/libvirt-ubuntu-1804.Dockerfile +++ b/ci/containers/libvirt-ubuntu-1804.Dockerfile @@ -83,6 +83,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ diff --git a/ci/containers/libvirt-ubuntu-2004.Dockerfile b/ci/containers/l= ibvirt-ubuntu-2004.Dockerfile index 09b213c8ba..0203eecceb 100644 --- a/ci/containers/libvirt-ubuntu-2004.Dockerfile +++ b/ci/containers/libvirt-ubuntu-2004.Dockerfile @@ -83,6 +83,7 @@ RUN export DEBIAN_FRONTEND=3Dnoninteractive && \ python3 \ python3-docutils \ python3-pip \ + python3-pygments \ python3-setuptools \ python3-wheel \ qemu-utils \ --=20 2.26.2 From nobody Tue May 7 00:28:12 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) client-ip=216.205.24.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1601044867; cv=none; d=zohomail.com; s=zohoarc; b=Nr0GQQTmnrb9rep9Pji/DxrCE/jQramT8sxZ5OAENhoo81sRYJYtYsA/13XwHbrRvrHM4YOvnTw+AXZpd+xrU5kz9TSuL1OF9/Ofg8FF0tZyq5bkLJRt51KjcmmCLAj4wDtvCJhjNgykCz0gg4Pbg1J3tN4+SLALaSErGDqhfUg= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1601044867; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=zW7pgAch25uvkhugUBK6i5LJ6z1ju4LsoIOWsLUHGPI=; b=MmEx3qK2JBpYJim1cIsb52RKMKBRzdgwXCk7wZInZCAXCOYh73l6Nf1jWimKZ+FUcIyKZhkvcNRD7ohlLDoufCR3I9KCinsM+YCB0vtUlYprWm4Yvw7sWH9lchSqkGJN6NFUfYxWLR4tGC6jLrSjMqDIhcb5YN3yycMnDE2Tddg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 216.205.24.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [216.205.24.124]) by mx.zohomail.com with SMTPS id 1601044867203512.2574918653459; Fri, 25 Sep 2020 07:41:07 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-419-e_gVwuPAPXCiisHhPCe2gA-1; Fri, 25 Sep 2020 10:40:32 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 26398101872C; Fri, 25 Sep 2020 14:40:27 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 03BA27369C; Fri, 25 Sep 2020 14:40:27 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 9F66F44A5E; Fri, 25 Sep 2020 14:40:26 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 08PEeNfH017417 for ; Fri, 25 Sep 2020 10:40:23 -0400 Received: by smtp.corp.redhat.com (Postfix) id 1E8AC5578D; Fri, 25 Sep 2020 14:40:23 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-114-208.ams2.redhat.com [10.36.114.208]) by smtp.corp.redhat.com (Postfix) with ESMTP id 1CC8A5576F; Fri, 25 Sep 2020 14:40:21 +0000 (UTC) Dkim-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1601044865; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=zW7pgAch25uvkhugUBK6i5LJ6z1ju4LsoIOWsLUHGPI=; b=JfiFyorqEm4tnDClmjnC8i/dyAQu4+RZYm5ZWOmAa4m38j0WHhV43jg3e4InqtpZ/jC2Bn d/KoC56CvM2NcWzpYNcPzksSwCu8COKo2jvNh+1RRZpkYMU4wvVxW4CbuMFyAS2oOB1HbQ TOiIYYhepgcFA/UMEzx5qJDuJP/PXls= X-MC-Unique: e_gVwuPAPXCiisHhPCe2gA-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: libvir-list@redhat.com Subject: [libvirt PATCH 2/2] docs: specify "sh" as the language for code-block directives Date: Fri, 25 Sep 2020 15:40:14 +0100 Message-Id: <20200925144014.2223835-3-berrange@redhat.com> In-Reply-To: <20200925144014.2223835-1-berrange@redhat.com> References: <20200925144014.2223835-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) This makes the man pages compatible with both implementations of the rst2html5 tool. Signed-off-by: Daniel P. Berrang=C3=A9 Reviewed-by: J=C3=A1n Tomko --- docs/manpages/libvirtd.rst | 4 +- docs/manpages/virsh.rst | 582 +++++++++++++++++------------------ docs/manpages/virt-admin.rst | 52 ++-- docs/manpages/virtlockd.rst | 4 +- docs/manpages/virtlogd.rst | 4 +- 5 files changed, 323 insertions(+), 323 deletions(-) diff --git a/docs/manpages/libvirtd.rst b/docs/manpages/libvirtd.rst index c88e2dd7e1..af9a69e626 100644 --- a/docs/manpages/libvirtd.rst +++ b/docs/manpages/libvirtd.rst @@ -199,7 +199,7 @@ EXAMPLES =20 To retrieve the version of libvirtd: =20 -.. code-block:: +.. code-block:: shell =20 # libvirtd --version libvirtd (libvirt) 0.8.2 @@ -207,7 +207,7 @@ To retrieve the version of libvirtd: =20 To start libvirtd, instructing it to daemonize and create a PID file: =20 -.. code-block:: +.. code-block:: shell =20 # libvirtd -d # ls -la @RUNSTATEDIR@/libvirtd.pid diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index ebf4f16cf7..8d2f727d81 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -38,7 +38,7 @@ KVM, LXC, OpenVZ, VirtualBox and VMware ESX. The basic structure of most virsh usage is: =20 =20 -.. code-block:: +.. code-block:: shell =20 virsh [OPTION]... [ARG]... =20 @@ -185,7 +185,7 @@ historical reasons, some commands default to bytes, whi= le other commands default to kibibytes). The following case-insensitive suffixes can be used to select a specific scale: =20 -.. code-block:: +.. code-block:: shell =20 b, byte byte 1 KB kilobyte 1,000 @@ -214,7 +214,7 @@ help =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 help [command-or-group] =20 @@ -228,7 +228,7 @@ group as an option. For example: =20 **Example 1:** =20 -.. code-block:: +.. code-block:: shell =20 virsh # help host =20 @@ -250,7 +250,7 @@ option instead. For example: =20 **Example 2:** =20 -.. code-block:: +.. code-block:: shell =20 virsh # help list NAME @@ -272,7 +272,7 @@ quit, exit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 quit exit @@ -286,7 +286,7 @@ version =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 version [--daemon] =20 @@ -296,7 +296,7 @@ is included in the output. =20 **Example:** =20 -.. code-block:: +.. code-block:: shell =20 $ virsh version Compiled against library: libvirt 1.2.3 @@ -317,7 +317,7 @@ cd =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 cd [directory] =20 @@ -334,7 +334,7 @@ pwd =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pwd =20 @@ -347,7 +347,7 @@ connect =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 connect [URI] [--readonly] =20 @@ -388,7 +388,7 @@ uri =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 uri =20 @@ -400,7 +400,7 @@ hostname =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 hostname =20 @@ -412,7 +412,7 @@ sysinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 sysinfo =20 @@ -424,7 +424,7 @@ nodeinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodeinfo =20 @@ -440,7 +440,7 @@ nodecpumap =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodecpumap [--pretty] =20 @@ -456,7 +456,7 @@ nodecpustats =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodecpustats [cpu] [--percent] =20 @@ -471,7 +471,7 @@ nodememstats =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodememstats [cell] =20 @@ -484,7 +484,7 @@ nodesuspend =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodesuspend [target] [duration] =20 @@ -503,7 +503,7 @@ node-memory-tune =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 node-memory-tune [shm-pages-to-scan] [shm-sleep-millisecs] [shm-merge-a= cross-nodes] =20 @@ -525,7 +525,7 @@ capabilities =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 capabilities =20 @@ -545,7 +545,7 @@ domcapabilities =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domcapabilities [virttype] [emulatorbin] [arch] [machine] =20 @@ -588,7 +588,7 @@ pool-capabilities =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-capabilities =20 @@ -605,7 +605,7 @@ inject-nmi =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 inject-nmi domain =20 @@ -617,7 +617,7 @@ list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 list [--inactive | --all] [--managed-save] [--title] @@ -637,7 +637,7 @@ specified it prints out information about running domai= ns. =20 An example format for the list is as follows: =20 -.. code-block:: +.. code-block:: shell =20 ``virsh`` list Id Name State @@ -775,7 +775,7 @@ printed in an extra column. This flag is usable only wi= th the default =20 **Example 2:** =20 -.. code-block:: +.. code-block:: shell =20 $ virsh list --title Id Name State Title @@ -790,7 +790,7 @@ freecell =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 freecell [{ [--cellno] cellno | --all }] =20 @@ -809,7 +809,7 @@ freepages =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 freepages [{ [--cellno] cellno [--pagesize] pagesize | --all }] =20 @@ -824,7 +824,7 @@ allocpages =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 allocpages [--pagesize] pagesize [--pagecount] pagecount [[--cellno] ce= llno] [--add] [--all] =20 @@ -843,7 +843,7 @@ cpu-baseline =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 cpu-baseline FILE [--features] [--migratable] =20 @@ -864,7 +864,7 @@ cpu-compare =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 cpu-compare FILE [--error] =20 @@ -890,7 +890,7 @@ cpu-models =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 cpu-models arch =20 @@ -909,7 +909,7 @@ echo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 echo [--shell] [--xml] [err...] [arg...] =20 @@ -926,7 +926,7 @@ hypervisor-cpu-compare =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 hypervisor-cpu-compare FILE [virttype] [emulator] [arch] [machine] [--e= rror] =20 @@ -958,7 +958,7 @@ hypervisor-cpu-baseline =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 hypervisor-cpu-baseline FILE [virttype] [emulator] [arch] [machine] [--= features] [--migratable] =20 @@ -1005,7 +1005,7 @@ autostart =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 autostart [--disable] domain =20 @@ -1020,7 +1020,7 @@ blkdeviotune =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 blkdeviotune domain device [[--config] [--live] | [--current]] [[total-bytes-sec] | [read-bytes-sec] [write-bytes-sec]] @@ -1103,7 +1103,7 @@ blkiotune =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 blkiotune domain [--weight weight] [--device-weights device-weights] [--device-read-iops-sec device-read-iops-sec] @@ -1165,7 +1165,7 @@ blockcommit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 blockcommit domain path [bandwidth] [--bytes] [base] [--shallow] [top] [--delete] [--keep-relative] @@ -1223,7 +1223,7 @@ blockcopy =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 blockcopy domain path { dest [format] [--blockdev] | --xml file } [--shallow] [--reuse-external] [bandwidth] @@ -1295,7 +1295,7 @@ blockjob =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 blockjob domain path { [--abort] [--async] [--pivot] | [--info] [--raw] [--bytes] | [bandwidth] } @@ -1345,7 +1345,7 @@ blockpull =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 blockpull domain path [bandwidth] [--bytes] [base] [--wait [--verbose] [--timeout seconds] [--async]] @@ -1386,7 +1386,7 @@ blockresize =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 blockresize domain path size =20 @@ -1407,7 +1407,7 @@ console =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 console domain [devname] [--safe] [--force] =20 @@ -1428,7 +1428,7 @@ cpu-stats =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 cpu-stats domain [--total] [start] [count] =20 @@ -1444,7 +1444,7 @@ create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 create FILE [--console] [--paused] [--autodestroy] [--pass-fds N,M,...] [--validate] @@ -1475,7 +1475,7 @@ is only supported with container based virtualization. #. prepare a template from an existing domain (skip directly to 3a if writ= ing one from scratch) =20 - .. code-block:: + .. code-block:: shell =20 # virsh dumpxml > domain.xml =20 @@ -1484,7 +1484,7 @@ is only supported with container based virtualization. a. DO CHANGE! and ( can also be removed), or b. DON'T CHANGE! either or =20 - .. code-block:: + .. code-block:: shell =20 # $EDITOR domain.xml =20 @@ -1495,7 +1495,7 @@ is only supported with container based virtualization. b. an existing persistent guest will run with a modified one-time configuration =20 - .. code-block:: + .. code-block:: shell =20 # virsh create domain.xml =20 @@ -1505,7 +1505,7 @@ define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 define FILE [--validate] =20 @@ -1521,7 +1521,7 @@ desc =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 desc domain [[--live] [--config] | [--current]] [--title] [--edit] [--new-desc @@ -1553,7 +1553,7 @@ destroy =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 destroy domain [--graceful] =20 @@ -1581,7 +1581,7 @@ domblkerror =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domblkerror domain =20 @@ -1597,7 +1597,7 @@ domblkinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domblkinfo domain [block-device --all] [--human] =20 @@ -1617,7 +1617,7 @@ domblklist =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domblklist domain [--inactive] [--details] =20 @@ -1637,7 +1637,7 @@ domblkstat =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domblkstat domain [block-device] [--human] =20 @@ -1674,7 +1674,7 @@ domblkthreshold =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domblkthreshold domain dev threshold =20 @@ -1689,7 +1689,7 @@ domcontrol =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domcontrol domain =20 @@ -1703,7 +1703,7 @@ domdisplay =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domdisplay domain [--include-password] [[--type] type] [--all] =20 @@ -1720,7 +1720,7 @@ domfsfreeze =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domfsfreeze domain [[--mountpoint] mountpoint...] =20 @@ -1742,7 +1742,7 @@ domfsinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domfsinfo domain =20 @@ -1759,7 +1759,7 @@ domfsthaw =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domfsthaw domain [[--mountpoint] mountpoint...] =20 @@ -1776,7 +1776,7 @@ domfstrim =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domfstrim domain [--minimum bytes] [--mountpoint mountPoint] =20 @@ -1797,7 +1797,7 @@ domhostname =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domhostname domain [--source lease|agent] =20 @@ -1814,7 +1814,7 @@ domid =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domid domain-name-or-uuid =20 @@ -1826,7 +1826,7 @@ domif-getlink =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domif-getlink domain interface-device [--config] =20 @@ -1842,7 +1842,7 @@ domif-setlink =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domif-setlink domain interface-device state [--config] =20 @@ -1858,7 +1858,7 @@ domifaddr =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domifaddr domain [interface] [--full] [--source lease|agent|arp] @@ -1885,7 +1885,7 @@ backup-begin =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 backup-begin domain [backupxml] [checkpointxml] [--reuse-external] =20 @@ -1919,7 +1919,7 @@ backup-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 backup-dumpxml domain =20 @@ -1931,7 +1931,7 @@ domiflist =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domiflist domain [--inactive] =20 @@ -1948,7 +1948,7 @@ domifstat =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domifstat domain interface-device =20 @@ -1965,7 +1965,7 @@ domiftune =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domiftune domain interface-device [[--config] [--live] | [--current]] [*--inbound average,peak,burst,floor*] @@ -2000,7 +2000,7 @@ dominfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 dominfo domain =20 @@ -2012,7 +2012,7 @@ domjobabort =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domjobabort domain =20 @@ -2024,7 +2024,7 @@ domjobinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domjobinfo domain [--completed [--keep-completed]] [--anystats] [--raws= tats] =20 @@ -2051,7 +2051,7 @@ dommemstat =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 dommemstat domain [--period seconds] [[--config] [--live] | [--current]] =20 @@ -2106,7 +2106,7 @@ domname =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domname domain-id-or-uuid =20 @@ -2118,7 +2118,7 @@ dompmsuspend =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 dompmsuspend domain target [--duration] =20 @@ -2149,7 +2149,7 @@ dompmwakeup =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 dompmwakeup domain =20 @@ -2164,7 +2164,7 @@ domrename =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domrename domain new-name =20 @@ -2179,7 +2179,7 @@ domstate =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domstate domain [--reason] =20 @@ -2192,7 +2192,7 @@ domstats =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domstats [--raw] [--enforce] [--backing] [--nowait] [--state] [--cpu-total] [--balloon] [--vcpu] [--interface] @@ -2426,7 +2426,7 @@ domtime =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domtime domain { [--now] [--pretty] [--sync] [--time time] } =20 @@ -2451,7 +2451,7 @@ domuuid =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domuuid domain-name-or-id =20 @@ -2463,7 +2463,7 @@ domxml-from-native =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domxml-from-native format config =20 @@ -2481,7 +2481,7 @@ domxml-to-native =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 domxml-to-native format { [--xml] xml | --domain domain-name-or-id-or-u= uid } =20 @@ -2496,7 +2496,7 @@ dump =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 dump domain corefilepath [--bypass-cache] { [--live] | [--crash] | [--reset] } @@ -2538,7 +2538,7 @@ dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 dumpxml domain [--inactive] [--security-info] [--update-cpu] [--migrata= ble] =20 @@ -2559,7 +2559,7 @@ edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 edit domain =20 @@ -2568,7 +2568,7 @@ next boot of the guest. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh dumpxml --inactive --security-info domain > domain.xml vi domain.xml (or make changes with your other text editor) @@ -2585,7 +2585,7 @@ emulatorpin =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 emulatorpin domain [cpulist] [[--live] [--config] | [--current]] =20 @@ -2608,7 +2608,7 @@ event =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 event {[domain] { event | --all } [--loop] [--timeout seconds] [--times= tamp] | --list} =20 @@ -2635,7 +2635,7 @@ guest-agent-timeout =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 guest-agent-timeout domain [--timeout value] =20 @@ -2655,7 +2655,7 @@ guestinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 guestinfo domain [--user] [--os] [--timezone] [--hostname] [--filesyste= m] =20 @@ -2731,7 +2731,7 @@ guestvcpus =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 guestvcpus domain [[--enable] | [--disable]] [cpulist] =20 @@ -2750,7 +2750,7 @@ iothreadadd =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iothreadadd domain iothread_id [[--config] [--live] | [--current]] =20 @@ -2770,7 +2770,7 @@ iothreaddel =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iothreaddel domain iothread_id [[--config] [--live] | [--current]] =20 @@ -2792,7 +2792,7 @@ iothreadinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iothreadinfo domain [[--live] [--config] | [--current]] =20 @@ -2813,7 +2813,7 @@ iothreadpin =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iothreadpin domain iothread cpulist [[--live] [--config] | [--current]] =20 @@ -2846,7 +2846,7 @@ iothreadset =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iothreadset domain iothread_id [[--poll-max-ns ns] [--poll-grow factor] [--poll-shrink divisor]] @@ -2878,7 +2878,7 @@ managedsave =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 managedsave domain [--bypass-cache] [{--running | --paused}] [--verbose] =20 @@ -2907,7 +2907,7 @@ managedsave-define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 managedsave-define domain xml [{--running | --paused}] =20 @@ -2927,7 +2927,7 @@ managedsave-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 managedsave-dumpxml domain [--security-info] =20 @@ -2941,7 +2941,7 @@ managedsave-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 managedsave-edit domain [{--running | --paused}] =20 @@ -2955,7 +2955,7 @@ will allow overriding which state the ``restore`` sho= uld use. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh managedsave-dumpxml domain-name > state-file.xml vi state-file.xml (or make changes with your other text editor) @@ -2972,7 +2972,7 @@ managedsave-remove =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 managedsave-remove domain =20 @@ -2985,7 +2985,7 @@ maxvcpus =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 maxvcpus [type] =20 @@ -2999,7 +2999,7 @@ memtune =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 memtune domain [--hard-limit size] [--soft-limit size] [--swap-hard-lim= it size] [--min-guarantee size] [[--config] [--live] | [--current]] @@ -3058,7 +3058,7 @@ metadata =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 metadata domain [[--live] [--config] | [--current]] [--edit] [uri] [key] [set] [--remove] @@ -3097,7 +3097,7 @@ migrate =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 migrate [--live] [--offline] [--direct] [--p2p [--tunnelled]] [--persistent] [--undefinesource] [--suspend] [--copy-storage-all] @@ -3240,7 +3240,7 @@ and/or libvirt does not have network access to the re= mote side you can use a UNIX transport in the URI and specify a socket path in the query, for exam= ple with the qemu driver you could use this: =20 -.. code-block:: +.. code-block:: shell =20 qemu+unix:///system?socket=3D/path/to/socket =20 @@ -3274,7 +3274,7 @@ There are a few scenarios where specifying *migrateur= i* may help: should not guess a *migrateuri* and it should be specified using UNIX socket path URI: =20 -.. code-block:: +.. code-block:: shell =20 unix:///path/to/socket =20 @@ -3289,7 +3289,7 @@ connected to and needs to connect through a proxy, *g= raphicsuri* may be used to specify the address the client should connect to. The URI is formed as follows: =20 -.. code-block:: +.. code-block:: shell =20 protocol://hostname[:port]/[?parameters] =20 @@ -3297,7 +3297,7 @@ where protocol is either "spice" or "vnc" and paramet= ers is a list of protocol specific parameters separated by '&'. Currently recognized parameters are "tlsPort" and "tlsSubject". For example, =20 -.. code-block:: +.. code-block:: shell =20 spice://target.host.com:1234/?tlsPort=3D4567 =20 @@ -3327,7 +3327,7 @@ migrate-compcache =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 migrate-compcache domain [--size bytes] =20 @@ -3347,7 +3347,7 @@ migrate-getmaxdowntime =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 migrate-getmaxdowntime domain =20 @@ -3362,7 +3362,7 @@ migrate-getspeed =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 migrate-getspeed domain [--postcopy] =20 @@ -3376,7 +3376,7 @@ migrate-postcopy =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 migrate-postcopy domain =20 @@ -3389,7 +3389,7 @@ migrate-setmaxdowntime =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 migrate-setmaxdowntime domain downtime =20 @@ -3403,7 +3403,7 @@ migrate-setspeed =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 migrate-setspeed domain bandwidth [--postcopy] =20 @@ -3421,7 +3421,7 @@ numatune =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 numatune domain [--mode mode] [--nodeset nodeset] [[--config] [--live] | [--current]] @@ -3459,7 +3459,7 @@ perf =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 perf domain [--enable eventSpec] [--disable eventSpec] [[--config] [--live] | [--current]] @@ -3548,7 +3548,7 @@ reboot =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 reboot domain [--mode MODE-LIST] =20 @@ -3574,7 +3574,7 @@ reset =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 reset domain =20 @@ -3590,7 +3590,7 @@ restore =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 restore state-file [--bypass-cache] [--xml file] [{--running | --paused}] @@ -3622,7 +3622,7 @@ resume =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 resume domain =20 @@ -3636,7 +3636,7 @@ save =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 save domain state-file [--bypass-cache] [--xml file] [{--running | --paused}] [--verbose] @@ -3680,7 +3680,7 @@ save-image-define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 save-image-define file xml [{--running | --paused}] =20 @@ -3702,7 +3702,7 @@ save-image-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 save-image-dumpxml file [--security-info] =20 @@ -3716,7 +3716,7 @@ save-image-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 save-image-edit file [{--running | --paused}] =20 @@ -3730,7 +3730,7 @@ will allow overriding which state the ``restore`` sho= uld use. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh save-image-dumpxml state-file > state-file.xml vi state-file.xml (or make changes with your other text editor) @@ -3747,7 +3747,7 @@ schedinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 schedinfo domain [[--config] [--live] | [--current]] [[--set] parameter= =3Dvalue]... schedinfo [--weight number] [--cap number] domain @@ -3790,7 +3790,7 @@ screenshot =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 screenshot domain [imagefilepath] [--screen screenID] =20 @@ -3807,7 +3807,7 @@ send-key =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 send-key domain [--codeset codeset] [--holdtime holdtime] keycode... =20 @@ -3904,7 +3904,7 @@ distinct keypresses, you must use multiple send-key i= nvocations. =20 **Examples:** =20 -.. code-block:: +.. code-block:: shell =20 # send three strokes 'k', 'e', 'y', using xt codeset. these # are all pressed simultaneously and may be received by the guest @@ -3924,7 +3924,7 @@ send-process-signal =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 send-process-signal domain-id pid signame =20 @@ -3935,7 +3935,7 @@ domain namespace. The *signame* argument may be either an integer signal constant number, or one of the symbolic names: =20 -.. code-block:: +.. code-block:: shell =20 "nop", "hup", "int", "quit", "ill", "trap", "abrt", "bus", "fpe", "kill", @@ -3955,7 +3955,7 @@ may be in uppercase or lowercase. =20 **Examples:** =20 -.. code-block:: +.. code-block:: shell =20 virsh send-process-signal myguest 1 15 virsh send-process-signal myguest 1 term @@ -3968,7 +3968,7 @@ set-lifecycle-action =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 set-lifecycle-action domain type action [[--config] [--live] | [--current]] @@ -3985,7 +3985,7 @@ set-user-password =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 set-user-password domain user password [--encrypted] =20 @@ -4003,7 +4003,7 @@ setmaxmem =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 setmaxmem domain size [[--config] [--live] | [--current]] =20 @@ -4035,7 +4035,7 @@ setmem =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 setmem domain size [[--config] [--live] | [--current]] =20 @@ -4071,7 +4071,7 @@ setvcpus =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 setvcpus domain count [--maximum] [[--config] [--live] | [--current]] [= --guest] [--hotpluggable] =20 @@ -4123,7 +4123,7 @@ setvcpu =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 setvcpu domain vcpulist [--enable] | [--disable] [[--live] [--config] | [--current]] @@ -4151,7 +4151,7 @@ shutdown =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 shutdown domain [--mode MODE-LIST] =20 @@ -4183,7 +4183,7 @@ start =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 start domain-name-or-uuid [--console] [--paused] [--autodestroy] [--bypass-cache] [--force-boot] @@ -4212,7 +4212,7 @@ suspend =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 suspend domain =20 @@ -4225,7 +4225,7 @@ ttyconsole =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 ttyconsole domain =20 @@ -4238,7 +4238,7 @@ undefine =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 undefine domain [--managed-save] [--snapshots-metadata] [--checkpoints-metadata] [--nvram] [--keep-nvram] @@ -4304,7 +4304,7 @@ vcpucount =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vcpucount domain [{--maximum | --active} {--config | --live | --current}] [--guest] @@ -4335,7 +4335,7 @@ vcpuinfo =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vcpuinfo domain [--pretty] =20 @@ -4346,7 +4346,7 @@ With *--pretty*, cpu affinities are shown as ranges. =20 **Example:** =20 -.. code-block:: +.. code-block:: shell =20 $ virsh vcpuinfo fedora VCPU: 0 @@ -4399,7 +4399,7 @@ vcpupin =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vcpupin domain [vcpu] [cpulist] [[--live] [--config] | [--current]] =20 @@ -4428,7 +4428,7 @@ vncdisplay =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vncdisplay domain =20 @@ -4451,7 +4451,7 @@ attach-device =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 attach-device domain FILE [[[--live] [--config] | [--current]] | [--per= sistent]] =20 @@ -4488,7 +4488,7 @@ attach-disk =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 attach-disk domain source target [[[--live] [--config] | [--current]] | [--persistent]] [--targetbus bus] @@ -4556,7 +4556,7 @@ attach-interface =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 attach-interface domain type source [[[--live] [--config] | [--current]] | [--persistent]] @@ -4648,7 +4648,7 @@ detach-device =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 detach-device domain FILE [[[--live] [--config] | [--current]] | [--persistent]] @@ -4695,7 +4695,7 @@ detach-device-alias =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 detach-device-alias domain alias [[[--live] [--config] | [--current]]]] =20 @@ -4717,7 +4717,7 @@ detach-disk =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 detach-disk domain target [[[--live] [--config] | [--current]] | [--persistent]] [--print-xml] @@ -4751,7 +4751,7 @@ detach-interface =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 detach-interface domain type [--mac mac] [[[--live] [--config] | [--current]] | [--persistent]] @@ -4784,7 +4784,7 @@ update-device =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 update-device domain file [--force] [[[--live] [--config] | [--current]] | [--persistent]] @@ -4819,7 +4819,7 @@ change-media =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 change-media domain path [--eject] [--insert] [--update] [source] [--force] [[--live] [--config] | @@ -4889,7 +4889,7 @@ nodedev-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-create FILE =20 @@ -4905,7 +4905,7 @@ nodedev-destroy =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-destroy device =20 @@ -4920,7 +4920,7 @@ nodedev-detach =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-detach nodedev [--driver backend_driver] =20 @@ -4940,7 +4940,7 @@ nodedev-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-dumpxml device =20 @@ -4957,7 +4957,7 @@ nodedev-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-list cap --tree =20 @@ -4976,7 +4976,7 @@ nodedev-reattach =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-reattach nodedev =20 @@ -4991,7 +4991,7 @@ nodedev-reset =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-reset nodedev =20 @@ -5006,7 +5006,7 @@ nodedev-event =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nodedev-event {[nodedev] event [--loop] [--timeout seconds] [--timestam= p] | --list} =20 @@ -5042,7 +5042,7 @@ net-autostart =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-autostart network [--disable] =20 @@ -5055,7 +5055,7 @@ net-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-create file =20 @@ -5070,7 +5070,7 @@ net-define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-define file =20 @@ -5083,7 +5083,7 @@ net-destroy =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-destroy network =20 @@ -5096,7 +5096,7 @@ net-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-dumpxml network [--inactive] =20 @@ -5111,7 +5111,7 @@ net-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-edit network =20 @@ -5119,7 +5119,7 @@ Edit the XML configuration file for a network. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh net-dumpxml --inactive network > network.xml vi network.xml (or make changes with your other text editor) @@ -5136,7 +5136,7 @@ net-event =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-event {[network] event [--loop] [--timeout seconds] [--timestamp] |= --list} =20 @@ -5161,7 +5161,7 @@ net-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-info network =20 @@ -5173,7 +5173,7 @@ net-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-list [--inactive | --all] { [--table] | --name | --uuid } @@ -5204,7 +5204,7 @@ net-name =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-name network-UUID =20 @@ -5216,7 +5216,7 @@ net-start =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-start network =20 @@ -5228,7 +5228,7 @@ net-undefine =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-undefine network =20 @@ -5241,7 +5241,7 @@ net-uuid =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-uuid network-name =20 @@ -5253,7 +5253,7 @@ net-update =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-update network command section xml [--parent-index index] [[--live] [--config] | [--current]] @@ -5301,7 +5301,7 @@ net-dhcp-leases =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-dhcp-leases network [mac] =20 @@ -5326,7 +5326,7 @@ net-port-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-port-list { [--table] | --uuid } network =20 @@ -5343,7 +5343,7 @@ net-port-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-port-create network file =20 @@ -5356,7 +5356,7 @@ net-port-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-port-dumpxml network port =20 @@ -5368,7 +5368,7 @@ net-port-delete =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 net-port-delete network port =20 @@ -5397,7 +5397,7 @@ iface-bridge =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-bridge interface bridge [--no-stp] [delay] [--no-start] =20 @@ -5416,7 +5416,7 @@ iface-define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-define file =20 @@ -5429,7 +5429,7 @@ iface-destroy =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-destroy interface =20 @@ -5442,7 +5442,7 @@ iface-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-dumpxml interface [--inactive] =20 @@ -5456,7 +5456,7 @@ iface-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-edit interface =20 @@ -5464,7 +5464,7 @@ Edit the XML configuration file for a host interface. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh iface-dumpxml iface > iface.xml vi iface.xml (or make changes with your other text editor) @@ -5481,7 +5481,7 @@ iface-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-list [--inactive | --all] =20 @@ -5495,7 +5495,7 @@ iface-name =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-name interface =20 @@ -5510,7 +5510,7 @@ iface-mac =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-mac interface =20 @@ -5524,7 +5524,7 @@ iface-start =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-start interface =20 @@ -5536,7 +5536,7 @@ iface-unbridge =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-unbridge bridge [--no-start] =20 @@ -5554,7 +5554,7 @@ iface-undefine =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-undefine interface =20 @@ -5566,7 +5566,7 @@ iface-begin =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-begin =20 @@ -5584,7 +5584,7 @@ iface-commit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-commit =20 @@ -5598,7 +5598,7 @@ iface-rollback =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 iface-rollback =20 @@ -5624,7 +5624,7 @@ find-storage-pool-sources =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 find-storage-pool-sources type [srcSpec] =20 @@ -5662,7 +5662,7 @@ find-pool-sources-as =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 find-storage-pool-sources-as type [host] [port] [initiator] =20 @@ -5686,7 +5686,7 @@ pool-autostart =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-autostart pool-or-uuid [--disable] =20 @@ -5698,7 +5698,7 @@ pool-build =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-build pool-or-uuid [--overwrite] [--no-overwrite] =20 @@ -5740,7 +5740,7 @@ pool-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-create file [--build] [[--overwrite] | [--no-overwrite]] =20 @@ -5758,7 +5758,7 @@ pool-create-as =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-create-as name type [--source-host hostname] [--source-path path] [--source-dev path] @@ -5848,7 +5848,7 @@ pool-define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-define file =20 @@ -5861,7 +5861,7 @@ pool-define-as =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-define-as name type [--source-host hostname] [--source-path path] [--source-dev path] @@ -5887,7 +5887,7 @@ pool-destroy =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-destroy pool-or-uuid =20 @@ -5902,7 +5902,7 @@ pool-delete =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-delete pool-or-uuid =20 @@ -5916,7 +5916,7 @@ pool-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-dumpxml [--inactive] pool-or-uuid =20 @@ -5930,7 +5930,7 @@ pool-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-edit pool-or-uuid =20 @@ -5938,7 +5938,7 @@ Edit the XML configuration file for a storage pool. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh pool-dumpxml pool > pool.xml vi pool.xml (or make changes with your other text editor) @@ -5955,7 +5955,7 @@ pool-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-info [--bytes] pool-or-uuid =20 @@ -5968,7 +5968,7 @@ pool-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-list [--inactive] [--all] [--persistent] [--transient] @@ -6008,7 +6008,7 @@ pool-name =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-name uuid =20 @@ -6020,7 +6020,7 @@ pool-refresh =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-refresh pool-or-uuid =20 @@ -6032,7 +6032,7 @@ pool-start =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-start pool-or-uuid [--build] [[--overwrite] | [--no-overwrite]] =20 @@ -6060,7 +6060,7 @@ pool-undefine =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-undefine pool-or-uuid =20 @@ -6072,7 +6072,7 @@ pool-uuid =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-uuid pool =20 @@ -6084,7 +6084,7 @@ pool-event =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pool-event {[pool] event [--loop] [--timeout seconds] [--timestamp] | -= -list} =20 @@ -6112,7 +6112,7 @@ vol-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-create pool-or-uuid FILE [--prealloc-metadata] =20 @@ -6131,7 +6131,7 @@ only slightly higher initial disk space usage. =20 **Example:** =20 -.. code-block:: +.. code-block:: shell =20 virsh vol-dumpxml --pool storagepool1 appvolume1 > newvolume.xml vi newvolume.xml (or make changes with your other text editor) @@ -6143,7 +6143,7 @@ vol-create-from =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-create-from pool-or-uuid FILE vol-name-or-key-or-path [--inputpool pool-or-uuid] [--prealloc-metadata] [--reflink] @@ -6174,7 +6174,7 @@ vol-create-as =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-create-as pool-or-uuid name capacity [--allocation size] [--format = string] [--backing-vol vol-name-or-key-or-path] @@ -6223,7 +6223,7 @@ vol-clone =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-clone vol-name-or-key-or-path name [--pool pool-or-uuid] [--prealloc-metadata] [--reflink] @@ -6256,7 +6256,7 @@ vol-delete =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-delete vol-name-or-key-or-path [--pool pool-or-uuid] [--delete-snap= shots] =20 @@ -6280,7 +6280,7 @@ vol-upload =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-upload vol-name-or-key-or-path local-file [--pool pool-or-uuid] [--offset bytes] @@ -6318,7 +6318,7 @@ vol-download =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-download vol-name-or-key-or-path local-file [--pool pool-or-uuid] [--offset bytes] [--length bytes] @@ -6349,7 +6349,7 @@ vol-wipe =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-wipe vol-name-or-key-or-path [--pool pool-or-uuid] [--algorithm alg= orithm] =20 @@ -6408,7 +6408,7 @@ vol-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-dumpxml vol-name-or-key-or-path [--pool pool-or-uuid] =20 @@ -6428,7 +6428,7 @@ vol-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-info vol-name-or-key-or-path [--pool pool-or-uuid] [--bytes] [--phy= sical] =20 @@ -6457,7 +6457,7 @@ vol-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-list [--pool pool-or-uuid] [--details] =20 @@ -6474,7 +6474,7 @@ vol-pool =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-pool vol-key-or-path [--uuid] =20 @@ -6492,7 +6492,7 @@ vol-path =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-path vol-name-or-key [--pool pool-or-uuid] =20 @@ -6511,7 +6511,7 @@ vol-name =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-name vol-key-or-path =20 @@ -6525,7 +6525,7 @@ vol-key =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-key vol-name-or-path [--pool pool-or-uuid] =20 @@ -6545,7 +6545,7 @@ vol-resize =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 vol-resize vol-name-or-path capacity [--pool pool-or-uuid] [--allocate]= [--delta] [--shrink] =20 @@ -6590,7 +6590,7 @@ secret-define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 secret-define file =20 @@ -6605,7 +6605,7 @@ secret-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 secret-dumpxml secret =20 @@ -6617,7 +6617,7 @@ secret-event =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 secret-event {[secret] event [--loop] [--timeout seconds] [--timestamp]= | --list} =20 @@ -6642,7 +6642,7 @@ secret-set-value =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 secret-set-value secret (--file filename [--plain] | --interactive | ba= se64) =20 @@ -6665,7 +6665,7 @@ secret-get-value =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 secret-get-value [--plain] secret =20 @@ -6682,7 +6682,7 @@ secret-undefine =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 secret-undefine secret =20 @@ -6696,7 +6696,7 @@ secret-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 secret-list [--ephemeral] [--no-ephemeral] [--private] [--no-private] @@ -6723,7 +6723,7 @@ snapshot-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-create domain [xmlfile] {[--redefine [--current]] | [--no-metadata] [--halt] [--disk-only] [--reuse-external] @@ -6804,7 +6804,7 @@ snapshot-create-as =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-create-as domain {[--print-xml] [--no-metadata] [--halt] [--reuse-external]} [name] @@ -6843,7 +6843,7 @@ all three of *domain*, *name*, and *description* are = also present. For example, a diskspec of "vda,snapshot=3Dexternal,file=3D/path/to,,new" results in the following XML: =20 -.. code-block:: +.. code-block:: shell =20 @@ -6886,7 +6886,7 @@ snapshot-current =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-current domain {[--name] | [--security-info] | [snapshotname]} =20 @@ -6905,7 +6905,7 @@ snapshot-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-edit domain [snapshotname] [--current] {[--rename] | [--clone]} =20 @@ -6917,7 +6917,7 @@ snapshot. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh snapshot-dumpxml dom name > snapshot.xml vi snapshot.xml (or make changes with your other text editor) @@ -6942,7 +6942,7 @@ snapshot-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-info domain {snapshot | --current} =20 @@ -6955,7 +6955,7 @@ snapshot-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-list domain [--metadata] [--no-metadata] [{--parent | --roots | [{--tree | --name}]}] [--topological] @@ -7024,7 +7024,7 @@ snapshot-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-dumpxml domain snapshot [--security-info] =20 @@ -7038,7 +7038,7 @@ snapshot-parent =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-parent domain {snapshot | --current} =20 @@ -7051,7 +7051,7 @@ snapshot-revert =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-revert domain {snapshot | --current} [{--running | --paused}] = [--force] =20 @@ -7101,7 +7101,7 @@ snapshot-delete =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 snapshot-delete domain {snapshot | --current} [--metadata] [{--children | --children-only}] @@ -7135,7 +7135,7 @@ checkpoint-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-create domain [xmlfile] { --redefine | [--quiesce]} =20 @@ -7174,7 +7174,7 @@ checkpoint-create-as =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-create-as domain [--print-xml] [name] [description] [--quiesce] [--diskspec] diskspec]... @@ -7194,7 +7194,7 @@ all three of *domain*, *name*, and *description* are = also present. For example, a diskspec of "vda,checkpoint=3Dbitmap,bitmap=3Dmap1" results in the following XML: =20 -.. code-block:: +.. code-block:: shell =20 =20 @@ -7212,7 +7212,7 @@ checkpoint-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-edit domain checkpointname =20 @@ -7220,7 +7220,7 @@ Edit the XML configuration file for *checkpointname* = of a domain. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh checkpoint-dumpxml dom name > checkpoint.xml vi checkpoint.xml (or make changes with your other text editor) @@ -7238,7 +7238,7 @@ checkpoint-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-info domain checkpoint =20 @@ -7250,7 +7250,7 @@ checkpoint-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-list domain [{--parent | --roots | [{--tree | --name}]}] [--topological] @@ -7296,7 +7296,7 @@ checkpoint-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-dumpxml domain checkpoint [--security-info] [--no-domain] [-= -size] =20 @@ -7316,7 +7316,7 @@ checkpoint-parent =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-parent domain checkpoint =20 @@ -7328,7 +7328,7 @@ checkpoint-delete =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 checkpoint-delete domain checkpoint [--metadata] [{--children | --children-only}] @@ -7365,7 +7365,7 @@ nwfilter-define =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-define xmlfile =20 @@ -7382,7 +7382,7 @@ nwfilter-undefine =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-undefine nwfilter-name =20 @@ -7395,7 +7395,7 @@ nwfilter-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-list =20 @@ -7407,7 +7407,7 @@ nwfilter-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-dumpxml nwfilter-name =20 @@ -7419,7 +7419,7 @@ nwfilter-edit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-edit nwfilter-name =20 @@ -7427,7 +7427,7 @@ Edit the XML of a network filter. =20 This is equivalent to: =20 -.. code-block:: +.. code-block:: shell =20 virsh nwfilter-dumpxml myfilter > myfilter.xml vi myfilter.xml (or make changes with your other text editor) @@ -7458,7 +7458,7 @@ nwfilter-binding-create =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-binding-create xmlfile =20 @@ -7477,7 +7477,7 @@ nwfilter-binding-delete =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-binding-delete port-name =20 @@ -7495,7 +7495,7 @@ nwfilter-binding-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-binding-list =20 @@ -7507,7 +7507,7 @@ nwfilter-binding-dumpxml =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 nwfilter-binding-dumpxml port-name =20 @@ -7531,7 +7531,7 @@ qemu-attach =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 qemu-attach pid =20 @@ -7540,7 +7540,7 @@ The QEMU process must have been created with a monito= r connection using the UNIX driver. Ideally the process will also have had the '-name' argument specified. =20 -.. code-block:: +.. code-block:: shell =20 $ qemu-kvm -cdrom ~/demo.iso \ -monitor unix:/tmp/demo,server,nowait \ @@ -7561,7 +7561,7 @@ qemu-monitor-command =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 qemu-monitor-command domain { [--hmp] | [--pretty] [--return-value] } c= ommand... =20 @@ -7588,7 +7588,7 @@ qemu-agent-command =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 qemu-agent-command domain [--timeout seconds | --async | --block] comma= nd... =20 @@ -7606,7 +7606,7 @@ qemu-monitor-event =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 qemu-monitor-event [domain] [--event event-name] [--loop] [--timeout seconds] [--pretty] [--regex] [--no-case] @@ -7637,7 +7637,7 @@ lxc-enter-namespace =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 lxc-enter-namespace domain [--noseclabel] -- /path/to/binary [arg1, [arg2, ...]] diff --git a/docs/manpages/virt-admin.rst b/docs/manpages/virt-admin.rst index d5cb23a1c5..97bb058ef3 100644 --- a/docs/manpages/virt-admin.rst +++ b/docs/manpages/virt-admin.rst @@ -28,7 +28,7 @@ as for monitoring and managing all clients connected to t= he daemon. =20 The basic structure of most virt-admin usage is: =20 -.. code-block:: +.. code-block:: shell =20 virt-admin [OPTION]... [ARG]... =20 @@ -107,7 +107,7 @@ help =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 help [command-or-group] =20 @@ -124,7 +124,7 @@ quit, exit =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 quit exit @@ -136,7 +136,7 @@ version =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 version =20 @@ -146,7 +146,7 @@ the version of the daemon. =20 **Example:** =20 -.. code-block:: +.. code-block:: shell =20 $ virt-admin version Compiled against library: libvirt 1.2.21 @@ -160,7 +160,7 @@ cd =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 cd [directory] =20 @@ -175,7 +175,7 @@ pwd =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 pwd =20 @@ -187,7 +187,7 @@ connect =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 connect [URI] =20 @@ -206,7 +206,7 @@ uri =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 uri =20 @@ -230,7 +230,7 @@ server-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 server-list =20 @@ -243,7 +243,7 @@ daemon-log-filters =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 daemon-log-filters [--filters string] =20 @@ -264,7 +264,7 @@ space. Each filter must conform to the form described i= n detail by To define a filter which suppresses all e.g. 'virObjectUnref' DEBUG messages, use the following: =20 -.. code-block:: +.. code-block:: shell =20 $ virt-admin daemon-log-filters "4:util.object" =20 @@ -277,7 +277,7 @@ daemon-log-outouts =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 daemon-log-outputs [--outputs string] =20 @@ -298,13 +298,13 @@ space. Each output must conform to the form described= in detail by To replace the current setting for logging outputs with one that writes to a file while logging errors only, the following could be used: =20 -.. code-block:: +.. code-block:: shell =20 $ virt-admin daemon-log-outputs "4:file:" =20 To define multiple outputs at once they need to be delimited by spaces: =20 -.. code-block:: +.. code-block:: shell =20 $ virt-admin daemon-log-outputs "4:stderr 2:syslog:" =20 @@ -320,7 +320,7 @@ server-threadpool-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 server-threadpool-info server =20 @@ -355,7 +355,7 @@ that, unlike tasks carried out by normal workers, are w= ithin libvirt's full control and libvirt guarantees that such a task cannot hang, thus will alw= ays finish. An example of such a task this would be destroying a domain: =20 -.. code-block:: +.. code-block:: shell =20 $ virsh destroy . =20 @@ -365,7 +365,7 @@ server-threadpool-set =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 server-threadpool-set server [--min-workers count] [--max-workers count= ] [--priority-workers count] =20 @@ -394,7 +394,7 @@ server-clients-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 server-clients-info server =20 @@ -407,7 +407,7 @@ runtime values, more specifically, the current number o= f clients connected to =20 **Example:** =20 -.. code-block:: +.. code-block:: shell =20 # virt-admin server-clients-info libvirtd nclients_max : 120 @@ -421,7 +421,7 @@ server-clients-set =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 server-clients-set server [--max-clients count] [--max-unauth-clients c= ount] =20 @@ -447,7 +447,7 @@ server-update-tls =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 server-update-tls server =20 @@ -474,7 +474,7 @@ client-list =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 client-list server =20 @@ -488,7 +488,7 @@ client-info =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 client-info server client =20 @@ -504,7 +504,7 @@ enabled within daemon). =20 **Examples:** =20 -.. code-block:: +.. code-block:: shell =20 # virt-admin client-info libvirtd 1 id : 1 @@ -530,7 +530,7 @@ client-disconnect =20 **Syntax:** =20 -.. code-block:: +.. code-block:: shell =20 client-disconnect server client =20 diff --git a/docs/manpages/virtlockd.rst b/docs/manpages/virtlockd.rst index ea37b25d05..452135d1cb 100644 --- a/docs/manpages/virtlockd.rst +++ b/docs/manpages/virtlockd.rst @@ -120,14 +120,14 @@ EXAMPLES =20 To retrieve the version of ``virtlockd``: =20 -.. code-block:: +.. code-block:: shell =20 # virtlockd --version virtlockd (libvirt) 1.1.1 =20 To start ``virtlockd``, instructing it to daemonize and create a PID file: =20 -.. code-block:: +.. code-block:: shell =20 # virtlockd -d # ls -la @RUNSTATEDIR@/virtlockd.pid diff --git a/docs/manpages/virtlogd.rst b/docs/manpages/virtlogd.rst index edf8288230..c3120cb10a 100644 --- a/docs/manpages/virtlogd.rst +++ b/docs/manpages/virtlogd.rst @@ -121,14 +121,14 @@ EXAMPLES =20 To retrieve the version of ``virtlogd``: =20 -.. code-block:: +.. code-block:: shell =20 # virtlogd --version virtlogd (libvirt) 1.1.1 =20 To start ``virtlogd``, instructing it to daemonize and create a PID file: =20 -.. code-block:: +.. code-block:: shell =20 # virtlogd -d # ls -la @RUNSTATEDIR@/virtlogd.pid --=20 2.26.2