Changes

← Older edit

Man/ploop.8

8,155 bytes added, 18:51, 28 November 2016

Bot: Automated import of articles *** existing text overwritten ***

[-t fstype]

[-b blocksize]

[-B fsblocksize] [--nolazy]delta_file</td></tr>

-m mount_point | DiskDescriptor.xml |

image_file }</td></tr>

ploop replace</td>

{ -u uuid |

-l level | -o cur_image_file }

[--keep-name] -i image_file

DiskDescriptor.xml </td></tr>

</table>

[-u uuid]DiskDescriptor.xml <table width="100%" border="0" rules="none" frame="void" cellspacing="0" cellpadding="0"><tr valign="top" align="left"><td width="11%"></td><td width="17%"> ploop check</td><td width="72%"> [--force]

[--hard-force] [--check] [--ro]

[--silent] [--drop-inuse] [--raw]

[--blocksize size]

[--repair-sparse] ~~DiskDescriptor.xml~~image_file |<i/p>~~image_file~~</itd> ~~<table width="100%" border="0" rules="none" frame="void"~~ ~~cellspacing="0" cellpadding="0"~~tr>

ploop info</td>

[-s] [-d]DiskDescriptor.xml ~~</td><td width="37%">~~</td></tr>

ploop list</td>

[-a]~~</td><td width="37%">~~</td></tr>

</table>

ploop snapshot-merge </td>

[-u uuid [-U uuid2] | -A][-n new_delta]DiskDescriptor.xml ~~</td><td width="6%">~~</td></tr>

ploop snapshot-switch </td>

-u uuid

DiskDescriptor.xml ~~</td><td width="6%">~~</td></tr>

ploop snapshot-delete </td>

-u uuid

DiskDescriptor.xml ~~</td><td width="6%">~~</td></tr>

ploop snapshot-list </td>

</td></tr>

</table>

[-H]

[-u uuid] [-s]

[-o field[,field...]]

DiskDescriptor.xml

ploop copy</td>

-s device

[-F stop_command]{[-d file]|[-o </pb> output_fd</tdi>][<~~td width="15%"~~b>-f feedback_fd] }</td></tr>

ploop copy</td>

-d file[-i </pb>input_fd</tdi>][<~~td width="15%"~~b>-f feedback_fd]</td></tr>

</table>

ploop balloon discard <td width="45%"></td>

[--automount]

[--to-free size]

[--min-block min_size] [--defrag]DiskDescriptor.xml </td><td width="5%"></td></tr></table> <table width="100%" border="0" rules="none" frame="void" cellspacing="0" cellpadding="0"><tr valign="top" align="left"> ploop restore-descriptor <td width="49%"></td><td width="51%"> -f format[-b blocksize] disk_dirdelta_file </td></tr>

</table>

[-t fstype]

[-b blocksize]

[-B fsblocksize] [--nolazy]delta_file</td></tr>

Filesystem block size, in

bytes. Default is 4096 bytes.

-n, --nolazy

Disable lazy mkfs

initialization (which is enabled by default). Currently that

means if this flag is set, mkfs.ext4(8) is called

with -Elazy_itable_init=0,lazy_journal_init=0

options.

<table width="100%" border="0" rules="none" frame="void"

</td></tr>

</table>

==== replace ====

Replaces a ploop image by a

different (but identical) one, on a running ploop device.

Only a read-only image (e.g. a non-top one in a stacked

configuration) can be replaced. An image to be replaced is

specified by either one of level, UUID, or the current image

file.

If a new image is not identical

to the old one (i.e. its content differs) or not suitable

for ploop in any other way (e.g. it is sparse, or resides on

a file system not supported by ploop), the result is

undefined.

<table width="100%" border="0" rules="none" frame="void"

cellspacing="0" cellpadding="0">

ploop replace</td>

{ -u uuid |

-l level | -o cur_image_file }

[--keep-name] -i image_file

DiskDescriptor.xml </td></tr>

-u uuid</td>

A uuid of an image to be replaced.</td></tr>

-l level</td>

A level of image to be replaced. A level is a distance

of an image from the base delta.</td></tr>

</table>

-o

cur_image_file

A current image file (the one

to replace).

-k,

--keep-name

A flag to keep the same image

file name. If this flag is set, after the image is replaced,

a new image_file is renamed to the old one (removing

the old, now unused, image), so no modification to

DiskDescriptor.xml is required.

<table width="100%" border="0" rules="none" frame="void"

cellspacing="0" cellpadding="0">

-i image_file</td>

A new replacement image.</td>

</td></tr>

</table>

DiskDescriptor.xml

Path to the DiskDescriptor.xml

file with information about images.

==== resize ====

Check the internal consistency

of (and possibly repair) a ploop image (or images). Note

that image(s) to be tested should not be in use. If <table width="100%" border="0" rules="none" frame="void" cellspacing="0" cellpadding="0"><tr valign="top" align="left"><td width="11%"></td><td width="17%"> ploop check</td><td width="1%"></td><td width="43%"> [-u uuid]DiskDescriptor.xml ~~is supplied,~~ </td><td width="28%"></td></tr></table> Check all the images inDiskDescriptor.xml up to the one denoted bythe~~one~~ uuid (or default top delta, if UUID is notspecified). Default built-in check options are used, and theones specified on the command line, if any, are ~~checked~~ignored.

