1 //! Platform-specific extensions to `std` for the WebAssembly System Interface (WASI). 2 //! 3 //! Provides access to platform-level information on WASI, and exposes 4 //! WASI-specific functions that would otherwise be inappropriate as 5 //! part of the core `std` library. 6 //! 7 //! It exposes more ways to deal with platform-specific strings (`OsStr`, 8 //! `OsString`), allows to set permissions more granularly, extract low-level 9 //! file descriptors from files and sockets, and has platform-specific helpers 10 //! for spawning processes. 11 //! 12 //! # Examples 13 //! 14 //! ```no_run 15 //! use std::fs::File; 16 //! use std::os::wasi::prelude::*; 17 //! 18 //! fn main() -> std::io::Result<()> { 19 //! let f = File::create("foo.txt")?; 20 //! let fd = f.as_raw_fd(); 21 //! 22 //! // use fd with native WASI bindings 23 //! 24 //! Ok(()) 25 //! } 26 //! ``` 27 //! 28 //! [`OsStr`]: crate::ffi::OsStr 29 //! [`OsString`]: crate::ffi::OsString 30 31 #![stable(feature = "rust1", since = "1.0.0")] 32 #![deny(unsafe_op_in_unsafe_fn)] 33 #![doc(cfg(target_os = "wasi"))] 34 35 pub mod ffi; 36 pub mod fs; 37 pub mod io; 38 pub mod net; 39 40 /// A prelude for conveniently writing platform-specific code. 41 /// 42 /// Includes all extension traits, and some important type definitions. 43 #[stable(feature = "rust1", since = "1.0.0")] 44 pub mod prelude { 45 #[doc(no_inline)] 46 #[stable(feature = "rust1", since = "1.0.0")] 47 pub use super::ffi::{OsStrExt, OsStringExt}; 48 #[doc(no_inline)] 49 #[stable(feature = "rust1", since = "1.0.0")] 50 pub use super::fs::FileTypeExt; 51 #[doc(no_inline)] 52 #[stable(feature = "rust1", since = "1.0.0")] 53 pub use super::fs::{DirEntryExt, FileExt, MetadataExt, OpenOptionsExt}; 54 #[doc(no_inline)] 55 #[stable(feature = "rust1", since = "1.0.0")] 56 pub use super::io::{AsFd, AsRawFd, BorrowedFd, FromRawFd, IntoRawFd, OwnedFd, RawFd}; 57 } 58