Skip to main content

TaskContext

Struct TaskContext 

Source
pub struct TaskContext { /* private fields */ }
Expand description

Saved hardware states of a task.

The context usually includes:

  • Callee-saved registers
  • Stack pointer register
  • Thread pointer register (for kernel-space thread-local storage)
  • FP/SIMD registers

On context switch, current task saves its context from CPU to memory, and the next task restores its context from memory to CPU.

Implementations§

Source§

impl TaskContext

Source

pub fn new() -> Self

Creates a dummy context for a new task.

Note the context is not initialized, it will be filled by switch_to_prepared (for initial tasks) and init (for regular tasks) methods.

Source

pub fn init( &mut self, entry: usize, kstack_top: VirtAddr, kernel_tls: KernelTlsBase, )

Initializes the context for a new task, with the given entry point and kernel stack.

Source

pub fn set_context_header(&mut self, header: NonNull<ExecutionContextHeader>)

Sets the pinned task-owned execution-context header.

Source

pub const fn context_header(&self) -> Option<NonNull<ExecutionContextHeader>>

Returns the configured task-owned execution-context header.

Source

pub fn prepare_switch_to(&mut self, _next_ctx: &Self)

Completes FP/SIMD work before current-context publication.

Source

pub unsafe fn switch_to_prepared( &mut self, next_ctx: &Self, prepared: PreparedContextSwitch<'_>, )

Performs only the final GPR/current/TLS transfer.

§Safety

Scheduling must be serialized, FP state prepared, and the next current header published. No fallible Rust work may follow before this call.

Trait Implementations§

Source§

impl Debug for TaskContext

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl Default for TaskContext

Source§

fn default() -> TaskContext

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.