X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=guestfish-actions.pod;h=04343af2d9bc33999664f8592de1f96811ddd8db;hp=44d86f24ece5e5420fd7b71b8ab2fa463ed7f263;hb=d43dac69483e8ec62e8356d93f761684ce2f5cc8;hpb=36f9dac1a2530b575dab9226f6ddd85e6e8c8590
diff --git a/guestfish-actions.pod b/guestfish-actions.pod
index 44d86f2..04343af 100644
--- a/guestfish-actions.pod
+++ b/guestfish-actions.pod
@@ -403,6 +403,20 @@ The first character of C string must be a C<-> (dash).
C can be NULL.
+=head2 cp
+
+ cp src dest
+
+This copies a file from C to C where C is
+either a destination filename or destination directory.
+
+=head2 cp-a
+
+ cp-a src dest
+
+This copies a file or directory from C to C
+recursively using the C command.
+
=head2 debug
debug subcmd 'extraargs ...'
@@ -415,6 +429,19 @@ There is no comprehensive help for this command. You have
to look at the file C in the libguestfs source
to find out what you can do.
+=head2 dmesg
+
+ dmesg
+
+This returns the kernel messages (C output) from
+the guest kernel. This is sometimes useful for extended
+debugging of problems.
+
+Another way to get the same information is to enable
+verbose messages with C or by setting
+the environment variable C before
+running the program.
+
=head2 download
download remotefilename (filename|-)
@@ -428,6 +455,29 @@ See also C, C.
Use C<-> instead of a filename to read/write from stdin/stdout.
+=head2 drop-caches
+
+ drop-caches whattodrop
+
+This instructs the guest kernel to drop its page cache,
+and/or dentries and inode caches. The parameter C
+tells the kernel what precisely to drop, see
+L
+
+Setting C to 3 should drop everything.
+
+This automatically calls L before the operation,
+so that the maximum guest memory is freed.
+
+=head2 equal
+
+ equal file1 file2
+
+This compares the two files C and C and returns
+true if their content is exactly equal, or false otherwise.
+
+The external L program is used for the comparison.
+
=head2 exists
exists path
@@ -534,6 +584,24 @@ For more information on states, see L.
This returns the verbose messages flag.
+=head2 grub-install
+
+ grub-install root device
+
+This command installs GRUB (the Grand Unified Bootloader) on
+C, with the root directory being C.
+
+=head2 hexdump
+
+ hexdump path
+
+This runs C on the given C. The result is
+the human-readable, canonical hex dump of the file.
+
+Because of the message protocol, there is a transfer limit
+of somewhere between 2MB and 4MB. To transfer large files you should use
+FTP.
+
=head2 is-busy
is-busy
@@ -722,7 +790,7 @@ as necessary. This is like the C shell command.
mkfs fstype device
This creates a filesystem on C (usually a partition
-of LVM logical volume). The filesystem type is C, for
+or LVM logical volume). The filesystem type is C, for
example C.
=head2 mount
@@ -778,6 +846,22 @@ the list of devices (eg. C, C).
Some internal mounts are not shown.
+=head2 mv
+
+ mv src dest
+
+This moves a file from C to C where C is
+either a destination filename or destination directory.
+
+=head2 ping-daemon
+
+ ping-daemon
+
+This is a test probe into the guestfs daemon running inside
+the qemu subprocess. Calling this function checks that the
+daemon responds to the ping message, without affecting the daemon
+or attached block device(s) in any other way.
+
=head2 pvcreate
pvcreate device
@@ -970,6 +1054,35 @@ C should be a file or directory in the mounted file system
This is the same as the C system call.
+=head2 strings
+
+ strings path
+
+This runs the L command on a file and returns
+the list of printable strings found.
+
+Because of the message protocol, there is a transfer limit
+of somewhere between 2MB and 4MB. To transfer large files you should use
+FTP.
+
+=head2 strings-e
+
+ strings-e encoding path
+
+This is like the C command, but allows you to
+specify the encoding.
+
+See the L manpage for the full list of encodings.
+
+Commonly useful encodings are C (lower case L) which will
+show strings inside Windows/x86 files.
+
+The returned strings are transcoded to UTF-8.
+
+Because of the message protocol, there is a transfer limit
+of somewhere between 2MB and 4MB. To transfer large files you should use
+FTP.
+
=head2 sync
sync
@@ -1120,6 +1233,11 @@ As a special case, if C is C<0>
then the length is calculated using C (so in this case
the content cannot contain embedded ASCII NULs).
+I Owing to a bug, writing content containing ASCII NUL
+characters does I work, even if the length is specified.
+We hope to resolve this bug in a future version. In the meantime
+use C.
+
Because of the message protocol, there is a transfer limit
of somewhere between 2MB and 4MB. To transfer large files you should use
FTP.