Look up the value associated with C<path>. If C<path>
matches exactly one node, the C<value> is returned.
-This function returns a string or NULL on error.
+This function returns a string, or NULL on error.
I<The caller must free the returned string after use>.
=head2 guestfs_aug_init
as end of string). For those you need to use the C<guestfs_read_file>
function which has a more complex interface.
-This function returns a string or NULL on error.
+This function returns a string, or NULL on error.
I<The caller must free the returned string after use>.
Because of the message protocol, there is a transfer limit
char *guestfs_command (guestfs_h *handle,
char * const* const arguments);
-This calls runs a command from the guest filesystem. The
+This call runs a command from the guest filesystem. The
filesystem must be mounted, and must contain a compatible
operating system (ie. something Linux, with the same
or compatible processor architecture).
all filesystems that are needed are mounted at the right
locations.
-This function returns a string or NULL on error.
+This function returns a string, or NULL on error.
I<The caller must free the returned string after use>.
=head2 guestfs_command_lines
particular that the filename is not prepended to the output
(the C<-b> option).
-This function returns a string or NULL on error.
+This function returns a string, or NULL on error.
I<The caller must free the returned string after use>.
=head2 guestfs_get_autosync
This is always non-NULL. If it wasn't set already, then this will
return the default path.
-This function returns a string or NULL on error.
+This function returns a string, or NULL on error.
The string is owned by the guest handle and must I<not> be freed.
=head2 guestfs_get_verbose
This command is mostly useful for interactive sessions. It
is I<not> intended that you try to parse the output string.
-This function returns a string or NULL on error.
+This function returns a string, or NULL on error.
I<The caller must free the returned string after use>.
=head2 guestfs_ls