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-2012 ARM. All rights reserved.ARM DUI 0475H
Non-ConfidentialID070912