]> wimlib.net Git - wimlib/blobdiff - src/extract_image.c
Update Win32 support; inc version to 1.3.0
[wimlib] / src / extract_image.c
index 8d21edaca0cafa3a108ab83bbe2747e9b1e07916..6735602f495d489a545598bddd85a3efe6060265 100644 (file)
@@ -32,9 +32,9 @@
 
 #if defined(__CYGWIN__) || defined(__WIN32__)
 #include <windows.h>
-#      ifdef ERROR
-#              undef ERROR
-#      endif
+#ifdef ERROR
+#undef ERROR
+#endif
 #include <wchar.h>
 #endif
 
 static int win32_set_reparse_data(HANDLE h,
                                  u32 reparse_tag,
                                  const struct wim_lookup_table_entry *lte,
-                                 const wchar_t *path,
-                                 const char *path_utf8)
+                                 const wchar_t *path)
 {
        int ret;
        u8 *buf;
        size_t len;
-       
+
        if (!lte) {
-               WARNING("\"%s\" is marked as a reparse point but had no reparse data",
-                       path_utf8);
+               WARNING("\"%ls\" is marked as a reparse point but had no reparse data",
+                       path);
                return 0;
        }
        len = wim_resource_size(lte);
        if (len > 16 * 1024 - 8) {
-               WARNING("\"%s\": reparse data too long!", path_utf8);
+               WARNING("\"%ls\": reparse data too long!", path);
                return 0;
        }
+
+       /* The WIM stream omits the ReparseTag and ReparseDataLength fields, so
+        * leave 8 bytes of space for them at the beginning of the buffer, then
+        * set them manually. */
        buf = alloca(len + 8);
        ret = read_full_wim_resource(lte, buf + 8, 0);
        if (ret)
                return ret;
        *(u32*)(buf + 0) = reparse_tag;
        *(u16*)(buf + 4) = len;
+       *(u16*)(buf + 6) = 0;
+
+       /* Set the reparse data on the open file using the
+        * FSCTL_SET_REPARSE_POINT ioctl.
+        *
+        * There are contradictions in Microsoft's documentation for this:
+        *
+        * "If hDevice was opened without specifying FILE_FLAG_OVERLAPPED,
+        * lpOverlapped is ignored."
+        *
+        * --- So setting lpOverlapped to NULL is okay since it's ignored.
+        *
+        * "If lpOverlapped is NULL, lpBytesReturned cannot be NULL. Even when an
+        * operation returns no output data and lpOutBuffer is NULL,
+        * DeviceIoControl makes use of lpBytesReturned. After such an
+        * operation, the value of lpBytesReturned is meaningless."
+        *
+        * --- So lpOverlapped not really ignored, as it affects another
+        *  parameter.  This is the actual behavior: lpBytesReturned must be
+        *  specified, even though lpBytesReturned is documented as:
+        *
+        *  "Not used with this operation; set to NULL."
+        */
+       DWORD bytesReturned;
        if (!DeviceIoControl(h, FSCTL_SET_REPARSE_POINT, buf, len + 8,
-                            NULL, 0, NULL, NULL))
+                            NULL, 0,
+                            &bytesReturned /* lpBytesReturned */,
+                            NULL /* lpOverlapped */))
        {
                DWORD err = GetLastError();
-               ERROR("Failed to set reparse data on \"%s\"",
-                     path_utf8);
+               ERROR("Failed to set reparse data on \"%ls\"", path);
                win32_error(err);
-               ret = WIMLIB_ERR_WRITE;
-       } else
-               ret = 0;
-       return ret;
+               return WIMLIB_ERR_WRITE;
+       }
+       return 0;
 }
 
 
