]> wimlib.net Git - wimlib/blobdiff - src/dentry.c
Refactor some of the dentry, inode, and lookup table code
[wimlib] / src / dentry.c
index a73828ba41c1ada58c7b9528d48033214b6c477c..62b35cf86da52ff91b2df0a0cf57c4039374b3ac 100644 (file)
 #endif
 
 #include "wimlib.h"
+#include "wimlib/case.h"
 #include "wimlib/dentry.h"
 #include "wimlib/encoding.h"
 #include "wimlib/endianness.h"
 #include "wimlib/error.h"
 #include "wimlib/lookup_table.h"
 #include "wimlib/metadata.h"
+#include "wimlib/paths.h"
 #include "wimlib/resource.h"
 #include "wimlib/security.h"
 #include "wimlib/sha1.h"
 
 #include <errno.h>
 
-/* WIM alternate data stream entry (on-disk format) */
-struct wim_ads_entry_on_disk {
-       /*  Length of the entry, in bytes.  This apparently includes all
-        *  fixed-length fields, plus the stream name and null terminator if
-        *  present, and the padding up to an 8 byte boundary.  wimlib is a
-        *  little less strict when reading the entries, and only requires that
-        *  the number of bytes from this field is at least as large as the size
-        *  of the fixed length fields and stream name without null terminator.
-        *  */
-       le64  length;
-
-       le64  reserved;
-
-       /* SHA1 message digest of the uncompressed stream; or, alternatively,
-        * can be all zeroes if the stream has zero length. */
-       u8 hash[SHA1_HASH_SIZE];
-
-       /* Length of the stream name, in bytes.  0 if the stream is unnamed.  */
-       le16 stream_name_nbytes;
-
-       /* Stream name in UTF-16LE.  It is @stream_name_nbytes bytes long,
-        * excluding the the null terminator.  There is a null terminator
-        * character if @stream_name_nbytes != 0; i.e., if this stream is named.
-        * */
-       utf16lechar stream_name[];
-} _packed_attribute;
-
-#define WIM_ADS_ENTRY_DISK_SIZE 38
-
 /* On-disk format of a WIM dentry (directory entry), located in the metadata
  * resource for a WIM image.  */
 struct wim_dentry_on_disk {
@@ -141,7 +114,9 @@ struct wim_dentry_on_disk {
         * As a further special case, if this field is all zeroes but there is
         * an alternate data stream entry with no name and a nonzero SHA-1
         * message digest field, then that hash must be used instead of this
-        * one.  (wimlib does not use this quirk on WIM images it creates.)
+        * one.  In fact, when named data streams are present, some versions of
+        * Windows PE contain a bug where they only look in the alternate data
+        * stream entries for the unnamed data stream, not here.
         */
        u8 unnamed_stream_hash[SHA1_HASH_SIZE];
 
@@ -211,13 +186,11 @@ struct wim_dentry_on_disk {
        /*utf16lechar short_name[];*/
 } _packed_attribute;
 
-#define WIM_DENTRY_DISK_SIZE 102
-
 /* Calculates the unaligned length, in bytes, of an on-disk WIM dentry that has
  * a file name and short name that take the specified numbers of bytes.  This
  * excludes any alternate data stream entries that may follow the dentry. */
 static u64
-_dentry_correct_length_unaligned(u16 file_name_nbytes, u16 short_name_nbytes)
+dentry_correct_length_unaligned(u16 file_name_nbytes, u16 short_name_nbytes)
 {
        u64 length = sizeof(struct wim_dentry_on_disk);
        if (file_name_nbytes)
@@ -232,56 +205,24 @@ _dentry_correct_length_unaligned(u16 file_name_nbytes, u16 short_name_nbytes)
  * ignored; also, this excludes any alternate data stream entries that may
  * follow the dentry. */
 static u64
-dentry_correct_length_unaligned(const struct wim_dentry *dentry)
+dentry_correct_length_aligned(const struct wim_dentry *dentry)
 {
-       return _dentry_correct_length_unaligned(dentry->file_name_nbytes,
-                                               dentry->short_name_nbytes);
-}
+       u64 len;
 
-/* Duplicates a string of system-dependent encoding into a UTF-16LE string and
- * returns the string and its length, in bytes, in the pointer arguments.  Frees
- * any existing string at the return location before overwriting it. */
-static int
-get_utf16le_name(const tchar *name, utf16lechar **name_utf16le_ret,
-                u16 *name_utf16le_nbytes_ret)
-{
-       utf16lechar *name_utf16le;
-       size_t name_utf16le_nbytes;
-       int ret;
-#if TCHAR_IS_UTF16LE
-       name_utf16le_nbytes = tstrlen(name) * sizeof(utf16lechar);
-       name_utf16le = MALLOC(name_utf16le_nbytes + sizeof(utf16lechar));
-       if (!name_utf16le)
-               return WIMLIB_ERR_NOMEM;
-       memcpy(name_utf16le, name, name_utf16le_nbytes + sizeof(utf16lechar));
-       ret = 0;
-#else
-
-       ret = tstr_to_utf16le(name, tstrlen(name), &name_utf16le,
-                             &name_utf16le_nbytes);
-       if (ret == 0) {
-               if (name_utf16le_nbytes > 0xffff) {
-                       FREE(name_utf16le);
-                       ERROR("Multibyte string \"%"TS"\" is too long!", name);
-                       ret = WIMLIB_ERR_INVALID_UTF8_STRING;
-               }
-       }
-#endif
-       if (ret == 0) {
-               FREE(*name_utf16le_ret);
-               *name_utf16le_ret = name_utf16le;
-               *name_utf16le_nbytes_ret = name_utf16le_nbytes;
-       }
-       return ret;
+       len = dentry_correct_length_unaligned(dentry->file_name_nbytes,
+                                             dentry->short_name_nbytes);
+       return (len + 7) & ~7;
 }
 
-/* Sets the name of a WIM dentry from a multibyte string. */
+/* Sets the name of a WIM dentry from a multibyte string.
+ * Only use this on dentries not inserted into the tree.  Use rename_wim_path()
+ * to do a real rename.  */
 int
-set_dentry_name(struct wim_dentry *dentry, const tchar *new_name)
+dentry_set_name(struct wim_dentry *dentry, const tchar *new_name)
 {
        int ret;
-       ret = get_utf16le_name(new_name, &dentry->file_name,
-                              &dentry->file_name_nbytes);
+       ret = get_utf16le_string(new_name, &dentry->file_name,
+                                &dentry->file_name_nbytes);
        if (ret == 0) {
                /* Clear the short name and recalculate the dentry length */
                if (dentry_has_short_name(dentry)) {
@@ -305,31 +246,59 @@ ads_entry_total_length(const struct wim_ads_entry *entry)
        return (len + 7) & ~7;
 }
 
+/*
+ * Determine whether to include a "dummy" stream when writing a WIM dentry:
+ *
+ * Some versions of Microsoft's WIM software (the boot driver(s) in WinPE 3.0,
+ * for example) contain a bug where they assume the first alternate data stream
+ * (ADS) entry of a dentry with a nonzero ADS count specifies the unnamed
+ * stream, even if it has a name and the unnamed stream is already specified in
+ * the hash field of the dentry itself.
+ *
+ * wimlib has to work around this behavior by carefully emulating the behavior
+ * of (most versions of) ImageX/WIMGAPI, which move the unnamed stream reference
+ * into the alternate stream entries whenever there are named data streams, even
+ * though there is already a field in the dentry itself for the unnamed stream
+ * reference, which then goes to waste.
+ */
+static inline bool
+inode_needs_dummy_stream(const struct wim_inode *inode)
+{
+       return (inode->i_num_ads > 0 &&
+               inode->i_num_ads < 0xffff && /* overflow check */
+               inode->i_canonical_streams); /* assume the dentry is okay if it
+                                               already had an unnamed ADS entry
+                                               when it was read in  */
+}
 
-static u64
-_dentry_total_length(const struct wim_dentry *dentry, u64 length)
+/* Calculate the total number of bytes that will be consumed when a WIM dentry
+ * is written.  This includes base dentry and name fields as well as all
+ * alternate data stream entries and alignment bytes.  */
+u64
+dentry_out_total_length(const struct wim_dentry *dentry)
 {
+       u64 length = dentry_correct_length_aligned(dentry);
        const struct wim_inode *inode = dentry->d_inode;
+
+       if (inode_needs_dummy_stream(inode))
+               length += ads_entry_total_length(&(struct wim_ads_entry){});
+
        for (u16 i = 0; i < inode->i_num_ads; i++)
                length += ads_entry_total_length(&inode->i_ads_entries[i]);
-       return (length + 7) & ~7;
-}
 
-/* Calculate the aligned *total* length of an on-disk WIM dentry.  This includes
- * all alternate data streams. */
-u64
-dentry_correct_total_length(const struct wim_dentry *dentry)
-{
-       return _dentry_total_length(dentry,
-                                   dentry_correct_length_unaligned(dentry));
+       return length;
 }
 
-/* Like dentry_correct_total_length(), but use the existing dentry->length field
- * instead of calculating its "correct" value. */
+/* Calculate the aligned, total length of a dentry, including all alternate data
+ * stream entries.  Uses dentry->length.  */
 static u64
-dentry_total_length(const struct wim_dentry *dentry)
+dentry_in_total_length(const struct wim_dentry *dentry)
 {
-       return _dentry_total_length(dentry, dentry->length);
+       u64 length = dentry->length;
+       const struct wim_inode *inode = dentry->d_inode;
+       for (u16 i = 0; i < inode->i_num_ads; i++)
+               length += ads_entry_total_length(&inode->i_ads_entries[i]);
+       return (length + 7) & ~7;
 }
 
 int
@@ -403,6 +372,24 @@ for_dentry_tree_in_rbtree(struct rb_node *node,
        return 0;
 }
 
+/*
+ * Iterate over all children of @dentry, calling the function @visitor, passing
+ * it a child dentry and the extra argument @arg.
+ *
+ * Note: this function iterates over ALL child dentries, even those with the
+ * same case-insensitive name.
+ *
+ * Note: this function clobbers the tmp_list field of the child dentries.  */
+int
+for_dentry_child(const struct wim_dentry *dentry,
+                int (*visitor)(struct wim_dentry *, void *),
+                void *arg)
+{
+       return for_dentry_in_rbtree(dentry->d_inode->i_children.rb_node,
+                                   visitor,
+                                   arg);
+}
+
 /* Calls a function on all directory entries in a WIM dentry tree.  Logically,
  * this is a pre-order traversal (the function is called on a parent dentry
  * before its children), but sibling dentries will be visited in order as well.
@@ -413,7 +400,7 @@ for_dentry_in_tree(struct wim_dentry *root,
 {
        int ret;
 
-       if (!root)
+       if (root == NULL)
                return 0;
        ret = (*visitor)(root, arg);
        if (ret)
@@ -431,7 +418,7 @@ for_dentry_in_tree_depth(struct wim_dentry *root,
 {
        int ret;
 
-       if (!root)
+       if (root == NULL)
                return 0;
        ret = for_dentry_tree_in_rbtree_depth(root->d_inode->i_children.rb_node,
                                              visitor, arg);
@@ -455,7 +442,7 @@ calculate_dentry_full_path(struct wim_dentry *dentry)
        if (dentry_is_root(dentry)) {
                static const tchar _root_path[] = {WIM_PATH_SEPARATOR, T('\0')};
                full_path = TSTRDUP(_root_path);
-               if (!full_path)
+               if (full_path == NULL)
                        return WIMLIB_ERR_NOMEM;
                full_path_nbytes = 1 * sizeof(tchar);
        } else {
@@ -469,7 +456,7 @@ calculate_dentry_full_path(struct wim_dentry *dentry)
                        parent_full_path = T("");
                        parent_full_path_nbytes = 0;
                } else {
-                       if (!parent->_full_path) {
+                       if (parent->_full_path == NULL) {
                                ret = calculate_dentry_full_path(parent);
                                if (ret)
                                        return ret;
@@ -495,7 +482,7 @@ calculate_dentry_full_path(struct wim_dentry *dentry)
                full_path_nbytes = parent_full_path_nbytes + sizeof(tchar) +
                                   filename_nbytes;
                full_path = MALLOC(full_path_nbytes + sizeof(tchar));
-               if (!full_path)
+               if (full_path == NULL)
                        return WIMLIB_ERR_NOMEM;
                memcpy(full_path, parent_full_path, parent_full_path_nbytes);
                full_path[parent_full_path_nbytes / sizeof(tchar)] = WIM_PATH_SEPARATOR;
@@ -537,7 +524,7 @@ dentry_full_path(struct wim_dentry *dentry)
 static int
 increment_subdir_offset(struct wim_dentry *dentry, void *subdir_offset_p)
 {
-       *(u64*)subdir_offset_p += dentry_correct_total_length(dentry);
+       *(u64*)subdir_offset_p += dentry_out_total_length(dentry);
        return 0;
 }
 
@@ -584,98 +571,38 @@ calculate_subdir_offsets(struct wim_dentry *dentry, u64 *subdir_offset_p)
        }
 }
 
-/* Case-sensitive UTF-16LE dentry or stream name comparison.  Used on both UNIX
- * (always) and Windows (sometimes) */
-static int
-compare_utf16le_names_case_sensitive(const utf16lechar *name1, size_t nbytes1,
-                                    const utf16lechar *name2, size_t nbytes2)
-{
-       /* Return the result if the strings differ up to their minimum length.
-        * Note that we cannot use strcmp() or strncmp() here, as the strings
-        * are in UTF-16LE format. */
-       int result = memcmp(name1, name2, min(nbytes1, nbytes2));
-       if (result)
-               return result;
-
-       /* The strings are the same up to their minimum length, so return a
-        * result based on their lengths. */
-       if (nbytes1 < nbytes2)
-               return -1;
-       else if (nbytes1 > nbytes2)
-               return 1;
-       else
-               return 0;
-}
-
-#ifdef __WIN32__
-/* Windoze: Case-insensitive UTF-16LE dentry or stream name comparison */
-static int
-compare_utf16le_names_case_insensitive(const utf16lechar *name1, size_t nbytes1,
-                                      const utf16lechar *name2, size_t nbytes2)
-{
-       /* Return the result if the strings differ up to their minimum length.
-        * */
-       int result = _wcsnicmp((const wchar_t*)name1, (const wchar_t*)name2,
-                              min(nbytes1 / 2, nbytes2 / 2));
-       if (result)
-               return result;
-
-       /* The strings are the same up to their minimum length, so return a
-        * result based on their lengths. */
-       if (nbytes1 < nbytes2)
-               return -1;
-       else if (nbytes1 > nbytes2)
-               return 1;
-       else
-               return 0;
-}
-#endif /* __WIN32__ */
-
-#ifdef __WIN32__
-#  define compare_utf16le_names compare_utf16le_names_case_insensitive
-#else
-#  define compare_utf16le_names compare_utf16le_names_case_sensitive
-#endif
-
-
-#ifdef __WIN32__
 static int
 dentry_compare_names_case_insensitive(const struct wim_dentry *d1,
                                      const struct wim_dentry *d2)
 {
-       return compare_utf16le_names_case_insensitive(d1->file_name,
-                                                     d1->file_name_nbytes,
-                                                     d2->file_name,
-                                                     d2->file_name_nbytes);
+       return cmp_utf16le_strings(d1->file_name,
+                                  d1->file_name_nbytes / 2,
+                                  d2->file_name,
+                                  d2->file_name_nbytes / 2,
+                                  true);
 }
-#endif /* __WIN32__ */
 
 static int
 dentry_compare_names_case_sensitive(const struct wim_dentry *d1,
                                    const struct wim_dentry *d2)
 {
-       return compare_utf16le_names_case_sensitive(d1->file_name,
-                                                   d1->file_name_nbytes,
-                                                   d2->file_name,
-                                                   d2->file_name_nbytes);
+       return cmp_utf16le_strings(d1->file_name,
+                                  d1->file_name_nbytes / 2,
+                                  d2->file_name,
+                                  d2->file_name_nbytes / 2,
+                                  false);
 }
 
+/* Default case sensitivity behavior for searches with
+ * WIMLIB_CASE_PLATFORM_DEFAULT specified.  This can be modified by
+ * wimlib_global_init().  */
+bool default_ignore_case =
 #ifdef __WIN32__
-#  define dentry_compare_names dentry_compare_names_case_insensitive
+       true
 #else
-#  define dentry_compare_names dentry_compare_names_case_sensitive
+       false
 #endif
-
-/* Return %true iff the alternate data stream entry @entry has the UTF-16LE
- * stream name @name that has length @name_nbytes bytes. */
-static inline bool
-ads_entry_has_name(const struct wim_ads_entry *entry,
-                  const utf16lechar *name, size_t name_nbytes)
-{
-       return !compare_utf16le_names(name, name_nbytes,
-                                     entry->stream_name,
-                                     entry->stream_name_nbytes);
-}
+;
 
 /* Given a UTF-16LE filename and a directory, look up the dentry for the file.
  * Return it if found, otherwise NULL.  This is case-sensitive on UNIX and
@@ -683,42 +610,67 @@ ads_entry_has_name(const struct wim_ads_entry *entry,
 struct wim_dentry *
 get_dentry_child_with_utf16le_name(const struct wim_dentry *dentry,
                                   const utf16lechar *name,
-                                  size_t name_nbytes)
+                                  size_t name_nbytes,
+                                  CASE_SENSITIVITY_TYPE case_ctype)
 {
        struct rb_node *node;
 
-#ifdef __WIN32__
-       node = dentry->d_inode->i_children_case_insensitive.rb_node;
-#else
-       node = dentry->d_inode->i_children.rb_node;
-#endif
+       bool ignore_case = will_ignore_case(case_ctype);
+
+       if (ignore_case)
+               node = dentry->d_inode->i_children_case_insensitive.rb_node;
+       else
+               node = dentry->d_inode->i_children.rb_node;
 
        struct wim_dentry *child;
        while (node) {
-       #ifdef __WIN32__
-               child = rb_entry(node, struct wim_dentry, rb_node_case_insensitive);
-       #else
-               child = rbnode_dentry(node);
-       #endif
-               int result = compare_utf16le_names(name, name_nbytes,
-                                                  child->file_name,
-                                                  child->file_name_nbytes);
-               if (result < 0)
+               if (ignore_case)
+                       child = rb_entry(node, struct wim_dentry, rb_node_case_insensitive);
+               else
+                       child = rb_entry(node, struct wim_dentry, rb_node);
+
+               int result = cmp_utf16le_strings(name,
+                                                name_nbytes / 2,
+                                                child->file_name,
+                                                child->file_name_nbytes / 2,
+                                                ignore_case);
+               if (result < 0) {
                        node = node->rb_left;
-               else if (result > 0)
+               } else if (result > 0) {
                        node = node->rb_right;
-               else {
-               #ifdef __WIN32__
-                       if (!list_empty(&child->case_insensitive_conflict_list))
-                       {
-                               WARNING("Result of case-insensitive lookup is ambiguous "
-                                       "(returning \"%ls\" instead of \"%ls\")",
-                                       child->file_name,
-                                       container_of(child->case_insensitive_conflict_list.next,
-                                                    struct wim_dentry,
-                                                    case_insensitive_conflict_list)->file_name);
-                       }
-               #endif
+               } else if (!ignore_case ||
+                       list_empty(&child->case_insensitive_conflict_list)) {
+                       return child;
+               } else {
+                       /* Multiple dentries have the same case-insensitive
+                        * name, and a case-insensitive lookup is being
+                        * performed.  Choose the dentry with the same
+                        * case-sensitive name, if one exists; otherwise print a
+                        * warning and choose one arbitrarily.  */
+                       struct wim_dentry *alt = child;
+                       size_t num_alts = 0;
+
+                       do {
+                               num_alts++;
+                               if (0 == cmp_utf16le_strings(name,
+                                                            name_nbytes / 2,
+                                                            alt->file_name,
+                                                            alt->file_name_nbytes / 2,
+                                                            false))
+                                       return alt;
+                               alt = list_entry(alt->case_insensitive_conflict_list.next,
+                                                struct wim_dentry,
+                                                case_insensitive_conflict_list);
+                       } while (alt != child);
+
+                       WARNING("Result of case-insensitive lookup is ambiguous\n"
+                               "          (returning \"%"TS"\" of %zu "
+                               "possible files, including \"%"TS"\")",
+                               dentry_full_path(child),
+                               num_alts,
+                               dentry_full_path(list_entry(child->case_insensitive_conflict_list.next,
+                                                           struct wim_dentry,
+                                                           case_insensitive_conflict_list)));
                        return child;
                }
        }
@@ -728,11 +680,13 @@ get_dentry_child_with_utf16le_name(const struct wim_dentry *dentry,
 /* Returns the child of @dentry that has the file name @name.  Returns NULL if
  * no child has the name. */
 struct wim_dentry *
-get_dentry_child_with_name(const struct wim_dentry *dentry, const tchar *name)
+get_dentry_child_with_name(const struct wim_dentry *dentry, const tchar *name,
+                          CASE_SENSITIVITY_TYPE case_type)
 {
 #if TCHAR_IS_UTF16LE
        return get_dentry_child_with_utf16le_name(dentry, name,
-                                                 tstrlen(name) * sizeof(tchar));
+                                                 tstrlen(name) * sizeof(tchar),
+                                                 case_type);
 #else
        utf16lechar *utf16le_name;
        size_t utf16le_name_nbytes;
@@ -746,7 +700,8 @@ get_dentry_child_with_name(const struct wim_dentry *dentry, const tchar *name)
        } else {
                child = get_dentry_child_with_utf16le_name(dentry,
                                                           utf16le_name,
-                                                          utf16le_name_nbytes);
+                                                          utf16le_name_nbytes,
+                                                          case_type);
                FREE(utf16le_name);
        }
        return child;
@@ -754,54 +709,111 @@ get_dentry_child_with_name(const struct wim_dentry *dentry, const tchar *name)
 }
 
 static struct wim_dentry *
-get_dentry_utf16le(WIMStruct *wim, const utf16lechar *path)
+get_dentry_utf16le(WIMStruct *wim, const utf16lechar *path,
+                  CASE_SENSITIVITY_TYPE case_type)
 {
-       struct wim_dentry *cur_dentry, *parent_dentry;
-       const utf16lechar *p, *pp;
+       struct wim_dentry *cur_dentry;
+       const utf16lechar *name_start, *name_end;
 
-       cur_dentry = parent_dentry = wim_root_dentry(wim);
-       if (!cur_dentry) {
-               errno = ENOENT;
-               return NULL;
-       }
-       p = path;
-       while (1) {
-               while (*p == cpu_to_le16(WIM_PATH_SEPARATOR))
-                       p++;
-               if (*p == cpu_to_le16('\0'))
-                       break;
-               pp = p;
-               while (*pp != cpu_to_le16(WIM_PATH_SEPARATOR) &&
-                      *pp != cpu_to_le16('\0'))
-                       pp++;
-
-               cur_dentry = get_dentry_child_with_utf16le_name(parent_dentry, p,
-                                                               (void*)pp - (void*)p);
-               if (cur_dentry == NULL)
-                       break;
-               p = pp;
-               parent_dentry = cur_dentry;
-       }
-       if (cur_dentry == NULL) {
-               if (dentry_is_directory(parent_dentry))
+       /* Start with the root directory of the image.  Note: this will be NULL
+        * if an image has been added directly with wimlib_add_empty_image() but
+        * no files have been added yet; in that case we fail with ENOENT.  */
+       cur_dentry = wim_root_dentry(wim);
+
+       name_start = path;
+       for (;;) {
+               if (cur_dentry == NULL) {
                        errno = ENOENT;
-               else
+                       return NULL;
+               }
+
+               if (*name_start && !dentry_is_directory(cur_dentry)) {
                        errno = ENOTDIR;
+                       return NULL;
+               }
+
+               while (*name_start == cpu_to_le16(WIM_PATH_SEPARATOR))
+                       name_start++;
+
+               if (!*name_start)
+                       return cur_dentry;
+
+               name_end = name_start;
+               do {
+                       ++name_end;
+               } while (*name_end != cpu_to_le16(WIM_PATH_SEPARATOR) && *name_end);
+
+               cur_dentry = get_dentry_child_with_utf16le_name(cur_dentry,
+                                                               name_start,
+                                                               (u8*)name_end - (u8*)name_start,
+                                                               case_type);
+               name_start = name_end;
        }
-       return cur_dentry;
 }
 
 /*
- * Returns the dentry in the currently selected WIM image named by @path
- * starting from the root of the WIM image, or NULL if there is no such dentry.
+ * WIM path lookup: translate a path in the currently selected WIM image to the
+ * corresponding dentry, if it exists.
+ *
+ * @wim
+ *     The WIMStruct for the WIM.  The search takes place in the currently
+ *     selected image.
+ *
+ * @path
+ *     The path to look up, given relative to the root of the WIM image.
+ *     Characters with value WIM_PATH_SEPARATOR are taken to be path
+ *     separators.  Leading path separators are ignored, whereas one or more
+ *     trailing path separators cause the path to only match a directory.
+ *
+ * @case_type
+ *     The case-sensitivity behavior of this function, as one of the following
+ *     constants:
+ *
+ *    - WIMLIB_CASE_SENSITIVE:  Perform the search case sensitively.  This means
+ *     that names must match exactly.
+ *
+ *    - WIMLIB_CASE_INSENSITIVE:  Perform the search case insensitively.  This
+ *     means that names are considered to match if they are equal when
+ *     transformed to upper case.  If a path component matches multiple names
+ *     case-insensitively, the name that matches the path component
+ *     case-sensitively is chosen, if existent; otherwise one
+ *     case-insensitively matching name is chosen arbitrarily.
+ *
+ *    - WIMLIB_CASE_PLATFORM_DEFAULT:  Perform either case-sensitive or
+ *     case-insensitive search, depending on the value of the global variable
+ *     default_ignore_case.
+ *
+ *    In any case, no Unicode normalization is done before comparing strings.
+ *
+ * Returns a pointer to the dentry that is the result of the lookup, or NULL if
+ * no such dentry exists.  If NULL is returned, errno is set to one of the
+ * following values:
+ *
+ *     ENOTDIR if one of the path components used as a directory existed but
+ *     was not, in fact, a directory.
+ *
+ *     ENOENT otherwise.
+ *
+ * Additional notes:
+ *
+ *    - This function does not consider a reparse point to be a directory, even
+ *     if it has FILE_ATTRIBUTE_DIRECTORY set.
+ *
+ *    - This function does not dereference symbolic links or junction points
+ *     when performing the search.
+ *
+ *    - Since this function ignores leading slashes, the empty path is valid and
+ *     names the root directory of the WIM image.
  *
- * On Windows, the search is done case-insensitively.
+ *    - An image added with wimlib_add_empty_image() does not have a root
+ *     directory yet, and this function will fail with ENOENT for any path on
+ *     such an image.
  */
 struct wim_dentry *
-get_dentry(WIMStruct *wim, const tchar *path)
+get_dentry(WIMStruct *wim, const tchar *path, CASE_SENSITIVITY_TYPE case_type)
 {
 #if TCHAR_IS_UTF16LE
-       return get_dentry_utf16le(wim, path);
+       return get_dentry_utf16le(wim, path, case_type);
 #else
        utf16lechar *path_utf16le;
        size_t path_utf16le_nbytes;
@@ -812,23 +824,12 @@ get_dentry(WIMStruct *wim, const tchar *path)
                              &path_utf16le, &path_utf16le_nbytes);
        if (ret)
                return NULL;
-       dentry = get_dentry_utf16le(wim, path_utf16le);
+       dentry = get_dentry_utf16le(wim, path_utf16le, case_type);
        FREE(path_utf16le);
        return dentry;
 #endif
 }
 
-struct wim_inode *
-wim_pathname_to_inode(WIMStruct *wim, const tchar *path)
-{
-       struct wim_dentry *dentry;
-       dentry = get_dentry(wim, path);
-       if (dentry)
-               return dentry->d_inode;
-       else
-               return NULL;
-}
-
 /* Takes in a path of length @len in @buf, and transforms it into a string for
  * the path of its parent directory. */
 static void
@@ -844,18 +845,91 @@ to_parent_name(tchar *buf, size_t len)
        buf[i + 1] = T('\0');
 }
 
