Context Navigation

-              r7db6ac5
+              r3c928f1
 <para>Most programs and libraries are, by default, compiled with debugging
 symbols included (with <command>gcc</command>'s <emphasis>-g</emphasis>
+symbols included (with <command>gcc</command>'s <parameter>-g</parameter>
 option). This means that, when debugging a program or library that was compiled
 with debugging information included, the debugger can give you not only memory
 …
 without debugging symbols: 480 KB</para></listitem>
+<listitem><para>Glibc and GCC files (/lib and /usr/lib)
+<listitem><para>Glibc and GCC files (<filename class="directory">/lib</filename>
+and <filename class="directory">/usr/lib</filename>)
 with debugging symbols: 87 MB</para></listitem>

chapter06/automake.xml

r7db6ac5	r3c928f1
185	185	<listitem>
186	186	<indexterm zone="ch-system-automake ylwrap"><primary sortas="b-ylwrap">ylwrap</primary></indexterm>
187		<para>is a wrapper for ~~lex and yacc~~.</para>
	187	<para>is a wrapper for <command>lex</command> and <command>yacc</command>.</para>
188	188	</listitem>
189	189	</varlistentry>

chapter06/bash.xml

-              r7db6ac5
+              r3c928f1
 <screen><userinput>exec /bin/bash --login +h</userinput></screen>
+<para>Note that the parameters used make it an interactive login instance
+(so /etc/profile is read, if it exists, and the first found
+~/.bash_profile, ~/.bash_login or and ~/.profile) and continue to
+<note><para>The parameters used make it an interactive login instance
+(so <filename>/etc/profile</filename> is read, if it exists, and the first found
+<filename>~/.bash_profile</filename>, <filename>~/.bash_login</filename> or
+and <filename>~/.profile</filename>) and continue to
 disable hashing so that new programs are found as they become
 available.</para>
+available.</para></note>
 </sect2>
 …
 <indexterm zone="ch-system-bash bashbug"><primary sortas="b-bashbug">bashbug</primary></indexterm>
 <para>is a shell script to help the user
 compose and mail bug reports concerning bash in a standard format.</para>
+compose and mail bug reports concerning <command>bash</command> in a standard format.</para>
 </listitem>
 </varlistentry>
 …
 <indexterm zone="ch-system-bash sh"><primary sortas="b-sh">sh</primary></indexterm>
 <para>is a symlink to the bash program. When invoked
+as sh, bash tries to mimic the startup behavior of historical versions of sh as
+as <command>sh</command>, <command>bash</command> tries to mimic the
+startup behavior of historical versions of <command>sh</command> as
 closely as possible, while conforming to the POSIX standard as well.</para>
 </listitem>

chapter06/binutils.xml

-              r7db6ac5
+              r3c928f1
 <para>If you receive the message:</para>
 <blockquote><screen>The system has no more ptys.  Ask your system administrator to create more.</screen></blockquote>
+<screen><computeroutput>The system has no more ptys.  Ask your system administrator to create more.</computeroutput></screen>
 <para>Your chroot environment is not set up for proper PTY operation. In this
 …
 <para>This package is known to behave badly when you have changed its
 default optimization flags (including the -march and -mcpu options).
+default optimization flags (including the <parameter>-march</parameter> and <parameter>-mcpu</parameter> options).
 Therefore, if you have defined any environment variables that override
 default optimizations, such as CFLAGS and CXXFLAGS, we recommend un-setting
 …
 <para>Normally, the <emphasis>tooldir</emphasis> (the directory where the
 executables end up) is set to $(exec_prefix)/$(target_alias), which expands
 into, for example, <filename>/usr/i686-pc-linux-gnu</filename>. Since we only
+into, for example, <filename class="directory">/usr/i686-pc-linux-gnu</filename>. Since we only
 build for our own system, we don't need this target specific directory in
 <filename>/usr</filename>. That setup would be used if the system was used to
+<filename class="directory">/usr</filename>. That setup would be used if the system was used to
 cross-compile (for example compiling a package on an Intel machine that
 generates code that can be executed on PowerPC machines).</para>
 …
 <screen><userinput>make tooldir=/usr install</userinput></screen>
 <para>Install the <emphasis>libiberty</emphasis> header file that is needed by
+<para>Install the <filename class="headerfile">libiberty</filename> header file that is needed by
 some packages:</para>
 …
 <listitem>
 <indexterm zone="ch-system-binutils as"><primary sortas="b-as">as</primary></indexterm>
 <para>is an assembler. It assembles the output of gcc into object files.</para>
+<para>is an assembler. It assembles the output of <command>gcc</command> into object files.</para>
 </listitem>
 </varlistentry>

chapter06/bison.xml

-              r7db6ac5
+              r3c928f1
 <indexterm zone="ch-system-bison bison"><primary sortas="b-bison">bison</primary></indexterm>
 <para>generates, from a series of rules, a program
 for analyzing the structure of text files. Bison is a replacement for yacc
+for analyzing the structure of text files. <command>bison</command> is a replacement for <command>yacc</command>
 (Yet Another Compiler Compiler).</para>
 </listitem>
 …
 <listitem>
 <indexterm zone="ch-system-bison yacc"><primary sortas="b-yacc">yacc</primary></indexterm>
+<para>is a wrapper for bison, meant for programs
+that still call yacc instead of bison. It calls bison with the -y option.</para>
+<para>is a wrapper for <command>bison</command>, meant for programs
+that still call <command>yacc</command> instead of <command>bison</command>.
+It calls <command>bison</command> with the <parameter>-y</parameter> option.</para>
 </listitem>
 </varlistentry>

chapter06/bzip2.xml

-              r7db6ac5
+              r3c928f1
 make clean</userinput></screen>
 <para>The <emphasis>-f</emphasis> flag will cause Bzip2 to be built
+<para>The <parameter>-f</parameter> flag will cause Bzip2 to be built
 using a different <filename>Makefile</filename> file, in this case the
 <filename>Makefile-libbz2_so</filename> file, which creates a dynamic
 <filename>libbz2.so</filename> library and links the Bzip2 utilities
+<filename class="libraryfile">libbz2.so</filename> library and links the Bzip2 utilities
 against it.</para>
 …
 <listitem>
 <indexterm zone="ch-system-bzip2 bzcmp"><primary sortas="b-bzcmp">bzcmp</primary></indexterm>
 <para>runs cmp on bzipped files.</para>
+<para>runs <command>cmp</command> on bzipped files.</para>
 </listitem>
 </varlistentry>
 …
 <listitem>
 <indexterm zone="ch-system-bzip2 bzdiff"><primary sortas="b-bzdiff">bzdiff</primary></indexterm>
 <para>runs diff on bzipped files.</para>
+<para>runs <command>diff</command> on bzipped files.</para>
 </listitem>
 </varlistentry>
 …
 <listitem>
 <indexterm zone="ch-system-bzip2 bzgrep"><primary sortas="b-bzgrep">bzgrep</primary></indexterm>
 <para>and friends run grep on bzipped files.</para>
+<para>and friends run <command>grep</command> on bzipped files.</para>
 </listitem>
 </varlistentry>
 …
 <listitem>
 <indexterm zone="ch-system-bzip2 bzip2recover"><primary sortas="b-bzip2recover">bzip2recover</primary></indexterm>
 <para>tries to recover data from damaged bzip2 files.</para>
+<para>tries to recover data from damaged bzipped files.</para>
 </listitem>
 </varlistentry>
 …
 <listitem>
 <indexterm zone="ch-system-bzip2 bzless"><primary sortas="b-bzless">bzless</primary></indexterm>
 <para>runs less on bzipped files.</para>
+<para>runs <command>less</command> on bzipped files.</para>
 </listitem>
 </varlistentry>
 …
 <listitem>
 <indexterm zone="ch-system-bzip2 bzmore"><primary sortas="b-bzmore">bzmore</primary></indexterm>
 <para>runs more on bzipped files.</para>
+<para>runs <command>more</command> on bzipped files.</para>
 </listitem>
 </varlistentry>

chapter06/changingowner.xml

r7db6ac5	r3c928f1
30	30	<screen><userinput>chown -R 0:0 /tools</userinput></screen>
31	31
32		<para>The command uses <~~quote>0:0</quote> instead of <quote>root:root</quote~~>,
	32	<para>The command uses <parameter>0:0</parameter> instead of <parameter>root:root</parameter>,
33	33	because <userinput>chown</userinput> is unable to resolve the name
34	34	<quote>root</quote> until the password file has been created.</para>

chapter06/chapter06.xml

-              r7db6ac5
+              r3c928f1
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="util-linux.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="aboutdebug.xml"/>
+<sect1 id="ch-system-strippingagain">
+<title>Stripping again</title>
+<?dbhtml filename="strippingagain.html"?>
+<para>If you are not a programmer and don't plan to do any debugging on your
+system software, you can shrink your system by about 200 MB by removing the
+debugging symbols from binaries and libraries. This causes no inconvenience
+other than not being able to debug the software fully any more.</para>
+<para>Most people who use the command mentioned below don't experience any
+problems. But it is easy to make a typo and render your new system unusable, so
+before running the strip command it is probably a good idea to make a backup of
+the current situation.</para>
+<para>If you are going to perform the stripping, special care is needed to
+ensure you're not running any of the binaries that are about to be stripped.
+If you're not sure whether you entered chroot with the command given in
+<xref linkend="ch-system-chroot"/>, then first exit from chroot:</para>
+<screen><userinput>logout</userinput></screen>
+<para>Then reenter it with:</para>
+<screen><userinput>chroot $LFS /tools/bin/env -i \
+    HOME=/root TERM=$TERM PS1='\u:\w\$ ' \
+    PATH=/bin:/usr/bin:/sbin:/usr/sbin \
+    /tools/bin/bash --login</userinput></screen>
+<para>Now you can safely strip the binaries and libraries:</para>
+<screen><userinput>/tools/bin/find /{,usr/}{bin,lib,sbin} -type f \
+   -exec /tools/bin/strip --strip-debug '{}' ';'</userinput></screen>
+<para>A large number of files will be reported as having their file format not
+recognized. These warnings can be safely ignored, they just mean that those
+files are scripts instead of binaries, no harm is done.</para>
+<para>If you are really tight on disk space, you may want to use
+<emphasis>--strip-all</emphasis> on the binaries in
+<filename>/{,usr/}{bin,sbin}</filename> to gain several more megabytes. But do
+<emphasis>not</emphasis> use this option on libraries: they would be
+destroyed.</para>
+</sect1>
+<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="strippingagain.xml"/>
 <xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="revisedchroot.xml"/>

chapter06/chroot.xml

-              r7db6ac5
+              r3c928f1
     /tools/bin/bash --login +h</userinput></screen>
 <para>The <emphasis>-i</emphasis> option given to the
+<para>The <parameter>-i</parameter> option given to the
 <command>env</command> command will clear all variables of the chroot
 environment. After that, only the HOME, TERM, PS1 and PATH variables are
 set again. The TERM=$TERM construct will set the TERM variable inside chroot
+set again. The <parameter>TERM=$TERM</parameter> construct will set the TERM variable inside chroot
 to the same value as outside chroot; this variable is needed for programs
 like <command>vim</command> and <command>less</command> to operate
 …
 as soon as its final version is installed. Well, at least when the shell
 doesn't remember the locations of executed binaries -- for this reason hashing
 is switched off by passing the <emphasis>+h</emphasis> option to
+is switched off by passing the <parameter>+h</parameter> option to
 <command>bash</command>.</para>
 …
 in the following chapters are run from within the chroot environment.
 If you ever leave this environment for any reason (rebooting for example),
+you must remember to first mount the proc and devpts file systems (discussed
+you must remember to first mount the <systemitem class="filesystem">proc</systemitem>
+and <systemitem class="filesystem">devpts</systemitem> file systems (discussed
 in the previous section) <emphasis>and</emphasis> enter chroot again before
 continuing with the installations.</para>
+<para>Note that the bash prompt will say <quote>I have no name!</quote> This is
+<para>Note that the <command>bash</command> prompt will say
+<computeroutput>I have no name!</computeroutput> This is
 normal, as the <filename>/etc/passwd</filename> file has not been created yet.
 </para>

chapter06/coreutils.xml

-              r7db6ac5
+              r3c928f1
 <para>Normally the functionality of <command>uname</command> is somewhat
 broken, in that the <emphasis>-p</emphasis> switch always returns
 <quote>unknown</quote>.  The following patch fixes this behavior for Intel
+broken, in that the <parameter>-p</parameter> switch always returns
+<computeroutput>unknown</computeroutput>.  The following patch fixes this behavior for Intel
 architectures:</para>
 …
 <indexterm zone="ch-system-coreutils chroot"><primary sortas="b-chroot">chroot</primary></indexterm>
 <para>runs a given command with the specified directory as the
 <filename>/</filename> directory. The given command can be an interactive shell.
+<filename class="directory">/</filename> directory. The given command can be an interactive shell.
 On most systems only <emphasis>root</emphasis> can do this.</para>
 </listitem>
 …
 <listitem>
 <indexterm zone="ch-system-coreutils dir"><primary sortas="b-dir">dir</primary></indexterm>
 <para>is the same as ls.</para>
+<para>is the same as <command>ls</command>.</para>
 </listitem>
 </varlistentry>
 …
 <indexterm zone="ch-system-coreutils dircolors"><primary sortas="b-dircolors">dircolors</primary></indexterm>
 <para>outputs commands to set the LS_COLOR
 environment variable, to change the color scheme used by ls.</para>
+environment variable, to change the color scheme used by <command>ls</command>.</para>
 </listitem>
 </varlistentry>
 …
 <listitem>
 <indexterm zone="ch-system-coreutils mkfifo"><primary sortas="b-mkfifo">mkfifo</primary></indexterm>
 <para>creates FIFOs (First-In, First-Out, a "named pipe" in UNIX parlance) with
+<para>creates FIFOs (First-In, First-Out, a <quote>named pipe</quote> in UNIX parlance) with
 the given names.</para>
 </listitem>
 …
 <listitem>
 <indexterm zone="ch-system-coreutils vdir"><primary sortas="b-vdir">vdir</primary></indexterm>
 <para>is the same as ls -l.</para>
+<para>is the same as <command>ls -l</command>.</para>
 </listitem>
 </varlistentry>
 …
 <listitem>
 <indexterm zone="ch-system-coreutils yes"><primary sortas="b-yes">yes</primary></indexterm>
 <para>outputs 'y' or a given string repeatedly, until killed.</para>
+<para>outputs <quote>y</quote> or a given string repeatedly, until killed.</para>
 </listitem>
 </varlistentry>

chapter06/devices.xml

-              r7db6ac5
+              r3c928f1
 <?dbhtml filename="devices.html"?>
 <indexterm zone="ch-system-devices"><primary sortas="a-Devices">Devices</primary></indexterm>
+<indexterm zone="ch-system-devices"><primary sortas="e-Devices">Devices</primary></indexterm>
 <sect2>
 …
 <para>When the kernel boots the system, it requires the presence of a few device
+nodes, in particular the console and null devices:</para>
+nodes, in particular the <filename class="devicefile">console</filename> and
+<filename class="devicefile">null</filename> devices:</para>
 <screen><userinput>mknod -m 600 /dev/console c 5 1
 …
 <title>Mounting ramfs and populating /dev</title>
+<para>The ideal way to populate /dev is to mount a ramfs onto /dev (like tmpfs, but it
+<para>The ideal way to populate <filename class="directory">/dev</filename> is
+to mount a <systemitem class="filesystem">ramfs</systemitem> onto <filename class="directory">/dev </filename>
+like <systemitem class="filesystem">tmpfs</systemitem>, but it
 cannot be swapped) and create the devices on there during each bootup.  Since we haven't
 booted the system, we have to do what the bootscripts would otherwise do for us, and
 populate /dev ourselves.  Begin by mounting /dev:</para>
+populate <filename class="directory">/dev</filename> ourselves.  Begin by mounting <filename class="directory">/dev</filename>:</para>
 <screen><userinput>mount -n -t ramfs none /dev</userinput></screen>
 <para>Now use the provided udevstart utility to create the initial devices based on
 all the information in /sys:</para>
+all the information in <filename class="directory">/sys</filename>:</para>
 <screen><userinput>/tools/sbin/udevstart</userinput></screen>

Note: See TracChangeset for help on using the changeset viewer.

Context Navigation

Changeset 3c928f1

Legend:

Download in other formats: