Command line, help.
[libguestfs.git] / guestfs-actions.pod
1 =head2 guestfs_mount
2
3  int guestfs_mount (guestfs_h *handle,
4                 const char *device,
5                 const char *mountpoint);
6
7 Mount a guest disk at a position in the filesystem.  Block devices
8 are named C</dev/sda>, C</dev/sdb> and so on, as they were added to
9 the guest.  If those block devices contain partitions, they will have
10 the usual names (eg. C</dev/sda1>).  Also LVM C</dev/VG/LV>-style
11 names can be used.
12
13 The rules are the same as for L<mount(2)>:  A filesystem must
14 first be mounted on C</> before others can be mounted.  Other
15 filesystems can only be mounted on directories which already
16 exist.
17
18 The mounted filesystem is writable, if we have sufficient permissions
19 on the underlying device.
20
21 The filesystem options C<sync> and C<noatime> are set with this
22 call, in order to improve reliability.
23
24 This function return 0 on success or -1 on error.
25
26 =head2 guestfs_sync
27
28  int guestfs_sync (guestfs_h *handle);
29
30 This syncs the disk, so that any writes are flushed through to the
31 underlying disk image.
32
33 You should always call this if you have modified a disk image, before
34 calling C<guestfs_close>.
35
36 This function return 0 on success or -1 on error.
37
38 =head2 guestfs_touch
39
40  int guestfs_touch (guestfs_h *handle,
41                 const char *path);
42
43 Touch acts like the L<touch(1)> command.  It can be used to
44 update the timestamps on a file, or, if the file does not exist,
45 to create a new zero-length file.
46
47 This function return 0 on success or -1 on error.
48