INSTALL

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