From e261c8f8e55fccea5e9ae4e26cdb6c837e17304c Mon Sep 17 00:00:00 2001 From: David Schleef Date: Sat, 20 Apr 2002 23:26:32 +0000 Subject: Moved old README to INSTALL, and wrote a new README that is much more like an introduction to the project. --- README | 82 +++++++++++++++++++++++------------------------------------------- 1 file changed, 28 insertions(+), 54 deletions(-) (limited to 'README') diff --git a/README b/README index fd882fc44..5ebe3bda4 100644 --- a/README +++ b/README @@ -1,64 +1,38 @@ -* Configuration: + uClibc - a small libc implementation + Erik Andersen - ln -s ./extra/Configs/Config. ./Config -Then edit ./Config for your setup. In particular, modify CROSS and -KERNEL_SOURCE as necessary. You may also want to modify -SHARED_LIB_LOADER_PATH, DEVEL_PREFIX, and SYSTEM_DEVEL_PREFIX depending -on where you want to install the development environment. By default, -the development environment is installed into /usr/-linux-uclibc/. +uClibc (aka µClibc/pronounced yew-see-lib-see) is size-optimized +implementation of the standard C library. The primary use is +for developing embedded Linux systems. It is much smaller then +the GNU C Library (glibc), but nearly all applications supported +by glibc also compile and work perfectly with uClibc. Porting +applications from glibc to uClibc typically involves just +recompiling the source code. uClibc even supports shared +libraries and threading. It currently runs on standard Linux +and MMU-less Linux (also known as µClinux) systems on the +following processors: ARM, i386, h8300, m68k, mips, mipsel, +PowerPC, SH, SPARC, and v850. +For installation instructions, see the file INSTALL. -* Building: +This distribution contains a wrapper for gcc and ld that allows +you to use existing toolchains that were targetted for glibc. +See extra/gcc-uClibc/ for information. - make +uClibc strives to be standards compliant, which means that most +documentation written for functions in glibc also apply to uClibc +functions. However, many GNU extensions are not supported +because they have not been ported, or more importantly, would +increase the size of uClibc disproportional to the added +functionality. +Additional information (recent releases, FAQ, mailing list, bugs, +etc.) can be found at http://www.uclibc.org/. -* Installing the development environment: +uClibc may be freely modified distributed under the terms of the +GNU Library General Public License, which can be found in the +file COPYING.LIB. -(As root, if necessary,) - make install - -This will install the header files, libraries, and the gcc -wrapper into the directories defined in Config. - - -* Installing the target runtime environment: - -(As root, if necessary,) - - make PREFIX= install_target - -This installs only the files that are necessary to run binaries -compiled against uClibc. Hint: You probably do not want to install -the target runtime environment on your host machine. - - -* Using uClibc: - -To compile programs with uClibc, - - export PATH={uClibc DEVEL_PREFIX}/bin:$PATH - -and then just ./configure and make as usual. - -Note: - - You may also want to look at extra/gcc-uclibc/gcc-uclibc.c for - additional information concerning what options and environment - variables the gcc wrapper handles. - -Note2: - - There is an unwholesomely huge amount of code out there that - depends on the presence of GNU libc header files. We have GNU - libc header files. So we have committed a horrible sin in - uClibc. We _lie_ and claim to be GNU libc in order to force - many applications to work as their developers intended. This - is IMHO, pardonable, since these defines are not really - intended to check for the presence of a particular library, but - rather are used to define an _interface_. Some programs (such - as GNU binutils) are especially chummy with glibc, and need - this behavior disabled by adding CFLAGS+=-D__FORCE_NOGLIBC -- cgit v1.2.3