builtins/
debug_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.DebugResource protocol.
12pub struct DebugResource {
13    resource: Resource,
14}
15
16impl DebugResource {
17    /// `resource` must be the Debug 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_DEBUG_BASE
22            || resource_info.size != 1
23        {
24            return Err(format_err!("Debug 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::DebugResourceRequestStream,
32    ) -> Result<(), Error> {
33        while let Some(fkernel::DebugResourceRequest::Get { responder }) = stream.try_next().await?
34        {
35            responder.send(self.resource.duplicate_handle(zx::Rights::SAME_RIGHTS)?)?;
36        }
37        Ok(())
38    }
39}
40
41#[cfg(test)]
42mod tests {
43    use super::*;
44    use fidl_fuchsia_kernel as fkernel;
45    use fuchsia_async as fasync;
46    use fuchsia_component::client::connect_to_protocol;
47
48    async fn get_debug_resource() -> Result<Resource, Error> {
49        let debug_resource_provider = connect_to_protocol::<fkernel::DebugResourceMarker>()?;
50        let debug_resource_handle = debug_resource_provider.get().await?;
51        Ok(Resource::from(debug_resource_handle))
52    }
53
54    async fn serve_debug_resource() -> Result<fkernel::DebugResourceProxy, Error> {
55        let debug_resource = get_debug_resource().await?;
56
57        let (proxy, stream) =
58            fidl::endpoints::create_proxy_and_stream::<fkernel::DebugResourceMarker>();
59        fasync::Task::local(
60            DebugResource::new(debug_resource)
61                .unwrap_or_else(|e| panic!("Error while creating debug resource service: {}", e))
62                .serve(stream)
63                .unwrap_or_else(|e| panic!("Error while serving debug resource service: {}", e)),
64        )
65        .detach();
66        Ok(proxy)
67    }
68
69    #[fuchsia::test]
70    async fn base_type_is_debug() -> Result<(), Error> {
71        let debug_resource_provider = serve_debug_resource().await?;
72        let debug_resource: Resource = debug_resource_provider.get().await?;
73        let resource_info = debug_resource.info()?;
74        assert_eq!(resource_info.kind, zx::sys::ZX_RSRC_KIND_SYSTEM);
75        assert_eq!(resource_info.base, zx::sys::ZX_RSRC_SYSTEM_DEBUG_BASE);
76        assert_eq!(resource_info.size, 1);
77        Ok(())
78    }
79}
builtins/debug_resource.rs

builtins/
debug_resource.rs
