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|--add image Add image\n"
84 " -m|--mount dev[:mnt] Mount dev on mnt (if omitted, /)\n"
85 " -n|--no-sync Don't autosync\n"
86 /*" --ro|-r All mounts are read-only\n"*/
87 " -v|--verbose Verbose messages\n"
88 "For more information, see the manpage guestfish(1).\n");
92 main (int argc, char *argv[])
94 static const char *options = "a:h::m:v?";
95 static struct option long_options[] = {
97 { "cmd-help", 2, 0, 'h' },
98 { "help", 0, 0, '?' },
99 { "mount", 1, 0, 'm' },
100 { "no-sync", 0, 0, 'n' },
101 { "verbose", 0, 0, 'v' },
104 struct mp *mps = NULL;
109 /* guestfs_create is meant to be a lightweight operation, so
110 * it's OK to do it early here.
112 g = guestfs_create ();
114 fprintf (stderr, "guestfs_create: failed to create handle\n");
118 guestfs_set_autosync (g, 1);
120 /* If developing, add . to the path. Note that libtools interferes
121 * with this because uninstalled guestfish is a shell script that runs
122 * the real program with an absolute path. Detect that too.
125 (argv[0][0] != '/' || strstr (argv[0], "/.libs/lt-") != NULL))
126 guestfs_set_path (g, ".:" GUESTFS_DEFAULT_PATH);
129 c = getopt_long (argc, argv, options, long_options, NULL);
134 if (access (optarg, R_OK) != 0) {
138 if (guestfs_add_drive (g, optarg) == -1)
144 display_command (optarg);
145 else if (argv[optind] && argv[optind][0] != '-')
146 display_command (argv[optind++]);
152 mp = malloc (sizeof (struct mp));
157 p = strchr (optarg, ':');
160 mp->mountpoint = p+1;
162 mp->mountpoint = "/";
169 guestfs_set_autosync (g, 0);
174 guestfs_set_verbose (g, verbose);
182 fprintf (stderr, "guestfish: unexpected command line option 0x%x\n", c);
187 /* If we've got mountpoints, we must launch the guest and mount them. */
189 if (launch () == -1) exit (1);
193 /* Interactive, shell script, or command(s) on the command line? */
194 if (optind >= argc) {
201 cmdline (argv, optind, argc);
207 pod2text (const char *heading, const char *str)
211 fp = popen ("pod2text", "w");
213 /* pod2text failed, maybe not found, so let's just print the
214 * source instead, since that's better than doing nothing.
216 printf ("%s\n\n%s\n", heading, str);
219 fputs ("=head1 ", fp);
226 /* List is built in reverse order, so mount them in reverse order. */
228 mount_mps (struct mp *mp)
231 mount_mps (mp->next);
232 if (guestfs_mount (g, mp->device, mp->mountpoint) == -1)
259 "Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
260 "editing virtual machine filesystems.\n"
262 "Type: 'help' for help with commands\n"
263 " 'quit' to quit the shell\n"
267 if (prompt) printf ("><fs> ");
268 if (fgets (buf, sizeof buf, stdin) == NULL) {
274 if (len > 0 && buf[len-1] == '\n') buf[len-1] = '\0';
276 /* Split the buffer up at whitespace. */
277 cmd = strtok (buf, " \t");
282 while (i < sizeof argv / sizeof argv[0] &&
283 (argv[i] = strtok (NULL, " \t")) != NULL)
285 if (i == sizeof argv / sizeof argv[0]) {
286 fprintf (stderr, "guestfish: too many arguments in command\n");
290 (void) issue_command (cmd, argv);
292 if (prompt) printf ("\n");
296 cmdline (char *argv[], int optind, int argc)
301 if (optind >= argc) return;
303 cmd = argv[optind++];
304 if (strcmp (cmd, ":") == 0) {
305 fprintf (stderr, "guestfish: empty command on command line\n");
308 params = &argv[optind];
310 /* Search for end of command list or ":" ... */
311 while (optind < argc && strcmp (argv[optind], ":") != 0)
314 if (optind == argc) {
315 if (issue_command (cmd, params) == -1) exit (1);
318 if (issue_command (cmd, params) == -1) exit (1);
319 cmdline (argv, optind+1, argc);
324 issue_command (const char *cmd, char *argv[])
328 for (argc = 0; argv[argc] != NULL; ++argc)
331 if (strcasecmp (cmd, "help") == 0) {
335 display_command (argv[0]);
338 else if (strcasecmp (cmd, "quit") == 0 ||
339 strcasecmp (cmd, "exit") == 0 ||
340 strcasecmp (cmd, "q") == 0)
342 else if (strcasecmp (cmd, "add") == 0 ||
343 strcasecmp (cmd, "drive") == 0 ||
344 strcasecmp (cmd, "add_drive") == 0) {
346 fprintf (stderr, "use 'add image' to add a guest image\n");
350 return guestfs_add_drive (g, argv[0]);
352 else if (strcasecmp (cmd, "cdrom") == 0) {
354 fprintf (stderr, "use 'cdrom image' to add a CD-ROM image\n");
358 return guestfs_add_cdrom (g, argv[0]);
360 else if (strcasecmp (cmd, "launch") == 0) {
362 fprintf (stderr, "'launch' command takes no parameters\n");
369 return run_action (cmd, argc, argv);
373 list_builtin_commands (void)
375 printf ("%-20s %s\n",
376 "help", "display a list of commands or help on a command");
377 printf ("%-20s %s\n",
378 "quit", "quit guestfish");
379 printf ("%-20s %s\n",
380 "add", "add a guest image to be examined or modified");
381 printf ("%-20s %s\n",
382 "cdrom", "add a CD-ROM image to be examined");
383 printf ("%-20s %s\n",
384 "launch", "launch the subprocess");
388 display_builtin_command (const char *cmd)
390 if (strcasecmp (cmd, "add") == 0)
391 printf ("add - add a guest image to be examined or modified\n"
393 else if (strcasecmp (cmd, "cdrom") == 0)
394 printf ("cdrom - add a CD-ROM image to be examined\n"
395 " cdrom <iso-file>\n");
396 else if (strcasecmp (cmd, "help") == 0)
397 printf ("help - display a list of commands or help on a command\n"
400 else if (strcasecmp (cmd, "quit") == 0)
401 printf ("quit - quit guestfish\n"
403 else if (strcasecmp (cmd, "launch") == 0)
404 printf ("launch - launch the subprocess\n"
407 fprintf (stderr, "%s: command not known, use -h to list all commands\n",