summaryrefslogtreecommitdiffstats
path: root/libc/CAVEATS
blob: 72281a010fcc7d9120b3823eda589521258feb80 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
Bionic is a very small C library because we have decided to *not* implement various features
of the POSIX standard. we only add functions on a as-needed basis, and there are a few things
we wish we'll never put in there.

this file is here to document explicitely what we don't want to support in Bionic:

- C++ exceptions are not supported. on embedded systems, they lead to extremely larger and
  slower code for no good reason (even when so-called zero-cost exception schemes are
  implemented, they enforce very large numbers of registers spills to the stack, even
  in functions that do not throw an exception themselves).

- pthread cancellation is *not* supported. this seemingly simple "feature" is the source
  of much bloat and complexity in a C library. Besides, you'd better write correct
  multi-threaded code instead of relying on this stuff.

- pthread_once() doesn't support C++ exceptions thrown from the init function, or the init
  function doing a fork().

- locales and wide characters are not supported. we use ICU for all this i18n stuff, which
  is much better than the ill-designed related C libraries functions.

- at the moment, several user-account-related functions like getpwd are stubbed and return
  the values corresponding to root. this will be fixed when we'll be able to have distinct
  users on the Android filesystem. :-(

  see bionic/stubs.c for the details