summaryrefslogtreecommitdiffstats
path: root/guestfs.pod
diff options
context:
space:
mode:
authorRichard Jones <rjones@redhat.com>2009-11-22 19:15:56 +0000
committerRichard Jones <rjones@redhat.com>2009-11-23 00:10:37 +0000
commit22e531bc459309d9a871a845cfacd1396ff5b7e4 (patch)
tree32ec16f2a1799ec6a667b6b7bf29d751e17697ac /guestfs.pod
parentacdcbac91e9f03333a47204f2a6c52ac03288305 (diff)
downloadlibguestfs-22e531bc459309d9a871a845cfacd1396ff5b7e4.tar.gz
libguestfs-22e531bc459309d9a871a845cfacd1396ff5b7e4.tar.xz
libguestfs-22e531bc459309d9a871a845cfacd1396ff5b7e4.zip
Implement 'dd' command.
Diffstat (limited to 'guestfs.pod')
-rw-r--r--guestfs.pod35
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