From 1bbb24b645cd7038d141c6a20dcdf23aeeb592bf Mon Sep 17 00:00:00 2001 From: Gerard Beekmans Date: Sat, 11 Jan 2003 16:18:59 +0000 Subject: rewrote bash install page git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@2306 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- appendixa/binutils-desc.xml | 14 +++----------- appendixa/binutils-shortdesc.xml | 20 ++++++++++++++++++++ appendixa/binutils.xml | 1 + chapter05/binutils-exp.xml | 18 ------------------ chapter05/binutils-inst.xml | 33 ++++++++++++++++++++++++++++----- chapter05/binutils.xml | 5 ++--- entities/binutils.ent | 1 + 7 files changed, 55 insertions(+), 37 deletions(-) create mode 100644 appendixa/binutils-shortdesc.xml delete mode 100644 chapter05/binutils-exp.xml diff --git a/appendixa/binutils-desc.xml b/appendixa/binutils-desc.xml index 20b7dd116..c0e9ec965 100644 --- a/appendixa/binutils-desc.xml +++ b/appendixa/binutils-desc.xml @@ -1,13 +1,8 @@ -Contents of Binutils +Descriptions Last checked against version &binutils-contversion;. -Program Files - -addr2line, ar, as, gprof, ld, nm, objcopy, objdump, -ranlib, readelf, size, strings and strip - -Descriptions +Program files descriptions addr2line addr2line translates program addresses into file names and line numbers. @@ -79,10 +74,7 @@ modified copies under different names. -Library Files -libbfd.[a,so] and libopcodes.[a,so] - -Descriptions +Library files descriptions libbfd libbfd is the Binary File Descriptor library. diff --git a/appendixa/binutils-shortdesc.xml b/appendixa/binutils-shortdesc.xml new file mode 100644 index 000000000..e28cf4030 --- /dev/null +++ b/appendixa/binutils-shortdesc.xml @@ -0,0 +1,20 @@ +Contents of Binutils + +Last checked against version &binutils-contversion;. + +Binutils is a collection of software development tools containing a +linker, assembler and other tools to work with object files and +archives. + +Binutils installs the following files: + +Program Files + +addr2line, ar, as, gprof, ld, nm, objcopy, objdump, +ranlib, readelf, size, strings and strip + +Library Files +libbfd.[a,so] and libopcodes.[a,so] + + + diff --git a/appendixa/binutils.xml b/appendixa/binutils.xml index 8f0ede362..c8ef4affb 100644 --- a/appendixa/binutils.xml +++ b/appendixa/binutils.xml @@ -3,6 +3,7 @@ &aa-binutils-down; +&aa-binutils-shortdesc; &aa-binutils-desc; &aa-binutils-dep; diff --git a/chapter05/binutils-exp.xml b/chapter05/binutils-exp.xml deleted file mode 100644 index 2b6983510..000000000 --- a/chapter05/binutils-exp.xml +++ /dev/null @@ -1,18 +0,0 @@ - -Command explanations - -mkdir ../binutils-build: The installation -instructions for Binutils recommend creating a separate build directory -instead of compiling the package inside the source tree. So, we create a -binutils-build directory and work from there. - ---disable-nls: This option disables -internationalization (also known as i18n). We don't need this for our -static programs and nls often causes problems when you're linking -statically. - -LDFLAGS="-all-static": Setting the variable LDFLAGS -to the value -all-static causes binutils to be linked statically. - - - diff --git a/chapter05/binutils-inst.xml b/chapter05/binutils-inst.xml index 118762fcb..c03606a48 100644 --- a/chapter05/binutils-inst.xml +++ b/chapter05/binutils-inst.xml @@ -8,14 +8,37 @@ that override default optimizations, such as CFLAGS and CXXFLAGS, we recommend unsetting or modifying them when building binutils. You have been warned. -Install Binutils by running the following commands: +It is recommended by the Binutils installation documentation to build +Binutils outside of the source directory in a dedicated directory: +mkdir ../binutils-build +cd ../binutils-build -mkdir ../binutils-build && -cd ../binutils-build && -../binutils-&binutils-version;/configure --prefix=$LFS/static --disable-nls && -make LDFLAGS="-all-static" && +Next, prepare Binutils to be compiled: + +../binutils-&binutils-version;/configure --prefix=$LFS/static --disable-nls + +The meaning of the (new) configure switches are: + + +--disable-nls: This option disables +internationalization (also known as i18n). We don't need this for our +static programs and nls often causes problems when you're linking +statically. + + +We'll finish off by compiling and installing the package: + +make LDFLAGS="-all-static" && make install +make LDFLAGS="-all-static" is how we tell +Binutils that all programs should be statically linked. Setting the +LDFLAGS variable is the common way of specifying we +want a static link to take place, however, its value and the way it is set +is not always the same. You'll see with the remaining packages that there +are different ways of setting up the LDFLAGS +variable. + diff --git a/chapter05/binutils.xml b/chapter05/binutils.xml index b52a71942..f3661ccbc 100644 --- a/chapter05/binutils.xml +++ b/chapter05/binutils.xml @@ -5,10 +5,9 @@ Estimated build time: &binutils-time-static; Estimated required disk space: &binutils-compsize-static; -&c5-binutils-inst; -&c5-binutils-exp; -&aa-binutils-desc; +&aa-binutils-shortdesc; &aa-binutils-dep; +&c5-binutils-inst; diff --git a/entities/binutils.ent b/entities/binutils.ent index 836233d31..a59811065 100644 --- a/entities/binutils.ent +++ b/entities/binutils.ent @@ -9,6 +9,7 @@ + -- cgit v1.2.3-54-g00ecf