History

jokemanfire a345bac309 OpenOptions in blocking mod is a time-consuming operation. 1.Prevent it from blocking a tokio thread. Change sync to async. 2.Add pipe unit test which I found error in Pipe new. Signed-off-by: jokemanfire <hu.dingyang@zte.com.cn>		2025-01-09 02:57:43 +00:00
..
src	OpenOptions in blocking mod is a time-consuming operation.	2025-01-09 02:57:43 +00:00
Cargo.toml	runc/Cargo: add the missing os_pipe dependency	2024-12-03 17:58:52 +00:00
README.md	chore: Fix whitespace	2024-07-30 16:54:34 +00:00

README.md

Rust bindings for runc CLI

A crate for consuming the runc binary in your Rust applications, similar to go-runc for Go. This crate is based on archived rust-runc.

Usage

Both sync/async version is available. You can build runc client with RuncConfig in method chaining style. Call build() or build_async() to get client. Note that async client depends on tokio, then please use it on tokio runtime.

#[tokio::main]
async fn main() {
    let config = runc::GlobalOpts::new()
        .root("./new_root")
        .debug(false)
        .log("/path/to/logfile.json")
        .log_format(runc::LogFormat::Json)
        .rootless(true);

    let client = config.build_async().unwrap();

    let opts = runc::options::CreateOpts::new()
        .pid_file("/path/to/pid/file")
        .no_pivot(true);

    client.create("container-id", "path/to/bundle", Some(&opts)).unwrap();
}

Limitations

Supported commands are only:
- create
- start
- state
- kill
- delete
Exec is not available in RuncAsyncClient now.
Console utilites are not available
- see Go version