fuse/guestmount.c

   1 /* guestmount - mount guests using libguestfs and FUSE
   2  * Copyright (C) 2009 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  * Derived from the example program 'fusexmp.c':
  19  * Copyright (C) 2001-2007  Miklos Szeredi <miklos@szeredi.hu>
  20  *
  21  * This program can be distributed under the terms of the GNU GPL.
  22  * See the file COPYING.
  23  */
  24
  25 #define FUSE_USE_VERSION 26
  26
  27 #include <config.h>
  28
  29 #include <stdio.h>
  30 #include <stdlib.h>
  31 #include <stdint.h>
  32 #include <string.h>
  33 #include <unistd.h>
  34 #include <getopt.h>
  35 #include <fcntl.h>
  36 #include <dirent.h>
  37 #include <errno.h>
  38 #include <signal.h>
  39 #include <time.h>
  40 #include <assert.h>
  41 #include <sys/time.h>
  42 #include <sys/types.h>
  43
  44 #include <fuse.h>
  45 #include <guestfs.h>
  46
  47 #include "progname.h"
  48
  49 #include "guestmount.h"
  50 #include "dircache.h"
  51
  52 /* See <attr/xattr.h> */
  53 #ifndef ENOATTR
  54 #define ENOATTR ENODATA
  55 #endif
  56
  57 static guestfs_h *g = NULL;
  58 static int read_only = 0;
  59 int verbose = 0;
  60 int dir_cache_timeout = 60;
  61
  62 /* This is ugly: guestfs errors are strings, FUSE wants -errno.  We
  63  * have to do the conversion as best we can.
  64  */
  65 #define MAX_ERRNO 256
  66
  67 static int
  68 error (void)
  69 {
  70   int i;
  71   const char *err = guestfs_last_error (g);
  72
  73   if (!err)
  74     return -EINVAL;
  75
  76   if (verbose)
  77     fprintf (stderr, "%s\n", err);
  78
  79   /* Add a few of our own ... */
  80
  81   /* This indicates guestfsd died.  Translate into a hard EIO error.
  82    * Arguably we could relaunch the guest if we hit this error.
  83    */
  84   if (strstr (err, "call launch before using this function"))
  85     return -EIO;
  86
  87   /* See if it matches an errno string in the host. */
  88   for (i = 0; i < MAX_ERRNO; ++i) {
  89     const char *e = strerror (i);
  90     if (e && strstr (err, e) != NULL)
  91       return -i;
  92   }
  93
  94   /* Too bad, return a generic error. */
  95   return -EINVAL;
  96 }
  97
  98 static struct guestfs_xattr_list *
  99 copy_xattr_list (const struct guestfs_xattr *first, size_t num)
 100 {
 101   struct guestfs_xattr_list *xattrs;
 102
 103   xattrs = malloc (sizeof *xattrs);
 104   if (xattrs == NULL) {
 105     perror ("malloc");
 106     return NULL;
 107   }
 108
 109   xattrs->len = num;
 110   xattrs->val = malloc (num * sizeof (struct guestfs_xattr));
 111   if (xattrs->val == NULL) {
 112     perror ("malloc");
 113     free (xattrs);
 114     return NULL;
 115   }
 116
 117   size_t i;
 118   for (i = 0; i < num; ++i) {
 119     xattrs->val[i].attrname = strdup (first[i].attrname);
 120     xattrs->val[i].attrval_len = first[i].attrval_len;
 121     xattrs->val[i].attrval = malloc (first[i].attrval_len);
 122     memcpy (xattrs->val[i].attrval, first[i].attrval, first[i].attrval_len);
 123   }
 124
 125   return xattrs;
 126 }
 127
 128 static int
 129 fg_readdir (const char *path, void *buf, fuse_fill_dir_t filler,
 130             off_t offset, struct fuse_file_info *fi)
 131 {
 132   time_t now;
 133   time (&now);
 134
 135   dir_cache_remove_all_expired (now);
 136
 137   struct guestfs_dirent_list *ents;
 138
 139   ents = guestfs_readdir (g, path);
 140   if (ents == NULL)
 141     return error ();
 142
 143   size_t i;
 144   for (i = 0; i < ents->len; ++i) {
 145     struct stat stat;
 146     memset (&stat, 0, sizeof stat);
 147
 148     stat.st_ino = ents->val[i].ino;
 149     switch (ents->val[i].ftyp) {
 150     case 'b': stat.st_mode = S_IFBLK; break;
 151     case 'c': stat.st_mode = S_IFCHR; break;
 152     case 'd': stat.st_mode = S_IFDIR; break;
 153     case 'f': stat.st_mode = S_IFIFO; break;
 154     case 'l': stat.st_mode = S_IFLNK; break;
 155     case 'r': stat.st_mode = S_IFREG; break;
 156     case 's': stat.st_mode = S_IFSOCK; break;
 157     case 'u':
 158     case '?':
 159     default:  stat.st_mode = 0;
 160     }
 161
 162     /* Copied from the example, which also ignores 'offset'.  I'm
 163      * not quite sure how this is ever supposed to work on large
 164      * directories. XXX
 165      */
 166     if (filler (buf, ents->val[i].name, &stat, 0))
 167       break;
 168   }
 169
 170   /* Now prepopulate the directory caches.  This step is just an
 171    * optimization, don't worry if it fails.
 172    */
 173   char **names = malloc ((ents->len + 1) * sizeof (char *));
 174   if (names) {
 175     for (i = 0; i < ents->len; ++i)
 176       names[i] = ents->val[i].name;
 177     names[i] = NULL;
 178
 179     struct guestfs_stat_list *ss = guestfs_lstatlist (g, path, names);
 180     if (ss) {
 181       for (i = 0; i < ss->len; ++i) {
 182         if (ss->val[i].ino >= 0) {
 183           struct stat statbuf;
 184
 185           statbuf.st_dev = ss->val[i].dev;
 186           statbuf.st_ino = ss->val[i].ino;
 187           statbuf.st_mode = ss->val[i].mode;
 188           statbuf.st_nlink = ss->val[i].nlink;
 189           statbuf.st_uid = ss->val[i].uid;
 190           statbuf.st_gid = ss->val[i].gid;
 191           statbuf.st_rdev = ss->val[i].rdev;
 192           statbuf.st_size = ss->val[i].size;
 193           statbuf.st_blksize = ss->val[i].blksize;
 194           statbuf.st_blocks = ss->val[i].blocks;
 195           statbuf.st_atime = ss->val[i].atime;
 196           statbuf.st_mtime = ss->val[i].mtime;
 197           statbuf.st_ctime = ss->val[i].ctime;
 198
 199           lsc_insert (path, names[i], now, &statbuf);
 200         }
 201       }
 202       guestfs_free_stat_list (ss);
 203     }
 204
 205     struct guestfs_xattr_list *xattrs = guestfs_lxattrlist (g, path, names);
 206     if (xattrs) {
 207       size_t ni, num;
 208       struct guestfs_xattr *first;
 209       struct guestfs_xattr_list *copy;
 210       for (i = 0, ni = 0; i < xattrs->len; ++i, ++ni) {
 211         assert (strlen (xattrs->val[i].attrname) == 0);
 212         if (xattrs->val[i].attrval_len > 0) {
 213           ++i;
 214           first = &xattrs->val[i];
 215           num = 0;
 216           for (; i < xattrs->len && strlen (xattrs->val[i].attrname) > 0; ++i)
 217             num++;
 218
 219           copy = copy_xattr_list (first, num);
 220           if (copy)
 221             xac_insert (path, names[ni], now, copy);
 222
 223           i--;
 224         }
 225       }
 226       guestfs_free_xattr_list (xattrs);
 227     }
 228
 229     char **links = guestfs_readlinklist (g, path, names);
 230     if (links) {
 231       for (i = 0; names[i] != NULL; ++i) {
 232         if (links[i][0])
 233           /* Note that rlc_insert owns the string links[i] after this, */
 234           rlc_insert (path, names[i], now, links[i]);
 235         else
 236           /* which is why we have to free links[i] here. */
 237           free (links[i]);
 238       }
 239       free (links);             /* free the array, not the strings */
 240     }
 241
 242     free (names);
 243   }
 244
 245   guestfs_free_dirent_list (ents);
 246
 247   return 0;
 248 }
 249
 250 static int
 251 fg_getattr (const char *path, struct stat *statbuf)
 252 {
 253   const struct stat *buf;
 254
 255   buf = lsc_lookup (path);
 256   if (buf) {
 257     memcpy (statbuf, buf, sizeof *statbuf);
 258     return 0;
 259   }
 260
 261   struct guestfs_stat *r;
 262
 263   r = guestfs_lstat (g, path);
 264   if (r == NULL)
 265     return error ();
 266
 267   statbuf->st_dev = r->dev;
 268   statbuf->st_ino = r->ino;
 269   statbuf->st_mode = r->mode;
 270   statbuf->st_nlink = r->nlink;
 271   statbuf->st_uid = r->uid;
 272   statbuf->st_gid = r->gid;
 273   statbuf->st_rdev = r->rdev;
 274   statbuf->st_size = r->size;
 275   statbuf->st_blksize = r->blksize;
 276   statbuf->st_blocks = r->blocks;
 277   statbuf->st_atime = r->atime;
 278   statbuf->st_mtime = r->mtime;
 279   statbuf->st_ctime = r->ctime;
 280
 281   guestfs_free_stat (r);
 282
 283   return 0;
 284 }
 285
 286 /* Nautilus loves to use access(2) to test everything about a file,
 287  * such as whether it's executable.  Therefore treat this a lot like
 288  * fg_getattr.
 289  */
 290 static int
 291 fg_access (const char *path, int mask)
 292 {
 293   struct stat statbuf;
 294   int r;
 295
 296   if (read_only && (mask & W_OK))
 297     return -EROFS;
 298
 299   r = fg_getattr (path, &statbuf);
 300   if (r < 0 || mask == F_OK)
 301     return r;
 302
 303   struct fuse_context *fuse = fuse_get_context ();
 304   int ok = 1;
 305
 306   if (mask & R_OK)
 307     ok = ok &&
 308       (  fuse->uid == statbuf.st_uid ? statbuf.st_mode & S_IRUSR
 309        : fuse->gid == statbuf.st_gid ? statbuf.st_mode & S_IRGRP
 310        : statbuf.st_mode & S_IROTH);
 311   if (mask & W_OK)
 312     ok = ok &&
 313       (  fuse->uid == statbuf.st_uid ? statbuf.st_mode & S_IWUSR
 314        : fuse->gid == statbuf.st_gid ? statbuf.st_mode & S_IWGRP
 315        : statbuf.st_mode & S_IWOTH);
 316   if (mask & X_OK)
 317     ok = ok &&
 318       (  fuse->uid == statbuf.st_uid ? statbuf.st_mode & S_IXUSR
 319        : fuse->gid == statbuf.st_gid ? statbuf.st_mode & S_IXGRP
 320        : statbuf.st_mode & S_IXOTH);
 321
 322   return ok ? 0 : -EACCES;
 323 }
 324
 325 static int
 326 fg_readlink (const char *path, char *buf, size_t size)
 327 {
 328   const char *r;
 329   int free_it = 0;
 330
 331   r = rlc_lookup (path);
 332   if (!r) {
 333     r = guestfs_readlink (g, path);
 334     if (r == NULL)
 335       return error ();
 336     free_it = 1;
 337   }
 338
 339   /* Note this is different from the real readlink(2) syscall.  FUSE wants
 340    * the string to be always nul-terminated, even if truncated.
 341    */
 342   size_t len = strlen (r);
 343   if (len > size - 1)
 344     len = size - 1;
 345
 346   memcpy (buf, r, len);
 347   buf[len] = '\0';
 348
 349   if (free_it) {
 350     char *tmp = (char *) r;
 351     free (tmp);
 352   }
 353
 354   return 0;
 355 }
 356
 357 static int
 358 fg_mknod (const char *path, mode_t mode, dev_t rdev)
 359 {
 360   int r;
 361
 362   if (read_only) return -EROFS;
 363
 364   dir_cache_invalidate (path);
 365
 366   r = guestfs_mknod (g, mode, major (rdev), minor (rdev), path);
 367   if (r == -1)
 368     return error ();
 369
 370   return 0;
 371 }
 372
 373 static int
 374 fg_mkdir (const char *path, mode_t mode)
 375 {
 376   int r;
 377
 378   if (read_only) return -EROFS;
 379
 380   dir_cache_invalidate (path);
 381
 382   r = guestfs_mkdir_mode (g, path, mode);
 383   if (r == -1)
 384     return error ();
 385
 386   return 0;
 387 }
 388
 389 static int
 390 fg_unlink (const char *path)
 391 {
 392   int r;
 393
 394   if (read_only) return -EROFS;
 395
 396   dir_cache_invalidate (path);
 397
 398   r = guestfs_rm (g, path);
 399   if (r == -1)
 400     return error ();
 401
 402   return 0;
 403 }
 404
 405 static int
 406 fg_rmdir (const char *path)
 407 {
 408   int r;
 409
 410   if (read_only) return -EROFS;
 411
 412   dir_cache_invalidate (path);
 413
 414   r = guestfs_rmdir (g, path);
 415   if (r == -1)
 416     return error ();
 417
 418   return 0;
 419 }
 420
 421 static int
 422 fg_symlink (const char *from, const char *to)
 423 {
 424   int r;
 425
 426   if (read_only) return -EROFS;
 427
 428   dir_cache_invalidate (to);
 429
 430   r = guestfs_ln_s (g, from, to);
 431   if (r == -1)
 432     return error ();
 433
 434   return 0;
 435 }
 436
 437 static int
 438 fg_rename (const char *from, const char *to)
 439 {
 440   int r;
 441
 442   if (read_only) return -EROFS;
 443
 444   dir_cache_invalidate (to);
 445
 446   /* XXX It's not clear how close the 'mv' command is to the
 447    * rename syscall.  We might need to add the rename syscall
 448    * to the guestfs(3) API.
 449    */
 450   r = guestfs_mv (g, from, to);
 451   if (r == -1)
 452     return error ();
 453
 454   return 0;
 455 }
 456
 457 static int
 458 fg_link (const char *from, const char *to)
 459 {
 460   int r;
 461
 462   if (read_only) return -EROFS;
 463
 464   dir_cache_invalidate (from);
 465   dir_cache_invalidate (to);
 466
 467   r = guestfs_ln (g, from, to);
 468   if (r == -1)
 469     return error ();
 470
 471   return 0;
 472 }
 473
 474 static int
 475 fg_chmod (const char *path, mode_t mode)
 476 {
 477   int r;
 478
 479   if (read_only) return -EROFS;
 480
 481   dir_cache_invalidate (path);
 482
 483   r = guestfs_chmod (g, mode, path);
 484   if (r == -1)
 485     return error ();
 486
 487   return 0;
 488 }
 489
 490 static int
 491 fg_chown (const char *path, uid_t uid, gid_t gid)
 492 {
 493   int r;
 494
 495   if (read_only) return -EROFS;
 496
 497   dir_cache_invalidate (path);
 498
 499   r = guestfs_lchown (g, uid, gid, path);
 500   if (r == -1)
 501     return error ();
 502
 503   return 0;
 504 }
 505
 506 static int
 507 fg_truncate (const char *path, off_t size)
 508 {
 509   int r;
 510
 511   if (read_only) return -EROFS;
 512
 513   dir_cache_invalidate (path);
 514
 515   r = guestfs_truncate_size (g, path, size);
 516   if (r == -1)
 517     return error ();
 518
 519   return 0;
 520 }
 521
 522 static int
 523 fg_utimens (const char *path, const struct timespec ts[2])
 524 {
 525   int r;
 526
 527   if (read_only) return -EROFS;
 528
 529   dir_cache_invalidate (path);
 530
 531   time_t atsecs = ts[0].tv_sec;
 532   long atnsecs = ts[0].tv_nsec;
 533   time_t mtsecs = ts[1].tv_sec;
 534   long mtnsecs = ts[1].tv_nsec;
 535
 536   if (atnsecs == UTIME_NOW)
 537     atnsecs = -1;
 538   if (atnsecs == UTIME_OMIT)
 539     atnsecs = -2;
 540   if (mtnsecs == UTIME_NOW)
 541     mtnsecs = -1;
 542   if (mtnsecs == UTIME_OMIT)
 543     mtnsecs = -2;
 544
 545   r = guestfs_utimens (g, path, atsecs, atnsecs, mtsecs, mtnsecs);
 546   if (r == -1)
 547     return error ();
 548
 549   return 0;
 550 }
 551
 552 /* This call is quite hard to emulate through the guestfs(3) API.  In
 553  * one sense it's a little like access (see above) because it tests
 554  * whether opening a file would succeed given the flags.  But it also
 555  * has side effects such as truncating the file if O_TRUNC is given.
 556  * Therefore we need to emulate it ... painfully.
 557  */
 558 static int
 559 fg_open (const char *path, struct fuse_file_info *fi)
 560 {
 561   int r, exists;
 562
 563   if (fi->flags & O_WRONLY) {
 564     if (read_only)
 565       return -EROFS;
 566   }
 567
 568   exists = guestfs_exists (g, path);
 569   if (exists == -1)
 570     return error ();
 571
 572   if (fi->flags & O_CREAT) {
 573     if (read_only)
 574       return -EROFS;
 575
 576     dir_cache_invalidate (path);
 577
 578     /* Exclusive?  File must not exist already. */
 579     if (fi->flags & O_EXCL) {
 580       if (exists)
 581         return -EEXIST;
 582     }
 583
 584     /* Create?  Touch it and optionally truncate it. */
 585     r = guestfs_touch (g, path);
 586     if (r == -1)
 587       return error ();
 588
 589     if (fi->flags & O_TRUNC) {
 590       r = guestfs_truncate (g, path);
 591       if (r == -1)
 592         return error ();
 593     }
 594   } else {
 595     /* Not create, just check it exists. */
 596     if (!exists)
 597       return -ENOENT;
 598   }
 599
 600   return 0;
 601 }
 602
 603 static int
 604 fg_read (const char *path, char *buf, size_t size, off_t offset,
 605          struct fuse_file_info *fi)
 606 {
 607   char *r;
 608   size_t rsize;
 609
 610   if (verbose)
 611     fprintf (stderr, "fg_read: %s: size %zu offset %ju\n",
 612              path, size, offset);
 613
 614   /* The guestfs protocol limits size to somewhere over 2MB.  We just
 615    * reduce the requested size here accordingly and push the problem
 616    * up to every user.  http://www.jwz.org/doc/worse-is-better.html
 617    */
 618   const size_t limit = 2 * 1024 * 1024;
 619   if (size > limit)
 620     size = limit;
 621
 622   r = guestfs_pread (g, path, size, offset, &rsize);
 623   if (r == NULL)
 624     return error ();
 625
 626   /* This should never happen, but at least it stops us overflowing
 627    * the output buffer if it does happen.
 628    */
 629   if (rsize > size)
 630     rsize = size;
 631
 632   memcpy (buf, r, rsize);
 633   free (r);
 634
 635   return rsize;
 636 }
 637
 638 static int
 639 fg_write (const char *path, const char *buf, size_t size,
 640           off_t offset, struct fuse_file_info *fi)
 641 {
 642   if (read_only) return -EROFS;
 643
 644   dir_cache_invalidate (path);
 645
 646   return -ENOSYS;               /* XXX */
 647 }
 648
 649 static int
 650 fg_statfs (const char *path, struct statvfs *stbuf)
 651 {
 652   struct guestfs_statvfs *r;
 653
 654   r = guestfs_statvfs (g, path);
 655   if (r == NULL)
 656     return error ();
 657
 658   stbuf->f_bsize = r->bsize;
 659   stbuf->f_frsize = r->frsize;
 660   stbuf->f_blocks = r->blocks;
 661   stbuf->f_bfree = r->bfree;
 662   stbuf->f_bavail = r->bavail;
 663   stbuf->f_files = r->files;
 664   stbuf->f_ffree = r->ffree;
 665   stbuf->f_favail = r->favail;
 666   stbuf->f_fsid = r->fsid;
 667   stbuf->f_flag = r->flag;
 668   stbuf->f_namemax = r->namemax;
 669
 670   guestfs_free_statvfs (r);
 671
 672   return 0;
 673 }
 674
 675 static int
 676 fg_release (const char *path, struct fuse_file_info *fi)
 677 {
 678   /* Just a stub. This method is optional and can safely be left
 679    * unimplemented.
 680    */
 681   return 0;
 682 }
 683
 684 /* Emulate this by calling sync. */
 685 static int fg_fsync(const char *path, int isdatasync,
 686                      struct fuse_file_info *fi)
 687 {
 688   int r;
 689
 690   r = guestfs_sync (g);
 691   if (r == -1)
 692     return error ();
 693
 694   return 0;
 695 }
 696
 697 static int
 698 fg_setxattr (const char *path, const char *name, const char *value,
 699              size_t size, int flags)
 700 {
 701   int r;
 702
 703   if (read_only) return -EROFS;
 704
 705   dir_cache_invalidate (path);
 706
 707   /* XXX Underlying guestfs(3) API doesn't understand the flags. */
 708   r = guestfs_lsetxattr (g, name, value, size, path);
 709   if (r == -1)
 710     return error ();
 711
 712   return 0;
 713 }
 714
 715 /* The guestfs(3) API for getting xattrs is much easier to use
 716  * than the real syscall.  Unfortunately we now have to emulate
 717  * the real syscall using that API :-(
 718  */
 719 static int
 720 fg_getxattr (const char *path, const char *name, char *value,
 721              size_t size)
 722 {
 723   const struct guestfs_xattr_list *xattrs;
 724   int free_attrs = 0;
 725
 726   xattrs = xac_lookup (path);
 727   if (xattrs == NULL) {
 728     xattrs = guestfs_lgetxattrs (g, path);
 729     if (xattrs == NULL)
 730       return error ();
 731     free_attrs = 1;
 732   }
 733
 734   size_t i;
 735   int r = -ENOATTR;
 736   for (i = 0; i < xattrs->len; ++i) {
 737     if (STREQ (xattrs->val[i].attrname, name)) {
 738       size_t sz = xattrs->val[i].attrval_len;
 739       if (sz > size)
 740         sz = size;
 741       memcpy (value, xattrs->val[i].attrval, sz);
 742       r = 0;
 743       break;
 744     }
 745   }
 746
 747   if (free_attrs)
 748     guestfs_free_xattr_list ((struct guestfs_xattr_list *) xattrs);
 749
 750   return r;
 751 }
 752
 753 /* Ditto as above. */
 754 static int
 755 fg_listxattr (const char *path, char *list, size_t size)
 756 {
 757   const struct guestfs_xattr_list *xattrs;
 758   int free_attrs = 0;
 759
 760   xattrs = xac_lookup (path);
 761   if (xattrs == NULL) {
 762     xattrs = guestfs_lgetxattrs (g, path);
 763     if (xattrs == NULL)
 764       return error ();
 765     free_attrs = 1;
 766   }
 767
 768   size_t i;
 769   ssize_t copied = 0;
 770   for (i = 0; i < xattrs->len; ++i) {
 771     size_t len = strlen (xattrs->val[i].attrname) + 1;
 772     if (size >= len) {
 773       memcpy (list, xattrs->val[i].attrname, len);
 774       size -= len;
 775       list += len;
 776       copied += len;
 777     } else {
 778       copied = -ERANGE;
 779       break;
 780     }
 781   }
 782
 783   if (free_attrs)
 784     guestfs_free_xattr_list ((struct guestfs_xattr_list *) xattrs);
 785
 786   return copied;
 787 }
 788
 789 static int
 790 fg_removexattr(const char *path, const char *name)
 791 {
 792   int r;
 793
 794   if (read_only) return -EROFS;
 795
 796   dir_cache_invalidate (path);
 797
 798   r = guestfs_lremovexattr (g, name, path);
 799   if (r == -1)
 800     return error ();
 801
 802   return 0;
 803 }
 804
 805 static struct fuse_operations fg_operations = {
 806   .getattr      = fg_getattr,
 807   .access       = fg_access,
 808   .readlink     = fg_readlink,
 809   .readdir      = fg_readdir,
 810   .mknod        = fg_mknod,
 811   .mkdir        = fg_mkdir,
 812   .symlink      = fg_symlink,
 813   .unlink       = fg_unlink,
 814   .rmdir        = fg_rmdir,
 815   .rename       = fg_rename,
 816   .link         = fg_link,
 817   .chmod        = fg_chmod,
 818   .chown        = fg_chown,
 819   .truncate     = fg_truncate,
 820   .utimens      = fg_utimens,
 821   .open         = fg_open,
 822   .read         = fg_read,
 823   .write        = fg_write,
 824   .statfs       = fg_statfs,
 825   .release      = fg_release,
 826   .fsync        = fg_fsync,
 827   .setxattr     = fg_setxattr,
 828   .getxattr     = fg_getxattr,
 829   .listxattr    = fg_listxattr,
 830   .removexattr  = fg_removexattr,
 831 };
 832
 833 struct drv {
 834   struct drv *next;
 835   char *filename;
 836 };
 837
 838 struct mp {
 839   struct mp *next;
 840   char *device;
 841   char *mountpoint;
 842 };
 843
 844 static void add_drives (struct drv *);
 845 static void mount_mps (struct mp *);
 846
 847 static void __attribute__((noreturn))
 848 fuse_help (void)
 849 {
 850   const char *tmp_argv[] = { program_name, "--help", NULL };
 851   fuse_main (2, (char **) tmp_argv, &fg_operations, NULL);
 852   exit (0);
 853 }
 854
 855 static void __attribute__((noreturn))
 856 usage (int status)
 857 {
 858   if (status != EXIT_SUCCESS)
 859     fprintf (stderr, _("Try `%s --help' for more information.\n"),
 860              program_name);
 861   else {
 862     fprintf (stdout,
 863            _("%s: FUSE module for libguestfs\n"
 864              "%s lets you mount a virtual machine filesystem\n"
 865              "Copyright (C) 2009 Red Hat Inc.\n"
 866              "Usage:\n"
 867              "  %s [--options] [-- [--FUSE-options]] mountpoint\n"
 868              "Options:\n"
 869              "  -a|--add image       Add image\n"
 870              "  --dir-cache-timeout  Set readdir cache timeout (default 5 sec)\n"
 871              "  --fuse-help          Display extra FUSE options\n"
 872              "  --help               Display help message and exit\n"
 873              "  -m|--mount dev[:mnt] Mount dev on mnt (if omitted, /)\n"
 874              "  -n|--no-sync         Don't autosync\n"
 875              "  -o|--option opt      Pass extra option to FUSE\n"
 876              "  -r|--ro              Mount read-only\n"
 877              "  --selinux            Enable SELinux support\n"
 878              "  --trace              Trace guestfs API calls (to stderr)\n"
 879              "  -v|--verbose         Verbose messages\n"
 880              "  -V|--version         Display version and exit\n"
 881              ),
 882              program_name, program_name, program_name);
 883   }
 884   exit (status);
 885 }
 886
 887 int
 888 main (int argc, char *argv[])
 889 {
 890   enum { HELP_OPTION = CHAR_MAX + 1 };
 891
 892   /* The command line arguments are broadly compatible with (a subset
 893    * of) guestfish.  Thus we have to deal mainly with -a, -m and --ro.
 894    */
 895   static const char *options = "a:m:no:rv?V";
 896   static const struct option long_options[] = {
 897     { "add", 1, 0, 'a' },
 898     { "dir-cache-timeout", 1, 0, 0 },
 899     { "fuse-help", 0, 0, 0 },
 900     { "help", 0, 0, HELP_OPTION },
 901     { "mount", 1, 0, 'm' },
 902     { "no-sync", 0, 0, 'n' },
 903     { "option", 1, 0, 'o' },
 904     { "ro", 0, 0, 'r' },
 905     { "selinux", 0, 0, 0 },
 906     { "trace", 0, 0, 0 },
 907     { "verbose", 0, 0, 'v' },
 908     { "version", 0, 0, 'V' },
 909     { 0, 0, 0, 0 }
 910   };
 911
 912   struct drv *drvs = NULL;
 913   struct drv *drv;
 914   struct mp *mps = NULL;
 915   struct mp *mp;
 916   char *p;
 917   int c, i, r;
 918   int option_index;
 919   struct sigaction sa;
 920
 921   int fuse_argc = 0;
 922   const char **fuse_argv = NULL;
 923
 924 #define ADD_FUSE_ARG(str)                                               \
 925   do {                                                                  \
 926     fuse_argc ++;                                                       \
 927     fuse_argv = realloc (fuse_argv, (1+fuse_argc) * sizeof (char *));   \
 928     if (!fuse_argv) {                                                   \
 929       perror ("realloc");                                               \
 930       exit (1);                                                         \
 931     }                                                                   \
 932     fuse_argv[fuse_argc-1] = (str);                                     \
 933     fuse_argv[fuse_argc] = NULL;                                        \
 934   } while (0)
 935
 936   /* LC_ALL=C is required so we can parse error messages. */
 937   setenv ("LC_ALL", "C", 1);
 938
 939   /* Set global program name that is not polluted with libtool artifacts.  */
 940   set_program_name (argv[0]);
 941
 942   memset (&sa, 0, sizeof sa);
 943   sa.sa_handler = SIG_IGN;
 944   sa.sa_flags = SA_RESTART;
 945   sigaction (SIGPIPE, &sa, NULL);
 946
 947   /* Various initialization. */
 948   init_dir_caches ();
 949
 950   g = guestfs_create ();
 951   if (g == NULL) {
 952     fprintf (stderr, _("guestfs_create: failed to create handle\n"));
 953     exit (1);
 954   }
 955
 956   guestfs_set_autosync (g, 1);
 957   guestfs_set_recovery_proc (g, 0);
 958
 959   ADD_FUSE_ARG (program_name);
 960   /* MUST be single-threaded.  You cannot have two threads accessing the
 961    * same libguestfs handle, and opening more than one handle is likely
 962    * to be very expensive.
 963    */
 964   ADD_FUSE_ARG ("-s");
 965
 966   /* If developing, add ./appliance to the path.  Note that libtools
 967    * interferes with this because uninstalled guestfish is a shell
 968    * script that runs the real program with an absolute path.  Detect
 969    * that too.
 970    *
 971    * BUT if LIBGUESTFS_PATH environment variable is already set by
 972    * the user, then don't override it.
 973    */
 974   if (getenv ("LIBGUESTFS_PATH") == NULL &&
 975       argv[0] &&
 976       (argv[0][0] != '/' || strstr (argv[0], "/.libs/lt-") != NULL))
 977     guestfs_set_path (g, "appliance:" GUESTFS_DEFAULT_PATH);
 978
 979   for (;;) {
 980     c = getopt_long (argc, argv, options, long_options, &option_index);
 981     if (c == -1) break;
 982
 983     switch (c) {
 984     case 0:                     /* options which are long only */
 985       if (STREQ (long_options[option_index].name, "dir-cache-timeout"))
 986         dir_cache_timeout = atoi (optarg);
 987       else if (STREQ (long_options[option_index].name, "fuse-help"))
 988         fuse_help ();
 989       else if (STREQ (long_options[option_index].name, "selinux"))
 990         guestfs_set_selinux (g, 1);
 991       else if (STREQ (long_options[option_index].name, "trace")) {
 992         ADD_FUSE_ARG ("-f");
 993         guestfs_set_trace (g, 1);
 994         guestfs_set_recovery_proc (g, 1);
 995       }
 996       else {
 997         fprintf (stderr, _("%s: unknown long option: %s (%d)\n"),
 998                  program_name, long_options[option_index].name, option_index);
 999         exit (1);
1000       }
1001       break;
1002
1003     case 'a':
1004       if (access (optarg, R_OK) != 0) {
1005         perror (optarg);
1006         exit (1);
1007       }
1008       drv = malloc (sizeof (struct drv));
1009       if (!drv) {
1010         perror ("malloc");
1011         exit (1);
1012       }
1013       drv->filename = optarg;
1014       drv->next = drvs;
1015       drvs = drv;
1016       break;
1017
1018     case 'm':
1019       mp = malloc (sizeof (struct mp));
1020       if (!mp) {
1021         perror ("malloc");
1022         exit (1);
1023       }
1024       p = strchr (optarg, ':');
1025       if (p) {
1026         *p = '\0';
1027         mp->mountpoint = p+1;
1028       } else
1029         mp->mountpoint = bad_cast ("/");
1030       mp->device = optarg;
1031       mp->next = mps;
1032       mps = mp;
1033       break;
1034
1035     case 'n':
1036       guestfs_set_autosync (g, 0);
1037       break;
1038
1039     case 'o':
1040       ADD_FUSE_ARG ("-o");
1041       ADD_FUSE_ARG (optarg);
1042       break;
1043
1044     case 'r':
1045       read_only = 1;
1046       break;
1047
1048     case 'v':
1049       verbose++;
1050       guestfs_set_verbose (g, verbose);
1051       break;
1052
1053     case 'V':
1054       printf ("%s %s\n", program_name, PACKAGE_VERSION);
1055       exit (0);
1056
1057     case HELP_OPTION:
1058       usage (0);
1059
1060     default:
1061       usage (1);
1062     }
1063   }
1064
1065   /* We must have at least one -a and at least one -m. */
1066   if (!drvs || !mps) {
1067     fprintf (stderr,
1068              _("%s: must have at least one -a and at least one -m option\n"),
1069              program_name);
1070     exit (1);
1071   }
1072
1073   /* We'd better have a mountpoint. */
1074   if (optind+1 != argc) {
1075     fprintf (stderr,
1076              _("%s: you must specify a mountpoint in the host filesystem\n"),
1077              program_name);
1078     exit (1);
1079   }
1080
1081   /* Do the guest drives and mountpoints. */
1082   add_drives (drvs);
1083   if (guestfs_launch (g) == -1)
1084     exit (1);
1085   mount_mps (mps);
1086
1087   /* FUSE example does this, not clear if it's necessary, but ... */
1088   if (guestfs_umask (g, 0) == -1)
1089     exit (1);
1090
1091   /* At the last minute, remove the libguestfs error handler.  In code
1092    * above this point, the default error handler has been used which
1093    * sends all errors to stderr.  Now before entering FUSE itself we
1094    * want to silence errors so we can convert them (see error()
1095    * function above).
1096    */
1097   guestfs_set_error_handler (g, NULL, NULL);
1098
1099   /* Finish off FUSE args. */
1100   ADD_FUSE_ARG (argv[optind]);
1101
1102   /*
1103     It says about the line containing the for-statement:
1104     error: assuming signed overflow does not occur when simplifying conditional to constant [-Wstrict-overflow]
1105
1106   if (verbose) {
1107     fprintf (stderr, "guestmount: invoking FUSE with args [");
1108     for (i = 0; i < fuse_argc; ++i) {
1109       if (i > 0) fprintf (stderr, ", ");
1110       fprintf (stderr, "%s", fuse_argv[i]);
1111     }
1112     fprintf (stderr, "]\n");
1113   }
1114   */
1115
1116   r = fuse_main (fuse_argc, (char **) fuse_argv, &fg_operations, NULL);
1117
1118   /* Cleanup. */
1119   guestfs_close (g);
1120   free_dir_caches ();
1121
1122   exit (r == -1 ? 1 : 0);
1123 }
1124
1125 /* List is built in reverse order, so add them in reverse order. */
1126 static void
1127 add_drives (struct drv *drv)
1128 {
1129   int r;
1130
1131   if (drv) {
1132     add_drives (drv->next);
1133     if (!read_only)
1134       r = guestfs_add_drive (g, drv->filename);
1135     else
1136       r = guestfs_add_drive_ro (g, drv->filename);
1137     if (r == -1)
1138       exit (1);
1139   }
1140 }
1141
1142 /* List is built in reverse order, so mount them in reverse order. */
1143 static void
1144 mount_mps (struct mp *mp)
1145 {
1146   int r;
1147
1148   if (mp) {
1149     mount_mps (mp->next);
1150     if (!read_only)
1151       r = guestfs_mount (g, mp->device, mp->mountpoint);
1152     else
1153       r = guestfs_mount_ro (g, mp->device, mp->mountpoint);
1154     if (r == -1)
1155       exit (1);
1156   }
1157 }