build

func Image ¶

func Image(params Params) (details ImageDetails, err 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 structure contains 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. Also that structure provides a compiler ID field that contains the name and the version of the compiler/toolchain that was used to build the kernel. The CompilerID field is not guaranteed to be non-empty.