@@ -137,8 +164,7 @@ static int do_win32_extract_stream(HANDLE hStream, struct wim_lookup_table_entry
 static int win32_extract_stream(const struct wim_inode *inode,
                                const wchar_t *path,
                                const wchar_t *stream_name_utf16,
-                               struct wim_lookup_table_entry *lte,
-                               const char *path_utf8)
+                               struct wim_lookup_table_entry *lte)
 {
        wchar_t *stream_path;
        HANDLE h;
@@ -147,42 +173,59 @@ static int win32_extract_stream(const struct wim_inode *inode,
        DWORD creationDisposition = CREATE_ALWAYS;
 
        if (stream_name_utf16) {
+               /* Named stream.  Create a buffer that contains the UTF-16LE
+                * string [./]@path:@stream_name_utf16.  This is needed to
+                * create and open the stream using CreateFileW().  I'm not
+                * aware of any other APIs to do this.  Note: note that the
+                * '$DATA' suffix seems to be unneeded; Additional note: a "./"
+                * prefix needs to be added when the path is not absolute to
+                * avoid ambiguity with drive letters. */
                size_t stream_path_nchars;
-               size_t path_nchars = wcslen(path);
-               size_t stream_name_nchars = wcslen(stream_name_utf16);
+               size_t path_nchars;
+               size_t stream_name_nchars;
+               const wchar_t *prefix;
 
+               path_nchars = wcslen(path);
+               stream_name_nchars = wcslen(stream_name_utf16);
                stream_path_nchars = path_nchars + 1 + stream_name_nchars;
-
+               if (path[0] != L'/' && path[1] != L'\\') {
+                       prefix = L"./";
+                       stream_path_nchars += 2;
+               } else {
+                       prefix = L"";
+               }
                stream_path = alloca((stream_path_nchars + 1) * sizeof(wchar_t));
-
-               memcpy(stream_path, path, path_nchars * sizeof(wchar_t));
-               stream_path[path_nchars] = L':';
-               memcpy(&stream_path[path_nchars + 1], stream_name_utf16,
-                      stream_name_nchars * sizeof(wchar_t));
-               stream_path[stream_path_nchars] = L'\0';
-
-               /*wsprintf(stream_path, stream_path_nchars, L"%ls:%ls",*/
-                        /*path, stream_name_utf16);*/
+               swprintf(stream_path, stream_path_nchars + 1, L"%ls%ls:%ls",
+                        prefix, path, stream_name_utf16);
        } else {
+               /* Unnamed stream; it's path is just the path to the file
+                * itself. */
                stream_path = (wchar_t*)path;
+
+               /* Directories must be created with CreateDirectoryW().  Then
+                * the call to CreateFileW() will merely open the directory that
+                * was already created rather than creating a new file. */
                if (inode->i_attributes & FILE_ATTRIBUTE_DIRECTORY) {
                        if (!CreateDirectoryW(stream_path, NULL)) {
                                err = GetLastError();
-                               if (err == ERROR_FILE_EXISTS &&
-                                   dentry_is_root(inode_first_dentry(inode)))
-                               {
-                                       /* Already exists */
-                                       return 0;
+                               if (err != ERROR_ALREADY_EXISTS) {
+                                       ERROR("Failed to create directory \"%ls\"",
+                                             path);
+                                       win32_error(err);
+                                       ret = WIMLIB_ERR_MKDIR;
+                                       goto fail;
                                }
-                               ERROR("Failed to create directory \"%s\"", path_utf8);
-                               win32_error(err);
-                               ret = WIMLIB_ERR_MKDIR;
-                               goto fail;
+                       }
+                       DEBUG("Created directory \"%ls\"", stream_path);
+                       if (!(inode->i_attributes & FILE_ATTRIBUTE_REPARSE_POINT)) {
+                               ret = 0;
+                               goto out;
                        }
                        creationDisposition = OPEN_EXISTING;
                }
        }
 
+       DEBUG("Opening \"%ls\"", stream_path);
        h = CreateFileW(stream_path,
                        GENERIC_WRITE | WRITE_OWNER | WRITE_DAC,
                        0,
@@ -194,37 +237,33 @@ static int win32_extract_stream(const struct wim_inode *inode,
                        NULL);
        if (h == INVALID_HANDLE_VALUE) {
                err = GetLastError();
-               if (err == ERROR_FILE_EXISTS &&
-                   dentry_is_root(inode_first_dentry(inode)))
-               {
-                       /* Already exists */
-                       return 0;
-               }
-               ERROR("Failed to create \"%s\"", path_utf8);
+               ERROR("Failed to create \"%ls\"", stream_path);
                win32_error(err);
                ret = WIMLIB_ERR_OPEN;
                goto fail;
        }
 
-       if (inode->i_attributes & FILE_ATTRIBUTE_REPARSE_POINT) {
-               DEBUG("Setting reparse data on \"%s\"", path_utf8);
-               ret = win32_set_reparse_data(h, inode->i_reparse_tag,
-                                            lte, path, path_utf8);
+       if (inode->i_attributes & FILE_ATTRIBUTE_REPARSE_POINT &&
+           stream_name_utf16 == NULL)
+       {
+               DEBUG("Setting reparse data on \"%ls\"", path);
+               ret = win32_set_reparse_data(h, inode->i_reparse_tag, lte, path);
                if (ret)
                        goto fail_close_handle;
        } else {
                if (lte) {
-                       DEBUG("Extracting stream for \"%s\" (len = %zu)",
-                             path_utf8, wim_resource_size(lte));
+                       DEBUG("Extracting \"%ls\" (len = %zu)",
+                             stream_path, wim_resource_size(lte));
                        ret = do_win32_extract_stream(h, lte);
                        if (ret)
                                goto fail_close_handle;
                }
        }
 
+       DEBUG("Closing \"%ls\"", stream_path);
        if (!CloseHandle(h)) {
                err = GetLastError();
-               ERROR("Failed to close \"%s\"", path_utf8);
+               ERROR("Failed to close \"%ls\"", stream_path);
                win32_error(err);
                ret = WIMLIB_ERR_WRITE;
                goto fail;
@@ -234,43 +273,67 @@ static int win32_extract_stream(const struct wim_inode *inode,
 fail_close_handle:
        CloseHandle(h);
 fail:
-       ERROR("Error extracting %s", path_utf8);
+       ERROR("Error extracting %ls", stream_path);
 out:
        return ret;
 }
 
+/*
+ * Creates a file, directory, or reparse point and extracts all streams to it
+ * (unnamed data stream and/or reparse point stream, plus any alternate data
+ * streams).  This in Win32-specific code.
+ *
+ * @inode:     WIM inode for this file or directory.
+ * @path:      UTF-16LE external path to extract the inode to.
+ *
+ * Returns 0 on success; nonzero on failure.
+ */
 static int win32_extract_streams(struct wim_inode *inode,
-                                const wchar_t *path,
-                                const char *path_utf8)
+                                const wchar_t *path)
 {
        struct wim_lookup_table_entry *unnamed_lte;
        int ret;
 
-       ret = win32_extract_stream(inode, path, NULL, unnamed_lte, path_utf8);
+       unnamed_lte = inode_unnamed_lte_resolved(inode);
+       ret = win32_extract_stream(inode, path, NULL, unnamed_lte);
        if (ret)
                goto out;
-
        for (u16 i = 0; i < inode->i_num_ads; i++) {
                const struct wim_ads_entry *ads_entry = &inode->i_ads_entries[i];
                if (ads_entry->stream_name_len != 0) {
+                       /* Skip special UNIX data entries (see documentation for
+                        * WIMLIB_ADD_IMAGE_FLAG_UNIX_DATA) */
+                       if (ads_entry->stream_name_len == WIMLIB_UNIX_DATA_TAG_LEN
+                           && !memcmp(ads_entry->stream_name_utf8,
+                                      WIMLIB_UNIX_DATA_TAG,
+                                      WIMLIB_UNIX_DATA_TAG_LEN))
+                               continue;
                        ret = win32_extract_stream(inode,
                                                   path,
                                                   (const wchar_t*)ads_entry->stream_name,
-                                                  ads_entry->lte,
-                                                  path_utf8);
+                                                  ads_entry->lte);
                        if (ret)
-                               goto out;
+                               break;
                }
        }
-       ret = 0;
 out:
        return ret;
 }
 
+/*
+ * Sets the security descriptor on an extracted file.  This is Win32-specific
+ * code.
+ *
+ * @inode:     The WIM inode that was extracted and has a security descriptor.
+ * @path:      UTF-16LE external path that the inode was extracted to.
+ * @sd:                Security data for the WIM image.
+ * @path_utf8:  @path in UTF-8 for error messages only.
+ *
+ * Returns 0 on success; nonzero on failure.
+ */
 static int win32_set_security_data(const struct wim_inode *inode,
                                   const wchar_t *path,
-                                  const struct wim_security_data *sd,
-                                  const char *path_utf8)
+                                  const struct wim_security_data *sd)
 {
        SECURITY_INFORMATION securityInformation = DACL_SECURITY_INFORMATION |
                                                   SACL_SECURITY_INFORMATION |
@@ -280,7 +343,7 @@ static int win32_set_security_data(const struct wim_inode *inode,
                              (PSECURITY_DESCRIPTOR)sd->descriptors[inode->i_security_id]))
        {
                DWORD err = GetLastError();
-               ERROR("Can't set security descriptor on \"%s\"", path_utf8);
+               ERROR("Can't set security descriptor on \"%ls\"", path);
                win32_error(err);
                return WIMLIB_ERR_WRITE;
        }
@@ -632,49 +695,50 @@ static int apply_dentry_normal(struct wim_dentry *dentry, void *arg)
                return ret;
 
        if (inode->i_nlink > 1 && inode->i_extracted_file != NULL) {
-               /* Linked file, with another name already extracted */
-               if (!CreateHardLinkW((const wchar_t*)inode->i_extracted_file,
-                                    (const wchar_t*)utf16_path,
+               /* Linked file, with another name already extracted.  Create a
+                * hard link. */
+               DEBUG("Creating hard link \"%ls => %ls\"",
+                     (const wchar_t*)utf16_path,
+                     (const wchar_t*)inode->i_extracted_file);
+               if (!CreateHardLinkW((const wchar_t*)utf16_path,
+                                    (const wchar_t*)inode->i_extracted_file,
                                     NULL))
                {
                        err = GetLastError();
-                       ERROR("Can't create hard link \"%s\"", output_path);
+                       ERROR("Can't create hard link \"%ls => %ls\"",
+                             (const wchar_t*)utf16_path,
+                             (const wchar_t*)inode->i_extracted_file);
                        ret = WIMLIB_ERR_LINK;
                        win32_error(err);
-                       goto out_free_utf16_path;
                }
-               ret = 0;
-               goto out_free_utf16_path;
-       }
-       ret = win32_extract_streams(inode, (const wchar_t*)utf16_path,
-                                   output_path);
-       if (ret)
-               goto out_free_utf16_path;
-
-       if (inode->i_security_id != -1) {
-               DEBUG("Setting security descriptor %d on %s",
-                     inode->i_security_id, output_path);
-               ret = win32_set_security_data(inode,
-                                             (const wchar_t*)utf16_path,
-                                             wim_const_security_data(args->w),
-                                             output_path);
+       } else {
+               /* Create the file, directory, or reparse point, and extract the
+                * data streams. */
+               ret = win32_extract_streams(inode, (const wchar_t*)utf16_path);
                if (ret)
                        goto out_free_utf16_path;
-       }
-
-       /*if (inode->i_attributes & FILE_ATTRIBUTE_REPARSE_POINT) {*/
-               /*ret = win32_set_reparse_data(inode, path, output_path);*/
-               /*if (ret)*/
-                       /*goto out_free_utf16_path;*/
-       /*}*/
 
-       if (inode->i_nlink > 1) {
-               inode->i_extracted_file = utf16_path;
-               utf16_path = NULL;
+               /* Set security descriptor if present */
+               if (inode->i_security_id != -1) {
+                       DEBUG("Setting security descriptor %d on %s",
+                             inode->i_security_id, output_path);
+                       ret = win32_set_security_data(inode,
+                                                     (const wchar_t*)utf16_path,
+                                                     wim_const_security_data(args->w));
+                       if (ret)
+                               goto out_free_utf16_path;
+               }
+               if (inode->i_nlink > 1) {
+                       /* Save extracted path for a later call to
+                        * CreateHardLinkW() if this inode has multiple links.
+                        * */
+                       inode->i_extracted_file = utf16_path;
+                       goto out;
+               }
        }
-       ret = 0;
 out_free_utf16_path:
        FREE(utf16_path);
+out:
        return ret;
 #else
        if (inode_is_symlink(inode))
@@ -692,14 +756,21 @@ out_free_utf16_path:
 static int apply_dentry_timestamps_normal(struct wim_dentry *dentry, void *arg)
 {
        struct apply_args *args = arg;
-       size_t len = strlen(args->target);
-       char output_path[len + dentry->full_path_utf8_len + 1];
-       const struct wim_inode *inode = dentry->d_inode;
+       size_t len;
+       char *output_path;
        int ret;
+       const struct wim_inode *inode = dentry->d_inode;
 
-       memcpy(output_path, args->target, len);
-       memcpy(output_path + len, dentry->full_path_utf8, dentry->full_path_utf8_len);
-       output_path[len + dentry->full_path_utf8_len] = '\0';
+       len = strlen(args->target);
+       if (dentry_is_root(dentry)) {
+               output_path = (char*)args->target;
+       } else {
+               output_path = alloca(len + dentry->full_path_utf8_len + 1);
+               memcpy(output_path, args->target, len);
+               memcpy(output_path + len, dentry->full_path_utf8, dentry->full_path_utf8_len);
+               output_path[len + dentry->full_path_utf8_len] = '\0';
+               len += dentry->full_path_utf8_len;
+       }
 
 #if defined(__CYGWIN__) || defined(__WIN32__)
        /* Win32 */
@@ -709,13 +780,15 @@ static int apply_dentry_timestamps_normal(struct wim_dentry *dentry, void *arg)
        HANDLE h;
        BOOL bret1, bret2;
 
-       ret = utf8_to_utf16(output_path, len + dentry->full_path_utf8_len,
-                           &utf16_path, &utf16_path_len);
+       ret = utf8_to_utf16(output_path, len, &utf16_path, &utf16_path_len);
        if (ret)
                return ret;
-       h = CreateFile(utf16_path, GENERIC_WRITE, 0, NULL, OPEN_EXISTING,
-                      FILE_FLAG_BACKUP_SEMANTICS | FILE_FLAG_OPEN_REPARSE_POINT,
-                      NULL);
+
+       DEBUG("Opening \"%ls\" to set timestamps", utf16_path);
+       h = CreateFileW(utf16_path, GENERIC_WRITE, FILE_SHARE_READ,
+                       NULL, OPEN_EXISTING,
+                       FILE_FLAG_BACKUP_SEMANTICS | FILE_FLAG_OPEN_REPARSE_POINT,
+                       NULL);
 
        if (h == INVALID_HANDLE_VALUE)
                err = GetLastError();
@@ -730,18 +803,19 @@ static int apply_dentry_timestamps_normal(struct wim_dentry *dentry, void *arg)
        FILETIME lastWriteTime = {.dwLowDateTime = dentry->d_inode->i_last_write_time & 0xffffffff,
                                  .dwHighDateTime = dentry->d_inode->i_last_write_time >> 32};
 
+       DEBUG("Calling SetFileTime() on \"%s\"", output_path);
        if (!SetFileTime(h, &creationTime, &lastAccessTime, &lastWriteTime)) {
                err = GetLastError();
                CloseHandle(h);
                goto fail;
        }
+       DEBUG("Closing \"%s\"", output_path);
        if (!CloseHandle(h)) {
                err = GetLastError();
                goto fail;
        }
        return 0;
 fail:
-       err = GetLastError();
        ERROR("Can't set timestamps on \"%s\"", output_path);
        win32_error(err);
        return WIMLIB_ERR_WRITE;