blockjob
Syntax:
blockjob domain path { [--abort] [--async] [--pivot] |
[--info] [--raw] [--bytes] | [bandwidth] }
Manage active block operations.管理活动块操作
There are three mutually-exclusive（互相排斥的） modes:
--info, bandwidth, and --abort. --async(异步的) and --pivot imply（意味着） abort mode;
--raw implies info mode; and if no mode was given, --info mode is assumed（被假定的）.
path specifies fully-qualified path of the disk; it corresponds to a unique target name (<target dev='name'/>) or source file (<source file='name'/>) for one of the disk devices attached to domain (see also domblklist for listing these names).
In --abort mode, the active job on the specified disk will be aborted.
If --async is also specified, this command will return immediately, rather than waiting for the cancellation to complete.
如果还指定了--async，则该命令将立即返回，而不是等待取消操作完成
If --pivot is specified, this requests that an active copy or active commit job be pivoted over to the new image.
如果指定了--pivot，则将一个活动的拷贝或活动的提交作业请求转移到新映像
In --info mode, the active job information on the specified disk will be printed.
By default, the output is a single human-readable summary line; this format may change in future versions.
Adding --raw lists each field of the struct, in a stable format.
If the --bytes flag is set, then the command errors out if the server could not supply bytes/s resolution;
when omitting(省略) the flag, raw output is listed in MiB/s and human-readable output automatically selects the best resolution supported by the server.
bandwidth can be used to set bandwidth limit for the active job in MiB/s. If --bytes is specified then the bandwidth value is interpreted(理解) in bytes/s.
Specifying a negative value is interpreted as an unsigned long value or essentially unlimited.
The hypervisor can choose whether to reject the value or convert it to the maximum value allowed.
Optionally a scaled positive number may be used as bandwidth (see NOTES above).
Using --bytes with a scaled value permits a finer granularity to be selected. A scaled value used without --bytes will be rounded down to MiB/s.
Note that the --bytes may be unsupported by the hypervisor.
指定负数将被解释为无符号长值或本质上无限长值。
hypervisor可以选择是否拒绝该值或将其转换为允许的最大值。
可选地使用一个缩放的正数作为带宽(见上面的注释)。
使用带有缩放值的——bytes可以选择更细的粒度。不使用——bytes的缩放值将被四舍五入到MiB/s。
注意——bytes可能不被管理程序支持
Note that the progress reported for blockjobs corresponding to a pull-mode backup don't report progress of the backup but rather usage of temporary space required for the backup.
注意，对应于拉式备份的blockjobs报告的进度不会报告备份的进度，而是报告备份所需的临时空间的使用情况