summaryrefslogtreecommitdiffstats
path: root/guestfish.pod
diff options
context:
space:
mode:
authorRichard Jones <rjones@redhat.com>2009-05-08 15:19:51 +0100
committerRichard Jones <rjones@redhat.com>2009-05-08 15:19:51 +0100
commitc10fa84ada465d83bcbe0550ed512215036b4bea (patch)
tree9c0247d1d2870009e14bfcf08c605018da09f845 /guestfish.pod
parent33377fc61d4356a0e83cf7ef39d545842647481c (diff)
downloadlibguestfs-c10fa84ada465d83bcbe0550ed512215036b4bea.tar.gz
libguestfs-c10fa84ada465d83bcbe0550ed512215036b4bea.tar.xz
libguestfs-c10fa84ada465d83bcbe0550ed512215036b4bea.zip
Implement -command (to ignore errors) in guestfish, and allow recovery from qemu process failure.
Diffstat (limited to 'guestfish.pod')
-rw-r--r--guestfish.pod16
1 files changed, 16 insertions, 0 deletions
diff --git a/guestfish.pod b/guestfish.pod
index b464c717..e7a4ffa6 100644
--- a/guestfish.pod
+++ b/guestfish.pod
@@ -202,6 +202,17 @@ will create a directory C<local> on the host, and then export
the contents of C</remote> on the mounted filesystem to
C<local/remote-data.tar.gz>. (See C<tgz-out>).
+=head1 EXIT ON ERROR BEHAVIOUR
+
+By default, guestfish will ignore any errors when in interactive mode
+(ie. taking commands from a human over a tty), and will exit on the
+first error in non-interactive mode (scripts, commands given on the
+command line).
+
+If you prefix a command with a I<-> character, then that command will
+not cause guestfish to exit, even if that (one) command returns an
+error.
+
=head1 COMMANDS
=head2 help
@@ -301,6 +312,11 @@ set, it uses C<vi>.
=back
+=head1 EXIT CODE
+
+guestfish returns I<0> if the commands completed without error, or
+I<1> if there was an error.
+
=head1 SEE ALSO
L<guestfs(3)>,