5fbf2e0992
This patch defines a few new macros that can be used to control the visibility of symbols exported by the C library: - ENTRY_PRIVATE() can be used in assembly sources to indicate that an assembler function should have "hidden" visibility, i.e. will never be exported by the C library's shared library. This is the equivalent of using __LIBC_HIDDEN__ for a C function, but ENTRY_PRIVATE() works like ENTRY(), and must be used with END() to tag the end of the function. - __LIBC_ABI_PUBLIC__ can be used to tag a C functions as being part of the C library's public ABI. This is important for a few functions that must be exposed by the NDK to maintain binary compatibility. Once a symbol has been tagged with this macro, it shall *never* be removed from the library, even if it becomes directly unused due to implementation changes (e.g. __is_threaded). - __LIBC_ABI_PRIVATE__ can be used for C functions that should always be exported by the C library because they are used by other libraries in the platform, but should not be exposed by the NDK. It is possible to remove such symbols from the implementation if all callers are also modified. + Add missing END() assembly macro for x86 Change-Id: Ia96236ea0dbec41d57bea634b39d246b30e5e234 |
||
---|---|---|
.. | ||
arch-arm | ||
arch-x86 | ||
bionic | ||
docs | ||
include | ||
inet | ||
kernel | ||
netbsd | ||
private | ||
regex | ||
stdio | ||
stdlib | ||
string | ||
tools | ||
tzcode | ||
unistd | ||
wchar | ||
zoneinfo | ||
Android.mk | ||
CAVEATS | ||
Jamfile | ||
MODULE_LICENSE_BSD | ||
NOTICE | ||
README | ||
SYSCALLS.TXT |
Welcome to Bionic, Android's small and custom C library for the Android platform. Bionic is mainly a port of the BSD C library to our Linux kernel with the following additions/changes: - no support for locales - no support for wide chars (i.e. multi-byte characters) - its own smallish implementation of pthreads based on Linux futexes - support for x86, ARM and ARM thumb CPU instruction sets and kernel interfaces Bionic is released under the standard 3-clause BSD License Bionic doesn't want to implement all features of a traditional C library, we only add features to it as we need them, and we try to keep things as simple and small as possible. Our goal is not to support scaling to thousands of concurrent threads on multi-processors machines; we're running this on cell-phones, damnit !! Note that Bionic doesn't provide a libthread_db or a libm implementation. Adding new syscalls: ==================== Bionic provides the gensyscalls.py Python script to automatically generate syscall stubs from the list defined in the file SYSCALLS.TXT. You can thus add a new syscall by doing the following: - edit SYSCALLS.TXT - add a new line describing your syscall, it should look like: return_type syscall_name(parameters) syscall_number - in the event where you want to differentiate the syscall function from its entry name, use the alternate: return_type funcname:syscall_name(parameters) syscall_number - additionally, if the syscall number is different between ARM and x86, use: return_type funcname[:syscall_name](parameters) arm_number,x86_number - a syscall number can be -1 to indicate that the syscall is not implemented on a given platform, for example: void __set_tls(void*) arm_number,-1 the comments in SYSCALLS.TXT contain more information about the line format You can also use the 'checksyscalls.py' script to check that all the syscall numbers you entered are correct. It does so by looking at the values defined in your Linux kernel headers. The script indicates where the values are incorrect and what is expected instead.