wimlib.h

Go to the documentation of this file.

#ifndef _WIMLIB_H
#define _WIMLIB_H

#include <stdio.h>
#include <stddef.h>
#include <stdbool.h>
#include <inttypes.h>
#include <time.h>

#define WIMLIB_MAJOR_VERSION 1

#define WIMLIB_MINOR_VERSION 8

#define WIMLIB_PATCH_VERSION 3

#ifdef __cplusplus
extern "C" {
#endif

#ifndef WIMLIB_WIMSTRUCT_DECLARED
typedef struct WIMStruct WIMStruct;
#define WIMLIB_WIMSTRUCT_DECLARED
#endif

#ifdef __WIN32__
typedef wchar_t wimlib_tchar;
#else

typedef char wimlib_tchar;
#endif

#ifdef __WIN32__

#  define WIMLIB_WIM_PATH_SEPARATOR '\\'
#  define WIMLIB_WIM_PATH_SEPARATOR_STRING L"\\"
#else

#  define WIMLIB_WIM_PATH_SEPARATOR '/'
#  define WIMLIB_WIM_PATH_SEPARATOR_STRING "/"
#endif

#define WIMLIB_WIM_ROOT_PATH WIMLIB_WIM_PATH_SEPARATOR_STRING

#define WIMLIB_IS_WIM_ROOT_PATH(path) \
                ((path)[0] == WIMLIB_WIM_PATH_SEPARATOR &&      \
                 (path)[1] == 0)

#define WIMLIB_GUID_LEN 16

enum wimlib_compression_type {
        WIMLIB_COMPRESSION_TYPE_NONE = 0,

        WIMLIB_COMPRESSION_TYPE_XPRESS = 1,

        WIMLIB_COMPRESSION_TYPE_LZX = 2,

        WIMLIB_COMPRESSION_TYPE_LZMS = 3,
};

enum wimlib_progress_msg {

        WIMLIB_PROGRESS_MSG_EXTRACT_IMAGE_BEGIN = 0,

        WIMLIB_PROGRESS_MSG_EXTRACT_TREE_BEGIN = 1,

        WIMLIB_PROGRESS_MSG_EXTRACT_FILE_STRUCTURE = 3,

        WIMLIB_PROGRESS_MSG_EXTRACT_STREAMS = 4,

        WIMLIB_PROGRESS_MSG_EXTRACT_SPWM_PART_BEGIN = 5,

        WIMLIB_PROGRESS_MSG_EXTRACT_METADATA = 6,

        WIMLIB_PROGRESS_MSG_EXTRACT_IMAGE_END = 7,

        WIMLIB_PROGRESS_MSG_EXTRACT_TREE_END = 8,

        WIMLIB_PROGRESS_MSG_SCAN_BEGIN = 9,

        WIMLIB_PROGRESS_MSG_SCAN_DENTRY = 10,

        WIMLIB_PROGRESS_MSG_SCAN_END = 11,

        WIMLIB_PROGRESS_MSG_WRITE_STREAMS = 12,

        WIMLIB_PROGRESS_MSG_WRITE_METADATA_BEGIN = 13,

        WIMLIB_PROGRESS_MSG_WRITE_METADATA_END = 14,

        WIMLIB_PROGRESS_MSG_RENAME = 15,

        WIMLIB_PROGRESS_MSG_VERIFY_INTEGRITY = 16,

        WIMLIB_PROGRESS_MSG_CALC_INTEGRITY = 17,

        WIMLIB_PROGRESS_MSG_SPLIT_BEGIN_PART = 19,

        WIMLIB_PROGRESS_MSG_SPLIT_END_PART = 20,

        WIMLIB_PROGRESS_MSG_UPDATE_BEGIN_COMMAND = 21,

        WIMLIB_PROGRESS_MSG_UPDATE_END_COMMAND = 22,

        WIMLIB_PROGRESS_MSG_REPLACE_FILE_IN_WIM = 23,

        WIMLIB_PROGRESS_MSG_WIMBOOT_EXCLUDE = 24,

        WIMLIB_PROGRESS_MSG_UNMOUNT_BEGIN = 25,

        WIMLIB_PROGRESS_MSG_DONE_WITH_FILE = 26,

        WIMLIB_PROGRESS_MSG_BEGIN_VERIFY_IMAGE = 27,

        WIMLIB_PROGRESS_MSG_END_VERIFY_IMAGE = 28,

        WIMLIB_PROGRESS_MSG_VERIFY_STREAMS = 29,

        WIMLIB_PROGRESS_MSG_TEST_FILE_EXCLUSION = 30,

        WIMLIB_PROGRESS_MSG_HANDLE_ERROR = 31,
};

enum wimlib_progress_status {

        WIMLIB_PROGRESS_STATUS_CONTINUE = 0,

        WIMLIB_PROGRESS_STATUS_ABORT    = 1,
};

union wimlib_progress_info {

        struct wimlib_progress_info_write_streams {

                uint64_t total_bytes;

                uint64_t total_streams;

                uint64_t completed_bytes;

                uint64_t completed_streams;

                uint32_t num_threads;

                int32_t  compression_type;

                uint32_t total_parts;

                uint32_t completed_parts;
        } write_streams;

        struct wimlib_progress_info_scan {

                const wimlib_tchar *source;

                const wimlib_tchar *cur_path;

                enum {
                        WIMLIB_SCAN_DENTRY_OK = 0,

                        WIMLIB_SCAN_DENTRY_EXCLUDED,

                        WIMLIB_SCAN_DENTRY_UNSUPPORTED,

                        WIMLIB_SCAN_DENTRY_FIXED_SYMLINK,

                        WIMLIB_SCAN_DENTRY_NOT_FIXED_SYMLINK,
                } status;

                union {
                        const wimlib_tchar *wim_target_path;

                        const wimlib_tchar *symlink_target;
                };

                uint64_t num_dirs_scanned;

                uint64_t num_nondirs_scanned;

                uint64_t num_bytes_scanned;
        } scan;

        struct wimlib_progress_info_extract {

                uint32_t image;

                uint32_t extract_flags;

                const wimlib_tchar *wimfile_name;

                const wimlib_tchar *image_name;

                const wimlib_tchar *target;

                const wimlib_tchar *reserved;

                uint64_t total_bytes;

                uint64_t completed_bytes;

                uint64_t total_streams;

                uint64_t completed_streams;

                uint32_t part_number;

                uint32_t total_parts;

                uint8_t guid[WIMLIB_GUID_LEN];

                uint64_t current_file_count;

                uint64_t end_file_count;
        } extract;

        struct wimlib_progress_info_rename {
                const wimlib_tchar *from;

                const wimlib_tchar *to;
        } rename;

        struct wimlib_progress_info_update {
                const struct wimlib_update_command *command;

                size_t completed_commands;

                size_t total_commands;
        } update;

        struct wimlib_progress_info_integrity {

                uint64_t total_bytes;

                uint64_t completed_bytes;

                uint32_t total_chunks;

                uint32_t completed_chunks;

                uint32_t chunk_size;

                const wimlib_tchar *filename;
        } integrity;

        struct wimlib_progress_info_split {
                uint64_t total_bytes;

                uint64_t completed_bytes;

                unsigned cur_part_number;

                unsigned total_parts;

                wimlib_tchar *part_name;
        } split;

        struct wimlib_progress_info_replace {
                const wimlib_tchar *path_in_wim;
        } replace;

        struct wimlib_progress_info_wimboot_exclude {
                const wimlib_tchar *path_in_wim;

                const wimlib_tchar *extraction_path;
        } wimboot_exclude;

        struct wimlib_progress_info_unmount {
                const wimlib_tchar *mountpoint;

                const wimlib_tchar *mounted_wim;

                uint32_t mounted_image;

                uint32_t mount_flags;

                uint32_t unmount_flags;
        } unmount;

        struct wimlib_progress_info_done_with_file {
                const wimlib_tchar *path_to_file;
        } done_with_file;

        struct wimlib_progress_info_verify_image {
                const wimlib_tchar *wimfile;
                uint32_t total_images;
                uint32_t current_image;
        } verify_image;

        struct wimlib_progress_info_verify_streams {
                const wimlib_tchar *wimfile;
                uint64_t total_streams;
                uint64_t total_bytes;
                uint64_t completed_streams;
                uint64_t completed_bytes;
        } verify_streams;

        struct wimlib_progress_info_test_file_exclusion {

                const wimlib_tchar *path;

                bool will_exclude;
        } test_file_exclusion;

        struct wimlib_progress_info_handle_error {

                const wimlib_tchar *path;

                int error_code;

                bool will_ignore;
        } handle_error;
};

typedef enum wimlib_progress_status
        (*wimlib_progress_func_t)(enum wimlib_progress_msg msg_type,
                                  union wimlib_progress_info *info,
                                  void *progctx);

struct wimlib_capture_source {
        wimlib_tchar *fs_source_path;

        wimlib_tchar *wim_target_path;

        long reserved;
};

#define WIMLIB_CHANGE_READONLY_FLAG             0x00000001

#define WIMLIB_CHANGE_GUID                      0x00000002

#define WIMLIB_CHANGE_BOOT_INDEX                0x00000004

#define WIMLIB_CHANGE_RPFIX_FLAG                0x00000008

struct wimlib_wim_info {

        uint8_t guid[WIMLIB_GUID_LEN];

        uint32_t image_count;

        uint32_t boot_index;

        uint32_t wim_version;

        uint32_t chunk_size;

        uint16_t part_number;

        uint16_t total_parts;

        int32_t compression_type;

        uint64_t total_bytes;

        uint32_t has_integrity_table : 1;

        uint32_t opened_from_file : 1;

        uint32_t is_readonly : 1;

        uint32_t has_rpfix : 1;

        uint32_t is_marked_readonly : 1;

        uint32_t spanned : 1;

        uint32_t write_in_progress : 1;

        uint32_t metadata_only : 1;

        uint32_t resource_only : 1;

        uint32_t pipable : 1;
        uint32_t reserved_flags : 22;
        uint32_t reserved[9];
};

struct wimlib_resource_entry {

        uint64_t uncompressed_size;

        uint64_t compressed_size;

        uint64_t offset;

        uint8_t sha1_hash[20];

        uint32_t part_number;

        uint32_t reference_count;

        uint32_t is_compressed : 1;

        uint32_t is_metadata : 1;

        uint32_t is_free : 1;
        uint32_t is_spanned : 1;

        uint32_t is_missing : 1;

        uint32_t packed : 1;

        uint32_t reserved_flags : 26;

        uint64_t raw_resource_offset_in_wim;

        uint64_t raw_resource_compressed_size;

        uint64_t raw_resource_uncompressed_size;

        uint64_t reserved[1];
};

struct wimlib_stream_entry {

        const wimlib_tchar *stream_name;

        struct wimlib_resource_entry resource;

        uint64_t reserved[4];
};

struct wimlib_dir_entry {
        const wimlib_tchar *filename;

        const wimlib_tchar *dos_name;

        const wimlib_tchar *full_path;

        size_t depth;

        const char *security_descriptor;

        size_t security_descriptor_size;

#define WIMLIB_FILE_ATTRIBUTE_READONLY            0x00000001
#define WIMLIB_FILE_ATTRIBUTE_HIDDEN              0x00000002
#define WIMLIB_FILE_ATTRIBUTE_SYSTEM              0x00000004
#define WIMLIB_FILE_ATTRIBUTE_DIRECTORY           0x00000010
#define WIMLIB_FILE_ATTRIBUTE_ARCHIVE             0x00000020
#define WIMLIB_FILE_ATTRIBUTE_DEVICE              0x00000040
#define WIMLIB_FILE_ATTRIBUTE_NORMAL              0x00000080
#define WIMLIB_FILE_ATTRIBUTE_TEMPORARY           0x00000100
#define WIMLIB_FILE_ATTRIBUTE_SPARSE_FILE         0x00000200
#define WIMLIB_FILE_ATTRIBUTE_REPARSE_POINT       0x00000400
#define WIMLIB_FILE_ATTRIBUTE_COMPRESSED          0x00000800
#define WIMLIB_FILE_ATTRIBUTE_OFFLINE             0x00001000
#define WIMLIB_FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 0x00002000
#define WIMLIB_FILE_ATTRIBUTE_ENCRYPTED           0x00004000
#define WIMLIB_FILE_ATTRIBUTE_VIRTUAL             0x00010000

        uint32_t attributes;

#define WIMLIB_REPARSE_TAG_RESERVED_ZERO        0x00000000
#define WIMLIB_REPARSE_TAG_RESERVED_ONE         0x00000001
#define WIMLIB_REPARSE_TAG_MOUNT_POINT          0xA0000003
#define WIMLIB_REPARSE_TAG_HSM                  0xC0000004
#define WIMLIB_REPARSE_TAG_HSM2                 0x80000006
#define WIMLIB_REPARSE_TAG_DRIVER_EXTENDER      0x80000005
#define WIMLIB_REPARSE_TAG_SIS                  0x80000007
#define WIMLIB_REPARSE_TAG_DFS                  0x8000000A
#define WIMLIB_REPARSE_TAG_DFSR                 0x80000012
#define WIMLIB_REPARSE_TAG_FILTER_MANAGER       0x8000000B
#define WIMLIB_REPARSE_TAG_WOF                  0x80000017
#define WIMLIB_REPARSE_TAG_SYMLINK              0xA000000C

        uint32_t reparse_tag;

        uint32_t num_links;

        uint32_t num_named_streams;

        uint64_t hard_link_group_id;

        struct timespec creation_time;

        struct timespec last_write_time;

        struct timespec last_access_time;

        uint32_t unix_uid;

        uint32_t unix_gid;

        uint32_t unix_mode;

        uint32_t unix_rdev;

        uint64_t reserved[14];

        struct wimlib_stream_entry streams[];
};

typedef int (*wimlib_iterate_dir_tree_callback_t)(const struct wimlib_dir_entry *dentry,
                                                  void *user_ctx);

typedef int (*wimlib_iterate_lookup_table_callback_t)(const struct wimlib_resource_entry *resource,
                                                      void *user_ctx);

#define WIMLIB_ITERATE_DIR_TREE_FLAG_RECURSIVE 0x00000001

#define WIMLIB_ITERATE_DIR_TREE_FLAG_CHILDREN  0x00000002

#define WIMLIB_ITERATE_DIR_TREE_FLAG_RESOURCES_NEEDED  0x00000004


#define WIMLIB_ADD_FLAG_NTFS                    0x00000001

#define WIMLIB_ADD_FLAG_DEREFERENCE             0x00000002

#define WIMLIB_ADD_FLAG_VERBOSE                 0x00000004

#define WIMLIB_ADD_FLAG_BOOT                    0x00000008

#define WIMLIB_ADD_FLAG_UNIX_DATA               0x00000010

#define WIMLIB_ADD_FLAG_NO_ACLS                 0x00000020

#define WIMLIB_ADD_FLAG_STRICT_ACLS             0x00000040

#define WIMLIB_ADD_FLAG_EXCLUDE_VERBOSE         0x00000080

#define WIMLIB_ADD_FLAG_RPFIX                   0x00000100

#define WIMLIB_ADD_FLAG_NORPFIX                 0x00000200

#define WIMLIB_ADD_FLAG_NO_UNSUPPORTED_EXCLUDE  0x00000400

#define WIMLIB_ADD_FLAG_WINCONFIG               0x00000800

#define WIMLIB_ADD_FLAG_WIMBOOT                 0x00001000

#define WIMLIB_ADD_FLAG_NO_REPLACE              0x00002000

#define WIMLIB_ADD_FLAG_TEST_FILE_EXCLUSION     0x00004000

/* Note: the WIMLIB_ADD_IMAGE_FLAG names are retained for source compatibility.
 * Use the WIMLIB_ADD_FLAG names in new code.  */
#define WIMLIB_ADD_IMAGE_FLAG_NTFS              WIMLIB_ADD_FLAG_NTFS
#define WIMLIB_ADD_IMAGE_FLAG_DEREFERENCE       WIMLIB_ADD_FLAG_DEREFERENCE
#define WIMLIB_ADD_IMAGE_FLAG_VERBOSE           WIMLIB_ADD_FLAG_VERBOSE
#define WIMLIB_ADD_IMAGE_FLAG_BOOT              WIMLIB_ADD_FLAG_BOOT
#define WIMLIB_ADD_IMAGE_FLAG_UNIX_DATA         WIMLIB_ADD_FLAG_UNIX_DATA
#define WIMLIB_ADD_IMAGE_FLAG_NO_ACLS           WIMLIB_ADD_FLAG_NO_ACLS
#define WIMLIB_ADD_IMAGE_FLAG_STRICT_ACLS       WIMLIB_ADD_FLAG_STRICT_ACLS
#define WIMLIB_ADD_IMAGE_FLAG_EXCLUDE_VERBOSE   WIMLIB_ADD_FLAG_EXCLUDE_VERBOSE
#define WIMLIB_ADD_IMAGE_FLAG_RPFIX             WIMLIB_ADD_FLAG_RPFIX
#define WIMLIB_ADD_IMAGE_FLAG_NORPFIX           WIMLIB_ADD_FLAG_NORPFIX
#define WIMLIB_ADD_IMAGE_FLAG_NO_UNSUPPORTED_EXCLUDE \
                                                WIMLIB_ADD_FLAG_NO_UNSUPPORTED_EXCLUDE
#define WIMLIB_ADD_IMAGE_FLAG_WINCONFIG         WIMLIB_ADD_FLAG_WINCONFIG
#define WIMLIB_ADD_IMAGE_FLAG_WIMBOOT           WIMLIB_ADD_FLAG_WIMBOOT


#define WIMLIB_DELETE_FLAG_FORCE                        0x00000001

#define WIMLIB_DELETE_FLAG_RECURSIVE                    0x00000002

#define WIMLIB_EXPORT_FLAG_BOOT                         0x00000001

#define WIMLIB_EXPORT_FLAG_NO_NAMES                     0x00000002

#define WIMLIB_EXPORT_FLAG_NO_DESCRIPTIONS              0x00000004

#define WIMLIB_EXPORT_FLAG_GIFT                         0x00000008

#define WIMLIB_EXPORT_FLAG_WIMBOOT                      0x00000010

#define WIMLIB_EXTRACT_FLAG_NTFS                        0x00000001

#define WIMLIB_EXTRACT_FLAG_UNIX_DATA                   0x00000020

#define WIMLIB_EXTRACT_FLAG_NO_ACLS                     0x00000040

#define WIMLIB_EXTRACT_FLAG_STRICT_ACLS                 0x00000080

#define WIMLIB_EXTRACT_FLAG_RPFIX                       0x00000100

#define WIMLIB_EXTRACT_FLAG_NORPFIX                     0x00000200

#define WIMLIB_EXTRACT_FLAG_TO_STDOUT                   0x00000400

#define WIMLIB_EXTRACT_FLAG_REPLACE_INVALID_FILENAMES   0x00000800

#define WIMLIB_EXTRACT_FLAG_ALL_CASE_CONFLICTS          0x00001000

#define WIMLIB_EXTRACT_FLAG_STRICT_TIMESTAMPS           0x00002000

#define WIMLIB_EXTRACT_FLAG_STRICT_SHORT_NAMES          0x00004000

#define WIMLIB_EXTRACT_FLAG_STRICT_SYMLINKS             0x00008000

#define WIMLIB_EXTRACT_FLAG_RESUME                      0x00010000

#define WIMLIB_EXTRACT_FLAG_GLOB_PATHS                  0x00040000

#define WIMLIB_EXTRACT_FLAG_STRICT_GLOB                 0x00080000

#define WIMLIB_EXTRACT_FLAG_NO_ATTRIBUTES               0x00100000

#define WIMLIB_EXTRACT_FLAG_NO_PRESERVE_DIR_STRUCTURE   0x00200000

#define WIMLIB_EXTRACT_FLAG_WIMBOOT                     0x00400000

#define WIMLIB_EXTRACT_FLAG_COMPACT_XPRESS4K            0x01000000

#define WIMLIB_EXTRACT_FLAG_COMPACT_XPRESS8K            0x02000000

#define WIMLIB_EXTRACT_FLAG_COMPACT_XPRESS16K           0x04000000

#define WIMLIB_EXTRACT_FLAG_COMPACT_LZX                 0x08000000

#define WIMLIB_MOUNT_FLAG_READWRITE                     0x00000001

#define WIMLIB_MOUNT_FLAG_DEBUG                         0x00000002

#define WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_NONE         0x00000004

#define WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_XATTR        0x00000008

#define WIMLIB_MOUNT_FLAG_STREAM_INTERFACE_WINDOWS      0x00000010

#define WIMLIB_MOUNT_FLAG_UNIX_DATA                     0x00000020

#define WIMLIB_MOUNT_FLAG_ALLOW_OTHER                   0x00000040

#define WIMLIB_OPEN_FLAG_CHECK_INTEGRITY                0x00000001

#define WIMLIB_OPEN_FLAG_ERROR_IF_SPLIT                 0x00000002

#define WIMLIB_OPEN_FLAG_WRITE_ACCESS                   0x00000004

#define WIMLIB_UNMOUNT_FLAG_CHECK_INTEGRITY             0x00000001

#define WIMLIB_UNMOUNT_FLAG_COMMIT                      0x00000002

#define WIMLIB_UNMOUNT_FLAG_REBUILD                     0x00000004

#define WIMLIB_UNMOUNT_FLAG_RECOMPRESS                  0x00000008

#define WIMLIB_UNMOUNT_FLAG_FORCE                       0x00000010

#define WIMLIB_UNMOUNT_FLAG_NEW_IMAGE                   0x00000020

#define WIMLIB_UPDATE_FLAG_SEND_PROGRESS                0x00000001

#define WIMLIB_WRITE_FLAG_CHECK_INTEGRITY               0x00000001

#define WIMLIB_WRITE_FLAG_NO_CHECK_INTEGRITY            0x00000002

#define WIMLIB_WRITE_FLAG_PIPABLE                       0x00000004

#define WIMLIB_WRITE_FLAG_NOT_PIPABLE                   0x00000008

#define WIMLIB_WRITE_FLAG_RECOMPRESS                    0x00000010

#define WIMLIB_WRITE_FLAG_FSYNC                         0x00000020

#define WIMLIB_WRITE_FLAG_REBUILD                       0x00000040

#define WIMLIB_WRITE_FLAG_SOFT_DELETE                   0x00000080

#define WIMLIB_WRITE_FLAG_IGNORE_READONLY_FLAG          0x00000100

#define WIMLIB_WRITE_FLAG_SKIP_EXTERNAL_WIMS            0x00000200

#define WIMLIB_WRITE_FLAG_STREAMS_OK                    0x00000400

#define WIMLIB_WRITE_FLAG_RETAIN_GUID                   0x00000800

#define WIMLIB_WRITE_FLAG_SOLID                         0x00001000

#define WIMLIB_WRITE_FLAG_PACK_STREAMS                  WIMLIB_WRITE_FLAG_SOLID

#define WIMLIB_WRITE_FLAG_SEND_DONE_WITH_FILE_MESSAGES  0x00002000

#define WIMLIB_WRITE_FLAG_NO_SOLID_SORT                 0x00004000

#define WIMLIB_WRITE_FLAG_UNSAFE_COMPACT                0x00008000

#define WIMLIB_INIT_FLAG_ASSUME_UTF8                    0x00000001

#define WIMLIB_INIT_FLAG_DONT_ACQUIRE_PRIVILEGES        0x00000002

#define WIMLIB_INIT_FLAG_STRICT_CAPTURE_PRIVILEGES      0x00000004

#define WIMLIB_INIT_FLAG_STRICT_APPLY_PRIVILEGES        0x00000008

#define WIMLIB_INIT_FLAG_DEFAULT_CASE_SENSITIVE         0x00000010

#define WIMLIB_INIT_FLAG_DEFAULT_CASE_INSENSITIVE       0x00000020

#define WIMLIB_REF_FLAG_GLOB_ENABLE             0x00000001

#define WIMLIB_REF_FLAG_GLOB_ERR_ON_NOMATCH     0x00000002

enum wimlib_update_op {
        WIMLIB_UPDATE_OP_ADD = 0,

        WIMLIB_UPDATE_OP_DELETE,

        WIMLIB_UPDATE_OP_RENAME,
};

struct wimlib_add_command {
        wimlib_tchar *fs_source_path;

        wimlib_tchar *wim_target_path;

        wimlib_tchar *config_file;

        int add_flags;
};

struct wimlib_delete_command {

        wimlib_tchar *wim_path;

        int delete_flags;
};

struct wimlib_rename_command {

        wimlib_tchar *wim_source_path;

        wimlib_tchar *wim_target_path;

        int rename_flags;
};

struct wimlib_update_command {

        enum wimlib_update_op op;

        union {
                struct wimlib_add_command add;
                struct wimlib_delete_command delete_; /* Underscore is for C++
                                                         compatibility.  */
                struct wimlib_rename_command rename;
        };
};

enum wimlib_error_code {
        WIMLIB_ERR_SUCCESS                            = 0,
        WIMLIB_ERR_ALREADY_LOCKED                     = 1,
        WIMLIB_ERR_DECOMPRESSION                      = 2,
        WIMLIB_ERR_FUSE                               = 6,
        WIMLIB_ERR_GLOB_HAD_NO_MATCHES                = 8,
        WIMLIB_ERR_ICONV_NOT_AVAILABLE                = 9,
        WIMLIB_ERR_IMAGE_COUNT                        = 10,
        WIMLIB_ERR_IMAGE_NAME_COLLISION               = 11,
        WIMLIB_ERR_INSUFFICIENT_PRIVILEGES            = 12,
        WIMLIB_ERR_INTEGRITY                          = 13,
        WIMLIB_ERR_INVALID_CAPTURE_CONFIG             = 14,
        WIMLIB_ERR_INVALID_CHUNK_SIZE                 = 15,
        WIMLIB_ERR_INVALID_COMPRESSION_TYPE           = 16,
        WIMLIB_ERR_INVALID_HEADER                     = 17,
        WIMLIB_ERR_INVALID_IMAGE                      = 18,
        WIMLIB_ERR_INVALID_INTEGRITY_TABLE            = 19,
        WIMLIB_ERR_INVALID_LOOKUP_TABLE_ENTRY         = 20,
        WIMLIB_ERR_INVALID_METADATA_RESOURCE          = 21,
        WIMLIB_ERR_INVALID_MULTIBYTE_STRING           = 22,
        WIMLIB_ERR_INVALID_OVERLAY                    = 23,
        WIMLIB_ERR_INVALID_PARAM                      = 24,
        WIMLIB_ERR_INVALID_PART_NUMBER                = 25,
        WIMLIB_ERR_INVALID_PIPABLE_WIM                = 26,
        WIMLIB_ERR_INVALID_REPARSE_DATA               = 27,
        WIMLIB_ERR_INVALID_RESOURCE_HASH              = 28,
        WIMLIB_ERR_INVALID_UTF16_STRING               = 30,
        WIMLIB_ERR_INVALID_UTF8_STRING                = 31,
        WIMLIB_ERR_IS_DIRECTORY                       = 32,
        WIMLIB_ERR_IS_SPLIT_WIM                       = 33,
        WIMLIB_ERR_LINK                               = 35,
        WIMLIB_ERR_METADATA_NOT_FOUND                 = 36,
        WIMLIB_ERR_MKDIR                              = 37,
        WIMLIB_ERR_MQUEUE                             = 38,
        WIMLIB_ERR_NOMEM                              = 39,
        WIMLIB_ERR_NOTDIR                             = 40,
        WIMLIB_ERR_NOTEMPTY                           = 41,
        WIMLIB_ERR_NOT_A_REGULAR_FILE                 = 42,
        WIMLIB_ERR_NOT_A_WIM_FILE                     = 43,
        WIMLIB_ERR_NOT_PIPABLE                        = 44,
        WIMLIB_ERR_NO_FILENAME                        = 45,
        WIMLIB_ERR_NTFS_3G                            = 46,
        WIMLIB_ERR_OPEN                               = 47,
        WIMLIB_ERR_OPENDIR                            = 48,
        WIMLIB_ERR_PATH_DOES_NOT_EXIST                = 49,
        WIMLIB_ERR_READ                               = 50,
        WIMLIB_ERR_READLINK                           = 51,
        WIMLIB_ERR_RENAME                             = 52,
        WIMLIB_ERR_REPARSE_POINT_FIXUP_FAILED         = 54,
        WIMLIB_ERR_RESOURCE_NOT_FOUND                 = 55,
        WIMLIB_ERR_RESOURCE_ORDER                     = 56,
        WIMLIB_ERR_SET_ATTRIBUTES                     = 57,
        WIMLIB_ERR_SET_REPARSE_DATA                   = 58,
        WIMLIB_ERR_SET_SECURITY                       = 59,
        WIMLIB_ERR_SET_SHORT_NAME                     = 60,
        WIMLIB_ERR_SET_TIMESTAMPS                     = 61,
        WIMLIB_ERR_SPLIT_INVALID                      = 62,
        WIMLIB_ERR_STAT                               = 63,
        WIMLIB_ERR_UNEXPECTED_END_OF_FILE             = 65,
        WIMLIB_ERR_UNICODE_STRING_NOT_REPRESENTABLE   = 66,
        WIMLIB_ERR_UNKNOWN_VERSION                    = 67,
        WIMLIB_ERR_UNSUPPORTED                        = 68,
        WIMLIB_ERR_UNSUPPORTED_FILE                   = 69,
        WIMLIB_ERR_WIM_IS_READONLY                    = 71,
        WIMLIB_ERR_WRITE                              = 72,
        WIMLIB_ERR_XML                                = 73,
        WIMLIB_ERR_WIM_IS_ENCRYPTED                   = 74,
        WIMLIB_ERR_WIMBOOT                            = 75,
        WIMLIB_ERR_ABORTED_BY_PROGRESS                = 76,
        WIMLIB_ERR_UNKNOWN_PROGRESS_STATUS            = 77,
        WIMLIB_ERR_MKNOD                              = 78,
        WIMLIB_ERR_MOUNTED_IMAGE_IS_BUSY              = 79,
        WIMLIB_ERR_NOT_A_MOUNTPOINT                   = 80,
        WIMLIB_ERR_NOT_PERMITTED_TO_UNMOUNT           = 81,
        WIMLIB_ERR_FVE_LOCKED_VOLUME                  = 82,
        WIMLIB_ERR_UNABLE_TO_READ_CAPTURE_CONFIG      = 83,
        WIMLIB_ERR_WIM_IS_INCOMPLETE                  = 84,
        WIMLIB_ERR_COMPACTION_NOT_POSSIBLE            = 85,
        WIMLIB_ERR_IMAGE_HAS_MULTIPLE_REFERENCES      = 86,
        WIMLIB_ERR_DUPLICATE_EXPORTED_IMAGE           = 87,
        WIMLIB_ERR_CONCURRENT_MODIFICATION_DETECTED   = 88,
};


#define WIMLIB_NO_IMAGE         0

#define WIMLIB_ALL_IMAGES       (-1)

extern int
wimlib_add_empty_image(WIMStruct *wim,
                       const wimlib_tchar *name,
                       int *new_idx_ret);

extern int
wimlib_add_image(WIMStruct *wim,
                 const wimlib_tchar *source,
                 const wimlib_tchar *name,
                 const wimlib_tchar *config_file,
                 int add_flags);

extern int
wimlib_add_image_multisource(WIMStruct *wim,
                             const struct wimlib_capture_source *sources,
                             size_t num_sources,
                             const wimlib_tchar *name,
                             const wimlib_tchar *config_file,
                             int add_flags);

extern int
wimlib_add_tree(WIMStruct *wim, int image,
                const wimlib_tchar *fs_source_path,
                const wimlib_tchar *wim_target_path, int add_flags);

extern int
wimlib_create_new_wim(enum wimlib_compression_type ctype, WIMStruct **wim_ret);

extern int
wimlib_delete_image(WIMStruct *wim, int image);

extern int
wimlib_delete_path(WIMStruct *wim, int image,
                   const wimlib_tchar *path, int delete_flags);

extern int
wimlib_export_image(WIMStruct *src_wim, int src_image,
                    WIMStruct *dest_wim,
                    const wimlib_tchar *dest_name,
                    const wimlib_tchar *dest_description,
                    int export_flags);

extern int
wimlib_extract_image(WIMStruct *wim, int image,
                     const wimlib_tchar *target, int extract_flags);

extern int
wimlib_extract_image_from_pipe(int pipe_fd,
                               const wimlib_tchar *image_num_or_name,
                               const wimlib_tchar *target, int extract_flags);

extern int
wimlib_extract_image_from_pipe_with_progress(int pipe_fd,
                                             const wimlib_tchar *image_num_or_name,
                                             const wimlib_tchar *target,
                                             int extract_flags,
                                             wimlib_progress_func_t progfunc,
                                             void *progctx);

extern int
wimlib_extract_pathlist(WIMStruct *wim, int image,
                        const wimlib_tchar *target,
                        const wimlib_tchar *path_list_file,
                        int extract_flags);

extern int
wimlib_extract_paths(WIMStruct *wim,
                     int image,
                     const wimlib_tchar *target,
                     const wimlib_tchar * const *paths,
                     size_t num_paths,
                     int extract_flags);

extern int
wimlib_extract_xml_data(WIMStruct *wim, FILE *fp);

extern void
wimlib_free(WIMStruct *wim);

extern const wimlib_tchar *
wimlib_get_compression_type_string(enum wimlib_compression_type ctype);

extern const wimlib_tchar *
wimlib_get_error_string(enum wimlib_error_code code);

extern const wimlib_tchar *
wimlib_get_image_description(const WIMStruct *wim, int image);

extern const wimlib_tchar *
wimlib_get_image_name(const WIMStruct *wim, int image);

extern const wimlib_tchar *
wimlib_get_image_property(const WIMStruct *wim, int image,
                          const wimlib_tchar *property_name);

extern uint32_t
wimlib_get_version(void);

extern int
wimlib_get_wim_info(WIMStruct *wim, struct wimlib_wim_info *info);

extern int
wimlib_get_xml_data(WIMStruct *wim, void **buf_ret, size_t *bufsize_ret);

extern int
wimlib_global_init(int init_flags);

extern void
wimlib_global_cleanup(void);

extern bool
wimlib_image_name_in_use(const WIMStruct *wim, const wimlib_tchar *name);

extern int
wimlib_iterate_dir_tree(WIMStruct *wim, int image, const wimlib_tchar *path,
                        int flags,
                        wimlib_iterate_dir_tree_callback_t cb, void *user_ctx);

extern int
wimlib_iterate_lookup_table(WIMStruct *wim, int flags,
                            wimlib_iterate_lookup_table_callback_t cb,
                            void *user_ctx);

extern int
wimlib_join(const wimlib_tchar * const *swms,
            unsigned num_swms,
            const wimlib_tchar *output_path,
            int swm_open_flags,
            int wim_write_flags);

extern int
wimlib_join_with_progress(const wimlib_tchar * const *swms,
                          unsigned num_swms,
                          const wimlib_tchar *output_path,
                          int swm_open_flags,
                          int wim_write_flags,
                          wimlib_progress_func_t progfunc,
                          void *progctx);


extern int
wimlib_mount_image(WIMStruct *wim,
                   int image,
                   const wimlib_tchar *dir,
                   int mount_flags,
                   const wimlib_tchar *staging_dir);

extern int
wimlib_open_wim(const wimlib_tchar *wim_file,
                int open_flags,
                WIMStruct **wim_ret);

extern int
wimlib_open_wim_with_progress(const wimlib_tchar *wim_file,
                              int open_flags,
                              WIMStruct **wim_ret,
                              wimlib_progress_func_t progfunc,
                              void *progctx);

extern int
wimlib_overwrite(WIMStruct *wim, int write_flags, unsigned num_threads);

extern void
wimlib_print_available_images(const WIMStruct *wim, int image);

extern void
wimlib_print_header(const WIMStruct *wim);

extern int
wimlib_reference_resource_files(WIMStruct *wim,
                                const wimlib_tchar * const *resource_wimfiles_or_globs,
                                unsigned count,
                                int ref_flags,
                                int open_flags);

extern int
wimlib_reference_resources(WIMStruct *wim, WIMStruct **resource_wims,
                           unsigned num_resource_wims, int ref_flags);

extern int
wimlib_reference_template_image(WIMStruct *wim, int new_image,
                                WIMStruct *template_wim, int template_image,
                                int flags);

extern void
wimlib_register_progress_function(WIMStruct *wim,
                                  wimlib_progress_func_t progfunc,
                                  void *progctx);

extern int
wimlib_rename_path(WIMStruct *wim, int image,
                   const wimlib_tchar *source_path, const wimlib_tchar *dest_path);

extern int
wimlib_resolve_image(WIMStruct *wim,
                     const wimlib_tchar *image_name_or_num);

extern int
wimlib_set_error_file(FILE *fp);

extern int
wimlib_set_error_file_by_name(const wimlib_tchar *path);

extern int
wimlib_set_image_descripton(WIMStruct *wim, int image,
                            const wimlib_tchar *description);

extern int
wimlib_set_image_flags(WIMStruct *wim, int image, const wimlib_tchar *flags);

extern int
wimlib_set_image_name(WIMStruct *wim, int image, const wimlib_tchar *name);

extern int
wimlib_set_image_property(WIMStruct *wim, int image,
                          const wimlib_tchar *property_name,
                          const wimlib_tchar *property_value);

extern int
wimlib_set_memory_allocator(void *(*malloc_func)(size_t),
                            void (*free_func)(void *),
                            void *(*realloc_func)(void *, size_t));

extern int
wimlib_set_output_chunk_size(WIMStruct *wim, uint32_t chunk_size);

extern int
wimlib_set_output_pack_chunk_size(WIMStruct *wim, uint32_t chunk_size);

extern int
wimlib_set_output_compression_type(WIMStruct *wim,
                                   enum wimlib_compression_type ctype);

extern int
wimlib_set_output_pack_compression_type(WIMStruct *wim,
                                        enum wimlib_compression_type ctype);

extern int
wimlib_set_print_errors(bool show_messages);

extern int
wimlib_set_wim_info(WIMStruct *wim, const struct wimlib_wim_info *info,
                    int which);

extern int
wimlib_split(WIMStruct *wim,
             const wimlib_tchar *swm_name,
             uint64_t part_size,
             int write_flags);

extern int
wimlib_verify_wim(WIMStruct *wim, int verify_flags);

extern int
wimlib_unmount_image(const wimlib_tchar *dir, int unmount_flags);

extern int
wimlib_unmount_image_with_progress(const wimlib_tchar *dir,
                                   int unmount_flags,
                                   wimlib_progress_func_t progfunc,
                                   void *progctx);

extern int
wimlib_update_image(WIMStruct *wim,
                    int image,
                    const struct wimlib_update_command *cmds,
                    size_t num_cmds,
                    int update_flags);

extern int
wimlib_write(WIMStruct *wim,
             const wimlib_tchar *path,
             int image,
             int write_flags,
             unsigned num_threads);

extern int
wimlib_write_to_fd(WIMStruct *wim,
                   int fd,
                   int image,
                   int write_flags,
                   unsigned num_threads);

struct wimlib_compressor;

struct wimlib_decompressor;

extern int
wimlib_set_default_compression_level(int ctype, unsigned int compression_level);

extern uint64_t
wimlib_get_compressor_needed_memory(enum wimlib_compression_type ctype,
                                    size_t max_block_size,
                                    unsigned int compression_level);

#define WIMLIB_COMPRESSOR_FLAG_DESTRUCTIVE      0x80000000

extern int
wimlib_create_compressor(enum wimlib_compression_type ctype,
                         size_t max_block_size,
                         unsigned int compression_level,
                         struct wimlib_compressor **compressor_ret);

extern size_t
wimlib_compress(const void *uncompressed_data, size_t uncompressed_size,
                void *compressed_data, size_t compressed_size_avail,
                struct wimlib_compressor *compressor);

extern void
wimlib_free_compressor(struct wimlib_compressor *compressor);

extern int
wimlib_create_decompressor(enum wimlib_compression_type ctype,
                           size_t max_block_size,
                           struct wimlib_decompressor **decompressor_ret);

extern int
wimlib_decompress(const void *compressed_data, size_t compressed_size,
                  void *uncompressed_data, size_t uncompressed_size,
                  struct wimlib_decompressor *decompressor);

extern void
wimlib_free_decompressor(struct wimlib_decompressor *decompressor);


#ifdef __cplusplus
}
#endif

#endif /* _WIMLIB_H */