From nobody Mon Feb 9 09:10:15 2026 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=1609867574; cv=none; d=zohomail.com; s=zohoarc; b=WmDgDTWyX/4yNt4hhKU7luI5NW7gsMTUt3XblJmgf68sjpNgU7vUvtwxbPDCZ80wAIt+eE9tvzINN236qA3UiOpPsrE53DufANSfVpXAKpKT6UykWZXNZD95Oc+sJhA6mYff0aV0DDBsc+dqRiw75IoIISFxz3g082zIUPVCF4M= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1609867574; 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=gw4PwUiTaDQ5lQX4WuC1c+mE8NT7bX7zCiTrQ38dHDg=; b=eV9e3uVJu3h7L8ThNdJ15ZDxp8vu8cHTsDdooAxBahqHMDHkgycjNgTuEEK7XBb7fhhm2jptRy2us9HS0vW980d8NI6HBmx0QSZGlsA7NKtcV7sUHxlcTb1TF+GctURACkG2s7spS2IIdP2ouxmlpzubA3O3YPqYSCT1ws9KuqI= 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 1609867574604399.90749883686703; Tue, 5 Jan 2021 09:26:14 -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-181-ej1P6ckeOeqX9e1-RFiCCw-1; Tue, 05 Jan 2021 12:26:11 -0500 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 00727180A094; Tue, 5 Jan 2021 17:26:05 +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 CE19A7092C; Tue, 5 Jan 2021 17:26:04 +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 6682F4BB7B; Tue, 5 Jan 2021 17:26:04 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 105HQ1AH032281 for ; Tue, 5 Jan 2021 12:26:01 -0500 Received: by smtp.corp.redhat.com (Postfix) id 09D8B60C0F; Tue, 5 Jan 2021 17:26:01 +0000 (UTC) Received: from localhost.localdomain.com (ovpn-114-197.ams2.redhat.com [10.36.114.197]) by smtp.corp.redhat.com (Postfix) with ESMTP id 33B2860BE5; Tue, 5 Jan 2021 17:26:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1609867573; 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=gw4PwUiTaDQ5lQX4WuC1c+mE8NT7bX7zCiTrQ38dHDg=; b=N3nOjBw5U6lLTDEcbJ1MCth5099CWbPOYe5izzqg6SC0zkz3DSitYBygJM0kXIfLYF4TZq HhfgGuZiqe1F36bSwPKzfZP4w0Pcss0osxh2HhCutilFxbQ7yMBmpAPR7YSDm/kQzyI0dx paCvpjXvmZ4K5orkzz6WrpIf3zNZMTM= X-MC-Unique: ej1P6ckeOeqX9e1-RFiCCw-1 From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?= To: libvir-list@redhat.com Subject: [libvirt PATCH v2 01/16] docs: consistently mark libvirtd as preformatted text Date: Tue, 5 Jan 2021 17:25:39 +0000 Message-Id: <20210105172554.943968-2-berrange@redhat.com> In-Reply-To: <20210105172554.943968-1-berrange@redhat.com> References: <20210105172554.943968-1-berrange@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.12 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) 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.29.2