X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=src%2Fgenerator.ml;h=9e602acd5ab9ee8eb315d6dec38fa5910b87901f;hb=f02acc3d307f210d418a0177f374d02a4f8ccb5a;hp=1206be22fbd81323511f803dccd848bf65f3e2fa;hpb=b017cd67bb56284d05fc168d2b3536bee55b9ebf;p=libguestfs.git diff --git a/src/generator.ml b/src/generator.ml index 1206be2..9e602ac 100755 --- a/src/generator.ml +++ b/src/generator.ml @@ -3266,7 +3266,7 @@ matching lines."); This calls the external C program and returns the matching lines."); - ("realpath", (RString "rpath", [Pathname "path"]), 163, [], + ("realpath", (RString "rpath", [Pathname "path"]), 163, [Optional "realpath"], [InitISOFS, Always, TestOutput ( [["realpath"; "/../directory"]], "/directory")], "canonicalized absolute pathname", @@ -4105,28 +4105,28 @@ To fill a file with zero bytes (sparsely), it is much more efficient to use C."); ("available", (RErr, [StringList "groups"]), 216, [], - [], + [InitNone, Always, TestRun [["available"; ""]]], "test availability of some parts of the API", "\ This command is used to check the availability of some -groups of libguestfs functions which not all builds of -libguestfs will be able to provide. +groups of functionality in the appliance, which not all builds of +the libguestfs appliance will be able to provide. -The precise libguestfs function groups that may be checked by this -command are listed in L. +The libguestfs groups, and the functions that those +groups correspond to, are listed in L. -The argument C is a list of API group names, eg: +The argument C is a list of group names, eg: C<[\"inotify\", \"augeas\"]> would check for the availability of -the C functions and C -(partition editing) functions. +the Linux inotify functions and Augeas (configuration file +editing) functions. The command returns no error if I requested groups are available. -It returns an error if one or more of the requested -groups is unavailable. +It fails with an error if one or more of the requested +groups is unavailable in the appliance. If an unknown group name is included in the -list of C then an error is always returned. +list of groups then an error is always returned. I @@ -4135,7 +4135,8 @@ I =item * You must call C before calling this function. -The reason is because we don't know what function groups are + +The reason is because we don't know what groups are supported by the appliance/daemon until it is running and can be queried.