<table width="100%" border="0" rules="none" frame="void"

</table>

~~Show~~ When run without any options, show information about disk space and inodes usage andlimits on the inner ploop filesystem, somewhat similar to[[Man/vzquota.8|vzquota(8)]] stat or show commands.

<table width="100%" border="0" rules="none" frame="void"

ploop info</td>

[-s] [-d]

DiskDescriptor.xml </td>

</td></tr>

</table>

~~Show~~ Either one or both options can be used together. Option-s is used to show information about ploop device size, block size,and format version. Option -d isused to show a corresponding ploop block device, itavailable. file.

==== list ====

With option -a it also shows a mount point (third

column).

==== restore-descriptor ====

Create DiskDescriptor.xml file

suitable for delta_file and put it into

disk_dir.

<table width="100%" border="0" rules="none" frame="void"

cellspacing="0" cellpadding="0">

ploop restore-descriptor </td>

-f format

[-b blocksize] disk_dir

delta_file </td></tr>

</table>

Read image header in case of

ploop1 format or check raw image size and generate proper

DiskDescriptor.xml file. You can specify blocksize for raw

images. If it’s not specified it will be choosen

automatically - largest possible value between 32K and 1M.

Raw image size must be aligned to blocksize.

This command works only for base

images. Snapshots are not supported.

=== Working with snapshots ===

Snapshots are identified by a

unique UUID. A snapshot can be mounted using ploop mount

-u ~~UUID~~uuid command, see above.

==== snapshot ====

Merge a snapshot with its

parent. That is, contents of the delta file corresponding tothe snapshot is merged to a parent delta, then the file isremoved. Parent snapshot UUID is lost (as it is replacedwith the uuid specified). All snapshots having thelost one as a parent are updated to have the uuid asits parent.

<table width="100%" border="0" rules="none" frame="void"

[-u uuid [-U uuid2] | -A][-n new_delta]

DiskDescriptor.xml </td></tr>

Specify a single snapshot uuid to merge. If this optionis not specified, the top delta will be used.</td></tr><tr valign="top" align="left"><td width="11%"></td><td width="31%"> -U uuid2</td><td width="1%"></td><td width="57%"> Together with -u uuid, specify that allsnapshots in the range uuid...uuid2 are to bemerged.</td></tr>

snapshots have more than a single child, they will be

impossible to merge.</td></tr>

-n new_delta</td>

If this option is set, instead of merging the child

delta into its parent, both the parent and the child deltas

are merged into a newly created file new_delta, which

replaces the parent delta. Both deltas are then removed.</td></tr>

</table>

[-H]

[-u uuid] [-s]

[-o field[,field...]]

DiskDescriptor.xml </td></tr>

Filter the output to a

specified uuid.

<table width="100%" border="0" rules="none" frame="void"

cellspacing="0" cellpadding="0">

-s, --snapshot</td>

List in terms of snapshots. By default (i.e. without

this option) the command lists all deltas, and top delta is

marked as current. When this option is used, top delta is

not listed, and the snapshot which is the parent of top

delta is marked as current.</td></tr>

</table>

-o, --output

ploop copy</td>

-s device

[-F stop_command]{[-d file]|[-o </pb> output_fd</tdi>][<~~td width="15%"~~b>-f feedback_fd] }</td></tr>

</table>

in-kernel write tracker for the specified ploop

device, then sends all the data blocks from the top

delta image to a pipe specified by the output_fdargument (stdout (, i.e. 1 by default),supposedly read by destinationploop copy) , or a file. After that, ititeratively gets the list of the modified data blocks fromthe kernel and sends those blocks again. After a number ofiterations (or when the list is empty), it executes thestop_command (this could be vzctl stop orvzctl chkpnt) and does the last iteration of sendingthe modified data blocks. Finally, it checks that the datawere not modified, error is returned otherwise. If feedback_fd isspecified, it is used to read back from the ploop copyreceiving side. The feedback channel is currently used towait for fdatasync(2) completion.

==== copy (receiving) ====

ploop copy</td>

-d file[-i input_fd][-f feedback_fd]</td><td width="6214%">

</td></tr>

</table>

Reads the data ~~block~~ blocks (providedby the source ploop copy) from the file descriptorinput_fd (stdin , i.e. 0 by default) and

writes them to the file.

If feedback_fd is

specified, it is used to send status back to the ploop copy

sending side.

=== Ballooning ===

ploop balloon discard </td>

[--automount]

[--to-free size]

[--min-block min_size] [--defrag]DiskDescriptor.xml </td><td width="5%"></td></tr>

</table>

--automount option to automatically mount ploop for

the duration of the operation.

Option --defrag can be

used to run a filesystem defragmentation utility (currently

e4defrag2 on ext4 only) before the main operation.

Option --to-free can be

Error from fsck(8).

43, SYSEXIT_NOSNAP

Can’t find specified

snapshot UUID.

== SEE ALSO ==

Kir

Bureaucrats, Administrators

6,534

edits

OpenVZ Virtuozzo Containers Wiki β

Changes

Man/ploop.8

OpenVZ Virtuozzo Containers Wiki ^β