Home Explore Help
Sign In
oss
/
uclibc-ng
4
1
Fork 0
Files Issues 3 Pull Requests 0 Wiki
Tree: 5e816a6bb9
Branches Tags
uclibc-ng
/
README

README 2.6 KB
History Raw

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960 
  1. 

  2.   uClibc - a Small C Library for Linux
    3. 

  3.   Erik Andersen <andersen@codepoet.org>
    4. 

  4. 

  5. uClibc (aka µClibc/pronounced yew-see-lib-see) is a C library for
    6. 

  6. developing embedded Linux systems. It is much smaller than the
    7. 

  7. GNU C Library, but nearly all applications supported by glibc
    8. 

  8. also work perfectly with uClibc. Porting applications from glibc
    9. 

  9. to uClibc typically involves just recompiling the source code.
    10. 

  10. uClibc even supports shared libraries and threading. It currently
    11. 

  11. runs on standard Linux and MMU-less (also known as µClinux)
    12. 

  12. systems with support for alpha, ARM, i386, i960, h8300, m68k,
    13. 

  13. mips/mipsel, PowerPC, SH, SPARC, and v850 processors.
    14. 

  14. 

  15. If you are building an embedded Linux system and you find that
    16. 

  16. glibc is eating up too much space, you should consider using
    17. 

  17. uClibc. If you are building a huge fileserver with 12 Terabytes
    18. 

  18. of storage, then using glibc may be a better choice...
    19. 

  19. 

  20. uClibc is maintained by Erik Andersen and is licensed under the
    21. 

  21. GNU LIBRARY GENERAL PUBLIC LICENSE . This license allows you to
    22. 

  22. make closed source commercial applications using uClibc (Please
    23. 

  23. consider sharing some of the money you make ;-). You do not need
    24. 

  24. to give away all your source code just because you use uClibc
    25. 

  25. and/or run on Linux. 
    26. 

  26. 

  27. 

  28. For installation instructions, see the file INSTALL.
    29. 

  29. 

  30. This distribution contains a wrapper for gcc and ld that allows you
    31. 

  31. to use existing toolchains that were targetted for glibc.  See
    32. 

  32. extra/gcc-uClibc/ for information.
    33. 

  33. 

  34. uClibc strives to be standards compliant, which means that most
    35. 

  35. documentation written for functions in glibc also apply to uClibc
    36. 

  36. functions.  However, many GNU extensions are not supported because
    37. 

  37. they have not been ported, or more importantly, would increase the
    38. 

  38. size of uClibc disproportional to the added functionality.
    39. 

  39. 

  40. Additional information (recent releases, FAQ, mailing list, bugs,
    41. 

  41. etc.) can be found at http://www.uclibc.org/.
    42. 

  42. 

  43. uClibc may be freely modified distributed under the terms of the
    44. 

  44. GNU Library General Public License, which can be found in the
    45. 

  45. file COPYING.LIB.
    46. 

  46. 

  47. Please Note:
    48. 

  48. 

  49. 	There is an unwholesomely huge amount of code out there
    50. 

  50. 	that depends on the presence of GNU libc header files.
    51. 

  51. 	We have GNU libc header files.  So we have committed a
    52. 

  52. 	horrible sin in uClibc.  We _lie_ and claim to be GNU
    53. 

  53. 	libc in order to force these applications to work as their
    54. 

  54. 	developers intended.  This is IMHO, pardonable, since
    55. 

  55. 	these defines are not really intended to check for the
    56. 

  56. 	presence of a particular library, but rather are used to
    57. 

  57. 	define an _interface_.  Some programs (such as GNU
    58. 

  58. 	binutils) are especially chummy with glibc, and need this
    59. 

  59. 	behavior disabled by adding CFLAGS+=-D__FORCE_NOGLIBC
    60. 

  60.