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
This function returns 0 on success or -1 on error.
+=head2 guestfs_command
+
+ char *guestfs_command (guestfs_h *handle,
+ char * const* const arguments);
+
+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).
+
+The single parameter is an argv-style list of arguments.
+The first element is the name of the program to run.
+Subsequent elements are parameters. The list must be
+non-empty (ie. must contain a program name).
+
+The C<$PATH> environment variable will contain at least
+C</usr/bin> and C</bin>. If you require a program from
+another location, you should provide the full path in the
+first parameter.
+
+Shared libraries and data files required by the program
+must be available on filesystems which are mounted in the
+correct places. It is the caller's responsibility to ensure
+all filesystems that are needed are mounted at the right
+locations.
+
+This function returns a string, or NULL on error.
+I<The caller must free the returned string after use>.
+
+=head2 guestfs_command_lines
+
+ char **guestfs_command_lines (guestfs_h *handle,
+ char * const* const arguments);
+
+This is the same as C<guestfs_command>, but splits the
+result into a list of lines.
+
+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_config
int guestfs_config (guestfs_h *handle,
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