libc/docs/CHANGES.TXT

   1 Bionic ChangeLog:
   2 -----------------
   3
   4 Differences between current and Android 2.3:
   5
   6 - <android/api-level.h>: Added new header to define __ANDROID_API__ to
   7   a constant integer corresponding to the native API level. This header
   8   also exists in the NDK's platform headers.
   9
  10 - <sys/cdefs.h>: Include <android/api-level.h>
  11
  12 - <time.h>: Add timegm(), timelocal(), time2posix() and posix2time()
  13
  14 - <sched.h>: Add sched_getcpu(), sched_getaffinity(), sched_setaffinity(),
  15   cpu_set_t and related macros (e.g. CPU_SETSIZE, CPU_ZERO, CPU_SET, ...)
  16
  17 - <unistd.h>: Add ftruncate64().
  18
  19 - <signal.h>: Changed the definition of SIGRTMAX to 64. However, note that
  20   sigset_t is only 32-bit and cannot deal with real-time signals.
  21
  22 -------------------------------------------------------------------------------
  23 Differences between Android 2.3 and Android 2.2:
  24
  25 - <pthread.h>: Add reader/writer locks implementation. Add sanity
  26   checking to pthread_mutex_destroy() (e.g. a locked mutex will return
  27   EBUSY).
  28
  29 - <semaphore.h>: Use private futexes for semaphore implementation,
  30   unless your set 'pshared' to non-0 when calling sem_init().
  31
  32   Also fixed a bug in sem_post() to make it wake up all waiting
  33   threads, instead of one. As a consequence, the maximum semaphore
  34   value is now reduced to 0x3fffffff.
  35
  36 - <math.h>: Added sincos(), sincosf() and sincosl() (GLibc compatibility).
  37
  38 - <sys/sysinfo.h>: Added missing sysinfo() system call implementation
  39   (the function was already declared in the header though).
  40
  41 - sysconf() didn't work for some arguments due to a small bug in the
  42   /proc line parser.
  43
  44 - <termio.h>: added missing header (just includes <termios.h>)
  45
  46 - <unistd.h>: add missing declaration for truncate(). The implementation
  47   was already here since Android 1.5.
  48
  49   modify implementation of alarm() to return 0 in case of error (i.e.
  50   if a value larger than 0x7fffffff seconds is passed to it). This
  51   makes the implementation compliant with the GLibc behaviour.
  52
  53 - <wchar.h>: small fixes to really support wchar_t in Bionic (not there yet).
  54
  55      the size of wchar_t is still 32-bit (decided by the compiler)
  56
  57      WCHAR_MIN: changed from 0 to INT_MIN
  58      WCHAR_MAX: changed from 255 to INT_MAX
  59
  60      wcpcpy(), wcpncpy(), wcscat(), wcschr(), wcscmp(),
  61      wcscpy(), wcscspn(), wcsdup(), wcslcat(), wcslcpy(),
  62      wcslen(), wcsncat(), wcsncmp(), wcsncpy(), wcsnlen(),
  63      wcspbrk(), wcsrchr(), wcsrchr(), wcsspn(), wcsstr(),
  64      wcstok(), wcswidth(), wmemchr(), wmemcmp(), wmemcpy(),
  65      wmemmove(), wmemset(): Added proper implementations.
  66
  67      wcscasecmp(), wcsncasecmp(): Added implementation limited
  68      to ASCII codes for lower/upper.
  69
  70      wcscoll(): added dummy implementation that calls wcscmp()
  71      wcsxfrm(): added dummy implementation that calls wcsncpy()
  72
  73   NOTE: Technically, this breaks the ABI, but we never claimed to support
  74         wchar_t anyway. The wchar_t support is still *NOT* official at this
  75         point. We need better multi-byte support code, and wprintf/wscanf
  76         stuff too.
  77
  78 - <inttypes.h>: add missing declarations for strntoimax abd strntoumax.
  79
  80 - <stdlib.h>: add missing declarations for drand48() and erand48().
  81
  82 - clearerr(): fix broken implementation.
  83
  84 - Feature test macros like _POSIX_C_SOURCE / _XOPEN_SOURCE / _C99_SOURCE
  85   are now handled correctly by our C library headers (see <sys/cdefs.h>)
  86
  87 - <sys/select.h>: add missing declaration for pselect()
  88
  89 - <sys/vfs.h>: fixed implementation of fstatfs() (also fixes fpathconf()
  90   which uses it).
  91
  92 - Added an implementation of pthread_atfork()
  93
  94 - <dlfcn.h>: fixed dlopen() implementation to support dlopen(NULL, ...).
  95   This allows one to look at the dynamic symbols exported by an executable.
  96
  97 - <private/bionic_tls.h>: use kernel helper functions for static versions
  98   of the C library. This is necessary because we don't know where the corresponding
  99   machine code is going to run, and the optimization for __get_tls() might
 100   not match the features of the target device where we run a static executable
 101   linked to the C library. This fixes one of the bug that explains why gdbserver
 102   didn't work well with threads.
 103
 104 -------------------------------------------------------------------------------
 105 Differences between Android 2.2. and Android 2.1:
 106
 107 - Support FP register save/load in setjmp()/longjmp() on ARMv7 builds.
 108
 109 - Add support for SH-4 CPU architecture !
 110
 111 - __atomic_swap(): use LDREX/STREX CPU instructions on ARMv6 and higher.
 112
 113 - <arpa/telnet.h>: New header (declarations only, no implementation).
 114
 115 - <err.h>: New header + implementation. GLibc compatibility.
 116
 117 - <warn.h>: New header + implementation. GLibc compatibility.
 118
 119 - <fts.h>: New header + implementation.
 120
 121 - <mntent.h>: Add missing <stdio.h> include.
 122
 123 - <regex.h>: New header + implementation.
 124
 125 - <signal.h>: Added killpg()
 126
 127 - <stdint.h>: Allow 64-bit type declarations on C99 builds.
 128
 129 - <stdio.h>: Add fdprintf() and vfdprintf(). Note that GLibc provides
 130   the confusing 'dprintf' and 'vdprintf()' functions instead.
 131
 132 - <stdlib.h>: Fix ptsname_r(): the return type is int instead of char*.
 133   The mistake comes from a GLibc man page bug (the man page listed a return
 134   type of char*, while the implementation used int. Fixed in late 2009 only).
 135   The Bionic implementation was incorrect. Technically, this is an ABI
 136   breakage, but code that used this function probably never worked or
 137   compiled properly anyway.
 138
 139 - <strings.h>: Add missing <sys/types.h> include.
 140
 141 - <sys/queue.h>: Added new header (no implementation - macro templates).
 142
 143 - <sys/resource.h>: Add rlim_t proper definition.
 144
 145 - <time64.h>: Add missing C++ header inclusion guards.
 146
 147 - <unistd.h>: Add getusershell(), setusershell() and endusershell(), though
 148   implementation are bogus. GLibc compatibility.
 149
 150 - <wchar.h>: Add mbstowcs() and wcstombs()
 151
 152 - add clone() implementation for ARM (x86 and SH-4 not working yet).
 153
 154 - <sys/epoll.h>: <sys/system_properties.h>: Add missing C++ inclusion guards
 155
 156 - fix getpwnam() and getpwgrp() to accept "app_0" as a valid user name.
 157
 158 - fix sem_trywait() to return -1 and set errno to EAGAIN, instead of
 159   returning EAGAIN directly.
 160
 161 - fix sem_post() to wake up multiple threads when called rapidly in
 162   succession.
 163
 164 - DNS: partial implementation of RFC3484 (rule 1, 2, 5, 6, 8, 10 and
 165   modified rule 9), for better address selection/sorting.
 166   In the process, removed code that was previously used for "sortlist"
 167   in /etc/resolv.conf. (resolv.conf is already ignored, so the latter
 168   is a no-op for actual functionality.)
 169
 170 - fix pthread_sigmask() to properly return an error code without touching
 171   errno. Previous implementation returned -1 on error, setting errno, which
 172   is not Posix compliant.
 173
 174 - add sigaltstack() implementation for ARM.
 175
 176 - <time.h>: Properly implement the 'timezone' and 'daylight' global variables
 177   (they were not defined previously, though declared in the header).
 178
 179 - <time.h>: Fix timezone management implementation to properly update
 180   'tm_gmtoff' field in 'struct tm' structure.
 181
 182 - DNS: get rid of spurious random DNS queries when trying to resolve
 183   an unknown domain name. Due to an initialization bug, a random DNS search
 184   list was generated for each thread if net.dns.search is not defined.
 185
 186 - <pthread.h>: Add pthread_condattr_init/destroy/setpshared/getpshared functions
 187   to enable proper shared conditional variable initialization.
 188
 189   Modify the pthread_mutex_t and pthread_cond_t implementation to use private
 190   futexes for performance reasons. Mutexes and Condvars are no longer shareable
 191   between processes by default anymore, unless you use PTHREAD_PROCESS_SHARED
 192   with pthread_mutexattr_setpshared() and/or pthread_condattr_setpshared().
 193
 194 -------------------------------------------------------------------------------
 195 Differences between Android 2.1 and 2.0.1:
 196
 197 - zoneinfo: updated data tables to version 2009s
 198
 199
 200 -------------------------------------------------------------------------------
 201 Differences between Android 2.0.1 and 2.0:
 202
 203 - abort(): ARM-specific hack to preserve the 'lr' register when abort()
 204   is called (GCC does not preserve it by default since it thinks that
 205   abort() never returns). This improves stack traces considerably.
 206
 207
 208 -------------------------------------------------------------------------------
 209 Differences between Android 2.0 and 1.6:
 210
 211 - memcmp(), memcpy(): ARMv7 optimized versions.
 212
 213 - pthread_mutexattr_setpshared(): implementation will not return ENOTSUP
 214   if PTHREAD_PROCESS_SHARED is used, because our Mutex implementation can
 215   work across multiple processes.
 216
 217   *HOWEVER* it does not use "robust futexes" which means that held mutexes
 218   *are not* automatically released by the kernel when the owner process
 219   crashes or exits. This is only done to simplify communication between
 220   two always-live system processes, DO NOT USE THIS IN APPLICATIONS !
 221
 222 - pthread_mutex_lock_timeout_np(): New Android-specific function to
 223   perform a timed lock (). In case of timeout, it returns EBUSY.
 224
 225 - pthread_cond_timedwait_monotonic_np(): Same as pthread_cond_timedwait()
 226   but uses the monotonic clock(). Android-specific.
 227
 228 - pthread_cond_timedwait_relative_np(): Same as pthread_cond_timedwait()
 229   but uses a relative timeout instead. Android-specific.
 230
 231 - <netinet/in.h>: Now includes <netinet/in6.h>.
 232
 233 - <netinet/in6.h>: Added IPV6_JOIN_GROUP, IPV6_LEAVE_GROUP, IN6ADDR_ANY_INIT
 234   and ipv6mr_interface definitions.
 235
 236 - <time.h>:
 237     * Add missing tzset() declaration.
 238     * Add Android-specific strftime_tz().
 239
 240 - getaddrinfo():
 241     Only perform IPv6 lookup for AF_UNSPEC if we have IPv6 connectivity.
 242     This saves one DNS query per lookup on non-IPv6 systems.
 243
 244 - mktime(): Fix an infinite loop problen that appeared when switching to
 245   GCC 4.4.0.
 246
 247 - strftime(): fix incorrect handling of dates > 2038 due to 64-bit issue
 248   in original code.
 249
 250 -------------------------------------------------------------------------------
 251 Differences between Android 1.6 and 1.5:
 252
 253 - C runtime: Fix runtime initialization to be called before any static C++
 254   constructors. This allows these to use pthread functions properly.
 255
 256 - __aeabi_atexit(): Fix implementation to properly call C++ static destructors
 257   when the program exits (or when a shared library is unloaded).
 258
 259 - <sys/stat.h>: added GLibc compatibility macros definitions:
 260
 261         #define  st_atimensec  st_atime_nsec
 262         #define  st_mtimensec  st_mtime_nsec
 263         #define  st_ctimensec  st_ctime_nsec
 264
 265 - getaddrinfo(): implementation will now allow numeric ports if ai_socktype is
 266   set to ANY. This is to match the GLibc behaviour.
 267
 268 - getservent(): and getservent_r() incorrectly returned the port in host-endian
 269   order in the s_port field. It now returns it in big-endian order.
 270
 271 - DNS: Allow underscore in the middle of DNS labels. While not really
 272   standard, this extension is needed for some VPN configurations and is
 273   supported by other operating systems.
 274
 275 - DNS: Support for DNS domain search lists through the new net.dns.search
 276   system property. The corresponding value must be a space-separated list of
 277   domain suffixes.