summaryrefslogtreecommitdiffstats
path: root/src
diff options
context:
space:
mode:
authorRichard Jones <rjones@redhat.com>2010-05-27 09:49:28 +0100
committerRichard Jones <rjones@redhat.com>2010-05-27 09:49:28 +0100
commit1d1cc4114d48623fb44e3d18e74407902c8f2ae9 (patch)
treeb7d57e6989d6ec7ae65cf52e8e5cc03785e992c2 /src
parent6b500f1b8e1ac8d28c485a5591c2833b18cc86e2 (diff)
downloadlibguestfs-1d1cc4114d48623fb44e3d18e74407902c8f2ae9.tar.gz
libguestfs-1d1cc4114d48623fb44e3d18e74407902c8f2ae9.tar.xz
libguestfs-1d1cc4114d48623fb44e3d18e74407902c8f2ae9.zip
Revise documentation on creating files.
Diffstat (limited to 'src')
-rw-r--r--src/guestfs.pod6
1 files changed, 5 insertions, 1 deletions
diff --git a/src/guestfs.pod b/src/guestfs.pod
index e3f6cf05..3794023a 100644
--- a/src/guestfs.pod
+++ b/src/guestfs.pod
@@ -258,7 +258,11 @@ L</guestfs_tgz_out>.
It's often the case that you want to write a file or files to the disk
image.
-For small, single files, use L</guestfs_write>.
+To write a small file with fixed content, use L</guestfs_write>. To
+create a file of all zeroes, use L</guestfs_truncate_size> (sparse) or
+L</guestfs_fallocate64> (with all disk blocks allocated). There are a
+variety of other functions for creating test files, for example
+L</guestfs_fill> and L</guestfs_fill_pattern>.
To upload a single file, use L</guestfs_upload>. This call has no
limits on file content or size (even files larger than 4 GB).