X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=src%2Fguestfs.pod;h=d9838cf987a429cf4b152ea58a890e82558ccd32;hb=b61fddabaf4cdf171731a0a2ea63d727844d0958;hp=73657d083cad9c5b21b82e8c3afb9031d0d76b8a;hpb=0699e05354cf97d5e3790dc89d9dd727242d3ac6;p=libguestfs.git
diff --git a/src/guestfs.pod b/src/guestfs.pod
index 73657d0..d9838cf 100644
--- a/src/guestfs.pod
+++ b/src/guestfs.pod
@@ -99,7 +99,7 @@ this:
* disk image.
*/
guestfs_touch (g, "/hello");
-
+
/* This is only needed for libguestfs < 1.5.24. Since then
* it is done automatically when you close the handle. See
* discussion of autosync in this page.
@@ -262,10 +262,9 @@ L.
=head2 DOWNLOADING
-Use L to download small, text only files. This call
-is limited to files which are less than 2 MB and which cannot contain
-any ASCII NUL (C<\0>) characters. However it has a very simple
-to use API.
+Use L to download small, text only files. This call is
+limited to files which are less than 2 MB and which cannot contain any
+ASCII NUL (C<\0>) characters. However the API is very simple to use.
L can be used to read files which contain
arbitrary 8 bit data, since it returns a (pointer, size) pair.
@@ -353,13 +352,13 @@ descriptor N.
For example, L writes its output to stdout by
doing:
- guestfs_download (filename, "/dev/stdout");
+ guestfs_download (g, filename, "/dev/stdout");
and you can write tar output to a pipe C by doing:
char devfd[64];
snprintf (devfd, sizeof devfd, "/dev/fd/%d", fd);
- guestfs_tar_out ("/", devfd);
+ guestfs_tar_out (g, "/", devfd);
=head2 LISTING FILES
@@ -676,9 +675,9 @@ Although we don't want to discourage you from using the C API, we will
mention here that the same API is also available in other languages.
The API is broadly identical in all supported languages. This means
-that the C call C is
-C<$g-Emount($path)> in Perl, C in Python,
-and C in OCaml. In other words, a
+that the C call C is
+C<$g-Eadd_drive_ro($file)> in Perl, C in Python,
+and C in OCaml. In other words, a
straightforward, predictable isomorphism between each language.
Error messages are automatically transformed
@@ -714,11 +713,11 @@ with libguestfs.
=item B
-For documentation see L.
+See L.
=item B
-For documentation see L.
+See L.
=item B
@@ -729,15 +728,15 @@ The PHP binding only works correctly on 64 bit machines.
=item B
-For documentation see L.
+See L.
=item B
-For documentation see L.
+See L.
=item B
-For documentation see L.
+See L.
=back
@@ -913,8 +912,8 @@ architecture for multithreaded programs using libvirt and libguestfs.
=head2 PATH
-Libguestfs needs a kernel and initrd.img, which it finds by looking
-along an internal path.
+Libguestfs needs a supermin appliance, which it finds by looking along
+an internal path.
By default it looks for these in the directory C<$libdir/guestfs>
(eg. C or C).
@@ -2458,8 +2457,8 @@ example:
=item LIBGUESTFS_PATH
-Set the path that libguestfs uses to search for kernel and initrd.img.
-See the discussion of paths in section PATH above.
+Set the path that libguestfs uses to search for a supermin appliance.
+See the discussion of paths in section L above.
=item LIBGUESTFS_QEMU