bionic/libc
Elliott Hughes 52d6233296 Report errors to the log, not just stderr.
In particular this affects assert(3) and __cxa_pure_virtual, both of
which have managed to confuse people this week by apparently aborting
without reason. (Because stderr goes nowhere, normally.)

Bug: 6852995
Bug: 6840813
Change-Id: I7f5d17d5ddda439e217b7932096702dc013b9142
2012-07-27 17:43:38 -07:00
..
arch-arm arm: rewrite crtbegin* as C files. 2012-06-01 14:41:27 -07:00
arch-mips resolved conflicts for merge of e5408907 to jb-dev-plus-aosp 2012-05-09 13:53:37 -07:00
arch-sh/syscalls am 70cf0bc0: Merge "Remove the last references to SuperH." 2012-05-16 17:18:23 -07:00
arch-x86 arm: rewrite crtbegin* as C files. 2012-06-01 14:41:27 -07:00
bionic Report errors to the log, not just stderr. 2012-07-27 17:43:38 -07:00
docs libc: Fix the definition of SIGRTMAX 2010-12-20 15:58:06 +01:00
include Fix implementation of generic atomic operations 2012-07-24 13:56:38 -07:00
inet inet_ntop: pass the size of tmp to snprintf() 2012-06-11 16:00:52 -07:00
kernel Merge "Modify ion header" 2012-06-28 14:16:10 -07:00
netbsd am c5cab345: am 028ccf5d: Merge "Avoid multiple dns lookups for the same query" 2012-06-12 15:56:29 -07:00
private Report errors to the log, not just stderr. 2012-07-27 17:43:38 -07:00
regex Remove compiler warnings when building Bionic. 2010-06-22 17:51:41 -07:00
stdio vfprintf: fix spelling. 2012-07-25 16:01:38 -07:00
stdlib Report errors to the log, not just stderr. 2012-07-27 17:43:38 -07:00
string FORTIFY_SOURCE: revert memcpy changes. 2012-07-13 17:58:37 -07:00
tools Remove the 'Factory' time zone by not processing the 'factory' file. 2012-07-26 16:19:46 -07:00
tzcode libc: remove private declarations from <time.h> and <resolv.h> 2012-01-13 14:24:08 +01:00
unistd Report errors to the log, not just stderr. 2012-07-27 17:43:38 -07:00
wchar wchar.h: improve wchar_t support in Bionic 2010-06-15 07:04:41 -07:00
zoneinfo Replace ALL_PREBUILTS with BUILD_PREBUILT 2012-07-27 13:44:01 -07:00
Android.mk FORTIFY_SOURCE: strlen check. 2012-07-13 13:49:59 -07:00
CAVEATS auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
MODULE_LICENSE_BSD auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
NOTICE Clean up NOTICE files. 2010-10-19 15:12:40 -07:00
README Add an 's and a . to the bionic/libc README. 2009-07-23 17:41:47 -07:00
SYSCALLS.TXT resolved conflicts for merge of e5408907 to jb-dev-plus-aosp 2012-05-09 13:53:37 -07:00

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.