Module files 

Re-exports

use std::any::Any; 🔒

use std::collections::BTreeMap; 🔒

use std::convert::BoundedCastFromInt; 🔒 Experimental

use std::fs::Dir; 🔒 Experimental

use std::fs::File; 🔒

use std::io::ErrorKind; 🔒

use std::io::IsTerminal; 🔒

use std::io::Read; 🔒

use std::io::Seek; 🔒

use std::io::SeekFrom; 🔒

use std::io::Write; 🔒

use std::marker::CoercePointee; 🔒 Experimental

use std::ops::Deref; 🔒

use std::rc::Rc; 🔒

use std::rc::Weak; 🔒

use std::fs; 🔒

use std::io; 🔒

use rustc_abi::Size; 🔒

use crate::shims::unix::UnixFileDescription; 🔒

use crate::*; 🔒

Structs

DirHandle

FdId

A unique id for file descriptions. While we could use the address, considering that is definitely unique, the address would expose interpreter internal state when used for sorting things. So instead we generate a unique id per file description which is the same for all duplicates and is never reused.

FdIdWith 🔒

FdTable

The file descriptor table

FileDescriptionRef

A refcounted pointer to a file description, also tracking the globally unique ID of this file description.

FileHandle

NullOutput

Like /dev/null

Stderr

Stdin

Stdout

WeakFileDescriptionRef

Holds a weak reference to the actual file description.

Constants

BIG_ACCESS

Accesses this large have a higher chance of being shortened. We use twice the usual page size, which means the shortened access is at least a page.

FD_LIMIT

The maximum number of open FDs.

Traits

EvalContextExt

FileDescription

Represents an open file description.

FileDescriptionExt

A helper trait to indirectly allow downcasting on Rc<FdIdWith<dyn _>>. Ideally we’d just add a FdIdWith<Self>: Any bound to the FileDescription trait, but that does not allow upcasting.

Functions

open_file_or_dir

Open something for which we don’t know ahead of time whether it is a file or a directory.

Type Aliases

DynFileDescriptionRef

FdNum

Internal type of a file-descriptor - this is what FdTable expects

WeakDynFileDescriptionRef