uacfull

Documentation

Overview

Package uacfull carries a complete UAC tree for the differential harness.

This is separate from internal/uacdata on purpose. That package holds only the artifact definitions -- 49 KiB -- and is linked into the shipped binary. This one holds the whole shell implementation including bin/, which is 8.6 MB of precompiled tools for a dozen architectures. Nothing outside the harness imports it, so none of that reaches the uacscan executable.

Unlike uacdata this really does unpack onto disk, because the harness has to execute ./uac: you cannot exec a script out of an in-memory filesystem.

Regenerate after updating the UAC checkout. This archive comes first, because internal/uacdata's is derived from it:

go generate ./test/uacfull ./internal/uacdata

Index

• func Cleanup()
• func Dir() (string, error)
• func Extract(dir string) error
• func Version() (release, commitHash string)

Functions

func Cleanup

func Cleanup()

Cleanup removes a directory produced by Dir.

func Dir

func Dir() (string, error)

Dir unpacks the embedded UAC tree the first time it is called and returns the directory. Subsequent calls reuse it, so a test binary pays the unpacking cost once rather than per test.

The directory is created under the OS temp dir and left in place: it is cheaper to let one 20 MB tree persist for the run than to unpack it repeatedly. Callers that care can pass it to Cleanup.

func Extract

func Extract(dir string) error

Extract unpacks the embedded tree into dir.

func Version

func Version() (release, commitHash string)

Version reports which UAC release and commit the embedded tree came from.