From 45d78361d791f4a752fca9472b81bdc75f9f92a4 Mon Sep 17 00:00:00 2001 From: Richard Jones Date: Tue, 12 May 2009 17:16:59 +0100 Subject: Test the 'command' and 'command_lines' functions thoroughly. --- guestfish-actions.pod | 15 +++++++++++++++ 1 file changed, 15 insertions(+) (limited to 'guestfish-actions.pod') diff --git a/guestfish-actions.pod b/guestfish-actions.pod index 04343af2..7d46206b 100644 --- a/guestfish-actions.pod +++ b/guestfish-actions.pod @@ -372,6 +372,13 @@ The first element is the name of the program to run. Subsequent elements are parameters. The list must be non-empty (ie. must contain a program name). +The return value is anything printed to I by +the command. + +If the command returns a non-zero exit status, then +this function returns an error message. The error message +string is the content of I from the command. + The C<$PATH> environment variable will contain at least C and C. If you require a program from another location, you should provide the full path in the @@ -383,6 +390,10 @@ correct places. It is the caller's responsibility to ensure all filesystems that are needed are mounted at the right locations. +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 command-lines command-lines 'arguments ...' @@ -390,6 +401,10 @@ locations. This is the same as C, but splits the result into a list of lines. +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 config config qemuparam qemuvalue -- cgit