wimlib.net Git - wimlib/blob - include/wimlib/wim.h

   1 #ifndef _WIMLIB_WIM_H
   2 #define _WIMLIB_WIM_H
   3
   4 #include "wimlib/header.h"
   5 #include "wimlib/types.h"
   6 #include "wimlib/file_io.h"
   7 #include "wimlib/list.h"
   8
   9 struct wim_info;
  10 struct wim_lookup_table;
  11 struct wim_image_metadata;
  12
  13 /* The opaque structure exposed to the wimlib API. */
  14 struct WIMStruct {
  15
  16         /* File descriptor for the WIM file, opened for reading.  in_fd.fd is -1
  17          * if the WIM file has not been opened or there is no associated file
  18          * backing it yet. */
  19         struct filedes in_fd;
  20
  21         /* File descriptor, opened either for writing only or for
  22          * reading+writing, for the WIM file (if any) currently being written.
  23          * */
  24         struct filedes out_fd;
  25
  26         /* The name of the WIM file (if any) that has been opened. */
  27         tchar *filename;
  28
  29         /* The lookup table for the WIM file. */
  30         struct wim_lookup_table *lookup_table;
  31
  32         /* Information retrieved from the XML data, arranged in an orderly
  33          * manner. */
  34         struct wim_info *wim_info;
  35
  36         /* Array of the image metadata, one for each image in the WIM. */
  37         struct wim_image_metadata **image_metadata;
  38
  39         /* The header of the WIM file. */
  40         struct wim_header hdr;
  41
  42         /* Temporary field */
  43         void *private;
  44
  45         /* LZX compression context for default thread  */
  46         struct wimlib_lzx_context *lzx_context;
  47
  48         struct list_head subwims;
  49
  50         struct list_head subwim_node;
  51
  52         /* The currently selected image, indexed starting at 1.  If not 0,
  53          * subtract 1 from this to get the index of the current image in the
  54          * image_metadata array. */
  55         int current_image;
  56
  57         /* Have any images been deleted? */
  58         u8 deletion_occurred : 1;
  59
  60         /* Do we know that all the stream reference counts in the WIM are
  61          * correct?  If so, this is set to 1 and deletions are safe; otherwise
  62          * this is set to 0 and deletions are not safe until reference counts
  63          * are recalculated.  (This is due to a bug in M$'s software that
  64          * generates WIMs with invalid reference counts.)  */
  65         u8 refcnts_ok : 1;
  66
  67         u8 wim_locked : 1;
  68
  69         u8 guid_set_explicitly : 1;
  70
  71         /* One of WIMLIB_COMPRESSION_TYPE_*, cached from the header flags. */
  72         u8 compression_type : 2;
  73
  74         /* Overwritten compression type for wimlib_overwrite() or
  75          * wimlib_write().  Can be changed by
  76          * wimlib_set_output_compression_type(); otherwise is the same as
  77          * compression_type.  */
  78         u8 out_compression_type : 2;
  79 };
  80
  81 static inline bool wim_is_pipable(const WIMStruct *wim)
  82 {
  83         return (wim->hdr.magic == PWM_MAGIC);
  84 }
  85
  86 static inline bool wim_has_integrity_table(const WIMStruct *wim)
  87 {
  88         return (wim->hdr.integrity.offset != 0);
  89 }
  90
  91 static inline bool wim_has_metadata(const WIMStruct *wim)
  92 {
  93         return (wim->image_metadata != NULL || wim->hdr.image_count == 0);
  94 }
  95
  96 extern void
  97 wim_recalculate_refcnts(WIMStruct *wim);
  98
  99 extern u32
 100 get_wim_hdr_cflags(int ctype);
 101
 102 extern int
 103 init_wim_header(struct wim_header *hdr, int ctype);
 104
 105 extern int
 106 read_wim_header(const tchar *filename, struct filedes *in_fd,
 107                 struct wim_header *hdr);
 108
 109 extern int
 110 write_wim_header(const struct wim_header *hdr, struct filedes *out_fd);
 111
 112 extern int
 113 write_wim_header_at_offset(const struct wim_header *hdr, struct filedes *out_fd,
 114                            off_t offset);
 115
 116 extern int
 117 write_wim_header_flags(u32 hdr_flags, struct filedes *out_fd);
 118
 119 extern int
 120 rename_wim_path(WIMStruct *wim, const tchar *from, const tchar *to);
 121
 122 extern int
 123 select_wim_image(WIMStruct *wim, int image);
 124
 125 extern int
 126 for_image(WIMStruct *wim, int image, int (*visitor)(WIMStruct *));
 127
 128 extern int
 129 wim_checksum_unhashed_streams(WIMStruct *wim);
 130
 131 extern int
 132 reopen_wim(WIMStruct *wim);
 133
 134 /* Internal open flags (pass to open_wim_as_WIMStruct(), not wimlib_open_wim())
 135  */
 136 #define WIMLIB_OPEN_FLAG_FROM_PIPE      0x80000000
 137 #define WIMLIB_OPEN_MASK_PUBLIC         0x7fffffff
 138
 139 extern int
 140 open_wim_as_WIMStruct(const void *wim_filename_or_fd, int open_flags,
 141                       WIMStruct **wim_ret,
 142                       wimlib_progress_func_t progress_func);
 143
 144 extern int
 145 close_wim(WIMStruct *wim);
 146
 147 extern int
 148 can_modify_wim(WIMStruct *wim);
 149
 150 extern int
 151 can_delete_from_wim(WIMStruct *wim);
 152
 153 #endif /* _WIMLIB_WIM_H */