]> wimlib.net Git - wimlib/blobdiff - programs/imagex.c
wimlib-imagex: remove old --pack-* option aliases for --solid-*
[wimlib] / programs / imagex.c
index 556006f6e82b4ea61551c805aa6b2bd9b0919c48..fdd35c8072b089b19b6793da3d16a78ad60a3cb0 100644 (file)
@@ -6,7 +6,7 @@
  */
 
 /*
- * Copyright (C) 2012, 2013, 2014, 2015 Eric Biggers
+ * Copyright (C) 2012-2016 Eric Biggers
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -160,6 +160,7 @@ enum {
        IMAGEX_FLAGS_OPTION,
        IMAGEX_FORCE_OPTION,
        IMAGEX_HEADER_OPTION,
+       IMAGEX_IMAGE_PROPERTY_OPTION,
        IMAGEX_INCLUDE_INVALID_NAMES_OPTION,
        IMAGEX_LAZY_OPTION,
        IMAGEX_METADATA_OPTION,
@@ -181,8 +182,8 @@ enum {
        IMAGEX_RECOMPRESS_OPTION,
        IMAGEX_RECURSIVE_OPTION,
        IMAGEX_REF_OPTION,
-       IMAGEX_RESUME_OPTION,
        IMAGEX_RPFIX_OPTION,
+       IMAGEX_SNAPSHOT_OPTION,
        IMAGEX_SOFT_OPTION,
        IMAGEX_SOLID_CHUNK_SIZE_OPTION,
        IMAGEX_SOLID_COMPRESS_OPTION,
@@ -194,6 +195,7 @@ enum {
        IMAGEX_THREADS_OPTION,
        IMAGEX_TO_STDOUT_OPTION,
        IMAGEX_UNIX_DATA_OPTION,
+       IMAGEX_UNSAFE_COMPACT_OPTION,
        IMAGEX_UPDATE_OF_OPTION,
        IMAGEX_VERBOSE_OPTION,
        IMAGEX_WIMBOOT_CONFIG_OPTION,
@@ -213,9 +215,6 @@ static const struct option apply_options[] = {
        {T("rpfix"),       no_argument,       NULL, IMAGEX_RPFIX_OPTION},
        {T("norpfix"),     no_argument,       NULL, IMAGEX_NORPFIX_OPTION},
        {T("include-invalid-names"), no_argument,       NULL, IMAGEX_INCLUDE_INVALID_NAMES_OPTION},
-
-       /* --resume is undocumented for now as it needs improvement.  */
-       {T("resume"),      no_argument,       NULL, IMAGEX_RESUME_OPTION},
        {T("wimboot"),     no_argument,       NULL, IMAGEX_WIMBOOT_OPTION},
        {T("compact"),     required_argument, NULL, IMAGEX_COMPACT_OPTION},
        {NULL, 0, NULL, 0},
