From nobody Thu Apr 25 07:44:12 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail(p=quarantine dis=quarantine) header.from=suse.com Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1641849872265519.5933818227934; Mon, 10 Jan 2022 13:24:32 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-6-6U6zlR0rNN2G39z6hMqiQw-1; Mon, 10 Jan 2022 16:24:27 -0500 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 712EE83DD21; Mon, 10 Jan 2022 21:24:21 +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 1A2385BE3C; Mon, 10 Jan 2022 21:24:20 +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 70E921809CB8; Mon, 10 Jan 2022 21:24:15 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 20ALODn0014404 for ; Mon, 10 Jan 2022 16:24:14 -0500 Received: by smtp.corp.redhat.com (Postfix) id CA46040CFD02; Mon, 10 Jan 2022 21:24:13 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast06.extmail.prod.ext.rdu2.redhat.com [10.11.55.22]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C462B40CFD01 for ; Mon, 10 Jan 2022 21:24:13 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [205.139.110.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id AADDF185A79C for ; Mon, 10 Jan 2022 21:24:13 +0000 (UTC) Received: from de-smtp-delivery-102.mimecast.com (de-smtp-delivery-102.mimecast.com [194.104.111.102]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-342-g61dkhrSOeuokVxK7YsicA-1; Mon, 10 Jan 2022 16:24:11 -0500 Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05lp2174.outbound.protection.outlook.com [104.47.17.174]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id de-mta-30-FxB1PvUrM0CP13aAOmBo7Q-1; Mon, 10 Jan 2022 22:24:08 +0100 Received: from AM0PR04MB4899.eurprd04.prod.outlook.com (2603:10a6:208:c5::16) by AM0PR04MB4546.eurprd04.prod.outlook.com (2603:10a6:208:75::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4867.7; Mon, 10 Jan 2022 21:24:07 +0000 Received: from AM0PR04MB4899.eurprd04.prod.outlook.com ([fe80::d5d2:21c0:eae6:3aea]) by AM0PR04MB4899.eurprd04.prod.outlook.com ([fe80::d5d2:21c0:eae6:3aea%5]) with mapi id 15.20.4867.012; Mon, 10 Jan 2022 21:24:07 +0000 X-MC-Unique: 6U6zlR0rNN2G39z6hMqiQw-1 X-MC-Unique: g61dkhrSOeuokVxK7YsicA-1 X-MC-Unique: FxB1PvUrM0CP13aAOmBo7Q-1 From: Jim Fehlig To: libvir-list@redhat.com Subject: [PATCH V2 1/2] build: Only install libvirt-guests when building libvirtd Date: Mon, 10 Jan 2022 14:24:00 -0700 Message-ID: <20220110212401.31422-2-jfehlig@suse.com> In-Reply-To: <20220110212401.31422-1-jfehlig@suse.com> References: <20220110212401.31422-1-jfehlig@suse.com> X-ClientProxiedBy: AS8PR07CA0015.eurprd07.prod.outlook.com (2603:10a6:20b:451::28) To AM0PR04MB4899.eurprd04.prod.outlook.com (2603:10a6:208:c5::16) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: d0c0aa1f-4a55-4beb-722f-08d9d47f88e0 X-MS-TrafficTypeDiagnostic: AM0PR04MB4546:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:568 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0 X-Microsoft-Antispam-Message-Info: ROB7qFl55HyK7HHHlVuBBB3BmUcXsAqTZZjGxFaW2SO+d5Vk7C0y1MA3vfCYpDNeeJDWzlQvnQEI+O9yDJvLltD6Wngrtujd5YeGLikvJrijw/FW4j5rsGg+yNvwRd09MIZiV8uXEgutrmlM/QlUasNucNWE4Ti5bUMnZ1yM2EFJt/4rIrWD34GOmGuFN8Q8Dk9a8jfz8XNAOhiKxo/nNSj6NCUiwLuTDpkwOeSAOiQxS8MY0zjqjUgTGMCn3eCZLuVx5CBwUVg6a/+1kiQrcDLzLlGqhSAnntF0BGd5BIn16b1PdkH+1vyw5djMseggB4k8RlgicGUNqUN7F3EdqWGPLa/S3zxTU1v8LKeLVI8DsEs0Le9qevPCn3UGZ9xJYf3K6a+ZdncGRj5TkubL5phSbzfOAhOMUwb9vUR+uVTBHX8ib2f+58WsDhGNYN5FVDtXlD6auK6zzkvFWShhPnlQOPiOIPGSYykaJWbciRpMqxmOFxUZ4l0G+RYloIgAjMElivfOnojLV5T1daIkeAWqtVVNsXcomYquZGxhZZj+K4aSFX3yEoDaMbPLmy+RjKvMFs9fNsLaw6DOEg2Nzhy7Qny3I/sV6Uguy9Gtkikgd1vzbTYpRdoh3+vRtK35Icd5SNVbHtIaQihaNZBgug== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0PR04MB4899.eurprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(86362001)(2616005)(83380400001)(6506007)(6666004)(6512007)(316002)(6916009)(36756003)(8676002)(66556008)(66946007)(508600001)(66476007)(38100700002)(1076003)(8936002)(186003)(26005)(2906002)(6486002)(5660300002); DIR:OUT; SFP:1101 X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?yuvqiSjClhymgcvCY3QR/jU+7sW3e9DDHmjmFqxQuNGeuTxyVDld1ilRbUc4?= =?us-ascii?Q?lIeYouOKnasi8NnDSgW/Z00nbEfq4l1chWMixu2/ANy959NMqvdW0lCNAhK8?= =?us-ascii?Q?mQIg1r7OZvOWHKdPwf2FDchuFkdSDkS9k4Y6RrVwCMxIt6GqJ6jnSgkbMWu3?= =?us-ascii?Q?hun044fdPGW27wUrIZ+fCPl2BjqfBfRPM5yCJ7HIMRwkJ1SHAtU19aKCSKzW?= =?us-ascii?Q?7Vi+IdyrRtZN0lKZ/X7iUA9pav2RJhQH3ekvQfILa8MtgEaAFGdt7N1iBy0j?= =?us-ascii?Q?LZ5zxMTudmyyyZEfJWBJpLWPk8DP1Vw9g+aas1a6T5Jjp62VnrPmYDOL1SfF?= =?us-ascii?Q?+eF1icebhjZX7Uyz/WvqWWgh2JpBUsuZCKdrntbkxUoCnFMvZy6PVLPpgqNY?= =?us-ascii?Q?Gw+Vhawz2+O9hZy6K0rbBr5kXwdwiKssqj19iLGZAIVZKYL6JJAiJ0tRWvVd?= =?us-ascii?Q?B85GGiZSNmHZkGzt4h5+TUO6Gh8g56xzpABT9pgNtPtzXG/tAUOU6kbqo9Cf?= =?us-ascii?Q?mpcyoUqDgHSGumYxNl/EhrrWNIars1jz4LumNxcwGuLhNpaLmwY3hDm3+PlB?= =?us-ascii?Q?LJPrtEawS6QUAIL8UCLkmKxvzwthIzW3rWkYmCC/m6TDs2OAjfAVuwkxCPJZ?= =?us-ascii?Q?08sn+1ZMqk9/mpg1sH155QiClDNIIXwmSs02LwwiQ7aSm+q3KwX9Fot4ICZg?= =?us-ascii?Q?/OWrp/s2QuJbdRluiItmO7VHyAcw6oyZWRorI5zQscoa55ZPOkuyQWEoISA/?= =?us-ascii?Q?tiRfy53Ynb5ai1VDSGu4mgdmCOewSbhVehwI27EFwNKJY13kRj9/bSuXgrRc?= =?us-ascii?Q?ubHsx7Vt6wfQoOq2ycwAnMWuZ3OC6qAIw114YXXM3sRul5j2VNq5lxT5oLz4?= =?us-ascii?Q?1W8bW246nOujxBVcnHBS7/5ThTzq77dhvM1r5lyuJ20tN6g5xHf3gQOZJ8w9?= =?us-ascii?Q?EXVEAuz7o/HvyFYPna7QGnI6H6LFkCJDZgj4Q5hFhzyyfP8HRAmIRBMqqlW+?= =?us-ascii?Q?YBmORezqjunqQcaqD3zO5fDwf6MQ4Jxm+B+tx60ZXZ+7YhaiPCHJ9yYJVkrM?= =?us-ascii?Q?K7TUrcrO9vWgwN/2BWR/Id/sq99BDk85LvUcf7VyiQ0LpD3O+GJ4VOTFztfY?= =?us-ascii?Q?qcrzJTJSAubrYf4D3HJEAOIImWN50hX3FtLNeZQVGZFA5J5DWwSbBAkTdKMv?= =?us-ascii?Q?sqKTIpT82jiPUl2q+oe1Y5mkdlRiiiVGy2Yn35Ypu5CdwhvrVHJSirUmcH1T?= =?us-ascii?Q?h4Xy941AV8bZKmmfbqgdo6kCiGAXd7K3aziQTP5IAYoVn+kX8N7IhNd3fFsK?= =?us-ascii?Q?Kn690sZOXK9AFw3hbk0WPbRFEQ/Lb8Ll3CoNejonRf/+Dua0QIq3EWXLP4eq?= =?us-ascii?Q?fhSvOehfFBc6DBLnGXZHQ5MOVJ+klMrFLO/Dg+hmiPnM9GyerFVOC5qMg7FM?= =?us-ascii?Q?iOEMwRO6UDMHtPmKFJP3FQIR/PH0NM3WG6bSp5kAaqaNeCOiYiRbg/97MQiD?= =?us-ascii?Q?Y8cNR+oAnDDS9gG5mVnRqZLoZnJoA0F8gEg6FyclaB0LKjpzKdwK12i+S6ZO?= =?us-ascii?Q?Scs/A4KfwxbopILecbDCUUBhZLnfz3EibMXSqhJGeVthFxnxyShdv79tOCFD?= =?us-ascii?Q?J0vHU3EK7dE+IiN0haiFKlw=3D?= X-OriginatorOrg: suse.com X-MS-Exchange-CrossTenant-Network-Message-Id: d0c0aa1f-4a55-4beb-722f-08d9d47f88e0 X-MS-Exchange-CrossTenant-AuthSource: AM0PR04MB4899.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Jan 2022 21:24:07.2919 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: f7a17af6-1c5c-4a36-aa8b-f5be247aa4ba X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: kATMvIu/mmko/apZpJRAX81DePwDOKNw4ajtEfMuElvd1shuJOARmVfFB8LkTfxY4xIhhdSVJcALr3kWryQiiA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR04MB4546 X-Mimecast-Impersonation-Protect: Policy=CLT - Impersonation Protection Definition; Similar Internal Domain=false; Similar Monitored External Domain=false; Custom External Domain=false; Mimecast External Domain=false; Newly Observed Domain=false; Internal User Name=false; Custom Display Name List=false; Reply-to Address Mismatch=false; Targeted Threat Dictionary=false; Mimecast Threat Dictionary=false; Custom Threat Dictionary=false X-Scanned-By: MIMEDefang 2.84 on 10.11.54.1 X-MIME-Autoconverted: from quoted-printable to 8bit by lists01.pubmisc.prod.ext.phx2.redhat.com id 20ALODn0014404 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.15 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-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1641849873523100001 Content-Type: text/plain; charset="utf-8" libvirt-guests was already moved to the libvirt daemon package in commit d800c50349. It only needs to be installed when building libvirtd. Signed-off-by: Jim Fehlig Reviewed-by: Andrea Bolognani --- tools/meson.build | 38 ++++++++++++++++++++------------------ 1 file changed, 20 insertions(+), 18 deletions(-) diff --git a/tools/meson.build b/tools/meson.build index 22fa3604ba..2d0aecb90b 100644 --- a/tools/meson.build +++ b/tools/meson.build @@ -297,29 +297,31 @@ if conf.has('WITH_SANLOCK') ) endif =20 -configure_file( - input: 'libvirt-guests.sh.in', - output: '@BASENAME@', - configuration: tools_conf, - install: true, - install_dir: libexecdir, - install_mode: 'rwxrwxr-x', -) - -if init_script =3D=3D 'systemd' - install_data( - 'libvirt-guests.sysconf', - install_dir: sysconfdir / 'sysconfig', - rename: 'libvirt-guests', - ) - +if conf.has('WITH_LIBVIRTD') configure_file( - input: 'libvirt-guests.service.in', + input: 'libvirt-guests.sh.in', output: '@BASENAME@', configuration: tools_conf, install: true, - install_dir: prefix / 'lib' / 'systemd' / 'system', + install_dir: libexecdir, + install_mode: 'rwxrwxr-x', ) + + if init_script =3D=3D 'systemd' + install_data( + 'libvirt-guests.sysconf', + install_dir: sysconfdir / 'sysconfig', + rename: 'libvirt-guests', + ) + + configure_file( + input: 'libvirt-guests.service.in', + output: '@BASENAME@', + configuration: tools_conf, + install: true, + install_dir: prefix / 'lib' / 'systemd' / 'system', + ) + endif endif =20 if bash_completion_dep.found() --=20 2.34.1 From nobody Thu Apr 25 07:44:12 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=fail(p=quarantine dis=quarantine) header.from=suse.com Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1641849902689333.5364760013057; Mon, 10 Jan 2022 13:25:02 -0800 (PST) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-195-M42aL6mnODK3mJ8a0CuaXw-1; Mon, 10 Jan 2022 16:24:57 -0500 Received: from smtp.corp.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.23]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 65A2183DD24; Mon, 10 Jan 2022 21:24:52 +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 414CCE2F7; Mon, 10 Jan 2022 21:24:52 +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 122601802E2B; Mon, 10 Jan 2022 21:24:52 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 20ALOHxs014424 for ; Mon, 10 Jan 2022 16:24:17 -0500 Received: by smtp.corp.redhat.com (Postfix) id E55D640CFD02; Mon, 10 Jan 2022 21:24:16 +0000 (UTC) Received: from mimecast-mx02.redhat.com (mimecast03.extmail.prod.ext.rdu2.redhat.com [10.11.55.19]) by smtp.corp.redhat.com (Postfix) with ESMTPS id DF6C940CFD01 for ; Mon, 10 Jan 2022 21:24:16 +0000 (UTC) Received: from us-smtp-1.mimecast.com (us-smtp-1.mimecast.com [207.211.31.81]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id C3BB7811E78 for ; Mon, 10 Jan 2022 21:24:16 +0000 (UTC) Received: from de-smtp-delivery-102.mimecast.com (de-smtp-delivery-102.mimecast.com [194.104.111.102]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-407-st2c7L8cOte5-NuGZoQlkA-1; Mon, 10 Jan 2022 16:24:13 -0500 Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05lp2171.outbound.protection.outlook.com [104.47.17.171]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id de-mta-32-C5TIrSquOf67xRxAIowIHA-1; Mon, 10 Jan 2022 22:24:11 +0100 Received: from AM0PR04MB4899.eurprd04.prod.outlook.com (2603:10a6:208:c5::16) by AM0PR04MB4546.eurprd04.prod.outlook.com (2603:10a6:208:75::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4867.7; Mon, 10 Jan 2022 21:24:10 +0000 Received: from AM0PR04MB4899.eurprd04.prod.outlook.com ([fe80::d5d2:21c0:eae6:3aea]) by AM0PR04MB4899.eurprd04.prod.outlook.com ([fe80::d5d2:21c0:eae6:3aea%5]) with mapi id 15.20.4867.012; Mon, 10 Jan 2022 21:24:10 +0000 X-MC-Unique: M42aL6mnODK3mJ8a0CuaXw-1 X-MC-Unique: st2c7L8cOte5-NuGZoQlkA-1 X-MC-Unique: C5TIrSquOf67xRxAIowIHA-1 From: Jim Fehlig To: libvir-list@redhat.com Subject: [PATCH V2 2/2] docs: Add man page for libvirt-guests Date: Mon, 10 Jan 2022 14:24:01 -0700 Message-ID: <20220110212401.31422-3-jfehlig@suse.com> In-Reply-To: <20220110212401.31422-1-jfehlig@suse.com> References: <20220110212401.31422-1-jfehlig@suse.com> X-ClientProxiedBy: AS8PR07CA0025.eurprd07.prod.outlook.com (2603:10a6:20b:451::25) To AM0PR04MB4899.eurprd04.prod.outlook.com (2603:10a6:208:c5::16) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 60b23dce-5a9a-4dfb-9328-08d9d47f8a6e X-MS-TrafficTypeDiagnostic: AM0PR04MB4546:EE_ X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:2043 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0 X-Microsoft-Antispam-Message-Info: 14tnZC+w3uaXAZUhVUELBlhCRIqlLM976dhVleqIsi85sIfMBglUEggqF9PWWXfkDQzIEKH/kOiYhOnaQ6xSo0zyO4bc85NUPFLXaHJAzlIkwNi0wHcykA45rYgPwE38kjzUtre9co2bCTjysVIkvkUgw4IyR9UFbevDvg2siGJ/9sh0RvLogXQ9D9Vc4Z+gpP4Fbb5zoa+3Pk/3IHnnvRJG3gXx5xUAEiBowyqbPPH/reP7hd7Dwx3rqwXB0X0BDA/IPoQ5J1Dh9RP4C3rFJPrxS9TggAoOBCuG0AjR5e9agn+IEI2qQV6BOE+6s0aF/cxGEcE0NCXusuASJh7julMDyBUF7cqCg0Dz7kCno49nBbmH1NqUTqLggkN46tlWEfF/IdV059AGHxgmbwR/E78GpQONvtzPGuLxPsTzZH4jKi6wu9KbEsf2hCLJ6C7zmvm5N/N2r+OxEixVH3FTd1bWNKtWfzY3/sf4i6h8u8dzDZfozMogBuR30KwHydtEZ17e02nbcpB0IvLondZKFm5KivQ/rad6raWVDlFLrQBmGkDLY/aay+kzdmOadDn1FDTXHMbtLCsSLj5c+LqeD0mYyogk3MK84j0EiYtGVuBf3gYhiE3Ea9kPhmlOz0GNBVFGXBtWuQKU5cDOV+zbNKtWHIpCbbZUueQypDirmJThVAF9ybPYkeTn7K3TL8FFT2PH7nR0xLOKDsQL2FUq0OScfhtQC7Io+zBHX6FpUZAoLnlY3nZ3nlGqdNrT9hejNpxdqljX2Ht2fGaVCL0S12y2RVAuEJ9UJJwiI0LAl40CUcf0M9IIu/MJIvfs96Uy X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0PR04MB4899.eurprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(86362001)(2616005)(83380400001)(6506007)(6666004)(6512007)(316002)(6916009)(36756003)(8676002)(66556008)(66946007)(508600001)(66476007)(38100700002)(1076003)(8936002)(186003)(26005)(2906002)(6486002)(5660300002)(2004002); DIR:OUT; SFP:1101 X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?us-ascii?Q?g7tju9jCg9vb9tOpL+7elNgzLbBrRRsmF+IetbDY4tj6rHwZjVsiSsL9HqtB?= =?us-ascii?Q?3N77Ek06wEblYXr5n9ZAXaDmluO3XVleD5vfUi9Ys+1IAdyU5+AHjshy6Uzl?= =?us-ascii?Q?tXcyV/G815CKFt6EGbKShFPL4JztrNGvGOyJ7DOC2glundgTk43ctWJRnU8O?= =?us-ascii?Q?pAxYgPX07nW5fN8CjLCgzyVpHXFMYXgDTHYw6pcgWjFaXmvDWBRpWKIM08KE?= =?us-ascii?Q?YVFHcGiQBYKaHRj3bk+NcXAR97lrIpbxqNBj0G1xuCkeDyvSBk5gq++cG70H?= =?us-ascii?Q?Euy+cizk/8Sv55VuEKcTUCufLCZDIUR1R0QfvpkzW3/OksOD4z/d8DWvWdQh?= =?us-ascii?Q?S3cFg5U7fpOSv+cFB7BU46Hz8yDl0wpqCgYw3Gcz2vRkewLJETKGk2htORag?= =?us-ascii?Q?yLzAw2f+OR1Y2oyPJeYBowJGvvflTFLO1IDQZ+4jSUAN3PNy2Rvg5/NRVOJk?= =?us-ascii?Q?ZgDyb+Zamn6WPrQETa6F1vipecLN9ApcXS5NStRShRFaVqTyXF7h8NoRcZis?= =?us-ascii?Q?HZtEelt2To94H6o72Gf0YQl6E+bT9sjrdcegN1JoG8ypmoHRqB440qHMsNnF?= =?us-ascii?Q?aOoCnwyGgtW/jWUfnDXH6BpBhnEF0L98CdIBIxs30cfTFckn7N9eqrHo4jps?= =?us-ascii?Q?COfElznmHbLJP7Rh4VchP/nTlAT4MqKObhmgkUKgOCasfRDBJ9L5cSxvFkmh?= =?us-ascii?Q?4UaziScNBTNLX1puapg9HBica/dLVt6qGS9hwjB44KGC6mfi+7XC8stwqdmh?= =?us-ascii?Q?ogBS6CB+f7HdS2X69RThhqaVqH6RUF4ETvORCEPkSW9phBbm4gkusBj6beMv?= =?us-ascii?Q?z4Aft82EB8S4gRgaBhuHbl+TgRpIxyDuBm82O1jQomwY+HSXaMd8WGZ++hA5?= =?us-ascii?Q?cY5g6v/RQ+8x3schfW8xw94jgsGnqNNAtsoeGGB86L25tsKp2GBSaLzPFftH?= =?us-ascii?Q?kXu5TJuBkiU0p1946oyGzvI3YlklW0F73Kw2IPVjRlR7hrzR1EXUZCzkeqz0?= =?us-ascii?Q?84XbeJHE65UwbHD62F2055xOyUawgGl+dmRe8qFKaRkmQ3PA2qrCz3aZQmaU?= =?us-ascii?Q?aZNWKHHtU5n6vePCuFkn8uSOQUjhkBSz9Vt+vM4QtTnzQXjkzmVWKdlx5QiH?= =?us-ascii?Q?aEgwYUYuZWg670mc3WZqH26yaKoXeKTgSKThjhML8pyc8Sj0gQ3xcMXCE/jz?= =?us-ascii?Q?NHmaKb3IgV5ADV7ocuoVKKmQj1Jrvm8nNw3Zq26K0DaxZ4I0g00pjRQHdBuO?= =?us-ascii?Q?W6pDW56PcihzcwkkKh8m9sZht+afBPwJ+jKZljs3NUlqaE64PedXL7xQrJ2z?= =?us-ascii?Q?8E0uHdPFTiIXKfpq1DHVvF3tUcEh4+PPN0hPaCiAcnqbMYMU2nVjcYj35rpT?= =?us-ascii?Q?01DP7D9fEnNZXxZezLcZEv/6FDv4J3LPaRLh/ZXlweF4eYXTv62fOOc6CXHS?= =?us-ascii?Q?W3wATL6rb9TbZIVYctsnuFejZNVRMd+C12Ouevnr03QxqwvtGCvkns3ocgjA?= =?us-ascii?Q?OTbrsJwkCjsyyhBehUEmRcYt8igvtI4u8x/sfoZ5U2lFxFKjIULrDnhSaneM?= =?us-ascii?Q?WBfSm06D9z9E/gK7v5YwEa6mxDPB5g7VadojyXm8Sy88wdUEJyNxePhZMHzt?= =?us-ascii?Q?/Xpu/mrFxXf1VDH3dFwOAz8=3D?= X-OriginatorOrg: suse.com X-MS-Exchange-CrossTenant-Network-Message-Id: 60b23dce-5a9a-4dfb-9328-08d9d47f8a6e X-MS-Exchange-CrossTenant-AuthSource: AM0PR04MB4899.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Jan 2022 21:24:10.0729 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: f7a17af6-1c5c-4a36-aa8b-f5be247aa4ba X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: w4Ox9J6OptMBfRcovGI9mxxvpW8cLwiLG6/cMzjE2P+lMCNSA0UcHd8R/kZZ8yuXzTJOxiSKyQq/9/OUVkDb/A== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR04MB4546 X-Mimecast-Impersonation-Protect: Policy=CLT - Impersonation Protection Definition; Similar Internal Domain=false; Similar Monitored External Domain=false; Custom External Domain=false; Mimecast External Domain=false; Newly Observed Domain=false; Internal User Name=false; Custom Display Name List=false; Reply-to Address Mismatch=false; Targeted Threat Dictionary=false; Mimecast Threat Dictionary=false; Custom Threat Dictionary=false X-Scanned-By: MIMEDefang 2.84 on 10.11.54.1 X-MIME-Autoconverted: from quoted-printable to 8bit by lists01.pubmisc.prod.ext.phx2.redhat.com id 20ALOHxs014424 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.84 on 10.5.11.23 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-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1641849904693100001 Content-Type: text/plain; charset="utf-8" Signed-off-by: Jim Fehlig Reviewed-by: Andrea Bolognani --- docs/manpages/index.rst | 1 + docs/manpages/libvirt-guests.rst | 151 +++++++++++++++++++++++++++++++ docs/manpages/meson.build | 1 + libvirt.spec.in | 1 + tools/libvirt-guests.service.in | 2 +- 5 files changed, 155 insertions(+), 1 deletion(-) diff --git a/docs/manpages/index.rst b/docs/manpages/index.rst index fb4a36d46a..8fd0d90041 100644 --- a/docs/manpages/index.rst +++ b/docs/manpages/index.rst @@ -41,6 +41,7 @@ Tools * `virt-admin(1) `__ - daemon administration interface * `virsh(1) `__ - management user interface * `virt-qemu-run(1) `__ - run standalone QEMU instances +* `libvirt-guests(8) `__ - suspend/resume running lib= virt guests =20 Key codes =3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/docs/manpages/libvirt-guests.rst b/docs/manpages/libvirt-guest= s.rst new file mode 100644 index 0000000000..76045ed11a --- /dev/null +++ b/docs/manpages/libvirt-guests.rst @@ -0,0 +1,151 @@ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +libvirt-guests +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +------------------------------------- +suspend/resume running libvirt guests +------------------------------------- + +:Manual section: 8 +:Manual group: Virtualization Support + +.. contents:: + +SYNOPSIS +=3D=3D=3D=3D=3D=3D=3D=3D + +``libvirt-guests`` *COMMAND* + + +DESCRIPTION +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +``libvirt-guests`` is a service that can be used to coordinate guest and h= ost +lifecyle actions. By default, ``libvirt-guests`` will suspend running gues= ts +when the host shuts down, and restore them to their pre-shutdown state when +the host reboots. + +``libvirt-guests`` is typically under control of systemd. When +``libvirt-guests.service`` is enabled, systemd will call ``libvirt-guests`` +with the ``start`` *COMMAND* when the host boots. Conversely, systemd will= call +``libvirt-guests`` with the ``stop`` *COMMAND* when the host shuts down. + +``libvirt-guests`` can be used directly. In addition to the ``start`` and +``stop`` *COMMAND*\s, it also supports ``status``, ``restart``, ``condrest= art``, +``try-restart``, ``reload``, ``force-reload``, ``gueststatus``, and +``shutdown`` *COMMAND*\s. + + +FILES +=3D=3D=3D=3D=3D + +``libvirt-guests`` defines several variables to control service behavior. +The default vaule of these variables can be overridden in: + +* ``@SYSCONFDIR@/sysconfig/libvirt-guests`` + +The following variables are supported: + +- URIS=3Ddefault + + URIs to check for running guests. Example: + ``URIS=3D'default xen:///system xen+tcp://host/system lxc:///system'`` + +- ON_BOOT=3Dstart + + Action taken on host boot + + * start + + All guests which were running on shutdown are started on boot regardle= ss + of their autostart settings + + * ignore + + ``libvirt-guests`` won't start any guest on boot, however, guests mark= ed + as autostart will still be automatically started by libvirtd + +- START_DELAY=3D0 + + Number of seconds to wait between each guest start. Set to 0 to allow pa= rallel + startup. + +- ON_SHUTDOWN=3Dsuspend + + Action taken on host shutdown + + * suspend + + All running guests are suspended using virsh managedsave + + * shutdown + + All running guests are asked to shutdown. Please be careful with this + settings since there is no way to distinguish between a guest which is + stuck or ignores shutdown requests and a guest which just needs a long + time to shutdown. When setting ON_SHUTDOWN=3Dshutdown, you must also s= et + SHUTDOWN_TIMEOUT to a value suitable for your guests. + +- PARALLEL_SHUTDOWN=3D0 + + Number of guests will be shutdown concurrently, taking effect when + "ON_SHUTDOWN" is set to "shutdown". If Set to 0, guests will be shutdown= one + after another. Number of guests on shutdown at any time will not exceed = number + set in this variable. + +- SHUTDOWN_TIMEOUT=3D300 + + Number of seconds we're willing to wait for a guest to shut down. If par= allel + shutdown is enabled, this timeout applies as a timeout for shutting down= all + guests on a single URI defined in the variable URIS. If this is 0, then = there + is no time out (use with caution, as guests might not respond to a shutd= own + request). The default value is 300 seconds (5 minutes). + +- BYPASS_CACHE=3D0 + + If non-zero, try to bypass the file system cache when saving and + restoring guests, even though this may give slower operation for + some file systems. + +- SYNC_TIME=3D0 + + If non-zero, try to sync guest time on domain resume. Be aware, that + this requires guest agent with support for time synchronization + running in the guest. By default, this functionality is turned off. + + +BUGS +=3D=3D=3D=3D + +Please report all bugs you discover. This should be done via either: + +#. the mailing list + + `https://libvirt.org/contact.html `_ + +#. the bug tracker + + `https://libvirt.org/bugs.html `_ + +Alternatively, you may report bugs to your software distributor / vendor. + + +AUTHORS +=3D=3D=3D=3D=3D=3D=3D + +Please refer to the AUTHORS file distributed with libvirt. + + +LICENSE +=3D=3D=3D=3D=3D=3D=3D + +``libvirt-guests`` 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 + + +SEE ALSO +=3D=3D=3D=3D=3D=3D=3D=3D + +libvirtd(8), `https://libvirt.org/ `_ diff --git a/docs/manpages/meson.build b/docs/manpages/meson.build index 6763d19af8..c9b86551b5 100644 --- a/docs/manpages/meson.build +++ b/docs/manpages/meson.build @@ -39,6 +39,7 @@ docs_man_files =3D [ { 'name': 'virtvboxd', 'section': '8', 'install': conf.has('WITH_VBOX') = }, { 'name': 'virtvzd', 'section': '8', 'install': conf.has('WITH_VZ') }, { 'name': 'virtxend', 'section': '8', 'install': conf.has('WITH_LIBXL') = }, + { 'name': 'libvirt-guests', 'section': '8', 'install': conf.has('WITH_LI= BVIRTD') }, ] =20 foreach name : keycode_list diff --git a/libvirt.spec.in b/libvirt.spec.in index 7a90a1a9e6..b52af707eb 100644 --- a/libvirt.spec.in +++ b/libvirt.spec.in @@ -1694,6 +1694,7 @@ exit 0 %{_mandir}/man1/virt-admin.1* %{_mandir}/man1/virt-host-validate.1* %{_mandir}/man1/virt-ssh-helper.1* +%{_mandir}/man8/libvirt-guests.8* %{_mandir}/man8/libvirtd.8* %{_mandir}/man8/virtlogd.8* %{_mandir}/man8/virtlockd.8* diff --git a/tools/libvirt-guests.service.in b/tools/libvirt-guests.service= .in index 10c664016a..1a9b233e11 100644 --- a/tools/libvirt-guests.service.in +++ b/tools/libvirt-guests.service.in @@ -6,7 +6,7 @@ After=3Dnetwork.target After=3Dtime-sync.target After=3Dlibvirtd.service After=3Dvirt-guest-shutdown.target -Documentation=3Dman:libvirtd(8) +Documentation=3Dman:libvirt-guests(8) Documentation=3Dhttps://libvirt.org =20 [Service] --=20 2.34.1