instance

Documentation

Overview

Package instance provides helper functions for creation of temporal instances used for testing of images, patches and bisection.

Index

• func ExecprogCmd(execprog, executor, OS, arch, sandbox string, repeat, threaded, collide bool, ...) string
• func FuzzerCmd(fuzzer, executor, name, OS, arch, fwdAddr, sandbox string, ...) string
• func SetConfigImage(cfg *mgrconfig.Config, imageDir string) error
• type CrashError
  • func (err *CrashError) Error() string
• type Env
  • func NewEnv(cfg *mgrconfig.Config) (*Env, error)
  • func (env *Env) BuildKernel(compilerBin, userspaceDir, cmdlineFile, sysctlFile string, kernelConfig []byte) error
  • func (env *Env) BuildSyzkaller(repo, commit string) error
  • func (env *Env) Test(numVMs int, reproSyz, reproOpts, reproC []byte) ([]error, error)
• type TestError
  • func (err *TestError) Error() string

Functions

func ExecprogCmd

func ExecprogCmd(execprog, executor, OS, arch, sandbox string, repeat, threaded, collide bool,
	procs, faultCall, faultNth int, progFile string) string

func FuzzerCmd

func FuzzerCmd(fuzzer, executor, name, OS, arch, fwdAddr, sandbox string, procs, verbosity int,
	cover, debug, test, runtest bool) string

func SetConfigImage

func SetConfigImage(cfg *mgrconfig.Config, imageDir string) error

Types

type CrashError

type CrashError struct {
	Report *report.Report
}

func (*CrashError) Error

func (err *CrashError) Error() string

type Env

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

func NewEnv

func NewEnv(cfg *mgrconfig.Config) (*Env, error)

func (*Env) BuildKernel

func (env *Env) BuildKernel(compilerBin, userspaceDir, cmdlineFile, sysctlFile string, kernelConfig []byte) error

func (*Env) BuildSyzkaller

func (env *Env) BuildSyzkaller(repo, commit string) error

func (*Env) Test

func (env *Env) Test(numVMs int, reproSyz, reproOpts, reproC []byte) ([]error, error)

Test boots numVMs VMs, tests basic kernel operation, and optionally tests the provided reproducer. TestError is returned if there is a problem with kernel/image (crash, reboot loop, etc). CrashError is returned if the reproducer crashes kernel.

type TestError

type TestError struct {
	Boot   bool // says if the error happened during booting or during instance testing
	Title  string
	Output []byte
	Report *report.Report
}

func (*TestError) Error

func (err *TestError) Error() string