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)
242 printf ("Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
243 "editing virtual machine filesystems.\n"
245 "Type: 'help' for help with commands\n"
246 " 'quit' to quit the shell\n"
250 if (prompt) printf ("><fs> ");
251 if (fgets (buf, sizeof buf, stdin) == NULL) {
257 if (len > 0 && buf[len-1] == '\n') buf[len-1] = '\0';
259 /* Split the buffer up at whitespace. */
260 cmd = strtok (buf, " \t");
265 while (i < sizeof argv / sizeof argv[0] &&
266 (argv[i] = strtok (NULL, " \t")) != NULL)
268 if (i == sizeof argv / sizeof argv[0]) {
269 fprintf (stderr, "guestfish: too many arguments in command\n");
273 (void) issue_command (cmd, argv);
275 if (prompt) printf ("\n");
279 cmdline (char *argv[], int optind, int argc)
284 if (optind >= argc) return;
286 cmd = argv[optind++];
287 if (strcmp (cmd, ":") == 0) {
288 fprintf (stderr, "guestfish: empty command on command line\n");
291 params = &argv[optind];
293 /* Search for end of command list or ":" ... */
294 while (optind < argc && strcmp (argv[optind], ":") != 0)
297 if (optind == argc) {
298 if (issue_command (cmd, params) == -1) exit (1);
301 if (issue_command (cmd, params) == -1) exit (1);
302 cmdline (argv, optind+1, argc);
307 issue_command (const char *cmd, char *argv[])
311 for (argc = 0; argv[argc] != NULL; ++argc)
314 if (strcasecmp (cmd, "help") == 0) {
318 display_command (argv[0]);
321 else if (strcasecmp (cmd, "quit") == 0 ||
322 strcasecmp (cmd, "exit") == 0 ||
323 strcasecmp (cmd, "q") == 0)
325 else if (strcasecmp (cmd, "add") == 0 ||
326 strcasecmp (cmd, "drive") == 0 ||
327 strcasecmp (cmd, "add_drive") == 0) {
329 fprintf (stderr, "use 'add image' to add a guest image\n");
333 return guestfs_add_drive (g, argv[0]);
335 else if (strcasecmp (cmd, "cdrom") == 0) {
337 fprintf (stderr, "use 'cdrom image' to add a guest cdrom\n");
341 return guestfs_add_cdrom (g, argv[0]);
343 else if (strcasecmp (cmd, "launch") == 0) {
345 fprintf (stderr, "'launch' command takes no parameters\n");
352 return run_action (cmd, argc, argv);
356 list_builtin_commands (void)
358 printf ("%-20s %s\n",
359 "help", "display a list of commands or help on a command");
360 printf ("%-20s %s\n",
361 "quit", "quit guestfish");
362 printf ("%-20s %s\n",
363 "add", "add a guest image to be examined or modified");
364 printf ("%-20s %s\n",
365 "cdrom", "add a guest CD-ROM image to be examined");
366 printf ("%-20s %s\n",
367 "launch", "launch the subprocess");
371 display_builtin_command (const char *cmd)
373 if (strcasecmp (cmd, "add") == 0)
374 printf ("add - add a guest image to be examined or modified\n"
376 else if (strcasecmp (cmd, "cdrom") == 0)
377 printf ("cdrom - add a guest CD-ROM image to be examined\n"
378 " cdrom <iso-file>\n");
379 else if (strcasecmp (cmd, "help") == 0)
380 printf ("help - display a list of commands or help on a command\n"
383 else if (strcasecmp (cmd, "quit") == 0)
384 printf ("quit - quit guestfish\n"
386 else if (strcasecmp (cmd, "launch") == 0)
387 printf ("launch - launch the subprocess\n"
390 fprintf (stderr, "%s: command not known, use -h to list all commands\n",