IMAGEX

Section: User Commands (1)
Updated: June 2013
Index

NAME

wimlib-imagex-extract - Extract files or directories from a WIM image

SYNOPSIS

wimlib-imagex extract WIMFILE IMAGE [PATH...] [OPTION...]

DESCRIPTION

wimlib-imagex extract extracts one or more files or directory treesfrom the specified IMAGE contained in the Windows Imaging (WIM) fileWIMFILE.

wimlib-imagex extract is intended for extracting only a subset of aWIM image. If you want to extract or "apply" a full WIM image to a directory orNTFS volume, use wimlib-imagex apply (1) instead.

IMAGE specifies the image in WIMFILE that contains the files ordirectory trees to extract. It may be a 1-based index of an image in the WIM orthe name of an image in the WIM. Use the wimlib-imagex info (1)command to show what images a WIM file contains.

Each PATH specifies a file or directory tree within the WIM image toextract. See PATH_SPECIFICATIONS.

By default, files and directories are extracted to the current directory. Use--dest-dir to choose an alternate target directory. Alternatively, use--to-stdout to extract a file to standard output to pipe into anotherprogram.

wimlib-imagex extract supports extracting files and directory treesfrom stand-alone WIMs as well as split WIMs. See SPLIT WIMS.

PATH SPECIFICATIONS

Each PATH specifies a file or directory tree within the WIM image toextract. Each path must be specified as an absolute path starting from the rootof the WIM image, like those output by the wimlib-imagex dir (1)command. However, path separators may be either forward or backward slashes,and the leading slash is optional; also, on Windows, the paths are treatedcase-insensitively, while on UNIX, paths are treated case-sensitively.

If no PATHs are provided, the default behavior is to extract the fullimage, as if the path "/" had been provided.

SPLIT WIMS

You may use wimlib-imagex extract to extract files or directory treesfrom a split WIM. This uses the --refs="GLOB" option in the sameway as in other commands such as wimlib-imagex apply. Seewimlib-imagex apply (1) for more details.

OPTIONS

--check: When reading WIMFILE, verify its integrity if an integrity table ispresent.
--ref="GLOB": File glob of additional split WIM parts that are part of the split WIM. SeeSPLIT_WIMS.
--verbose: Print the path of each file or directory within the WIM image as it isextracted.
--unix-data: See the documentation for this option in wimlib-imagex-apply (1).
--no-acls: See the documentation for this option in wimlib-imagex-apply (1).
--strict-acls: See the documentation for this option in wimlib-imagex-apply (1).
--include-invalid-names: See the documentation for this option in wimlib-imagex-apply (1).
--to-stdout: Extract the files to standard output instead of to the filesystem. This canonly be provided if all the specified PATHs are to regular files (notdirectories or reparse points). If present, alternate data streams are notextracted.
--dest-dir=DIR: Extract the files and directories to the directory DIR instead of to thecurrent working directory.

NOTES

See the documentation wimlib-imagex apply (1) for documentation aboutwhat data and metadata are extracted on UNIX versus on Windows.

On UNIX, one can alternatively mount the WIM image with wimlib-imagexmount and then extract the desired files or directories using any standardcommand-line or graphical program.

Reparse-point fixups (a.k.a. changing absolute symbolic links and junctions topoint within the extraction location) are never done by wimlib-imagexextract. Use wimlib-imagex apply if you want this behavior.

Unlike wimlib-imagex apply, wimlib-imagex extract does notsupport extracting files directly to a NTFS volume using libntfs-3g.

EXAMPLES

Extract a file from the first image in "boot.wim" to the current directory:

: wimlib-imagex extract boot.wim 1 /Windows/System32/notepad.exe

Extract a file from the first image in "boot.wim" to standard output:

: wimlib-imagex extract boot.wim 1 /Windows/System32/notepad.exe --to-stdout

Extract a file from the first image in "boot.wim" to the specified directory:

: wimlib-imagex extract boot.wim 1 /Windows/System32/notepad.exe --dest-dir=somedir

Extract the "sources" directory from the first image in "boot.wim" to thecurrent directory:

: wimlib-imagex extract boot.wim 1 /sources

Extract multiple files and directories in one command:

: wimlib-imagex extract boot.wim 1 /Windows/Fonts /sources /Windows/System32/cmd.exe

This document was created byman2html,using the manual pages.