builtins/
hypervisor_resource.rs

1// Copyright 2020 The Fuchsia Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5use anyhow::{Error, format_err};
6use fidl_fuchsia_kernel as fkernel;
7use futures::prelude::*;
8use std::sync::Arc;
9use zx::Resource;
10
11/// An implementation of fuchsia.kernel.HypervisorResource protocol.
12pub struct HypervisorResource {
13    resource: Resource,
14}
15
16impl HypervisorResource {
17    /// `resource` must be the Hypervisor resource.
18    pub fn new(resource: Resource) -> Result<Arc<Self>, Error> {
19        let resource_info = resource.info()?;
20        if resource_info.kind != zx::sys::ZX_RSRC_KIND_SYSTEM
21            || resource_info.base != zx::sys::ZX_RSRC_SYSTEM_HYPERVISOR_BASE
22            || resource_info.size != 1
23        {
24            return Err(format_err!("Hypervisor resource not available."));
25        }
26        Ok(Arc::new(Self { resource }))
27    }
28
29    pub async fn serve(
30        self: Arc<Self>,
31        mut stream: fkernel::HypervisorResourceRequestStream,
32    ) -> Result<(), Error> {
33        while let Some(fkernel::HypervisorResourceRequest::Get { responder }) =
34            stream.try_next().await?
35        {
36            responder.send(self.resource.duplicate_handle(zx::Rights::SAME_RIGHTS)?)?;
37        }
38        Ok(())
39    }
40}
41
42#[cfg(test)]
43mod tests {
44    use super::*;
45    use fidl_fuchsia_kernel as fkernel;
46    use fuchsia_async as fasync;
47    use fuchsia_component::client::connect_to_protocol;
48
49    async fn get_hypervisor_resource() -> Result<Resource, Error> {
50        let hypervisor_resource_provider =
51            connect_to_protocol::<fkernel::HypervisorResourceMarker>()?;
52        let hypervisor_resource_handle = hypervisor_resource_provider.get().await?;
53        Ok(Resource::from(hypervisor_resource_handle))
54    }
55
56    async fn serve_hypervisor_resource() -> Result<fkernel::HypervisorResourceProxy, Error> {
57        let hypervisor_resource = get_hypervisor_resource().await?;
58
59        let (proxy, stream) =
60            fidl::endpoints::create_proxy_and_stream::<fkernel::HypervisorResourceMarker>();
61        fasync::Task::local(
62            HypervisorResource::new(hypervisor_resource)
63                .unwrap_or_else(|e| {
64                    panic!("Error while creating hypervisor resource service: {}", e)
65                })
66                .serve(stream)
67                .unwrap_or_else(|e| {
68                    panic!("Error while serving HYPERVISOR resource service: {}", e)
69                }),
70        )
71        .detach();
72        Ok(proxy)
73    }
74
75    #[fuchsia::test]
76    async fn kind_type_is_hypervisor() -> Result<(), Error> {
77        let hypervisor_resource_provider = serve_hypervisor_resource().await?;
78        let hypervisor_resource: Resource = hypervisor_resource_provider.get().await?;
79        let resource_info = hypervisor_resource.info()?;
80        assert_eq!(resource_info.kind, zx::sys::ZX_RSRC_KIND_SYSTEM);
81        assert_eq!(resource_info.base, zx::sys::ZX_RSRC_SYSTEM_HYPERVISOR_BASE);
82        assert_eq!(resource_info.size, 1);
83        Ok(())
84    }
85}
builtins/hypervisor_resource.rs

builtins/
hypervisor_resource.rs
