callout
QNX SDP8.0Building Embedded SystemsConfigurationDeveloper
Information for kernel callouts
The callout area is CPU-independent. It is defined by the
callout_entry data structure, which includes the following members:
- reboot
- A pointer to the reboot callout function. This callout function is invoked in two scenarios:
- A
normal
termination, which is done based on a user request (e.g., through sysmgr_reboot()) and is therefore expected - An
abnormal
termination, which is done to recover from an unexpected system failure and is therefore unexpected. Reasons for an abnormal termination include:- the kernel detects internal inconsistencies
- the kernel runs out of memory doing work that is guaranteed to succeed
- a critical process terminates
Note:If the behavior of the system cannot be guaranteed to meet all requirements, the safest course of action is to return system control to the startup program so that it can, in a board-specific way, put the system into a known good state (e.g., by rebooting).For more details and a code sample, see
System reboot
. - A
- power
- Deprecated. This field is set to NULL.
- timer_load
- A pointer to a callout that sets the period for the system tick timer and enables it.
The callout is called first during procnto initialization to make
the timer start generating system ticks. It is also called when the system tick period
is changed (via ClockPeriod()), when entering or leaving tickless
operations, and by high-resolution software timers.
For details on what exactly this function does, see the timer_load() description in
Timer and clock
. - timer_reload
- A pointer to a callout used to manually reload the timer with the same period for the
next fire. If a new period needs to be set, timer_load() will be used
instead.
For more information, see the timer_reload() description in
Timer and clock
. - timer_value
- A pointer to a callout that is used to determine when the next interrupt is expected.
It's a count-up value from 0 (since
the last interrupt
) to the current time, to tell how far the timer has gone.For examples of using this callout, see the timer_value() description in
Timer and clock
. - debug
- This field is an array that has two entries:
- debug[0] — used for informational purposes
- debug[1] — currently unused; set this field to NULL
Only the first entry is discussed in this guide. This entry points to a callout that prints out internal debugging information to a device. For information about the specific types of kernel debug callouts, see the
Kernel debug
entry in theKernel Callouts
chapter. - debug_watchdog
- Not used. This field is set to NULL.
- custom
- This field must be either:
- NULL, indicating that no custom kernel call callout is provided
- non-NULL, and pointing to valid code provided by the startup program, indicating that
a custom kernel call callout is provided. For information about the signature and a code sample for a custom callout,
see the
Custom
entry in theKernel Callouts
chapter.
Page updated: