blob: 0c5480b5b434d5d4933e5fa5366d2fdecf00d7f4 [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;
Akilesh Kailash05515dc2024-10-22 21:42:52 -070020use crate::crosvm::{AudioConfig, CrosvmConfig, DiskFile, SharedPathConfig, DisplayConfig, GpuConfig, InputDeviceOption, PayloadState, UsbConfig, VmContext, VmInstance, VmState};
Jaewan Kimabd328b2024-12-10 15:59:33 +090021use crate::debug_config::{DebugConfig, DebugPolicy};
Shikha Panwar55e10ec2024-02-13 12:53:49 +000022use crate::dt_overlay::{create_device_tree_overlay, VM_DT_OVERLAY_MAX_SIZE, VM_DT_OVERLAY_PATH};
Inseob Kimf79c5722024-12-16 17:29:57 +090023use crate::payload::{ApexInfoList, add_microdroid_payload_images, add_microdroid_system_images, add_microdroid_vendor_image};
Nikita Ioffe13748d22024-10-23 15:10:39 +000024use crate::selinux::{check_tee_service_permission, getfilecon, getprevcon, 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::{
Jaewan Kimf43372b2024-12-13 18:33:58 +090032 AssignedDevices::AssignedDevices,
Inseob Kim53d0b212023-07-20 16:58:37 +090033 AssignableDevice::AssignableDevice,
Andrew Walbran6b650662021-09-07 13:13:23 +000034 DiskImage::DiskImage,
Akilesh Kailash05515dc2024-10-22 21:42:52 -070035 SharedPath::SharedPath,
Jeongik Chac181be72024-03-27 00:18:30 +090036 InputDevice::InputDevice,
Devin Moore407df8f2024-08-27 19:39:16 +000037 IVirtualMachine::{self, BnVirtualMachine},
Andrew Walbran6b650662021-09-07 13:13:23 +000038 IVirtualMachineCallback::IVirtualMachineCallback,
39 IVirtualizationService::IVirtualizationService,
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};
Inseob Kimecde8c02024-09-03 13:11:08 +090049use android_system_virtualizationservice_internal::aidl::android::system::virtualizationservice_internal::IGlobalVmContext::IGlobalVmContext;
David Brazdilafc9a9e2023-01-12 16:08:10 +000050use android_system_virtualizationservice_internal::aidl::android::system::virtualizationservice_internal::IVirtualizationServiceInternal::IVirtualizationServiceInternal;
Seungjae Yoodd91f0f2022-11-09 15:25:21 +090051use android_system_virtualmachineservice::aidl::android::system::virtualmachineservice::IVirtualMachineService::{
David Brazdilafc9a9e2023-01-12 16:08:10 +000052 BnVirtualMachineService, IVirtualMachineService,
Seungjae Yoofd9a0622022-10-14 10:01:29 +090053};
Shikha Panware45e9422024-02-28 21:18:10 +000054use android_hardware_security_secretkeeper::aidl::android::hardware::security::secretkeeper::ISecretkeeper::{BnSecretkeeper, ISecretkeeper};
Shikha Panwar5d6a6752023-12-14 22:08:26 +000055use android_hardware_security_secretkeeper::aidl::android::hardware::security::secretkeeper::SecretId::SecretId;
Matt Gilbrideb57abcc2024-10-12 15:26:45 +000056use android_hardware_security_secretkeeper::aidl::android::hardware::security::secretkeeper::PublicKey::PublicKey;
Shikha Panwar5d6a6752023-12-14 22:08:26 +000057use android_hardware_security_authgraph::aidl::android::hardware::security::authgraph::{
58 Arc::Arc as AuthgraphArc, IAuthGraphKeyExchange::IAuthGraphKeyExchange,
59 IAuthGraphKeyExchange::BnAuthGraphKeyExchange, Identity::Identity, KeInitResult::KeInitResult,
60 Key::Key, PubKey::PubKey, SessionIdSignature::SessionIdSignature, SessionInfo::SessionInfo,
61 SessionInitiationInfo::SessionInitiationInfo,
62};
Inseob Kim7e1877b2024-11-07 17:28:56 +090063use anyhow::{anyhow, bail, ensure, Context, Result};
Seungjae Yoofd9a0622022-10-14 10:01:29 +090064use apkverify::{HashAlgorithm, V4Signature};
Jiyong Parkd7bd2f22023-08-10 20:41:19 +090065use avflog::LogResult;
Alan Stokes0e82b502022-08-08 14:44:48 +010066use binder::{
Devin Moore407df8f2024-08-27 19:39:16 +000067 self, wait_for_interface, Accessor, BinderFeatures, ConnectionInfo, ExceptionCode, Interface, ParcelFileDescriptor,
68 SpIBinder, Status, StatusCode, Strong, IntoBinderResult,
Andrew Walbrana89fc132021-03-17 17:08:36 +000069};
Inseob Kim46257382024-01-03 15:41:22 +090070use glob::glob;
Devin Moorec8800a12024-10-17 17:56:18 +000071use libc::{AF_VSOCK, sa_family_t, sockaddr_vm};
Seungjae Yoo0a8c84c2022-07-11 08:19:15 +000072use log::{debug, error, info, warn};
Nikita Ioffe901083f2025-01-20 01:54:28 +000073use microdroid_payload_config::{ApexConfig, 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 Kimecde8c02024-09-03 13:11:08 +090078use serde::Deserialize;
Inseob Kim7e1877b2024-11-07 17:28:56 +090079use std::collections::{HashSet, HashMap};
Andrew Walbrandff3b942021-06-09 15:20:36 +000080use std::convert::TryInto;
Shikha Panwar55e10ec2024-02-13 12:53:49 +000081use std::fs;
Jaewan Kim39952072024-01-19 17:04:53 +090082use std::ffi::CStr;
Inseob Kimecde8c02024-09-03 13:11:08 +090083use std::fs::{canonicalize, create_dir_all, read_dir, remove_dir_all, remove_file, File, OpenOptions};
Shikha Panwar9ae2e622024-01-30 12:22:30 +000084use std::io::{BufRead, BufReader, Error, ErrorKind, Seek, SeekFrom, Write};
Inseob Kim46257382024-01-03 15:41:22 +090085use std::iter;
Nikita Ioffe5776f082023-02-10 21:38:26 +000086use std::num::{NonZeroU16, NonZeroU32};
Inseob Kimecde8c02024-09-03 13:11:08 +090087use std::ops::Range;
Jiyong Parkaf63d1c2024-09-04 16:15:42 +090088use std::os::unix::io::{AsRawFd, FromRawFd, IntoRawFd};
David Brazdilafc9a9e2023-01-12 16:08:10 +000089use std::os::unix::raw::pid_t;
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +000090use std::path::{Path, PathBuf};
Andrew Walbran9c03a3a2024-09-03 12:12:59 +010091use std::sync::{Arc, Mutex, Weak, LazyLock};
Seungjae Yoo14e60182024-02-21 13:28:31 +090092use vbmeta::VbMetaImage;
Pierre-Clément Tosid3bbe1d2024-04-15 18:03:51 +010093use vmconfig::{VmConfig, get_debug_level};
Devin Moorec8800a12024-10-17 17:56:18 +000094use vsock::VsockStream;
Jooyung Han35edb8f2021-07-01 16:17:16 +090095use zip::ZipArchive;
Andrew Walbrand6dce6f2021-03-05 16:39:08 +000096
David Brazdil41d1a872022-10-05 14:44:19 +010097/// The unique ID of a VM used (together with a port number) for vsock communication.
98pub type Cid = u32;
99
David Brazdil4b4c5102022-12-19 22:56:20 +0000100pub const BINDER_SERVICE_IDENTIFIER: &str = "android.system.virtualizationservice";
101
Devin Moore407df8f2024-08-27 19:39:16 +0000102/// Vsock privileged ports are below this number.
103const VSOCK_PRIV_PORT_MAX: u32 = 1024;
104
Jooyung Han95884632021-07-06 22:27:54 +0900105/// The size of zero.img.
106/// Gaps in composite disk images are filled with a shared zero.img.
107const ZERO_FILLER_SIZE: u64 = 4096;
108
David Brazdilf50c7a62023-04-19 14:22:42 +0000109/// Magic string for the instance image
110const ANDROID_VM_INSTANCE_MAGIC: &str = "Android-VM-instance";
111
112/// Version of the instance image format
113const ANDROID_VM_INSTANCE_VERSION: u16 = 1;
114
Alan Stokes0d1ef782022-09-27 13:46:35 +0100115const MICRODROID_OS_NAME: &str = "microdroid";
116
Shikha Panwar5d6a6752023-12-14 22:08:26 +0000117const SECRETKEEPER_IDENTIFIER: &str =
Shikha Panwarbe5dee72024-02-21 19:06:20 +0000118 "android.hardware.security.secretkeeper.ISecretkeeper/default";
Shikha Panwar5d6a6752023-12-14 22:08:26 +0000119
David Brazdilf50c7a62023-04-19 14:22:42 +0000120const UNFORMATTED_STORAGE_MAGIC: &str = "UNFORMATTED-STORAGE";
121
122/// crosvm requires all partitions to be a multiple of 4KiB.
123const PARTITION_GRANULARITY_BYTES: u64 = 4096;
124
Shikha Panwar55e10ec2024-02-13 12:53:49 +0000125const VM_REFERENCE_DT_ON_HOST_PATH: &str = "/proc/device-tree/avf/reference";
126
Andrew Walbran9c03a3a2024-09-03 12:12:59 +0100127pub static GLOBAL_SERVICE: LazyLock<Strong<dyn IVirtualizationServiceInternal>> =
128 LazyLock::new(|| {
Inseob Kimecde8c02024-09-03 13:11:08 +0900129 if cfg!(early) {
130 panic!("Early virtmgr must not connect to VirtualizatinoServiceInternal")
131 } else {
132 wait_for_interface(BINDER_SERVICE_IDENTIFIER)
133 .expect("Could not connect to VirtualizationServiceInternal")
134 }
Andrew Walbran9c03a3a2024-09-03 12:12:59 +0100135 });
136static SUPPORTED_OS_NAMES: LazyLock<HashSet<String>> =
137 LazyLock::new(|| get_supported_os_names().expect("Failed to get list of supported os names"));
David Brazdil49f96f52022-12-16 21:29:13 +0000138
Inseob Kime3e932d2024-12-16 20:06:57 +0900139static CALLING_EXE_PATH: LazyLock<Option<PathBuf>> = LazyLock::new(|| {
140 let calling_exe_link = format!("/proc/{}/exe", get_calling_pid());
141 match fs::read_link(&calling_exe_link) {
142 Ok(calling_exe_path) => Some(calling_exe_path),
143 Err(e) => {
144 // virtmgr forked from apps fails to read /proc probably due to hidepid=2. As we
145 // discourage vendor apps, regarding such cases as system is safer.
146 // TODO(b/383969737): determine if this is okay. Or find a way how to track origins of
147 // apps.
148 warn!("can't read_link '{calling_exe_link}': {e:?}; regarding as system");
149 None
150 }
151 }
152});
153
Nikita Ioffef1ce9872022-12-09 13:31:59 +0000154fn create_or_update_idsig_file(
155 input_fd: &ParcelFileDescriptor,
156 idsig_fd: &ParcelFileDescriptor,
157) -> Result<()> {
158 let mut input = clone_file(input_fd)?;
159 let metadata = input.metadata().context("failed to get input metadata")?;
160 if !metadata.is_file() {
161 bail!("input is not a regular file");
162 }
Alan Stokes25f69362023-03-06 16:51:54 +0000163 let mut sig =
164 V4Signature::create(&mut input, get_current_sdk()?, 4096, &[], HashAlgorithm::SHA256)
165 .context("failed to create idsig")?;
Nikita Ioffef1ce9872022-12-09 13:31:59 +0000166
167 let mut output = clone_file(idsig_fd)?;
Jiyong Park8d192952023-06-26 14:29:51 +0900168
169 // Optimization. We don't have to update idsig file whenever a VM is started. Don't update it,
170 // if the idsig file already has the same APK digest.
171 if output.metadata()?.len() > 0 {
172 if let Ok(out_sig) = V4Signature::from_idsig(&mut output) {
173 if out_sig.signing_info.apk_digest == sig.signing_info.apk_digest {
174 debug!("idsig {:?} is up-to-date with apk {:?}.", output, input);
175 return Ok(());
176 }
177 }
178 // if we fail to read v4signature from output, that's fine. User can pass a random file.
179 // We will anyway overwrite the file to the v4signature generated from input_fd.
180 }
181
Shikha Panwar9ae2e622024-01-30 12:22:30 +0000182 output
183 .seek(SeekFrom::Start(0))
184 .context("failed to move cursor to start on the idsig output")?;
Nikita Ioffec09b0492022-12-14 20:18:33 +0000185 output.set_len(0).context("failed to set_len on the idsig output")?;
186 sig.write_into(&mut output).context("failed to write idsig")?;
Nikita Ioffef1ce9872022-12-09 13:31:59 +0000187 Ok(())
188}
189
Alan Stokes25f69362023-03-06 16:51:54 +0000190fn get_current_sdk() -> Result<u32> {
191 let current_sdk = system_properties::read("ro.build.version.sdk")?;
192 let current_sdk = current_sdk.ok_or_else(|| anyhow!("SDK version missing"))?;
193 current_sdk.parse().context("Malformed SDK version")
194}
195
David Brazdil4b4c5102022-12-19 22:56:20 +0000196pub fn remove_temporary_files(path: &PathBuf) -> Result<()> {
197 for dir_entry in read_dir(path)? {
198 remove_file(dir_entry?.path())?;
199 }
200 Ok(())
David Brazdil528e0472022-10-10 15:06:02 +0100201}
202
David Brazdil528e0472022-10-10 15:06:02 +0100203/// Implementation of `IVirtualizationService`, the entry point of the AIDL service.
David Brazdil49f96f52022-12-16 21:29:13 +0000204#[derive(Debug, Default)]
Andrew Walbranf6bf6862021-05-21 12:41:13 +0000205pub struct VirtualizationService {
Jiyong Park8611a6c2021-07-09 18:17:44 +0900206 state: Arc<Mutex<State>>,
Andrew Walbrand6dce6f2021-03-05 16:39:08 +0000207}
208
Shikha Panward8e35422021-10-11 13:51:27 +0000209impl Interface for VirtualizationService {
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000210 fn dump(&self, writer: &mut dyn Write, _args: &[&CStr]) -> Result<(), StatusCode> {
Shikha Panward8e35422021-10-11 13:51:27 +0000211 check_permission("android.permission.DUMP").or(Err(StatusCode::PERMISSION_DENIED))?;
212 let state = &mut *self.state.lock().unwrap();
213 let vms = state.vms();
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000214 writeln!(writer, "Running {0} VMs:", vms.len()).or(Err(StatusCode::UNKNOWN_ERROR))?;
Shikha Panward8e35422021-10-11 13:51:27 +0000215 for vm in vms {
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000216 writeln!(writer, "VM CID: {}", vm.cid).or(Err(StatusCode::UNKNOWN_ERROR))?;
217 writeln!(writer, "\tState: {:?}", vm.vm_state.lock().unwrap())
Shikha Panward8e35422021-10-11 13:51:27 +0000218 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000219 writeln!(writer, "\tPayload state {:?}", vm.payload_state())
Shikha Panward8e35422021-10-11 13:51:27 +0000220 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000221 writeln!(writer, "\tProtected: {}", vm.protected).or(Err(StatusCode::UNKNOWN_ERROR))?;
222 writeln!(writer, "\ttemporary_directory: {}", vm.temporary_directory.to_string_lossy())
Shikha Panward8e35422021-10-11 13:51:27 +0000223 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000224 writeln!(writer, "\trequester_uid: {}", vm.requester_uid)
Shikha Panward8e35422021-10-11 13:51:27 +0000225 .or(Err(StatusCode::UNKNOWN_ERROR))?;
Andrei Homescu0cf8e222023-11-09 04:27:55 +0000226 writeln!(writer, "\trequester_debug_pid: {}", vm.requester_debug_pid)
Shikha Panward8e35422021-10-11 13:51:27 +0000227 .or(Err(StatusCode::UNKNOWN_ERROR))?;
228 }
229 Ok(())
230 }
231}
Andrew Walbranf6bf6862021-05-21 12:41:13 +0000232impl IVirtualizationService for VirtualizationService {
Andrew Walbranf8d94112021-09-07 11:45:36 +0000233 /// Creates (but does not start) a new VM with the given configuration, assigning it the next
234 /// available CID.
Andrew Walbrand6dce6f2021-03-05 16:39:08 +0000235 ///
236 /// Returns a binder `IVirtualMachine` object referring to it, as a handle for the client.
Andrew Walbranf8d94112021-09-07 11:45:36 +0000237 fn createVm(
Andrew Walbrana89fc132021-03-17 17:08:36 +0000238 &self,
Andrew Walbran3a5a9212021-05-04 17:09:08 +0000239 config: &VirtualMachineConfig,
Jiyong Parke6fb1672023-06-26 16:45:55 +0900240 console_out_fd: Option<&ParcelFileDescriptor>,
241 console_in_fd: Option<&ParcelFileDescriptor>,
Andrew Walbrana89fc132021-03-17 17:08:36 +0000242 log_fd: Option<&ParcelFileDescriptor>,
Elie Kheirallah5c807a22024-09-23 20:40:42 +0000243 dump_dt_fd: Option<&ParcelFileDescriptor>,
Devin Moore407df8f2024-08-27 19:39:16 +0000244 ) -> binder::Result<Strong<dyn IVirtualMachine::IVirtualMachine>> {
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000245 let mut is_protected = false;
Jiyong Parke6fb1672023-06-26 16:45:55 +0900246 let ret = self.create_vm_internal(
247 config,
248 console_out_fd,
249 console_in_fd,
250 log_fd,
251 &mut is_protected,
Elie Kheirallah5c807a22024-09-23 20:40:42 +0000252 dump_dt_fd,
Jiyong Parke6fb1672023-06-26 16:45:55 +0900253 );
Seungjae Yoo0a8c84c2022-07-11 08:19:15 +0000254 write_vm_creation_stats(config, is_protected, &ret);
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000255 ret
Andrew Walbrand6dce6f2021-03-05 16:39:08 +0000256 }
Andrew Walbran320b5602021-03-04 16:11:12 +0000257
Shikha Panwar61a74b52024-02-16 13:17:01 +0000258 /// Allocate a new instance_id to the VM
259 fn allocateInstanceId(&self) -> binder::Result<[u8; 64]> {
Shikha Panwarbd5eba92024-03-27 20:23:31 +0000260 check_manage_access()?;
Shikha Panwar61a74b52024-02-16 13:17:01 +0000261 GLOBAL_SERVICE.allocateInstanceId()
262 }
263
Andrew Walbrandff3b942021-06-09 15:20:36 +0000264 /// Initialise an empty partition image of the given size to be used as a writable partition.
265 fn initializeWritablePartition(
266 &self,
267 image_fd: &ParcelFileDescriptor,
Alan Stokesff0005f2023-01-30 09:53:00 +0000268 size_bytes: i64,
Jiyong Park9dd389e2021-08-23 20:42:59 +0900269 partition_type: PartitionType,
Andrew Walbrandff3b942021-06-09 15:20:36 +0000270 ) -> binder::Result<()> {
Jiyong Park753553b2021-07-12 21:21:09 +0900271 check_manage_access()?;
Jiyong Park2227eaa2023-08-04 11:59:18 +0900272 let size_bytes = size_bytes
273 .try_into()
274 .with_context(|| format!("Invalid size: {}", size_bytes))
275 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000276 let size_bytes = round_up(size_bytes, PARTITION_GRANULARITY_BYTES);
Shikha Panwar9ae2e622024-01-30 12:22:30 +0000277 let mut image = clone_file(image_fd)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000278 // initialize the file. Any data in the file will be erased.
Shikha Panwar9ae2e622024-01-30 12:22:30 +0000279 image
280 .seek(SeekFrom::Start(0))
281 .context("failed to move cursor to start")
282 .or_service_specific_exception(-1)?;
Jiyong Park2227eaa2023-08-04 11:59:18 +0900283 image.set_len(0).context("Failed to reset a file").or_service_specific_exception(-1)?;
Frederick Mayle0d310572024-05-02 12:34:58 -0700284 // Set the file length. In most filesystems, this will not allocate any physical disk
285 // space, it will only change the logical size.
286 image
287 .set_len(size_bytes)
288 .context("Failed to extend file")
Jiyong Park2227eaa2023-08-04 11:59:18 +0900289 .or_service_specific_exception(-1)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000290
291 match partition_type {
292 PartitionType::RAW => Ok(()),
Frederick Mayle0d310572024-05-02 12:34:58 -0700293 PartitionType::ANDROID_VM_INSTANCE => format_as_android_vm_instance(&mut image),
294 PartitionType::ENCRYPTEDSTORE => format_as_encryptedstore(&mut image),
David Brazdilf50c7a62023-04-19 14:22:42 +0000295 _ => Err(Error::new(
296 ErrorKind::Unsupported,
297 format!("Unsupported partition type {:?}", partition_type),
298 )),
299 }
Jiyong Park2227eaa2023-08-04 11:59:18 +0900300 .with_context(|| format!("Failed to initialize partition as {:?}", partition_type))
301 .or_service_specific_exception(-1)?;
David Brazdilf50c7a62023-04-19 14:22:42 +0000302
303 Ok(())
Andrew Walbrandff3b942021-06-09 15:20:36 +0000304 }
305
Jiyong Park0a248432021-08-20 23:32:39 +0900306 /// Creates or update the idsig file by digesting the input APK file.
307 fn createOrUpdateIdsigFile(
308 &self,
309 input_fd: &ParcelFileDescriptor,
310 idsig_fd: &ParcelFileDescriptor,
311 ) -> binder::Result<()> {
Jiyong Parkc3ca24f2022-06-28 10:45:15 +0900312 check_manage_access()?;
313
Jiyong Park2227eaa2023-08-04 11:59:18 +0900314 create_or_update_idsig_file(input_fd, idsig_fd).or_service_specific_exception(-1)?;
Jiyong Park0a248432021-08-20 23:32:39 +0900315 Ok(())
316 }
317
Andrew Walbran320b5602021-03-04 16:11:12 +0000318 /// Get a list of all currently running VMs. This method is only intended for debug purposes,
319 /// and as such is only permitted from the shell user.
320 fn debugListVms(&self) -> binder::Result<Vec<VirtualMachineDebugInfo>> {
David Brazdil209074a2023-01-12 16:44:51 +0000321 // Delegate to the global service, including checking the debug permission.
David Brazdild4f51a52023-01-11 14:09:27 +0000322 GLOBAL_SERVICE.debugListVms()
Andrew Walbran320b5602021-03-04 16:11:12 +0000323 }
Inseob Kim53d0b212023-07-20 16:58:37 +0900324
325 /// Get a list of assignable device types.
326 fn getAssignableDevices(&self) -> binder::Result<Vec<AssignableDevice>> {
327 // Delegate to the global service, including checking the permission.
328 GLOBAL_SERVICE.getAssignableDevices()
329 }
Nikita Ioffef7c742a2023-09-04 16:57:59 +0100330
Inseob Kim46257382024-01-03 15:41:22 +0900331 /// Get a list of supported OSes.
332 fn getSupportedOSList(&self) -> binder::Result<Vec<String>> {
333 Ok(Vec::from_iter(SUPPORTED_OS_NAMES.iter().cloned()))
334 }
335
Jaewan Kimabd328b2024-12-10 15:59:33 +0900336 /// Get printable debug policy for testing and debugging
337 fn getDebugPolicy(&self) -> binder::Result<String> {
338 let debug_policy = DebugPolicy::from_host();
339 Ok(format!("{debug_policy:?}"))
340 }
341
Nikita Ioffef7c742a2023-09-04 16:57:59 +0100342 /// Returns whether given feature is enabled
343 fn isFeatureEnabled(&self, feature: &str) -> binder::Result<bool> {
344 check_manage_access()?;
Shikha Panwar6d306412024-02-17 21:37:49 +0000345 Ok(avf_features::is_feature_enabled(feature))
Nikita Ioffef7c742a2023-09-04 16:57:59 +0100346 }
Alice Wange64dd182024-01-17 15:57:55 +0000347
348 fn enableTestAttestation(&self) -> binder::Result<()> {
349 GLOBAL_SERVICE.enableTestAttestation()
350 }
Alice Wang0362f7f2024-03-21 08:16:26 +0000351
352 fn isRemoteAttestationSupported(&self) -> binder::Result<bool> {
353 check_manage_access()?;
354 GLOBAL_SERVICE.isRemoteAttestationSupported()
355 }
Shikha Panwar7aef66d2024-03-13 00:28:41 +0000356
357 fn isUpdatableVmSupported(&self) -> binder::Result<bool> {
358 // The response is specific to Microdroid. Updatable VMs are only possible if device
359 // supports Secretkeeper. Guest OS needs to use Secretkeeper based secrets. Microdroid does
360 // this, however other guest OSes may do things differently.
361 check_manage_access()?;
362 Ok(is_secretkeeper_supported())
363 }
Shikha Panwarbd5eba92024-03-27 20:23:31 +0000364
Shikha Panwar07d701c2024-03-28 14:43:52 +0000365 fn removeVmInstance(&self, instance_id: &[u8; 64]) -> binder::Result<()> {
366 check_manage_access()?;
367 GLOBAL_SERVICE.removeVmInstance(instance_id)
368 }
369
Shikha Panwarbd5eba92024-03-27 20:23:31 +0000370 fn claimVmInstance(&self, instance_id: &[u8; 64]) -> binder::Result<()> {
371 check_manage_access()?;
372 GLOBAL_SERVICE.claimVmInstance(instance_id)
373 }
Andrew Walbran320b5602021-03-04 16:11:12 +0000374}
375
Inseob Kimecde8c02024-09-03 13:11:08 +0900376/// Implementation of the AIDL `IGlobalVmContext` interface for early VMs.
377#[derive(Debug, Default)]
378struct EarlyVmContext {
379 /// The unique CID assigned to the VM for vsock communication.
380 cid: Cid,
381 /// Temporary directory for this VM instance.
382 temp_dir: PathBuf,
383}
384
385impl EarlyVmContext {
386 fn new(cid: Cid, temp_dir: PathBuf) -> Result<Self> {
387 // Remove the entire directory before creating a VM. Early VMs use predefined CIDs and AVF
388 // should trust clients, e.g. they won't run two VMs at the same time
389 let _ = remove_dir_all(&temp_dir);
390 create_dir_all(&temp_dir).context(format!("can't create '{}'", temp_dir.display()))?;
391
392 Ok(Self { cid, temp_dir })
393 }
394}
395
396impl Interface for EarlyVmContext {}
397
398impl Drop for EarlyVmContext {
399 fn drop(&mut self) {
400 if let Err(e) = remove_dir_all(&self.temp_dir) {
401 error!("Cannot remove {} upon dropping: {e}", self.temp_dir.display());
402 }
403 }
404}
405
406impl IGlobalVmContext for EarlyVmContext {
407 fn getCid(&self) -> binder::Result<i32> {
408 Ok(self.cid as i32)
409 }
410
411 fn getTemporaryDirectory(&self) -> binder::Result<String> {
412 Ok(self.temp_dir.to_string_lossy().to_string())
413 }
414
415 fn setHostConsoleName(&self, _pathname: &str) -> binder::Result<()> {
416 Err(Status::new_exception_str(
417 ExceptionCode::UNSUPPORTED_OPERATION,
418 Some("Early VM doesn't support setting host console name"),
419 ))
420 }
421}
422
Inseob Kime3e932d2024-12-16 20:06:57 +0900423fn find_partition(path: Option<&Path>) -> binder::Result<String> {
424 let path = match path {
425 Some(path) => path,
426 None => return Ok("system".to_owned()),
427 };
Inseob Kimf79c5722024-12-16 17:29:57 +0900428 let mut components = path.components();
429 match components.nth(1) {
Inseob Kimecde8c02024-09-03 13:11:08 +0900430 Some(std::path::Component::Normal(partition)) => {
Inseob Kimf79c5722024-12-16 17:29:57 +0900431 if partition != "apex" {
432 return Ok(partition.to_string_lossy().into_owned());
433 }
434
435 // If path is under /apex, find a partition of the preinstalled .apex path
436 let apex_name = match components.next() {
437 Some(std::path::Component::Normal(name)) => name.to_string_lossy(),
438 _ => {
439 return Err(anyhow!("Can't find apex name for '{}'", path.display()))
440 .or_service_specific_exception(-1)
441 }
442 };
443
444 let apex_info_list = ApexInfoList::load()
445 .context("Failed to get apex info list")
446 .or_service_specific_exception(-1)?;
447
448 for apex_info in apex_info_list.list.iter() {
449 if apex_info.name == apex_name {
450 return Ok(apex_info.partition.to_lowercase());
451 }
452 }
453
454 Err(anyhow!("Can't find apex info for '{apex_name}'")).or_service_specific_exception(-1)
Inseob Kimecde8c02024-09-03 13:11:08 +0900455 }
456 _ => Err(anyhow!("Can't find partition in '{}'", path.display()))
457 .or_service_specific_exception(-1),
458 }
459}
460
Jiyong Park8611a6c2021-07-09 18:17:44 +0900461impl VirtualizationService {
462 pub fn init() -> VirtualizationService {
David Brazdil49f96f52022-12-16 21:29:13 +0000463 VirtualizationService::default()
Jiyong Park8611a6c2021-07-09 18:17:44 +0900464 }
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000465
Inseob Kimecde8c02024-09-03 13:11:08 +0900466 fn create_early_vm_context(
467 &self,
468 config: &VirtualMachineConfig,
Inseob Kime3e932d2024-12-16 20:06:57 +0900469 calling_exe_path: Option<&Path>,
Inseob Kimecde8c02024-09-03 13:11:08 +0900470 ) -> binder::Result<(VmContext, Cid, PathBuf)> {
Inseob Kimecde8c02024-09-03 13:11:08 +0900471 let name = match config {
472 VirtualMachineConfig::RawConfig(config) => &config.name,
473 VirtualMachineConfig::AppConfig(config) => &config.name,
474 };
Inseob Kime3e932d2024-12-16 20:06:57 +0900475 let calling_partition = find_partition(calling_exe_path)?;
476 let early_vm = find_early_vm_for_partition(&calling_partition, name)
477 .or_service_specific_exception(-1)?;
478 let calling_exe_path = match calling_exe_path {
479 Some(path) => path,
480 None => {
481 return Err(anyhow!("Can't verify the path of PID {}", get_calling_pid()))
482 .or_service_specific_exception(-1)
483 }
484 };
485 if Path::new(&early_vm.path) != calling_exe_path {
Inseob Kimecde8c02024-09-03 13:11:08 +0900486 return Err(anyhow!(
Inseob Kime3e932d2024-12-16 20:06:57 +0900487 "VM '{name}' in partition '{calling_partition}' must be created with '{}', not '{}'",
Inseob Kimecde8c02024-09-03 13:11:08 +0900488 &early_vm.path,
Inseob Kime3e932d2024-12-16 20:06:57 +0900489 calling_exe_path.display()
Inseob Kimecde8c02024-09-03 13:11:08 +0900490 ))
491 .or_service_specific_exception(-1);
492 }
493
494 let cid = early_vm.cid as Cid;
495 let temp_dir = PathBuf::from(format!("/mnt/vm/early/{cid}"));
496
497 let context = EarlyVmContext::new(cid, temp_dir.clone())
498 .context(format!("Can't create early vm contexts for {cid}"))
499 .or_service_specific_exception(-1)?;
Inseob Kimecde8c02024-09-03 13:11:08 +0900500
Jiyong Park690c1ca2024-11-28 18:06:50 +0900501 if requires_vm_service(config) {
502 // Start VM service listening for connections from the new CID on port=CID.
503 let service = VirtualMachineService::new_binder(self.state.clone(), cid).as_binder();
504 let port = cid;
505 let (vm_server, _) = RpcServer::new_vsock(service, cid, port)
506 .context(format!("Could not start RpcServer on port {port}"))
507 .or_service_specific_exception(-1)?;
508 vm_server.start();
509 Ok((VmContext::new(Strong::new(Box::new(context)), Some(vm_server)), cid, temp_dir))
510 } else {
511 Ok((VmContext::new(Strong::new(Box::new(context)), None), cid, temp_dir))
512 }
Inseob Kimecde8c02024-09-03 13:11:08 +0900513 }
514
David Brazdil209074a2023-01-12 16:44:51 +0000515 fn create_vm_context(
516 &self,
517 requester_debug_pid: pid_t,
Jiyong Park690c1ca2024-11-28 18:06:50 +0900518 config: &VirtualMachineConfig,
David Brazdil209074a2023-01-12 16:44:51 +0000519 ) -> binder::Result<(VmContext, Cid, PathBuf)> {
David Brazdil8cf8f482022-11-23 14:21:26 +0000520 const NUM_ATTEMPTS: usize = 5;
521
522 for _ in 0..NUM_ATTEMPTS {
Charisee96113f32023-01-26 09:00:42 +0000523 let vm_context = GLOBAL_SERVICE.allocateGlobalVmContext(requester_debug_pid)?;
David Brazdild4f51a52023-01-11 14:09:27 +0000524 let cid = vm_context.getCid()? as Cid;
525 let temp_dir: PathBuf = vm_context.getTemporaryDirectory()?.into();
Jiyong Park690c1ca2024-11-28 18:06:50 +0900526
527 // We don't need to start the VM service for custom VMs.
528 if !requires_vm_service(config) {
529 return Ok((VmContext::new(vm_context, None), cid, temp_dir));
530 }
531
David Brazdil8cf8f482022-11-23 14:21:26 +0000532 let service = VirtualMachineService::new_binder(self.state.clone(), cid).as_binder();
533
534 // Start VM service listening for connections from the new CID on port=CID.
David Brazdil8cf8f482022-11-23 14:21:26 +0000535 let port = cid;
David Brazdil3238da42022-11-18 10:04:51 +0000536 match RpcServer::new_vsock(service, cid, port) {
Devin Moore068e6742024-10-28 18:16:25 +0000537 Ok((vm_server, _)) => {
David Brazdil8cf8f482022-11-23 14:21:26 +0000538 vm_server.start();
Jiyong Park690c1ca2024-11-28 18:06:50 +0900539 return Ok((VmContext::new(vm_context, Some(vm_server)), cid, temp_dir));
David Brazdil8cf8f482022-11-23 14:21:26 +0000540 }
541 Err(err) => {
542 warn!("Could not start RpcServer on port {}: {}", port, err);
543 }
544 }
545 }
Jiyong Park2227eaa2023-08-04 11:59:18 +0900546 Err(anyhow!("Too many attempts to create VM context failed"))
547 .or_service_specific_exception(-1)
David Brazdil8cf8f482022-11-23 14:21:26 +0000548 }
549
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000550 fn create_vm_internal(
551 &self,
552 config: &VirtualMachineConfig,
Jiyong Parke6fb1672023-06-26 16:45:55 +0900553 console_out_fd: Option<&ParcelFileDescriptor>,
554 console_in_fd: Option<&ParcelFileDescriptor>,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000555 log_fd: Option<&ParcelFileDescriptor>,
556 is_protected: &mut bool,
Elie Kheirallah5c807a22024-09-23 20:40:42 +0000557 dump_dt_fd: Option<&ParcelFileDescriptor>,
Devin Moore407df8f2024-08-27 19:39:16 +0000558 ) -> binder::Result<Strong<dyn IVirtualMachine::IVirtualMachine>> {
David Brazdil209074a2023-01-12 16:44:51 +0000559 let requester_uid = get_calling_uid();
560 let requester_debug_pid = get_calling_pid();
561
Nikita Ioffe631717e2023-09-05 13:38:07 +0100562 check_config_features(config)?;
563
Inseob Kimecde8c02024-09-03 13:11:08 +0900564 if cfg!(early) {
565 check_config_allowed_for_early_vms(config)?;
566 }
567
Nikita Ioffeb1416122024-10-22 12:18:49 +0000568 let caller_secontext = getprevcon().or_service_specific_exception(-1)?;
569 info!("callers secontext: {}", caller_secontext);
570
David Brazdil209074a2023-01-12 16:44:51 +0000571 // Allocating VM context checks the MANAGE_VIRTUAL_MACHINE permission.
Inseob Kimecde8c02024-09-03 13:11:08 +0900572 let (vm_context, cid, temporary_directory) = if cfg!(early) {
Inseob Kime3e932d2024-12-16 20:06:57 +0900573 self.create_early_vm_context(config, CALLING_EXE_PATH.as_deref())?
Inseob Kimecde8c02024-09-03 13:11:08 +0900574 } else {
Jiyong Park690c1ca2024-11-28 18:06:50 +0900575 self.create_vm_context(requester_debug_pid, config)?
Inseob Kimecde8c02024-09-03 13:11:08 +0900576 };
Inseob Kim1119d702022-05-02 18:01:58 +0900577
Alan Stokesfda70842023-12-20 17:50:14 +0000578 if is_custom_config(config) {
Alan Stokes7bc146c2022-10-20 17:10:32 +0100579 check_use_custom_virtual_machine()?;
Inseob Kim1119d702022-05-02 18:01:58 +0900580 }
581
Nikita Ioffe5776f082023-02-10 21:38:26 +0000582 let gdb_port = extract_gdb_port(config);
583
584 // Additional permission checks if caller request gdb.
585 if gdb_port.is_some() {
586 check_gdb_allowed(config)?;
587 }
588
Frederick Mayle196ca2b2024-12-18 15:27:43 -0800589 let instance_id = extract_instance_id(config);
Jaewan Kimf43372b2024-12-13 18:33:58 +0900590 let mut device_tree_overlays = vec![];
Frederick Mayle196ca2b2024-12-18 15:27:43 -0800591 if let Some(dt_overlay) =
592 maybe_create_reference_dt_overlay(config, &instance_id, &temporary_directory)?
593 {
Jaewan Kimf43372b2024-12-13 18:33:58 +0900594 device_tree_overlays.push(dt_overlay);
595 }
596 if let Some(dtbo) = get_dtbo(config) {
597 let dtbo = File::from(
598 dtbo.as_ref()
599 .try_clone()
600 .context("Failed to create VM DTBO from ParcelFileDescriptor")
601 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)?,
602 );
603 device_tree_overlays.push(dtbo);
604 }
Seungjae Yooec3bc522023-11-09 10:14:30 +0900605
Jaewan Kimf3143242024-03-15 06:56:31 +0000606 let debug_config = DebugConfig::new(config);
Nikita Ioffe2cb75cf2024-06-04 16:43:56 +0000607 let ramdump = if !uses_gki_kernel(config) && debug_config.is_ramdump_needed() {
Jiyong Parked180932023-02-24 19:55:41 +0900608 Some(prepare_ramdump_file(&temporary_directory)?)
609 } else {
610 None
611 };
612
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000613 let state = &mut *self.state.lock().unwrap();
Jiyong Parke6fb1672023-06-26 16:45:55 +0900614 let console_out_fd =
Pierre-Clément Tosifc523c52024-08-20 10:34:06 +0100615 clone_or_prepare_logger_fd(console_out_fd, format!("Console({})", cid))?;
Jiyong Parke6fb1672023-06-26 16:45:55 +0900616 let console_in_fd = console_in_fd.map(clone_file).transpose()?;
Pierre-Clément Tosifc523c52024-08-20 10:34:06 +0100617 let log_fd = clone_or_prepare_logger_fd(log_fd, format!("Log({})", cid))?;
Pierre-Clément Tosi9515d0f2024-04-15 15:58:07 +0100618 let dump_dt_fd = if let Some(fd) = dump_dt_fd {
619 Some(clone_file(fd)?)
620 } else if debug_config.dump_device_tree {
621 Some(prepare_dump_dt_file(&temporary_directory)?)
622 } else {
623 None
624 };
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000625
626 // Counter to generate unique IDs for temporary image files.
627 let mut next_temporary_image_id = 0;
628 // Files which are referred to from composite images. These must be mapped to the crosvm
629 // child process, and not closed before it is started.
630 let mut indirect_files = vec![];
631
Alan Stokes7bc146c2022-10-20 17:10:32 +0100632 let (is_app_config, config) = match config {
633 VirtualMachineConfig::RawConfig(config) => (false, BorrowedOrOwned::Borrowed(config)),
634 VirtualMachineConfig::AppConfig(config) => {
Jiyong Park2227eaa2023-08-04 11:59:18 +0900635 let config = load_app_config(config, &debug_config, &temporary_directory)
636 .or_service_specific_exception_with(-1, |e| {
Jaewan Kim61f86142023-03-28 15:12:52 +0900637 *is_protected = config.protectedVm;
638 let message = format!("Failed to load app config: {:?}", e);
639 error!("{}", message);
Jiyong Park2227eaa2023-08-04 11:59:18 +0900640 message
Jaewan Kim61f86142023-03-28 15:12:52 +0900641 })?;
Alan Stokes7bc146c2022-10-20 17:10:32 +0100642 (true, BorrowedOrOwned::Owned(config))
643 }
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000644 };
645 let config = config.as_ref();
646 *is_protected = config.protectedVm;
647
Nikita Ioffe9951e4b2024-11-14 17:30:50 +0000648 if !config.teeServices.is_empty() {
649 check_tee_service_permission(&caller_secontext, &config.teeServices)
650 .with_log()
651 .or_binder_exception(ExceptionCode::SECURITY)?;
652 }
Nikita Ioffe13748d22024-10-23 15:10:39 +0000653
Jiyong Park3051ffe2024-11-26 14:41:58 +0900654 let kernel = maybe_clone_file(&config.kernel)?;
655 let initrd = maybe_clone_file(&config.initrd)?;
656
657 if config.protectedVm {
658 // Fail fast with a meaningful error message in case device doesn't support pVMs.
659 check_protected_vm_is_supported()?;
660
661 // In a protected VM, we require custom kernels to come from a trusted source
662 // (b/237054515).
663 check_label_for_kernel_files(&kernel, &initrd).or_service_specific_exception(-1)?;
664
665 // Check if partition images are labeled incorrectly. This is to prevent random images
666 // which are not protected by the Android Verified Boot (e.g. bits downloaded by apps)
667 // from being loaded in a pVM. This applies to everything but the instance image in the
668 // raw config, and everything but the non-executable, generated partitions in the app
669 // config.
670 config
671 .disks
672 .iter()
673 .flat_map(|disk| disk.partitions.iter())
674 .filter(|partition| {
675 if is_app_config {
676 !is_safe_app_partition(&partition.label)
677 } else {
678 !is_safe_raw_partition(&partition.label)
679 }
680 })
681 .try_for_each(check_label_for_partition)
682 .or_service_specific_exception(-1)?;
683 }
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000684
Inseob Kimff48a7c2024-02-26 22:07:21 +0900685 // Check if files for payloads and bases are NOT coming from /vendor and /odm, as they may
686 // have unstable interfaces.
687 // TODO(b/316431494): remove once Treble interfaces are stabilized.
Inseob Kime3e932d2024-12-16 20:06:57 +0900688 check_partitions_for_files(config, &find_partition(CALLING_EXE_PATH.as_deref())?)
689 .or_service_specific_exception(-1)?;
Inseob Kimff48a7c2024-02-26 22:07:21 +0900690
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000691 let zero_filler_path = temporary_directory.join("zero.img");
Jiyong Park2227eaa2023-08-04 11:59:18 +0900692 write_zero_filler(&zero_filler_path)
693 .context("Failed to make composite image")
694 .with_log()
695 .or_service_specific_exception(-1)?;
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000696
697 // Assemble disk images if needed.
698 let disks = config
699 .disks
700 .iter()
701 .map(|disk| {
702 assemble_disk_image(
703 disk,
704 &zero_filler_path,
705 &temporary_directory,
706 &mut next_temporary_image_id,
707 &mut indirect_files,
708 )
709 })
710 .collect::<Result<Vec<DiskFile>, _>>()?;
711
Akilesh Kailash05515dc2024-10-22 21:42:52 -0700712 let shared_paths = assemble_shared_paths(&config.sharedPaths, &temporary_directory)?;
713
Jaewan Kimf43372b2024-12-13 18:33:58 +0900714 let (vfio_devices, dtbo) = match &config.devices {
715 AssignedDevices::Devices(devices) if !devices.is_empty() => {
716 let mut set = HashSet::new();
717 for device in devices.iter() {
718 let path = canonicalize(device)
719 .with_context(|| format!("can't canonicalize {device}"))
720 .or_service_specific_exception(-1)?;
721 if !set.insert(path) {
722 return Err(anyhow!("duplicated device {device}"))
723 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT);
724 }
Inseob Kim6ef80972023-07-20 17:23:36 +0900725 }
Jaewan Kimf43372b2024-12-13 18:33:58 +0900726 let devices = GLOBAL_SERVICE.bindDevicesToVfioDriver(devices)?;
727 let dtbo_file = File::from(
728 GLOBAL_SERVICE
729 .getDtboFile()?
730 .as_ref()
731 .try_clone()
732 .context("Failed to create VM DTBO from ParcelFileDescriptor")
733 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)?,
734 );
735 (devices, Some(dtbo_file))
Inseob Kim6ef80972023-07-20 17:23:36 +0900736 }
Jaewan Kimf43372b2024-12-13 18:33:58 +0900737 _ => (vec![], None),
Inseob Kim7307a892023-09-14 13:37:58 +0900738 };
Jeongik Cha798401c2024-04-11 21:54:49 +0900739 let display_config = if cfg!(paravirtualized_devices) {
740 config
741 .displayConfig
742 .as_ref()
743 .map(DisplayConfig::new)
744 .transpose()
745 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?
746 } else {
747 None
748 };
Jason Macnakea7b0fa2024-05-08 17:02:44 -0700749 let gpu_config = if cfg!(paravirtualized_devices) {
750 config
751 .gpuConfig
752 .as_ref()
753 .map(GpuConfig::new)
754 .transpose()
755 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?
756 } else {
757 None
758 };
Jeongik Cha1df1c032024-04-03 16:03:12 +0900759
Jeongik Chac181be72024-03-27 00:18:30 +0900760 let input_device_options = if cfg!(paravirtualized_devices) {
761 config
762 .inputDevices
763 .iter()
764 .map(to_input_device_option_from)
765 .collect::<Result<Vec<InputDeviceOption>, _>>()
766 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT)?
767 } else {
768 vec![]
769 };
770
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900771 // Create TAP network interface if the VM supports network.
Seungjae Yoo986d7a42024-05-28 14:06:58 +0900772 let tap = if cfg!(network) && config.networkSupported {
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900773 if *is_protected {
774 return Err(anyhow!("Network feature is not supported for pVM yet"))
775 .with_log()
776 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION)?;
777 }
Seungjae Yoo986d7a42024-05-28 14:06:58 +0900778 Some(File::from(
779 GLOBAL_SERVICE
780 .createTapInterface(&get_this_pid().to_string())?
781 .as_ref()
782 .try_clone()
783 .context("Failed to get TAP interface from ParcelFileDescriptor")
784 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)?,
785 ))
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900786 } else {
787 None
788 };
Mu-Le Leeb2d5a312024-06-05 10:52:47 +0800789
790 let audio_config = if cfg!(paravirtualized_devices) {
791 config.audioConfig.as_ref().map(AudioConfig::new)
792 } else {
793 None
794 };
Seungjae Yoo13af0b62024-05-20 14:15:13 +0900795
Elie Kheirallah29d72912024-08-07 20:17:26 +0000796 let usb_config = config
797 .usbConfig
798 .as_ref()
799 .map(UsbConfig::new)
800 .unwrap_or(Ok(UsbConfig { controller: false }))
801 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)?;
802
Pierre-Clément Tosi3d70d462025-01-07 16:03:24 +0000803 let detect_hangup = is_app_config && gdb_port.is_none();
804
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000805 // Actually start the VM.
806 let crosvm_config = CrosvmConfig {
807 cid,
Seungjae Yoo62085c02022-08-12 04:44:52 +0000808 name: config.name.clone(),
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000809 bootloader: maybe_clone_file(&config.bootloader)?,
Alan Stokes185fe112023-01-10 16:20:55 +0000810 kernel,
811 initrd,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000812 disks,
Akilesh Kailash05515dc2024-10-22 21:42:52 -0700813 shared_paths,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000814 params: config.params.to_owned(),
815 protected: *is_protected,
Jaewan Kim61f86142023-03-28 15:12:52 +0900816 debug_config,
Frederick Mayle68d06e72024-07-12 17:18:11 -0700817 memory_mib: config
818 .memoryMib
819 .try_into()
820 .ok()
821 .and_then(NonZeroU32::new)
822 .unwrap_or(NonZeroU32::new(256).unwrap()),
Frederick Mayle384f5b52024-12-06 16:23:23 -0800823 swiotlb_mib: config.swiotlbMib.try_into().ok().and_then(NonZeroU32::new),
Elie Kheirallahb4b2f242025-01-23 03:38:07 +0000824 cpus: config.cpuOptions.clone(),
Jiyong Parke6fb1672023-06-26 16:45:55 +0900825 console_out_fd,
826 console_in_fd,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000827 log_fd,
Jiyong Parked180932023-02-24 19:55:41 +0900828 ramdump,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000829 indirect_files,
830 platform_version: parse_platform_version_req(&config.platformVersion)?,
Pierre-Clément Tosi3d70d462025-01-07 16:03:24 +0000831 detect_hangup,
Nikita Ioffe5776f082023-02-10 21:38:26 +0000832 gdb_port,
Inseob Kim7307a892023-09-14 13:37:58 +0900833 vfio_devices,
David Brazdil2dfefd12023-11-17 14:07:36 +0000834 dtbo,
Jaewan Kimf43372b2024-12-13 18:33:58 +0900835 device_tree_overlays,
Jeongik Cha1df1c032024-04-03 16:03:12 +0900836 display_config,
Jeongik Chac181be72024-03-27 00:18:30 +0900837 input_device_options,
Vincent Donnefort538a2c62024-03-20 16:01:10 +0000838 hugepages: config.hugePages,
Seungjae Yoo986d7a42024-05-28 14:06:58 +0900839 tap,
Yi-Yo Chiang8dd32552024-05-22 19:38:16 +0800840 console_input_device: config.consoleInputDevice.clone(),
David Dai23cff712024-06-13 19:23:45 +0000841 boost_uclamp: config.boostUclamp,
Jason Macnakea7b0fa2024-05-08 17:02:44 -0700842 gpu_config,
Mu-Le Leeb2d5a312024-06-05 10:52:47 +0800843 audio_config,
Frederick Maylecc4e2d72024-12-06 16:54:40 -0800844 balloon: config.balloon,
Elie Kheirallah29d72912024-08-07 20:17:26 +0000845 usb_config,
Elie Kheirallah5c807a22024-09-23 20:40:42 +0000846 dump_dt_fd,
Frederick Mayle196ca2b2024-12-18 15:27:43 -0800847 enable_hypervisor_specific_auth_method: config.enableHypervisorSpecificAuthMethod,
848 instance_id,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000849 };
850 let instance = Arc::new(
David Brazdil528e0472022-10-10 15:06:02 +0100851 VmInstance::new(
852 crosvm_config,
853 temporary_directory,
854 requester_uid,
855 requester_debug_pid,
856 vm_context,
857 )
Jiyong Park2227eaa2023-08-04 11:59:18 +0900858 .with_context(|| format!("Failed to create VM with config {:?}", config))
859 .with_log()
860 .or_service_specific_exception(-1)?,
Shikha Panwar061aa2c2022-04-05 12:52:56 +0000861 );
862 state.add_vm(Arc::downgrade(&instance));
863 Ok(VirtualMachine::create(instance))
864 }
Jiyong Park8611a6c2021-07-09 18:17:44 +0900865}
866
Alan Stokesfda70842023-12-20 17:50:14 +0000867/// Returns whether a VM config represents a "custom" virtual machine, which requires the
868/// USE_CUSTOM_VIRTUAL_MACHINE.
869fn is_custom_config(config: &VirtualMachineConfig) -> bool {
870 match config {
871 // Any raw (non-Microdroid) VM is considered custom.
872 VirtualMachineConfig::RawConfig(_) => true,
873 VirtualMachineConfig::AppConfig(config) => {
874 // Some features are reserved for platform apps only, even when using
875 // VirtualMachineAppConfig. Almost all of these features are grouped in the
876 // CustomConfig struct:
877 // - controlling CPUs;
878 // - gdbPort is set, meaning that crosvm will start a gdb server;
879 // - using anything other than the default kernel;
880 // - specifying devices to be assigned.
881 if config.customConfig.is_some() {
882 true
883 } else {
884 // Additional custom features not included in CustomConfig:
885 // - specifying a config file;
Alan Stokes736f6822024-02-16 16:08:00 +0000886 // - specifying extra APKs;
887 // - specifying an OS other than Microdroid.
Inseob Kim89b24592024-02-23 18:59:43 +0900888 (match &config.payload {
Alan Stokesfda70842023-12-20 17:50:14 +0000889 Payload::ConfigPath(_) => true,
Inseob Kim89b24592024-02-23 18:59:43 +0900890 Payload::PayloadConfig(payload_config) => !payload_config.extraApks.is_empty(),
891 }) || config.osName != MICRODROID_OS_NAME
Alan Stokesfda70842023-12-20 17:50:14 +0000892 }
893 }
894 }
895}
896
Jiyong Park690c1ca2024-11-28 18:06:50 +0900897/// Returns whether a VM config requires VirtualMachineService running on the host. Only Microdroid
898/// VM (i.e. AppConfig) requires it. However, a few Microdroid tests use RawConfig for Microdroid
899/// VM. To handle the exceptional case, we use name as a second criteria; if the name is
900/// "microdroid" we run VirtualMachineService
901fn requires_vm_service(config: &VirtualMachineConfig) -> bool {
902 match config {
903 VirtualMachineConfig::AppConfig(_) => true,
904 VirtualMachineConfig::RawConfig(config) => config.name == "microdroid",
905 }
906}
907
Seungjae Yoo14e60182024-02-21 13:28:31 +0900908fn extract_vendor_hashtree_digest(config: &VirtualMachineConfig) -> Result<Option<Vec<u8>>> {
909 let VirtualMachineConfig::AppConfig(config) = config else {
910 return Ok(None);
911 };
912 let Some(custom_config) = &config.customConfig else {
913 return Ok(None);
914 };
915 let Some(file) = custom_config.vendorImage.as_ref() else {
916 return Ok(None);
917 };
918
919 let file = clone_file(file)?;
920 let size =
921 file.metadata().context("Failed to get metadata from microdroid vendor image")?.len();
922 let vbmeta = VbMetaImage::verify_reader_region(&file, 0, size)
923 .context("Failed to get vbmeta from microdroid-vendor.img")?;
924
925 for descriptor in vbmeta.descriptors()?.iter() {
926 if let vbmeta::Descriptor::Hashtree(_) = descriptor {
927 let root_digest = hex::encode(descriptor.to_hashtree()?.root_digest());
928 return Ok(Some(root_digest.as_bytes().to_vec()));
929 }
930 }
931 Err(anyhow!("No hashtree digest is extracted from microdroid vendor image"))
932}
933
Jaewan Kimf43372b2024-12-13 18:33:58 +0900934fn maybe_create_reference_dt_overlay(
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000935 config: &VirtualMachineConfig,
Frederick Mayle196ca2b2024-12-18 15:27:43 -0800936 instance_id: &[u8; 64],
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000937 temporary_directory: &Path,
938) -> binder::Result<Option<File>> {
939 // Currently, VirtMgr adds the host copy of reference DT & untrusted properties
940 // (e.g. instance-id)
941 let host_ref_dt = Path::new(VM_REFERENCE_DT_ON_HOST_PATH);
942 let host_ref_dt = if host_ref_dt.exists()
943 && read_dir(host_ref_dt).or_service_specific_exception(-1)?.next().is_some()
944 {
945 Some(host_ref_dt)
946 } else {
947 warn!("VM reference DT doesn't exist in host DT");
948 None
949 };
950
951 let vendor_hashtree_digest = extract_vendor_hashtree_digest(config)
952 .context("Failed to extract vendor hashtree digest")
953 .or_service_specific_exception(-1)?;
954
Matt Gilbrideaade4272024-12-05 13:52:42 +0000955 let mut trusted_props = if let Some(ref vendor_hashtree_digest) = vendor_hashtree_digest {
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000956 info!(
957 "Passing vendor hashtree digest to pvmfw. This will be rejected if it doesn't \
958 match the trusted digest in the pvmfw config, causing the VM to fail to start."
959 );
Alan Stokesf46a17c2025-01-05 15:50:18 +0000960 vec![(c"vendor_hashtree_descriptor_root_digest", vendor_hashtree_digest.as_slice())]
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000961 } else {
Matt Gilbrideaade4272024-12-05 13:52:42 +0000962 vec![]
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000963 };
964
Matt Gilbrideaade4272024-12-05 13:52:42 +0000965 let key_material;
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000966 let mut untrusted_props = Vec::with_capacity(2);
967 if cfg!(llpvm_changes) {
Alan Stokesf46a17c2025-01-05 15:50:18 +0000968 untrusted_props.push((c"instance-id", &instance_id[..]));
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000969 let want_updatable = extract_want_updatable(config);
970 if want_updatable && is_secretkeeper_supported() {
971 // Let guest know that it can defer rollback protection to Secretkeeper by setting
972 // an empty property in untrusted node in DT. This enables Updatable VMs.
Alan Stokesf46a17c2025-01-05 15:50:18 +0000973 untrusted_props.push((c"defer-rollback-protection", &[]));
Matt Gilbrideaade4272024-12-05 13:52:42 +0000974 let sk: Strong<dyn ISecretkeeper> =
975 binder::wait_for_interface(SECRETKEEPER_IDENTIFIER)?;
976 if sk.getInterfaceVersion()? >= 2 {
977 let PublicKey { keyMaterial } = sk.getSecretkeeperIdentity()?;
978 key_material = keyMaterial;
Alan Stokesf46a17c2025-01-05 15:50:18 +0000979 trusted_props.push((c"secretkeeper_public_key", key_material.as_slice()));
Matt Gilbrideaade4272024-12-05 13:52:42 +0000980 }
Nikita Ioffeb2c6f3a2024-06-06 12:51:53 +0000981 }
982 }
983
984 let device_tree_overlay = if host_ref_dt.is_some()
985 || !untrusted_props.is_empty()
986 || !trusted_props.is_empty()
987 {
988 let dt_output = temporary_directory.join(VM_DT_OVERLAY_PATH);
989 let mut data = [0_u8; VM_DT_OVERLAY_MAX_SIZE];
990 let fdt =
991 create_device_tree_overlay(&mut data, host_ref_dt, &untrusted_props, &trusted_props)
992 .map_err(|e| anyhow!("Failed to create DT overlay, {e:?}"))
993 .or_service_specific_exception(-1)?;
994 fs::write(&dt_output, fdt.as_slice()).or_service_specific_exception(-1)?;
995 Some(File::open(dt_output).or_service_specific_exception(-1)?)
996 } else {
997 None
998 };
999 Ok(device_tree_overlay)
1000}
1001
Jaewan Kimf43372b2024-12-13 18:33:58 +09001002fn get_dtbo(config: &VirtualMachineConfig) -> Option<&ParcelFileDescriptor> {
1003 let VirtualMachineConfig::RawConfig(config) = config else {
1004 return None;
1005 };
1006 match &config.devices {
1007 AssignedDevices::Dtbo(dtbo) => dtbo.as_ref(),
1008 _ => None,
1009 }
1010}
1011
Andrew Walbranfbb39d22021-07-28 17:01:25 +00001012fn write_zero_filler(zero_filler_path: &Path) -> Result<()> {
Jooyung Han95884632021-07-06 22:27:54 +09001013 let file = OpenOptions::new()
1014 .create_new(true)
1015 .read(true)
1016 .write(true)
1017 .open(zero_filler_path)
1018 .with_context(|| "Failed to create zero.img")?;
1019 file.set_len(ZERO_FILLER_SIZE)?;
Andrew Walbranfbb39d22021-07-28 17:01:25 +00001020 Ok(())
Jooyung Han95884632021-07-06 22:27:54 +09001021}
1022
David Brazdilf50c7a62023-04-19 14:22:42 +00001023fn format_as_android_vm_instance(part: &mut dyn Write) -> std::io::Result<()> {
1024 part.write_all(ANDROID_VM_INSTANCE_MAGIC.as_bytes())?;
1025 part.write_all(&ANDROID_VM_INSTANCE_VERSION.to_le_bytes())?;
1026 part.flush()
1027}
1028
1029fn format_as_encryptedstore(part: &mut dyn Write) -> std::io::Result<()> {
1030 part.write_all(UNFORMATTED_STORAGE_MAGIC.as_bytes())?;
1031 part.flush()
1032}
1033
1034fn round_up(input: u64, granularity: u64) -> u64 {
1035 if granularity == 0 {
1036 return input;
1037 }
1038 // If the input is absurdly large we round down instead of up; it's going to fail anyway.
1039 let result = input.checked_add(granularity - 1).unwrap_or(input);
1040 (result / granularity) * granularity
1041}
1042
Jeongik Chac181be72024-03-27 00:18:30 +09001043fn to_input_device_option_from(input_device: &InputDevice) -> Result<InputDeviceOption> {
1044 Ok(match input_device {
1045 InputDevice::SingleTouch(single_touch) => InputDeviceOption::SingleTouch {
1046 file: clone_file(single_touch.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?)?,
1047 height: u32::try_from(single_touch.height)?,
1048 width: u32::try_from(single_touch.width)?,
1049 name: if !single_touch.name.is_empty() {
1050 Some(single_touch.name.clone())
1051 } else {
1052 None
1053 },
1054 },
1055 InputDevice::EvDev(evdev) => InputDeviceOption::EvDev(clone_file(
1056 evdev.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
1057 )?),
Jeongik Cha985b6402024-04-15 18:13:00 +09001058 InputDevice::Keyboard(keyboard) => InputDeviceOption::Keyboard(clone_file(
1059 keyboard.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
1060 )?),
Jeongik Cha343894e2024-05-17 20:39:31 +09001061 InputDevice::Mouse(mouse) => InputDeviceOption::Mouse(clone_file(
1062 mouse.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
1063 )?),
Jiyong Park6c1b9f02024-07-05 16:21:10 +09001064 InputDevice::Switches(switches) => InputDeviceOption::Switches(clone_file(
1065 switches.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?,
1066 )?),
Jeongik Cha112a2682024-07-09 12:28:45 +09001067 InputDevice::Trackpad(trackpad) => InputDeviceOption::MultiTouchTrackpad {
1068 file: clone_file(trackpad.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?)?,
1069 height: u32::try_from(trackpad.height)?,
1070 width: u32::try_from(trackpad.width)?,
1071 name: if !trackpad.name.is_empty() { Some(trackpad.name.clone()) } else { None },
1072 },
Jeongik Cha10494912024-07-16 11:19:50 +09001073 InputDevice::MultiTouch(multi_touch) => InputDeviceOption::MultiTouch {
1074 file: clone_file(multi_touch.pfd.as_ref().ok_or(anyhow!("pfd should have value"))?)?,
1075 height: u32::try_from(multi_touch.height)?,
1076 width: u32::try_from(multi_touch.width)?,
1077 name: if !multi_touch.name.is_empty() { Some(multi_touch.name.clone()) } else { None },
1078 },
Jeongik Chac181be72024-03-27 00:18:30 +09001079 })
1080}
Akilesh Kailash05515dc2024-10-22 21:42:52 -07001081
1082fn assemble_shared_paths(
1083 shared_paths: &[SharedPath],
1084 temporary_directory: &Path,
1085) -> Result<Vec<SharedPathConfig>, Status> {
1086 if shared_paths.is_empty() {
1087 return Ok(Vec::new()); // Return an empty vector if shared_paths is empty
1088 }
1089
1090 shared_paths
1091 .iter()
1092 .map(|path| {
1093 Ok(SharedPathConfig {
1094 path: path.sharedPath.clone(),
1095 host_uid: path.hostUid,
1096 host_gid: path.hostGid,
1097 guest_uid: path.guestUid,
1098 guest_gid: path.guestGid,
1099 mask: path.mask,
1100 tag: path.tag.clone(),
Akilesh Kailashc9aa0682024-11-25 10:27:24 -08001101 socket_path: temporary_directory
1102 .join(&path.socketPath)
1103 .to_string_lossy()
1104 .to_string(),
1105 socket_fd: maybe_clone_file(&path.socketFd)?,
1106 app_domain: path.appDomain,
Akilesh Kailash05515dc2024-10-22 21:42:52 -07001107 })
1108 })
1109 .collect()
1110}
1111
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001112/// Given the configuration for a disk image, assembles the `DiskFile` to pass to crosvm.
1113///
1114/// This may involve assembling a composite disk from a set of partition images.
1115fn assemble_disk_image(
1116 disk: &DiskImage,
Jooyung Han95884632021-07-06 22:27:54 +09001117 zero_filler_path: &Path,
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001118 temporary_directory: &Path,
1119 next_temporary_image_id: &mut u64,
1120 indirect_files: &mut Vec<File>,
Andrew Walbran806f1542021-06-10 14:07:12 +00001121) -> Result<DiskFile, Status> {
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001122 let image = if !disk.partitions.is_empty() {
1123 if disk.image.is_some() {
1124 warn!("DiskImage {:?} contains both image and partitions.", disk);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001125 return Err(anyhow!("DiskImage contains both image and partitions"))
1126 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT);
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001127 }
1128
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001129 let composite_image_filenames =
1130 make_composite_image_filenames(temporary_directory, next_temporary_image_id);
1131 let (image, partition_files) = make_composite_image(
1132 &disk.partitions,
Jooyung Han95884632021-07-06 22:27:54 +09001133 zero_filler_path,
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001134 &composite_image_filenames.composite,
1135 &composite_image_filenames.header,
1136 &composite_image_filenames.footer,
1137 )
Jiyong Park2227eaa2023-08-04 11:59:18 +09001138 .with_context(|| format!("Failed to make composite disk image with config {:?}", disk))
1139 .with_log()
1140 .or_service_specific_exception(-1)?;
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001141
1142 // Pass the file descriptors for the various partition files to crosvm when it
1143 // is run.
1144 indirect_files.extend(partition_files);
1145
1146 image
1147 } else if let Some(image) = &disk.image {
1148 clone_file(image)?
1149 } else {
1150 warn!("DiskImage {:?} didn't contain image or partitions.", disk);
Jiyong Park2227eaa2023-08-04 11:59:18 +09001151 return Err(anyhow!("DiskImage didn't contain image or partitions."))
1152 .or_binder_exception(ExceptionCode::ILLEGAL_ARGUMENT);
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001153 };
1154
1155 Ok(DiskFile { image, writable: disk.writable })
1156}
1157
Nikita Ioffeaa6858c2023-07-04 01:37:41 +01001158fn append_kernel_param(param: &str, vm_config: &mut VirtualMachineRawConfig) {
1159 if let Some(ref mut params) = vm_config.params {
1160 params.push(' ');
1161 params.push_str(param)
1162 } else {
1163 vm_config.params = Some(param.to_owned())
1164 }
1165}
1166
Inseob Kim46257382024-01-03 15:41:22 +09001167fn extract_os_name_from_config_path(config: &Path) -> Option<String> {
1168 if config.extension()?.to_str()? != "json" {
1169 return None;
Inseob Kim172f9eb2023-11-06 17:02:08 +09001170 }
Inseob Kim46257382024-01-03 15:41:22 +09001171
1172 Some(config.with_extension("").file_name()?.to_str()?.to_owned())
1173}
1174
1175fn extract_os_names_from_configs(config_glob_pattern: &str) -> Result<HashSet<String>> {
1176 let configs = glob(config_glob_pattern)?.collect::<Result<Vec<_>, _>>()?;
1177 let os_names =
1178 configs.iter().filter_map(|x| extract_os_name_from_config_path(x)).collect::<HashSet<_>>();
1179
1180 Ok(os_names)
1181}
1182
1183fn get_supported_os_names() -> Result<HashSet<String>> {
1184 if !cfg!(vendor_modules) {
1185 return Ok(iter::once(MICRODROID_OS_NAME.to_owned()).collect());
1186 }
1187
1188 extract_os_names_from_configs("/apex/com.android.virt/etc/microdroid*.json")
1189}
1190
1191fn is_valid_os(os_name: &str) -> bool {
1192 SUPPORTED_OS_NAMES.contains(os_name)
Inseob Kim172f9eb2023-11-06 17:02:08 +09001193}
1194
Nikita Ioffe2cb75cf2024-06-04 16:43:56 +00001195fn uses_gki_kernel(config: &VirtualMachineConfig) -> bool {
1196 if !cfg!(vendor_modules) {
1197 return false;
1198 }
1199 match config {
1200 VirtualMachineConfig::RawConfig(_) => false,
1201 VirtualMachineConfig::AppConfig(config) => config.osName.starts_with("microdroid_gki-"),
1202 }
1203}
1204
Jooyung Han21e9b922021-06-26 04:14:16 +09001205fn load_app_config(
1206 config: &VirtualMachineAppConfig,
Jaewan Kim61f86142023-03-28 15:12:52 +09001207 debug_config: &DebugConfig,
Jooyung Han21e9b922021-06-26 04:14:16 +09001208 temporary_directory: &Path,
Jooyung Hanadfb76c2021-06-28 17:29:30 +09001209) -> Result<VirtualMachineRawConfig> {
Andrew Walbrancc0db522021-07-12 17:03:42 +00001210 let apk_file = clone_file(config.apk.as_ref().unwrap())?;
1211 let idsig_file = clone_file(config.idsig.as_ref().unwrap())?;
Jiyong Park8d081812021-07-23 17:45:04 +09001212 let instance_file = clone_file(config.instanceImage.as_ref().unwrap())?;
Jooyung Han21e9b922021-06-26 04:14:16 +09001213
Shikha Panwar22e70452022-10-10 18:32:55 +00001214 let storage_image = if let Some(file) = config.encryptedStorageImage.as_ref() {
1215 Some(clone_file(file)?)
1216 } else {
1217 None
1218 };
1219
Alan Stokesfda70842023-12-20 17:50:14 +00001220 let vm_payload_config;
1221 let extra_apk_files: Vec<_>;
1222 match &config.payload {
Alan Stokes0d1ef782022-09-27 13:46:35 +01001223 Payload::ConfigPath(config_path) => {
Alan Stokesfda70842023-12-20 17:50:14 +00001224 vm_payload_config =
1225 load_vm_payload_config_from_file(&apk_file, config_path.as_str())
1226 .with_context(|| format!("Couldn't read config from {}", config_path))?;
1227 extra_apk_files = vm_payload_config
1228 .extra_apks
1229 .iter()
1230 .enumerate()
1231 .map(|(i, apk)| {
1232 File::open(PathBuf::from(&apk.path))
1233 .with_context(|| format!("Failed to open extra apk #{i} {}", apk.path))
1234 })
1235 .collect::<Result<_>>()?;
Alan Stokes0d1ef782022-09-27 13:46:35 +01001236 }
Alan Stokesfda70842023-12-20 17:50:14 +00001237 Payload::PayloadConfig(payload_config) => {
1238 vm_payload_config = create_vm_payload_config(payload_config)?;
1239 extra_apk_files =
1240 payload_config.extraApks.iter().map(clone_file).collect::<binder::Result<_>>()?;
1241 }
Alan Stokes0d1ef782022-09-27 13:46:35 +01001242 };
Jooyung Han21e9b922021-06-26 04:14:16 +09001243
Inseob Kim89b24592024-02-23 18:59:43 +09001244 let payload_config_os = vm_payload_config.os.name.as_str();
1245 if !payload_config_os.is_empty() && payload_config_os != "microdroid" {
1246 bail!("'os' in payload config is deprecated");
1247 }
1248
Inseob Kim172f9eb2023-11-06 17:02:08 +09001249 // For now, the only supported OS is Microdroid and Microdroid GKI
Inseob Kim89b24592024-02-23 18:59:43 +09001250 let os_name = config.osName.as_str();
Inseob Kim172f9eb2023-11-06 17:02:08 +09001251 if !is_valid_os(os_name) {
Andrew Walbrancc0db522021-07-12 17:03:42 +00001252 bail!("Unknown OS \"{}\"", os_name);
Jooyung Han35edb8f2021-07-01 16:17:16 +09001253 }
Andrew Walbrancc0db522021-07-12 17:03:42 +00001254
1255 // It is safe to construct a filename based on the os_name because we've already checked that it
1256 // is one of the allowed values.
Jooyung Han21e9b922021-06-26 04:14:16 +09001257 let vm_config_path = PathBuf::from(format!("/apex/com.android.virt/etc/{}.json", os_name));
1258 let vm_config_file = File::open(vm_config_path)?;
Andrew Walbrancc0db522021-07-12 17:03:42 +00001259 let mut vm_config = VmConfig::load(&vm_config_file)?.to_parcelable()?;
Jooyung Han21e9b922021-06-26 04:14:16 +09001260
Nikita Ioffea0eb5ee2023-06-26 18:18:21 +01001261 if let Some(custom_config) = &config.customConfig {
1262 if let Some(file) = custom_config.customKernelImage.as_ref() {
1263 vm_config.kernel = Some(ParcelFileDescriptor::new(clone_file(file)?))
1264 }
Nikita Ioffea0eb5ee2023-06-26 18:18:21 +01001265 vm_config.gdbPort = custom_config.gdbPort;
Nikita Ioffe5dfddf22023-06-29 16:11:26 +01001266
1267 if let Some(file) = custom_config.vendorImage.as_ref() {
Nikita Ioffeaa6858c2023-07-04 01:37:41 +01001268 add_microdroid_vendor_image(clone_file(file)?, &mut vm_config);
Pechetty Sravani (xWF)faabfbd2024-09-24 15:27:48 +00001269 append_kernel_param("androidboot.microdroid.mount_vendor=1", &mut vm_config)
Nikita Ioffe5dfddf22023-06-29 16:11:26 +01001270 }
Inseob Kim6ef80972023-07-20 17:23:36 +09001271
Jaewan Kimf43372b2024-12-13 18:33:58 +09001272 vm_config.devices = AssignedDevices::Devices(custom_config.devices.clone());
Seungjae Yoo13af0b62024-05-20 14:15:13 +09001273 vm_config.networkSupported = custom_config.networkSupported;
Nikita Ioffeb4268b32024-09-03 10:23:14 +00001274
1275 for param in custom_config.extraKernelCmdlineParams.iter() {
1276 append_kernel_param(param, &mut vm_config);
1277 }
Nikita Ioffe99548382024-10-21 15:54:46 +00001278
1279 vm_config.teeServices.clone_from(&custom_config.teeServices);
Nikita Ioffe26c35ed2023-06-05 17:49:08 +01001280 }
1281
Andrew Walbrancc045902021-07-27 16:06:17 +00001282 if config.memoryMib > 0 {
1283 vm_config.memoryMib = config.memoryMib;
Andrew Walbran45bcb0c2021-07-14 15:02:06 +00001284 }
1285
Chris Wailes6177c662024-05-09 14:37:44 -07001286 vm_config.name.clone_from(&config.name);
Andrew Walbran3994f002022-01-27 17:33:45 +00001287 vm_config.protectedVm = config.protectedVm;
Elie Kheirallahb4b2f242025-01-23 03:38:07 +00001288 vm_config.cpuOptions = config.cpuOptions.clone();
Vincent Donnefort538a2c62024-03-20 16:01:10 +00001289 vm_config.hugePages = config.hugePages || vm_payload_config.hugepages;
David Dai23cff712024-06-13 19:23:45 +00001290 vm_config.boostUclamp = config.boostUclamp;
Jiyong Park032615f2022-01-10 13:55:34 +09001291
Shikha Panwar22e70452022-10-10 18:32:55 +00001292 // Microdroid takes additional init ramdisk & (optionally) storage image
Inseob Kim172f9eb2023-11-06 17:02:08 +09001293 add_microdroid_system_images(config, instance_file, storage_image, os_name, &mut vm_config)?;
Shikha Panwar22e70452022-10-10 18:32:55 +00001294
1295 // Include Microdroid payload disk (contains apks, idsigs) in vm config
1296 add_microdroid_payload_images(
Alan Stokes0d1ef782022-09-27 13:46:35 +01001297 config,
Jaewan Kim61f86142023-03-28 15:12:52 +09001298 debug_config,
Alan Stokes0d1ef782022-09-27 13:46:35 +01001299 temporary_directory,
1300 apk_file,
1301 idsig_file,
Alan Stokesfda70842023-12-20 17:50:14 +00001302 extra_apk_files,
Alan Stokes0d1ef782022-09-27 13:46:35 +01001303 &vm_payload_config,
1304 &mut vm_config,
1305 )?;
Jooyung Han21e9b922021-06-26 04:14:16 +09001306
Andrew Walbrancc0db522021-07-12 17:03:42 +00001307 Ok(vm_config)
Jooyung Han21e9b922021-06-26 04:14:16 +09001308}
1309
Inseob Kime3e932d2024-12-16 20:06:57 +09001310fn check_partition_for_file(fd: &ParcelFileDescriptor, calling_partition: &str) -> Result<()> {
Inseob Kimff48a7c2024-02-26 22:07:21 +09001311 let path = format!("/proc/self/fd/{}", fd.as_raw_fd());
1312 let link = fs::read_link(&path).context(format!("can't read_link {path}"))?;
1313
1314 // microdroid vendor image is OK
1315 if cfg!(vendor_modules) && link == Path::new("/vendor/etc/avf/microdroid/microdroid_vendor.img")
1316 {
1317 return Ok(());
1318 }
1319
Inseob Kime3e932d2024-12-16 20:06:57 +09001320 let is_fd_vendor = link.starts_with("/vendor") || link.starts_with("/odm");
1321 let is_caller_vendor = calling_partition == "vendor" || calling_partition == "odm";
1322
1323 if is_fd_vendor != is_caller_vendor {
1324 bail!("{} can't be used for VM client in {calling_partition}", link.display());
Inseob Kimff48a7c2024-02-26 22:07:21 +09001325 }
1326
1327 Ok(())
1328}
1329
Inseob Kime3e932d2024-12-16 20:06:57 +09001330fn check_partitions_for_files(
1331 config: &VirtualMachineRawConfig,
1332 calling_partition: &str,
1333) -> Result<()> {
Inseob Kimff48a7c2024-02-26 22:07:21 +09001334 config
1335 .disks
1336 .iter()
1337 .flat_map(|disk| disk.partitions.iter())
1338 .filter_map(|partition| partition.image.as_ref())
Inseob Kime3e932d2024-12-16 20:06:57 +09001339 .try_for_each(|fd| check_partition_for_file(fd, calling_partition))?;
Inseob Kimff48a7c2024-02-26 22:07:21 +09001340
Inseob Kime3e932d2024-12-16 20:06:57 +09001341 config
1342 .disks
1343 .iter()
1344 .filter_map(|disk| disk.image.as_ref())
1345 .try_for_each(|fd| check_partition_for_file(fd, calling_partition))?;
1346
1347 config.kernel.as_ref().map_or(Ok(()), |fd| check_partition_for_file(fd, calling_partition))?;
1348 config.initrd.as_ref().map_or(Ok(()), |fd| check_partition_for_file(fd, calling_partition))?;
1349 config
1350 .bootloader
1351 .as_ref()
1352 .map_or(Ok(()), |fd| check_partition_for_file(fd, calling_partition))?;
Inseob Kimff48a7c2024-02-26 22:07:21 +09001353
1354 Ok(())
1355}
1356
Alan Stokes0d1ef782022-09-27 13:46:35 +01001357fn load_vm_payload_config_from_file(apk_file: &File, config_path: &str) -> Result<VmPayloadConfig> {
1358 let mut apk_zip = ZipArchive::new(apk_file)?;
1359 let config_file = apk_zip.by_name(config_path)?;
1360 Ok(serde_json::from_reader(config_file)?)
1361}
1362
Alan Stokes8f12f2b2023-01-09 09:19:20 +00001363fn create_vm_payload_config(
1364 payload_config: &VirtualMachinePayloadConfig,
1365) -> Result<VmPayloadConfig> {
Alan Stokes0d1ef782022-09-27 13:46:35 +01001366 // There isn't an actual config file. Construct a synthetic VmPayloadConfig from the explicit
1367 // parameters we've been given. Microdroid will do something equivalent inside the VM using the
1368 // payload config that we send it via the metadata file.
Alan Stokes8f12f2b2023-01-09 09:19:20 +00001369
1370 let payload_binary_name = &payload_config.payloadBinaryName;
1371 if payload_binary_name.contains('/') {
1372 bail!("Payload binary name must not specify a path: {payload_binary_name}");
1373 }
1374
1375 let task = Task { type_: TaskType::MicrodroidLauncher, command: payload_binary_name.clone() };
Alan Stokesfda70842023-12-20 17:50:14 +00001376
1377 // The VM only cares about how many there are, these names are actually ignored.
1378 let extra_apk_count = payload_config.extraApks.len();
1379 let extra_apks =
1380 (0..extra_apk_count).map(|i| ApkConfig { path: format!("extra-apk-{i}") }).collect();
1381
Nikita Ioffe901083f2025-01-20 01:54:28 +00001382 if check_use_relaxed_microdroid_rollback_protection().is_ok() {
1383 // The only payload delivered via Mainline module in this release requires
1384 // com.android.i18n apex. However, we are past all the reasonable deadlines to add new
1385 // APIs, so we use the fact that the payload is granted
1386 // USE_RELAXED_MICRODROID_ROLLBACK_PROTECTION permission as a signal that we should include
1387 // com.android.i18n APEX.
1388 // TODO: remove this after we provide a stable @SystemApi to load additional APEXes to
1389 // Microdroid pVMs.
1390 let apexes = vec![ApexConfig { name: String::from("com.android.i18n") }];
1391 Ok(VmPayloadConfig { task: Some(task), apexes, extra_apks, ..Default::default() })
1392 } else {
1393 Ok(VmPayloadConfig { task: Some(task), extra_apks, ..Default::default() })
1394 }
Alan Stokes0d1ef782022-09-27 13:46:35 +01001395}
1396
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001397/// Generates a unique filename to use for a composite disk image.
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001398fn make_composite_image_filenames(
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001399 temporary_directory: &Path,
1400 next_temporary_image_id: &mut u64,
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001401) -> CompositeImageFilenames {
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001402 let id = *next_temporary_image_id;
1403 *next_temporary_image_id += 1;
Andrew Walbran3eca16c2021-06-14 11:15:14 +00001404 CompositeImageFilenames {
1405 composite: temporary_directory.join(format!("composite-{}.img", id)),
1406 header: temporary_directory.join(format!("composite-{}-header.img", id)),
1407 footer: temporary_directory.join(format!("composite-{}-footer.img", id)),
1408 }
1409}
1410
1411/// Filenames for a composite disk image, including header and footer partitions.
1412#[derive(Clone, Debug, Eq, PartialEq)]
1413struct CompositeImageFilenames {
1414 /// The composite disk image itself.
1415 composite: PathBuf,
1416 /// The header partition image.
1417 header: PathBuf,
1418 /// The footer partition image.
1419 footer: PathBuf,
Andrew Walbranf5fbb7d2021-05-12 17:15:48 +00001420}
1421
Jiyong Park753553b2021-07-12 21:21:09 +09001422/// Checks whether the caller has a specific permission
1423fn check_permission(perm: &str) -> binder::Result<()> {
Inseob Kimecde8c02024-09-03 13:11:08 +09001424 if cfg!(early) {
1425 // Skip permission check for early VMs, in favor of SELinux
1426 return Ok(());
1427 }
David Brazdil1f530702022-10-03 12:18:10 +01001428 let calling_pid = get_calling_pid();
1429 let calling_uid = get_calling_uid();
Jiyong Park753553b2021-07-12 21:21:09 +09001430 // Root can do anything
1431 if calling_uid == 0 {
1432 return Ok(());
1433 }
1434 let perm_svc: Strong<dyn IPermissionController::IPermissionController> =
Frederick Mayleb2a02872024-05-08 13:35:12 -07001435 binder::wait_for_interface("permission")?;
Jiyong Park753553b2021-07-12 21:21:09 +09001436 if perm_svc.checkPermission(perm, calling_pid, calling_uid as i32)? {
Andrew Walbran806f1542021-06-10 14:07:12 +00001437 Ok(())
1438 } else {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001439 Err(anyhow!("does not have the {} permission", perm))
1440 .or_binder_exception(ExceptionCode::SECURITY)
Andrew Walbran806f1542021-06-10 14:07:12 +00001441 }
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001442}
1443
Jiyong Park753553b2021-07-12 21:21:09 +09001444/// Check whether the caller of the current Binder method is allowed to manage VMs
1445fn check_manage_access() -> binder::Result<()> {
1446 check_permission("android.permission.MANAGE_VIRTUAL_MACHINE")
1447}
1448
Inseob Kim1119d702022-05-02 18:01:58 +09001449/// Check whether the caller of the current Binder method is allowed to create custom VMs
1450fn check_use_custom_virtual_machine() -> binder::Result<()> {
1451 check_permission("android.permission.USE_CUSTOM_VIRTUAL_MACHINE")
1452}
1453
Nikita Ioffe901083f2025-01-20 01:54:28 +00001454/// Check whether the caller of the current binder method is allowed to use relaxed microdroid
1455/// rollback protection schema.
1456fn check_use_relaxed_microdroid_rollback_protection() -> binder::Result<()> {
1457 check_permission("android.permission.USE_RELAXED_MICRODROID_ROLLBACK_PROTECTION")
1458}
1459
Alan Stokes185fe112023-01-10 16:20:55 +00001460/// Return whether a partition is exempt from selinux label checks, because we know that it does
1461/// not contain code and is likely to be generated in an app-writable directory.
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001462fn is_safe_app_partition(label: &str) -> bool {
Shikha Panwara2ff8c52022-11-30 19:25:46 +00001463 // See add_microdroid_system_images & add_microdroid_payload_images in payload.rs.
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001464 label == "vm-instance"
Shikha Panwara2ff8c52022-11-30 19:25:46 +00001465 || label == "encryptedstore"
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001466 || label == "microdroid-apk-idsig"
1467 || label == "payload-metadata"
1468 || label.starts_with("extra-idsig-")
1469}
1470
Alice Wangc206b9b2023-08-28 14:13:51 +00001471/// Returns whether a partition with the given label is safe for a raw config VM.
1472fn is_safe_raw_partition(label: &str) -> bool {
1473 label == "vm-instance"
1474}
1475
Alan Stokes185fe112023-01-10 16:20:55 +00001476/// Check that a file SELinux label is acceptable.
1477///
1478/// 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 +09001479/// system or vendor, do not have write access to.
Alan Stokes185fe112023-01-10 16:20:55 +00001480///
1481/// Note that sepolicy must also grant read access for these types to both virtualization
1482/// service and crosvm.
1483///
1484/// App private data files are deliberately excluded, to avoid arbitrary payloads being run on
1485/// user devices (W^X).
1486fn check_label_is_allowed(context: &SeContext) -> Result<()> {
1487 match context.selinux_type()? {
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001488 | "apk_data_file" // APKs of an installed app
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001489 | "shell_data_file" // test files created via adb shell
Alan Stokesfe4bb0c2023-03-20 14:15:36 +00001490 | "staging_data_file" // updated/staged APEX images
1491 | "system_file" // immutable dm-verity protected partition
1492 | "virtualizationservice_data_file" // files created by VS / VirtMgr
Seungjae Yoo2b74c442023-11-15 18:05:07 +09001493 | "vendor_microdroid_file" // immutable dm-verity protected partition (/vendor/etc/avf/microdroid/.*)
Alan Stokes53cc5ca2022-08-30 14:28:19 +01001494 => Ok(()),
Alan Stokes185fe112023-01-10 16:20:55 +00001495 _ => bail!("Label {} is not allowed", context),
Jiyong Park029977d2021-11-24 21:56:49 +09001496 }
1497}
1498
Alan Stokes185fe112023-01-10 16:20:55 +00001499fn check_label_for_partition(partition: &Partition) -> Result<()> {
1500 let file = partition.image.as_ref().unwrap().as_ref();
1501 check_label_is_allowed(&getfilecon(file)?)
1502 .with_context(|| format!("Partition {} invalid", &partition.label))
1503}
1504
1505fn check_label_for_kernel_files(kernel: &Option<File>, initrd: &Option<File>) -> Result<()> {
1506 if let Some(f) = kernel {
1507 check_label_for_file(f, "kernel")?;
1508 }
1509 if let Some(f) = initrd {
1510 check_label_for_file(f, "initrd")?;
1511 }
1512 Ok(())
1513}
1514fn check_label_for_file(file: &File, name: &str) -> Result<()> {
1515 check_label_is_allowed(&getfilecon(file)?).with_context(|| format!("{} file invalid", name))
1516}
1517
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001518/// Implementation of the AIDL `IVirtualMachine` interface. Used as a handle to a VM.
1519#[derive(Debug)]
1520struct VirtualMachine {
1521 instance: Arc<VmInstance>,
1522}
1523
1524impl VirtualMachine {
Devin Moore407df8f2024-08-27 19:39:16 +00001525 fn create(instance: Arc<VmInstance>) -> Strong<dyn IVirtualMachine::IVirtualMachine> {
David Brazdil4b4c5102022-12-19 22:56:20 +00001526 BnVirtualMachine::new_binder(VirtualMachine { instance }, BinderFeatures::default())
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001527 }
1528}
1529
1530impl Interface for VirtualMachine {}
1531
Devin Moore407df8f2024-08-27 19:39:16 +00001532impl IVirtualMachine::IVirtualMachine for VirtualMachine {
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001533 fn getCid(&self) -> binder::Result<i32> {
Jiyong Park753553b2021-07-12 21:21:09 +09001534 // Don't check permission. The owner of the VM might have passed this binder object to
1535 // others.
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001536 Ok(self.instance.cid as i32)
1537 }
Andrew Walbrandae07162021-03-12 17:05:20 +00001538
Andrew Walbran6b650662021-09-07 13:13:23 +00001539 fn getState(&self) -> binder::Result<VirtualMachineState> {
Jiyong Park753553b2021-07-12 21:21:09 +09001540 // Don't check permission. The owner of the VM might have passed this binder object to
1541 // others.
Andrew Walbran6b650662021-09-07 13:13:23 +00001542 Ok(get_state(&self.instance))
Andrew Walbrandae07162021-03-12 17:05:20 +00001543 }
1544
1545 fn registerCallback(
1546 &self,
1547 callback: &Strong<dyn IVirtualMachineCallback>,
1548 ) -> binder::Result<()> {
Jiyong Park753553b2021-07-12 21:21:09 +09001549 // Don't check permission. The owner of the VM might have passed this binder object to
1550 // others.
Jaewan Kim27ac1832025-02-03 23:42:08 +09001551
1552 // Only register callback if it may be notified.
1553 // This also ensures no cyclic reference between callback and VmInstance after VM is died.
1554 let vm_state = self.instance.vm_state.lock().unwrap();
1555 if matches!(*vm_state, VmState::Dead) {
1556 warn!("Ignoring registerCallback() after VM is died");
1557 } else {
1558 self.instance.callbacks.add(callback.clone());
1559 }
1560 drop(vm_state);
1561
Andrew Walbrandae07162021-03-12 17:05:20 +00001562 Ok(())
1563 }
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001564
Andrew Walbranf8d94112021-09-07 11:45:36 +00001565 fn start(&self) -> binder::Result<()> {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001566 self.instance
1567 .start()
1568 .with_context(|| format!("Error starting VM with CID {}", self.instance.cid))
1569 .with_log()
1570 .or_service_specific_exception(-1)
Andrew Walbranf8d94112021-09-07 11:45:36 +00001571 }
1572
Inseob Kima446f802022-07-11 19:46:37 +09001573 fn stop(&self) -> binder::Result<()> {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001574 self.instance
1575 .kill()
1576 .with_context(|| format!("Error stopping VM with CID {}", self.instance.cid))
1577 .with_log()
1578 .or_service_specific_exception(-1)
Inseob Kima446f802022-07-11 19:46:37 +09001579 }
1580
Keir Fraser48221ba2024-07-12 14:05:02 +00001581 fn getMemoryBalloon(&self) -> binder::Result<i64> {
1582 let balloon = self
1583 .instance
1584 .get_memory_balloon()
1585 .with_context(|| format!("Error getting balloon for VM with CID {}", self.instance.cid))
1586 .with_log()
1587 .or_service_specific_exception(-1)?;
1588 Ok(balloon.try_into().unwrap())
1589 }
1590
1591 fn setMemoryBalloon(&self, num_bytes: i64) -> binder::Result<()> {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001592 self.instance
Keir Fraser48221ba2024-07-12 14:05:02 +00001593 .set_memory_balloon(num_bytes.try_into().unwrap())
1594 .with_context(|| format!("Error setting balloon for VM with CID {}", self.instance.cid))
Jiyong Park2227eaa2023-08-04 11:59:18 +09001595 .with_log()
1596 .or_service_specific_exception(-1)
Keir Frasercdd4b112022-11-24 14:02:25 +00001597 }
1598
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001599 fn connectVsock(&self, port: i32) -> binder::Result<ParcelFileDescriptor> {
Andrew Walbranf8d94112021-09-07 11:45:36 +00001600 if !matches!(&*self.instance.vm_state.lock().unwrap(), VmState::Running { .. }) {
Devin Moore407df8f2024-08-27 19:39:16 +00001601 return Err(Status::new_service_specific_error_str(
1602 IVirtualMachine::ERROR_UNEXPECTED,
1603 Some("Virtual Machine is not running"),
1604 ));
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001605 }
Alan Stokes10c47672022-12-13 17:17:08 +00001606 let port = port as u32;
Devin Moore407df8f2024-08-27 19:39:16 +00001607 if port < VSOCK_PRIV_PORT_MAX {
1608 return Err(Status::new_service_specific_error_str(
1609 IVirtualMachine::ERROR_UNEXPECTED,
1610 Some("Can't connect to privileged port {port}"),
1611 ));
Alan Stokes10c47672022-12-13 17:17:08 +00001612 }
Jiyong Park2227eaa2023-08-04 11:59:18 +09001613 let stream = VsockStream::connect_with_cid_port(self.instance.cid, port)
1614 .context("Failed to connect")
Devin Moore407df8f2024-08-27 19:39:16 +00001615 .or_service_specific_exception(IVirtualMachine::ERROR_UNEXPECTED)?;
Jiyong Parkaf63d1c2024-09-04 16:15:42 +09001616 Ok(vsock_stream_to_pfd(stream))
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001617 }
Yi-Yo Chiang2fbf0da2024-06-14 22:56:56 +08001618
Devin Moore407df8f2024-08-27 19:39:16 +00001619 fn createAccessorBinder(&self, name: &str, port: i32) -> binder::Result<SpIBinder> {
1620 if !matches!(&*self.instance.vm_state.lock().unwrap(), VmState::Running { .. }) {
1621 return Err(Status::new_service_specific_error_str(
1622 IVirtualMachine::ERROR_UNEXPECTED,
1623 Some("Virtual Machine is not running"),
1624 ));
1625 }
1626 let port = port as u32;
1627 if port < VSOCK_PRIV_PORT_MAX {
1628 return Err(Status::new_service_specific_error_str(
1629 IVirtualMachine::ERROR_UNEXPECTED,
1630 Some("Can't connect to privileged port {port}"),
1631 ));
1632 }
1633 let cid = self.instance.cid;
Devin Moorec8800a12024-10-17 17:56:18 +00001634 let addr = sockaddr_vm {
1635 svm_family: AF_VSOCK as sa_family_t,
1636 svm_reserved1: 0,
1637 svm_port: port,
1638 svm_cid: cid,
1639 svm_zero: [0u8; 4],
1640 };
1641 let get_connection_info = move |_instance: &str| Some(ConnectionInfo::Vsock(addr));
Devin Moore407df8f2024-08-27 19:39:16 +00001642 let accessor = Accessor::new(name, get_connection_info);
1643 accessor
1644 .as_binder()
1645 .context("The newly created Accessor should always have a binder")
1646 .or_service_specific_exception(IVirtualMachine::ERROR_UNEXPECTED)
1647 }
1648
Yi-Yo Chiang2fbf0da2024-06-14 22:56:56 +08001649 fn setHostConsoleName(&self, ptsname: &str) -> binder::Result<()> {
1650 self.instance.vm_context.global_context.setHostConsoleName(ptsname)
1651 }
Jiyong Park23b67392024-07-04 13:51:42 +09001652
1653 fn suspend(&self) -> binder::Result<()> {
1654 self.instance
1655 .suspend()
1656 .with_context(|| format!("Error suspending VM with CID {}", self.instance.cid))
1657 .with_log()
1658 .or_service_specific_exception(-1)
1659 }
1660
1661 fn resume(&self) -> binder::Result<()> {
1662 self.instance
1663 .resume()
1664 .with_context(|| format!("Error resuming VM with CID {}", self.instance.cid))
1665 .with_log()
1666 .or_service_specific_exception(-1)
1667 }
Andrew Walbrandae07162021-03-12 17:05:20 +00001668}
1669
1670impl Drop for VirtualMachine {
1671 fn drop(&mut self) {
1672 debug!("Dropping {:?}", self);
Inseob Kima446f802022-07-11 19:46:37 +09001673 if let Err(e) = self.instance.kill() {
1674 debug!("Error stopping dropped VM with CID {}: {:?}", self.instance.cid, e);
1675 }
Andrew Walbrandae07162021-03-12 17:05:20 +00001676 }
1677}
1678
1679/// A set of Binders to be called back in response to various events on the VM, such as when it
1680/// dies.
1681#[derive(Debug, Default)]
1682pub struct VirtualMachineCallbacks(Mutex<Vec<Strong<dyn IVirtualMachineCallback>>>);
1683
1684impl VirtualMachineCallbacks {
Jiyong Park8611a6c2021-07-09 18:17:44 +09001685 /// Call all registered callbacks to notify that the payload has started.
David Brazdil451cc962022-10-14 14:08:12 +01001686 pub fn notify_payload_started(&self, cid: Cid) {
Jiyong Park8611a6c2021-07-09 18:17:44 +09001687 let callbacks = &*self.0.lock().unwrap();
Jiyong Park8611a6c2021-07-09 18:17:44 +09001688 for callback in callbacks {
David Brazdil451cc962022-10-14 14:08:12 +01001689 if let Err(e) = callback.onPayloadStarted(cid as i32) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001690 error!("Error notifying payload start event from VM CID {}: {:?}", cid, e);
Jiyong Park8611a6c2021-07-09 18:17:44 +09001691 }
1692 }
1693 }
1694
Inseob Kim14cb8692021-08-31 21:50:39 +09001695 /// Call all registered callbacks to notify that the payload is ready to serve.
1696 pub fn notify_payload_ready(&self, cid: Cid) {
1697 let callbacks = &*self.0.lock().unwrap();
1698 for callback in callbacks {
1699 if let Err(e) = callback.onPayloadReady(cid as i32) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001700 error!("Error notifying payload ready event from VM CID {}: {:?}", cid, e);
Inseob Kim14cb8692021-08-31 21:50:39 +09001701 }
1702 }
1703 }
1704
Inseob Kim2444af92021-08-31 01:22:50 +09001705 /// Call all registered callbacks to notify that the payload has finished.
1706 pub fn notify_payload_finished(&self, cid: Cid, exit_code: i32) {
1707 let callbacks = &*self.0.lock().unwrap();
1708 for callback in callbacks {
1709 if let Err(e) = callback.onPayloadFinished(cid as i32, exit_code) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001710 error!("Error notifying payload finish event from VM CID {}: {:?}", cid, e);
Inseob Kim2444af92021-08-31 01:22:50 +09001711 }
1712 }
1713 }
1714
Jooyung Handd0a1732021-11-23 15:26:20 +09001715 /// Call all registered callbacks to say that the VM encountered an error.
Alan Stokes2bead0d2022-09-05 16:58:34 +01001716 pub fn notify_error(&self, cid: Cid, error_code: ErrorCode, message: &str) {
Jooyung Handd0a1732021-11-23 15:26:20 +09001717 let callbacks = &*self.0.lock().unwrap();
1718 for callback in callbacks {
1719 if let Err(e) = callback.onError(cid as i32, error_code, message) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001720 error!("Error notifying error event from VM CID {}: {:?}", cid, e);
Jooyung Handd0a1732021-11-23 15:26:20 +09001721 }
1722 }
1723 }
1724
Andrew Walbrandae07162021-03-12 17:05:20 +00001725 /// Call all registered callbacks to say that the VM has died.
Andrew Walbranc92d35f2022-01-12 12:45:19 +00001726 pub fn callback_on_died(&self, cid: Cid, reason: DeathReason) {
Jaewan Kim27ac1832025-02-03 23:42:08 +09001727 let mut callbacks = self.0.lock().unwrap();
1728 for callback in &*callbacks {
Andrew Walbranc92d35f2022-01-12 12:45:19 +00001729 if let Err(e) = callback.onDied(cid as i32, reason) {
Alan Stokes70ccf162022-07-08 11:05:03 +01001730 error!("Error notifying exit of VM CID {}: {:?}", cid, e);
Andrew Walbrandae07162021-03-12 17:05:20 +00001731 }
1732 }
Jaewan Kim27ac1832025-02-03 23:42:08 +09001733
1734 // Nothing to notify afterward because VM cannot be restarted.
1735 // Explicitly clear callbacks to prevent potential cyclic references
1736 // between callback and VmInstance.
1737 (*callbacks).clear();
Andrew Walbrandae07162021-03-12 17:05:20 +00001738 }
1739
1740 /// Add a new callback to the set.
1741 fn add(&self, callback: Strong<dyn IVirtualMachineCallback>) {
1742 self.0.lock().unwrap().push(callback);
1743 }
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001744}
1745
Andrew Walbranf6bf6862021-05-21 12:41:13 +00001746/// The mutable state of the VirtualizationService. There should only be one instance of this
1747/// struct.
Chris Wailes641fc4a2021-12-01 15:03:21 -08001748#[derive(Debug, Default)]
Andrew Walbrand6dce6f2021-03-05 16:39:08 +00001749struct State {
Alan Stokes3e5eec12023-09-07 12:10:00 +01001750 /// The VMs which have been started. When VMs are started a weak reference is added to this
1751 /// list while a strong reference is returned to the caller over Binder. Once all copies of
1752 /// the Binder client are dropped the weak reference here will become invalid, and will be
1753 /// removed from the list opportunistically the next time `add_vm` is called.
Andrew Walbran320b5602021-03-04 16:11:12 +00001754 vms: Vec<Weak<VmInstance>>,
1755}
1756
1757impl State {
Andrew Walbrandae07162021-03-12 17:05:20 +00001758 /// Get a list of VMs which still have Binder references to them.
Andrew Walbran320b5602021-03-04 16:11:12 +00001759 fn vms(&self) -> Vec<Arc<VmInstance>> {
1760 // Attempt to upgrade the weak pointers to strong pointers.
1761 self.vms.iter().filter_map(Weak::upgrade).collect()
1762 }
1763
1764 /// Add a new VM to the list.
1765 fn add_vm(&mut self, vm: Weak<VmInstance>) {
1766 // Garbage collect any entries from the stored list which no longer exist.
1767 self.vms.retain(|vm| vm.strong_count() > 0);
1768
1769 // Actually add the new VM.
1770 self.vms.push(vm);
1771 }
David Brazdil3c2ddef2021-03-18 13:09:57 +00001772
Jiyong Park8611a6c2021-07-09 18:17:44 +09001773 /// Get a VM that corresponds to the given cid
1774 fn get_vm(&self, cid: Cid) -> Option<Arc<VmInstance>> {
1775 self.vms().into_iter().find(|vm| vm.cid == cid)
1776 }
Jiyong Parkd50a0242021-09-16 21:00:14 +09001777}
1778
Andrew Walbran6b650662021-09-07 13:13:23 +00001779/// Gets the `VirtualMachineState` of the given `VmInstance`.
1780fn get_state(instance: &VmInstance) -> VirtualMachineState {
Andrew Walbranf8d94112021-09-07 11:45:36 +00001781 match &*instance.vm_state.lock().unwrap() {
1782 VmState::NotStarted { .. } => VirtualMachineState::NOT_STARTED,
1783 VmState::Running { .. } => match instance.payload_state() {
Andrew Walbran6b650662021-09-07 13:13:23 +00001784 PayloadState::Starting => VirtualMachineState::STARTING,
1785 PayloadState::Started => VirtualMachineState::STARTED,
1786 PayloadState::Ready => VirtualMachineState::READY,
1787 PayloadState::Finished => VirtualMachineState::FINISHED,
Jiyong Parka4eebde2022-07-12 18:01:12 +09001788 PayloadState::Hangup => VirtualMachineState::DEAD,
Andrew Walbranf8d94112021-09-07 11:45:36 +00001789 },
1790 VmState::Dead => VirtualMachineState::DEAD,
1791 VmState::Failed => VirtualMachineState::DEAD,
Andrew Walbran6b650662021-09-07 13:13:23 +00001792 }
1793}
1794
David Brazdilf50c7a62023-04-19 14:22:42 +00001795/// Converts a `&ParcelFileDescriptor` to a `File` by cloning the file.
Jiyong Park2227eaa2023-08-04 11:59:18 +09001796pub fn clone_file(file: &ParcelFileDescriptor) -> binder::Result<File> {
1797 file.as_ref()
1798 .try_clone()
1799 .context("Failed to clone File from ParcelFileDescriptor")
1800 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)
Andrei Homescu11333c62023-11-09 04:26:39 +00001801 .map(File::from)
David Brazdilf50c7a62023-04-19 14:22:42 +00001802}
1803
Andrew Walbrand3a84182021-09-07 14:48:52 +00001804/// Converts an `&Option<ParcelFileDescriptor>` to an `Option<File>` by cloning the file.
Jiyong Park2227eaa2023-08-04 11:59:18 +09001805fn maybe_clone_file(file: &Option<ParcelFileDescriptor>) -> binder::Result<Option<File>> {
Andrew Walbrand3a84182021-09-07 14:48:52 +00001806 file.as_ref().map(clone_file).transpose()
1807}
1808
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001809/// Converts a `VsockStream` to a `ParcelFileDescriptor`.
Jiyong Parkaf63d1c2024-09-04 16:15:42 +09001810fn vsock_stream_to_pfd(stream: VsockStream) -> ParcelFileDescriptor {
1811 // SAFETY: ownership is transferred from stream to f
1812 let f = unsafe { File::from_raw_fd(stream.into_raw_fd()) };
1813 ParcelFileDescriptor::new(f)
Andrew Walbrancbe8b082021-08-06 15:42:11 +00001814}
1815
Jiyong Parkdcf17412022-02-08 15:07:23 +09001816/// Parses the platform version requirement string.
Jiyong Park2227eaa2023-08-04 11:59:18 +09001817fn parse_platform_version_req(s: &str) -> binder::Result<VersionReq> {
1818 VersionReq::parse(s)
1819 .with_context(|| format!("Invalid platform version requirement {}", s))
1820 .or_binder_exception(ExceptionCode::BAD_PARCELABLE)
Jiyong Parkdcf17412022-02-08 15:07:23 +09001821}
1822
Jiyong Parked180932023-02-24 19:55:41 +09001823/// Create the empty ramdump file
1824fn prepare_ramdump_file(temporary_directory: &Path) -> binder::Result<File> {
1825 // `ramdump_write` is sent to crosvm and will be the backing store for the /dev/hvc1 where
1826 // VM will emit ramdump to. `ramdump_read` will be sent back to the client (i.e. the VM
1827 // owner) for readout.
1828 let ramdump_path = temporary_directory.join("ramdump");
Jiyong Park2227eaa2023-08-04 11:59:18 +09001829 let ramdump = File::create(ramdump_path)
1830 .context("Failed to prepare ramdump file")
1831 .with_log()
1832 .or_service_specific_exception(-1)?;
Jiyong Parked180932023-02-24 19:55:41 +09001833 Ok(ramdump)
1834}
1835
Pierre-Clément Tosi9515d0f2024-04-15 15:58:07 +01001836/// Create the empty device tree dump file
1837fn prepare_dump_dt_file(temporary_directory: &Path) -> binder::Result<File> {
1838 let path = temporary_directory.join("device_tree.dtb");
1839 let file = File::create(path)
1840 .context("Failed to prepare device tree dump file")
1841 .with_log()
1842 .or_service_specific_exception(-1)?;
1843 Ok(file)
1844}
1845
Nikita Ioffe5776f082023-02-10 21:38:26 +00001846fn is_protected(config: &VirtualMachineConfig) -> bool {
1847 match config {
1848 VirtualMachineConfig::RawConfig(config) => config.protectedVm,
1849 VirtualMachineConfig::AppConfig(config) => config.protectedVm,
1850 }
1851}
1852
1853fn check_gdb_allowed(config: &VirtualMachineConfig) -> binder::Result<()> {
1854 if is_protected(config) {
Jiyong Park2227eaa2023-08-04 11:59:18 +09001855 return Err(anyhow!("Can't use gdb with protected VMs"))
1856 .or_binder_exception(ExceptionCode::SECURITY);
Nikita Ioffe5776f082023-02-10 21:38:26 +00001857 }
1858
Pierre-Clément Tosid3bbe1d2024-04-15 18:03:51 +01001859 if get_debug_level(config) == Some(DebugLevel::NONE) {
1860 return Err(anyhow!("Can't use gdb with non-debuggable VMs"))
1861 .or_binder_exception(ExceptionCode::SECURITY);
Nikita Ioffe5776f082023-02-10 21:38:26 +00001862 }
Pierre-Clément Tosid3bbe1d2024-04-15 18:03:51 +01001863
1864 Ok(())
Nikita Ioffe5776f082023-02-10 21:38:26 +00001865}
1866
Shikha Panwar61a74b52024-02-16 13:17:01 +00001867fn extract_instance_id(config: &VirtualMachineConfig) -> [u8; 64] {
1868 match config {
1869 VirtualMachineConfig::RawConfig(config) => config.instanceId,
1870 VirtualMachineConfig::AppConfig(config) => config.instanceId,
1871 }
1872}
1873
Alan Stokesc96b35e2024-05-03 13:21:20 +01001874fn extract_want_updatable(config: &VirtualMachineConfig) -> bool {
1875 match config {
1876 VirtualMachineConfig::RawConfig(_) => true,
1877 VirtualMachineConfig::AppConfig(config) => {
1878 let Some(custom) = &config.customConfig else { return true };
1879 custom.wantUpdatable
1880 }
1881 }
1882}
1883
Nikita Ioffe5776f082023-02-10 21:38:26 +00001884fn extract_gdb_port(config: &VirtualMachineConfig) -> Option<NonZeroU16> {
1885 match config {
1886 VirtualMachineConfig::RawConfig(config) => NonZeroU16::new(config.gdbPort as u16),
Nikita Ioffea0eb5ee2023-06-26 18:18:21 +01001887 VirtualMachineConfig::AppConfig(config) => {
1888 NonZeroU16::new(config.customConfig.as_ref().map(|c| c.gdbPort).unwrap_or(0) as u16)
1889 }
Nikita Ioffe5776f082023-02-10 21:38:26 +00001890 }
1891}
1892
Nikita Ioffe631717e2023-09-05 13:38:07 +01001893fn check_no_vendor_modules(config: &VirtualMachineConfig) -> binder::Result<()> {
1894 let VirtualMachineConfig::AppConfig(config) = config else { return Ok(()) };
1895 if let Some(custom_config) = &config.customConfig {
1896 if custom_config.vendorImage.is_some() || custom_config.customKernelImage.is_some() {
1897 return Err(anyhow!("vendor modules feature is disabled"))
1898 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1899 }
1900 }
1901 Ok(())
1902}
1903
Nikita Ioffe94a8a182023-11-16 16:37:48 +00001904fn check_no_devices(config: &VirtualMachineConfig) -> binder::Result<()> {
1905 let VirtualMachineConfig::AppConfig(config) = config else { return Ok(()) };
1906 if let Some(custom_config) = &config.customConfig {
1907 if !custom_config.devices.is_empty() {
1908 return Err(anyhow!("device assignment feature is disabled"))
1909 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1910 }
1911 }
1912 Ok(())
1913}
1914
Alan Stokesfda70842023-12-20 17:50:14 +00001915fn check_no_extra_apks(config: &VirtualMachineConfig) -> binder::Result<()> {
1916 let VirtualMachineConfig::AppConfig(config) = config else { return Ok(()) };
1917 let Payload::PayloadConfig(payload_config) = &config.payload else { return Ok(()) };
1918 if !payload_config.extraApks.is_empty() {
1919 return Err(anyhow!("multi-tenant feature is disabled"))
1920 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1921 }
1922 Ok(())
1923}
1924
Nikita Ioffeb4268b32024-09-03 10:23:14 +00001925fn check_no_extra_kernel_cmdline_params(config: &VirtualMachineConfig) -> binder::Result<()> {
1926 let VirtualMachineConfig::AppConfig(config) = config else { return Ok(()) };
1927 if let Some(custom_config) = &config.customConfig {
1928 if !custom_config.extraKernelCmdlineParams.is_empty() {
1929 return Err(anyhow!("debuggable_vms_improvements feature is disabled"))
1930 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1931 }
1932 }
1933 Ok(())
1934}
1935
Nikita Ioffe99548382024-10-21 15:54:46 +00001936fn check_no_tee_services(config: &VirtualMachineConfig) -> binder::Result<()> {
1937 match config {
1938 VirtualMachineConfig::RawConfig(config) => {
1939 if !config.teeServices.is_empty() {
1940 return Err(anyhow!("tee_services_allowlist feature is disabled"))
1941 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1942 }
1943 }
1944 VirtualMachineConfig::AppConfig(config) => {
1945 if let Some(custom_config) = &config.customConfig {
1946 if !custom_config.teeServices.is_empty() {
1947 return Err(anyhow!("tee_services_allowlist feature is disabled"))
1948 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION);
1949 }
1950 }
1951 }
1952 };
1953 Ok(())
1954}
1955
Nikita Ioffef934e812024-07-05 15:44:41 +00001956fn check_protected_vm_is_supported() -> binder::Result<()> {
1957 let is_pvm_supported =
1958 hypervisor_props::is_protected_vm_supported().or_service_specific_exception(-1)?;
1959 if is_pvm_supported {
1960 Ok(())
1961 } else {
1962 Err(anyhow!("pVM is not supported"))
1963 .or_binder_exception(ExceptionCode::UNSUPPORTED_OPERATION)
1964 }
1965}
1966
Nikita Ioffe631717e2023-09-05 13:38:07 +01001967fn check_config_features(config: &VirtualMachineConfig) -> binder::Result<()> {
1968 if !cfg!(vendor_modules) {
1969 check_no_vendor_modules(config)?;
1970 }
Nikita Ioffe94a8a182023-11-16 16:37:48 +00001971 if !cfg!(device_assignment) {
1972 check_no_devices(config)?;
1973 }
Alan Stokesfda70842023-12-20 17:50:14 +00001974 if !cfg!(multi_tenant) {
1975 check_no_extra_apks(config)?;
1976 }
Nikita Ioffeb4268b32024-09-03 10:23:14 +00001977 if !cfg!(debuggable_vms_improvements) {
1978 check_no_extra_kernel_cmdline_params(config)?;
1979 }
Nikita Ioffe99548382024-10-21 15:54:46 +00001980 if !cfg!(tee_services_allowlist) {
1981 check_no_tee_services(config)?;
1982 }
Nikita Ioffe631717e2023-09-05 13:38:07 +01001983 Ok(())
1984}
1985
Inseob Kimecde8c02024-09-03 13:11:08 +09001986fn check_config_allowed_for_early_vms(config: &VirtualMachineConfig) -> binder::Result<()> {
1987 check_no_vendor_modules(config)?;
1988 check_no_devices(config)?;
1989
1990 Ok(())
1991}
1992
Inseob Kim0168b462022-12-27 14:54:35 +09001993fn clone_or_prepare_logger_fd(
Inseob Kim0168b462022-12-27 14:54:35 +09001994 fd: Option<&ParcelFileDescriptor>,
1995 tag: String,
1996) -> Result<Option<File>, Status> {
1997 if let Some(fd) = fd {
1998 return Ok(Some(clone_file(fd)?));
1999 }
2000
Frederick Maylefbbcfcd2024-04-08 16:31:54 -07002001 let (read_fd, write_fd) =
Jiyong Park2227eaa2023-08-04 11:59:18 +09002002 pipe().context("Failed to create pipe").or_service_specific_exception(-1)?;
Inseob Kim0168b462022-12-27 14:54:35 +09002003
Frederick Maylefbbcfcd2024-04-08 16:31:54 -07002004 let mut reader = BufReader::new(File::from(read_fd));
2005 let write_fd = File::from(write_fd);
Inseob Kim0168b462022-12-27 14:54:35 +09002006
Frederick Mayle26e41af2025-02-05 18:30:29 -08002007 let mut buf = vec![];
Inseob Kim0168b462022-12-27 14:54:35 +09002008 std::thread::spawn(move || loop {
Frederick Mayle26e41af2025-02-05 18:30:29 -08002009 buf.clear();
2010 buf.shrink_to(1024);
Inseob Kim0168b462022-12-27 14:54:35 +09002011 match reader.read_until(b'\n', &mut buf) {
2012 Ok(0) => {
2013 // EOF
2014 return;
2015 }
Frederick Mayle690ec2c2025-02-05 18:31:33 -08002016 Ok(_size) => {
2017 if buf.last() == Some(&b'\n') {
Inseob Kim0168b462022-12-27 14:54:35 +09002018 buf.pop();
Frederick Mayle690ec2c2025-02-05 18:31:33 -08002019 // Logs sent via TTY usually end lines with "\r\n".
2020 if buf.last() == Some(&b'\r') {
2021 buf.pop();
2022 }
Inseob Kim0168b462022-12-27 14:54:35 +09002023 }
2024 info!("{}: {}", &tag, &String::from_utf8_lossy(&buf));
2025 }
2026 Err(e) => {
2027 error!("Could not read console pipe: {:?}", e);
2028 return;
2029 }
2030 };
2031 });
2032
2033 Ok(Some(write_fd))
2034}
2035
Jooyung Han35edb8f2021-07-01 16:17:16 +09002036/// Simple utility for referencing Borrowed or Owned. Similar to std::borrow::Cow, but
2037/// it doesn't require that T implements Clone.
2038enum BorrowedOrOwned<'a, T> {
2039 Borrowed(&'a T),
2040 Owned(T),
2041}
2042
Chris Wailes73a1eb72025-01-15 11:56:43 -08002043impl<T> AsRef<T> for BorrowedOrOwned<'_, T> {
Jooyung Han35edb8f2021-07-01 16:17:16 +09002044 fn as_ref(&self) -> &T {
2045 match self {
2046 Self::Borrowed(b) => b,
Chris Wailes68c39f82021-07-27 16:03:44 -07002047 Self::Owned(o) => o,
Jooyung Han35edb8f2021-07-01 16:17:16 +09002048 }
2049 }
2050}
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002051
2052/// Implementation of `IVirtualMachineService`, the entry point of the AIDL service.
2053#[derive(Debug, Default)]
2054struct VirtualMachineService {
2055 state: Arc<Mutex<State>>,
Inseob Kimc7d28c72021-10-25 14:28:10 +00002056 cid: Cid,
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002057}
2058
2059impl Interface for VirtualMachineService {}
2060
2061impl IVirtualMachineService for VirtualMachineService {
Inseob Kimc7d28c72021-10-25 14:28:10 +00002062 fn notifyPayloadStarted(&self) -> binder::Result<()> {
2063 let cid = self.cid;
Inseob Kim7f61fe72021-08-20 20:50:47 +09002064 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01002065 info!("VM with CID {} started payload", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002066 vm.update_payload_state(PayloadState::Started)
2067 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
David Brazdil451cc962022-10-14 14:08:12 +01002068 vm.callbacks.notify_payload_started(cid);
Seungjae Yoo62085c02022-08-12 04:44:52 +00002069
Seungjae Yoo6d265d92022-11-15 10:51:33 +09002070 let vm_start_timestamp = vm.vm_metric.lock().unwrap().start_timestamp;
2071 write_vm_booted_stats(vm.requester_uid as i32, &vm.name, vm_start_timestamp);
Inseob Kim7f61fe72021-08-20 20:50:47 +09002072 Ok(())
2073 } else {
Jooyung Handd0a1732021-11-23 15:26:20 +09002074 error!("notifyPayloadStarted is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002075 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002076 }
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002077 }
Inseob Kim2444af92021-08-31 01:22:50 +09002078
Inseob Kimc7d28c72021-10-25 14:28:10 +00002079 fn notifyPayloadReady(&self) -> binder::Result<()> {
2080 let cid = self.cid;
Inseob Kim14cb8692021-08-31 21:50:39 +09002081 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01002082 info!("VM with CID {} reported payload is ready", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002083 vm.update_payload_state(PayloadState::Ready)
2084 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
Inseob Kim14cb8692021-08-31 21:50:39 +09002085 vm.callbacks.notify_payload_ready(cid);
2086 Ok(())
2087 } else {
Jooyung Handd0a1732021-11-23 15:26:20 +09002088 error!("notifyPayloadReady is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002089 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Inseob Kim14cb8692021-08-31 21:50:39 +09002090 }
2091 }
2092
Inseob Kimc7d28c72021-10-25 14:28:10 +00002093 fn notifyPayloadFinished(&self, exit_code: i32) -> binder::Result<()> {
2094 let cid = self.cid;
Inseob Kim2444af92021-08-31 01:22:50 +09002095 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01002096 info!("VM with CID {} finished payload", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002097 vm.update_payload_state(PayloadState::Finished)
2098 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
Inseob Kim2444af92021-08-31 01:22:50 +09002099 vm.callbacks.notify_payload_finished(cid, exit_code);
2100 Ok(())
2101 } else {
Jooyung Handd0a1732021-11-23 15:26:20 +09002102 error!("notifyPayloadFinished is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002103 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Jooyung Handd0a1732021-11-23 15:26:20 +09002104 }
2105 }
2106
Alan Stokes2bead0d2022-09-05 16:58:34 +01002107 fn notifyError(&self, error_code: ErrorCode, message: &str) -> binder::Result<()> {
Jooyung Handd0a1732021-11-23 15:26:20 +09002108 let cid = self.cid;
2109 if let Some(vm) = self.state.lock().unwrap().get_vm(cid) {
David Brazdil415097c2022-10-21 14:17:05 +01002110 info!("VM with CID {} encountered an error", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002111 vm.update_payload_state(PayloadState::Finished)
2112 .or_binder_exception(ExceptionCode::ILLEGAL_STATE)?;
Jooyung Handd0a1732021-11-23 15:26:20 +09002113 vm.callbacks.notify_error(cid, error_code, message);
2114 Ok(())
2115 } else {
Seungjae Yooec8c1602022-06-20 05:28:00 +00002116 error!("notifyError is called from an unknown CID {}", cid);
Jiyong Park2227eaa2023-08-04 11:59:18 +09002117 Err(anyhow!("cannot find a VM with CID {}", cid)).or_service_specific_exception(-1)
Inseob Kim2444af92021-08-31 01:22:50 +09002118 }
2119 }
Alice Wangc2fec932023-02-23 16:24:02 +00002120
Shikha Panware45e9422024-02-28 21:18:10 +00002121 fn getSecretkeeper(&self) -> binder::Result<Strong<dyn ISecretkeeper>> {
2122 if !is_secretkeeper_supported() {
2123 return Err(StatusCode::NAME_NOT_FOUND)?;
2124 }
2125 let sk = binder::wait_for_interface(SECRETKEEPER_IDENTIFIER)?;
2126 Ok(BnSecretkeeper::new_binder(SecretkeeperProxy(sk), BinderFeatures::default()))
Shikha Panwar5d6a6752023-12-14 22:08:26 +00002127 }
2128
Alice Wange64dd182024-01-17 15:57:55 +00002129 fn requestAttestation(&self, csr: &[u8], test_mode: bool) -> binder::Result<Vec<Certificate>> {
2130 GLOBAL_SERVICE.requestAttestation(csr, get_calling_uid() as i32, test_mode)
Alice Wangc2fec932023-02-23 16:24:02 +00002131 }
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002132}
2133
Shikha Panwar8707f0f2024-02-28 20:40:42 +00002134fn is_secretkeeper_supported() -> bool {
Shikha Panwar81d13d32024-03-10 19:39:23 +00002135 binder::is_declared(SECRETKEEPER_IDENTIFIER)
2136 .expect("Could not check for declared Secretkeeper interface")
Shikha Panwar8187ca22024-01-04 08:33:08 +00002137}
2138
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002139impl VirtualMachineService {
Inseob Kimc7d28c72021-10-25 14:28:10 +00002140 fn new_binder(state: Arc<Mutex<State>>, cid: Cid) -> Strong<dyn IVirtualMachineService> {
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002141 BnVirtualMachineService::new_binder(
Inseob Kimc7d28c72021-10-25 14:28:10 +00002142 VirtualMachineService { state, cid },
Inseob Kim1b95f2e2021-08-19 13:17:40 +09002143 BinderFeatures::default(),
2144 )
2145 }
2146}
Alan Stokes53cc5ca2022-08-30 14:28:19 +01002147
Stephen Hines4c1e2fc2024-02-09 16:34:47 -08002148struct SecretkeeperProxy(Strong<dyn ISecretkeeper>);
2149
2150impl Interface for SecretkeeperProxy {}
2151
2152impl ISecretkeeper for SecretkeeperProxy {
2153 fn processSecretManagementRequest(&self, req: &[u8]) -> binder::Result<Vec<u8>> {
2154 // Pass the request to the channel, and read the response.
2155 self.0.processSecretManagementRequest(req)
2156 }
2157
2158 fn getAuthGraphKe(&self) -> binder::Result<Strong<dyn IAuthGraphKeyExchange>> {
2159 let ag = AuthGraphKeyExchangeProxy(self.0.getAuthGraphKe()?);
2160 Ok(BnAuthGraphKeyExchange::new_binder(ag, BinderFeatures::default()))
2161 }
2162
2163 fn deleteIds(&self, ids: &[SecretId]) -> binder::Result<()> {
2164 self.0.deleteIds(ids)
2165 }
2166
2167 fn deleteAll(&self) -> binder::Result<()> {
2168 self.0.deleteAll()
2169 }
Matt Gilbrideb57abcc2024-10-12 15:26:45 +00002170
2171 fn getSecretkeeperIdentity(&self) -> binder::Result<PublicKey> {
2172 // SecretkeeperProxy is really a RPC binder service for PVM (It is called by
2173 // MicrodroidManager). PVMs do not & must not (for security reason) rely on
2174 // getSecretKeeperIdentity, so we throw an exception if someone attempts to
2175 // use this API from the proxy.
2176 Err(ExceptionCode::SECURITY.into())
2177 }
Stephen Hines4c1e2fc2024-02-09 16:34:47 -08002178}
2179
2180struct AuthGraphKeyExchangeProxy(Strong<dyn IAuthGraphKeyExchange>);
2181
2182impl Interface for AuthGraphKeyExchangeProxy {}
2183
2184impl IAuthGraphKeyExchange for AuthGraphKeyExchangeProxy {
2185 fn create(&self) -> binder::Result<SessionInitiationInfo> {
2186 self.0.create()
2187 }
2188
2189 fn init(
2190 &self,
2191 peer_pub_key: &PubKey,
2192 peer_id: &Identity,
2193 peer_nonce: &[u8],
2194 peer_version: i32,
2195 ) -> binder::Result<KeInitResult> {
2196 self.0.init(peer_pub_key, peer_id, peer_nonce, peer_version)
2197 }
2198
2199 fn finish(
2200 &self,
2201 peer_pub_key: &PubKey,
2202 peer_id: &Identity,
2203 peer_signature: &SessionIdSignature,
2204 peer_nonce: &[u8],
2205 peer_version: i32,
2206 own_key: &Key,
2207 ) -> binder::Result<SessionInfo> {
2208 self.0.finish(peer_pub_key, peer_id, peer_signature, peer_nonce, peer_version, own_key)
2209 }
2210
2211 fn authenticationComplete(
2212 &self,
2213 peer_signature: &SessionIdSignature,
2214 shared_keys: &[AuthgraphArc; 2],
2215 ) -> binder::Result<[AuthgraphArc; 2]> {
2216 self.0.authenticationComplete(peer_signature, shared_keys)
2217 }
2218}
2219
Inseob Kimecde8c02024-09-03 13:11:08 +09002220// KEEP IN SYNC WITH early_vms.xsd
Inseob Kim7e1877b2024-11-07 17:28:56 +09002221#[derive(Clone, Debug, Deserialize, PartialEq)]
Inseob Kimecde8c02024-09-03 13:11:08 +09002222struct EarlyVm {
Inseob Kimecde8c02024-09-03 13:11:08 +09002223 name: String,
Inseob Kimecde8c02024-09-03 13:11:08 +09002224 cid: i32,
Inseob Kimecde8c02024-09-03 13:11:08 +09002225 path: String,
2226}
2227
2228#[derive(Debug, Default, Deserialize)]
2229struct EarlyVms {
Inseob Kimecde8c02024-09-03 13:11:08 +09002230 early_vm: Vec<EarlyVm>,
2231}
2232
Inseob Kim7e1877b2024-11-07 17:28:56 +09002233static EARLY_VMS_CACHE: LazyLock<Mutex<HashMap<String, Vec<EarlyVm>>>> =
2234 LazyLock::new(|| Mutex::new(HashMap::new()));
2235
Inseob Kimecde8c02024-09-03 13:11:08 +09002236fn range_for_partition(partition: &str) -> Result<Range<Cid>> {
2237 match partition {
2238 "system" => Ok(100..200),
2239 "system_ext" | "product" => Ok(200..300),
Inseob Kime3e932d2024-12-16 20:06:57 +09002240 "vendor" | "odm" => Ok(300..400),
Inseob Kimecde8c02024-09-03 13:11:08 +09002241 _ => Err(anyhow!("Early VMs are not supported for {partition}")),
2242 }
2243}
2244
Inseob Kim7e1877b2024-11-07 17:28:56 +09002245fn get_early_vms_in_path(xml_path: &Path) -> Result<Vec<EarlyVm>> {
Inseob Kimecde8c02024-09-03 13:11:08 +09002246 if !xml_path.exists() {
2247 bail!("{} doesn't exist", xml_path.display());
2248 }
2249
2250 let xml =
2251 fs::read(xml_path).with_context(|| format!("Failed to read {}", xml_path.display()))?;
2252 let xml = String::from_utf8(xml)
2253 .with_context(|| format!("{} is not a valid UTF-8 file", xml_path.display()))?;
2254 let early_vms: EarlyVms = serde_xml_rs::from_str(&xml)
2255 .with_context(|| format!("Can't parse {}", xml_path.display()))?;
2256
Inseob Kim7e1877b2024-11-07 17:28:56 +09002257 Ok(early_vms.early_vm)
2258}
Inseob Kimecde8c02024-09-03 13:11:08 +09002259
Inseob Kim7e1877b2024-11-07 17:28:56 +09002260fn validate_cid_range(early_vms: &[EarlyVm], cid_range: &Range<Cid>) -> Result<()> {
2261 for early_vm in early_vms {
2262 let cid = early_vm
2263 .cid
2264 .try_into()
2265 .with_context(|| format!("VM '{}' uses Invalid CID {}", early_vm.name, early_vm.cid))?;
2266
2267 ensure!(
2268 cid_range.contains(&cid),
2269 "VM '{}' uses CID {cid} which is out of range. Available CIDs: {cid_range:?}",
2270 early_vm.name
2271 );
2272 }
2273 Ok(())
2274}
2275
2276fn get_early_vms_in_partition(partition: &str) -> Result<Vec<EarlyVm>> {
2277 let mut cache = EARLY_VMS_CACHE.lock().unwrap();
2278
2279 if let Some(result) = cache.get(partition) {
2280 return Ok(result.clone());
2281 }
2282
2283 let pattern = format!("/{partition}/etc/avf/early_vms*.xml");
2284 let mut early_vms = Vec::new();
2285 for entry in glob::glob(&pattern).with_context(|| format!("Failed to glob {}", &pattern))? {
2286 match entry {
2287 Ok(path) => early_vms.extend(get_early_vms_in_path(&path)?),
2288 Err(e) => error!("Error while globbing (but continuing) {}: {}", &pattern, e),
2289 }
2290 }
2291
2292 validate_cid_range(&early_vms, &range_for_partition(partition)?)
2293 .with_context(|| format!("CID validation for {partition} failed"))?;
2294
2295 cache.insert(partition.to_owned(), early_vms.clone());
2296
2297 Ok(early_vms)
2298}
2299
2300fn find_early_vm<'a>(early_vms: &'a [EarlyVm], name: &str) -> Result<&'a EarlyVm> {
2301 let mut found_vm: Option<&EarlyVm> = None;
2302
2303 for early_vm in early_vms {
Inseob Kimecde8c02024-09-03 13:11:08 +09002304 if early_vm.name != name {
2305 continue;
2306 }
2307
Inseob Kimecde8c02024-09-03 13:11:08 +09002308 if found_vm.is_some() {
Inseob Kim7e1877b2024-11-07 17:28:56 +09002309 bail!("Multiple VMs named '{name}' are found");
Inseob Kimecde8c02024-09-03 13:11:08 +09002310 }
2311
2312 found_vm = Some(early_vm);
2313 }
2314
Inseob Kim7e1877b2024-11-07 17:28:56 +09002315 found_vm.ok_or_else(|| anyhow!("Can't find a VM named '{name}'"))
Inseob Kimecde8c02024-09-03 13:11:08 +09002316}
2317
2318fn find_early_vm_for_partition(partition: &str, name: &str) -> Result<EarlyVm> {
Inseob Kim7e1877b2024-11-07 17:28:56 +09002319 let early_vms = get_early_vms_in_partition(partition)
2320 .with_context(|| format!("Failed to get early VMs from {partition}"))?;
2321
2322 Ok(find_early_vm(&early_vms, name)
2323 .with_context(|| format!("Failed to find early VM '{name}' in {partition}"))?
2324 .clone())
Inseob Kimecde8c02024-09-03 13:11:08 +09002325}
2326
Alan Stokes53cc5ca2022-08-30 14:28:19 +01002327#[cfg(test)]
2328mod tests {
2329 use super::*;
2330
2331 #[test]
2332 fn test_is_allowed_label_for_partition() -> Result<()> {
2333 let expected_results = vec![
2334 ("u:object_r:system_file:s0", true),
2335 ("u:object_r:apk_data_file:s0", true),
2336 ("u:object_r:app_data_file:s0", false),
2337 ("u:object_r:app_data_file:s0:c512,c768", false),
2338 ("u:object_r:privapp_data_file:s0:c512,c768", false),
2339 ("invalid", false),
2340 ("user:role:apk_data_file:severity:categories", true),
2341 ("user:role:apk_data_file:severity:categories:extraneous", false),
2342 ];
2343
2344 for (label, expected_valid) in expected_results {
2345 let context = SeContext::new(label)?;
2346 let result = check_label_is_allowed(&context);
2347 if expected_valid {
2348 assert!(result.is_ok(), "Expected label {} to be allowed, got {:?}", label, result);
2349 } else if result.is_ok() {
2350 bail!("Expected label {} to be disallowed", label);
2351 }
2352 }
2353 Ok(())
2354 }
Nikita Ioffef1ce9872022-12-09 13:31:59 +00002355
2356 #[test]
2357 fn test_create_or_update_idsig_file_empty_apk() -> Result<()> {
2358 let apk = tempfile::tempfile().unwrap();
2359 let idsig = tempfile::tempfile().unwrap();
2360
2361 let ret = create_or_update_idsig_file(
2362 &ParcelFileDescriptor::new(apk),
2363 &ParcelFileDescriptor::new(idsig),
2364 );
2365 assert!(ret.is_err(), "should fail");
2366 Ok(())
2367 }
2368
2369 #[test]
2370 fn test_create_or_update_idsig_dir_instead_of_file_for_apk() -> Result<()> {
2371 let tmp_dir = tempfile::TempDir::new().unwrap();
2372 let apk = File::open(tmp_dir.path()).unwrap();
2373 let idsig = tempfile::tempfile().unwrap();
2374
2375 let ret = create_or_update_idsig_file(
2376 &ParcelFileDescriptor::new(apk),
2377 &ParcelFileDescriptor::new(idsig),
2378 );
2379 assert!(ret.is_err(), "should fail");
2380 Ok(())
2381 }
2382
2383 /// Verifies that create_or_update_idsig_file won't oom if a fd that corresponds to a directory
2384 /// on ext4 filesystem is passed.
2385 /// On ext4 lseek on a directory fd will return (off_t)-1 (see:
2386 /// https://bugzilla.kernel.org/show_bug.cgi?id=200043), which will result in
2387 /// create_or_update_idsig_file ooming while attempting to allocate petabytes of memory.
2388 #[test]
2389 fn test_create_or_update_idsig_does_not_crash_dir_on_ext4() -> Result<()> {
2390 // APEXes are backed by the ext4.
2391 let apk = File::open("/apex/com.android.virt/").unwrap();
2392 let idsig = tempfile::tempfile().unwrap();
2393
2394 let ret = create_or_update_idsig_file(
2395 &ParcelFileDescriptor::new(apk),
2396 &ParcelFileDescriptor::new(idsig),
2397 );
2398 assert!(ret.is_err(), "should fail");
2399 Ok(())
2400 }
Jiyong Park8d192952023-06-26 14:29:51 +09002401
2402 #[test]
2403 fn test_create_or_update_idsig_does_not_update_if_already_valid() -> Result<()> {
2404 use std::io::Seek;
2405
2406 // Pick any APK
2407 let mut apk = File::open("/system/priv-app/Shell/Shell.apk").unwrap();
2408 let mut idsig = tempfile::tempfile().unwrap();
2409
2410 create_or_update_idsig_file(
2411 &ParcelFileDescriptor::new(apk.try_clone()?),
2412 &ParcelFileDescriptor::new(idsig.try_clone()?),
2413 )?;
2414 let modified_orig = idsig.metadata()?.modified()?;
2415 apk.rewind()?;
2416 idsig.rewind()?;
2417
2418 // Call the function again
2419 create_or_update_idsig_file(
2420 &ParcelFileDescriptor::new(apk.try_clone()?),
2421 &ParcelFileDescriptor::new(idsig.try_clone()?),
2422 )?;
2423 let modified_new = idsig.metadata()?.modified()?;
2424 assert!(modified_orig == modified_new, "idsig file was updated unnecessarily");
2425 Ok(())
2426 }
Nikita Ioffeaa6858c2023-07-04 01:37:41 +01002427
2428 #[test]
Shikha Panwar9ae2e622024-01-30 12:22:30 +00002429 fn test_create_or_update_idsig_on_non_empty_file() -> Result<()> {
2430 use std::io::Read;
2431
2432 // Pick any APK
2433 let mut apk = File::open("/system/priv-app/Shell/Shell.apk").unwrap();
2434 let idsig_empty = tempfile::tempfile().unwrap();
2435 let mut idsig_invalid = tempfile::tempfile().unwrap();
2436 idsig_invalid.write_all(b"Oops")?;
2437
2438 // Create new idsig
2439 create_or_update_idsig_file(
2440 &ParcelFileDescriptor::new(apk.try_clone()?),
2441 &ParcelFileDescriptor::new(idsig_empty.try_clone()?),
2442 )?;
2443 apk.rewind()?;
2444
2445 // Update idsig_invalid
2446 create_or_update_idsig_file(
2447 &ParcelFileDescriptor::new(apk.try_clone()?),
2448 &ParcelFileDescriptor::new(idsig_invalid.try_clone()?),
2449 )?;
2450
2451 // Ensure the 2 idsig files have same size!
2452 assert!(
2453 idsig_empty.metadata()?.len() == idsig_invalid.metadata()?.len(),
2454 "idsig files differ in size"
2455 );
2456 // Ensure the 2 idsig files have same content!
2457 for (b1, b2) in idsig_empty.bytes().zip(idsig_invalid.bytes()) {
2458 assert!(b1.unwrap() == b2.unwrap(), "idsig files differ")
2459 }
2460 Ok(())
2461 }
2462 #[test]
Nikita Ioffeaa6858c2023-07-04 01:37:41 +01002463 fn test_append_kernel_param_first_param() {
2464 let mut vm_config = VirtualMachineRawConfig { ..Default::default() };
2465 append_kernel_param("foo=1", &mut vm_config);
2466 assert_eq!(vm_config.params, Some("foo=1".to_owned()))
2467 }
2468
2469 #[test]
2470 fn test_append_kernel_param() {
2471 let mut vm_config =
2472 VirtualMachineRawConfig { params: Some("foo=5".to_owned()), ..Default::default() };
2473 append_kernel_param("bar=42", &mut vm_config);
2474 assert_eq!(vm_config.params, Some("foo=5 bar=42".to_owned()))
2475 }
Seungjae Yooec3bc522023-11-09 10:14:30 +09002476
Inseob Kim46257382024-01-03 15:41:22 +09002477 fn test_extract_os_name_from_config_path(
2478 path: &Path,
2479 expected_result: Option<&str>,
2480 ) -> Result<()> {
2481 let result = extract_os_name_from_config_path(path);
2482 if result.as_deref() != expected_result {
2483 bail!("Expected {:?} but was {:?}", expected_result, &result)
2484 }
2485 Ok(())
2486 }
2487
2488 #[test]
2489 fn test_extract_os_name_from_microdroid_config() -> Result<()> {
2490 test_extract_os_name_from_config_path(
2491 Path::new("/apex/com.android.virt/etc/microdroid.json"),
2492 Some("microdroid"),
2493 )
2494 }
2495
2496 #[test]
Nikita Ioffef49350e2024-11-01 16:11:48 +00002497 fn test_extract_os_name_from_microdroid_16k_config() -> Result<()> {
2498 test_extract_os_name_from_config_path(
2499 Path::new("/apex/com.android.virt/etc/microdroid_16k.json"),
2500 Some("microdroid_16k"),
2501 )
2502 }
2503
2504 #[test]
Inseob Kim46257382024-01-03 15:41:22 +09002505 fn test_extract_os_name_from_microdroid_gki_config() -> Result<()> {
2506 test_extract_os_name_from_config_path(
2507 Path::new("/apex/com.android.virt/etc/microdroid_gki-android14-6.1.json"),
2508 Some("microdroid_gki-android14-6.1"),
2509 )
2510 }
2511
2512 #[test]
2513 fn test_extract_os_name_from_invalid_path() -> Result<()> {
2514 test_extract_os_name_from_config_path(
2515 Path::new("/apex/com.android.virt/etc/microdroid.img"),
2516 None,
2517 )
2518 }
2519
2520 #[test]
2521 fn test_extract_os_name_from_configs() -> Result<()> {
2522 let tmp_dir = tempfile::TempDir::new()?;
2523 let tmp_dir_path = tmp_dir.path().to_owned();
2524
2525 let mut os_names: HashSet<String> = HashSet::new();
2526 os_names.insert("microdroid".to_owned());
2527 os_names.insert("microdroid_gki-android14-6.1".to_owned());
2528 os_names.insert("microdroid_gki-android15-6.1".to_owned());
2529
2530 // config files
2531 for os_name in &os_names {
2532 std::fs::write(tmp_dir_path.join(os_name.to_owned() + ".json"), b"")?;
2533 }
2534
2535 // fake files not related to configs
2536 std::fs::write(tmp_dir_path.join("microdroid_super.img"), b"")?;
2537 std::fs::write(tmp_dir_path.join("microdroid_foobar.apk"), b"")?;
2538
2539 let glob_pattern = match tmp_dir_path.join("microdroid*.json").to_str() {
2540 Some(s) => s.to_owned(),
2541 None => bail!("tmp_dir_path {:?} is not UTF-8", tmp_dir_path),
2542 };
2543
2544 let result = extract_os_names_from_configs(&glob_pattern)?;
2545 if result != os_names {
2546 bail!("Expected {:?} but was {:?}", os_names, result);
2547 }
2548 Ok(())
2549 }
Inseob Kimecde8c02024-09-03 13:11:08 +09002550
2551 #[test]
2552 fn test_find_early_vms_from_xml() -> Result<()> {
2553 let tmp_dir = tempfile::TempDir::new()?;
2554 let tmp_dir_path = tmp_dir.path().to_owned();
2555 let xml_path = tmp_dir_path.join("early_vms.xml");
2556
2557 std::fs::write(
2558 &xml_path,
2559 br#"<?xml version="1.0" encoding="utf-8"?>
2560 <early_vms>
2561 <early_vm>
2562 <name>vm_demo_native_early</name>
2563 <cid>123</cid>
2564 <path>/system/bin/vm_demo_native_early</path>
2565 </early_vm>
2566 <early_vm>
Inseob Kim7e1877b2024-11-07 17:28:56 +09002567 <name>vm_demo_native_early_2</name>
2568 <cid>456</cid>
2569 <path>/system/bin/vm_demo_native_early_2</path>
2570 </early_vm>
2571 </early_vms>
2572 "#,
2573 )?;
2574
2575 let cid_range = 100..1000;
2576
2577 let early_vms = get_early_vms_in_path(&xml_path)?;
2578 validate_cid_range(&early_vms, &cid_range)?;
2579
2580 let test_cases = [
2581 (
2582 "vm_demo_native_early",
2583 EarlyVm {
2584 name: "vm_demo_native_early".to_owned(),
2585 cid: 123,
2586 path: "/system/bin/vm_demo_native_early".to_owned(),
2587 },
2588 ),
2589 (
2590 "vm_demo_native_early_2",
2591 EarlyVm {
2592 name: "vm_demo_native_early_2".to_owned(),
2593 cid: 456,
2594 path: "/system/bin/vm_demo_native_early_2".to_owned(),
2595 },
2596 ),
2597 ];
2598
2599 for (name, expected) in test_cases {
2600 let result = find_early_vm(&early_vms, name)?;
2601 assert_eq!(result, &expected);
2602 }
2603
2604 Ok(())
2605 }
2606
2607 #[test]
2608 fn test_invalid_cid_validation() -> Result<()> {
2609 let tmp_dir = tempfile::TempDir::new()?;
2610 let xml_path = tmp_dir.path().join("early_vms.xml");
2611
2612 let cid_range = 100..1000;
2613
2614 for cid in [-1, 999999] {
2615 std::fs::write(
2616 &xml_path,
2617 format!(
2618 r#"<?xml version="1.0" encoding="utf-8"?>
2619 <early_vms>
2620 <early_vm>
2621 <name>vm_demo_invalid_cid</name>
2622 <cid>{cid}</cid>
2623 <path>/system/bin/vm_demo_invalid_cid</path>
2624 </early_vm>
2625 </early_vms>
2626 "#
2627 ),
2628 )?;
2629
2630 let early_vms = get_early_vms_in_path(&xml_path)?;
2631 assert!(validate_cid_range(&early_vms, &cid_range).is_err(), "should fail");
2632 }
2633
2634 Ok(())
2635 }
2636
2637 #[test]
2638 fn test_duplicated_early_vms() -> Result<()> {
2639 let tmp_dir = tempfile::TempDir::new()?;
2640 let tmp_dir_path = tmp_dir.path().to_owned();
2641 let xml_path = tmp_dir_path.join("early_vms.xml");
2642
2643 std::fs::write(
2644 &xml_path,
2645 br#"<?xml version="1.0" encoding="utf-8"?>
2646 <early_vms>
2647 <early_vm>
Inseob Kimecde8c02024-09-03 13:11:08 +09002648 <name>vm_demo_duplicated_name</name>
2649 <cid>456</cid>
2650 <path>/system/bin/vm_demo_duplicated_name_1</path>
2651 </early_vm>
2652 <early_vm>
2653 <name>vm_demo_duplicated_name</name>
2654 <cid>789</cid>
2655 <path>/system/bin/vm_demo_duplicated_name_2</path>
2656 </early_vm>
Inseob Kimecde8c02024-09-03 13:11:08 +09002657 </early_vms>
2658 "#,
2659 )?;
2660
2661 let cid_range = 100..1000;
2662
Inseob Kim7e1877b2024-11-07 17:28:56 +09002663 let early_vms = get_early_vms_in_path(&xml_path)?;
2664 validate_cid_range(&early_vms, &cid_range)?;
Inseob Kimecde8c02024-09-03 13:11:08 +09002665
Inseob Kim7e1877b2024-11-07 17:28:56 +09002666 assert!(find_early_vm(&early_vms, "vm_demo_duplicated_name").is_err(), "should fail");
Inseob Kimecde8c02024-09-03 13:11:08 +09002667
2668 Ok(())
2669 }
Alan Stokes53cc5ca2022-08-30 14:28:19 +01002670}