bisect

Documentation

Index

• Constants
• func Run(cfg *Config) ([]*vcs.Commit, *report.Report, *vcs.Commit, error)
• type Config
• type KernelConfig
• type ReproConfig
• type SyzkallerConfig

Constants

const NumTests = 10 // number of tests we do per commit

Functions

func Run

func Run(cfg *Config) ([]*vcs.Commit, *report.Report, *vcs.Commit, error)

Run does the bisection and returns:

• if bisection is conclusive, the single cause/fix commit
• for cause bisection report is the crash on the cause commit
• for fix bisection report is nil
• *vcs.Commit will be nil
• if bisection is inconclusive, range of potential cause/fix commits
• report is nil in such case
• *vcs.Commit will be nil
• if the crash still happens on the oldest release/HEAD (for cause/fix bisection correspondingly), no commits and the crash report on the oldest release/HEAD; and *vcs.Commit will point to the oldest/latest commit where crash happens.
• if the crash is not reproduced on the start commit, an error, *vcs.Commit will be nil

Types

type Config

type Config struct {
	Trace     io.Writer
	Fix       bool
	BinDir    string
	DebugDir  string
	Kernel    KernelConfig
	Syzkaller SyzkallerConfig
	Repro     ReproConfig
	Manager   mgrconfig.Config
}

type KernelConfig

type KernelConfig struct {
	Repo      string
	Branch    string
	Commit    string
	Cmdline   string
	Sysctl    string
	Config    []byte
	Userspace string
}

type ReproConfig

type ReproConfig struct {
	Opts []byte
	Syz  []byte
	C    []byte
}

type SyzkallerConfig

type SyzkallerConfig struct {
	Repo         string
	Commit       string
	Descriptions string
}