Struct Ctx 

pub struct Ctx {
    pub config: Config,
    pub root: Arc<View>,
    pub cache: Arc<DirCache>,
    pub mem: Mem,
    pub procs: Arc<ProcTable>,
    pub no_ptrace: bool,
    pub mailbox: Option<i32>,
    nested: AtomicBool,
}

Everything handlers need, shared read-mostly between all threads.

Fields

config: Config

root: Arc<View>

The view of the first tracee, and of every process without one of its own.

cache: Arc<DirCache>

Directory cache shared by every view.

mem: Mem

procs: Arc<ProcTable>

Per-process bookkeeping, shared with fs for /proc magic links.

no_ptrace: bool

True when running without ptrace: the former ptrace tier is served through notifications with in-place rewrites (see syscall::direct).

mailbox: Option<i32>

The mailbox descriptor of the guest-stub restricted mode, installed into every process that execs (see guest_stub); None elsewhere.

nested: AtomicBool

Set once any process has a view of its own; until then every lookup answers the root view without touching the process table.

Implementations

impl Ctx

pub fn new(config: Config, no_ptrace: bool) -> Ctx

Builds the shared state from a configuration.

Arguments

• config - Parsed command line.
• no_ptrace - Run without a ptrace tier.

pub fn trap_mode(&self) -> bool

Whether guests run the stub of the guest-stub restricted mode.

Returns

true when a mailbox was set up.

pub fn view(&self, tid: i32) -> Arc<View>

The view the process of thread tid lives in.

Arguments

• tid - Thread or process id.

pub fn enter_view(&self, tid: i32, view: Arc<View>, cwd: Vec<u8>)

Moves the process of thread tid into view, with cwd as its working directory there when the working directory is virtual.

Arguments

• tid - Thread or process id.
• view - The view to enter.
• cwd - Working directory as a guest path of view.

pub fn tracee(&self, tid: i32) -> TraceeInfo

Returns a copy of what is known about the process of thread tid.

pub fn set_exe(&self, tid: i32, guest: Vec<u8>, host: Vec<u8>)

Records the executable the process of thread tid is now running.

pub fn ids(&self, tid: i32) -> Ids

The virtual identity of the process of thread tid (root until changed).

pub fn set_ids(&self, tid: i32, ids: Ids)

Replaces the virtual identity of the process of thread tid.

pub fn dumpable(&self, tid: i32) -> bool

Whether the process of thread tid still reads as dumpable.

pub fn set_dumpable(&self, tid: i32, dumpable: bool)

Records the dumpable flag the process of thread tid set.

pub fn groups(&self, tid: i32) -> Option<Vec<u32>>

Supplementary groups of the process of thread tid, if setgroups was called.

pub fn set_groups(&self, tid: i32, groups: Vec<u32>)

Records the supplementary groups of the process of thread tid.

pub fn fork(&self, parent: i32, child: i32)

Copies the bookkeeping of the process of parent to a newly forked child.

pub fn forget(&self, pid: i32)

Forgets a process or thread that exited.

pub fn tgid(&self, tid: i32) -> i32

Thread-group id of a thread.