Struct ExecSession 

pub struct ExecSession { /* private fields */ }

An active exec session handle for sending input to a running process.

Output reading is handled by a background task that sends events via the mpsc channel provided at spawn time.

Implementations

impl ExecSession

pub fn spawn( id: u32, req: &ExecRequest, tx: UnboundedSender<(u32, SessionOutput)>, default_user: Option<&str>, security_profile: SecurityProfile, ) -> AgentdResult<Self>

Spawns a new exec session.

If req.tty is true, uses a PTY. Otherwise, uses piped stdin/stdout/stderr. A background task is spawned to read output and send events via tx.

pub fn pid(&self) -> u32

Returns the PID of the spawned process (as u32 for the protocol).

pub async fn write_stdin(&self, data: &[u8]) -> AgentdResult<()>

Writes data to the process’s stdin (or PTY master).

pub fn resize(&self, rows: u16, cols: u16) -> AgentdResult<()>

Resizes the PTY (only applicable for TTY sessions).

pub fn send_signal(&self, signum: i32) -> AgentdResult<()>

Sends a signal to the spawned process and everything it started.

The child is made a session leader at spawn (both pipe and PTY modes), so signalling the negative pid reaches its whole process group. A bare kill(pid) here leaked orphans: killing sh -c "job &" took out the shell while its backgrounded children survived reparented to init, silently accumulating load in the guest.

pub fn close_stdin(&mut self)

Closes the process’s stdin.

For pipe mode, drops the ChildStdin handle which closes the fd. For PTY mode, this is a no-op (the PTY master stays open for output).

Trait Implementations

impl Debug for ExecSession

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

Formats the value using the given formatter.

impl Drop for ExecSession

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.