X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;ds=sidebyside;f=fish%2Fguestfish.pod;h=b4cde8169ce8dfa76dc8444a20f1aa0adb4b110e;hb=ce95be8b185ce697816c3446406d7129e01cc0e1;hp=165cdf28f4fa05a3933d0f143dbd26374a7327db;hpb=b054e33db629e83c20c3d4e8ff941b7beb5abf34;p=libguestfs.git diff --git a/fish/guestfish.pod b/fish/guestfish.pod index 165cdf2..b4cde81 100644 --- a/fish/guestfish.pod +++ b/fish/guestfish.pod @@ -451,6 +451,39 @@ This syntax implicitly calls C (q.v.) so it also handles case insensitivity like Windows would. This only works in argument positions that expect a path. +=head1 UPLOADING AND DOWNLOADING FILES + +For commands such as C, C, C, C and +others which upload from or download to a local file, you can use the +special filename C<-> to mean "from stdin" or "to stdout". For example: + + upload - /foo + +reads stdin and creates from that a file C in the disk image, +and: + + tar-out /etc - | tar tf - + +writes the tarball to stdout and then pipes that into the external +"tar" command (see L). + +When using C<-> to read from stdin, the input is read up to the end of +stdin. You can also use a special "heredoc"-like syntax to read up to +some arbitrary end marker: + + upload -<. The end +marker must appear on a line of its own, without any preceeding or +following characters (not even spaces). + +Note that the C<-EE> syntax only applies to parameters used to +upload local files (so-called "FileIn" parameters in the generator). + =head1 EXIT ON ERROR BEHAVIOUR By default, guestfish will ignore any errors when in interactive mode @@ -552,39 +585,6 @@ Create a blank 200MB disk: guestfish -N disk:200M -=head1 UPLOADING AND DOWNLOADING FILES - -For commands such as C, C, C, C and -others which upload from or download to a local file, you can use the -special filename C<-> to mean "from stdin" or "to stdout". For example: - - upload - /foo - -reads stdin and creates from that a file C in the disk image, -and: - - tar-out /etc - | tar tf - - -writes the tarball to stdout and then pipes that into the external -"tar" command (see L). - -When using C<-> to read from stdin, the input is read up to the end of -stdin. You can also use a special "heredoc"-like syntax to read up to -some arbitrary end marker: - - upload -<. The end -marker must appear on a line of its own, without any preceeding or -following characters (not even spaces). - -Note that the C<-EE> syntax only applies to parameters used to -upload local files (so-called "FileIn" parameters in the generator). - =head1 GUESTFISH COMMANDS The commands in this section are guestfish convenience commands, in @@ -835,8 +835,8 @@ enough. =head1 EXIT CODE -guestfish returns I<0> if the commands completed without error, or -I<1> if there was an error. +guestfish returns 0 if the commands completed without error, or +1 if there was an error. =head1 SEE ALSO @@ -860,7 +860,7 @@ Richard W.M. Jones (C) =head1 COPYRIGHT -Copyright (C) 2009 Red Hat Inc. +Copyright (C) 2009-2010 Red Hat Inc. L This program is free software; you can redistribute it and/or modify