interface xdc.runtime.ISystemSupport

Interface to core system functions

Each embedded system requires implementations of these functions but the behavior of these functions varies depending on the context of the embedded system. For example, some systems will implement exit() as an infinite loop because the executable is designed to *never* exit.
XDCspec summary sourced in xdc/runtime/ISystemSupport.xdc
interface ISystemSupport {  ...
// inherits xdc.runtime.IModule
XDCspec declarations sourced in xdc/runtime/ISystemSupport.xdc
package xdc.runtime;
 
interface ISystemSupport {
module-wide config parameters
module-wide functions
    Void abort// Backend for System.abort()(CString str);
    Void exit// Backend for System.exit()(Int stat);
}
 
metaonly config ISystemSupport.common$  // module-wide

Common module configuration parameters

XDCspec declarations sourced in xdc/runtime/ISystemSupport.xdc
metaonly config Types.Common$ common$;
 
DETAILS
All modules have this configuration parameter. Its name contains the '$' character to ensure it does not conflict with configuration parameters declared by the module. This allows new configuration parameters to be added in the future without any chance of breaking existing modules.
 
ISystemSupport.abort()  // module-wide

Backend for System.abort()

XDCspec declarations sourced in xdc/runtime/ISystemSupport.xdc
Void abort(CString str);
 
ARGUMENTS
str — message to output just prior to aborting
If non-NULL, this string should be output just prior to terminating.
DETAILS
This function is called by System.abort() prior to calling the ANSI C Standard library function abort(). So, to ensure the abort processing of the system's ANSI C Standard library completes, this function should return to its caller.
 
ISystemSupport.exit()  // module-wide

Backend for System.exit()

XDCspec declarations sourced in xdc/runtime/ISystemSupport.xdc
Void exit(Int stat);
 
ARGUMENTS
stat — status value passed to all "atexit" handlers
This value is passed to all "atexit" handles bound via System.atexit().
DETAILS
This function is called as part the normal "atexit" processing performed by the ANSI C Standard Library's exit() function; System.exit() directly calls ANSI exit().
This function is called after all "atexit" handlers bound via System.atexit() are run and it is always called while "inside" the the System gate.
To ensure that all exit processing of the system's ANSI C Standard Library completes, this function should return to its caller. Exit handlers bound using the ANSI C Standard Library atexit() function may run before or after this function.
SEE
 
ISystemSupport.flush()  // module-wide

Backend for System.flush()

XDCspec declarations sourced in xdc/runtime/ISystemSupport.xdc
Void flush();
 
DETAILS
This function is simply called by System_flush to output any characters buffered by the underlying SystemSupport module to an output device.
 
ISystemSupport.putch()  // module-wide

Backend for System.printf() and System.putch()

XDCspec declarations sourced in xdc/runtime/ISystemSupport.xdc
Void putch(Char ch);
 
ARGUMENTS
ch — character to output
DETAILS
Output a single character. This function is called by System_printf() to write each character of formated output specified by its arguments.
 
ISystemSupport.ready()  // module-wide

Test if character output can proceed

XDCspec declarations sourced in xdc/runtime/ISystemSupport.xdc
Bool ready();
 
DETAILS
This function is called by System prior to performing any character output. If this function returns FALSE, the System functions that would normally call putch() simply return (with an appropriate error status) without ever calling putch.
generated on Thu, 23 May 2019 00:24:44 GMT