wimlib

README

go-wimlib

Go bindings for wimlib, the library behind wimlib-imagex. It covers what you need to work with Windows WIM images from Go: open and create archives, extract full images or single paths, add and delete files in an image, export images between archives (ESD to WIM included), and set image names and boot flags.

Two extras go beyond the usual imaging calls. Decompressor gives you raw LZX/LZMS block decompression, and the dcs package uses it to parse CBS delta-compressed stores, the format Windows packages hide their payloads in. ListChildren enumerates a directory inside an image without extracting anything.

The cgo bindings sit behind the wimlib build tag, so plain go build compiles a stub that returns errors instead, and packages that import this one still build on machines without libwim. Build with -tags wimlib (and libwim installed) to get the real thing. This library is part of the Windows tooling behind devcell; pin a version, there is no v1 yet.

go get github.com/devcell-sh/go-wimlib

Documentation

Index

• func Available() bool
• func DecompressDCS(data []byte) ([]byte, error)
• func IsDCS(data []byte) bool
• type Compression
• type Decompressor
  • func NewDecompressor(ctype Compression, maxBlockSize int) (*Decompressor, error)
  • func (d *Decompressor) Close()
  • func (d *Decompressor) Decompress(compressed []byte, uncompressedSize int) ([]byte, error)
• type ProgressFunc
• type WIM
  • func CreateWIM(compression Compression) (*WIM, error)
  • func OpenWIM(path string) (*WIM, error)
  • func (w *WIM) Close()
  • func (w *WIM) ExportImage(imageNum int, dest *WIM, compression Compression) error
  • func (w *WIM) ExtractImage(imageNum int, targetDir string, onProgress ProgressFunc) error
  • func (w *WIM) ExtractPaths(imageNum int, targetDir string, wimPaths []string) error
  • func (w *WIM) ImageCount() (int, error)
  • func (w *WIM) ImageDescription(imageNum int) (string, error)
  • func (w *WIM) ListChildren(imageNum int, wimDirPath string) ([]string, error)
  • func (w *WIM) Overwrite() error
  • func (w *WIM) ReferenceResourceFilePaths(paths []string) error
  • func (w *WIM) ReferenceResourceFiles(globs []string) error
  • func (w *WIM) SetBootImage(imageNum int) error
  • func (w *WIM) SetImageName(imageNum int, name, description string) error
  • func (w *WIM) SetImageProperty(imageNum int, propertyName, propertyValue string) error
  • func (w *WIM) UpdateImageAdd(imageNum int, fsSourcePath, wimTargetPath string) error
  • func (w *WIM) UpdateImageAddTree(imageNum int, fsRootDir, wimRootDir string) error
  • func (w *WIM) UpdateImageDelete(imageNum int, wimPath string) error
  • func (w *WIM) Write(path string) error

Functions

func Available

func Available() bool

func DecompressDCS

func DecompressDCS(data []byte) ([]byte, error)

DecompressDCS decompresses a DCS\x01 container (CBS delta-compressed store). The format wraps LZMS-compressed blocks:

Header (12 bytes): Signature(4) + NumberOfBlocks(4, LE) + UncompressedFileSize(4, LE)
Per block: BlockSize(4, LE) + DecompressedBlockSize(4, LE) + CompressedData[BlockSize-4]
Next block starts at current offset + BlockSize + 4.

func IsDCS

func IsDCS(data []byte) bool

IsDCS checks whether data starts with the DCS\x01 signature.

Types

type Compression

type Compression int

Compression type for WIM images.

const (
	None Compression = 0
	LZX  Compression = 1
	LZMS Compression = 2
)

type Decompressor

type Decompressor struct {
	// contains filtered or unexported fields
}

Decompressor wraps a wimlib decompressor handle for raw block decompression.

func NewDecompressor

func NewDecompressor(ctype Compression, maxBlockSize int) (*Decompressor, error)

func (*Decompressor) Close

func (d *Decompressor) Close()

func (*Decompressor) Decompress

func (d *Decompressor) Decompress(compressed []byte, uncompressedSize int) ([]byte, error)

type ProgressFunc

type ProgressFunc func(percentDone int)

ProgressFunc is called during long WIM operations with completion percentage.

type WIM

type WIM struct {
	// contains filtered or unexported fields
}

WIM represents an open WIM archive.

func CreateWIM

func CreateWIM(compression Compression) (*WIM, error)

func OpenWIM

func OpenWIM(path string) (*WIM, error)

func (*WIM) Close

func (w *WIM) Close()

func (*WIM) ExportImage

func (w *WIM) ExportImage(imageNum int, dest *WIM, compression Compression) error

func (*WIM) ExtractImage

func (w *WIM) ExtractImage(imageNum int, targetDir string, onProgress ProgressFunc) error

func (*WIM) ExtractPaths

func (w *WIM) ExtractPaths(imageNum int, targetDir string, wimPaths []string) error

func (*WIM) ImageCount

func (w *WIM) ImageCount() (int, error)

func (*WIM) ImageDescription

func (w *WIM) ImageDescription(imageNum int) (string, error)

func (*WIM) ListChildren

func (w *WIM) ListChildren(imageNum int, wimDirPath string) ([]string, error)

func (*WIM) Overwrite

func (w *WIM) Overwrite() error

func (*WIM) ReferenceResourceFilePaths

func (w *WIM) ReferenceResourceFilePaths(paths []string) error

func (*WIM) ReferenceResourceFiles

func (w *WIM) ReferenceResourceFiles(globs []string) error

func (*WIM) SetBootImage

func (w *WIM) SetBootImage(imageNum int) error

func (*WIM) SetImageName

func (w *WIM) SetImageName(imageNum int, name, description string) error

func (*WIM) SetImageProperty

func (w *WIM) SetImageProperty(imageNum int, propertyName, propertyValue string) error

func (*WIM) UpdateImageAdd

func (w *WIM) UpdateImageAdd(imageNum int, fsSourcePath, wimTargetPath string) error

func (*WIM) UpdateImageAddTree

func (w *WIM) UpdateImageAddTree(imageNum int, fsRootDir, wimRootDir string) error

func (*WIM) UpdateImageDelete

func (w *WIM) UpdateImageDelete(imageNum int, wimPath string) error

func (*WIM) Write

func (w *WIM) Write(path string) error