X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=guestfish.pod;h=28daa0abdf40247519533c21d43b54742cc7c05d;hp=b464c717742e0769be7d48c6a04b17110f4865bc;hb=8c637e1fb03d4a4ff36af770758671b3cabf9842;hpb=a4d88af2c13692e38fb7cfce77b082cee6e0462f diff --git a/guestfish.pod b/guestfish.pod index b464c71..28daa0a 100644 --- a/guestfish.pod +++ b/guestfish.pod @@ -202,6 +202,17 @@ will create a directory C on the host, and then export the contents of C on the mounted filesystem to C. (See C). +=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 @@ -267,6 +278,15 @@ editors. NOTE: This will not work reliably for large files (> 2 MB) or binary files containing \0 bytes. +=head2 lcd + + lcd directory + +Change the local directory, ie. the current directory of guestfish +itself. + +Note that C won't do what you might expect. + @ACTIONS@ =head1 ENVIRONMENT VARIABLES @@ -289,6 +309,10 @@ Set the default qemu binary that libguestfs uses. If not set, then the qemu which was found at compile time by the configure script is used. +=item LIBGUESTFS_APPEND + +Pass additional options to the guest kernel. + =item HOME If compiled with GNU readline support, then the command history @@ -301,10 +325,15 @@ set, it uses C. =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, -L. +L. =head1 AUTHORS @@ -313,7 +342,7 @@ Richard W.M. Jones (C) =head1 COPYRIGHT Copyright (C) 2009 Red Hat Inc. -L +L This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by