Ignore:
Timestamp:
08/01/2015 04:26:22 AM (9 years ago)
Author:
Douglas R. Reno <renodr@…>
Branches:
systemd-13485
Children:
ad6910d
Parents:
4a83293
Message:

Import back into SVN from Github

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16309 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • networking/netutils/wireshark-systemd.xml

    r4a83293 rac38e9dc  
    55  %general-entities;
    66
    7   <!ENTITY wireshark-download-http "http://www.wireshark.org/download/src/all-versions/wireshark-&wireshark-version;.tar.bz2">
    8   <!ENTITY wireshark-download-ftp  " ">
    9   <!ENTITY wireshark-md5sum        "2f2a16be8b087227cb17733c72288ae4">
     7  <!ENTITY wireshark-download-http "https://www.wireshark.org/download/src/all-versions/wireshark-&wireshark-version;.tar.bz2">
     8  <!ENTITY wireshark-download-ftp  "ftp://ftp.uni-kl.de/pub/wireshark/src/wireshark-&wireshark-version;.tar.bz2">
     9  <!ENTITY wireshark-md5sum        "25ad2bc1c2a21396827c238fcff51bf3">
    1010  <!ENTITY wireshark-size          "28 MB">
    11   <!ENTITY wireshark-buildsize     "750 MB (up to 1.5 GB)">
    12   <!ENTITY wireshark-time          "7.32 SBU">
     11  <!ENTITY wireshark-buildsize     "1.6 GB">
     12  <!ENTITY wireshark-time          "6.0 SBU">
    1313]>
    1414
    … …  
    3030    <title>Introduction to Wireshark</title>
    3131
    32     <para>The <application>Wireshark</application> package contains a network
    33     protocol analyzer, also known as a <quote>sniffer</quote>. This is useful
    34     for analyzing data captured <quote>off the wire</quote> from a live network
    35     connection, or data read from a capture file.
    36     <application>Wireshark</application> provides both a graphical and a TTY-mode
    37     front-end for examining captured network packets from over 500 protocols,
    38     as well as the capability to read capture files from many other popular
    39     network analyzers.</para>
    40 
    41     &lfs76_checked;
     32    <para>
     33      The <application>Wireshark</application> package contains a network
     34      protocol analyzer, also known as a <quote>sniffer</quote>. This is useful
     35      for analyzing data captured <quote>off the wire</quote> from a live
     36      network connection, or data read from a capture file.
     37    </para>
     38
     39    <para>
     40      <application>Wireshark</application> provides both a graphical and a
     41      TTY-mode front-end for examining captured network packets from over 500
     42      protocols, as well as the capability to read capture files from many
     43      other popular network analyzers.
     44    </para>
     45
     46    &lfs77_checked;
    4247
    4348    <bridgehead renderas="sect3">Package Information</bridgehead>
    … …  
    6671    <itemizedlist spacing="compact">
    6772      <listitem>
    68         <para>Additional Documentation:
    69            <ulink url="http://www.wireshark.org/download/docs/"/>
     73        <para>
     74          Additional Documentation:
     75          <ulink url="https://www.wireshark.org/download/docs/"/>
     76          (contains links to docs in a variety of formats)
    7077         </para>
    7178      </listitem>
    7279    </itemizedlist>
    73 
    74     <para>From this page you can download many different docs in a variety
    75     of formats.</para>
    76 
    7780    <bridgehead renderas="sect3">Wireshark dependencies</bridgehead>
    7881
    7982    <bridgehead renderas="sect4">Required</bridgehead>
    8083    <para role="required">
    81       <xref linkend="glib2"/> (to build the TTY-mode front-end only)
    82     </para>
    83 
    84     <para>Note that you need <application>GTK+</application> or
    85     <application>Qt</application> installed, otherwise, pass
    86     <option>--disable-wireshark</option> to the
    87     <command>configure</command> command.</para>
     84      <xref linkend="glib2"/>
     85    </para>
    8886
    8987    <bridgehead renderas="sect4">Recommended</bridgehead>
    … …  
    113111    </para>
    114112
    115     <para condition="html" role="usernotes">User Notes:
    116     <ulink url="&blfs-wiki;/wireshark"/></para>
    117 
     113    <para condition="html" role="usernotes">
     114      User Notes: <ulink url="&blfs-wiki;/wireshark"/>
     115    </para>
    118116  </sect2>
    119117
    … …  
    121119    <title>Kernel Configuration</title>
    122120
    123       <para>The kernel must have the Packet protocol enabled for
    124       <application>Wireshark</application> to capture live packets from the
    125       network.</para>
     121    <para>
     122      The kernel must have the Packet protocol enabled for <application>
     123      Wireshark</application> to capture live packets from the network:
     124    </para>
    126125     
    127 <screen><literal>Networking support: Y
    128   Networking options:
    129     Packet: sockets monitoring interface: M or Y</literal></screen>
    130 
    131       <para>If built as a module, the name is
    132       <filename>af_packet.ko</filename>.</para>
    133 
    134       <indexterm zone="wireshark wireshark-kernel">
    135         <primary sortas="d-Capturing-network-packets">Capturing network
    136         packets</primary>
    137       </indexterm>
     126<screen><literal>[*] Networking support ---&gt;          [CONFIG_NET]
     127      Networking options ---&gt;
     128        &lt;*/M&gt; Packet socket          [CONFIG_PACKET]</literal></screen>
     129
     130    <indexterm zone="wireshark wireshark-kernel">
     131      <primary sortas="d-Capturing-network-packets">
     132        Capturing network packets
     133      </primary>
     134    </indexterm>
    138135
    139136  </sect2>
    … …  
    142139    <title>Installation of Wireshark</title>
    143140
    144     <para>Optionally, fix the description of the program in the title.
    145     The first change overwrites the default "SVN Unknown" in the title
    146     and the second overwrites a utility script that resets the version
    147     to "unknown".</para>
    148 
    149 <screen><userinput>cat > svnversion.h &lt;&lt; "EOF"
     141    <para>
     142      Optionally, fix the description of the program in the title.
     143      The first change overwrites the default <quote>SVN Unknown</quote> in
     144      the title and the second overwrites a utility script that resets the
     145      version to <quote>unknown</quote>.
     146    </para>
     147
     148<screen><userinput>cat > svnversion.h &lt;&lt; "EOF" &amp;&amp;
    150149#define SVNVERSION "BLFS"
    151150#define SVNPATH "source"
    … …  
    153152
    154153cat > make-version.pl &lt;&lt; "EOF"
    155 #!/usr/bin/perl
     154<literal>#!/usr/bin/perl</literal>
    156155EOF</userinput></screen>
    157156
    158     <para><application>Wireshark</application> is a very large and complex
    159     application.  These instructions provide additional security measures to
    160     ensure that only trusted users are allowed to view network traffic.  First,
    161     set up a system group for wireshark.  As the <systemitem
    162     class="username">root</systemitem> user:</para>
     157    <para>
     158      <application>Wireshark</application> is a very large and complex
     159      application. These instructions provide additional security measures to
     160      ensure that only trusted users are allowed to view network traffic. First,
     161      set up a system group for wireshark.  As the <systemitem
     162      class="username">root</systemitem> user:
     163    </para>
    163164
    164165<screen role="root"><userinput>groupadd -g 62 wireshark</userinput></screen>
    165 
    166     <para>If you want an unpriviledged user to execute
    167     <application>wireshark</application>, run the following command as the
    168     <systemitem class="username">root</systemitem> user:</para>
    169 
    170 <screen><userinput>usermod -a -G wireshark <replaceable>&lt;username&gt;</replaceable></userinput></screen>
    171166
    172167    <para>
    … …  
    190185    </para>
    191186
    192 <screen><userinput>export QT_SELECT=qt5</userinput></screen>
     187<screen><userinput>sed -i "s:moc;:moc-qt5;:g" configure &amp;&amp;
     188sed -i "s:uic;:uic-qt5;:g" configure &amp;&amp;
     189sed -i "s:(AM_V_RCC)rcc:&amp;-qt5:g" ui/qt/Makefile.in</userinput></screen>
    193190
    194191    <para>
    … …  
    198195    </para>
    199196
    200 <screen><userinput>sed -i "s:Qt5 Qt:Qt:g" configure</userinput></screen>
     197<screen><userinput>sed -i "s:Qt5 Qt:Qt:g" configure     &amp;&amp;
     198sed -i "s:moc;:moc-qt4;:g" configure &amp;&amp;
     199sed -i "s:uic;:uic-qt4;:g" configure &amp;&amp;
     200sed -i "s:(AM_V_RCC)rcc:&amp;-qt4:g" ui/qt/Makefile.in</userinput></screen>
    201201
    202202    <para>
    … …  
    211211make</userinput></screen>
    212212
    213     <para>This package does not come with a test suite.</para>
    214 
    215     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     213    <para>
     214      This package does not come with a test suite.
     215    </para>
     216
     217    <para>
     218      Now, as the <systemitem class="username">root</systemitem> user:
     219    </para>
    216220
    217221<screen role="root"><userinput>make install &amp;&amp;
    … …  
    233237if [ -e /usr/bin/wireshark-qt ]; then
    234238   install -v -Dm644 wireshark.desktop /usr/share/applications/wireshark-qt.desktop &amp;&amp;
    235    sed -i "/Exec/s:wireshark:&amp;-qt:g" /usr/share/applications/wireshark-qt.desktop
     239   sed -i "s:Exec.*wireshark:&amp;-qt:g" /usr/share/applications/wireshark-qt.desktop   &amp;&amp;
     240   sed -i "s:Name.*Wireshark:&amp; (Qt):g" /usr/share/applications/wireshark-qt.desktop
    236241fi &amp;&amp;
    237242
    … …  
    243248done &amp;&amp;
    244249
    245 unset size &amp;&amp;
    246 unset QT_SELECT</userinput></screen>
    247 
    248     <para>If you downloaded any of the documentation files from the page
    249     listed in the 'Additional Downloads', install them by issuing the following
    250     commands as the <systemitem class="username">root</systemitem> user:</para>
     250unset size</userinput></screen>
     251
     252    <para>
     253      If you downloaded any of the documentation files from the page
     254      listed in the 'Additional Downloads', install them by issuing the
     255      following commands as the <systemitem class="username">root</systemitem>
     256      user:
     257    </para>
    251258
    252259<screen role="root"><userinput>install -v -m644 <replaceable>&lt;Downloaded_Files&gt;</replaceable> /usr/share/doc/wireshark-&wireshark-version;</userinput></screen>
    253260
    254   <para>Now, set ownership and permissions of sensitive applications to
    255   only allow authorized users.  As the <systemitem
    256   class="username">root</systemitem> user:</para>
     261    <para>
     262      Now, set ownership and permissions of sensitive applications to only
     263      allow authorized users.  As the <systemitem class="username">root
     264      </systemitem> user:
     265    </para>
    257266
    258267<screen role="root"><userinput>chown -v root:wireshark /usr/bin/{tshark,dumpcap} &amp;&amp;
    259268chmod -v 6550 /usr/bin/{tshark,dumpcap}</userinput></screen>
    260269
    261   <para>Finally, add any users to the wireshark group (as root user):</para>
     270    <para>
     271      Finally, add any users to the wireshark group (as <systemitem class=
     272      "username">root</systemitem> user):
     273    </para>
    262274
    263275<screen role="root"><userinput>usermod -a -G wireshark &lt;username&gt;</userinput></screen>
    … …  
    353365        <seg>
    354366          /usr/lib/wireshark,
    355           /usr/share/doc/wireshark-&wireshark-version; and
     367          /usr/share/doc/wireshark-&wireshark-version;,
     368          /usr/share/pixmaps/wireshark and
    356369          /usr/share/wireshark
    357370        </seg>
Note: See TracChangeset for help on using the changeset viewer.