RTEMS 4.9.3 On-Line Library

RTEMS Specific Commands task - display information about tasks

RTEMS Shell User's Guide

5.2.8: task - display information about tasks

SYNOPSYS:

task [id [id ...] ]

DESCRIPTION:

When invoked with no arguments, this command prints information on the set of Classic API Tasks currently active in the system.

If invoked with a set of ids as arguments, then just those objects are included in the information printed.

EXIT STATUS:

This command returns 0 on success and non-zero if an error is encountered.

NOTES:

NONE

EXAMPLES:

The following is an example of how to use the task on an application with just two Classic API tasks:

SHLL [/] $ task
  ID       NAME   PRIO   STAT   MODES  EVENTS   WAITID  WAITARG  NOTES
------------------------------------------------------------------------------
0a010001   UI1      1   SUSP   P:T:nA  NONE
0a010002   SHLL   100   READY  P:T:nA  NONE

CONFIGURATION:

This command is included in the default shell command set. When building a custom command set, define CONFIGURE_SHELL_COMMAND_TASK to have this command included.

This command can be excluded from the shell command set by defining CONFIGURE_SHELL_NO_COMMAND_TASK when all shell commands have been configured.

PROGRAMMING INFORMATION:

The task is implemented by a C language function which has the following prototype:

int rtems_shell_rtems_main_task(
  int    argc,
  char **argv
);

The configuration structure for the task has the following prototype:

extern rtems_shell_cmd_t rtems_shell_TASK_Command;

RTEMS Shell User's Guide