#include <stdint.h>
#include <time.h>
+#ifdef BUILDING_WIMLIB
+# ifdef _WIN32
+# define WIMLIBAPI __declspec(dllexport)
+# else
+# define WIMLIBAPI __attribute__((visibility("default")))
+# endif
+#else
+# define WIMLIBAPI
+#endif
+
/** @addtogroup G_general
* @{ */
* @retval ::WIMLIB_ERR_IMAGE_NAME_COLLISION
* The WIM already contains an image with the requested name.
*/
-extern int
+WIMLIBAPI int
wimlib_add_empty_image(WIMStruct *wim,
const wimlib_tchar *name,
int *new_idx_ret);
* In addition, if ::WIMLIB_ADD_FLAG_VERBOSE is specified in @p add_flags, it
* will receive ::WIMLIB_PROGRESS_MSG_SCAN_DENTRY.
*/
-extern int
+WIMLIBAPI int
wimlib_add_image(WIMStruct *wim,
const wimlib_tchar *source,
const wimlib_tchar *name,
* same as wimlib_add_image(). See the documentation for <b>wimcapture</b> for
* full details on how this mode works.
*/
-extern int
+WIMLIBAPI int
wimlib_add_image_multisource(WIMStruct *wim,
const struct wimlib_capture_source *sources,
size_t num_sources,
* This just builds an appropriate ::wimlib_add_command and passes it to
* wimlib_update_image().
*/
-extern int
+WIMLIBAPI int
wimlib_add_tree(WIMStruct *wim, int image,
const wimlib_tchar *fs_source_path,
const wimlib_tchar *wim_target_path, int add_flags);
* @retval ::WIMLIB_ERR_NOMEM
* Insufficient memory to allocate a new ::WIMStruct.
*/
-extern int
+WIMLIBAPI int
wimlib_create_new_wim(enum wimlib_compression_type ctype, WIMStruct **wim_ret);
/**
* If this function fails when @p image was ::WIMLIB_ALL_IMAGES, then it's
* possible that some but not all of the images were deleted.
*/
-extern int
+WIMLIBAPI int
wimlib_delete_image(WIMStruct *wim, int image);
/**
* This just builds an appropriate ::wimlib_delete_command and passes it to
* wimlib_update_image().
*/
-extern int
+WIMLIBAPI int
wimlib_delete_path(WIMStruct *wim, int image,
const wimlib_tchar *path, int delete_flags);
* indicate failure (for different reasons) to read the metadata resource for an
* image in @p src_wim that needed to be exported.
*/
-extern int
+WIMLIBAPI int
wimlib_export_image(WIMStruct *src_wim, int src_image,
WIMStruct *dest_wim,
const wimlib_tchar *dest_name,
* ::WIMLIB_PROGRESS_MSG_EXTRACT_METADATA messages, then
* ::WIMLIB_PROGRESS_MSG_EXTRACT_IMAGE_END.
*/
-extern int
+WIMLIBAPI int
wimlib_extract_image(WIMStruct *wim, int image,
const wimlib_tchar *target, int extract_flags);
* @retval ::WIMLIB_ERR_NOT_PIPABLE
* The WIM being piped over @p pipe_fd is a normal WIM, not a pipable WIM.
*/
-extern int
+WIMLIBAPI int
wimlib_extract_image_from_pipe(int pipe_fd,
const wimlib_tchar *image_num_or_name,
const wimlib_tchar *target, int extract_flags);
* ::WIMLIB_PROGRESS_MSG_EXTRACT_STREAMS, in addition to
* ::WIMLIB_PROGRESS_MSG_EXTRACT_SPWM_PART_BEGIN.
*/
-extern int
+WIMLIBAPI int
wimlib_extract_image_from_pipe_with_progress(int pipe_fd,
const wimlib_tchar *image_num_or_name,
const wimlib_tchar *target,
* cannot read the path list file (e.g. ::WIMLIB_ERR_OPEN, ::WIMLIB_ERR_STAT,
* ::WIMLIB_ERR_READ).
*/
-extern int
+WIMLIBAPI int
wimlib_extract_pathlist(WIMStruct *wim, int image,
const wimlib_tchar *target,
const wimlib_tchar *path_list_file,
* If a progress function is registered with @p wim, then it will receive
* ::WIMLIB_PROGRESS_MSG_EXTRACT_STREAMS.
*/
-extern int
+WIMLIBAPI int
wimlib_extract_paths(WIMStruct *wim,
int image,
const wimlib_tchar *target,
* @retval ::WIMLIB_ERR_WRITE
* Failed to write the data to the requested file.
*/
-extern int
+WIMLIBAPI int
wimlib_extract_xml_data(WIMStruct *wim, FILE *fp);
/**
* @param wim
* Pointer to the ::WIMStruct to release. If @c NULL, no action is taken.
*/
-extern void
+WIMLIBAPI void
wimlib_free(WIMStruct *wim);
/**
* "None", "LZX", or "XPRESS". If the value was unrecognized, then
* the resulting string will be "Invalid".
*/
-extern const wimlib_tchar *
+WIMLIBAPI const wimlib_tchar *
wimlib_get_compression_type_string(enum wimlib_compression_type ctype);
/**
* the value was unrecognized, then the resulting string will be "Unknown
* error".
*/
-extern const wimlib_tchar *
+WIMLIBAPI const wimlib_tchar *
wimlib_get_error_string(enum wimlib_error_code code);
/**
* Get the description of the specified image. Equivalent to
* <tt>wimlib_get_image_property(wim, image, "DESCRIPTION")</tt>.
*/
-extern const wimlib_tchar *
+WIMLIBAPI const wimlib_tchar *
wimlib_get_image_description(const WIMStruct *wim, int image);
/**
* wimlib_get_image_name() will return an empty string if the image is unnamed
* whereas wimlib_get_image_property() may return @c NULL in that case.
*/
-extern const wimlib_tchar *
+WIMLIBAPI const wimlib_tchar *
wimlib_get_image_name(const WIMStruct *wim, int image);
/**
* no such property. The string may not remain valid after later library
* calls, so the caller should duplicate it if needed.
*/
-extern const wimlib_tchar *
+WIMLIBAPI const wimlib_tchar *
wimlib_get_image_property(const WIMStruct *wim, int image,
const wimlib_tchar *property_name);
* 20) | (WIMLIB_MINOR_VERSION << 10) | WIMLIB_PATCH_VERSION)</c> for the
* corresponding header file.
*/
-extern uint32_t
+WIMLIBAPI uint32_t
wimlib_get_version(void);
/**
* PACKAGE_VERSION string that was set at build time. (This allows a beta
* release to be distinguished from an official release.)
*/
-extern const wimlib_tchar *
+WIMLIBAPI const wimlib_tchar *
wimlib_get_version_string(void);
/**
*
* @return 0
*/
-extern int
+WIMLIBAPI int
wimlib_get_wim_info(WIMStruct *wim, struct wimlib_wim_info *info);
/**
* @retval ::WIMLIB_ERR_UNEXPECTED_END_OF_FILE
* Failed to read the XML document from the WIM file.
*/
-extern int
+WIMLIBAPI int
wimlib_get_xml_data(WIMStruct *wim, void **buf_ret, size_t *bufsize_ret);
/**
* ::WIMLIB_INIT_FLAG_STRICT_CAPTURE_PRIVILEGES were specified in @p
* init_flags, but the corresponding privileges could not be acquired.
*/
-extern int
+WIMLIBAPI int
wimlib_global_init(int init_flags);
/**
* Cleanup function for wimlib. You are not required to call this function, but
* it will release any global resources allocated by the library.
*/
-extern void
+WIMLIBAPI void
wimlib_global_cleanup(void);
/**
* if there is no image named @p name in @p wim. If @p name is @c NULL or
* the empty string, then @c false is returned.
*/
-extern bool
+WIMLIBAPI bool
wimlib_image_name_in_use(const WIMStruct *wim, const wimlib_tchar *name);
/**
* indicate failure (for different reasons) to read the metadata resource for an
* image over which iteration needed to be done.
*/
-extern int
+WIMLIBAPI 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);
* @return 0 if all calls to @p cb returned 0; otherwise the first nonzero value
* that was returned from @p cb.
*/
-extern int
+WIMLIBAPI int
wimlib_iterate_lookup_table(WIMStruct *wim, int flags,
wimlib_iterate_lookup_table_callback_t cb,
void *user_ctx);
* an easy-to-use wrapper around this that has some advantages (e.g. extra
* sanity checks).
*/
-extern int
+WIMLIBAPI int
wimlib_join(const wimlib_tchar * const *swms,
unsigned num_swms,
const wimlib_tchar *output_path,
* ::WIMLIB_PROGRESS_MSG_VERIFY_INTEGRITY messages when each of the split WIM
* parts is opened.
*/
-extern int
+WIMLIBAPI int
wimlib_join_with_progress(const wimlib_tchar * const *swms,
unsigned num_swms,
const wimlib_tchar *output_path,
* To unmount the image, call wimlib_unmount_image(). This may be done in a
* different process.
*/
-extern int
+WIMLIBAPI int
wimlib_mount_image(WIMStruct *wim,
int image,
const wimlib_tchar *dir,
* @retval ::WIMLIB_ERR_XML
* The XML data of the WIM was invalid.
*/
-extern int
+WIMLIBAPI int
wimlib_open_wim(const wimlib_tchar *wim_file,
int open_flags,
WIMStruct **wim_ret);
* progress function will receive ::WIMLIB_PROGRESS_MSG_VERIFY_INTEGRITY
* messages while checking the WIM file's integrity.
*/
-extern int
+WIMLIBAPI int
wimlib_open_wim_with_progress(const wimlib_tchar *wim_file,
int open_flags,
WIMStruct **wim_ret,
* ::WIMLIB_PROGRESS_MSG_WRITE_METADATA_BEGIN, and
* ::WIMLIB_PROGRESS_MSG_WRITE_METADATA_END.
*/
-extern int
+WIMLIBAPI int
wimlib_overwrite(WIMStruct *wim, int write_flags, unsigned num_threads);
/**
* This function is deprecated; use wimlib_get_xml_data() or
* wimlib_get_image_property() to query image information instead.
*/
-extern void
+WIMLIBAPI void
wimlib_print_available_images(const WIMStruct *wim, int image);
/**
*
* Print the header of the WIM file (intended for debugging only).
*/
-extern void
+WIMLIBAPI void
wimlib_print_header(const WIMStruct *wim);
/**
* This function can additionally return most values that can be returned by
* wimlib_open_wim().
*/
-extern int
+WIMLIBAPI int
wimlib_reference_resource_files(WIMStruct *wim,
const wimlib_tchar * const *resource_wimfiles_or_globs,
unsigned count,
*
* @return 0 on success; a ::wimlib_error_code value on failure.
*/
-extern int
+WIMLIBAPI int
wimlib_reference_resources(WIMStruct *wim, WIMStruct **resource_wims,
unsigned num_resource_wims, int ref_flags);
* indicate failure (for different reasons) to read the metadata resource for
* the template image.
*/
-extern int
+WIMLIBAPI int
wimlib_reference_template_image(WIMStruct *wim, int new_image,
WIMStruct *template_wim, int template_image,
int flags);
* The value which will be passed as the third argument to calls to @p
* progfunc.
*/
-extern void
+WIMLIBAPI void
wimlib_register_progress_function(WIMStruct *wim,
wimlib_progress_func_t progfunc,
void *progctx);
* This just builds an appropriate ::wimlib_rename_command and passes it to
* wimlib_update_image().
*/
-extern int
+WIMLIBAPI int
wimlib_rename_path(WIMStruct *wim, int image,
const wimlib_tchar *source_path, const wimlib_tchar *dest_path);
* images, an unnamed image must be specified by index to eliminate the
* ambiguity.)
*/
-extern int
+WIMLIBAPI int
wimlib_resolve_image(WIMStruct *wim,
const wimlib_tchar *image_name_or_num);
*
* @return 0
*/
-extern int
+WIMLIBAPI int
wimlib_set_error_file(FILE *fp);
/**
* @retval ::WIMLIB_ERR_OPEN
* The file named by @p path could not be opened for appending.
*/
-extern int
+WIMLIBAPI int
wimlib_set_error_file_by_name(const wimlib_tchar *path);
/**
*
* Note that "description" is misspelled in the name of this function.
*/
-extern int
+WIMLIBAPI int
wimlib_set_image_descripton(WIMStruct *wim, int image,
const wimlib_tchar *description);
* (usually something like "Core" or "Ultimate"). Equivalent to
* <tt>wimlib_set_image_property(wim, image, "FLAGS", flags)</tt>.
*/
-extern int
+WIMLIBAPI int
wimlib_set_image_flags(WIMStruct *wim, int image, const wimlib_tchar *flags);
/**
* Change the name of a WIM image. Equivalent to
* <tt>wimlib_set_image_property(wim, image, "NAME", name)</tt>.
*/
-extern int
+WIMLIBAPI int
wimlib_set_image_name(WIMStruct *wim, int image, const wimlib_tchar *name);
/**
* @p property_name has an unsupported format, or @p property_name included
* a bracketed index that was too high.
*/
-extern int
+WIMLIBAPI int
wimlib_set_image_property(WIMStruct *wim, int image,
const wimlib_tchar *property_name,
const wimlib_tchar *property_value);
*
* @return 0
*/
-extern int
+WIMLIBAPI int
wimlib_set_memory_allocator(void *(*malloc_func)(size_t),
void (*free_func)(void *),
void *(*realloc_func)(void *, size_t));
* @p chunk_size was not 0 or a supported chunk size for the currently
* selected output compression type.
*/
-extern int
+WIMLIBAPI int
wimlib_set_output_chunk_size(WIMStruct *wim, uint32_t chunk_size);
/**
* Similar to wimlib_set_output_chunk_size(), but set the chunk size for writing
* solid resources.
*/
-extern int
+WIMLIBAPI int
wimlib_set_output_pack_chunk_size(WIMStruct *wim, uint32_t chunk_size);
/**
* @retval ::WIMLIB_ERR_INVALID_COMPRESSION_TYPE
* @p ctype did not specify a valid compression type.
*/
-extern int
+WIMLIBAPI int
wimlib_set_output_compression_type(WIMStruct *wim,
enum wimlib_compression_type ctype);
* Similar to wimlib_set_output_compression_type(), but set the compression type
* for writing solid resources. This cannot be ::WIMLIB_COMPRESSION_TYPE_NONE.
*/
-extern int
+WIMLIBAPI int
wimlib_set_output_pack_compression_type(WIMStruct *wim,
enum wimlib_compression_type ctype);
*
* @return 0
*/
-extern int
+WIMLIBAPI int
wimlib_set_print_errors(bool show_messages);
/**
* ::wimlib_wim_info.boot_index did not specify 0 or a valid 1-based image
* index in the WIM.
*/
-extern int
+WIMLIBAPI int
wimlib_set_wim_info(WIMStruct *wim, const struct wimlib_wim_info *info,
int which);
* receive ::WIMLIB_PROGRESS_MSG_WRITE_STREAMS messages while writing each part;
* these messages will report the progress of the current part only.
*/
-extern int
+WIMLIBAPI int
wimlib_split(WIMStruct *wim,
const wimlib_tchar *swm_name,
uint64_t part_size,
* ::WIMLIB_PROGRESS_MSG_END_VERIFY_IMAGE, and
* ::WIMLIB_PROGRESS_MSG_VERIFY_STREAMS.
*/
-extern int
+WIMLIBAPI int
wimlib_verify_wim(WIMStruct *wim, int verify_flags);
/**
* by using the @c umount or @c fusermount programs. However, you need to call
* this function if you want changes to be committed.
*/
-extern int
+WIMLIBAPI int
wimlib_unmount_image(const wimlib_tchar *dir, int unmount_flags);
/**
* message. In addition, if changes are committed from a read-write mount, the
* progress function will receive ::WIMLIB_PROGRESS_MSG_WRITE_STREAMS messages.
*/
-extern int
+WIMLIBAPI int
wimlib_unmount_image_with_progress(const wimlib_tchar *dir,
int unmount_flags,
wimlib_progress_func_t progfunc,
* indicate failure (for different reasons) to read the metadata resource for an
* image that needed to be updated.
*/
-extern int
+WIMLIBAPI int
wimlib_update_image(WIMStruct *wim,
int image,
const struct wimlib_update_command *cmds,
* ::WIMLIB_PROGRESS_MSG_WRITE_METADATA_BEGIN, and
* ::WIMLIB_PROGRESS_MSG_WRITE_METADATA_END.
*/
-extern int
+WIMLIBAPI int
wimlib_write(WIMStruct *wim,
const wimlib_tchar *path,
int image,
* @p fd was not seekable, but ::WIMLIB_WRITE_FLAG_PIPABLE was not
* specified in @p write_flags.
*/
-extern int
+WIMLIBAPI int
wimlib_write_to_fd(WIMStruct *wim,
int fd,
int image,
* @retval ::WIMLIB_ERR_INVALID_COMPRESSION_TYPE
* @p ctype was neither a supported compression type nor -1.
*/
-extern int
+WIMLIBAPI int
wimlib_set_default_compression_level(int ctype, unsigned int compression_level);
/**
* compression type is invalid, or the @p max_block_size for that compression
* type is invalid.
*/
-extern uint64_t
+WIMLIBAPI uint64_t
wimlib_get_compressor_needed_memory(enum wimlib_compression_type ctype,
size_t max_block_size,
unsigned int compression_level);
* @retval ::WIMLIB_ERR_NOMEM
* Insufficient memory to allocate the compressor.
*/
-extern int
+WIMLIBAPI int
wimlib_create_compressor(enum wimlib_compression_type ctype,
size_t max_block_size,
unsigned int compression_level,
* The size of the compressed data, in bytes, or 0 if the data could not be
* compressed to @p compressed_size_avail or fewer bytes.
*/
-extern size_t
+WIMLIBAPI size_t
wimlib_compress(const void *uncompressed_data, size_t uncompressed_size,
void *compressed_data, size_t compressed_size_avail,
struct wimlib_compressor *compressor);
* @param compressor
* The compressor to free. If @c NULL, no action is taken.
*/
-extern void
+WIMLIBAPI void
wimlib_free_compressor(struct wimlib_compressor *compressor);
/**
* @retval ::WIMLIB_ERR_NOMEM
* Insufficient memory to allocate the decompressor.
*/
-extern int
+WIMLIBAPI int
wimlib_create_decompressor(enum wimlib_compression_type ctype,
size_t max_block_size,
struct wimlib_decompressor **decompressor_ret);
* as the @p uncompressed_size parameter. If this is not done correctly,
* decompression may fail or the data may be decompressed incorrectly.
*/
-extern int
+WIMLIBAPI int
wimlib_decompress(const void *compressed_data, size_t compressed_size,
void *uncompressed_data, size_t uncompressed_size,
struct wimlib_decompressor *decompressor);
* @param decompressor
* The decompressor to free. If @c NULL, no action is taken.
*/
-extern void
+WIMLIBAPI void
wimlib_free_decompressor(struct wimlib_decompressor *decompressor);
git://wimlib.net / wimlib / commitdiff