cpvdi command

Purpose

Copies a block device.

Syntax

cpvdi -src input_disk_image -dst output_disk_image [-isp input_storage_pool] [-osp output_storage_pool] [-progress] [-overwrite] [-unconfigure] [-f]

Description

The cpvdi command copies a block device image, which can be either a logical or physical volume, a file-backed device, or a file on another existing disk. The parameters of the -src and -dst flags should be fully qualified names when specifying a file or device. Specifying the -progress flag prints a number sign (#) on the stderr for each block (1 M) of data copied on to the destination.

Note: The output_disk_image device that you specify with the -dst flag cannot be a physical volume that is assigned to a shared memory pool (to be used as a paging space device by a shared memory partition).

Flags

-src input_disk_image	Specifies the input backing device. The input backing device might either be a physical or logical volume or a file is located in the caller's home directory, any of its subdirectories or in the /mnt directory. The root user will not have any file location restrictions.
-dst output_disk_image	Specifies the output backing device. The output backing device might either be a physical or logical volume or a file is located in the caller's home directory, any of its subdirectories or in the /mnt directory. The root user will not have any file location restrictions.
-f	Overwrites the destination file. However, if the source or destination file is configured as backing device, it copies the file without unconfiguring the device or devices. If the -unconfigure flag is used in addition to the -f flag, then the -unconfigure flag takes priority.
-progress	Specifies the process status of the command will be expressed by printing a number sign (#) to stderr for every 1024 KB block of data that has been copied.
-isp input_storage_pool	Specifies the name of the storage pool where the input file-backed device exists. Required if the argument of the -src flag is a file-backed device.
-osp output_storage_pool	Specifies the name of the storage pool where the input file-backed device exists. Required if the argument of the -dst flag is a file-backed device.
-overwrite	Overwrites the destination file, if the file is present. If you do not use this flag, an error message displays with a non-zero exit code.
-unconfigure	Specifies to unconfigure the virtual target device (VTD) and reconfigure the VTD after a copy operation. Only use this flag if the source or destination file is configured as backing device. If you do not use this flag, an error message displays with a non-zero exit code.

Exit Status

See Exit status for Virtual I/O Server commands.

Examples

To copy a physical volume disk image to a file, type the following command:
```
cpvdi -src hdisk1 -dst /home/my_home/image1_file
```
To copy a disk image that is a file to a physical volume, type the following command:
```
cpvdi -src /home/my_home/image2_file -dst hdisk2
```
To output a hash symbol for every block of data that is copied, type the following command:
```
cpvdi -src hdisk1 -dst hdisk2 -progress
```
To copy a file-backed device to another file-backed device, type the following command:
```
cpvdi -src image1_file -dst image2_file -isp sp01 -osp sp02
```
To copy a file1 to file2, when file2 already exists, type the following command:
```
cpvdi -src /home/padmin/file1 -dst /home/padmin/file2 -overwrite
```
To copy a file-backed device fbd1 as fbd2, when fbd1 is configured as the backing device, type the following command:
```
cpvdi -src fbd1 -dst fbd2 -isp sp01 -osp sp01 -f
```

Related Information

The cp command and the backupios command.