483d953a86
Save and restore (also known as suspend and resume) permits a snapshot to be taken of a guest's state that can later be resumed. In the current implementation, bhyve(8) creates a UNIX domain socket that is used by bhyvectl(8) to send a request to save a snapshot (and optionally exit after the snapshot has been taken). A snapshot currently consists of two files: the first holds a copy of guest RAM, and the second file holds other guest state such as vCPU register values and device model state. To resume a guest, bhyve(8) must be started with a matching pair of command line arguments to instantiate the same set of device models as well as a pointer to the saved snapshot. While the current implementation is useful for several uses cases, it has a few limitations. The file format for saving the guest state is tied to the ABI of internal bhyve structures and is not self-describing (in that it does not communicate the set of device models present in the system). In addition, the state saved for some device models closely matches the internal data structures which might prove a challenge for compatibility of snapshot files across a range of bhyve versions. The file format also does not currently support versioning of individual chunks of state. As a result, the current file format is not a fixed binary format and future revisions to save and restore will break binary compatiblity of snapshot files. The goal is to move to a more flexible format that adds versioning, etc. and at that point to commit to providing a reasonable level of compatibility. As a result, the current implementation is not enabled by default. It can be enabled via the WITH_BHYVE_SNAPSHOT=yes option for userland builds, and the kernel option BHYVE_SHAPSHOT. Submitted by: Mihai Tiganus, Flavius Anton, Darius Mihai Submitted by: Elena Mihailescu, Mihai Carabas, Sergiu Weisz Relnotes: yes Sponsored by: University Politehnica of Bucharest Sponsored by: Matthew Grooms (student scholarships) Sponsored by: iXsystems Differential Revision: https://reviews.freebsd.org/D19495
179 lines
4.5 KiB
Makefile
179 lines
4.5 KiB
Makefile
# $FreeBSD$
|
|
|
|
# Options set in the build system that affect the kernel somehow.
|
|
|
|
#
|
|
# Define MK_* variables (which are either "yes" or "no") for users
|
|
# to set via WITH_*/WITHOUT_* in /etc/src.conf and override in the
|
|
# make(1) environment.
|
|
# These should be tested with `== "no"' or `!= "no"' in makefiles.
|
|
# The NO_* variables should only be set by makefiles for variables
|
|
# that haven't been converted over.
|
|
#
|
|
|
|
# Note: bsd.own.mk must be included before the rest of kern.opts.mk to make
|
|
# building on 10.x and earlier work. This should be removed when that's no
|
|
# longer supported since it confounds the defaults (since it uses the host's
|
|
# notion of defaults rather than what's default in current when building
|
|
# within sys/modules).
|
|
.include <bsd.own.mk>
|
|
|
|
# These options are used by the kernel build process (kern.mk and kmod.mk)
|
|
# They have to be listed here so we can build modules outside of the
|
|
# src tree.
|
|
|
|
KLDXREF_CMD?= kldxref
|
|
|
|
__DEFAULT_YES_OPTIONS = \
|
|
AUTOFS \
|
|
BHYVE \
|
|
BLUETOOTH \
|
|
CCD \
|
|
CDDL \
|
|
CRYPT \
|
|
CUSE \
|
|
EFI \
|
|
FORMAT_EXTENSIONS \
|
|
INET \
|
|
INET6 \
|
|
IPFILTER \
|
|
IPSEC_SUPPORT \
|
|
ISCSI \
|
|
KERNEL_SYMBOLS \
|
|
NETGRAPH \
|
|
PF \
|
|
SOURCELESS_HOST \
|
|
SOURCELESS_UCODE \
|
|
TESTS \
|
|
USB_GADGET_EXAMPLES \
|
|
ZFS
|
|
|
|
__DEFAULT_NO_OPTIONS = \
|
|
BHYVE_SNAPSHOT \
|
|
EXTRA_TCP_STACKS \
|
|
KERNEL_RETPOLINE \
|
|
OFED \
|
|
RATELIMIT \
|
|
REPRODUCIBLE_BUILD
|
|
|
|
# Some options are totally broken on some architectures. We disable
|
|
# them. If you need to enable them on an experimental basis, you
|
|
# must change this code.
|
|
# Note: These only apply to the list of modules we build by default
|
|
# and sometimes what is in the opt_*.h files by default.
|
|
# Kernel config files are unaffected, though some targets can be
|
|
# affected by KERNEL_SYMBOLS, FORMAT_EXTENSIONS, CTF and SSP.
|
|
|
|
# Things that don't work based on the CPU
|
|
.if ${MACHINE_CPUARCH} == "arm"
|
|
. if ${MACHINE_ARCH:Marmv[67]*} == ""
|
|
BROKEN_OPTIONS+= CDDL ZFS
|
|
. endif
|
|
.endif
|
|
|
|
.if ${MACHINE_CPUARCH} == "mips"
|
|
BROKEN_OPTIONS+= CDDL ZFS SSP
|
|
.endif
|
|
|
|
.if ${MACHINE_CPUARCH} == "powerpc" && ${MACHINE_ARCH} == "powerpc"
|
|
BROKEN_OPTIONS+= ZFS
|
|
.endif
|
|
|
|
.if ${MACHINE_CPUARCH} == "riscv"
|
|
BROKEN_OPTIONS+= FORMAT_EXTENSIONS
|
|
.endif
|
|
|
|
# Things that don't work because the kernel doesn't have the support
|
|
# for them.
|
|
.if ${MACHINE} != "i386" && ${MACHINE} != "amd64"
|
|
BROKEN_OPTIONS+= OFED
|
|
.endif
|
|
|
|
# Things that don't work based on toolchain support.
|
|
.if ${MACHINE} != "i386" && ${MACHINE} != "amd64"
|
|
BROKEN_OPTIONS+= KERNEL_RETPOLINE
|
|
.endif
|
|
|
|
# EFI doesn't exist on mips, powerpc, or riscv.
|
|
.if ${MACHINE:Mmips} || ${MACHINE:Mpowerpc} || ${MACHINE:Mriscv}
|
|
BROKEN_OPTIONS+=EFI
|
|
.endif
|
|
|
|
# expanded inline from bsd.mkopt.mk to avoid share/mk dependency
|
|
|
|
# Those that default to yes
|
|
.for var in ${__DEFAULT_YES_OPTIONS}
|
|
.if !defined(MK_${var})
|
|
.if defined(WITHOUT_${var}) # WITHOUT always wins
|
|
MK_${var}:= no
|
|
.else
|
|
MK_${var}:= yes
|
|
.endif
|
|
.else
|
|
.if ${MK_${var}} != "yes" && ${MK_${var}} != "no"
|
|
.error "Illegal value for MK_${var}: ${MK_${var}}"
|
|
.endif
|
|
.endif # !defined(MK_${var})
|
|
.endfor
|
|
.undef __DEFAULT_YES_OPTIONS
|
|
|
|
# Those that default to no
|
|
.for var in ${__DEFAULT_NO_OPTIONS}
|
|
.if !defined(MK_${var})
|
|
.if defined(WITH_${var}) && !defined(WITHOUT_${var}) # WITHOUT always wins
|
|
MK_${var}:= yes
|
|
.else
|
|
MK_${var}:= no
|
|
.endif
|
|
.else
|
|
.if ${MK_${var}} != "yes" && ${MK_${var}} != "no"
|
|
.error "Illegal value for MK_${var}: ${MK_${var}}"
|
|
.endif
|
|
.endif # !defined(MK_${var})
|
|
.endfor
|
|
.undef __DEFAULT_NO_OPTIONS
|
|
|
|
#
|
|
# MK_* options which are always no, usually because they are
|
|
# unsupported/badly broken on this architecture.
|
|
#
|
|
.for var in ${BROKEN_OPTIONS}
|
|
MK_${var}:= no
|
|
.endfor
|
|
.undef BROKEN_OPTIONS
|
|
#end of bsd.mkopt.mk expanded inline.
|
|
|
|
#
|
|
# MK_*_SUPPORT options which default to "yes" unless their corresponding
|
|
# MK_* variable is set to "no".
|
|
#
|
|
.for var in \
|
|
INET \
|
|
INET6
|
|
.if defined(WITHOUT_${var}_SUPPORT) || ${MK_${var}} == "no"
|
|
MK_${var}_SUPPORT:= no
|
|
.else
|
|
.if defined(KERNBUILDDIR) # See if there's an opt_foo.h
|
|
.if !defined(OPT_${var})
|
|
OPT_${var}!= cat ${KERNBUILDDIR}/opt_${var:tl}.h; echo
|
|
.export OPT_${var}
|
|
.endif
|
|
.if ${OPT_${var}} == "" # nothing -> no
|
|
MK_${var}_SUPPORT:= no
|
|
.else
|
|
MK_${var}_SUPPORT:= yes
|
|
.endif
|
|
.else # otherwise, yes
|
|
MK_${var}_SUPPORT:= yes
|
|
.endif
|
|
.endif
|
|
.endfor
|
|
|
|
# Some modules only compile successfully if option FDT is set, due to #ifdef FDT
|
|
# wrapped around declarations. Module makefiles can optionally compile such
|
|
# things using .if !empty(OPT_FDT)
|
|
.if !defined(OPT_FDT) && defined(KERNBUILDDIR)
|
|
OPT_FDT!= sed -n '/FDT/p' ${KERNBUILDDIR}/opt_platform.h
|
|
.export OPT_FDT
|
|
.endif
|