OSDN Git Service

mkostemp: fix implementation
[uclinux-h8/uClibc.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 9ea7e62..78fe3fc 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -1,83 +1,80 @@
 SOFTWARE REQUIREMENTS
 
-   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.
+   Compiling 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, version 2.4 and version 2.6 are known to work.  Other
+   kernel versions may work but haven'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.
 
 
 CONFIGURING uClibc:
 
- - Check the Rules.mak file and adjust CROSS to specify your cross-
-    compiler if you are cross compiling.
-
- - Use must have a valid configuration file to compile uClibc.  Do not
+ - Users 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.
-
- - 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.
+    release, and odd configuration options are sometimes removed.
+    To configure uClibc, you can run:
 
- - 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'.
+            make menuconfig
+    or
+            make config
 
+    If you have an existing .config file, you can update this file
+    using the
 
+            make oldconfig
 
-COMPILING uClibc:
+    command, which will only ask you about new configuration options.
 
- - Once you have a valid configuration file, just run 'make' to compile 
-    uClibc.  
+    Available configuration commands are:
+        "make config"       Text based configuration, no menus or colors.
+        "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 "no" for all options.
 
 
+COMPILING uClibc:
 
-INSTALLING the uClibc development environment:
+ - 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 
 
- - As root, if necessary, run:
+            make clean
 
-       make install
+ - Once you have a valid configuration file, just run
 
-    This will install the header files, libraries, and the gcc wrapper
-    into the directories defined in Config.
+            make
 
+    to compile uClibc.  or if you are cross compiling, you would
+    instead run something like:
 
-INSTALLING the uClibc target runtime environment:
- - As root, if necessary, run:
+            make CROSS_COMPILE=arm-linux-
 
-       make PREFIX=<temporary path> install_target
 
-   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.
+INSTALLING the uClibc development environment:
 
+ - As root, if necessary, run something like:
 
-USING uClibc:
- - To compile programs with uClibc,
+        make PREFIX=<some path> install
 
-       export PATH={uClibc DEVEL_PREFIX}/bin:$PATH
+    This will install the uClibc runtime and development system (i.e.
+    all the header files, libraries, etc) into the directories defined
+    within your .config file.
 
-    and then just run './configure' and 'make' as usual.
 
-Note: 
+USING uClibc:
 
-       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.
+ - To compile programs with uClibc you will need a complete toolchain
+    (i.e. binutils, gcc, and uClibc) that was built expressly for use
+    with uClibc.
 
+ - Native and cross compiling toolchains, as well as makefiles for creating
+    uClibc toolchains, are available from the uClibc website.  You may want 
+    to check out "buildroot", which is available from the uClibc download area,
+    which provides examples of how to build your own uClibc based system.