]> wimlib.net Git - wimlib/blob - src/ntfs-3g_capture.c
avl_tree: Fix comments
[wimlib] / src / ntfs-3g_capture.c
1 /*
2  * ntfs-3g_capture.c
3  *
4  * Capture a WIM image directly from a NTFS volume using libntfs-3g.  We capture
5  * everything we can, including security data and alternate data streams.
6  */
7
8 /*
9  * Copyright (C) 2012, 2013, 2014 Eric Biggers
10  *
11  * This file is part of wimlib, a library for working with WIM files.
12  *
13  * wimlib is free software; you can redistribute it and/or modify it under the
14  * terms of the GNU General Public License as published by the Free
15  * Software Foundation; either version 3 of the License, or (at your option)
16  * any later version.
17  *
18  * wimlib is distributed in the hope that it will be useful, but WITHOUT ANY
19  * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
20  * A PARTICULAR PURPOSE. See the GNU General Public License for more
21  * details.
22  *
23  * You should have received a copy of the GNU General Public License
24  * along with wimlib; if not, see http://www.gnu.org/licenses/.
25  */
26
27 #ifdef HAVE_CONFIG_H
28 #  include "config.h"
29 #endif
30
31 #ifdef WITH_NTFS_3G
32
33 #include <errno.h>
34 #include <stdlib.h>
35
36 #ifdef HAVE_ALLOCA_H
37 #  include <alloca.h>
38 #endif
39
40 #include <ntfs-3g/attrib.h>
41 #include <ntfs-3g/reparse.h>
42 #include <ntfs-3g/security.h>
43 #include <ntfs-3g/volume.h>
44
45 #include "wimlib/capture.h"
46 #include "wimlib/dentry.h"
47 #include "wimlib/encoding.h"
48 #include "wimlib/endianness.h"
49 #include "wimlib/error.h"
50 #include "wimlib/lookup_table.h"
51 #include "wimlib/ntfs_3g.h"
52 #include "wimlib/paths.h"
53 #include "wimlib/security.h"
54
55 static inline ntfschar *
56 attr_record_name(ATTR_RECORD *ar)
57 {
58         return (ntfschar*)((u8*)ar + le16_to_cpu(ar->name_offset));
59 }
60
61 static ntfs_attr *
62 open_ntfs_attr(ntfs_inode *ni, struct ntfs_location *loc)
63 {
64         ntfs_attr *na;
65
66         na = ntfs_attr_open(ni,
67                             loc->is_reparse_point ? AT_REPARSE_POINT : AT_DATA,
68                             loc->stream_name,
69                             loc->stream_name_nchars);
70         if (!na) {
71                 ERROR_WITH_ERRNO("Failed to open attribute of \"%"TS"\" in "
72                                  "NTFS volume", loc->path);
73         }
74         return na;
75 }
76
77 int
78 read_ntfs_file_prefix(const struct wim_lookup_table_entry *lte, u64 size,
79                       consume_data_callback_t cb, void *cb_ctx)
80 {
81         struct ntfs_location *loc = lte->ntfs_loc;
82         ntfs_volume *vol = loc->ntfs_vol;
83         ntfs_inode *ni;
84         ntfs_attr *na;
85         s64 pos;
86         s64 bytes_remaining;
87         int ret;
88         u8 buf[BUFFER_SIZE];
89
90         ni = ntfs_pathname_to_inode(vol, NULL, loc->path);
91         if (!ni) {
92                 ERROR_WITH_ERRNO("Can't find NTFS inode for \"%"TS"\"", loc->path);
93                 ret = WIMLIB_ERR_NTFS_3G;
94                 goto out;
95         }
96
97         na = open_ntfs_attr(ni, loc);
98         if (!na) {
99                 ret = WIMLIB_ERR_NTFS_3G;
100                 goto out_close_ntfs_inode;
101         }
102
103         pos = (loc->is_reparse_point) ? 8 : 0;
104         bytes_remaining = size;
105         while (bytes_remaining) {
106                 s64 to_read = min(bytes_remaining, sizeof(buf));
107                 if (ntfs_attr_pread(na, pos, to_read, buf) != to_read) {
108                         ERROR_WITH_ERRNO("Error reading \"%"TS"\"", loc->path);
109                         ret = WIMLIB_ERR_NTFS_3G;
110                         goto out_close_ntfs_attr;
111                 }
112                 pos += to_read;
113                 bytes_remaining -= to_read;
114                 ret = cb(buf, to_read, cb_ctx);
115                 if (ret)
116                         goto out_close_ntfs_attr;
117         }
118         ret = 0;
119 out_close_ntfs_attr:
120         ntfs_attr_close(na);
121 out_close_ntfs_inode:
122         ntfs_inode_close(ni);
123 out:
124         return ret;
125 }
126
127 static int
128 read_reparse_tag(ntfs_inode *ni, struct ntfs_location *loc,
129                  u32 *reparse_tag_ret)
130 {
131         int ret;
132         le32 reparse_tag;
133         ntfs_attr *na;
134
135         na = open_ntfs_attr(ni, loc);
136         if (!na) {
137                 ret = WIMLIB_ERR_NTFS_3G;
138                 goto out;
139         }
140
141         if (ntfs_attr_pread(na, 0, sizeof(reparse_tag),
142                             &reparse_tag) != sizeof(reparse_tag))
143         {
144                 ERROR_WITH_ERRNO("Error reading reparse data");
145                 ret = WIMLIB_ERR_NTFS_3G;
146                 goto out_close_ntfs_attr;
147         }
148         *reparse_tag_ret = le32_to_cpu(reparse_tag);
149         DEBUG("ReparseTag = %#x", *reparse_tag_ret);
150         ret = 0;
151 out_close_ntfs_attr:
152         ntfs_attr_close(na);
153 out:
154         return ret;
155
156 }
157
158 /* Load the streams from a file or reparse point in the NTFS volume  */
159 static int
160 capture_ntfs_streams(struct wim_inode *inode,
161                      ntfs_inode *ni,
162                      char *path,
163                      size_t path_len,
164                      struct list_head *unhashed_streams,
165                      ntfs_volume *vol,
166                      ATTR_TYPES type)
167 {
168         ntfs_attr_search_ctx *actx;
169         struct ntfs_location *ntfs_loc;
170         int ret;
171         struct wim_lookup_table_entry *lte;
172
173         DEBUG("Capturing NTFS data streams from `%s'", path);
174
175         /* Get context to search the streams of the NTFS file. */
176         actx = ntfs_attr_get_search_ctx(ni, NULL);
177         if (!actx) {
178                 ERROR_WITH_ERRNO("Cannot get NTFS attribute search "
179                                  "context for \"%s\"", path);
180                 return WIMLIB_ERR_NTFS_3G;
181         }
182
183         /* Capture each data stream or reparse data stream. */
184         while (!ntfs_attr_lookup(type, NULL, 0,
185                                  CASE_SENSITIVE, 0, NULL, 0, actx))
186         {
187                 u64 data_size = ntfs_get_attribute_value_length(actx->attr);
188                 u64 name_length = actx->attr->name_length;
189                 u32 stream_id;
190
191                 if (data_size == 0) {
192                         /* Empty stream.  No lookup table entry is needed. */
193                         lte = NULL;
194                         ntfs_loc = NULL;
195                 } else {
196                         ntfs_loc = CALLOC(1, sizeof(*ntfs_loc));
197                         if (!ntfs_loc) {
198                                 ret = WIMLIB_ERR_NOMEM;
199                                 goto out_put_actx;
200                         }
201                         ntfs_loc->ntfs_vol = vol;
202                         ntfs_loc->path = memdup(path, path_len + 1);
203                         if (!ntfs_loc->path) {
204                                 ret = WIMLIB_ERR_NOMEM;
205                                 goto out_free_ntfs_loc;
206                         }
207                         if (name_length) {
208                                 ntfs_loc->stream_name = memdup(attr_record_name(actx->attr),
209                                                                name_length * 2);
210                                 if (!ntfs_loc->stream_name) {
211                                         ret = WIMLIB_ERR_NOMEM;
212                                         goto out_free_ntfs_loc;
213                                 }
214                                 ntfs_loc->stream_name_nchars = name_length;
215                         }
216
217                         lte = new_lookup_table_entry();
218                         if (!lte) {
219                                 ret = WIMLIB_ERR_NOMEM;
220                                 goto out_free_ntfs_loc;
221                         }
222                         lte->resource_location = RESOURCE_IN_NTFS_VOLUME;
223                         lte->ntfs_loc = ntfs_loc;
224                         ntfs_loc = NULL;
225                         if (type == AT_REPARSE_POINT) {
226                                 if (data_size < 8) {
227                                         ERROR("Invalid reparse data on \"%s\" "
228                                               "(only %u bytes)!", path, (unsigned)data_size);
229                                         ret = WIMLIB_ERR_NTFS_3G;
230                                         goto out_free_lte;
231                                 }
232                                 lte->ntfs_loc->is_reparse_point = true;
233                                 lte->size = data_size - 8;
234                                 ret = read_reparse_tag(ni, lte->ntfs_loc,
235                                                        &inode->i_reparse_tag);
236                                 if (ret)
237                                         goto out_free_lte;
238                         } else {
239                                 lte->ntfs_loc->is_reparse_point = false;
240                                 lte->size = data_size;
241                         }
242                 }
243                 if (name_length == 0) {
244                         /* Unnamed data stream.  Put the reference to it in the
245                          * dentry's inode. */
246                         if (inode->i_lte) {
247                                 if (lte) {
248                                         ERROR("Found two un-named data streams for \"%s\" "
249                                               "(sizes = %"PRIu64", %"PRIu64")",
250                                               path, inode->i_lte->size,
251                                               lte->size);
252                                         ret = WIMLIB_ERR_NTFS_3G;
253                                         goto out_free_lte;
254                                 }
255                         } else {
256                                 stream_id = 0;
257                                 inode->i_lte = lte;
258                         }
259                 } else {
260                         /* Named data stream.  Put the reference to it in the
261                          * alternate data stream entries */
262                         struct wim_ads_entry *new_ads_entry;
263
264                         new_ads_entry = inode_add_ads_utf16le(inode,
265                                                               attr_record_name(actx->attr),
266                                                               name_length * 2);
267                         if (!new_ads_entry) {
268                                 ret = WIMLIB_ERR_NOMEM;
269                                 goto out_free_lte;
270                         }
271                         wimlib_assert(new_ads_entry->stream_name_nbytes == name_length * 2);
272                         stream_id = new_ads_entry->stream_id;
273                         new_ads_entry->lte = lte;
274                 }
275                 if (lte) {
276                         add_unhashed_stream(lte, inode,
277                                             stream_id, unhashed_streams);
278                 }
279         }
280         if (errno == ENOENT) {
281                 ret = 0;
282         } else {
283                 ERROR_WITH_ERRNO("Error listing NTFS attributes of \"%s\"", path);
284                 ret = WIMLIB_ERR_NTFS_3G;
285         }
286         goto out_put_actx;
287 out_free_lte:
288         free_lookup_table_entry(lte);
289 out_free_ntfs_loc:
290         if (ntfs_loc) {
291                 FREE(ntfs_loc->path);
292                 FREE(ntfs_loc->stream_name);
293                 FREE(ntfs_loc);
294         }
295 out_put_actx:
296         ntfs_attr_put_search_ctx(actx);
297         if (ret == 0)
298                 DEBUG("Successfully captured NTFS streams from \"%s\"", path);
299         else
300                 ERROR("Failed to capture NTFS streams from \"%s\"", path);
301         return ret;
302 }
303
304 /* Binary tree that maps NTFS inode numbers to DOS names */
305 struct dos_name_map {
306         struct avl_tree_node *root;
307 };
308
309 struct dos_name_node {
310         struct avl_tree_node index_node;
311         char dos_name[24];
312         int name_nbytes;
313         le64 ntfs_ino;
314 };
315
316 #define DOS_NAME_NODE(avl_node) \
317         avl_tree_entry(avl_node, struct dos_name_node, index_node)
318
319 static int
320 _avl_cmp_by_ntfs_ino(const struct avl_tree_node *n1,
321                      const struct avl_tree_node *n2)
322 {
323         return cmp_u64(DOS_NAME_NODE(n1)->ntfs_ino,
324                        DOS_NAME_NODE(n2)->ntfs_ino);
325 }
326
327 /* Inserts a new DOS name into the map */
328 static int
329 insert_dos_name(struct dos_name_map *map, const ntfschar *dos_name,
330                 size_t name_nbytes, le64 ntfs_ino)
331 {
332         struct dos_name_node *new_node;
333
334         DEBUG("DOS name_len = %zu", name_nbytes);
335         new_node = MALLOC(sizeof(struct dos_name_node));
336         if (!new_node)
337                 return -1;
338
339         /* DOS names are supposed to be 12 characters max (that's 24 bytes,
340          * assuming 2-byte ntfs characters) */
341         wimlib_assert(name_nbytes <= sizeof(new_node->dos_name));
342
343         /* Initialize the DOS name, DOS name length, and NTFS inode number of
344          * the search tree node */
345         memcpy(new_node->dos_name, dos_name, name_nbytes);
346         new_node->name_nbytes = name_nbytes;
347         new_node->ntfs_ino = ntfs_ino;
348
349         /* Insert the search tree node */
350         if (avl_tree_insert(&map->root, &new_node->index_node,
351                             _avl_cmp_by_ntfs_ino))
352         {
353                 /* This should be impossible since a NTFS inode cannot
354                  * have multiple DOS names, and we only should get each
355                  * DOS name entry once from the ntfs_readdir() calls. */
356                 ERROR("NTFS inode %"PRIu64" has multiple DOS names",
357                         le64_to_cpu(ntfs_ino));
358                 FREE(new_node);
359                 return -1;
360         }
361         DEBUG("Inserted DOS name for inode %"PRIu64, le64_to_cpu(ntfs_ino));
362         return 0;
363 }
364
365 /* Returns a structure that contains the DOS name and its length for a NTFS
366  * inode, or NULL if the inode has no DOS name. */
367 static struct dos_name_node *
368 lookup_dos_name(const struct dos_name_map *map, u64 ntfs_ino)
369 {
370         struct dos_name_node dummy;
371         struct avl_tree_node *res;
372
373         dummy.ntfs_ino = cpu_to_le64(ntfs_ino);
374
375         res = avl_tree_lookup_node(map->root, &dummy.index_node,
376                                    _avl_cmp_by_ntfs_ino);
377         if (!res)
378                 return NULL;
379         return DOS_NAME_NODE(res);
380 }
381
382 static int
383 set_dentry_dos_name(struct wim_dentry *dentry, const struct dos_name_map *map)
384 {
385         const struct dos_name_node *node;
386
387         if (dentry->is_win32_name) {
388                 node = lookup_dos_name(map, dentry->d_inode->i_ino);
389                 if (node) {
390                         dentry->short_name = MALLOC(node->name_nbytes + 2);
391                         if (!dentry->short_name)
392                                 return WIMLIB_ERR_NOMEM;
393                         memcpy(dentry->short_name, node->dos_name,
394                                node->name_nbytes);
395                         dentry->short_name[node->name_nbytes / 2] = 0;
396                         dentry->short_name_nbytes = node->name_nbytes;
397                         DEBUG("Assigned DOS name to ino %"PRIu64,
398                               dentry->d_inode->i_ino);
399                 } else {
400                         WARNING("NTFS inode %"PRIu64" has Win32 name with no "
401                                 "corresponding DOS name",
402                                 dentry->d_inode->i_ino);
403                 }
404         }
405         return 0;
406 }
407
408 static void
409 free_dos_name_tree(struct avl_tree_node *node) {
410         if (node) {
411                 free_dos_name_tree(node->left);
412                 free_dos_name_tree(node->right);
413                 FREE(DOS_NAME_NODE(node));
414         }
415 }
416
417 static void
418 destroy_dos_name_map(struct dos_name_map *map)
419 {
420         free_dos_name_tree(map->root);
421 }
422
423 struct readdir_ctx {
424         struct wim_dentry *parent;
425         char *path;
426         size_t path_len;
427         struct dos_name_map *dos_name_map;
428         ntfs_volume *vol;
429         struct add_image_params *params;
430 };
431
432 static int
433 build_dentry_tree_ntfs_recursive(struct wim_dentry **root_p,
434                                  ntfs_inode *ni,
435                                  char *path,
436                                  size_t path_len,
437                                  int name_type,
438                                  ntfs_volume *ntfs_vol,
439                                  struct add_image_params *params);
440
441 static int
442 wim_ntfs_capture_filldir(void *dirent, const ntfschar *name,
443                          const int name_nchars, const int name_type,
444                          const s64 pos, const MFT_REF mref,
445                          const unsigned dt_type)
446 {
447         struct readdir_ctx *ctx;
448         size_t mbs_name_nbytes;
449         char *mbs_name;
450         struct wim_dentry *child;
451         int ret;
452         size_t path_len;
453         size_t name_nbytes = name_nchars * sizeof(ntfschar);
454
455         ctx = dirent;
456         if (name_type & FILE_NAME_DOS) {
457                 /* If this is the entry for a DOS name, store it for later. */
458                 ret = insert_dos_name(ctx->dos_name_map, name,
459                                       name_nbytes, mref & MFT_REF_MASK_CPU);
460
461                 /* Return now if an error occurred or if this is just a DOS name
462                  * and not a Win32+DOS name. */
463                 if (ret != 0 || name_type == FILE_NAME_DOS)
464                         goto out;
465         }
466         ret = utf16le_to_tstr(name, name_nbytes,
467                               &mbs_name, &mbs_name_nbytes);
468         if (ret)
469                 goto out;
470
471         if (mbs_name[0] == '.' &&
472              (mbs_name[1] == '\0' ||
473               (mbs_name[1] == '.' && mbs_name[2] == '\0'))) {
474                 /* . or .. entries
475                  *
476                  * note: name_type is POSIX for these, so DOS names will not
477                  * have been inserted for them.  */
478                 ret = 0;
479                 goto out_free_mbs_name;
480         }
481
482         /* Open the inode for this directory entry and recursively capture the
483          * directory tree rooted at it */
484         ntfs_inode *ni = ntfs_inode_open(ctx->vol, mref);
485         if (!ni) {
486                 /* XXX This used to be treated as an error, but NTFS-3g seemed
487                  * to be unable to read some inodes on a Windows 8 image for
488                  * some reason. */
489                 WARNING_WITH_ERRNO("Failed to open NTFS file \"%s/%s\"",
490                                    ctx->path, mbs_name);
491                 ret = 0;
492                 goto out_free_mbs_name;
493         }
494         path_len = ctx->path_len;
495         if (path_len != 1)
496                 ctx->path[path_len++] = '/';
497         memcpy(ctx->path + path_len, mbs_name, mbs_name_nbytes + 1);
498         path_len += mbs_name_nbytes;
499         child = NULL;
500         ret = build_dentry_tree_ntfs_recursive(&child, ni, ctx->path,
501                                                path_len, name_type,
502                                                ctx->vol, ctx->params);
503         path_len -= mbs_name_nbytes + 1;
504         if (child)
505                 dentry_add_child(ctx->parent, child);
506         ntfs_inode_close(ni);
507 out_free_mbs_name:
508         FREE(mbs_name);
509 out:
510         ctx->path[ctx->path_len] = '\0';
511         return ret;
512 }
513
514 /* Recursively build a WIM dentry tree corresponding to a NTFS volume.
515  * At the same time, update the WIM lookup table with lookup table entries for
516  * the NTFS streams, and build an array of security descriptors.
517  */
518 static int
519 build_dentry_tree_ntfs_recursive(struct wim_dentry **root_ret,
520                                  ntfs_inode *ni,
521                                  char *path,
522                                  size_t path_len,
523                                  int name_type,
524                                  ntfs_volume *vol,
525                                  struct add_image_params *params)
526 {
527         le32 attributes;
528         int ret;
529         struct wim_dentry *root = NULL;
530         struct wim_inode *inode = NULL;
531         ATTR_TYPES stream_type;
532
533         if (exclude_path(path, path_len, params->config, false)) {
534                 /* Exclude a file or directory tree based on the capture
535                  * configuration file.  */
536                 ret = 0;
537                 goto out_progress;
538         }
539
540         /* Get file attributes */
541         ret = ntfs_get_ntfs_attrib(ni, (char*)&attributes, sizeof(attributes));
542         if (ret != sizeof(attributes)) {
543                 ERROR_WITH_ERRNO("Failed to get NTFS attributes from \"%s\"", path);
544                 ret = WIMLIB_ERR_NTFS_3G;
545                 goto out;
546         }
547
548         if ((attributes & (FILE_ATTRIBUTE_DIRECTORY |
549                            FILE_ATTRIBUTE_ENCRYPTED)) == FILE_ATTRIBUTE_ENCRYPTED)
550         {
551                 if (params->add_flags & WIMLIB_ADD_FLAG_NO_UNSUPPORTED_EXCLUDE)
552                 {
553                         ERROR("Can't archive unsupported encrypted file \"%s\"", path);
554                         ret = WIMLIB_ERR_UNSUPPORTED_FILE;
555                         goto out;
556                 }
557                 params->progress.scan.cur_path = path;
558                 do_capture_progress(params, WIMLIB_SCAN_DENTRY_UNSUPPORTED, NULL);
559                 ret = 0;
560                 goto out;
561         }
562
563         /* Create a WIM dentry with an associated inode, which may be shared */
564         ret = inode_table_new_dentry(&params->inode_table,
565                                      path_basename_with_len(path, path_len),
566                                      ni->mft_no, 0, false, &root);
567         if (ret)
568                 goto out;
569
570         if (name_type & FILE_NAME_WIN32) /* Win32 or Win32+DOS name (rather than POSIX) */
571                 root->is_win32_name = 1;
572
573         inode = root->d_inode;
574
575         if (inode->i_nlink > 1) {
576                 /* Shared inode; nothing more to do */
577                 ret = 0;
578                 goto out_progress;
579         }
580
581         inode->i_creation_time    = le64_to_cpu(ni->creation_time);
582         inode->i_last_write_time  = le64_to_cpu(ni->last_data_change_time);
583         inode->i_last_access_time = le64_to_cpu(ni->last_access_time);
584         inode->i_attributes       = le32_to_cpu(attributes);
585         inode->i_resolved         = 1;
586
587         if (attributes & FILE_ATTR_REPARSE_POINT)
588                 stream_type = AT_REPARSE_POINT;
589         else
590                 stream_type = AT_DATA;
591
592         /* Capture the file's streams; more specifically, this is supposed to:
593          *
594          * - Regular files: capture unnamed data stream and any named data
595          *   streams
596          * - Directories: capture any named data streams
597          * - Reparse points: capture reparse data only
598          */
599         ret = capture_ntfs_streams(inode, ni, path, path_len,
600                                    params->unhashed_streams, vol, stream_type);
601         if (ret)
602                 goto out;
603
604         if (ni->mrec->flags & MFT_RECORD_IS_DIRECTORY) {
605
606                 /* Recurse to directory children */
607                 s64 pos = 0;
608                 struct dos_name_map dos_name_map = { .root = NULL };
609                 struct readdir_ctx ctx = {
610                         .parent          = root,
611                         .path            = path,
612                         .path_len        = path_len,
613                         .dos_name_map    = &dos_name_map,
614                         .vol             = vol,
615                         .params          = params,
616                 };
617                 ret = ntfs_readdir(ni, &pos, &ctx, wim_ntfs_capture_filldir);
618                 if (ret) {
619                         ERROR_WITH_ERRNO("Error reading directory \"%s\"", path);
620                         ret = WIMLIB_ERR_NTFS_3G;
621                 } else {
622                         struct wim_dentry *child;
623
624                         ret = 0;
625                         for_dentry_child(child, root) {
626                                 ret = set_dentry_dos_name(child, &dos_name_map);
627                                 if (ret)
628                                         break;
629                         }
630                 }
631                 destroy_dos_name_map(&dos_name_map);
632                 if (ret)
633                         goto out;
634         }
635         path[path_len] = '\0';
636
637         /* Reparse-point fixups are a no-op because in NTFS-3g capture mode we
638          * only allow capturing an entire volume. */
639         if (params->add_flags & WIMLIB_ADD_FLAG_RPFIX &&
640             inode_is_symlink(inode))
641                 inode->i_not_rpfixed = 0;
642
643         if (!(params->add_flags & WIMLIB_ADD_FLAG_NO_ACLS)) {
644                 struct SECURITY_CONTEXT sec_ctx;
645                 char _sd[4096];
646                 char *sd;
647
648                 /* Get security descriptor */
649                 memset(&sec_ctx, 0, sizeof(sec_ctx));
650                 sec_ctx.vol = vol;
651
652                 errno = 0;
653                 sd = _sd;
654                 ret = ntfs_get_ntfs_acl(&sec_ctx, ni, sd, sizeof(_sd));
655                 if (ret > sizeof(_sd)) {
656                         sd = alloca(ret);
657                         ret = ntfs_get_ntfs_acl(&sec_ctx, ni, sd, ret);
658                 }
659                 if (ret > 0) {
660                         inode->i_security_id = sd_set_add_sd(&params->sd_set,
661                                                              sd, ret);
662                         if (inode->i_security_id == -1) {
663                                 ERROR("Out of memory");
664                                 ret = WIMLIB_ERR_NOMEM;
665                                 goto out;
666                         }
667                         DEBUG("Added security ID = %u for `%s'",
668                               inode->i_security_id, path);
669                         ret = 0;
670                 } else if (ret < 0) {
671                         ERROR_WITH_ERRNO("Failed to get security information from "
672                                          "`%s'", path);
673                         ret = WIMLIB_ERR_NTFS_3G;
674                 } else {
675                         inode->i_security_id = -1;
676                         DEBUG("No security ID for `%s'", path);
677                 }
678         }
679         if (ret)
680                 goto out;
681
682 out_progress:
683         params->progress.scan.cur_path = path;
684         if (root == NULL)
685                 do_capture_progress(params, WIMLIB_SCAN_DENTRY_EXCLUDED, NULL);
686         else
687                 do_capture_progress(params, WIMLIB_SCAN_DENTRY_OK, inode);
688 out:
689         if (ret == 0)
690                 *root_ret = root;
691         else
692                 free_dentry_tree(root, params->lookup_table);
693         return ret;
694 }
695
696
697 int
698 do_ntfs_umount(struct _ntfs_volume *vol)
699 {
700         DEBUG("Unmounting NTFS volume");
701         if (ntfs_umount(vol, FALSE))
702                 return WIMLIB_ERR_NTFS_3G;
703         else
704                 return 0;
705 }
706
707 int
708 build_dentry_tree_ntfs(struct wim_dentry **root_p,
709                        const char *device,
710                        struct add_image_params *params)
711 {
712         ntfs_volume *vol;
713         ntfs_inode *root_ni;
714         int ret;
715
716         DEBUG("Mounting NTFS volume `%s' read-only", device);
717
718 /* NTFS-3g 2013 renamed the "read-only" mount flag from MS_RDONLY to
719  * NTFS_MNT_RDONLY.
720  *
721  * Unfortunately we can't check for defined(NTFS_MNT_RDONLY) because
722  * NTFS_MNT_RDONLY is an enumerated constant.  Also, the NTFS-3g headers don't
723  * seem to contain any explicit version information.  So we have to rely on a
724  * test done at configure time to detect whether NTFS_MNT_RDONLY should be used.
725  * */
726 #ifdef HAVE_NTFS_MNT_RDONLY
727         /* NTFS-3g 2013 */
728         vol = ntfs_mount(device, NTFS_MNT_RDONLY);
729 #elif defined(MS_RDONLY)
730         /* NTFS-3g 2011, 2012 */
731         vol = ntfs_mount(device, MS_RDONLY);
732 #else
733   #error "Can't find NTFS_MNT_RDONLY or MS_RDONLY flags"
734 #endif
735         if (!vol) {
736                 ERROR_WITH_ERRNO("Failed to mount NTFS volume `%s' read-only",
737                                  device);
738                 return WIMLIB_ERR_NTFS_3G;
739         }
740         ntfs_open_secure(vol);
741
742         /* We don't want to capture the special NTFS files such as $Bitmap.  Not
743          * to be confused with "hidden" or "system" files which are real files
744          * that we do need to capture.  */
745         NVolClearShowSysFiles(vol);
746
747         DEBUG("Opening root NTFS dentry");
748         root_ni = ntfs_inode_open(vol, FILE_root);
749         if (!root_ni) {
750                 ERROR_WITH_ERRNO("Failed to open root inode of NTFS volume "
751                                  "`%s'", device);
752                 ret = WIMLIB_ERR_NTFS_3G;
753                 goto out;
754         }
755
756         /* Currently we assume that all the paths fit into this length and there
757          * is no check for overflow. */
758         char *path = MALLOC(32768);
759         if (!path) {
760                 ERROR("Could not allocate memory for NTFS pathname");
761                 ret = WIMLIB_ERR_NOMEM;
762                 goto out_cleanup;
763         }
764
765         path[0] = '/';
766         path[1] = '\0';
767         ret = build_dentry_tree_ntfs_recursive(root_p, root_ni, path, 1,
768                                                FILE_NAME_POSIX, vol, params);
769 out_cleanup:
770         FREE(path);
771         ntfs_inode_close(root_ni);
772 out:
773         ntfs_index_ctx_put(vol->secure_xsii);
774         ntfs_index_ctx_put(vol->secure_xsdh);
775         ntfs_inode_close(vol->secure_ni);
776
777         if (ret) {
778                 if (do_ntfs_umount(vol)) {
779                         ERROR_WITH_ERRNO("Failed to unmount NTFS volume `%s'",
780                                          device);
781                         if (ret == 0)
782                                 ret = WIMLIB_ERR_NTFS_3G;
783                 }
784         } else {
785                 /* We need to leave the NTFS volume mounted so that we can read
786                  * the NTFS files again when we are actually writing the WIM */
787                 *(ntfs_volume**)params->extra_arg = vol;
788         }
789         return ret;
790 }
791 #endif /* WITH_NTFS_3G */