Struct RequestContext

Source
pub struct RequestContext { /* private fields */ }
Expand description

The RequestContext provides a store of information that needs to cross the plugin sandbox boundary.

Implementations§

Source§

impl RequestContext

Source

pub fn new( plugin: Arc<Plugin>, redis_info: Option<Arc<RedisInfo>>, http_client: Arc<Client>, params: Arc<Mutex<Map<String, Value>>>, request: Arc<Request>, ) -> Result<RequestContext, ContextInstantiationError>

Creates a new RequestContext.

§Arguments
  • plugin - The Plugin and its associated configuration.
  • redis_info - The Redis connection pool.
  • params - A key-value map that plugins use to pass values within the context of a request. Any parameters captured by the router will be added to this before plugin execution.
  • request - The Request that plugins will be operating on.

Trait Implementations§

Source§

impl WasiView for RequestContext

Source§

fn table(&self) -> &Table

Source§

fn table_mut(&mut self) -> &mut Table

Source§

fn ctx(&self) -> &WasiCtx

Source§

fn ctx_mut(&mut self) -> &mut WasiCtx

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> GetSetFdFlags for T

Source§

fn get_fd_flags(&self) -> Result<FdFlags, Error>
where T: AsFilelike,

Query the “status” flags for the self file descriptor.
Source§

fn new_set_fd_flags(&self, fd_flags: FdFlags) -> Result<SetFdFlags<T>, Error>
where T: AsFilelike,

Create a new SetFdFlags value for use with set_fd_flags. Read more
Source§

fn set_fd_flags(&mut self, set_fd_flags: SetFdFlags<T>) -> Result<(), Error>
where T: AsFilelike,

Set the “status” flags for the self file descriptor. Read more
Source§

impl<T> Host for T
where T: Host,

Source§

fn convert_error_code( &mut self, err: TrappableError<ErrorCode>, ) -> Result<ErrorCode, Error>

Source§

fn filesystem_error_code( &mut self, err: Resource<Error>, ) -> Result<Option<ErrorCode>, Error>

Attempts to extract a filesystem-related error-code from the stream error provided. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn poll( &mut self, pollables: Vec<Resource<Pollable>>, ) -> Result<Vec<u32>, Error>

Poll for completion on a set of pollables. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn get_terminal_stdin( &mut self, ) -> Result<Option<Resource<TerminalInput>>, Error>

If stdin is connected to a terminal, return a terminal-input handle allowing further interaction with it.
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn get_terminal_stdout( &mut self, ) -> Result<Option<Resource<TerminalOutput>>, Error>

If stdout is connected to a terminal, return a terminal-output handle allowing further interaction with it.
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn get_terminal_stderr( &mut self, ) -> Result<Option<Resource<TerminalOutput>>, Error>

If stderr is connected to a terminal, return a terminal-output handle allowing further interaction with it.
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn now(&mut self) -> Result<Datetime, Error>

Read the current value of the clock. Read more
Source§

fn resolution(&mut self) -> Result<Datetime, Error>

Query the resolution of the clock. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn now(&mut self) -> Result<u64, Error>

Read the current value of the clock. Read more
Source§

fn resolution(&mut self) -> Result<u64, Error>

Query the resolution of the clock. Returns the duration of time corresponding to a clock tick.
Source§

fn subscribe_instant(&mut self, when: u64) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the specified instant occured.
Source§