-/* Returns the dentry that corresponds to the parent directory of @path, or NULL
- * if the dentry is not found. */
+/* Similar to get_dentry(), but returns the dentry named by @path with the last
+ * component stripped off.
+ *
+ * Note: The returned dentry is NOT guaranteed to be a directory.  */
 struct wim_dentry *
-get_parent_dentry(WIMStruct *wim, const tchar *path)
+get_parent_dentry(WIMStruct *wim, const tchar *path,
+                 CASE_SENSITIVITY_TYPE case_type)
 {
        size_t path_len = tstrlen(path);
        tchar buf[path_len + 1];
 
        tmemcpy(buf, path, path_len + 1);
        to_parent_name(buf, path_len);
-       return get_dentry(wim, buf);
+       return get_dentry(wim, buf, case_type);
+}
+
+#ifdef WITH_FUSE
+/* Finds the dentry, lookup table entry, and stream index for a WIM file stream,
+ * given a path name.
+ *
+ * Currently, lookups of this type are only needed if FUSE is enabled.  */
+int
+wim_pathname_to_stream(WIMStruct *wim,
+                      const tchar *path,
+                      int lookup_flags,
+                      struct wim_dentry **dentry_ret,
+                      struct wim_lookup_table_entry **lte_ret,
+                      u16 *stream_idx_ret)
+{
+       struct wim_dentry *dentry;
+       struct wim_lookup_table_entry *lte;
+       u16 stream_idx;
+       const tchar *stream_name = NULL;
+       struct wim_inode *inode;
+       tchar *p = NULL;
+
+       if (lookup_flags & LOOKUP_FLAG_ADS_OK) {
+               stream_name = path_stream_name(path);
+               if (stream_name) {
+                       p = (tchar*)stream_name - 1;
+                       *p = T('\0');
+               }
+       }
+
+       dentry = get_dentry(wim, path, WIMLIB_CASE_SENSITIVE);
+       if (p)
+               *p = T(':');
+       if (!dentry)
+               return -errno;
+
+       inode = dentry->d_inode;
+
+       if (!inode->i_resolved)
+               if (inode_resolve_streams(inode, wim->lookup_table, false))
+                       return -EIO;
+
+       if (!(lookup_flags & LOOKUP_FLAG_DIRECTORY_OK)
+             && inode_is_directory(inode))
+               return -EISDIR;
+
+       if (stream_name) {
+               struct wim_ads_entry *ads_entry;
+               u16 ads_idx;
+               ads_entry = inode_get_ads_entry(inode, stream_name,
+                                               &ads_idx);
+               if (ads_entry) {
+                       stream_idx = ads_idx + 1;
+                       lte = ads_entry->lte;
+                       goto out;
+               } else {
+                       return -ENOENT;
+               }
+       } else {
+               lte = inode_unnamed_stream_resolved(inode, &stream_idx);
+       }
+out:
+       if (dentry_ret)
+               *dentry_ret = dentry;
+       if (lte_ret)
+               *lte_ret = lte;
+       if (stream_idx_ret)
+               *stream_idx_ret = stream_idx;
+       return 0;
 }
