1 //! Platform-specific extensions to `std` for the WebAssembly System Interface (WASI).
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.
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.
15 //! use std::fs::File;
16 //! use std::os::wasi::prelude::*;
18 //! fn main() -> std::io::Result<()> {
19 //! let f = File::create("foo.txt")?;
20 //! let fd = f.as_raw_fd();
22 //! // use fd with native WASI bindings
28 //! [`OsStr`]: crate::ffi::OsStr
29 //! [`OsString`]: crate::ffi::OsString
31 #![stable(feature = "rust1", since = "1.0.0")]
32 #![deny(unsafe_op_in_unsafe_fn)]
33 #![doc(cfg(target_os = "wasi"))]
40 /// A prelude for conveniently writing platform-specific code.
42 /// Includes all extension traits, and some important type definitions.
43 #[stable(feature = "rust1", since = "1.0.0")]
46 #[stable(feature = "rust1", since = "1.0.0")]
47 pub use super::ffi::{OsStrExt, OsStringExt};
49 #[stable(feature = "rust1", since = "1.0.0")]
50 pub use super::fs::FileTypeExt;
52 #[stable(feature = "rust1", since = "1.0.0")]
53 pub use super::fs::{DirEntryExt, FileExt, MetadataExt, OpenOptionsExt};
55 #[stable(feature = "rust1", since = "1.0.0")]
56 pub use super::io::{AsFd, AsRawFd, BorrowedFd, FromRawFd, IntoRawFd, OwnedFd, RawFd};