blob: 7d406d9670f37a4e85c9eb596460792b9957f1f4 [file] [log] [blame]
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001// Copyright 2021, The Android Open Source Project
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7// http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
Andrew Walbranf6bf6862021-05-21 12:41:13 +000015//! Implementation of the AIDL interface of the VirtualizationService.
Andrew Walbrand6dce6f2021-03-05 16:39:08 +000016
Seungjae Yoo13af0b62024-05-20 14:15:13 +090017use crate::{get_calling_pid, get_calling_uid, get_this_pid};
Alan Stokesfda70842023-12-20 17:50:14 +000018use crate::atom::{write_vm_booted_stats, write_vm_creation_stats};
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +000019use crate::composite::make_composite_image;
Mu-Le Leeb2d5a312024-06-05 10:52:47 +080020use crate::crosvm::{AudioConfig, CrosvmConfig, DiskFile, DisplayConfig, GpuConfig, InputDeviceOption, PayloadState, VmContext, VmInstance, VmState};
Jaewan Kim61f86142023-03-28 15:12:52 +090021use crate::debug_config::DebugConfig;
Shikha Panwar55e10ec2024-02-13 12:53:49 +000022use crate::dt_overlay::{create_device_tree_overlay, VM_DT_OVERLAY_MAX_SIZE, VM_DT_OVERLAY_PATH};
Nikita Ioffe5dfddf22023-06-29 16:11:26 +010023use crate::payload::{add_microdroid_payload_images, add_microdroid_system_images, add_microdroid_vendor_image};
Seungjae Yoofd9a0622022-10-14 10:01:29 +090024use crate::selinux::{getfilecon, SeContext};
Jiyong Park753553b2021-07-12 21:21:09 +090025use android_os_permissions_aidl::aidl::android::os::IPermissionController;
David Brazdil49f96f52022-12-16 21:29:13 +000026use android_system_virtualizationcommon::aidl::android::system::virtualizationcommon::{
Alice Wang4e3015d2023-10-10 09:35:37 +000027 Certificate::Certificate,
Andrew Walbranc92d35f2022-01-12 12:45:19 +000028 DeathReason::DeathReason,
David Brazdil49f96f52022-12-16 21:29:13 +000029 ErrorCode::ErrorCode,
30};
31use android_system_virtualizationservice::aidl::android::system::virtualizationservice::{
Inseob Kim53d0b212023-07-20 16:58:37 +090032 AssignableDevice::AssignableDevice,
David Brazdil7d1e5ec2023-02-06 17:56:29 +000033 CpuTopology::CpuTopology,
Andrew Walbran6b650662021-09-07 13:13:23 +000034 DiskImage::DiskImage,
Jeongik Chac181be72024-03-27 00:18:30 +090035 InputDevice::InputDevice,
Alan Stokes0cc59ee2021-09-24 11:20:34 +010036 IVirtualMachine::{BnVirtualMachine, IVirtualMachine},
Andrew Walbran6b650662021-09-07 13:13:23 +000037 IVirtualMachineCallback::IVirtualMachineCallback,
38 IVirtualizationService::IVirtualizationService,
Keir Frasercdd4b112022-11-24 14:02:25 +000039 MemoryTrimLevel::MemoryTrimLevel,
Jiyong Park029977d2021-11-24 21:56:49 +090040 Partition::Partition,
Andrew Walbran6b650662021-09-07 13:13:23 +000041 PartitionType::PartitionType,
Inseob Kim0168b462022-12-27 14:54:35 +090042 VirtualMachineAppConfig::{DebugLevel::DebugLevel, Payload::Payload, VirtualMachineAppConfig},
Jooyung Han21e9b922021-06-26 04:14:16 +090043 VirtualMachineConfig::VirtualMachineConfig,
Andrew Walbran6b650662021-09-07 13:13:23 +000044 VirtualMachineDebugInfo::VirtualMachineDebugInfo,
Alan Stokes0d1ef782022-09-27 13:46:35 +010045 VirtualMachinePayloadConfig::VirtualMachinePayloadConfig,
Jooyung Han21e9b922021-06-26 04:14:16 +090046 VirtualMachineRawConfig::VirtualMachineRawConfig,
Andrew Walbran6b650662021-09-07 13:13:23 +000047 VirtualMachineState::VirtualMachineState,
Jooyung Han21e9b922021-06-26 04:14:16 +090048};
David Brazdilafc9a9e2023-01-12 16:08:10 +000049use android_system_virtualizationservice_internal::aidl::android::system::virtualizationservice_internal::IVirtualizationServiceInternal::IVirtualizationServiceInternal;
Seungjae Yoodd91f0f2022-11-09 15:25:21 +090050use android_system_virtualmachineservice::aidl::android::system::virtualmachineservice::IVirtualMachineService::{
David Brazdilafc9a9e2023-01-12 16:08:10 +000051 BnVirtualMachineService, IVirtualMachineService,
Seungjae Yoofd9a0622022-10-14 10:01:29 +090052};
Shikha Panware45e9422024-02-28 21:18:10 +000053use android_hardware_security_secretkeeper::aidl::android::hardware::security::secretkeeper::ISecretkeeper::{BnSecretkeeper, ISecretkeeper};
Shikha Panwar5d6a6752023-12-14 22:08:26 +000054use android_hardware_security_secretkeeper::aidl::android::hardware::security::secretkeeper::SecretId::SecretId;
55use android_hardware_security_authgraph::aidl::android::hardware::security::authgraph::{
56 Arc::Arc as AuthgraphArc, IAuthGraphKeyExchange::IAuthGraphKeyExchange,
57 IAuthGraphKeyExchange::BnAuthGraphKeyExchange, Identity::Identity, KeInitResult::KeInitResult,
58 Key::Key, PubKey::PubKey, SessionIdSignature::SessionIdSignature, SessionInfo::SessionInfo,
59 SessionInitiationInfo::SessionInitiationInfo,
60};
Alan Stokes25f69362023-03-06 16:51:54 +000061use anyhow::{anyhow, bail, Context, Result};
Seungjae Yoofd9a0622022-10-14 10:01:29 +090062use apkverify::{HashAlgorithm, V4Signature};
Jiyong Parkd7bd2f22023-08-10 20:41:19 +090063use avflog::LogResult;
Alan Stokes0e82b502022-08-08 14:44:48 +010064use binder::{
David Brazdilafc9a9e2023-01-12 16:08:10 +000065 self, wait_for_interface, BinderFeatures, ExceptionCode, Interface, ParcelFileDescriptor,
66 Status, StatusCode, Strong,
Jiyong Park2227eaa2023-08-04 11:59:18 +090067 IntoBinderResult,
Andrew Walbrana89fc132021-03-17 17:08:36 +000068};
Shikha Panwar55e10ec2024-02-13 12:53:49 +000069use cstr::cstr;
Inseob Kim46257382024-01-03 15:41:22 +090070use glob::glob;
David Brazdil49f96f52022-12-16 21:29:13 +000071use lazy_static::lazy_static;
Seungjae Yoo0a8c84c2022-07-11 08:19:15 +000072use log::{debug, error, info, warn};
Inseob Kim89b24592024-02-23 18:59:43 +090073use microdroid_payload_config::{ApkConfig, Task, TaskType, VmPayloadConfig};
Inseob Kim0168b462022-12-27 14:54:35 +090074use nix::unistd::pipe;
David Brazdil73988ea2022-11-11 15:10:32 +000075use rpcbinder::RpcServer;
Alan Stokes25f69362023-03-06 16:51:54 +000076use rustutils::system_properties;
Jiyong Parkdcf17412022-02-08 15:07:23 +090077use semver::VersionReq;
Inseob Kim6ef80972023-07-20 17:23:36 +090078use std::collections::HashSet;
Andrew Walbrandff3b942021-06-09 15:20:36 +000079use std::convert::TryInto;
Shikha Panwar55e10ec2024-02-13 12:53:49 +000080use std::fs;
Jaewan Kim39952072024-01-19 17:04:53 +090081use std::ffi::CStr;
Inseob Kim6ef80972023-07-20 17:23:36 +090082use std::fs::{canonicalize, read_dir, remove_file, File, OpenOptions};
Shikha Panwar9ae2e622024-01-30 12:22:30 +000083use std::io::{BufRead, BufReader, Error, ErrorKind, Seek, SeekFrom, Write};
Inseob Kim46257382024-01-03 15:41:22 +090084use std::iter;
Nikita Ioffe5776f082023-02-10 21:38:26 +000085use std::num::{NonZeroU16, NonZeroU32};
Inseob Kimff48a7c2024-02-26 22:07:21 +090086use std::os::unix::io::{AsRawFd, FromRawFd, IntoRawFd};
David Brazdilafc9a9e2023-01-12 16:08:10 +000087use std::os::unix::raw::pid_t;
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +000088use std::path::{Path, PathBuf};
Andrew Walbran320b5602021-03-04 16:11:12 +000089use std::sync::{Arc, Mutex, Weak};
Seungjae Yoo14e60182024-02-21 13:28:31 +090090use vbmeta::VbMetaImage;
Pierre-Clément Tosid3bbe1d2024-04-15 18:03:51 +010091use vmconfig::{VmConfig, get_debug_level};
David Brazdilafc9a9e2023-01-12 16:08:10 +000092use vsock::VsockStream;
Jooyung Han35edb8f2021-07-01 16:17:16 +090093use zip::ZipArchive;
Andrew Walbrand6dce6f2021-03-05 16:39:08 +000094
David Brazdil41d1a872022-10-05 14:44:19 +010095/// The unique ID of a VM used (together with a port number) for vsock communication.
96pub type Cid = u32;
97
David Brazdil4b4c5102022-12-19 22:56:20 +000098pub const BINDER_SERVICE_IDENTIFIER: &str = "android.system.virtualizationservice";
99
Jooyung Han95884632021-07-06 22:27:54 +0900100/// The size of zero.img.
101/// Gaps in composite disk images are filled with a shared zero.img.
102const ZERO_FILLER_SIZE: u64 = 4096;
103
David Brazdilf50c7a62023-04-19 14:22:42 +0000104/// Magic string for the instance image
105const ANDROID_VM_INSTANCE_MAGIC: &str = "Android-VM-instance";
106
107/// Version of the instance image format
108const ANDROID_VM_INSTANCE_VERSION: u16 = 1;
109
Alan Stokes0d1ef782022-09-27 13:46:35 +0100110const MICRODROID_OS_NAME: &str = "microdroid";
111
Shikha Panwar5d6a6752023-12-14 22:08:26 +0000112const SECRETKEEPER_IDENTIFIER: &str =
Shikha Panwarbe5dee72024-02-21 19:06:20 +0000113 "android.hardware.security.secretkeeper.ISecretkeeper/default";
Shikha Panwar5d6a6752023-12-14 22:08:26 +0000114
David Brazdilf50c7a62023-04-19 14:22:42 +0000115const UNFORMATTED_STORAGE_MAGIC: &str = "UNFORMATTED-STORAGE";
116
117/// crosvm requires all partitions to be a multiple of 4KiB.
118const PARTITION_GRANULARITY_BYTES: u64 = 4096;
119
Shikha Panwar55e10ec2024-02-13 12:53:49 +0000120const VM_REFERENCE_DT_ON_HOST_PATH: &str = "/proc/device-tree/avf/reference";
121
David Brazdil49f96f52022-12-16 21:29:13 +0000122lazy_static! {
David Brazdil4b4c5102022-12-19 22:56:20 +0000123 pub static ref GLOBAL_SERVICE: Strong<dyn IVirtualizationServiceInternal> =
124 wait_for_interface(BINDER_SERVICE_IDENTIFIER)
125 .expect("Could not connect to VirtualizationServiceInternal");
Inseob Kim46257382024-01-03 15:41:22 +0900126 static ref SUPPORTED_OS_NAMES: HashSet<String> =
127 get_supported_os_names().expect("Failed to get list of supported os names");
David Brazdil49f96f52022-12-16 21:29:13 +0000128}
129
Nikita Ioffef1ce9872022-12-09 13:31:59 +0000130fn create_or_update_idsig_file(
131 input_fd: &ParcelFileDescriptor,
132 idsig_fd: &ParcelFileDescriptor,
133) -> Result<()> {
134 let mut input = clone_file(input_fd)?;
135 let metadata = input.metadata().context("failed to get input metadata")?;
136 if !metadata.is_file() {
137 bail!("input is not a regular file");
138 }
Alan Stokes25f69362023-03-06 16:51:54 +0000139 let mut sig =
140 V4Signature::create(&mut input, get_current_sdk()?, 4096, &[], HashAlgorithm::SHA256)
141 .context("failed to create idsig")?;
Nikita Ioffef1ce9872022-12-09 13:31:59 +0000142
143 let mut output = clone_file(idsig_fd)?;
Jiyong Park8d192952023-06-26 14:29:51 +0900144
145 // Optimization. We don't have to update idsig file whenever a VM is started. Don't update it,
146 // if the idsig file already has the same APK digest.
147 if output.metadata()?.len() > 0 {
148 if let Ok(out_sig) = V4Signature::from_idsig(&mut output) {
149 if out_sig.signing_info.apk_digest == sig.signing_info.apk_digest {
150 debug!("idsig {:?} is up-to-date with apk {:?}.", output, input);
151 return Ok(());
152 }
153 }
154 // if we fail to read v4signature from output, that's fine. User can pass a random file.
155 // We will anyway overwrite the file to the v4signature generated from input_fd.
156 }
157
Shikha Panwar9ae2e622024-01-30 12:22:30 +0000158 output
159 .seek(SeekFrom::Start(0))
160 .context("failed to move cursor to start on the idsig output")?;
Nikita Ioffec09b0492022-12-14 20:18:33 +0000161 output.set_len(0).context("failed to set_len on the idsig output")?;
162 sig.write_into(&mut output).context("failed to write idsig")?;
Nikita Ioffef1ce9872022-12-09 13:31:59 +0000163 Ok(())
164}
165
Alan Stokes25f69362023-03-06 16:51:54 +0000166fn get_current_sdk() -> Result<u32> {
167 let current_sdk = system_properties::read("ro.build.version.sdk")?;
168 let current_sdk = current_sdk.ok_or_else(|| anyhow!("SDK version missing"))?;
169 current_sdk.parse().context("Malformed SDK version")
170}
171
David Brazdil4b4c5102022-12-19 22:56:20 +0000172pub fn remove_temporary_files(path: &PathBuf) -> Result<()> {
173 for dir_entry in read_dir(path)? {
174 remove_file(dir_entry?.path())?;
175 }
176 Ok(())
David Brazdil528e0472022-10-10 15:06:02 +0100177}
178
David Brazdil528e0472022-10-10 15:06:02 +0100179/// Implementation of `IVirtualizationService`, the entry point of the AIDL service.
David Brazdil49f96f52022-12-16 21:29:13 +0000180#[derive(Debug, Default)]
Andrew Walbranf6bf6862021-05-21 12:41:13 +0000181pub struct VirtualizationService {
Jiyong Park8611a6c2021-07-09 18:17:44 +0900182 state: Arc<Mutex<State>>,
Andrew Walbrand6dce6f2021-03-05 16:39:08 +0000183}
184
Shikha Panward8e35422021-10-11 13:51:27 +0000185impl Interface for VirtualizationService {
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000186 fn dump(&self, writer: &mut dyn Write, _args: &[&CStr]) -> Result<(), StatusCode> {
Shikha Panward8e35422021-10-11 13:51:27 +0000187 check_permission("android.permission.DUMP").or(Err(StatusCode::PERMISSION_DENIED))?;
188 let state = &mut *self.state.lock().unwrap();
189 let vms = state.vms();
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000190 writeln!(writer, "Running {0} VMs:", vms.len()).or(Err(StatusCode::UNKNOWN_ERROR))?;
Shikha Panward8e35422021-10-11 13:51:27 +0000191 for vm in vms {
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000192 writeln!(writer, "VM CID: {}", vm.cid).or(Err(StatusCode::UNKNOWN_ERROR))?;
193 writeln!(writer, "\tState: {:?}", vm.vm_state.lock().unwrap())
Shikha Panward8e35422021-10-11 13:51:27 +0000194 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000195 writeln!(writer, "\tPayload state {:?}", vm.payload_state())
Shikha Panward8e35422021-10-11 13:51:27 +0000196 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000197 writeln!(writer, "\tProtected: {}", vm.protected).or(Err(StatusCode::UNKNOWN_ERROR))?;
198 writeln!(writer, "\ttemporary_directory: {}", vm.temporary_directory.to_string_lossy())
Shikha Panward8e35422021-10-11 13:51:27 +0000199 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000200 writeln!(writer, "\trequester_uid: {}", vm.requester_uid)
Shikha Panward8e35422021-10-11 13:51:27 +0000201 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000202 writeln!(writer, "\trequester_debug_pid: {}", vm.requester_debug_pid)
Shikha Panward8e35422021-10-11 13:51:27 +0000203 .or(Err(StatusCode::UNKNOWN_ERROR))?;
204 }
205 Ok(())
206 }
207}
Andrew Walbranf6bf6862021-05-21 12:41:13 +0000208impl IVirtualizationService for VirtualizationService {
Andrew Walbranf8d94112021-09-07 11:45:36 +0000209 /// Creates (but does not start) a new VM with the given configuration, assigning it the next
210 /// available CID.
Andrew Walbrand6dce6f2021-03-05 16:39:08 +0000211 ///
212 /// Returns a binder `IVirtualMachine` object referring to it, as a handle for the client.
Andrew Walbranf8d94112021-09-07 11:45:36 +0000213 fn createVm(
Andrew Walbrana89fc132021-03-17 17:08:36 +0000214 &self,
Andrew Walbran3a5a9212021-05-04 17:09:08 +0000215 config: &VirtualMachineConfig,
Jiyong Parke6fb1672023-06-26 16:45:55 +0900216 console_out_fd: Option<&ParcelFileDescriptor>,
217 console_in_fd: Option<&ParcelFileDescriptor>,
Andrew Walbrana89fc132021-03-17 17:08:36 +0000218 log_fd: Option<&ParcelFileDescriptor>,
219 ) -> binder::Result<Strong<dyn IVirtualMachine>> {
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000220 let mut is_protected = false;
Jiyong Parke6fb1672023-06-26 16:45:55 +0900221 let ret = self.create_vm_internal(
222 config,
223 console_out_fd,
224 console_in_fd,
225 log_fd,
226 &mut is_protected,
227 );
Seungjae Yoo0a8c84c2022-07-11 08:19:15 +0000228 write_vm_creation_stats(config, is_protected, &ret);
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000229 ret
Andrew Walbrand6dce6f2021-03-05 16:39:08 +0000230 }
Andrew Walbran320b5602021-03-04 16:11:12 +0000231
Shikha Panwar61a74b52024-02-16 13:17:01 +0000232 /// Allocate a new instance_id to the VM
233 fn allocateInstanceId(&self) -> binder::Result<[u8; 64]> {
Shikha Panwarbd5eba92024-03-27 20:23:31 +0000234 check_manage_access()?;
Shikha Panwar61a74b52024-02-16 13:17:01 +0000235 GLOBAL_SERVICE.allocateInstanceId()
236 }
237
Andrew Walbrandff3b942021-06-09 15:20:36 +0000238 /// Initialise an empty partition image of the given size to be used as a writable partition.
239 fn initializeWritablePartition(
240 &self,
241 image_fd: &ParcelFileDescriptor,
Alan Stokesff0005f2023-01-30 09:53:00 +0000242 size_bytes: i64,
Jiyong Park9dd389e2021-08-23 20:42:59 +0900243 partition_type: PartitionType,
Andrew Walbrandff3b942021-06-09 15:20:36 +0000244 ) -> binder::Result<()> {
Jiyong Park753553b2021-07-12 21:21:09 +0900245 check_manage_access()?;
Jiyong Park2227eaa2023-08-04 11:59:18 +0900246 let size_bytes = size_bytes
247 .try_into()
248 .with_context(|| format!("Invalid size: {}", size_bytes))
249 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000250 let size_bytes = round_up(size_bytes, PARTITION_GRANULARITY_BYTES);
Shikha Panwar9ae2e622024-01-30 12:22:30 +0000251 let mut image = clone_file(image_fd)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000252 // initialize the file. Any data in the file will be erased.
Shikha Panwar9ae2e622024-01-30 12:22:30 +0000253 image
254 .seek(SeekFrom::Start(0))
255 .context("failed to move cursor to start")
256 .or_service_specific_exception(-1)?;
Jiyong Park2227eaa2023-08-04 11:59:18 +0900257 image.set_len(0).context("Failed to reset a file").or_service_specific_exception(-1)?;
Frederick Mayle0d310572024-05-02 12:34:58 -0700258 // Set the file length. In most filesystems, this will not allocate any physical disk
259 // space, it will only change the logical size.
260 image
261 .set_len(size_bytes)
262 .context("Failed to extend file")
Jiyong Park2227eaa2023-08-04 11:59:18 +0900263 .or_service_specific_exception(-1)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000264
265 match partition_type {
266 PartitionType::RAW => Ok(()),
Frederick Mayle0d310572024-05-02 12:34:58 -0700267 PartitionType::ANDROID_VM_INSTANCE => format_as_android_vm_instance(&mut image),
268 PartitionType::ENCRYPTEDSTORE => format_as_encryptedstore(&mut image),
David Brazdilf50c7a62023-04-19 14:22:42 +0000269 _ => Err(Error::new(
270 ErrorKind::Unsupported,
271 format!("Unsupported partition type {:?}", partition_type),
272 )),
273 }
Jiyong Park2227eaa2023-08-04 11:59:18 +0900274 .with_context(|| format!("Failed to initialize partition as {:?}", partition_type))
275 .or_service_specific_exception(-1)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000276
277 Ok(())
Andrew Walbrandff3b942021-06-09 15:20:36 +0000278 }
279
Jiyong Park0a248432021-08-20 23:32:39 +0900280 /// Creates or update the idsig file by digesting the input APK file.
281 fn createOrUpdateIdsigFile(
282 &self,
283 input_fd: &ParcelFileDescriptor,
284 idsig_fd: &ParcelFileDescriptor,
285 ) -> binder::Result<()> {
Jiyong Parkc3ca24f2022-06-28 10:45:15 +0900286 check_manage_access()?;
287
Jiyong Park2227eaa2023-08-04 11:59:18 +0900288 create_or_update_idsig_file(input_fd, idsig_fd).or_service_specific_exception(-1)?;
Jiyong Park0a248432021-08-20 23:32:39 +0900289 Ok(())
290 }
291
Andrew Walbran320b5602021-03-04 16:11:12 +0000292 /// Get a list of all currently running VMs. This method is only intended for debug purposes,
293 /// and as such is only permitted from the shell user.
294 fn debugListVms(&self) -> binder::Result<Vec<VirtualMachineDebugInfo>> {
David Brazdil209074a2023-01-12 16:44:51 +0000295 // Delegate to the global service, including checking the debug permission.
David Brazdild4f51a52023-01-11 14:09:27 +0000296 GLOBAL_SERVICE.debugListVms()
Andrew Walbran320b5602021-03-04 16:11:12 +0000297 }
Inseob Kim53d0b212023-07-20 16:58:37 +0900298
299 /// Get a list of assignable device types.
300 fn getAssignableDevices(&self) -> binder::Result<Vec<AssignableDevice>> {
301 // Delegate to the global service, including checking the permission.
302 GLOBAL_SERVICE.getAssignableDevices()
303 }
Nikita Ioffef7c742a2023-09-04 16:57:59 +0100304
Inseob Kim46257382024-01-03 15:41:22 +0900305 /// Get a list of supported OSes.
306 fn getSupportedOSList(&self) -> binder::Result<Vec<String>> {
307 Ok(Vec::from_iter(SUPPORTED_OS_NAMES.iter().cloned()))
308 }
309
Nikita Ioffef7c742a2023-09-04 16:57:59 +0100310 /// Returns whether given feature is enabled
311 fn isFeatureEnabled(&self, feature: &str) -> binder::Result<bool> {
312 check_manage_access()?;
Shikha Panwar6d306412024-02-17 21:37:49 +0000313 Ok(avf_features::is_feature_enabled(feature))
Nikita Ioffef7c742a2023-09-04 16:57:59 +0100314 }
Alice Wange64dd182024-01-17 15:57:55 +0000315
316 fn enableTestAttestation(&self) -> binder::Result<()> {
317 GLOBAL_SERVICE.enableTestAttestation()
318 }
Alice Wang0362f7f2024-03-21 08:16:26 +0000319
320 fn isRemoteAttestationSupported(&self) -> binder::Result<bool> {
321 check_manage_access()?;
322 GLOBAL_SERVICE.isRemoteAttestationSupported()
323 }
Shikha Panwar7aef66d2024-03-13 00:28:41 +0000324
325 fn isUpdatableVmSupported(&self) -> binder::Result<bool> {
326 // The response is specific to Microdroid. Updatable VMs are only possible if device
327 // supports Secretkeeper. Guest OS needs to use Secretkeeper based secrets. Microdroid does
328 // this, however other guest OSes may do things differently.
329 check_manage_access()?;
330 Ok(is_secretkeeper_supported())
331 }
Shikha Panwarbd5eba92024-03-27 20:23:31 +0000332
Shikha Panwar07d701c2024-03-28 14:43:52 +0000333 fn removeVmInstance(&self, instance_id: &[u8; 64]) -> binder::Result<()> {
334 check_manage_access()?;
335 GLOBAL_SERVICE.removeVmInstance(instance_id)
336 }
337
Shikha Panwarbd5eba92024-03-27 20:23:31 +0000338 fn claimVmInstance(&self, instance_id: &[u8; 64]) -> binder::Result<()> {
339 check_manage_access()?;
340 GLOBAL_SERVICE.claimVmInstance(instance_id)
341 }
Andrew Walbran320b5602021-03-04 16:11:12 +0000342}
343
Jiyong Park8611a6c2021-07-09 18:17:44 +0900344impl VirtualizationService {
345 pub fn init() -> VirtualizationService {
David Brazdil49f96f52022-12-16 21:29:13 +0000346 VirtualizationService::default()
Jiyong Park8611a6c2021-07-09 18:17:44 +0900347 }
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000348
David Brazdil209074a2023-01-12 16:44:51 +0000349 fn create_vm_context(
350 &self,
351 requester_debug_pid: pid_t,
352 ) -> binder::Result<(VmContext, Cid, PathBuf)> {
David Brazdil8cf8f482022-11-23 14:21:26 +0000353 const NUM_ATTEMPTS: usize = 5;
354
355 for _ in 0..NUM_ATTEMPTS {
Charisee96113f32023-01-26 09:00:42 +0000356 let vm_context = GLOBAL_SERVICE.allocateGlobalVmContext(requester_debug_pid)?;
David Brazdild4f51a52023-01-11 14:09:27 +0000357 let cid = vm_context.getCid()? as Cid;
358 let temp_dir: PathBuf = vm_context.getTemporaryDirectory()?.into();
David Brazdil8cf8f482022-11-23 14:21:26 +0000359 let service = VirtualMachineService::new_binder(self.state.clone(), cid).as_binder();
360
361 // Start VM service listening for connections from the new CID on port=CID.
David Brazdil8cf8f482022-11-23 14:21:26 +0000362 let port = cid;
David Brazdil3238da42022-11-18 10:04:51 +0000363 match RpcServer::new_vsock(service, cid, port) {
David Brazdil8cf8f482022-11-23 14:21:26 +0000364 Ok(vm_server) => {
365 vm_server.start();
David Brazdild4f51a52023-01-11 14:09:27 +0000366 return Ok((VmContext::new(vm_context, vm_server), cid, temp_dir));
David Brazdil8cf8f482022-11-23 14:21:26 +0000367 }
368 Err(err) => {
369 warn!("Could not start RpcServer on port {}: {}", port, err);
370 }
371 }
372 }
Jiyong Park2227eaa2023-08-04 11:59:18 +0900373 Err(anyhow!("Too many attempts to create VM context failed"))
374 .or_service_specific_exception(-1)
David Brazdil8cf8f482022-11-23 14:21:26 +0000375 }
376
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000377 fn create_vm_internal(
378 &self,
379 config: &VirtualMachineConfig,
Jiyong Parke6fb1672023-06-26 16:45:55 +0900380 console_out_fd: Option<&ParcelFileDescriptor>,
381 console_in_fd: Option<&ParcelFileDescriptor>,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000382 log_fd: Option<&ParcelFileDescriptor>,
383 is_protected: &mut bool,
384 ) -> binder::Result<Strong<dyn IVirtualMachine>> {
David Brazdil209074a2023-01-12 16:44:51 +0000385 let requester_uid = get_calling_uid();
386 let requester_debug_pid = get_calling_pid();
387
Nikita Ioffe631717e2023-09-05 13:38:07 +0100388 check_config_features(config)?;
389
David Brazdil209074a2023-01-12 16:44:51 +0000390 // Allocating VM context checks the MANAGE_VIRTUAL_MACHINE permission.
391 let (vm_context, cid, temporary_directory) = self.create_vm_context(requester_debug_pid)?;
Inseob Kim1119d702022-05-02 18:01:58 +0900392
Alan Stokesfda70842023-12-20 17:50:14 +0000393 if is_custom_config(config) {
Alan Stokes7bc146c2022-10-20 17:10:32 +0100394 check_use_custom_virtual_machine()?;
Inseob Kim1119d702022-05-02 18:01:58 +0900395 }
396
Nikita Ioffe5776f082023-02-10 21:38:26 +0000397 let gdb_port = extract_gdb_port(config);
398
399 // Additional permission checks if caller request gdb.
400 if gdb_port.is_some() {
401 check_gdb_allowed(config)?;
402 }
403
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000404 let device_tree_overlay = maybe_create_device_tree_overlay(config, &temporary_directory)?;
Seungjae Yooec3bc522023-11-09 10:14:30 +0900405
Jaewan Kimf3143242024-03-15 06:56:31 +0000406 let debug_config = DebugConfig::new(config);
Nikita Ioffe2cb75cf2024-06-04 16:43:56 +0000407 let ramdump = if !uses_gki_kernel(config) && debug_config.is_ramdump_needed() {
Jiyong Parked180932023-02-24 19:55:41 +0900408 Some(prepare_ramdump_file(&temporary_directory)?)
409 } else {
410 None
411 };
412
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000413 let state = &mut *self.state.lock().unwrap();
Jiyong Parke6fb1672023-06-26 16:45:55 +0900414 let console_out_fd =
415 clone_or_prepare_logger_fd(&debug_config, console_out_fd, format!("Console({})", cid))?;
416 let console_in_fd = console_in_fd.map(clone_file).transpose()?;
Jaewan Kim61f86142023-03-28 15:12:52 +0900417 let log_fd = clone_or_prepare_logger_fd(&debug_config, log_fd, format!("Log({})", cid))?;
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000418
419 // Counter to generate unique IDs for temporary image files.
420 let mut next_temporary_image_id = 0;
421 // Files which are referred to from composite images. These must be mapped to the crosvm
422 // child process, and not closed before it is started.
423 let mut indirect_files = vec![];
424
Alan Stokes7bc146c2022-10-20 17:10:32 +0100425 let (is_app_config, config) = match config {
426 VirtualMachineConfig::RawConfig(config) => (false, BorrowedOrOwned::Borrowed(config)),
427 VirtualMachineConfig::AppConfig(config) => {
Jiyong Park2227eaa2023-08-04 11:59:18 +0900428 let config = load_app_config(config, &debug_config, &temporary_directory)
429 .or_service_specific_exception_with(-1, |e| {
Jaewan Kim61f86142023-03-28 15:12:52 +0900430 *is_protected = config.protectedVm;
431 let message = format!("Failed to load app config: {:?}", e);
432 error!("{}", message);
Jiyong Park2227eaa2023-08-04 11:59:18 +0900433 message
Jaewan Kim61f86142023-03-28 15:12:52 +0900434 })?;
Alan Stokes7bc146c2022-10-20 17:10:32 +0100435 (true, BorrowedOrOwned::Owned(config))
436 }
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000437 };
438 let config = config.as_ref();
439 *is_protected = config.protectedVm;
440
441 // Check if partition images are labeled incorrectly. This is to prevent random images
442 // which are not protected by the Android Verified Boot (e.g. bits downloaded by apps) from
Alan Stokes3e5eec12023-09-07 12:10:00 +0100443 // being loaded in a pVM. This applies to everything but the instance image in the raw
444 // config, and everything but the non-executable, generated partitions in the app
445 // config.
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000446 config
447 .disks
448 .iter()
449 .flat_map(|disk| disk.partitions.iter())
450 .filter(|partition| {
451 if is_app_config {
Alan Stokes53cc5ca2022-08-30 14:28:19 +0100452 !is_safe_app_partition(&partition.label)
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000453 } else {
Alice Wangc206b9b2023-08-28 14:13:51 +0000454 !is_safe_raw_partition(&partition.label)
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000455 }
456 })
457 .try_for_each(check_label_for_partition)
Jiyong Park2227eaa2023-08-04 11:59:18 +0900458 .or_service_specific_exception(-1)?;
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000459
Inseob Kimff48a7c2024-02-26 22:07:21 +0900460 // Check if files for payloads and bases are NOT coming from /vendor and /odm, as they may
461 // have unstable interfaces.
462 // TODO(b/316431494): remove once Treble interfaces are stabilized.
463 check_partitions_for_files(config).or_service_specific_exception(-1)?;
464
Alan Stokes185fe112023-01-10 16:20:55 +0000465 let kernel = maybe_clone_file(&config.kernel)?;
466 let initrd = maybe_clone_file(&config.initrd)?;
467
Alan Stokes185fe112023-01-10 16:20:55 +0000468 if config.protectedVm {
Nikita Ioffef934e812024-07-05 15:44:41 +0000469 // In a protected VM, we require custom kernels to come from a trusted source
470 // (b/237054515).
Jiyong Park2227eaa2023-08-04 11:59:18 +0900471 check_label_for_kernel_files(&kernel, &initrd).or_service_specific_exception(-1)?;
Nikita Ioffef934e812024-07-05 15:44:41 +0000472 // Fail fast with a meaningful error message in case device doesn't support pVMs.
473 check_protected_vm_is_supported()?;
Alan Stokes185fe112023-01-10 16:20:55 +0000474 }
475
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000476 let zero_filler_path = temporary_directory.join("zero.img");
Jiyong Park2227eaa2023-08-04 11:59:18 +0900477 write_zero_filler(&zero_filler_path)
478 .context("Failed to make composite image")
479 .with_log()
480 .or_service_specific_exception(-1)?;
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000481
482 // Assemble disk images if needed.
483 let disks = config
484 .disks
485 .iter()
486 .map(|disk| {
487 assemble_disk_image(
488 disk,
489 &zero_filler_path,
490 &temporary_directory,
491 &mut next_temporary_image_id,
492 &mut indirect_files,
493 )
494 })
495 .collect::<Result<Vec<DiskFile>, _>>()?;
496
David Brazdil7d1e5ec2023-02-06 17:56:29 +0000497 let (cpus, host_cpu_topology) = match config.cpuTopology {
498 CpuTopology::MATCH_HOST => (None, true),
499 CpuTopology::ONE_CPU => (NonZeroU32::new(1), false),
500 val => {
Jiyong Park2227eaa2023-08-04 11:59:18 +0900501 return Err(anyhow!("Failed to parse CPU topology value {:?}", val))
502 .with_log()
503 .or_service_specific_exception(-1);
David Brazdil7d1e5ec2023-02-06 17:56:29 +0000504 }
505 };
506
David Brazdil2dfefd12023-11-17 14:07:36 +0000507 let (vfio_devices, dtbo) = if !config.devices.is_empty() {
Inseob Kim6ef80972023-07-20 17:23:36 +0900508 let mut set = HashSet::new();
509 for device in config.devices.iter() {
Jiyong Park2227eaa2023-08-04 11:59:18 +0900510 let path = canonicalize(device)
511 .with_context(|| format!("can't canonicalize {device}"))
512 .or_service_specific_exception(-1)?;
Inseob Kim6ef80972023-07-20 17:23:36 +0900513 if !set.insert(path) {
Jiyong Park2227eaa2023-08-04 11:59:18 +0900514 return Err(anyhow!("duplicated device {device}"))
515 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT);
Inseob Kim6ef80972023-07-20 17:23:36 +0900516 }
517 }
Jakob Vukalovicd42aa2c2023-11-09 16:04:00 +0000518 let devices = GLOBAL_SERVICE.bindDevicesToVfioDriver(&config.devices)?;
David Brazdil2dfefd12023-11-17 14:07:36 +0000519 let dtbo_file = File::from(
520 GLOBAL_SERVICE
521 .getDtboFile()?
522 .as_ref()
523 .try_clone()
Jaewan Kim39952072024-01-19 17:04:53 +0900524 .context("Failed to create VM DTBO from ParcelFileDescriptor")
David Brazdil2dfefd12023-11-17 14:07:36 +0000525 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)?,
526 );
527 (devices, Some(dtbo_file))
Inseob Kim7307a892023-09-14 13:37:58 +0900528 } else {
David Brazdil2dfefd12023-11-17 14:07:36 +0000529 (vec![], None)
Inseob Kim7307a892023-09-14 13:37:58 +0900530 };
Jeongik Cha798401c2024-04-11 21:54:49 +0900531 let display_config = if cfg!(paravirtualized_devices) {
532 config
533 .displayConfig
534 .as_ref()
535 .map(DisplayConfig::new)
536 .transpose()
537 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?
538 } else {
539 None
540 };
Jason Macnakea7b0fa2024-05-08 17:02:44 -0700541 let gpu_config = if cfg!(paravirtualized_devices) {
542 config
543 .gpuConfig
544 .as_ref()
545 .map(GpuConfig::new)
546 .transpose()
547 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?
548 } else {
549 None
550 };
Jeongik Cha1df1c032024-04-03 16:03:12 +0900551
Jeongik Chac181be72024-03-27 00:18:30 +0900552 let input_device_options = if cfg!(paravirtualized_devices) {
553 config
554 .inputDevices
555 .iter()
556 .map(to_input_device_option_from)
557 .collect::<Result<Vec<InputDeviceOption>, _>>()
558 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?
559 } else {
560 vec![]
561 };
562
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900563 // Create TAP network interface if the VM supports network.
Seungjae Yoo986d7a42024-05-28 14:06:58 +0900564 let tap = if cfg!(network) && config.networkSupported {
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900565 if *is_protected {
566 return Err(anyhow!("Network feature is not supported for pVM yet"))
567 .with_log()
568 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION)?;
569 }
Seungjae Yoo986d7a42024-05-28 14:06:58 +0900570 Some(File::from(
571 GLOBAL_SERVICE
572 .createTapInterface(&get_this_pid().to_string())?
573 .as_ref()
574 .try_clone()
575 .context("Failed to get TAP interface from ParcelFileDescriptor")
576 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)?,
577 ))
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900578 } else {
579 None
580 };
Mu-Le Leeb2d5a312024-06-05 10:52:47 +0800581
582 let audio_config = if cfg!(paravirtualized_devices) {
583 config.audioConfig.as_ref().map(AudioConfig::new)
584 } else {
585 None
586 };
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900587
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000588 // Actually start the VM.
589 let crosvm_config = CrosvmConfig {
590 cid,
Seungjae Yoo62085c02022-08-12 04:44:52 +0000591 name: config.name.clone(),
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000592 bootloader: maybe_clone_file(&config.bootloader)?,
Alan Stokes185fe112023-01-10 16:20:55 +0000593 kernel,
594 initrd,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000595 disks,
596 params: config.params.to_owned(),
597 protected: *is_protected,
Jaewan Kim61f86142023-03-28 15:12:52 +0900598 debug_config,
Frederick Mayle68d06e72024-07-12 17:18:11 -0700599 memory_mib: config
600 .memoryMib
601 .try_into()
602 .ok()
603 .and_then(NonZeroU32::new)
604 .unwrap_or(NonZeroU32::new(256).unwrap()),
David Brazdil7d1e5ec2023-02-06 17:56:29 +0000605 cpus,
606 host_cpu_topology,
Jiyong Parke6fb1672023-06-26 16:45:55 +0900607 console_out_fd,
608 console_in_fd,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000609 log_fd,
Jiyong Parked180932023-02-24 19:55:41 +0900610 ramdump,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000611 indirect_files,
612 platform_version: parse_platform_version_req(&config.platformVersion)?,
Jiyong Parke6ed0f92022-06-22 00:13:00 +0900613 detect_hangup: is_app_config,
Nikita Ioffe5776f082023-02-10 21:38:26 +0000614 gdb_port,
Inseob Kim7307a892023-09-14 13:37:58 +0900615 vfio_devices,
David Brazdil2dfefd12023-11-17 14:07:36 +0000616 dtbo,
Shikha Panwar55e10ec2024-02-13 12:53:49 +0000617 device_tree_overlay,
Jeongik Cha1df1c032024-04-03 16:03:12 +0900618 display_config,
Jeongik Chac181be72024-03-27 00:18:30 +0900619 input_device_options,
Vincent Donnefort538a2c62024-03-20 16:01:10 +0000620 hugepages: config.hugePages,
Seungjae Yoo986d7a42024-05-28 14:06:58 +0900621 tap,
Yi-Yo Chiang8dd32552024-05-22 19:38:16 +0800622 console_input_device: config.consoleInputDevice.clone(),
David Dai23cff712024-06-13 19:23:45 +0000623 boost_uclamp: config.boostUclamp,
Jason Macnakea7b0fa2024-05-08 17:02:44 -0700624 gpu_config,
Mu-Le Leeb2d5a312024-06-05 10:52:47 +0800625 audio_config,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000626 };
627 let instance = Arc::new(
David Brazdil528e0472022-10-10 15:06:02 +0100628 VmInstance::new(
629 crosvm_config,
630 temporary_directory,
631 requester_uid,
632 requester_debug_pid,
633 vm_context,
634 )
Jiyong Park2227eaa2023-08-04 11:59:18 +0900635 .with_context(|| format!("Failed to create VM with config {:?}", config))
636 .with_log()
637 .or_service_specific_exception(-1)?,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000638 );
639 state.add_vm(Arc::downgrade(&instance));
640 Ok(VirtualMachine::create(instance))
641 }
Jiyong Park8611a6c2021-07-09 18:17:44 +0900642}
643
Alan Stokesfda70842023-12-20 17:50:14 +0000644/// Returns whether a VM config represents a "custom" virtual machine, which requires the
645/// USE_CUSTOM_VIRTUAL_MACHINE.
646fn is_custom_config(config: &VirtualMachineConfig) -> bool {
647 match config {
648 // Any raw (non-Microdroid) VM is considered custom.
649 VirtualMachineConfig::RawConfig(_) => true,
650 VirtualMachineConfig::AppConfig(config) => {
651 // Some features are reserved for platform apps only, even when using
652 // VirtualMachineAppConfig. Almost all of these features are grouped in the
653 // CustomConfig struct:
654 // - controlling CPUs;
655 // - gdbPort is set, meaning that crosvm will start a gdb server;
656 // - using anything other than the default kernel;
657 // - specifying devices to be assigned.
658 if config.customConfig.is_some() {
659 true
660 } else {
661 // Additional custom features not included in CustomConfig:
662 // - specifying a config file;
Alan Stokes736f6822024-02-16 16:08:00 +0000663 // - specifying extra APKs;
664 // - specifying an OS other than Microdroid.
Inseob Kim89b24592024-02-23 18:59:43 +0900665 (match &config.payload {
Alan Stokesfda70842023-12-20 17:50:14 +0000666 Payload::ConfigPath(_) => true,
Inseob Kim89b24592024-02-23 18:59:43 +0900667 Payload::PayloadConfig(payload_config) => !payload_config.extraApks.is_empty(),
668 }) || config.osName != MICRODROID_OS_NAME
Alan Stokesfda70842023-12-20 17:50:14 +0000669 }
670 }
671 }
672}
673
Seungjae Yoo14e60182024-02-21 13:28:31 +0900674fn extract_vendor_hashtree_digest(config: &VirtualMachineConfig) -> Result<Option<Vec<u8>>> {
675 let VirtualMachineConfig::AppConfig(config) = config else {
676 return Ok(None);
677 };
678 let Some(custom_config) = &config.customConfig else {
679 return Ok(None);
680 };
681 let Some(file) = custom_config.vendorImage.as_ref() else {
682 return Ok(None);
683 };
684
685 let file = clone_file(file)?;
686 let size =
687 file.metadata().context("Failed to get metadata from microdroid vendor image")?.len();
688 let vbmeta = VbMetaImage::verify_reader_region(&file, 0, size)
689 .context("Failed to get vbmeta from microdroid-vendor.img")?;
690
691 for descriptor in vbmeta.descriptors()?.iter() {
692 if let vbmeta::Descriptor::Hashtree(_) = descriptor {
693 let root_digest = hex::encode(descriptor.to_hashtree()?.root_digest());
694 return Ok(Some(root_digest.as_bytes().to_vec()));
695 }
696 }
697 Err(anyhow!("No hashtree digest is extracted from microdroid vendor image"))
698}
699
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000700fn maybe_create_device_tree_overlay(
701 config: &VirtualMachineConfig,
702 temporary_directory: &Path,
703) -> binder::Result<Option<File>> {
704 // Currently, VirtMgr adds the host copy of reference DT & untrusted properties
705 // (e.g. instance-id)
706 let host_ref_dt = Path::new(VM_REFERENCE_DT_ON_HOST_PATH);
707 let host_ref_dt = if host_ref_dt.exists()
708 && read_dir(host_ref_dt).or_service_specific_exception(-1)?.next().is_some()
709 {
710 Some(host_ref_dt)
711 } else {
712 warn!("VM reference DT doesn't exist in host DT");
713 None
714 };
715
716 let vendor_hashtree_digest = extract_vendor_hashtree_digest(config)
717 .context("Failed to extract vendor hashtree digest")
718 .or_service_specific_exception(-1)?;
719
720 let trusted_props = if let Some(ref vendor_hashtree_digest) = vendor_hashtree_digest {
721 info!(
722 "Passing vendor hashtree digest to pvmfw. This will be rejected if it doesn't \
723 match the trusted digest in the pvmfw config, causing the VM to fail to start."
724 );
725 vec![(cstr!("vendor_hashtree_descriptor_root_digest"), vendor_hashtree_digest.as_slice())]
726 } else {
727 vec![]
728 };
729
730 let instance_id;
731 let mut untrusted_props = Vec::with_capacity(2);
732 if cfg!(llpvm_changes) {
733 instance_id = extract_instance_id(config);
734 untrusted_props.push((cstr!("instance-id"), &instance_id[..]));
735 let want_updatable = extract_want_updatable(config);
736 if want_updatable && is_secretkeeper_supported() {
737 // Let guest know that it can defer rollback protection to Secretkeeper by setting
738 // an empty property in untrusted node in DT. This enables Updatable VMs.
739 untrusted_props.push((cstr!("defer-rollback-protection"), &[]))
740 }
741 }
742
743 let device_tree_overlay = if host_ref_dt.is_some()
744 || !untrusted_props.is_empty()
745 || !trusted_props.is_empty()
746 {
747 let dt_output = temporary_directory.join(VM_DT_OVERLAY_PATH);
748 let mut data = [0_u8; VM_DT_OVERLAY_MAX_SIZE];
749 let fdt =
750 create_device_tree_overlay(&mut data, host_ref_dt, &untrusted_props, &trusted_props)
751 .map_err(|e| anyhow!("Failed to create DT overlay, {e:?}"))
752 .or_service_specific_exception(-1)?;
753 fs::write(&dt_output, fdt.as_slice()).or_service_specific_exception(-1)?;
754 Some(File::open(dt_output).or_service_specific_exception(-1)?)
755 } else {
756 None
757 };
758 Ok(device_tree_overlay)
759}
760
Andrew Walbranfbb39d22021-07-28 17:01:25 +0000761fn write_zero_filler(zero_filler_path: &Path) -> Result<()> {
Jooyung Han95884632021-07-06 22:27:54 +0900762 let file = OpenOptions::new()
763 .create_new(true)
764 .read(true)
765 .write(true)
766 .open(zero_filler_path)
767 .with_context(|| "Failed to create zero.img")?;
768 file.set_len(ZERO_FILLER_SIZE)?;
Andrew Walbranfbb39d22021-07-28 17:01:25 +0000769 Ok(())
Jooyung Han95884632021-07-06 22:27:54 +0900770}
771
David Brazdilf50c7a62023-04-19 14:22:42 +0000772fn format_as_android_vm_instance(part: &mut dyn Write) -> std::io::Result<()> {
773 part.write_all(ANDROID_VM_INSTANCE_MAGIC.as_bytes())?;
774 part.write_all(&ANDROID_VM_INSTANCE_VERSION.to_le_bytes())?;
775 part.flush()
776}
777
778fn format_as_encryptedstore(part: &mut dyn Write) -> std::io::Result<()> {
779 part.write_all(UNFORMATTED_STORAGE_MAGIC.as_bytes())?;
780 part.flush()
781}
782
783fn round_up(input: u64, granularity: u64) -> u64 {
784 if granularity == 0 {
785 return input;
786 }
787 // If the input is absurdly large we round down instead of up; it's going to fail anyway.
788 let result = input.checked_add(granularity - 1).unwrap_or(input);
789 (result / granularity) * granularity
790}
791
Jeongik Chac181be72024-03-27 00:18:30 +0900792fn to_input_device_option_from(input_device: &InputDevice) -> Result<InputDeviceOption> {
793 Ok(match input_device {
794 InputDevice::SingleTouch(single_touch) => InputDeviceOption::SingleTouch {
795 file: clone_file(single_touch.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?)?,
796 height: u32::try_from(single_touch.height)?,
797 width: u32::try_from(single_touch.width)?,
798 name: if !single_touch.name.is_empty() {
799 Some(single_touch.name.clone())
800 } else {
801 None
802 },
803 },
804 InputDevice::EvDev(evdev) => InputDeviceOption::EvDev(clone_file(
805 evdev.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
806 )?),
Jeongik Cha985b6402024-04-15 18:13:00 +0900807 InputDevice::Keyboard(keyboard) => InputDeviceOption::Keyboard(clone_file(
808 keyboard.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
809 )?),
Jeongik Cha343894e2024-05-17 20:39:31 +0900810 InputDevice::Mouse(mouse) => InputDeviceOption::Mouse(clone_file(
811 mouse.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
812 )?),
Jiyong Park6c1b9f02024-07-05 16:21:10 +0900813 InputDevice::Switches(switches) => InputDeviceOption::Switches(clone_file(
814 switches.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
815 )?),
Jeongik Chac181be72024-03-27 00:18:30 +0900816 })
817}
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +0000818/// Given the configuration for a disk image, assembles the `DiskFile` to pass to crosvm.
819///
820/// This may involve assembling a composite disk from a set of partition images.
821fn assemble_disk_image(
822 disk: &DiskImage,
Jooyung Han95884632021-07-06 22:27:54 +0900823 zero_filler_path: &Path,
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +0000824 temporary_directory: &Path,
825 next_temporary_image_id: &mut u64,
826 indirect_files: &mut Vec<File>,
Andrew Walbran806f1542021-06-10 14:07:12 +0000827) -> Result<DiskFile, Status> {
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +0000828 let image = if !disk.partitions.is_empty() {
829 if disk.image.is_some() {
830 warn!("DiskImage {:?} contains both image and partitions.", disk);
Jiyong Park2227eaa2023-08-04 11:59:18 +0900831 return Err(anyhow!("DiskImage contains both image and partitions"))
832 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT);
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +0000833 }
834
Andrew Walbran3eca16c2021-06-14 11:15:14 +0000835 let composite_image_filenames =
836 make_composite_image_filenames(temporary_directory, next_temporary_image_id);
837 let (image, partition_files) = make_composite_image(
838 &disk.partitions,
Jooyung Han95884632021-07-06 22:27:54 +0900839 zero_filler_path,
Andrew Walbran3eca16c2021-06-14 11:15:14 +0000840 &composite_image_filenames.composite,
841 &composite_image_filenames.header,
842 &composite_image_filenames.footer,
843 )
Jiyong Park2227eaa2023-08-04 11:59:18 +0900844 .with_context(|| format!("Failed to make composite disk image with config {:?}", disk))
845 .with_log()
846 .or_service_specific_exception(-1)?;
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +0000847
848 // Pass the file descriptors for the various partition files to crosvm when it
849 // is run.
850 indirect_files.extend(partition_files);
851
852 image
853 } else if let Some(image) = &disk.image {
854 clone_file(image)?
855 } else {
856 warn!("DiskImage {:?} didn't contain image or partitions.", disk);
Jiyong Park2227eaa2023-08-04 11:59:18 +0900857 return Err(anyhow!("DiskImage didn't contain image or partitions."))
858 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT);
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +0000859 };
860
861 Ok(DiskFile { image, writable: disk.writable })
862}
863
Nikita Ioffeaa6858c2023-07-04 01:37:41 +0100864fn append_kernel_param(param: &str, vm_config: &mut VirtualMachineRawConfig) {
865 if let Some(ref mut params) = vm_config.params {
866 params.push(' ');
867 params.push_str(param)
868 } else {
869 vm_config.params = Some(param.to_owned())
870 }
871}
872
Inseob Kim46257382024-01-03 15:41:22 +0900873fn extract_os_name_from_config_path(config: &Path) -> Option<String> {
874 if config.extension()?.to_str()? != "json" {
875 return None;
Inseob Kim172f9eb2023-11-06 17:02:08 +0900876 }
Inseob Kim46257382024-01-03 15:41:22 +0900877
878 Some(config.with_extension("").file_name()?.to_str()?.to_owned())
879}
880
881fn extract_os_names_from_configs(config_glob_pattern: &str) -> Result<HashSet<String>> {
882 let configs = glob(config_glob_pattern)?.collect::<Result<Vec<_>, _>>()?;
883 let os_names =
884 configs.iter().filter_map(|x| extract_os_name_from_config_path(x)).collect::<HashSet<_>>();
885
886 Ok(os_names)
887}
888
889fn get_supported_os_names() -> Result<HashSet<String>> {
890 if !cfg!(vendor_modules) {
891 return Ok(iter::once(MICRODROID_OS_NAME.to_owned()).collect());
892 }
893
894 extract_os_names_from_configs("/apex/com.android.virt/etc/microdroid*.json")
895}
896
897fn is_valid_os(os_name: &str) -> bool {
898 SUPPORTED_OS_NAMES.contains(os_name)
Inseob Kim172f9eb2023-11-06 17:02:08 +0900899}
900
Nikita Ioffe2cb75cf2024-06-04 16:43:56 +0000901fn uses_gki_kernel(config: &VirtualMachineConfig) -> bool {
902 if !cfg!(vendor_modules) {
903 return false;
904 }
905 match config {
906 VirtualMachineConfig::RawConfig(_) => false,
907 VirtualMachineConfig::AppConfig(config) => config.osName.starts_with("microdroid_gki-"),
908 }
909}
910
Jooyung Han21e9b922021-06-26 04:14:16 +0900911fn load_app_config(
912 config: &VirtualMachineAppConfig,
Jaewan Kim61f86142023-03-28 15:12:52 +0900913 debug_config: &DebugConfig,
Jooyung Han21e9b922021-06-26 04:14:16 +0900914 temporary_directory: &Path,
Jooyung Hanadfb76c2021-06-28 17:29:30 +0900915) -> Result<VirtualMachineRawConfig> {
Andrew Walbrancc0db522021-07-12 17:03:42 +0000916 let apk_file = clone_file(config.apk.as_ref().unwrap())?;
917 let idsig_file = clone_file(config.idsig.as_ref().unwrap())?;
Jiyong Park8d081812021-07-23 17:45:04 +0900918 let instance_file = clone_file(config.instanceImage.as_ref().unwrap())?;
Jooyung Han21e9b922021-06-26 04:14:16 +0900919
Shikha Panwar22e70452022-10-10 18:32:55 +0000920 let storage_image = if let Some(file) = config.encryptedStorageImage.as_ref() {
921 Some(clone_file(file)?)
922 } else {
923 None
924 };
925
Alan Stokesfda70842023-12-20 17:50:14 +0000926 let vm_payload_config;
927 let extra_apk_files: Vec<_>;
928 match &config.payload {
Alan Stokes0d1ef782022-09-27 13:46:35 +0100929 Payload::ConfigPath(config_path) => {
Alan Stokesfda70842023-12-20 17:50:14 +0000930 vm_payload_config =
931 load_vm_payload_config_from_file(&apk_file, config_path.as_str())
932 .with_context(|| format!("Couldn't read config from {}", config_path))?;
933 extra_apk_files = vm_payload_config
934 .extra_apks
935 .iter()
936 .enumerate()
937 .map(|(i, apk)| {
938 File::open(PathBuf::from(&apk.path))
939 .with_context(|| format!("Failed to open extra apk #{i} {}", apk.path))
940 })
941 .collect::<Result<_>>()?;
Alan Stokes0d1ef782022-09-27 13:46:35 +0100942 }
Alan Stokesfda70842023-12-20 17:50:14 +0000943 Payload::PayloadConfig(payload_config) => {
944 vm_payload_config = create_vm_payload_config(payload_config)?;
945 extra_apk_files =
946 payload_config.extraApks.iter().map(clone_file).collect::<binder::Result<_>>()?;
947 }
Alan Stokes0d1ef782022-09-27 13:46:35 +0100948 };
Jooyung Han21e9b922021-06-26 04:14:16 +0900949
Inseob Kim89b24592024-02-23 18:59:43 +0900950 let payload_config_os = vm_payload_config.os.name.as_str();
951 if !payload_config_os.is_empty() && payload_config_os != "microdroid" {
952 bail!("'os' in payload config is deprecated");
953 }
954
Inseob Kim172f9eb2023-11-06 17:02:08 +0900955 // For now, the only supported OS is Microdroid and Microdroid GKI
Inseob Kim89b24592024-02-23 18:59:43 +0900956 let os_name = config.osName.as_str();
Inseob Kim172f9eb2023-11-06 17:02:08 +0900957 if !is_valid_os(os_name) {
Andrew Walbrancc0db522021-07-12 17:03:42 +0000958 bail!("Unknown OS \"{}\"", os_name);
Jooyung Han35edb8f2021-07-01 16:17:16 +0900959 }
Andrew Walbrancc0db522021-07-12 17:03:42 +0000960
961 // It is safe to construct a filename based on the os_name because we've already checked that it
962 // is one of the allowed values.
Jooyung Han21e9b922021-06-26 04:14:16 +0900963 let vm_config_path = PathBuf::from(format!("/apex/com.android.virt/etc/{}.json", os_name));
964 let vm_config_file = File::open(vm_config_path)?;
Andrew Walbrancc0db522021-07-12 17:03:42 +0000965 let mut vm_config = VmConfig::load(&vm_config_file)?.to_parcelable()?;
Jooyung Han21e9b922021-06-26 04:14:16 +0900966
Nikita Ioffea0eb5ee2023-06-26 18:18:21 +0100967 if let Some(custom_config) = &config.customConfig {
968 if let Some(file) = custom_config.customKernelImage.as_ref() {
969 vm_config.kernel = Some(ParcelFileDescriptor::new(clone_file(file)?))
970 }
Nikita Ioffea0eb5ee2023-06-26 18:18:21 +0100971 vm_config.gdbPort = custom_config.gdbPort;
Nikita Ioffe5dfddf22023-06-29 16:11:26 +0100972
973 if let Some(file) = custom_config.vendorImage.as_ref() {
Nikita Ioffeaa6858c2023-07-04 01:37:41 +0100974 add_microdroid_vendor_image(clone_file(file)?, &mut vm_config);
975 append_kernel_param("androidboot.microdroid.mount_vendor=1", &mut vm_config)
Nikita Ioffe5dfddf22023-06-29 16:11:26 +0100976 }
Inseob Kim6ef80972023-07-20 17:23:36 +0900977
Chris Wailes6177c662024-05-09 14:37:44 -0700978 vm_config.devices.clone_from(&custom_config.devices);
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900979 vm_config.networkSupported = custom_config.networkSupported;
Nikita Ioffe26c35ed2023-06-05 17:49:08 +0100980 }
981
Andrew Walbrancc045902021-07-27 16:06:17 +0000982 if config.memoryMib > 0 {
983 vm_config.memoryMib = config.memoryMib;
Andrew Walbran45bcb0c2021-07-14 15:02:06 +0000984 }
985
Chris Wailes6177c662024-05-09 14:37:44 -0700986 vm_config.name.clone_from(&config.name);
Andrew Walbran3994f002022-01-27 17:33:45 +0000987 vm_config.protectedVm = config.protectedVm;
David Brazdil7d1e5ec2023-02-06 17:56:29 +0000988 vm_config.cpuTopology = config.cpuTopology;
Vincent Donnefort538a2c62024-03-20 16:01:10 +0000989 vm_config.hugePages = config.hugePages || vm_payload_config.hugepages;
David Dai23cff712024-06-13 19:23:45 +0000990 vm_config.boostUclamp = config.boostUclamp;
Jiyong Park032615f2022-01-10 13:55:34 +0900991
Shikha Panwar22e70452022-10-10 18:32:55 +0000992 // Microdroid takes additional init ramdisk & (optionally) storage image
Inseob Kim172f9eb2023-11-06 17:02:08 +0900993 add_microdroid_system_images(config, instance_file, storage_image, os_name, &mut vm_config)?;
Shikha Panwar22e70452022-10-10 18:32:55 +0000994
995 // Include Microdroid payload disk (contains apks, idsigs) in vm config
996 add_microdroid_payload_images(
Alan Stokes0d1ef782022-09-27 13:46:35 +0100997 config,
Jaewan Kim61f86142023-03-28 15:12:52 +0900998 debug_config,
Alan Stokes0d1ef782022-09-27 13:46:35 +0100999 temporary_directory,
1000 apk_file,
1001 idsig_file,
Alan Stokesfda70842023-12-20 17:50:14 +00001002 extra_apk_files,
Alan Stokes0d1ef782022-09-27 13:46:35 +01001003 &vm_payload_config,
1004 &mut vm_config,
1005 )?;
Jooyung Han21e9b922021-06-26 04:14:16 +09001006
Andrew Walbrancc0db522021-07-12 17:03:42 +00001007 Ok(vm_config)
Jooyung Han21e9b922021-06-26 04:14:16 +09001008}
1009
Inseob Kimff48a7c2024-02-26 22:07:21 +09001010fn check_partition_for_file(fd: &ParcelFileDescriptor) -> Result<()> {
1011 let path = format!("/proc/self/fd/{}", fd.as_raw_fd());
1012 let link = fs::read_link(&path).context(format!("can't read_link {path}"))?;
1013
1014 // microdroid vendor image is OK
1015 if cfg!(vendor_modules) && link == Path::new("/vendor/etc/avf/microdroid/microdroid_vendor.img")
1016 {
1017 return Ok(());
1018 }
1019
1020 if link.starts_with("/vendor") || link.starts_with("/odm") {
1021 bail!("vendor or odm file {} can't be used for VM", link.display());
1022 }
1023
1024 Ok(())
1025}
1026
1027fn check_partitions_for_files(config: &VirtualMachineRawConfig) -> Result<()> {
1028 config
1029 .disks
1030 .iter()
1031 .flat_map(|disk| disk.partitions.iter())
1032 .filter_map(|partition| partition.image.as_ref())
1033 .try_for_each(check_partition_for_file)?;
1034
1035 config.kernel.as_ref().map_or(Ok(()), check_partition_for_file)?;
1036 config.initrd.as_ref().map_or(Ok(()), check_partition_for_file)?;
1037 config.bootloader.as_ref().map_or(Ok(()), check_partition_for_file)?;
1038
1039 Ok(())
1040}
1041
Alan Stokes0d1ef782022-09-27 13:46:35 +01001042fn load_vm_payload_config_from_file(apk_file: &File, config_path: &str) -> Result<VmPayloadConfig> {
1043 let mut apk_zip = ZipArchive::new(apk_file)?;
1044 let config_file = apk_zip.by_name(config_path)?;
1045 Ok(serde_json::from_reader(config_file)?)
1046}
1047
Alan Stokes8f12f2b2023-01-09 09:19:20 +00001048fn create_vm_payload_config(
1049 payload_config: &VirtualMachinePayloadConfig,
1050) -> Result<VmPayloadConfig> {
Alan Stokes0d1ef782022-09-27 13:46:35 +01001051 // There isn't an actual config file. Construct a synthetic VmPayloadConfig from the explicit
1052 // parameters we've been given. Microdroid will do something equivalent inside the VM using the
1053 // payload config that we send it via the metadata file.
Alan Stokes8f12f2b2023-01-09 09:19:20 +00001054
1055 let payload_binary_name = &payload_config.payloadBinaryName;
1056 if payload_binary_name.contains('/') {
1057 bail!("Payload binary name must not specify a path: {payload_binary_name}");
1058 }
1059
1060 let task = Task { type_: TaskType::MicrodroidLauncher, command: payload_binary_name.clone() };
Alan Stokesfda70842023-12-20 17:50:14 +00001061
1062 // The VM only cares about how many there are, these names are actually ignored.
1063 let extra_apk_count = payload_config.extraApks.len();
1064 let extra_apks =
1065 (0..extra_apk_count).map(|i| ApkConfig { path: format!("extra-apk-{i}") }).collect();
1066
Inseob Kim89b24592024-02-23 18:59:43 +09001067 Ok(VmPayloadConfig { task: Some(task), extra_apks, ..Default::default() })
Alan Stokes0d1ef782022-09-27 13:46:35 +01001068}
1069
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001070/// Generates a unique filename to use for a composite disk image.
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001071fn make_composite_image_filenames(
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001072 temporary_directory: &Path,
1073 next_temporary_image_id: &mut u64,
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001074) -> CompositeImageFilenames {
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001075 let id = *next_temporary_image_id;
1076 *next_temporary_image_id += 1;
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001077 CompositeImageFilenames {
1078 composite: temporary_directory.join(format!("composite-{}.img", id)),
1079 header: temporary_directory.join(format!("composite-{}-header.img", id)),
1080 footer: temporary_directory.join(format!("composite-{}-footer.img", id)),
1081 }
1082}
1083
1084/// Filenames for a composite disk image, including header and footer partitions.
1085#[derive(Clone, Debug, Eq, PartialEq)]
1086struct CompositeImageFilenames {
1087 /// The composite disk image itself.
1088 composite: PathBuf,
1089 /// The header partition image.
1090 header: PathBuf,
1091 /// The footer partition image.
1092 footer: PathBuf,
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001093}
1094
Jiyong Park753553b2021-07-12 21:21:09 +09001095/// Checks whether the caller has a specific permission
1096fn check_permission(perm: &str) -> binder::Result<()> {
David Brazdil1f530702022-10-03 12:18:10 +01001097 let calling_pid = get_calling_pid();
1098 let calling_uid = get_calling_uid();
Jiyong Park753553b2021-07-12 21:21:09 +09001099 // Root can do anything
1100 if calling_uid == 0 {
1101 return Ok(());
1102 }
1103 let perm_svc: Strong<dyn IPermissionController::IPermissionController> =
Frederick Mayleb2a02872024-05-08 13:35:12 -07001104 binder::wait_for_interface("permission")?;
Jiyong Park753553b2021-07-12 21:21:09 +09001105 if perm_svc.checkPermission(perm, calling_pid, calling_uid as i32)? {
Andrew Walbran806f1542021-06-10 14:07:12 +00001106 Ok(())
1107 } else {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001108 Err(anyhow!("does not have the {} permission", perm))
1109 .or_binder_exception(ExceptionCode::SECURITY)
Andrew Walbran806f1542021-06-10 14:07:12 +00001110 }
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001111}
1112
Jiyong Park753553b2021-07-12 21:21:09 +09001113/// Check whether the caller of the current Binder method is allowed to manage VMs
1114fn check_manage_access() -> binder::Result<()> {
1115 check_permission("android.permission.MANAGE_VIRTUAL_MACHINE")
1116}
1117
Inseob Kim1119d702022-05-02 18:01:58 +09001118/// Check whether the caller of the current Binder method is allowed to create custom VMs
1119fn check_use_custom_virtual_machine() -> binder::Result<()> {
1120 check_permission("android.permission.USE_CUSTOM_VIRTUAL_MACHINE")
1121}
1122
Alan Stokes185fe112023-01-10 16:20:55 +00001123/// Return whether a partition is exempt from selinux label checks, because we know that it does
1124/// not contain code and is likely to be generated in an app-writable directory.
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001125fn is_safe_app_partition(label: &str) -> bool {
Shikha Panwara2ff8c52022-11-30 19:25:46 +00001126 // See add_microdroid_system_images & add_microdroid_payload_images in payload.rs.
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001127 label == "vm-instance"
Shikha Panwara2ff8c52022-11-30 19:25:46 +00001128 || label == "encryptedstore"
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001129 || label == "microdroid-apk-idsig"
1130 || label == "payload-metadata"
1131 || label.starts_with("extra-idsig-")
1132}
1133
Alice Wangc206b9b2023-08-28 14:13:51 +00001134/// Returns whether a partition with the given label is safe for a raw config VM.
1135fn is_safe_raw_partition(label: &str) -> bool {
1136 label == "vm-instance"
1137}
1138
Alan Stokes185fe112023-01-10 16:20:55 +00001139/// Check that a file SELinux label is acceptable.
1140///
1141/// We only want to allow code in a VM to be sourced from places that apps, and the
Seungjae Yoo2b74c442023-11-15 18:05:07 +09001142/// system or vendor, do not have write access to.
Alan Stokes185fe112023-01-10 16:20:55 +00001143///
1144/// Note that sepolicy must also grant read access for these types to both virtualization
1145/// service and crosvm.
1146///
1147/// App private data files are deliberately excluded, to avoid arbitrary payloads being run on
1148/// user devices (W^X).
1149fn check_label_is_allowed(context: &SeContext) -> Result<()> {
1150 match context.selinux_type()? {
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001151 | "apk_data_file" // APKs of an installed app
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001152 | "shell_data_file" // test files created via adb shell
Alan Stokesfe4bb0c2023-03-20 14:15:36 +00001153 | "staging_data_file" // updated/staged APEX images
1154 | "system_file" // immutable dm-verity protected partition
1155 | "virtualizationservice_data_file" // files created by VS / VirtMgr
Seungjae Yoo2b74c442023-11-15 18:05:07 +09001156 | "vendor_microdroid_file" // immutable dm-verity protected partition (/vendor/etc/avf/microdroid/.*)
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001157 => Ok(()),
Alan Stokes185fe112023-01-10 16:20:55 +00001158 _ => bail!("Label {} is not allowed", context),
Jiyong Park029977d2021-11-24 21:56:49 +09001159 }
1160}
1161
Alan Stokes185fe112023-01-10 16:20:55 +00001162fn check_label_for_partition(partition: &Partition) -> Result<()> {
1163 let file = partition.image.as_ref().unwrap().as_ref();
1164 check_label_is_allowed(&getfilecon(file)?)
1165 .with_context(|| format!("Partition {} invalid", &partition.label))
1166}
1167
1168fn check_label_for_kernel_files(kernel: &Option<File>, initrd: &Option<File>) -> Result<()> {
1169 if let Some(f) = kernel {
1170 check_label_for_file(f, "kernel")?;
1171 }
1172 if let Some(f) = initrd {
1173 check_label_for_file(f, "initrd")?;
1174 }
1175 Ok(())
1176}
1177fn check_label_for_file(file: &File, name: &str) -> Result<()> {
1178 check_label_is_allowed(&getfilecon(file)?).with_context(|| format!("{} file invalid", name))
1179}
1180
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001181/// Implementation of the AIDL `IVirtualMachine` interface. Used as a handle to a VM.
1182#[derive(Debug)]
1183struct VirtualMachine {
1184 instance: Arc<VmInstance>,
1185}
1186
1187impl VirtualMachine {
1188 fn create(instance: Arc<VmInstance>) -> Strong<dyn IVirtualMachine> {
David Brazdil4b4c5102022-12-19 22:56:20 +00001189 BnVirtualMachine::new_binder(VirtualMachine { instance }, BinderFeatures::default())
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001190 }
1191}
1192
1193impl Interface for VirtualMachine {}
1194
1195impl IVirtualMachine for VirtualMachine {
1196 fn getCid(&self) -> binder::Result<i32> {
Jiyong Park753553b2021-07-12 21:21:09 +09001197 // Don't check permission. The owner of the VM might have passed this binder object to
1198 // others.
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001199 Ok(self.instance.cid as i32)
1200 }
Andrew Walbrandae07162021-03-12 17:05:20 +00001201
Andrew Walbran6b650662021-09-07 13:13:23 +00001202 fn getState(&self) -> binder::Result<VirtualMachineState> {
Jiyong Park753553b2021-07-12 21:21:09 +09001203 // Don't check permission. The owner of the VM might have passed this binder object to
1204 // others.
Andrew Walbran6b650662021-09-07 13:13:23 +00001205 Ok(get_state(&self.instance))
Andrew Walbrandae07162021-03-12 17:05:20 +00001206 }
1207
1208 fn registerCallback(
1209 &self,
1210 callback: &Strong<dyn IVirtualMachineCallback>,
1211 ) -> binder::Result<()> {
Jiyong Park753553b2021-07-12 21:21:09 +09001212 // Don't check permission. The owner of the VM might have passed this binder object to
1213 // others.
1214 //
Andrew Walbrandae07162021-03-12 17:05:20 +00001215 // TODO: Should this give an error if the VM is already dead?
1216 self.instance.callbacks.add(callback.clone());
1217 Ok(())
1218 }
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001219
Andrew Walbranf8d94112021-09-07 11:45:36 +00001220 fn start(&self) -> binder::Result<()> {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001221 self.instance
1222 .start()
1223 .with_context(|| format!("Error starting VM with CID {}", self.instance.cid))
1224 .with_log()
1225 .or_service_specific_exception(-1)
Andrew Walbranf8d94112021-09-07 11:45:36 +00001226 }
1227
Inseob Kima446f802022-07-11 19:46:37 +09001228 fn stop(&self) -> binder::Result<()> {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001229 self.instance
1230 .kill()
1231 .with_context(|| format!("Error stopping VM with CID {}", self.instance.cid))
1232 .with_log()
1233 .or_service_specific_exception(-1)
Inseob Kima446f802022-07-11 19:46:37 +09001234 }
1235
Keir Frasercdd4b112022-11-24 14:02:25 +00001236 fn onTrimMemory(&self, level: MemoryTrimLevel) -> binder::Result<()> {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001237 self.instance
1238 .trim_memory(level)
1239 .with_context(|| format!("Error trimming VM with CID {}", self.instance.cid))
1240 .with_log()
1241 .or_service_specific_exception(-1)
Keir Frasercdd4b112022-11-24 14:02:25 +00001242 }
1243
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001244 fn connectVsock(&self, port: i32) -> binder::Result<ParcelFileDescriptor> {
Andrew Walbranf8d94112021-09-07 11:45:36 +00001245 if !matches!(&*self.instance.vm_state.lock().unwrap(), VmState::Running { .. }) {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001246 return Err(anyhow!("VM is not running")).or_service_specific_exception(-1);
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001247 }
Alan Stokes10c47672022-12-13 17:17:08 +00001248 let port = port as u32;
1249 if port < 1024 {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001250 return Err(anyhow!("Can't connect to privileged port {port}"))
1251 .or_service_specific_exception(-1);
Alan Stokes10c47672022-12-13 17:17:08 +00001252 }
Jiyong Park2227eaa2023-08-04 11:59:18 +09001253 let stream = VsockStream::connect_with_cid_port(self.instance.cid, port)
1254 .context("Failed to connect")
1255 .or_service_specific_exception(-1)?;
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001256 Ok(vsock_stream_to_pfd(stream))
1257 }
Yi-Yo Chiang2fbf0da2024-06-14 22:56:56 +08001258
1259 fn setHostConsoleName(&self, ptsname: &str) -> binder::Result<()> {
1260 self.instance.vm_context.global_context.setHostConsoleName(ptsname)
1261 }
Jiyong Park23b67392024-07-04 13:51:42 +09001262
1263 fn suspend(&self) -> binder::Result<()> {
1264 self.instance
1265 .suspend()
1266 .with_context(|| format!("Error suspending VM with CID {}", self.instance.cid))
1267 .with_log()
1268 .or_service_specific_exception(-1)
1269 }
1270
1271 fn resume(&self) -> binder::Result<()> {
1272 self.instance
1273 .resume()
1274 .with_context(|| format!("Error resuming VM with CID {}", self.instance.cid))
1275 .with_log()
1276 .or_service_specific_exception(-1)
1277 }
Andrew Walbrandae07162021-03-12 17:05:20 +00001278}
1279
1280impl Drop for VirtualMachine {
1281 fn drop(&mut self) {
1282 debug!("Dropping {:?}", self);
Inseob Kima446f802022-07-11 19:46:37 +09001283 if let Err(e) = self.instance.kill() {
1284 debug!("Error stopping dropped VM with CID {}: {:?}", self.instance.cid, e);
1285 }
Andrew Walbrandae07162021-03-12 17:05:20 +00001286 }
1287}
1288
1289/// A set of Binders to be called back in response to various events on the VM, such as when it
1290/// dies.
1291#[derive(Debug, Default)]
1292pub struct VirtualMachineCallbacks(Mutex<Vec<Strong<dyn IVirtualMachineCallback>>>);
1293
1294impl VirtualMachineCallbacks {
Jiyong Park8611a6c2021-07-09 18:17:44 +09001295 /// Call all registered callbacks to notify that the payload has started.
David Brazdil451cc962022-10-14 14:08:12 +01001296 pub fn notify_payload_started(&self, cid: Cid) {
Jiyong Park8611a6c2021-07-09 18:17:44 +09001297 let callbacks = &*self.0.lock().unwrap();
Jiyong Park8611a6c2021-07-09 18:17:44 +09001298 for callback in callbacks {
David Brazdil451cc962022-10-14 14:08:12 +01001299 if let Err(e) = callback.onPayloadStarted(cid as i32) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001300 error!("Error notifying payload start event from VM CID {}: {:?}", cid, e);
Jiyong Park8611a6c2021-07-09 18:17:44 +09001301 }
1302 }
1303 }
1304
Inseob Kim14cb8692021-08-31 21:50:39 +09001305 /// Call all registered callbacks to notify that the payload is ready to serve.
1306 pub fn notify_payload_ready(&self, cid: Cid) {
1307 let callbacks = &*self.0.lock().unwrap();
1308 for callback in callbacks {
1309 if let Err(e) = callback.onPayloadReady(cid as i32) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001310 error!("Error notifying payload ready event from VM CID {}: {:?}", cid, e);
Inseob Kim14cb8692021-08-31 21:50:39 +09001311 }
1312 }
1313 }
1314
Inseob Kim2444af92021-08-31 01:22:50 +09001315 /// Call all registered callbacks to notify that the payload has finished.
1316 pub fn notify_payload_finished(&self, cid: Cid, exit_code: i32) {
1317 let callbacks = &*self.0.lock().unwrap();
1318 for callback in callbacks {
1319 if let Err(e) = callback.onPayloadFinished(cid as i32, exit_code) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001320 error!("Error notifying payload finish event from VM CID {}: {:?}", cid, e);
Inseob Kim2444af92021-08-31 01:22:50 +09001321 }
1322 }
1323 }
1324
Jooyung Handd0a1732021-11-23 15:26:20 +09001325 /// Call all registered callbacks to say that the VM encountered an error.
Alan Stokes2bead0d2022-09-05 16:58:34 +01001326 pub fn notify_error(&self, cid: Cid, error_code: ErrorCode, message: &str) {
Jooyung Handd0a1732021-11-23 15:26:20 +09001327 let callbacks = &*self.0.lock().unwrap();
1328 for callback in callbacks {
1329 if let Err(e) = callback.onError(cid as i32, error_code, message) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001330 error!("Error notifying error event from VM CID {}: {:?}", cid, e);
Jooyung Handd0a1732021-11-23 15:26:20 +09001331 }
1332 }
1333 }
1334
Andrew Walbrandae07162021-03-12 17:05:20 +00001335 /// Call all registered callbacks to say that the VM has died.
Andrew Walbranc92d35f2022-01-12 12:45:19 +00001336 pub fn callback_on_died(&self, cid: Cid, reason: DeathReason) {
Andrew Walbrandae07162021-03-12 17:05:20 +00001337 let callbacks = &*self.0.lock().unwrap();
1338 for callback in callbacks {
Andrew Walbranc92d35f2022-01-12 12:45:19 +00001339 if let Err(e) = callback.onDied(cid as i32, reason) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001340 error!("Error notifying exit of VM CID {}: {:?}", cid, e);
Andrew Walbrandae07162021-03-12 17:05:20 +00001341 }
1342 }
1343 }
1344
1345 /// Add a new callback to the set.
1346 fn add(&self, callback: Strong<dyn IVirtualMachineCallback>) {
1347 self.0.lock().unwrap().push(callback);
1348 }
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001349}
1350
Andrew Walbranf6bf6862021-05-21 12:41:13 +00001351/// The mutable state of the VirtualizationService. There should only be one instance of this
1352/// struct.
Chris Wailes641fc4a2021-12-01 15:03:21 -08001353#[derive(Debug, Default)]
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001354struct State {
Alan Stokes3e5eec12023-09-07 12:10:00 +01001355 /// The VMs which have been started. When VMs are started a weak reference is added to this
1356 /// list while a strong reference is returned to the caller over Binder. Once all copies of
1357 /// the Binder client are dropped the weak reference here will become invalid, and will be
1358 /// removed from the list opportunistically the next time `add_vm` is called.
Andrew Walbran320b5602021-03-04 16:11:12 +00001359 vms: Vec<Weak<VmInstance>>,
1360}
1361
1362impl State {
Andrew Walbrandae07162021-03-12 17:05:20 +00001363 /// Get a list of VMs which still have Binder references to them.
Andrew Walbran320b5602021-03-04 16:11:12 +00001364 fn vms(&self) -> Vec<Arc<VmInstance>> {
1365 // Attempt to upgrade the weak pointers to strong pointers.
1366 self.vms.iter().filter_map(Weak::upgrade).collect()
1367 }
1368
1369 /// Add a new VM to the list.
1370 fn add_vm(&mut self, vm: Weak<VmInstance>) {
1371 // Garbage collect any entries from the stored list which no longer exist.
1372 self.vms.retain(|vm| vm.strong_count() > 0);
1373
1374 // Actually add the new VM.
1375 self.vms.push(vm);
1376 }
David Brazdil3c2ddef2021-03-18 13:09:57 +00001377
Jiyong Park8611a6c2021-07-09 18:17:44 +09001378 /// Get a VM that corresponds to the given cid
1379 fn get_vm(&self, cid: Cid) -> Option<Arc<VmInstance>> {
1380 self.vms().into_iter().find(|vm| vm.cid == cid)
1381 }
Jiyong Parkd50a0242021-09-16 21:00:14 +09001382}
1383
Andrew Walbran6b650662021-09-07 13:13:23 +00001384/// Gets the `VirtualMachineState` of the given `VmInstance`.
1385fn get_state(instance: &VmInstance) -> VirtualMachineState {
Andrew Walbranf8d94112021-09-07 11:45:36 +00001386 match &*instance.vm_state.lock().unwrap() {
1387 VmState::NotStarted { .. } => VirtualMachineState::NOT_STARTED,
1388 VmState::Running { .. } => match instance.payload_state() {
Andrew Walbran6b650662021-09-07 13:13:23 +00001389 PayloadState::Starting => VirtualMachineState::STARTING,
1390 PayloadState::Started => VirtualMachineState::STARTED,
1391 PayloadState::Ready => VirtualMachineState::READY,
1392 PayloadState::Finished => VirtualMachineState::FINISHED,
Jiyong Parka4eebde2022-07-12 18:01:12 +09001393 PayloadState::Hangup => VirtualMachineState::DEAD,
Andrew Walbranf8d94112021-09-07 11:45:36 +00001394 },
1395 VmState::Dead => VirtualMachineState::DEAD,
1396 VmState::Failed => VirtualMachineState::DEAD,
Andrew Walbran6b650662021-09-07 13:13:23 +00001397 }
1398}
1399
David Brazdilf50c7a62023-04-19 14:22:42 +00001400/// Converts a `&ParcelFileDescriptor` to a `File` by cloning the file.
Jiyong Park2227eaa2023-08-04 11:59:18 +09001401pub fn clone_file(file: &ParcelFileDescriptor) -> binder::Result<File> {
1402 file.as_ref()
1403 .try_clone()
1404 .context("Failed to clone File from ParcelFileDescriptor")
1405 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)
Andrei Homescu11333c62023-11-09 04:26:39 +00001406 .map(File::from)
David Brazdilf50c7a62023-04-19 14:22:42 +00001407}
1408
Andrew Walbrand3a84182021-09-07 14:48:52 +00001409/// Converts an `&Option<ParcelFileDescriptor>` to an `Option<File>` by cloning the file.
Jiyong Park2227eaa2023-08-04 11:59:18 +09001410fn maybe_clone_file(file: &Option<ParcelFileDescriptor>) -> binder::Result<Option<File>> {
Andrew Walbrand3a84182021-09-07 14:48:52 +00001411 file.as_ref().map(clone_file).transpose()
1412}
1413
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001414/// Converts a `VsockStream` to a `ParcelFileDescriptor`.
1415fn vsock_stream_to_pfd(stream: VsockStream) -> ParcelFileDescriptor {
1416 // SAFETY: ownership is transferred from stream to f
1417 let f = unsafe { File::from_raw_fd(stream.into_raw_fd()) };
1418 ParcelFileDescriptor::new(f)
1419}
1420
Jiyong Parkdcf17412022-02-08 15:07:23 +09001421/// Parses the platform version requirement string.
Jiyong Park2227eaa2023-08-04 11:59:18 +09001422fn parse_platform_version_req(s: &str) -> binder::Result<VersionReq> {
1423 VersionReq::parse(s)
1424 .with_context(|| format!("Invalid platform version requirement {}", s))
1425 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)
Jiyong Parkdcf17412022-02-08 15:07:23 +09001426}
1427
Jiyong Parked180932023-02-24 19:55:41 +09001428/// Create the empty ramdump file
1429fn prepare_ramdump_file(temporary_directory: &Path) -> binder::Result<File> {
1430 // `ramdump_write` is sent to crosvm and will be the backing store for the /dev/hvc1 where
1431 // VM will emit ramdump to. `ramdump_read` will be sent back to the client (i.e. the VM
1432 // owner) for readout.
1433 let ramdump_path = temporary_directory.join("ramdump");
Jiyong Park2227eaa2023-08-04 11:59:18 +09001434 let ramdump = File::create(ramdump_path)
1435 .context("Failed to prepare ramdump file")
1436 .with_log()
1437 .or_service_specific_exception(-1)?;
Jiyong Parked180932023-02-24 19:55:41 +09001438 Ok(ramdump)
1439}
1440
Nikita Ioffe5776f082023-02-10 21:38:26 +00001441fn is_protected(config: &VirtualMachineConfig) -> bool {
1442 match config {
1443 VirtualMachineConfig::RawConfig(config) => config.protectedVm,
1444 VirtualMachineConfig::AppConfig(config) => config.protectedVm,
1445 }
1446}
1447
1448fn check_gdb_allowed(config: &VirtualMachineConfig) -> binder::Result<()> {
1449 if is_protected(config) {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001450 return Err(anyhow!("Can't use gdb with protected VMs"))
1451 .or_binder_exception(ExceptionCode::SECURITY);
Nikita Ioffe5776f082023-02-10 21:38:26 +00001452 }
1453
Pierre-Clément Tosid3bbe1d2024-04-15 18:03:51 +01001454 if get_debug_level(config) == Some(DebugLevel::NONE) {
1455 return Err(anyhow!("Can't use gdb with non-debuggable VMs"))
1456 .or_binder_exception(ExceptionCode::SECURITY);
Nikita Ioffe5776f082023-02-10 21:38:26 +00001457 }
Pierre-Clément Tosid3bbe1d2024-04-15 18:03:51 +01001458
1459 Ok(())
Nikita Ioffe5776f082023-02-10 21:38:26 +00001460}
1461
Shikha Panwar61a74b52024-02-16 13:17:01 +00001462fn extract_instance_id(config: &VirtualMachineConfig) -> [u8; 64] {
1463 match config {
1464 VirtualMachineConfig::RawConfig(config) => config.instanceId,
1465 VirtualMachineConfig::AppConfig(config) => config.instanceId,
1466 }
1467}
1468
Alan Stokesc96b35e2024-05-03 13:21:20 +01001469fn extract_want_updatable(config: &VirtualMachineConfig) -> bool {
1470 match config {
1471 VirtualMachineConfig::RawConfig(_) => true,
1472 VirtualMachineConfig::AppConfig(config) => {
1473 let Some(custom) = &config.customConfig else { return true };
1474 custom.wantUpdatable
1475 }
1476 }
1477}
1478
Nikita Ioffe5776f082023-02-10 21:38:26 +00001479fn extract_gdb_port(config: &VirtualMachineConfig) -> Option<NonZeroU16> {
1480 match config {
1481 VirtualMachineConfig::RawConfig(config) => NonZeroU16::new(config.gdbPort as u16),
Nikita Ioffea0eb5ee2023-06-26 18:18:21 +01001482 VirtualMachineConfig::AppConfig(config) => {
1483 NonZeroU16::new(config.customConfig.as_ref().map(|c| c.gdbPort).unwrap_or(0) as u16)
1484 }
Nikita Ioffe5776f082023-02-10 21:38:26 +00001485 }
1486}
1487
Nikita Ioffe631717e2023-09-05 13:38:07 +01001488fn check_no_vendor_modules(config: &VirtualMachineConfig) -> binder::Result<()> {
1489 let VirtualMachineConfig::AppConfig(config) = config else { return Ok(()) };
1490 if let Some(custom_config) = &config.customConfig {
1491 if custom_config.vendorImage.is_some() || custom_config.customKernelImage.is_some() {
1492 return Err(anyhow!("vendor modules feature is disabled"))
1493 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1494 }
1495 }
1496 Ok(())
1497}
1498
Nikita Ioffe94a8a182023-11-16 16:37:48 +00001499fn check_no_devices(config: &VirtualMachineConfig) -> binder::Result<()> {
1500 let VirtualMachineConfig::AppConfig(config) = config else { return Ok(()) };
1501 if let Some(custom_config) = &config.customConfig {
1502 if !custom_config.devices.is_empty() {
1503 return Err(anyhow!("device assignment feature is disabled"))
1504 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1505 }
1506 }
1507 Ok(())
1508}
1509
Alan Stokesfda70842023-12-20 17:50:14 +00001510fn check_no_extra_apks(config: &VirtualMachineConfig) -> binder::Result<()> {
1511 let VirtualMachineConfig::AppConfig(config) = config else { return Ok(()) };
1512 let Payload::PayloadConfig(payload_config) = &config.payload else { return Ok(()) };
1513 if !payload_config.extraApks.is_empty() {
1514 return Err(anyhow!("multi-tenant feature is disabled"))
1515 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1516 }
1517 Ok(())
1518}
1519
Nikita Ioffef934e812024-07-05 15:44:41 +00001520fn check_protected_vm_is_supported() -> binder::Result<()> {
1521 let is_pvm_supported =
1522 hypervisor_props::is_protected_vm_supported().or_service_specific_exception(-1)?;
1523 if is_pvm_supported {
1524 Ok(())
1525 } else {
1526 Err(anyhow!("pVM is not supported"))
1527 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION)
1528 }
1529}
1530
Nikita Ioffe631717e2023-09-05 13:38:07 +01001531fn check_config_features(config: &VirtualMachineConfig) -> binder::Result<()> {
1532 if !cfg!(vendor_modules) {
1533 check_no_vendor_modules(config)?;
1534 }
Nikita Ioffe94a8a182023-11-16 16:37:48 +00001535 if !cfg!(device_assignment) {
1536 check_no_devices(config)?;
1537 }
Alan Stokesfda70842023-12-20 17:50:14 +00001538 if !cfg!(multi_tenant) {
1539 check_no_extra_apks(config)?;
1540 }
Nikita Ioffe631717e2023-09-05 13:38:07 +01001541 Ok(())
1542}
1543
Inseob Kim0168b462022-12-27 14:54:35 +09001544fn clone_or_prepare_logger_fd(
Jaewan Kim61f86142023-03-28 15:12:52 +09001545 debug_config: &DebugConfig,
Inseob Kim0168b462022-12-27 14:54:35 +09001546 fd: Option<&ParcelFileDescriptor>,
1547 tag: String,
1548) -> Result<Option<File>, Status> {
1549 if let Some(fd) = fd {
1550 return Ok(Some(clone_file(fd)?));
1551 }
1552
Jaewan Kim61f86142023-03-28 15:12:52 +09001553 if !debug_config.should_prepare_console_output() {
Jaewan Kim66f062e2023-02-25 01:07:43 +09001554 return Ok(None);
1555 };
Inseob Kim0168b462022-12-27 14:54:35 +09001556
Frederick Maylefbbcfcd2024-04-08 16:31:54 -07001557 let (read_fd, write_fd) =
Jiyong Park2227eaa2023-08-04 11:59:18 +09001558 pipe().context("Failed to create pipe").or_service_specific_exception(-1)?;
Inseob Kim0168b462022-12-27 14:54:35 +09001559
Frederick Maylefbbcfcd2024-04-08 16:31:54 -07001560 let mut reader = BufReader::new(File::from(read_fd));
1561 let write_fd = File::from(write_fd);
Inseob Kim0168b462022-12-27 14:54:35 +09001562
1563 std::thread::spawn(move || loop {
1564 let mut buf = vec![];
1565 match reader.read_until(b'\n', &mut buf) {
1566 Ok(0) => {
1567 // EOF
1568 return;
1569 }
1570 Ok(size) => {
1571 if buf[size - 1] == b'\n' {
1572 buf.pop();
1573 }
1574 info!("{}: {}", &tag, &String::from_utf8_lossy(&buf));
1575 }
1576 Err(e) => {
1577 error!("Could not read console pipe: {:?}", e);
1578 return;
1579 }
1580 };
1581 });
1582
1583 Ok(Some(write_fd))
1584}
1585
Jooyung Han35edb8f2021-07-01 16:17:16 +09001586/// Simple utility for referencing Borrowed or Owned. Similar to std::borrow::Cow, but
1587/// it doesn't require that T implements Clone.
1588enum BorrowedOrOwned<'a, T> {
1589 Borrowed(&'a T),
1590 Owned(T),
1591}
1592
1593impl<'a, T> AsRef<T> for BorrowedOrOwned<'a, T> {
1594 fn as_ref(&self) -> &T {
1595 match self {
1596 Self::Borrowed(b) => b,
Chris Wailes68c39f82021-07-27 16:03:44 -07001597 Self::Owned(o) => o,
Jooyung Han35edb8f2021-07-01 16:17:16 +09001598 }
1599 }
1600}
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001601
1602/// Implementation of `IVirtualMachineService`, the entry point of the AIDL service.
1603#[derive(Debug, Default)]
1604struct VirtualMachineService {
1605 state: Arc<Mutex<State>>,
Inseob Kimc7d28c72021-10-25 14:28:10 +00001606 cid: Cid,
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001607}
1608
1609impl Interface for VirtualMachineService {}
1610
1611impl IVirtualMachineService for VirtualMachineService {
Inseob Kimc7d28c72021-10-25 14:28:10 +00001612 fn notifyPayloadStarted(&self) -> binder::Result<()> {
1613 let cid = self.cid;
Inseob Kim7f61fe72021-08-20 20:50:47 +09001614 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01001615 info!("VM with CID {} started payload", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001616 vm.update_payload_state(PayloadState::Started)
1617 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
David Brazdil451cc962022-10-14 14:08:12 +01001618 vm.callbacks.notify_payload_started(cid);
Seungjae Yoo62085c02022-08-12 04:44:52 +00001619
Seungjae Yoo6d265d92022-11-15 10:51:33 +09001620 let vm_start_timestamp = vm.vm_metric.lock().unwrap().start_timestamp;
1621 write_vm_booted_stats(vm.requester_uid as i32, &vm.name, vm_start_timestamp);
Inseob Kim7f61fe72021-08-20 20:50:47 +09001622 Ok(())
1623 } else {
Jooyung Handd0a1732021-11-23 15:26:20 +09001624 error!("notifyPayloadStarted is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001625 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001626 }
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001627 }
Inseob Kim2444af92021-08-31 01:22:50 +09001628
Inseob Kimc7d28c72021-10-25 14:28:10 +00001629 fn notifyPayloadReady(&self) -> binder::Result<()> {
1630 let cid = self.cid;
Inseob Kim14cb8692021-08-31 21:50:39 +09001631 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01001632 info!("VM with CID {} reported payload is ready", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001633 vm.update_payload_state(PayloadState::Ready)
1634 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
Inseob Kim14cb8692021-08-31 21:50:39 +09001635 vm.callbacks.notify_payload_ready(cid);
1636 Ok(())
1637 } else {
Jooyung Handd0a1732021-11-23 15:26:20 +09001638 error!("notifyPayloadReady is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001639 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Inseob Kim14cb8692021-08-31 21:50:39 +09001640 }
1641 }
1642
Inseob Kimc7d28c72021-10-25 14:28:10 +00001643 fn notifyPayloadFinished(&self, exit_code: i32) -> binder::Result<()> {
1644 let cid = self.cid;
Inseob Kim2444af92021-08-31 01:22:50 +09001645 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01001646 info!("VM with CID {} finished payload", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001647 vm.update_payload_state(PayloadState::Finished)
1648 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
Inseob Kim2444af92021-08-31 01:22:50 +09001649 vm.callbacks.notify_payload_finished(cid, exit_code);
1650 Ok(())
1651 } else {
Jooyung Handd0a1732021-11-23 15:26:20 +09001652 error!("notifyPayloadFinished is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001653 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Jooyung Handd0a1732021-11-23 15:26:20 +09001654 }
1655 }
1656
Alan Stokes2bead0d2022-09-05 16:58:34 +01001657 fn notifyError(&self, error_code: ErrorCode, message: &str) -> binder::Result<()> {
Jooyung Handd0a1732021-11-23 15:26:20 +09001658 let cid = self.cid;
1659 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01001660 info!("VM with CID {} encountered an error", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001661 vm.update_payload_state(PayloadState::Finished)
1662 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
Jooyung Handd0a1732021-11-23 15:26:20 +09001663 vm.callbacks.notify_error(cid, error_code, message);
1664 Ok(())
1665 } else {
Seungjae Yooec8c1602022-06-20 05:28:00 +00001666 error!("notifyError is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001667 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Inseob Kim2444af92021-08-31 01:22:50 +09001668 }
1669 }
Alice Wangc2fec932023-02-23 16:24:02 +00001670
Shikha Panware45e9422024-02-28 21:18:10 +00001671 fn getSecretkeeper(&self) -> binder::Result<Strong<dyn ISecretkeeper>> {
1672 if !is_secretkeeper_supported() {
1673 return Err(StatusCode::NAME_NOT_FOUND)?;
1674 }
1675 let sk = binder::wait_for_interface(SECRETKEEPER_IDENTIFIER)?;
1676 Ok(BnSecretkeeper::new_binder(SecretkeeperProxy(sk), BinderFeatures::default()))
Shikha Panwar5d6a6752023-12-14 22:08:26 +00001677 }
1678
Alice Wange64dd182024-01-17 15:57:55 +00001679 fn requestAttestation(&self, csr: &[u8], test_mode: bool) -> binder::Result<Vec<Certificate>> {
1680 GLOBAL_SERVICE.requestAttestation(csr, get_calling_uid() as i32, test_mode)
Alice Wangc2fec932023-02-23 16:24:02 +00001681 }
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001682}
1683
Shikha Panwar8707f0f2024-02-28 20:40:42 +00001684fn is_secretkeeper_supported() -> bool {
Shikha Panwar81d13d32024-03-10 19:39:23 +00001685 binder::is_declared(SECRETKEEPER_IDENTIFIER)
1686 .expect("Could not check for declared Secretkeeper interface")
Shikha Panwar8187ca22024-01-04 08:33:08 +00001687}
1688
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001689impl VirtualMachineService {
Inseob Kimc7d28c72021-10-25 14:28:10 +00001690 fn new_binder(state: Arc<Mutex<State>>, cid: Cid) -> Strong<dyn IVirtualMachineService> {
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001691 BnVirtualMachineService::new_binder(
Inseob Kimc7d28c72021-10-25 14:28:10 +00001692 VirtualMachineService { state, cid },
Inseob Kim1b95f2e2021-08-19 13:17:40 +09001693 BinderFeatures::default(),
1694 )
1695 }
1696}
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001697
Stephen Hines4c1e2fc2024-02-09 16:34:47 -08001698struct SecretkeeperProxy(Strong<dyn ISecretkeeper>);
1699
1700impl Interface for SecretkeeperProxy {}
1701
1702impl ISecretkeeper for SecretkeeperProxy {
1703 fn processSecretManagementRequest(&self, req: &[u8]) -> binder::Result<Vec<u8>> {
1704 // Pass the request to the channel, and read the response.
1705 self.0.processSecretManagementRequest(req)
1706 }
1707
1708 fn getAuthGraphKe(&self) -> binder::Result<Strong<dyn IAuthGraphKeyExchange>> {
1709 let ag = AuthGraphKeyExchangeProxy(self.0.getAuthGraphKe()?);
1710 Ok(BnAuthGraphKeyExchange::new_binder(ag, BinderFeatures::default()))
1711 }
1712
1713 fn deleteIds(&self, ids: &[SecretId]) -> binder::Result<()> {
1714 self.0.deleteIds(ids)
1715 }
1716
1717 fn deleteAll(&self) -> binder::Result<()> {
1718 self.0.deleteAll()
1719 }
1720}
1721
1722struct AuthGraphKeyExchangeProxy(Strong<dyn IAuthGraphKeyExchange>);
1723
1724impl Interface for AuthGraphKeyExchangeProxy {}
1725
1726impl IAuthGraphKeyExchange for AuthGraphKeyExchangeProxy {
1727 fn create(&self) -> binder::Result<SessionInitiationInfo> {
1728 self.0.create()
1729 }
1730
1731 fn init(
1732 &self,
1733 peer_pub_key: &PubKey,
1734 peer_id: &Identity,
1735 peer_nonce: &[u8],
1736 peer_version: i32,
1737 ) -> binder::Result<KeInitResult> {
1738 self.0.init(peer_pub_key, peer_id, peer_nonce, peer_version)
1739 }
1740
1741 fn finish(
1742 &self,
1743 peer_pub_key: &PubKey,
1744 peer_id: &Identity,
1745 peer_signature: &SessionIdSignature,
1746 peer_nonce: &[u8],
1747 peer_version: i32,
1748 own_key: &Key,
1749 ) -> binder::Result<SessionInfo> {
1750 self.0.finish(peer_pub_key, peer_id, peer_signature, peer_nonce, peer_version, own_key)
1751 }
1752
1753 fn authenticationComplete(
1754 &self,
1755 peer_signature: &SessionIdSignature,
1756 shared_keys: &[AuthgraphArc; 2],
1757 ) -> binder::Result<[AuthgraphArc; 2]> {
1758 self.0.authenticationComplete(peer_signature, shared_keys)
1759 }
1760}
1761
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001762#[cfg(test)]
1763mod tests {
1764 use super::*;
1765
1766 #[test]
1767 fn test_is_allowed_label_for_partition() -> Result<()> {
1768 let expected_results = vec![
1769 ("u:object_r:system_file:s0", true),
1770 ("u:object_r:apk_data_file:s0", true),
1771 ("u:object_r:app_data_file:s0", false),
1772 ("u:object_r:app_data_file:s0:c512,c768", false),
1773 ("u:object_r:privapp_data_file:s0:c512,c768", false),
1774 ("invalid", false),
1775 ("user:role:apk_data_file:severity:categories", true),
1776 ("user:role:apk_data_file:severity:categories:extraneous", false),
1777 ];
1778
1779 for (label, expected_valid) in expected_results {
1780 let context = SeContext::new(label)?;
1781 let result = check_label_is_allowed(&context);
1782 if expected_valid {
1783 assert!(result.is_ok(), "Expected label {} to be allowed, got {:?}", label, result);
1784 } else if result.is_ok() {
1785 bail!("Expected label {} to be disallowed", label);
1786 }
1787 }
1788 Ok(())
1789 }
Nikita Ioffef1ce9872022-12-09 13:31:59 +00001790
1791 #[test]
1792 fn test_create_or_update_idsig_file_empty_apk() -> Result<()> {
1793 let apk = tempfile::tempfile().unwrap();
1794 let idsig = tempfile::tempfile().unwrap();
1795
1796 let ret = create_or_update_idsig_file(
1797 &ParcelFileDescriptor::new(apk),
1798 &ParcelFileDescriptor::new(idsig),
1799 );
1800 assert!(ret.is_err(), "should fail");
1801 Ok(())
1802 }
1803
1804 #[test]
1805 fn test_create_or_update_idsig_dir_instead_of_file_for_apk() -> Result<()> {
1806 let tmp_dir = tempfile::TempDir::new().unwrap();
1807 let apk = File::open(tmp_dir.path()).unwrap();
1808 let idsig = tempfile::tempfile().unwrap();
1809
1810 let ret = create_or_update_idsig_file(
1811 &ParcelFileDescriptor::new(apk),
1812 &ParcelFileDescriptor::new(idsig),
1813 );
1814 assert!(ret.is_err(), "should fail");
1815 Ok(())
1816 }
1817
1818 /// Verifies that create_or_update_idsig_file won't oom if a fd that corresponds to a directory
1819 /// on ext4 filesystem is passed.
1820 /// On ext4 lseek on a directory fd will return (off_t)-1 (see:
1821 /// https://bugzilla.kernel.org/show_bug.cgi?id=200043), which will result in
1822 /// create_or_update_idsig_file ooming while attempting to allocate petabytes of memory.
1823 #[test]
1824 fn test_create_or_update_idsig_does_not_crash_dir_on_ext4() -> Result<()> {
1825 // APEXes are backed by the ext4.
1826 let apk = File::open("/apex/com.android.virt/").unwrap();
1827 let idsig = tempfile::tempfile().unwrap();
1828
1829 let ret = create_or_update_idsig_file(
1830 &ParcelFileDescriptor::new(apk),
1831 &ParcelFileDescriptor::new(idsig),
1832 );
1833 assert!(ret.is_err(), "should fail");
1834 Ok(())
1835 }
Jiyong Park8d192952023-06-26 14:29:51 +09001836
1837 #[test]
1838 fn test_create_or_update_idsig_does_not_update_if_already_valid() -> Result<()> {
1839 use std::io::Seek;
1840
1841 // Pick any APK
1842 let mut apk = File::open("/system/priv-app/Shell/Shell.apk").unwrap();
1843 let mut idsig = tempfile::tempfile().unwrap();
1844
1845 create_or_update_idsig_file(
1846 &ParcelFileDescriptor::new(apk.try_clone()?),
1847 &ParcelFileDescriptor::new(idsig.try_clone()?),
1848 )?;
1849 let modified_orig = idsig.metadata()?.modified()?;
1850 apk.rewind()?;
1851 idsig.rewind()?;
1852
1853 // Call the function again
1854 create_or_update_idsig_file(
1855 &ParcelFileDescriptor::new(apk.try_clone()?),
1856 &ParcelFileDescriptor::new(idsig.try_clone()?),
1857 )?;
1858 let modified_new = idsig.metadata()?.modified()?;
1859 assert!(modified_orig == modified_new, "idsig file was updated unnecessarily");
1860 Ok(())
1861 }
Nikita Ioffeaa6858c2023-07-04 01:37:41 +01001862
1863 #[test]
Shikha Panwar9ae2e622024-01-30 12:22:30 +00001864 fn test_create_or_update_idsig_on_non_empty_file() -> Result<()> {
1865 use std::io::Read;
1866
1867 // Pick any APK
1868 let mut apk = File::open("/system/priv-app/Shell/Shell.apk").unwrap();
1869 let idsig_empty = tempfile::tempfile().unwrap();
1870 let mut idsig_invalid = tempfile::tempfile().unwrap();
1871 idsig_invalid.write_all(b"Oops")?;
1872
1873 // Create new idsig
1874 create_or_update_idsig_file(
1875 &ParcelFileDescriptor::new(apk.try_clone()?),
1876 &ParcelFileDescriptor::new(idsig_empty.try_clone()?),
1877 )?;
1878 apk.rewind()?;
1879
1880 // Update idsig_invalid
1881 create_or_update_idsig_file(
1882 &ParcelFileDescriptor::new(apk.try_clone()?),
1883 &ParcelFileDescriptor::new(idsig_invalid.try_clone()?),
1884 )?;
1885
1886 // Ensure the 2 idsig files have same size!
1887 assert!(
1888 idsig_empty.metadata()?.len() == idsig_invalid.metadata()?.len(),
1889 "idsig files differ in size"
1890 );
1891 // Ensure the 2 idsig files have same content!
1892 for (b1, b2) in idsig_empty.bytes().zip(idsig_invalid.bytes()) {
1893 assert!(b1.unwrap() == b2.unwrap(), "idsig files differ")
1894 }
1895 Ok(())
1896 }
1897 #[test]
Nikita Ioffeaa6858c2023-07-04 01:37:41 +01001898 fn test_append_kernel_param_first_param() {
1899 let mut vm_config = VirtualMachineRawConfig { ..Default::default() };
1900 append_kernel_param("foo=1", &mut vm_config);
1901 assert_eq!(vm_config.params, Some("foo=1".to_owned()))
1902 }
1903
1904 #[test]
1905 fn test_append_kernel_param() {
1906 let mut vm_config =
1907 VirtualMachineRawConfig { params: Some("foo=5".to_owned()), ..Default::default() };
1908 append_kernel_param("bar=42", &mut vm_config);
1909 assert_eq!(vm_config.params, Some("foo=5 bar=42".to_owned()))
1910 }
Seungjae Yooec3bc522023-11-09 10:14:30 +09001911
Inseob Kim46257382024-01-03 15:41:22 +09001912 fn test_extract_os_name_from_config_path(
1913 path: &Path,
1914 expected_result: Option<&str>,
1915 ) -> Result<()> {
1916 let result = extract_os_name_from_config_path(path);
1917 if result.as_deref() != expected_result {
1918 bail!("Expected {:?} but was {:?}", expected_result, &result)
1919 }
1920 Ok(())
1921 }
1922
1923 #[test]
1924 fn test_extract_os_name_from_microdroid_config() -> Result<()> {
1925 test_extract_os_name_from_config_path(
1926 Path::new("/apex/com.android.virt/etc/microdroid.json"),
1927 Some("microdroid"),
1928 )
1929 }
1930
1931 #[test]
1932 fn test_extract_os_name_from_microdroid_gki_config() -> Result<()> {
1933 test_extract_os_name_from_config_path(
1934 Path::new("/apex/com.android.virt/etc/microdroid_gki-android14-6.1.json"),
1935 Some("microdroid_gki-android14-6.1"),
1936 )
1937 }
1938
1939 #[test]
1940 fn test_extract_os_name_from_invalid_path() -> Result<()> {
1941 test_extract_os_name_from_config_path(
1942 Path::new("/apex/com.android.virt/etc/microdroid.img"),
1943 None,
1944 )
1945 }
1946
1947 #[test]
1948 fn test_extract_os_name_from_configs() -> Result<()> {
1949 let tmp_dir = tempfile::TempDir::new()?;
1950 let tmp_dir_path = tmp_dir.path().to_owned();
1951
1952 let mut os_names: HashSet<String> = HashSet::new();
1953 os_names.insert("microdroid".to_owned());
1954 os_names.insert("microdroid_gki-android14-6.1".to_owned());
1955 os_names.insert("microdroid_gki-android15-6.1".to_owned());
1956
1957 // config files
1958 for os_name in &os_names {
1959 std::fs::write(tmp_dir_path.join(os_name.to_owned() + ".json"), b"")?;
1960 }
1961
1962 // fake files not related to configs
1963 std::fs::write(tmp_dir_path.join("microdroid_super.img"), b"")?;
1964 std::fs::write(tmp_dir_path.join("microdroid_foobar.apk"), b"")?;
1965
1966 let glob_pattern = match tmp_dir_path.join("microdroid*.json").to_str() {
1967 Some(s) => s.to_owned(),
1968 None => bail!("tmp_dir_path {:?} is not UTF-8", tmp_dir_path),
1969 };
1970
1971 let result = extract_os_names_from_configs(&glob_pattern)?;
1972 if result != os_names {
1973 bail!("Expected {:?} but was {:?}", os_names, result);
1974 }
1975 Ok(())
1976 }
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001977}