@@ -230,15 +229,13 @@ static const struct option capture_or_append_options[] = {
        {T("compress-slow"), no_argument,     NULL, IMAGEX_COMPRESS_SLOW_OPTION},
        {T("chunk-size"),  required_argument, NULL, IMAGEX_CHUNK_SIZE_OPTION},
        {T("solid"),       no_argument,      NULL, IMAGEX_SOLID_OPTION},
-       {T("pack-streams"), no_argument,      NULL, IMAGEX_SOLID_OPTION},
        {T("solid-compress"),required_argument, NULL, IMAGEX_SOLID_COMPRESS_OPTION},
-       {T("pack-compress"), required_argument, NULL, IMAGEX_SOLID_COMPRESS_OPTION},
        {T("solid-chunk-size"),required_argument, NULL, IMAGEX_SOLID_CHUNK_SIZE_OPTION},
-       {T("pack-chunk-size"), required_argument, NULL, IMAGEX_SOLID_CHUNK_SIZE_OPTION},
        {T("no-solid-sort"), no_argument,     NULL, IMAGEX_NO_SOLID_SORT_OPTION},
        {T("config"),      required_argument, NULL, IMAGEX_CONFIG_OPTION},
        {T("dereference"), no_argument,       NULL, IMAGEX_DEREFERENCE_OPTION},
        {T("flags"),       required_argument, NULL, IMAGEX_FLAGS_OPTION},
+       {T("image-property"), required_argument, NULL, IMAGEX_IMAGE_PROPERTY_OPTION},
        {T("verbose"),     no_argument,       NULL, IMAGEX_VERBOSE_OPTION},
        {T("threads"),     required_argument, NULL, IMAGEX_THREADS_OPTION},
        {T("rebuild"),     no_argument,       NULL, IMAGEX_REBUILD_OPTION},
@@ -254,12 +251,15 @@ static const struct option capture_or_append_options[] = {
        {T("update-of"),   required_argument, NULL, IMAGEX_UPDATE_OF_OPTION},
        {T("delta-from"),  required_argument, NULL, IMAGEX_DELTA_FROM_OPTION},
        {T("wimboot"),     no_argument,       NULL, IMAGEX_WIMBOOT_OPTION},
+       {T("unsafe-compact"), no_argument,    NULL, IMAGEX_UNSAFE_COMPACT_OPTION},
+       {T("snapshot"),    no_argument,       NULL, IMAGEX_SNAPSHOT_OPTION},
        {NULL, 0, NULL, 0},
 };
 
 static const struct option delete_options[] = {
        {T("check"), no_argument, NULL, IMAGEX_CHECK_OPTION},
        {T("soft"),  no_argument, NULL, IMAGEX_SOFT_OPTION},
+       {T("unsafe-compact"), no_argument, NULL, IMAGEX_UNSAFE_COMPACT_OPTION},
        {NULL, 0, NULL, 0},
 };
 
@@ -267,6 +267,7 @@ static const struct option dir_options[] = {
        {T("path"),     required_argument, NULL, IMAGEX_PATH_OPTION},
        {T("detailed"), no_argument,       NULL, IMAGEX_DETAILED_OPTION},
        {T("one-file-only"), no_argument,  NULL, IMAGEX_ONE_FILE_ONLY_OPTION},
+       {T("ref"),      required_argument, NULL, IMAGEX_REF_OPTION},
        {NULL, 0, NULL, 0},
 };
 
@@ -280,11 +281,8 @@ static const struct option export_options[] = {
        {T("compress-slow"), no_argument,     NULL, IMAGEX_COMPRESS_SLOW_OPTION},
        {T("chunk-size"),  required_argument, NULL, IMAGEX_CHUNK_SIZE_OPTION},
        {T("solid"),       no_argument,       NULL, IMAGEX_SOLID_OPTION},
-       {T("pack-streams"),no_argument,       NULL, IMAGEX_SOLID_OPTION},
        {T("solid-compress"),required_argument, NULL, IMAGEX_SOLID_COMPRESS_OPTION},
-       {T("pack-compress"), required_argument, NULL, IMAGEX_SOLID_COMPRESS_OPTION},
        {T("solid-chunk-size"),required_argument, NULL, IMAGEX_SOLID_CHUNK_SIZE_OPTION},
-       {T("pack-chunk-size"), required_argument, NULL, IMAGEX_SOLID_CHUNK_SIZE_OPTION},
        {T("no-solid-sort"), no_argument,     NULL, IMAGEX_NO_SOLID_SORT_OPTION},
        {T("ref"),         required_argument, NULL, IMAGEX_REF_OPTION},
        {T("threads"),     required_argument, NULL, IMAGEX_THREADS_OPTION},
@@ -292,6 +290,7 @@ static const struct option export_options[] = {
        {T("pipable"),     no_argument,       NULL, IMAGEX_PIPABLE_OPTION},
        {T("not-pipable"), no_argument,       NULL, IMAGEX_NOT_PIPABLE_OPTION},
        {T("wimboot"),     no_argument,       NULL, IMAGEX_WIMBOOT_OPTION},
+       {T("unsafe-compact"), no_argument,    NULL, IMAGEX_UNSAFE_COMPACT_OPTION},
        {NULL, 0, NULL, 0},
 };
 
@@ -327,6 +326,7 @@ static const struct option info_options[] = {
        {T("blobs"),        no_argument,       NULL, IMAGEX_BLOBS_OPTION},
        {T("metadata"),     no_argument,       NULL, IMAGEX_METADATA_OPTION},
        {T("xml"),          no_argument,       NULL, IMAGEX_XML_OPTION},
+       {T("image-property"), required_argument, NULL, IMAGEX_IMAGE_PROPERTY_OPTION},
        {NULL, 0, NULL, 0},
 };
 
@@ -356,15 +356,13 @@ static const struct option optimize_options[] = {
        {T("recompress-slow"), no_argument,   NULL, IMAGEX_COMPRESS_SLOW_OPTION},
        {T("chunk-size"),  required_argument, NULL, IMAGEX_CHUNK_SIZE_OPTION},
        {T("solid"),       no_argument,       NULL, IMAGEX_SOLID_OPTION},
-       {T("pack-streams"),no_argument,       NULL, IMAGEX_SOLID_OPTION},
        {T("solid-compress"),required_argument, NULL, IMAGEX_SOLID_COMPRESS_OPTION},
-       {T("pack-compress"), required_argument, NULL, IMAGEX_SOLID_COMPRESS_OPTION},
        {T("solid-chunk-size"),required_argument, NULL, IMAGEX_SOLID_CHUNK_SIZE_OPTION},
-       {T("pack-chunk-size"), required_argument, NULL, IMAGEX_SOLID_CHUNK_SIZE_OPTION},
        {T("no-solid-sort"), no_argument,     NULL, IMAGEX_NO_SOLID_SORT_OPTION},
        {T("threads"),     required_argument, NULL, IMAGEX_THREADS_OPTION},
        {T("pipable"),     no_argument,       NULL, IMAGEX_PIPABLE_OPTION},
        {T("not-pipable"), no_argument,       NULL, IMAGEX_NOT_PIPABLE_OPTION},
+       {T("unsafe-compact"), no_argument,    NULL, IMAGEX_UNSAFE_COMPACT_OPTION},
        {NULL, 0, NULL, 0},
 };
 
@@ -409,6 +407,7 @@ static const struct option update_options[] = {
        {T("no-acls"),     no_argument,       NULL, IMAGEX_NO_ACLS_OPTION},
        {T("strict-acls"), no_argument,       NULL, IMAGEX_STRICT_ACLS_OPTION},
        {T("no-replace"),  no_argument,       NULL, IMAGEX_NO_REPLACE_OPTION},
+       {T("unsafe-compact"), no_argument,    NULL, IMAGEX_UNSAFE_COMPACT_OPTION},
 
        {NULL, 0, NULL, 0},
 };
@@ -506,9 +505,9 @@ print_available_compression_types(FILE *fp)
        tfputs(s, fp);
 }
 
-/* Parse the argument to --compress */
+/* Parse the argument to --compress or --solid-compress  */
 static int
-get_compression_type(tchar *optarg)
+get_compression_type(tchar *optarg, bool solid)
 {
        int ctype;
        unsigned int compression_level = 0;
@@ -531,15 +530,27 @@ get_compression_type(tchar *optarg)
 
        if (!tstrcasecmp(optarg, T("maximum")) ||
            !tstrcasecmp(optarg, T("lzx")) ||
-           !tstrcasecmp(optarg, T("max")))
+           !tstrcasecmp(optarg, T("max"))) {
                ctype = WIMLIB_COMPRESSION_TYPE_LZX;
-       else if (!tstrcasecmp(optarg, T("fast")) || !tstrcasecmp(optarg, T("xpress")))
+       } else if (!tstrcasecmp(optarg, T("fast")) || !tstrcasecmp(optarg, T("xpress"))) {
                ctype = WIMLIB_COMPRESSION_TYPE_XPRESS;
-       else if (!tstrcasecmp(optarg, T("recovery")) || !tstrcasecmp(optarg, T("lzms")))
+       } else if (!tstrcasecmp(optarg, T("recovery"))) {
+               if (!solid) {
+                       tfprintf(stderr,
+T(
+"Warning: use of '--compress=recovery' is discouraged because it behaves\n"
+"   differently from DISM.  Instead, you typically want to use '--solid' to\n"
+"   create a solid LZMS-compressed WIM or \"ESD file\", similar to DISM's\n"
+"   /compress:recovery.  But if you really want *non-solid* LZMS compression,\n"
+"   then you may suppress this warning by specifying '--compress=lzms' instead\n"
+"   of '--compress=recovery'.\n"));
+               }
                ctype = WIMLIB_COMPRESSION_TYPE_LZMS;
-       else if (!tstrcasecmp(optarg, T("none")))
+       } else if (!tstrcasecmp(optarg, T("lzms"))) {
+               ctype = WIMLIB_COMPRESSION_TYPE_LZMS;
+       } else if (!tstrcasecmp(optarg, T("none"))) {
                ctype = WIMLIB_COMPRESSION_TYPE_NONE;
-       else {
+       else {
                imagex_error(T("Invalid compression type \"%"TS"\"!"), optarg);
                print_available_compression_types(stderr);
                return WIMLIB_COMPRESSION_TYPE_INVALID;
@@ -592,7 +603,7 @@ set_compress_slow(void)
 }
 
 struct string_set {
-       const tchar **strings;
+       tchar **strings;
        unsigned num_strings;
        unsigned num_alloc_strings;
 };
@@ -604,12 +615,12 @@ struct string_set {
        struct string_set _strings = STRING_SET_INITIALIZER
 
 static int
-string_set_append(struct string_set *set, const tchar *glob)
+string_set_append(struct string_set *set, tchar *glob)
 {
        unsigned num_alloc_strings = set->num_alloc_strings;
 
        if (set->num_strings == num_alloc_strings) {
-               const tchar **new_strings;
+               tchar **new_strings;
 
                num_alloc_strings += 4;
                new_strings = realloc(set->strings,
@@ -634,12 +645,57 @@ string_set_destroy(struct string_set *set)
 static int
 wim_reference_globs(WIMStruct *wim, struct string_set *set, int open_flags)
 {
-       return wimlib_reference_resource_files(wim, set->strings,
+       return wimlib_reference_resource_files(wim, (const tchar **)set->strings,
                                               set->num_strings,
                                               WIMLIB_REF_FLAG_GLOB_ENABLE,
                                               open_flags);
 }
 
+static int
+append_image_property_argument(struct string_set *image_properties)
+{
+       if (!tstrchr(optarg, '=')) {
+               imagex_error(T("'--image-property' argument "
+                              "must be in the form NAME=VALUE"));
+               return -1;
+       }
+       return string_set_append(image_properties, optarg);
+}
+
+static int
+apply_image_properties(struct string_set *image_properties,
+                      WIMStruct *wim, int image, bool *any_changes_ret)
+{
+       bool any_changes = false;
+       for (unsigned i = 0; i < image_properties->num_strings; i++) {
+               tchar *name, *value;
+               const tchar *current_value;
+               int ret;
+
+               name = image_properties->strings[i];
+               value = tstrchr(name, '=');
+               *value++ = '\0';
+
+               current_value = wimlib_get_image_property(wim, image, name);
+               if (current_value && !tstrcmp(current_value, value)) {
+                       imagex_printf(T("The %"TS" property of image %d "
+                                       "already has value \"%"TS"\".\n"),
+                                     name, image, value);
+               } else {
+                       imagex_printf(T("Setting the %"TS" property of image "
+                                       "%d to \"%"TS"\".\n"),
+                                     name, image, value);
+                       ret = wimlib_set_image_property(wim, image, name, value);
+                       if (ret)
+                               return ret;
+                       any_changes = true;
+               }
+       }
+       if (any_changes_ret)
+               *any_changes_ret = any_changes;
+       return 0;
+}
+
 static void
 do_resource_not_found_warning(const tchar *wimfile,
                              const struct wimlib_wim_info *info,
@@ -661,6 +717,17 @@ do_resource_not_found_warning(const tchar *wimfile,
        }
 }
 
+static void
+do_metadata_not_found_warning(const tchar *wimfile,
+                             const struct wimlib_wim_info *info)
+{
+       if (info->part_number != 1) {
+               imagex_error(T("\"%"TS"\" is not the first part of the split WIM.\n"
+                              "       You must specify the first part."),
+                              wimfile);
+       }
+}
+
 /* Returns the size of a file given its name, or -1 if the file does not exist
  * or its size cannot be determined.  */
 static off_t
@@ -1091,23 +1158,24 @@ imagex_progress_func(enum wimlib_progress_msg msg,
        switch (msg) {
        case WIMLIB_PROGRESS_MSG_WRITE_STREAMS:
                {
-                       static bool first = true;
-                       if (first) {
-                               imagex_printf(T("Writing %"TS"-compressed data "
-                                               "using %u thread%"TS"\n"),
-                                             wimlib_get_compression_type_string(
-                                                       info->write_streams.compression_type),
-                                       info->write_streams.num_threads,
-                                       (info->write_streams.num_threads == 1) ? T("") : T("s"));
-                               first = false;
+                       static bool started;
+                       if (!started) {
+                               if (info->write_streams.compression_type != WIMLIB_COMPRESSION_TYPE_NONE) {
+                                       imagex_printf(T("Using %"TS" compression "
+                                                       "with %u thread%"TS"\n"),
+                                                     wimlib_get_compression_type_string(
+                                                               info->write_streams.compression_type),
+                                               info->write_streams.num_threads,
+                                               (info->write_streams.num_threads == 1) ? T("") : T("s"));
+                               }
+                               started = true;
                        }
                }
                unit_shift = get_unit(info->write_streams.total_bytes, &unit_name);
                percent_done = TO_PERCENT(info->write_streams.completed_bytes,
                                          info->write_streams.total_bytes);
 
-               imagex_printf(T("\r%"PRIu64" %"TS" of %"PRIu64" %"TS" (uncompressed) "
-                       "written (%u%% done)"),
+               imagex_printf(T("\rArchiving file data: %"PRIu64" %"TS" of %"PRIu64" %"TS" (%u%%) done"),
                        info->write_streams.completed_bytes >> unit_shift,
                        unit_name,
                        info->write_streams.total_bytes >> unit_shift,
@@ -1639,9 +1707,6 @@ imagex_apply(int argc, tchar **argv, int cmd)
                        extract_flags |= WIMLIB_EXTRACT_FLAG_REPLACE_INVALID_FILENAMES;
                        extract_flags |= WIMLIB_EXTRACT_FLAG_ALL_CASE_CONFLICTS;
                        break;
-               case IMAGEX_RESUME_OPTION:
-                       extract_flags |= WIMLIB_EXTRACT_FLAG_RESUME;
-                       break;
                case IMAGEX_WIMBOOT_OPTION:
                        extract_flags |= WIMLIB_EXTRACT_FLAG_WIMBOOT;
                        break;
@@ -1757,6 +1822,8 @@ imagex_apply(int argc, tchar **argv, int cmd)
                                       "       make sure you have "
                                       "concatenated together all parts."));
                }
+       } else if (ret == WIMLIB_ERR_METADATA_NOT_FOUND && wim) {
+               do_metadata_not_found_warning(wimfile, &info);
        }
 out_wimlib_free:
        wimlib_free(wim);
@@ -1790,8 +1857,7 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
        const tchar *wimfile;
        int wim_fd;
        const tchar *name;
-       const tchar *desc;
-       const tchar *flags_element = NULL;
+       STRING_SET(image_properties);
 
        WIMStruct *wim;
        STRING_SET(base_wimfiles);
@@ -1835,7 +1901,7 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
                        add_flags &= ~WIMLIB_ADD_FLAG_WINCONFIG;
                        break;
                case IMAGEX_COMPRESS_OPTION:
-                       compression_type = get_compression_type(optarg);
+                       compression_type = get_compression_type(optarg, false);
                        if (compression_type == WIMLIB_COMPRESSION_TYPE_INVALID)
                                goto out_err;
                        break;
@@ -1853,7 +1919,7 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
                                goto out_err;
                        break;
                case IMAGEX_SOLID_COMPRESS_OPTION:
-                       solid_ctype = get_compression_type(optarg);
+                       solid_ctype = get_compression_type(optarg, true);
                        if (solid_ctype == WIMLIB_COMPRESSION_TYPE_INVALID)
                                goto out_err;
                        break;
@@ -1863,8 +1929,18 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
                case IMAGEX_NO_SOLID_SORT_OPTION:
                        write_flags |= WIMLIB_WRITE_FLAG_NO_SOLID_SORT;
                        break;
-               case IMAGEX_FLAGS_OPTION:
-                       flags_element = optarg;
+               case IMAGEX_FLAGS_OPTION: {
+                       tchar *p = alloca((6 + tstrlen(optarg) + 1) * sizeof(tchar));
+                       tsprintf(p, T("FLAGS=%"TS), optarg);
+                       ret = string_set_append(&image_properties, p);
+                       if (ret)
+                               goto out;
+                       break;
+               }
+               case IMAGEX_IMAGE_PROPERTY_OPTION:
+                       ret = append_image_property_argument(&image_properties);
+                       if (ret)
+                               goto out;
                        break;
                case IMAGEX_DEREFERENCE_OPTION:
                        add_flags |= WIMLIB_ADD_FLAG_DEREFERENCE;
@@ -1931,12 +2007,23 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
                        }
                        ret = string_set_append(&base_wimfiles, optarg);
                        if (ret)
-                               goto out_free_base_wimfiles;
+                               goto out;
                        write_flags |= WIMLIB_WRITE_FLAG_SKIP_EXTERNAL_WIMS;
                        break;
                case IMAGEX_WIMBOOT_OPTION:
                        add_flags |= WIMLIB_ADD_FLAG_WIMBOOT;
                        break;
+               case IMAGEX_UNSAFE_COMPACT_OPTION:
+                       if (cmd != CMD_APPEND) {
+                               imagex_error(T("'--unsafe-compact' is only "
+                                              "valid for append!"));
+                               goto out_err;
+                       }
+                       write_flags |= WIMLIB_WRITE_FLAG_UNSAFE_COMPACT;
+                       break;
+               case IMAGEX_SNAPSHOT_OPTION:
+                       add_flags |= WIMLIB_ADD_FLAG_SNAPSHOT;
+                       break;
                default:
                        goto out_usage;
                }
@@ -2037,11 +2124,15 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
                name = tbasename(tstrcpy(source_copy, source));
                name_defaulted = true;
        }
-       /* Image description defaults to NULL if not given. */
-       if (argc >= 4)
-               desc = argv[3];
-       else
-               desc = NULL;
+
+       /* Image description (if given). */
+       if (argc >= 4) {
+               tchar *p = alloca((12 + tstrlen(argv[3]) + 1) * sizeof(tchar));
+               tsprintf(p, T("DESCRIPTION=%"TS), argv[3]);
+               ret = string_set_append(&image_properties, p);
+               if (ret)
+                       goto out;
+       }
 
        if (source_list) {
                /* Set up capture sources in source list mode */
@@ -2094,11 +2185,21 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
                ret = wimlib_set_output_chunk_size(wim, chunk_size);
                if (ret)
                        goto out_free_wim;
-       } else if ((add_flags & WIMLIB_ADD_FLAG_WIMBOOT) &&
-                  compression_type == WIMLIB_COMPRESSION_TYPE_XPRESS) {
-               ret = wimlib_set_output_chunk_size(wim, 4096);
-               if (ret)
-                       goto out_free_wim;
+       } else if ((add_flags & WIMLIB_ADD_FLAG_WIMBOOT)) {
+
+               int ctype = compression_type;
+
+               if (cmd == CMD_APPEND) {
+                       struct wimlib_wim_info info;
+                       wimlib_get_wim_info(wim, &info);
+                       ctype = info.compression_type;
+               }
+
+               if (ctype == WIMLIB_COMPRESSION_TYPE_XPRESS) {
+                       ret = wimlib_set_output_chunk_size(wim, 4096);
+                       if (ret)
+                               goto out_free_wim;
+               }
        }
        if (solid_ctype != WIMLIB_COMPRESSION_TYPE_INVALID) {
                ret = wimlib_set_output_pack_compression_type(wim, solid_ctype);
@@ -2240,29 +2341,18 @@ imagex_capture_or_append(int argc, tchar **argv, int cmd)
        if (ret)
                goto out_free_template_wim;
 
-       if (desc || flags_element || template_image_name_or_num) {
-               /* User provided <DESCRIPTION> or <FLAGS> element, or an image
-                * on which the added one is to be based has been specified with
-                * --update-of.  Get the index of the image we just
-                *  added, then use it to call the appropriate functions.  */
+       if (image_properties.num_strings || template_image_name_or_num) {
+               /* User asked to set additional image properties, or an image on
+                * which the added one is to be based has been specified with
+                * --update-of.  */
                struct wimlib_wim_info info;
 
                wimlib_get_wim_info(wim, &info);
 
-               if (desc) {
-                       ret = wimlib_set_image_descripton(wim,
-                                                         info.image_count,
-                                                         desc);
-                       if (ret)
-                               goto out_free_template_wim;
-               }
-
-               if (flags_element) {
-                       ret = wimlib_set_image_flags(wim, info.image_count,
-                                                    flags_element);
-                       if (ret)
-                               goto out_free_template_wim;
-               }
+               ret = apply_image_properties(&image_properties, wim,
+                                            info.image_count, NULL);
+               if (ret)
+                       goto out_free_template_wim;
 
                /* Reference template image if the user provided one.  */
                if (template_image_name_or_num) {
@@ -2306,7 +2396,8 @@ out_free_capture_sources:
                free(capture_sources);
 out_free_source_list_contents:
        free(source_list_contents);
-out_free_base_wimfiles:
+out:
+       string_set_destroy(&image_properties);
        string_set_destroy(&base_wimfiles);
        return ret;
 
@@ -2314,7 +2405,7 @@ out_usage:
        usage(cmd, stderr);
 out_err:
        ret = -1;
-       goto out_free_base_wimfiles;
+       goto out;
 }
 
 /* Remove image(s) from a WIM. */
@@ -2339,6 +2430,9 @@ imagex_delete(int argc, tchar **argv, int cmd)
                case IMAGEX_SOFT_OPTION:
                        write_flags |= WIMLIB_WRITE_FLAG_SOFT_DELETE;
                        break;
+               case IMAGEX_UNSAFE_COMPACT_OPTION:
+                       write_flags |= WIMLIB_WRITE_FLAG_UNSAFE_COMPACT;
+                       break;
                default:
                        goto out_usage;
                }
@@ -2639,6 +2733,8 @@ imagex_dir(int argc, tchar **argv, int cmd)
        };
        int iterate_flags = WIMLIB_ITERATE_DIR_TREE_FLAG_RECURSIVE;
 
+       STRING_SET(refglobs);
+
        for_opt(c, dir_options) {
                switch (c) {
                case IMAGEX_PATH_OPTION:
@@ -2650,6 +2746,11 @@ imagex_dir(int argc, tchar **argv, int cmd)
                case IMAGEX_ONE_FILE_ONLY_OPTION:
                        iterate_flags &= ~WIMLIB_ITERATE_DIR_TREE_FLAG_RECURSIVE;
                        break;
+               case IMAGEX_REF_OPTION:
+                       ret = string_set_append(&refglobs, optarg);
+                       if (ret)
+                               goto out_free_refglobs;
+                       break;
                default:
                        goto out_usage;
                }
@@ -2670,7 +2771,7 @@ imagex_dir(int argc, tchar **argv, int cmd)
        ret = wimlib_open_wim_with_progress(wimfile, 0, &wim,
                                            imagex_progress_func, NULL);
        if (ret)
-               goto out;
+               goto out_free_refglobs;
 
        if (argc >= 2) {
                image = wimlib_resolve_image(wim, argv[1]);
@@ -2694,17 +2795,30 @@ imagex_dir(int argc, tchar **argv, int cmd)
                image = 1;
        }
 
+       if (refglobs.num_strings) {
+               ret = wim_reference_globs(wim, &refglobs, 0);
+               if (ret)
+                       goto out_wimlib_free;
+       }
+
        ret = wimlib_iterate_dir_tree(wim, image, path, iterate_flags,
                                      print_dentry, &options);
+       if (ret == WIMLIB_ERR_METADATA_NOT_FOUND) {
+               struct wimlib_wim_info info;
+
+               wimlib_get_wim_info(wim, &info);
+               do_metadata_not_found_warning(wimfile, &info);
+       }
 out_wimlib_free:
        wimlib_free(wim);
-out:
+out_free_refglobs:
+       string_set_destroy(&refglobs);
        return ret;
 
 out_usage:
        usage(CMD_DIR, stderr);
        ret = -1;
-       goto out;
+       goto out_free_refglobs;
 }
 
 /* Exports one, or all, images from a WIM file to a new WIM file or an existing
@@ -2749,7 +2863,7 @@ imagex_export(int argc, tchar **argv, int cmd)
                        write_flags |= WIMLIB_WRITE_FLAG_NO_CHECK_INTEGRITY;
                        break;
                case IMAGEX_COMPRESS_OPTION:
-                       compression_type = get_compression_type(optarg);
+                       compression_type = get_compression_type(optarg, false);
                        if (compression_type == WIMLIB_COMPRESSION_TYPE_INVALID)
                                goto out_err;
                        break;
@@ -2777,7 +2891,7 @@ imagex_export(int argc, tchar **argv, int cmd)
                                goto out_err;
                        break;
                case IMAGEX_SOLID_COMPRESS_OPTION:
-                       solid_ctype = get_compression_type(optarg);
+                       solid_ctype = get_compression_type(optarg, true);
                        if (solid_ctype == WIMLIB_COMPRESSION_TYPE_INVALID)
                                goto out_err;
                        break;
@@ -2803,6 +2917,9 @@ imagex_export(int argc, tchar **argv, int cmd)
                case IMAGEX_WIMBOOT_OPTION:
                        export_flags |= WIMLIB_EXPORT_FLAG_WIMBOOT;
                        break;
+               case IMAGEX_UNSAFE_COMPACT_OPTION:
+                       write_flags |= WIMLIB_WRITE_FLAG_UNSAFE_COMPACT;
+                       break;
                default:
                        goto out_usage;
                }
@@ -2892,6 +3009,13 @@ imagex_export(int argc, tchar **argv, int cmd)
                        goto out_free_src_wim;
                }
 
+               if (write_flags & WIMLIB_WRITE_FLAG_UNSAFE_COMPACT) {
+                       imagex_error(T("'--unsafe-compact' is only valid when "
+                                      "exporting to an existing WIM file!"));
+                       ret = -1;
+                       goto out_free_src_wim;
+               }
+
                /* dest_wimfile is not an existing file, so create a new WIM. */
 
                if (compression_type == WIMLIB_COMPRESSION_TYPE_INVALID) {
@@ -2969,6 +3093,8 @@ imagex_export(int argc, tchar **argv, int cmd)
                if (ret == WIMLIB_ERR_RESOURCE_NOT_FOUND) {
                        do_resource_not_found_warning(src_wimfile,
                                                      &src_info, &refglobs);
+               } else if (ret == WIMLIB_ERR_METADATA_NOT_FOUND) {
+                       do_metadata_not_found_warning(src_wimfile, &src_info);
                }
                goto out_free_dest_wim;
        }
@@ -3166,6 +3292,11 @@ imagex_extract(int argc, tchar **argv, int cmd)
 
                wimlib_get_wim_info(wim, &info);
                do_resource_not_found_warning(wimfile, &info, &refglobs);
+       } else if (ret == WIMLIB_ERR_METADATA_NOT_FOUND) {
+               struct wimlib_wim_info info;
+
+               wimlib_get_wim_info(wim, &info);
+               do_metadata_not_found_warning(wimfile, &info);
        }
 out_wimlib_free:
        wimlib_free(wim);
@@ -3196,8 +3327,7 @@ imagex_info(int argc, tchar **argv, int cmd)
        const tchar *xml_out_file = NULL;
        const tchar *wimfile;
        const tchar *image_num_or_name;
-       const tchar *new_name;
-       const tchar *new_desc;
+       STRING_SET(image_properties);
        WIMStruct *wim;
        int image;
        int ret;
@@ -3235,6 +3365,11 @@ imagex_info(int argc, tchar **argv, int cmd)
                        imagex_error(T("The --metadata option has been removed. "
                                       "Use 'wimdir --detail' instead."));
                        goto out_err;
+               case IMAGEX_IMAGE_PROPERTY_OPTION:
+                       ret = append_image_property_argument(&image_properties);
+                       if (ret)
+                               goto out;
+                       break;
                default:
                        goto out_usage;
                }
@@ -3247,8 +3382,24 @@ imagex_info(int argc, tchar **argv, int cmd)
 
        wimfile           = argv[0];
        image_num_or_name = (argc >= 2) ? argv[1] : T("all");
-       new_name          = (argc >= 3) ? argv[2] : NULL;
-       new_desc          = (argc >= 4) ? argv[3] : NULL;
+
+       if (argc >= 3) {
+               /* NEW_NAME */
+               tchar *p = alloca((5 + tstrlen(argv[2]) + 1) * sizeof(tchar));
+               tsprintf(p, T("NAME=%"TS), argv[2]);
+               ret = string_set_append(&image_properties, p);
+               if (ret)
+                       goto out;
+       }
+
+       if (argc >= 4) {
+               /* NEW_DESC */
+               tchar *p = alloca((12 + tstrlen(argv[3]) + 1) * sizeof(tchar));
+               tsprintf(p, T("DESCRIPTION=%"TS), argv[3]);
+               ret = string_set_append(&image_properties, p);
+               if (ret)
+                       goto out;
+       }
 
        if (check && nocheck) {
                imagex_error(T("Can't specify both --check and --nocheck"));
@@ -3289,17 +3440,17 @@ imagex_info(int argc, tchar **argv, int cmd)
                                       "image in a multi-image WIM"));
                        goto out_wimlib_free;
                }
-               if (new_name) {
-                       imagex_error(T("Cannot specify the NEW_NAME "
-                                      "without specifying a specific "
-                                      "image in a multi-image WIM"));
+               if (image_properties.num_strings) {
+                       imagex_error(T("Can't change image properties without "
+                                      "specifying a specific image in a "
+                                      "multi-image WIM"));
                        goto out_wimlib_free;
                }
        }
 
        /* Operations that print information are separated from operations that
         * recreate the WIM file. */
-       if (!new_name && !boot) {
+       if (!image_properties.num_strings && !boot) {
 
                /* Read-only operations */
 
@@ -3358,15 +3509,15 @@ imagex_info(int argc, tchar **argv, int cmd)
 
                ret = 0;
        } else {
-
                /* Modification operations */
+               bool any_property_changes;
 
                if (image == WIMLIB_ALL_IMAGES)
                        image = 1;
 
-               if (image == WIMLIB_NO_IMAGE && new_name) {
-                       imagex_error(T("Cannot specify new_name (\"%"TS"\") "
-                                      "when using image 0"), new_name);
+               if (image == WIMLIB_NO_IMAGE && image_properties.num_strings) {
+                       imagex_error(T("Cannot change image properties "
+                                      "when using image 0"));
                        ret = -1;
                        goto out_wimlib_free;
                }
@@ -3386,40 +3537,15 @@ imagex_info(int argc, tchar **argv, int cmd)
                                        goto out_wimlib_free;
                        }
                }
-               if (new_name) {
-                       if (!tstrcmp(wimlib_get_image_name(wim, image), new_name))
-                       {
-                               imagex_printf(T("Image %d is already named \"%"TS"\".\n"),
-                                       image, new_name);
-                               new_name = NULL;
-                       } else {
-                               imagex_printf(T("Changing the name of image %d to "
-                                         "\"%"TS"\".\n"), image, new_name);
-                               ret = wimlib_set_image_name(wim, image, new_name);
-                               if (ret)
-                                       goto out_wimlib_free;
-                       }
-               }
-               if (new_desc) {
-                       const tchar *old_desc;
-                       old_desc = wimlib_get_image_description(wim, image);
-                       if (old_desc && !tstrcmp(old_desc, new_desc)) {
-                               imagex_printf(T("The description of image %d is already "
-                                         "\"%"TS"\".\n"), image, new_desc);
-                               new_desc = NULL;
-                       } else {
-                               imagex_printf(T("Changing the description of image %d "
-                                         "to \"%"TS"\".\n"), image, new_desc);
-                               ret = wimlib_set_image_descripton(wim, image,
-                                                                 new_desc);
-                               if (ret)
-                                       goto out_wimlib_free;
-                       }
-               }
+
+               ret = apply_image_properties(&image_properties, wim, image,
+                                            &any_property_changes);
+               if (ret)
+                       goto out_wimlib_free;
 
                /* Only call wimlib_overwrite() if something actually needs to
                 * be changed.  */
-               if (boot || new_name || new_desc ||
+               if (boot || any_property_changes ||
                    (check && !info.has_integrity_table) ||
                    (nocheck && info.has_integrity_table))
                {
@@ -3440,6 +3566,7 @@ imagex_info(int argc, tchar **argv, int cmd)
 out_wimlib_free:
        wimlib_free(wim);
 out:
+       string_set_destroy(&image_properties);
        return ret;
 
 out_usage:
@@ -3600,9 +3727,13 @@ imagex_mount_rw_or_ro(int argc, tchar **argv, int cmd)
 
        ret = wimlib_mount_image(wim, image, dir, mount_flags, staging_dir);
        if (ret) {
-               imagex_error(T("Failed to mount image %d from \"%"TS"\" "
-                              "on \"%"TS"\""),
-                            image, wimfile, dir);
+               if (ret == WIMLIB_ERR_METADATA_NOT_FOUND) {
+                       do_metadata_not_found_warning(wimfile, &info);
+               } else {
+                       imagex_error(T("Failed to mount image %d from \"%"TS"\" "
+                                      "on \"%"TS"\""),
+                                    image, wimfile, dir);
+               }
        }
 out_free_wim:
        wimlib_free(wim);
@@ -3646,7 +3777,7 @@ imagex_optimize(int argc, tchar **argv, int cmd)
                        break;
                case IMAGEX_COMPRESS_OPTION:
                        write_flags |= WIMLIB_WRITE_FLAG_RECOMPRESS;
-                       compression_type = get_compression_type(optarg);
+                       compression_type = get_compression_type(optarg, false);
                        if (compression_type == WIMLIB_COMPRESSION_TYPE_INVALID)
                                goto out_err;
                        break;
@@ -3668,7 +3799,7 @@ imagex_optimize(int argc, tchar **argv, int cmd)
                                goto out_err;
                        break;
                case IMAGEX_SOLID_COMPRESS_OPTION:
-                       solid_ctype = get_compression_type(optarg);
+                       solid_ctype = get_compression_type(optarg, true);
                        if (solid_ctype == WIMLIB_COMPRESSION_TYPE_INVALID)
                                goto out_err;
                        break;
@@ -3690,6 +3821,9 @@ imagex_optimize(int argc, tchar **argv, int cmd)
                case IMAGEX_NOT_PIPABLE_OPTION:
                        write_flags |= WIMLIB_WRITE_FLAG_NOT_PIPABLE;
                        break;
+               case IMAGEX_UNSAFE_COMPACT_OPTION:
+                       write_flags |= WIMLIB_WRITE_FLAG_UNSAFE_COMPACT;
+                       break;
                default:
                        goto out_usage;
                }
@@ -3987,6 +4121,9 @@ imagex_update(int argc, tchar **argv, int cmd)
                case IMAGEX_NO_REPLACE_OPTION:
                        default_add_flags |= WIMLIB_ADD_FLAG_NO_REPLACE;
                        break;
+               case IMAGEX_UNSAFE_COMPACT_OPTION:
+                       write_flags |= WIMLIB_WRITE_FLAG_UNSAFE_COMPACT;
+                       break;
                default:
                        goto out_usage;
                }
@@ -4248,7 +4385,7 @@ T(
 "                    [--boot] [--check] [--nocheck] [--config=FILE]\n"
 "                    [--threads=NUM_THREADS] [--no-acls] [--strict-acls]\n"
 "                    [--rpfix] [--norpfix] [--update-of=[WIMFILE:]IMAGE]\n"
-"                    [--wimboot] [--unix-data] [--dereference]\n"
+"                    [--wimboot] [--unix-data] [--dereference] [--snapshot]\n"
 ),
 [CMD_APPLY] =
 T(
@@ -4266,6 +4403,7 @@ T(
 "                    [--no-acls] [--strict-acls] [--rpfix] [--norpfix]\n"
 "                    [--update-of=[WIMFILE:]IMAGE] [--delta-from=WIMFILE]\n"
 "                    [--wimboot] [--unix-data] [--dereference] [--solid]\n"
+"                    [--snapshot]\n"
 ),
 [CMD_DELETE] =
 T(
@@ -4296,6 +4434,7 @@ T(
 "    %"TS" WIMFILE [IMAGE [NEW_NAME [NEW_DESC]]]\n"
 "                    [--boot] [--check] [--nocheck] [--xml]\n"
 "                    [--extract-xml FILE] [--header] [--blobs]\n"
+"                    [--image-property NAME=VALUE]\n"
 ),
 [CMD_JOIN] =
 T(
@@ -4375,7 +4514,7 @@ version(void)
        static const tchar *s =
        T(
 "wimlib-imagex (distributed with " PACKAGE " " PACKAGE_VERSION ")\n"
-"Copyright (C) 2012, 2013, 2014, 2015 Eric Biggers\n"
+"Copyright (C) 2012-2016 Eric Biggers\n"
 "License GPLv3+; GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.\n"
 "This is free software: you are free to change and redistribute it.\n"
 "There is NO WARRANTY, to the extent permitted by law.\n"