Struct TaskRunningState 

pub struct TaskRunningState {
    pub thread: OnceLock<ZirconThread>,
    pub files: LockDepMutex<Option<SharedFdTable>, TaskFilesLock>,
    pub mm: RcuArc<MemoryManager>,
    pub fs: RcuArc<FsContext>,
    pub abstract_socket_namespace: Arc<AbstractUnixSocketNamespace>,
    pub abstract_vsock_namespace: Arc<AbstractVsockSocketNamespace>,
    pub proc_pid_directory_cache: OnceLock<FsNodeHandle>,
}

The running state of a task.

This structure contains the state of a task that is only relevant while the task is running. It is dropped when the task enters an exited state.

Fields

thread: OnceLock<ZirconThread>

A handle to the underlying Zircon thread object.

Some tasks lack an underlying Zircon thread. These tasks are used internally by the Starnix kernel to track background work, typically on a kthread.

files: LockDepMutex<Option<SharedFdTable>, TaskFilesLock>

The file descriptor table for this task.

This table can be shared by many tasks.

This is always Some while the task is running. It becomes None upon exit.

mm: RcuArc<MemoryManager>

The memory manager for this task. This is None only for system tasks.

fs: RcuArc<FsContext>

The file system for this task.

This is always Some while the task is running. It becomes None upon exit, so that the FsContext (and possibly the whole mount namespace) is released on the exiting thread rather than by whichever thread happens to drop the last reference to this TaskRunningState.

abstract_socket_namespace: Arc<AbstractUnixSocketNamespace>

The namespace for abstract AF_UNIX sockets for this task.

abstract_vsock_namespace: Arc<AbstractVsockSocketNamespace>

The namespace for AF_VSOCK for this task.

proc_pid_directory_cache: OnceLock<FsNodeHandle>

The pid directory, so it doesn’t have to be generated and thrown away on every access. See https://fxbug.dev/291962828 for details.

Implementations

impl TaskRunningState

pub fn files(&self) -> Result<Arc<FdTable>, Errno>

pub fn fork_files(&self) -> Option<SharedFdTable>

pub fn share_files(&self) -> Option<SharedFdTable>

pub fn unshare_files(&self, current_task: &CurrentTask)

Unshares the file descriptor table for this task, if shared.

Updates the Arc<FdTable> reference in both SharedFdTable and CurrentTask.

pub fn mm(&self) -> Result<Arc<MemoryManager>, Errno>

pub fn fs(&self) -> Result<Arc<FsContext>, Errno>

Returns the file system context for this task.

Errors

Returns [Err(ESRCH)] if the task has exited and released its file system context.