TaskControlBlock Struct Reference

任务控制块，管理进程/线程的核心数据结构 More...

#include <task_control_block.hpp>

Inheritance diagram for TaskControlBlock:

Collaboration diagram for TaskControlBlock:

Classes
struct	PriorityCompare
	任务优先级比较函数，优先级数值越小，优先级越高 More...
union	SchedData
	不同调度器的专用字段 (互斥使用) More...
struct	SchedInfo
	基础调度信息 More...
struct	WakeTickCompare
	任务唤醒时间比较函数，时间越早优先级越高 More...

Public Member Functions
auto	GetStatus () const -> etl::fsm_state_id_t
	获取当前任务状态
auto	IsThreadGroupLeader () const -> bool
	检查是否是线程组的主线程
auto	JoinThreadGroup (TaskControlBlock *leader) -> void
	将线程添加到线程组
auto	LeaveThreadGroup () -> void
	从线程组中移除自己
auto	GetThreadGroupSize () const -> size_t
	获取线程组中的线程数量
auto	InSameThreadGroup (const TaskControlBlock *other) const -> bool
	检查是否与另一个任务在同一线程组
构造/析构函数
	TaskControlBlock (const char *name, int priority, ThreadEntry entry, void *arg)
	构造函数 (内核线程)
	TaskControlBlock (const char *name, int priority, uint8_t *elf, int argc, char **argv)
	构造函数 (用户线程)
	TaskControlBlock ()=default
	TaskControlBlock (const TaskControlBlock &)=delete
	TaskControlBlock (TaskControlBlock &&)=delete
auto	operator= (const TaskControlBlock &) -> TaskControlBlock &=delete
auto	operator= (TaskControlBlock &&) -> TaskControlBlock &=delete
	~TaskControlBlock ()

Public Attributes
const char *	name {"Unnamed Task"}
	任务名称
Pid	pid {0}
	线程 ID (Task ID)
TaskFsm	fsm {}
	任务状态机
SchedPolicy	policy {SchedPolicy::kNormal}
	调度策略
struct TaskControlBlock::SchedInfo	sched_info
union TaskControlBlock::SchedData	sched_data
uint8_t *	kernel_stack {nullptr}
	内核栈
cpu_io::TrapContext *	trap_context_ptr {nullptr}
	Trap 上下文
cpu_io::CalleeSavedContext	task_context {}
	任务上下文
uint64_t *	page_table {nullptr}
	页表
TaskAuxData *	aux {nullptr}
	非调度热路径的辅助数据

Static Public Attributes
static constexpr size_t	kDefaultKernelStackSize = 16 * 1024
	默认内核栈大小 (16 KB)

Detailed Description

任务控制块，管理进程/线程的核心数据结构

仅保留调度热路径字段（状态机、优先级、上下文、页表等）。 进程级辅助数据存储在 TaskAuxData 中，通过 aux 指针访问。

Definition at line 121 of file task_control_block.hpp.

Constructor & Destructor Documentation

TaskControlBlock() [1/5]

TaskControlBlock::TaskControlBlock	(	const char *	name,
		int	priority,
		ThreadEntry	entry,
		void *	arg
	)

构造函数 (内核线程)

Parameters

name	任务名称
priority	优先级 (数字越小优先级越高)
entry	线程入口函数
arg	线程参数

Definition at line 131 of file task_control_block.cpp.

    : name(_name) {
  // 分配辅助数据
  aux = new TaskAuxData{};
  if (!aux) {
    klog::Err("Failed to allocate TaskAuxData for task {}", name);
    return;
  }
 
  // 设置优先级
  sched_info.priority = priority;
  sched_info.base_priority = priority;
 
  // 分配内核栈
  kernel_stack = static_cast<uint8_t*>(aligned_alloc(
      cpu_io::virtual_memory::kPageSize, kDefaultKernelStackSize));
  if (!kernel_stack) {
    klog::Err("Failed to allocate kernel stack for task {}", name);
    return;
  }
 
  // 设置 trap_context_ptr 指向内核栈顶预留的位置
  trap_context_ptr = reinterpret_cast<cpu_io::TrapContext*>(
      kernel_stack + kDefaultKernelStackSize - sizeof(cpu_io::TrapContext));
 
  // 设置内核栈顶
  auto stack_top =
      reinterpret_cast<uint64_t>(kernel_stack) + kDefaultKernelStackSize;
 
  // 初始化任务上下文
  InitTaskContext(&task_context, entry, arg, stack_top);
 
  fsm.Start();
}

Here is the call graph for this function:

TaskControlBlock() [2/5]

TaskControlBlock::TaskControlBlock	(	const char *	name,
		int	priority,
		uint8_t *	elf,
		int	argc,
		char **	argv
	)

构造函数 (用户线程)

Parameters

name	任务名称
priority	优先级 (数字越小优先级越高)
elf	指向 ELF 镜像的指针
argc	参数个数
argv	参数数组

Todo:

Definition at line 167 of file task_control_block.cpp.

    : name(_name) {
  // 分配辅助数据
  aux = new TaskAuxData{};
  if (!aux) {
    klog::Err("Failed to allocate TaskAuxData for task {}", name);
    return;
  }
 
  // 设置优先级
  sched_info.priority = priority;
  sched_info.base_priority = priority;
 
  (void)_name;
  (void)priority;
  (void)elf;
  (void)argc;
  (void)argv;
  LoadElf(nullptr, nullptr);
 
  fsm.Start();
}

Here is the call graph for this function:

TaskControlBlock() [3/5]

TaskControlBlock::TaskControlBlock ( )

default

TaskControlBlock() [4/5]

TaskControlBlock::TaskControlBlock ( const TaskControlBlock &  )

delete

TaskControlBlock() [5/5]

TaskControlBlock::TaskControlBlock ( TaskControlBlock &&  )

delete

~TaskControlBlock()

TaskControlBlock::~TaskControlBlock

(

)

Definition at line 192 of file task_control_block.cpp.

                                    {
  // 从线程组中移除
  LeaveThreadGroup();
 
  // 释放内核栈
  if (kernel_stack) {
    aligned_free(kernel_stack);
    kernel_stack = nullptr;
  }
 
  // 释放页表（如果有用户空间页表）
  if (page_table) {
    // 如果是私有页表（非共享），需要释放物理页
    auto should_free_pages = !(aux->clone_flags & clone_flag::kVm);
    VirtualMemorySingleton::instance().DestroyPageDirectory(page_table,
                                                            should_free_pages);
    page_table = nullptr;
  }
 
  // 释放辅助数据
  if (aux) {
    delete aux;
    aux = nullptr;
  }
}

Here is the call graph for this function:

Member Function Documentation

GetStatus()

auto TaskControlBlock::GetStatus

(

)

const -> etl::fsm_state_id_t

获取当前任务状态

Returns

etl::fsm_state_id_t 当前任务状态 ID

Definition at line 88 of file task_control_block.cpp.

                                                            {
  return fsm.GetStateId();
}

Here is the call graph for this function:

Here is the caller graph for this function:

GetThreadGroupSize()

auto TaskControlBlock::GetThreadGroupSize

(

)

const -> size_t

获取线程组中的线程数量

Returns

size_t 线程数量 (包括自己)

Definition at line 106 of file task_control_block.cpp.

                                                          {
  if (aux->tgid == 0) {
    // 未加入任何线程组
    return 1;
  }
 
  size_t count = 1;
 
  // 向前遍历至链表头
  const ThreadGroupLink* curr = etl_previous;
  while (curr) {
    ++count;
    curr = curr->etl_previous;
  }
 
  // 向后遍历至链表尾
  curr = etl_next;
  while (curr) {
    ++count;
    curr = curr->etl_next;
  }
 
  return count;
}

InSameThreadGroup()

auto TaskControlBlock::InSameThreadGroup ( const TaskControlBlock *  other ) const -> bool

inline

检查是否与另一个任务在同一线程组

Parameters

other

另一个任务

Returns

true 如果在同一线程组

Definition at line 259 of file task_control_block.hpp.

              {
    return aux && other && other->aux && (aux->tgid == other->aux->tgid) &&
           (aux->tgid != 0);
  }

IsThreadGroupLeader()

auto TaskControlBlock::IsThreadGroupLeader ( ) const -> bool

inline

检查是否是线程组的主线程

Returns

true 如果是主线程 (pid == tgid)

Definition at line 231 of file task_control_block.hpp.

                                                         {
    return aux && pid == aux->tgid;
  }

JoinThreadGroup()

auto TaskControlBlock::JoinThreadGroup

(

TaskControlBlock *

leader

)

-> void

将线程添加到线程组

Parameters

leader

线程组的主线程

Note

调用者需要确保加锁

Definition at line 92 of file task_control_block.cpp.

                                                                       {
  if (!leader || leader == this) {
    return;
  }
 
  // 设置 tgid
  aux->tgid = leader->aux->tgid;
 
  // 在 leader 之后插入自身
  etl::link_splice<ThreadGroupLink>(*leader, *this);
}

LeaveThreadGroup()

auto TaskControlBlock::LeaveThreadGroup

(

)

-> void

从线程组中移除自己

Note

调用者需要确保加锁

Definition at line 104 of file task_control_block.cpp.

{ ThreadGroupLink::unlink(); }

Here is the caller graph for this function:

operator=() [1/2]

auto TaskControlBlock::operator= ( const TaskControlBlock &  ) -> TaskControlBlock &=delete

delete

operator=() [2/2]

auto TaskControlBlock::operator= ( TaskControlBlock &&  ) -> TaskControlBlock &=delete

delete

Member Data Documentation

aux

TaskAuxData* TaskControlBlock::aux {nullptr}

非调度热路径的辅助数据

Definition at line 219 of file task_control_block.hpp.

{nullptr};

fsm

TaskFsm TaskControlBlock::fsm {}

任务状态机

Definition at line 162 of file task_control_block.hpp.

{};

kDefaultKernelStackSize

constexpr size_t TaskControlBlock::kDefaultKernelStackSize = 16 * 1024

staticconstexpr

默认内核栈大小 (16 KB)

Definition at line 123 of file task_control_block.hpp.

kernel_stack

uint8_t* TaskControlBlock::kernel_stack {nullptr}

内核栈

Definition at line 209 of file task_control_block.hpp.

{nullptr};

name

const char* TaskControlBlock::name {"Unnamed Task"}

任务名称

Definition at line 156 of file task_control_block.hpp.

{"Unnamed Task"};

page_table

uint64_t* TaskControlBlock::page_table {nullptr}

页表

Definition at line 216 of file task_control_block.hpp.

{nullptr};

pid

Pid TaskControlBlock::pid {0}

线程 ID (Task ID)

Definition at line 159 of file task_control_block.hpp.

{0};

policy

SchedPolicy TaskControlBlock::policy {SchedPolicy::kNormal}

调度策略

Definition at line 165 of file task_control_block.hpp.

{SchedPolicy::kNormal};

sched_data

union TaskControlBlock::SchedData TaskControlBlock::sched_data

sched_info

struct TaskControlBlock::SchedInfo TaskControlBlock::sched_info

task_context

cpu_io::CalleeSavedContext TaskControlBlock::task_context {}

任务上下文

Definition at line 214 of file task_control_block.hpp.

{};

trap_context_ptr

cpu_io::TrapContext* TaskControlBlock::trap_context_ptr {nullptr}

Trap 上下文

Definition at line 212 of file task_control_block.hpp.

{nullptr};

---

The documentation for this struct was generated from the following files:

• /workspaces/SimpleKernel/src/task/include/task_control_block.hpp
• /workspaces/SimpleKernel/src/task/task_control_block.cpp