blob: de42f4f98c8a73fcd6d241883bc2472cd212a68b [file] [log] [blame]
// WARNING: This file is machine generated by fidlgen.
#![allow(
deprecated, // FIDL Impl struct pattern is referenced internally
unused_parens, // one-element-tuple-case is not a tuple
unused_mut, // not all args require mutation, but many do
nonstandard_style, // auto-caps does its best, but is not always successful
)]
#![recursion_limit = "512"]
#[cfg(target_os = "fuchsia")]
#[allow(unused_imports)]
use fuchsia_zircon as zx;
#[allow(unused_imports)]
use {
bitflags::bitflags,
fidl::{
client::{decode_transaction_body_fut, QueryResponseFut},
encoding::{Decodable as _, Encodable as _},
fidl_empty_struct, fidl_flexible_bits, fidl_flexible_enum, fidl_strict_bits,
fidl_strict_enum, fidl_struct, fidl_struct_copy, fidl_table, fidl_xunion,
wrap_handle_metadata,
},
fuchsia_zircon_status as zx_status,
futures::future::{self, MaybeDone, TryFutureExt},
};
const _FIDL_TRACE_BINDINGS_RUST: u32 = 6;
pub type ExampleFooResult = std::result::Result<(i64), u32>;
pub type ExampleFooResultHandleWrapper = std::result::Result<(i64,), u32>;
#[derive(
Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash, zerocopy::AsBytes, zerocopy::FromBytes,
)]
#[repr(C)]
pub struct ExampleFooResponse {
pub y: i64,
}
fidl_struct_copy! {
name: ExampleFooResponse,
members: [
y {
ty: i64,
offset_v1: 0,
},
],
padding: [],
size_v1: 8,
align_v1: 8,
}
#[derive(Debug, Copy, Clone, Eq, PartialEq, Ord, PartialOrd, Hash)]
pub struct ExampleMarker;
impl fidl::endpoints::ServiceMarker for ExampleMarker {
type Proxy = ExampleProxy;
type RequestStream = ExampleRequestStream;
const DEBUG_NAME: &'static str = "(anonymous) Example";
}
pub trait ExampleProxyInterface: Send + Sync {
type FooResponseFut: std::future::Future<Output = Result<(ExampleFooResult), fidl::Error>>
+ Send;
fn r#foo(&self, s: &str) -> Self::FooResponseFut;
}
#[derive(Debug)]
#[cfg(target_os = "fuchsia")]
pub struct ExampleSynchronousProxy {
client: fidl::client::sync::Client,
}
#[cfg(target_os = "fuchsia")]
impl ExampleSynchronousProxy {
pub fn new(channel: fidl::Channel) -> Self {
let service_name = <ExampleMarker as fidl::endpoints::ServiceMarker>::DEBUG_NAME;
Self { client: fidl::client::sync::Client::new(channel, service_name) }
}
pub fn into_channel(self) -> fidl::Channel {
self.client.into_channel()
}
pub fn r#foo(
&mut self,
mut s: &str,
___deadline: zx::Time,
) -> Result<(ExampleFooResult), fidl::Error> {
let _value: (ExampleFooResultHandleWrapper) =
self.client.send_query(&mut (s), 0x57e41804562237ae, ___deadline)?;
Ok(_value.map(|_value| _value.0))
}
}
#[derive(Debug, Clone)]
pub struct ExampleProxy {
client: fidl::client::Client,
}
impl fidl::endpoints::Proxy for ExampleProxy {
type Service = ExampleMarker;
fn from_channel(inner: fidl::AsyncChannel) -> Self {
Self::new(inner)
}
fn into_channel(self) -> Result<::fidl::AsyncChannel, Self> {
self.client.into_channel().map_err(|client| Self { client })
}
fn as_channel(&self) -> &::fidl::AsyncChannel {
self.client.as_channel()
}
}
impl ExampleProxy {
/// Create a new Proxy for Example
pub fn new(channel: fidl::AsyncChannel) -> Self {
let service_name = <ExampleMarker as fidl::endpoints::ServiceMarker>::DEBUG_NAME;
Self { client: fidl::client::Client::new(channel, service_name) }
}
/// Get a Stream of events from the remote end of the Example protocol
///
/// # Panics
///
/// Panics if the event stream was already taken.
pub fn take_event_stream(&self) -> ExampleEventStream {
ExampleEventStream { event_receiver: self.client.take_event_receiver() }
}
pub fn r#foo(&self, mut s: &str) -> fidl::client::QueryResponseFut<(ExampleFooResult)> {
ExampleProxyInterface::r#foo(self, s)
}
}
impl ExampleProxyInterface for ExampleProxy {
type FooResponseFut = fidl::client::QueryResponseFut<(ExampleFooResult)>;
fn r#foo(&self, mut s: &str) -> Self::FooResponseFut {
fn transform(
result: Result<(ExampleFooResultHandleWrapper), fidl::Error>,
) -> Result<(ExampleFooResult), fidl::Error> {
result.map(|_value| _value.map(|_value| _value.0))
}
let send_result = self.client.call_send_raw_query(&mut (s), 0x57e41804562237ae);
QueryResponseFut(match send_result {
Ok(res_fut) => future::maybe_done(
res_fut.and_then(|buf| decode_transaction_body_fut(buf, transform)),
),
Err(e) => MaybeDone::Done(Err(e)),
})
}
}
pub struct ExampleEventStream {
event_receiver: fidl::client::EventReceiver,
}
impl std::marker::Unpin for ExampleEventStream {}
impl futures::stream::FusedStream for ExampleEventStream {
fn is_terminated(&self) -> bool {
self.event_receiver.is_terminated()
}
}
impl futures::Stream for ExampleEventStream {
type Item = Result<ExampleEvent, fidl::Error>;
fn poll_next(
mut self: std::pin::Pin<&mut Self>,
cx: &mut std::task::Context<'_>,
) -> std::task::Poll<Option<Self::Item>> {
let mut buf = match futures::ready!(futures::stream::StreamExt::poll_next_unpin(
&mut self.event_receiver,
cx
)?) {
Some(buf) => buf,
None => return std::task::Poll::Ready(None),
};
let (bytes, _handles) = buf.split_mut();
let (tx_header, _body_bytes) = fidl::encoding::decode_transaction_header(bytes)?;
std::task::Poll::Ready(Some(match tx_header.ordinal() {
_ => Err(fidl::Error::UnknownOrdinal {
ordinal: tx_header.ordinal(),
service_name: <ExampleMarker as fidl::endpoints::ServiceMarker>::DEBUG_NAME,
}),
}))
}
}
#[derive(Debug)]
pub enum ExampleEvent {}
impl ExampleEvent {}
/// A type which can be used to send responses and events into a borrowed channel.
///
/// Note: this should only be used when the channel must be temporarily
/// borrowed. For a typical sending of events, use the send_ methods
/// on the ControlHandle types, which can be acquired through a
/// RequestStream or Responder type.
#[deprecated(note = "Use ExampleRequestStream / Responder instead")]
pub struct ExampleServerSender<'a> {
// Some protocols don't define events which would render this channel unused.
#[allow(unused)]
channel: &'a fidl::Channel,
}
impl<'a> ExampleServerSender<'a> {
pub fn new(channel: &'a fidl::Channel) -> Self {
Self { channel }
}
pub fn send_foo_response(
&self,
txid: fidl::client::Txid,
mut result: &mut ExampleFooResult,
) -> Result<(), fidl::Error> {
fidl::encoding::with_tls_encode_buf(|bytes_, handles_| {
ExampleEncoder::encode_foo_response(bytes_, handles_, txid.as_raw_id(), result)?;
self.channel
.write_etc(&*bytes_, &mut *handles_)
.map_err(fidl::Error::ServerResponseWrite)?;
Ok(())
})
}
}
/// A Stream of incoming requests for Example
pub struct ExampleRequestStream {
inner: std::sync::Arc<fidl::ServeInner>,
is_terminated: bool,
}
impl std::marker::Unpin for ExampleRequestStream {}
impl futures::stream::FusedStream for ExampleRequestStream {
fn is_terminated(&self) -> bool {
self.is_terminated
}
}
impl fidl::endpoints::RequestStream for ExampleRequestStream {
type Service = ExampleMarker;
/// Consume a channel to make a ExampleRequestStream
fn from_channel(channel: fidl::AsyncChannel) -> Self {
Self { inner: std::sync::Arc::new(fidl::ServeInner::new(channel)), is_terminated: false }
}
/// ControlHandle for the remote connection
type ControlHandle = ExampleControlHandle;
/// ControlHandle for the remote connection
fn control_handle(&self) -> Self::ControlHandle {
ExampleControlHandle { inner: self.inner.clone() }
}
fn into_inner(self) -> (::std::sync::Arc<fidl::ServeInner>, bool) {
(self.inner, self.is_terminated)
}
fn from_inner(inner: std::sync::Arc<fidl::ServeInner>, is_terminated: bool) -> Self {
Self { inner, is_terminated }
}
}
impl futures::Stream for ExampleRequestStream {
type Item = Result<ExampleRequest, fidl::Error>;
fn poll_next(
mut self: std::pin::Pin<&mut Self>,
cx: &mut std::task::Context<'_>,
) -> std::task::Poll<Option<Self::Item>> {
let this = &mut *self;
if this.inner.poll_shutdown(cx) {
this.is_terminated = true;
return std::task::Poll::Ready(None);
}
if this.is_terminated {
panic!("polled ExampleRequestStream after completion");
}
fidl::encoding::with_tls_decode_buf(|bytes, handles| {
match this.inner.channel().read_etc(cx, bytes, handles) {
std::task::Poll::Ready(Ok(())) => {}
std::task::Poll::Pending => return std::task::Poll::Pending,
std::task::Poll::Ready(Err(zx_status::Status::PEER_CLOSED)) => {
this.is_terminated = true;
return std::task::Poll::Ready(None);
}
std::task::Poll::Ready(Err(e)) => {
return std::task::Poll::Ready(Some(Err(fidl::Error::ServerRequestRead(e))))
}
}
// A message has been received from the channel
let (header, _body_bytes) = fidl::encoding::decode_transaction_header(bytes)?;
if !header.is_compatible() {
return std::task::Poll::Ready(Some(Err(fidl::Error::IncompatibleMagicNumber(
header.magic_number(),
))));
}
std::task::Poll::Ready(Some(match header.ordinal() {
0x57e41804562237ae => {
let mut req: (String,) = fidl::encoding::Decodable::new_empty();
fidl::duration_begin!("fidl", "decode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "name" => "fidl.test.error/ExampleFooRequest");
fidl::trace_blob!("fidl:blob", "decode", bytes);
fidl::encoding::Decoder::decode_into(&header, _body_bytes, handles, &mut req)?;
fidl::duration_end!("fidl", "decode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "size" => bytes.len() as u32, "handle_count" => handles.len() as u32);
let control_handle = ExampleControlHandle { inner: this.inner.clone() };
Ok(ExampleRequest::Foo {
s: req.0,
responder: ExampleFooResponder {
control_handle: std::mem::ManuallyDrop::new(control_handle),
tx_id: header.tx_id(),
ordinal: header.ordinal(),
},
})
}
_ => Err(fidl::Error::UnknownOrdinal {
ordinal: header.ordinal(),
service_name: <ExampleMarker as fidl::endpoints::ServiceMarker>::DEBUG_NAME,
}),
}))
})
}
}
/// Represents a single request.
/// RequestMessages should only be used for manual deserialization when higher level
/// structs such as RequestStream cannot be used. One usually would only encounter
/// such scenarios when working with legacy FIDL code (prior to FIDL generated client/server bindings).
#[derive(Debug)]
#[deprecated(note = "Use ExampleRequest instead")]
pub enum ExampleRequestMessage {
Foo { s: String, tx_id: fidl::client::Txid },
}
impl ExampleRequestMessage {
pub fn decode(
bytes: &[u8],
_handles: &mut [fidl::HandleInfo],
) -> Result<ExampleRequestMessage, fidl::Error> {
let (header, _body_bytes) = fidl::encoding::decode_transaction_header(bytes)?;
match header.ordinal() {
0x57e41804562237ae => {
let mut out_tuple: (String,) = fidl::encoding::Decodable::new_empty();
fidl::duration_begin!("fidl", "decode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "name" => "fidl.test.error/ExampleFooRequest");
fidl::trace_blob!("fidl:blob", "decode", bytes);
fidl::encoding::Decoder::decode_into(
&header,
_body_bytes,
_handles,
&mut out_tuple,
)?;
fidl::duration_end!("fidl", "decode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "size" => bytes.len() as u32, "handle_count" => _handles.len() as u32);
Ok(ExampleRequestMessage::Foo { s: out_tuple.0, tx_id: header.tx_id().into() })
}
_ => Err(fidl::Error::UnknownOrdinal {
ordinal: header.ordinal(),
service_name: <ExampleMarker as fidl::endpoints::ServiceMarker>::DEBUG_NAME,
}),
}
}
}
#[derive(Debug)]
pub enum ExampleRequest {
Foo { s: String, responder: ExampleFooResponder },
}
impl ExampleRequest {
#[allow(irrefutable_let_patterns)]
pub fn into_foo(self) -> Option<(String, ExampleFooResponder)> {
if let ExampleRequest::Foo { s, responder } = self {
Some((s, responder))
} else {
None
}
}
/// Name of the method defined in FIDL
pub fn method_name(&self) -> &'static str {
match *self {
ExampleRequest::Foo { .. } => "foo",
}
}
}
pub struct ExampleEncoder;
impl ExampleEncoder {
pub fn encode_foo_request<'a>(
out_bytes: &'a mut Vec<u8>,
out_handles: &'a mut Vec<fidl::HandleDisposition<'static>>,
tx_id: u32,
mut in_s: &str,
) -> Result<(), fidl::Error> {
let header = fidl::encoding::TransactionHeader::new(tx_id, 0x57e41804562237ae);
let mut body = (in_s,);
let mut msg = fidl::encoding::TransactionMessage { header, body: &mut body };
fidl::duration_begin!("fidl", "encode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "name" => "fidl.test.error/ExampleFooRequest");
fidl::encoding::Encoder::encode(out_bytes, out_handles, &mut msg)?;
fidl::trace_blob!("fidl:blob", "encode", out_bytes.as_slice());
fidl::duration_end!("fidl", "encode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "size" => out_bytes.len() as u32, "handle_count" => out_handles.len() as u32);
Ok(())
}
pub fn encode_foo_response<'a>(
out_bytes: &'a mut Vec<u8>,
out_handles: &'a mut Vec<fidl::HandleDisposition<'static>>,
tx_id: u32,
mut in_result: &mut ExampleFooResult,
) -> Result<(), fidl::Error> {
let header = fidl::encoding::TransactionHeader::new(tx_id, 0x57e41804562237ae);
let mut body = (in_result,);
let mut msg = fidl::encoding::TransactionMessage { header, body: &mut body };
fidl::duration_begin!("fidl", "encode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "name" => "fidl.test.error/ExampleFooResponse");
fidl::encoding::Encoder::encode(out_bytes, out_handles, &mut msg)?;
fidl::trace_blob!("fidl:blob", "encode", out_bytes.as_slice());
fidl::duration_end!("fidl", "encode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "size" => out_bytes.len() as u32, "handle_count" => out_handles.len() as u32);
Ok(())
}
}
#[derive(Debug, Clone)]
pub struct ExampleControlHandle {
inner: std::sync::Arc<fidl::ServeInner>,
}
impl ExampleControlHandle {
/// Set the server to shutdown. The underlying channel is only closed the
/// next time the stream is polled.
pub fn shutdown(&self) {
self.inner.shutdown()
}
pub fn shutdown_with_epitaph(&self, status: zx_status::Status) {
self.inner.shutdown_with_epitaph(status)
}
}
#[must_use = "FIDL methods require a response to be sent"]
#[derive(Debug)]
pub struct ExampleFooResponder {
control_handle: std::mem::ManuallyDrop<ExampleControlHandle>,
tx_id: u32,
ordinal: u64,
}
/// Set the the channel to be shutdown (see [`ExampleControlHandle::shutdown`])
/// if the responder is dropped without sending a response, so that the client
/// doesn't hang. To prevent this behavior, call `drop_without_shutdown`.
impl std::ops::Drop for ExampleFooResponder {
fn drop(&mut self) {
self.control_handle.shutdown();
// Safety: drops once, never accessed again
unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
}
}
impl ExampleFooResponder {
pub fn control_handle(&self) -> &ExampleControlHandle {
&self.control_handle
}
/// Drop the Responder without setting the channel to shutdown.
///
/// This method shouldn't normally be used-- instead, send a response
/// to prevent the channel from shutting down.
pub fn drop_without_shutdown(mut self) {
// Safety: drops once, never accessed again due to mem::forget
unsafe { std::mem::ManuallyDrop::drop(&mut self.control_handle) };
// Prevent Drop from running (which would shut down the channel)
std::mem::forget(self);
}
/// Sends a response to the FIDL transaction.
///
/// Sets the channel to shutdown if an error occurs.
pub fn send(self, mut result: &mut ExampleFooResult) -> Result<(), fidl::Error> {
let r = self.send_raw(result);
if r.is_err() {
self.control_handle.shutdown();
}
self.drop_without_shutdown();
r
}
/// Similar to "send" but does not shutdown the channel if
/// an error occurs.
pub fn send_no_shutdown_on_err(
self,
mut result: &mut ExampleFooResult,
) -> Result<(), fidl::Error> {
let r = self.send_raw(result);
self.drop_without_shutdown();
r
}
fn send_raw(&self, mut result: &mut ExampleFooResult) -> Result<(), fidl::Error> {
let mut response = (result);
let mut msg = fidl::encoding::TransactionMessage {
header: fidl::encoding::TransactionHeader::new(self.tx_id, self.ordinal),
body: &mut response,
};
fidl::encoding::with_tls_encode_buf(|bytes, handles| {
fidl::duration_begin!("fidl", "encode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "name" => "fidl.test.error/ExampleFooResponse");
fidl::encoding::Encoder::encode(bytes, handles, &mut msg)?;
fidl::trace_blob!("fidl:blob", "encode", bytes.as_slice());
fidl::duration_end!("fidl", "encode", "bindings" => _FIDL_TRACE_BINDINGS_RUST, "size" => bytes.len() as u32, "handle_count" => handles.len() as u32);
self.control_handle
.inner
.channel()
.write_etc(&*bytes, &mut *handles)
.map_err(fidl::Error::ServerResponseWrite)?;
Ok(())
})
}
}