C library API definitions for targeting a different environment

In addition to the semihosting functions listed in Table 2 and Table 3, Table 4 shows functions and files that might be useful when building for a different environment.

Table 4. Published API definitions

File or functionDescription
__main()
__rt_entry()
Initializes the runtime environment and executes the user application.
__rt_lib_init(),
__rt_exit(),
__rt_lib_shutdown()
Initializes or finalizes the runtime library.
LC_CTYPE locale
Defines the character properties for the local alphabet.
rt_sys.hA C header file describing all the functions whose default (semihosted) implementations use semihosting calls.
rt_heap.hA C header file describing the storage management abstract data type.
rt_locale.hA C header file describing the five locale category filing systems, and defining some macros that are useful for describing the contents of locale categories.
rt_misc.hA C header file describing miscellaneous unrelated public interfaces to the C library.
rt_memory.sAn empty, but commented, prototype implementation of the memory model.

If you are re-implementing a function that exists in the standard ARM library, the linker uses an object or library from your project rather than the standard ARM library.

Caution

Do not replace or delete libraries supplied by ARM. You must not overwrite the supplied library files. Place your re-implemented functions in separate object files or libraries instead.

Show/hideSee also

Copyright © 2010-2011 ARM. All rights reserved.ARM DUI 0475C
Non-ConfidentialID080411