diff options
author | Richard Jones <rjones@redhat.com> | 2009-11-22 19:15:56 +0000 |
---|---|---|
committer | Richard Jones <rjones@redhat.com> | 2009-11-23 00:10:37 +0000 |
commit | 22e531bc459309d9a871a845cfacd1396ff5b7e4 (patch) | |
tree | 32ec16f2a1799ec6a667b6b7bf29d751e17697ac /guestfs.pod | |
parent | acdcbac91e9f03333a47204f2a6c52ac03288305 (diff) | |
download | libguestfs-22e531bc459309d9a871a845cfacd1396ff5b7e4.tar.gz libguestfs-22e531bc459309d9a871a845cfacd1396ff5b7e4.tar.xz libguestfs-22e531bc459309d9a871a845cfacd1396ff5b7e4.zip |
Implement 'dd' command.
Diffstat (limited to 'guestfs.pod')
-rw-r--r-- | guestfs.pod | 35 |
1 files changed, 35 insertions, 0 deletions
diff --git a/guestfs.pod b/guestfs.pod index 4a477330..7b6a34e3 100644 --- a/guestfs.pod +++ b/guestfs.pod @@ -274,6 +274,41 @@ non-portable between kernel versions, and they don't support labels or UUIDs. If you want to pre-build an image or you need to mount it using a label or UUID, use an ISO image instead. +=head2 COPYING + +There are various different commands for copying between files and +devices and in and out of the guest filesystem. These are summarised +in the table below. + +=over 4 + +=item B<file> to B<file> + +Use L</guestfs_cp> to copy a single file, or +L</guestfs_cp_a> to copy directories recursively. + +=item B<file or device> to B<file or device> + +Use L</guestfs_dd> which efficiently uses L<dd(1)> +to copy between files and devices in the guest. + +Example: duplicate the contents of an LV: + + guestfs_dd (g, "/dev/VG/Original", "/dev/VG/Copy"); + +The destination (C</dev/VG/Copy>) must be at least as large as the +source (C</dev/VG/Original>). + +=item B<file on the host> to B<file or device> + +Use L</guestfs_upload>. See L</UPLOADING> above. + +=item B<file or device> to B<file on the host> + +Use L</guestfs_download>. See L</DOWNLOADING> above. + +=back + =head2 LISTING FILES C<guestfs_ll> is just designed for humans to read (mainly when using |