Struct RealSystem 

pub struct RealSystem(/* private fields */);

Implementation of System that actually interacts with the system.

RealSystem is an empty struct because the underlying operating system manages the system’s internal state.

Implementations

impl RealSystem

pub unsafe fn new() -> Self

Returns an instance of RealSystem.

Safety

This function is marked unsafe because improper use of RealSystem may lead to undefined behavior. Remember that most operations performed on the system by Env are not thread-safe. You should never use RealSystem in a multi-threaded program, and it is your responsibility to make sure you are using only one instance of ReadSystem in the process.

Trait Implementations

impl Debug for RealSystem

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

Formats the value using the given formatter.

impl System for RealSystem

fn times(&self) -> Result<Times>

Returns consumed CPU times.

This function actually uses getrusage rather than times because it provides better resolution on many systems.

fn new_child_process(&mut self) -> Result<ChildProcessStarter>

Creates a new child process.

This implementation calls the fork system call and returns both in the parent and child process. In the parent, the returned ChildProcessStarter ignores any arguments and returns the child process ID. In the child, the starter runs the task and exits the process.

fn shell_path(&self) -> CString

Returns the path to the shell.

On Linux, this function returns /proc/self/exe. On other platforms, it searches for an executable sh from the default PATH returned by confstr_path.

fn fstat(&self, fd: Fd) -> Result<Stat>

Retrieves metadata of a file.

fn fstatat( &self, dir_fd: Fd, path: &CStr, follow_symlinks: bool, ) -> Result<Stat>

Retrieves metadata of a file.

fn is_executable_file(&self, path: &CStr) -> bool

Whether there is an executable file at the specified path.

fn is_directory(&self, path: &CStr) -> bool

Whether there is a directory at the specified path.

fn pipe(&mut self) -> Result<(Fd, Fd)>

Creates an unnamed pipe.

fn dup(&mut self, from: Fd, to_min: Fd, flags: EnumSet<FdFlag>) -> Result<Fd>

Duplicates a file descriptor.

fn dup2(&mut self, from: Fd, to: Fd) -> Result<Fd>

Duplicates a file descriptor.

fn open( &mut self, path: &CStr, access: OfdAccess, flags: EnumSet<OpenFlag>, mode: Mode, ) -> Result<Fd>

Opens a file descriptor.

fn open_tmpfile(&mut self, parent_dir: &Path) -> Result<Fd>

Opens a file descriptor associated with an anonymous temporary file.

fn close(&mut self, fd: Fd) -> Result<()>

Closes a file descriptor.

fn ofd_access(&self, fd: Fd) -> Result<OfdAccess>

Returns the open file description access mode.

fn get_and_set_nonblocking(&mut self, fd: Fd, nonblocking: bool) -> Result<bool>

Gets and sets the non-blocking mode for the open file description.

fn fcntl_getfd(&self, fd: Fd) -> Result<EnumSet<FdFlag>>

Returns the attributes for the file descriptor.

fn fcntl_setfd(&mut self, fd: Fd, flags: EnumSet<FdFlag>) -> Result<()>

Sets attributes for the file descriptor.

fn isatty(&self, fd: Fd) -> bool

Tests if a file descriptor is associated with a terminal device.

fn read(&mut self, fd: Fd, buffer: &mut [u8]) -> Result<usize>

Reads from the file descriptor.

fn write(&mut self, fd: Fd, buffer: &[u8]) -> Result<usize>

Writes to the file descriptor.

fn lseek(&mut self, fd: Fd, position: SeekFrom) -> Result<u64>

Moves the position of the open file description.

fn fdopendir(&mut self, fd: Fd) -> Result<Box<dyn Dir>>

Opens a directory for enumerating entries.

fn opendir(&mut self, path: &CStr) -> Result<Box<dyn Dir>>

Opens a directory for enumerating entries.

fn umask(&mut self, new_mask: Mode) -> Mode

Gets and sets the file creation mode mask.

fn now(&self) -> Instant

Returns the current time.

fn validate_signal(&self, number: RawNumber) -> Option<(Name, Number)>

Tests if a signal number is valid.

fn signal_number_from_name(&self, name: Name) -> Option<Number>

Gets the signal number from the signal name.

fn sigmask( &mut self, op: Option<(SigmaskOp, &[Number])>, old_mask: Option<&mut Vec<Number>>, ) -> Result<()>

Gets and/or sets the signal blocking mask.

fn get_sigaction(&self, signal: Number) -> Result<Disposition>

Gets the disposition for a signal.

fn sigaction( &mut self, signal: Number, handling: Disposition, ) -> Result<Disposition>

Gets and sets the disposition for a signal.

fn caught_signals(&mut self) -> Vec<Number>

Returns signals this process has caught, if any.

fn kill( &mut self, target: Pid, signal: Option<Number>, ) -> FlexFuture<Result<()>>

Sends a signal.

fn raise(&mut self, signal: Number) -> FlexFuture<Result<()>>

Sends a signal to the current process.

fn select( &mut self, readers: &mut Vec<Fd>, writers: &mut Vec<Fd>, timeout: Option<Duration>, signal_mask: Option<&[Number]>, ) -> Result<c_int>

Waits for a next event.

fn getsid(&self, pid: Pid) -> Result<Pid>

Returns the session ID of the specified process.

fn getpid(&self) -> Pid

Returns the process ID of the current process.

fn getppid(&self) -> Pid

Returns the process ID of the parent process.

fn getpgrp(&self) -> Pid

Returns the process group ID of the current process.

fn setpgid(&mut self, pid: Pid, pgid: Pid) -> Result<()>

Modifies the process group ID of a process.

fn tcgetpgrp(&self, fd: Fd) -> Result<Pid>

Returns the current foreground process group ID.

fn tcsetpgrp(&mut self, fd: Fd, pgid: Pid) -> Result<()>

Switches the foreground process group.

fn wait(&mut self, target: Pid) -> Result<Option<(Pid, ProcessState)>>

Reports updated status of a child process.

fn execve( &mut self, path: &CStr, args: &[CString], envs: &[CString], ) -> FlexFuture<Result<Infallible>>

Replaces the current process with an external utility.

fn exit(&mut self, exit_status: ExitStatus) -> FlexFuture<Infallible>

Terminates the current process.

fn getcwd(&self) -> Result<PathBuf>

Returns the current working directory path.

fn chdir(&mut self, path: &CStr) -> Result<()>

Changes the working directory.

fn getuid(&self) -> Uid

Returns the real user ID of the current process.

fn geteuid(&self) -> Uid

Returns the effective user ID of the current process.

fn getgid(&self) -> Gid

Returns the real group ID of the current process.

fn getegid(&self) -> Gid

Returns the effective group ID of the current process.

fn getpwnam_dir(&self, name: &CStr) -> Result<Option<PathBuf>>

Returns the home directory path of the given user.

fn confstr_path(&self) -> Result<UnixString>

Returns the standard $PATH value where all standard utilities are expected to be found.

fn getrlimit(&self, resource: Resource) -> Result<LimitPair>

Returns the limits for the specified resource.

fn setrlimit(&mut self, resource: Resource, limits: LimitPair) -> Result<()>

Sets the limits for the specified resource.