diffmeasuredboot

Documentation

Index

• Constants
• func Diagnose(log logger.Logger, diffRanges pkgbytes.Ranges, origImage *uefi.UEFI, ...) diffanalysis.DiffDiagnosis
• func New() analysis.Analyzer[Input]
• func NewExecutorInput(originalFirmware analysis.Blob, actualFirmware analysis.Blob, ...) (analysis.Input, error)
• type DiffMeasuredBoot
  • func (analyzer *DiffMeasuredBoot) Analyze(ctx context.Context, input Input) (*analysis.Report, error)
  • func (analyzer *DiffMeasuredBoot) ID() analysis.AnalyzerID
• type Input

Constants

const ID analysis.AnalyzerID = diffanalysis.DiffMeasuredBootAnalyzerID

ID represents the unique id of DiffMeasuredBoot analyzer

Functions

func Diagnose

func Diagnose(
	log logger.Logger,
	diffRanges pkgbytes.Ranges,
	origImage *uefi.UEFI,
	modifiedImage analysis.ActualFirmwareBlob,
	actualBIOSInfo *analysis.ActualBIOSInfo,
	origBIOSInfo *analysis.OriginalBIOSInfo,
) diffanalysis.DiffDiagnosis

Diagnose provides the diagnosis how to interpret an image corruption.

func New

func New() analysis.Analyzer[Input]

New creates a new instance of DiffMeasuredBoot

func NewExecutorInput

func NewExecutorInput(
	originalFirmware analysis.Blob,
	actualFirmware analysis.Blob,
	regs registers.Registers,
	tpm tpmdetection.Type,
	eventlog *tpmeventlog.TPMEventLog,
	actualPCR []byte,
	enforcedMeasurementsFlow *pcr.Flow,
) (analysis.Input, error)

NewExecutorInput builds an analysis.Executor's input required for DiffMeasuredBoot analyzer

Optional arguments: tpm, eventlog, actualPCR and enforcedMeasurementsFlow

Types

type DiffMeasuredBoot

type DiffMeasuredBoot struct {
}

DiffMeasuredBoot represents the analyzer

func (*DiffMeasuredBoot) Analyze

func (analyzer *DiffMeasuredBoot) Analyze(
	ctx context.Context,
	input Input,
) (*analysis.Report, error)

Analyze makes the difference analysis of firmwares

func (*DiffMeasuredBoot) ID

func (analyzer *DiffMeasuredBoot) ID() analysis.AnalyzerID

ID implements the ID method required for analysis.Analyzer

type Input

type Input struct {
	ActualFirmware   analysis.ActualFirmwareBlob
	OriginalFirmware analysis.OriginalFirmware
	ActualBIOSInfo   *analysis.ActualBIOSInfo   `exec:"optional"`
	OriginalBIOSInfo *analysis.OriginalBIOSInfo `exec:"optional"`
	AlignedOrigFW    analysis.AlignedOriginalFirmware
	StatusRegisters  analysis.FixedRegisters
	BootFlow         types.BootFlow
	HostAssetID      *analysis.AssetID `exec:"optional"`
}

Input describes the input data for the DiffMeasuredBoot analyzer