From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [212.224.123.68]) by lore.proxmox.com (Postfix) with ESMTPS id 983391FF17C for ; Tue, 16 Dec 2025 14:01:59 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id C6B1EEDEC; Tue, 16 Dec 2025 14:02:38 +0100 (CET) From: Fiona Ebner To: pve-devel@lists.proxmox.com Date: Tue, 16 Dec 2025 14:02:14 +0100 Message-ID: <20251216130230.104772-4-f.ebner@proxmox.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20251216130230.104772-1-f.ebner@proxmox.com> References: <20251216130230.104772-1-f.ebner@proxmox.com> MIME-Version: 1.0 X-Bm-Milter-Handled: 55990f41-d878-4baa-be0a-ee34c49e34d2 X-Bm-Transport-Timestamp: 1765890145629 X-SPAM-LEVEL: Spam detection results: 0 AWL -0.016 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 SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Subject: [pve-devel] [PATCH storage 03/11] plugin: document volume_resize() method 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: , Reply-To: Proxmox VE development discussion Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Errors-To: pve-devel-bounces@lists.proxmox.com Sender: "pve-devel" Based on Max's submission [0] and Fabian's reply there. Also document that the size is a multiple of 1024 and that padding to a larger size is allowed. [0]: https://lore.proxmox.com/pve-devel/20250326142059.261938-8-m.carrara@proxmox.com/ Signed-off-by: Fiona Ebner --- src/PVE/Storage/Plugin.pm | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/src/PVE/Storage/Plugin.pm b/src/PVE/Storage/Plugin.pm index 260c259..b0d3bbf 100644 --- a/src/PVE/Storage/Plugin.pm +++ b/src/PVE/Storage/Plugin.pm @@ -1340,6 +1340,24 @@ sub volume_size_info { } +=head3 volume_resize + + $plugin->volume_resize(\%scfg, $storeid, $volname, $size, $running); + +Resize a volume to the new C<$size> in bytes. The size is guaranteed to be a multiple of C<1024>. +The implementation may pad to a larger size if required. In case of virtual machines, C<$running> +indicates that the VM is currently running and the call will be followed by a C QMP +command in QEMU. If resizing is supported natively via QEMU (for example, when using librbd), then +the plugin should simply return if the VM is running. For containers, C<$running> will always be +C<0>. + +Cs in case of errors, or if the underlying storage implementation or the volume's format +doesn't support resizing. + +This function should not return any value. + +=cut + sub volume_resize { my ($class, $scfg, $storeid, $volname, $size, $running) = @_; -- 2.47.3 _______________________________________________ pve-devel mailing list pve-devel@lists.proxmox.com https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel