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.
28 void list_commands (void)
30 printf (" %-16s %s\n", "Command", "Description");
31 list_builtin_commands ();
32 printf ("%-20s %s\n", "cat", "list the contents of a file");
33 printf ("%-20s %s\n", "ll", "list the files in a directory (long format)");
34 printf ("%-20s %s\n", "ls", "list the files in a directory");
35 printf ("%-20s %s\n", "mount", "mount a guest disk at a position in the filesystem");
36 printf ("%-20s %s\n", "sync", "sync disks, writes are flushed through to the disk image");
37 printf ("%-20s %s\n", "touch", "update file timestamps or create a new file");
38 printf (" Use -h <cmd> / help <cmd> to show detailed help for a command.\n");
41 void display_command (const char *cmd)
43 if (strcasecmp (cmd, "cat") == 0)
44 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<guestfs_read>\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.");
46 if (strcasecmp (cmd, "ll") == 0)
47 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.");
49 if (strcasecmp (cmd, "ls") == 0)
50 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<guestfs_readdir> instead.");
52 if (strcasecmp (cmd, "mount") == 0)
53 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.");
55 if (strcasecmp (cmd, "sync") == 0)
56 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\ncalling C<guestfs_close>.");
58 if (strcasecmp (cmd, "touch") == 0)
59 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.");
61 display_builtin_command (cmd);
64 static int run_cat (const char *cmd, int argc, char *argv[])
69 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
70 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
74 r = guestfs_cat (g, path);
75 if (r == NULL) return -1;
81 static int run_ll (const char *cmd, int argc, char *argv[])
84 const char *directory;
86 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
87 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
91 r = guestfs_ll (g, directory);
92 if (r == NULL) return -1;
98 static int run_ls (const char *cmd, int argc, char *argv[])
101 const char *directory;
103 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
104 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
108 r = guestfs_ls (g, directory);
109 if (r == NULL) return -1;
115 static int run_mount (const char *cmd, int argc, char *argv[])
119 const char *mountpoint;
121 fprintf (stderr, "%s should have 2 parameter(s)\n", cmd);
122 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
126 mountpoint = argv[1];
127 r = guestfs_mount (g, device, mountpoint);
131 static int run_sync (const char *cmd, int argc, char *argv[])
135 fprintf (stderr, "%s should have 0 parameter(s)\n", cmd);
136 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
139 r = guestfs_sync (g);
143 static int run_touch (const char *cmd, int argc, char *argv[])
148 fprintf (stderr, "%s should have 1 parameter(s)\n", cmd);
149 fprintf (stderr, "type 'help %s' for help on %s\n", cmd, cmd);
153 r = guestfs_touch (g, path);
157 int run_action (const char *cmd, int argc, char *argv[])
159 if (strcasecmp (cmd, "cat") == 0)
160 return run_cat (cmd, argc, argv);
162 if (strcasecmp (cmd, "ll") == 0)
163 return run_ll (cmd, argc, argv);
165 if (strcasecmp (cmd, "ls") == 0)
166 return run_ls (cmd, argc, argv);
168 if (strcasecmp (cmd, "mount") == 0)
169 return run_mount (cmd, argc, argv);
171 if (strcasecmp (cmd, "sync") == 0)
172 return run_sync (cmd, argc, argv);
174 if (strcasecmp (cmd, "touch") == 0)
175 return run_touch (cmd, argc, argv);
178 fprintf (stderr, "%s: unknown command\n", cmd);