X-Git-Url: https://wimlib.net/git/?p=wimlib;a=blobdiff_plain;f=include%2Fwimlib%2Fdentry.h;h=cbc0b7c3052300dccaca1baf911c700893d56cf5;hp=241dc56d58c47493b059cc1926b936c21ffabe78;hb=ee547cc83f231d727e4d9984c23e86d96d3da769;hpb=3de1ec66f778edda19865482d685bc6f4e17faf7 diff --git a/include/wimlib/dentry.h b/include/wimlib/dentry.h index 241dc56d..cbc0b7c3 100644 --- a/include/wimlib/dentry.h +++ b/include/wimlib/dentry.h @@ -21,28 +21,18 @@ struct blob_table; * tree for each image in the WIM. * * Note that this is a directory entry and not an inode. Since NTFS allows hard - * links, it's possible for an NTFS inode to correspond to multiple WIM dentries. - * The hard link group ID field of the on-disk WIM dentry tells us the number of - * the NTFS inode that the dentry corresponds to (and this gets placed in - * d_inode->i_ino). + * links, it's possible for an NTFS inode to correspond to multiple WIM + * dentries. The hard link group ID field of the on-disk WIM dentry tells us + * the number of the NTFS inode that the dentry corresponds to (and this gets + * placed in d_inode->i_ino). * * Unfortunately, WIM files do not have an analogue to an inode; instead certain - * information, such as file attributes, the security descriptor, and file - * streams is replicated in each hard-linked dentry, even though this - * information really is associated with an inode. In-memory, we fix up this - * flaw by allocating a `struct wim_inode' for each dentry that contains some of - * this duplicated information, then combining the inodes for each hard link - * group together. - * - * Confusingly, it's possible for stream information to be missing from a dentry - * in a hard link set, in which case the stream information needs to be gotten - * from one of the other dentries in the hard link set. In addition, it is - * possible for dentries to have inconsistent security IDs, file attributes, or - * file streams when they share the same hard link ID (don't even ask. I hope - * that Microsoft may have fixed this problem, since I've only noticed it in the - * 'install.wim' for Windows 7). For those dentries, we have to use the - * conflicting fields to split up the hard link groups. (See - * dentry_tree_fix_inodes() in inode_fixup.c.) + * information, such as file attributes, the security descriptor, and streams is + * replicated in each hard-linked dentry, even though this information really is + * associated with an inode. In-memory, we fix up this flaw by allocating a + * `struct wim_inode' for each dentry that contains some of this duplicated + * information, then combining the inodes for each hard link group together. + * (See dentry_tree_fix_inodes().) */ struct wim_dentry { /* Pointer to the inode for this dentry. This will contain some @@ -67,55 +57,53 @@ struct wim_dentry { /* Linked list node that places this dentry in the list of aliases for * its inode (d_inode) */ - struct list_head d_alias; - - /* Pointer to the UTF-16LE short filename (malloc()ed buffer), or NULL - * if this dentry has no short name. */ - utf16lechar *short_name; + struct hlist_node d_alias_node; /* Pointer to the UTF-16LE filename (malloc()ed buffer), or NULL if this * dentry has no filename. */ - utf16lechar *file_name; + utf16lechar *d_name; - /* Length of UTF-16LE encoded short filename, in bytes, not including - * the terminating zero wide-character. */ - u16 short_name_nbytes; + /* Pointer to the UTF-16LE short filename (malloc()ed buffer), or NULL + * if this dentry has no short name. */ + utf16lechar *d_short_name; + + /* Length of 'd_name' in bytes, excluding the terminating null */ + u16 d_name_nbytes; - /* Length of UTF-16LE encoded "long" file name, in bytes, not including - * the terminating null character. */ - u16 file_name_nbytes; + /* Length of 'd_short_name' in bytes, excluding the terminating null */ + u16 d_short_name_nbytes; /* When capturing from an NTFS volume using NTFS-3g, this flag is set on * dentries that were created from a filename in the WIN32 or WIN32+DOS * namespaces rather than the POSIX namespace. Otherwise this will * always be 0. */ - u8 is_win32_name : 1; + u8 d_is_win32_name : 1; /* Temporary flag; always reset to 0 when done using. */ - u8 tmp_flag : 1; + u8 d_tmp_flag : 1; /* Used by wimlib_update_image() */ - u8 is_orphan : 1; + u8 d_is_orphan : 1; union { - /* 'subdir_offset' is only used while reading and writing this + /* The subdir offset is only used while reading and writing this * dentry. See the corresponding field in `struct * wim_dentry_on_disk' for explanation. */ - u64 subdir_offset; + u64 d_subdir_offset; /* Temporary list field */ - struct list_head tmp_list; + struct list_head d_tmp_list; }; /* Full path to this dentry in the WIM, in platform-dependent tchars * that can be printed without conversion. By default this field will * be NULL and will only be calculated on-demand by the * calculate_dentry_full_path() or dentry_full_path() functions. */ - tchar *_full_path; + tchar *d_full_path; /* (Extraction only) Actual name to extract this dentry as. This may be * either in 'tchars' or in 'utf16lechars', depending on what encoding - * the extraction backend needs. This may alias 'file_name'. If it + * the extraction backend needs. This may alias 'd_name'. If it * doesn't, it is an allocated buffer which must be freed. */ void *d_extraction_name; @@ -126,18 +114,12 @@ struct wim_dentry { * extracted as part of the current extraction operation. */ struct list_head d_extraction_list_node; - /* (Extraction only) Linked list node that connects all dentries being - * extracted as aliases of the same inode as part of the current - * extraction operation. */ - struct list_head d_extraction_alias_node; + /* (Extraction only) Pointer to the next alias for this dentry's inode + * that needs to be extracted as part of the current extraction + * operation, or NULL if this is the last alias. */ + struct wim_dentry *d_next_extraction_alias; }; -static inline bool -dentry_is_first_in_inode(const struct wim_dentry *dentry) -{ - return inode_first_dentry(dentry->d_inode) == dentry; -} - static inline bool will_extract_dentry(const struct wim_dentry *dentry) { @@ -231,13 +213,12 @@ extern tchar * dentry_full_path(struct wim_dentry *dentry); extern int -new_dentry(const tchar *name, struct wim_dentry **dentry_ret); - -extern int -new_dentry_with_inode(const tchar *name, struct wim_dentry **dentry_ret); +new_dentry_with_new_inode(const tchar *name, bool set_timestamps, + struct wim_dentry **dentry_ret); extern int -new_dentry_with_timeless_inode(const tchar *name, struct wim_dentry **dentry_ret); +new_dentry_with_existing_inode(const tchar *name, struct wim_inode *inode, + struct wim_dentry **dentry_ret); extern void dentry_tree_clear_inode_visited(struct wim_dentry *root); @@ -292,14 +273,14 @@ dentry_has_children(const struct wim_dentry *dentry) } static inline bool -dentry_has_short_name(const struct wim_dentry *dentry) +dentry_has_long_name(const struct wim_dentry *dentry) { - return dentry->short_name_nbytes != 0; + return dentry->d_name_nbytes != 0; } static inline bool -dentry_has_long_name(const struct wim_dentry *dentry) +dentry_has_short_name(const struct wim_dentry *dentry) { - return dentry->file_name_nbytes != 0; + return dentry->d_short_name_nbytes != 0; } #endif /* _WIMLIB_DENTRY_H */