From nobody Sat Feb 7 11:05:30 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 63.128.21.124 as permitted sender) client-ip=63.128.21.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 63.128.21.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=1605632591; cv=none; d=zohomail.com; s=zohoarc; b=f5oYwMmndq68zw7QUXjL66URhH/ZwG9DNFZESYZcn9QF8IDN6ScTyKVecIvEZlTifsHrHT0wMNkgxBL8/BsvxMCrzYOPnu0avW6xjbWhg2pXsN+Rz9tvMzZELWeADKxegopaqd4FUON+UQ9GcZw4jWp6Uo7IZAWs5dBaM1NB738= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1605632591; 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=BCO3MgzYlubLFZFcQl8Vqze3QqN3/hdKte9Ev0PmPKw=; b=XQRr617Rqg+mYBqY2u5It22xebSQeO3DORaFxfHdu8gohcNrRZlPyMXo4IT4l1Q5/JVdpVAcO7g6rze1THtomg4rvvP1+XpI1o92kXdWfF0bkVPFO06Uy0r84tPJ0dm4uUTLjVnX3QqlkptVlfbKXBgeD2BVdym8d8R/7He9Sik= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 63.128.21.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 [63.128.21.124]) by mx.zohomail.com with SMTPS id 1605632590689396.6885766020563; Tue, 17 Nov 2020 09:03:10 -0800 (PST) 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-463-db1hf9ZVMe6xtaml3MVO2g-1; Tue, 17 Nov 2020 12:02:46 -0500 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 59A2E1882FBB; Tue, 17 Nov 2020 17:02:40 +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 31F765B4CF; Tue, 17 Nov 2020 17:02:40 +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 E92321832FE0; Tue, 17 Nov 2020 17:02:39 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 0AHGAVko027955 for ; Tue, 17 Nov 2020 11:10:31 -0500 Received: by smtp.corp.redhat.com (Postfix) id F36BB5B4BE; Tue, 17 Nov 2020 16:10:30 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-115-10.ams2.redhat.com [10.36.115.10]) by smtp.corp.redhat.com (Postfix) with ESMTP id 175285B4CF; Tue, 17 Nov 2020 16:10:29 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1605632588; 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=BCO3MgzYlubLFZFcQl8Vqze3QqN3/hdKte9Ev0PmPKw=; b=go7FGGQZ6vP1/BQATuQWrRoy+772kBgybe25sw9SReZq9xWcI1cMuJyIbOHKsWQt0tQag+ 0nYj/eSLi3jd8N21S5CKAQRiO22RZ6GCLFisAwvYM7xxVgHbsFUGbxIS7IJAq1HzvR6UkF Fe9gus/IvPQNd6wU64Pc+TmUoLSnbzU= X-MC-Unique: db1hf9ZVMe6xtaml3MVO2g-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: libvir-list@redhat.com Subject: [libvirt PATCH 01/16] docs: consistently mark libvirtd as preformatted text Date: Tue, 17 Nov 2020 16:10:12 +0000 Message-Id: <20201117161027.210543-2-berrange@redhat.com> In-Reply-To: <20201117161027.210543-1-berrange@redhat.com> References: <20201117161027.210543-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 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.11 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) Signed-off-by: Daniel P. Berrang=C3=A9 --- docs/manpages/libvirtd.rst | 48 +++++++++++++++++++------------------- 1 file changed, 24 insertions(+), 24 deletions(-) diff --git a/docs/manpages/libvirtd.rst b/docs/manpages/libvirtd.rst index cd9976c5e4..2ce6284b3a 100644 --- a/docs/manpages/libvirtd.rst +++ b/docs/manpages/libvirtd.rst @@ -32,13 +32,13 @@ The libvirt client libraries and utilities connect to t= his daemon to issue tasks and collect information about the configuration and resources of the= host system and guests. =20 -By default, the libvirtd daemon listens for requests on a local Unix domain -socket. Using the ``-l`` | ``--listen`` command line option, the libvirtd= daemon -can be instructed to additionally listen on a TCP/IP socket. The TCP/IP s= ocket -to use is defined in the libvirtd configuration file. +By default, the ``libvirtd`` daemon listens for requests on a local Unix d= omain +socket. Using the ``-l`` | ``--listen`` command line option, the ``libvir= td`` +daemon can be instructed to additionally listen on a TCP/IP socket. The T= CP/IP +socket to use is defined in the ``libvirtd`` configuration file. =20 -Restarting libvirtd does not impact running guests. Guests continue to op= erate -and will be picked up automatically if their XML configuration has been +Restarting ``libvirtd`` does not impact running guests. Guests continue to +operate and will be picked up automatically if their XML configuration has= been defined. Any guests whose XML configuration has not been defined will be = lost from the configuration. =20 @@ -98,8 +98,8 @@ Use this configuration file, overriding the default value. ``-l``, ``--listen`` =20 Listen for TCP/IP connections. This should not be set if using systemd -socket activation. Instead activate the libvirtd-tls.socket or -libvirtd-tcp.socket unit files. +socket activation. Instead activate the ``libvirtd-tls.socket`` or +``libvirtd-tcp.socket`` unit files. =20 ``-p``, ``--pid-file *FILE*`` =20 @@ -122,7 +122,7 @@ Display version information then exit. SIGNALS =3D=3D=3D=3D=3D=3D=3D =20 -On receipt of ``SIGHUP`` libvirtd will reload its configuration. +On receipt of ``SIGHUP`` ``libvirtd`` will reload its configuration. =20 =20 FILES @@ -133,25 +133,25 @@ When run as *root* =20 * ``@SYSCONFDIR@/libvirt/libvirtd.conf`` =20 -The default configuration file used by libvirtd, unless overridden on the +The default configuration file used by ``libvirtd``, unless overridden on = the command line using the ``-f`` | ``--config`` option. =20 * ``@RUNSTATEDIR@/libvirt/libvirt-sock`` * ``@RUNSTATEDIR@/libvirt/libvirt-sock-ro`` =20 -The sockets libvirtd will use. +The sockets ``libvirtd`` will use. =20 * ``@SYSCONFDIR@/pki/CA/cacert.pem`` =20 -The TLS **Certificate Authority** certificate libvirtd will use. +The TLS **Certificate Authority** certificate ``libvirtd`` will use. =20 * ``@SYSCONFDIR@/pki/libvirt/servercert.pem`` =20 -The TLS **Server** certificate libvirtd will use. +The TLS **Server** certificate ``libvirtd`` will use. =20 * ``@SYSCONFDIR@/pki/libvirt/private/serverkey.pem`` =20 -The TLS **Server** private key libvirtd will use. +The TLS **Server** private key ``libvirtd`` will use. =20 * ``@RUNSTATEDIR@/libvirtd.pid`` =20 @@ -163,41 +163,41 @@ When run as *non-root* =20 * ``$XDG_CONFIG_HOME/libvirt/libvirtd.conf`` =20 -The default configuration file used by libvirtd, unless overridden on the +The default configuration file used by ``libvirtd``, unless overridden on = the command line using the ``-f``|``--config`` option. =20 * ``$XDG_RUNTIME_DIR/libvirt/libvirt-sock`` =20 -The socket libvirtd will use. +The socket ``libvirtd`` will use. =20 * ``$HOME/.pki/libvirt/cacert.pem`` =20 -The TLS **Certificate Authority** certificate libvirtd will use. +The TLS **Certificate Authority** certificate ``libvirtd`` will use. =20 * ``$HOME/.pki/libvirt/servercert.pem`` =20 -The TLS **Server** certificate libvirtd will use. +The TLS **Server** certificate ``libvirtd`` will use. =20 * ``$HOME/.pki/libvirt/serverkey.pem`` =20 -The TLS **Server** private key libvirtd will use. +The TLS **Server** private key ``libvirtd`` will use. =20 * ``$XDG_RUNTIME_DIR/libvirt/libvirtd.pid`` =20 The PID file to use, unless overridden by the ``-p``|``--pid-file`` option. =20 =20 -If ``$XDG_CONFIG_HOME`` is not set in your environment, libvirtd will use +If ``$XDG_CONFIG_HOME`` is not set in your environment, ``libvirtd`` will = use ``$HOME/.config`` =20 -If ``$XDG_RUNTIME_DIR`` is not set in your environment, libvirtd will use +If ``$XDG_RUNTIME_DIR`` is not set in your environment, ``libvirtd`` will = use ``$HOME/.cache`` =20 =20 EXAMPLES =3D=3D=3D=3D=3D=3D=3D=3D =20 -To retrieve the version of libvirtd: +To retrieve the version of ``libvirtd``: =20 :: =20 @@ -205,7 +205,7 @@ To retrieve the version of libvirtd: libvirtd (libvirt) 0.8.2 =20 =20 -To start libvirtd, instructing it to daemonize and create a PID file: +To start ``libvirtd``, instructing it to daemonize and create a PID file: =20 :: =20 @@ -246,7 +246,7 @@ libvirt AUTHORS file. LICENSE =3D=3D=3D=3D=3D=3D=3D =20 -libvirtd is distributed under the terms of the GNU LGPL v2.1+. +``libvirtd`` is distributed under the terms of the GNU LGPL v2.1+. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE --=20 2.28.0