Undefine __USE_STRING_INLINES.
[kopensolaris-gnu/glibc.git] / INSTALL
diff --git a/INSTALL b/INSTALL
index 6664aad..8897804 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -76,6 +76,23 @@ you run `configure':
      static library is compiled with no optimization and full debugging
      information, and installed as `-lc_g'.
 
+`--enable-bounded'
+`--disable-bounded'
+     Enable or disable building of the C library with support for bounded
+     pointers.  To do this one need the enhanced version of the GNU CC
+     with can generate code for bounded pointers.  This version of the
+     C library is necessary to run code which is also compiled using the
+     enhanced gcc for debugging purposes.
+
+There are two more options:
+
+`--with-gmp'
+`--with-gettext'
+     These options are not of much use for the normal installer of the
+     GNU libc.  Only maintainers need this to get automatic updates of
+     the files from these packages in the GNU C library source tree.
+
+
    The simplest way to run `configure' is to do it in the directory
 that contains the library sources.  This prepares to build the library
 in that very directory.
@@ -157,7 +174,7 @@ build the GNU C library:
      recommend you port GNU `make' instead.  *Really.* We recommend
      version GNU `make' version 3.75 or later.
 
-   * GCC 2.7.2
+   * GCC 2.7.2.1
 
      On most platforms, the GNU C library can only be compiled with the
      GNU C compiler.  We recommend GCC version 2.7.2 or later; earlier
@@ -177,14 +194,22 @@ Supported Configurations
    The GNU C Library currently supports configurations that match the
 following patterns:
 
-     alpha-dec-osf1
      alpha-ANYTHING-linux
      alpha-ANYTHING-linuxecoff
-     iX86-ANYTHING-bsd4.3
      iX86-ANYTHING-gnu
+     iX86-ANYTHING-linux
+     m68k-ANYTHING-linux
+     mips-ANYTHING-linux
+     sparc-ANYTHING-linux
+     powerpc-ANYTHING-linux
+
+   Former versions of this library used to support the following
+configurations but the current status is unknown:
+
+     alpha-dec-osf1
+     iX86-ANYTHING-bsd4.3
      iX86-ANYTHING-isc2.2
      iX86-ANYTHING-isc3.N
-     iX86-ANYTHING-linux
      iX86-ANYTHING-sco3.2
      iX86-ANYTHING-sco3.2v4
      iX86-ANYTHING-sysv
@@ -203,7 +228,7 @@ following patterns:
      sparc-sun-solaris2.N
      sparc-sun-sunos4.N
 
-   Each case of `iX86' can be `i386', `i486', `i586', or `i686'..  All
+   Each case of `iX86' can be `i386', `i486', `i586', or `i686'.  All
 of those configurations produce a library that can run on any of these
 processors.  The library will be optimized for the specified processor,
 but will not use instructions not available on all of them.
@@ -647,10 +672,10 @@ level of the `sysdeps' hierarchy.  This directory contains
 subdirectories (and subdirectory trees) for various Unix variants.
 
    The functions which are system calls in most Unix systems are
-implemented in assembly code in files in `sysdeps/unix'.  These files
-are named with a suffix of `.S'; for example, `__open.S'.  Files ending
-in `.S' are run through the C preprocessor before being fed to the
-assembler.
+automatically generated from the `syscalls.list' files for the appropriate
+archirecture.  The format of the syscalls.list files is quite easy: only
+a few informations are necessary line the system call name, the number of
+arguments and such.  The files are run through the C preprocessor.
 
    These files all use a set of macros that should be defined in
 `sysdep.h'.  The `sysdep.h' file in `sysdeps/unix' partially defines