+#endif /* WITH_FUSE  */
 
 /* Prints the full path of a dentry. */
 int
@@ -978,34 +1052,6 @@ dentry_common_init(struct wim_dentry *dentry)
        memset(dentry, 0, sizeof(struct wim_dentry));
 }
 
-struct wim_inode *
-new_timeless_inode(void)
-{
-       struct wim_inode *inode = CALLOC(1, sizeof(struct wim_inode));
-       if (inode) {
-               inode->i_security_id = -1;
-               inode->i_nlink = 1;
-               inode->i_next_stream_id = 1;
-               inode->i_not_rpfixed = 1;
-               INIT_LIST_HEAD(&inode->i_list);
-               INIT_LIST_HEAD(&inode->i_dentry);
-       }
-       return inode;
-}
-
-static struct wim_inode *
-new_inode(void)
-{
-       struct wim_inode *inode = new_timeless_inode();
-       if (inode) {
-               u64 now = get_wim_timestamp();
-               inode->i_creation_time = now;
-               inode->i_last_access_time = now;
-               inode->i_last_write_time = now;
-       }
-       return inode;
-}
-
 /* Creates an unlinked directory entry. */
 int
 new_dentry(const tchar *name, struct wim_dentry **dentry_ret)
@@ -1014,11 +1060,11 @@ new_dentry(const tchar *name, struct wim_dentry **dentry_ret)
        int ret;
 
        dentry = MALLOC(sizeof(struct wim_dentry));
