Struct pwner::tokio::Process

pub struct Process(_, _);

An implementation of Process that uses tokio::process as the launcher.

All read and write operations are async.

Note: On *nix platforms, the owned process will have 2 seconds between signals, which is run in a spawned task.

Panics

When, on *nix platforms, a process gets dropped without a runtime.

Implementations

impl Process

pub fn read_from(&mut self, read_source: ReadSource) -> &mut Self

Choose which pipe to read form next.

Examples

Basic usage:

use tokio::io::AsyncReadExt;
use tokio::process::Command;
use pwner::Spawner;
use pwner::tokio::ReadSource;

let mut child = Command::new("ls").spawn_owned().unwrap();
let mut buffer = [0_u8; 1024];

child.read_from(ReadSource::Both).read(&mut buffer).await.unwrap();

pub fn decompose(
    &mut self
) -> (&mut ChildStdin, &mut ChildStdout, &mut ChildStderr)

Decomposes the handle into mutable references to the pipes.

Examples

Basic usage:

use tokio::io::{ AsyncReadExt, AsyncWriteExt };
use tokio::process::Command;
use pwner::Spawner;

let mut child = Command::new("cat").spawn_owned().unwrap();
let mut buffer = [0_u8; 1024];
let (stdin, stdout, _) = child.decompose();

stdin.write_all(b"hello\n").await.unwrap();
stdout.read(&mut buffer).await.unwrap();

Trait Implementations

impl AsyncRead for Process

fn poll_read(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &mut ReadBuf<'_>
) -> Poll<Result<()>>

Attempts to read from the AsyncRead into buf.

impl AsyncWrite for Process

fn poll_write(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &[u8]
) -> Poll<Result<usize>>

Attempt to write bytes from buf into the object.

fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>

Attempts to flush the object, ensuring that any buffered data reach their destination.

fn poll_shutdown(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<Result<()>>

Initiates or attempts to shut down this writer, returning success when the I/O connection has completely shut down.

impl Drop for Process

fn drop(&mut self)

Executes the destructor for this type.

impl Process for Process

#[must_use]fn id(&self) -> Option<u32>

Returns the OS-assigned process identifier associated with this child.

Examples

Basic usage:

use tokio::process::Command;
use pwner::{ Spawner, Process };

let mut command = Command::new("ls");
if let Ok(child) = command.spawn_owned() {
    match child.id() {
      Some(pid) => println!("Child's ID is {}", pid),
      None => println!("Child has already exited"),
    }
} else {
    println!("ls command didn't start");
}