fn subscribe_duration( &mut self, duration: u64, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the given duration has elapsed, starting at the time at which this function was called. occured.
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn convert_error_code( &mut self, err: TrappableError<ErrorCode>, ) -> Result<ErrorCode, Error>

Source§

fn filesystem_error_code( &mut self, err: Resource<Error>, ) -> Result<Option<ErrorCode>, Error>

Attempts to extract a filesystem-related error-code from the stream error provided. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn get_directories( &mut self, ) -> Result<Vec<(Resource<Descriptor>, String)>, Error>

Return the set of preopened directories, and their path.
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn poll<'life0, 'async_trait>( &'life0 mut self, pollables: Vec<Resource<Pollable>>, ) -> Pin<Box<dyn Future<Output = Result<Vec<u32>, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Poll for completion on a set of pollables. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

fn get_random_bytes(&mut self, len: u64) -> Result<Vec<u8>, Error>

Return len cryptographically-secure random or pseudo-random bytes. Read more
Source§

fn get_random_u64(&mut self) -> Result<u64, Error>

Return a cryptographically-secure random or pseudo-random u64 value. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn get_insecure_random_bytes(&mut self, len: u64) -> Result<Vec<u8>, Error>

Return len insecure pseudo-random bytes. Read more
Source§

fn get_insecure_random_u64(&mut self) -> Result<u64, Error>

Return an insecure pseudo-random u64 value. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn insecure_seed(&mut self) -> Result<(u64, u64), Error>

Return a 128-bit value that may contain a pseudo-random value. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

fn instance_network(&mut self) -> Result<Resource<Network>, Error>

Get a handle to the default network.
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn resolve_addresses( &mut self, network: Resource<Network>, name: String, ) -> Result<Resource<ResolveAddressStream>, TrappableError<ErrorCode>>

Resolve an internet host name to a list of IP addresses. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn create_tcp_socket( &mut self, address_family: IpAddressFamily, ) -> Result<Resource<TcpSocket>, TrappableError<ErrorCode>>

Create a new TCP socket. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn create_udp_socket( &mut self, address_family: IpAddressFamily, ) -> Result<Resource<UdpSocket>, TrappableError<ErrorCode>>

Create a new UDP socket. Read more
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn get_environment(&mut self) -> Result<Vec<(String, String)>, Error>

Get the POSIX-style environment variables. Read more
Source§

fn get_arguments(&mut self) -> Result<Vec<String>, Error>

Get the POSIX-style arguments to the program.
Source§

fn initial_cwd(&mut self) -> Result<Option<String>, Error>

Return a path that programs should use as their initial current working directory, interpreting . as shorthand for this.
Source§

impl<T> Host for T
where T: WasiView,

Source§

fn exit(&mut self, status: Result<(), ()>) -> Result<(), Error>

Exit the current instance and any linked instances.
Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> HostDescriptor for T
where T: HostDescriptor,

Source§

fn advise( &mut self, fd: Resource<Descriptor>, offset: u64, len: u64, advice: Advice, ) -> Result<(), TrappableError<ErrorCode>>

Provide file advisory information on a descriptor. Read more
Source§

fn sync_data( &mut self, fd: Resource<Descriptor>, ) -> Result<(), TrappableError<ErrorCode>>

Synchronize the data of a file to disk. Read more
Source§

fn get_flags( &mut self, fd: Resource<Descriptor>, ) -> Result<DescriptorFlags, TrappableError<ErrorCode>>

Get flags associated with a descriptor. Read more
Source§

fn get_type( &mut self, fd: Resource<Descriptor>, ) -> Result<DescriptorType, TrappableError<ErrorCode>>

Get the dynamic type of a descriptor. Read more
Source§

fn set_size( &mut self, fd: Resource<Descriptor>, size: u64, ) -> Result<(), TrappableError<ErrorCode>>

Adjust the size of an open file. If this increases the file’s size, the extra bytes are filled with zeros. Read more
Source§

fn set_times( &mut self, fd: Resource<Descriptor>, atim: NewTimestamp, mtim: NewTimestamp, ) -> Result<(), TrappableError<ErrorCode>>

Adjust the timestamps of an open file or directory. Read more
Source§

fn read( &mut self, fd: Resource<Descriptor>, len: u64, offset: u64, ) -> Result<(Vec<u8>, bool), TrappableError<ErrorCode>>

Read from a descriptor, without using and updating the descriptor’s offset. Read more
Source§

fn write( &mut self, fd: Resource<Descriptor>, buf: Vec<u8>, offset: u64, ) -> Result<u64, TrappableError<ErrorCode>>

Write to a descriptor, without using and updating the descriptor’s offset. Read more
Source§

fn read_directory( &mut self, fd: Resource<Descriptor>, ) -> Result<Resource<ReaddirIterator>, TrappableError<ErrorCode>>

Read directory entries from a directory. Read more
Source§

fn sync( &mut self, fd: Resource<Descriptor>, ) -> Result<(), TrappableError<ErrorCode>>

Synchronize the data and metadata of a file to disk. Read more
Source§

fn create_directory_at( &mut self, fd: Resource<Descriptor>, path: String, ) -> Result<(), TrappableError<ErrorCode>>

Create a directory. Read more
Source§

fn stat( &mut self, fd: Resource<Descriptor>, ) -> Result<DescriptorStat, TrappableError<ErrorCode>>

Return the attributes of an open file or directory. Read more
Source§

fn stat_at( &mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, ) -> Result<DescriptorStat, TrappableError<ErrorCode>>

Return the attributes of a file or directory. Read more
Source§

fn set_times_at( &mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, atim: NewTimestamp, mtim: NewTimestamp, ) -> Result<(), TrappableError<ErrorCode>>

Adjust the timestamps of a file or directory. Read more
Create a hard link. Read more
Source§

fn open_at( &mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, oflags: OpenFlags, flags: DescriptorFlags, ) -> Result<Resource<Descriptor>, TrappableError<ErrorCode>>

Open a file or directory. Read more
Source§

fn drop(&mut self, fd: Resource<Descriptor>) -> Result<(), Error>

Read the contents of a symbolic link. Read more
Source§

fn remove_directory_at( &mut self, fd: Resource<Descriptor>, path: String, ) -> Result<(), TrappableError<ErrorCode>>

Remove a directory. Read more
Source§

fn rename_at( &mut self, fd: Resource<Descriptor>, old_path: String, new_fd: Resource<Descriptor>, new_path: String, ) -> Result<(), TrappableError<ErrorCode>>

Rename a filesystem object. Read more
Create a symbolic link (also known as a “symlink”). Read more
Unlink a filesystem object that is not a directory. Read more
Source§

fn read_via_stream( &mut self, fd: Resource<Descriptor>, offset: u64, ) -> Result<Resource<InputStream>, TrappableError<ErrorCode>>

Return a stream for reading from a file, if available. Read more
Source§

fn write_via_stream( &mut self, fd: Resource<Descriptor>, offset: u64, ) -> Result<Resource<Box<dyn HostOutputStream>>, TrappableError<ErrorCode>>

Return a stream for writing to a file, if available. Read more
Source§

fn append_via_stream( &mut self, fd: Resource<Descriptor>, ) -> Result<Resource<Box<dyn HostOutputStream>>, TrappableError<ErrorCode>>

Return a stream for appending to a file, if available. Read more
Source§

fn is_same_object( &mut self, a: Resource<Descriptor>, b: Resource<Descriptor>, ) -> Result<bool, Error>

Test whether two descriptors refer to the same filesystem object. Read more
Source§

fn metadata_hash( &mut self, fd: Resource<Descriptor>, ) -> Result<MetadataHashValue, TrappableError<ErrorCode>>

Return a hash of the metadata associated with a filesystem object referred to by a descriptor. Read more
Source§

fn metadata_hash_at( &mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, ) -> Result<MetadataHashValue, TrappableError<ErrorCode>>

Return a hash of the metadata associated with a filesystem object referred to by a directory descriptor and a relative path. Read more
Source§

impl<T> HostDescriptor for T
where T: WasiView,

Source§

fn advise<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, offset: u64, len: u64, advice: Advice, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Provide file advisory information on a descriptor. Read more
Source§

fn sync_data<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Synchronize the data of a file to disk. Read more
Source§

fn get_flags<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<DescriptorFlags, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Get flags associated with a descriptor. Read more
Source§

fn get_type<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<DescriptorType, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Get the dynamic type of a descriptor. Read more
Source§

fn set_size<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, size: u64, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Adjust the size of an open file. If this increases the file’s size, the extra bytes are filled with zeros. Read more
Source§

fn set_times<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, atim: NewTimestamp, mtim: NewTimestamp, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Adjust the timestamps of an open file or directory. Read more
Source§

fn read<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, len: u64, offset: u64, ) -> Pin<Box<dyn Future<Output = Result<(Vec<u8>, bool), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Read from a descriptor, without using and updating the descriptor’s offset. Read more
Source§

fn write<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, buf: Vec<u8>, offset: u64, ) -> Pin<Box<dyn Future<Output = Result<u64, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Write to a descriptor, without using and updating the descriptor’s offset. Read more
Source§

