1 /* guestfish - the filesystem interactive shell
2 * Copyright (C) 2009 Red Hat Inc.
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation; either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
37 static void mount_mps (struct mp *mp);
38 static void interactive (void);
39 static void shell_script (void);
40 static void script (int prompt);
41 static void cmdline (char *argv[], int optind, int argc);
42 static int issue_command (const char *cmd, char *argv[]);
44 /* Currently open libguestfs handle. */
55 if (guestfs_launch (g) == -1)
57 if (guestfs_wait_ready (g) == -1)
68 "guestfish: guest filesystem shell\n"
69 "guestfish lets you edit virtual machine filesystems\n"
70 "Copyright (C) 2009 Red Hat Inc.\n"
72 " guestfish [--options] cmd [: cmd : cmd ...]\n"
73 "or for interactive use:\n"
75 "or from a shell script:\n"
81 " -h|--cmd-help List available commands\n"
82 " -h|--cmd-help cmd Display detailed help on 'cmd'\n"
83 " -a image Add image\n"
84 " -m dev[:mnt] Mount dev on mnt (if omitted, /)\n"
85 /*" --ro|-r All mounts are read-only\n"*/
86 " -v|--verbose Verbose messages\n"
87 "For more information, see the manpage guestfish(1).\n");
91 main (int argc, char *argv[])
93 static const char *options = "a:h::m:v?";
94 static struct option long_options[] = {
96 { "cmd-help", 2, 0, 'h' },
97 { "help", 0, 0, '?' },
98 { "mount", 1, 0, 'm' },
99 { "verbose", 0, 0, 'v' },
102 struct mp *mps = NULL;
107 /* guestfs_create is meant to be a lightweight operation, so
108 * it's OK to do it early here.
110 g = guestfs_create ();
112 fprintf (stderr, "guestfs_create: failed to create handle\n");
117 c = getopt_long (argc, argv, options, long_options, NULL);
122 if (access (optarg, R_OK) != 0) {
126 if (guestfs_add_drive (g, optarg) == -1)
132 display_command (optarg);
133 else if (argv[optind] && argv[optind][0] != '-')
134 display_command (argv[optind++]);
140 mp = malloc (sizeof (struct mp));
145 p = strchr (optarg, ':');
148 mp->mountpoint = p+1;
150 mp->mountpoint = "/";
158 guestfs_set_verbose (g, verbose);
166 fprintf (stderr, "guestfish: unexpected command line option 0x%x\n", c);
171 /* If we've got mountpoints, we must launch the guest and mount them. */
173 if (launch () == -1) exit (1);
177 /* Interactive, shell script, or command(s) on the command line? */
178 if (optind >= argc) {
185 cmdline (argv, optind, argc);
191 pod2text (const char *heading, const char *str)
195 fp = popen ("pod2text", "w");
197 /* pod2text failed, maybe not found, so let's just print the
198 * source instead, since that's better than doing nothing.
200 printf ("%s\n\n%s\n", heading, str);
203 fputs ("=head1 ", fp);
210 /* List is built in reverse order, so mount them in reverse order. */
212 mount_mps (struct mp *mp)
215 mount_mps (mp->next);
216 if (guestfs_mount (g, mp->device, mp->mountpoint) == -1)
243 "Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
244 "editing virtual machine filesystems.\n"
246 "Type: 'help' for help with commands\n"
247 " 'quit' to quit the shell\n"
251 if (prompt) printf ("><fs> ");
252 if (fgets (buf, sizeof buf, stdin) == NULL) {
258 if (len > 0 && buf[len-1] == '\n') buf[len-1] = '\0';
260 /* Split the buffer up at whitespace. */
261 cmd = strtok (buf, " \t");
266 while (i < sizeof argv / sizeof argv[0] &&
267 (argv[i] = strtok (NULL, " \t")) != NULL)
269 if (i == sizeof argv / sizeof argv[0]) {
270 fprintf (stderr, "guestfish: too many arguments in command\n");
274 (void) issue_command (cmd, argv);
276 if (prompt) printf ("\n");
280 cmdline (char *argv[], int optind, int argc)
285 if (optind >= argc) return;
287 cmd = argv[optind++];
288 if (strcmp (cmd, ":") == 0) {
289 fprintf (stderr, "guestfish: empty command on command line\n");
292 params = &argv[optind];
294 /* Search for end of command list or ":" ... */
295 while (optind < argc && strcmp (argv[optind], ":") != 0)
298 if (optind == argc) {
299 if (issue_command (cmd, params) == -1) exit (1);
302 if (issue_command (cmd, params) == -1) exit (1);
303 cmdline (argv, optind+1, argc);
308 issue_command (const char *cmd, char *argv[])
312 for (argc = 0; argv[argc] != NULL; ++argc)
315 if (strcasecmp (cmd, "help") == 0) {
319 display_command (argv[0]);
322 else if (strcasecmp (cmd, "quit") == 0 ||
323 strcasecmp (cmd, "exit") == 0 ||
324 strcasecmp (cmd, "q") == 0)
326 else if (strcasecmp (cmd, "add") == 0 ||
327 strcasecmp (cmd, "drive") == 0 ||
328 strcasecmp (cmd, "add_drive") == 0) {
330 fprintf (stderr, "use 'add image' to add a guest image\n");
334 return guestfs_add_drive (g, argv[0]);
336 else if (strcasecmp (cmd, "cdrom") == 0) {
338 fprintf (stderr, "use 'cdrom image' to add a CD-ROM image\n");
342 return guestfs_add_cdrom (g, argv[0]);
344 else if (strcasecmp (cmd, "launch") == 0) {
346 fprintf (stderr, "'launch' command takes no parameters\n");
353 return run_action (cmd, argc, argv);
357 list_builtin_commands (void)
359 printf ("%-20s %s\n",
360 "help", "display a list of commands or help on a command");
361 printf ("%-20s %s\n",
362 "quit", "quit guestfish");
363 printf ("%-20s %s\n",
364 "add", "add a guest image to be examined or modified");
365 printf ("%-20s %s\n",
366 "cdrom", "add a CD-ROM image to be examined");
367 printf ("%-20s %s\n",
368 "launch", "launch the subprocess");
372 display_builtin_command (const char *cmd)
374 if (strcasecmp (cmd, "add") == 0)
375 printf ("add - add a guest image to be examined or modified\n"
377 else if (strcasecmp (cmd, "cdrom") == 0)
378 printf ("cdrom - add a CD-ROM image to be examined\n"
379 " cdrom <iso-file>\n");
380 else if (strcasecmp (cmd, "help") == 0)
381 printf ("help - display a list of commands or help on a command\n"
384 else if (strcasecmp (cmd, "quit") == 0)
385 printf ("quit - quit guestfish\n"
387 else if (strcasecmp (cmd, "launch") == 0)
388 printf ("launch - launch the subprocess\n"
391 fprintf (stderr, "%s: command not known, use -h to list all commands\n",