|
@@ -1,48 +1,79 @@
|
|
|
+SOFTWARE REQUIREMENTS
|
|
|
|
|
|
-* Configuration:
|
|
|
+ Compiling and running uClibc requires Linux kernel header files.
|
|
|
+ uClibc will be compiled to match the interfaces available in the
|
|
|
+ provided version of the Linux kernel headers. Linux kernel version
|
|
|
+ 2.0, version 2.2, and version 2.4 are known to work. Other kernel
|
|
|
+ versions may work but havn't been tested. Its also helpful to have
|
|
|
+ a working version of GNU binutils, and GNU gcc -- using excessively
|
|
|
+ old versions of these packages can cause very strange errors that
|
|
|
+ are difficult to find and fix.
|
|
|
|
|
|
- ln -s ./extra/Configs/Config.<arch> ./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/<arch>-linux-uclibc/.
|
|
|
+CONFIGURING uClibc:
|
|
|
|
|
|
+ - Check the Rules.mak file and adjust CROSS to specify your cross-
|
|
|
+ compiler if you are cross compiling.
|
|
|
|
|
|
-* Building:
|
|
|
+ - Use must have a valid configuration file to compile uClibc. Do not
|
|
|
+ skip this step. New configuration options are added in each
|
|
|
+ release, and odd problems will turn up if your configuration file
|
|
|
+ is not set up as expected. If you want to carry your existing
|
|
|
+ configuration to a new version with minimal work, use "make
|
|
|
+ oldconfig", which will only ask you for the answers to new
|
|
|
+ questions.
|
|
|
|
|
|
- make
|
|
|
+ - Available configuration commands are:
|
|
|
+ "make menuconfig" Text based color menus, radiolists & dialogs.
|
|
|
+ "make oldconfig" Default all questions based on the contents of
|
|
|
+ your existing ./.config file.
|
|
|
+ "make defconfig" Use defaults for all options.
|
|
|
+ "make randconfig" Use random values for all options.
|
|
|
+ "make allyesconfig" Set all values to "yes" for all options.
|
|
|
+ "make allnoconfig" Set all values to "yes" for all options.
|
|
|
|
|
|
+ - uClibc does not have proper dependancy checking (yet) so if you
|
|
|
+ change your uClibc configuration, you must current rebuild the
|
|
|
+ entire library, by first running 'make clean'.
|
|
|
|
|
|
-* Installing the development environment:
|
|
|
|
|
|
-(As root, if necessary,)
|
|
|
|
|
|
- make install
|
|
|
+COMPILING uClibc:
|
|
|
|
|
|
-This will install the header files, libraries, and the gcc
|
|
|
-wrapper into the directories defined in Config.
|
|
|
+ - Once you have a valid configuration file, just run 'make' to compile
|
|
|
+ uClibc.
|
|
|
|
|
|
|
|
|
-* Installing the target runtime environment:
|
|
|
|
|
|
-(As root, if necessary,)
|
|
|
+INSTALLING the uClibc development environment:
|
|
|
|
|
|
- make PREFIX=<temporary path> install_target
|
|
|
+ - As root, if necessary, run:
|
|
|
|
|
|
-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.
|
|
|
+ make install
|
|
|
|
|
|
+ This will install the header files, libraries, and the gcc wrapper
|
|
|
+ into the directories defined in Config.
|
|
|
|
|
|
-* Using uClibc:
|
|
|
|
|
|
-To compile programs with uClibc,
|
|
|
+INSTALLING the uClibc target runtime environment:
|
|
|
+
|
|
|
+ - As root, if necessary, run:
|
|
|
|
|
|
- export PATH={uClibc DEVEL_PREFIX}/bin:$PATH
|
|
|
+ make PREFIX=<temporary path> install_target
|
|
|
|
|
|
-and then just ./configure and make as usual.
|
|
|
+ This will install only the files that are necessary to run
|
|
|
+ binaries compiled against uClibc. Hint: You probably do not want
|
|
|
+ to install the target runtime environment into /lib on your host
|
|
|
+ machine.
|
|
|
+
|
|
|
+
|
|
|
+USING uClibc:
|
|
|
+
|
|
|
+ - To compile programs with uClibc,
|
|
|
+
|
|
|
+ export PATH={uClibc DEVEL_PREFIX}/bin:$PATH
|
|
|
+
|
|
|
+ and then just run './configure' and 'make' as usual.
|
|
|
|
|
|
Note:
|
|
|
|