fn read_directory<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<Resource<ReaddirIterator>, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Read directory entries from a directory. Read more
Source§

fn sync<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Synchronize the data and metadata of a file to disk. Read more
Source§

fn create_directory_at<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, path: String, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Create a directory. Read more
Source§

fn stat<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<DescriptorStat, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Return the attributes of an open file or directory. Read more
Source§

fn stat_at<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, ) -> Pin<Box<dyn Future<Output = Result<DescriptorStat, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Return the attributes of a file or directory. Read more
Source§

fn set_times_at<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, atim: NewTimestamp, mtim: NewTimestamp, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Adjust the timestamps of a file or directory. Read more
Create a hard link. Read more
Source§

fn open_at<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, oflags: OpenFlags, flags: DescriptorFlags, ) -> Pin<Box<dyn Future<Output = Result<Resource<Descriptor>, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Open a file or directory. Read more
Source§

fn drop(&mut self, fd: Resource<Descriptor>) -> Result<(), Error>

Read the contents of a symbolic link. Read more
Source§

fn remove_directory_at<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, path: String, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Remove a directory. Read more
Source§

fn rename_at<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, old_path: String, new_fd: Resource<Descriptor>, new_path: String, ) -> Pin<Box<dyn Future<Output = Result<(), TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Rename a filesystem object. Read more
Create a symbolic link (also known as a “symlink”). Read more
Unlink a filesystem object that is not a directory. Read more
Source§

