Skip to content

Commit 48afec7

Browse files
committed
doc: add info about T2S template
Signed-off-by: Nikita Kalyazin <[email protected]>
1 parent 153e3f1 commit 48afec7

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

docs/snapshotting/versioning.md

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -184,12 +184,16 @@ architecture. They are only compatible if the CPU features exposed to the guest
184184
are an invariant when saving and restoring the snapshot. The trivial scenario
185185
is creating and restoring snapshots on hosts that have the same CPU model.
186186

187-
To make snapshots more portable across Intel CPUs Firecracker provides an API
188-
to select a CPU template which is only available for Intel - T2 and C3.
189-
Firecracker CPU templates mask CPUID to restrict the exposed features to a
190-
common denominator of multiple CPU models. These templates are mapped as close
191-
as possible to AWS T2/C3 instances in terms of CPU features. There are no
192-
templates available for AMD or ARM64.
187+
To make snapshots more portable across Intel CPUs Firecracker provides an API to
188+
select a CPU template which is only available for Intel - T2, T2S and C3.
189+
Firecracker CPU templates mask CPUID and some MSR values (in case of T2S) to
190+
restrict the exposed features to a common denominator of multiple CPU models. T2
191+
and C3 templates are mapped as close as possible to AWS T2/C3 instances in terms
192+
of CPU features. The T2S template is designed to allow migrating snapshots
193+
between hosts with Intel SkyLake and Cascade Lake securely by further
194+
restricting CPU features for the guest, however this comes with a performance
195+
penalty. Users are encouraged to carry out a performance assessment if they wish
196+
to use the T2S template. There are no templates available for AMD or ARM64.
193197

194198
It is important to note that guest workloads can still execute instructions
195199
that are being masked by CPUID and restoring and saving of such workloads will

0 commit comments

Comments
 (0)