From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [IPv6:2a01:7e0:0:424::9]) by lore.proxmox.com (Postfix) with ESMTPS id AC89E1FF13F for ; Thu, 26 Mar 2026 22:45:58 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id D86D11DB0E; Thu, 26 Mar 2026 22:46:18 +0100 (CET) Message-ID: <73f52c39-189d-4cdc-a42b-ed39d5718c97@proxmox.com> Date: Thu, 26 Mar 2026 22:46:10 +0100 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Beta Subject: Re: [PATCH qemu-server v2 4/4] qga: rename guest-fsfreeze to freeze-fs To: Maximiliano Sandoval References: <20260325213415.3861690-1-t.lamprecht@proxmox.com> <20260325213415.3861690-5-t.lamprecht@proxmox.com> Content-Language: en-US From: Thomas Lamprecht In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1774561521757 X-SPAM-LEVEL: Spam detection results: 0 AWL -0.011 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment RCVD_IN_VALIDITY_CERTIFIED_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to Validity was blocked. See https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more information. RCVD_IN_VALIDITY_RPBL_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to Validity was blocked. See https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more information. RCVD_IN_VALIDITY_SAFE_BLOCKED 0.001 ADMINISTRATOR NOTICE: The query to Validity was blocked. See https://knowledge.validity.com/hc/en-us/articles/20961730681243 for more information. SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Message-ID-Hash: GTQNYAMS6EBKEVHQVU3XYYJV6MLUHJJK X-Message-ID-Hash: GTQNYAMS6EBKEVHQVU3XYYJV6MLUHJJK X-MailFrom: t.lamprecht@proxmox.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: pve-devel@lists.proxmox.com X-Mailman-Version: 3.3.10 Precedence: list List-Id: Proxmox VE development discussion List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Am 26.03.26 um 10:07 schrieb Maximiliano Sandoval: > Thomas Lamprecht writes: > >> These settings are already in the (QEMU guest) agent property, and we >> do not use the guest- prefix for any of the existing properties >> (fstrim or freeze-fs-on-backup), and moving freeze-fs-on-backup to a >> generic variant is less confusing if one just drops the "-on-backup" >> part, i.e. no point in inventing a new name schema just for the sake >> of it. >> >> We already rolled this the guest-fsfreeze name to pve-test, so lets >> add an alias, but as we do not provide API stability guarantees for >> test packages this is really just for convenience for anybody that >> tested this, I'm more than fine with dropping such a (never stable) >> released key again on a major release with the respective upgrade >> check in our pveXtoY tool. >> >> Signed-off-by: Thomas Lamprecht > For the sake of documenting, the rationale behind the "guest-fsfreeze" > name was using the guest agent command names, namely > "guest-fsfreeze-freeze" and "guest-fsfreeze-thaw", as a base. I got that, but the specific low-level QMP QGA commands are a implementation detail, leaking that is IMO not the best way to reduce any confusion, which IMO is rather unlikely to affect end users much, as those don't really care what the underlying commands are named after. > For a long time I struggled to find the actual name of these commands > and their documentation since they are named ever-so-slightly > differently each time they appear on the docs or UI: "fsfreeze", > "freeze", "fs-freeze", etc. If, then this makes it sound like the documentation should improve, if this is really something our users struggle with too - which I'd find slightly surprising, tbh. > If anything, I personally found the old name to be a source of confusion. For what exactly? And wouldn't we then have to encode both, the freeze and thaw also in the name? Like guest-fsfreeze-freeze-and-thaw?