fn read_via_stream( &mut self, fd: Resource<Descriptor>, offset: u64, ) -> Result<Resource<InputStream>, TrappableError<ErrorCode>>

Return a stream for reading from a file, if available. Read more
Source§

fn write_via_stream( &mut self, fd: Resource<Descriptor>, offset: u64, ) -> Result<Resource<Box<dyn HostOutputStream>>, TrappableError<ErrorCode>>

Return a stream for writing to a file, if available. Read more
Source§

fn append_via_stream( &mut self, fd: Resource<Descriptor>, ) -> Result<Resource<Box<dyn HostOutputStream>>, TrappableError<ErrorCode>>

Return a stream for appending to a file, if available. Read more
Source§

fn is_same_object<'life0, 'async_trait>( &'life0 mut self, a: Resource<Descriptor>, b: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<bool, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Test whether two descriptors refer to the same filesystem object. Read more
Source§

fn metadata_hash<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, ) -> Pin<Box<dyn Future<Output = Result<MetadataHashValue, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Return a hash of the metadata associated with a filesystem object referred to by a descriptor. Read more
Source§

fn metadata_hash_at<'life0, 'async_trait>( &'life0 mut self, fd: Resource<Descriptor>, path_flags: PathFlags, path: String, ) -> Pin<Box<dyn Future<Output = Result<MetadataHashValue, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Return a hash of the metadata associated with a filesystem object referred to by a directory descriptor and a relative path. Read more
Source§

impl<T> HostDirectoryEntryStream for T

Source§

fn read_directory_entry( &mut self, stream: Resource<ReaddirIterator>, ) -> Result<Option<DirectoryEntry>, TrappableError<ErrorCode>>

Read a single directory entry from a directory-entry-stream.
Source§

fn drop(&mut self, stream: Resource<ReaddirIterator>) -> Result<(), Error>

Source§

impl<T> HostDirectoryEntryStream for T
where T: WasiView,

Source§

fn read_directory_entry<'life0, 'async_trait>( &'life0 mut self, stream: Resource<ReaddirIterator>, ) -> Pin<Box<dyn Future<Output = Result<Option<DirectoryEntry>, TrappableError<ErrorCode>>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Read a single directory entry from a directory-entry-stream.
Source§

fn drop(&mut self, stream: Resource<ReaddirIterator>) -> Result<(), Error>

Source§

impl<T> HostError for T
where T: WasiView,

Source§

fn drop(&mut self, err: Resource<Error>) -> Result<(), Error>

Source§

fn to_debug_string(&mut self, err: Resource<Error>) -> Result<String, Error>

Returns a string that is suitable to assist humans in debugging this error. Read more
Source§

impl<T> HostIncomingDatagramStream for T
where T: WasiView,

Source§

fn receive( &mut self, this: Resource<IncomingDatagramStream>, max_results: u64, ) -> Result<Vec<IncomingDatagram>, TrappableError<ErrorCode>>

Receive messages on the socket. Read more
Source§

fn subscribe( &mut self, this: Resource<IncomingDatagramStream>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the stream is ready to receive again. Read more
Source§

fn drop(&mut self, this: Resource<IncomingDatagramStream>) -> Result<(), Error>

Source§

impl<T> HostInputStream for T
where T: WasiView,

Source§

fn drop(&mut self, stream: Resource<InputStream>) -> Result<(), Error>

Source§

fn read( &mut self, stream: Resource<InputStream>, len: u64, ) -> Result<Vec<u8>, StreamError>

Perform a non-blocking read from the stream. Read more
Source§

fn blocking_read( &mut self, stream: Resource<InputStream>, len: u64, ) -> Result<Vec<u8>, StreamError>

Read bytes from a stream, after blocking until at least one byte can be read. Except for blocking, behavior is identical to read.
Source§

fn skip( &mut self, stream: Resource<InputStream>, len: u64, ) -> Result<u64, StreamError>

Skip bytes from a stream. Returns number of bytes skipped. Read more
Source§

fn blocking_skip( &mut self, stream: Resource<InputStream>, len: u64, ) -> Result<u64, StreamError>

Skip bytes from a stream, after blocking until at least one byte can be skipped. Except for blocking behavior, identical to skip.
Source§

fn subscribe( &mut self, stream: Resource<InputStream>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once either the specified stream has bytes available to read or the other end of the stream has been closed. The created pollable is a child resource of the input-stream. Implementations may trap if the input-stream is dropped before all derived pollables created with this function are dropped.
Source§

impl<T> HostInputStream for T
where T: WasiView,

Source§

fn drop(&mut self, stream: Resource<InputStream>) -> Result<(), Error>

Source§

fn read<'life0, 'async_trait>( &'life0 mut self, stream: Resource<InputStream>, len: u64, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Perform a non-blocking read from the stream. Read more
Source§

fn blocking_read<'life0, 'async_trait>( &'life0 mut self, stream: Resource<InputStream>, len: u64, ) -> Pin<Box<dyn Future<Output = Result<Vec<u8>, StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Read bytes from a stream, after blocking until at least one byte can be read. Except for blocking, behavior is identical to read.
Source§

fn skip<'life0, 'async_trait>( &'life0 mut self, stream: Resource<InputStream>, len: u64, ) -> Pin<Box<dyn Future<Output = Result<u64, StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Skip bytes from a stream. Returns number of bytes skipped. Read more
Source§

fn blocking_skip<'life0, 'async_trait>( &'life0 mut self, stream: Resource<InputStream>, len: u64, ) -> Pin<Box<dyn Future<Output = Result<u64, StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Skip bytes from a stream, after blocking until at least one byte can be skipped. Except for blocking behavior, identical to skip.
Source§

fn subscribe( &mut self, stream: Resource<InputStream>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once either the specified stream has bytes available to read or the other end of the stream has been closed. The created pollable is a child resource of the input-stream. Implementations may trap if the input-stream is dropped before all derived pollables created with this function are dropped.
Source§

impl<T> HostNetwork for T
where T: WasiView,

Source§

fn drop(&mut self, this: Resource<Network>) -> Result<(), Error>

Source§

impl<T> HostOutgoingDatagramStream for T
where T: WasiView,

Source§

fn check_send( &mut self, this: Resource<OutgoingDatagramStream>, ) -> Result<u64, TrappableError<ErrorCode>>

Check readiness for sending. This function never blocks. Read more
Source§

fn send( &mut self, this: Resource<OutgoingDatagramStream>, datagrams: Vec<OutgoingDatagram>, ) -> Result<u64, TrappableError<ErrorCode>>

Send messages on the socket. Read more
Source§

fn subscribe( &mut self, this: Resource<OutgoingDatagramStream>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the stream is ready to send again. Read more
Source§

fn drop(&mut self, this: Resource<OutgoingDatagramStream>) -> Result<(), Error>

Source§

impl<T> HostOutputStream for T
where T: WasiView,

Source§

fn drop( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<(), Error>

Source§

fn check_write( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<u64, StreamError>

Check readiness for writing. This function never blocks. Read more
Source§

fn write( &mut self, stream: Resource<Box<dyn HostOutputStream>>, bytes: Vec<u8>, ) -> Result<(), StreamError>

Perform a write. This function never blocks. Read more
Source§

fn blocking_write_and_flush( &mut self, stream: Resource<Box<dyn HostOutputStream>>, bytes: Vec<u8>, ) -> Result<(), StreamError>

Perform a write of up to 4096 bytes, and then flush the stream. Block until all of these operations are complete, or an error occurs. Read more
Source§

fn blocking_write_zeroes_and_flush( &mut self, stream: Resource<Box<dyn HostOutputStream>>, len: u64, ) -> Result<(), StreamError>

Perform a write of up to 4096 zeroes, and then flush the stream. Block until all of these operations are complete, or an error occurs. Read more
Source§

fn subscribe( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the output-stream is ready for more writing, or an error has occured. When this pollable is ready, check-write will return ok(n) with n>0, or an error. Read more
Source§

fn write_zeroes( &mut self, stream: Resource<Box<dyn HostOutputStream>>, len: u64, ) -> Result<(), StreamError>

Write zeroes to a stream. Read more
Source§

fn flush( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<(), StreamError>

Request to flush buffered output. This function never blocks. Read more
Source§

fn blocking_flush( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<(), StreamError>

Request to flush buffered output, and block until flush completes and stream is ready for writing again.
Source§

fn splice( &mut self, dst: Resource<Box<dyn HostOutputStream>>, src: Resource<InputStream>, len: u64, ) -> Result<u64, StreamError>

Read from one stream and write to another. Read more
Source§

fn blocking_splice( &mut self, dst: Resource<Box<dyn HostOutputStream>>, src: Resource<InputStream>, len: u64, ) -> Result<u64, StreamError>

Read from one stream and write to another, with blocking. Read more
Source§

impl<T> HostOutputStream for T
where T: WasiView,

Source§

fn drop( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<(), Error>

Source§

fn check_write( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<u64, StreamError>

Check readiness for writing. This function never blocks. Read more
Source§

fn write( &mut self, stream: Resource<Box<dyn HostOutputStream>>, bytes: Vec<u8>, ) -> Result<(), StreamError>

Perform a write. This function never blocks. Read more
Source§

fn subscribe( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the output-stream is ready for more writing, or an error has occured. When this pollable is ready, check-write will return ok(n) with n>0, or an error. Read more
Source§

fn blocking_write_and_flush<'life0, 'async_trait>( &'life0 mut self, stream: Resource<Box<dyn HostOutputStream>>, bytes: Vec<u8>, ) -> Pin<Box<dyn Future<Output = Result<(), StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Perform a write of up to 4096 bytes, and then flush the stream. Block until all of these operations are complete, or an error occurs. Read more
Source§

fn blocking_write_zeroes_and_flush<'life0, 'async_trait>( &'life0 mut self, stream: Resource<Box<dyn HostOutputStream>>, len: u64, ) -> Pin<Box<dyn Future<Output = Result<(), StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Perform a write of up to 4096 zeroes, and then flush the stream. Block until all of these operations are complete, or an error occurs. Read more
Source§

fn write_zeroes( &mut self, stream: Resource<Box<dyn HostOutputStream>>, len: u64, ) -> Result<(), StreamError>

Write zeroes to a stream. Read more
Source§

fn flush( &mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Result<(), StreamError>

Request to flush buffered output. This function never blocks. Read more
Source§

fn blocking_flush<'life0, 'async_trait>( &'life0 mut self, stream: Resource<Box<dyn HostOutputStream>>, ) -> Pin<Box<dyn Future<Output = Result<(), StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Request to flush buffered output, and block until flush completes and stream is ready for writing again.
Source§

fn splice<'life0, 'async_trait>( &'life0 mut self, dest: Resource<Box<dyn HostOutputStream>>, src: Resource<InputStream>, len: u64, ) -> Pin<Box<dyn Future<Output = Result<u64, StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Read from one stream and write to another. Read more
Source§

fn blocking_splice<'life0, 'async_trait>( &'life0 mut self, dest: Resource<Box<dyn HostOutputStream>>, src: Resource<InputStream>, len: u64, ) -> Pin<Box<dyn Future<Output = Result<u64, StreamError>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Read from one stream and write to another, with blocking. Read more
Source§

impl<T> HostPollable for T
where T: WasiView,

Source§

fn ready(&mut self, pollable: Resource<Pollable>) -> Result<bool, Error>

Return the readiness of a pollable. This function never blocks. Read more
Source§

fn block(&mut self, pollable: Resource<Pollable>) -> Result<(), Error>

block returns immediately if the pollable is ready, and otherwise blocks until ready. Read more
Source§

fn drop(&mut self, pollable: Resource<Pollable>) -> Result<(), Error>

Source§

impl<T> HostPollable for T
where T: WasiView,

Source§

fn block<'life0, 'async_trait>( &'life0 mut self, pollable: Resource<Pollable>, ) -> Pin<Box<dyn Future<Output = Result<(), Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

block returns immediately if the pollable is ready, and otherwise blocks until ready. Read more
Source§

fn ready<'life0, 'async_trait>( &'life0 mut self, pollable: Resource<Pollable>, ) -> Pin<Box<dyn Future<Output = Result<bool, Error>> + Send + 'async_trait>>
where 'life0: 'async_trait, T: 'async_trait,

Return the readiness of a pollable. This function never blocks. Read more
Source§

fn drop(&mut self, pollable: Resource<Pollable>) -> Result<(), Error>

Source§

impl<T> HostResolveAddressStream for T
where T: WasiView,

Source§

fn resolve_next_address( &mut self, resource: Resource<ResolveAddressStream>, ) -> Result<Option<IpAddress>, TrappableError<ErrorCode>>

Returns the next address from the resolver. Read more
Source§

fn subscribe( &mut self, resource: Resource<ResolveAddressStream>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the stream is ready for I/O. Read more
Source§

fn drop( &mut self, resource: Resource<ResolveAddressStream>, ) -> Result<(), Error>

Source§

impl<T> HostTcpSocket for T
where T: WasiView,

Source§

fn start_bind( &mut self, this: Resource<TcpSocket>, network: Resource<Network>, local_address: IpSocketAddress, ) -> Result<(), TrappableError<ErrorCode>>

Bind the socket to a specific network on the provided IP address and port. Read more
Source§

fn finish_bind( &mut self, this: Resource<TcpSocket>, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn start_connect( &mut self, this: Resource<TcpSocket>, network: Resource<Network>, remote_address: IpSocketAddress, ) -> Result<(), TrappableError<ErrorCode>>

Connect to a remote endpoint. Read more
Source§

fn finish_connect( &mut self, this: Resource<TcpSocket>, ) -> Result<(Resource<InputStream>, Resource<Box<dyn HostOutputStream>>), TrappableError<ErrorCode>>

Source§

fn start_listen( &mut self, this: Resource<TcpSocket>, ) -> Result<(), TrappableError<ErrorCode>>

Start listening for new connections. Read more
Source§

fn finish_listen( &mut self, this: Resource<TcpSocket>, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn accept( &mut self, this: Resource<TcpSocket>, ) -> Result<(Resource<TcpSocket>, Resource<InputStream>, Resource<Box<dyn HostOutputStream>>), TrappableError<ErrorCode>>

Accept a new client socket. Read more
Source§

fn local_address( &mut self, this: Resource<TcpSocket>, ) -> Result<IpSocketAddress, TrappableError<ErrorCode>>

Get the bound local address. Read more
Source§

fn remote_address( &mut self, this: Resource<TcpSocket>, ) -> Result<IpSocketAddress, TrappableError<ErrorCode>>

Get the remote address. Read more
Source§

fn is_listening(&mut self, this: Resource<TcpSocket>) -> Result<bool, Error>

Whether the socket is listening for new connections. Read more
Source§

fn address_family( &mut self, this: Resource<TcpSocket>, ) -> Result<IpAddressFamily, Error>

Whether this is a IPv4 or IPv6 socket. Read more
Source§

fn ipv6_only( &mut self, this: Resource<TcpSocket>, ) -> Result<bool, TrappableError<ErrorCode>>

Whether IPv4 compatibility (dual-stack) mode is disabled or not. Read more
Source§

fn set_ipv6_only( &mut self, this: Resource<TcpSocket>, value: bool, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn set_listen_backlog_size( &mut self, this: Resource<TcpSocket>, value: u64, ) -> Result<(), TrappableError<ErrorCode>>

Hints the desired listen queue size. Implementations are free to ignore this. Read more
Source§

fn keep_alive_enabled( &mut self, this: Resource<TcpSocket>, ) -> Result<bool, TrappableError<ErrorCode>>

Enables or disables keepalive. Read more
Source§

fn set_keep_alive_enabled( &mut self, this: Resource<TcpSocket>, value: bool, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn keep_alive_idle_time( &mut self, this: Resource<TcpSocket>, ) -> Result<u64, TrappableError<ErrorCode>>

Amount of time the connection has to be idle before TCP starts sending keepalive packets. Read more
Source§

fn set_keep_alive_idle_time( &mut self, this: Resource<TcpSocket>, value: u64, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn keep_alive_interval( &mut self, this: Resource<TcpSocket>, ) -> Result<u64, TrappableError<ErrorCode>>

The time between keepalive packets. Read more
Source§

fn set_keep_alive_interval( &mut self, this: Resource<TcpSocket>, value: u64, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn keep_alive_count( &mut self, this: Resource<TcpSocket>, ) -> Result<u32, TrappableError<ErrorCode>>

The maximum amount of keepalive packets TCP should send before aborting the connection. Read more
Source§

fn set_keep_alive_count( &mut self, this: Resource<TcpSocket>, value: u32, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn hop_limit( &mut self, this: Resource<TcpSocket>, ) -> Result<u8, TrappableError<ErrorCode>>

Equivalent to the IP_TTL & IPV6_UNICAST_HOPS socket options. Read more
Source§

fn set_hop_limit( &mut self, this: Resource<TcpSocket>, value: u8, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn receive_buffer_size( &mut self, this: Resource<TcpSocket>, ) -> Result<u64, TrappableError<ErrorCode>>

The kernel buffer space reserved for sends/receives on this socket. Read more
Source§

fn set_receive_buffer_size( &mut self, this: Resource<TcpSocket>, value: u64, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn send_buffer_size( &mut self, this: Resource<TcpSocket>, ) -> Result<u64, TrappableError<ErrorCode>>

Source§

fn set_send_buffer_size( &mut self, this: Resource<TcpSocket>, value: u64, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn subscribe( &mut self, this: Resource<TcpSocket>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the socket is ready for I/O. Read more
Source§

fn shutdown( &mut self, this: Resource<TcpSocket>, shutdown_type: ShutdownType, ) -> Result<(), TrappableError<ErrorCode>>

Initiate a graceful shutdown. Read more
Source§

fn drop(&mut self, this: Resource<TcpSocket>) -> Result<(), Error>

Source§

impl<T> HostTerminalInput for T
where T: WasiView,

Source§

impl<T> HostTerminalOutput for T
where T: WasiView,

Source§

impl<T> HostUdpSocket for T
where T: WasiView,

Source§

fn start_bind( &mut self, this: Resource<UdpSocket>, network: Resource<Network>, local_address: IpSocketAddress, ) -> Result<(), TrappableError<ErrorCode>>

Bind the socket to a specific network on the provided IP address and port. Read more
Source§

fn finish_bind( &mut self, this: Resource<UdpSocket>, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn stream( &mut self, this: Resource<UdpSocket>, remote_address: Option<IpSocketAddress>, ) -> Result<(Resource<IncomingDatagramStream>, Resource<OutgoingDatagramStream>), TrappableError<ErrorCode>>

Set up inbound & outbound communication channels, optionally to a specific peer. Read more
Source§

fn local_address( &mut self, this: Resource<UdpSocket>, ) -> Result<IpSocketAddress, TrappableError<ErrorCode>>

Get the current bound address. Read more
Source§

fn remote_address( &mut self, this: Resource<UdpSocket>, ) -> Result<IpSocketAddress, TrappableError<ErrorCode>>

Get the address the socket is currently streaming to. Read more
Source§

fn address_family( &mut self, this: Resource<UdpSocket>, ) -> Result<IpAddressFamily, Error>

Whether this is a IPv4 or IPv6 socket. Read more
Source§

fn ipv6_only( &mut self, this: Resource<UdpSocket>, ) -> Result<bool, TrappableError<ErrorCode>>

Whether IPv4 compatibility (dual-stack) mode is disabled or not. Read more
Source§

fn set_ipv6_only( &mut self, this: Resource<UdpSocket>, value: bool, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn unicast_hop_limit( &mut self, this: Resource<UdpSocket>, ) -> Result<u8, TrappableError<ErrorCode>>

Equivalent to the IP_TTL & IPV6_UNICAST_HOPS socket options. Read more
Source§

fn set_unicast_hop_limit( &mut self, this: Resource<UdpSocket>, value: u8, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn receive_buffer_size( &mut self, this: Resource<UdpSocket>, ) -> Result<u64, TrappableError<ErrorCode>>

The kernel buffer space reserved for sends/receives on this socket. Read more
Source§

fn set_receive_buffer_size( &mut self, this: Resource<UdpSocket>, value: u64, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn send_buffer_size( &mut self, this: Resource<UdpSocket>, ) -> Result<u64, TrappableError<ErrorCode>>

Source§

fn set_send_buffer_size( &mut self, this: Resource<UdpSocket>, value: u64, ) -> Result<(), TrappableError<ErrorCode>>

Source§

fn subscribe( &mut self, this: Resource<UdpSocket>, ) -> Result<Resource<Pollable>, Error>

Create a pollable which will resolve once the socket is ready for I/O. Read more
Source§

fn drop(&mut self, this: Resource<UdpSocket>) -> Result<(), Error>

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> Pointable for T

Source§

const ALIGN: usize

The alignment of pointer.
Source§

type Init = T

The type for initializers.
Source§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
Source§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
Source§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
Source§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T> Pointee for T

Source§

type Pointer = u32

Source§

fn debug( pointer: <T as Pointee>::Pointer, f: &mut Formatter<'_>, ) -> Result<(), Error>

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

Source§

fn vzip(self) -> V

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> Host for T
where T: WasiView,

Source§

impl<T> MaybeSendSync for T