From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits)) (No client certificate requested) by lists.proxmox.com (Postfix) with ESMTPS id 7F6EF6AF71 for ; Thu, 10 Dec 2020 09:17:19 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id 78F5118761 for ; Thu, 10 Dec 2020 09:16:49 +0100 (CET) Received: from dev.dominic.proxmox.com (212-186-127-178.static.upcbusiness.at [212.186.127.178]) by firstgate.proxmox.com (Proxmox) with ESMTP id 0D63B18757 for ; Thu, 10 Dec 2020 09:16:49 +0100 (CET) Received: by dev.dominic.proxmox.com (Postfix, from userid 0) id DCD0A22DF5; Thu, 10 Dec 2020 09:16:48 +0100 (CET) From: =?UTF-8?q?Dominic=20J=C3=A4ger?= To: pve-devel@lists.proxmox.com Date: Thu, 10 Dec 2020 09:15:59 +0100 Message-Id: <20201210081600.37881-1-d.jaeger@proxmox.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 1 AWL -0.360 Adjusted score from AWL reputation of From: address KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment KAM_LAZY_DOMAIN_SECURITY 1 Sending domain does not have any anti-forgery methods KHOP_HELO_FCRDNS 0.399 Relay HELO differs from its IP's reverse DNS NO_DNS_FOR_FROM 0.379 Envelope sender has no MX or A DNS records SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_NONE 0.001 SPF: sender does not publish an SPF Record Subject: [pve-devel] [PATCH docs] qm/pct: Add explanation for --purge X-BeenThere: pve-devel@lists.proxmox.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Proxmox VE development discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 10 Dec 2020 08:17:19 -0000 This was apparently not clear enough. For example, see #3184. A bit long, but I think this is a better place for additional information about ACL and firewall than the GUI tooltip or the API parameter description. Signed-off-by: Dominic Jäger --- pct.adoc | 10 ++++++++++ qm.adoc | 8 ++++++++ 2 files changed, 18 insertions(+) diff --git a/pct.adoc b/pct.adoc index 1f0bcef..ddc16e2 100644 --- a/pct.adoc +++ b/pct.adoc @@ -791,6 +791,16 @@ Reduce the memory of the container to 512MB # pct set 100 -memory 512 ---- +Destroying a container always removes it from Access Control Lists and it always +removes the firewall configuration of the container. You have to activate +'--purge', if you want to additionally remove the container from replication jobs, +backup jobs and HA resource configurations. + +---- +# pct destroy 100 --purge +---- + + Obtaining Debugging Logs ~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/qm.adoc b/qm.adoc index 5e53e4a..9c54903 100644 --- a/qm.adoc +++ b/qm.adoc @@ -1326,6 +1326,14 @@ Same as above, but only wait for 40 seconds. qm shutdown 300 && qm wait 300 -timeout 40 +Destroying a VM always removes it from Access Control Lists and it always +removes the firewall configuration of the VM. You have to activate +'--purge', if you want to additionally remove the VM from replication jobs, +backup jobs and HA resource configurations. + + qm destroy 300 --purge + + [[qm_configuration]] Configuration -- 2.20.1