virsh: clarify snapshot vs. save

* tools/virsh.c (info_snapshot_create, info_save): Clarify
description.
* tools/virsh.pod (save): Likewise.
This commit is contained in:
Eric Blake 2011-06-15 14:24:53 -06:00
parent b325768064
commit ea71d82816
2 changed files with 10 additions and 4 deletions

View File

@ -1517,7 +1517,7 @@ cmdStart(vshControl *ctl, const vshCmd *cmd)
*/ */
static const vshCmdInfo info_save[] = { static const vshCmdInfo info_save[] = {
{"help", N_("save a domain state to a file")}, {"help", N_("save a domain state to a file")},
{"desc", N_("Save a running domain.")}, {"desc", N_("Save the RAM state of a running domain.")},
{NULL, NULL} {NULL, NULL}
}; };
@ -11035,8 +11035,8 @@ cmdQuit(vshControl *ctl, const vshCmd *cmd ATTRIBUTE_UNUSED)
* "snapshot-create" command * "snapshot-create" command
*/ */
static const vshCmdInfo info_snapshot_create[] = { static const vshCmdInfo info_snapshot_create[] = {
{"help", N_("Create a snapshot")}, {"help", N_("Create a snapshot from XML")},
{"desc", N_("Snapshot create")}, {"desc", N_("Create a snapshot (disk and RAM) from XML")},
{NULL, NULL} {NULL, NULL}
}; };

View File

@ -600,7 +600,8 @@ the state file was created.
=item B<save> I<domain-id> I<state-file> =item B<save> I<domain-id> I<state-file>
Saves a running domain to a state file so that it can be restored Saves a running domain (RAM, but not disk state) to a state file so that
it can be restored
later. Once saved, the domain will no longer be running on the later. Once saved, the domain will no longer be running on the
system, thus the memory allocated for the domain will be free for system, thus the memory allocated for the domain will be free for
other domains to use. B<virsh restore> restores from this state file. other domains to use. B<virsh restore> restores from this state file.
@ -609,6 +610,11 @@ This is roughly equivalent to doing a hibernate on a running computer,
with all the same limitations. Open network connections may be with all the same limitations. Open network connections may be
severed upon restore, as TCP timeouts may have expired. severed upon restore, as TCP timeouts may have expired.
Domain saved state files assume that disk images will be unchanged
between the creation and restore point. For a more complete system
restore point, where the disk state is saved alongside the memory
state, see the B<snapshot> family of commands.
=item B<schedinfo> optional I<--set> B<parameter=value> I<domain-id> I<--config> =item B<schedinfo> optional I<--set> B<parameter=value> I<domain-id> I<--config>
I<--live> I<--current> I<--live> I<--current>