forked from Imagelibrary/rtems
d5154d0f6a
Notepads where a feature of RTEMS' tasks that simply functioned in the same way as POSIX keys or threaded local storage (TLS). They were introduced well before per task variables, which are also deprecated, and were barely used in favor of their POSIX alternatives. In addition to their scarce usage, Notepads took up unnecessary memory. For each task: - 16 32-bit integers were allocated. - A total of 64 bytes per task per thread. This is especially critical in low memory and safety-critical applications. They are also defined as uint32_t, and therefore are not guaranteed to hold a pointer. Lastly, they are not portable solutions for SMP and uniprocessor systems, like POSIX keys and TLS. updates #2493.
93 lines
2.8 KiB
Plaintext
93 lines
2.8 KiB
Plaintext
monitor task
|
|
|
|
The monitor task is an optional task that knows about RTEMS
|
|
data structures and can print out information about them.
|
|
It is a work-in-progress and needs many more commands, but
|
|
is useful now.
|
|
|
|
The monitor works best when it is the highest priority task,
|
|
so all your other tasks should ideally be at some priority
|
|
greater than 1.
|
|
|
|
To use the monitor:
|
|
-------------------
|
|
|
|
#include <rtems/monitor.h>
|
|
|
|
...
|
|
|
|
rtems_monitor_init(0);
|
|
|
|
The parameter to rtems_monitor_init() tells the monitor whether
|
|
to suspend itself on startup. A value of 0 causes the monitor
|
|
to immediately enter command mode; a non-zero value causes the
|
|
monitor to suspend itself after creation and wait for explicit
|
|
wakeup.
|
|
|
|
|
|
rtems_monitor_wakeup();
|
|
|
|
wakes up a suspended monitor and causes it to reenter command mode.
|
|
|
|
Monitor commands
|
|
----------------
|
|
|
|
The monitor prompt is 'rtems> '.
|
|
Can abbreviate commands to "uniquity"
|
|
There is a 'help' command. Here is the output from various
|
|
help commands:
|
|
|
|
Commands (may be abbreviated)
|
|
|
|
help -- get this message or command specific help
|
|
task -- show task information
|
|
queue -- show message queue information
|
|
symbol -- show entries from symbol table
|
|
pause -- pause monitor for a specified number of ticks
|
|
fatal -- invoke a fatal RTEMS error
|
|
|
|
task [id [id ...] ]
|
|
display information about the specified tasks.
|
|
Default is to display information about all tasks on this node
|
|
|
|
queue [id [id ... ] ]
|
|
display information about the specified message queues
|
|
Default is to display information about all queues on this node
|
|
|
|
symbol [ symbolname [symbolname ... ] ]
|
|
display value associated with specified symbol.
|
|
Defaults to displaying all known symbols.
|
|
|
|
pause [ticks]
|
|
monitor goes to "sleep" for specified ticks (default is 1)
|
|
monitor will resume at end of period or if explicitly awakened
|
|
|
|
fatal [status]
|
|
Invoke 'rtems_fatal_error_occurred' with 'status'
|
|
(default is RTEMS_INTERNAL_ERROR)
|
|
|
|
continue
|
|
put the monitor to sleep waiting for an explicit wakeup from the
|
|
program running.
|
|
|
|
|
|
Sample output from 'task' command
|
|
---------------------------------
|
|
|
|
rtems> task
|
|
ID NAME PRIO STAT MODES EVENTS WAITID WAITARG NOTES
|
|
------------------------------------------------------------------------
|
|
00010001 UI1 2 READY P:T:nA NONE15: 0x40606348
|
|
00010002 RMON 1 READY nP NONE15: 0x40604110
|
|
|
|
'RMON' is the monitor itself, so we have 1 "user" task.
|
|
Its modes are P:T:nA which translate to:
|
|
|
|
preemptable
|
|
timesliced
|
|
no ASRS
|
|
|
|
It has no events.
|
|
(this is the libc thread state)
|
|
|