From 4ae43249571811cc3e532908edcc4a628f8dcc34 Mon Sep 17 00:00:00 2001 From: Manuel Canales Esparcia Date: Sun, 5 Feb 2006 11:33:31 +0000 Subject: Indenting chapter 6, part 6 git-svn-id: http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7348 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689 --- chapter06/groff.xml | 817 +++++++++++++++++++++++++-------------------- chapter06/grub.xml | 228 +++++++------ chapter06/gzip.xml | 403 ++++++++++++---------- chapter06/hotplug.xml | 357 +++++++++++--------- chapter06/iana-etc.xml | 136 ++++---- chapter06/inetutils.xml | 339 +++++++++++-------- chapter06/introduction.xml | 106 +++--- 7 files changed, 1332 insertions(+), 1054 deletions(-) (limited to 'chapter06') diff --git a/chapter06/groff.xml b/chapter06/groff.xml index db13ad57e..9f41b2ae3 100644 --- a/chapter06/groff.xml +++ b/chapter06/groff.xml @@ -1,395 +1,494 @@ - %general-entities; ]> + -Groff-&groff-version; - + + + Groff-&groff-version; + + + Groff + + + + -<indexterm zone="ch-system-groff"><primary sortas="a-Groff">Groff</primary></indexterm> + <para>The Groff package contains programs for processing and formatting + text.</para> -<sect2 role="package"><title/> -<para>The Groff package contains programs for processing and formatting text.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.5 SBU</seg><seg>38.7 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.5 SBU</seg> + <seg>38.7 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, -Gawk, GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of Groff + + Bash, Binutils, Coreutils, Diffutils, Gawk, GCC, Glibc, Grep, + Make, and Sed + + -Apply the patch that adds the ascii8 and -nippon devices to Groff: + + + + Installation of Groff + + Apply the patch that adds the ascii8 and + nippon devices to Groff: zcat ../&groff-debian-patch; | patch -Np1 -These devices are used by Man-DB when formatting non-English manual -pages that are not in the ISO-8859-1 encoding. Currently, there is no working -patch for Groff-1.19.x that adds this functionality. - - + + These devices are used by Man-DB when formatting non-English manual + pages that are not in the ISO-8859-1 encoding. Currently, there is no + working patch for Groff-1.19.x that adds this functionality. + + -Many screen fonts don't have Unicode single quotes and dashes in them. -Tell Groff to use the ASCII equivalents instead: + Many screen fonts don't have Unicode single quotes and dashes in them. + Tell Groff to use the ASCII equivalents instead: sed -i -e 's/2010/002D/' -e 's/2212/002D/' \ - -e 's/2018/0060/' -e 's/2019/0027/' font/devutf8/R.proto - + -e 's/2018/0060/' -e 's/2019/0027/' font/devutf8/R.proto -Groff expects the environment variable PAGE -to contain the default paper size. For users in the United States, -PAGE=letter is appropriate. Elsewhere, -PAGE=A4 may be more suitable. -While the default paper size is configured during compilation, it can be -overridden later by echoing either A4 or letter -to the /etc/papersize file. + Groff expects the environment variable PAGE to + contain the default paper size. For users in the United States, + PAGE=letter is appropriate. Elsewhere, + PAGE=A4 may be more suitable. While the default + paper size is configured during compilation, it can be overridden later + by echoing either A4 or letter to the + /etc/papersize file. -Prepare Groff for compilation: + Prepare Groff for compilation: PAGE=[paper_size] ./configure --prefix=/usr --enable-multibyte -Compile the package: + Compile the package: make -This package does not come with a test suite. + This package does not come with a test suite. -Install the package: + Install the package: make install -Some documentation programs, such as xman, -will not work properly without the following symlinks: + Some documentation programs, such as xman, + will not work properly without the following symlinks: ln -sv soelim /usr/bin/zsoelim ln -sv eqn /usr/bin/geqn ln -sv tbl /usr/bin/gtbl - - - -Contents of Groff - - -Installed programs -addftinfo, afmtodit, eqn, eqn2graph, geqn (link to eqn), grn, -grodvi, groff, groffer, grog, grolbp, grolj4, grops, grotty, gtbl (link to tbl), hpftodit, -indxbib, lkbib, lookbib, mmroff, neqn, nroff, pfbtops, pic, pic2graph, post-grohtml, -pre-grohtml, refer, soelim, tbl, tfmtodit, troff, and zsoelim (link to soelim) - - -Short Descriptions - - - - -addftinfo - -Reads a troff font file and adds some -additional font-metric information that is used by the groff system -addftinfo - - - - -afmtodit - -Creates a font file for use with groff and grops -afmtodit - - - - -eqn - -Compiles descriptions of equations embedded -within troff input files into commands that are understood by troff -eqn - - - - -eqn2graph - -Converts a troff EQN (equation) into a cropped image -eqn2graph - - - - -geqn - -A link to eqn -geqn - - - - -grn - -A groff preprocessor for gremlin files -grn - - - - -grodvi - -A driver for groff that produces TeX dvi format -grodvi - - - - -groff - -A front-end to the groff document -formatting system; normally, it runs the troff program and a post-processor -appropriate for the selected device -groff - - - - -groffer - -Displays groff files and man pages on X and tty terminals -groffer - - - - -grog - -Reads files and guesses which of the groff -options -e, -man, --me, -mm, --ms, -p, -s, -and -t are required for printing -files, and reports the groff command including those options -grog - - - - -grolbp - -Is a groff driver for Canon CAPSL printers -(LBP-4 and LBP-8 series laser printers) -grolbp - - - - -grolj4 - -Is a driver for groff that produces output -in PCL5 format suitable for an HP LaserJet 4 printer -grolj4 - - - - -grops - -Translates the output of GNU troff to PostScript -grops - - - - -grotty - -Translates the output of GNU troff into -a form suitable for typewriter-like devices -grotty - - - - -gtbl - -A link to tbl -gtbl - - - - -hpftodit - -Creates a font file for use with -groff -Tlj4 from an HP-tagged font metric file -hpftodit - - - - -indxbib - -Creates an inverted index for the bibliographic databases with a specified file for -use with refer, lookbib, and lkbib -indxbib - - - - -lkbib - -Searches bibliographic databases for references that contain -specified keys and reports any references found -lkbib - - - - -lookbib - -Prints a prompt on the standard error (unless the standard input -is not a terminal), reads a line containing a -set of keywords from the standard input, searches the bibliographic databases in a specified -file for references containing those keywords, prints any references -found on the standard output, and repeats this process until the end -of input -lookbib - - - - -mmroff - -A simple preprocessor for groff -mmroff - - - - -neqn - -Formats equations for American Standard Code for Information -Interchange (ASCII) output -neqn - - - - -nroff - -A script that emulates the nroff command using groff -nroff - - - - -pfbtops - -Translates a PostScript font in .pfb format to ASCII -pfbtops - - - - -pic - -Compiles descriptions of pictures embedded -within troff or TeX input files into commands understood by TeX or troff -pic - - - - -pic2graph - -Converts a PIC diagram into a cropped image -pic2graph - - - - -post-grohtml - -Translates the output of GNU troff to HTML -post-grohtml - - - - -pre-grohtml - -Translates the output of GNU troff to HTML -pre-grohtml - - - - -refer - -Copies the contents of a file to the standard output, except -that lines between .[ and .] -are interpreted as citations, and lines between -.R1 and .R2 are interpreted -as commands for how citations are to be processed -refer - - - - -soelim - -Reads files and replaces lines of the form -.so file by the contents of the mentioned -file -soelim - - - - -tbl - -Compiles descriptions of tables embedded -within troff input files into commands that are understood by troff -tbl - - - - -tfmtodit - -Creates a font file for use with groff -Tdvi -tfmtodit - - - - -troff - -Is highly compatible with Unix troff; it -should usually be invoked using the -groff command, which will also run preprocessors and post-processors in the -appropriate order and with the appropriate options -troff - - - - -zsoelim - -A link to soelim -zsoelim - - - - - + + + + Contents of Groff + + + Installed programs + + + addftinfo, afmtodit, eqn, eqn2graph, geqn (link to eqn), grn, + grodvi, groff, groffer, grog, grolbp, grolj4, grops, grotty, gtbl + (link to tbl), hpftodit, indxbib, lkbib, lookbib, mmroff, neqn, + nroff, pfbtops, pic, pic2graph, post-grohtml, pre-grohtml, refer, + soelim, tbl, tfmtodit, troff, and zsoelim (link to soelim) + + + + + Short Descriptions + + + + + addftinfo + + Reads a troff font file and adds some additional font-metric + information that is used by the groff system + + addftinfo + + + + + + afmtodit + + Creates a font file for use with groff and + grops + + afmtodit + + + + + + eqn + + Compiles descriptions of equations embedded within troff + input files into commands that are understood by + troff + + eqn + + + + + + eqn2graph + + Converts a troff EQN (equation) into a cropped image + + eqn2graph + + + + + + geqn + + A link to eqn + + geqn + + + + + + grn + + A groff preprocessor for gremlin files + + grn + + + + + + grodvi + + A driver for groff that produces TeX dvi + format + + grodvi + + + + + + groff + + A front-end to the groff document formatting system; normally, it + runs the troff program and a post-processor + appropriate for the selected device + + groff + + + + + + groffer + + Displays groff files and man pages on X and tty terminals + + groffer + + + + + + grog + + Reads files and guesses which of the groff + options , , , + , , , + , and are required for printing + files, and reports the groff command including those + options + + grog + + + + + + grolbp + + Is a groff driver for Canon CAPSL printers + (LBP-4 and LBP-8 series laser printers) + + grolbp + + + + + + grolj4 + + Is a driver for groff that produces output + in PCL5 format suitable for an HP LaserJet 4 printer + + grolj4 + + + + + + grops + + Translates the output of GNU troff to + PostScript + + grops + + + + + + grotty + + Translates the output of GNU troff into + a form suitable for typewriter-like devices + + grotty + + + + + + gtbl + + A link to tbl + + gtbl + + + + + + hpftodit + + Creates a font file for use with groff -Tlj4 + from an HP-tagged font metric file + + hpftodit + + + + + + indxbib + + Creates an inverted index for the bibliographic databases with a + specified file for use with refer, + lookbib, and lkbib + + indxbib + + + + + + lkbib + + Searches bibliographic databases for references that contain + specified keys and reports any references found + + lkbib + + + + + + lookbib + + Prints a prompt on the standard error (unless the standard input + is not a terminal), reads a line containing a set of keywords from the + standard input, searches the bibliographic databases in a specified file + for references containing those keywords, prints any references found + on the standard output, and repeats this process until the end of + input + + lookbib + + + + + + mmroff + + A simple preprocessor for groff + + mmroff + + + + + + neqn + + Formats equations for American Standard Code for Information + Interchange (ASCII) output + + neqn + + + + + + nroff + + A script that emulates the nroff command + using groff + + nroff + + + + + + pfbtops + + Translates a PostScript font in .pfb format to ASCII + + pfbtops + + + + + + pic + + Compiles descriptions of pictures embedded within troff or + TeX input files into commands understood by TeX or + troff + + pic + + + + + + pic2graph + + Converts a PIC diagram into a cropped image + + pic2graph + + + + + + post-grohtml + + Translates the output of GNU troff to + HTML + + post-grohtml + + + + + + pre-grohtml + + Translates the output of GNU troff to + HTML + + pre-grohtml + + + + + + refer + + Copies the contents of a file to the standard output, except + that lines between .[ and .] + are interpreted as citations, and lines between .R1 + and .R2 are interpreted as commands for how + citations are to be processed + + refer + + + + + + soelim + + Reads files and replaces lines of the form .so + file by the contents of the mentioned + file + + soelim + + + + + + tbl + + Compiles descriptions of tables embedded within troff input + files into commands that are understood by + troff + + tbl + + + + + + tfmtodit + + Creates a font file for use with groff + -Tdvi + + tfmtodit + + + + + + troff + + Is highly compatible with Unix troff; it + should usually be invoked using the groff command, + which will also run preprocessors and post-processors in the + appropriate order and with the appropriate options + + troff + + + + + + zsoelim + + A link to soelim + + zsoelim + + + + + + + - diff --git a/chapter06/grub.xml b/chapter06/grub.xml index 3f643b04e..ebff3707d 100644 --- a/chapter06/grub.xml +++ b/chapter06/grub.xml @@ -1,126 +1,154 @@ - %general-entities; ]> + -GRUB-&grub-version; - + + + GRUB-&grub-version; + + + GRUB + + + + -<indexterm zone="ch-system-grub"><primary sortas="a-Grub">GRUB</primary></indexterm> + <para>The GRUB package contains the GRand Unified Bootloader.</para> -<sect2 role="package"><title/> -<para>The GRUB package contains the GRand Unified Bootloader.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.2 SBU</seg><seg>10.0 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.2 SBU</seg> + <seg>10.0 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, -GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of GRUB + + Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make, + Ncurses, and Sed + + -This package is known to have issues when its default -optimization flags (including the -march and --mcpu options) are changed. If any environment -variables that override default optimizations have been defined, such -as CFLAGS and CXXFLAGS, -unset them when building GRUB. + -Prepare GRUB for compilation: + + Installation of GRUB + + This package is known to have issues when its default + optimization flags (including the -march and + -mcpu options) are changed. If any environment + variables that override default optimizations have been defined, such + as CFLAGS and CXXFLAGS, + unset them when building GRUB. + + Prepare GRUB for compilation: ./configure --prefix=/usr -Compile the package: + Compile the package: make -To test the results, issue: -make check. + To test the results, issue: + make check. -Install the package: + Install the package: make install mkdir -v /boot/grub cp -v /usr/lib/grub/i386-pc/stage{1,2} /boot/grub -Replace i386-pc with whatever -directory is appropriate for the hardware in use. - -The i386-pc directory -contains a number of *stage1_5 files, different -ones for different file systems. Review the files available and copy -the appropriate ones to the /boot/grub directory. Most users will -copy the e2fs_stage1_5 and/or -reiserfs_stage1_5 files. - - - - -Contents of GRUB - - -Installed programs -grub, grub-install, -grub-md5-crypt, grub-terminfo, and mbchk - - -Short Descriptions - - - - -grub - -The Grand Unified Bootloader's command shell -grub - - - - -grub-install - -Installs GRUB on the given device -grub-install - - - - -grub-md5-crypt - -Encrypts a password in MD5 format -grub-md5-crypt - - - - -grub-terminfo - -Generates a terminfo command from a terminfo name; it can be -employed if an unknown terminal is being used -grub-terminfo - - - - -mbchk - -Checks the format of a multi-boot kernel -mbchk - - - - - + Replace i386-pc with whatever + directory is appropriate for the hardware in use. + + The i386-pc directory + contains a number of *stage1_5 files, different + ones for different file systems. Review the files available and copy + the appropriate ones to the /boot/grub directory. Most users will + copy the e2fs_stage1_5 and/or + reiserfs_stage1_5 files. + + + + + Contents of GRUB + + + Installed programs + + + grub, grub-install, grub-md5-crypt, grub-terminfo, and mbchk + + + + + Short Descriptions + + + + + grub + + The Grand Unified Bootloader's command shell + + grub + + + + + + grub-install + + Installs GRUB on the given device + + grub-install + + + + + + grub-md5-crypt + + Encrypts a password in MD5 format + + grub-md5-crypt + + + + + + grub-terminfo + + Generates a terminfo command from a terminfo name; it can be + employed if an unknown terminal is being used + + grub-terminfo + + + + + + mbchk + + Checks the format of a multi-boot kernel + + mbchk + + + + + + + - diff --git a/chapter06/gzip.xml b/chapter06/gzip.xml index 74d7d7bf9..7ac5fed4e 100644 --- a/chapter06/gzip.xml +++ b/chapter06/gzip.xml @@ -1,63 +1,78 @@ - %general-entities; ]> + -Gzip-&gzip-version; - + + + Gzip-&gzip-version; + + + Gzip + + + + -<indexterm zone="ch-system-gzip"><primary sortas="a-Gzip">Gzip</primary></indexterm> + <para>The Gzip package contains programs for compressing and decompressing + files.</para> -<sect2 role="package"><title/> -<para>The Gzip package contains programs for compressing and decompressing -files.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>2.2 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.1 SBU</seg> + <seg>2.2 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, -GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of Gzip + + Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make, + and Sed + + -Gzip has 2 known security vulnerabilities. The following patch -addresses both of them: + + + + Installation of Gzip + + Gzip has 2 known security vulnerabilities. The following patch + addresses both of them: patch -Np1 -i ../&gzip-security_fix-patch; -Prepare Gzip for compilation: + Prepare Gzip for compilation: ./configure --prefix=/usr -The gzexe script has the location of the -gzip binary hard-wired into it. Because the -location of the binary is changed later, the following command ensures -that the new location gets placed into the script: + The gzexe script has the location of the + gzip binary hard-wired into it. Because the + location of the binary is changed later, the following command ensures + that the new location gets placed into the script: sed -i 's@"BINDIR"@/bin@g' gzexe.in -Compile the package: + Compile the package: make -This package does not come with a test suite. + This package does not come with a test suite. -Install the package: + Install the package: make install -Move the gzip program to the /bin directory and create some commonly used -symlinks to it: + Move the gzip program to the /bin directory and create some commonly used + symlinks to it: mv -v /usr/bin/gzip /bin rm -v /usr/bin/{gunzip,zcat} @@ -66,148 +81,184 @@ ln -sv gzip /bin/zcat ln -sv gzip /bin/compress ln -sv gunzip /bin/uncompress - - - -Contents of Gzip - - -Installed programs -compress (link to gzip), gunzip (link to gzip), gzexe, -gzip, uncompress (link to gunzip), zcat (link to gzip), zcmp, zdiff, -zegrep, zfgrep, zforce, zgrep, zless, zmore, and znew - - -Short Descriptions - - - - -compress - -Compresses and decompresses files -compress - - - - -gunzip - -Decompresses gzipped files -gunzip - - - - -gzexe - -Creates self-decompressing executable files -gzexe - - - - -gzip - -Compresses the given files using Lempel-Ziv (LZ77) coding -gzip - - - - -uncompress - -Decompresses compressed files -uncompress - - - - -zcat - -Decompresses the given gzipped files to standard output -zcat - - - - -zcmp - -Runs cmp on gzipped files -zcmp - - - - -zdiff - -Runs diff on gzipped files -zdiff - - - - -zegrep - -Runs egrep on gzipped files -zegrep - - - - -zfgrep - -Runs fgrep on gzipped files -zfgrep - - - - -zforce - -Forces a .gz extension on all given files -that are gzipped files, so that gzip will not compress them again; this can be -useful when file names were truncated during a file transfer -zforce - - - - -zgrep - -Runs grep on gzipped files -zgrep - - - - -zless - -Runs less on gzipped files -zless - - - - -zmore - -Runs more on gzipped files -zmore - - - - -znew - -Re-compresses files from compress format to -gzip format—.Z -to .gz -znew - - - - - + + + + Contents of Gzip + + + Installed programs + + + compress (link to gzip), gunzip (link to gzip), gzexe, gzip, + uncompress (link to gunzip), zcat (link to gzip), zcmp, zdiff, + zegrep, zfgrep, zforce, zgrep, zless, zmore, and znew + + + + + Short Descriptions + + + + + compress + + Compresses and decompresses files + + compress + + + + + + gunzip + + Decompresses gzipped files + + gunzip + + + + + + gzexe + + Creates self-decompressing executable files + + gzexe + + + + + + gzip + + Compresses the given files using Lempel-Ziv (LZ77) coding + + gzip + + + + + + uncompress + + Decompresses compressed files + + uncompress + + + + + + zcat + + Decompresses the given gzipped files to standard output + + zcat + + + + + + zcmp + + Runs cmp on gzipped files + + zcmp + + + + + + zdiff + + Runs diff on gzipped files + + zdiff + + + + + + zegrep + + Runs egrep on gzipped files + + zegrep + + + + + + zfgrep + + Runs fgrep on gzipped files + + zfgrep + + + + + + zforce + + Forces a .gz extension on + all given files that are gzipped files, so that gzip + will not compress them again; this can be useful when file names were + truncated during a file transfer + + zforce + + + + + + zgrep + + Runs grep on gzipped files + + zgrep + + + + + + zless + + Runs less on gzipped files + + zless + + + + + + zmore + + Runs more on gzipped files + + zmore + + + + + + znew + + Re-compresses files from compress format to + gzip format—.Z to .gz + + znew + + + + + + + - diff --git a/chapter06/hotplug.xml b/chapter06/hotplug.xml index bbc9cfe95..fa61152c6 100644 --- a/chapter06/hotplug.xml +++ b/chapter06/hotplug.xml @@ -1,188 +1,223 @@ - %general-entities; ]> - -Hotplug-&hotplug-version; - -Hotplug + + - -<para>The Hotplug package contains scripts that react upon hotplug events -generated by the kernel. Such events correspond to every change in the kernel -state visible in the <systemitem class="filesystem">sysfs</systemitem> -filesystem, e.g., the addition and removal of hardware. This package also -detects existing hardware during boot and inserts the relevant modules into the -running kernel.</para> + <title>Hotplug-&hotplug-version; - -&buildtime; -&diskspace; -0.01 SBU460 KB - + + Hotplug + - -&dependencies; -Bash, Coreutils, Find, Gawk, and Make - - + + -<sect2 role="installation"> -<title>Installation of Hotplug + The Hotplug package contains scripts that react upon hotplug events + generated by the kernel. Such events correspond to every change in the kernel + state visible in the sysfs + filesystem, e.g., the addition and removal of hardware. This package also + detects existing hardware during boot and inserts the relevant modules into the + running kernel. -This package does not come with a test suite. + + &buildtime; + &diskspace; -Install the Hotplug package: + + 0.01 SBU + 460 KB + + + + + &dependencies; + + + Bash, Coreutils, Find, Gawk, and Make + + + + + + + Installation of Hotplug + + This package does not come with a test suite. + + Install the Hotplug package: make install -Copy a file that the install target omits. + Copy a file that the install target omits. cp -v etc/hotplug/pnp.distmap /etc/hotplug -Remove the init script that Hotplug installs since we are going to be -using the script included in the LFS-Bootscripts package: + Remove the init script that Hotplug installs since we are going to be + using the script included in the LFS-Bootscripts package: rm -rfv /etc/init.d -Network device hotplugging is not yet supported by the LFS-Bootscripts -package. For that reason, remove the network hotplug agent: + Network device hotplugging is not yet supported by the LFS-Bootscripts + package. For that reason, remove the network hotplug agent: rm -fv /etc/hotplug/net.agent -Create a directory for storing firmware that can be loaded by -hotplug: + Create a directory for storing firmware that can be loaded by + hotplug: mkdir -v /lib/firmware - - - -Contents of Hotplug - - -Installed program -Installed scripts -Installed files -hotplug -/etc/hotplug/*.rc, /etc/hotplug/*.agent -/etc/hotplug/hotplug.functions, /etc/hotplug/blacklist, /etc/hotplug/{pci,usb}, -/etc/hotplug/usb.usermap, /etc/hotplug.d, and /var/log/hotplug/events - - -Short Descriptions - - - - -hotplug - -This script is called by default by the Linux kernel when something -changes in its internal state (e.g., a new device is added or an existing device -is removed) -hotplug - - - - -/etc/hotplug/*.rc - -These scripts are used for cold plugging, i.e., detecting and acting upon -hardware already present during system startup. They are called by the -hotplug initscript included in the LFS-Bootscripts package. -The *.rc scripts try to recover hotplug events that were lost -during system boot because, for example, the root filesystem was not mounted by -the kernel -/etc/hotplug/*.rc - - - - -/etc/hotplug/*.agent - -These scripts are called by hotplug -in response to different types of hotplug events generated by the kernel. -Their action is to insert corresponding kernel modules and call any -user-provided scripts -/etc/hotplug/*.agent - - - - -/etc/hotplug/blacklist - -This file contains the list of modules that should never be inserted into -the kernel by the Hotplug scripts -/etc/hotplug/blacklist - - - - -/etc/hotplug/hotplug.functions - -This file contains common functions used by other scripts in the Hotplug -package -/etc/hotplug/hotplug.functions - - - - -/etc/hotplug/{pci,usb} - -These directories contain user-written handlers for hotplug events -/etc/hotplug/{pci,usb} - - - - -/etc/hotplug/usb.usermap - -This file contains rules that determine which user-defined handlers to -call for each USB device, based on its vendor ID and other attributes -/etc/hotplug/usb.usermap - - - - -/etc/hotplug.d - -This directory contains programs (or symlinks to them) that are interested -in receiving hotplug events. For example, Udev puts its symlink here during -installation -/etc/hotplug.d - - - - -/lib/firmware - -This directory contains the firmware for devices that need to have their -firmware loaded before use -/lib/firmware - - - - -/var/log/hotplug/events - -This file contains all the events that hotplug has -called since bootup -/var/log/hotplug/events - - - - - + + + + + Contents of Hotplug + + + Installed program + Installed scripts + Installed files + + + hotplug + /etc/hotplug/*.rc, /etc/hotplug/*.agent + /etc/hotplug/hotplug.functions, /etc/hotplug/blacklist, + /etc/hotplug/{pci,usb}, /etc/hotplug/usb.usermap, /etc/hotplug.d, + and /var/log/hotplug/events + + + + + Short Descriptions + + + + + hotplug + + This script is called by default by the Linux kernel when + something changes in its internal state (e.g., a new device is + added or an existing device is removed) + + hotplug + + + + + + /etc/hotplug/*.rc + + These scripts are used for cold plugging, i.e., detecting and + acting upon hardware already present during system startup. They are + called by the hotplug initscript included in + the LFS-Bootscripts package. The *.rc scripts try + to recover hotplug events that were lost during system boot because, + for example, the root filesystem was not mounted by the kernel + + /etc/hotplug/*.rc + + + + + + /etc/hotplug/*.agent + + These scripts are called by hotplug in response + to different types of hotplug events generated by the kernel. Their + action is to insert corresponding kernel modules and call any + user-provided scripts + + /etc/hotplug/*.agent + + + + + + /etc/hotplug/blacklist + + This file contains the list of modules that should never be + inserted into the kernel by the Hotplug scripts + + /etc/hotplug/blacklist + + + + + + /etc/hotplug/hotplug.functions + + This file contains common functions used by other scripts in the + Hotplug package + + /etc/hotplug/hotplug.functions + + + + + + /etc/hotplug/{pci,usb} + + These directories contain user-written handlers for hotplug + events + + /etc/hotplug/{pci,usb} + + + + + + /etc/hotplug/usb.usermap + + This file contains rules that determine which user-defined handlers to + call for each USB device, based on its vendor ID and other + attributes + + /etc/hotplug/usb.usermap + + + + + + /etc/hotplug.d + + This directory contains programs (or symlinks to them) that are + interested in receiving hotplug events. For example, Udev puts its + symlink here during installation + + /etc/hotplug.d + + + + + + /lib/firmware + + This directory contains the firmware for devices that need to + have their firmware loaded before use + + /lib/firmware + + + + + + /var/log/hotplug/events + + This file contains all the events that hotplug + has called since bootup + + /var/log/hotplug/events + + + + + + + + diff --git a/chapter06/iana-etc.xml b/chapter06/iana-etc.xml index 38ac0b8de..da4f1d28b 100644 --- a/chapter06/iana-etc.xml +++ b/chapter06/iana-etc.xml @@ -1,79 +1,103 @@ - %general-entities; ]> - -Iana-Etc-&iana-etc-version; - - -Iana-Etc - -<para>The Iana-Etc package provides data for network services and protocols.</para> +<sect1 id="ch-system-iana-etc" role="wrap"> + <?dbhtml filename="iana-etc.html"?> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.1 SBU</seg><seg>2.0 MB</seg></seglistitem> -</segmentedlist> + <title>Iana-Etc-&iana-etc-version; - -&dependencies; -Make - - + + Iana-Etc + - -Installation of Iana-Etc + + -<para>The following command converts the raw data provided by IANA into the -correct formats for the <filename>/etc/protocols</filename> and -<filename>/etc/services</filename> data files:</para> + <para>The Iana-Etc package provides data for network services and + protocols.</para> -<screen><userinput>make</userinput></screen> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<para>This package does not come with a test suite.</para> + <seglistitem> + <seg>0.1 SBU</seg> + <seg>2.0 MB</seg> + </seglistitem> + </segmentedlist> -<para>Install the package:</para> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<screen><userinput>make install</userinput></screen> + <seglistitem> + <seg>Make</seg> + </seglistitem> + </segmentedlist> -</sect2> + </sect2> + <sect2 role="installation"> + <title>Installation of Iana-Etc -Contents of Iana-Etc + The following command converts the raw data provided by IANA into the + correct formats for the /etc/protocols and + /etc/services data files: - -Installed files -/etc/protocols and /etc/services - +make -Short Descriptions - - + This package does not come with a test suite. - -/etc/protocols - -Describes the various DARPA Internet protocols that are -available from the TCP/IP subsystem -/etc/protocols - - + Install the package: - -/etc/services - -Provides a mapping between friendly textual names for internet -services, and their underlying assigned port numbers and protocol -types -/etc/services - - - +make install - + + + + Contents of Iana-Etc + + + Installed files + + + /etc/protocols and /etc/services + + + + + Short Descriptions + + + + + /etc/protocols + + Describes the various DARPA Internet protocols that are + available from the TCP/IP subsystem + + /etc/protocols + + + + + + /etc/services + + Provides a mapping between friendly textual names for internet + services, and their underlying assigned port numbers and protocol + types + + /etc/services + + + + + + + - diff --git a/chapter06/inetutils.xml b/chapter06/inetutils.xml index dabe959d6..3a391ae0f 100644 --- a/chapter06/inetutils.xml +++ b/chapter06/inetutils.xml @@ -1,41 +1,57 @@ - %general-entities; ]> + -Inetutils-&inetutils-version; - + + + Inetutils-&inetutils-version; + + + Inetutils + + + + -<indexterm zone="ch-system-inetutils"><primary sortas="a-Inetutils">Inetutils</primary></indexterm> + <para>The Inetutils package contains programs for basic networking.</para> -<sect2 role="package"><title/> -<para>The Inetutils package contains programs for basic networking.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.2 SBU</seg><seg>8.7 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.2 SBU</seg> + <seg>8.7 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, -Diffutils, GCC, Glibc, Grep, Make, Ncurses, and Sed</seg></seglistitem> -</segmentedlist> -</sect2> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -<sect2 role="installation"> -<title>Installation of Inetutils + + Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, Make, + Ncurses, and Sed + + -Apply a patch to Inetutils to enable it to compile with GCC-&gcc-version;: + + + + Installation of Inetutils + + Apply a patch to Inetutils to enable it to compile with + GCC-&gcc-version;: patch -Np1 -i ../&inetutils-gcc4_fixes-patch; -All programs that come with Inetutils will not be installed. -However, the Inetutils build system will insist on installing all the -man pages anyway. The following patch will correct this -situation: + All programs that come with Inetutils will not be installed. + However, the Inetutils build system will insist on installing all the + man pages anyway. The following patch will correct this + situation: patch -Np1 -i ../&inetutils-man_pages-patch; @@ -46,139 +62,166 @@ situation: --disable-logger --disable-syslogd \ --disable-whois --disable-servers -The meaning of the configure options: - - - ---disable-logger -This option -prevents Inetutils from installing the logger program, which is used by -scripts to pass messages to the System Log Daemon. Do not install it -because Util-linux installs a better version later. - - - ---disable-syslogd -This option -prevents Inetutils from installing the System Log Daemon, which is -installed with the Sysklogd package. - - - ---disable-whois -This option disables -the building of the Inetutils whois client, which is out of date. -Instructions for a better whois client are in the BLFS book. - - - ---disable-servers -This disables the installation of the various network -servers included as part of the Inetutils package. These servers are -deemed not appropriate in a basic LFS system. Some are insecure by -nature and are only considered safe on trusted networks. More -information can be found at . Note that -better replacements are available for many of these -servers. - - - -Compile the package: + + The meaning of the configure options: + + + --disable-logger + + This option prevents Inetutils from installing the + logger program, which is used by scripts to + pass messages to the System Log Daemon. Do not install it because + Util-linux installs a better version later. + + + + + --disable-syslogd + + This option prevents Inetutils from installing the System Log + Daemon, which is installed with the Sysklogd package. + + + + + --disable-whois + + This option disables the building of the Inetutils + whois client, which is out of date. Instructions for + a better whois client are in the BLFS book. + + + + + --disable-servers + + This disables the installation of the various network servers + included as part of the Inetutils package. These servers are deemed not + appropriate in a basic LFS system. Some are insecure by nature and are + only considered safe on trusted networks. More information can be found + at . Note that + better replacements are available for many of these servers. + + + + + + Compile the package: make -This package does not come with a test suite. + This package does not come with a test suite. -Install the package: + Install the package: make install -Move the ping program to its FHS-compliant -place: + Move the ping program to its FHS-compliant + place: mv -v /usr/bin/ping /bin - - - -Contents of Inetutils - - -Installed programs -ftp, ping, rcp, rlogin, rsh, talk, telnet, and tftp - - -Short Descriptions - - - - -ftp - -Is the file transfer protocol program -ftp - - - - -ping - -Sends echo-request packets and reports how long the replies take -ping - - - - -rcp - -Performs remote file copy -rcp - - - - -rlogin - -Performs remote login -rlogin - - - - -rsh - -Runs a remote shell -rsh - - - - -talk - -Is used to chat with another user -talk - - - - -telnet - -An interface to the TELNET protocol -telnet - - - - -tftp - -A trivial file transfer program -tftp - - - - - + + + + Contents of Inetutils + + + Installed programs + + + ftp, ping, rcp, rlogin, rsh, talk, telnet, and tftp + + + + + Short Descriptions + + + + + ftp + + Is the file transfer protocol program + + ftp + + + + + + ping + + Sends echo-request packets and reports how long the replies + take + + ping + + + + + + rcp + + Performs remote file copy + + rcp + + + + + + rlogin + + Performs remote login + + rlogin + + + + + + rsh + + Runs a remote shell + + rsh + + + + + + talk + + Is used to chat with another user + + talk + + + + + + telnet + + An interface to the TELNET protocol + + telnet + + + + + + tftp + + A trivial file transfer program + + tftp + + + + + + + - diff --git a/chapter06/introduction.xml b/chapter06/introduction.xml index 065baeeed..5e9cfd5c3 100644 --- a/chapter06/introduction.xml +++ b/chapter06/introduction.xml @@ -1,67 +1,65 @@ - %general-entities; ]> + -Introduction - + -In this chapter, we enter the building site and start -constructing the LFS system in earnest. That is, we chroot into the -temporary mini Linux system, make a few final preparations, and then -begin installing the packages. + Introduction -The installation of this software is straightforward. Although -in many cases the installation instructions could be made shorter and -more generic, we have opted to provide the full instructions for every -package to minimize the possibilities for mistakes. The key to -learning what makes a Linux system work is to know what each package -is used for and why the user (or the system) needs it. For every -installed package, a summary of its contents is given, followed by -concise descriptions of each program and library the package -installed. + In this chapter, we enter the building site and start constructing the + LFS system in earnest. That is, we chroot into the temporary mini Linux system, + make a few final preparations, and then begin installing the packages. -If using the compiler optimizations provided in this chapter, -please review the optimization hint at . Compiler optimizations can make -a program run slightly faster, but they may also cause compilation -difficulties and problems when running the program. If a package -refuses to compile when using optimization, try to compile it without -optimization and see if that fixes the problem. Even if the package -does compile when using optimization, there is the risk it may have -been compiled incorrectly because of the complex interactions between -the code and build tools. Also note that the -and options may cause problems with the -toolchain packages (Binutils, GCC and Glibc). The small potential -gains achieved in using compiler optimizations are often outweighed by -the risks. First-time builders of LFS are encouraged to build without -custom optimizations. The subsequent system will still run very fast -and be stable at the same time. + The installation of this software is straightforward. Although in many + cases the installation instructions could be made shorter and more generic, + we have opted to provide the full instructions for every package to minimize + the possibilities for mistakes. The key to learning what makes a Linux system + work is to know what each package is used for and why the user (or the system) + needs it. For every installed package, a summary of its contents is given, + followed by concise descriptions of each program and library the package + installed. -The order that packages are installed in this chapter needs to -be strictly followed to ensure that no program accidentally acquires a -path referring to /tools -hard-wired into it. For the same reason, do not compile packages in -parallel. Compiling in parallel may save time (especially on dual-CPU -machines), but it could result in a program containing a hard-wired -path to /tools, which will -cause the program to stop working when that directory is -removed. + If using the compiler optimizations provided in this chapter, please + review the optimization hint at . + Compiler optimizations can make a program run slightly faster, but they may + also cause compilation difficulties and problems when running the program. + If a package refuses to compile when using optimization, try to compile it + without optimization and see if that fixes the problem. Even if the package + does compile when using optimization, there is the risk it may have been + compiled incorrectly because of the complex interactions between the code + and build tools. Also note that the and + options may cause problems with the toolchain packages + (Binutils, GCC and Glibc). The small potential gains achieved in using + compiler optimizations are often outweighed by the risks. First-time builders + of LFS are encouraged to build without custom optimizations. The subsequent + system will still run very fast and be stable at the same time. -Before the installation instructions, each installation page -provides information about the package, including a concise -description of what it contains, approximately how long it will take -to build, how much disk space is required during this building -process, and any other packages needed to successfully build the -package. Following the installation instructions, there is a list of -programs and libraries (along with brief descriptions of these) that -the package installs. + The order that packages are installed in this chapter needs to be + strictly followed to ensure that no program accidentally acquires a path + referring to /tools hard-wired into + it. For the same reason, do not compile packages in parallel. Compiling in + parallel may save time (especially on dual-CPU machines), but it could result + in a program containing a hard-wired path to /tools, which will cause the program to stop + working when that directory is removed. -At this point, you may wish to keep your finished temporary -tools for use in future LFS builds by creating a tarball of the -/tools directory and -storing it in a safe location. + Before the installation instructions, each installation page provides + information about the package, including a concise description of what it + contains, approximately how long it will take to build, how much disk space + is required during this building process, and any other packages needed to + successfully build the package. Following the installation instructions, + there is a list of programs and libraries (along with brief descriptions of + these) that the package installs. - + + At this point, you may wish to keep your finished temporary + tools for use in future LFS builds by creating a tarball of the + /tools directory and + storing it in a safe location. + + -- cgit v1.2.3-54-g00ecf