daemon/guestfsd.c

   1 /* libguestfs - the guestfsd daemon
   2  * Copyright (C) 2009-2011 Red Hat Inc.
   3  *
   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.
   8  *
   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.
  13  *
  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.
  17  */
  18
  19 #include <config.h>
  20
  21 #ifdef HAVE_WINDOWS_H
  22 # include <windows.h>
  23 #endif
  24
  25 #include <stdio.h>
  26 #include <stdlib.h>
  27 #include <string.h>
  28 #include <unistd.h>
  29 #include <rpc/types.h>
  30 #include <rpc/xdr.h>
  31 #include <getopt.h>
  32 #include <sys/param.h>
  33 #include <sys/types.h>
  34 #include <sys/stat.h>
  35 #include <fcntl.h>
  36 #include <signal.h>
  37 #include <netdb.h>
  38 #include <sys/select.h>
  39 #include <sys/wait.h>
  40 #include <arpa/inet.h>
  41 #include <netinet/in.h>
  42 #include <errno.h>
  43
  44 #ifdef HAVE_PRINTF_H
  45 # include <printf.h>
  46 #endif
  47
  48 #include "sockets.h"
  49 #include "c-ctype.h"
  50 #include "ignore-value.h"
  51 #include "error.h"
  52
  53 #include "daemon.h"
  54
  55 static char *read_cmdline (void);
  56
  57 #ifndef MAX
  58 # define MAX(a,b) ((a)>(b)?(a):(b))
  59 #endif
  60
  61 /* Not the end of the world if this open flag is not defined. */
  62 #ifndef O_CLOEXEC
  63 # define O_CLOEXEC 0
  64 #endif
  65
  66 /* If root device is an ext2 filesystem, this is the major and minor.
  67  * This is so we can ignore this device from the point of view of the
  68  * user, eg. in guestfs_list_devices and many other places.
  69  */
  70 static dev_t root_device = 0;
  71
  72 int verbose = 0;
  73
  74 static int print_shell_quote (FILE *stream, const struct printf_info *info, const void *const *args);
  75 static int print_sysroot_shell_quote (FILE *stream, const struct printf_info *info, const void *const *args);
  76 #ifdef HAVE_REGISTER_PRINTF_SPECIFIER
  77 static int print_arginfo (const struct printf_info *info, size_t n, int *argtypes, int *size);
  78 #else
  79 #ifdef HAVE_REGISTER_PRINTF_FUNCTION
  80 static int print_arginfo (const struct printf_info *info, size_t n, int *argtypes);
  81 #else
  82 #error "HAVE_REGISTER_PRINTF_{SPECIFIER|FUNCTION} not defined"
  83 #endif
  84 #endif
  85
  86 #ifdef WIN32
  87 static int
  88 winsock_init (void)
  89 {
  90   int r;
  91
  92   /* http://msdn2.microsoft.com/en-us/library/ms742213.aspx */
  93   r = gl_sockets_startup (SOCKETS_2_2);
  94   return r == 0 ? 0 : -1;
  95 }
  96 #else /* !WIN32 */
  97 static int
  98 winsock_init (void)
  99 {
 100   return 0;
 101 }
 102 #endif /* !WIN32 */
 103
 104 /* Location to mount root device. */
 105 const char *sysroot = "/sysroot"; /* No trailing slash. */
 106 size_t sysroot_len = 8;
 107
 108 /* If set (the default), do 'umount-all' when performing autosync. */
 109 int autosync_umount = 1;
 110
 111 /* Not used explicitly, but required by the gnulib 'error' module. */
 112 const char *program_name = "guestfsd";
 113
 114 static void
 115 usage (void)
 116 {
 117   fprintf (stderr,
 118     "guestfsd [-r] [-v|--verbose]\n");
 119 }
 120
 121 int
 122 main (int argc, char *argv[])
 123 {
 124   static const char *options = "rv?";
 125   static const struct option long_options[] = {
 126     { "help", 0, 0, '?' },
 127     { "verbose", 0, 0, 'v' },
 128     { 0, 0, 0, 0 }
 129   };
 130   int c;
 131   char *cmdline;
 132
 133   ignore_value (chdir ("/"));
 134
 135   if (winsock_init () == -1)
 136     error (EXIT_FAILURE, 0, "winsock initialization failed");
 137
 138 #ifdef HAVE_REGISTER_PRINTF_SPECIFIER
 139   /* http://udrepper.livejournal.com/20948.html */
 140   register_printf_specifier ('Q', print_shell_quote, print_arginfo);
 141   register_printf_specifier ('R', print_sysroot_shell_quote, print_arginfo);
 142 #else
 143 #ifdef HAVE_REGISTER_PRINTF_FUNCTION
 144   register_printf_function ('Q', print_shell_quote, print_arginfo);
 145   register_printf_function ('R', print_sysroot_shell_quote, print_arginfo);
 146 #else
 147 #error "HAVE_REGISTER_PRINTF_{SPECIFIER|FUNCTION} not defined"
 148 #endif
 149 #endif
 150
 151   struct stat statbuf;
 152   if (stat ("/", &statbuf) == 0)
 153     root_device = statbuf.st_dev;
 154
 155   for (;;) {
 156     c = getopt_long (argc, argv, options, long_options, NULL);
 157     if (c == -1) break;
 158
 159     switch (c) {
 160       /* The -r flag is used when running standalone.  It changes
 161        * several aspects of the daemon.
 162        */
 163     case 'r':
 164       sysroot = "";
 165       sysroot_len = 0;
 166       autosync_umount = 0;
 167       break;
 168
 169     case 'v':
 170       verbose = 1;
 171       break;
 172
 173     case '?':
 174       usage ();
 175       exit (EXIT_SUCCESS);
 176
 177     default:
 178       fprintf (stderr, "guestfsd: unexpected command line option 0x%x\n", c);
 179       exit (EXIT_FAILURE);
 180     }
 181   }
 182
 183   if (optind < argc) {
 184     usage ();
 185     exit (EXIT_FAILURE);
 186   }
 187
 188   cmdline = read_cmdline ();
 189
 190   /* Set the verbose flag. */
 191   verbose = verbose ||
 192     (cmdline && strstr (cmdline, "guestfs_verbose=1") != NULL);
 193   if (verbose)
 194     printf ("verbose daemon enabled\n");
 195
 196   if (verbose) {
 197     if (cmdline)
 198       printf ("linux commmand line: %s\n", cmdline);
 199     else
 200       printf ("could not read linux command line\n");
 201   }
 202
 203 #ifndef WIN32
 204   /* Make sure SIGPIPE doesn't kill us. */
 205   struct sigaction sa;
 206   memset (&sa, 0, sizeof sa);
 207   sa.sa_handler = SIG_IGN;
 208   sa.sa_flags = 0;
 209   if (sigaction (SIGPIPE, &sa, NULL) == -1)
 210     perror ("sigaction SIGPIPE"); /* but try to continue anyway ... */
 211 #endif
 212
 213 #ifdef WIN32
 214 # define setenv(n,v,f) _putenv(n "=" v)
 215 #endif
 216   /* Set up a basic environment.  After we are called by /init the
 217    * environment is essentially empty.
 218    * https://bugzilla.redhat.com/show_bug.cgi?id=502074#c5
 219    *
 220    * NOTE: if you change $PATH, you must also change 'prog_exists'
 221    * function below.
 222    */
 223   setenv ("PATH", "/sbin:/usr/sbin:/bin:/usr/bin", 1);
 224   setenv ("SHELL", "/bin/sh", 1);
 225   setenv ("LC_ALL", "C", 1);
 226   setenv ("TERM", "dumb", 1);
 227
 228 #ifndef WIN32
 229   /* We document that umask defaults to 022 (it should be this anyway). */
 230   umask (022);
 231 #else
 232   /* This is the default for Windows anyway.  It's not even clear if
 233    * Windows ever uses this -- the MSDN documentation for the function
 234    * contains obvious errors.
 235    */
 236   _umask (0);
 237 #endif
 238
 239   /* Connect to virtio-serial channel. */
 240   int sock = open ("/dev/virtio-ports/org.libguestfs.channel.0",
 241                    O_RDWR | O_CLOEXEC);
 242   if (sock == -1) {
 243     fprintf (stderr,
 244              "\n"
 245              "Failed to connect to virtio-serial channel.\n"
 246              "\n"
 247              "This is a fatal error and the appliance will now exit.\n"
 248              "\n"
 249              "Usually this error is caused by either QEMU or the appliance\n"
 250              "kernel not supporting the vmchannel method that the\n"
 251              "libguestfs library chose to use.  Please run\n"
 252              "'libguestfs-test-tool' and provide the complete, unedited\n"
 253              "output to the libguestfs developers, either in a bug report\n"
 254              "or on the libguestfs redhat com mailing list.\n"
 255              "\n");
 256     perror ("/dev/virtio-ports/org.libguestfs.channel.0");
 257     exit (EXIT_FAILURE);
 258   }
 259
 260   /* Send the magic length message which indicates that
 261    * userspace is up inside the guest.
 262    */
 263   char lenbuf[4];
 264   XDR xdr;
 265   uint32_t len = GUESTFS_LAUNCH_FLAG;
 266   xdrmem_create (&xdr, lenbuf, sizeof lenbuf, XDR_ENCODE);
 267   xdr_u_int (&xdr, &len);
 268
 269   if (xwrite (sock, lenbuf, sizeof lenbuf) == -1) {
 270     perror ("xwrite");
 271     exit (EXIT_FAILURE);
 272   }
 273
 274   xdr_destroy (&xdr);
 275
 276   /* Enter the main loop, reading and performing actions. */
 277   main_loop (sock);
 278
 279   exit (EXIT_SUCCESS);
 280 }
 281
 282 /* Read /proc/cmdline. */
 283 static char *
 284 read_cmdline (void)
 285 {
 286   int fd = open ("/proc/cmdline", O_RDONLY);
 287   if (fd == -1) {
 288     perror ("/proc/cmdline");
 289     return NULL;
 290   }
 291
 292   size_t len = 0;
 293   ssize_t n;
 294   char buf[256];
 295   char *r = NULL;
 296
 297   for (;;) {
 298     n = read (fd, buf, sizeof buf);
 299     if (n == -1) {
 300       perror ("read");
 301       free (r);
 302       close (fd);
 303       return NULL;
 304     }
 305     if (n == 0)
 306       break;
 307     char *newr = realloc (r, len + n + 1); /* + 1 is for terminating NUL */
 308     if (newr == NULL) {
 309       perror ("realloc");
 310       free (r);
 311       close (fd);
 312       return NULL;
 313     }
 314     r = newr;
 315     memcpy (&r[len], buf, n);
 316     len += n;
 317   }
 318
 319   if (r)
 320     r[len] = '\0';
 321
 322   if (close (fd) == -1) {
 323     perror ("close");
 324     free (r);
 325     return NULL;
 326   }
 327
 328   return r;
 329 }
 330
 331 /* Return true iff device is the root device (and therefore should be
 332  * ignored from the point of view of user calls).
 333  */
 334 int
 335 is_root_device (const char *device)
 336 {
 337   struct stat statbuf;
 338   if (stat (device, &statbuf) == -1) {
 339     perror (device);
 340     return 0;
 341   }
 342   if (statbuf.st_rdev == root_device)
 343     return 1;
 344   return 0;
 345 }
 346
 347 /* Turn "/path" into "/sysroot/path".
 348  *
 349  * Caller must check for NULL and call reply_with_perror ("malloc")
 350  * if it is.  Caller must also free the string.
 351  *
 352  * See also the custom %R printf formatter which does shell quoting too.
 353  */
 354 char *
 355 sysroot_path (const char *path)
 356 {
 357   char *r;
 358   int len = strlen (path) + sysroot_len + 1;
 359
 360   r = malloc (len);
 361   if (r == NULL)
 362     return NULL;
 363
 364   snprintf (r, len, "%s%s", sysroot, path);
 365   return r;
 366 }
 367
 368 int
 369 xwrite (int sock, const void *v_buf, size_t len)
 370 {
 371   int r;
 372   const char *buf = v_buf;
 373
 374   while (len > 0) {
 375     r = write (sock, buf, len);
 376     if (r == -1) {
 377       perror ("write");
 378       return -1;
 379     }
 380     buf += r;
 381     len -= r;
 382   }
 383
 384   return 0;
 385 }
 386
 387 int
 388 xread (int sock, void *v_buf, size_t len)
 389 {
 390   int r;
 391   char *buf = v_buf;
 392
 393   while (len > 0) {
 394     r = read (sock, buf, len);
 395     if (r == -1) {
 396       perror ("read");
 397       return -1;
 398     }
 399     if (r == 0) {
 400       fprintf (stderr, "read: unexpected end of file on fd %d\n", sock);
 401       return -1;
 402     }
 403     buf += r;
 404     len -= r;
 405   }
 406
 407   return 0;
 408 }
 409
 410 int
 411 add_string (char ***argv, int *size, int *alloc, const char *str)
 412 {
 413   char **new_argv;
 414   char *new_str;
 415
 416   if (*size >= *alloc) {
 417     *alloc += 64;
 418     new_argv = realloc (*argv, *alloc * sizeof (char *));
 419     if (new_argv == NULL) {
 420       reply_with_perror ("realloc");
 421       free_strings (*argv);
 422       return -1;
 423     }
 424     *argv = new_argv;
 425   }
 426
 427   if (str) {
 428     new_str = strdup (str);
 429     if (new_str == NULL) {
 430       reply_with_perror ("strdup");
 431       free_strings (*argv);
 432       return -1;
 433     }
 434   } else
 435     new_str = NULL;
 436
 437   (*argv)[*size] = new_str;
 438
 439   (*size)++;
 440   return 0;
 441 }
 442
 443 size_t
 444 count_strings (char *const *argv)
 445 {
 446   size_t argc;
 447
 448   for (argc = 0; argv[argc] != NULL; ++argc)
 449     ;
 450   return argc;
 451 }
 452
 453 /* http://graphics.stanford.edu/~seander/bithacks.html#DetermineIfPowerOf2 */
 454 int
 455 is_power_of_2 (unsigned long v)
 456 {
 457   return v && ((v & (v - 1)) == 0);
 458 }
 459
 460 static int
 461 compare (const void *vp1, const void *vp2)
 462 {
 463   char * const *p1 = (char * const *) vp1;
 464   char * const *p2 = (char * const *) vp2;
 465   return strcmp (*p1, *p2);
 466 }
 467
 468 void
 469 sort_strings (char **argv, int len)
 470 {
 471   qsort (argv, len, sizeof (char *), compare);
 472 }
 473
 474 void
 475 free_strings (char **argv)
 476 {
 477   int argc;
 478
 479   for (argc = 0; argv[argc] != NULL; ++argc)
 480     free (argv[argc]);
 481   free (argv);
 482 }
 483
 484 void
 485 free_stringslen (char **argv, int len)
 486 {
 487   int i;
 488
 489   for (i = 0; i < len; ++i)
 490     free (argv[i]);
 491   free (argv);
 492 }
 493
 494 /* Easy ways to run external commands.  For full documentation, see
 495  * 'commandrvf' below.
 496  */
 497 int
 498 commandf (char **stdoutput, char **stderror, int flags, const char *name, ...)
 499 {
 500   va_list args;
 501   const char **argv;
 502   char *s;
 503   int i, r;
 504
 505   /* Collect the command line arguments into an array. */
 506   i = 2;
 507   argv = malloc (sizeof (char *) * i);
 508   if (argv == NULL) {
 509     perror ("malloc");
 510     return -1;
 511   }
 512   argv[0] = (char *) name;
 513   argv[1] = NULL;
 514
 515   va_start (args, name);
 516
 517   while ((s = va_arg (args, char *)) != NULL) {
 518     const char **p = realloc (argv, sizeof (char *) * (++i));
 519     if (p == NULL) {
 520       perror ("realloc");
 521       free (argv);
 522       va_end (args);
 523       return -1;
 524     }
 525     argv = p;
 526     argv[i-2] = s;
 527     argv[i-1] = NULL;
 528   }
 529
 530   va_end (args);
 531
 532   r = commandvf (stdoutput, stderror, flags, (const char * const*) argv);
 533
 534   /* NB: Mustn't free the strings which are on the stack. */
 535   free (argv);
 536
 537   return r;
 538 }
 539
 540 /* Same as 'command', but we allow the status code from the
 541  * subcommand to be non-zero, and return that status code.
 542  * We still return -1 if there was some other error.
 543  */
 544 int
 545 commandrf (char **stdoutput, char **stderror, int flags, const char *name, ...)
 546 {
 547   va_list args;
 548   const char **argv;
 549   char *s;
 550   int i, r;
 551
 552   /* Collect the command line arguments into an array. */
 553   i = 2;
 554   argv = malloc (sizeof (char *) * i);
 555   if (argv == NULL) {
 556     perror ("malloc");
 557     return -1;
 558   }
 559   argv[0] = (char *) name;
 560   argv[1] = NULL;
 561
 562   va_start (args, name);
 563
 564   while ((s = va_arg (args, char *)) != NULL) {
 565     const char **p = realloc (argv, sizeof (char *) * (++i));
 566     if (p == NULL) {
 567       perror ("realloc");
 568       free (argv);
 569       va_end (args);
 570       return -1;
 571     }
 572     argv = p;
 573     argv[i-2] = s;
 574     argv[i-1] = NULL;
 575   }
 576
 577   va_end (args);
 578
 579   r = commandrvf (stdoutput, stderror, flags, argv);
 580
 581   /* NB: Mustn't free the strings which are on the stack. */
 582   free (argv);
 583
 584   return r;
 585 }
 586
 587 /* Same as 'command', but passing an argv. */
 588 int
 589 commandvf (char **stdoutput, char **stderror, int flags,
 590            char const *const *argv)
 591 {
 592   int r;
 593
 594   r = commandrvf (stdoutput, stderror, flags, (void *) argv);
 595   if (r == 0)
 596     return 0;
 597   else
 598     return -1;
 599 }
 600
 601 /* This is a more sane version of 'system(3)' for running external
 602  * commands.  It uses fork/execvp, so we don't need to worry about
 603  * quoting of parameters, and it allows us to capture any error
 604  * messages in a buffer.
 605  *
 606  * If stdoutput is not NULL, then *stdoutput will return the stdout
 607  * of the command.
 608  *
 609  * If stderror is not NULL, then *stderror will return the stderr
 610  * of the command.  If there is a final \n character, it is removed
 611  * so you can use the error string directly in a call to
 612  * reply_with_error.
 613  *
 614  * Flags:
 615  *
 616  * COMMAND_FLAG_FOLD_STDOUT_ON_STDERR: For broken external commands
 617  * that send error messages to stdout (hello, parted) but that don't
 618  * have any useful stdout information, use this flag to capture the
 619  * error messages in the *stderror buffer.  If using this flag,
 620  * you should pass stdoutput as NULL because nothing could ever be
 621  * captured in that buffer.
 622  *
 623  * COMMAND_FLAG_CHROOT_COPY_FILE_TO_STDIN: For running external
 624  * commands on chrooted files correctly (see RHBZ#579608) specifying
 625  * this flag causes another process to be forked which chroots into
 626  * sysroot and just copies the input file to stdin of the specified
 627  * command.  The file descriptor is ORed with the flags, and that file
 628  * descriptor is always closed by this function.  See hexdump.c for an
 629  * example of usage.
 630  */
 631 int
 632 commandrvf (char **stdoutput, char **stderror, int flags,
 633             char const* const *argv)
 634 {
 635   int so_size = 0, se_size = 0;
 636   int so_fd[2], se_fd[2];
 637   int flag_copy_stdin = flags & COMMAND_FLAG_CHROOT_COPY_FILE_TO_STDIN;
 638   int stdin_fd[2] = { -1, -1 };
 639   pid_t pid, stdin_pid = -1;
 640   int r, quit, i;
 641   fd_set rset, rset2;
 642   char buf[256];
 643   char *p;
 644
 645   if (stdoutput) *stdoutput = NULL;
 646   if (stderror) *stderror = NULL;
 647
 648   if (verbose) {
 649     printf ("%s", argv[0]);
 650     for (i = 1; argv[i] != NULL; ++i)
 651       printf (" %s", argv[i]);
 652     printf ("\n");
 653   }
 654
 655   /* Note: abort is used in a few places along the error paths early
 656    * in this function.  This is because (a) cleaning up correctly is
 657    * very complex at these places and (b) abort is used when a
 658    * resource problems is indicated which would be due to much more
 659    * serious issues - eg. memory or file descriptor leaks.  We
 660    * wouldn't expect fork(2) or pipe(2) to fail in normal
 661    * circumstances.
 662    */
 663
 664   if (pipe (so_fd) == -1 || pipe (se_fd) == -1) {
 665     error (0, errno, "pipe");
 666     abort ();
 667   }
 668
 669   if (flag_copy_stdin) {
 670     if (pipe (stdin_fd) == -1) {
 671       error (0, errno, "pipe");
 672       abort ();
 673     }
 674   }
 675
 676   pid = fork ();
 677   if (pid == -1) {
 678     error (0, errno, "fork");
 679     abort ();
 680   }
 681
 682   if (pid == 0) {               /* Child process running the command. */
 683     signal (SIGALRM, SIG_DFL);
 684     signal (SIGPIPE, SIG_DFL);
 685     close (0);
 686     if (flag_copy_stdin) {
 687       dup2 (stdin_fd[0], 0);
 688       close (stdin_fd[0]);
 689       close (stdin_fd[1]);
 690     } else {
 691       /* Set stdin to /dev/null (ignore failure) */
 692       open ("/dev/null", O_RDONLY);
 693     }
 694     close (so_fd[0]);
 695     close (se_fd[0]);
 696     if (!(flags & COMMAND_FLAG_FOLD_STDOUT_ON_STDERR))
 697       dup2 (so_fd[1], 1);
 698     else
 699       dup2 (se_fd[1], 1);
 700     dup2 (se_fd[1], 2);
 701     close (so_fd[1]);
 702     close (se_fd[1]);
 703
 704     execvp (argv[0], (void *) argv);
 705     perror (argv[0]);
 706     _exit (EXIT_FAILURE);
 707   }
 708
 709   if (flag_copy_stdin) {
 710     int fd = flags & COMMAND_FLAG_FD_MASK;
 711
 712     stdin_pid = fork ();
 713     if (stdin_pid == -1) {
 714       error (0, errno, "fork");
 715       abort ();
 716     }
 717
 718     if (stdin_pid == 0) {       /* Child process copying stdin. */
 719       close (so_fd[0]);
 720       close (so_fd[1]);
 721       close (se_fd[0]);
 722       close (se_fd[1]);
 723
 724       close (1);
 725       dup2 (stdin_fd[1], 1);
 726       close (stdin_fd[0]);
 727       close (stdin_fd[1]);
 728
 729       if (chroot (sysroot) == -1) {
 730         perror ("chroot");
 731         _exit (EXIT_FAILURE);
 732       }
 733
 734       ssize_t n;
 735       char buffer[BUFSIZ];
 736       while ((n = read (fd, buffer, sizeof buffer)) > 0) {
 737         if (xwrite (1, buffer, n) == -1)
 738           /* EPIPE error indicates the command process has exited
 739            * early.  If the command process fails that will be caught
 740            * by the daemon, and if not, then it's not an error.
 741            */
 742           _exit (errno == EPIPE ? EXIT_SUCCESS : EXIT_FAILURE);
 743       }
 744
 745       if (n == -1) {
 746         perror ("read");
 747         _exit (EXIT_FAILURE);
 748       }
 749
 750       if (close (fd) == -1) {
 751         perror ("close");
 752         _exit (EXIT_FAILURE);
 753       }
 754
 755       _exit (EXIT_SUCCESS);
 756     }
 757
 758     close (fd);
 759     close (stdin_fd[0]);
 760     close (stdin_fd[1]);
 761   }
 762
 763   /* Parent process. */
 764   close (so_fd[1]);
 765   close (se_fd[1]);
 766
 767   FD_ZERO (&rset);
 768   FD_SET (so_fd[0], &rset);
 769   FD_SET (se_fd[0], &rset);
 770
 771   quit = 0;
 772   while (quit < 2) {
 773   again:
 774     rset2 = rset;
 775     r = select (MAX (so_fd[0], se_fd[0]) + 1, &rset2, NULL, NULL, NULL);
 776     if (r == -1) {
 777       if (errno == EINTR)
 778         goto again;
 779
 780       perror ("select");
 781     quit:
 782       if (stdoutput) free (*stdoutput);
 783       if (stderror) free (*stderror);
 784       close (so_fd[0]);
 785       close (se_fd[0]);
 786       waitpid (pid, NULL, 0);
 787       if (stdin_pid >= 0) waitpid (stdin_pid, NULL, 0);
 788       return -1;
 789     }
 790
 791     if (FD_ISSET (so_fd[0], &rset2)) { /* something on stdout */
 792       r = read (so_fd[0], buf, sizeof buf);
 793       if (r == -1) {
 794         perror ("read");
 795         goto quit;
 796       }
 797       if (r == 0) { FD_CLR (so_fd[0], &rset); quit++; }
 798
 799       if (r > 0 && stdoutput) {
 800         so_size += r;
 801         p = realloc (*stdoutput, so_size);
 802         if (p == NULL) {
 803           perror ("realloc");
 804           goto quit;
 805         }
 806         *stdoutput = p;
 807         memcpy (*stdoutput + so_size - r, buf, r);
 808       }
 809     }
 810
 811     if (FD_ISSET (se_fd[0], &rset2)) { /* something on stderr */
 812       r = read (se_fd[0], buf, sizeof buf);
 813       if (r == -1) {
 814         perror ("read");
 815         goto quit;
 816       }
 817       if (r == 0) { FD_CLR (se_fd[0], &rset); quit++; }
 818
 819       if (r > 0) {
 820         if (verbose)
 821           ignore_value (write (2, buf, r));
 822
 823         if (stderror) {
 824           se_size += r;
 825           p = realloc (*stderror, se_size);
 826           if (p == NULL) {
 827             perror ("realloc");
 828             goto quit;
 829           }
 830           *stderror = p;
 831           memcpy (*stderror + se_size - r, buf, r);
 832         }
 833       }
 834     }
 835   }
 836
 837   close (so_fd[0]);
 838   close (se_fd[0]);
 839
 840   /* Make sure the output buffers are \0-terminated.  Also remove any
 841    * trailing \n characters from the error buffer (not from stdout).
 842    */
 843   if (stdoutput) {
 844     void *q = realloc (*stdoutput, so_size+1);
 845     if (q == NULL) {
 846       perror ("realloc");
 847       free (*stdoutput);
 848     }
 849     *stdoutput = q;
 850     if (*stdoutput)
 851       (*stdoutput)[so_size] = '\0';
 852   }
 853   if (stderror) {
 854     void *q = realloc (*stderror, se_size+1);
 855     if (q == NULL) {
 856       perror ("realloc");
 857       free (*stderror);
 858     }
 859     *stderror = q;
 860     if (*stderror) {
 861       (*stderror)[se_size] = '\0';
 862       se_size--;
 863       while (se_size >= 0 && (*stderror)[se_size] == '\n')
 864         (*stderror)[se_size--] = '\0';
 865     }
 866   }
 867
 868   if (flag_copy_stdin) {
 869     /* Check copy process didn't fail. */
 870     if (waitpid (stdin_pid, &r, 0) != stdin_pid) {
 871       perror ("waitpid");
 872       kill (pid, 9);
 873       waitpid (pid, NULL, 0);
 874       return -1;
 875     }
 876
 877     if (!WIFEXITED (r) || WEXITSTATUS (r) != 0) {
 878       fprintf (stderr, "failed copying from input file, see earlier messages\n");
 879       kill (pid, 9);
 880       waitpid (pid, NULL, 0);
 881       return -1;
 882     }
 883   }
 884
 885   /* Get the exit status of the command. */
 886   if (waitpid (pid, &r, 0) != pid) {
 887     perror ("waitpid");
 888     return -1;
 889   }
 890
 891   if (WIFEXITED (r)) {
 892     return WEXITSTATUS (r);
 893   } else
 894     return -1;
 895 }
 896
 897 /* Split an output string into a NULL-terminated list of lines.
 898  * Typically this is used where we have run an external command
 899  * which has printed out a list of things, and we want to return
 900  * an actual list.
 901  *
 902  * The corner cases here are quite tricky.  Note in particular:
 903  *
 904  *   "" -> []
 905  *   "\n" -> [""]
 906  *   "a\nb" -> ["a"; "b"]
 907  *   "a\nb\n" -> ["a"; "b"]
 908  *   "a\nb\n\n" -> ["a"; "b"; ""]
 909  *
 910  * The original string is written over and destroyed by this
 911  * function (which is usually OK because it's the 'out' string
 912  * from command()).  You can free the original string, because
 913  * add_string() strdups the strings.
 914  */
 915 char **
 916 split_lines (char *str)
 917 {
 918   char **lines = NULL;
 919   int size = 0, alloc = 0;
 920   char *p, *pend;
 921
 922   if (STREQ (str, ""))
 923     goto empty_list;
 924
 925   p = str;
 926   while (p) {
 927     /* Empty last line? */
 928     if (p[0] == '\0')
 929       break;
 930
 931     pend = strchr (p, '\n');
 932     if (pend) {
 933       *pend = '\0';
 934       pend++;
 935     }
 936
 937     if (add_string (&lines, &size, &alloc, p) == -1) {
 938       return NULL;
 939     }
 940
 941     p = pend;
 942   }
 943
 944  empty_list:
 945   if (add_string (&lines, &size, &alloc, NULL) == -1)
 946     return NULL;
 947
 948   return lines;
 949 }
 950
 951 /* Skip leading and trailing whitespace, updating the original string
 952  * in-place.
 953  */
 954 void
 955 trim (char *str)
 956 {
 957   size_t len = strlen (str);
 958
 959   while (len > 0 && c_isspace (str[len-1])) {
 960     str[len-1] = '\0';
 961     len--;
 962   }
 963
 964   const char *p = str;
 965   while (*p && c_isspace (*p)) {
 966     p++;
 967     len--;
 968   }
 969
 970   memmove (str, p, len+1);
 971 }
 972
 973 /* printf helper function so we can use %Q ("quoted") and %R to print
 974  * shell-quoted strings.  See guestfs(3)/EXTENDING LIBGUESTFS for more
 975  * details.
 976  */
 977 static int
 978 print_shell_quote (FILE *stream,
 979                    const struct printf_info *info ATTRIBUTE_UNUSED,
 980                    const void *const *args)
 981 {
 982 #define SAFE(c) (c_isalnum((c)) ||                                      \
 983                  (c) == '/' || (c) == '-' || (c) == '_' || (c) == '.')
 984   int i, len;
 985   const char *str = *((const char **) (args[0]));
 986
 987   for (i = len = 0; str[i]; ++i) {
 988     if (!SAFE(str[i])) {
 989       putc ('\\', stream);
 990       len ++;
 991     }
 992     putc (str[i], stream);
 993     len ++;
 994   }
 995
 996   return len;
 997 }
 998
 999 static int