-       if (!dentry)
+       if (dentry == NULL)
                return WIMLIB_ERR_NOMEM;
 
        dentry_common_init(dentry);
-       ret = set_dentry_name(dentry, name);
+       ret = dentry_set_name(dentry, name);
        if (ret == 0) {
                dentry->parent = dentry;
                *dentry_ret = dentry;
@@ -1030,7 +1076,6 @@ new_dentry(const tchar *name, struct wim_dentry **dentry_ret)
        return ret;
 }
 
-
 static int
 _new_dentry_with_inode(const tchar *name, struct wim_dentry **dentry_ret,
                        bool timeless)
@@ -1046,7 +1091,7 @@ _new_dentry_with_inode(const tchar *name, struct wim_dentry **dentry_ret,
                dentry->d_inode = new_timeless_inode();
        else
                dentry->d_inode = new_inode();
-       if (!dentry->d_inode) {
+       if (dentry->d_inode == NULL) {
                free_dentry(dentry);
                return WIMLIB_ERR_NOMEM;
        }
@@ -1099,75 +1144,10 @@ dentry_tree_clear_inode_visited(struct wim_dentry *root)
        for_dentry_in_tree(root, dentry_clear_inode_visited, NULL);
 }
 
-static int
-init_ads_entry(struct wim_ads_entry *ads_entry, const void *name,
-              size_t name_nbytes, bool is_utf16le)
-{
-       int ret = 0;
-       memset(ads_entry, 0, sizeof(*ads_entry));
-
-       if (is_utf16le) {
-               utf16lechar *p = MALLOC(name_nbytes + sizeof(utf16lechar));
-               if (!p)
-                       return WIMLIB_ERR_NOMEM;
-               memcpy(p, name, name_nbytes);
-               p[name_nbytes / 2] = cpu_to_le16(0);
-               ads_entry->stream_name = p;
-               ads_entry->stream_name_nbytes = name_nbytes;
-       } else {
-               if (name && *(const tchar*)name != T('\0')) {
-                       ret = get_utf16le_name(name, &ads_entry->stream_name,
-                                              &ads_entry->stream_name_nbytes);
-               }
-       }
-       return ret;
-}
-
-static void
-destroy_ads_entry(struct wim_ads_entry *ads_entry)
-{
-       FREE(ads_entry->stream_name);
-}
-
-/* Frees an inode. */
-void
-free_inode(struct wim_inode *inode)
-{
-       if (inode) {
-               if (inode->i_ads_entries) {
-                       for (u16 i = 0; i < inode->i_num_ads; i++)
-                               destroy_ads_entry(&inode->i_ads_entries[i]);
-                       FREE(inode->i_ads_entries);
-               }
-               /* HACK: This may instead delete the inode from i_list, but the
-                * hlist_del() behaves the same as list_del(). */
-               if (!hlist_unhashed(&inode->i_hlist))
-                       hlist_del(&inode->i_hlist);
-               FREE(inode);
-       }
-}
-
-/* Decrements link count on an inode and frees it if the link count reaches 0.
- * */
-static void
-put_inode(struct wim_inode *inode)
-{
-       wimlib_assert(inode->i_nlink != 0);
-       if (--inode->i_nlink == 0) {
-       #ifdef WITH_FUSE
-               if (inode->i_num_opened_fds == 0)
-       #endif
-               {
-                       free_inode(inode);
-               }
-       }
-}
-
 /* Frees a WIM dentry.
  *
  * The corresponding inode (if any) is freed only if its link count is
- * decremented to 0.
- */
+ * decremented to 0.  */
 void
 free_dentry(struct wim_dentry *dentry)
 {
@@ -1219,8 +1199,6 @@ free_dentry_tree(struct wim_dentry *root, struct wim_lookup_table *lookup_table)
        for_dentry_in_tree_depth(root, do_free_dentry, lookup_table);
 }
 
-#ifdef __WIN32__
-
 /* Insert a dentry into the case insensitive index for a directory.
  *
  * This is a red-black tree, but when multiple dentries share the same
@@ -1256,7 +1234,6 @@ dentry_add_child_case_insensitive(struct wim_dentry *parent,
        rb_insert_color(&child->rb_node_case_insensitive, root);
        return NULL;
 }
-#endif
 
 /*
  * Links a dentry into the directory tree.
@@ -1300,7 +1277,7 @@ dentry_add_child(struct wim_dentry * restrict parent,
        rb_link_node(&child->rb_node, rb_parent, new);
        rb_insert_color(&child->rb_node, root);
 
-#ifdef __WIN32__
+       /* Case insensitive child dentry index */
        {
                struct wim_dentry *existing;
                existing = dentry_add_child_case_insensitive(parent, child);
@@ -1312,7 +1289,6 @@ dentry_add_child(struct wim_dentry * restrict parent,
                        INIT_LIST_HEAD(&child->case_insensitive_conflict_list);
                }
        }
-#endif
        return NULL;
 }
 
@@ -1325,7 +1301,7 @@ unlink_dentry(struct wim_dentry *dentry)
        if (parent == dentry)
                return;
        rb_erase(&dentry->rb_node, &parent->d_inode->i_children);
-#ifdef __WIN32__
+
        if (dentry->rb_node_case_insensitive.__rb_parent_color) {
                /* This dentry was in the case-insensitive red-black tree. */
                rb_erase(&dentry->rb_node_case_insensitive,
@@ -1344,431 +1320,76 @@ unlink_dentry(struct wim_dentry *dentry)
                }
        }
        list_del(&dentry->case_insensitive_conflict_list);
