task

VxWorks Tasks.

task [SUBCOMMAND [ARGS]]

Handle the VxWorks tasks (kernel and RTP tasks).

This command is VxWorks specific, and cannot be invoked if connected to another Operating System.

List of task subcommands:

Type “help task” followed by task subcommand name for full documentation. Command name abbreviations are allowed if unambiguous.

task attach – Attach to a VxWorks task

Attach to a VxWorks task.

task attach (ID|Name) [(ID|Name) ...]

  • ID – The ID of the task to attach to.
  • Name – The name of the task to attach to.

WRDBG will switch to the inferior that contains the last task specified and it will be used as the current thread of the inferior.

The list of tasks can be retrieved using “info tasks”.

task create – Create a VxWorks kernel task

Create a VxWorks kernel task.

task create [-d] ENTRYPOINT [ARG [ARG ...]]

  • -d[etached] – create the task detached from the debugger and not stopped at its entry point.

  • ENTRYPOINT – is a function name or address.

  • ARG – is an optional task creation argument.

    • Use double-quotes to set string argument (for example ‘task create printf “foo %d” 2’)

To configure task creation options, see “show task create” and “set task create”.

To terminate a task (even if not attached), see “task kill”.

task detach – Detach a VxWorks task

Detach a VxWorks task previously attached.

task detach [(ID|Name) [(ID|Name) ...]]

  • ID – The ID of the task to detach.
  • Name – The name of the task to detach.

If no task is specified, detach the current task.

The list of tasks can be retrieved using “info tasks”.

task kill – Kill a VxWorks task

Kill execution of specified VxWorks tasks.

task kill [(ID|Name) [(ID|Name) ...]]

  • ID – The ID of the task to detach.
  • Name – The name of the task to detach.

The command can be used to kill a task which is not attached. If no task is specified, the current task is killed.

See “info tasks” for the list of tasks.

task select – Select a VxWorks task

Switch between tasks.

task select ID

  • ID – is the ID or the name of the task to switch to. The new task ID must be currently known and returned by “info tasks”. When using names, the task name must be unique (if it is not, use ID).

The “select” subcommand may be omitted, “task <ID>” is equivalent to “task select <ID>”.