Struct Terminal 

pub(crate) struct Terminal {
    path: TempFile,
    connected_rx: Receiver<OwnedFd>,
    resizer: TerminalResizer,
}

The terminal of a process, which the runtime passes over a console socket.

Fields

path: TempFile

The socket the runtime connects to, removed with the terminal.

connected_rx: Receiver<OwnedFd>

resizer: TerminalResizer

Implementations

impl Terminal

pub(crate) fn path(&self) -> &Path

The console socket the runtime connects to.

pub(crate) fn resizer(&self) -> TerminalResizer

Resizes the terminal also while something else holds it, like the runtime call which waits for the connection.

fn tty(&self) -> Option<Arc<TerminalFd>>

The terminal while it is connected and open.

impl Terminal

pub(crate) fn new() -> Result<Self>

Setup a new terminal instance.

pub(crate) async fn connect(&mut self) -> Result<TerminalIo>

Wait for the runtime to hand over the terminal, for the loops which read and write it, see ContainerIO::connect_terminal. A wait which gets dropped leaves the descriptor queued for the next one. The terminal gets the size requested before, see TerminalResizer::resize.

pub(crate) fn eof_char(&self) -> u8

The end of file character of the terminal, ^D unless the process changed it.

pub(crate) fn resize(&self, width: u16, height: u16) -> Result<()>

Resize the terminal width and height, see TerminalResizer::resize.

async fn listen(listener: UnixListener, config: Config) -> Result<()>

Accept the connection of the runtime and receive the terminal from it. The runtime never connects or never sends the descriptor if it fails early. The terminal gets dropped then, which closes the channel, so do not keep the listener around forever.

async fn accept(listener: UnixListener, config: Config) -> Result<()>

async fn handle_fd_receive(stream: UnixStream, config: Config) -> Result<()>

fn recv_fd(socket: BorrowedFd<'_>) -> Result<Option<OwnedFd>>

Receive the descriptor of the terminal. It gets close-on-exec right away, the runtimes which other threads spawn meanwhile would inherit the terminal of the container otherwise.

Trait Implementations

impl Debug for Terminal

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

Formats the value using the given formatter.