4 * This file implements mounting of WIM files using FUSE, which stands for
5 * Filesystem in Userspace. FUSE allows a filesystem to be implemented in a
6 * userspace process by implementing the filesystem primitives--- read(),
7 * write(), readdir(), etc.
11 * Copyright (C) 2012, 2013 Eric Biggers
13 * This file is part of wimlib, a library for working with WIM files.
15 * wimlib is free software; you can redistribute it and/or modify it under the
16 * terms of the GNU General Public License as published by the Free
17 * Software Foundation; either version 3 of the License, or (at your option)
20 * wimlib is distributed in the hope that it will be useful, but WITHOUT ANY
21 * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
22 * A PARTICULAR PURPOSE. See the GNU General Public License for more
25 * You should have received a copy of the GNU General Public License
26 * along with wimlib; if not, see http://www.gnu.org/licenses/.
34 #include "wimlib/error.h"
39 # error "FUSE mount not supported on Win32! Please configure --without-fuse"
42 #include "wimlib/encoding.h"
43 #include "wimlib/file_io.h"
44 #include "wimlib/lookup_table.h"
45 #include "wimlib/metadata.h"
46 #include "wimlib/paths.h"
47 #include "wimlib/reparse.h"
48 #include "wimlib/resource.h"
49 #include "wimlib/timestamp.h"
50 #include "wimlib/version.h"
51 #include "wimlib/write.h"
52 #include "wimlib/xml.h"
63 #include <sys/types.h>
68 #define FUSE_USE_VERSION 26
72 #include <attr/xattr.h>
75 #define MSG_VERSION_TOO_HIGH -1
76 #define MSG_BREAK_LOOP -2
78 /* File descriptor to a file open on the WIM filesystem. */
80 struct wim_inode *f_inode;
81 struct wim_lookup_table_entry *f_lte;
82 struct filedes staging_fd;
87 struct wimfs_context {
88 /* The WIMStruct for the mounted WIM. */
91 /* Name of the staging directory for a read-write mount. Whenever a new file is
92 * created, it is done so in the staging directory. Furthermore, whenever a
93 * file in the WIM is modified, it is extracted to the staging directory. If
94 * changes are commited when the WIM is unmounted, the file resources are merged
95 * in from the staging directory when writing the new WIM. */
96 char *staging_dir_name;
97 size_t staging_dir_name_len;
99 /* Flags passed to wimlib_mount(). */
102 /* Default flags to use when looking up a WIM dentry (depends on whether
103 * the Windows interface to alternate data streams is being used or
105 int default_lookup_flags;
107 /* Next inode number to be assigned. Note: I didn't bother with a
108 * bitmap of free inode numbers since this isn't even a "real"
109 * filesystem anyway. */
112 /* List of inodes in the mounted image */
113 struct list_head *image_inode_list;
115 /* Name and message queue descriptors for message queues between the
116 * filesystem daemon process and the unmount process. These are used
117 * when the filesystem is unmounted and the process running
118 * wimlib_unmount_image() needs to communicate with the filesystem
119 * daemon running fuse_main() (i.e. the process created by a call to
120 * wimlib_mount_image(). */
121 char *unmount_to_daemon_mq_name;
122 char *daemon_to_unmount_mq_name;
123 mqd_t unmount_to_daemon_mq;
124 mqd_t daemon_to_unmount_mq;
134 init_wimfs_context(struct wimfs_context *ctx)
136 memset(ctx, 0, sizeof(*ctx));
137 ctx->unmount_to_daemon_mq = (mqd_t)-1;
138 ctx->daemon_to_unmount_mq = (mqd_t)-1;
141 #define WIMFS_CTX(fuse_ctx) ((struct wimfs_context*)(fuse_ctx)->private_data)
143 static inline struct wimfs_context *
144 wimfs_get_context(void)
146 return WIMFS_CTX(fuse_get_context());
149 static inline WIMStruct *
150 wimfs_get_WIMStruct(void)
152 return wimfs_get_context()->wim;
156 wimfs_ctx_readonly(const struct wimfs_context *ctx)
158 return (ctx->mount_flags & WIMLIB_MOUNT_FLAG_READWRITE) == 0;
162 get_lookup_flags(const struct wimfs_context *ctx)
164 return ctx->default_lookup_flags;
167 /* Returns nonzero if write permission is requested on the file open flags */
169 flags_writable(int open_flags)
171 return open_flags & (O_RDWR | O_WRONLY);
175 * Allocate a file descriptor for a stream.
177 * @inode: inode containing the stream we're opening
178 * @stream_id: ID of the stream we're opening
179 * @lte: Lookup table entry for the stream (may be NULL)
180 * @fd_ret: Return the allocated file descriptor if successful.
181 * @readonly: True if this is a read-only mount.
183 * Return 0 iff successful or error code if unsuccessful.
186 alloc_wimfs_fd(struct wim_inode *inode,
188 struct wim_lookup_table_entry *lte,
189 struct wimfs_fd **fd_ret,
192 static const u16 fds_per_alloc = 8;
193 static const u16 max_fds = 0xffff;
196 DEBUG("Allocating fd for stream ID %u from inode %#"PRIx64" "
197 "(open = %u, allocated = %u)",
198 stream_id, inode->i_ino, inode->i_num_opened_fds,
199 inode->i_num_allocated_fds);
201 if (inode->i_num_opened_fds == inode->i_num_allocated_fds) {
202 struct wimfs_fd **fds;
205 if (inode->i_num_allocated_fds == max_fds) {
209 num_new_fds = min(fds_per_alloc,
210 max_fds - inode->i_num_allocated_fds);
212 fds = REALLOC(inode->i_fds,
213 (inode->i_num_allocated_fds + num_new_fds) *
214 sizeof(inode->i_fds[0]));
219 memset(&fds[inode->i_num_allocated_fds], 0,
220 num_new_fds * sizeof(fds[0]));
222 inode->i_num_allocated_fds += num_new_fds;
224 for (u16 i = 0; ; i++) {
225 if (!inode->i_fds[i]) {
226 struct wimfs_fd *fd = CALLOC(1, sizeof(*fd));
233 filedes_invalidate(&fd->staging_fd);
235 fd->stream_id = stream_id;
237 inode->i_fds[i] = fd;
238 inode->i_num_opened_fds++;
239 if (lte && !readonly)
240 lte->num_opened_fds++;
241 DEBUG("Allocated fd (idx = %u)", fd->idx);
251 inode_put_fd(struct wim_inode *inode, struct wimfs_fd *fd)
253 wimlib_assert(inode != NULL);
254 wimlib_assert(fd->f_inode == inode);
255 wimlib_assert(inode->i_num_opened_fds != 0);
256 wimlib_assert(fd->idx < inode->i_num_allocated_fds);
257 wimlib_assert(inode->i_fds[fd->idx] == fd);
259 inode->i_fds[fd->idx] = NULL;
261 if (--inode->i_num_opened_fds == 0) {
264 inode->i_num_allocated_fds = 0;
265 if (inode->i_nlink == 0)
271 lte_put_fd(struct wim_lookup_table_entry *lte, struct wimfs_fd *fd)
273 wimlib_assert(fd->f_lte == lte);
275 if (!lte) /* Empty stream with no lookup table entry */
278 /* Close staging file descriptor if needed. */
280 if (lte->resource_location == RESOURCE_IN_STAGING_FILE
281 && filedes_valid(&fd->staging_fd))
283 if (filedes_close(&fd->staging_fd)) {
284 ERROR_WITH_ERRNO("Failed to close staging file");
288 lte_decrement_num_opened_fds(lte);
292 /* Close a file descriptor. */
294 close_wimfs_fd(struct wimfs_fd *fd)
297 DEBUG("Closing fd (ino = %#"PRIx64", opened = %u, allocated = %u)",
298 fd->f_inode->i_ino, fd->f_inode->i_num_opened_fds,
299 fd->f_inode->i_num_allocated_fds);
300 ret = lte_put_fd(fd->f_lte, fd);
304 inode_put_fd(fd->f_inode, fd);
309 fuse_mask_mode(mode_t mode, struct fuse_context *fuse_ctx)
311 #if FUSE_MAJOR_VERSION > 2 || (FUSE_MAJOR_VERSION == 2 && FUSE_MINOR_VERSION >= 8)
312 mode &= ~fuse_ctx->umask;
318 * Add a new dentry with a new inode to a WIM image.
320 * Returns 0 on success, or negative error number on failure.
323 create_dentry(struct fuse_context *fuse_ctx, const char *path,
324 mode_t mode, int attributes, struct wim_dentry **dentry_ret)
326 struct wim_dentry *parent;
327 struct wim_dentry *new;
328 const char *basename;
329 struct wimfs_context *wimfs_ctx = WIMFS_CTX(fuse_ctx);
332 parent = get_parent_dentry(wimfs_ctx->wim, path);
336 if (!dentry_is_directory(parent))
339 basename = path_basename(path);
340 if (get_dentry_child_with_name(parent, basename))
343 ret = new_dentry_with_inode(basename, &new);
347 new->d_inode->i_resolved = 1;
348 new->d_inode->i_ino = wimfs_ctx->next_ino++;
349 new->d_inode->i_attributes = attributes;
351 if (wimfs_ctx->mount_flags & WIMLIB_MOUNT_FLAG_UNIX_DATA) {
352 if (inode_set_unix_data(new->d_inode,
355 fuse_mask_mode(mode, fuse_ctx),
356 wimfs_ctx->wim->lookup_table,
357 UNIX_DATA_ALL | UNIX_DATA_CREATE))
363 dentry_add_child(parent, new);
364 list_add_tail(&new->d_inode->i_list, wimfs_ctx->image_inode_list);
370 /* Remove a dentry from a mounted WIM image; i.e. remove an alias for the
371 * corresponding inode.
373 * If there are no remaining references to the inode either through dentries or
374 * open file descriptors, the inode is freed. Otherwise, the inode is not
375 * removed, but the dentry is unlinked and freed.
377 * Either way, all lookup table entries referenced by the inode have their
378 * reference count decremented. If a lookup table entry has no open file
379 * descriptors and no references remaining, it is freed, and the corresponding
380 * staging file is unlinked.
383 remove_dentry(struct wim_dentry *dentry,
384 struct wim_lookup_table *lookup_table)
386 struct wim_inode *inode = dentry->d_inode;
387 struct wim_lookup_table_entry *lte;
390 for (i = 0; i <= inode->i_num_ads; i++) {
391 lte = inode_stream_lte_resolved(inode, i);
393 lte_decrement_refcnt(lte, lookup_table);
395 unlink_dentry(dentry);
400 inode_default_unix_mode(const struct wim_inode *inode)
402 if (inode_is_symlink(inode))
403 return S_IFLNK | 0777;
404 else if (inode_is_directory(inode))
405 return S_IFDIR | 0777;
407 return S_IFREG | 0777;
410 /* Transfers file attributes from a struct wim_inode to a `stat' buffer.
412 * The lookup table entry tells us which stream in the inode we are statting.
413 * For a named data stream, everything returned is the same as the unnamed data
414 * stream except possibly the size and block count. */
416 inode_to_stbuf(const struct wim_inode *inode,
417 const struct wim_lookup_table_entry *lte,
420 const struct wimfs_context *ctx = wimfs_get_context();
422 memset(stbuf, 0, sizeof(struct stat));
423 stbuf->st_mode = inode_default_unix_mode(inode);
424 stbuf->st_uid = ctx->default_uid;
425 stbuf->st_gid = ctx->default_gid;
426 if (ctx->mount_flags & WIMLIB_MOUNT_FLAG_UNIX_DATA) {
427 struct wimlib_unix_data unix_data;
428 if (inode_get_unix_data(inode, &unix_data, NULL) == 0) {
429 stbuf->st_uid = unix_data.uid;
430 stbuf->st_gid = unix_data.gid;
431 stbuf->st_mode = unix_data.mode;
434 stbuf->st_ino = (ino_t)inode->i_ino;
435 stbuf->st_nlink = inode->i_nlink;
437 stbuf->st_size = lte->size;
440 #ifdef HAVE_STAT_NANOSECOND_PRECISION
441 stbuf->st_atim = wim_timestamp_to_timespec(inode->i_last_access_time);
442 stbuf->st_mtim = wim_timestamp_to_timespec(inode->i_last_write_time);
443 stbuf->st_ctim = stbuf->st_mtim;
445 stbuf->st_atime = wim_timestamp_to_unix(inode->i_last_access_time);
446 stbuf->st_mtime = wim_timestamp_to_unix(inode->i_last_write_time);
447 stbuf->st_ctime = stbuf->st_mtime;
449 stbuf->st_blocks = (stbuf->st_size + 511) / 512;
454 touch_inode(struct wim_inode *inode)
456 u64 now = get_wim_timestamp();
457 inode->i_last_access_time = now;
458 inode->i_last_write_time = now;
461 /* Creates a new staging file and returns its file descriptor opened for
464 * @name_ret: A location into which the a pointer to the newly allocated name of
465 * the staging file is stored.
467 * @ctx: Context for the WIM filesystem; this provides the name of the
470 * On success, returns the file descriptor for the staging file, opened for
471 * writing. On failure, returns -1 and sets errno.
474 create_staging_file(char **name_ret, struct wimfs_context *ctx)
482 static const size_t STAGING_FILE_NAME_LEN = 20;
484 name_len = ctx->staging_dir_name_len + 1 + STAGING_FILE_NAME_LEN;
485 name = MALLOC(name_len + 1);
493 memcpy(name, ctx->staging_dir_name, ctx->staging_dir_name_len);
494 name[ctx->staging_dir_name_len] = '/';
495 randomize_char_array_with_alnum(name + ctx->staging_dir_name_len + 1,
496 STAGING_FILE_NAME_LEN);
497 name[name_len] = '\0';
500 /* Just in case, verify that the randomly generated name doesn't name an
501 * existing file, and try again if so */
502 } while (stat(name, &stbuf) == 0);
504 if (errno != ENOENT) /* other error?! */
507 /* doesn't exist--- ok */
509 DEBUG("Creating staging file `%s'", name);
511 fd = open(name, O_WRONLY | O_CREAT | O_EXCL, 0600);
523 * Extract a WIM resource to the staging directory.
525 * @inode: Inode that contains the stream we are extracting
527 * @stream_id: Identifier for the stream (it stays constant even if the indices
528 * of the stream entries are changed)
530 * @lte: Pointer to pointer to the lookup table entry for the stream we need to
531 * extract, or NULL if there was no lookup table entry present for the stream
533 * @size: Number of bytes of the stream we want to extract (this supports the
534 * wimfs_truncate() function). It may be more than the actual stream length, in
535 * which case the extra space is filled with zeroes.
537 * @ctx: Context for the WIM filesystem.
539 * Returns 0 on success or a negative error code on failure.
542 extract_resource_to_staging_dir(struct wim_inode *inode,
544 struct wim_lookup_table_entry **lte,
546 struct wimfs_context *ctx)
548 char *staging_file_name;
551 struct wim_lookup_table_entry *old_lte, *new_lte;
554 DEBUG("Extracting resource to staging dir: inode %"PRIu64", "
555 "stream id %"PRIu32, inode->i_ino, stream_id);
559 wimlib_assert(old_lte == NULL ||
560 old_lte->resource_location != RESOURCE_IN_STAGING_FILE);
562 /* Create the staging file */
563 fd = create_staging_file(&staging_file_name, ctx);
567 /* Extract the stream to the staging file (possibly truncated) */
569 struct filedes wimlib_fd;
570 filedes_init(&wimlib_fd, fd);
571 extract_size = min(old_lte->size, size);
572 ret = extract_stream_to_fd(old_lte, &wimlib_fd, extract_size);
578 /* In the case of truncate() to more than the file length, extend the
579 * file with zeroes by calling ftruncate() on the underlying staging
581 if (ret == 0 && size > extract_size)
582 ret = ftruncate(fd, size);
584 /* Close the staging file descriptor and check for errors. If there's
585 * an error, unlink the staging file. */
586 if (ret != 0 || close(fd) != 0) {
592 goto out_delete_staging_file;
595 /* Now deal with the lookup table entries. We may be able to re-use the
596 * existing entry, but we may have to create a new one instead. */
598 if (old_lte && inode->i_nlink == old_lte->refcnt) {
599 /* The reference count of the existing lookup table entry is the
600 * same as the link count of the inode that contains the stream
601 * we're opening. Therefore, ALL the references to the lookup
602 * table entry correspond to the stream we're trying to extract,
603 * so the lookup table entry can be re-used. */
604 DEBUG("Re-using lookup table entry");
605 lookup_table_unlink(ctx->wim->lookup_table, old_lte);
609 /* There's an existing lookup table entry, but its
610 * reference count is greater than the link count for
611 * the inode containing a stream we're opening.
612 * Therefore, we need to split the lookup table entry.
614 wimlib_assert(old_lte->refcnt > inode->i_nlink);
615 DEBUG("Splitting lookup table entry "
616 "(inode->i_nlink = %u, old_lte->refcnt = %u)",
617 inode->i_nlink, old_lte->refcnt);
620 new_lte = new_lookup_table_entry();
623 goto out_delete_staging_file;
626 /* There may already be open file descriptors to this stream if
627 * it's previously been opened read-only, but just now we're
628 * opening it read-write. Identify those file descriptors and
629 * change their lookup table entry pointers to point to the new
630 * lookup table entry, and open staging file descriptors for
633 * At the same time, we need to count the number of these opened
634 * file descriptors to the new lookup table entry. If there's
635 * an old lookup table entry, this number needs to be subtracted
636 * from the fd's opened to the old entry. */
637 for (u16 i = 0, j = 0; j < inode->i_num_opened_fds; i++) {
638 struct wimfs_fd *fd = inode->i_fds[i];
640 if (fd->stream_id == stream_id) {
643 wimlib_assert(fd->f_lte == old_lte);
644 wimlib_assert(!filedes_valid(&fd->staging_fd));
646 new_lte->num_opened_fds++;
647 raw_fd = open(staging_file_name, O_RDONLY);
650 goto out_revert_fd_changes;
652 filedes_init(&fd->staging_fd, raw_fd);
657 DEBUG("%hu fd's were already opened to the file we extracted",
658 new_lte->num_opened_fds);
660 old_lte->num_opened_fds -= new_lte->num_opened_fds;
661 old_lte->refcnt -= inode->i_nlink;
665 new_lte->refcnt = inode->i_nlink;
666 new_lte->resource_location = RESOURCE_IN_STAGING_FILE;
667 new_lte->staging_file_name = staging_file_name;
668 new_lte->size = size;
670 lookup_table_insert_unhashed(ctx->wim->lookup_table, new_lte,
672 *retrieve_lte_pointer(new_lte) = new_lte;
675 out_revert_fd_changes:
676 for (u16 i = 0, j = 0; j < new_lte->num_opened_fds; i++) {
677 struct wimfs_fd *fd = inode->i_fds[i];
678 if (fd && fd->stream_id == stream_id && fd->f_lte == new_lte) {
680 if (filedes_valid(&fd->staging_fd)) {
681 filedes_close(&fd->staging_fd);
682 filedes_invalidate(&fd->staging_fd);
687 free_lookup_table_entry(new_lte);
688 out_delete_staging_file:
689 unlink(staging_file_name);
690 FREE(staging_file_name);
695 * Creates a randomly named staging directory and saves its name in the
696 * filesystem context structure.
699 make_staging_dir(struct wimfs_context *ctx, const char *user_prefix)
701 static const size_t random_suffix_len = 10;
702 static const char *common_suffix = ".staging";
703 static const size_t common_suffix_len = 8;
705 char *staging_dir_name = NULL;
706 size_t staging_dir_name_len;
708 const char *wim_basename;
709 char *real_user_prefix = NULL;
713 real_user_prefix = realpath(user_prefix, NULL);
714 if (!real_user_prefix) {
715 ERROR_WITH_ERRNO("Could not resolve `%s'",
717 ret = WIMLIB_ERR_NOTDIR;
720 wim_basename = path_basename(ctx->wim->filename);
721 prefix_len = strlen(real_user_prefix) + 1 + strlen(wim_basename);
723 prefix_len = strlen(ctx->wim->filename);
726 staging_dir_name_len = prefix_len + common_suffix_len + random_suffix_len;
728 staging_dir_name = MALLOC(staging_dir_name_len + 1);
729 if (!staging_dir_name) {
730 ret = WIMLIB_ERR_NOMEM;
734 if (real_user_prefix)
735 sprintf(staging_dir_name, "%s/%s", real_user_prefix, wim_basename);
737 strcpy(staging_dir_name, ctx->wim->filename);
739 strcat(staging_dir_name, common_suffix);
741 randomize_char_array_with_alnum(staging_dir_name + prefix_len + common_suffix_len,
744 staging_dir_name[staging_dir_name_len] = '\0';
746 if (mkdir(staging_dir_name, 0700) != 0) {
747 ERROR_WITH_ERRNO("Failed to create temporary directory `%s'",
749 ret = WIMLIB_ERR_MKDIR;
754 FREE(real_user_prefix);
756 ctx->staging_dir_name = staging_dir_name;
757 ctx->staging_dir_name_len = staging_dir_name_len;
759 FREE(staging_dir_name);
765 remove_file_or_directory(const char *fpath, const struct stat *sb,
766 int typeflag, struct FTW *ftwbuf)
768 if (remove(fpath) == 0)
771 ERROR_WITH_ERRNO("Cannot remove `%s'", fpath);
772 return WIMLIB_ERR_DELETE_STAGING_DIR;
777 * Deletes the staging directory and all the files contained in it.
780 delete_staging_dir(struct wimfs_context *ctx)
783 ret = nftw(ctx->staging_dir_name, remove_file_or_directory,
785 FREE(ctx->staging_dir_name);
786 ctx->staging_dir_name = NULL;
791 inode_close_fds(struct wim_inode *inode)
793 u16 num_opened_fds = inode->i_num_opened_fds;
794 for (u16 i = 0, j = 0; j < num_opened_fds; i++) {
795 struct wimfs_fd *fd = inode->i_fds[i];
797 wimlib_assert(fd->f_inode == inode);
798 int ret = close_wimfs_fd(fd);
807 /* Overwrites the WIM file, with changes saved. */
809 rebuild_wim(struct wimfs_context *ctx, int write_flags,
810 wimlib_progress_func_t progress_func)
813 struct wim_lookup_table_entry *lte, *tmp;
814 WIMStruct *wim = ctx->wim;
815 struct wim_image_metadata *imd = wim_get_current_image_metadata(ctx->wim);
817 DEBUG("Closing all staging file descriptors.");
818 image_for_each_unhashed_stream_safe(lte, tmp, imd) {
819 ret = inode_close_fds(lte->back_inode);
824 DEBUG("Freeing entries for zero-length streams");
825 image_for_each_unhashed_stream_safe(lte, tmp, imd) {
826 wimlib_assert(lte->unhashed);
827 if (lte->size == 0) {
828 struct wim_lookup_table_entry **back_ptr;
829 back_ptr = retrieve_lte_pointer(lte);
831 list_del(<e->unhashed_list);
832 free_lookup_table_entry(lte);
836 xml_update_image_info(wim, wim->current_image);
837 ret = wimlib_overwrite(wim, write_flags, 0, progress_func);
839 ERROR("Failed to commit changes to mounted WIM image");
843 /* Simple function that returns the concatenation of 2 strings. */
845 strcat_dup(const char *s1, const char *s2, size_t max_len)
847 size_t len = strlen(s1) + strlen(s2);
850 char *p = MALLOC(len + 1);
853 snprintf(p, len + 1, "%s%s", s1, s2);
858 set_message_queue_names(struct wimfs_context *ctx, const char *mount_dir)
860 static const char *u2d_prefix = "/wimlib-unmount-to-daemon-mq";
861 static const char *d2u_prefix = "/wimlib-daemon-to-unmount-mq";
866 dir_path = realpath(mount_dir, NULL);
868 ERROR_WITH_ERRNO("Failed to resolve path \"%s\"", mount_dir);
870 return WIMLIB_ERR_NOMEM;
872 return WIMLIB_ERR_NOTDIR;
875 for (p = dir_path; *p; p++)
879 ctx->unmount_to_daemon_mq_name = strcat_dup(u2d_prefix, dir_path,
881 if (!ctx->unmount_to_daemon_mq_name) {
882 ret = WIMLIB_ERR_NOMEM;
883 goto out_free_dir_path;
885 ctx->daemon_to_unmount_mq_name = strcat_dup(d2u_prefix, dir_path,
887 if (!ctx->daemon_to_unmount_mq_name) {
888 ret = WIMLIB_ERR_NOMEM;
889 goto out_free_unmount_to_daemon_mq_name;
893 goto out_free_dir_path;
894 out_free_unmount_to_daemon_mq_name:
895 FREE(ctx->unmount_to_daemon_mq_name);
896 ctx->unmount_to_daemon_mq_name = NULL;
903 free_message_queue_names(struct wimfs_context *ctx)
905 FREE(ctx->unmount_to_daemon_mq_name);
906 FREE(ctx->daemon_to_unmount_mq_name);
907 ctx->unmount_to_daemon_mq_name = NULL;
908 ctx->daemon_to_unmount_mq_name = NULL;
912 * Opens two POSIX message queue: one for sending messages from the unmount
913 * process to the daemon process, and one to go the other way. The names of the
914 * message queues, which must be system-wide unique, are be based on the mount
917 * @daemon specifies whether the calling process is the filesystem daemon or the
921 open_message_queues(struct wimfs_context *ctx, bool daemon)
923 int unmount_to_daemon_mq_flags = O_WRONLY | O_CREAT;
924 int daemon_to_unmount_mq_flags = O_RDONLY | O_CREAT;
930 swap(unmount_to_daemon_mq_flags, daemon_to_unmount_mq_flags);
936 orig_umask = umask(0000);
937 DEBUG("Opening message queue \"%s\"", ctx->unmount_to_daemon_mq_name);
938 ctx->unmount_to_daemon_mq = mq_open(ctx->unmount_to_daemon_mq_name,
939 unmount_to_daemon_mq_flags, mode, NULL);
941 if (ctx->unmount_to_daemon_mq == (mqd_t)-1) {
942 ERROR_WITH_ERRNO("mq_open()");
943 ret = WIMLIB_ERR_MQUEUE;
947 DEBUG("Opening message queue \"%s\"", ctx->daemon_to_unmount_mq_name);
948 ctx->daemon_to_unmount_mq = mq_open(ctx->daemon_to_unmount_mq_name,
949 daemon_to_unmount_mq_flags, mode, NULL);
951 if (ctx->daemon_to_unmount_mq == (mqd_t)-1) {
952 ERROR_WITH_ERRNO("mq_open()");
953 mq_close(ctx->unmount_to_daemon_mq);
954 mq_unlink(ctx->unmount_to_daemon_mq_name);
955 ctx->unmount_to_daemon_mq = (mqd_t)-1;
956 ret = WIMLIB_ERR_MQUEUE;
965 /* Try to determine the maximum message size of a message queue. The return
966 * value is the maximum message size, or a guess of 8192 bytes if it cannot be
969 mq_get_msgsize(mqd_t mq)
971 static const char *msgsize_max_file = "/proc/sys/fs/mqueue/msgsize_max";
976 if (mq_getattr(mq, &attr) == 0) {
977 msgsize = attr.mq_msgsize;
979 ERROR_WITH_ERRNO("mq_getattr()");
980 ERROR("Attempting to read %s", msgsize_max_file);
981 fp = fopen(msgsize_max_file, "rb");
983 if (fscanf(fp, "%ld", &msgsize) != 1) {
984 ERROR("Assuming message size of 8192");
989 ERROR_WITH_ERRNO("Failed to open the file `%s'",
991 ERROR("Assuming message size of 8192");
999 get_mailbox(mqd_t mq, long needed_msgsize, long *msgsize_ret,
1005 msgsize = mq_get_msgsize(mq);
1007 if (msgsize < needed_msgsize) {
1008 ERROR("Message queue max size must be at least %ld!",
1010 return WIMLIB_ERR_MQUEUE;
1013 mailbox = MALLOC(msgsize);
1015 ERROR("Failed to allocate %ld bytes for mailbox", msgsize);
1016 return WIMLIB_ERR_NOMEM;
1018 *msgsize_ret = msgsize;
1019 *mailbox_ret = mailbox;
1024 unlink_message_queues(struct wimfs_context *ctx)
1026 mq_unlink(ctx->unmount_to_daemon_mq_name);
1027 mq_unlink(ctx->daemon_to_unmount_mq_name);
1030 /* Closes the message queues, which are allocated in static variables */
1032 close_message_queues(struct wimfs_context *ctx)
1034 DEBUG("Closing message queues");
1035 mq_close(ctx->unmount_to_daemon_mq);
1036 ctx->unmount_to_daemon_mq = (mqd_t)(-1);
1037 mq_close(ctx->daemon_to_unmount_mq);
1038 ctx->daemon_to_unmount_mq = (mqd_t)(-1);
1039 unlink_message_queues(ctx);
1043 struct unmount_msg_hdr {
1048 } _packed_attribute;
1050 struct msg_unmount_request {
1051 struct unmount_msg_hdr hdr;
1053 u8 want_progress_messages;
1054 } _packed_attribute;
1056 struct msg_daemon_info {
1057 struct unmount_msg_hdr hdr;
1060 } _packed_attribute;
1062 struct msg_unmount_finished {
1063 struct unmount_msg_hdr hdr;
1065 } _packed_attribute;
1067 struct msg_write_streams_progress {
1068 struct unmount_msg_hdr hdr;
1069 union wimlib_progress_info info;
1070 } _packed_attribute;
1073 MSG_TYPE_UNMOUNT_REQUEST,
1074 MSG_TYPE_DAEMON_INFO,
1075 MSG_TYPE_WRITE_STREAMS_PROGRESS,
1076 MSG_TYPE_UNMOUNT_FINISHED,
1080 struct msg_handler_context_hdr {
1081 int timeout_seconds;
1084 struct unmount_msg_handler_context {
1085 struct msg_handler_context_hdr hdr;
1089 wimlib_progress_func_t progress_func;
1092 struct daemon_msg_handler_context {
1093 struct msg_handler_context_hdr hdr;
1094 struct wimfs_context *wimfs_ctx;
1098 send_unmount_request_msg(mqd_t mq, int unmount_flags, u8 want_progress_messages)
1100 DEBUG("Sending unmount request msg");
1101 struct msg_unmount_request msg = {
1103 .min_version = WIMLIB_MAKEVERSION(1, 2, 1),
1104 .cur_version = WIMLIB_VERSION_CODE,
1105 .msg_type = MSG_TYPE_UNMOUNT_REQUEST,
1106 .msg_size = sizeof(msg),
1108 .unmount_flags = unmount_flags,
1109 .want_progress_messages = want_progress_messages,
1112 if (mq_send(mq, (void*)&msg, sizeof(msg), 1)) {
1113 ERROR_WITH_ERRNO("Failed to communicate with filesystem daemon");
1114 return WIMLIB_ERR_MQUEUE;
1120 send_daemon_info_msg(mqd_t mq, pid_t pid, int mount_flags)
1122 DEBUG("Sending daemon info msg (pid = %d, mount_flags=%x)",
1125 struct msg_daemon_info msg = {
1127 .min_version = WIMLIB_MAKEVERSION(1, 2, 1),
1128 .cur_version = WIMLIB_VERSION_CODE,
1129 .msg_type = MSG_TYPE_DAEMON_INFO,
1130 .msg_size = sizeof(msg),
1133 .mount_flags = mount_flags,
1135 if (mq_send(mq, (void*)&msg, sizeof(msg), 1)) {
1136 ERROR_WITH_ERRNO("Failed to send daemon info to unmount process");
1137 return WIMLIB_ERR_MQUEUE;
1143 send_unmount_finished_msg(mqd_t mq, int status)
1145 DEBUG("Sending unmount finished msg");
1146 struct msg_unmount_finished msg = {
1148 .min_version = WIMLIB_MAKEVERSION(1, 2, 1),
1149 .cur_version = WIMLIB_VERSION_CODE,
1150 .msg_type = MSG_TYPE_UNMOUNT_FINISHED,
1151 .msg_size = sizeof(msg),
1155 if (mq_send(mq, (void*)&msg, sizeof(msg), 1))
1156 ERROR_WITH_ERRNO("Failed to send status to unmount process");
1160 unmount_progress_func(enum wimlib_progress_msg msg,
1161 const union wimlib_progress_info *info)
1163 if (msg == WIMLIB_PROGRESS_MSG_WRITE_STREAMS) {
1164 struct msg_write_streams_progress msg = {
1166 .min_version = WIMLIB_MAKEVERSION(1, 2, 1),
1167 .cur_version = WIMLIB_VERSION_CODE,
1168 .msg_type = MSG_TYPE_WRITE_STREAMS_PROGRESS,
1169 .msg_size = sizeof(msg),
1173 if (mq_send(wimfs_get_context()->daemon_to_unmount_mq,
1174 (void*)&msg, sizeof(msg), 1))
1176 ERROR_WITH_ERRNO("Failed to send progress information "
1177 "to unmount process");
1184 msg_unmount_request_handler(const void *_msg, void *_handler_ctx)
1186 const struct msg_unmount_request *msg = _msg;
1187 struct daemon_msg_handler_context *handler_ctx = _handler_ctx;
1188 struct wimfs_context *wimfs_ctx;
1192 wimlib_progress_func_t progress_func;
1194 DEBUG("Handling unmount request msg");
1196 wimfs_ctx = handler_ctx->wimfs_ctx;
1197 if (msg->hdr.msg_size < sizeof(*msg)) {
1198 status = WIMLIB_ERR_INVALID_UNMOUNT_MESSAGE;
1202 unmount_flags = msg->unmount_flags;
1203 if (msg->want_progress_messages)
1204 progress_func = unmount_progress_func;
1206 progress_func = NULL;
1208 ret = send_daemon_info_msg(wimfs_ctx->daemon_to_unmount_mq, getpid(),
1209 wimfs_ctx->mount_flags);
1215 if (wimfs_ctx->mount_flags & WIMLIB_MOUNT_FLAG_READWRITE) {
1216 if (unmount_flags & WIMLIB_UNMOUNT_FLAG_COMMIT) {
1217 int write_flags = 0;
1218 if (unmount_flags & WIMLIB_UNMOUNT_FLAG_CHECK_INTEGRITY)
1219 write_flags |= WIMLIB_WRITE_FLAG_CHECK_INTEGRITY;
1220 if (unmount_flags & WIMLIB_UNMOUNT_FLAG_REBUILD)
1221 write_flags |= WIMLIB_WRITE_FLAG_REBUILD;
1222 if (unmount_flags & WIMLIB_UNMOUNT_FLAG_RECOMPRESS)
1223 write_flags |= WIMLIB_WRITE_FLAG_RECOMPRESS;
1224 status = rebuild_wim(wimfs_ctx, write_flags,
1228 DEBUG("Read-only mount");
1233 if (wimfs_ctx->mount_flags & WIMLIB_MOUNT_FLAG_READWRITE) {
1234 ret = delete_staging_dir(wimfs_ctx);
1236 ERROR("Failed to delete the staging directory");
1241 wimfs_ctx->status = status;
1242 wimfs_ctx->have_status = true;
1243 return MSG_BREAK_LOOP;
1247 msg_daemon_info_handler(const void *_msg, void *_handler_ctx)
1249 const struct msg_daemon_info *msg = _msg;
1250 struct unmount_msg_handler_context *handler_ctx = _handler_ctx;
1252 DEBUG("Handling daemon info msg");
1253 if (msg->hdr.msg_size < sizeof(*msg))
1254 return WIMLIB_ERR_INVALID_UNMOUNT_MESSAGE;
1255 handler_ctx->daemon_pid = msg->daemon_pid;
1256 handler_ctx->mount_flags = msg->mount_flags;
1257 handler_ctx->hdr.timeout_seconds = 1;
1258 DEBUG("pid of daemon is %d; mount flags were %#x",
1259 handler_ctx->daemon_pid,
1260 handler_ctx->mount_flags);
1265 msg_write_streams_progress_handler(const void *_msg, void *_handler_ctx)
1267 const struct msg_write_streams_progress *msg = _msg;
1268 struct unmount_msg_handler_context *handler_ctx = _handler_ctx;
1270 if (msg->hdr.msg_size < sizeof(*msg))
1271 return WIMLIB_ERR_INVALID_UNMOUNT_MESSAGE;
1272 if (handler_ctx->progress_func) {
1273 handler_ctx->progress_func(WIMLIB_PROGRESS_MSG_WRITE_STREAMS,
1280 msg_unmount_finished_handler(const void *_msg, void *_handler_ctx)
1282 const struct msg_unmount_finished *msg = _msg;
1283 struct unmount_msg_handler_context *handler_ctx = _handler_ctx;
1285 DEBUG("Handling unmount finished message");
1286 if (msg->hdr.msg_size < sizeof(*msg))
1287 return WIMLIB_ERR_INVALID_UNMOUNT_MESSAGE;
1288 handler_ctx->status = msg->status;
1289 DEBUG("status is %d", handler_ctx->status);
1290 return MSG_BREAK_LOOP;
1294 unmount_timed_out_cb(void *_handler_ctx)
1296 struct unmount_msg_handler_context *handler_ctx = _handler_ctx;
1298 if (handler_ctx->daemon_pid == 0) {
1301 kill(handler_ctx->daemon_pid, 0);
1302 if (errno == ESRCH) {
1305 DEBUG("Filesystem daemon is still alive... "
1306 "Waiting another %d seconds\n",
1307 handler_ctx->hdr.timeout_seconds);
1312 ERROR("The filesystem daemon has crashed! Changes to the "
1313 "WIM may not have been commited.");
1314 return WIMLIB_ERR_FILESYSTEM_DAEMON_CRASHED;
1318 daemon_timed_out_cb(void *_handler_ctx)
1320 ERROR("Timed out waiting for unmount request! "
1321 "Changes to the mounted WIM will not be committed.");
1322 return WIMLIB_ERR_TIMEOUT;
1325 typedef int (*msg_handler_t)(const void *_msg, void *_handler_ctx);
1327 struct msg_handler_callbacks {
1328 int (*timed_out)(void * _handler_ctx);
1329 msg_handler_t msg_handlers[MSG_TYPE_MAX];
1332 static const struct msg_handler_callbacks unmount_msg_handler_callbacks = {
1333 .timed_out = unmount_timed_out_cb,
1335 [MSG_TYPE_DAEMON_INFO] = msg_daemon_info_handler,
1336 [MSG_TYPE_WRITE_STREAMS_PROGRESS] = msg_write_streams_progress_handler,
1337 [MSG_TYPE_UNMOUNT_FINISHED] = msg_unmount_finished_handler,
1341 static const struct msg_handler_callbacks daemon_msg_handler_callbacks = {
1342 .timed_out = daemon_timed_out_cb,
1344 [MSG_TYPE_UNMOUNT_REQUEST] = msg_unmount_request_handler,
1349 receive_message(mqd_t mq,
1350 struct msg_handler_context_hdr *handler_ctx,
1351 const msg_handler_t msg_handlers[],
1352 long mailbox_size, void *mailbox)
1355 struct timespec timeout;
1356 ssize_t bytes_received;
1357 struct unmount_msg_hdr *hdr;
1360 gettimeofday(&now, NULL);
1361 timeout.tv_sec = now.tv_sec + handler_ctx->timeout_seconds;
1362 timeout.tv_nsec = now.tv_usec * 1000;
1364 bytes_received = mq_timedreceive(mq, mailbox,
1365 mailbox_size, NULL, &timeout);
1367 if (bytes_received == -1) {
1368 if (errno == ETIMEDOUT) {
1369 ret = WIMLIB_ERR_TIMEOUT;
1371 ERROR_WITH_ERRNO("mq_timedreceive()");
1372 ret = WIMLIB_ERR_MQUEUE;
1374 } else if (bytes_received < sizeof(*hdr) ||
1375 bytes_received != hdr->msg_size) {
1376 ret = WIMLIB_ERR_INVALID_UNMOUNT_MESSAGE;
1377 } else if (WIMLIB_VERSION_CODE < hdr->min_version) {
1378 /*ERROR("Cannot understand the received message. "*/
1379 /*"Please upgrade wimlib to at least v%d.%d.%d",*/
1380 /*WIMLIB_GET_MAJOR_VERSION(hdr->min_version),*/
1381 /*WIMLIB_GET_MINOR_VERSION(hdr->min_version),*/
1382 /*WIMLIB_GET_PATCH_VERSION(hdr->min_version));*/
1383 ret = MSG_VERSION_TOO_HIGH;
1384 } else if (hdr->msg_type >= MSG_TYPE_MAX) {
1385 ret = WIMLIB_ERR_INVALID_UNMOUNT_MESSAGE;
1386 } else if (msg_handlers[hdr->msg_type] == NULL) {
1387 ret = WIMLIB_ERR_INVALID_UNMOUNT_MESSAGE;
1389 ret = msg_handlers[hdr->msg_type](mailbox, handler_ctx);
1395 message_loop(mqd_t mq,
1396 const struct msg_handler_callbacks *callbacks,
1397 struct msg_handler_context_hdr *handler_ctx)
1399 static const size_t MAX_MSG_SIZE = 512;
1404 DEBUG("Entering message loop");
1406 ret = get_mailbox(mq, MAX_MSG_SIZE, &msgsize, &mailbox);
1410 ret = receive_message(mq, handler_ctx,
1411 callbacks->msg_handlers,
1413 if (ret == 0 || ret == MSG_VERSION_TOO_HIGH) {
1415 } else if (ret == MSG_BREAK_LOOP) {
1418 } else if (ret == WIMLIB_ERR_TIMEOUT) {
1419 if (callbacks->timed_out)
1420 ret = callbacks->timed_out(handler_ctx);
1426 ERROR_WITH_ERRNO("Error communicating with "
1427 "filesystem daemon");
1432 DEBUG("Exiting message loop");
1436 /* Execute `fusermount -u', which is installed setuid root, to unmount the WIM.
1438 * FUSE does not yet implement synchronous unmounts. This means that fusermount
1439 * -u will return before the filesystem daemon returns from wimfs_destroy().
1440 * This is partly what we want, because we need to send a message from this
1441 * process to the filesystem daemon telling whether --commit was specified or
1442 * not. However, after that, the unmount process must wait for the filesystem
1443 * daemon to finish writing the WIM file.
1446 execute_fusermount(const char *dir, bool lazy)
1454 ERROR_WITH_ERRNO("Failed to fork()");
1455 return WIMLIB_ERR_FORK;
1461 *argp++ = "fusermount";
1465 *argp++ = (char*)dir;
1467 execvp("fusermount", argv);
1468 ERROR_WITH_ERRNO("Failed to execute `fusermount'");
1469 exit(WIMLIB_ERR_FUSERMOUNT);
1473 ret = waitpid(pid, &status, 0);
1475 ERROR_WITH_ERRNO("Failed to wait for fusermount process to "
1477 return WIMLIB_ERR_FUSERMOUNT;
1480 if (!WIFEXITED(status)) {
1481 ERROR("'fusermount' did not terminate normally!");
1482 return WIMLIB_ERR_FUSERMOUNT;
1485 status = WEXITSTATUS(status);
1490 if (status != WIMLIB_ERR_FUSERMOUNT)
1491 return WIMLIB_ERR_FUSERMOUNT;
1493 /* Try again, but with the `umount' program. This is required on other
1494 * FUSE implementations such as FreeBSD's that do not have a
1495 * `fusermount' program. */
1496 ERROR("Falling back to 'umount'. Note: you may need to be "
1497 "root for this to work");
1500 ERROR_WITH_ERRNO("Failed to fork()");
1501 return WIMLIB_ERR_FORK;
1510 *argp++ = (char*)dir;
1512 execvp("umount", argv);
1513 ERROR_WITH_ERRNO("Failed to execute `umount'");
1514 exit(WIMLIB_ERR_FUSERMOUNT);
1518 ret = waitpid(pid, &status, 0);
1520 ERROR_WITH_ERRNO("Failed to wait for `umount' process to "
1522 return WIMLIB_ERR_FUSERMOUNT;
1525 ERROR("`umount' did not successfully complete");
1526 return WIMLIB_ERR_FUSERMOUNT;
1532 wimfs_chmod(const char *path, mode_t mask)
1534 struct wim_dentry *dentry;
1535 struct wimfs_context *ctx = wimfs_get_context();
1538 if (!(ctx->mount_flags & WIMLIB_MOUNT_FLAG_UNIX_DATA))
1541 ret = wim_pathname_to_stream(ctx->wim, path, LOOKUP_FLAG_DIRECTORY_OK,
1542 &dentry, NULL, NULL);
1546 ret = inode_set_unix_data(dentry->d_inode, ctx->default_uid,
1547 ctx->default_gid, mask,
1548 ctx->wim->lookup_table, UNIX_DATA_MODE);
1549 return ret ? -ENOMEM : 0;
1553 wimfs_chown(const char *path, uid_t uid, gid_t gid)
1555 struct wim_dentry *dentry;
1556 struct wimfs_context *ctx = wimfs_get_context();
1559 if (!(ctx->mount_flags & WIMLIB_MOUNT_FLAG_UNIX_DATA))
1562 ret = wim_pathname_to_stream(ctx->wim, path, LOOKUP_FLAG_DIRECTORY_OK,
1563 &dentry, NULL, NULL);
1567 ret = inode_set_unix_data(dentry->d_inode, uid, gid,
1568 inode_default_unix_mode(dentry->d_inode),
1569 ctx->wim->lookup_table,
1570 UNIX_DATA_UID | UNIX_DATA_GID);
1571 return ret ? -ENOMEM : 0;
1574 /* Called when the filesystem is unmounted. */
1576 wimfs_destroy(void *p)
1578 struct wimfs_context *wimfs_ctx = wimfs_get_context();
1579 if (open_message_queues(wimfs_ctx, true) == 0) {
1580 struct daemon_msg_handler_context handler_ctx = {
1582 .timeout_seconds = 5,
1584 .wimfs_ctx = wimfs_ctx,
1586 message_loop(wimfs_ctx->unmount_to_daemon_mq,
1587 &daemon_msg_handler_callbacks,
1593 wimfs_fgetattr(const char *path, struct stat *stbuf,
1594 struct fuse_file_info *fi)
1596 struct wimfs_fd *fd = (struct wimfs_fd*)(uintptr_t)fi->fh;
1597 return inode_to_stbuf(fd->f_inode, fd->f_lte, stbuf);
1601 wimfs_ftruncate(const char *path, off_t size, struct fuse_file_info *fi)
1603 struct wimfs_fd *fd = (struct wimfs_fd*)(uintptr_t)fi->fh;
1604 int ret = ftruncate(fd->staging_fd.fd, size);
1607 touch_inode(fd->f_inode);
1608 fd->f_lte->size = size;
1613 * Fills in a `struct stat' that corresponds to a file or directory in the WIM.
1616 wimfs_getattr(const char *path, struct stat *stbuf)
1618 struct wim_dentry *dentry;
1619 struct wim_lookup_table_entry *lte;
1621 struct wimfs_context *ctx = wimfs_get_context();
1623 ret = wim_pathname_to_stream(ctx->wim, path,
1624 get_lookup_flags(ctx) |
1625 LOOKUP_FLAG_DIRECTORY_OK,
1626 &dentry, <e, NULL);
1629 return inode_to_stbuf(dentry->d_inode, lte, stbuf);
1633 /* Read an alternate data stream through the XATTR interface, or get its size */
1635 wimfs_getxattr(const char *path, const char *name, char *value,
1639 struct wim_inode *inode;
1640 struct wim_ads_entry *ads_entry;
1642 struct wim_lookup_table_entry *lte;
1643 struct wimfs_context *ctx = wimfs_get_context();
1645 if (!(ctx->mount_flags & WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_XATTR))
1648 if (strlen(name) <= 5 || memcmp(name, "user.", 5) != 0)
1652 inode = wim_pathname_to_inode(ctx->wim, path);
1656 ads_entry = inode_get_ads_entry(inode, name, NULL);
1660 lte = ads_entry->lte;
1661 stream_size = lte->size;
1666 if (stream_size > size)
1669 ret = read_full_stream_into_buf(lte, value);
1680 /* Create a hard link */
1682 wimfs_link(const char *to, const char *from)
1684 struct wim_dentry *from_dentry, *from_dentry_parent;
1685 const char *link_name;
1686 struct wim_inode *inode;
1687 WIMStruct *wim = wimfs_get_WIMStruct();
1690 inode = wim_pathname_to_inode(wim, to);
1694 if (inode->i_attributes & (FILE_ATTRIBUTE_DIRECTORY |
1695 FILE_ATTRIBUTE_REPARSE_POINT))
1698 from_dentry_parent = get_parent_dentry(wim, from);
1699 if (!from_dentry_parent)
1701 if (!dentry_is_directory(from_dentry_parent))
1704 link_name = path_basename(from);
1705 if (get_dentry_child_with_name(from_dentry_parent, link_name))
1708 ret = new_dentry(link_name, &from_dentry);
1713 inode_ref_streams(inode);
1714 from_dentry->d_inode = inode;
1715 inode_add_dentry(from_dentry, inode);
1716 dentry_add_child(from_dentry_parent, from_dentry);
1722 wimfs_listxattr(const char *path, char *list, size_t size)
1725 struct wim_inode *inode;
1726 struct wimfs_context *ctx = wimfs_get_context();
1729 bool size_only = (size == 0);
1731 if (!(ctx->mount_flags & WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_XATTR))
1734 /* List alternate data streams, or get the list size */
1736 inode = wim_pathname_to_inode(ctx->wim, path);
1741 for (i = 0; i < inode->i_num_ads; i++) {
1743 if (!ads_entry_is_named_stream(&inode->i_ads_entries[i]))
1746 char *stream_name_mbs;
1747 size_t stream_name_mbs_nbytes;
1750 ret = utf16le_to_tstr(inode->i_ads_entries[i].stream_name,
1751 inode->i_ads_entries[i].stream_name_nbytes,
1753 &stream_name_mbs_nbytes);
1757 needed_size = stream_name_mbs_nbytes + 6;
1759 if (needed_size > size) {
1760 FREE(stream_name_mbs);
1763 sprintf(p, "user.%s", stream_name_mbs);
1764 size -= needed_size;
1767 FREE(stream_name_mbs);
1774 /* Create a directory in the WIM image. */
1776 wimfs_mkdir(const char *path, mode_t mode)
1778 return create_dentry(fuse_get_context(), path, mode | S_IFDIR,
1779 FILE_ATTRIBUTE_DIRECTORY, NULL);
1782 /* Create a regular file or alternate data stream in the WIM image. */
1784 wimfs_mknod(const char *path, mode_t mode, dev_t rdev)
1786 const char *stream_name;
1787 struct fuse_context *fuse_ctx = fuse_get_context();
1788 struct wimfs_context *wimfs_ctx = WIMFS_CTX(fuse_ctx);
1793 if ((wimfs_ctx->mount_flags & WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_WINDOWS)
1794 && (stream_name = path_stream_name(path))) {
1795 /* Make an alternate data stream */
1796 struct wim_ads_entry *new_entry;
1797 struct wim_inode *inode;
1799 char *p = (char*)stream_name - 1;
1800 wimlib_assert(*p == ':');
1803 inode = wim_pathname_to_inode(wimfs_ctx->wim, path);
1806 if (inode->i_attributes & FILE_ATTRIBUTE_REPARSE_POINT)
1808 if (inode_get_ads_entry(inode, stream_name, NULL))
1810 new_entry = inode_add_ads(inode, stream_name);
1815 /* Make a normal file (not an alternate data stream) */
1816 return create_dentry(fuse_ctx, path, mode | S_IFREG,
1817 FILE_ATTRIBUTE_NORMAL, NULL);
1823 wimfs_open(const char *path, struct fuse_file_info *fi)
1825 struct wim_dentry *dentry;
1826 struct wim_lookup_table_entry *lte;
1828 struct wimfs_fd *fd;
1829 struct wim_inode *inode;
1832 struct wimfs_context *ctx = wimfs_get_context();
1833 struct wim_lookup_table_entry **back_ptr;
1835 ret = wim_pathname_to_stream(ctx->wim, path, get_lookup_flags(ctx),
1836 &dentry, <e, &stream_idx);
1840 inode = dentry->d_inode;
1842 if (stream_idx == 0) {
1844 back_ptr = &inode->i_lte;
1846 stream_id = inode->i_ads_entries[stream_idx - 1].stream_id;
1847 back_ptr = &inode->i_ads_entries[stream_idx - 1].lte;
1850 /* The file resource may be in the staging directory (read-write mounts
1851 * only) or in the WIM. If it's in the staging directory, we need to
1852 * open a native file descriptor for the corresponding file. Otherwise,
1853 * we can read the file resource directly from the WIM file if we are
1854 * opening it read-only, but we need to extract the resource to the
1855 * staging directory if we are opening it writable. */
1857 if (flags_writable(fi->flags) &&
1858 (!lte || lte->resource_location != RESOURCE_IN_STAGING_FILE)) {
1859 u64 size = (lte) ? lte->size : 0;
1860 ret = extract_resource_to_staging_dir(inode, stream_id,
1867 ret = alloc_wimfs_fd(inode, stream_id, lte, &fd,
1868 wimfs_ctx_readonly(ctx));
1872 if (lte && lte->resource_location == RESOURCE_IN_STAGING_FILE) {
1875 raw_fd = open(lte->staging_file_name, fi->flags);
1877 int errno_save = errno;
1881 filedes_init(&fd->staging_fd, raw_fd);
1883 fi->fh = (uintptr_t)fd;
1887 /* Opens a directory. */
1889 wimfs_opendir(const char *path, struct fuse_file_info *fi)
1891 struct wim_inode *inode;
1893 struct wimfs_fd *fd = NULL;
1894 struct wimfs_context *ctx = wimfs_get_context();
1895 WIMStruct *wim = ctx->wim;
1897 inode = wim_pathname_to_inode(wim, path);
1900 if (!inode_is_directory(inode))
1902 ret = alloc_wimfs_fd(inode, 0, NULL, &fd, wimfs_ctx_readonly(ctx));
1903 fi->fh = (uintptr_t)fd;
1909 * Read data from a file in the WIM or in the staging directory.
1912 wimfs_read(const char *path, char *buf, size_t size,
1913 off_t offset, struct fuse_file_info *fi)
1915 struct wimfs_fd *fd = (struct wimfs_fd*)(uintptr_t)fi->fh;
1926 stream_size = fd->f_lte->size;
1930 if (offset > stream_size)
1933 size = min(size, stream_size - offset);
1937 switch (fd->f_lte->resource_location) {
1938 case RESOURCE_IN_STAGING_FILE:
1939 ret = raw_pread(&fd->staging_fd, buf, size, offset);
1943 case RESOURCE_IN_WIM:
1944 if (read_partial_wim_stream_into_buf(fd->f_lte, size,
1950 case RESOURCE_IN_ATTACHED_BUFFER:
1951 memcpy(buf, fd->f_lte->attached_buffer + offset, size);
1955 ERROR("Invalid resource location");
1962 struct fill_params {
1964 fuse_fill_dir_t filler;
1968 dentry_fuse_fill(struct wim_dentry *dentry, void *arg)
1970 struct fill_params *fill_params = arg;
1972 char *file_name_mbs;
1973 size_t file_name_mbs_nbytes;
1976 ret = utf16le_to_tstr(dentry->file_name,
1977 dentry->file_name_nbytes,
1979 &file_name_mbs_nbytes);
1983 ret = fill_params->filler(fill_params->buf, file_name_mbs, NULL, 0);
1984 FREE(file_name_mbs);
1988 /* Fills in the entries of the directory specified by @path using the
1989 * FUSE-provided function @filler. */
1991 wimfs_readdir(const char *path, void *buf, fuse_fill_dir_t filler,
1992 off_t offset, struct fuse_file_info *fi)
1994 struct wimfs_fd *fd = (struct wimfs_fd*)(uintptr_t)fi->fh;
1995 struct wim_inode *inode;
2000 inode = fd->f_inode;
2002 struct fill_params fill_params = {
2007 filler(buf, ".", NULL, 0);
2008 filler(buf, "..", NULL, 0);
2010 return for_dentry_in_rbtree(inode->i_children.rb_node,
2011 dentry_fuse_fill, &fill_params);
2016 wimfs_readlink(const char *path, char *buf, size_t buf_len)
2018 struct wimfs_context *ctx = wimfs_get_context();
2019 struct wim_inode *inode = wim_pathname_to_inode(ctx->wim, path);
2023 if (!inode_is_symlink(inode))
2026 return -ENAMETOOLONG;
2027 ret = wim_inode_readlink(inode, buf, buf_len - 1, NULL);
2029 wimlib_assert(ret <= buf_len - 1);
2032 } else if (ret == -ENAMETOOLONG) {
2033 buf[buf_len - 1] = '\0';
2040 wimfs_release(const char *path, struct fuse_file_info *fi)
2042 struct wimfs_fd *fd = (struct wimfs_fd*)(uintptr_t)fi->fh;
2043 return close_wimfs_fd(fd);
2046 /* Close a directory */
2048 wimfs_releasedir(const char *path, struct fuse_file_info *fi)
2050 struct wimfs_fd *fd = (struct wimfs_fd*)(uintptr_t)fi->fh;
2051 return close_wimfs_fd(fd);
2055 /* Remove an alternate data stream through the XATTR interface */
2057 wimfs_removexattr(const char *path, const char *name)
2059 struct wim_inode *inode;
2060 struct wim_ads_entry *ads_entry;
2062 struct wimfs_context *ctx = wimfs_get_context();
2064 if (!(ctx->mount_flags & WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_XATTR))
2067 if (strlen(name) < 5 || memcmp(name, "user.", 5) != 0)
2071 inode = wim_pathname_to_inode(ctx->wim, path);
2075 ads_entry = inode_get_ads_entry(inode, name, &ads_idx);
2078 inode_remove_ads(inode, ads_idx, ctx->wim->lookup_table);
2083 /* Renames a file or directory. See rename (3) */
2085 wimfs_rename(const char *from, const char *to)
2087 return rename_wim_path(wimfs_get_WIMStruct(), from, to);
2090 /* Remove a directory */
2092 wimfs_rmdir(const char *path)
2094 struct wim_dentry *dentry;
2095 WIMStruct *wim = wimfs_get_WIMStruct();
2097 dentry = get_dentry(wim, path);
2101 if (!dentry_is_directory(dentry))
2104 if (dentry_has_children(dentry))
2107 remove_dentry(dentry, wim->lookup_table);
2112 /* Write an alternate data stream through the XATTR interface */
2114 wimfs_setxattr(const char *path, const char *name,
2115 const char *value, size_t size, int flags)
2117 struct wim_ads_entry *existing_ads_entry;
2118 struct wim_inode *inode;
2120 struct wimfs_context *ctx = wimfs_get_context();
2123 if (!(ctx->mount_flags & WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_XATTR))
2126 if (strlen(name) <= 5 || memcmp(name, "user.", 5) != 0)
2130 inode = wim_pathname_to_inode(ctx->wim, path);
2134 existing_ads_entry = inode_get_ads_entry(inode, name, &ads_idx);
2135 if (existing_ads_entry) {
2136 if (flags & XATTR_CREATE)
2139 if (flags & XATTR_REPLACE)
2143 ret = inode_add_ads_with_data(inode, name, value,
2144 size, ctx->wim->lookup_table);
2146 if (existing_ads_entry)
2147 inode_remove_ads(inode, ads_idx, ctx->wim->lookup_table);
2156 wimfs_symlink(const char *to, const char *from)
2158 struct fuse_context *fuse_ctx = fuse_get_context();
2159 struct wimfs_context *wimfs_ctx = WIMFS_CTX(fuse_ctx);
2160 struct wim_dentry *dentry;
2163 ret = create_dentry(fuse_ctx, from, S_IFLNK | 0777,
2164 FILE_ATTRIBUTE_REPARSE_POINT, &dentry);
2166 dentry->d_inode->i_reparse_tag = WIM_IO_REPARSE_TAG_SYMLINK;
2167 ret = wim_inode_set_symlink(dentry->d_inode, to,
2168 wimfs_ctx->wim->lookup_table);
2170 remove_dentry(dentry, wimfs_ctx->wim->lookup_table);
2171 if (ret == WIMLIB_ERR_NOMEM)
2181 /* Reduce the size of a file */
2183 wimfs_truncate(const char *path, off_t size)
2185 struct wim_dentry *dentry;
2186 struct wim_lookup_table_entry *lte;
2190 struct wim_inode *inode;
2191 struct wimfs_context *ctx = wimfs_get_context();
2193 ret = wim_pathname_to_stream(ctx->wim, path, get_lookup_flags(ctx),
2194 &dentry, <e, &stream_idx);
2199 if (lte == NULL && size == 0)
2202 if (lte != NULL && lte->resource_location == RESOURCE_IN_STAGING_FILE) {
2203 ret = truncate(lte->staging_file_name, size);
2209 /* File in WIM. Extract it to the staging directory, but only
2210 * the first @size bytes of it. */
2211 struct wim_lookup_table_entry **back_ptr;
2213 inode = dentry->d_inode;
2214 if (stream_idx == 0) {
2216 back_ptr = &inode->i_lte;
2218 stream_id = inode->i_ads_entries[stream_idx - 1].stream_id;
2219 back_ptr = &inode->i_ads_entries[stream_idx - 1].lte;
2221 ret = extract_resource_to_staging_dir(inode, stream_id,
2228 /* Unlink a non-directory or alternate data stream */
2230 wimfs_unlink(const char *path)
2232 struct wim_dentry *dentry;
2233 struct wim_lookup_table_entry *lte;
2236 struct wimfs_context *ctx = wimfs_get_context();
2238 ret = wim_pathname_to_stream(ctx->wim, path, get_lookup_flags(ctx),
2239 &dentry, <e, &stream_idx);
2244 if (inode_stream_name_nbytes(dentry->d_inode, stream_idx) == 0)
2245 remove_dentry(dentry, ctx->wim->lookup_table);
2247 inode_remove_ads(dentry->d_inode, stream_idx - 1,
2248 ctx->wim->lookup_table);
2252 #ifdef HAVE_UTIMENSAT
2254 * Change the timestamp on a file dentry.
2256 * Note that alternate data streams do not have their own timestamps.
2259 wimfs_utimens(const char *path, const struct timespec tv[2])
2261 struct wim_dentry *dentry;
2262 struct wim_inode *inode;
2263 WIMStruct *wim = wimfs_get_WIMStruct();
2265 dentry = get_dentry(wim, path);
2268 inode = dentry->d_inode;
2270 if (tv[0].tv_nsec != UTIME_OMIT) {
2271 if (tv[0].tv_nsec == UTIME_NOW)
2272 inode->i_last_access_time = get_wim_timestamp();
2274 inode->i_last_access_time = timespec_to_wim_timestamp(tv[0]);
2276 if (tv[1].tv_nsec != UTIME_OMIT) {
2277 if (tv[1].tv_nsec == UTIME_NOW)
2278 inode->i_last_write_time = get_wim_timestamp();
2280 inode->i_last_write_time = timespec_to_wim_timestamp(tv[1]);
2284 #else /* HAVE_UTIMENSAT */
2286 wimfs_utime(const char *path, struct utimbuf *times)
2288 struct wim_dentry *dentry;
2289 struct wim_inode *inode;
2290 WIMStruct *wim = wimfs_get_WIMStruct();
2292 dentry = get_dentry(wim, path);
2295 inode = dentry->d_inode;
2297 inode->i_last_write_time = unix_timestamp_to_wim(times->modtime);
2298 inode->i_last_access_time = unix_timestamp_to_wim(times->actime);
2301 #endif /* !HAVE_UTIMENSAT */
2303 /* Writes to a file in the WIM filesystem.
2304 * It may be an alternate data stream, but here we don't even notice because we
2305 * just get a lookup table entry. */
2307 wimfs_write(const char *path, const char *buf, size_t size,
2308 off_t offset, struct fuse_file_info *fi)
2310 struct wimfs_fd *fd = (struct wimfs_fd*)(uintptr_t)fi->fh;
2316 wimlib_assert(fd->f_lte != NULL);
2317 wimlib_assert(fd->f_lte->staging_file_name != NULL);
2318 wimlib_assert(filedes_valid(&fd->staging_fd));
2319 wimlib_assert(fd->f_inode != NULL);
2321 /* Write the data. */
2322 ret = raw_pwrite(&fd->staging_fd, buf, size, offset);
2326 /* Update file size */
2327 if (offset + size > fd->f_lte->size) {
2328 DEBUG("Update file size %"PRIu64 " => %"PRIu64"",
2329 fd->f_lte->size, offset + size);
2330 fd->f_lte->size = offset + size;
2333 /* Update timestamps */
2334 touch_inode(fd->f_inode);
2338 static struct fuse_operations wimfs_operations = {
2339 .chmod = wimfs_chmod,
2340 .chown = wimfs_chown,
2341 .destroy = wimfs_destroy,
2342 .fgetattr = wimfs_fgetattr,
2343 .ftruncate = wimfs_ftruncate,
2344 .getattr = wimfs_getattr,
2346 .getxattr = wimfs_getxattr,
2350 .listxattr = wimfs_listxattr,
2352 .mkdir = wimfs_mkdir,
2353 .mknod = wimfs_mknod,
2355 .opendir = wimfs_opendir,
2357 .readdir = wimfs_readdir,
2358 .readlink = wimfs_readlink,
2359 .release = wimfs_release,
2360 .releasedir = wimfs_releasedir,
2362 .removexattr = wimfs_removexattr,
2364 .rename = wimfs_rename,
2365 .rmdir = wimfs_rmdir,
2367 .setxattr = wimfs_setxattr,
2369 .symlink = wimfs_symlink,
2370 .truncate = wimfs_truncate,
2371 .unlink = wimfs_unlink,
2372 #ifdef HAVE_UTIMENSAT
2373 .utimens = wimfs_utimens,
2375 .utime = wimfs_utime,
2377 .write = wimfs_write,
2379 /* wimfs keeps file descriptor structures (struct wimfs_fd), so there is
2380 * no need to have the file path provided on operations such as read()
2381 * where only the file descriptor is needed. */
2382 #if FUSE_MAJOR_VERSION > 2 || (FUSE_MAJOR_VERSION == 2 && FUSE_MINOR_VERSION >= 8)
2383 .flag_nullpath_ok = 1,
2385 #if FUSE_MAJOR_VERSION > 2 || (FUSE_MAJOR_VERSION == 2 && FUSE_MINOR_VERSION >= 9)
2387 .flag_utime_omit_ok = 1,
2392 /* API function documented in wimlib.h */
2394 wimlib_mount_image(WIMStruct *wim, int image, const char *dir,
2395 int mount_flags, const char *staging_dir)
2401 struct wim_image_metadata *imd;
2402 struct wimfs_context ctx;
2403 struct wim_inode *inode;
2405 DEBUG("Mount: wim = %p, image = %d, dir = %s, flags = %d, ",
2406 wim, image, dir, mount_flags);
2409 return WIMLIB_ERR_INVALID_PARAM;
2411 if (mount_flags & WIMLIB_MOUNT_FLAG_READWRITE) {
2412 ret = can_delete_from_wim(wim);
2417 ret = select_wim_image(wim, image);
2421 DEBUG("Selected image %d", image);
2423 imd = wim_get_current_image_metadata(wim);
2425 if (imd->refcnt != 1) {
2426 ERROR("Cannot mount image that was just exported with "
2427 "wimlib_export_image()");
2428 return WIMLIB_ERR_INVALID_PARAM;
2431 if (imd->modified) {
2432 ERROR("Cannot mount image that was added "
2433 "with wimlib_add_image()");
2434 return WIMLIB_ERR_INVALID_PARAM;
2437 if (mount_flags & WIMLIB_MOUNT_FLAG_READWRITE) {
2438 ret = lock_wim(wim, wim->in_fd.fd);
2443 /* Use default stream interface if one was not specified */
2444 if (!(mount_flags & (WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_NONE |
2445 WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_XATTR |
2446 WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_WINDOWS)))
2447 mount_flags |= WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_XATTR;
2449 DEBUG("Initializing struct wimfs_context");
2450 init_wimfs_context(&ctx);
2452 ctx.mount_flags = mount_flags;
2453 ctx.image_inode_list = &imd->inode_list;
2454 ctx.default_uid = getuid();
2455 ctx.default_gid = getgid();
2456 wimlib_assert(list_empty(&imd->unhashed_streams));
2457 ctx.wim->lookup_table->unhashed_streams = &imd->unhashed_streams;
2458 if (mount_flags & WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_WINDOWS)
2459 ctx.default_lookup_flags = LOOKUP_FLAG_ADS_OK;
2461 DEBUG("Unlinking message queues in case they already exist");
2462 ret = set_message_queue_names(&ctx, dir);
2465 unlink_message_queues(&ctx);
2467 DEBUG("Preparing arguments to fuse_main()");
2469 dir_copy = STRDUP(dir);
2471 goto out_free_message_queue_names;
2474 argv[argc++] = "wimlib";
2475 argv[argc++] = dir_copy;
2477 /* disable multi-threaded operation */
2478 argv[argc++] = "-s";
2480 if (mount_flags & WIMLIB_MOUNT_FLAG_DEBUG)
2481 argv[argc++] = "-d";
2484 * We provide the use_ino option to the FUSE mount because we are going
2485 * to assign inode numbers ourselves. */
2486 char optstring[256] =
2490 #if FUSE_MAJOR_VERSION > 2 || (FUSE_MAJOR_VERSION == 2 && FUSE_MINOR_VERSION >= 8)
2493 ",default_permissions"
2495 argv[argc++] = "-o";
2496 argv[argc++] = optstring;
2497 if ((mount_flags & WIMLIB_MOUNT_FLAG_READWRITE)) {
2498 /* Read-write mount. Make the staging directory */
2499 ret = make_staging_dir(&ctx, staging_dir);
2501 goto out_free_dir_copy;
2503 /* Read-only mount */
2504 strcat(optstring, ",ro");
2506 if (mount_flags & WIMLIB_MOUNT_FLAG_ALLOW_OTHER)
2507 strcat(optstring, ",allow_other");
2513 DEBUG("FUSE command line (argc = %d): ", argc);
2514 for (i = 0; i < argc; i++) {
2515 fputs(argv[i], stdout);
2523 /* Mark dentry tree as modified if read-write mount. */
2524 if (mount_flags & WIMLIB_MOUNT_FLAG_READWRITE)
2527 /* Resolve the lookup table entries for every inode in the image, and
2528 * assign inode numbers */
2529 DEBUG("Resolving lookup table entries and assigning inode numbers");
2531 image_for_each_inode(inode, imd)
2532 inode->i_ino = ctx.next_ino++;
2533 DEBUG("(next_ino = %"PRIu64")", ctx.next_ino);
2535 DEBUG("Calling fuse_main()");
2537 ret = fuse_main(argc, argv, &wimfs_operations, &ctx);
2539 DEBUG("Returned from fuse_main() (ret = %d)", ret);
2542 ret = WIMLIB_ERR_FUSE;
2544 if (ctx.have_status)
2547 ret = WIMLIB_ERR_TIMEOUT;
2549 if (ctx.daemon_to_unmount_mq != (mqd_t)(-1)) {
2550 send_unmount_finished_msg(ctx.daemon_to_unmount_mq, ret);
2551 close_message_queues(&ctx);
2554 /* Try to delete the staging directory if a deletion wasn't yet
2555 * attempted due to an earlier error */
2556 if (ctx.staging_dir_name)
2557 delete_staging_dir(&ctx);
2561 wim->wim_locked = 0;
2562 out_free_message_queue_names:
2563 free_message_queue_names(&ctx);
2567 /* API function documented in wimlib.h */
2569 wimlib_unmount_image(const char *dir, int unmount_flags,
2570 wimlib_progress_func_t progress_func)
2573 struct wimfs_context wimfs_ctx;
2575 init_wimfs_context(&wimfs_ctx);
2577 ret = set_message_queue_names(&wimfs_ctx, dir);
2581 ret = open_message_queues(&wimfs_ctx, false);
2583 goto out_free_message_queue_names;
2585 ret = send_unmount_request_msg(wimfs_ctx.unmount_to_daemon_mq,
2587 progress_func != NULL);
2589 goto out_close_message_queues;
2591 ret = execute_fusermount(dir, (unmount_flags & WIMLIB_UNMOUNT_FLAG_LAZY) != 0);
2593 goto out_close_message_queues;
2595 struct unmount_msg_handler_context handler_ctx = {
2597 .timeout_seconds = 5,
2600 .progress_func = progress_func,
2603 ret = message_loop(wimfs_ctx.daemon_to_unmount_mq,
2604 &unmount_msg_handler_callbacks,
2607 ret = handler_ctx.status;
2608 out_close_message_queues:
2609 close_message_queues(&wimfs_ctx);
2610 out_free_message_queue_names:
2611 free_message_queue_names(&wimfs_ctx);
2616 #else /* WITH_FUSE */
2620 mount_unsupported_error(void)
2622 #if defined(__WIN32__)
2623 ERROR("Sorry-- Mounting WIM images is not supported on Windows!");
2625 ERROR("wimlib was compiled with --without-fuse, which disables support "
2626 "for mounting WIMs.");
2628 return WIMLIB_ERR_UNSUPPORTED;
2632 wimlib_unmount_image(const tchar *dir, int unmount_flags,
2633 wimlib_progress_func_t progress_func)
2635 return mount_unsupported_error();
2639 wimlib_mount_image(WIMStruct *wim, int image, const tchar *dir,
2640 int mount_flags, const tchar *staging_dir)
2642 return mount_unsupported_error();
2645 #endif /* !WITH_FUSE */