-#endif
-}
-
-/*
- * Returns the alternate data stream entry belonging to @inode that has the
- * stream name @stream_name.
- */
-struct wim_ads_entry *
-inode_get_ads_entry(struct wim_inode *inode, const tchar *stream_name,
-                   u16 *idx_ret)
-{
-       if (inode->i_num_ads == 0) {
-               return NULL;
-       } else {
-               size_t stream_name_utf16le_nbytes;
-               u16 i;
-               struct wim_ads_entry *result;
-
-       #if TCHAR_IS_UTF16LE
-               const utf16lechar *stream_name_utf16le;
-
-               stream_name_utf16le = stream_name;
-               stream_name_utf16le_nbytes = tstrlen(stream_name) * sizeof(tchar);
-       #else
-               utf16lechar *stream_name_utf16le;
-
-               {
-                       int ret = tstr_to_utf16le(stream_name,
-                                                 tstrlen(stream_name) *
-                                                     sizeof(tchar),
-                                                 &stream_name_utf16le,
-                                                 &stream_name_utf16le_nbytes);
-                       if (ret)
-                               return NULL;
-               }
-       #endif
-               i = 0;
-               result = NULL;
-               do {
-                       if (ads_entry_has_name(&inode->i_ads_entries[i],
-                                              stream_name_utf16le,
-                                              stream_name_utf16le_nbytes))
-                       {
-                               if (idx_ret)
-                                       *idx_ret = i;
-                               result = &inode->i_ads_entries[i];
-                               break;
-                       }
-               } while (++i != inode->i_num_ads);
-       #if !TCHAR_IS_UTF16LE
-               FREE(stream_name_utf16le);
-       #endif
-               return result;
-       }
-}
-
-static struct wim_ads_entry *
-do_inode_add_ads(struct wim_inode *inode, const void *stream_name,
-                size_t stream_name_nbytes, bool is_utf16le)
-{
-       u16 num_ads;
-       struct wim_ads_entry *ads_entries;
-       struct wim_ads_entry *new_entry;
-
-       if (inode->i_num_ads >= 0xfffe) {
-               ERROR("Too many alternate data streams in one inode!");
-               return NULL;
-       }
-       num_ads = inode->i_num_ads + 1;
-       ads_entries = REALLOC(inode->i_ads_entries,
-                             num_ads * sizeof(inode->i_ads_entries[0]));
-       if (!ads_entries) {
-               ERROR("Failed to allocate memory for new alternate data stream");
-               return NULL;
-       }
-       inode->i_ads_entries = ads_entries;
-
-       new_entry = &inode->i_ads_entries[num_ads - 1];
-       if (init_ads_entry(new_entry, stream_name, stream_name_nbytes, is_utf16le))
-               return NULL;
-       new_entry->stream_id = inode->i_next_stream_id++;
-       inode->i_num_ads = num_ads;
-       return new_entry;
-}
-
-struct wim_ads_entry *
-inode_add_ads_utf16le(struct wim_inode *inode,
-                     const utf16lechar *stream_name,
-                     size_t stream_name_nbytes)
-{
-       DEBUG("Add alternate data stream \"%"WS"\"", stream_name);
-       return do_inode_add_ads(inode, stream_name, stream_name_nbytes, true);
-}
-
-/*
- * Add an alternate stream entry to a WIM inode and return a pointer to it, or
- * NULL if memory could not be allocated.
- */
-struct wim_ads_entry *
-inode_add_ads(struct wim_inode *inode, const tchar *stream_name)
-{
-       DEBUG("Add alternate data stream \"%"TS"\"", stream_name);
-       return do_inode_add_ads(inode, stream_name,
-                               tstrlen(stream_name) * sizeof(tchar),
-                               TCHAR_IS_UTF16LE);
 }
 
-static struct wim_lookup_table_entry *
-add_stream_from_data_buffer(const void *buffer, size_t size,
-                           struct wim_lookup_table *lookup_table)
-{
-       u8 hash[SHA1_HASH_SIZE];
-       struct wim_lookup_table_entry *lte, *existing_lte;
-
-       sha1_buffer(buffer, size, hash);
-       existing_lte = __lookup_resource(lookup_table, hash);
-       if (existing_lte) {
-               wimlib_assert(wim_resource_size(existing_lte) == size);
-               lte = existing_lte;
-               lte->refcnt++;
-       } else {
-               void *buffer_copy;
-               lte = new_lookup_table_entry();
-               if (!lte)
-                       return NULL;
-               buffer_copy = memdup(buffer, size);
-               if (!buffer_copy) {
-                       free_lookup_table_entry(lte);
-                       return NULL;
-               }
-               lte->resource_location            = RESOURCE_IN_ATTACHED_BUFFER;
-               lte->attached_buffer              = buffer_copy;
-               lte->resource_entry.original_size = size;
-               copy_hash(lte->hash, hash);
-               lookup_table_insert(lookup_table, lte);
-       }
-       return lte;
-}
-
-int
-inode_add_ads_with_data(struct wim_inode *inode, const tchar *name,
-                       const void *value, size_t size,
-                       struct wim_lookup_table *lookup_table)
+static int
+free_dentry_full_path(struct wim_dentry *dentry, void *_ignore)
 {
-       struct wim_ads_entry *new_ads_entry;
-
-       wimlib_assert(inode->i_resolved);
-
-       new_ads_entry = inode_add_ads(inode, name);
-       if (!new_ads_entry)
-               return WIMLIB_ERR_NOMEM;
-
-       new_ads_entry->lte = add_stream_from_data_buffer(value, size,
-                                                        lookup_table);
-       if (!new_ads_entry->lte) {
-               inode_remove_ads(inode, new_ads_entry - inode->i_ads_entries,
-                                lookup_table);
-               return WIMLIB_ERR_NOMEM;
-       }
+       FREE(dentry->_full_path);
+       dentry->_full_path = NULL;
        return 0;
 }
 
-bool
-inode_has_named_stream(const struct wim_inode *inode)
-{
-       for (u16 i = 0; i < inode->i_num_ads; i++)
-               if (ads_entry_is_named_stream(&inode->i_ads_entries[i]))
-                       return true;
-       return false;
-}
-
-/* Set the unnamed stream of a WIM inode, given a data buffer containing the
- * stream contents. */
+/* Rename a file or directory in the WIM.  */
 int
