diff options
author | Richard Jones <rjones@redhat.com> | 2009-04-15 10:45:01 +0100 |
---|---|---|
committer | Richard Jones <rjones@redhat.com> | 2009-04-15 10:45:01 +0100 |
commit | 6bcbe54b5785cb8c911ccf4b724ae6abfdf53ce4 (patch) | |
tree | 17dc6cbf4514f5808fbc204e592723bea95c4382 /guestfs-actions.pod | |
parent | 212a55d483c2a20e61f42211c0c64aab3645cb09 (diff) | |
download | libguestfs-6bcbe54b5785cb8c911ccf4b724ae6abfdf53ce4.tar.gz libguestfs-6bcbe54b5785cb8c911ccf4b724ae6abfdf53ce4.tar.xz libguestfs-6bcbe54b5785cb8c911ccf4b724ae6abfdf53ce4.zip |
Generated code for stat/lstat/statvfs changes.
Diffstat (limited to 'guestfs-actions.pod')
-rw-r--r-- | guestfs-actions.pod | 63 |
1 files changed, 59 insertions, 4 deletions
diff --git a/guestfs-actions.pod b/guestfs-actions.pod index 5bd9628b..03378e0a 100644 --- a/guestfs-actions.pod +++ b/guestfs-actions.pod @@ -58,7 +58,8 @@ On success this returns a pair containing the number of nodes in the nodeset, and a boolean flag if a node was created. -This function returns a C<struct guestfs_int_bool *>. +This function returns a C<struct guestfs_int_bool *>, +or NULL if there was an error. I<The caller must call C<guestfs_free_int_bool> after use>. =head2 guestfs_aug_defvar @@ -500,6 +501,24 @@ This function returns a NULL-terminated array of strings (like L<environ(3)>), or NULL if there was an error. I<The caller must free the strings and the array after use>. +=head2 guestfs_lstat + + struct guestfs_stat *guestfs_lstat (guestfs_h *handle, + const char *path); + +Returns file information for the given C<path>. + +This is the same as C<guestfs_stat> except that if C<path> +is a symbolic link, then the link is stat-ed, not the file it +refers to. + +This is the same as the C<lstat(2)> system call. + +This function returns a C<struct guestfs_stat *> +(see L<stat(2)> and E<lt>guestfs-structs.hE<gt>), +or NULL if there was an error. +I<The caller must call C<free> after use>. + =head2 guestfs_lvcreate int guestfs_lvcreate (guestfs_h *handle, @@ -547,7 +566,9 @@ I<The caller must free the strings and the array after use>. List all the logical volumes detected. This is the equivalent of the L<lvs(8)> command. The "full" version includes all fields. -This function returns a C<struct guestfs_lvm_lv_list *>. +This function returns a C<struct guestfs_lvm_lv_list *> +(see E<lt>guestfs-structs.hE<gt>), +or NULL if there was an error. I<The caller must call C<guestfs_free_lvm_lv_list> after use>. =head2 guestfs_mkdir @@ -653,7 +674,9 @@ I<The caller must free the strings and the array after use>. List all the physical volumes detected. This is the equivalent of the L<pvs(8)> command. The "full" version includes all fields. -This function returns a C<struct guestfs_lvm_pv_list *>. +This function returns a C<struct guestfs_lvm_pv_list *> +(see E<lt>guestfs-structs.hE<gt>), +or NULL if there was an error. I<The caller must call C<guestfs_free_lvm_pv_list> after use>. =head2 guestfs_read_lines @@ -778,6 +801,36 @@ This function returns 0 on success or -1 on error. B<This command is dangerous. Without careful use you can easily destroy all your data>. +=head2 guestfs_stat + + struct guestfs_stat *guestfs_stat (guestfs_h *handle, + const char *path); + +Returns file information for the given C<path>. + +This is the same as the C<stat(2)> system call. + +This function returns a C<struct guestfs_stat *> +(see L<stat(2)> and E<lt>guestfs-structs.hE<gt>), +or NULL if there was an error. +I<The caller must call C<free> after use>. + +=head2 guestfs_statvfs + + struct guestfs_statvfs *guestfs_statvfs (guestfs_h *handle, + const char *path); + +Returns file system statistics for any mounted file system. +C<path> should be a file or directory in the mounted file system +(typically it is the mount point itself, but it doesn't need to be). + +This is the same as the C<statvfs(2)> system call. + +This function returns a C<struct guestfs_statvfs *> +(see L<statvfs(2)> and E<lt>guestfs-structs.hE<gt>), +or NULL if there was an error. +I<The caller must call C<free> after use>. + =head2 guestfs_sync int guestfs_sync (guestfs_h *handle); @@ -856,7 +909,9 @@ I<The caller must free the strings and the array after use>. List all the volumes groups detected. This is the equivalent of the L<vgs(8)> command. The "full" version includes all fields. -This function returns a C<struct guestfs_lvm_vg_list *>. +This function returns a C<struct guestfs_lvm_vg_list *> +(see E<lt>guestfs-structs.hE<gt>), +or NULL if there was an error. I<The caller must call C<guestfs_free_lvm_vg_list> after use>. =head2 guestfs_wait_ready |