fidl_fuchsia_crashdriver_test/
fidl_fuchsia_crashdriver_test.rs

1// WARNING: This file is machine generated by fidlgen.
2
3#![warn(clippy::all)]
4#![allow(unused_parens, unused_mut, unused_imports, nonstandard_style)]
5
6use bitflags::bitflags;
7use fidl::client::QueryResponseFut;
8use fidl::encoding::{MessageBufFor, ProxyChannelBox, ResourceDialect};
9use fidl::endpoints::{ControlHandle as _, Responder as _};
10pub use fidl_fuchsia_crashdriver_test_common::*;
11use futures::future::{self, MaybeDone, TryFutureExt};
12use zx_status;
13
14#[derive(Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)]
15pub struct CrasherMarker;
16
17impl fidl::endpoints::ProtocolMarker for CrasherMarker {
18    type Proxy = CrasherProxy;
19    type RequestStream = CrasherRequestStream;
20    #[cfg(target_os = "fuchsia")]
21    type SynchronousProxy = CrasherSynchronousProxy;
22
23    const DEBUG_NAME: &'static str = "(anonymous) Crasher";
24}
25
26pub trait CrasherProxyInterface: Send + Sync {
27    type PingResponseFut: std::future::Future<Output = Result<u64, fidl::Error>> + Send;
28    fn r#ping(&self) -> Self::PingResponseFut;
29    fn r#crash(&self) -> Result<(), fidl::Error>;
30}
31#[derive(Debug)]
32#[cfg(target_os = "fuchsia")]
33pub struct CrasherSynchronousProxy {
34    client: fidl::client::sync::Client,
35}
36
37#[cfg(target_os = "fuchsia")]
38impl fidl::endpoints::SynchronousProxy for CrasherSynchronousProxy {
39    type Proxy = CrasherProxy;
40    type Protocol = CrasherMarker;
41
42    fn from_channel(inner: fidl::Channel) -> Self {
43        Self::new(inner)
44    }
45
46    fn into_channel(self) -> fidl::Channel {
47        self.client.into_channel()
48    }
49
50    fn as_channel(&self) -> &fidl::Channel {
51        self.client.as_channel()
52    }
53}
54
55#[cfg(target_os = "fuchsia")]
56impl CrasherSynchronousProxy {
57    pub fn new(channel: fidl::Channel) -> Self {
58        let protocol_name = <CrasherMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME;
59        Self { client: fidl::client::sync::Client::new(channel, protocol_name) }
60    }
61
62    pub fn into_channel(self) -> fidl::Channel {
63        self.client.into_channel()
64    }
65
66    /// Waits until an event arrives and returns it. It is safe for other
67    /// threads to make concurrent requests while waiting for an event.
68    pub fn wait_for_event(
69        &self,
70        deadline: zx::MonotonicInstant,
71    ) -> Result<CrasherEvent, fidl::Error> {
72        CrasherEvent::decode(self.client.wait_for_event(deadline)?)
73    }
74
75    /// Returns a number that is unique per instance of the driver.
76    pub fn r#ping(&self, ___deadline: zx::MonotonicInstant) -> Result<u64, fidl::Error> {
77        let _response =
78            self.client.send_query::<fidl::encoding::EmptyPayload, CrasherPingResponse>(
79                (),
80                0x63e0c4d973e4b1f9,
81                fidl::encoding::DynamicFlags::empty(),
82                ___deadline,
83            )?;
84        Ok(_response.pong)
85    }
86
87    /// One way call that will assert false and kill the host process.
88    pub fn r#crash(&self) -> Result<(), fidl::Error> {
89        self.client.send::<fidl::encoding::EmptyPayload>(
90            (),
91            0x15290e84d9b74bd2,
92            fidl::encoding::DynamicFlags::empty(),
93        )
94    }
95}
96
97#[cfg(target_os = "fuchsia")]
98impl From<CrasherSynchronousProxy> for zx::Handle {
99    fn from(value: CrasherSynchronousProxy) -> Self {
100        value.into_channel().into()
101    }
102}
103
104#[cfg(target_os = "fuchsia")]
105impl From<fidl::Channel> for CrasherSynchronousProxy {
106    fn from(value: fidl::Channel) -> Self {
107        Self::new(value)
108    }
109}
110
111#[derive(Debug, Clone)]
112pub struct CrasherProxy {
113    client: fidl::client::Client<fidl::encoding::DefaultFuchsiaResourceDialect>,
114}
115
116impl fidl::endpoints::Proxy for CrasherProxy {
117    type Protocol = CrasherMarker;
118
119    fn from_channel(inner: ::fidl::AsyncChannel) -> Self {
120        Self::new(inner)
121    }
122
123    fn into_channel(self) -> Result<::fidl::AsyncChannel, Self> {
124        self.client.into_channel().map_err(|client| Self { client })
125    }
126
127    fn as_channel(&self) -> &::fidl::AsyncChannel {
128        self.client.as_channel()
129    }
130}
131
132impl CrasherProxy {
133    /// Create a new Proxy for fuchsia.crashdriver.test/Crasher.
134    pub fn new(channel: ::fidl::AsyncChannel) -> Self {
135        let protocol_name = <CrasherMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME;
136        Self { client: fidl::client::Client::new(channel, protocol_name) }
137    }
138
139    /// Get a Stream of events from the remote end of the protocol.
140    ///
141    /// # Panics
142    ///
143    /// Panics if the event stream was already taken.
144    pub fn take_event_stream(&self) -> CrasherEventStream {
145        CrasherEventStream { event_receiver: self.client.take_event_receiver() }
146    }
147
148    /// Returns a number that is unique per instance of the driver.
149    pub fn r#ping(
150        &self,
151    ) -> fidl::client::QueryResponseFut<u64, fidl::encoding::DefaultFuchsiaResourceDialect> {
152        CrasherProxyInterface::r#ping(self)
153    }
154
155    /// One way call that will assert false and kill the host process.
156    pub fn r#crash(&self) -> Result<(), fidl::Error> {
157        CrasherProxyInterface::r#crash(self)
158    }
159}
160
161impl CrasherProxyInterface for CrasherProxy {
162    type PingResponseFut =
163        fidl::client::QueryResponseFut<u64, fidl::encoding::DefaultFuchsiaResourceDialect>;
164    fn r#ping(&self) -> Self::PingResponseFut {
165        fn _decode(
166            mut _buf: Result<<fidl::encoding::DefaultFuchsiaResourceDialect as fidl::encoding::ResourceDialect>::MessageBufEtc, fidl::Error>,
167        ) -> Result<u64, fidl::Error> {
168            let _response = fidl::client::decode_transaction_body::<
169                CrasherPingResponse,
170                fidl::encoding::DefaultFuchsiaResourceDialect,
171                0x63e0c4d973e4b1f9,
172            >(_buf?)?;
173            Ok(_response.pong)
174        }
175        self.client.send_query_and_decode::<fidl::encoding::EmptyPayload, u64>(
176            (),
177            0x63e0c4d973e4b1f9,
178            fidl::encoding::DynamicFlags::empty(),
179            _decode,
180        )
181    }
182
183    fn r#crash(&self) -> Result<(), fidl::Error> {
184        self.client.send::<fidl::encoding::EmptyPayload>(
185            (),
186            0x15290e84d9b74bd2,
187            fidl::encoding::DynamicFlags::empty(),
188        )
189    }
190}
191
192pub struct CrasherEventStream {
193    event_receiver: fidl::client::EventReceiver<fidl::encoding::DefaultFuchsiaResourceDialect>,
194}
195
196impl std::marker::Unpin for CrasherEventStream {}
197
198impl futures::stream::FusedStream for CrasherEventStream {
199    fn is_terminated(&self) -> bool {
200        self.event_receiver.is_terminated()
201    }
202}
203
204impl futures::Stream for CrasherEventStream {
205    type Item = Result<CrasherEvent, fidl::Error>;
206
207    fn poll_next(
208        mut self: std::pin::Pin<&mut Self>,
209        cx: &mut std::task::Context<'_>,
210    ) -> std::task::Poll<Option<Self::Item>> {
211        match futures::ready!(futures::stream::StreamExt::poll_next_unpin(
212            &mut self.event_receiver,
213            cx
214        )?) {
215            Some(buf) => std::task::Poll::Ready(Some(CrasherEvent::decode(buf))),
216            None => std::task::Poll::Ready(None),
217        }
218    }
219}
220
221#[derive(Debug)]
222pub enum CrasherEvent {}
223
224impl CrasherEvent {
225    /// Decodes a message buffer as a [`CrasherEvent`].
226    fn decode(
227        mut buf: <fidl::encoding::DefaultFuchsiaResourceDialect as fidl::encoding::ResourceDialect>::MessageBufEtc,
228    ) -> Result<CrasherEvent, fidl::Error> {
229        let (bytes, _handles) = buf.split_mut();
230        let (tx_header, _body_bytes) = fidl::encoding::decode_transaction_header(bytes)?;
231        debug_assert_eq!(tx_header.tx_id, 0);
232        match tx_header.ordinal {
233            _ => Err(fidl::Error::UnknownOrdinal {
234                ordinal: tx_header.ordinal,
235                protocol_name: <CrasherMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME,
236            }),
237        }
238    }
239}
240
241/// A Stream of incoming requests for fuchsia.crashdriver.test/Crasher.
242pub struct CrasherRequestStream {
243    inner: std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>,
244    is_terminated: bool,
245}
246
247impl std::marker::Unpin for CrasherRequestStream {}
248
249impl futures::stream::FusedStream for CrasherRequestStream {
250    fn is_terminated(&self) -> bool {
251        self.is_terminated
252    }
253}
254
255impl fidl::endpoints::RequestStream for CrasherRequestStream {
256    type Protocol = CrasherMarker;
257    type ControlHandle = CrasherControlHandle;
258
259    fn from_channel(channel: ::fidl::AsyncChannel) -> Self {
260        Self { inner: std::sync::Arc::new(fidl::ServeInner::new(channel)), is_terminated: false }
261    }
262
263    fn control_handle(&self) -> Self::ControlHandle {
264        CrasherControlHandle { inner: self.inner.clone() }
265    }
266
267    fn into_inner(
268        self,
269    ) -> (::std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>, bool)
270    {
271        (self.inner, self.is_terminated)
272    }
273
274    fn from_inner(
275        inner: std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>,
276        is_terminated: bool,
277    ) -> Self {
278        Self { inner, is_terminated }
279    }
280}
281
282impl futures::Stream for CrasherRequestStream {
283    type Item = Result<CrasherRequest, fidl::Error>;
284
285    fn poll_next(
286        mut self: std::pin::Pin<&mut Self>,
287        cx: &mut std::task::Context<'_>,
288    ) -> std::task::Poll<Option<Self::Item>> {
289        let this = &mut *self;
290        if this.inner.check_shutdown(cx) {
291            this.is_terminated = true;
292            return std::task::Poll::Ready(None);
293        }
294        if this.is_terminated {
295            panic!("polled CrasherRequestStream after completion");
296        }
297        fidl::encoding::with_tls_decode_buf::<_, fidl::encoding::DefaultFuchsiaResourceDialect>(
298            |bytes, handles| {
299                match this.inner.channel().read_etc(cx, bytes, handles) {
300                    std::task::Poll::Ready(Ok(())) => {}
301                    std::task::Poll::Pending => return std::task::Poll::Pending,
302                    std::task::Poll::Ready(Err(zx_status::Status::PEER_CLOSED)) => {
303                        this.is_terminated = true;
304                        return std::task::Poll::Ready(None);
305                    }
306                    std::task::Poll::Ready(Err(e)) => {
307                        return std::task::Poll::Ready(Some(Err(fidl::Error::ServerRequestRead(
308                            e.into(),
309                        ))))
310                    }
311                }
312
313                // A message has been received from the channel
314                let (header, _body_bytes) = fidl::encoding::decode_transaction_header(bytes)?;
315
316                std::task::Poll::Ready(Some(match header.ordinal {
317                    0x63e0c4d973e4b1f9 => {
318                        header.validate_request_tx_id(fidl::MethodType::TwoWay)?;
319                        let mut req = fidl::new_empty!(
320                            fidl::encoding::EmptyPayload,
321                            fidl::encoding::DefaultFuchsiaResourceDialect
322                        );
323                        fidl::encoding::Decoder::<fidl::encoding::DefaultFuchsiaResourceDialect>::decode_into::<fidl::encoding::EmptyPayload>(&header, _body_bytes, handles, &mut req)?;
324                        let control_handle = CrasherControlHandle { inner: this.inner.clone() };
325                        Ok(CrasherRequest::Ping {
326                            responder: CrasherPingResponder {
327                                control_handle: std::mem::ManuallyDrop::new(control_handle),
328                                tx_id: header.tx_id,
329                            },
330                        })
331                    }
332                    0x15290e84d9b74bd2 => {
333                        header.validate_request_tx_id(fidl::MethodType::OneWay)?;
334                        let mut req = fidl::new_empty!(
335                            fidl::encoding::EmptyPayload,
336                            fidl::encoding::DefaultFuchsiaResourceDialect
337                        );
338                        fidl::encoding::Decoder::<fidl::encoding::DefaultFuchsiaResourceDialect>::decode_into::<fidl::encoding::EmptyPayload>(&header, _body_bytes, handles, &mut req)?;
339                        let control_handle = CrasherControlHandle { inner: this.inner.clone() };
340                        Ok(CrasherRequest::Crash { control_handle })
341                    }
342                    _ => Err(fidl::Error::UnknownOrdinal {
343                        ordinal: header.ordinal,
344                        protocol_name:
345                            <CrasherMarker as fidl::endpoints::ProtocolMarker>::DEBUG_NAME,
346                    }),
347                }))
348            },
349        )
350    }
351}
352
353#[derive(Debug)]
354pub enum CrasherRequest {
355    /// Returns a number that is unique per instance of the driver.
356    Ping { responder: CrasherPingResponder },
357    /// One way call that will assert false and kill the host process.
358    Crash { control_handle: CrasherControlHandle },
359}
360
361impl CrasherRequest {
362    #[allow(irrefutable_let_patterns)]
363    pub fn into_ping(self) -> Option<(CrasherPingResponder)> {
364        if let CrasherRequest::Ping { responder } = self {
365            Some((responder))
366        } else {
367            None
368        }
369    }
370
371    #[allow(irrefutable_let_patterns)]
372    pub fn into_crash(self) -> Option<(CrasherControlHandle)> {
373        if let CrasherRequest::Crash { control_handle } = self {
374            Some((control_handle))
375        } else {
376            None
377        }
378    }
379
380    /// Name of the method defined in FIDL
381    pub fn method_name(&self) -> &'static str {
382        match *self {
383            CrasherRequest::Ping { .. } => "ping",
384            CrasherRequest::Crash { .. } => "crash",
385        }
386    }
387}
388
389#[derive(Debug, Clone)]
390pub struct CrasherControlHandle {
391    inner: std::sync::Arc<fidl::ServeInner<fidl::encoding::DefaultFuchsiaResourceDialect>>,
392}
393
394impl fidl::endpoints::ControlHandle for CrasherControlHandle {
395    fn shutdown(&self) {
396        self.inner.shutdown()
397    }
398    fn shutdown_with_epitaph(&self, status: zx_status::Status) {
399        self.inner.shutdown_with_epitaph(status)
400    }
401
402    fn is_closed(&self) -> bool {
403        self.inner.channel().is_closed()
404    }
405    fn on_closed(&self) -> fidl::OnSignalsRef<'_> {
406        self.inner.channel().on_closed()
407    }
408
409    #[cfg(target_os = "fuchsia")]
410    fn signal_peer(
411        &self,
412        clear_mask: zx::Signals,
413        set_mask: zx::Signals,
414    ) -> Result<(), zx_status::Status> {
415        use fidl::Peered;
416        self.inner.channel().signal_peer(clear_mask, set_mask)
417    }
418}
419
420impl CrasherControlHandle {}
421
422#[must_use = "FIDL methods require a response to be sent"]
423#[derive(Debug)]
424pub struct CrasherPingResponder {
425    control_handle: std::mem::ManuallyDrop<CrasherControlHandle>,
426    tx_id: u32,
427}
428
429/// Set the the channel to be shutdown (see [`CrasherControlHandle::shutdown`])
430/// if the responder is dropped without sending a response, so that the client
431/// doesn't hang. To prevent this behavior, call `drop_without_shutdown`.
432impl std::ops::Drop for CrasherPingResponder {
433    fn drop(&mut self) {
434        self.control_handle.shutdown();
435        // Safety: drops once, never accessed again
436        unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
437    }
438}
439
440impl fidl::endpoints::Responder for CrasherPingResponder {
441    type ControlHandle = CrasherControlHandle;
442
443    fn control_handle(&self) -> &CrasherControlHandle {
444        &self.control_handle
445    }
446
447    fn drop_without_shutdown(mut self) {
448        // Safety: drops once, never accessed again due to mem::forget
449        unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
450        // Prevent Drop from running (which would shut down the channel)
451        std::mem::forget(self);
452    }
453}
454
455impl CrasherPingResponder {
456    /// Sends a response to the FIDL transaction.
457    ///
458    /// Sets the channel to shutdown if an error occurs.
459    pub fn send(self, mut pong: u64) -> Result<(), fidl::Error> {
460        let _result = self.send_raw(pong);
461        if _result.is_err() {
462            self.control_handle.shutdown();
463        }
464        self.drop_without_shutdown();
465        _result
466    }
467
468    /// Similar to "send" but does not shutdown the channel if an error occurs.
469    pub fn send_no_shutdown_on_err(self, mut pong: u64) -> Result<(), fidl::Error> {
470        let _result = self.send_raw(pong);
471        self.drop_without_shutdown();
472        _result
473    }
474
475    fn send_raw(&self, mut pong: u64) -> Result<(), fidl::Error> {
476        self.control_handle.inner.send::<CrasherPingResponse>(
477            (pong,),
478            self.tx_id,
479            0x63e0c4d973e4b1f9,
480            fidl::encoding::DynamicFlags::empty(),
481        )
482    }
483}
484
485#[derive(Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)]
486pub struct DeviceMarker;
487
488#[cfg(target_os = "fuchsia")]
489impl fidl::endpoints::ServiceMarker for DeviceMarker {
490    type Proxy = DeviceProxy;
491    type Request = DeviceRequest;
492    const SERVICE_NAME: &'static str = "fuchsia.crashdriver.test.Device";
493}
494
495/// A request for one of the member protocols of Device.
496///
497#[cfg(target_os = "fuchsia")]
498pub enum DeviceRequest {
499    Crasher(CrasherRequestStream),
500}
501
502#[cfg(target_os = "fuchsia")]
503impl fidl::endpoints::ServiceRequest for DeviceRequest {
504    type Service = DeviceMarker;
505
506    fn dispatch(name: &str, _channel: fidl::AsyncChannel) -> Self {
507        match name {
508            "crasher" => Self::Crasher(
509                <CrasherRequestStream as fidl::endpoints::RequestStream>::from_channel(_channel),
510            ),
511            _ => panic!("no such member protocol name for service Device"),
512        }
513    }
514
515    fn member_names() -> &'static [&'static str] {
516        &["crasher"]
517    }
518}
519#[cfg(target_os = "fuchsia")]
520pub struct DeviceProxy(#[allow(dead_code)] Box<dyn fidl::endpoints::MemberOpener>);
521
522#[cfg(target_os = "fuchsia")]
523impl fidl::endpoints::ServiceProxy for DeviceProxy {
524    type Service = DeviceMarker;
525
526    fn from_member_opener(opener: Box<dyn fidl::endpoints::MemberOpener>) -> Self {
527        Self(opener)
528    }
529}
530
531#[cfg(target_os = "fuchsia")]
532impl DeviceProxy {
533    pub fn connect_to_crasher(&self) -> Result<CrasherProxy, fidl::Error> {
534        let (proxy, server_end) = fidl::endpoints::create_proxy::<CrasherMarker>();
535        self.connect_channel_to_crasher(server_end)?;
536        Ok(proxy)
537    }
538
539    /// Like `connect_to_crasher`, but returns a sync proxy.
540    /// See [`Self::connect_to_crasher`] for more details.
541    pub fn connect_to_crasher_sync(&self) -> Result<CrasherSynchronousProxy, fidl::Error> {
542        let (proxy, server_end) = fidl::endpoints::create_sync_proxy::<CrasherMarker>();
543        self.connect_channel_to_crasher(server_end)?;
544        Ok(proxy)
545    }
546
547    /// Like `connect_to_crasher`, but accepts a server end.
548    /// See [`Self::connect_to_crasher`] for more details.
549    pub fn connect_channel_to_crasher(
550        &self,
551        server_end: fidl::endpoints::ServerEnd<CrasherMarker>,
552    ) -> Result<(), fidl::Error> {
553        self.0.open_member("crasher", server_end.into_channel())
554    }
555
556    pub fn instance_name(&self) -> &str {
557        self.0.instance_name()
558    }
559}
560
561mod internal {
562    use super::*;
563}
fidl_fuchsia_crashdriver_test/fidl_fuchsia_crashdriver_test.rs

fidl_fuchsia_crashdriver_test/
fidl_fuchsia_crashdriver_test.rs
