[pve-devel] [PATCH docs] pvesm: Add example & clarification for export

[Dominic Jäger]

The literal usage of "qcow2+size" as well as what the command is supposed to do
has confused users [0].

[0] https://forum.proxmox.com/threads/trying-to-convert-raw-disk-to-vmdk-using-pvesm.70046/
---
It has also confused me and I think some other devs, too.

 pvesm.adoc | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/pvesm.adoc b/pvesm.adoc
index b76ce87..612c0eb 100644
--- a/pvesm.adoc
+++ b/pvesm.adoc
@@ -357,6 +357,14 @@ Show file system path for a volume
 
  pvesm path <VOLUME_ID>
 
+Exporting the volume `local:103/vm-103-disk-0.qcow2` to the file `target`.
+This is mostly used internally with `pvesm import`.
+The stream format qcow2+size is different to the qcow2 format.
+Consequently, the exported file cannot simply be attached to a VM.
+This also holds for the other formats.
+
+ pvesm export local:103/vm-103-disk-0.qcow2 qcow2+size target --with-snapshots 1
+
 ifdef::wiki[]
 
 See Also
-- 
2.20.1