pvesm: Add example & clarification for export

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/

diff --git a/pvesm.adoc b/pvesm.adoc
index b76ce877937d7793f4fb3e47ffd2538dce89da92..612c0eb07510ae76b6adfbafd8c217357903f355 100644 (file)
--- 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