| Line 1... |
Line 1... |
README for newlib-1.8.1 release
|
README for newlib-1.8.2 release
|
(mostly cribbed from the README in the gdb-4.13 release)
|
(mostly cribbed from the README in the gdb-4.13 release)
|
|
|
This is `newlib', a simple ANSI C library, math library, and collection
|
This is `newlib', a simple ANSI C library, math library, and collection
|
of board support packages.
|
of board support packages.
|
|
|
| Line 15... |
Line 15... |
|
|
|
|
Unpacking and Installation -- quick overview
|
Unpacking and Installation -- quick overview
|
==========================
|
==========================
|
|
|
When you unpack the newlib-1.8.1.tar.gz file, you'll find a directory
|
When you unpack the newlib-1.8.2.tar.gz file, you'll find a directory
|
called `newlib-1.8.1', which contains:
|
called `newlib-1.8.2', which contains:
|
|
|
COPYING config/ install-sh* mpw-configure
|
COPYING config/ install-sh* mpw-configure
|
COPYING.LIB config-ml.in libgloss/ mpw-install
|
COPYING.LIB config-ml.in libgloss/ mpw-install
|
COPYING.NEWLIB config.guess* mkinstalldirs* newlib/
|
COPYING.NEWLIB config.guess* mkinstalldirs* newlib/
|
CYGNUS config.sub* move-if-change* symlink-tree*
|
CYGNUS config.sub* move-if-change* symlink-tree*
|
| Line 28... |
Line 28... |
Makefile.in configure.in mpw-build.in
|
Makefile.in configure.in mpw-build.in
|
README etc/ mpw-config.in
|
README etc/ mpw-config.in
|
|
|
To build NEWLIB, you can just do:
|
To build NEWLIB, you can just do:
|
|
|
cd newlib-1.8.1
|
cd newlib-1.8.2
|
./configure --target=
|
./configure --target=
|
make all install
|
make all install
|
|
|
This will configure and build all the libraries and crt0 (if one exists).
|
This will configure and build all the libraries and crt0 (if one exists).
|
If `configure' can't determine your host system type, specify one as its
|
If `configure' can't determine your host system type, specify one as its
|
| Line 94... |
Line 94... |
to specify a path to find `configure' itself from your working
|
to specify a path to find `configure' itself from your working
|
directory. If the path to `configure' would be the same as the
|
directory. If the path to `configure' would be the same as the
|
argument to `--srcdir', you can leave out the `--srcdir' option; it
|
argument to `--srcdir', you can leave out the `--srcdir' option; it
|
will be assumed.)
|
will be assumed.)
|
|
|
For example, with version 1.8.1, you can build NEWLIB in a separate
|
For example, with version 1.8.2, you can build NEWLIB in a separate
|
directory for a Sun 4 cross m68k-aout environment like this:
|
directory for a Sun 4 cross m68k-aout environment like this:
|
|
|
cd newlib-1.8.1
|
cd newlib-1.8.2
|
mkdir ../newlib-m68k-aout
|
mkdir ../newlib-m68k-aout
|
cd ../newlib-m68k-aout
|
cd ../newlib-m68k-aout
|
../newlib-1.8.1/configure --host=sun4 --target=m68k-aout
|
../newlib-1.8.2/configure --host=sun4 --target=m68k-aout
|
make
|
make
|
|
|
When `configure' builds a configuration using a remote source
|
When `configure' builds a configuration using a remote source
|
directory, it creates a tree for the binaries with the same structure
|
directory, it creates a tree for the binaries with the same structure
|
(and using the same names) as the tree under the source directory. In
|
(and using the same names) as the tree under the source directory. In
|
| Line 116... |
Line 116... |
in a configured directory--whatever directory you were in when you
|
in a configured directory--whatever directory you were in when you
|
called `configure' (or one of its subdirectories).
|
called `configure' (or one of its subdirectories).
|
|
|
The `Makefile' that `configure' generates in each source directory
|
The `Makefile' that `configure' generates in each source directory
|
also runs recursively. If you type `make' in a source directory such
|
also runs recursively. If you type `make' in a source directory such
|
as `newlib-1.8.1' (or in a separate configured directory configured with
|
as `newlib-1.8.2' (or in a separate configured directory configured with
|
`--srcdir=PATH/newlib-1.8.1'), you will build all the required libraries.
|
`--srcdir=PATH/newlib-1.8.2'), you will build all the required libraries.
|
|
|
When you have multiple hosts or targets configured in separate
|
When you have multiple hosts or targets configured in separate
|
directories, you can run `make' on them in parallel (for example, if
|
directories, you can run `make' on them in parallel (for example, if
|
they are NFS-mounted on each of the hosts); they will not interfere
|
they are NFS-mounted on each of the hosts); they will not interfere
|
with each other.
|
with each other.
|
| Line 218... |
Line 218... |
|
|
|
|
Reporting Bugs
|
Reporting Bugs
|
==============
|
==============
|
|
|
The correct address for reporting bugs found in NEWLIB is "newlib@cygnus.com".
|
The correct address for reporting bugs found in NEWLIB is
|
Please email all bug reports to that address. Please include the NEWLIB
|
"newlib@sourceware.cygnus.com". Please email all bug reports to that
|
version number (e.g., newlib-1.8.1), and how you configured it
|
address. Please include the NEWLIB version number (e.g., newlib-1.8.2),
|
(e.g., "sun4 host and m68k-aout target"). Since NEWLIB supports many
|
and how you configured it (e.g., "sun4 host and m68k-aout target").
|
different configurations, it is important that you be precise about this.
|
Since NEWLIB supports many different configurations, it is important
|
|
that you be precise about this.
|
|
|
|
Archives of the newlib mailing list are on-line, see
|
|
http://sourceware.cygnus.com/ml/newlib/
|
