bionic/libc
vinay harugop 76ec6891e2 ARM architecture reference manuals for ARMv6 & ARMv7 state that the use of 'swp' instruction is deprecated
ARMv6 onwards. These architectures provide the load-linked, store-conditional pair of ldrex/strex whose use
is recommended in place of 'swp'. Also, the description of the 'swp' instruction in the ARMv6 reference
manual states that the swap operation does not include any memory barrier guarantees.This fix attempts to
address these issues by providing an atomic swap implementation using ldrex/strex under _ARM_HAVE_LDREX_STREX
macro.  This Fix is verified on ST Ericsson's U8500 platform and Submitted on behalf of a third-party:
Surinder-pal SINGH from STMicroelectronics.
2009-09-09 21:01:46 +05:30
..
arch-arm ARM architecture reference manuals for ARMv6 & ARMv7 state that the use of 'swp' instruction is deprecated 2009-09-09 21:01:46 +05:30
arch-x86 Revert "Fix the C library initialization to avoid calling static C++ constructors twice." 2009-06-03 19:32:37 +02:00
bionic Changed logging functions in bionic/logd_write.c. 2009-08-25 10:27:26 -07:00
docs Fix getservent() so that it returns s_port in network byte order. 2009-05-27 00:01:11 +02:00
include Merge change 10749 2009-08-21 11:25:21 -07:00
inet auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
kernel Add <linux/uinput.h> to C library kernel headers 2009-07-10 00:59:56 +02:00
netbsd Include <endian.h> instead of <sys/endian.h>, 2009-08-31 15:42:09 +08:00
private Pass the elfdata pointer in a slot of the temporary TLS area. 2009-07-17 17:55:01 +02:00
stdio auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
stdlib Fix __eabi_atexit() implementation, as well as a bug in the BSD-originated __cxa_finalize() implementation 2009-05-20 11:42:52 +02:00
string auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
tools auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
tzcode auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
unistd auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
zoneinfo auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
Android.mk libc: Add an intermediate version of the static libc without malloc 2009-05-27 20:16:19 -07:00
CAVEATS auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
Jamfile 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 auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08:00
README Add an 's and a . to the bionic/libc README. 2009-07-23 17:41:47 -07:00
SYSCALLS.TXT auto import from //depot/cupcake/@135843 2009-03-03 19:28:35 -08: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.