1000 print_sysroot_shell_quote (FILE *stream,
1001                            const struct printf_info *info,
1002                            const void *const *args)
1003 {
1004   fputs (sysroot, stream);
1005   return sysroot_len + print_shell_quote (stream, info, args);
1006 }
1007
1008 #ifdef HAVE_REGISTER_PRINTF_SPECIFIER
1009 static int
1010 print_arginfo (const struct printf_info *info ATTRIBUTE_UNUSED,
1011                size_t n, int *argtypes, int *size)
1012 {
1013   if (n > 0) {
1014     argtypes[0] = PA_STRING;
1015     size[0] = sizeof (const char *);
1016   }
1017   return 1;
1018 }
1019 #else
1020 #ifdef HAVE_REGISTER_PRINTF_FUNCTION
1021 static int
1022 print_arginfo (const struct printf_info *info, size_t n, int *argtypes)
1023 {
1024   if (n > 0)
1025     argtypes[0] = PA_STRING;
1026   return 1;
1027 }
1028 #else
1029 #error "HAVE_REGISTER_PRINTF_{SPECIFIER|FUNCTION} not defined"
1030 #endif
1031 #endif
1032
1033 /* Perform device name translation.  Don't call this directly -
1034  * use the RESOLVE_DEVICE macro.
1035  *
1036  * See guestfs(3) for the algorithm.
1037  *
1038  * We have to open the device and test for ENXIO, because
1039  * the device nodes themselves will exist in the appliance.
1040  */
1041 int
1042 device_name_translation (char *device)
1043 {
1044   int fd;
1045
1046   fd = open (device, O_RDONLY);
1047   if (fd >= 0) {
1048   close_ok:
1049     close (fd);
1050     return 0;
1051   }
1052
1053   if (errno != ENXIO && errno != ENOENT)
1054     return -1;
1055
1056   /* If the name begins with "/dev/sd" then try the alternatives. */
1057   if (STRNEQLEN (device, "/dev/sd", 7))
1058     return -1;
1059
1060   device[5] = 'h';              /* /dev/hd (old IDE driver) */
1061   fd = open (device, O_RDONLY);
1062   if (fd >= 0)
1063     goto close_ok;
1064
1065   device[5] = 'v';              /* /dev/vd (for virtio devices) */
1066   fd = open (device, O_RDONLY);
1067   if (fd >= 0)
1068     goto close_ok;
1069
1070   device[5] = 's';              /* Restore original device name. */
1071   return -1;
1072 }
1073
1074 /* Check program exists and is executable on $PATH.  Actually, we
1075  * just assume PATH contains the default entries (see main() above).
1076  */
1077 int
1078 prog_exists (const char *prog)
1079 {
1080   static const char * const dirs[] =
1081     { "/sbin", "/usr/sbin", "/bin", "/usr/bin" };
1082   size_t i;
1083   char buf[1024];
1084
1085   for (i = 0; i < sizeof dirs / sizeof dirs[0]; ++i) {
1086     snprintf (buf, sizeof buf, "%s/%s", dirs[i], prog);
1087     if (access (buf, X_OK) == 0)
1088       return 1;
1089   }
1090   return 0;
1091 }
1092
1093 /* LVM and other commands aren't synchronous, especially when udev is
1094  * involved.  eg. You can create or remove some device, but the /dev
1095  * device node won't appear until some time later.  This means that
1096  * you get an error if you run one command followed by another.
1097  *
1098  * Use 'udevadm settle' after certain commands, but don't be too
1099  * fussed if it fails.
1100  *
1101  * 'udevsettle' was the old name for this command (RHEL 5).  This was
1102  * deprecated in favour of 'udevadm settle'.  The old 'udevsettle'
1103  * command was left as a symlink.  Then in Fedora 13 the old symlink
1104  * remained but it stopped working (RHBZ#548121), so we have to be
1105  * careful not to assume that we can use 'udevsettle' if it exists.
1106  */
1107 void
1108 udev_settle (void)
1109 {
1110   (void) command (NULL, NULL, "udevadm", "settle", NULL);
1111   (void) command (NULL, NULL, "udevsettle", NULL);
1112 }