Struct wasi_common::OsOther

pub struct OsOther { /* fields omitted */ }

OsOther is something of a catch-all for everything not covered with the specific handle types (OsFile, OsDir, Stdio). It currently encapsulates handles such as OS pipes, sockets, streams, etc. As such, when redirecting stdio within WasiCtxBuilder, the redirected pipe should be encapsulated within this instance and not OsFile which represents a regular OS file.

Constructing OsOther

OsOther can currently only be constructed from std::fs::File using the std::convert::TryFrom trait:

use std::fs::OpenOptions;
use std::convert::TryFrom;
use wasi_common::OsOther;

let pipe = OpenOptions::new().read(true).open("a_pipe").unwrap();
let os_other = OsOther::try_from(pipe).unwrap();

Trait Implementations

impl Debug for OsOther

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for OsOther

type Target = RawOsHandle

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Handle for OsOther

fn as_any(&self) -> &dyn Any

fn try_clone(&self) -> Result<Box<dyn Handle>>

fn get_file_type(&self) -> Filetype

fn get_rights(&self) -> HandleRights

fn set_rights(&self, new_rights: HandleRights)

fn fdstat_get(&self) -> Result<Fdflags>

fn fdstat_set_flags(&self, fdflags: Fdflags) -> Result<()>

fn read_vectored(&self, iovs: &mut [IoSliceMut<'_>]) -> Result<usize>

fn write_vectored(&self, iovs: &[IoSlice<'_>]) -> Result<usize>

fn is_directory(&self) -> bool

fn is_tty(&self) -> bool

Test whether this descriptor is considered a tty within WASI. Note that since WASI itself lacks an isatty syscall and relies on a conservative approximation, we use the same approximation here.

fn advise(
    &self,
    _advice: Advice,
    _offset: Filesize,
    _len: Filesize
) -> Result<()>

fn allocate(&self, _offset: Filesize, _len: Filesize) -> Result<()>

fn datasync(&self) -> Result<()>

fn filestat_get(&self) -> Result<Filestat>

fn filestat_set_size(&self, _st_size: Filesize) -> Result<()>

fn filestat_set_times(
    &self,
    _atim: Timestamp,
    _mtim: Timestamp,
    _fst_flags: Fstflags
) -> Result<()>

fn preadv(&self, _buf: &mut [IoSliceMut<'_>], _offset: u64) -> Result<usize>

fn pwritev(&self, _buf: &[IoSlice<'_>], _offset: u64) -> Result<usize>

fn readdir<'a>(
    &'a self,
    _cookie: Dircookie
) -> Result<Box<dyn Iterator<Item = Result<(Dirent, String)>> + 'a>>

fn seek(&self, _offset: SeekFrom) -> Result<u64>

fn sync(&self) -> Result<()>

fn create_directory(&self, _path: &str) -> Result<()>

fn filestat_get_at(&self, _path: &str, _follow: bool) -> Result<Filestat>

fn filestat_set_times_at(
    &self,
    _path: &str,
    _atim: Timestamp,
    _mtim: Timestamp,
    _fst_flags: Fstflags,
    _follow: bool
) -> Result<()>

fn openat(
    &self,
    _path: &str,
    _read: bool,
    _write: bool,
    _oflags: Oflags,
    _fd_flags: Fdflags
) -> Result<Box<dyn Handle>>

fn link(
    &self,
    _old_path: &str,
    _new_handle: Box<dyn Handle>,
    _new_path: &str,
    _follow: bool
) -> Result<()>

fn readlink(&self, _path: &str, _buf: &mut [u8]) -> Result<usize>

fn readlinkat(&self, _path: &str) -> Result<String>

fn remove_directory(&self, _path: &str) -> Result<()>

fn rename(
    &self,
    _old_path: &str,
    _new_handle: Box<dyn Handle>,
    _new_path: &str
) -> Result<()>

fn symlink(&self, _old_path: &str, _new_path: &str) -> Result<()>

fn unlink_file(&self, _path: &str) -> Result<()>

impl TryFrom<File> for OsOther

type Error = Error

The type returned in the event of a conversion error.

fn try_from(file: File) -> Result<Self>

Performs the conversion.