Struct Task 

pub struct Task(/* private fields */);

Wraps the kernel’s struct task_struct.

Invariants

All instances are valid tasks created by the C portion of the kernel.

Instances of this type are always refcounted, that is, a call to get_task_struct ensures that the allocation remains valid at least until the matching call to put_task_struct.

Examples

The following is an example of getting the PID of the current thread with zero additional cost when compared to the C version:

let pid = current!().pid();

Getting the PID of the current process, also zero additional cost:

let pid = current!().group_leader().pid();

Getting the current task and storing it in some struct. The reference count is automatically incremented when creating State and decremented when it is dropped:

use kernel::{task::Task, sync::aref::ARef};

struct State {
    creator: ARef<Task>,
    index: u32,
}

impl State {
    fn new() -> Self {
        Self {
            creator: ARef::from(&**current!()),
            index: 0,
        }
    }
}

Implementations

impl Task

pub fn current_raw() -> *mut task_struct

Returns a raw pointer to the current task.

It is up to the user to use the pointer correctly.

pub unsafe fn current() -> impl Deref<Target = CurrentTask>

Returns a task reference for the currently executing task/thread.

The recommended way to get the current task/thread is to use the current macro because it is safe.

Safety

Callers must ensure that the returned object is only used to access a CurrentTask within the task context that was active when this function was called. For more details, see the invariants section for CurrentTask.

pub fn as_ptr(&self) -> *mut task_struct

Returns a raw pointer to the task.

pub fn pid(&self) -> Pid

Returns the PID of the given task.

pub fn uid(&self) -> Kuid

Returns the UID of the given task.

pub fn euid(&self) -> Kuid

Returns the effective UID of the given task.

pub fn signal_pending(&self) -> bool

Determines whether the given task has pending signals.

pub fn get_pid_ns(&self) -> Option<ARef<PidNamespace>>

Returns task’s pid namespace with elevated reference count

pub fn tgid_nr_ns(&self, pidns: Option<&PidNamespace>) -> Pid

Returns the given task’s pid in the provided pid namespace.

pub fn wake_up(&self)

Wakes up the task.

Trait Implementations

impl AlwaysRefCounted for Task

fn inc_ref(&self)

Increments the reference count on the object.

unsafe fn dec_ref(obj: NonNull<Self>)

Decrements the reference count on the object.

impl PartialEq for Task

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Task

impl Send for Task

impl Sync for Task