INSTALL 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283
  1. SOFTWARE REQUIREMENTS
  2. Compiling and running uClibc requires Linux kernel header files.
  3. uClibc will be compiled to match the interfaces available in the
  4. provided version of the Linux kernel headers. Linux kernel version
  5. 2.0, version 2.2, and version 2.4 are known to work. Other kernel
  6. versions may work but havn't been tested. Its also helpful to have
  7. a working version of GNU binutils, and GNU gcc -- using excessively
  8. old versions of these packages can cause very strange errors that
  9. are difficult to find and fix.
  10. CONFIGURING uClibc:
  11. - Check the Rules.mak file and adjust CROSS to specify your cross-
  12. compiler if you are cross compiling.
  13. - Use must have a valid configuration file to compile uClibc. Do not
  14. skip this step. New configuration options are added in each
  15. release, and odd problems will turn up if your configuration file
  16. is not set up as expected. If you want to carry your existing
  17. configuration to a new version with minimal work, use "make
  18. oldconfig", which will only ask you for the answers to new
  19. questions.
  20. - Available configuration commands are:
  21. "make menuconfig" Text based color menus, radiolists & dialogs.
  22. "make oldconfig" Default all questions based on the contents of
  23. your existing ./.config file.
  24. "make defconfig" Use defaults for all options.
  25. "make randconfig" Use random values for all options.
  26. "make allyesconfig" Set all values to "yes" for all options.
  27. "make allnoconfig" Set all values to "yes" for all options.
  28. - uClibc does not have proper dependancy checking (yet) so if you
  29. change your uClibc configuration, you must current rebuild the
  30. entire library, by first running 'make clean'.
  31. COMPILING uClibc:
  32. - Once you have a valid configuration file, just run 'make' to compile
  33. uClibc.
  34. INSTALLING the uClibc development environment:
  35. - As root, if necessary, run:
  36. make install
  37. This will install the header files, libraries, and the gcc wrapper
  38. into the directories defined in Config.
  39. INSTALLING the uClibc target runtime environment:
  40. - As root, if necessary, run:
  41. make PREFIX=<temporary path> install_target
  42. This will install only the files that are necessary to run
  43. binaries compiled against uClibc. Hint: You probably do not want
  44. to install the target runtime environment into /lib on your host
  45. machine.
  46. USING uClibc:
  47. - To compile programs with uClibc,
  48. export PATH={uClibc DEVEL_PREFIX}/bin:$PATH
  49. and then just run './configure' and 'make' as usual.
  50. Note:
  51. You may also want to look at extra/gcc-uclibc/gcc-uclibc.c for
  52. additional information concerning what options and environment
  53. variables the gcc wrapper handles.