@@ -746,6 +771,10 @@ parts of the library were contributed or worked on by other people.
    * The port to Linux/m68k (`m68k-ANYTHING-linux') was contributed by
      Andreas Schwab.
 
+   * The ports to Linux/ARM (`arm-ANYTHING-linuxaout') and ARM standalone
+     (`arm-ANYTHING-none'), as well as parts of the IPv6 support code, were
+     contributed by Philip Blundell.
+
    * Richard Henderson contributed the ELF dynamic linking code and
      other support for the Alpha processor.
 
@@ -768,9 +797,10 @@ parts of the library were contributed or worked on by other people.
      platforms was written by Per Bothner and modified by Ulrich
      Drepper.
 
-   * The Internet-related code (most of the `inet' subdirectory) and
-     several other miscellaneous functions and header files have been
-     included from 4.4 BSD with little or no modification.
+   * Some of the Internet-related code (most of the `inet'
+     subdirectory) and several other miscellaneous functions and
+     header files have been included from 4.4 BSD with little or no
+     modification.
 
      All code incorporated from 4.4 BSD is under the following
      copyright:
@@ -912,3 +942,183 @@ parts of the library were contributed or worked on by other people.
           extensions that they make and grant Carnegie Mellon the
           rights to redistribute these changes.
 
+   * The `getaddrinfo' function is written by Craig Metz and it has the
+     following copyright:
+
+       The Inner Net License, Version 2.00
+       ===================================
+
+       The author(s) grant permission for redistribution and use in source and
+       binary forms, with or without modification, of the software
+       and documentation provided that the following conditions are met:
+
+       0. If you receive a version of the software that is
+          specifically labelled as not being for redistribution
+          (check the version message and/or README), you are not
+          permitted to redistribute that version of the software in
+          any way or form.
+       1. All terms of the all other applicable copyrights and
+          licenses must be followed.
+       2. Redistributions of source code must retain the authors'
+          copyright notice(s), this list of conditions, and the
+          following disclaimer.
+       3. Redistributions in binary form must reproduce the authors'
+          copyright notice(s), this list of conditions, and the
+          following disclaimer in the documentation and/or other
+          materials provided with the distribution.
+       4. All advertising materials mentioning features or use of
+          this software must display the following acknowledgement
+          with the name(s) of the authors as specified in the
+          copyright notice(s) substituted where indicated:
+
+       This product includes software developed by <name(s)>, The Inner
+       Net, and other contributors.
+
+       5. Neither the name(s) of the author(s) nor the names of its
+          contributors may be used to endorse or promote products
+          derived from this software without specific prior written
+          permission.
+
+       THIS SOFTWARE IS PROVIDED BY ITS AUTHORS AND CONTRIBUTORS ``AS
+       IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+       LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
+       FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
+       SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
+       INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+       DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+       SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
+       OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+       LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+       (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
+       THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
+       OF SUCH DAMAGE.
+
+       If these license terms cause you a real problem, contact the author.
++
+   * The `db' library is taken from the db-2.3.4 distribution by Sleepycat
+     Software, and is covered by the following terms:
+
+       /*-
+        * @(#)LICENSE  10.4 (Sleepycat) 7/24/97
+        */
+
+       The following are the copyrights and redistribution conditions
+       that apply to this copy of the DB software.  For a license to use,
+       redistribute or sell DB software under conditions other than those
+       described here, or to purchase support for this software, please
+       contact Sleepycat Software at one of the following addresses:
+
+               Sleepycat Software              db@sleepycat.com
+               394 E. Riding Dr.               +1-508-287-4781
+               Carlisle, MA 01741
+               USA
+
+       =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
+       /*
+        * Copyright (c) 1990, 1993, 1994, 1995, 1996, 1997
+        *      Sleepycat Software.  All rights reserved.
+        *
+        * Redistribution and use in source and binary forms, with or without
+        * modification, are permitted provided that the following conditions
+        * are met:
+        * 1. Redistributions of source code must retain the above copyright
+        *    notice, this list of conditions and the following disclaimer.
+        * 2. Redistributions in binary form must reproduce the above copyright
+        *    notice, this list of conditions and the following disclaimer in
+        *    the documentation and/or other materials provided with the
+        *    distribution.
+        * 3. Redistributions in any form must be accompanied by information on
+        *    how to obtain complete source code for the DB software and any
+        *    accompanying software that uses the DB software.  The source code
+        *    must either be included in the distribution or be available for
+        *    no more than the cost of distribution plus a nominal fee, and
+        *    must be freely redistributable under reasonable conditions.  For
+        *    an executable file, complete source code means the source code
+        *    for all modules it contains.  It does not mean source code for
+        *    modules or files that typically accompany the operating system
+        *    on which the executable file runs, e.g., standard library
+        *    modules or system header files.
+        *
+        * THIS SOFTWARE IS PROVIDED BY SLEEPYCAT SOFTWARE ``AS IS'' AND
+        * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+        * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+        * PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL SLEEPYCAT
+        * SOFTWARE BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+        * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+        * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+        * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+        * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+        * TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
+        * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+        * SUCH DAMAGE.
+        */
+       /*
+        * Copyright (c) 1990, 1993, 1994, 1995
+        *      The Regents of the University of California.  All rights
+        *      reserved.
+        *
+        * Redistribution and use in source and binary forms, with or without
+        * modification, are permitted provided that the following conditions
+        * are met:
+        * 1. Redistributions of source code must retain the above copyright
+        *    notice, this list of conditions and the following disclaimer.
+        * 2. Redistributions in binary form must reproduce the above copyright
+        *    notice, this list of conditions and the following disclaimer in
+        *    the documentation and/or other materials provided with the
+        *    distribution.
+        * 3. All advertising materials mentioning features or use of this
+        *    software must display the following acknowledgement:
+        *      This product includes software developed by the University of
+        *      California, Berkeley and its contributors.
+        * 4. Neither the name of the University nor the names of its
+        *    contributors may be used to endorse or promote products derived
+        *    from this software without specific prior written permission.
+        *
+        * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS''
+        * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+        * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+        * PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS
+        * OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+        * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+        * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+        * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+        * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+        * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
+        * IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
+        * THE POSSIBILITY OF SUCH DAMAGE.
+        */
+       /*
+        * Copyright (c) 1995, 1996
+        *      The President and Fellows of Harvard University.  All rights
+        *      reserved.
+        *
+        * Redistribution and use in source and binary forms, with or without
+        * modification, are permitted provided that the following conditions
+        * are met:
+        * 1. Redistributions of source code must retain the above copyright
+        *    notice, this list of conditions and the following disclaimer.
+        * 2. Redistributions in binary form must reproduce the above copyright
+        *    notice, this list of conditions and the following disclaimer in
+        *    the documentation and/or other materials provided with the
+        *    distribution.
+        * 3. All advertising materials mentioning features or use of this
+        *    software must display the following acknowledgement:
+        *      This product includes software developed by Harvard University
+        *      and its contributors.
+        * 4. Neither the name of the University nor the names of its
+        *    contributors may be used to endorse or promote products derived
+        *    from this software without specific prior written permission.
+        *
+        * THIS SOFTWARE IS PROVIDED BY HARVARD AND ITS CONTRIBUTORS ``AS IS''
+        * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+        * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+        * PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL HARVARD OR
+        * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+        * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+        * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
+        * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+        * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+        * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+        * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+        * POSSIBILITY OF SUCH DAMAGE.
+        */