virsh: Update for varstore handling

Document the fact that the existing flags which apply to
NVRAM files also do the right thing when varstore files are
used instead.

Signed-off-by: Andrea Bolognani <abologna@redhat.com>
Reviewed-by: Michal Privoznik <mprivozn@redhat.com>
Acked-by: Gerd Hoffmann <kraxel@redhat.com>
Reviewed-by: Daniel P. Berrangé <berrange@redhat.com>
This commit is contained in:
Andrea Bolognani committed 2026-02-24 11:29:07 +01:00
1 parent 31e40b6229
commit 0151db88c2
3 files changed
+18 -17

No files matched your search

+12 -11
View File
@@ -1722,8 +1722,8 @@ of open file descriptors which should be pass on into the guest. The
file descriptors will be re-numbered in the guest, starting from 3. This
is only supported with container based virtualization.
If *--reset-nvram* is specified, any existing NVRAM file will be deleted
and re-initialized from its pristine template.
If *--reset-nvram* is specified, any existing NVRAM/varstore file will be
deleted and re-initialized from its pristine template.
**Example:**
@@ -4281,8 +4281,8 @@ save image to decide between running or paused; passing either the
*--running* or *--paused* flag will allow overriding which state the
domain should be started in.
If *--reset-nvram* is specified, any existing NVRAM file will be deleted
and re-initialized from its pristine template.
If *--reset-nvram* is specified, any existing NVRAM/varstore file will be
deleted and re-initialized from its pristine template.
*--parallel-channels* option can specify number of parallel IO channels
to be used when loading memory from file. Parallel save may significantly
@@ -4925,8 +4925,8 @@ of open file descriptors which should be pass on into the guest. The
file descriptors will be re-numbered in the guest, starting from 3. This
is only supported with container based virtualization.
If *--reset-nvram* is specified, any existing NVRAM file will be deleted
and re-initialized from its pristine template.
If *--reset-nvram* is specified, any existing NVRAM/varstore file will be
deleted and re-initialized from its pristine template.
suspend
@@ -4988,9 +4988,10 @@ domain. Without the flag, attempts to undefine an inactive domain with
checkpoint metadata will fail. If the domain is active, this flag is
ignored.
*--nvram* and *--keep-nvram* specify accordingly to delete or keep nvram
(/domain/os/nvram/) file. If the domain has an nvram file and the flags are
omitted, the undefine will fail.
The *--nvram* and *--keep-nvram* flags specify whether to delete or keep the
NVRAM (/domain/os/nvram/) or varstore (/domain/os/varstore) file respectively.
If the domain has an NVRAM/varstore file and the flags are omitted, the
undefine operation will fail.
The *--storage* flag takes a parameter ``volumes``, which is a comma separated
list of volume target names or source paths of storage volumes to be removed
@@ -8174,8 +8175,8 @@ requires the use of *--force* to proceed:
likely cause extensive filesystem corruption or crashes due to swap content
mismatches when run.
If *--reset-nvram* is specified, any existing NVRAM file will be deleted
and re-initialized from its pristine template.
If *--reset-nvram* is specified, any existing NVRAM/varstore file will be
deleted and re-initialized from its pristine template.
snapshot-delete
+5 -5
View File
@@ -3981,11 +3981,11 @@ static const vshCmdOptDef opts_undefine[] = {
},
{.name = "nvram",
.type = VSH_OT_BOOL,
.help = N_("remove nvram file")
.help = N_("remove NVRAM/varstore file")
},
{.name = "keep-nvram",
.type = VSH_OT_BOOL,
.help = N_("keep nvram file")
.help = N_("keep NVRAM/varstore file")
},
{.name = "tpm",
.type = VSH_OT_BOOL,
@@ -4401,7 +4401,7 @@ static const vshCmdOptDef opts_start[] = {
},
{.name = "reset-nvram",
.type = VSH_OT_BOOL,
.help = N_("re-initialize NVRAM from its pristine template")
.help = N_("re-initialize NVRAM/varstore from its pristine template")
},
{.name = NULL}
};
@@ -5728,7 +5728,7 @@ static const vshCmdOptDef opts_restore[] = {
},
{.name = "reset-nvram",
.type = VSH_OT_BOOL,
.help = N_("re-initialize NVRAM from its pristine template")
.help = N_("re-initialize NVRAM/varstore from its pristine template")
},
{.name = NULL}
};
@@ -8520,7 +8520,7 @@ static const vshCmdOptDef opts_create[] = {
},
{.name = "reset-nvram",
.type = VSH_OT_BOOL,
.help = N_("re-initialize NVRAM from its pristine template")
.help = N_("re-initialize NVRAM/varstore from its pristine template")
},
{.name = NULL}
};
+1 -1
View File
@@ -1714,7 +1714,7 @@ static const vshCmdOptDef opts_snapshot_revert[] = {
},
{.name = "reset-nvram",
.type = VSH_OT_BOOL,
.help = N_("re-initialize NVRAM from its pristine template")
.help = N_("re-initialize NVRAM/varstore from its pristine template")
},
{.name = NULL}
};