Struct FileDescriptorTable 

pub struct FileDescriptorTable { /* private fields */ }

File descriptor table for managing open file descriptors

Implementations

impl FileDescriptorTable

pub fn new() -> Self

Create a new empty file descriptor table

pub fn open_fd( &mut self, fd_num: i32, path: &str, read: bool, write: bool, append: bool, truncate: bool, create_new: bool, ) -> Result<(), String>

Open a file and assign it to a file descriptor number

Arguments

• fd_num - The file descriptor number (0-9)
• path - Path to the file to open
• read - Whether to open for reading
• write - Whether to open for writing
• append - Whether to open in append mode
• truncate - Whether to truncate the file

Returns

• Ok(()) on success
• Err(String) with error message on failure

pub fn duplicate_fd( &mut self, source_fd: i32, target_fd: i32, ) -> Result<(), String>

Duplicate a file descriptor

Arguments

• source_fd - The source file descriptor to duplicate
• target_fd - The target file descriptor number

Returns

• Ok(()) on success
• Err(String) with error message on failure

pub fn close_fd(&mut self, fd_num: i32) -> Result<(), String>

Close a file descriptor

Arguments

• fd_num - The file descriptor number to close

Returns

• Ok(()) on success
• Err(String) with error message on failure

pub fn save_fd(&mut self, fd_num: i32) -> Result<(), String>

Save the current state of a file descriptor for later restoration

Arguments

• fd_num - The file descriptor number to save

Returns

• Ok(()) on success
• Err(String) with error message on failure

pub fn restore_fd(&mut self, fd_num: i32) -> Result<(), String>

Restore a previously saved file descriptor

Arguments

• fd_num - The file descriptor number to restore

Returns

• Ok(()) on success
• Err(String) with error message on failure

pub fn deep_clone(&self) -> Result<Self, String>

Create a deep copy of the file descriptor table This duplicates all open file descriptors so they are independent of the original table

pub fn save_all_fds(&mut self) -> Result<(), String>

Save all currently open file descriptors

Returns

• Ok(()) on success
• Err(String) with error message on failure

pub fn restore_all_fds(&mut self) -> Result<(), String>

Restore all previously saved file descriptors

Returns

• Ok(()) on success
• Err(String) with error message on failure

pub fn get_stdio(&self, fd_num: i32) -> Option<Stdio>

Get a file handle for a given file descriptor number

Arguments

• fd_num - The file descriptor number

Returns

• Some(Stdio) if the fd is open and can be converted to Stdio
• None if the fd is not open or is closed

pub fn get_raw_fd(&self, fd_num: i32) -> Option<RawFd>

Get the raw file descriptor number for a given fd

Arguments

• fd_num - The file descriptor number

Returns

• Some(RawFd) if the fd is open
• None if the fd is not open or is closed

pub fn is_open(&self, fd_num: i32) -> bool

Check if a file descriptor is open

Arguments

• fd_num - The file descriptor number

Returns

• true if the fd is open
• false if the fd is closed or not tracked

pub fn is_closed(&self, fd_num: i32) -> bool

Check if a file descriptor is closed

Arguments

• fd_num - The file descriptor number

Returns

• true if the fd is explicitly closed
• false otherwise

pub fn clear(&mut self)

Clear all file descriptors and saved state

Trait Implementations

impl Debug for FileDescriptorTable

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

Formats the value using the given formatter.

impl Default for FileDescriptorTable

fn default() -> Self

Creates the default FileDescriptorTable.

Examples

use rush_sh::state::FileDescriptorTable;
let table = FileDescriptorTable::default();