Changeset 2f6a5b0


Ignore:
Timestamp:
04/30/2005 03:50:38 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
129e5260
Parents:
c7ac14c
Message:

Tagged traceroute.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@3878 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • basicnet/netutils/traceroute.xml

    rc7ac14c r2f6a5b0  
    1414
    1515<sect1 id="traceroute" xreflabel="Traceroute-&traceroute-version;">
    16 <sect1info>
    17 <othername>$LastChangedBy$</othername>
    18 <date>$Date$</date>
    19 </sect1info>
    20 <?dbhtml filename="traceroute.html"?>
    21 <title>Traceroute-&traceroute-version;</title>
    22 <indexterm zone="traceroute">
    23 <primary sortas="a-Traceroute">Traceroute</primary></indexterm>
     16  <?dbhtml filename="traceroute.html"?>
     17 
     18  <sect1info>
     19    <othername>$LastChangedBy$</othername>
     20    <date>$Date$</date>
     21  </sect1info>
     22 
     23  <title>Traceroute-&traceroute-version;</title>
     24 
     25  <indexterm zone="traceroute">
     26    <primary sortas="a-Traceroute">Traceroute</primary>
     27  </indexterm>
    2428
    25 <sect2>
    26 <title>Introduction to <application>Traceroute</application></title>
     29  <sect2 role="package">
     30    <title>Introduction to Traceroute</title>
     31   
     32    <para>The <application>Traceroute</application> package contains a program
     33    which is used to display the network route that packets take to reach a
     34    specified host. This is a standard network troubleshooting tool. If you find
     35    yourself unable to connect to another system, traceroute can help pinpoint
     36    the problem.</para>
     37   
     38    <bridgehead renderas="sect3">Package Information</bridgehead>
     39    <itemizedlist spacing="compact">
     40      <listitem>
     41        <para>Download (HTTP): <ulink url="&traceroute-download-http;"/></para>
     42      </listitem>
     43      <listitem>
     44        <para>Download (FTP): <ulink url="&traceroute-download-ftp;"/></para>
     45      </listitem>
     46      <listitem>
     47        <para>Download MD5 sum: &traceroute-md5sum;</para>
     48      </listitem>
     49      <listitem>
     50        <para>Download size: &traceroute-size;</para>
     51      </listitem>
     52      <listitem>
     53        <para>Estimated disk space required: &traceroute-buildsize;</para>
     54      </listitem>
     55      <listitem>
     56        <para>Estimated build time: &traceroute-time;</para>
     57      </listitem>
     58    </itemizedlist>
     59   
     60  </sect2>
     61 
     62  <sect2 role="installation">
     63    <title>Installation of Traceroute</title>
    2764
    28 <para>The <application>Traceroute</application> package contains a program
    29 which is used to display the network route that packets take to reach a
    30 specified host. This is a standard network troubleshooting tool. If you find
    31 yourself unable to connect to another system, traceroute can help pinpoint
    32 the problem.</para>
     65    <para>Install <application>Traceroute</application> by running the following
     66    commands:</para>
    3367
    34 <sect3><title>Package information</title>
    35 <itemizedlist spacing='compact'>
    36 <listitem><para>Download (HTTP): <ulink
    37 url="&traceroute-download-http;"/></para></listitem>
    38 <listitem><para>Download (FTP): <ulink
    39 url="&traceroute-download-ftp;"/></para></listitem>
    40 <listitem><para>Download MD5 sum: &traceroute-md5sum;</para></listitem>
    41 <listitem><para>Download size: &traceroute-size;</para></listitem>
    42 <listitem><para>Estimated disk space required:
    43 &traceroute-buildsize;</para></listitem>
    44 <listitem><para>Estimated build time:
    45 &traceroute-time;</para></listitem></itemizedlist>
    46 </sect3>
     68<screen><userinput>sed -i -e 's/-o bin/-o root/' Makefile.in &amp;&amp;
     69./configure --prefix=/usr &amp;&amp;
     70make</userinput></screen>
     71   
     72    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    4773
    48 </sect2>
     74<screen role='root'><userinput>make install &amp;&amp;
     75make install-man</userinput></screen>
     76   
     77  </sect2>
     78 
     79  <sect2 role="commands">
     80    <title>Command Explanations</title>
     81   
     82    <para><command>sed 's/-o bin/-o root/' Makefile.in</command>:
     83    Adjusts the <filename>Makefile</filename> so that the program is installed
     84    with user root instead of user bin (which doesn't exist on a default
     85    LFS system).</para>
     86   
     87    <para><command>make install</command>: Installs <command>traceroute</command>
     88    with SUID set to <systemitem class="username">root</systemitem> in the
     89    <filename class='directory'>/usr/sbin</filename> directory. This makes it
     90    possible for all users to execute <command>traceroute</command>. For absolute
     91    security, turn off the SUID bit in <command>traceroute</command>'s file permissions
     92    with the command:</para>
     93   
     94<screen role='root'><userinput>chmod 0755 /usr/sbin/traceroute</userinput></screen>
     95   
     96    <para>The risk is that if a security problem such as a buffer overflow was
     97    ever found in the <application>Traceroute</application> code, a regular user
     98    on your system could gain <systemitem class="username">root</systemitem>
     99    access if the program is SUID <systemitem class="username">root</systemitem>.
     100    Of course, removing the SUID permission also makes it impossible for users other
     101    than <systemitem class="username">root</systemitem> to utilize
     102    <command>traceroute</command>, so decide what's right for
     103    your individual situation.</para>
     104   
     105    <para>The goal of BLFS is to be completely FHS compliant, so if you do leave the
     106    <command>traceroute</command> binary SUID <systemitem
     107    class="username">root</systemitem>, then you should move
     108    <filename>traceroute</filename> to <filename class='directory'>/usr/bin</filename>
     109    with the following command:</para>
     110   
     111<screen role='root'><userinput>mv /usr/sbin/traceroute /usr/bin</userinput></screen>
     112   
     113    <para>This ensures that the binary is in the path for non-root users.</para>
     114   
     115  </sect2>
     116 
     117  <sect2 role="content">
     118    <title>Contents</title>
    49119
    50 <sect2>
    51 <title>Installation of <application>Traceroute</application></title>
     120    <segmentedlist>
     121      <segtitle>Installed Program</segtitle>
     122      <segtitle>Installed Libraries</segtitle>
     123      <segtitle>Installed Directories</segtitle>
     124     
     125      <seglistitem>
     126        <seg>traceroute</seg>
     127        <seg>None</seg>
     128        <seg>None</seg>
     129      </seglistitem>
     130    </segmentedlist>
     131   
     132    <variablelist>
     133      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     134      <?dbfo list-presentation="list"?>
     135      <?dbhtml list-presentation="table"?>
     136     
     137      <varlistentry id="traceroute-prog">
     138        <term><command>traceroute</command></term>
     139        <listitem>
     140          <para>does basically what it says: it traces the route your packets
     141          take from the host you are working on to another host on a network, showing
     142          all the intermediate hops (gateways) along the way.</para>
     143          <indexterm zone="traceroute traceroute-prog">
     144            <primary sortas="b-traceroute">traceroute</primary>
     145          </indexterm>
     146        </listitem>
     147      </varlistentry>
     148   
     149    </variablelist>
    52150
    53 <para>Install <application>Traceroute</application> by running the following
    54 commands:</para>
    55 
    56 <screen><userinput><command>sed -i -e 's/-o bin/-o root/' Makefile.in &amp;&amp;
    57 ./configure --prefix=/usr &amp;&amp;
    58 make</command></userinput></screen>
    59 
    60 <para>Now, as the root user:</para>
    61 
    62 <screen><userinput role='root'><command>make install &amp;&amp;
    63 make install-man</command></userinput></screen>
    64 
    65 </sect2>
    66 
    67 <sect2>
    68 <title>Command explanations</title>
    69 
    70 <para><command>sed 's/-o bin/-o root/' Makefile.in</command>:
    71 Adjusts the <filename>Makefile</filename> so that the program is installed
    72 with user root instead of user bin (which doesn't exist on a default
    73 <acronym>LFS</acronym> system).</para>
    74 
    75 <para><command>make install</command>: Installs <command>traceroute</command>
    76 with <acronym>SUID</acronym> set to root in the
    77 <filename class='directory'>/usr/sbin</filename> directory. This makes it
    78 possible for all users to execute <command>traceroute</command>. For absolute
    79 security, turn off the <acronym>SUID</acronym> bit in
    80 <command>traceroute</command>'s file permissions with the command:</para>
    81 
    82 <screen><userinput role='root'><command>chmod 0755 /usr/sbin/traceroute</command></userinput></screen>
    83 
    84 <para>The risk is that if a security problem such as a buffer overflow was
    85 ever found in the <application>Traceroute</application> code, a regular user
    86 on your system could gain root access if the program is
    87 <acronym>SUID</acronym> root. Of course, removing
    88 the <acronym>SUID</acronym> permission also makes it impossible for users other
    89 than root to utilize <command>traceroute</command>, so decide what's right for
    90 your individual situation.</para>
    91 
    92 <para>The goal of <acronym>BLFS</acronym> is to be completely
    93 <acronym>FHS</acronym> compliant, so if you do leave the
    94 <command>traceroute</command> binary <acronym>SUID</acronym> root, then you
    95 should move <filename>traceroute</filename> to
    96 <filename class='directory'>/usr/bin</filename> with the following command:
    97 </para>
    98 
    99 <screen><userinput role='root'><command>mv /usr/sbin/traceroute /usr/bin</command></userinput></screen>
    100 
    101 <para>This ensures that the binary is in the path for non-root users.</para>
    102 
    103 </sect2>
    104 
    105 <sect2>
    106 <title>Contents</title>
    107 
    108 <segmentedlist>
    109 <segtitle>Installed Program</segtitle>
    110 <segtitle>Installed Libraries</segtitle>
    111 <segtitle>Installed Directories</segtitle>
    112 
    113 <seglistitem>
    114 <seg>traceroute</seg>
    115 <seg>None</seg>
    116 <seg>None</seg>
    117 </seglistitem>
    118 </segmentedlist>
    119 
    120 <variablelist>
    121 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    122 <?dbfo list-presentation="list"?>
    123 
    124 <varlistentry id="traceroute-prog">
    125 <term><command>traceroute</command></term>
    126 <listitem><para>does basically what it says: it traces the route your packets
    127 take from the host you are working on to another host on a network, showing
    128 all the intermediate hops (gateways) along the way.</para>
    129 <indexterm zone="traceroute traceroute-prog">
    130 <primary sortas="b-traceroute">traceroute</primary>
    131 </indexterm></listitem>
    132 </varlistentry>
    133 </variablelist>
    134 
    135 </sect2>
     151  </sect2>
    136152
    137153</sect1>
Note: See TracChangeset for help on using the changeset viewer.