X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=fish%2Ffish.c;h=a32ed4d0ef6aad2cbea1804d38fa683c2c780113;hp=e0d047069cf6e6d104d715e2c281db59f277fa79;hb=3920ad95f6b2db8fbf20aa26692877a09070cb04;hpb=73d6932ab2dd3f9120a1f4a532621c07cb174705 diff --git a/fish/fish.c b/fish/fish.c index e0d0470..a32ed4d 100644 --- a/fish/fish.c +++ b/fish/fish.c @@ -1,5 +1,5 @@ /* guestfish - the filesystem interactive shell - * Copyright (C) 2009 Red Hat Inc. + * Copyright (C) 2009-2010 Red Hat Inc. * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by @@ -24,11 +24,30 @@ #include #include #include -#include +#include +#include +#include +#include +#include + +#ifdef HAVE_LIBREADLINE +#include +#include +#endif #include #include "fish.h" +#include "c-ctype.h" +#include "closeout.h" +#include "progname.h" + +struct drv { + struct drv *next; + char *filename; /* disk filename (for -a or -N options) */ + prep_data *data; /* prepared type (for -N option only) */ + char *device; /* device inside the appliance */ +}; struct mp { struct mp *next; @@ -36,133 +55,280 @@ struct mp { char *mountpoint; }; +static void add_drives (struct drv *drv); +static void prepare_drives (struct drv *drv); static void mount_mps (struct mp *mp); +static int launch (void); static void interactive (void); static void shell_script (void); static void script (int prompt); static void cmdline (char *argv[], int optind, int argc); -static int issue_command (const char *cmd, char *argv[]); -static int parse_size (const char *str, off_t *size_rtn); +static void initialize_readline (void); +static void cleanup_readline (void); +#ifdef HAVE_LIBREADLINE +static void add_history_line (const char *); +#endif +static void print_shell_quote (FILE *stream, const char *str); /* Currently open libguestfs handle. */ guestfs_h *g; -int g_launched = 0; +int read_only = 0; int quit = 0; int verbose = 0; +int remote_control_listen = 0; +int remote_control = 0; +int exit_on_error = 1; +int command_num = 0; -int -launch (void) +static void __attribute__((noreturn)) +usage (int status) { - if (!g_launched) { - if (guestfs_launch (g) == -1) - return -1; - if (guestfs_wait_ready (g) == -1) - return -1; - g_launched = 1; + if (status != EXIT_SUCCESS) + fprintf (stderr, _("Try `%s --help' for more information.\n"), + program_name); + else { + fprintf (stdout, + _("%s: guest filesystem shell\n" + "%s lets you edit virtual machine filesystems\n" + "Copyright (C) 2009 Red Hat Inc.\n" + "Usage:\n" + " %s [--options] cmd [: cmd : cmd ...]\n" + " %s -i libvirt-domain\n" + " %s -i disk-image(s)\n" + "or for interactive use:\n" + " %s\n" + "or from a shell script:\n" + " %s <filename = optarg; + drv->data = NULL; + /* We could fill the device field in, but in fact we + * only use it for the -N option at present. + */ + drv->device = NULL; + drv->next = drvs; + drvs = drv; + next_drive++; + break; + + case 'N': + if (STRCASEEQ (optarg, "list")) { + list_prepared_drives (); + exit (EXIT_SUCCESS); + } + drv = malloc (sizeof (struct drv)); + if (!drv) { + perror ("malloc"); + exit (EXIT_FAILURE); } - if (guestfs_add_drive (g, optarg) == -1) - exit (1); + if (asprintf (&drv->filename, "test%d.img", + next_prepared_drive++) == -1) { + perror ("asprintf"); + exit (EXIT_FAILURE); + } + drv->data = create_prepared_file (optarg, drv->filename); + if (asprintf (&drv->device, "/dev/sd%c", next_drive++) == -1) { + perror ("asprintf"); + exit (EXIT_FAILURE); + } + drv->next = drvs; + drvs = drv; + break; + + case 'D': + complete_dest_paths = 0; + break; + + case 'f': + if (file) { + fprintf (stderr, _("%s: only one -f parameter can be given\n"), + program_name); + exit (EXIT_FAILURE); + } + file = optarg; break; case 'h': if (optarg) - display_command (optarg); + display_command (optarg); else if (argv[optind] && argv[optind][0] != '-') - display_command (argv[optind++]); + display_command (argv[optind++]); else - list_commands (); - exit (0); + list_commands (); + exit (EXIT_SUCCESS); + + case 'i': + inspector = 1; + break; case 'm': mp = malloc (sizeof (struct mp)); if (!mp) { - perror ("malloc"); - exit (1); + perror ("malloc"); + exit (EXIT_FAILURE); } p = strchr (optarg, ':'); if (p) { - *p = '\0'; - mp->mountpoint = p+1; + *p = '\0'; + mp->mountpoint = p+1; } else - mp->mountpoint = "/"; + mp->mountpoint = bad_cast ("/"); mp->device = optarg; mp->next = mps; mps = mp; @@ -172,27 +338,178 @@ main (int argc, char *argv[]) guestfs_set_autosync (g, 0); break; + case 'r': + read_only = 1; + break; + case 'v': verbose++; guestfs_set_verbose (g, verbose); break; - case '?': - usage (); - exit (0); + case 'V': + printf ("%s %s\n", program_name, PACKAGE_VERSION); + exit (EXIT_SUCCESS); + + case 'x': + guestfs_set_trace (g, 1); + break; + + case HELP_OPTION: + usage (EXIT_SUCCESS); default: - fprintf (stderr, "guestfish: unexpected command line option 0x%x\n", c); - exit (1); + usage (EXIT_FAILURE); + } + } + + /* Inspector mode invalidates most of the other arguments. */ + if (inspector) { + if (drvs || mps || remote_control_listen || remote_control || + guestfs_get_selinux (g)) { + fprintf (stderr, _("%s: cannot use -i option with -a, -m, -N, " + "--listen, --remote or --selinux\n"), + program_name); + exit (EXIT_FAILURE); } + if (optind >= argc) { + fprintf (stderr, + _("%s: -i requires a libvirt domain or path(s) to disk image(s)\n"), + program_name); + exit (EXIT_FAILURE); + } + + char *cmd; + size_t cmdlen; + FILE *fp = open_memstream (&cmd, &cmdlen); + if (fp == NULL) { + perror ("open_memstream"); + exit (EXIT_FAILURE); + } + + fprintf (fp, "virt-inspector"); + while (optind < argc) { + fputc (' ', fp); + print_shell_quote (fp, argv[optind]); + optind++; + } + + if (read_only) + fprintf (fp, " --ro-fish"); + else + fprintf (fp, " --fish"); + + if (fclose (fp) == -1) { + perror ("fclose"); + exit (EXIT_FAILURE); + } + + if (verbose) + fprintf (stderr, + "%s -i: running: %s\n", program_name, cmd); + + FILE *pp = popen (cmd, "r"); + if (pp == NULL) { + perror (cmd); + exit (EXIT_FAILURE); + } + + char *cmd2; + fp = open_memstream (&cmd2, &cmdlen); + if (fp == NULL) { + perror ("open_memstream"); + exit (EXIT_FAILURE); + } + + fprintf (fp, "%s", real_argv0); + + if (guestfs_get_verbose (g)) + fprintf (fp, " -v"); + if (!guestfs_get_autosync (g)) + fprintf (fp, " -n"); + if (guestfs_get_trace (g)) + fprintf (fp, " -x"); + + char *insp = NULL; + size_t insplen; + if (getline (&insp, &insplen, pp) == -1) { + perror (cmd); + exit (EXIT_FAILURE); + } + fprintf (fp, " %s", insp); + + if (pclose (pp) == -1) { + perror (cmd); + exit (EXIT_FAILURE); + } + + if (fclose (fp) == -1) { + perror ("fclose"); + exit (EXIT_FAILURE); + } + + if (verbose) + fprintf (stderr, + "%s -i: running: %s\n", program_name, cmd2); + + int r = system (cmd2); + if (r == -1) { + perror (cmd2); + exit (EXIT_FAILURE); + } + + free (cmd); + free (cmd2); + free (insp); + + exit (WEXITSTATUS (r)); } - /* If we've got mountpoints, we must launch the guest and mount them. */ - if (mps != NULL) { - if (launch () == -1) exit (1); + /* If we've got drives to add, add them now. */ + add_drives (drvs); + + /* If we've got mountpoints or prepared drives, we must launch the + * guest and mount them. + */ + if (next_prepared_drive > 1 || mps != NULL) { + if (launch () == -1) exit (EXIT_FAILURE); + prepare_drives (drvs); mount_mps (mps); } + /* Remote control? */ + if (remote_control_listen && remote_control) { + fprintf (stderr, + _("%s: cannot use --listen and --remote options at the same time\n"), + program_name); + exit (EXIT_FAILURE); + } + + if (remote_control_listen) { + if (optind < argc) { + fprintf (stderr, + _("%s: extra parameters on the command line with --listen flag\n"), + program_name); + exit (EXIT_FAILURE); + } + if (file) { + fprintf (stderr, + _("%s: cannot use --listen and --file options at the same time\n"), + program_name); + exit (EXIT_FAILURE); + } + rc_listen (); + } + + /* -f (file) parameter? */ + if (file) { + close (0); + if (open (file, O_RDONLY) == -1) { + perror (file); + exit (EXIT_FAILURE); + } + } + /* Interactive, shell script, or command(s) on the command line? */ if (optind >= argc) { if (isatty (0)) @@ -203,11 +520,13 @@ main (int argc, char *argv[]) else cmdline (argv, optind, argc); - exit (0); + cleanup_readline (); + + exit (EXIT_SUCCESS); } void -pod2text (const char *heading, const char *str) +pod2text (const char *name, const char *shortdesc, const char *str) { FILE *fp; @@ -216,12 +535,10 @@ pod2text (const char *heading, const char *str) /* pod2text failed, maybe not found, so let's just print the * source instead, since that's better than doing nothing. */ - printf ("%s\n\n%s\n", heading, str); + printf ("%s - %s\n\n%s\n", name, shortdesc, str); return; } - fputs ("=head1 ", fp); - fputs (heading, fp); - fputs ("\n\n", fp); + fprintf (fp, "=head1 NAME\n\n%s - %s\n\n", name, shortdesc); fputs (str, fp); pclose (fp); } @@ -230,11 +547,57 @@ pod2text (const char *heading, const char *str) static void mount_mps (struct mp *mp) { + int r; + if (mp) { mount_mps (mp->next); - if (guestfs_mount (g, mp->device, mp->mountpoint) == -1) - exit (1); + + /* Don't use guestfs_mount here because that will default to mount + * options -o sync,noatime. For more information, see guestfs(3) + * section "LIBGUESTFS GOTCHAS". + */ + const char *options = read_only ? "ro" : ""; + r = guestfs_mount_options (g, options, mp->device, mp->mountpoint); + if (r == -1) + exit (EXIT_FAILURE); + } +} + +static void +add_drives (struct drv *drv) +{ + int r; + + if (drv) { + add_drives (drv->next); + + if (drv->data /* -N option is not affected by --ro */ || !read_only) + r = guestfs_add_drive (g, drv->filename); + else + r = guestfs_add_drive_ro (g, drv->filename); + if (r == -1) + exit (EXIT_FAILURE); + } +} + +static void +prepare_drives (struct drv *drv) +{ + if (drv) { + prepare_drives (drv->next); + if (drv->data) + prepare_drive (drv->filename, drv->data, drv->device); + } +} + +static int +launch (void) +{ + if (guestfs_is_config (g)) { + if (guestfs_launch (g) == -1) + return -1; } + return 0; } static void @@ -249,50 +612,240 @@ shell_script (void) script (0); } +#define FISH "> " + +static char *line_read = NULL; + +static char * +rl_gets (int prompt) +{ +#ifdef HAVE_LIBREADLINE + + if (prompt) { + if (line_read) { + free (line_read); + line_read = NULL; + } + + line_read = readline (prompt ? FISH : ""); + + if (line_read && *line_read) + add_history_line (line_read); + + return line_read; + } + +#endif /* HAVE_LIBREADLINE */ + + static char buf[8192]; + int len; + + if (prompt) printf (FISH); + line_read = fgets (buf, sizeof buf, stdin); + + if (line_read) { + len = strlen (line_read); + if (len > 0 && buf[len-1] == '\n') buf[len-1] = '\0'; + } + + return line_read; +} + static void script (int prompt) { - char buf[8192]; + char *buf; char *cmd; + char *p, *pend; char *argv[64]; - int len, i; + int len; + int global_exit_on_error = !prompt; + int tilde_candidate; if (prompt) - printf ("\n" - "Welcome to guestfish, the libguestfs filesystem interactive shell for\n" - "editing virtual machine filesystems.\n" - "\n" - "Type: 'help' for help with commands\n" - " 'quit' to quit the shell\n" - "\n"); + printf (_("\n" + "Welcome to guestfish, the libguestfs filesystem interactive shell for\n" + "editing virtual machine filesystems.\n" + "\n" + "Type: 'help' for a list of commands\n" + " 'man' to read the manual\n" + " 'quit' to quit the shell\n" + "\n")); while (!quit) { - if (prompt) printf ("> "); - if (fgets (buf, sizeof buf, stdin) == NULL) { + char *pipe = NULL; + + exit_on_error = global_exit_on_error; + + buf = rl_gets (prompt); + if (!buf) { quit = 1; break; } - len = strlen (buf); - if (len > 0 && buf[len-1] == '\n') buf[len-1] = '\0'; + /* Skip any initial whitespace before the command. */ + again: + while (*buf && c_isspace (*buf)) + buf++; + + if (!*buf) continue; - /* Split the buffer up at whitespace. */ - cmd = strtok (buf, " \t"); - if (cmd == NULL) + /* If the next character is '#' then this is a comment. */ + if (*buf == '#') continue; + + /* If the next character is '!' then pass the whole lot to system(3). */ + if (*buf == '!') { + int r; + + r = system (buf+1); + if (exit_on_error) { + if (r == -1 || + (WIFSIGNALED (r) && + (WTERMSIG (r) == SIGINT || WTERMSIG (r) == SIGQUIT)) || + WEXITSTATUS (r) != 0) + exit (EXIT_FAILURE); + } continue; + } + + /* If the next character is '-' allow the command to fail without + * exiting on error (just for this one command though). + */ + if (*buf == '-') { + exit_on_error = 0; + buf++; + goto again; + } + + /* Get the command (cannot be quoted). */ + len = strcspn (buf, " \t"); - i = 0; - while (i < sizeof argv / sizeof argv[0] && - (argv[i] = strtok (NULL, " \t")) != NULL) + if (len == 0) continue; + + cmd = buf; + unsigned int i = 0; + if (buf[len] == '\0') { + argv[0] = NULL; + goto got_command; + } + + buf[len] = '\0'; + p = &buf[len+1]; + p += strspn (p, " \t"); + + /* Get the parameters. */ + while (*p && i < sizeof argv / sizeof argv[0]) { + tilde_candidate = 0; + + /* Parameters which start with quotes or pipes are treated + * specially. Bare parameters are delimited by whitespace. + */ + if (*p == '"') { + p++; + len = strcspn (p, "\""); + if (p[len] == '\0') { + fprintf (stderr, _("%s: unterminated double quote\n"), program_name); + if (exit_on_error) exit (EXIT_FAILURE); + goto next_command; + } + if (p[len+1] && (p[len+1] != ' ' && p[len+1] != '\t')) { + fprintf (stderr, + _("%s: command arguments not separated by whitespace\n"), + program_name); + if (exit_on_error) exit (EXIT_FAILURE); + goto next_command; + } + p[len] = '\0'; + pend = p[len+1] ? &p[len+2] : &p[len+1]; + } else if (*p == '\'') { + p++; + len = strcspn (p, "'"); + if (p[len] == '\0') { + fprintf (stderr, _("%s: unterminated single quote\n"), program_name); + if (exit_on_error) exit (EXIT_FAILURE); + goto next_command; + } + if (p[len+1] && (p[len+1] != ' ' && p[len+1] != '\t')) { + fprintf (stderr, + _("%s: command arguments not separated by whitespace\n"), + program_name); + if (exit_on_error) exit (EXIT_FAILURE); + goto next_command; + } + p[len] = '\0'; + pend = p[len+1] ? &p[len+2] : &p[len+1]; + } else if (*p == '|') { + *p = '\0'; + pipe = p+1; + continue; + /* + } else if (*p == '[') { + int c = 1; + p++; + pend = p; + while (*pend && c != 0) { + if (*pend == '[') c++; + else if (*pend == ']') c--; + pend++; + } + if (c != 0) { + fprintf (stderr, + _("%s: unterminated \"[...]\" sequence\n"), program_name); + if (exit_on_error) exit (EXIT_FAILURE); + goto next_command; + } + if (*pend && (*pend != ' ' && *pend != '\t')) { + fprintf (stderr, + _("%s: command arguments not separated by whitespace\n"), + program_name); + if (exit_on_error) exit (EXIT_FAILURE); + goto next_command; + } + *(pend-1) = '\0'; + */ + } else if (*p != ' ' && *p != '\t') { + /* If the first character is a ~ then note that this parameter + * is a candidate for ~username expansion. NB this does not + * apply to quoted parameters. + */ + tilde_candidate = *p == '~'; + len = strcspn (p, " \t"); + if (p[len]) { + p[len] = '\0'; + pend = &p[len+1]; + } else + pend = &p[len]; + } else { + fprintf (stderr, _("%s: internal error parsing string at '%s'\n"), + program_name, p); + abort (); + } + + if (!tilde_candidate) + argv[i] = p; + else + argv[i] = try_tilde_expansion (p); i++; + p = pend; + + if (*p) + p += strspn (p, " \t"); + } + if (i == sizeof argv / sizeof argv[0]) { - fprintf (stderr, "guestfish: too many arguments in command\n"); - exit (1); + fprintf (stderr, _("%s: too many arguments\n"), program_name); + if (exit_on_error) exit (EXIT_FAILURE); + goto next_command; } - if (issue_command (cmd, argv) == -1) { - if (!prompt) exit (1); + argv[i] = NULL; + + got_command: + if (issue_command (cmd, argv, pipe) == -1) { + if (exit_on_error) exit (EXIT_FAILURE); } + + next_command:; } if (prompt) printf ("\n"); } @@ -303,146 +856,200 @@ cmdline (char *argv[], int optind, int argc) const char *cmd; char **params; + exit_on_error = 1; + if (optind >= argc) return; cmd = argv[optind++]; - if (strcmp (cmd, ":") == 0) { - fprintf (stderr, "guestfish: empty command on command line\n"); - exit (1); + if (STREQ (cmd, ":")) { + fprintf (stderr, _("%s: empty command on command line\n"), program_name); + exit (EXIT_FAILURE); } + + /* Allow -cmd on the command line to mean (temporarily) override + * the normal exit on error (RHBZ#578407). + */ + if (cmd[0] == '-') { + exit_on_error = 0; + cmd++; + } + params = &argv[optind]; /* Search for end of command list or ":" ... */ - while (optind < argc && strcmp (argv[optind], ":") != 0) + while (optind < argc && STRNEQ (argv[optind], ":")) optind++; if (optind == argc) { - if (issue_command (cmd, params) == -1) exit (1); + if (issue_command (cmd, params, NULL) == -1 && exit_on_error) + exit (EXIT_FAILURE); } else { argv[optind] = NULL; - if (issue_command (cmd, params) == -1) exit (1); + if (issue_command (cmd, params, NULL) == -1 && exit_on_error) + exit (EXIT_FAILURE); cmdline (argv, optind+1, argc); } } -static int -issue_command (const char *cmd, char *argv[]) +int +issue_command (const char *cmd, char *argv[], const char *pipecmd) { int argc; + int stdout_saved_fd = -1; + int pid = 0; + int i, r; - for (argc = 0; argv[argc] != NULL; ++argc) - ; + /* This counts the commands issued, starting at 1. */ + command_num++; - if (strcasecmp (cmd, "help") == 0) { - if (argc == 0) - list_commands (); - else - display_command (argv[0]); - return 0; - } - else if (strcasecmp (cmd, "quit") == 0 || - strcasecmp (cmd, "exit") == 0 || - strcasecmp (cmd, "q") == 0) { - quit = 1; - return 0; - } - else if (strcasecmp (cmd, "add") == 0 || - strcasecmp (cmd, "drive") == 0 || - strcasecmp (cmd, "add-drive") == 0 || - strcasecmp (cmd, "add_drive") == 0) { - if (argc != 1) { - fprintf (stderr, "use 'add image' to add a guest image\n"); + /* For | ... commands. Annoyingly we can't use popen(3) here. */ + if (pipecmd) { + int fd[2]; + + if (fflush (stdout) == EOF) { + perror ("failed to flush standard output"); return -1; } - else - return guestfs_add_drive (g, argv[0]); - } - else if (strcasecmp (cmd, "cdrom") == 0 || - strcasecmp (cmd, "add-cdrom") == 0 || - strcasecmp (cmd, "add_cdrom") == 0) { - if (argc != 1) { - fprintf (stderr, "use 'cdrom image' to add a CD-ROM image\n"); + if (pipe (fd) < 0) { + perror ("pipe failed"); return -1; } - else - return guestfs_add_cdrom (g, argv[0]); - } - else if (strcasecmp (cmd, "alloc") == 0 || - strcasecmp (cmd, "allocate") == 0) { - if (argc != 2) { - fprintf (stderr, "use 'alloc file size' to create an image\n"); + pid = fork (); + if (pid == -1) { + perror ("fork"); return -1; } - else { - off_t size; - int fd; - - if (parse_size (argv[1], &size) == -1) - return -1; - - if (g_launched) { - fprintf (stderr, "can't allocate or add disks after launching\n"); - return -1; - } - - fd = open (argv[0], O_WRONLY|O_CREAT|O_NOCTTY|O_NONBLOCK|O_TRUNC, 0666); - if (fd == -1) { - perror (argv[0]); - return -1; - } - if (posix_fallocate (fd, 0, size) == -1) { - perror ("fallocate"); - close (fd); - unlink (argv[0]); - return -1; + if (pid == 0) { /* Child process. */ + close (fd[1]); + if (dup2 (fd[0], 0) < 0) { + perror ("dup2 of stdin failed"); + _exit (1); } - if (close (fd) == -1) { - perror (argv[0]); - unlink (argv[0]); - return -1; - } - - if (guestfs_add_drive (g, argv[0]) == -1) { - unlink (argv[0]); - return -1; + r = system (pipecmd); + if (r == -1) { + perror (pipecmd); + _exit (1); } + _exit (WEXITSTATUS (r)); + } - return 0; + if ((stdout_saved_fd = dup (1)) < 0) { + perror ("failed to dup stdout"); + return -1; } - } - else if (strcasecmp (cmd, "launch") == 0 || - strcasecmp (cmd, "run") == 0) { - if (argc != 0) { - fprintf (stderr, "'launch' command takes no parameters\n"); + close (fd[0]); + if (dup2 (fd[1], 1) < 0) { + perror ("failed to dup stdout"); + close (stdout_saved_fd); return -1; } + close (fd[1]); + } + + for (argc = 0; argv[argc] != NULL; ++argc) + ; + + /* If --remote was set, then send this command to a remote process. */ + if (remote_control) + r = rc_remote (remote_control, cmd, argc, argv, exit_on_error); + + /* Otherwise execute it locally. */ + else if (STRCASEEQ (cmd, "help")) { + if (argc == 0) + list_commands (); else - return launch (); + display_command (argv[0]); + r = 0; } + else if (STRCASEEQ (cmd, "quit") || + STRCASEEQ (cmd, "exit") || + STRCASEEQ (cmd, "q")) { + quit = 1; + r = 0; + } + else if (STRCASEEQ (cmd, "alloc") || + STRCASEEQ (cmd, "allocate")) + r = do_alloc (cmd, argc, argv); + else if (STRCASEEQ (cmd, "echo")) + r = do_echo (cmd, argc, argv); + else if (STRCASEEQ (cmd, "edit") || + STRCASEEQ (cmd, "vi") || + STRCASEEQ (cmd, "emacs")) + r = do_edit (cmd, argc, argv); + else if (STRCASEEQ (cmd, "lcd")) + r = do_lcd (cmd, argc, argv); + else if (STRCASEEQ (cmd, "glob")) + r = do_glob (cmd, argc, argv); + else if (STRCASEEQ (cmd, "man") || + STRCASEEQ (cmd, "manual")) + r = do_man (cmd, argc, argv); + else if (STRCASEEQ (cmd, "more") || + STRCASEEQ (cmd, "less")) + r = do_more (cmd, argc, argv); + else if (STRCASEEQ (cmd, "reopen")) + r = do_reopen (cmd, argc, argv); + else if (STRCASEEQ (cmd, "sparse")) + r = do_sparse (cmd, argc, argv); + else if (STRCASEEQ (cmd, "time")) + r = do_time (cmd, argc, argv); else - return run_action (cmd, argc, argv); + r = run_action (cmd, argc, argv); + + /* Always flush stdout after every command, so that messages, results + * etc appear immediately. + */ + if (fflush (stdout) == EOF) { + perror ("failed to flush standard output"); + return -1; + } + + if (pipecmd) { + close (1); + if (dup2 (stdout_saved_fd, 1) < 0) { + perror ("failed to dup2 standard output"); + r = -1; + } + close (stdout_saved_fd); + if (waitpid (pid, NULL, 0) < 0) { + perror ("waiting for command to complete"); + r = -1; + } + } + + return r; } void list_builtin_commands (void) { - /* help and quit should appear at the top */ + /* help, man and quit should appear at the top */ + printf ("%-20s %s\n", + "help", _("display a list of commands or help on a command")); printf ("%-20s %s\n", - "help", "display a list of commands or help on a command"); + "man", _("read the manual")); printf ("%-20s %s\n", - "quit", "quit guestfish"); + "quit", _("quit guestfish")); - /* then the non-actions, in alphabetical order */ printf ("%-20s %s\n", - "add", "add a guest image to be examined or modified"); + "alloc", _("allocate an image")); + printf ("%-20s %s\n", + "echo", _("display a line of text")); + printf ("%-20s %s\n", + "edit", _("edit a file in the image")); + printf ("%-20s %s\n", + "lcd", _("local change directory")); printf ("%-20s %s\n", - "alloc", "allocate an image"); + "glob", _("expand wildcards in command")); printf ("%-20s %s\n", - "cdrom", "add a CD-ROM image to be examined"); + "more", _("view a file in the pager")); printf ("%-20s %s\n", - "launch", "launch the subprocess"); + "reopen", _("close and reopen libguestfs handle")); + printf ("%-20s %s\n", + "sparse", _("allocate a sparse image file")); + printf ("%-20s %s\n", + "time", _("measure time taken to run command")); /* actions are printed after this (see list_commands) */ } @@ -452,96 +1059,619 @@ display_builtin_command (const char *cmd) { /* help for actions is auto-generated, see display_command */ - if (strcasecmp (cmd, "add") == 0) - printf ("add - add a guest image to be examined or modified\n" - " add \n"); - else if (strcasecmp (cmd, "alloc") == 0) - printf ("alloc - allocate an image\n" - " alloc \n" - "\n" - " This creates an empty (zeroed) file of the given size,\n" - " and then adds so it can be further examined.\n" - "\n" - " For more advanced image creation, see qemu-img utility.\n" - "\n" - " Size can be specified (where means a number):\n" - " number of kilobytes\n" - " eg: 1440 standard 3.5\" floppy\n" - " K or KB number of kilobytes\n" - " M or MB number of megabytes\n" - " G or GB number of gigabytes\n" - " sects number of 512 byte sectors\n"); - else if (strcasecmp (cmd, "cdrom") == 0) - printf ("cdrom - add a CD-ROM image to be examined\n" - " cdrom \n"); - else if (strcasecmp (cmd, "help") == 0) - printf ("help - display a list of commands or help on a command\n" - " help cmd\n" - " help\n"); - else if (strcasecmp (cmd, "quit") == 0) - printf ("quit - quit guestfish\n" - " quit\n"); - else if (strcasecmp (cmd, "launch") == 0) - printf ("launch - launch the subprocess\n" - " launch\n"); + if (STRCASEEQ (cmd, "alloc") || + STRCASEEQ (cmd, "allocate")) + printf (_("alloc - allocate an image\n" + " alloc \n" + "\n" + " This creates an empty (zeroed) file of the given size,\n" + " and then adds so it can be further examined.\n" + "\n" + " For more advanced image creation, see qemu-img utility.\n" + "\n" + " Size can be specified (where means a number):\n" + " number of kilobytes\n" + " eg: 1440 standard 3.5\" floppy\n" + " K or KB number of kilobytes\n" + " M or MB number of megabytes\n" + " G or GB number of gigabytes\n" + " T or TB number of terabytes\n" + " P or PB number of petabytes\n" + " E or EB number of exabytes\n" + " sects number of 512 byte sectors\n")); + else if (STRCASEEQ (cmd, "echo")) + printf (_("echo - display a line of text\n" + " echo [ ...]\n" + "\n" + " This echos the parameters to the terminal.\n")); + else if (STRCASEEQ (cmd, "edit") || + STRCASEEQ (cmd, "vi") || + STRCASEEQ (cmd, "emacs")) + printf (_("edit - edit a file in the image\n" + " edit \n" + "\n" + " This is used to edit a file.\n" + "\n" + " It is the equivalent of (and is implemented by)\n" + " running \"cat\", editing locally, and then \"write\".\n" + "\n" + " Normally it uses $EDITOR, but if you use the aliases\n" + " \"vi\" or \"emacs\" you will get those editors.\n" + "\n" + " NOTE: This will not work reliably for large files\n" + " (> 2 MB) or binary files containing \\0 bytes.\n")); + else if (STRCASEEQ (cmd, "lcd")) + printf (_("lcd - local change directory\n" + " lcd \n" + "\n" + " Change guestfish's current directory. This command is\n" + " useful if you want to download files to a particular\n" + " place.\n")); + else if (STRCASEEQ (cmd, "glob")) + printf (_("glob - expand wildcards in command\n" + " glob [ ...]\n" + "\n" + " Glob runs with wildcards expanded in any\n" + " command args. Note that the command is run repeatedly\n" + " once for each expanded argument.\n")); + else if (STRCASEEQ (cmd, "man") || + STRCASEEQ (cmd, "manual")) + printf (_("man - read the manual\n" + " man\n" + "\n" + " Opens the manual page for guestfish.\n")); + else if (STRCASEEQ (cmd, "help")) + printf (_("help - display a list of commands or help on a command\n" + " help cmd\n" + " help\n")); + else if (STRCASEEQ (cmd, "more") || + STRCASEEQ (cmd, "less")) + printf (_("more - view a file in the pager\n" + " more \n" + "\n" + " This is used to view a file in the pager.\n" + "\n" + " It is the equivalent of (and is implemented by)\n" + " running \"cat\" and using the pager.\n" + "\n" + " Normally it uses $PAGER, but if you use the alias\n" + " \"less\" then it always uses \"less\".\n" + "\n" + " NOTE: This will not work reliably for large files\n" + " (> 2 MB) or binary files containing \\0 bytes.\n")); + else if (STRCASEEQ (cmd, "quit") || + STRCASEEQ (cmd, "exit") || + STRCASEEQ (cmd, "q")) + printf (_("quit - quit guestfish\n" + " quit\n")); + else if (STRCASEEQ (cmd, "reopen")) + printf (_("reopen - close and reopen the libguestfs handle\n" + " reopen\n" + "\n" + "Close and reopen the libguestfs handle. It is not necessary to use\n" + "this normally, because the handle is closed properly when guestfish\n" + "exits. However this is occasionally useful for testing.\n")); + else if (STRCASEEQ (cmd, "sparse")) + printf (_("sparse - allocate a sparse image file\n" + " sparse \n" + "\n" + " This creates an empty sparse file of the given size,\n" + " and then adds so it can be further examined.\n" + "\n" + " In all respects it works the same as the 'alloc'\n" + " command, except that the image file is allocated\n" + " sparsely, which means that disk blocks are not assigned\n" + " to the file until they are needed. Sparse disk files\n" + " only use space when written to, but they are slower\n" + " and there is a danger you could run out of real disk\n" + " space during a write operation.\n" + "\n" + " For more advanced image creation, see qemu-img utility.\n" + "\n" + " Size can be specified (where means a number):\n" + " number of kilobytes\n" + " eg: 1440 standard 3.5\" floppy\n" + " K or KB number of kilobytes\n" + " M or MB number of megabytes\n" + " G or GB number of gigabytes\n" + " T or TB number of terabytes\n" + " P or PB number of petabytes\n" + " E or EB number of exabytes\n" + " sects number of 512 byte sectors\n")); + else if (STRCASEEQ (cmd, "time")) + printf (_("time - measure time taken to run command\n" + " time [ ...]\n" + "\n" + " This runs as usual, and prints the elapsed\n" + " time afterwards.\n")); else - fprintf (stderr, "%s: command not known, use -h to list all commands\n", - cmd); + fprintf (stderr, _("%s: command not known, use -h to list all commands\n"), + cmd); } -/* Parse size parameter of alloc command. */ -static int -parse_size (const char *str, off_t *size_rtn) +/* This is printed when the user types in an unknown command for the + * first command issued. A common case is the user doing: + * guestfish disk.img + * expecting guestfish to open 'disk.img' (in fact, this tried to + * run a command 'disk.img'). + */ +void +extended_help_message (void) +{ + fprintf (stderr, + _("Did you mean to open a disk image? guestfish -a disk.img\n" + "For a list of commands: guestfish -h\n" + "For complete documentation: man guestfish\n")); +} + +void +free_strings (char **argv) +{ + int argc; + + for (argc = 0; argv[argc] != NULL; ++argc) + free (argv[argc]); + free (argv); +} + +int +count_strings (char *const *argv) +{ + int c; + + for (c = 0; argv[c]; ++c) + ; + return c; +} + +void +print_strings (char *const *argv) +{ + int argc; + + for (argc = 0; argv[argc] != NULL; ++argc) + printf ("%s\n", argv[argc]); +} + +void +print_table (char *const *argv) +{ + int i; + + for (i = 0; argv[i] != NULL; i += 2) + printf ("%s: %s\n", argv[i], argv[i+1]); +} + +int +is_true (const char *str) +{ + return + STRCASENEQ (str, "0") && + STRCASENEQ (str, "f") && + STRCASENEQ (str, "false") && + STRCASENEQ (str, "n") && + STRCASENEQ (str, "no"); +} + +/* Free strings from a non-NULL terminated char** */ +static void +free_n_strings (char **str, size_t len) { - uint64_t size; - char type; + size_t i; + + for (i = 0; i < len; i++) { + free (str[i]); + } + free (str); +} - /* Note that the parsing here is looser than what is specified in the - * help, but we may tighten it up in future so beware. +char ** +parse_string_list (const char *str) +{ + char **argv = NULL; + size_t argv_len = 0; + + /* Current position pointer */ + const char *p = str; + + /* Token might be simple: + * Token + * or be quoted: + * 'This is a single token' + * or contain embedded single-quoted sections: + * This' is a sing'l'e to'ken + * + * The latter may seem over-complicated, but it's what a normal shell does. + * Not doing it risks surprising somebody. + * + * This outer loop is over complete tokens. */ - if (sscanf (str, "%"SCNu64"%c", &size, &type) == 2) { - switch (type) { - case 'k': case 'K': size *= 1024; break; - case 'm': case 'M': size *= 1024 * 1024; break; - case 'g': case 'G': size *= 1024 * 1024 * 1024; break; - case 's': size *= 512; break; - default: - fprintf (stderr, "could not parse size specification '%s'\n", str); + while (*p) { + char *tok = NULL; + size_t tok_len = 0; + + /* Skip leading whitespace */ + p += strspn (p, " \t"); + + char in_quote = 0; + + /* This loop is over token 'fragments'. A token can be in multiple bits if + * it contains single quotes. We also treat both sides of an escaped quote + * as separate fragments because we can't just copy it: we have to remove + * the \. + */ + while (*p && (!c_isblank (*p) || in_quote)) { + const char *end = p; + + /* Check if the fragment starts with a quote */ + if ('\'' == *p) { + /* Toggle in_quote */ + in_quote = !in_quote; + + /* Skip the quote */ + p++; end++; + } + + /* If we're in a quote, look for an end quote */ + if (in_quote) { + end += strcspn (end, "'"); + } + + /* Otherwise, look for whitespace or a quote */ + else { + end += strcspn (end, " \t'"); + } + + /* Grow the token to accommodate the fragment */ + size_t tok_end = tok_len; + tok_len += end - p; + char *tok_new = realloc (tok, tok_len + 1); + if (NULL == tok_new) { + perror ("realloc"); + free_n_strings (argv, argv_len); + free (tok); + exit (EXIT_FAILURE); + } + tok = tok_new; + + /* Check if we stopped on an escaped quote */ + if ('\'' == *end && end != p && *(end-1) == '\\') { + /* Add everything before \' to the token */ + memcpy (&tok[tok_end], p, end - p - 1); + + /* Add the quote */ + tok[tok_len-1] = '\''; + + /* Already processed the quote */ + p = end + 1; + } + + else { + /* Add the whole fragment */ + memcpy (&tok[tok_end], p, end - p); + + p = end; + } + } + + /* We've reached the end of a token. We shouldn't still be in quotes. */ + if (in_quote) { + fprintf (stderr, _("Runaway quote in string \"%s\"\n"), str); + + free_n_strings (argv, argv_len); + + return NULL; + } + + /* Add this token if there is one. There might not be if there was + * whitespace at the end of the input string */ + if (tok) { + /* Add the NULL terminator */ + tok[tok_len] = '\0'; + + /* Add the argument to the argument list */ + argv_len++; + char **argv_new = realloc (argv, sizeof (*argv) * argv_len); + if (NULL == argv_new) { + perror ("realloc"); + free_n_strings (argv, argv_len-1); + free (tok); + exit (EXIT_FAILURE); + } + argv = argv_new; + + argv[argv_len-1] = tok; + } + } + + /* NULL terminate the argument list */ + argv_len++; + char **argv_new = realloc (argv, sizeof (*argv) * argv_len); + if (NULL == argv_new) { + perror ("realloc"); + free_n_strings (argv, argv_len-1); + exit (EXIT_FAILURE); + } + argv = argv_new; + + argv[argv_len-1] = NULL; + + return argv; +} + +#ifdef HAVE_LIBREADLINE +static char histfile[1024]; +static int nr_history_lines = 0; +#endif + +static void +initialize_readline (void) +{ +#ifdef HAVE_LIBREADLINE + const char *home; + + home = getenv ("HOME"); + if (home) { + snprintf (histfile, sizeof histfile, "%s/.guestfish", home); + using_history (); + (void) read_history (histfile); + } + + rl_readline_name = "guestfish"; + rl_attempted_completion_function = do_completion; +#endif +} + +static void +cleanup_readline (void) +{ +#ifdef HAVE_LIBREADLINE + int fd; + + if (histfile[0] != '\0') { + fd = open (histfile, O_WRONLY|O_CREAT, 0644); + if (fd == -1) { + perror (histfile); + return; + } + close (fd); + +#ifdef HAVE_APPEND_HISTORY + (void) append_history (nr_history_lines, histfile); +#else + (void) write_history (histfile); +#endif + } +#endif +} + +#ifdef HAVE_LIBREADLINE +static void +add_history_line (const char *line) +{ + add_history (line); + nr_history_lines++; +} +#endif + +int +xwrite (int fd, const void *v_buf, size_t len) +{ + int r; + const char *buf = v_buf; + + while (len > 0) { + r = write (fd, buf, len); + if (r == -1) { + perror ("write"); return -1; } + buf += r; + len -= r; + } + + return 0; +} + +/* Resolve the special "win:..." form for Windows-specific paths. + * This always returns a newly allocated string which is freed by the + * caller function in "cmds.c". + */ +char * +resolve_win_path (const char *path) +{ + char *ret; + size_t i; + + if (STRCASENEQLEN (path, "win:", 4)) { + ret = strdup (path); + if (ret == NULL) + perror ("strdup"); + return ret; + } + + path += 4; + + /* Drop drive letter, if it's "C:". */ + if (STRCASEEQLEN (path, "c:", 2)) + path += 2; + + if (!*path) { + ret = strdup ("/"); + if (ret == NULL) + perror ("strdup"); + return ret; + } + + ret = strdup (path); + if (ret == NULL) { + perror ("strdup"); + return NULL; + } + + /* Blindly convert any backslashes into forward slashes. Is this good? */ + for (i = 0; i < strlen (ret); ++i) + if (ret[i] == '\\') + ret[i] = '/'; + + char *t = guestfs_case_sensitive_path (g, ret); + free (ret); + ret = t; + + return ret; +} + +/* Resolve the special FileIn paths ("-" or "-< or "END\n" in input. */ + size_t blen = strlen (buffer); + if (STREQLEN (buffer, endmarker, markerlen) && + (blen == markerlen || + (blen == markerlen+1 && buffer[markerlen] == '\n'))) + goto found_end; + + if (xwrite (fd, buffer, blen) == -1) { + if (!write_error) perror ("write"); + write_error = 1; + /* continue reading up to the end marker */ + } + } + + /* Reached EOF of stdin without finding the end marker, which + * is likely to be an error. */ - *size_rtn = size; + fprintf (stderr, "%s: end of input reached without finding '%s'\n", + program_name, endmarker); + goto error2; + + found_end: + if (write_error) { + close (fd); + goto error2; + } - return 0; + if (close (fd) == -1) { + perror ("close"); + goto error2; + } + + return file_in_tmpfile; + + error2: + unlink (file_in_tmpfile); + + error1: + free (file_in_tmpfile); + file_in_tmpfile = NULL; + return NULL; } void -free_strings (char **argv) +free_file_in (char *s) { - int argc; + if (file_in_tmpfile) { + if (unlink (file_in_tmpfile) == -1) + perror (file_in_tmpfile); + file_in_tmpfile = NULL; + } - for (argc = 0; argv[argc] != NULL; ++argc) - free (argv[argc]); - free (argv); + /* Free the device or file name which was strdup'd in file_in(). + * Note it's not immediately clear, but for -<< heredocs, + * s == file_in_tmpfile, so this frees up that buffer. + */ + free (s); } -void -print_strings (char **argv) +/* Resolve the special FileOut paths ("-" or filename). + * The caller (cmds.c) will call free (str) after the command has run. + */ +char * +file_out (const char *arg) { - int argc; + char *ret; - for (argc = 0; argv[argc] != NULL; ++argc) - printf ("%s\n", argv[argc]); + if (STREQ (arg, "-")) + ret = strdup ("/dev/stdout"); + else + ret = strdup (arg); + + if (!ret) { + perror ("strdup"); + return NULL; + } + return ret; +} + +static void +print_shell_quote (FILE *stream, const char *str) +{ +#define SAFE(c) (c_isalnum((c)) || \ + (c) == '/' || (c) == '-' || (c) == '_' || (c) == '.') + int i; + + for (i = 0; str[i]; ++i) { + if (!SAFE(str[i])) + putc ('\\', stream); + putc (str[i], stream); + } }