Struct axtask::TaskInner

pub struct TaskInner {
    pub trap_frame: UnsafeCell<TrapFrame>,
    pub page_table_token: UnsafeCell<usize>,
    pub cpu_set: AtomicU64,
    pub send_sigchld_when_exit: bool,
    pub sched_status: UnsafeCell<SchedStatus>,
    /* private fields */
}

Available on crate feature multitask only.

The inner task structure.

Fields

trap_frame: UnsafeCell<TrapFrame>

Available on crate feature monolithic only.

初始化的trap上下文

page_table_token: UnsafeCell<usize>

Available on crate feature monolithic only.

the page table token of the process which the task belongs to

cpu_set: AtomicU64

Available on crate feature monolithic only.

TODO: to support the sched_setaffinity

send_sigchld_when_exit: bool

Available on crate feature signal only.

退出时是否向父进程发送SIG_CHILD

sched_status: UnsafeCell<SchedStatus>

Available on crate feature monolithic only.

The scheduler status of the task, which defines the scheduling policy and priority

Implementations

impl TaskInner

pub const fn id(&self) -> TaskId

Gets the ID of the task.

pub fn name(&self) -> &str

Gets the name of the task.

pub fn set_name(&self, name: &str)

Sets the name of the task.

pub fn id_name(&self) -> String

Get a combined string of the task ID and name.

pub fn join(&self) -> Option<i32>

Wait for the task to exit, and return the exit code.

It will return immediately if the task has already exited (but not dropped).

pub fn get_kernel_stack_top(&self) -> Option<usize>

获取内核栈栈顶

impl TaskInner

pub fn set_child_tid(&self, tid: usize)

Available on crate feature monolithic only.

store the child thread ID at the location pointed to by child_tid in clone args

pub fn set_clear_child_tid(&self, tid: usize)

Available on crate feature monolithic only.

clear (zero) the child thread ID at the location pointed to by child_tid in clone args

pub fn get_clear_child_tid(&self) -> usize

Available on crate feature monolithic only.

get the pointer to the child thread ID

pub fn get_page_table_token(&self) -> usize

Available on crate feature monolithic only.

get the page table token of the process which the task belongs to

pub fn set_page_table_token(&self, token: usize)

Available on crate feature monolithic only.

force to set the page table token of the process UNSAFELY

pub fn time_stat_from_user_to_kernel(&self)

Available on crate feature monolithic only.

update the time information when the task is switched from user mode to kernel mode

pub fn time_stat_from_kernel_to_user(&self)

Available on crate feature monolithic only.

update the time information when the task is switched from kernel mode to user mode

pub fn time_stat_when_switch_from(&self)

Available on crate feature monolithic only.

update the time information when the task is switched out

pub fn time_stat_when_switch_to(&self)

Available on crate feature monolithic only.

update the time information when the task is ready to be switched in

pub fn time_stat_output(&self) -> (usize, usize, usize, usize)

Available on crate feature monolithic only.

将内核统计的运行时时间转为秒与微妙的形式输出，方便进行sys_time (用户态秒，用户态微妙，内核态秒，内核态微妙)

pub fn timer_output(&self) -> (usize, usize)

Available on crate feature monolithic only.

输出计时器信息 (计时器周期，当前计时器剩余时间) 单位为us

pub fn set_timer( &self, timer_interval_ns: usize, timer_remained_ns: usize, timer_type: usize ) -> bool

Available on crate feature monolithic only.

设置计时器信息

若type不为None则返回成功

pub fn time_stat_clear(&self)

Available on crate feature monolithic only.

重置统计时间

pub fn get_process_id(&self) -> u64

Available on crate feature monolithic only.

get the process ID of the task

pub fn set_process_id(&self, process_id: u64)

Available on crate feature monolithic only.

set the process ID of the task

pub fn get_first_trap_frame(&self) -> *mut TrapFrame

Available on crate feature monolithic only.

获取内核栈的第一个trap上下文

pub fn set_leader(&self, is_lead: bool)

Available on crate feature monolithic only.

set the flag whether the task is the main thread of the process

pub fn is_leader(&self) -> bool

Available on crate feature monolithic only.

whether the task is the main thread of the process

pub fn set_trap_context(&self, trap_frame: TrapFrame)

Available on crate feature monolithic only.

设置Trap上下文

pub fn set_trap_in_kernel_stack(&self)

Available on crate feature monolithic only.

将trap上下文直接写入到内核栈上 注意此时保持sp不变 返回值为压入了trap之后的内核栈的栈顶，可以用于多层trap压入

pub fn set_cpu_set(&self, mask: usize, set_size: usize)

Available on crate feature monolithic only.

设置CPU set，其中set_size为bytes长度

pub fn get_cpu_set(&self) -> usize

Available on crate feature monolithic only.

to get the CPU set

pub fn set_sched_status(&self, status: SchedStatus)

Available on crate feature monolithic only.

set the scheduling policy and priority

pub fn get_sched_status(&self) -> SchedStatus

Available on crate feature monolithic only.

get the scheduling policy and priority

pub fn get_ctx(&self) -> &TaskContext

Available on crate feature monolithic only.

get the task context for task switch

pub fn get_sig_child(&self) -> bool

Available on crate features monolithic and signal only.

whether to send SIG_CHILD when the task exits

pub fn set_sig_child(&mut self, sig_child: bool)

Available on crate features monolithic and signal only.

set whether to send SIG_CHILD when the task exits

pub unsafe fn set_tls_force(&self, value: usize)

Available on crate feature monolithic and x86-64 only.

Safety

It is unsafe because it may cause undefined behavior if the fs_base is not a valid address.

pub fn is_vfork(&self) -> bool

Available on crate feature monolithic only.

获取父进程blocked_by_vfork布尔值

impl TaskInner

pub fn new<F>( entry: F, name: String, stack_size: usize, process_id: u64, page_table_token: usize, sig_child: bool ) -> AxTaskRefwhere F: FnOnce() + Send + 'static,

Create a new task with the given entry function and stack size.

pub fn state(&self) -> TaskState

the state of the task

pub fn set_state(&self, state: TaskState)

set the state of the task

Trait Implementations

impl Debug for TaskInner

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

Formats the value using the given formatter.

impl Drop for TaskInner

fn drop(&mut self)

Executes the destructor for this type.

impl Send for TaskInner

impl Sync for TaskInner