fix non-thread compile for xtensa
[uclibc-ng.git] / README
blob002b6f9e8304712b83b95dc16a8b80b1dd1fe016
1   uClibc-ng - a small C Library for Linux
3 uClibc-ng (aka µClibc-ng/pronounced yew-see-lib-see-next-generation) is a C
4 library for developing embedded Linux systems. It is much smaller than the GNU
5 C Library, but nearly all applications supported by glibc also work perfectly
6 with uClibc-ng.
8 uClibc-ng is a spin-off of uClibc from http://www.uclibc.org
9 from Erik Andersen and others.
11 Porting applications from glibc to uClibc-ng typically involves just
12 recompiling the source code.  uClibc-ng even supports shared libraries and
13 threading. It currently runs on standard Linux and MMU-less (also
14 known as µClinux) systems with support for ARC, ARM, Blackfin, i386, M68K/Coldfire
15 MIPS, MIPS64, PowerPC, SH, Sparc, X86_64 and XTENSA processors.
17 If you are building an embedded Linux system and you find that
18 glibc is eating up too much space, you should consider using
19 uClibc-ng.  If you are building a huge fileserver with 12 Terabytes
20 of storage, then using glibc may make more sense.  Unless, for
21 example, that 12 Terabytes will be Network Attached Storage and
22 you plan to burn Linux into the system's firmware...
24 uClibc-ng is maintained by Waldemar Brodkorb and is licensed under the
25 GNU LESSER GENERAL PUBLIC LICENSE.  This license allows you to
26 make closed source commercial applications using an unmodified
27 version of uClibc-ng. You do not need to give away all your source code just
28 because you use uClibc-ng and/or run on Linux.  You should, however,
29 carefuly review the license and make certain you understand and
30 abide by it strictly.
32 For installation instructions, see the file INSTALL.
34 uClibc-ng strives to be standards compliant, which means that most
35 documentation written for SuSv3, or for glibc also applies to
36 uClibc-ng functions.  However, many GNU extensions are not supported
37 because they have not been ported, or more importantly, would
38 increase the size of uClibc-ng disproportional to the added
39 functionality.
41 Additional information can be found at http://www.uclibc-ng.org/.
43 uClibc-ng may be freely modified and distributed under the terms of
44 the GNU Lesser General Public License, which can be found in the
45 file COPYING.
47 And most of all, be sure to have some fun! :-)
48  -Waldemar