-inode_set_unnamed_stream(struct wim_inode *inode, const void *data, size_t len,
-                        struct wim_lookup_table *lookup_table)
+rename_wim_path(WIMStruct *wim, const tchar *from, const tchar *to,
+               CASE_SENSITIVITY_TYPE case_type)
 {
-       inode->i_lte = add_stream_from_data_buffer(data, len, lookup_table);
-       if (!inode->i_lte)
-               return WIMLIB_ERR_NOMEM;
-       inode->i_resolved = 1;
-       return 0;
-}
-
-/* Remove an alternate data stream from a WIM inode  */
-void
-inode_remove_ads(struct wim_inode *inode, u16 idx,
-                struct wim_lookup_table *lookup_table)
-{
-       struct wim_ads_entry *ads_entry;
-       struct wim_lookup_table_entry *lte;
-
-       wimlib_assert(idx < inode->i_num_ads);
-       wimlib_assert(inode->i_resolved);
-
-       ads_entry = &inode->i_ads_entries[idx];
-
-       DEBUG("Remove alternate data stream \"%"WS"\"", ads_entry->stream_name);
-
-       lte = ads_entry->lte;
-       if (lte)
-               lte_decrement_refcnt(lte, lookup_table);
-
-       destroy_ads_entry(ads_entry);
-
-       memmove(&inode->i_ads_entries[idx],
-               &inode->i_ads_entries[idx + 1],
-               (inode->i_num_ads - idx - 1) * sizeof(inode->i_ads_entries[0]));
-       inode->i_num_ads--;
-}
-
-bool
-inode_has_unix_data(const struct wim_inode *inode)
-{
-       for (u16 i = 0; i < inode->i_num_ads; i++)
-               if (ads_entry_is_unix_data(&inode->i_ads_entries[i]))
-                       return true;
-       return false;
-}
-
-#ifndef __WIN32__
-int
-inode_get_unix_data(const struct wim_inode *inode,
-                   struct wimlib_unix_data *unix_data,
-                   u16 *stream_idx_ret)
-{
-       const struct wim_ads_entry *ads_entry;
-       const struct wim_lookup_table_entry *lte;
-       size_t size;
+       struct wim_dentry *src;
+       struct wim_dentry *dst;
+       struct wim_dentry *parent_of_dst;
        int ret;
 
-       wimlib_assert(inode->i_resolved);
+       /* This rename() implementation currently only supports actual files
+        * (not alternate data streams) */
 
-       ads_entry = inode_get_ads_entry((struct wim_inode*)inode,
-                                       WIMLIB_UNIX_DATA_TAG, NULL);
-       if (!ads_entry)
-               return NO_UNIX_DATA;
+       src = get_dentry(wim, from, case_type);
+       if (!src)
+               return -errno;
 
-       if (stream_idx_ret)
-               *stream_idx_ret = ads_entry - inode->i_ads_entries;
+       dst = get_dentry(wim, to, case_type);
 
-       lte = ads_entry->lte;
-       if (!lte)
-               return NO_UNIX_DATA;
+       if (dst) {
+               /* Destination file exists */
 
-       size = wim_resource_size(lte);
-       if (size != sizeof(struct wimlib_unix_data))
-               return BAD_UNIX_DATA;
+               if (src == dst) /* Same file */
+                       return 0;
 
-       ret = read_full_resource_into_buf(lte, unix_data);
-       if (ret)
-               return ret;
-
-       if (unix_data->version != 0)
-               return BAD_UNIX_DATA;
-       return 0;
-}
-
-int
-inode_set_unix_data(struct wim_inode *inode, uid_t uid, gid_t gid, mode_t mode,
-                   struct wim_lookup_table *lookup_table, int which)
-{
-       struct wimlib_unix_data unix_data;
-       int ret;
-       bool have_good_unix_data = false;
-       bool have_unix_data = false;
-       u16 stream_idx;
-
-       if (!(which & UNIX_DATA_CREATE)) {
-               ret = inode_get_unix_data(inode, &unix_data, &stream_idx);
-               if (ret == 0 || ret == BAD_UNIX_DATA || ret > 0)
-                       have_unix_data = true;
-               if (ret == 0)
-                       have_good_unix_data = true;
-       }
-       unix_data.version = 0;
-       if (which & UNIX_DATA_UID || !have_good_unix_data)
-               unix_data.uid = uid;
-       if (which & UNIX_DATA_GID || !have_good_unix_data)
-               unix_data.gid = gid;
-       if (which & UNIX_DATA_MODE || !have_good_unix_data)
-               unix_data.mode = mode;
-       ret = inode_add_ads_with_data(inode, WIMLIB_UNIX_DATA_TAG,
-                                     &unix_data,
-                                     sizeof(struct wimlib_unix_data),
-                                     lookup_table);
-       if (ret == 0 && have_unix_data)
-               inode_remove_ads(inode, stream_idx, lookup_table);
-       return ret;
-}
-#endif /* !__WIN32__ */
-
-/*
- * Reads the alternate data stream entries of a WIM dentry.
- *
- * @p:
- *     Pointer to buffer that starts with the first alternate stream entry.
- *
- * @inode:
- *     Inode to load the alternate data streams into.  @inode->i_num_ads must
- *     have been set to the number of alternate data streams that are expected.
- *
- * @remaining_size:
- *     Number of bytes of data remaining in the buffer pointed to by @p.
- *
- * On success, inode->i_ads_entries is set to an array of `struct
- * wim_ads_entry's of length inode->i_num_ads.  On failure, @inode is not
- * modified.
- *
- * Return values:
- *     WIMLIB_ERR_SUCCESS (0)
- *     WIMLIB_ERR_INVALID_METADATA_RESOURCE
- *     WIMLIB_ERR_NOMEM
- */
-static int
-read_ads_entries(const u8 * restrict p, struct wim_inode * restrict inode,
-                size_t nbytes_remaining)
-{
-       u16 num_ads;
-       struct wim_ads_entry *ads_entries;
-       int ret;
-
-       BUILD_BUG_ON(sizeof(struct wim_ads_entry_on_disk) != WIM_ADS_ENTRY_DISK_SIZE);
-
-       /* Allocate an array for our in-memory representation of the alternate
-        * data stream entries. */
-       num_ads = inode->i_num_ads;
-       ads_entries = CALLOC(num_ads, sizeof(inode->i_ads_entries[0]));
-       if (!ads_entries)
-               goto out_of_memory;
-
-       /* Read the entries into our newly allocated buffer. */
-       for (u16 i = 0; i < num_ads; i++) {
-               u64 length;
-               struct wim_ads_entry *cur_entry;
-               const struct wim_ads_entry_on_disk *disk_entry =
-                       (const struct wim_ads_entry_on_disk*)p;
-
-               cur_entry = &ads_entries[i];
-               ads_entries[i].stream_id = i + 1;
-
-               /* Do we have at least the size of the fixed-length data we know
-                * need? */
-               if (nbytes_remaining < sizeof(struct wim_ads_entry_on_disk))
-                       goto out_invalid;
-
-               /* Read the length field */
-               length = le64_to_cpu(disk_entry->length);
-
-               /* Make sure the length field is neither so small it doesn't
-                * include all the fixed-length data nor so large it overflows
-                * the metadata resource buffer. */
-               if (length < sizeof(struct wim_ads_entry_on_disk) ||
-                   length > nbytes_remaining)
-                       goto out_invalid;
-
-               /* Read the rest of the fixed-length data. */
-
-               cur_entry->reserved = le64_to_cpu(disk_entry->reserved);
-               copy_hash(cur_entry->hash, disk_entry->hash);
-               cur_entry->stream_name_nbytes = le16_to_cpu(disk_entry->stream_name_nbytes);
-
-               /* If stream_name_nbytes != 0, this is a named stream.
-                * Otherwise this is an unnamed stream, or in some cases (bugs
-                * in Microsoft's software I guess) a meaningless entry
-                * distinguished from the real unnamed stream entry, if any, by
-                * the fact that the real unnamed stream entry has a nonzero
-                * hash field. */
-               if (cur_entry->stream_name_nbytes) {
-                       /* The name is encoded in UTF16-LE, which uses 2-byte
-                        * coding units, so the length of the name had better be
-                        * an even number of bytes... */
-                       if (cur_entry->stream_name_nbytes & 1)
-                               goto out_invalid;
-
-                       /* Add the length of the stream name to get the length
-                        * we actually need to read.  Make sure this isn't more
-                        * than the specified length of the entry. */
-                       if (sizeof(struct wim_ads_entry_on_disk) +
-                           cur_entry->stream_name_nbytes > length)
-                               goto out_invalid;
-
-                       cur_entry->stream_name = MALLOC(cur_entry->stream_name_nbytes + 2);
-                       if (!cur_entry->stream_name)
-                               goto out_of_memory;
-
-                       memcpy(cur_entry->stream_name,
-                              disk_entry->stream_name,
-                              cur_entry->stream_name_nbytes);
-                       cur_entry->stream_name[cur_entry->stream_name_nbytes / 2] = cpu_to_le16(0);
+               if (!dentry_is_directory(src)) {
+                       /* Cannot rename non-directory to directory. */
+                       if (dentry_is_directory(dst))
+                               return -EISDIR;
+               } else {
+                       /* Cannot rename directory to a non-directory or a non-empty
+                        * directory */
+                       if (!dentry_is_directory(dst))
+                               return -ENOTDIR;
+                       if (dentry_has_children(dst))
+                               return -ENOTEMPTY;
                }
+               parent_of_dst = dst->parent;
+       } else {
+               /* Destination does not exist */
+               parent_of_dst = get_parent_dentry(wim, to, case_type);
+               if (!parent_of_dst)
+                       return -errno;
 
-               /* It's expected that the size of every ADS entry is a multiple
-                * of 8.  However, to be safe, I'm allowing the possibility of
-                * an ADS entry at the very end of the metadata resource ending
-                * un-aligned.  So although we still need to increment the input
-                * pointer by @length to reach the next ADS entry, it's possible
-                * that less than @length is actually remaining in the metadata
-                * resource. We should set the remaining bytes to 0 if this
-                * happens. */
-               length = (length + 7) & ~(u64)7;
-               p += length;
-               if (nbytes_remaining < length)
-                       nbytes_remaining = 0;
-               else
-                       nbytes_remaining -= length;
+               if (!dentry_is_directory(parent_of_dst))
+                       return -ENOTDIR;
        }
-       inode->i_ads_entries = ads_entries;
-       inode->i_next_stream_id = inode->i_num_ads + 1;
-       ret = 0;
-       goto out;
-out_of_memory:
-       ret = WIMLIB_ERR_NOMEM;
-       goto out_free_ads_entries;
-out_invalid:
-       ERROR("An alternate data stream entry is invalid");
-       ret = WIMLIB_ERR_INVALID_METADATA_RESOURCE;
-out_free_ads_entries:
-       if (ads_entries) {
-               for (u16 i = 0; i < num_ads; i++)
-                       destroy_ads_entry(&ads_entries[i]);
-               FREE(ads_entries);
+
+       ret = dentry_set_name(src, path_basename(to));
+       if (ret)
+               return -ENOMEM;
+       if (dst) {
+               unlink_dentry(dst);
+               free_dentry_tree(dst, wim->lookup_table);
        }
-out:
-       return ret;
+       unlink_dentry(src);
+       dentry_add_child(parent_of_dst, src);
+       if (src->_full_path)
+               for_dentry_in_tree(src, free_dentry_full_path, NULL);
+       return 0;
 }
 
 /*
@@ -1863,7 +1484,7 @@ read_dentry(const u8 * restrict metadata_resource, u64 metadata_resource_len,
 
        /* Allocate a `struct wim_inode' for this `struct wim_dentry'. */
        inode = new_timeless_inode();
-       if (!inode)
+       if (inode == NULL)
                return WIMLIB_ERR_NOMEM;
 
        /* Read more fields; some into the dentry, and some into the inode. */
@@ -1914,8 +1535,8 @@ read_dentry(const u8 * restrict metadata_resource, u64 metadata_resource_len,
         * The calculated length here is unaligned to allow for the possibility
         * that the dentry->length names an unaligned length, although this
         * would be unexpected. */
-       calculated_size = _dentry_correct_length_unaligned(file_name_nbytes,
-                                                          short_name_nbytes);
+       calculated_size = dentry_correct_length_unaligned(file_name_nbytes,
+                                                         short_name_nbytes);
 
        if (dentry->length < calculated_size) {
                ERROR("Unexpected end of directory entry! (Expected "
@@ -1931,7 +1552,7 @@ read_dentry(const u8 * restrict metadata_resource, u64 metadata_resource_len,
         * is no null terminator following it. */
        if (file_name_nbytes) {
                file_name = MALLOC(file_name_nbytes + 2);
-               if (!file_name) {
+               if (file_name == NULL) {
                        ERROR("Failed to allocate %d bytes for dentry file name",
                              file_name_nbytes + 2);
                        ret = WIMLIB_ERR_NOMEM;
@@ -1949,7 +1570,7 @@ read_dentry(const u8 * restrict metadata_resource, u64 metadata_resource_len,
         * filename, there is no null terminator following it. */
        if (short_name_nbytes) {
                short_name = MALLOC(short_name_nbytes + 2);
-               if (!short_name) {
+               if (short_name == NULL) {
                        ERROR("Failed to allocate %d bytes for dentry short name",
                              short_name_nbytes + 2);
                        ret = WIMLIB_ERR_NOMEM;
@@ -2062,7 +1683,7 @@ read_dentry_tree(const u8 * restrict metadata_resource,
        for (parent = dentry->parent; !dentry_is_root(parent); parent = parent->parent)
        {
                if (unlikely(parent->subdir_offset == cur_offset)) {
-                       ERROR("Cyclic directory structure directed: children "
+                       ERROR("Cyclic directory structure detected: children "
                              "of \"%"TS"\" coincide with children of \"%"TS"\"",
                              dentry_full_path(dentry),
                              dentry_full_path(parent));
@@ -2086,7 +1707,7 @@ read_dentry_tree(const u8 * restrict metadata_resource,
                /* Not end of directory.  Allocate this child permanently and
                 * link it to the parent and previous child. */
                child = memdup(&cur_child, sizeof(struct wim_dentry));
-               if (!child) {
+               if (child == NULL) {
                        ERROR("Failed to allocate new dentry!");
                        ret = WIMLIB_ERR_NOMEM;
                        break;
@@ -2097,7 +1718,7 @@ read_dentry_tree(const u8 * restrict metadata_resource,
                 * cur_child.length, which although it does take into account
                 * the padding, it DOES NOT take into account alternate stream
                 * entries. */
-               cur_offset += dentry_total_length(child);
+               cur_offset += dentry_in_total_length(child);
 
                if (unlikely(!dentry_has_long_name(child))) {
                        WARNING("Ignoring unnamed dentry in "
@@ -2140,6 +1761,38 @@ read_dentry_tree(const u8 * restrict metadata_resource,
        return ret;
 }
 
+/*
+ * Writes a WIM alternate data stream (ADS) entry to an output buffer.
+ *
+ * @ads_entry:  The ADS entry structure.
+ * @hash:       The hash field to use (instead of the one in the ADS entry).
+ * @p:          The memory location to write the data to.
+ *
+ * Returns a pointer to the byte after the last byte written.
+ */
+static u8 *
+write_ads_entry(const struct wim_ads_entry *ads_entry,
+               const u8 *hash, u8 * restrict p)
+{
+       struct wim_ads_entry_on_disk *disk_ads_entry =
+                       (struct wim_ads_entry_on_disk*)p;
+       u8 *orig_p = p;
+
+       disk_ads_entry->reserved = cpu_to_le64(ads_entry->reserved);
+       copy_hash(disk_ads_entry->hash, hash);
+       disk_ads_entry->stream_name_nbytes = cpu_to_le16(ads_entry->stream_name_nbytes);
+       p += sizeof(struct wim_ads_entry_on_disk);
+       if (ads_entry->stream_name_nbytes) {
+               p = mempcpy(p, ads_entry->stream_name,
+                           ads_entry->stream_name_nbytes + 2);
+       }
+       /* Align to 8-byte boundary */
+       while ((uintptr_t)p & 7)
+               *p++ = 0;
+       disk_ads_entry->length = cpu_to_le64(p - orig_p);
+       return p;
+}
+
 /*
  * Writes a WIM dentry to an output buffer.
  *
@@ -2156,11 +1809,14 @@ write_dentry(const struct wim_dentry * restrict dentry, u8 * restrict p)
        struct wim_dentry_on_disk *disk_dentry;
        const u8 *orig_p;
        const u8 *hash;
+       bool use_dummy_stream;
+       u16 num_ads;
 
        wimlib_assert(((uintptr_t)p & 7) == 0); /* 8 byte aligned */
        orig_p = p;
 
        inode = dentry->d_inode;
+       use_dummy_stream = inode_needs_dummy_stream(inode);
        disk_dentry = (struct wim_dentry_on_disk*)p;
 
        disk_dentry->attributes = cpu_to_le32(inode->i_attributes);
@@ -2171,7 +1827,10 @@ write_dentry(const struct wim_dentry * restrict dentry, u8 * restrict p)
        disk_dentry->creation_time = cpu_to_le64(inode->i_creation_time);
        disk_dentry->last_access_time = cpu_to_le64(inode->i_last_access_time);
        disk_dentry->last_write_time = cpu_to_le64(inode->i_last_write_time);
-       hash = inode_stream_hash(inode, 0);
+       if (use_dummy_stream)
+               hash = zero_hash;
+       else
+               hash = inode_stream_hash(inode, 0);
        copy_hash(disk_dentry->unnamed_stream_hash, hash);
        if (inode->i_attributes & FILE_ATTRIBUTE_REPARSE_POINT) {
                disk_dentry->reparse.rp_unknown_1 = cpu_to_le32(inode->i_rp_unknown_1);
@@ -2183,7 +1842,10 @@ write_dentry(const struct wim_dentry * restrict dentry, u8 * restrict p)
                disk_dentry->nonreparse.hard_link_group_id =
                        cpu_to_le64((inode->i_nlink == 1) ? 0 : inode->i_ino);
        }
-       disk_dentry->num_alternate_data_streams = cpu_to_le16(inode->i_num_ads);
+       num_ads = inode->i_num_ads;
+       if (use_dummy_stream)
+               num_ads++;
+       disk_dentry->num_alternate_data_streams = cpu_to_le16(num_ads);
        disk_dentry->short_name_nbytes = cpu_to_le16(dentry->short_name_nbytes);
        disk_dentry->file_name_nbytes = cpu_to_le16(dentry->file_name_nbytes);
        p += sizeof(struct wim_dentry_on_disk);
@@ -2207,29 +1869,17 @@ write_dentry(const struct wim_dentry * restrict dentry, u8 * restrict p)
         * have been renamed, thus changing its needed length. */
        disk_dentry->length = cpu_to_le64(p - orig_p);
 
+       if (use_dummy_stream) {
+               hash = inode_unnamed_stream_hash(inode);
+               p = write_ads_entry(&(struct wim_ads_entry){}, hash, p);
+       }
+
        /* Write the alternate data streams entries, if any. */
        for (u16 i = 0; i < inode->i_num_ads; i++) {
-               const struct wim_ads_entry *ads_entry =
-                               &inode->i_ads_entries[i];
-               struct wim_ads_entry_on_disk *disk_ads_entry =
-                               (struct wim_ads_entry_on_disk*)p;
-               orig_p = p;
-
-               disk_ads_entry->reserved = cpu_to_le64(ads_entry->reserved);
-
                hash = inode_stream_hash(inode, i + 1);
-               copy_hash(disk_ads_entry->hash, hash);
-               disk_ads_entry->stream_name_nbytes = cpu_to_le16(ads_entry->stream_name_nbytes);
-               p += sizeof(struct wim_ads_entry_on_disk);
-               if (ads_entry->stream_name_nbytes) {
-                       p = mempcpy(p, ads_entry->stream_name,
-                                   ads_entry->stream_name_nbytes + 2);
-               }
-               /* Align to 8-byte boundary */
-               while ((uintptr_t)p & 7)
-                       *p++ = 0;
-               disk_ads_entry->length = cpu_to_le64(p - orig_p);
+               p = write_ads_entry(&inode->i_ads_entries[i], hash, p);
        }
+
        return p;
 }
 
@@ -2303,321 +1953,3 @@ write_dentry_tree(const struct wim_dentry * restrict root, u8 * restrict p)
        /* Recursively write the rest of the dentry tree. */
        return write_dentry_tree_recursive(root, p);
 }
-
-
-static int
-init_wimlib_dentry(struct wimlib_dir_entry *wdentry,
-                  struct wim_dentry *dentry,
-                  const WIMStruct *wim)
-{
-       int ret;
-       size_t dummy;
-       const struct wim_inode *inode = dentry->d_inode;
-       struct wim_lookup_table_entry *lte;
-
-#if TCHAR_IS_UTF16LE
-       wdentry->filename = dentry->file_name;
-       wdentry->dos_name = dentry->short_name;
-#else
-       if (dentry_has_long_name(dentry)) {
-               ret = utf16le_to_tstr(dentry->file_name,
-                                     dentry->file_name_nbytes,
-                                     (tchar**)&wdentry->filename,
-                                     &dummy);
-               if (ret)
-                       return ret;
-       }
-       if (dentry_has_short_name(dentry)) {
-               ret = utf16le_to_tstr(dentry->short_name,
-                                     dentry->short_name_nbytes,
-                                     (tchar**)&wdentry->dos_name,
-                                     &dummy);
-               if (ret)
-                       return ret;
-       }
-#endif
-       ret = calculate_dentry_full_path(dentry);
-       if (ret)
-               return ret;
-       wdentry->full_path = dentry->_full_path;
-
-       for (struct wim_dentry *d = dentry; !dentry_is_root(d); d = d->parent)
-               wdentry->depth++;
-
-       if (inode->i_security_id >= 0) {
-               const struct wim_security_data *sd = wim_const_security_data(wim);
-               wdentry->security_descriptor = sd->descriptors[inode->i_security_id];
-               wdentry->security_descriptor_size = sd->sizes[inode->i_security_id];
-       }
-       wdentry->reparse_tag = inode->i_reparse_tag;
-       wdentry->num_links = inode->i_nlink;
-       wdentry->attributes = inode->i_attributes;
-       wdentry->hard_link_group_id = inode->i_ino;
-       wdentry->creation_time = wim_timestamp_to_timespec(inode->i_creation_time);
-       wdentry->last_write_time = wim_timestamp_to_timespec(inode->i_last_write_time);
-       wdentry->last_access_time = wim_timestamp_to_timespec(inode->i_last_access_time);
-
-       lte = inode_unnamed_lte(inode, wim->lookup_table);
-       if (lte)
-               lte_to_wimlib_resource_entry(lte, &wdentry->streams[0].resource);
-
-       for (unsigned i = 0; i < inode->i_num_ads; i++) {
-               if (inode->i_ads_entries[i].stream_name == NULL)
-                       continue;
-               lte = inode_stream_lte(inode, i + 1, wim->lookup_table);
-               wdentry->num_named_streams++;
-               if (lte) {
-                       lte_to_wimlib_resource_entry(lte, &wdentry->streams[
-                                                               wdentry->num_named_streams].resource);
-               }
-       #if TCHAR_IS_UTF16LE
-               wdentry->streams[wdentry->num_named_streams].stream_name =
-                               inode->i_ads_entries[i].stream_name;
-       #else
-               size_t dummy;
-
-               ret = utf16le_to_tstr(inode->i_ads_entries[i].stream_name,
-                                     inode->i_ads_entries[i].stream_name_nbytes,
-                                     (tchar**)&wdentry->streams[
-                                               wdentry->num_named_streams].stream_name,
-                                     &dummy);
-               if (ret)
-                       return ret;
-       #endif
-       }
-       return 0;
-}
-
-static void
-free_wimlib_dentry(struct wimlib_dir_entry *wdentry)
-{
-#if !TCHAR_IS_UTF16LE
-       FREE((tchar*)wdentry->filename);
-       FREE((tchar*)wdentry->dos_name);
-       for (unsigned i = 1; i <= wdentry->num_named_streams; i++)
-               FREE((tchar*)wdentry->streams[i].stream_name);
-#endif
-       FREE(wdentry);
-}
-
-struct iterate_dir_tree_ctx {
-       WIMStruct *wim;
-       int flags;
-       wimlib_iterate_dir_tree_callback_t cb;
-       void *user_ctx;
-};
-
-static int
-do_iterate_dir_tree(WIMStruct *wim,
-                   struct wim_dentry *dentry, int flags,
-                   wimlib_iterate_dir_tree_callback_t cb,
-                   void *user_ctx);
-
-static int
-call_do_iterate_dir_tree(struct wim_dentry *dentry, void *_ctx)
-{
-       struct iterate_dir_tree_ctx *ctx = _ctx;
-       return do_iterate_dir_tree(ctx->wim, dentry, ctx->flags,
-                                  ctx->cb, ctx->user_ctx);
-}
-
-static int
-do_iterate_dir_tree(WIMStruct *wim,
-                   struct wim_dentry *dentry, int flags,
-                   wimlib_iterate_dir_tree_callback_t cb,
-                   void *user_ctx)
-{
-       struct wimlib_dir_entry *wdentry;
-       int ret = WIMLIB_ERR_NOMEM;
-
-
-       wdentry = CALLOC(1, sizeof(struct wimlib_dir_entry) +
-                                 (1 + dentry->d_inode->i_num_ads) *
-                                       sizeof(struct wimlib_stream_entry));
-       if (!wdentry)
-               goto out;
-
-       ret = init_wimlib_dentry(wdentry, dentry, wim);
-       if (ret)
-               goto out_free_wimlib_dentry;
-
-       if (!(flags & WIMLIB_ITERATE_DIR_TREE_FLAG_CHILDREN)) {
-               ret = (*cb)(wdentry, user_ctx);
-               if (ret)
-                       goto out_free_wimlib_dentry;
-       }
-
-       if (flags & (WIMLIB_ITERATE_DIR_TREE_FLAG_RECURSIVE |
-                    WIMLIB_ITERATE_DIR_TREE_FLAG_CHILDREN))
-       {
-               struct iterate_dir_tree_ctx ctx = {
-                       .wim      = wim,
-                       .flags    = flags &= ~WIMLIB_ITERATE_DIR_TREE_FLAG_CHILDREN,
-                       .cb       = cb,
-                       .user_ctx = user_ctx,
-               };
-               ret = for_dentry_child(dentry, call_do_iterate_dir_tree, &ctx);
-       }
-out_free_wimlib_dentry:
-       free_wimlib_dentry(wdentry);
-out:
-       return ret;
-}
-
-struct image_iterate_dir_tree_ctx {
-       const tchar *path;
-       int flags;
-       wimlib_iterate_dir_tree_callback_t cb;
-       void *user_ctx;
-};
-
-
-static int
-image_do_iterate_dir_tree(WIMStruct *wim)
-{
-       struct image_iterate_dir_tree_ctx *ctx = wim->private;
-       struct wim_dentry *dentry;
-
-       dentry = get_dentry(wim, ctx->path);
-       if (!dentry)
-               return WIMLIB_ERR_PATH_DOES_NOT_EXIST;
-       return do_iterate_dir_tree(wim, dentry, ctx->flags, ctx->cb, ctx->user_ctx);
-}
-
-/* API function documented in wimlib.h  */
-WIMLIBAPI int
-wimlib_iterate_dir_tree(WIMStruct *wim, int image, const tchar *path,
-                       int flags,
-                       wimlib_iterate_dir_tree_callback_t cb, void *user_ctx)
-{
-       struct image_iterate_dir_tree_ctx ctx = {
-               .path = path,
-               .flags = flags,
-               .cb = cb,
-               .user_ctx = user_ctx,
-       };
-       wim->private = &ctx;
-       return for_image(wim, image, image_do_iterate_dir_tree);
-}
-
-static bool
-inode_stream_sizes_consistent(const struct wim_inode *inode_1,
-                             const struct wim_inode *inode_2,
-                             const struct wim_lookup_table *lookup_table)
-{
-       if (inode_1->i_num_ads != inode_2->i_num_ads)
-               return false;
-       for (unsigned i = 0; i <= inode_1->i_num_ads; i++) {
-               const struct wim_lookup_table_entry *lte_1, *lte_2;
-
-               lte_1 = inode_stream_lte(inode_1, i, lookup_table);
-               lte_2 = inode_stream_lte(inode_2, i, lookup_table);
-               if (lte_1 && lte_2) {
-                       if (wim_resource_size(lte_1) != wim_resource_size(lte_2))
-                               return false;
-               } else if (lte_1 && wim_resource_size(lte_1)) {
-                       return false;
-               } else if (lte_2 && wim_resource_size(lte_2)) {
-                       return false;
-               }
-       }
-       return true;
-}
-
-static void
-inode_replace_ltes(struct wim_inode *inode,
-                  struct wim_inode *template_inode,
-                  struct wim_lookup_table *lookup_table)
-{
-       for (unsigned i = 0; i <= inode->i_num_ads; i++) {
-               struct wim_lookup_table_entry *lte, *lte_template;
-
-               lte = inode_stream_lte(inode, i, lookup_table);
-               if (lte) {
-                       for (unsigned j = 0; j < inode->i_nlink; j++)
-                               lte_decrement_refcnt(lte, lookup_table);
-                       lte_template = inode_stream_lte(template_inode, i,
-                                                       lookup_table);
-                       if (i == 0)
-                               inode->i_lte = lte_template;
-                       else
-                               inode->i_ads_entries[i - 1].lte = lte_template;
-                       if (lte_template)
-                               lte_template->refcnt += inode->i_nlink;
-               }
-       }
-       inode->i_resolved = 1;
-}
-
-static int
-dentry_reference_template(struct wim_dentry *dentry, void *_wim)
-{
-       int ret;
-       struct wim_dentry *template_dentry;
-       struct wim_inode *inode, *template_inode;
-       WIMStruct *wim = _wim;
-
-       if (dentry->d_inode->i_visited)
-               return 0;
-
-       ret = calculate_dentry_full_path(dentry);
-       if (ret)
-               return ret;
-
-       template_dentry = get_dentry(wim, dentry->_full_path);
-       if (!template_dentry) {
-               DEBUG("\"%"TS"\": newly added file", dentry->_full_path);
-               return 0;
-       }
-
-       inode = dentry->d_inode;
-       template_inode = template_dentry->d_inode;
-
-       if (inode->i_last_write_time == template_inode->i_last_write_time
-           && inode->i_creation_time == template_inode->i_creation_time
-           && inode->i_last_access_time >= template_inode->i_last_access_time
-           && inode_stream_sizes_consistent(inode, template_inode,
-                                            wim->lookup_table))
-       {
-               /*DEBUG("\"%"TS"\": No change detected", dentry->_full_path);*/
-               inode_replace_ltes(inode, template_inode, wim->lookup_table);
-               inode->i_visited = 1;
-       } else {
-               DEBUG("\"%"TS"\": change detected!", dentry->_full_path);
-       }
-       return 0;
-}
-
-/* API function documented in wimlib.h  */
-WIMLIBAPI int
-wimlib_reference_template_image(WIMStruct *wim, int new_image, int template_image,
-                               int flags, wimlib_progress_func_t progress_func)
-{
-       int ret;
-       struct wim_image_metadata *new_imd;
-
-       if (new_image < 1 || new_image > wim->hdr.image_count)
-               return WIMLIB_ERR_INVALID_IMAGE;
-
-       if (template_image < 1 || template_image > wim->hdr.image_count)
-               return WIMLIB_ERR_INVALID_IMAGE;
-
-       if (new_image == template_image)
-               return WIMLIB_ERR_INVALID_PARAM;
-
-       if (!wim_has_metadata(wim))
-               return WIMLIB_ERR_METADATA_NOT_FOUND;
-
-       new_imd = wim->image_metadata[new_image - 1];
-       if (!new_imd->modified)
-               return WIMLIB_ERR_INVALID_PARAM;
-
-       ret = select_wim_image(wim, template_image);
-       if (ret)
-               return ret;
-
-       ret = for_dentry_in_tree(new_imd->root_dentry,
-                                dentry_reference_template, wim);
-       dentry_tree_clear_inode_visited(new_imd->root_dentry);
-       return ret;
-}