build

package
v0.0.0-...-26c8979 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jun 2, 2021 License: Apache-2.0 Imports: 21 Imported by: 0

Documentation

Overview

Package build contains helper functions for building kernels/images.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Clean

func Clean(targetOS, targetArch, vmType, kernelDir string) error

func CompilerIdentity

func CompilerIdentity(compiler string) (string, error)

func Image

func Image(params *Params) (string, error)

Image creates a disk image for the specified OS/ARCH/VM. Kernel is taken from KernelDir, userspace system is taken from UserspaceDir. If CmdlineFile is not empty, contents of the file are appended to the kernel command line. If SysctlFile is not empty, contents of the file are appended to the image /etc/sysctl.conf. Output is stored in OutputDir and includes (everything except for image is optional):

  • image: the image
  • key: ssh key for the image
  • kernel: kernel for injected boot
  • initrd: initrd for injected boot
  • kernel.config: actual kernel config used during build
  • obj/: directory with kernel object files (this should match KernelObject specified in sys/targets, e.g. vmlinux for linux)

The returned string is a kernel ID that will be the same for kernels with the same runtime behavior, and different for kernels with different runtime behavior. Binary equal builds, or builds that differ only in e.g. debug info, have the same ID. The ID may be empty if OS implementation does not have a way to calculate such IDs.

Types

type KernelBuildError

type KernelBuildError struct {
	*osutil.VerboseError
}

type Params

type Params struct {
	TargetOS     string
	TargetArch   string
	VMType       string
	KernelDir    string
	OutputDir    string
	Compiler     string
	UserspaceDir string
	CmdlineFile  string
	SysctlFile   string
	Config       []byte
}

Params is input arguments for the Image function.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL