[task] Task control commands

The following table describes the task control commands:

[task] commands

Description

info

Shows top-level task control information.

rings

Lists tasks (head and tail) on each task priority ring.

sqe

Displays a memory area as a task SQE (service queue element).

task

Shows detailed information about the named task.

This command is also present in the [con] Standard commands.

tasks

Displays all created tasks. Information includes:

  • Name: Name of the given task. A leading \$\ indicates kernel task.

  • Prior: Priority of task. 1 = highest priority. 31 = lowest.

  • State: Current state of task. Valid states include:

  • Created: Task was created but never executed.

  • Stalled: Kernel detected invalid instruction (usually breakpoint during debug session).

  • Waiting: Task is asleep and waiting for work.

  • Blocked: Higher priority task currently blocking.

  • Running: Task is executing.

  • Holding: Invalid kernel service requested.

 

  • Msgs: Number of messages queued to task.

  • Peak: Maximum number of messages ever queued to task.

  • Ovfl: Messages dropped due to queue overflow.

  • Total: Total number of messages processed by task.

  • TCB Addr: Task control block address.

  • Stk Depth: Maximum stack depth used by task.

  • Cmd Opts: Command options provided to task.

 

This command is also present in the [con] Standard commands.

tcb

Displays a memory area as a TCB (task control block).