Ignore:
File:
1 edited

Legend:

Unmodified
Added
Removed

  • networking/netutils/networkmanager.xml

    r9556a94 r299daa19  
    99  <!ENTITY NetworkManager-download-ftp
    1010"&gnome-download-ftp;/NetworkManager/&NetworkManager-minor;/NetworkManager-&NetworkManager-version;.tar.xz">
    11   <!ENTITY NetworkManager-md5sum        "0913815a98c60d0d2bcc6e930b596906">
    12   <!ENTITY NetworkManager-size          "5.1 MB">
    13   <!ENTITY NetworkManager-buildsize     "286 MB (with tests)">
    14   <!ENTITY NetworkManager-time          "0.8 SBU (with tests, using parallelism=4)">
     11  <!ENTITY NetworkManager-md5sum        "46be005b3cae8c002339ada4c9f9f3ea">
     12  <!ENTITY NetworkManager-size          "6.2 MB">
     13  <!ENTITY NetworkManager-buildsize     "275 MB (with tests and documentation)">
     14  <!ENTITY NetworkManager-time          "0.9 SBU (with tests, using parallelism=4)">
    1515]>
    1616
    … …  
    1818  <?dbhtml filename="networkmanager.html"?>
    1919
    20   <sect1info>
    21     <date>$Date$</date>
    22   </sect1info>
    2320
    2421  <title>NetworkManager-&NetworkManager-version;</title>
    … …  
    4037    </para>
    4138
    42     &lfs110a_checked;
     39    &lfs112_checked;
    4340
    4441    <note revision="systemd">
    … …  
    122119      <xref linkend="ModemManager"/>,
    123120      <xref linkend="valgrind"/>,
    124       <ulink url="http://www.thekelleys.org.uk/dnsmasq/doc.html">dnsmasq</ulink>,
     121      <ulink url="https://thekelleys.org.uk/dnsmasq/doc.html">dnsmasq</ulink>,
    125122      <ulink url="https://firewalld.org/">firewalld</ulink>,
    126123      <ulink url="https://github.com/Distrotech/libaudit">libaudit</ulink>,
    … …  
    140137
    141138    <para>
    142       If you wish to run the tests, enable the following options in the
    143       kernel configuration and recompile the kernel if necessary:
     139      If you wish to run the tests, check that at least the following options
     140      are enabled in the kernel configuration. Those options have been
     141      determined to be necessary, but may not be sufficient. Recompile the
     142      kernel if necessary:
    144143    </para>
    145144
    … …  
    148147         the Linux Platform tests to move farther along because otherwise
    149148         RTNETLINK would respond with an Error 95 - unknown device type.
    150          This would cause the test to fail early on in the process. -->
    151 
    152 <screen><literal>Device Drivers ---&gt;
    153   [*] Network device support         [CONFIG_NETDEVICES] ---&gt;
    154     [*] Bonding driver support       [CONFIG_BONDING]
    155     [*] Dummy net driver support     [CONFIG_DUMMY]
    156     [*] Ethernet team driver support [CONFIG_NET_TEAM]</literal></screen>
     149         This would cause the test to fail early on in the process.
     150
     151         [pierre, Nov 2022]: I cannot tell whether these options are
     152         the only ones that are needed. They are the options I had to add
     153         in order to have some tests pass. But I already had some other
     154         options set for packet filtering (iptables), that may not be
     155         available by default and may be necessary. Even with the options
     156         below still one test (test-route) fails.-->
     157
     158<screen><literal>
     159[*] Networking support---&gt;                                [CONFIG_NET]
     160      Networking options---&gt;
     161      [*] TCP/IP networking                               [CONFIG_INET]
     162      &lt;*/M&gt;   IP: tunelling                               [CONFIG_NET_IPIP]
     163      &lt;*/M&gt;   IP: GRE demultiplexer                       [CONFIG_NET_IPGRE_DEMUX]
     164      &lt;*/M&gt;   IP: GRE tunnels over IP                     [CONFIG_NET_IPGRE]
     165      &lt;*&gt;   The IPv6 protocol ---&gt;                        [CONFIG_IPV6]
     166        &lt;*/M&gt; IPv6: IPv6-in-IPv4 tunnel (SIT driver)      [CONFIG_IPV6_SIT]
     167        &lt;*/M&gt; IPv6: GRE tunnel                            [CONFIG_IPV6_GRE]
     168        [*] IPv6: Multiple Routing Tables                 [CONFIG_IPV6_MULTIPLE_TABLES]
     169      [*]   MPTCP:   Multipath TCP                        [CONFIG_MPTCP]
     170      [*]     MPTCP: IPv6 support for Multipath TCP       [CONFIG_MPTCP_IPV6]
     171      &lt;*/M&gt; 802.1Q/802.1ad VLAN Support                   [CONFIG_VLAN_8021Q]
     172      [*] QoS and/or fair queueing  ---&gt;                  [CONFIG_NET_SCHED]
     173        &lt;*/M&gt; Stochastic Fairness Queueing (SFQ)          [CONFIG_NET_SCH_SFQ]
     174        &lt;*/M&gt; Token Bucket Filter (TBF)                   [CONFIG_NET_SCH_TBF]
     175        &lt;*/M&gt; Fair Queue Controlled Delay AQM (FQ_CODEL)  [CONFIG_NET_SCH_FQ_CODEL]
     176        &lt;*/M&gt; Ingress/classifier-action Qdisc             [CONFIG_NET_SCH_INGRESS]
     177    Device Drivers ---&gt;
     178    [*] Network device support ---&gt;                       [CONFIG_NETDEVICES]
     179      [*] Network core driver support                     [CONFIG_NET_CORE]
     180      &lt;*&gt;   Bonding driver support                        [CONFIG_BONDING]
     181      &lt;*&gt;   Dummy net driver support                      [CONFIG_DUMMY]
     182      &lt;*&gt;   Ethernet team driver support ---&gt;             [CONFIG_NET_TEAM]
     183      &lt;*&gt;   MAC-VLAN support                              [CONFIG_MACVLAN]
     184      &lt;*&gt;     MAC-VLAN based tap driver                   [CONFIG_MACVTAP]
     185      &lt;*&gt;   IP-VLAN support                               [CONFIG_IPVLAN]
     186      &lt;*&gt;   Virtual eXtensible Local Area Network (VXLAN) [CONFIG_VXLAN]
     187      &lt;*&gt;   Virtual ethernet pair device                  [CONFIG_VETH]
     188      &lt;*&gt;   Virtual Routing and Forwarding (Lite)         [CONFIG_VRF]
     189  </literal></screen>
    157190
    158191    <indexterm zone="NetworkManager NetworkManager-kernel">
    … …  
    235268
    236269    <para>
    237       An already active graphical session
    238       with a bus address is necessary to run the tests. To test the results,
    239       as the root user, <!-- needs the "ip" command -->
    240       issue: <command>ninja test</command>. Five tests,
    241       <filename>platform/test-tc-linux</filename>,
    242       <!--<filename>platform/test-core</filename>,-->
    243       <filename>test-l3cfg</filename>,
    244       <filename>devices/test-acd</filename>,
    245       <filename>platform/test-route-linux</filename>, and
    246       <filename>platform/test-link-linux</filename>,
    247       <!--<filename>platform/test-cleanup-linux</filename>,--> are known to fail.
     270      An already active graphical session with a bus address is necessary
     271      to run the tests. To test the results, issue
     272      <command>ninja test</command>.
     273    </para>
     274
     275    <para>
     276      A few tests may fail, depending on enabled kernel options.
    248277    </para>
    249278
    … …  
    254283<screen role="root"><userinput>ninja install &amp;&amp;
    255284mv -v /usr/share/doc/NetworkManager{,-&NetworkManager-version;}</userinput></screen>
     285
     286    <para>
     287      If you have not passed the <option>-Ddocs=true</option> option to
     288      <command>meson</command>, you can install the pregenerated manual pages
     289      with (as the &root; user):
     290    </para>
     291
     292<screen role="root"><userinput>for file in $(echo ../man/*.[1578]); do
     293    section=${file##*.} &amp;&amp;
     294    install -vdm 755 /usr/share/man/man$section
     295    install -vm 644 $file /usr/share/man/man$section/
     296done</userinput></screen>
     297
     298    <para>
     299      Still in case you have not used <option>-Ddocs=true</option>, the
     300      pregenerated HTML documentation can also be installed with (as
     301      the &root; user):
     302    </para>
     303
     304<screen role="root"
     305        remap="doc"><userinput>cp -Rv ../docs/{api,libnm} /usr/share/doc/NetworkManager-&NetworkManager-version;</userinput></screen>
    256306
    257307  </sect2>
    … …  
    285335
    286336    <para>
    287   <!--<parameter>-Djson_validation=false</parameter>, no longer recognized -->
    288337      <parameter>-Dlibpsl=false</parameter> and
    289338      <parameter>-Dovs=false</parameter>: These switches disable building with the
    … …  
    300349
    301350    <para>
    302       <parameter>-Dmodem_manager=false</parameter>: This switch is requried if
     351      <parameter>-Dmodem_manager=false</parameter>: This switch is required if
    303352      <application>ModemManager</application> is not installed. Omit if you
    304353      have built <application>ModemManager</application> and
    … …  
    417466
    418467      <para>
    419         For additional configuation options, see
     468        For additional configuration options, see
    420469        <command>man 5 NetworkManager.conf</command>.
    421470      </para>
    … …  
    534583          /var/lib/NetworkManager
    535584        </seg>
    536         <!-- A lot of libraries were removed here. We should verify compatibilty.
    537         RESTORED AT 1.18.2 -renodr -->
    538585      </seglistitem>
    539586    </segmentedlist>
Note: See TracChangeset for help on using the changeset viewer.