1 /* libguestfs generated file
2 * WARNING: THIS FILE IS GENERATED BY 'src/generator.ml'.
3 * ANY CHANGES YOU MAKE TO THIS FILE WILL BE LOST.
5 * Copyright (C) 2009 Red Hat Inc.
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
30 void list_commands (void)
32 printf (" %-16s %s\n", "Command", "Description");
33 list_builtin_commands ();
34 printf ("%-20s %s\n", "add-cdrom", "add a CD-ROM disk image to examine");
35 printf ("%-20s %s\n", "add-drive", "add an image to examine or modify");
36 printf ("%-20s %s\n", "aug-close", "close the current Augeas handle");
37 printf ("%-20s %s\n", "aug-defnode", "define an Augeas node");
38 printf ("%-20s %s\n", "aug-defvar", "define an Augeas variable");
39 printf ("%-20s %s\n", "aug-get", "look up the value of an Augeas path");
40 printf ("%-20s %s\n", "aug-init", "create a new Augeas handle");
41 printf ("%-20s %s\n", "aug-insert", "insert a sibling Augeas node");
42 printf ("%-20s %s\n", "aug-load", "load files into the tree");
43 printf ("%-20s %s\n", "aug-ls", "list Augeas nodes under a path");
44 printf ("%-20s %s\n", "aug-match", "return Augeas nodes which match path");
45 printf ("%-20s %s\n", "aug-mv", "move Augeas node");
46 printf ("%-20s %s\n", "aug-rm", "remove an Augeas path");
47 printf ("%-20s %s\n", "aug-save", "write all pending Augeas changes to disk");
48 printf ("%-20s %s\n", "aug-set", "set Augeas path to value");
49 printf ("%-20s %s\n", "cat", "list the contents of a file");
50 printf ("%-20s %s\n", "chmod", "change file mode");
51 printf ("%-20s %s\n", "chown", "change file owner and group");
52 printf ("%-20s %s\n", "command", "run a command from the guest filesystem");
53 printf ("%-20s %s\n", "command-lines", "run a command, returning lines");
54 printf ("%-20s %s\n", "config", "add qemu parameters");
55 printf ("%-20s %s\n", "exists", "test if file or directory exists");
56 printf ("%-20s %s\n", "file", "determine file type");
57 printf ("%-20s %s\n", "get-autosync", "get autosync mode");
58 printf ("%-20s %s\n", "get-path", "get the search path");
59 printf ("%-20s %s\n", "get-verbose", "get verbose mode");
60 printf ("%-20s %s\n", "is-dir", "test if file exists");
61 printf ("%-20s %s\n", "is-file", "test if file exists");
62 printf ("%-20s %s\n", "kill-subprocess", "kill the qemu subprocess");
63 printf ("%-20s %s\n", "launch", "launch the qemu subprocess");
64 printf ("%-20s %s\n", "list-devices", "list the block devices");
65 printf ("%-20s %s\n", "list-partitions", "list the partitions");
66 printf ("%-20s %s\n", "ll", "list the files in a directory (long format)");
67 printf ("%-20s %s\n", "ls", "list the files in a directory");
68 printf ("%-20s %s\n", "lstat", "get file information for a symbolic link");
69 printf ("%-20s %s\n", "lvcreate", "create an LVM volume group");
70 printf ("%-20s %s\n", "lvm-remove-all", "remove all LVM LVs, VGs and PVs");
71 printf ("%-20s %s\n", "lvs", "list the LVM logical volumes (LVs)");
72 printf ("%-20s %s\n", "lvs-full", "list the LVM logical volumes (LVs)");
73 printf ("%-20s %s\n", "mkdir", "create a directory");
74 printf ("%-20s %s\n", "mkdir-p", "create a directory and parents");
75 printf ("%-20s %s\n", "mkfs", "make a filesystem");
76 printf ("%-20s %s\n", "mount", "mount a guest disk at a position in the filesystem");
77 printf ("%-20s %s\n", "mounts", "show mounted filesystems");
78 printf ("%-20s %s\n", "pvcreate", "create an LVM physical volume");
79 printf ("%-20s %s\n", "pvs", "list the LVM physical volumes (PVs)");
80 printf ("%-20s %s\n", "pvs-full", "list the LVM physical volumes (PVs)");
81 printf ("%-20s %s\n", "read-lines", "read file as lines");
82 printf ("%-20s %s\n", "rm", "remove a file");
83 printf ("%-20s %s\n", "rm-rf", "remove a file or directory recursively");
84 printf ("%-20s %s\n", "rmdir", "remove a directory");
85 printf ("%-20s %s\n", "set-autosync", "set autosync mode");
86 printf ("%-20s %s\n", "set-path", "set the search path");
87 printf ("%-20s %s\n", "set-verbose", "set verbose mode");
88 printf ("%-20s %s\n", "sfdisk", "create partitions on a block device");
89 printf ("%-20s %s\n", "stat", "get file information");
90 printf ("%-20s %s\n", "statvfs", "get file system statistics");
91 printf ("%-20s %s\n", "sync", "sync disks, writes are flushed through to the disk image");
92 printf ("%-20s %s\n", "touch", "update file timestamps or create a new file");
93 printf ("%-20s %s\n", "umount", "unmount a filesystem");
94 printf ("%-20s %s\n", "umount-all", "unmount all filesystems");
95 printf ("%-20s %s\n", "vgcreate", "create an LVM volume group");
96 printf ("%-20s %s\n", "vgs", "list the LVM volume groups (VGs)");
97 printf ("%-20s %s\n", "vgs-full", "list the LVM volume groups (VGs)");
98 printf ("%-20s %s\n", "write-file", "create a file");
99 printf (" Use -h <cmd> / help <cmd> to show detailed help for a command.\n");
102 void display_command (const char *cmd)
104 if (strcasecmp (cmd, "launch") == 0 || strcasecmp (cmd, "run") == 0)
105 pod2text ("launch - launch the qemu subprocess", " launch\n\nInternally libguestfs is implemented by running a virtual machine\nusing L<qemu(1)>.\n\nYou should call this after configuring the handle\n(eg. adding drives) but before performing any actions.\n\nYou can use 'run' as an alias for this command.");
107 if (strcasecmp (cmd, "kill_subprocess") == 0 || strcasecmp (cmd, "kill-subprocess") == 0)
108 pod2text ("kill-subprocess - kill the qemu subprocess", " kill-subprocess\n\nThis kills the qemu subprocess. You should never need to call this.");
110 if (strcasecmp (cmd, "add_drive") == 0 || strcasecmp (cmd, "add-drive") == 0 || strcasecmp (cmd, "add") == 0)
111 pod2text ("add-drive - add an image to examine or modify", " add-drive <filename>\n\nThis function adds a virtual machine disk image C<filename> to the\nguest. The first time you call this function, the disk appears as IDE\ndisk 0 (C</dev/sda>) in the guest, the second time as C</dev/sdb>, and\nso on.\n\nYou don't necessarily need to be root when using libguestfs. However\nyou obviously do need sufficient permissions to access the filename\nfor whatever operations you want to perform (ie. read access if you\njust want to read the image or write access if you want to modify the\nimage).\n\nThis is equivalent to the qemu parameter C<-drive file=filename>.\n\nYou can use 'add' as an alias for this command.");
113 if (strcasecmp (cmd, "add_cdrom") == 0 || strcasecmp (cmd, "add-cdrom") == 0 || strcasecmp (cmd, "cdrom") == 0)
114 pod2text ("add-cdrom - add a CD-ROM disk image to examine", " add-cdrom <filename>\n\nThis function adds a virtual CD-ROM disk image to the guest.\n\nThis is equivalent to the qemu parameter C<-cdrom filename>.\n\nYou can use 'cdrom' as an alias for this command.");
116 if (strcasecmp (cmd, "config") == 0)
117 pod2text ("config - add qemu parameters", " config <qemuparam> <qemuvalue>\n\nThis can be used to add arbitrary qemu command line parameters\nof the form C<-param value>. Actually it's not quite arbitrary - we\nprevent you from setting some parameters which would interfere with\nparameters that we use.\n\nThe first character of C<param> string must be a C<-> (dash).\n\nC<value> can be NULL.");
119 if (strcasecmp (cmd, "set_path") == 0 || strcasecmp (cmd, "set-path") == 0 || strcasecmp (cmd, "path") == 0)
120 pod2text ("set-path - set the search path", " set-path <path>\n\nSet the path that libguestfs searches for kernel and initrd.img.\n\nThe default is C<$libdir/guestfs> unless overridden by setting\nC<LIBGUESTFS_PATH> environment variable.\n\nThe string C<path> is stashed in the libguestfs handle, so the caller\nmust make sure it remains valid for the lifetime of the handle.\n\nSetting C<path> to C<NULL> restores the default path.\n\nYou can use 'path' as an alias for this command.");
122 if (strcasecmp (cmd, "get_path") == 0 || strcasecmp (cmd, "get-path") == 0)
123 pod2text ("get-path - get the search path", " get-path\n\nReturn the current search path.\n\nThis is always non-NULL. If it wasn't set already, then this will\nreturn the default path.");
125 if (strcasecmp (cmd, "set_autosync") == 0 || strcasecmp (cmd, "set-autosync") == 0 || strcasecmp (cmd, "autosync") == 0)
126 pod2text ("set-autosync - set autosync mode", " set-autosync <autosync>\n\nIf C<autosync> is true, this enables autosync. Libguestfs will make a\nbest effort attempt to run C<sync> when the handle is closed\n(also if the program exits without closing handles).\n\nYou can use 'autosync' as an alias for this command.");
128 if (strcasecmp (cmd, "get_autosync") == 0 || strcasecmp (cmd, "get-autosync") == 0)
129 pod2text ("get-autosync - get autosync mode", " get-autosync\n\nGet the autosync flag.");
131 if (strcasecmp (cmd, "set_verbose") == 0 || strcasecmp (cmd, "set-verbose") == 0 || strcasecmp (cmd, "verbose") == 0)
132 pod2text ("set-verbose - set verbose mode", " set-verbose <verbose>\n\nIf C<verbose> is true, this turns on verbose messages (to C<stderr>).\n\nVerbose messages are disabled unless the environment variable\nC<LIBGUESTFS_DEBUG> is defined and set to C<1>.\n\nYou can use 'verbose' as an alias for this command.");
134 if (strcasecmp (cmd, "get_verbose") == 0 || strcasecmp (cmd, "get-verbose") == 0)
135 pod2text ("get-verbose - get verbose mode", " get-verbose\n\nThis returns the verbose messages flag.");
137 if (strcasecmp (cmd, "mount") == 0)
138 pod2text ("mount - mount a guest disk at a position in the filesystem", " mount <device> <mountpoint>\n\nMount a guest disk at a position in the filesystem. Block devices\nare named C</dev/sda>, C</dev/sdb> and so on, as they were added to\nthe guest. If those block devices contain partitions, they will have\nthe usual names (eg. C</dev/sda1>). Also LVM C</dev/VG/LV>-style\nnames can be used.\n\nThe rules are the same as for L<mount(2)>: A filesystem must\nfirst be mounted on C</> before others can be mounted. Other\nfilesystems can only be mounted on directories which already\nexist.\n\nThe mounted filesystem is writable, if we have sufficient permissions\non the underlying device.\n\nThe filesystem options C<sync> and C<noatime> are set with this\ncall, in order to improve reliability.");
140 if (strcasecmp (cmd, "sync") == 0)
141 pod2text ("sync - sync disks, writes are flushed through to the disk image", " sync\n\nThis syncs the disk, so that any writes are flushed through to the\nunderlying disk image.\n\nYou should always call this if you have modified a disk image, before\nclosing the handle.");
143 if (strcasecmp (cmd, "touch") == 0)
144 pod2text ("touch - update file timestamps or create a new file", " touch <path>\n\nTouch acts like the L<touch(1)> command. It can be used to\nupdate the timestamps on a file, or, if the file does not exist,\nto create a new zero-length file.");
146 if (strcasecmp (cmd, "cat") == 0)
147 pod2text ("cat - list the contents of a file", " cat <path>\n\nReturn the contents of the file named C<path>.\n\nNote that this function cannot correctly handle binary files\n(specifically, files containing C<\\0> character which is treated\nas end of string). For those you need to use the C<read_file>\nfunction which has a more complex interface.\n\nBecause of the message protocol, there is a transfer limit \nof somewhere between 2MB and 4MB. To transfer large files you should use\nFTP.");
149 if (strcasecmp (cmd, "ll") == 0)
150 pod2text ("ll - list the files in a directory (long format)", " ll <directory>\n\nList the files in C<directory> (relative to the root directory,\nthere is no cwd) in the format of 'ls -la'.\n\nThis command is mostly useful for interactive sessions. It\nis I<not> intended that you try to parse the output string.");
152 if (strcasecmp (cmd, "ls") == 0)
153 pod2text ("ls - list the files in a directory", " ls <directory>\n\nList the files in C<directory> (relative to the root directory,\nthere is no cwd). The '.' and '..' entries are not returned, but\nhidden files are shown.\n\nThis command is mostly useful for interactive sessions. Programs\nshould probably use C<readdir> instead.");
155 if (strcasecmp (cmd, "list_devices") == 0 || strcasecmp (cmd, "list-devices") == 0)
156 pod2text ("list-devices - list the block devices", " list-devices\n\nList all the block devices.\n\nThe full block device names are returned, eg. C</dev/sda>");
158 if (strcasecmp (cmd, "list_partitions") == 0 || strcasecmp (cmd, "list-partitions") == 0)
159 pod2text ("list-partitions - list the partitions", " list-partitions\n\nList all the partitions detected on all block devices.\n\nThe full partition device names are returned, eg. C</dev/sda1>\n\nThis does not return logical volumes. For that you will need to\ncall C<lvs>.");
161 if (strcasecmp (cmd, "pvs") == 0)
162 pod2text ("pvs - list the LVM physical volumes (PVs)", " pvs\n\nList all the physical volumes detected. This is the equivalent\nof the L<pvs(8)> command.\n\nThis returns a list of just the device names that contain\nPVs (eg. C</dev/sda2>).\n\nSee also C<pvs_full>.");
164 if (strcasecmp (cmd, "vgs") == 0)
165 pod2text ("vgs - list the LVM volume groups (VGs)", " vgs\n\nList all the volumes groups detected. This is the equivalent\nof the L<vgs(8)> command.\n\nThis returns a list of just the volume group names that were\ndetected (eg. C<VolGroup00>).\n\nSee also C<vgs_full>.");
167 if (strcasecmp (cmd, "lvs") == 0)
168 pod2text ("lvs - list the LVM logical volumes (LVs)", " lvs\n\nList all the logical volumes detected. This is the equivalent\nof the L<lvs(8)> command.\n\nThis returns a list of the logical volume device names\n(eg. C</dev/VolGroup00/LogVol00>).\n\nSee also C<lvs_full>.");
170 if (strcasecmp (cmd, "pvs_full") == 0 || strcasecmp (cmd, "pvs-full") == 0)
171 pod2text ("pvs-full - list the LVM physical volumes (PVs)", " pvs-full\n\nList all the physical volumes detected. This is the equivalent\nof the L<pvs(8)> command. The \"full\" version includes all fields.");
173 if (strcasecmp (cmd, "vgs_full") == 0 || strcasecmp (cmd, "vgs-full") == 0)
174 pod2text ("vgs-full - list the LVM volume groups (VGs)", " vgs-full\n\nList all the volumes groups detected. This is the equivalent\nof the L<vgs(8)> command. The \"full\" version includes all fields.");
176 if (strcasecmp (cmd, "lvs_full") == 0 || strcasecmp (cmd, "lvs-full") == 0)
177 pod2text ("lvs-full - list the LVM logical volumes (LVs)", " lvs-full\n\nList all the logical volumes detected. This is the equivalent\nof the L<lvs(8)> command. The \"full\" version includes all fields.");
179 if (strcasecmp (cmd, "read_lines") == 0 || strcasecmp (cmd, "read-lines") == 0)
180 pod2text ("read-lines - read file as lines", " read-lines <path>\n\nReturn the contents of the file named C<path>.\n\nThe file contents are returned as a list of lines. Trailing\nC<LF> and C<CRLF> character sequences are I<not> returned.\n\nNote that this function cannot correctly handle binary files\n(specifically, files containing C<\\0> character which is treated\nas end of line). For those you need to use the C<read_file>\nfunction which has a more complex interface.");
182 if (strcasecmp (cmd, "aug_init") == 0 || strcasecmp (cmd, "aug-init") == 0)
183 pod2text ("aug-init - create a new Augeas handle", " aug-init <root> <flags>\n\nCreate a new Augeas handle for editing configuration files.\nIf there was any previous Augeas handle associated with this\nguestfs session, then it is closed.\n\nYou must call this before using any other C<aug_*>\ncommands.\n\nC<root> is the filesystem root. C<root> must not be NULL,\nuse C</> instead.\n\nThe flags are the same as the flags defined in\nE<lt>augeas.hE<gt>, the logical I<or> of the following\nintegers:\n\n=over 4\n\n=item C<AUG_SAVE_BACKUP> = 1\n\nKeep the original file with a C<.augsave> extension.\n\n=item C<AUG_SAVE_NEWFILE> = 2\n\nSave changes into a file with extension C<.augnew>, and\ndo not overwrite original. Overrides C<AUG_SAVE_BACKUP>.\n\n=item C<AUG_TYPE_CHECK> = 4\n\nTypecheck lenses (can be expensive).\n\n=item C<AUG_NO_STDINC> = 8\n\nDo not use standard load path for modules.\n\n=item C<AUG_SAVE_NOOP> = 16\n\nMake save a no-op, just record what would have been changed.\n\n=item C<AUG_NO_LOAD> = 32\n\nDo not load the tree in C<aug_init>.\n\n=back\n\nTo close the handle, you can call C<aug_close>.\n\nTo find out more about Augeas, see L<http://augeas.net/>.");
185 if (strcasecmp (cmd, "aug_close") == 0 || strcasecmp (cmd, "aug-close") == 0)
186 pod2text ("aug-close - close the current Augeas handle", " aug-close\n\nClose the current Augeas handle and free up any resources\nused by it. After calling this, you have to call\nC<aug_init> again before you can use any other\nAugeas functions.");
188 if (strcasecmp (cmd, "aug_defvar") == 0 || strcasecmp (cmd, "aug-defvar") == 0)
189 pod2text ("aug-defvar - define an Augeas variable", " aug-defvar <name> <expr>\n\nDefines an Augeas variable C<name> whose value is the result\nof evaluating C<expr>. If C<expr> is NULL, then C<name> is\nundefined.\n\nOn success this returns the number of nodes in C<expr>, or\nC<0> if C<expr> evaluates to something which is not a nodeset.");
191 if (strcasecmp (cmd, "aug_defnode") == 0 || strcasecmp (cmd, "aug-defnode") == 0)
192 pod2text ("aug-defnode - define an Augeas node", " aug-defnode <name> <expr> <val>\n\nDefines a variable C<name> whose value is the result of\nevaluating C<expr>.\n\nIf C<expr> evaluates to an empty nodeset, a node is created,\nequivalent to calling C<aug_set> C<expr>, C<value>.\nC<name> will be the nodeset containing that single node.\n\nOn success this returns a pair containing the\nnumber of nodes in the nodeset, and a boolean flag\nif a node was created.");
194 if (strcasecmp (cmd, "aug_get") == 0 || strcasecmp (cmd, "aug-get") == 0)
195 pod2text ("aug-get - look up the value of an Augeas path", " aug-get <path>\n\nLook up the value associated with C<path>. If C<path>\nmatches exactly one node, the C<value> is returned.");
197 if (strcasecmp (cmd, "aug_set") == 0 || strcasecmp (cmd, "aug-set") == 0)
198 pod2text ("aug-set - set Augeas path to value", " aug-set <path> <val>\n\nSet the value associated with C<path> to C<value>.");
200 if (strcasecmp (cmd, "aug_insert") == 0 || strcasecmp (cmd, "aug-insert") == 0)
201 pod2text ("aug-insert - insert a sibling Augeas node", " aug-insert <path> <label> <before>\n\nCreate a new sibling C<label> for C<path>, inserting it into\nthe tree before or after C<path> (depending on the boolean\nflag C<before>).\n\nC<path> must match exactly one existing node in the tree, and\nC<label> must be a label, ie. not contain C</>, C<*> or end\nwith a bracketed index C<[N]>.");
203 if (strcasecmp (cmd, "aug_rm") == 0 || strcasecmp (cmd, "aug-rm") == 0)
204 pod2text ("aug-rm - remove an Augeas path", " aug-rm <path>\n\nRemove C<path> and all of its children.\n\nOn success this returns the number of entries which were removed.");
206 if (strcasecmp (cmd, "aug_mv") == 0 || strcasecmp (cmd, "aug-mv") == 0)
207 pod2text ("aug-mv - move Augeas node", " aug-mv <src> <dest>\n\nMove the node C<src> to C<dest>. C<src> must match exactly\none node. C<dest> is overwritten if it exists.");
209 if (strcasecmp (cmd, "aug_match") == 0 || strcasecmp (cmd, "aug-match") == 0)
210 pod2text ("aug-match - return Augeas nodes which match path", " aug-match <path>\n\nReturns a list of paths which match the path expression C<path>.\nThe returned paths are sufficiently qualified so that they match\nexactly one node in the current tree.");
212 if (strcasecmp (cmd, "aug_save") == 0 || strcasecmp (cmd, "aug-save") == 0)
213 pod2text ("aug-save - write all pending Augeas changes to disk", " aug-save\n\nThis writes all pending changes to disk.\n\nThe flags which were passed to C<aug_init> affect exactly\nhow files are saved.");
215 if (strcasecmp (cmd, "aug_load") == 0 || strcasecmp (cmd, "aug-load") == 0)
216 pod2text ("aug-load - load files into the tree", " aug-load\n\nLoad files into the tree.\n\nSee C<aug_load> in the Augeas documentation for the full gory\ndetails.");
218 if (strcasecmp (cmd, "aug_ls") == 0 || strcasecmp (cmd, "aug-ls") == 0)
219 pod2text ("aug-ls - list Augeas nodes under a path", " aug-ls <path>\n\nThis is just a shortcut for listing C<aug_match>\nC<path/*> and sorting the resulting nodes into alphabetical order.");
221 if (strcasecmp (cmd, "rm") == 0)
222 pod2text ("rm - remove a file", " rm <path>\n\nRemove the single file C<path>.");
224 if (strcasecmp (cmd, "rmdir") == 0)
225 pod2text ("rmdir - remove a directory", " rmdir <path>\n\nRemove the single directory C<path>.");
227 if (strcasecmp (cmd, "rm_rf") == 0 || strcasecmp (cmd, "rm-rf") == 0)
228 pod2text ("rm-rf - remove a file or directory recursively", " rm-rf <path>\n\nRemove the file or directory C<path>, recursively removing the\ncontents if its a directory. This is like the C<rm -rf> shell\ncommand.");
230 if (strcasecmp (cmd, "mkdir") == 0)
231 pod2text ("mkdir - create a directory", " mkdir <path>\n\nCreate a directory named C<path>.");
233 if (strcasecmp (cmd, "mkdir_p") == 0 || strcasecmp (cmd, "mkdir-p") == 0)
234 pod2text ("mkdir-p - create a directory and parents", " mkdir-p <path>\n\nCreate a directory named C<path>, creating any parent directories\nas necessary. This is like the C<mkdir -p> shell command.");
236 if (strcasecmp (cmd, "chmod") == 0)
237 pod2text ("chmod - change file mode", " chmod <mode> <path>\n\nChange the mode (permissions) of C<path> to C<mode>. Only\nnumeric modes are supported.");
239 if (strcasecmp (cmd, "chown") == 0)
240 pod2text ("chown - change file owner and group", " chown <owner> <group> <path>\n\nChange the file owner to C<owner> and group to C<group>.\n\nOnly numeric uid and gid are supported. If you want to use\nnames, you will need to locate and parse the password file\nyourself (Augeas support makes this relatively easy).");
242 if (strcasecmp (cmd, "exists") == 0)
243 pod2text ("exists - test if file or directory exists", " exists <path>\n\nThis returns C<true> if and only if there is a file, directory\n(or anything) with the given C<path> name.\n\nSee also C<is_file>, C<is_dir>, C<stat>.");
245 if (strcasecmp (cmd, "is_file") == 0 || strcasecmp (cmd, "is-file") == 0)
246 pod2text ("is-file - test if file exists", " is-file <path>\n\nThis returns C<true> if and only if there is a file\nwith the given C<path> name. Note that it returns false for\nother objects like directories.\n\nSee also C<stat>.");
248 if (strcasecmp (cmd, "is_dir") == 0 || strcasecmp (cmd, "is-dir") == 0)
249 pod2text ("is-dir - test if file exists", " is-dir <path>\n\nThis returns C<true> if and only if there is a directory\nwith the given C<path> name. Note that it returns false for\nother objects like files.\n\nSee also C<stat>.");
251 if (strcasecmp (cmd, "pvcreate") == 0)
252 pod2text ("pvcreate - create an LVM physical volume", " pvcreate <device>\n\nThis creates an LVM physical volume on the named C<device>,\nwhere C<device> should usually be a partition name such\nas C</dev/sda1>.");
254 if (strcasecmp (cmd, "vgcreate") == 0)
255 pod2text ("vgcreate - create an LVM volume group", " vgcreate <volgroup> <physvols>\n\nThis creates an LVM volume group called C<volgroup>\nfrom the non-empty list of physical volumes C<physvols>.");
257 if (strcasecmp (cmd, "lvcreate") == 0)
258 pod2text ("lvcreate - create an LVM volume group", " lvcreate <logvol> <volgroup> <mbytes>\n\nThis creates an LVM volume group called C<logvol>\non the volume group C<volgroup>, with C<size> megabytes.");
260 if (strcasecmp (cmd, "mkfs") == 0)
261 pod2text ("mkfs - make a filesystem", " mkfs <fstype> <device>\n\nThis creates a filesystem on C<device> (usually a partition\nof LVM logical volume). The filesystem type is C<fstype>, for\nexample C<ext3>.");
263 if (strcasecmp (cmd, "sfdisk") == 0)
264 pod2text ("sfdisk - create partitions on a block device", " sfdisk <device> <cyls> <heads> <sectors> <lines>\n\nThis is a direct interface to the L<sfdisk(8)> program for creating\npartitions on block devices.\n\nC<device> should be a block device, for example C</dev/sda>.\n\nC<cyls>, C<heads> and C<sectors> are the number of cylinders, heads\nand sectors on the device, which are passed directly to sfdisk as\nthe I<-C>, I<-H> and I<-S> parameters. If you pass C<0> for any\nof these, then the corresponding parameter is omitted. Usually for\n'large' disks, you can just pass C<0> for these, but for small\n(floppy-sized) disks, sfdisk (or rather, the kernel) cannot work\nout the right geometry and you will need to tell it.\n\nC<lines> is a list of lines that we feed to C<sfdisk>. For more\ninformation refer to the L<sfdisk(8)> manpage.\n\nTo create a single partition occupying the whole disk, you would\npass C<lines> as a single element list, when the single element being\nthe string C<,> (comma).\n\nB<This command is dangerous. Without careful use you\ncan easily destroy all your data>.");
266 if (strcasecmp (cmd, "write_file") == 0 || strcasecmp (cmd, "write-file") == 0)
267 pod2text ("write-file - create a file", " write-file <path> <content> <size>\n\nThis call creates a file called C<path>. The contents of the\nfile is the string C<content> (which can contain any 8 bit data),\nwith length C<size>.\n\nAs a special case, if C<size> is C<0>\nthen the length is calculated using C<strlen> (so in this case\nthe content cannot contain embedded ASCII NULs).\n\nBecause of the message protocol, there is a transfer limit \nof somewhere between 2MB and 4MB. To transfer large files you should use\nFTP.");
269 if (strcasecmp (cmd, "umount") == 0 || strcasecmp (cmd, "unmount") == 0)
270 pod2text ("umount - unmount a filesystem", " umount <pathordevice>\n\nThis unmounts the given filesystem. The filesystem may be\nspecified either by its mountpoint (path) or the device which\ncontains the filesystem.\n\nYou can use 'unmount' as an alias for this command.");
272 if (strcasecmp (cmd, "mounts") == 0)
273 pod2text ("mounts - show mounted filesystems", " mounts\n\nThis returns the list of currently mounted filesystems. It returns\nthe list of devices (eg. C</dev/sda1>, C</dev/VG/LV>).\n\nSome internal mounts are not shown.");
275 if (strcasecmp (cmd, "umount_all") == 0 || strcasecmp (cmd, "umount-all") == 0 || strcasecmp (cmd, "unmount-all") == 0)
276 pod2text ("umount-all - unmount all filesystems", " umount-all\n\nThis unmounts all mounted filesystems.\n\nSome internal mounts are not unmounted by this call.\n\nYou can use 'unmount-all' as an alias for this command.");
278 if (strcasecmp (cmd, "lvm_remove_all") == 0 || strcasecmp (cmd, "lvm-remove-all") == 0)
279 pod2text ("lvm-remove-all - remove all LVM LVs, VGs and PVs", " lvm-remove-all\n\nThis command removes all LVM logical volumes, volume groups\nand physical volumes.\n\nB<This command is dangerous. Without careful use you\ncan easily destroy all your data>.");
281 if (strcasecmp (cmd, "file") == 0)
282 pod2text ("file - determine file type", " file <path>\n\nThis call uses the standard L<file(1)> command to determine\nthe type or contents of the file. This also works on devices,\nfor example to find out whether a partition contains a filesystem.\n\nThe exact command which runs is C<file -bsL path>. Note in\nparticular that the filename is not prepended to the output\n(the C<-b> option).");
284 if (strcasecmp (cmd, "command") == 0)
285 pod2text ("command - run a command from the guest filesystem", " command <arguments>\n\nThis call runs a command from the guest filesystem. The\nfilesystem must be mounted, and must contain a compatible\noperating system (ie. something Linux, with the same\nor compatible processor architecture).\n\nThe single parameter is an argv-style list of arguments.\nThe first element is the name of the program to run.\nSubsequent elements are parameters. The list must be\nnon-empty (ie. must contain a program name).\n\nThe C<$PATH> environment variable will contain at least\nC</usr/bin> and C</bin>. If you require a program from\nanother location, you should provide the full path in the\nfirst parameter.\n\nShared libraries and data files required by the program\nmust be available on filesystems which are mounted in the\ncorrect places. It is the caller's responsibility to ensure\nall filesystems that are needed are mounted at the right\nlocations.");
287 if (strcasecmp (cmd, "command_lines") == 0 || strcasecmp (cmd, "command-lines") == 0)
288 pod2text ("command-lines - run a command, returning lines", " command-lines <arguments>\n\nThis is the same as C<command>, but splits the\nresult into a list of lines.");
290 if (strcasecmp (cmd, "stat") == 0)
291 pod2text ("stat - get file information", " stat <path>\n\nReturns file information for the given C<path>.\n\nThis is the same as the C<stat(2)> system call.");
293 if (strcasecmp (cmd, "lstat") == 0)
294 pod2text ("lstat - get file information for a symbolic link", " lstat <path>\n\nReturns file information for the given C<path>.\n\nThis is the same as C<stat> except that if C<path>\nis a symbolic link, then the link is stat-ed, not the file it\nrefers to.\n\nThis is the same as the C<lstat(2)> system call.");
296 if (strcasecmp (cmd, "statvfs") == 0)
297 pod2text ("statvfs - get file system statistics", " statvfs <path>\n\nReturns file system statistics for any mounted file system.\nC<path> should be a file or directory in the mounted file system\n(typically it is the mount point itself, but it doesn't need to be).\n\nThis is the same as the C<statvfs(2)> system call.");
299 display_builtin_command (cmd);
302 static void print_pv (struct guestfs_lvm_pv *pv)
306 printf ("pv_name: %s\n", pv->pv_name);
307 printf ("pv_uuid: ");
308 for (i = 0; i < 32; ++i)
309 printf ("%c", pv->pv_uuid[i]);
311 printf ("pv_fmt: %s\n", pv->pv_fmt);
312 printf ("pv_size: %" PRIu64 "\n", pv->pv_size);
313 printf ("dev_size: %" PRIu64 "\n", pv->dev_size);
314 printf ("pv_free: %" PRIu64 "\n", pv->pv_free);
315 printf ("pv_used: %" PRIu64 "\n", pv->pv_used);
316 printf ("pv_attr: %s\n", pv->pv_attr);
317 printf ("pv_pe_count: %" PRIi64 "\n", pv->pv_pe_count);
318 printf ("pv_pe_alloc_count: %" PRIi64 "\n", pv->pv_pe_alloc_count);
319 printf ("pv_tags: %s\n", pv->pv_tags);
320 printf ("pe_start: %" PRIu64 "\n", pv->pe_start);
321 printf ("pv_mda_count: %" PRIi64 "\n", pv->pv_mda_count);
322 printf ("pv_mda_free: %" PRIu64 "\n", pv->pv_mda_free);
325 static void print_pv_list (struct guestfs_lvm_pv_list *pvs)
329 for (i = 0; i < pvs->len; ++i)
330 print_pv (&pvs->val[i]);
333 static void print_vg (struct guestfs_lvm_vg *vg)
337 printf ("vg_name: %s\n", vg->vg_name);
338 printf ("vg_uuid: ");
339 for (i = 0; i < 32; ++i)
340 printf ("%c", vg->vg_uuid[i]);
342 printf ("vg_fmt: %s\n", vg->vg_fmt);
343 printf ("vg_attr: %s\n", vg->vg_attr);
344 printf ("vg_size: %" PRIu64 "\n", vg->vg_size);
345 printf ("vg_free: %" PRIu64 "\n", vg->vg_free);
346 printf ("vg_sysid: %s\n", vg->vg_sysid);
347 printf ("vg_extent_size: %" PRIu64 "\n", vg->vg_extent_size);
348 printf ("vg_extent_count: %" PRIi64 "\n", vg->vg_extent_count);
349 printf ("vg_free_count: %" PRIi64 "\n", vg->vg_free_count);
350 printf ("max_lv: %" PRIi64 "\n", vg->max_lv);
351 printf ("max_pv: %" PRIi64 "\n", vg->max_pv);
352 printf ("pv_count: %" PRIi64 "\n", vg->pv_count);
353 printf ("lv_count: %" PRIi64 "\n", vg->lv_count);
354 printf ("snap_count: %" PRIi64 "\n", vg->snap_count);
355 printf ("vg_seqno: %" PRIi64 "\n", vg->vg_seqno);
356 printf ("vg_tags: %s\n", vg->vg_tags);
357 printf ("vg_mda_count: %" PRIi64 "\n", vg->vg_mda_count);
358 printf ("vg_mda_free: %" PRIu64 "\n", vg->vg_mda_free);
361 static void print_vg_list (struct guestfs_lvm_vg_list *vgs)
365 for (i = 0; i < vgs->len; ++i)
366 print_vg (&vgs->val[i]);
369 static void print_lv (struct guestfs_lvm_lv *lv)
373 printf ("lv_name: %s\n", lv->lv_name);
374 printf ("lv_uuid: ");
375 for (i = 0; i < 32; ++i)
376 printf ("%c", lv->lv_uuid[i]);
378 printf ("lv_attr: %s\n", lv->lv_attr);
379 printf ("lv_major: %" PRIi64 "\n", lv->lv_major);
380 printf ("lv_minor: %" PRIi64 "\n", lv->lv_minor);
381 printf ("lv_kernel_major: %" PRIi64 "\n", lv->lv_kernel_major);
382 printf ("lv_kernel_minor: %" PRIi64 "\n", lv->lv_kernel_minor);
383 printf ("lv_size: %" PRIu64 "\n", lv->lv_size);
384 printf ("seg_count: %" PRIi64 "\n", lv->seg_count);
385 printf ("origin: %s\n", lv->origin);
386 if (lv->snap_percent >= 0) printf ("snap_percent: %g %%\n", lv->snap_percent);
387 else printf ("snap_percent: \n");
388 if (lv->copy_percent >= 0) printf ("copy_percent: %g %%\n", lv->copy_percent);
389 else printf ("copy_percent: \n");
390 printf ("move_pv: %s\n", lv->move_pv);
391 printf ("lv_tags: %s\n", lv->lv_tags);
392 printf ("mirror_log: %s\n", lv->mirror_log);
393 printf ("modules: %s\n", lv->modules);
396 static void print_lv_list (struct guestfs_lvm_lv_list *lvs)
400 for (i = 0; i < lvs->len; ++i)
401 print_lv (&lvs->val[i]);
404 static void print_stat (struct guestfs_stat *stat)
406 printf ("dev: %" PRIi64 "\n", stat->dev);
407 printf ("ino: %" PRIi64 "\n", stat->ino);
408 printf ("mode: %" PRIi64 "\n", stat->mode);
409 printf ("nlink: %" PRIi64 "\n", stat->nlink);
410 printf ("uid: %" PRIi64 "\n", stat->uid);
411 printf ("gid: %" PRIi64 "\n", stat->gid);
412 printf ("rdev: %" PRIi64 "\n", stat->rdev);
413 printf ("size: %" PRIi64 "\n", stat->size);
414 printf ("blksize: %" PRIi64 "\n", stat->blksize);
415 printf ("blocks: %" PRIi64 "\n", stat->blocks);
416 printf ("atime: %" PRIi64 "\n", stat->atime);
417 printf ("mtime: %" PRIi64 "\n", stat->mtime);
418 printf ("ctime: %" PRIi64 "\n", stat->ctime);
421 static void print_statvfs (struct guestfs_statvfs *statvfs)
423 printf ("bsize: %" PRIi64 "\n", statvfs->bsize);
424 printf ("frsize: %" PRIi64 "\n", statvfs->frsize);
425 printf ("blocks: %" PRIi64 "\n", statvfs->blocks);
426 printf ("bfree: %" PRIi64 "\n", statvfs->bfree);
427 printf ("bavail: %" PRIi64 "\n", statvfs->bavail);
428 printf ("files: %" PRIi64 "\n", statvfs->files);
429 printf ("ffree: %" PRIi64 "\n", statvfs->ffree);
430 printf ("favail: %" PRIi64 "\n", statvfs->favail);
431 printf ("fsid: %" PRIi64 "\n", statvfs->fsid);
432 printf ("flag: %" PRIi64 "\n", statvfs->flag);
433 printf ("namemax: %" PRIi64 "\n", statvfs->namemax);
436 static int run_launch (const char *cmd, int argc, char *argv[])
440 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
441 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
448 static int run_kill_subprocess (const char *cmd, int argc, char *argv[])
452 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
453 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
456 r = guestfs_kill_subprocess (g);
460 static int run_add_drive (const char *cmd, int argc, char *argv[])
463 const char *filename;
465 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
466 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
470 r = guestfs_add_drive (g, filename);
474 static int run_add_cdrom (const char *cmd, int argc, char *argv[])
477 const char *filename;
479 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
480 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
484 r = guestfs_add_cdrom (g, filename);
488 static int run_config (const char *cmd, int argc, char *argv[])
491 const char *qemuparam;
492 const char *qemuvalue;
494 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
495 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
499 qemuvalue = strcmp (argv[1], "") != 0 ? argv[1] : NULL;
500 r = guestfs_config (g, qemuparam, qemuvalue);
504 static int run_set_path (const char *cmd, int argc, char *argv[])
509 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
510 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
514 r = guestfs_set_path (g, path);
518 static int run_get_path (const char *cmd, int argc, char *argv[])
522 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
523 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
526 r = guestfs_get_path (g);
527 if (r == NULL) return -1;
532 static int run_set_autosync (const char *cmd, int argc, char *argv[])
537 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
538 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
541 autosync = is_true (argv[0]) ? 1 : 0;
542 r = guestfs_set_autosync (g, autosync);
546 static int run_get_autosync (const char *cmd, int argc, char *argv[])
550 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
551 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
554 r = guestfs_get_autosync (g);
555 if (r == -1) return -1;
556 if (r) printf ("true\n"); else printf ("false\n");
560 static int run_set_verbose (const char *cmd, int argc, char *argv[])
565 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
566 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
569 verbose = is_true (argv[0]) ? 1 : 0;
570 r = guestfs_set_verbose (g, verbose);
574 static int run_get_verbose (const char *cmd, int argc, char *argv[])
578 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
579 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
582 r = guestfs_get_verbose (g);
583 if (r == -1) return -1;
584 if (r) printf ("true\n"); else printf ("false\n");
588 static int run_mount (const char *cmd, int argc, char *argv[])
592 const char *mountpoint;
594 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
595 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
599 mountpoint = argv[1];
600 r = guestfs_mount (g, device, mountpoint);
604 static int run_sync (const char *cmd, int argc, char *argv[])
608 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
609 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
612 r = guestfs_sync (g);
616 static int run_touch (const char *cmd, int argc, char *argv[])
621 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
622 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
626 r = guestfs_touch (g, path);
630 static int run_cat (const char *cmd, int argc, char *argv[])
635 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
636 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
640 r = guestfs_cat (g, path);
641 if (r == NULL) return -1;
647 static int run_ll (const char *cmd, int argc, char *argv[])
650 const char *directory;
652 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
653 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
657 r = guestfs_ll (g, directory);
658 if (r == NULL) return -1;
664 static int run_ls (const char *cmd, int argc, char *argv[])
667 const char *directory;
669 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
670 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
674 r = guestfs_ls (g, directory);
675 if (r == NULL) return -1;
681 static int run_list_devices (const char *cmd, int argc, char *argv[])
685 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
686 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
689 r = guestfs_list_devices (g);
690 if (r == NULL) return -1;
696 static int run_list_partitions (const char *cmd, int argc, char *argv[])
700 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
701 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
704 r = guestfs_list_partitions (g);
705 if (r == NULL) return -1;
711 static int run_pvs (const char *cmd, int argc, char *argv[])
715 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
716 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
720 if (r == NULL) return -1;
726 static int run_vgs (const char *cmd, int argc, char *argv[])
730 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
731 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
735 if (r == NULL) return -1;
741 static int run_lvs (const char *cmd, int argc, char *argv[])
745 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
746 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
750 if (r == NULL) return -1;
756 static int run_pvs_full (const char *cmd, int argc, char *argv[])
758 struct guestfs_lvm_pv_list *r;
760 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
761 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
764 r = guestfs_pvs_full (g);
765 if (r == NULL) return -1;
767 guestfs_free_lvm_pv_list (r);
771 static int run_vgs_full (const char *cmd, int argc, char *argv[])
773 struct guestfs_lvm_vg_list *r;
775 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
776 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
779 r = guestfs_vgs_full (g);
780 if (r == NULL) return -1;
782 guestfs_free_lvm_vg_list (r);
786 static int run_lvs_full (const char *cmd, int argc, char *argv[])
788 struct guestfs_lvm_lv_list *r;
790 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
791 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
794 r = guestfs_lvs_full (g);
795 if (r == NULL) return -1;
797 guestfs_free_lvm_lv_list (r);
801 static int run_read_lines (const char *cmd, int argc, char *argv[])
806 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
807 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
811 r = guestfs_read_lines (g, path);
812 if (r == NULL) return -1;
818 static int run_aug_init (const char *cmd, int argc, char *argv[])
824 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
825 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
829 flags = atoi (argv[1]);
830 r = guestfs_aug_init (g, root, flags);
834 static int run_aug_close (const char *cmd, int argc, char *argv[])
838 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
839 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
842 r = guestfs_aug_close (g);
846 static int run_aug_defvar (const char *cmd, int argc, char *argv[])
852 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
853 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
857 expr = strcmp (argv[1], "") != 0 ? argv[1] : NULL;
858 r = guestfs_aug_defvar (g, name, expr);
859 if (r == -1) return -1;
860 if (r) printf ("%d\n", r);
864 static int run_aug_defnode (const char *cmd, int argc, char *argv[])
866 struct guestfs_int_bool *r;
871 fprintf (stderr, "%s should have 3 parameter(s)\n", cmd);
872 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
878 r = guestfs_aug_defnode (g, name, expr, val);
879 if (r == NULL) return -1;
880 printf ("%d, %s\n", r->i,
881 r->b ? "true" : "false");
882 guestfs_free_int_bool (r);
886 static int run_aug_get (const char *cmd, int argc, char *argv[])
891 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
892 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
896 r = guestfs_aug_get (g, path);
897 if (r == NULL) return -1;
903 static int run_aug_set (const char *cmd, int argc, char *argv[])
909 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
910 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
915 r = guestfs_aug_set (g, path, val);
919 static int run_aug_insert (const char *cmd, int argc, char *argv[])
926 fprintf (stderr, "%s should have 3 parameter(s)\n", cmd);
927 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
932 before = is_true (argv[2]) ? 1 : 0;
933 r = guestfs_aug_insert (g, path, label, before);
937 static int run_aug_rm (const char *cmd, int argc, char *argv[])
942 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
943 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
947 r = guestfs_aug_rm (g, path);
948 if (r == -1) return -1;
949 if (r) printf ("%d\n", r);
953 static int run_aug_mv (const char *cmd, int argc, char *argv[])
959 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
960 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
965 r = guestfs_aug_mv (g, src, dest);
969 static int run_aug_match (const char *cmd, int argc, char *argv[])
974 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
975 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
979 r = guestfs_aug_match (g, path);
980 if (r == NULL) return -1;
986 static int run_aug_save (const char *cmd, int argc, char *argv[])
990 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
991 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
994 r = guestfs_aug_save (g);
998 static int run_aug_load (const char *cmd, int argc, char *argv[])
1002 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
1003 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1006 r = guestfs_aug_load (g);
1010 static int run_aug_ls (const char *cmd, int argc, char *argv[])
1015 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1016 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1020 r = guestfs_aug_ls (g, path);
1021 if (r == NULL) return -1;
1027 static int run_rm (const char *cmd, int argc, char *argv[])
1032 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1033 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1037 r = guestfs_rm (g, path);
1041 static int run_rmdir (const char *cmd, int argc, char *argv[])
1046 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1047 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1051 r = guestfs_rmdir (g, path);
1055 static int run_rm_rf (const char *cmd, int argc, char *argv[])
1060 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1061 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1065 r = guestfs_rm_rf (g, path);
1069 static int run_mkdir (const char *cmd, int argc, char *argv[])
1074 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1075 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1079 r = guestfs_mkdir (g, path);
1083 static int run_mkdir_p (const char *cmd, int argc, char *argv[])
1088 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1089 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1093 r = guestfs_mkdir_p (g, path);
1097 static int run_chmod (const char *cmd, int argc, char *argv[])
1103 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
1104 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1107 mode = atoi (argv[0]);
1109 r = guestfs_chmod (g, mode, path);
1113 static int run_chown (const char *cmd, int argc, char *argv[])
1120 fprintf (stderr, "%s should have 3 parameter(s)\n", cmd);
1121 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1124 owner = atoi (argv[0]);
1125 group = atoi (argv[1]);
1127 r = guestfs_chown (g, owner, group, path);
1131 static int run_exists (const char *cmd, int argc, char *argv[])
1136 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1137 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1141 r = guestfs_exists (g, path);
1142 if (r == -1) return -1;
1143 if (r) printf ("true\n"); else printf ("false\n");
1147 static int run_is_file (const char *cmd, int argc, char *argv[])
1152 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1153 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1157 r = guestfs_is_file (g, path);
1158 if (r == -1) return -1;
1159 if (r) printf ("true\n"); else printf ("false\n");
1163 static int run_is_dir (const char *cmd, int argc, char *argv[])
1168 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1169 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1173 r = guestfs_is_dir (g, path);
1174 if (r == -1) return -1;
1175 if (r) printf ("true\n"); else printf ("false\n");
1179 static int run_pvcreate (const char *cmd, int argc, char *argv[])
1184 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1185 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1189 r = guestfs_pvcreate (g, device);
1193 static int run_vgcreate (const char *cmd, int argc, char *argv[])
1196 const char *volgroup;
1199 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
1200 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1204 physvols = parse_string_list (argv[1]);
1205 r = guestfs_vgcreate (g, volgroup, physvols);
1209 static int run_lvcreate (const char *cmd, int argc, char *argv[])
1213 const char *volgroup;
1216 fprintf (stderr, "%s should have 3 parameter(s)\n", cmd);
1217 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1222 mbytes = atoi (argv[2]);
1223 r = guestfs_lvcreate (g, logvol, volgroup, mbytes);
1227 static int run_mkfs (const char *cmd, int argc, char *argv[])
1233 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
1234 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1239 r = guestfs_mkfs (g, fstype, device);
1243 static int run_sfdisk (const char *cmd, int argc, char *argv[])
1252 fprintf (stderr, "%s should have 5 parameter(s)\n", cmd);
1253 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1257 cyls = atoi (argv[1]);
1258 heads = atoi (argv[2]);
1259 sectors = atoi (argv[3]);
1260 lines = parse_string_list (argv[4]);
1261 r = guestfs_sfdisk (g, device, cyls, heads, sectors, lines);
1265 static int run_write_file (const char *cmd, int argc, char *argv[])
1269 const char *content;
1272 fprintf (stderr, "%s should have 3 parameter(s)\n", cmd);
1273 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1278 size = atoi (argv[2]);
1279 r = guestfs_write_file (g, path, content, size);
1283 static int run_umount (const char *cmd, int argc, char *argv[])
1286 const char *pathordevice;
1288 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1289 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1292 pathordevice = argv[0];
1293 r = guestfs_umount (g, pathordevice);
1297 static int run_mounts (const char *cmd, int argc, char *argv[])
1301 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
1302 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1305 r = guestfs_mounts (g);
1306 if (r == NULL) return -1;
1312 static int run_umount_all (const char *cmd, int argc, char *argv[])
1316 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
1317 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1320 r = guestfs_umount_all (g);
1324 static int run_lvm_remove_all (const char *cmd, int argc, char *argv[])
1328 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
1329 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1332 r = guestfs_lvm_remove_all (g);
1336 static int run_file (const char *cmd, int argc, char *argv[])
1341 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1342 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1346 r = guestfs_file (g, path);
1347 if (r == NULL) return -1;
1353 static int run_command (const char *cmd, int argc, char *argv[])
1358 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1359 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1362 arguments = parse_string_list (argv[0]);
1363 r = guestfs_command (g, arguments);
1364 if (r == NULL) return -1;
1370 static int run_command_lines (const char *cmd, int argc, char *argv[])
1375 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1376 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1379 arguments = parse_string_list (argv[0]);
1380 r = guestfs_command_lines (g, arguments);
1381 if (r == NULL) return -1;
1387 static int run_stat (const char *cmd, int argc, char *argv[])
1389 struct guestfs_stat *r;
1392 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1393 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1397 r = guestfs_stat (g, path);
1398 if (r == NULL) return -1;
1404 static int run_lstat (const char *cmd, int argc, char *argv[])
1406 struct guestfs_stat *r;
1409 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1410 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1414 r = guestfs_lstat (g, path);
1415 if (r == NULL) return -1;
1421 static int run_statvfs (const char *cmd, int argc, char *argv[])
1423 struct guestfs_statvfs *r;
1426 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
1427 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
1431 r = guestfs_statvfs (g, path);
1432 if (r == NULL) return -1;
1438 int run_action (const char *cmd, int argc, char *argv[])
1440 if (strcasecmp (cmd, "launch") == 0 || strcasecmp (cmd, "run") == 0)
1441 return run_launch (cmd, argc, argv);
1443 if (strcasecmp (cmd, "kill_subprocess") == 0 || strcasecmp (cmd, "kill-subprocess") == 0)
1444 return run_kill_subprocess (cmd, argc, argv);
1446 if (strcasecmp (cmd, "add_drive") == 0 || strcasecmp (cmd, "add-drive") == 0 || strcasecmp (cmd, "add") == 0)
1447 return run_add_drive (cmd, argc, argv);
1449 if (strcasecmp (cmd, "add_cdrom") == 0 || strcasecmp (cmd, "add-cdrom") == 0 || strcasecmp (cmd, "cdrom") == 0)
1450 return run_add_cdrom (cmd, argc, argv);
1452 if (strcasecmp (cmd, "config") == 0)
1453 return run_config (cmd, argc, argv);
1455 if (strcasecmp (cmd, "set_path") == 0 || strcasecmp (cmd, "set-path") == 0 || strcasecmp (cmd, "path") == 0)
1456 return run_set_path (cmd, argc, argv);
1458 if (strcasecmp (cmd, "get_path") == 0 || strcasecmp (cmd, "get-path") == 0)
1459 return run_get_path (cmd, argc, argv);
1461 if (strcasecmp (cmd, "set_autosync") == 0 || strcasecmp (cmd, "set-autosync") == 0 || strcasecmp (cmd, "autosync") == 0)
1462 return run_set_autosync (cmd, argc, argv);
1464 if (strcasecmp (cmd, "get_autosync") == 0 || strcasecmp (cmd, "get-autosync") == 0)
1465 return run_get_autosync (cmd, argc, argv);
1467 if (strcasecmp (cmd, "set_verbose") == 0 || strcasecmp (cmd, "set-verbose") == 0 || strcasecmp (cmd, "verbose") == 0)
1468 return run_set_verbose (cmd, argc, argv);
1470 if (strcasecmp (cmd, "get_verbose") == 0 || strcasecmp (cmd, "get-verbose") == 0)
1471 return run_get_verbose (cmd, argc, argv);
1473 if (strcasecmp (cmd, "mount") == 0)
1474 return run_mount (cmd, argc, argv);
1476 if (strcasecmp (cmd, "sync") == 0)
1477 return run_sync (cmd, argc, argv);
1479 if (strcasecmp (cmd, "touch") == 0)
1480 return run_touch (cmd, argc, argv);
1482 if (strcasecmp (cmd, "cat") == 0)
1483 return run_cat (cmd, argc, argv);
1485 if (strcasecmp (cmd, "ll") == 0)
1486 return run_ll (cmd, argc, argv);
1488 if (strcasecmp (cmd, "ls") == 0)
1489 return run_ls (cmd, argc, argv);
1491 if (strcasecmp (cmd, "list_devices") == 0 || strcasecmp (cmd, "list-devices") == 0)
1492 return run_list_devices (cmd, argc, argv);
1494 if (strcasecmp (cmd, "list_partitions") == 0 || strcasecmp (cmd, "list-partitions") == 0)
1495 return run_list_partitions (cmd, argc, argv);
1497 if (strcasecmp (cmd, "pvs") == 0)
1498 return run_pvs (cmd, argc, argv);
1500 if (strcasecmp (cmd, "vgs") == 0)
1501 return run_vgs (cmd, argc, argv);
1503 if (strcasecmp (cmd, "lvs") == 0)
1504 return run_lvs (cmd, argc, argv);
1506 if (strcasecmp (cmd, "pvs_full") == 0 || strcasecmp (cmd, "pvs-full") == 0)
1507 return run_pvs_full (cmd, argc, argv);
1509 if (strcasecmp (cmd, "vgs_full") == 0 || strcasecmp (cmd, "vgs-full") == 0)
1510 return run_vgs_full (cmd, argc, argv);
1512 if (strcasecmp (cmd, "lvs_full") == 0 || strcasecmp (cmd, "lvs-full") == 0)
1513 return run_lvs_full (cmd, argc, argv);
1515 if (strcasecmp (cmd, "read_lines") == 0 || strcasecmp (cmd, "read-lines") == 0)
1516 return run_read_lines (cmd, argc, argv);
1518 if (strcasecmp (cmd, "aug_init") == 0 || strcasecmp (cmd, "aug-init") == 0)
1519 return run_aug_init (cmd, argc, argv);
1521 if (strcasecmp (cmd, "aug_close") == 0 || strcasecmp (cmd, "aug-close") == 0)
1522 return run_aug_close (cmd, argc, argv);
1524 if (strcasecmp (cmd, "aug_defvar") == 0 || strcasecmp (cmd, "aug-defvar") == 0)
1525 return run_aug_defvar (cmd, argc, argv);
1527 if (strcasecmp (cmd, "aug_defnode") == 0 || strcasecmp (cmd, "aug-defnode") == 0)
1528 return run_aug_defnode (cmd, argc, argv);
1530 if (strcasecmp (cmd, "aug_get") == 0 || strcasecmp (cmd, "aug-get") == 0)
1531 return run_aug_get (cmd, argc, argv);
1533 if (strcasecmp (cmd, "aug_set") == 0 || strcasecmp (cmd, "aug-set") == 0)
1534 return run_aug_set (cmd, argc, argv);
1536 if (strcasecmp (cmd, "aug_insert") == 0 || strcasecmp (cmd, "aug-insert") == 0)
1537 return run_aug_insert (cmd, argc, argv);
1539 if (strcasecmp (cmd, "aug_rm") == 0 || strcasecmp (cmd, "aug-rm") == 0)
1540 return run_aug_rm (cmd, argc, argv);
1542 if (strcasecmp (cmd, "aug_mv") == 0 || strcasecmp (cmd, "aug-mv") == 0)
1543 return run_aug_mv (cmd, argc, argv);
1545 if (strcasecmp (cmd, "aug_match") == 0 || strcasecmp (cmd, "aug-match") == 0)
1546 return run_aug_match (cmd, argc, argv);
1548 if (strcasecmp (cmd, "aug_save") == 0 || strcasecmp (cmd, "aug-save") == 0)
1549 return run_aug_save (cmd, argc, argv);
1551 if (strcasecmp (cmd, "aug_load") == 0 || strcasecmp (cmd, "aug-load") == 0)
1552 return run_aug_load (cmd, argc, argv);
1554 if (strcasecmp (cmd, "aug_ls") == 0 || strcasecmp (cmd, "aug-ls") == 0)
1555 return run_aug_ls (cmd, argc, argv);
1557 if (strcasecmp (cmd, "rm") == 0)
1558 return run_rm (cmd, argc, argv);
1560 if (strcasecmp (cmd, "rmdir") == 0)
1561 return run_rmdir (cmd, argc, argv);
1563 if (strcasecmp (cmd, "rm_rf") == 0 || strcasecmp (cmd, "rm-rf") == 0)
1564 return run_rm_rf (cmd, argc, argv);
1566 if (strcasecmp (cmd, "mkdir") == 0)
1567 return run_mkdir (cmd, argc, argv);
1569 if (strcasecmp (cmd, "mkdir_p") == 0 || strcasecmp (cmd, "mkdir-p") == 0)
1570 return run_mkdir_p (cmd, argc, argv);
1572 if (strcasecmp (cmd, "chmod") == 0)
1573 return run_chmod (cmd, argc, argv);
1575 if (strcasecmp (cmd, "chown") == 0)
1576 return run_chown (cmd, argc, argv);
1578 if (strcasecmp (cmd, "exists") == 0)
1579 return run_exists (cmd, argc, argv);
1581 if (strcasecmp (cmd, "is_file") == 0 || strcasecmp (cmd, "is-file") == 0)
1582 return run_is_file (cmd, argc, argv);
1584 if (strcasecmp (cmd, "is_dir") == 0 || strcasecmp (cmd, "is-dir") == 0)
1585 return run_is_dir (cmd, argc, argv);
1587 if (strcasecmp (cmd, "pvcreate") == 0)
1588 return run_pvcreate (cmd, argc, argv);
1590 if (strcasecmp (cmd, "vgcreate") == 0)
1591 return run_vgcreate (cmd, argc, argv);
1593 if (strcasecmp (cmd, "lvcreate") == 0)
1594 return run_lvcreate (cmd, argc, argv);
1596 if (strcasecmp (cmd, "mkfs") == 0)
1597 return run_mkfs (cmd, argc, argv);
1599 if (strcasecmp (cmd, "sfdisk") == 0)
1600 return run_sfdisk (cmd, argc, argv);
1602 if (strcasecmp (cmd, "write_file") == 0 || strcasecmp (cmd, "write-file") == 0)
1603 return run_write_file (cmd, argc, argv);
1605 if (strcasecmp (cmd, "umount") == 0 || strcasecmp (cmd, "unmount") == 0)
1606 return run_umount (cmd, argc, argv);
1608 if (strcasecmp (cmd, "mounts") == 0)
1609 return run_mounts (cmd, argc, argv);
1611 if (strcasecmp (cmd, "umount_all") == 0 || strcasecmp (cmd, "umount-all") == 0 || strcasecmp (cmd, "unmount-all") == 0)
1612 return run_umount_all (cmd, argc, argv);
1614 if (strcasecmp (cmd, "lvm_remove_all") == 0 || strcasecmp (cmd, "lvm-remove-all") == 0)
1615 return run_lvm_remove_all (cmd, argc, argv);
1617 if (strcasecmp (cmd, "file") == 0)
1618 return run_file (cmd, argc, argv);
1620 if (strcasecmp (cmd, "command") == 0)
1621 return run_command (cmd, argc, argv);
1623 if (strcasecmp (cmd, "command_lines") == 0 || strcasecmp (cmd, "command-lines") == 0)
1624 return run_command_lines (cmd, argc, argv);
1626 if (strcasecmp (cmd, "stat") == 0)
1627 return run_stat (cmd, argc, argv);
1629 if (strcasecmp (cmd, "lstat") == 0)
1630 return run_lstat (cmd, argc, argv);
1632 if (strcasecmp (cmd, "statvfs") == 0)
1633 return run_statvfs (cmd, argc, argv);
1636 fprintf (stderr, "%s: unknown command\n", cmd);