summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authormrpa <miruna.paun@enea.com>2020-02-28 12:20:53 +0100
committerMiruna Paun <mrpa@enea.se>2020-02-28 13:15:41 +0100
commitdc8eb2ac5b5710b66f54edc7f38f9452d93eff7a (patch)
tree26c4ac187669c0b131bf11ab4710eedd4b62b80f
parentc1dc861ad66563c5f2a35e0901ecb7161b62380a (diff)
downloadel_releases-nfv-access-dc8eb2ac5b5710b66f54edc7f38f9452d93eff7a.tar.gz
Removed all the books we decided to archive in gitlab2
Deleted the vnf onboarding guide as obsolete. Change-Id: I31c33756dad7332d6293d70404c43967449b405a
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/appendix_a.xml70
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/book.xml29
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated.xml165
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt320
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml952
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml120
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/doc/metasecure_tools.xml465
-rw-r--r--doc/book-enea-nfv-access-dev-hardening-guide/swcomp.mk10
-rw-r--r--doc/book-enea-nfv-access-esdk-open-source/doc/README4
-rw-r--r--doc/book-enea-nfv-access-esdk-open-source/doc/about.xml12
-rw-r--r--doc/book-enea-nfv-access-esdk-open-source/doc/book.xml15
-rwxr-xr-xdoc/book-enea-nfv-access-esdk-open-source/doc/licenses.xml8573
-rw-r--r--doc/book-enea-nfv-access-esdk-open-source/swcomp.mk10
-rw-r--r--doc/book-enea-nfv-access-guide/doc/benchmarks.xml1474
-rw-r--r--doc/book-enea-nfv-access-guide/doc/book.xml30
-rw-r--r--doc/book-enea-nfv-access-guide/doc/container_virtualization.xml136
-rw-r--r--doc/book-enea-nfv-access-guide/doc/dpdk.xml125
-rw-r--r--doc/book-enea-nfv-access-guide/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-nfv-access-guide/doc/eltf_params_updated.xml165
-rw-r--r--doc/book-enea-nfv-access-guide/doc/getting_started.xml244
-rw-r--r--doc/book-enea-nfv-access-guide/doc/hypervisor_virtualization.xml774
-rw-r--r--doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.pngbin6403 -> 0 bytes
-rw-r--r--doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg3
-rwxr-xr-xdoc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.pngbin82611 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.svg1569
-rw-r--r--doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions_old.pngbin24106 -> 0 bytes
-rw-r--r--doc/book-enea-nfv-access-guide/doc/overview.xml147
-rw-r--r--doc/book-enea-nfv-access-guide/doc/ovs.xml162
-rw-r--r--doc/book-enea-nfv-access-guide/doc/using_nfv_access_sdks.xml473
-rw-r--r--doc/book-enea-nfv-access-guide/swcomp.mk10
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/benchmarks.xml1488
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/book.xml30
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/container_virtualization.xml137
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/dpdk.xml115
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_updated.xml165
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/hypervisor_virtualization.xml744
-rwxr-xr-xdoc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.pngbin7833 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.svg213
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.pngbin6403 -> 0 bytes
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg3
-rwxr-xr-xdoc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.pngbin82611 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.svg1569
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/ostree.xml209
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/overview.xml153
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/ovs.xml161
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/doc/using_nfv_access_sdks.xml549
-rw-r--r--doc/book-enea-nfv-access-reference-guide-intel/swcomp.mk10
-rw-r--r--doc/book-enea-nfv-access-sdk-open-source/doc/README4
-rw-r--r--doc/book-enea-nfv-access-sdk-open-source/doc/about.xml12
-rw-r--r--doc/book-enea-nfv-access-sdk-open-source/doc/book.xml15
-rw-r--r--doc/book-enea-nfv-access-sdk-open-source/doc/licenses.xml8573
-rw-r--r--doc/book-enea-nfv-access-sdk-open-source/swcomp.mk12
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/book.xml18
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated.xml165
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt320
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/guidelines_hardening_linux.xml212
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/intro_hardentools_tech.xml209
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/intro_info_security.xml144
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/doc/introduction.xml102
-rw-r--r--doc/book-enea-nfv-access-user-hardening-guide/swcomp.mk10
-rw-r--r--doc/book-enea-nfv-access-vnf-onboarding-guide/doc/book.xml30
-rw-r--r--doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated.xml286
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated_template_how_to_use.txt320
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/6wind_cloudinit.pngbin129969 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/add_output.pngbin62319 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/coss_vnf_inst.pngbin55827 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/cosstream_cloudinit.pngbin122507 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_interface.pngbin28952 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_ovs_bridge.pngbin31738 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_cloudinit.pngbin75577 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port1.pngbin59834 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port2.pngbin62744 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port3.pngbin64756 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/main_net_int.pngbin61056 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_6wind.pngbin122245 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_clav_coss.pngbin61682 -> 0 bytes
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_fortios.pngbin53685 -> 0 bytes
-rw-r--r--doc/book-enea-nfv-access-vnf-onboarding-guide/doc/instantiation.xml126
-rw-r--r--doc/book-enea-nfv-access-vnf-onboarding-guide/doc/introduction.xml90
-rw-r--r--doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_configurations.xml378
-rw-r--r--doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_onboarding.xml173
-rwxr-xr-xdoc/book-enea-nfv-access-vnf-onboarding-guide/swcomp.mk10
86 files changed, 0 insertions, 33567 deletions
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/appendix_a.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/appendix_a.xml
deleted file mode 100644
index c5d9aaa..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/appendix_a.xml
+++ /dev/null
@@ -1,70 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<appendix id="appendix_a">
3 <title>Useful Memory Terms</title>
4
5 <remark>Change the title to something better</remark>
6
7 <section id="buffer_overflow">
8 <title>Buffer overflow</title>
9
10 <para>A buffer overflow occurs when a program or process attempts to write
11 more data to a fixed length block of memory, or buffer, than the buffer is
12 allocated to hold.</para>
13
14 <para>Since buffers are created to contain a defined amount of data, the
15 extra data can overwrite data values in memory addresses adjacent to the
16 destination buffer, unless the program includes sufficient bounds checking
17 to flag or discard data when too much is sent to a memory buffer.
18 Languages such Ada, C#, Haskell, Java, JavaScript, Lisp, PHP, Python,
19 Ruby, and Visual Basic enforce run-time checking. </para>
20
21 <para>C and C++ are prone to buffer overflow attacks as they have no
22 built-in protection against accessing or overwriting data in any part of
23 their memory, and do not automatically check that data written to an array
24 (the built-in buffer type) is within the boundaries of that array.</para>
25 </section>
26
27 <section id="security_exploit">
28 <title>Security Exploit</title>
29
30 <para>On many systems, the memory layout of a program, or the system as a
31 whole, is well defined. Exploiting the behavior of a buffer overflow is a
32 well-known security exploit. By sending in data designed to cause a buffer
33 overflow, it is possible to write into areas known to hold an executable,
34 and replace it with malicious code.</para>
35
36 <para>Bounds checking can prevent buffer overflows, but requires
37 additional code and processing time. Modern operating systems use a
38 variety of techniques to combat malicious buffer overflows by randomizing
39 the layout of memory, or deliberately leaving space between buffers and
40 looking for actions that write into those areas "canaries". For further
41 reading about security exploits refer to the <ulink
42 url="https://www.exploit-db.com/">Exploit database</ulink>.</para>
43 </section>
44
45 <section id="hd_bounds_ck">
46 <title>Hardware Bounds Checking</title>
47
48 <para>The safety added by bounds checking costs CPU time if checking is
49 performed in software however, if the checks are performed by hardware
50 then safety can be provided "for free" with no runtime cost. </para>
51
52 <para>Research was started at least as early as 2005 regarding methods to
53 use x86's built-in virtual memory management unit to ensure safety of
54 array and buffer accesses. In 2015 Intel provided their Intel MPX
55 extensions in their Skylake processor architecture which stores bounds in
56 a CPU register and table in memory. As of early 2017 GCC among others,
57 supports MPX extensions.</para>
58 </section>
59
60 <section id="rootkit">
61 <title>Rootkit</title>
62
63 <para>A rootkit is a collection of malicious software designed to enable
64 access to another software that would not otherwise be allowed, e.g: to an
65 unauthorized user, and often masks its existence or the existence of other
66 software. The term rootkit is a concatenation of "root" and
67 the word "kit", which refers to the software components that implement the
68 tool, and is associated with malware.</para>
69 </section>
70</appendix> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/book.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/book.xml
deleted file mode 100644
index 1a75484..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/book.xml
+++ /dev/null
@@ -1,29 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
5]>
6<book id="book_enea_nfv_access_hardening_guide">
7 <title><trademark class="registered">Enea</trademark> NFV Access Developer's
8 Hardening Guide</title>
9
10 <subtitle>Release Version <xi:include href="eltf_params_updated.xml"
11 xmlns:xi="http://www.w3.org/2001/XInclude"
12 xpointer="element(EneaLinux_REL_VER/1)" /></subtitle>
13
14 <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb -->
15
16 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml"
17 xmlns:xi="http://www.w3.org/2001/XInclude" />
18
19 <xi:include href="introduction.xml"
20 xmlns:xi="http://www.w3.org/2001/XInclude" />
21
22 <xi:include href="hardening_checklist.xml"
23 xmlns:xi="http://www.w3.org/2001/XInclude" />
24
25 <xi:include href="metasecure_tools.xml"
26 xmlns:xi="http://www.w3.org/2001/XInclude" />
27 <xi:include href="appendix_a.xml"
28 xmlns:xi="http://www.w3.org/2001/XInclude" />
29</book> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_template.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_template.xml
deleted file mode 100644
index eaa7ebd..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_template.xml
+++ /dev/null
@@ -1,151 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting>ELTF_PL_HOST_PREREQ</programlisting></para>
26
27 <bridgehead>A programlisting, ID
28 "eltf-getting-repo-install-command"</bridgehead>
29
30 <para id="eltf-getting-repo-install-command"><programlisting>ELTF_PL_GET_REPO</programlisting></para>
31
32 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
33 correct also compared to the "previous" REL VER in pardoc-distro.xml
34 "prev_baseline".</bridgehead>
35
36 <para id="EneaLinux_REL_VER"><phrase>ELTF_EL_REL_VER</phrase></para>
37
38 <para id="Yocto_VER"><phrase>ELTF_YOCTO_VER</phrase></para>
39
40 <para id="Yocto_NAME"><phrase>ELTF_YOCTO_NAME</phrase></para>
41
42 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
43 url="ELTF_YOCTO_PROJ_DOWNLOAD_URL">ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL</ulink></para>
44
45 <para id="ULINK_ENEA_LINUX_URL"><ulink
46 url="ELTF_EL_DOWNLOAD_URL">ELTF_EL_DOWNLOAD_TXTURL</ulink></para>
47
48 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
49 $MACHINE/default.xml as parameter, where MACHINE is one of the target
50 directory names in the manifest.</bridgehead>
51
52 <para id="eltf-repo-cloning-enea-linux"><programlisting>ELTF_PL_CLONE_W_REPO</programlisting></para>
53
54 <bridgehead>A table with ONE row, only the row with ID
55 "eltf-eclipse-version-row" is included in the book. MANUALLY BOTH in the
56 template.xml and in the updated.xml, set condition hidden on the
57 &lt;row&gt;, if eclipse is not in the release.</bridgehead>
58
59 <informaltable>
60 <tgroup cols="1">
61 <tbody>
62 <row id="eltf-eclipse-version-row">
63 <entry>Eclipse version ELTF_ECLIPSE_VERSION plus command line
64 development tools are included in this Enea NFV Access release.</entry>
65 </row>
66 </tbody>
67 </tgroup>
68 </informaltable>
69
70 <bridgehead>Below is one big section with title "Supported Targets with
71 Parameters". The entire section is included completely in the book via ID
72 "eltf-target-tables-section" and shall be LAST in the template. The
73 template contains ONE target subsection. COPY/APPEND it, if multiple
74 targets exist in the release and optionally add rows with additional
75 target parameters in each target subsection table.</bridgehead>
76 </section>
77
78 <section id="eltf-target-tables-section">
79 <title>Supported Targets with Parameters</title>
80
81 <para>The tables below describes the target(s) supported in this Enea
82 NFV Access release.</para>
83
84 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
85 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
86
87 <para><informaltable>
88 <tgroup cols="2">
89 <colspec colwidth="6*" />
90
91 <colspec colwidth="9*" />
92
93 <tbody>
94 <row>
95 <entry>Target official name</entry>
96
97 <entry>ELTF_T_NAME</entry>
98 </row>
99
100 <row>
101 <entry>Architecture and Description</entry>
102
103 <entry>ELTF_T_ARC_DESC</entry>
104 </row>
105
106 <row>
107 <entry>Link to target datasheet</entry>
108
109 <entry>See <ulink
110 url="ELTF_T_DS_URL">ELTF_T_DS_TXTURL</ulink></entry>
111 </row>
112
113 <row>
114 <entry>Poky version</entry>
115
116 <entry>ELTF_T_POKY_VER</entry>
117 </row>
118
119 <row>
120 <entry>GCC version</entry>
121
122 <entry>ELTF_T_GCC_VER</entry>
123 </row>
124
125 <row>
126 <entry>Linux Kernel Version</entry>
127
128 <entry>ELTF_T_KERN_VER</entry>
129 </row>
130
131 <row>
132 <entry>Supported Drivers</entry>
133
134 <entry>ELTF_T_DRIVERS</entry>
135 </row>
136
137 <row>
138 <entry>Enea rpm folder for downloading RPM packages for this
139 target</entry>
140
141 <entry><ulink
142 url="ELTF_T_EL_RPM_URL">ELTF_T_EL_RPM_TXTURL</ulink></entry>
143 </row>
144 </tbody>
145 </tgroup>
146 </informaltable></para>
147 </section>
148
149 <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->
150 </section>
151</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated.xml
deleted file mode 100644
index 1db30fd..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated.xml
+++ /dev/null
@@ -1,165 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 14.04.5 LTS 64bit
26sudo apt-get -y update
27sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
28 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
29 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
30 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
31 libxml-parser-perl</programlisting></para>
32
33 <bridgehead>A programlisting, ID
34 "eltf-getting-repo-install-command"</bridgehead>
35
36 <para id="eltf-getting-repo-install-command"><programlisting>mkdir -p ~/bin
37curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo
38chmod a+x ~/bin/repo
39export PATH=~/bin:$PATH</programlisting></para>
40
41 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
42 correct also compared to the "previous" REL VER in pardoc-distro.xml
43 "prev_baseline".</bridgehead>
44
45 <para id="EneaLinux_REL_VER"><phrase>1.1</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.1</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>krogoth</phrase></para>
50
51 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
52 url="http://www.yoctoproject.org/downloads/core/krogoth/21">http://www.yoctoproject.org/downloads/core/krogoth/21</ulink></para>
53
54 <para id="ULINK_ENEA_LINUX_URL"><ulink
55 url="https://linux.enea.com/6">https://linux.enea.com/6</ulink></para>
56
57 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
58 $MACHINE/default.xml as parameter, where MACHINE is one of the target
59 directory names in the manifest.</bridgehead>
60
61 <para id="eltf-repo-cloning-enea-linux"><programlisting>mkdir enea-linux
62cd enea-linux
63repo init -u git@git.enea.com:linux/manifests/el_manifests-virtualization.git \
64 -b refs/tags/EL6 -m $MACHINE/default.xml
65repo sync</programlisting></para>
66
67 <bridgehead>A table with ONE row, only the row with ID
68 "eltf-eclipse-version-row" is included in the book. MANUALLY in book, set
69 condition hidden if eclipse is not in the release. Do this both in
70 template.xml and updated.xml.</bridgehead>
71
72 <informaltable>
73 <tgroup cols="1">
74 <tbody>
75 <row condition="hidden" id="eltf-eclipse-version-row">
76 <entry>Eclipse version 4.3 (Mars) plus command line development
77 tools are included in this Enea NFV Access release.</entry>
78 </row>
79 </tbody>
80 </tgroup>
81 </informaltable>
82
83 <bridgehead>Below is one big section with title "Supported Targets with
84 Parameters". The entire section is included completely in the book via ID
85 "eltf-target-tables-section" and shall be LAST in the template. The
86 template contains ONE target subsection. COPY/APPEND it, if multiple
87 targets exist in the release and optionally add rows with additional
88 target parameters in each target subsection table.</bridgehead>
89 </section>
90
91 <section id="eltf-target-tables-section">
92 <title>Supported Reference Boards with Parameters</title>
93
94 <para>The tables below describes the target(s) supported in this Enea NFV
95 Access release.</para>
96
97 <section id="eltf-target-table-p2041rdb">
98 <title>MACHINE p2041rdb - Information</title>
99
100 <para><informaltable>
101 <tgroup cols="2">
102 <colspec colwidth="6*" />
103
104 <colspec colwidth="9*" />
105
106 <tbody>
107 <row>
108 <entry>Target official name</entry>
109
110 <entry>P2041RDB</entry>
111 </row>
112
113 <row>
114 <entry>Architecture and Description</entry>
115
116 <entry>Power, e500mc</entry>
117 </row>
118
119 <row>
120 <entry>Link to target datasheet</entry>
121
122 <entry>See <ulink
123 url="http://www.nxp.com/products/microcontrollers-and-processors/power-architecture-processors/qoriq-power-architecture-processors/p2041-qoriq-reference-design-board:RDP2041BOARD">link
124 to NXP's datasheet</ulink></entry>
125 </row>
126
127 <row>
128 <entry>Poky version</entry>
129
130 <entry>Git-commit-id:
131 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
132 </row>
133
134 <row>
135 <entry>GCC version</entry>
136
137 <entry>5.3</entry>
138 </row>
139
140 <row>
141 <entry>Linux Kernel Version</entry>
142
143 <entry>3.12</entry>
144 </row>
145
146 <row>
147 <entry>Supported Drivers</entry>
148
149 <entry>Ethernet, I2C, SPI, PCI Express, USB, Flash,
150 SD/SDHC/SDXC, RTC</entry>
151 </row>
152
153 <row>
154 <entry>Enea rpm folder for downloading RPM packages for this
155 target</entry>
156
157 <entry><ulink
158 url="https://linux.enea.com/6/p2041rgb/rpm">https://linux.enea.com/6/p2041rgb/rpm</ulink></entry>
159 </row>
160 </tbody>
161 </tgroup>
162 </informaltable></para>
163 </section>
164 </section>
165</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt b/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt
deleted file mode 100644
index 87a6445..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt
+++ /dev/null
@@ -1,320 +0,0 @@
1eltf_params_template_updated_howto_use.txt
2
3This is a way to collect all parameters for an Enea NFV Access release
4in one parameter file, easy to automatically update by ELTF regularly.
5
6NOTE: Both the release info AND the open source books use parameters from
7 here, but the XML file is inside the release info book directory.
8
9NOTE: The manifest_conf.mk, or overridden by the environment variable
10 MANIFESTHASH, contains the full tag (or hashvalue) for downloading
11 the manifest when the books are built. The list of target
12 directories are fetched from the manifest into the book.
13 The eltf_params_updates.xml can all the time contain
14 the final next complete tag e.g. refs/tags/EL6 or similar
15 in the ELTF_PL_CLONE_W_REPO parameter command lines.
16
17The ordinary book XML files use xi:include statements to include elements
18from this parameter file. The book XML files can thus be manually edited.
19Before editing, you must run "make init".
20Any other text in the template or updated.xml file, outside the parts that
21are included in the book, are not used but still all must be correct
22DocBook XML files.
23
24ELTF work:
25 template => ELTF replaces ALL ELTF_xxx variables => updated XML file
26 => push to git only if changed
27
28
29eltf_params_template.xml (in git)
30 File used by ELTF to autocreate/update the real parameter
31 file eltf_params_updated.xml.
32
33eltf_params_updated.xml (in git)
34 Real parameter file where ELTF has replaced all ELTF_xx variables with
35 strings, in several cases with multiline strings.
36 No spaces or linefeed allowed in beginning or end of the variable values!
37
38
39xi:include: Each parameter is xi:include'ed in various book files, using
40 the IDs existing in the parameter files.
41 In most cases the 1:st element inside an element with an ID is included
42 using a format like eltf-prereq-apt-get-commands-host/1.
43 In very few cases the element with the ID is included in the book, one
44 example is the target section which has an ID, but which contains
45 multiple subsections, one per target.
46 All IDs in a book must be unique.
47
48DocBook XML: All XML files must be correct DocBook XML files.
49
50Do NOT edit/save the real *updated.xml file with XMLmind to avoid changes
51 not done by ELTF. But it is OK to open the real file in XMLmind to
52 check that the format is correct.
53
54ELTF should autocreate a temporary "real" file but only replace
55 and push the eltf_params_updated.xml if it is changed.
56
57
58make eltf
59 This lists all ELTF_xxx variables and some rules how to treat them
60
61DocBook Format: All elements - rules:
62 Several strict generic XML rules apply for all strings:
63 1. No TABs allowed or any other control chr than "linefeed"
64 2. Only 7-bit ASCII
65 3. Any < > & must be converted to &lt; &gt; and &amp;
66 Similar for any other non-7-bit-ASCII but avoid those!
67 4. No leading spaces or linefeeds when replacing the ELTF_* variable
68 5. No trailing spaces or linefeeds when replacing the ELTF_* variable
69 6. Note: Keep existing spaces before/efter ELTF_* in a few cases.
70
71DocBook Format: <programlisting> - rules: ELTF*PL* variables
72 Several strict rules apply for the multiline string in programlisting
73 in addition to the general XML rules above:
74 7. Max line length < 80 char
75 8. Use backslash (\) to break longer lines
76 9. Use spaces (e.g. 4) to indent continuation lines in programlistings
77 10. No trailing spaces on any line
78 11. No spaces or linefeed immediately after leading <programlisting>
79 12. No spaces or linefeed before trailing </programlisting>
80
81DocBook Format: <ulink> - rules: ELTF_*URL* variables
82 13. ELTF_*URL and corresponding ELTF_*TXTURL shall be identical strings
83 14. Only if the URL is extremely long, the TXTURL can be a separate string
84
85Each target has one section with target parameters:
86 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
87 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
88 ..... with many ELTF_ variables ....
89 </section>
90
91 15. If there is only one target. ELTF just replaces ELTF parameters
92
93 16. It there are multiple targets. ELTF copies the section and appends the
94 section the required number of times.
95 Each section ID will become unique: eltf-target-table-ELTF_T_MANIFEST_DIR
96 Each section title will become unique
97
98Tables with target parameters in each target section:
99 17. It is possible for ELTF to append more rows with one parameter each
100 to these tables, because the entire tables are included in the book
101
102Special - NOT YET READY DEFINED how to handle the optionally included
103 Eclipse and its version, but this is a first suggestion:
104 18. Just now ELTF can define ELFT_ECLIPSE_VERSION as a full string
105 with both version number and name,
106 19. MANUALLY if Eclipse is NOT included in the release,
107 the release manager should manually set condition="hidden" on
108 the entire section in the book XML about Eclipse
109
110
111
112BELOW WE TRY TO EXPLAIN EACH ELTF_* variable, but always check with make eltf
113if there are more new variables, missing in this description file.
114
115_____________________________________________________________________________
116ELTF_PL_HOST_PREREQ Multiline list of host prerequisites, e.g. commands
117 like sudo apt-get install xxxx or similar.
118 First line = comment with the complete host name!
119 It is possible to include multiple hosts by just
120 adding an empty line, comment with host name, etc.
121 xi:include eltf-prereq-apt-get-commands-host/1
122 This is a <programlisting>...</programlisting>
123 Example:
124# Host Ubuntu 14.04.5 LTS 64bit
125sudo apt-get update
126sudo apt-get install sed wget subversion git-core coreutils unzip texi2html \
127 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
128 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
129 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
130 libxml-parser-perl
131
132_____________________________________________________________________________
133ELTF_PL_GET_REPO Multiline commands to download the repo tool
134 xi:include eltf-getting-repo-install-command/1
135 This is a <programlisting>...</programlisting>
136 Example:
137mkdir -p ~/bin
138curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
139chmod a+x ~/bin/repo
140export PATH=~/bin:$PATH
141
142_____________________________________________________________________________
143ELTF_EL_REL_VER General parameter string: The version of this Enea
144 Linux release. Major version and optional .Minor
145 Typically created from MAJOR and MINOR in enea.conf
146 MINOR in enea.conf is empty or contains a dot+minor
147 xi_include EneaLinux_REL_VER/1
148 This is a <phrase>X.x</phrase> used in many places.
149 Examples:
1506
151 or
1526.1
153
154_____________________________________________________________________________
155ELTF_YOCTO_VER General parameter string: Yocto version, created
156 from DISTRO in poky.ent
157 xi:include Yocto_VER/1
158 This is a <phrase>X.x</phrase> used in many places.
159 Example:
1602.1
161
162_____________________________________________________________________________
163ELTF_YOCTO_NAME General parameter string: Yocto name (branch), created
164 from DISTRO_NAME_NO_CAP in poky.ent
165 xi:include Yocto_NAME/1
166 This is a <phrase>X.x</phrase> used in many places.
167 Example:
168krogoth
169
170_____________________________________________________________________________
171ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL
172ELTF_YOCTO_PROJ_DOWNLOAD_URL strings with correct Yocto version string
173 at the end, typically without "dot".
174 xi:include ULINK_YOCTO_PROJECT_DOWNLOAD/1
175 This is an <ulink url="...">...</ulink>
176 Example:
177http://www.yoctoproject.org/downloads/core/krogoth/21
178
179_____________________________________________________________________________
180ELTF_EL_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL strings
181ELTF_EL_DOWNLOAD_URL and shall be the http:/..... address where
182 Enea NFV Access can be downloaded
183 Often containing same version as in ELTF_EL_REL_VER
184 xi:include ULINK_ENEA_LINUX_URL/1
185 This is an <ulink url="...">...</ulink>
186 Example:
187http://linux.enea.com/6
188
189_____________________________________________________________________________
190ELTF_PL_CLONE_W_REPO Multiline commands to run repo to clone everything.
191 Use the variable $MACHINE/default.xml (the text in
192 the book will list the avaiable values of MACHINE,
193 taken from the manifest repository)
194 xi:include eltf-repo-cloning-enea-linux/1
195 This is a <programlisting>...</programlisting>
196 Example:
197mkdir enea-linux
198cd enea-linux
199repo init -u git://git.enea.com/linux/el_manifests-standard.git \
200 -b refs/tags/EL6 -m $MACHINE/default.xml
201repo sync
202
203_____________________________________________________________________________
204ELTF_ECLIPSE_VERSION Optional general parameter string.
205 NOT YET READY DEFINED
206 Just now a release manage must manually set
207 condition="hidden" on the Eclipse section,
208 if Eclipse is not included in the release.
209 ELTF just replaces ELTF_ECLIPSE_VERSION with a full
210 string with "X.Y (name)"
211 It includes the ID and can only be ONCE in the book.
212 xi:include eltf-eclipse-version-row
213 Example.
2144.5 (Mars)
215
216
217_____________________________________________________________________________
218ELTF_T_* All these are in each target (MACHINE) and ELTF
219 must separately replace them with strings for
220 each target
221 NOTE: All (except the MANIFEST_DIR) are in rows
222 in a table and ELTF can select to append
223 more parameters by adding more rows
224
225_____________________________________________________________________________
226ELTF_T_MANIFEST_DIR This happens to be in two places. Must be exactly
227ELTF_T_MANIFEST_DIR the directory name in the manifest, e.g. same
228 as the MACHINE names in $MACHINE/default.xml.
229 In book: a) Part of section ID
230 b) Part of section title
231 Examples:
232p2041rgb
233 or
234ls1021aiot
235 or
236qemuarm
237
238_____________________________________________________________________________
239ELTF_T_NAME Target specific: "Target Official Name"
240 NOT same as the target directory name in most cases.
241 In book: An <entry> element in a row
242 Examples:
243P2041RGB
244 or
245LS1021a-IoT
246 or
247qemuarm
248
249_____________________________________________________________________________
250ELTF_T_ARC_DESC Target specific: "Architecture and Description"
251 It can be a short identification string or
252 it can be a longer descriptive sentence.
253 In book: An <entry> element in a row
254 Examples:
255Power, e500mc
256 or
257ARM Cortex-A7
258
259_____________________________________________________________________________
260ELTF_T_DS_TXTURL Target specific: "Link to target datasheet. These
261ELTF_T_DS_URL two usually are IDENTICAL strings with correct
262 hyperlink to the target's official datasheet.
263 In book: an <ulink url="...">...</ulink>
264 Only if the link is VERY LONG, the text part shall
265 instead be a descriptive string (see 2:nd example).
266 NOTE: Also here no spaces or line-feeds!
267 Examples:
268url="http://wiki.qemu.org">http://wiki.qemu.org
269or
270url="http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/qoriq-arm-processors/qoriq-ls1021a-iot-gateway-reference-design:LS1021A-IoT">link to NXP's datasheet
271
272_____________________________________________________________________________
273ELTF_T_POKY_VER Target specific: "Poky version" created either
274 from POKYVERSION in poky.ent
275 or using a hashvalue with a leading string, in
276 which case it may be different per target.
277 In book: An <entry> in a row
278 Examples:
27915.0.0
280or
281Git commit id: 75ca53211488a3e268037a44ee2a7ac5c7181bd2
282
283_____________________________________________________________________________
284ELTF_T_GCC_VER Target specific: "GCC Version". Should be in poky
285 but not easy to find among various parameters.
286 ELTF would extract it from build logs building SDK
287 and it is possibly different per target.
288 In book: An <entry> in a row
289 Example:
2905.3
291
292_____________________________________________________________________________
293ELTF_T_KERN_VER Target specific: "Linux Kernel Version". Often
294 different per target.
295 In book: An <entry> in a row
296 Example:
2973.12
298
299_____________________________________________________________________________
300ELTF_T_DRIVERS Target specific: "Supported Drivers". This is a
301 comma-separated list of driver names.
302 ELTF should create the list in same order for each
303 target, e.g. alphabetic migth be OK.
304 In book: An <entry> in a row
305 Example:
306Ethernet, I2C, SPI, PCI, USB, SD/SDHC/SDXC
307
308
309_____________________________________________________________________________
310ELTF_T_EL_RPM_TXTURL Target specific: "Enea rpm folder for downloading
311ELTF_T_EL_RPM_URL RPM packages for this target". These two are
312 INDENTICAL strings with hyperlink to the web site
313 at Enea where the customer can download RPMs
314 Note: Often the ELFT_EL_REL_VER value and
315 the ELTF_T_MANIFEST_DIR are used in the link.
316 In book: an <ulink url="...">...</ulink>
317 Example:
318url="https://linux.enea.com/6/ls1021aiot/rpm">https://linux.enea.com/6/ls1021aiot/rpm
319
320_____________________________________________________________________________
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml
deleted file mode 100644
index f444cd5..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/hardening_checklist.xml
+++ /dev/null
@@ -1,952 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="hardening_platform">
5 <title>Hardening Enea NFV Access</title>
6
7 <section id="broken_algorithms">
8 <title>Broken Algorithms</title>
9
10 <para>Algorithms that are broken in regards to security must not be used.
11 The following should be verified to prevent this issue:</para>
12
13 <remark>Ask Sona/Casc if the algorithms listed below are the broken ones
14 to check for or if they're the ones that are broken to begin with and if
15 seen should be eliminated from use.</remark>
16
17 <itemizedlist>
18 <listitem>
19 <para>DES</para>
20 </listitem>
21
22 <listitem>
23 <para>3DES</para>
24 </listitem>
25
26 <listitem>
27 <para>CAST</para>
28 </listitem>
29
30 <listitem>
31 <para>BLOWFISH</para>
32 </listitem>
33
34 <listitem>
35 <para>MD5</para>
36 </listitem>
37
38 <listitem>
39 <para>SHA-1</para>
40 </listitem>
41
42 <listitem>
43 <para>MODP512</para>
44 </listitem>
45
46 <listitem>
47 <para>MODP768</para>
48 </listitem>
49
50 <listitem>
51 <para>MODP1024</para>
52 </listitem>
53 </itemizedlist>
54 </section>
55
56 <section id="sys_installation">
57 <title>System Installation</title>
58
59 <para>Enea NFV Access Images should be check summed with SHA512 and/or a
60 signed GPG key. Please see <ulink
61 url="https://www.openssl.org/source/">https://www.openssl.org/source/</ulink>
62 for more details on how to proceed.</para>
63 </section>
64
65 <section id="security_updates">
66 <title>Security Updates</title>
67
68 <para>Applying security patches is an important part of security hardening
69 and maintenance. Enea backports all known critical vulnerabilities within
70 a reasonable time frame and makes them available to users for
71 updates/upgrades.</para>
72
73 <para>Prepare the system for regular updates in the following
74 manner:</para>
75
76 <itemizedlist>
77 <listitem>
78 <para>Configure the target to get software updates from the Enea
79 source repository.</para>
80 </listitem>
81
82 <listitem>
83 <para>Test to update or remove a package using apt-get command:
84 <programlisting>root@inteld1521:~#apt-get update/upgrade</programlisting></para>
85 </listitem>
86 </itemizedlist>
87 </section>
88
89 <section id="openembedded_security_layer">
90 <title>OpenEmbedded meta-security layer</title>
91
92 <para>An OpenEmbedded meta-security layer provides many hardening open
93 source packages suited for embedded devices. Below is a list of several
94 packages included in meta-security layer:</para>
95
96 <itemizedlist>
97 <listitem>
98 <para>Bastille</para>
99 </listitem>
100
101 <listitem>
102 <para>Redhat-security</para>
103 </listitem>
104
105 <listitem>
106 <para>Buck-security</para>
107 </listitem>
108
109 <listitem>
110 <para>Libseccomp</para>
111 </listitem>
112
113 <listitem>
114 <para>Pax-utils</para>
115 </listitem>
116
117 <listitem>
118 <para>Nmap</para>
119 </listitem>
120
121 <listitem>
122 <para>ISIC</para>
123 </listitem>
124
125 <listitem>
126 <para>Tripwire</para>
127 </listitem>
128
129 <listitem>
130 <para>checksecurity</para>
131 </listitem>
132
133 <listitem>
134 <para>TOMOYO, which contains a number of very useful libraries for
135 system analysis. <remark>Ask Sona if this is the intended meaning of
136 what she wrote here originally: TOMOYO and a number of libraries which
137 is very useful system analysis tool</remark></para>
138 </listitem>
139 </itemizedlist>
140
141 <para>For more information about tools supported in the meta-security
142 layer please refer to the chapter: <emphasis role="bold">Introduction to
143 the Tools in meta-security layer</emphasis>.</para>
144
145 <remark>change the bold text to point to the section/chapter in question
146 through an xref refering to chapter 3 of the same title.</remark>
147 </section>
148
149 <section id="ker-hardening">
150 <title>Kernel Hardening</title>
151
152 <para>For a secure set of build CONFIGs and runtime settings see the
153 <ulink
154 url="https://kernsec.org/wiki/index.php/Kernel_Self_Protection_Project/Recommended_Settings">Kernel
155 Self Protection Project</ulink>. Essentially, there are three ways to pass
156 options to the kernel:</para>
157
158 <itemizedlist>
159 <listitem>
160 <para>When building the kernel (via
161 <command>menuconfig</command>)</para>
162 </listitem>
163
164 <listitem>
165 <para>When starting the kernel (usually, when invoked from a boot
166 loader).</para>
167 </listitem>
168
169 <listitem>
170 <para>At runtime (through the files in <command>/proc</command> and
171 <command>/sys</command>). See <command>sysctl</command> for
172 details.</para>
173 </listitem>
174 </itemizedlist>
175
176 <para>Parameters either have the format <literal>parameter</literal> or
177 <literal>parameter=value</literal>. Kernel parameters can be configured
178 via <command>/etc/sysctl.conf</command> at run time or via
179 <command>menuconfig</command> at build time.</para>
180
181 <orderedlist>
182 <listitem>
183 <para>How to enable/disable kernel parameters via menuconfig:</para>
184
185 <itemizedlist>
186 <listitem>
187 <para>bitbake virtual/kernel &ndash;c menuconfig</para>
188 </listitem>
189
190 <listitem>
191 <para>Enable the configuration you want, save the .config file in
192 the build directory, and run bitbake.</para>
193 </listitem>
194 </itemizedlist>
195
196 <para>For more info see <ulink
197 url="http://www.tldp.org/HOWTO/SCSI-2.4-HOWTO/kconfig.html">http://www.tldp.org/HOWTO/SCSI-2.4-HOWTO/kconfig.html</ulink>.</para>
198 </listitem>
199
200 <listitem>
201 <para>Permanently add a Kernel Boot Parameter from boot loader:</para>
202
203 <para><programlisting>sudo gedit /etc/default/grub</programlisting></para>
204
205 <para>Enter your password when prompted by sudo. If the file
206 <command>/etc/default/grub</command> appears to be empty or does not
207 exist, see the instructions for earlier releases above.</para>
208 </listitem>
209
210 <listitem>
211 <para>Using <command>etc/sysctl.conf</command>:</para>
212
213 <para>We can view the value of a particular Linux kernel parameter
214 using sysctl, followed by the name of the parameter:</para>
215
216 <programlisting>root@inteld1521:~# sysctl dev.cdrom.autoclose
217dev.cdrom.autoclose = 1</programlisting>
218
219 <para>Or read the associated file:</para>
220
221 <programlisting>root@inteld1521:~# cat /proc/sys/dev/cdrom/autoclose
2221
223root@inteld1521:~# cat /proc/sys/dev/cdrom/</programlisting>
224
225 <para>It is good to store the output of the kernel settings for
226 comparison or reference by redirecting the output of the sysctl
227 command to a file, for example:</para>
228
229 <programlisting>sysctl -A &gt; /root/sysctl.settings.store</programlisting>
230 </listitem>
231 </orderedlist>
232
233 <para>The following kernel configurations can be used to secure the Linux
234 system against attacks.</para>
235
236 <programlisting># Turn on execshield
237kernel.exec-shield=1
238kernel.randomize_va_space=1
239
240# Enable IP spoofing protection
241net.ipv4.conf.all.rp_filter=1
242
243# Disable IP source routing
244net.ipv4.conf.all.accept_source_route=0
245
246# Ignore broadcasts request
247net.ipv4.icmp_echo_ignore_broadcasts=1
248net.ipv4.icmp_ignore_bogus_error_messages=1
249
250# Make sure spoofed packets get logged
251net.ipv4.conf.all.log_martians = 1</programlisting>
252
253 <section id="security-options">
254 <title>Security Options</title>
255
256 <itemizedlist>
257 <listitem>
258 <para>SECURITY</para>
259
260 <itemizedlist>
261 <listitem>
262 <para>(on/off) Enable different security models</para>
263 </listitem>
264
265 <listitem>
266 <para>Depends on SYSFS</para>
267 </listitem>
268 </itemizedlist>
269
270 <para>This option allows you to choose different security modules to
271 configure into your kernel. If this option is not selected, the
272 default Linux security model will be used.</para>
273 </listitem>
274
275 <listitem>
276 <para>SECURITY_NETWORK</para>
277
278 <itemizedlist>
279 <listitem>
280 <para>(on/off) Socket and Networking Security Hooks</para>
281 </listitem>
282
283 <listitem>
284 <para>Depends on SECURITY</para>
285 </listitem>
286 </itemizedlist>
287
288 <para>This enables the socket and networking security hooks. If
289 enabled, a security module can use these hooks to implement socket
290 and networking access controls. If you are unsure how to answer this
291 question, answer N.</para>
292 </listitem>
293
294 <listitem>
295 <para>SECURITY_CAPABILITIES</para>
296
297 <itemizedlist>
298 <listitem>
299 <para>Kernel Version(s): 2.6.15.6</para>
300 </listitem>
301
302 <listitem>
303 <para>(on/off/module) Default Linux Capabilities</para>
304 </listitem>
305
306 <listitem>
307 <para>Depends on SECURITY</para>
308 </listitem>
309 </itemizedlist>
310
311 <para>This enables the "default" Linux capabilities
312 functionality.</para>
313 </listitem>
314
315 <listitem>
316 <para>SECURITY_ROOTPLUG</para>
317
318 <itemizedlist>
319 <listitem>
320 <para>Kernel Version(s): 2.6.15.6</para>
321 </listitem>
322
323 <listitem>
324 <para>(on/off/module) Root Plug Support</para>
325 </listitem>
326
327 <listitem>
328 <para>depends on USB &amp;&amp; SECURITY</para>
329 </listitem>
330 </itemizedlist>
331
332 <para>This is a sample LSM module that should only be used as such.
333 It prevents any programs running with <command>egid == 0</command>
334 if a specific USB device is not present in the system.</para>
335 </listitem>
336
337 <listitem>
338 <para>SECURITY_SECLVL</para>
339
340 <itemizedlist>
341 <listitem>
342 <para>Kernel Version(s): 2.6.15.6</para>
343 </listitem>
344
345 <listitem>
346 <para>(on/off/module) BSD Secure Levels</para>
347 </listitem>
348
349 <listitem>
350 <para>Depends on SECURITY</para>
351 </listitem>
352
353 <listitem>
354 <para>select CRYPTO</para>
355 </listitem>
356
357 <listitem>
358 <para>select CRYPTO_SHA1</para>
359 </listitem>
360 </itemizedlist>
361
362 <para>Implements BSD Secure Levels as an LSM. See file
363 <command>Documentation/seclvl.txt</command> for instructions on how
364 to use this module.</para>
365 </listitem>
366 </itemizedlist>
367 </section>
368
369 <section id="config_stackprotector">
370 <title>Stack Protector (-fstack-protector GCC feature)</title>
371
372 <para><programlisting>CONFIG_CC_STACKPROTECTOR
373CONFIG_CC_STACKPROTECTOR_REGULAR
374CONFIG_CC_STACKPROTECTOR_STRONG</programlisting>This option turns on the
375 <command>-fstack-protector</command> GCC feature. This feature inserts a
376 canary value on the stack just before the return address, and validates
377 the value just before returning. Stack based buffer overflows (that need
378 to overwrite this return address) will now also overwrite the canary,
379 which gets detected and the attack is then neutralized via a kernel
380 panic. This feature requires gcc version 4.2 or above.</para>
381
382 <itemizedlist>
383 <listitem>
384 <para>prompt: Enable -fstack-protector buffer overflow detection
385 (EXPERIMENTAL)</para>
386 </listitem>
387
388 <listitem>
389 <para>type: bool</para>
390 </listitem>
391
392 <listitem>
393 <para>depends on: (none)</para>
394 </listitem>
395
396 <listitem>
397 <para>defined in arch/arm/Kconfig</para>
398 </listitem>
399
400 <listitem>
401 <para>found in Linux kernels: 2.6.36&ndash;2.6.39,
402 3.0&ndash;3.13</para>
403 </listitem>
404 </itemizedlist>
405
406 <para>Currently these configurations are not set in the Intel kernel in
407 Enea NFV Access:<programlisting>tmp/deploy/images/inteld1521/config-inteld1521.config
408
409CONFIG_CC_STACKPROTECTOR is not set
410CONFIG_CC_STACKPROTECTOR_REGULAR is not set
411CONFIG_CC_STACKPROTECTOR_STRONG is not set</programlisting></para>
412 </section>
413
414 <section id="config-freelist-random">
415 <title>CONFIG_FREELIST_RANDOM</title>
416
417 <para>An optional config to randomize the SLAB freelist (heap freelist).
418 SLAB is a memory management mechanism intended for the efficient memory
419 allocation of kernel objects. SLAB displays the desirable property of
420 eliminating fragmentation caused by allocations and
421 deallocations.</para>
422
423 <para>This security feature reduces the predictability of the kernel
424 slab allocator against heap overflows.</para>
425 </section>
426
427 <section id="config_page_poisoning">
428 <title>CONFIG_PAGE_POISONING</title>
429
430 <para>This feature fills the pages with poison patterns after
431 <literal>free_pages()</literal> and verifies the patterns before
432 <literal>alloc_pages()</literal>. This results in a large slowdown, but
433 helps to find certain types of memory corruption.</para>
434
435 <para>This option cannot be enabled in combination with hibernation as
436 that would result in incorrect warnings of memory corruption after a
437 resume, since free pages are not saved to the suspend image. Poison
438 pages after freeing are found in
439 <literal>mm/Kconfig.debug</literal>.</para>
440
441 <para>The configuration item CONFIG_PAGE_POISONING:</para>
442
443 <itemizedlist>
444 <listitem>
445 <para>prompt: Poison pages after freeing</para>
446 </listitem>
447
448 <listitem>
449 <para>type: bool</para>
450 </listitem>
451
452 <listitem>
453 <para>depends on: (none)</para>
454 </listitem>
455
456 <listitem>
457 <para>defined in <ulink
458 url="https://github.com/torvalds/linux/tree/master/mm/Kconfig.debug">mm/Kconfig.debug</ulink></para>
459 </listitem>
460
461 <listitem>
462 <para>found in Linux kernels: 4.6&ndash;4.12, 4.13-rc+HEAD</para>
463 </listitem>
464 </itemizedlist>
465 </section>
466
467 <section id="config_hardened_usercopy">
468 <title>CONFIG_HARDENED_USERCOPY</title>
469
470 <para><programlisting>CONFIG_HARDENED_USERCOPY
471CONFIG_HARDENED_USERCOPY_PAGESPAN</programlisting>This configuration checks
472 that objects being copied to/from user space meet certain
473 criteria.</para>
474 </section>
475
476 <section id="config_stackprotector_strong">
477 <title>CONFIG_CC_STACKPROTECTOR_STRONG</title>
478
479 <para><command>CONFIG_CC_STACKPROTECTOR_STRONG=y</command>, is a more
480 powerful stack canary checking method supported by GCC versions 4.9 and
481 later. On an x86 "defconfig" build, this feature adds canary checks to
482 about 20% of all kernel functions, which increases the kernel code size
483 by about 2%.</para>
484
485 <para>More info about this feature can be found at <ulink
486 url="https://lwn.net/Articles/584278/">https://lwn.net/Articles/584278/</ulink>.</para>
487 </section>
488
489 <section id="config_randomize_base">
490 <title>CONFIG_RANDOMIZE_BASE</title>
491
492 <para><command>CONFIG_RANDOMIZE_BASE</command> with physical memory
493 randomization, extends kernel image physical address randomization to
494 addresses larger than 4GB, among other improvements.</para>
495 </section>
496
497 <section id="config_randomize_memory">
498 <title>CONFIG_RANDOMIZE_MEMORY</title>
499
500 <para><command>CONFIG_RANDOMIZE_MEMORY</command> randomizes the virtual
501 addresses of memory sections, including physical memory mappings:
502 <command>vmalloc</command>, and <command>vemmap</command>. As with other
503 memory randomization routines, by randomizing the virtual address space
504 of kernel memory sections, the goal is to mitigate predictable memory
505 locations.</para>
506 </section>
507 </section>
508
509 <section id="os_hardening">
510 <title>OS Hardening</title>
511
512 <para>The sections below detail various ways in which a developer can
513 effectively secure their operating system(s).</para>
514
515 <section id="removing_root_account">
516 <title>Remove root account</title>
517
518 <para>Create a default user with <command>su</command> access and then
519 use <literal>sudo</literal> to delegate administrative access.</para>
520 </section>
521
522 <section id="syslog-rsyslog">
523 <title>Rsyslog, Syslog, Syslogng Service</title>
524
525 <para>Rsyslog is the default logging program on several Linux
526 distributions. Apart from implementing the syslog protocol, rsyslog adds
527 additional features such as content-based filtering and also uses TCP
528 for transporting, providing many configuration options. Further reading
529 is available at <ulink
530 url="https://linux-audit.com/central-audit-logging-configuration-collecting-linux-audit-events/">https://linux-audit.com/central-audit-logging-configuration-collecting-linux-audit-events/</ulink>.</para>
531 </section>
532
533 <section id="unnecessary_packages">
534 <title>Removing unnecessary Packages</title>
535
536 <para>Enea provides a minimum set of packages in release images. All
537 extra packages should be available in the Enea source repository so
538 users can get when needed.</para>
539
540 <remark>Ask Sona/Casc for details on what should be definitively written
541 in this section</remark>
542 </section>
543
544 <section id="disk-iso-prot">
545 <title>Disk Isolation and Protection</title>
546
547 <para>Critical systems should be separated into different partitions. An
548 example to start from would be:</para>
549
550 <para><programlisting>/
551/boot
552/usr
553/home
554/tmp
555/var</programlisting></para>
556
557 <para>Create a separate volume with the <command>nodev</command>,
558 <command>nosuid</command>, and <command>noexec</command> options set for
559 <command>/tmp</command>. <command>/tmp</command> is intended to be
560 globally writable, creating a separate partition for it can prevent
561 resource exhaustion.</para>
562
563 <para>Setting <command>nodev</command> prevents users from creating or
564 using block or special character devices. Setting
565 <command>noexec</command> prevents users from running binary executables
566 from /tmp. Setting <command>nosuid</command> prevents users from
567 creating set userid files in /tmp.</para>
568 </section>
569
570 <section id="unwanted_suid_sgid">
571 <title>Disable unwanted SUID and SGID Binaries</title>
572
573 <para>There are 3 special permissions available for executable files and
574 directories:</para>
575
576 <itemizedlist>
577 <listitem>
578 <para>SUID permission</para>
579 </listitem>
580
581 <listitem>
582 <para>SGID permission</para>
583 </listitem>
584
585 <listitem>
586 <para>Sticky bit</para>
587 </listitem>
588 </itemizedlist>
589
590 <section id="suid_sgid">
591 <title>SUID/SGID</title>
592
593 <para>To better understand, check the permissions of the
594 <command>/usr/bin/passwd</command> command: <programlisting># ls -lrt /usr/bin/passwd
595-r-sr-sr-x 1 root sys 31396 Jan 20 2014 /usr/bin/passwd</programlisting>There
596 are 2 S&rsquo;s in the permission field, the first &rdquor;s&rdquo;
597 stands for the SUID and the second for SGID. When a command or script
598 set with SUID bit is run, its effective UID becomes that of the owner
599 of the file, rather than of the user who is running it.</para>
600
601 <para>If there are files with all SUID/SGID bits enabled, said files
602 can be misused if the SUID/SGID executable has a security problem or
603 bug. All local or remote users can access/use the file, which may
604 prove dangerous. It's a good idea to find all such files and this can
605 be done using the <command>find</command> command:</para>
606
607 <para><programlisting>#See all set user id files:
608 find / -perm +4000
609
610# See all group id files
611 find / -perm +2000
612
613# Or combine both in a single command
614 find / \( -perm -4000 -o -perm -2000 \) -print
615 find / -path -prune -o -type f -perm +6000 -ls</programlisting>You
616 need to investigate each reported file. See reported file(s) man page
617 for further details.</para>
618 </section>
619
620 <section id="sticky_bit">
621 <title>Sticky Bit</title>
622
623 <para>The Sticky Bit is primarily used on shared directories. It's
624 useful for shared directories such as <command>/var/tmp</command> and
625 <command>/tmp</command> because users can create files, read and
626 execute files owned by other users, but are not allowed to remove
627 files owned by other users.</para>
628
629 <para>For example, if user Bob creates a file named /tmp/bob, user Tom
630 cannot delete this file even when the /tmp directory has permission
631 777. If Sticky Bit is not set, then Tom can delete /tmp/bob, since the
632 file inherits the parent directory permissions. The root users and
633 file owners can remove their own files.</para>
634
635 <para>Example:<programlisting># ls -ld /var/tmp
636drwxrwxrwt 2 sys sys 512 Jan 26 11:02 /var/tmp</programlisting>T refers
637 to when the execute permissions are off and t refers to when they are
638 on.</para>
639 </section>
640 </section>
641
642 <section id="secure_boot_dir">
643 <title>Secure boot directory</title>
644
645 <para>The boot directory contains important files related to the Linux
646 kernel, make sure that this directory is locked down with read-only
647 permissions. You can set the owner and group of
648 <filename>/etc/grub.conf</filename> to the root user like so:</para>
649
650 <programlisting>#chown root:root /etc/fstab
651#chown root:root /etc/grub.conf
652
653EX: ls -ld /boot/* &lt;&lt;&lt;&lt; root only
654
655lrwxrwxrwx 1 root root 32 Aug 7 13:07 /boot/bzImage -&gt; /
656bzImage-4.9.30-intel-pk-standard
657-rw-r--r-- 1 root root 7860816 Jun 8 10:55 /boot/bzImage-4.9.20-yocto-standard
658-rw-r--r-- 1 root root 4624464 Aug 7 12:48 /boot/bzImage-4.9.30-intel-pk-standard</programlisting>
659 </section>
660 </section>
661
662 <section id="netsecure_remoteacc">
663 <title>Network Security &amp; Remote Access</title>
664
665 <para>The networking stack includes IPsec, which provides confidentiality,
666 authenticity, and integrity protection of IP networking. It can be used to
667 implement VPNs, and also point to point security.</para>
668
669 <section id="encrypt_datacoms">
670 <title>Encrypt Data Communication</title>
671
672 <para>All data transmitted over a network is open to monitoring. Encrypt
673 transmitted data whenever possible with passwords or by using
674 keys/certificates.</para>
675
676 <para>Below are several methods and tools that facilitate
677 encryption:</para>
678
679 <orderedlist>
680 <listitem>
681 <para>Use <command>scp</command>, <command>ssh</command>,
682 <command>rsync</command>, or <command>sftp</command> for file
683 transfers. You can also mount a remote server file system or your
684 own home directory using special <command>sshfs</command> and fuse
685 tools.</para>
686 </listitem>
687
688 <listitem>
689 <para>GnuPG allows you to encrypt and sign your data and
690 communication, features a versatile key management system as well as
691 access modules for all kind of public key directories.</para>
692 </listitem>
693
694 <listitem>
695 <para>OpenVPN is a cost-effective, lightweight SSL VPN.</para>
696
697 <para>Another option to try out is <command>tinc</command>, which
698 uses tunneling and encryption to create a secure private network
699 between hosts, on the Internet or on a private insecure LAN.</para>
700 </listitem>
701
702 <listitem>
703 <para>Lighttpd SSL (Secure Server Layer) HTTPS Configuration and
704 Installation.</para>
705 </listitem>
706
707 <listitem>
708 <para>Apache SSL (Secure Server Layer) HTTPS (mod_ssl) Configuration
709 and Installation.</para>
710 </listitem>
711
712 <listitem>
713 <para>Configure Nginx with free Let&rsquo;s Encrypt SSL certificate
714 on Debian or Ubuntu Linux.</para>
715 </listitem>
716 </orderedlist>
717 </section>
718
719 <section id="ssh_service">
720 <title>SSH service</title>
721
722 <para>SSH is secure by default but its services need to be hardened as
723 well. Open <command>/etc/ssh/sshd_config</command> and change the
724 default configuration:</para>
725
726 <itemizedlist>
727 <listitem>
728 <para>Change the default port number 22 to something else, e.g.
729 99.<programlisting>root@inteld1521:~# xxxxx</programlisting></para>
730 </listitem>
731
732 <listitem>
733 <para>Disable ssh login for root<programlisting>ssh root@172.24.12.73
734root@inteld1521:~#</programlisting></para>
735 </listitem>
736
737 <listitem>
738 <para>Make sure following configuration is set for the SSH
739 server:</para>
740
741 <itemizedlist>
742 <listitem>
743 <para>Protocol version is set to 2</para>
744 </listitem>
745
746 <listitem>
747 <para>LogLevel is set to INFO</para>
748 </listitem>
749
750 <listitem>
751 <para>PermitEmptyPasswords</para>
752 </listitem>
753
754 <listitem>
755 <para>IgnoreRhosts to yes</para>
756 </listitem>
757
758 <listitem>
759 <para>HostbasedAuthentication no</para>
760 </listitem>
761
762 <listitem>
763 <para>PermitEmptyPasswords no</para>
764 </listitem>
765
766 <listitem>
767 <para>X11Forwarding no</para>
768 </listitem>
769
770 <listitem>
771 <para>MaxAuthTries 5</para>
772 </listitem>
773
774 <listitem>
775 <para>Ciphers aes128-ctr,aes192-ctr,aes256-ctr</para>
776 </listitem>
777
778 <listitem>
779 <para>ClientAliveInterval 900</para>
780 </listitem>
781
782 <listitem>
783 <para>ClientAliveCountMax 0</para>
784 </listitem>
785
786 <listitem>
787 <para>UsePAM yes</para>
788 </listitem>
789 </itemizedlist>
790
791 <para>These settings use the default set on most platforms, setting
792 them to other values impacts the security of the SSH server.</para>
793 </listitem>
794 </itemizedlist>
795
796 <para>The SSH connection to a server can be controlled by using the
797 following files: <filename>/etc/hosts.allow</filename> and
798 <filename>/<filename>etc/hosts.deny</filename></filename>. Set the
799 permissions on the <filename>sshd_config</filename> file so that only
800 root users can change its contents like so: <programlisting>#chown root:root /etc/ssh/sshd_config
801#chmod 600 /etc/ssh/sshd_config</programlisting></para>
802 </section>
803
804 <section id="check_open_ports">
805 <title>Check for open ports</title>
806
807 <para>Identifying open connections to the internet is a critical
808 mission. In Kali Linux, the following command can be used to spot any
809 hidden open ports:</para>
810
811 <programlisting>root@172:~# netstat -ral -tuwx -en
812
813Kernel IP routing table
814Destination Gateway Genmask Flags Metric Ref Use Iface
8150.0.0.0 172.24.15.254 0.0.0.0 UG 0 0 0 eth1
816172.24.12.0 0.0.0.0 255.255.252.0 U 0 0 0 eth1</programlisting>
817 </section>
818
819 <section id="no_legacyservices">
820 <title>Legacy services and Unencrypted Authentication</title>
821
822 <para>Disable legacy services that rely on unencrypted authentication
823 such as: <emphasis role="bold">telnet&shy;server, rsh, rlogin, rcp,
824 ypserv, ypbind, tftp, tftp&shy;server, talk</emphasis> and <emphasis
825 role="bold">talk&shy;server.</emphasis></para>
826
827 <para>Use instead<emphasis role="bold"> <ulink
828 url="https://www.cyberciti.biz/tips/linux-unix-bsd-openssh-server-best-practices.html">OpenSSH</ulink>
829 , </emphasis><ulink
830 url="https://www.cyberciti.biz/tips/configure-vsfptd-secure-connections-via-ssl-tls.html"><emphasis
831 role="bold">SFTP</emphasis> or <emphasis
832 role="bold">FTPS</emphasis></ulink> (<emphasis
833 role="bold">FTP</emphasis> over <emphasis role="bold">SSL</emphasis>),
834 which adds SSL or TLS encryption to FTP.</para>
835 </section>
836
837 <section>
838 <title>Disable unnecessary Services</title>
839
840 <para>Disabling unused services will reduce the attack surface. Examples
841 of such services include: <emphasis role="bold">FTP, DNS, LDAP, SMB,
842 DHCP, NFS, SNMP</emphasis>, etc.</para>
843 </section>
844
845 <section>
846 <title>Firewall</title>
847
848 <para>Firewalls are an important tool and act as a barrier between a
849 trusted and an untrusted network. <emphasis
850 role="bold">Iptables</emphasis> is a firewall (user space application)
851 which allows users to configure the <emphasis
852 role="bold">Netfilter</emphasis> provided by the Linux kernel. Netfilter
853 hooks packets which pass into, through and from the system. Kernel-level
854 modules may hook into this framework to examine packets and make
855 security decisions about them.</para>
856
857 <para><emphasis role="bold">Iptables</emphasis> contains five
858 tables:</para>
859
860 <itemizedlist>
861 <listitem>
862 <para><emphasis role="bold">Raw</emphasis> is used only for
863 configuring packets to be exempt from connection tracking.</para>
864 </listitem>
865
866 <listitem>
867 <para><emphasis role="bold">Filter</emphasis> is the default table,
868 where all the actions typically associated with a firewall take
869 place.</para>
870 </listitem>
871
872 <listitem>
873 <para><emphasis role="bold">NAT</emphasis> is used for network
874 address translation (e.g. port forwarding).</para>
875 </listitem>
876
877 <listitem>
878 <para><emphasis role="bold">Mangle</emphasis> is used for
879 specialized packet alterations.</para>
880 </listitem>
881
882 <listitem>
883 <para><emphasis role="bold">Security</emphasis> is used for
884 Mandatory Access Control networking rules (e.g. SELinux).</para>
885 </listitem>
886 </itemizedlist>
887
888 <para>Filter and NAT are the most common use cases. The other tables are
889 aimed at complex configurations involving multiple routers and routing
890 decisions, and are beyond the scope of these introductory
891 remarks.</para>
892
893 <para>Here are some important features to consider for securing a host
894 network (these kernel parameters are set in
895 <filename>/etc/sysctl.conf</filename>):</para>
896
897 <para><emphasis role="bold">Disable</emphasis>:</para>
898
899 <itemizedlist>
900 <listitem>
901 <para>IP forwarding</para>
902 </listitem>
903
904 <listitem>
905 <para>send packet redirects</para>
906 </listitem>
907
908 <listitem>
909 <para>source routed packet acceptance</para>
910 </listitem>
911
912 <listitem>
913 <para>ICMP redirect acceptance</para>
914 </listitem>
915 </itemizedlist>
916
917 <para><emphasis role="bold">Enable</emphasis>:</para>
918
919 <itemizedlist>
920 <listitem>
921 <para>Ignore Broadcast Requests</para>
922 </listitem>
923
924 <listitem>
925 <para>Bad Error Message Protection</para>
926 </listitem>
927
928 <listitem>
929 <para>TCP/SYN cookies</para>
930 </listitem>
931 </itemizedlist>
932
933 <para>iptables is a systemd service. However, the service won't start
934 unless it finds a <filename>/etc/iptables/iptables.rules</filename>
935 file. To start the service for the first time edit:</para>
936
937 <para><programlisting># vi /etc/iptables/iptables.rules</programlisting>or<programlisting># cp /etc/iptables/empty.rules /etc/iptables/iptables.rules &lt;&lt;&lt; no empty.rules
938root@inteld1521:~# ls /usr/sbin/iptables
939iptables iptables-restore iptables-save</programlisting></para>
940
941 <para>Then start the <literal>iptables.service</literal> unit. As with
942 other services, if you want iptables to be loaded automatically on boot,
943 you must enable it.</para>
944
945 <para>Iptables rules for IPv6 are, by default, stored in
946 <filename>/etc/iptables/ip6tables.rules</filename>, which is read by
947 <literal>ip6tables.service</literal>. You can start it the same way as
948 shown above. After adding rules via command-line as shown below, save
949 the configuration file manually: <programlisting># iptables-save &gt; /etc/iptables/iptables.rules</programlisting></para>
950 </section>
951 </section>
952</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml
deleted file mode 100644
index 67931a7..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/introduction.xml
+++ /dev/null
@@ -1,120 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="overview">
5 <title>Overview</title>
6
7 <para>This document describes the activities needed for securing Enea NFV
8 Access by ESRT/ developers in order to fulfill the security requirements
9 specified in <ulink
10 url="https://eneaissues.enea.com/browse/CPDX-2632">CPDX-2632</ulink> (see
11 the Security section under Pre-Study). For further information about the
12 hardening features available, please read <ulink
13 url="https://eneadoc.enea.com/idc/idcplg?IdcService=GET_FILE&amp;dDocName=055550&amp;Rendition=Primary&amp;RevisionSelectionMethod=Latest"><trademark
14 class="registered">Enea</trademark> NFV Access User's Hardening
15 Guide</ulink>.</para>
16
17 <section id="rev_hist">
18 <title>Revision History</title>
19
20 <table>
21 <tgroup cols="4">
22 <colspec align="center" />
23
24 <thead>
25 <row>
26 <entry align="center">Revision</entry>
27
28 <entry align="center">Author</entry>
29
30 <entry align="center">Date</entry>
31
32 <entry align="center">Purpose for Revision</entry>
33 </row>
34 </thead>
35
36 <tbody>
37 <row>
38 <entry>4</entry>
39
40 <entry>Sona Sarmadi</entry>
41
42 <entry>2017-09-07</entry>
43
44 <entry>Added Appendix, sec 4.</entry>
45 </row>
46
47 <row>
48 <entry>3</entry>
49
50 <entry>Sona Sarmadi</entry>
51
52 <entry>2017-09-05</entry>
53
54 <entry>Added introduction to the tools in the Open Embedded
55 meta-security layer Fixed 1.1 Revision History.</entry>
56 </row>
57
58 <row>
59 <entry>2</entry>
60
61 <entry>Sona Sarmadi</entry>
62
63 <entry>2017-08-30</entry>
64
65 <entry>Made this document as a guideline for Enea NFV Access
66 developers. Moved section 2 and 3 to a new document (a guideline
67 only for users).</entry>
68 </row>
69
70 <row>
71 <entry>1</entry>
72
73 <entry>Sona Sarmadi</entry>
74
75 <entry>2017-08-20</entry>
76
77 <entry>Initial Revision</entry>
78 </row>
79 </tbody>
80 </tgroup>
81 </table>
82 </section>
83
84 <section id="references">
85 <title>References</title>
86
87 <itemizedlist>
88 <listitem>
89 <para><ulink
90 url="https://www.sans.org/reading-room/whitepapers/linux/linux-kernel-hardening-1294">SANS
91 linux-kernel-hardening-1294</ulink></para>
92 </listitem>
93
94 <listitem>
95 <para><ulink
96 url="https://lwn.net/Articles/705262/">lwn.net/Articles/705262/</ulink></para>
97 </listitem>
98
99 <listitem>
100 <para><ulink
101 url="https://eneadoc.enea.com/idc/idcplg?IdcService=GET_FILE&amp;dDocName=055550&amp;Rendition=Primary&amp;RevisionSelectionMethod=Latest">Hardening
102 Guide for Users of Enea NFV Access</ulink><remark>Not sure if this
103 should remain an ulink to eneadoc or be changed to an olink to the
104 guide in question.</remark></para>
105 </listitem>
106 </itemizedlist>
107 </section>
108
109 <section id="def_acro">
110 <title>Definitions and Acronyms</title>
111
112 <para>Definitions:</para>
113
114 <para>[FIXME]</para>
115
116 <para>Acronyms:</para>
117
118 <para>[FIXME]</para>
119 </section>
120</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/doc/metasecure_tools.xml b/doc/book-enea-nfv-access-dev-hardening-guide/doc/metasecure_tools.xml
deleted file mode 100644
index 63c1225..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/doc/metasecure_tools.xml
+++ /dev/null
@@ -1,465 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="metasecure_tools">
3 <title>Introduction to Meta-Security Layer Tools</title>
4
5 <section id="summary">
6 <title>Summary of tools supported in the Meta-Security layer</title>
7
8 <informaltable>
9 <tgroup cols="2">
10 <tbody>
11 <row>
12 <entry>Afflib</entry>
13
14 <entry>On-disk format for storing computer forensic
15 information</entry>
16 </row>
17
18 <row>
19 <entry>Aircrack-ng</entry>
20
21 <entry>A set of tools for auditing wireless networks</entry>
22 </row>
23
24 <row>
25 <entry>AppArmor</entry>
26
27 <entry>A MAC control system</entry>
28 </row>
29
30 <row>
31 <entry>Bastille</entry>
32
33 <entry>Linux hardening tool</entry>
34 </row>
35
36 <row>
37 <entry>Buck-security</entry>
38
39 <entry>Linux security scanner</entry>
40 </row>
41
42 <row>
43 <entry>TOMOYO</entry>
44
45 <entry>A Mandatory Access Control (MAC) implementation for
46 Linux</entry>
47 </row>
48
49 <row>
50 <entry>checksec</entry>
51
52 <entry>Program randominization</entry>
53 </row>
54
55 <row>
56 <entry>checksecurity</entry>
57
58 <entry>Basic system security checks</entry>
59 </row>
60
61 <row>
62 <entry>ClamAV</entry>
63
64 <entry>Anti-virus utility for command-line interface</entry>
65 </row>
66
67 <row>
68 <entry>ecryptfs-utils</entry>
69
70 <entry>The eCryptfs mount helper and support libraries</entry>
71 </row>
72
73 <row>
74 <entry>freediameter</entry>
75
76 <entry>Platform for deploying a Diameter network for
77 Authentication, Authorization and Accounting.</entry>
78 </row>
79
80 <row>
81 <entry>ISIC</entry>
82
83 <entry>IP Stack Integrity Checker</entry>
84 </row>
85
86 <row>
87 <entry>keynote</entry>
88
89 <entry>Linux Key Management Utilities</entry>
90 </row>
91
92 <row>
93 <entry>keyutils</entry>
94
95 <entry>Linux Key Management Utilities</entry>
96 </row>
97
98 <row>
99 <entry>libdhash</entry>
100
101 <entry>Library of hashing algorithms</entry>
102 </row>
103
104 <row>
105 <entry>libgssglue</entry>
106
107 <entry>Exports a gssapi interface which calls other gssapi
108 libraries</entry>
109 </row>
110
111 <row>
112 <entry>libmhash</entry>
113
114 <entry>Library of hashing algorithms</entry>
115 </row>
116
117 <row>
118 <entry>Libmspack</entry>
119
120 <entry>A library for Microsoft compression formats</entry>
121 </row>
122
123 <row>
124 <entry>Libseccomp</entry>
125
126 <entry>The libseccomp library provides an easy to use, platform
127 independent, interface to the Linux Kernel's syscall filtering
128 mechanism: seccomp.</entry>
129 </row>
130
131 <row>
132 <entry>Nikto</entry>
133
134 <entry>Web server scanner</entry>
135 </row>
136
137 <row>
138 <entry>Nmap</entry>
139
140 <entry>Network auditing tool</entry>
141 </row>
142
143 <row>
144 <entry>Paxctl</entry>
145
146 <entry>A tool that allows PaX flags to be modified on a per-binary
147 basis</entry>
148 </row>
149
150 <row>
151 <entry>redhat-security</entry>
152
153 <entry>redhat security tools</entry>
154 </row>
155
156 <row>
157 <entry>samhain</entry>
158
159 <entry>Samhain is an integrity checker and host intrusion
160 detection system that can be used on single hosts as well as large
161 ones.</entry>
162 </row>
163
164 <row>
165 <entry>Scapy</entry>
166
167 <entry>Network scanning and manipulation tool</entry>
168 </row>
169
170 <row>
171 <entry>Smack</entry>
172
173 <entry>A simplified Mandatory Access Control</entry>
174 </row>
175
176 <row>
177 <entry>sssd</entry>
178
179 <entry>Selection of tools for developers working with
180 Smack</entry>
181 </row>
182
183 <row>
184 <entry>Suricata</entry>
185
186 <entry>The Suricata Engine is an Open Source Next Generation
187 Intrusion Detection and Prevention Engine</entry>
188 </row>
189
190 <row>
191 <entry>Tripwire</entry>
192
193 <entry>A system integrity assessment tool (IDS)</entry>
194 </row>
195
196 <row>
197 <entry>xmlsec1</entry>
198
199 <entry>XML Security Library is a C library based on
200 LibXML2</entry>
201 </row>
202 </tbody>
203 </tgroup>
204 </informaltable>
205 </section>
206
207 <section id="run_tools">
208 <title>How to configure, build and run the tools</title>
209
210 <para>In order to use this layer, you need to make the build system aware
211 of it. To do so, first clone the layer located at the address:
212 http://git.enea.com/cgit/linux/meta-security.git, then add the following
213 lines to the files below.</para>
214
215 <itemizedlist>
216 <listitem>
217 <para>In <literal>bblayers.conf</literal>:</para>
218
219 <para><programlisting>BBLAYERS ?= " \
220/path/to/oe-core/meta \
221/path/to/meta-openembedded/meta-oe \
222/path/to/meta-openembedded/meta-perl \
223/path/to/meta-openembedded/meta-gnome \
224/path/to/meta-openembedded/meta-xfce \
225/path/to/meta-openembedded/meta-python \
226/path/to/meta-openembedded/meta-networking \
227/path/to/layer/meta-security \</programlisting></para>
228 </listitem>
229
230 <listitem>
231 <para>In <literal>local.conf</literal>:</para>
232
233 <para><programlisting>IMAGE_INSTALL_append = "aircrack-ng buck-security checksecurity freediameter /
234keynote libgssglue libseccomp samhain-client samhain-server samhain-standalone /
235sssd xmlsec1 clamav keyutils libmhash nikto paxctl scapy suricata bastille /
236checksec ecryptfs-utils isic libmspack nmap redhat-security smack tripwire"</programlisting></para>
237 </listitem>
238
239 <listitem>
240 <para><programlisting>poky/build $ bitbake enea-hardend-image-virtualization-host</programlisting></para>
241
242 <remark>Need clarification here on a possible intro or specified
243 action/file as noted above.</remark>
244 </listitem>
245 </itemizedlist>
246
247 <section id="apparmor">
248 <title>AppArmor</title>
249
250 <para>AppArmor, like most other LSMs, supplements rather than replaces
251 the default Discretionary Access Control (DAC). As such, it's impossible
252 to grant a process more privileges than it had in the first place. When
253 AppArmor is active for an application, the operating system allows the
254 application to access only those files and folders that are mentioned in
255 its security profile. Thus, with a well-planned security profile, even
256 if the application is compromised during an attack, it won't be able to
257 do much harm.</para>
258
259 <para>Before compiling the kernel, set the following
260 options:<programlisting>CONFIG_SECURITY_APPARMOR=y
261CONFIG_SECURITY_APPARMOR_BOOTPARAM_VALUE=1
262CONFIG_DEFAULT_SECURITY_APPARMOR=y
263CONFIG_AUDIT=y</programlisting>Alternatively, instead of setting
264 <literal>CONFIG_SECURITY_APPARMOR_BOOTPARAM_VALUE</literal> and
265 <literal>CONFIG_DEFAULT_SECURITY_APPARMOR</literal>, you can set the
266 <ulink
267 url="https://wiki.archlinux.org/index.php/Kernel_parameters">kernel boot
268 parameters</ulink> in this manner: <literal>apparmor=1
269 security=apparmor</literal>. For those new or altered variables to not
270 get overridden, place them at the bottom of the config file or adjust
271 the previous invocations accordingly.</para>
272
273 <para>For further information see <ulink
274 url="https://www.digitalocean.com/community/tutorials/how-to-create-an-apparmor-profile-for-nginx-on-ubuntu-14-04">https://www.digitalocean.com/community/tutorials/how-to-create-an-apparmor-profile-for-nginx-on-ubuntu-14-04</ulink>.</para>
275
276 <para>To put the profile in enforce mode, use the
277 <literal>aa-enforce</literal>:</para>
278
279 <para><programlisting>sudo apparmor_status
280sudo aa-enforce nginx</programlisting>It is recommended that you reload all
281 profiles and restart Nginx to be sure that the latest changes are in
282 effect: <programlisting>sudo /etc/init.d/apparmor reload
283sudo service nginx restart</programlisting>Enable complain mode with the
284 <literal>aa-complain</literal> command. It is recommended that you wait
285 several days before running the <literal>aa-logprof</literal> command,
286 to give the system time to log more common actions for the application
287 if you are going to create a profile that will be used in production
288 systems.</para>
289 </section>
290
291 <section id="isic">
292 <title>ISIC - IP Stack Integrity Checker</title>
293
294 <para><emphasis role="bold">ISIC</emphasis> is a suite of utilities
295 meant to exercise the stability of an IP Stack and its component stacks
296 (TCP, UDP, ICMP et. al.). It generates many pseudo-random packets of the
297 target protocol, which are given tendancies to conform to. For example:
298 50% of the packets generated can have IP Options, and 25% of the packets
299 can be IP fragments, the percentages are arbitrary however, and most of
300 the packet fields have a configurable tendancy. <programlisting>root@qemux86:~# esic -i eth0 -s 52:54:00:12:34:0A -p rand -m 5000</programlisting><remark>what
301 does this programlisting detail exactly, is it an example or something
302 more directly concrete?</remark></para>
303 </section>
304
305 <section id="nikto">
306 <title>Nikto Web Vulnerability Scanner</title>
307
308 <para>Nikto is a web vulnerability scanner, a security testing tool that
309 scans web servers for vulnerabilities and other known issues.</para>
310 </section>
311
312 <section id="nmap">
313 <title>Nmap Network Exploration Tool</title>
314
315 <para>Nmap (Network Mapper), is an open source security scanner for
316 network exploration and security auditing. It is used to discover hosts
317 and services on a network, essentially creating a "map" of the network.
318 Nmap sends specially crafted packets to the target host(s), then
319 analyzes the responses.</para>
320
321 <para>Nmap uses raw IP packets in novel ways to determine what hosts are
322 available on the network, what services (application name and version)
323 those hosts are offering, what operating systems (and OS versions) they
324 are running, what type of packet filters/firewalls are in use, and
325 dozens of other characteristics. While Nmap is commonly used for
326 security audits, many systems and network administrators find it useful
327 for routine tasks such as network inventory, managing service upgrade
328 schedules, and monitoring host or service uptime. See a few examples of
329 options to use below:</para>
330
331 <para><programlisting>nmap -v -A scanme.nmap.org
332nmap -v -sn 192.168.0.0/16 10.0.0.0/8
333nmap -v -iR 10000 -Pn -p 80</programlisting>For more info see <ulink
334 url="https://layers.openembedded.org/layerindex/branch/master/layer/meta-security/">https://layers.openembedded.org/layerindex/branch/master/layer/meta-security/</ulink>.</para>
335 </section>
336
337 <section id="paxctl">
338 <title>Paxctl</title>
339
340 <para>A tool that allows PaX flags to be modified on a per-binary basis.
341 PaX provides various types of protection against abuses of memory, some
342 of which can only be enabled or disabled by (re)configuring the kernel
343 and recompiling/rebooting it.</para>
344
345 <para>Several important types (PAGEEXEC, EMUTRAMP, MPROTECT, RANDMMAP
346 and SEGMEXEC) can be tweaked when the system is up and running by
347 marking the PaX flags on the ELF objects of the program you want to run.
348 Since some programs need to use memory in a way normally forbidden by
349 PaX, some restrictions may have to be relaxed on a per program basis.
350 For more informations see: <ulink
351 url="https://wiki.gentoo.org/wiki/Hardened/PaX_flag_migration_from_PT_PAX_to_XATTR_PAX">https://wiki.gentoo.org/wiki/Hardened/PaX_flag_migration_from_PT_PAX_to_XATTR_PAX</ulink>.</para>
352
353 <para>Example:<programlisting>root #paxctl-ng -v /bin/*</programlisting></para>
354 </section>
355
356 <section id="samhin">
357 <title>Samhin</title>
358
359 <para><emphasis>Samhain</emphasis> is a host-based intrusion detection
360 system (HIDS) which provides integrity checking and log file
361 monitoring/analysis, as well as 4.1detection, port monitoring, detection
362 of rogue SUID executables, and hidden processes. It's main features
363 include:</para>
364
365 <itemizedlist>
366 <listitem>
367 <para>Complete integrity check</para>
368
369 <para>Uses cryptographic checksums of files to detect modifications.
370 It can find rogue SUID executables anywhere on disk.</para>
371 </listitem>
372
373 <listitem>
374 <para>Centralized monitoring</para>
375
376 <para>Native support for logging to a central server via encrypted
377 and authenticated connections.</para>
378 </listitem>
379
380 <listitem>
381 <para>Tamper resistance</para>
382
383 <para>Database and configuration files can be signed log file
384 entries. E-mail reports are signed support for stealth
385 operations.</para>
386 </listitem>
387 </itemizedlist>
388 </section>
389
390 <section id="smack">
391 <title>Smack</title>
392
393 <para>A simplified Mandatory Access Control.</para>
394 </section>
395
396 <section id="suricata">
397 <title>Suricata</title>
398
399 <para>The Suricata Engine is an Open Source Next Generation <emphasis
400 role="bold">Intrusion Detection and Prevention Engine.</emphasis></para>
401 </section>
402
403 <section id="tomoyo">
404 <title>TOMOYO</title>
405
406 <para><ulink
407 url="http://tomoyo.sourceforge.jp/1.8/index.html.en">TOMOYO</ulink> is
408 an alternative (pathname-based) Mandatory Access Control (MAC)
409 implementation for Linux that can be used to increase the security of a
410 system, while also being useful purely as a system analysis tool. The
411 main features of TOMOYO Linux include:</para>
412
413 <itemizedlist>
414 <listitem>
415 <para>System analysis</para>
416 </listitem>
417
418 <listitem>
419 <para>Increased security through Mandatory Access Control</para>
420 </listitem>
421
422 <listitem>
423 <para>Tools to aid in policy generation</para>
424 </listitem>
425
426 <listitem>
427 <para>Simple syntax</para>
428 </listitem>
429
430 <listitem>
431 <para>Easy to use</para>
432 </listitem>
433
434 <listitem>
435 <para>Very few dependencies</para>
436 </listitem>
437
438 <listitem>
439 <para>Requires no modification of existing binaries</para>
440 </listitem>
441 </itemizedlist>
442
443 <para>To start via command line add:<programlisting>"security=tomoyo TOMOYO_trigger=/usr/lib/systemd/systemd"</programlisting>To
444 initialize:<programlisting>/usr/lib/ccs/init_policy
445DISTRO_FEATURES_append = " tomoyo"</programlisting></para>
446 </section>
447
448 <section id="tripwire">
449 <title>Tripwire</title>
450
451 <para>Tripwire is an intrusion detection system (IDS), which constantly
452 and automatically, keeps your critical system files and reports under
453 control if they have been destroyed or modified by a hacker (or by
454 mistake). It allows the system administrator to know immediately what
455 was compromised and fix it. For more information see: <ulink
456 url="http://www.linuxjournal.com/article/8758">http://www.linuxjournal.com/article/8758</ulink>.</para>
457 </section>
458
459 <section id="xmlsec1">
460 <title>xmlsec1</title>
461
462 <para>XML Security Library is a C library based on LibXML2.</para>
463 </section>
464 </section>
465</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-dev-hardening-guide/swcomp.mk b/doc/book-enea-nfv-access-dev-hardening-guide/swcomp.mk
deleted file mode 100644
index 6f0889c..0000000
--- a/doc/book-enea-nfv-access-dev-hardening-guide/swcomp.mk
+++ /dev/null
@@ -1,10 +0,0 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-access-dev-hardening-guide
9BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access $(PROD_VER) Developer's Hardening Guide"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-nfv-access-esdk-open-source/doc/README b/doc/book-enea-nfv-access-esdk-open-source/doc/README
deleted file mode 100644
index 1077acb..0000000
--- a/doc/book-enea-nfv-access-esdk-open-source/doc/README
+++ /dev/null
@@ -1,4 +0,0 @@
1The licenses.xml in the git repository of Enea NFV Access Open Source Report
2is the frozen version belonging to the last official release of Enea NFV Access.
3The contents must be generated from the release script to obtain the latest
4lists of packages and licenses.
diff --git a/doc/book-enea-nfv-access-esdk-open-source/doc/about.xml b/doc/book-enea-nfv-access-esdk-open-source/doc/about.xml
deleted file mode 100644
index 0ca3155..0000000
--- a/doc/book-enea-nfv-access-esdk-open-source/doc/about.xml
+++ /dev/null
@@ -1,12 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="enea-linux-open-source-packages-and-licenses">
5 <title>About this Report</title>
6
7 <para>This document contains the open source and license information
8 pertaining to packages provided with Enea NFV Access <xi:include
9 href="../../book-enea-nfv-access-release-info/doc/eltf_params_updated.xml"
10 xmlns:xi="http://www.w3.org/2001/XInclude"
11 xpointer="element(EneaLinux_REL_VER/1)" />.</para>
12</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-esdk-open-source/doc/book.xml b/doc/book-enea-nfv-access-esdk-open-source/doc/book.xml
deleted file mode 100644
index 49c7e40..0000000
--- a/doc/book-enea-nfv-access-esdk-open-source/doc/book.xml
+++ /dev/null
@@ -1,15 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
5]>
6<book id="book_enea_nfv_access_open_source">
7 <title><trademark class="registered">Enea</trademark> NFV Access Open Source Report</title>
8 <subtitle>Release Version
9 <xi:include href="../../book-enea-nfv-access-release-info/doc/eltf_params_updated.xml" xpointer="element(EneaLinux_REL_VER/1)"
10 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle>
11 <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb -->
12 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
13 <xi:include href="about.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
14 <xi:include href="licenses.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
15</book>
diff --git a/doc/book-enea-nfv-access-esdk-open-source/doc/licenses.xml b/doc/book-enea-nfv-access-esdk-open-source/doc/licenses.xml
deleted file mode 100755
index 8ff32d0..0000000
--- a/doc/book-enea-nfv-access-esdk-open-source/doc/licenses.xml
+++ /dev/null
@@ -1,8573 +0,0 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="enea_linux_packages">
5 <title>Packages and Licenses</title>
6 <section id="licenses_packages">
7
8 <title>Packages</title>
9
10
11 <!--This chapter contains a generated list of all packages that Enea Linux
12supports, e.g. busybox, with a short explanatory blurb and links to package
13specific documentation.-->
14
15 <informaltable>
16 <tgroup cols="4">
17 <colspec colwidth="2*"/>
18 <colspec colwidth="1*"/>
19 <colspec colwidth="5*"/>
20 <colspec colwidth="2*"/>
21
22
23 <thead>
24 <row>
25 <entry align="center">Package Name</entry>
26 <entry align="center">Version</entry>
27 <entry align="center">Description</entry>
28 <entry align="center">License</entry>
29
30 </row>
31 </thead>
32
33 <tbody valign="top">
34<row>
35 <entry>4g-sierra</entry>
36 <entry>1.0</entry>
37 <entry>Scripts to setup 4G modems from Sierra</entry>
38 <entry>Enea</entry>
39</row>
40<row>
41 <entry>acl</entry>
42 <entry>2.2.52</entry>
43 <entry>Utilities for managing POSIX Access Control Lists.</entry>
44 <entry> LGPL-2.1, GPL-2.0</entry>
45</row>
46<row>
47 <entry>alsa-lib</entry>
48 <entry>1.1.4.1</entry>
49 <entry>ALSA sound library.</entry>
50 <entry> LGPL-2.1, GPL-2.0</entry>
51</row>
52<row>
53 <entry>ant</entry>
54 <entry>1.8.1</entry>
55 <entry>Another Neat Tool - build system for Java</entry>
56 <entry>Apache-2.0</entry>
57</row>
58<row>
59 <entry>antlr</entry>
60 <entry>2.7.7</entry>
61 <entry>Framework for constructing recognizers interpreters compilers and translators</entry>
62 <entry>PD</entry>
63</row>
64<row>
65 <entry>apache2</entry>
66 <entry>2.4.27</entry>
67 <entry>The Apache HTTP Server is a powerful efficient and extensible web server.</entry>
68 <entry>Apache-2.0</entry>
69</row>
70<row>
71 <entry>apr-util</entry>
72 <entry>1.6.0</entry>
73 <entry>Apache Portable Runtime (APR) companion library.</entry>
74 <entry>Apache-2.0</entry>
75</row>
76<row>
77 <entry>apr</entry>
78 <entry>1.6.2</entry>
79 <entry>Apache Portable Runtime (APR) library.</entry>
80 <entry>Apache-2.0</entry>
81</row>
82<row>
83 <entry>apt</entry>
84 <entry>1.2.24</entry>
85 <entry>Advanced front-end for dpkg.</entry>
86 <entry>GPL-2.0</entry>
87</row>
88<row>
89 <entry>attr</entry>
90 <entry>2.4.47</entry>
91 <entry>Utilities for manipulating filesystem extended attributes.</entry>
92 <entry> LGPL-2.1, GPL-2.0</entry>
93</row>
94<row>
95 <entry>aufs-util</entry>
96 <entry>4.4</entry>
97 <entry>Tools for managing AUFS mounts.</entry>
98 <entry>GPL-2.0</entry>
99</row>
100<row>
101 <entry>augeas</entry>
102 <entry>1.5.0</entry>
103 <entry>Augeas configuration API.</entry>
104 <entry>LGPL-2.1</entry>
105</row>
106<row>
107 <entry>autoconf-archive</entry>
108 <entry>2016.09.16</entry>
109 <entry>a collection of freely re-usable Autoconf macros.</entry>
110 <entry>GPL-3.0-with-autoconf-exception</entry>
111</row>
112<row>
113 <entry>autoconf</entry>
114 <entry>2.69</entry>
115 <entry>Autoconf is an extensible package of M4 macros that produce shell scripts to automatically configure software source code packages. Autoconf creates a configuration script for a package from a template file that lists the operating system features that the package can use in the form of M4 macro calls.</entry>
116 <entry> GPL-2.0, GPL-3.0</entry>
117</row>
118<row>
119 <entry>automake</entry>
120 <entry>1.15.1</entry>
121 <entry>Automake is a tool for automatically generating `Makefile.in' files compliant with the GNU Coding Standards. Automake requires the use of Autoconf.</entry>
122 <entry>GPL-2.0</entry>
123</row>
124<row>
125 <entry>avahi</entry>
126 <entry>0.6.32</entry>
127 <entry>"Avahi is a fully LGPL framework for Multicast DNS Service Discovery. It allows programs to publish and discover services and hosts running on a local network with no specific configuration. This tool implements IPv4LL ""Dynamic Configuration of IPv4 Link-Local Addresses"" (IETF RFC3927) a protocol for automatic IP address configuration from the link-local 169.254.0.0/16 range without the need for a central server."</entry>
128 <entry> GPL-2.0, LGPL-2.1</entry>
129</row>
130<row>
131 <entry>avalon-framework-api</entry>
132 <entry>4.3</entry>
133 <entry>Common way for components to be created initialized configured started. (API-only)</entry>
134 <entry>Apache-2.0</entry>
135</row>
136<row>
137 <entry>base-files</entry>
138 <entry>3.0.14</entry>
139 <entry>The base-files package creates the basic system directory structure and provides a small set of key configuration files for the system.</entry>
140 <entry>GPL-2.0</entry>
141</row>
142<row>
143 <entry>base-passwd</entry>
144 <entry>3.5.29</entry>
145 <entry>The master copies of the user database files (/etc/passwd and /etc/group). The update-passwd tool is also provided to keep the system databases synchronized with these master files.</entry>
146 <entry>GPL-2.0</entry>
147</row>
148<row>
149 <entry>bash-completion</entry>
150 <entry>2.7</entry>
151 <entry>Programmable Completion for Bash 4.</entry>
152 <entry>GPL-2.0</entry>
153</row>
154<row>
155 <entry>bash</entry>
156 <entry>4.4</entry>
157 <entry>An sh-compatible command language interpreter.</entry>
158 <entry>GPL-3.0</entry>
159</row>
160<row>
161 <entry>bc</entry>
162 <entry>1.06</entry>
163 <entry>Arbitrary precision calculator language.</entry>
164 <entry> GPL-2.0, LGPL-2.1</entry>
165</row>
166<row>
167 <entry>bcel</entry>
168 <entry>5.2</entry>
169 <entry>Java Bytecode manipulation library</entry>
170 <entry>Apache-2.0</entry>
171</row>
172<row>
173 <entry>bind</entry>
174 <entry>9.10.5-P3</entry>
175 <entry>ISC Internet Domain Name Server.</entry>
176 <entry> ISC, BSD</entry>
177</row>
178<row>
179 <entry>binutils-cross-x86_64</entry>
180 <entry>2.29.1</entry>
181 <entry>The GNU Binutils are a collection of binary tools. The main ones are ld (GNU Linker) and as (GNU Assembler). This package also includes addition tools such as addr2line (Converts addresses into filenames and line numbers) ar (utility for creating modifying and extracting archives) nm (list symbols in object files) objcopy (copy and translate object files) objdump (Display object information) and other tools and related libraries.</entry>
182 <entry>GPL-3.0</entry>
183</row>
184<row>
185 <entry>binutils</entry>
186 <entry>2.29.1</entry>
187 <entry>The GNU Binutils are a collection of binary tools. The main ones are ld (GNU Linker) and as (GNU Assembler). This package also includes addition tools such as addr2line (Converts addresses into filenames and line numbers) ar (utility for creating modifying and extracting archives) nm (list symbols in object files) objcopy (copy and translate object files) objdump (Display object information) and other tools and related libraries.</entry>
188 <entry>GPL-3.0</entry>
189</row>
190<row>
191 <entry>bison</entry>
192 <entry>3.0.4</entry>
193 <entry>Bison is a general-purpose parser generator that converts an annotated context-free grammar into an LALR(1) or GLR parser for that grammar. Bison is upward compatible with Yacc: all properly-written Yacc grammars ought to work with Bison with no change. Anyone familiar with Yacc should be able to use Bison with little trouble.</entry>
194 <entry>GPL-3.0</entry>
195</row>
196<row>
197 <entry>bjam</entry>
198 <entry>1.64.0</entry>
199 <entry>Portable Boost.Jam build tool for boost.</entry>
200 <entry> BSL-1.0, MIT, Python-2.0</entry>
201</row>
202<row>
203 <entry>bmap-tools</entry>
204 <entry>3.4</entry>
205 <entry>"Bmap-tools - tools to generate block map (AKA bmap) and flash images using bmap. Bmaptool is a generic tool for creating the block map (bmap) for a file and copying files using the block map. The idea is that large file containing unused blocks like raw system image files can be copied or flashed a lot faster with bmaptool than with traditional tools like ""dd"" or ""cp""."</entry>
206 <entry>GPL-2.0</entry>
207</row>
208<row>
209 <entry>boost</entry>
210 <entry>1.64.0</entry>
211 <entry>Free peer-reviewed portable C++ source libraries.</entry>
212 <entry> BSL-1.0, MIT, Python-2.0</entry>
213</row>
214<row>
215 <entry>bridge-utils</entry>
216 <entry>1.5</entry>
217 <entry>Tools for ethernet bridging.</entry>
218 <entry>GPL-2.0</entry>
219</row>
220<row>
221 <entry>bsf</entry>
222 <entry>2.4.0</entry>
223 <entry>Bean Scripting Framework package</entry>
224 <entry>Apache-2.0</entry>
225</row>
226<row>
227 <entry>btrfs-tools</entry>
228 <entry>4.12</entry>
229 <entry>Btrfs is a new copy on write filesystem for Linux aimed at implementing advanced features while focusing on fault tolerance repair and easy administration. This package contains utilities (mkfs fsck btrfsctl) used to work with btrfs and an utility (btrfs-convert) to make a btrfs filesystem from an ext3.</entry>
230 <entry>GPL-2.0</entry>
231</row>
232<row>
233 <entry>busybox</entry>
234 <entry>1.24.1</entry>
235 <entry>BusyBox combines tiny versions of many common UNIX utilities into a single small executable. It provides minimalist replacements for most of the utilities you usually find in GNU fileutils shellutils etc. The utilities in BusyBox generally have fewer options than their full-featured GNU cousins; however the options that are included provide the expected functionality and behave very much like their GNU counterparts. BusyBox provides a fairly complete POSIX environment for any small or embedded system.</entry>
236 <entry> GPL-2.0, BSD-4-Clause</entry>
237</row>
238<row>
239 <entry>bzip2</entry>
240 <entry>1.0.6</entry>
241 <entry>bzip2 compresses files using the Burrows-Wheeler block-sorting text compression algorithm and Huffman coding. Compression is generally considerably better than that achieved by more conventional LZ77/LZ78-based compressors and approaches the performance of the PPM family of statistical compressors.</entry>
242 <entry>BSD-4-Clause</entry>
243</row>
244<row>
245 <entry>ca-certificates</entry>
246 <entry>20170717</entry>
247 <entry>This package includes PEM files of CA certificates to allow SSL-based applications to check for the authenticity of SSL connections. This derived from Debian's CA Certificates.</entry>
248 <entry> GPL-2.0, MPL-2.0</entry>
249</row>
250<row>
251 <entry>cacao-initial</entry>
252 <entry>0.98</entry>
253 <entry>CacaoVM for use as OpenEmbedded's Java VM</entry>
254 <entry>GPL-2.0</entry>
255</row>
256<row>
257 <entry>cdrkit</entry>
258 <entry>1.1.11</entry>
259 <entry>CD/DVD command line tools.</entry>
260 <entry>GPL-2.0</entry>
261</row>
262<row>
263 <entry>cdrtools</entry>
264 <entry>3.01a31</entry>
265 <entry>A set of tools for CD recording including cdrecord.</entry>
266 <entry> GPL-2.0, CDDL-1.0, LGPL-2.1</entry>
267</row>
268<row>
269 <entry>classpath-initial</entry>
270 <entry>0.93</entry>
271 <entry>Java1.4-compatible GNU Classpath variant that is used as bootclasspath for jikes-native.</entry>
272 <entry> GPL-2.0, SAX-PD</entry>
273</row>
274<row>
275 <entry>classpath</entry>
276 <entry>0.99</entry>
277 <entry>GNU Classpath standard Java libraries - For native Java-dependent programs</entry>
278 <entry> GPL-2.0, SAX-PD</entry>
279</row>
280<row>
281 <entry>cloud-init</entry>
282 <entry>0.7.6</entry>
283 <entry>Init scripts for use on cloud images</entry>
284 <entry>GPL-3.0</entry>
285</row>
286<row>
287 <entry>cmake</entry>
288 <entry>3.8.2</entry>
289 <entry>Cross-platform open-source make system.</entry>
290 <entry>BSD</entry>
291</row>
292<row>
293 <entry>commons-logging</entry>
294 <entry>1.1.1</entry>
295 <entry>Java Internet protocol suite library</entry>
296 <entry>Apache-2.0</entry>
297</row>
298<row>
299 <entry>commons-net</entry>
300 <entry>1.4.1</entry>
301 <entry>Java Internet protocol suite library</entry>
302 <entry>Apache-2.0</entry>
303</row>
304<row>
305 <entry>compose-file</entry>
306 <entry>3.0</entry>
307 <entry>Parser for the Compose file format (version 3)</entry>
308 <entry>Apache-2.0</entry>
309</row>
310<row>
311 <entry>containerd-docker</entry>
312 <entry>v0.2.x</entry>
313 <entry>containerd is a daemon to control runC built for performance and density. containerd leverages runC's advanced features such as seccomp and user namespace support as well as checkpoint and restore for cloning and live migration of containers.</entry>
314 <entry>Apache-2.0</entry>
315</row>
316<row>
317 <entry>core-image-minimal-initramfs</entry>
318 <entry>1.0</entry>
319 <entry>Small image capable of booting a device. The kernel includes the Minimal RAM-based Initial Root Filesystem (initramfs) which finds the first 'init' program more efficiently.</entry>
320 <entry>MIT</entry>
321</row>
322<row>
323 <entry>coreutils</entry>
324 <entry>8.27</entry>
325 <entry>The GNU Core Utilities provide the basic file shell and text manipulation utilities. These are the core utilities which are expected to exist on every system.</entry>
326 <entry>GPL-3.0</entry>
327</row>
328<row>
329 <entry>cross-localedef</entry>
330 <entry>2.26</entry>
331 <entry>Cross locale generation tool for glibc.</entry>
332 <entry>LGPL-2.1</entry>
333</row>
334<row>
335 <entry>cryptodev-linux</entry>
336 <entry>1.9</entry>
337 <entry>A /dev/crypto device driver header file.</entry>
338 <entry>GPL-2.0</entry>
339</row>
340<row>
341 <entry>cup</entry>
342 <entry>0.10k</entry>
343 <entry>Lexical analyzer generator for Java</entry>
344 <entry>CUP</entry>
345</row>
346<row>
347 <entry>curl</entry>
348 <entry>7.58.0</entry>
349 <entry>Command line tool and library for client-side URL transfers.</entry>
350 <entry>MIT</entry>
351</row>
352<row>
353 <entry>cwautomacros</entry>
354 <entry>20110201</entry>
355 <entry>Collection of autoconf m4 macros.</entry>
356 <entry>GPL-2.0</entry>
357</row>
358<row>
359 <entry>db</entry>
360 <entry>5.3.28</entry>
361 <entry>Berkeley Database v5.</entry>
362 <entry>Sleepycat</entry>
363</row>
364<row>
365 <entry>dbus-glib</entry>
366 <entry>0.108</entry>
367 <entry>GLib bindings for the D-Bus message bus that integrate the D-Bus library with the GLib thread abstraction and main loop.</entry>
368 <entry> AFL-2.0, GPL-2.0</entry>
369</row>
370<row>
371 <entry>dbus-test</entry>
372 <entry>1.10.20</entry>
373 <entry>D-Bus test package (for D-bus functionality testing only).</entry>
374 <entry> AFL-2.0, GPL-2.0</entry>
375</row>
376<row>
377 <entry>dbus</entry>
378 <entry>1.10.20</entry>
379 <entry>"D-Bus is a message bus system a simple way for applications to talk to one another. In addition to interprocess communication D-Bus helps coordinate process lifecycle; it makes it simple and reliable to code a \""single instance\"" application or daemon and to launch applications and daemons on demand when their services are needed."</entry>
380 <entry> AFL-2.0, GPL-2.0</entry>
381</row>
382<row>
383 <entry>debianutils</entry>
384 <entry>4.8.1.1</entry>
385 <entry>Miscellaneous utilities specific to Debian.</entry>
386 <entry> GPL-2.0, SMAIL_GPL</entry>
387</row>
388<row>
389 <entry>depmodwrapper</entry>
390 <entry>1.0</entry>
391 <entry>Wrapper script for the Linux kernel module dependency indexer.</entry>
392 <entry>MIT</entry>
393</row>
394<row>
395 <entry>dhcp</entry>
396 <entry>4.3.6</entry>
397 <entry>DHCP (Dynamic Host Configuration Protocol) is a protocol which allows individual devices on an IP network to get their own network configuration information from a server. DHCP helps make it easier to administer devices.</entry>
398 <entry>ISC</entry>
399</row>
400<row>
401 <entry>diffutils</entry>
402 <entry>3.6</entry>
403 <entry>Diffutils contains the GNU diff diff3 sdiff and cmp utilities. These programs are usually used for creating patch files.</entry>
404 <entry>GPL-3.0</entry>
405</row>
406<row>
407 <entry>dmidecode</entry>
408 <entry>3.1</entry>
409 <entry>DMI (Desktop Management Interface) table related utilities.</entry>
410 <entry>GPL-2.0</entry>
411</row>
412<row>
413 <entry>dnsmasq</entry>
414 <entry>2.78</entry>
415 <entry>Lightweight easy to configure DNS forwarder and DHCP server.</entry>
416 <entry> GPL-2.0, GPL-3.0</entry>
417</row>
418<row>
419 <entry>docker</entry>
420 <entry>17.06.0</entry>
421 <entry>Linux container runtime Docker complements kernel namespacing with a high-level API which operates at the process level. It runs unix processes with strong guarantees of isolation and repeatability across servers. . Docker is a great building block for automating distributed systems: large-scale web deployments database clusters continuous deployment systems private PaaS service-oriented architectures etc. . This package contains the daemon and client. Using docker.io is officially supported on x86_64 and arm (32-bit) hosts. Other architectures are considered experimental. . Also note that kernel version 3.10 or above is required for proper operation of the daemon process and that any lower versions may have subtle and/or glaring issues. </entry>
422 <entry>Apache-2.0</entry>
423</row>
424<row>
425 <entry>dosfstools</entry>
426 <entry>4.1</entry>
427 <entry>DOS FAT Filesystem Utilities.</entry>
428 <entry>GPL-3.0</entry>
429</row>
430<row>
431 <entry>dpdk-dev-libibverbs</entry>
432 <entry>1.2.1-3.4-2.0.0.0</entry>
433 <entry>libibverbs library to support Mellanox config</entry>
434 <entry>GPL-2.0</entry>
435</row>
436<row>
437 <entry>dpdk</entry>
438 <entry>18.02</entry>
439 <entry>Intel(r) Data Plane Development Kit</entry>
440 <entry> BSD, LGPL-2.0, GPL-2.0</entry>
441</row>
442<row>
443 <entry>dpkg</entry>
444 <entry>1.18.24</entry>
445 <entry>Package maintenance system from Debian.</entry>
446 <entry>GPL-2.0</entry>
447</row>
448<row>
449 <entry>dtc</entry>
450 <entry>1.4.4</entry>
451 <entry>The Device Tree Compiler is a tool used to manipulate the Open-Firmware-like device tree used by PowerPC kernels.</entry>
452 <entry> GPL-2.0, BSD</entry>
453</row>
454<row>
455 <entry>e2fsprogs</entry>
456 <entry>1.43.5</entry>
457 <entry>The Ext2 Filesystem Utilities (e2fsprogs) contain all of the standard utilities for creating fixing configuring and debugging ext2 filesystems.</entry>
458 <entry> GPL-2.0, LGPL-2.0, BSD, MIT</entry>
459</row>
460<row>
461 <entry>ebtables</entry>
462 <entry>2.0.10-4</entry>
463 <entry>Utility for basic Ethernet frame filtering on a Linux bridge advanced logging MAC DNAT/SNAT and brouting.</entry>
464 <entry>GPL-2.0</entry>
465</row>
466<row>
467 <entry>ecj-bootstrap</entry>
468 <entry>1.0</entry>
469 <entry>JDT Core Batch Compiler - Bootstrap variant</entry>
470 <entry>MIT</entry>
471</row>
472<row>
473 <entry>ecj-initial</entry>
474 <entry>1.0</entry>
475 <entry>JDT Core Batch Compiler - Bootstrap variant</entry>
476 <entry>MIT</entry>
477</row>
478<row>
479 <entry>efibootmgr</entry>
480 <entry>0.15</entry>
481 <entry>Linux user-space application to modify the EFI Boot Manager.</entry>
482 <entry>GPL-2.0</entry>
483</row>
484<row>
485 <entry>efitools</entry>
486 <entry>1.7.0</entry>
487 <entry>From the EFI Tools package in the Linux user-space it's now possible to read and manipulate the UEFI signatures database via the new efi-readvar and efi-updatevar commands. Aside from needing efitools 1.4 the EFIVARFS file-system is also needed which was only introduced in the Linux 3.8 kernel. </entry>
488 <entry>GPL-2.0</entry>
489</row>
490<row>
491 <entry>efivar</entry>
492 <entry>0.31</entry>
493 <entry>efivar provides a simple command line interface to the UEFI variable facility</entry>
494 <entry>LGPL-2.1</entry>
495</row>
496<row>
497 <entry>element-vcpe</entry>
498 <entry>4.1.0</entry>
499 <entry>vCPE(based on Element-ODM)</entry>
500 <entry> Enea, Windbase, BSD</entry>
501</row>
502<row>
503 <entry>elfutils</entry>
504 <entry>0.170</entry>
505 <entry>Utilities and libraries for handling compiled object files.</entry>
506 <entry> GPL-3.0, Elfutils-Exception</entry>
507</row>
508<row>
509 <entry>enea-nfv-access-vnf</entry>
510 <entry>1.0</entry>
511 <entry>VNF image of the Enea NFV Access Platform includes kernel rootfs and boot parameters</entry>
512 <entry>MIT</entry>
513</row>
514<row>
515 <entry>enea-nfv-access</entry>
516 <entry>1.0</entry>
517 <entry>Image for the host side of the Enea NFV Access Platform with ODM and NETCONF Edgelink customizations</entry>
518 <entry>MIT</entry>
519</row>
520<row>
521 <entry>ethtool</entry>
522 <entry>4.11</entry>
523 <entry>A small utility for examining and tuning the settings of your ethernet-based network interfaces.</entry>
524 <entry>GPL-2.0</entry>
525</row>
526<row>
527 <entry>expat</entry>
528 <entry>2.2.3</entry>
529 <entry>Expat is an XML parser library written in C. It is a stream-oriented parser in which an application registers handlers for things the parser might find in the XML document (like start tags)</entry>
530 <entry>MIT</entry>
531</row>
532<row>
533 <entry>fastjar</entry>
534 <entry>0.98</entry>
535 <entry>jar replacement written in C.</entry>
536 <entry>GPL-2.0</entry>
537</row>
538<row>
539 <entry>file</entry>
540 <entry>5.31</entry>
541 <entry>File attempts to classify files depending on their contents and prints a description if a match is found.</entry>
542 <entry>BSD</entry>
543</row>
544<row>
545 <entry>findutils</entry>
546 <entry>4.6.0</entry>
547 <entry>The GNU Find Utilities are the basic directory searching utilities of the GNU operating system. These programs are typically used in conjunction with other programs to provide modular and powerful directory search and file locating capabilities to other commands.</entry>
548 <entry>GPL-3.0</entry>
549</row>
550<row>
551 <entry>flex</entry>
552 <entry>2.6.0</entry>
553 <entry>Flex is a fast lexical analyser generator. Flex is a tool for generating programs that recognize lexical patterns in text.</entry>
554 <entry>BSD</entry>
555</row>
556<row>
557 <entry>fontconfig</entry>
558 <entry>2.12.4</entry>
559 <entry>Fontconfig is a font configuration and customization library which does not depend on the X Window System. It is designed to locate fonts within the system and select them according to requirements specified by applications. Fontconfig is not a rasterization library nor does it impose a particular rasterization library on the application. The X-specific library 'Xft' uses fontconfig along with freetype to specify and rasterize fonts.</entry>
560 <entry> MIT, PD</entry>
561</row>
562<row>
563 <entry>freetype</entry>
564 <entry>2.8</entry>
565 <entry>FreeType is a software font engine that is designed to be small efficient highly customizable and portable while capable of producing high-quality output (glyph images). It can be used in graphics libraries display servers font conversion tools text image generation tools and many other products as well.</entry>
566 <entry> FreeType, GPL-2.0</entry>
567</row>
568<row>
569 <entry>fuse</entry>
570 <entry>2.9.7</entry>
571 <entry>FUSE (Filesystem in Userspace) is a simple interface for userspace programs to export a virtual filesystem to the Linux kernel. FUSE also aims to provide a secure method for non privileged users to create and mount their own filesystem implementations. </entry>
572 <entry> GPL-2.0, LGPL-2.0</entry>
573</row>
574<row>
575 <entry>gawk</entry>
576 <entry>4.1.4</entry>
577 <entry>The GNU version of awk a text processing utility. Awk interprets a special-purpose programming language to do quick and easy text pattern matching and reformatting jobs.</entry>
578 <entry>GPL-3.0</entry>
579</row>
580<row>
581 <entry>gcc-cross-initial-x86_64</entry>
582 <entry>7.3.0</entry>
583 <entry>GNU cc and gcc C compilers.</entry>
584 <entry> GPL-3.0-with-GCC-exception, GPL-3.0</entry>
585</row>
586<row>
587 <entry>gcc-cross-x86_64</entry>
588 <entry>7.3.0</entry>
589 <entry>GNU cc and gcc C compilers.</entry>
590 <entry> GPL-3.0-with-GCC-exception, GPL-3.0</entry>
591</row>
592<row>
593 <entry>gcc-source-7.3.0</entry>
594 <entry>7.3.0</entry>
595 <entry>GNU cc and gcc C compilers.</entry>
596 <entry> GPL-3.0-with-GCC-exception, GPL-3.0</entry>
597</row>
598<row>
599 <entry>gcc</entry>
600 <entry>7.3.0</entry>
601 <entry>Runtime libraries from GCC.</entry>
602 <entry>GPL-3.0-with-GCC-exception</entry>
603</row>
604<row>
605 <entry>gdbm</entry>
606 <entry>1.13</entry>
607 <entry>Key/value database library with extensible hashing.</entry>
608 <entry>GPL-3.0</entry>
609</row>
610<row>
611 <entry>gettext-minimal</entry>
612 <entry>0.19.8.1</entry>
613 <entry>Contains the m4 macros sufficient to support building autoconf/automake. This provides a significant build time speedup by the removal of gettext-native from most dependency chains (now only needed for gettext for the target).</entry>
614 <entry>FSF-Unlimited</entry>
615</row>
616<row>
617 <entry>gettext</entry>
618 <entry>0.19.8.1</entry>
619 <entry>GNU gettext is a set of tools that provides a framework to help other programs produce multi-lingual messages. These tools include a set of conventions about how programs should be written to support message catalogs a directory and file naming organization for the message catalogs themselves a runtime library supporting the retrieval of translated messages and a few stand-alone programs to massage in various ways the sets of translatable and already translated strings.</entry>
620 <entry> GPL-3.0, LGPL-2.1</entry>
621</row>
622<row>
623 <entry>giflib</entry>
624 <entry>5.1.4</entry>
625 <entry>shared library for GIF images.</entry>
626 <entry>MIT</entry>
627</row>
628<row>
629 <entry>git</entry>
630 <entry>2.13.3</entry>
631 <entry>Distributed version control system.</entry>
632 <entry>GPL-2.0</entry>
633</row>
634<row>
635 <entry>glib-2.0</entry>
636 <entry>2.52.3</entry>
637 <entry>GLib is a general-purpose utility library which provides many useful data types macros type conversions string utilities file utilities a main loop abstraction and so on.</entry>
638 <entry> LGPL-2.0, BSD, PD</entry>
639</row>
640<row>
641 <entry>glibc-locale</entry>
642 <entry>2.26</entry>
643 <entry>Locale data from glibc.</entry>
644 <entry> GPL-2.0, LGPL-2.1</entry>
645</row>
646<row>
647 <entry>glibc</entry>
648 <entry>2.26</entry>
649 <entry>The GNU C Library is used as the system C library in most systems with the Linux kernel.</entry>
650 <entry> GPL-2.0, LGPL-2.1</entry>
651</row>
652<row>
653 <entry>gmp</entry>
654 <entry>6.1.2</entry>
655 <entry>GMP is a free library for arbitrary precision arithmetic operating on signed integers rational numbers and floating point numbers</entry>
656 <entry> GPL-2.0, LGPL-3.0</entry>
657</row>
658<row>
659 <entry>gnome-desktop-testing</entry>
660 <entry>2014.1</entry>
661 <entry>Test runner for GNOME-style installed tests.</entry>
662 <entry>LGPL-2.0</entry>
663</row>
664<row>
665 <entry>gnu-config</entry>
666 <entry>20150728</entry>
667 <entry>Tool that installs the GNU config.guess / config.sub into a directory tree</entry>
668 <entry>GPL-3.0-with-autoconf-exception</entry>
669</row>
670<row>
671 <entry>gnu-efi</entry>
672 <entry>3.0.6</entry>
673 <entry>Libraries for producing EFI binaries.</entry>
674 <entry> GPL-2.0, BSD-2-Clause</entry>
675</row>
676<row>
677 <entry>gnujaf</entry>
678 <entry>1.1.1</entry>
679 <entry>Provides a mean to type data and locate components suitable for performing various kinds of action on it.</entry>
680 <entry>GPL-2.0-with-GCC-exception</entry>
681</row>
682<row>
683 <entry>gnulib</entry>
684 <entry>2017-08-20.18</entry>
685 <entry>A collection of software subroutines which are designed to be usable on many operating systems. The goal of the project is to make it easy for free software authors to make their software run on many operating systems. Since source is designed to be copied from gnulib it is not a library per-se as much as a collection of portable idioms to be used in other projects.</entry>
686 <entry>LGPL-2.0</entry>
687</row>
688<row>
689 <entry>gnumail</entry>
690 <entry>1.1.2</entry>
691 <entry>GNU's free implementation of the JavaMail API specification</entry>
692 <entry>GPL-2.0-with-GCC-exception</entry>
693</row>
694<row>
695 <entry>gnutls</entry>
696 <entry>3.5.13</entry>
697 <entry>GNU Transport Layer Security Library.</entry>
698 <entry> GPL-3.0, LGPL-2.1</entry>
699</row>
700<row>
701 <entry>go-capability</entry>
702 <entry>0.0</entry>
703 <entry>Utilities for manipulating POSIX capabilities in Go.</entry>
704 <entry>BSD-2-Clause</entry>
705</row>
706<row>
707 <entry>go-cli</entry>
708 <entry>1.1.0</entry>
709 <entry>A small package for building command line apps in Go</entry>
710 <entry>MIT</entry>
711</row>
712<row>
713 <entry>go-connections</entry>
714 <entry>0.2.1</entry>
715 <entry>Utility package to work with network connections</entry>
716 <entry>Apache-2.0</entry>
717</row>
718<row>
719 <entry>go-context</entry>
720 <entry>git</entry>
721 <entry>A golang registry for global request variables.</entry>
722 <entry>BSD-3-Clause</entry>
723</row>
724<row>
725 <entry>go-cross-x86_64</entry>
726 <entry>1.9.4</entry>
727 <entry> The Go programming language is an open source project to make programmers more productive. Go is expressive concise clean and efficient. Its concurrency mechanisms make it easy to write programs that get the most out of multicore and networked machines while its novel type system enables flexible and modular program construction. Go compiles quickly to machine code yet has the convenience of garbage collection and the power of run-time reflection. It's a fast statically typed compiled language that feels like a dynamically typed interpreted language.</entry>
728 <entry>BSD-3-Clause</entry>
729</row>
730<row>
731 <entry>go-dbus</entry>
732 <entry>4.0.0</entry>
733 <entry>Native Go bindings for D-Bus</entry>
734 <entry>BSD-2-Clause</entry>
735</row>
736<row>
737 <entry>go-distribution</entry>
738 <entry>2.6.0</entry>
739 <entry>The Docker toolset to pack ship store and deliver content</entry>
740 <entry>Apache-2.0</entry>
741</row>
742<row>
743 <entry>go-fsnotify</entry>
744 <entry>1.2.11</entry>
745 <entry>A golang registry for global request variables.</entry>
746 <entry>BSD-3-Clause</entry>
747</row>
748<row>
749 <entry>go-libtrust</entry>
750 <entry>0.0</entry>
751 <entry>Primitives for identity and authorization</entry>
752 <entry>Apache-2.0</entry>
753</row>
754<row>
755 <entry>go-logrus</entry>
756 <entry>0.11.0</entry>
757 <entry>A golang registry for global request variables.</entry>
758 <entry>MIT</entry>
759</row>
760<row>
761 <entry>go-mux</entry>
762 <entry>git</entry>
763 <entry>A powerful URL router and dispatcher for golang.</entry>
764 <entry>BSD-3-Clause</entry>
765</row>
766<row>
767 <entry>go-patricia</entry>
768 <entry>2.2.6</entry>
769 <entry>A generic patricia trie (also called radix tree) implemented in Go (Golang)</entry>
770 <entry>MIT</entry>
771</row>
772<row>
773 <entry>go-pty</entry>
774 <entry>git</entry>
775 <entry>PTY interface for Go</entry>
776 <entry>MIT</entry>
777</row>
778<row>
779 <entry>go-systemd</entry>
780 <entry>4</entry>
781 <entry>Go bindings to systemd socket activation journal D-Bus and unit files</entry>
782 <entry>Apache-2.0</entry>
783</row>
784<row>
785 <entry>go</entry>
786 <entry>1.9.4</entry>
787 <entry> The Go programming language is an open source project to make programmers more productive. Go is expressive concise clean and efficient. Its concurrency mechanisms make it easy to write programs that get the most out of multicore and networked machines while its novel type system enables flexible and modular program construction. Go compiles quickly to machine code yet has the convenience of garbage collection and the power of run-time reflection. It's a fast statically typed compiled language that feels like a dynamically typed interpreted language.</entry>
788 <entry>BSD-3-Clause</entry>
789</row>
790<row>
791 <entry>gobject-introspection</entry>
792 <entry>1.52.1</entry>
793 <entry>Middleware layer between GObject-using C libraries and language bindings.</entry>
794 <entry> LGPL-2.0, GPL-2.0</entry>
795</row>
796<row>
797 <entry>gperf</entry>
798 <entry>3.1</entry>
799 <entry>GNU gperf is a perfect hash function generator</entry>
800 <entry>GPL-3.0</entry>
801</row>
802<row>
803 <entry>gpgme</entry>
804 <entry>1.9.0</entry>
805 <entry>GnuPG Made Easy (GPGME) is a library designed to make access to GnuPG easier for applications. It provides a High-Level Crypto API for encryption decryption signing signature verification and key management</entry>
806 <entry> GPL-2.0, LGPL-2.1</entry>
807</row>
808<row>
809 <entry>gptfdisk</entry>
810 <entry>1.0.3</entry>
811 <entry>GPT fdisk is a disk partitioning tool loosely modeled on Linux fdisk but used for modifying GUID Partition Table (GPT) disks. The related FixParts utility fixes some common problems on Master Boot Record (MBR) disks.</entry>
812 <entry>GPL-2.0</entry>
813</row>
814<row>
815 <entry>grep</entry>
816 <entry>3.1</entry>
817 <entry>GNU grep utility.</entry>
818 <entry>GPL-3.0</entry>
819</row>
820<row>
821 <entry>groff</entry>
822 <entry>1.22.3</entry>
823 <entry>The groff (GNU troff) software is a typesetting package which reads plain text mixed with formatting commands and produces formatted output.</entry>
824 <entry>GPL-3.0</entry>
825</row>
826<row>
827 <entry>grpc-go</entry>
828 <entry>1.4.0</entry>
829 <entry>The Go language implementation of gRPC. HTTP/2 based RPC</entry>
830 <entry>BSD</entry>
831</row>
832<row>
833 <entry>grub-disable-fallback</entry>
834 <entry>1.0</entry>
835 <entry>Enea service to disable grub fallback when boot is successful</entry>
836 <entry>Enea</entry>
837</row>
838<row>
839 <entry>grub-efi</entry>
840 <entry>2.02</entry>
841 <entry>GRUB2 is the next generaion of a GPLed bootloader intended to unify bootloading across x86 operating systems. In addition to loading the Linux kernel it implements the Multiboot standard which allows for flexible loading of multiple boot images.</entry>
842 <entry>GPL-3.0</entry>
843</row>
844<row>
845 <entry>grub</entry>
846 <entry>2.02</entry>
847 <entry>GRUB2 is the next generaion of a GPLed bootloader intended to unify bootloading across x86 operating systems. In addition to loading the Linux kernel it implements the Multiboot standard which allows for flexible loading of multiple boot images.</entry>
848 <entry>GPL-3.0</entry>
849</row>
850<row>
851 <entry>gtk-doc</entry>
852 <entry>1.25</entry>
853 <entry>Gtk-doc is a set of scripts that extract specially formatted comments from glib-based software and produce a set of html documentation files from them</entry>
854 <entry>GPL-2.0</entry>
855</row>
856<row>
857 <entry>gzip</entry>
858 <entry>1.8</entry>
859 <entry>GNU Gzip is a popular data compression program originally written by Jean-loup Gailly for the GNU project. Mark Adler wrote the decompression part</entry>
860 <entry>GPL-3.0</entry>
861</row>
862<row>
863 <entry>help2man</entry>
864 <entry>1.47.4</entry>
865 <entry>Program for creating simple man pages.</entry>
866 <entry>GPL-3.0</entry>
867</row>
868<row>
869 <entry>htop</entry>
870 <entry>1.0.3</entry>
871 <entry>htop process monitor.</entry>
872 <entry>GPL-2.0</entry>
873</row>
874<row>
875 <entry>hugepage-reservation</entry>
876 <entry>1.0</entry>
877 <entry>Reserve hugepages on system startup.</entry>
878 <entry>Enea</entry>
879</row>
880<row>
881 <entry>icedtea7</entry>
882 <entry>2.1.3</entry>
883 <entry>Harness to build the source code from OpenJDK using Free Software build tools</entry>
884 <entry>GPL-2.0-with-classpath-exception</entry>
885</row>
886<row>
887 <entry>icu</entry>
888 <entry>59.1</entry>
889 <entry>The International Component for Unicode (ICU) is a mature portable set of C/C++ and Java libraries for Unicode support software internationalization (I18N) and globalization (G11N) giving applications the same results on all platforms.</entry>
890 <entry>ICU</entry>
891</row>
892<row>
893 <entry>inetlib</entry>
894 <entry>1.1.1</entry>
895 <entry>GNU Classpath inetlib is an extension library to provide extra network protocol support for GNU Classpath and ClasspathX project but it can also used standalone to add http imap pop3 and smtp client support applications. </entry>
896 <entry>GPL-2.0-with-GCC-exception</entry>
897</row>
898<row>
899 <entry>initramfs-framework</entry>
900 <entry>1.0</entry>
901 <entry>Modular initramfs system.</entry>
902 <entry>MIT</entry>
903</row>
904<row>
905 <entry>initramfs-module-install-efi</entry>
906 <entry>1.0</entry>
907 <entry>initramfs-framework module for EFI installation option.</entry>
908 <entry>MIT</entry>
909</row>
910<row>
911 <entry>initramfs-module-install</entry>
912 <entry>1.0</entry>
913 <entry>initramfs-framework module for installation option.</entry>
914 <entry>MIT</entry>
915</row>
916<row>
917 <entry>initramfs-module-setup-live</entry>
918 <entry>1.0</entry>
919 <entry>initramfs-framework module for live booting.</entry>
920 <entry>MIT</entry>
921</row>
922<row>
923 <entry>initramfs-ostree-image</entry>
924 <entry>1.0</entry>
925 <entry>OSTree initramfs image</entry>
926 <entry>MIT</entry>
927</row>
928<row>
929 <entry>inputproto</entry>
930 <entry>2.3.2</entry>
931 <entry>This package provides the wire protocol for the X Input extension. The extension supports input devices other then the core X keyboard and pointer.</entry>
932 <entry> MIT</entry>
933</row>
934<row>
935 <entry>intltool</entry>
936 <entry>0.51.0</entry>
937 <entry>Utility scripts for internationalizing XML.</entry>
938 <entry>GPL-2.0</entry>
939</row>
940<row>
941 <entry>iperf3</entry>
942 <entry>3.2</entry>
943 <entry>iperf is a tool for active measurements of the maximum achievable bandwidth on IP networks. It supports tuning of various parameters related to timing protocols and buffers. For each test it reports the bandwidth loss and other parameters.</entry>
944 <entry>BSD</entry>
945</row>
946<row>
947 <entry>iproute2</entry>
948 <entry>4.11.0</entry>
949 <entry>Iproute2 is a collection of utilities for controlling TCP / IP networking and traffic control in Linux. Of the utilities ip and tc are the most important. ip controls IPv4 and IPv6 configuration and tc stands for traffic control.</entry>
950 <entry>GPL-2.0</entry>
951</row>
952<row>
953 <entry>iptables</entry>
954 <entry>1.6.1</entry>
955 <entry>iptables is the userspace command line program used to configure and control network packet filtering code in Linux.</entry>
956 <entry>GPL-2.0</entry>
957</row>
958<row>
959 <entry>iw</entry>
960 <entry>4.9</entry>
961 <entry>iw is a new nl80211 based CLI configuration utility for wireless devices. It supports almost all new drivers that have been added to the kernel recently. </entry>
962 <entry>BSD</entry>
963</row>
964<row>
965 <entry>jacl</entry>
966 <entry>1.4.1</entry>
967 <entry>Tcl interpreter for Java</entry>
968 <entry> UCB, SUN, AMD, CDS</entry>
969</row>
970<row>
971 <entry>jamvm</entry>
972 <entry>2.0.0-devel</entry>
973 <entry>A compact Java Virtual Machine which conforms to the JVM specification version 2.</entry>
974 <entry>GPL-2.0</entry>
975</row>
976<row>
977 <entry>jansson</entry>
978 <entry>2.9</entry>
979 <entry>Jansson is a C library for encoding decoding and manipulating JSON data.</entry>
980 <entry>MIT</entry>
981</row>
982<row>
983 <entry>jaxp1.3</entry>
984 <entry>1.4.01</entry>
985 <entry>Java XML parser and transformer APIs (DOM SAX JAXP TrAX)</entry>
986 <entry> Apache-2.0, W3C, PD</entry>
987</row>
988<row>
989 <entry>jdepend</entry>
990 <entry>2.9.1</entry>
991 <entry>Design quality metrics generator for each Java</entry>
992 <entry>BSD</entry>
993</row>
994<row>
995 <entry>jikes-initial</entry>
996 <entry>1.0</entry>
997 <entry>Initial Java 1.4-compatible (and not higher) compiler.</entry>
998 <entry>MIT</entry>
999</row>
1000<row>
1001 <entry>jikes</entry>
1002 <entry>1.22</entry>
1003 <entry>Java compiler adhering to language and VM specifications</entry>
1004 <entry>IPL-1.0</entry>
1005</row>
1006<row>
1007 <entry>jlex</entry>
1008 <entry>1.2.6</entry>
1009 <entry>Lexical analyzer generator for Java</entry>
1010 <entry>JLEX</entry>
1011</row>
1012<row>
1013 <entry>jsch</entry>
1014 <entry>0.1.40</entry>
1015 <entry>SSH implementation in Java</entry>
1016 <entry>BSD</entry>
1017</row>
1018<row>
1019 <entry>junit</entry>
1020 <entry>3.8.2</entry>
1021 <entry>JUnit is a testing framework for Java</entry>
1022 <entry>CPL-1.0</entry>
1023</row>
1024<row>
1025 <entry>jzlib</entry>
1026 <entry>1.0.7</entry>
1027 <entry>zlib implementation in Java</entry>
1028 <entry>BSD</entry>
1029</row>
1030<row>
1031 <entry>kbd</entry>
1032 <entry>2.0.4</entry>
1033 <entry>Keytable files and keyboard utilities.</entry>
1034 <entry>GPL-2.0</entry>
1035</row>
1036<row>
1037 <entry>kbproto</entry>
1038 <entry>1.0.7</entry>
1039 <entry>This package provides the wire protocol for the X Keyboard extension. This extension is used to control options related to keyboard handling and layout.</entry>
1040 <entry>MIT</entry>
1041</row>
1042<row>
1043 <entry>kern-tools</entry>
1044 <entry>0.2</entry>
1045 <entry>Tools for managing Yocto Project style branched kernels.</entry>
1046 <entry>GPL-2.0</entry>
1047</row>
1048<row>
1049 <entry>keymaps</entry>
1050 <entry>1.0</entry>
1051 <entry>Keymaps and initscript to set the keymap on bootup.</entry>
1052 <entry>GPL-2.0</entry>
1053</row>
1054<row>
1055 <entry>keyutils</entry>
1056 <entry>1.5.10</entry>
1057 <entry> Utilities to control the kernel key management facility and to provide a mechanism by which the kernel call back to userspace to get a key instantiated. </entry>
1058 <entry> LGPL-2.1, GPL-2.0</entry>
1059</row>
1060<row>
1061 <entry>kmod</entry>
1062 <entry>24</entry>
1063 <entry>kmod is a set of tools to handle common tasks with Linux kernel modules like insert remove list check properties resolve dependencies and aliases.</entry>
1064 <entry> GPL-2.0, LGPL-2.1</entry>
1065</row>
1066<row>
1067 <entry>krb5</entry>
1068 <entry>1.15.1</entry>
1069 <entry>"Kerberos is a system for authenticating users and services on a network. Kerberos is a trusted third-party service. That means that there is a third party (the Kerberos server) that is trusted by all the entities on the network (users and services usually called ""principals""). . This is the MIT reference implementation of Kerberos V5. . This package contains the Kerberos key server (KDC). The KDC manages all authentication credentials for a Kerberos realm holds the master keys for the realm and responds to authentication requests. This package should be installed on both master and slave KDCs."</entry>
1070 <entry>MIT</entry>
1071</row>
1072<row>
1073 <entry>ldconfig</entry>
1074 <entry>2.12.1</entry>
1075 <entry>A standalone native ldconfig build.</entry>
1076 <entry>GPL-2.0</entry>
1077</row>
1078<row>
1079 <entry>libaio</entry>
1080 <entry>0.3.110</entry>
1081 <entry>Asynchronous input/output library that uses the kernels native interface</entry>
1082 <entry>LGPL-2.1</entry>
1083</row>
1084<row>
1085 <entry>libarchive</entry>
1086 <entry>3.3.2</entry>
1087 <entry>C library and command-line tools for reading and writing tar cpio zip ISO and other archive formats</entry>
1088 <entry>BSD</entry>
1089</row>
1090<row>
1091 <entry>libassuan</entry>
1092 <entry>2.4.3</entry>
1093 <entry>IPC library used by GnuPG and GPGME.</entry>
1094 <entry> GPL-3.0, LGPL-2.1</entry>
1095</row>
1096<row>
1097 <entry>libbsd</entry>
1098 <entry>0.8.6</entry>
1099 <entry>This library provides useful functions commonly found on BSD systems and lacking on others like GNU systems thus making it easier to port projects with strong BSD origins without needing to embed the same code over and over again on each project.</entry>
1100 <entry> BSD-4-Clause, ISC, PD</entry>
1101</row>
1102<row>
1103 <entry>libcap</entry>
1104 <entry>2.25</entry>
1105 <entry>Library for getting/setting POSIX.1e capabilities.</entry>
1106 <entry> BSD, GPL-2.0</entry>
1107</row>
1108<row>
1109 <entry>libcgroup</entry>
1110 <entry>0.41</entry>
1111 <entry>libcgroup is a library that abstracts the control group file system in Linux. Control groups allow you to limit account and isolate resource usage (CPU memory disk I/O etc.) of groups of processes.</entry>
1112 <entry>LGPL-2.1</entry>
1113</row>
1114<row>
1115 <entry>libcheck</entry>
1116 <entry>0.10.0</entry>
1117 <entry>Check - unit testing framework for C code.</entry>
1118 <entry>LGPL-2.1</entry>
1119</row>
1120<row>
1121 <entry>libdaemon</entry>
1122 <entry>0.14</entry>
1123 <entry>Lightweight C library which eases the writing of UNIX daemons.</entry>
1124 <entry>LGPL-2.1</entry>
1125</row>
1126<row>
1127 <entry>libdevmapper</entry>
1128 <entry>2.02.171</entry>
1129 <entry>LVM2 is a set of utilities to manage logical volumes in Linux.</entry>
1130 <entry> GPL-2.0, LGPL-2.0</entry>
1131</row>
1132<row>
1133 <entry>libecj-bootstrap</entry>
1134 <entry>3.6.2</entry>
1135 <entry>JDT Core Batch Compiler - Jar only</entry>
1136 <entry>EPL-1.0</entry>
1137</row>
1138<row>
1139 <entry>libevent</entry>
1140 <entry>2.1.8</entry>
1141 <entry>An asynchronous event notification library.</entry>
1142 <entry> BSD, MIT</entry>
1143</row>
1144<row>
1145 <entry>libffi</entry>
1146 <entry>3.2.1</entry>
1147 <entry>The `libffi' library provides a portable high level programming interface to various calling conventions. This allows a programmer to call any function specified by a call interface description at run time. FFI stands for Foreign Function Interface. A foreign function interface is the popular name for the interface that allows code written in one language to call code written in another language. The `libffi' library really only provides the lowest machine dependent layer of a fully featured foreign function interface. A layer must exist above `libffi' that handles type conversions for values passed between the two languages.</entry>
1148 <entry>MIT</entry>
1149</row>
1150<row>
1151 <entry>libfile-slurp-perl</entry>
1152 <entry>9999.19</entry>
1153 <entry>This module provides subroutines to read or write entire files with a simple call. It also has a subroutine for reading the list of filenames in a directory. </entry>
1154 <entry> Artistic-1.0, GPL-1.0</entry>
1155</row>
1156<row>
1157 <entry>libgcc</entry>
1158 <entry>7.3.0</entry>
1159 <entry>GNU cc and gcc C compilers.</entry>
1160 <entry>GPL-3.0-with-GCC-exception</entry>
1161</row>
1162<row>
1163 <entry>libgcrypt</entry>
1164 <entry>1.8.0</entry>
1165 <entry>General purpose cryptographic library based on the code from GnuPG.</entry>
1166 <entry> GPL-2.0, LGPL-2.1, GPL-3.0</entry>
1167</row>
1168<row>
1169 <entry>libgpg-error</entry>
1170 <entry>1.27</entry>
1171 <entry>Small library that defines common error values for all GnuPG components.</entry>
1172 <entry> GPL-2.0, LGPL-2.1</entry>
1173</row>
1174<row>
1175 <entry>libgudev</entry>
1176 <entry>231</entry>
1177 <entry>GObject wrapper for libudev.</entry>
1178 <entry>LGPL-2.1</entry>
1179</row>
1180<row>
1181 <entry>libice</entry>
1182 <entry>1.0.9</entry>
1183 <entry>The Inter-Client Exchange (ICE) protocol provides a generic framework for building protocols on top of reliable byte-stream transport connections. It provides basic mechanisms for setting up and shutting down connections for performing authentication for negotiating versions and for reporting errors. </entry>
1184 <entry>MIT</entry>
1185</row>
1186<row>
1187 <entry>libidn</entry>
1188 <entry>1.33</entry>
1189 <entry>Implementation of the Stringprep Punycode and IDNA specifications defined by the IETF Internationalized Domain Names (IDN) working group.</entry>
1190 <entry> LGPL-2.1, LGPL-3.0, GPL-3.0</entry>
1191</row>
1192<row>
1193 <entry>libjpeg-turbo</entry>
1194 <entry>1.5.2</entry>
1195 <entry>libjpeg-turbo is a derivative of libjpeg that uses SIMD instructions (MMX SSE2 NEON) to accelerate baseline JPEG compression and decompression</entry>
1196 <entry>BSD-3-Clause</entry>
1197</row>
1198<row>
1199 <entry>libmbim</entry>
1200 <entry>1.16.0</entry>
1201 <entry>libmbim is a glib-based library for talking to WWAN modems and devices which speak the Mobile Interface Broadband Model (MBIM) protocol</entry>
1202 <entry> GPL-2.0, LGPL-2.1</entry>
1203</row>
1204<row>
1205 <entry>libmnl</entry>
1206 <entry>1.0.4</entry>
1207 <entry>Minimalistic user-space library oriented to Netlink developers providing functions for common tasks in parsing validating and constructing both the Netlink header and TLVs.</entry>
1208 <entry>LGPL-2.1</entry>
1209</row>
1210<row>
1211 <entry>libmpc</entry>
1212 <entry>1.0.3</entry>
1213 <entry>Mpc is a C library for the arithmetic of complex numbers with arbitrarily high precision and correct rounding of the result. It is built upon and follows the same principles as Mpfr</entry>
1214 <entry>LGPL-3.0</entry>
1215</row>
1216<row>
1217 <entry>libndp</entry>
1218 <entry>1.6</entry>
1219 <entry>Library for IPv6 Neighbor Discovery Protocol.</entry>
1220 <entry>LGPL-2.1</entry>
1221</row>
1222<row>
1223 <entry>libnewt</entry>
1224 <entry>0.52.20</entry>
1225 <entry>Newt is a programming library for color text mode widget based user interfaces. Newt can be used to add stacked windows entry widgets checkboxes radio buttons labels plain text fields scrollbars etc. to text mode user interfaces. This package also contains the shared library needed by programs built with newt as well as a /usr/bin/dialog replacement called whiptail. Newt is based on the slang library.</entry>
1226 <entry>LGPL-2.0</entry>
1227</row>
1228<row>
1229 <entry>libnl</entry>
1230 <entry>3.4.0</entry>
1231 <entry>A library for applications dealing with netlink sockets.</entry>
1232 <entry>LGPL-2.1</entry>
1233</row>
1234<row>
1235 <entry>libnss-mdns</entry>
1236 <entry>0.10</entry>
1237 <entry>Name Service Switch module for Multicast DNS (zeroconf) name resolution.</entry>
1238 <entry>LGPL-2.1</entry>
1239</row>
1240<row>
1241 <entry>libpcap</entry>
1242 <entry>1.8.1</entry>
1243 <entry>Libpcap provides a portable framework for low-level network monitoring. Libpcap can provide network statistics collection security monitoring and network debugging.</entry>
1244 <entry>BSD</entry>
1245</row>
1246<row>
1247 <entry>libpciaccess</entry>
1248 <entry>0.13.5</entry>
1249 <entry>libpciaccess provides functionality for X to access the PCI bus and devices in a platform-independent way.</entry>
1250 <entry> MIT</entry>
1251</row>
1252<row>
1253 <entry>libpcre</entry>
1254 <entry>8.41</entry>
1255 <entry>The PCRE library is a set of functions that implement regular expression pattern matching using the same syntax and semantics as Perl 5. PCRE has its own native API as well as a set of wrapper functions that correspond to the POSIX regular expression API.</entry>
1256 <entry>BSD</entry>
1257</row>
1258<row>
1259 <entry>libpng</entry>
1260 <entry>1.6.31</entry>
1261 <entry>PNG image format decoding library.</entry>
1262 <entry>Libpng</entry>
1263</row>
1264<row>
1265 <entry>libpthread-stubs</entry>
1266 <entry>0.4</entry>
1267 <entry>This library provides weak aliases for pthread functions not provided in libc or otherwise available by default.</entry>
1268 <entry>MIT</entry>
1269</row>
1270<row>
1271 <entry>libqmi</entry>
1272 <entry>1.20.2</entry>
1273 <entry>libqmi is a glib-based library for talking to WWAN modems and devices which speak the Qualcomm MSM Interface (QMI) protocol</entry>
1274 <entry> GPL-2.0, LGPL-2.1</entry>
1275</row>
1276<row>
1277 <entry>libsdl</entry>
1278 <entry>1.2.15</entry>
1279 <entry>Simple DirectMedia Layer is a cross-platform multimedia library designed to provide low level access to audio keyboard mouse joystick 3D hardware via OpenGL and 2D video framebuffer.</entry>
1280 <entry>LGPL-2.1</entry>
1281</row>
1282<row>
1283 <entry>libsign</entry>
1284 <entry>0.3.2</entry>
1285 <entry>This project targets to provide a generic signing framework. This framework separates the signing request and signing process and correspondingly forms the so-called signlet and signaturelet. Each signaturelet only concerns about the details about how to construct the layout of a signature format and signlet only cares how to construct the signing request. </entry>
1286 <entry>BSD-3-Clause</entry>
1287</row>
1288<row>
1289 <entry>libsm</entry>
1290 <entry>1.2.2</entry>
1291 <entry>"The Session Management Library (SMlib) is a low-level \""C\"" language interface to XSMP. The purpose of the X Session Management Protocol (XSMP) is to provide a uniform mechanism for users to save and restore their sessions. A session is a group of clients each of which has a particular state."</entry>
1292 <entry>MIT</entry>
1293</row>
1294<row>
1295 <entry>libtasn1</entry>
1296 <entry>4.12</entry>
1297 <entry>Library for ASN.1 and DER manipulation.</entry>
1298 <entry> GPL-3.0, LGPL-2.1</entry>
1299</row>
1300<row>
1301 <entry>libtool</entry>
1302 <entry>2.4.6</entry>
1303 <entry>This is GNU libtool a generic library support script. Libtool hides the complexity of generating special library types (such as shared libraries) behind a consistent interface.</entry>
1304 <entry> GPL-2.0, LGPL-2.1</entry>
1305</row>
1306<row>
1307 <entry>libunistring</entry>
1308 <entry>0.9.7</entry>
1309 <entry>Text files are nowadays usually encoded in Unicode and may consist of very different scripts from Latin letters to Chinese Hanzi with many kinds of special characters accents right-to-left writing marks hyphens Roman numbers and much more. But the POSIX platform APIs for text do not contain adequate functions for dealing with particular properties of many Unicode characters. In fact the POSIX APIs for text have several assumptions at their base which don't hold for Unicode text. This library provides functions for manipulating Unicode strings and for manipulating C strings according to the Unicode standard. This package contains documentation.</entry>
1310 <entry> LGPL-3.0, GPL-2.0</entry>
1311</row>
1312<row>
1313 <entry>libusb-compat</entry>
1314 <entry>0.1.5</entry>
1315 <entry>libusb-0.1 compatible layer for libusb1 a drop-in replacement that aims to look feel and behave exactly like libusb-0.1</entry>
1316 <entry>LGPL-2.1</entry>
1317</row>
1318<row>
1319 <entry>libusb1</entry>
1320 <entry>1.0.21</entry>
1321 <entry>Userspace library to access USB (version 1.0).</entry>
1322 <entry>LGPL-2.1</entry>
1323</row>
1324<row>
1325 <entry>libvirt</entry>
1326 <entry>4.2.0</entry>
1327 <entry>A toolkit to interact with the virtualization capabilities of recent versions of Linux.</entry>
1328 <entry> LGPL-2.1, GPL-2.0</entry>
1329</row>
1330<row>
1331 <entry>libx11</entry>
1332 <entry>1.6.5</entry>
1333 <entry>This package provides a client interface to the X Window System otherwise known as 'Xlib'. It provides a complete API for the basic functions of the window system.</entry>
1334 <entry> MIT, BSD</entry>
1335</row>
1336<row>
1337 <entry>libxau</entry>
1338 <entry>1.0.8</entry>
1339 <entry>libxau provides the main interfaces to the X11 authorisation handling which controls authorisation for X connections both client-side and server-side.</entry>
1340 <entry>MIT</entry>
1341</row>
1342<row>
1343 <entry>libxcb</entry>
1344 <entry>1.12</entry>
1345 <entry>The X protocol C-language Binding (XCB) is a replacement for Xlib featuring a small footprint latency hiding direct access to the protocol improved threading support and extensibility.</entry>
1346 <entry>MIT</entry>
1347</row>
1348<row>
1349 <entry>libxdmcp</entry>
1350 <entry>1.1.2</entry>
1351 <entry>The purpose of the X Display Manager Control Protocol (XDMCP) is to provide a uniform mechanism for an autonomous display to request login service from a remote host. An X terminal (screen keyboard mouse processor network interface) is a prime example of an autonomous display.</entry>
1352 <entry>MIT</entry>
1353</row>
1354<row>
1355 <entry>libxext</entry>
1356 <entry>1.3.3</entry>
1357 <entry>libXext provides an X Window System client interface to several extensions to the X protocol. The supported protocol extensions are DOUBLE-BUFFER DPMS Extended-Visual-Information LBX MIT_SHM MIT_SUNDRY-NONSTANDARD Multi-Buffering SECURITY SHAPE SYNC TOG-CUP XC-APPGROUP XC-MISC XTEST. libXext also provides a small set of utility functions to aid authors of client APIs for X protocol extensions.</entry>
1358 <entry>MIT</entry>
1359</row>
1360<row>
1361 <entry>libxkbcommon</entry>
1362 <entry>0.7.1</entry>
1363 <entry>libxkbcommon is a keymap compiler and support library which processes a reduced subset of keymaps as defined by the XKB specification.</entry>
1364 <entry> MIT</entry>
1365</row>
1366<row>
1367 <entry>libxml-parser-perl</entry>
1368 <entry>2.44</entry>
1369 <entry>XML::Parser - A perl module for parsing XML documents.</entry>
1370 <entry> Artistic-1.0, GPL-1.0</entry>
1371</row>
1372<row>
1373 <entry>libxml2</entry>
1374 <entry>2.9.5</entry>
1375 <entry>The XML Parser Library allows for manipulation of XML files. Libxml2 exports Push and Pull type parser interfaces for both XML and HTML. It can do DTD validation at parse time on a parsed document instance or with an arbitrary DTD. Libxml2 includes complete XPath XPointer and Xinclude implementations. It also has a SAX like interface which is designed to be compatible with Expat.</entry>
1376 <entry>MIT</entry>
1377</row>
1378<row>
1379 <entry>libxrandr</entry>
1380 <entry>1.5.1</entry>
1381 <entry>The X Resize Rotate and Reflect Extension called RandR for short brings the ability to resize rotate and reflect the root window of a screen. It is based on the X Resize and Rotate Extension as specified in the Proceedings of the 2001 Usenix Technical Conference [RANDR].</entry>
1382 <entry>MIT</entry>
1383</row>
1384<row>
1385 <entry>libxrender</entry>
1386 <entry>0.9.10</entry>
1387 <entry>The X Rendering Extension (Render) introduces digital image composition as the foundation of a new rendering model within the X Window System. Rendering geometric figures is accomplished by client-side tessellation into either triangles or trapezoids. Text is drawn by loading glyphs into the server and rendering sets of them.</entry>
1388 <entry>MIT</entry>
1389</row>
1390<row>
1391 <entry>libxslt</entry>
1392 <entry>1.1.29</entry>
1393 <entry>GNOME XSLT library.</entry>
1394 <entry>MIT</entry>
1395</row>
1396<row>
1397 <entry>libyaml</entry>
1398 <entry>0.1.7</entry>
1399 <entry>LibYAML is a C library for parsing and emitting data in YAML 1.1 a human-readable data serialization format. </entry>
1400 <entry>MIT</entry>
1401</row>
1402<row>
1403 <entry>linux-firmware</entry>
1404 <entry>0.0</entry>
1405 <entry>Firmware files for use with Linux kernel.</entry>
1406 <entry>Redistributable binaries</entry>
1407</row>
1408<row>
1409 <entry>linux-intel-guest</entry>
1410 <entry>4.14.123</entry>
1411 <entry>Linux kernel.</entry>
1412 <entry>GPL-2.0</entry>
1413</row>
1414<row>
1415 <entry>linux-intel-host</entry>
1416 <entry>4.14.123</entry>
1417 <entry>Linux kernel.</entry>
1418 <entry>GPL-2.0</entry>
1419</row>
1420<row>
1421 <entry>linux-libc-headers</entry>
1422 <entry>4.12</entry>
1423 <entry>Sanitized set of kernel headers for the C library's use.</entry>
1424 <entry>GPL-2.0</entry>
1425</row>
1426<row>
1427 <entry>log4j1.2</entry>
1428 <entry>1.2.17</entry>
1429 <entry>Java library to help the programmer output log statements to a variety of output targets</entry>
1430 <entry>Apache-2.0</entry>
1431</row>
1432<row>
1433 <entry>logkit</entry>
1434 <entry>1.2.2</entry>
1435 <entry>Logging toolkit designed for secure performance orientated logging in Java applications</entry>
1436 <entry>Apache-2.0</entry>
1437</row>
1438<row>
1439 <entry>logrotate</entry>
1440 <entry>3.12.3</entry>
1441 <entry>Rotates compresses removes and mails system log files.</entry>
1442 <entry>GPL-2.0</entry>
1443</row>
1444<row>
1445 <entry>lsb</entry>
1446 <entry>4.1</entry>
1447 <entry>LSB support for OpenEmbedded.</entry>
1448 <entry>GPL-2.0</entry>
1449</row>
1450<row>
1451 <entry>lsbinitscripts</entry>
1452 <entry>9.72</entry>
1453 <entry>SysV init scripts which are only used in an LSB image.</entry>
1454 <entry>GPL-2.0</entry>
1455</row>
1456<row>
1457 <entry>lshw</entry>
1458 <entry>02.17</entry>
1459 <entry>A small tool to provide detailed information on the hardware configuration of the machine. It can report exact memory configuration firmware version mainboard configuration CPU version and speed cache configuration bus speed etc. on DMI-capable or EFI systems.</entry>
1460 <entry>GPL-2.0</entry>
1461</row>
1462<row>
1463 <entry>lsof</entry>
1464 <entry>4.89</entry>
1465 <entry>Lsof is a Unix-specific diagnostic tool. Its name stands for LiSt Open Files and it does just that.</entry>
1466 <entry>BSD</entry>
1467</row>
1468<row>
1469 <entry>lvm2</entry>
1470 <entry>2.02.171</entry>
1471 <entry>LVM2 is a set of utilities to manage logical volumes in Linux.</entry>
1472 <entry> GPL-2.0, LGPL-2.0</entry>
1473</row>
1474<row>
1475 <entry>lxc</entry>
1476 <entry>2.0.8</entry>
1477 <entry>lxc aims to use these new functionnalities to provide an userspace container object</entry>
1478 <entry>GPL-2.0</entry>
1479</row>
1480<row>
1481 <entry>lxd</entry>
1482 <entry>git</entry>
1483 <entry>"LXD is a container ""hypervisor"" and a new user experience for LXC Specifically it's made of three components: - A system-wide daemon (lxd) - A command line client (lxc) - An OpenStack Nova plugin (nova-compute-lxd)"</entry>
1484 <entry>Apache-2.0</entry>
1485</row>
1486<row>
1487 <entry>lz4</entry>
1488 <entry>1.7.4</entry>
1489 <entry>LZ4 is a very fast lossless compression algorithm providing compression speed at 400 MB/s per core scalable with multi-cores CPU. It also features an extremely fast decoder with speed in multiple GB/s per core typically reaching RAM speed limits on multi-core systems.</entry>
1490 <entry> BSD, BSD-2-Clause, GPL-2.0</entry>
1491</row>
1492<row>
1493 <entry>lzo</entry>
1494 <entry>2.10</entry>
1495 <entry>Lossless data compression library.</entry>
1496 <entry>GPL-2.0</entry>
1497</row>
1498<row>
1499 <entry>lzop</entry>
1500 <entry>1.03</entry>
1501 <entry>lzop is a compression utility which is designed to be a companion to gzip. \nIt is based on the LZO data compression library and its main advantages over \ngzip are much higher compression and decompression speed at the cost of some \ncompression ratio. The lzop compression utility was designed with the goals \nof reliability speed portability and with reasonable drop-in compatibility \nto gzip.</entry>
1502 <entry>GPL-2.0</entry>
1503</row>
1504<row>
1505 <entry>m4</entry>
1506 <entry>1.4.18</entry>
1507 <entry>GNU m4 is an implementation of the traditional Unix macro processor. It is mostly SVR4 compatible although it has some extensions (for example handling more than 9 positional parameters to macros). GNU M4 also has built-in functions for including files running shell commands doing arithmetic etc.</entry>
1508 <entry>GPL-3.0</entry>
1509</row>
1510<row>
1511 <entry>make</entry>
1512 <entry>4.2.1</entry>
1513 <entry>Make is a tool which controls the generation of executables and other non-source files of a program from the program's source files. Make gets its knowledge of how to build your program from a file called the makefile which lists each of the non-source files and how to compute it from other files.</entry>
1514 <entry> GPL-3.0, LGPL-2.0</entry>
1515</row>
1516<row>
1517 <entry>makedepend</entry>
1518 <entry>1.0.5</entry>
1519 <entry>The makedepend program reads each sourcefile in sequence and parses it like a C-preprocessor processing all #include #define #undef #ifdef #ifndef #endif #if #elif and #else directives so that it can correctly tell which #include directives would be used in a compilation. Any #include directives can reference files having other #include directives and parsing will occur in these files as well.</entry>
1520 <entry>MIT</entry>
1521</row>
1522<row>
1523 <entry>makedevs</entry>
1524 <entry>1.0.1</entry>
1525 <entry>Tool for creating device nodes.</entry>
1526 <entry>GPL-2.0</entry>
1527</row>
1528<row>
1529 <entry>mklibs</entry>
1530 <entry>0.1.43</entry>
1531 <entry>mklibs produces cut-down shared libraries that contain only the routines required by a particular set of executables.</entry>
1532 <entry>GPL-2.0</entry>
1533</row>
1534<row>
1535 <entry>modemmanager</entry>
1536 <entry>1.7.991</entry>
1537 <entry>ModemManager is a DBus-activated daemon which controls mobile broadband (2G/3G/4G) devices and connections</entry>
1538 <entry> GPL-2.0, LGPL-2.1</entry>
1539</row>
1540<row>
1541 <entry>mokutil</entry>
1542 <entry>0.3.0</entry>
1543 <entry>The utility to manipulate machines owner keys which managed in shim.</entry>
1544 <entry>GPL-3.0</entry>
1545</row>
1546<row>
1547 <entry>mozjs</entry>
1548 <entry>17.0.0</entry>
1549 <entry>SpiderMonkey is Mozilla's JavaScript engine written in C/C++.</entry>
1550 <entry>MPL-2.0</entry>
1551</row>
1552<row>
1553 <entry>mpfr</entry>
1554 <entry>3.1.5</entry>
1555 <entry>C library for multiple-precision floating-point computations with exact rounding.</entry>
1556 <entry> GPL-3.0, LGPL-3.0</entry>
1557</row>
1558<row>
1559 <entry>mtools</entry>
1560 <entry>4.0.18</entry>
1561 <entry>Mtools is a collection of utilities to access MS-DOS disks from GNU and Unix without mounting them.</entry>
1562 <entry>GPL-3.0</entry>
1563</row>
1564<row>
1565 <entry>nasm</entry>
1566 <entry>2.13.01</entry>
1567 <entry>General-purpose x86 assembler.</entry>
1568 <entry>BSD-2-Clause</entry>
1569</row>
1570<row>
1571 <entry>ncurses</entry>
1572 <entry>6.0</entry>
1573 <entry>SVr4 and XSI-Curses compatible curses library and terminfo tools including tic infocmp captoinfo. Supports color multiple highlights forms-drawing characters and automatic recognition of keypad and function-key sequences. Extensions include resizable windows and mouse support on both xterm and Linux console using the gpm library.</entry>
1574 <entry>MIT</entry>
1575</row>
1576<row>
1577 <entry>net-snmp</entry>
1578 <entry>5.7.3</entry>
1579 <entry>Various tools relating to the Simple Network Management Protocol.</entry>
1580 <entry>BSD</entry>
1581</row>
1582<row>
1583 <entry>netbase</entry>
1584 <entry>5.4</entry>
1585 <entry>This package provides the necessary infrastructure for basic TCP/IP based networking</entry>
1586 <entry>GPL-2.0</entry>
1587</row>
1588<row>
1589 <entry>netcat-openbsd</entry>
1590 <entry>1.105</entry>
1591 <entry>A simple Unix utility which reads and writes data across network connections using TCP or UDP protocol. It is designed to be a reliable 'back-end' tool that can be used directly or easily driven by other programs and scripts. At the same time it is a feature-rich network debugging and exploration tool since it can create almost any kind of connection you would need and has several interesting built-in capabilities.</entry>
1592 <entry>BSD-3-Clause</entry>
1593</row>
1594<row>
1595 <entry>netcf</entry>
1596 <entry>0.2.8</entry>
1597 <entry>netcf is a cross-platform network configuration library.</entry>
1598 <entry>LGPL-2.1</entry>
1599</row>
1600<row>
1601 <entry>nettle</entry>
1602 <entry>3.3</entry>
1603 <entry>A low level cryptographic library.</entry>
1604 <entry> LGPL-3.0, GPL-2.0</entry>
1605</row>
1606<row>
1607 <entry>networkmanager</entry>
1608 <entry>1.10.10</entry>
1609 <entry>NetworkManager.</entry>
1610 <entry>GPL-2.0</entry>
1611</row>
1612<row>
1613 <entry>nfv-init</entry>
1614 <entry>1.0</entry>
1615 <entry>Enea service expected to be run after cloud-init</entry>
1616 <entry>Enea</entry>
1617</row>
1618<row>
1619 <entry>nfv-installer</entry>
1620 <entry>1.0</entry>
1621 <entry>Enea NFV Access installer</entry>
1622 <entry>Enea</entry>
1623</row>
1624<row>
1625 <entry>nfva-startup</entry>
1626 <entry>1.0</entry>
1627 <entry>Service that configures the network according to installer settings</entry>
1628 <entry>Enea</entry>
1629</row>
1630<row>
1631 <entry>notary</entry>
1632 <entry>0.4.2</entry>
1633 <entry>Notary is a Docker project that allows anyone to have trust over arbitrary collections of data</entry>
1634 <entry>Apache-2.0</entry>
1635</row>
1636<row>
1637 <entry>nspr</entry>
1638 <entry>4.16</entry>
1639 <entry>Netscape Portable Runtime Library.</entry>
1640 <entry> GPL-2.0, MPL-2.0, LGPL-2.1</entry>
1641</row>
1642<row>
1643 <entry>nss</entry>
1644 <entry>3.31.1</entry>
1645 <entry>Network Security Services (NSS) is a set of libraries designed to support cross-platform development of security-enabled client and server applications. Applications built with NSS can support SSL v2 and v3 TLS PKCS 5 PKCS 7 PKCS 11 PKCS 12 S/MIME X.509 v3 certificates and other security standards.</entry>
1646 <entry> MPL-2.0, GPL-2.0, MPL-2.0, LGPL-2.1</entry>
1647</row>
1648<row>
1649 <entry>ntp</entry>
1650 <entry>4.2.8p10</entry>
1651 <entry>The Network Time Protocol (NTP) is used to synchronize the time of a computer client or server to another server or reference time source such as a radio or satellite receiver or modem.</entry>
1652 <entry>NTP</entry>
1653</row>
1654<row>
1655 <entry>numactl</entry>
1656 <entry>2.0.11</entry>
1657 <entry>Simple NUMA policy support. It consists of a numactl program to run other programs with a specific NUMA policy and a libnuma to do allocations with NUMA policy in applications.</entry>
1658 <entry> GPL-2.0, LGPL-2.1</entry>
1659</row>
1660<row>
1661 <entry>openjdk-8</entry>
1662 <entry>102b14</entry>
1663 <entry>Java runtime based upon the OpenJDK Project</entry>
1664 <entry>GPL-2.0-with-classpath-exception</entry>
1665</row>
1666<row>
1667 <entry>openssh</entry>
1668 <entry>7.5p1</entry>
1669 <entry>Secure rlogin/rsh/rcp/telnet replacement (OpenSSH) Ssh (Secure Shell) is a program for logging into a remote machine and for executing commands on a remote machine.</entry>
1670 <entry>BSD</entry>
1671</row>
1672<row>
1673 <entry>openssl</entry>
1674 <entry>1.0.2o</entry>
1675 <entry>Secure Socket Layer (SSL) binary and related cryptographic tools.</entry>
1676 <entry>OpenSSL</entry>
1677</row>
1678<row>
1679 <entry>openvswitch</entry>
1680 <entry>2.9</entry>
1681 <entry> Open vSwitch is a production quality multilayer virtual switch licensed under the open source Apache 2.0 license. It is designed to enable massive network automation through programmatic extension while still supporting standard management interfaces and protocols (e.g. NetFlow sFlow SPAN RSPAN CLI LACP 802.1ag) </entry>
1682 <entry>Apache-2.0</entry>
1683</row>
1684<row>
1685 <entry>opkg-utils</entry>
1686 <entry>0.3.5</entry>
1687 <entry>Additional utilities for the opkg package manager.</entry>
1688 <entry>GPL-2.0</entry>
1689</row>
1690<row>
1691 <entry>oro</entry>
1692 <entry>2.0.8</entry>
1693 <entry>Perl5-compatible regular expressions library for Java</entry>
1694 <entry>Apache-2.0</entry>
1695</row>
1696<row>
1697 <entry>os-release</entry>
1698 <entry>1.0</entry>
1699 <entry>The /etc/os-release file contains operating system identification data.</entry>
1700 <entry>MIT</entry>
1701</row>
1702<row>
1703 <entry>ostree-initrd</entry>
1704 <entry>3</entry>
1705 <entry>Extremely basic live image init script.</entry>
1706 <entry>MIT</entry>
1707</row>
1708<row>
1709 <entry>ostree-rw</entry>
1710 <entry>1.0</entry>
1711 <entry>Enea bash script to make current ostree hash writable</entry>
1712 <entry>Enea</entry>
1713</row>
1714<row>
1715 <entry>ostree</entry>
1716 <entry>v2018.7</entry>
1717 <entry>Tool for managing bootable immutable versioned filesystem trees.</entry>
1718 <entry>LGPL-2.0</entry>
1719</row>
1720<row>
1721 <entry>packagegroup-core-boot</entry>
1722 <entry>1.0</entry>
1723 <entry>The minimal set of packages required to boot the system</entry>
1724 <entry>MIT</entry>
1725</row>
1726<row>
1727 <entry>packagegroup-core-ssh-openssh</entry>
1728 <entry>1.0</entry>
1729 <entry>OpenSSH SSH client/server.</entry>
1730 <entry>MIT</entry>
1731</row>
1732<row>
1733 <entry>packagegroup-efi-secure-boot</entry>
1734 <entry>1.0</entry>
1735 <entry>EFI Secure Boot packages for secure-environment.</entry>
1736 <entry>MIT</entry>
1737</row>
1738<row>
1739 <entry>packagegroup-enea-virtualization-4gusb-modems</entry>
1740 <entry>1.0</entry>
1741 <entry>Packagegroup for 4G usb modems.</entry>
1742 <entry>MIT</entry>
1743</row>
1744<row>
1745 <entry>packagegroup-enea-virtualization-docker</entry>
1746 <entry>1.0</entry>
1747 <entry>Packagegroup for Docker.</entry>
1748 <entry>MIT</entry>
1749</row>
1750<row>
1751 <entry>packagegroup-enea-virtualization-dpdk</entry>
1752 <entry>1.0</entry>
1753 <entry>Packagegroup for DPDK.</entry>
1754 <entry>MIT</entry>
1755</row>
1756<row>
1757 <entry>packagegroup-enea-virtualization-guest</entry>
1758 <entry>1.0</entry>
1759 <entry>This package group includes packages and packagegroups specific to the guest side of the Enea Linux Virtualization Profile.</entry>
1760 <entry>MIT</entry>
1761</row>
1762<row>
1763 <entry>packagegroup-enea-virtualization-host</entry>
1764 <entry>1.0</entry>
1765 <entry>This package group includes packages and packagegroups specific to the host side of the Enea Linux Virtualization Profile.</entry>
1766 <entry>MIT</entry>
1767</row>
1768<row>
1769 <entry>packagegroup-enea-virtualization-libvirt</entry>
1770 <entry>1.0</entry>
1771 <entry>Package group for libvirt.</entry>
1772 <entry>MIT</entry>
1773</row>
1774<row>
1775 <entry>packagegroup-enea-virtualization-lxc</entry>
1776 <entry>1.0</entry>
1777 <entry>Packagegroup for LXC.</entry>
1778 <entry>MIT</entry>
1779</row>
1780<row>
1781 <entry>packagegroup-enea-virtualization-lxd</entry>
1782 <entry>1.0</entry>
1783 <entry>Packagegroup for LXD.</entry>
1784 <entry>MIT</entry>
1785</row>
1786<row>
1787 <entry>packagegroup-enea-virtualization-ovs</entry>
1788 <entry>1.0</entry>
1789 <entry>Packagegroup for Open vSwitch.</entry>
1790 <entry>MIT</entry>
1791</row>
1792<row>
1793 <entry>packagegroup-enea-virtualization-qemu</entry>
1794 <entry>1.0</entry>
1795 <entry>Packagegroup for QEMU.</entry>
1796 <entry>MIT</entry>
1797</row>
1798<row>
1799 <entry>packagegroup-enea-virtualization</entry>
1800 <entry>1.0</entry>
1801 <entry>This packagegroup includes packages and packagegroups required for both host and guest images of the Enea Linux Virtualization Profile.</entry>
1802 <entry>MIT</entry>
1803</row>
1804<row>
1805 <entry>packagegroup-enea-wifi</entry>
1806 <entry>1.0</entry>
1807 <entry>This package group includes packages and packagegroups that enable WiFi connectivity in the Enea NFV Access platform</entry>
1808 <entry>MIT</entry>
1809</row>
1810<row>
1811 <entry>parted</entry>
1812 <entry>3.2</entry>
1813 <entry>Disk partition editing/resizing utility.</entry>
1814 <entry>GPL-3.0</entry>
1815</row>
1816<row>
1817 <entry>partrt</entry>
1818 <entry>1.1</entry>
1819 <entry>partrt is a tool for dividing a SMP Linux system into a real time domain and a non-real time domain.</entry>
1820 <entry>BSD</entry>
1821</row>
1822<row>
1823 <entry>pciutils</entry>
1824 <entry>3.5.5</entry>
1825 <entry>The PCI Utilities package contains a library for portable access to PCI bus configuration space and several utilities based on this library.</entry>
1826 <entry>GPL-2.0</entry>
1827</row>
1828<row>
1829 <entry>perl</entry>
1830 <entry>5.24.1</entry>
1831 <entry>Perl scripting language.</entry>
1832 <entry> Artistic-1.0, GPL-1.0</entry>
1833</row>
1834<row>
1835 <entry>pigz</entry>
1836 <entry>2.3.4</entry>
1837 <entry>pigz which stands for parallel implementation of gzip is a fully functional replacement for gzip that exploits multiple processors and multiple cores to the hilt when compressing data. pigz was written by Mark Adler and uses the zlib and pthread libraries.</entry>
1838 <entry> Zlib, Apache-2.0</entry>
1839</row>
1840<row>
1841 <entry>pixman</entry>
1842 <entry>0.34.0</entry>
1843 <entry>Pixman provides a library for manipulating pixel regions -- a set of Y-X banded rectangles image compositing using the Porter/Duff model and implicit mask generation for geometric primitives including trapezoids triangles and rectangles.</entry>
1844 <entry> MIT, PD</entry>
1845</row>
1846<row>
1847 <entry>pkgconfig</entry>
1848 <entry>0.29.2</entry>
1849 <entry>pkg-config is a helper tool used when compiling applications and libraries. It helps determined the correct compiler/link options. It is also language-agnostic.</entry>
1850 <entry>GPL-2.0</entry>
1851</row>
1852<row>
1853 <entry>pm-utils</entry>
1854 <entry>1.4.1</entry>
1855 <entry>Simple shell command line tools to suspend and hibernate.</entry>
1856 <entry>GPL-2.0</entry>
1857</row>
1858<row>
1859 <entry>polkit</entry>
1860 <entry>0.113</entry>
1861 <entry>The polkit package is an application-level toolkit for defining and handling the policy that allows unprivileged processes to speak to privileged processes.</entry>
1862 <entry>LGPL-2.0</entry>
1863</row>
1864<row>
1865 <entry>popt</entry>
1866 <entry>1.16</entry>
1867 <entry>Library for parsing command line options.</entry>
1868 <entry>MIT</entry>
1869</row>
1870<row>
1871 <entry>pps-tools</entry>
1872 <entry>0.0.0</entry>
1873 <entry>User-space tools for LinuxPPS.</entry>
1874 <entry>GPL-2.0</entry>
1875</row>
1876<row>
1877 <entry>prelink</entry>
1878 <entry>1.0</entry>
1879 <entry>The prelink package contains a utility which modifies ELF shared libraries and executables so that far fewer relocations need to be resolved at runtime and thus programs come up faster.</entry>
1880 <entry>GPL-2.0</entry>
1881</row>
1882<row>
1883 <entry>procps</entry>
1884 <entry>3.3.12</entry>
1885 <entry>Procps contains a set of system utilities that provide system information about processes using the /proc filesystem. The package includes the programs ps top vmstat w kill and skill.</entry>
1886 <entry> GPL-2.0, LGPL-2.0</entry>
1887</row>
1888<row>
1889 <entry>pseudo</entry>
1890 <entry>1.8.2</entry>
1891 <entry>Pseudo gives fake root capabilities to a normal user.</entry>
1892 <entry>LGPL-2.1</entry>
1893</row>
1894<row>
1895 <entry>ptest-runner</entry>
1896 <entry>2.1</entry>
1897 <entry>The ptest-runner2 package installs a ptest-runner program which loops through all installed ptest test suites and runs them in sequence.</entry>
1898 <entry>GPL-2.0</entry>
1899</row>
1900<row>
1901 <entry>python-asn1crypto</entry>
1902 <entry>0.23.0</entry>
1903 <entry>Python binding to the Networking and Cryptography (NaCl) library</entry>
1904 <entry>Apache-2.0</entry>
1905</row>
1906<row>
1907 <entry>python-certifi</entry>
1908 <entry>2017.7.27.1</entry>
1909 <entry>This installable Python package contains a CA Bundle that you can reference in your Python code. This is useful for verifying HTTP requests for example. This is the same CA Bundle which ships with the Requests codebase and is derived from Mozilla Firefox's canonical set.</entry>
1910 <entry>ISC</entry>
1911</row>
1912<row>
1913 <entry>python-cffi</entry>
1914 <entry>1.11.2</entry>
1915 <entry>Foreign Function Interface for Python calling C code.</entry>
1916 <entry>MIT</entry>
1917</row>
1918<row>
1919 <entry>python-chardet</entry>
1920 <entry>3.0.4</entry>
1921 <entry>Universal encoding detector for Python 2 and 3.</entry>
1922 <entry>LGPL-2.1</entry>
1923</row>
1924<row>
1925 <entry>python-cryptography-vectors</entry>
1926 <entry>2.0.3</entry>
1927 <entry>Test vectors for the cryptography package..</entry>
1928 <entry> Apache-2.0, BSD</entry>
1929</row>
1930<row>
1931 <entry>python-cryptography</entry>
1932 <entry>2.0.3</entry>
1933 <entry>Provides cryptographic recipes and primitives to python developers.</entry>
1934 <entry> Apache-2.0, BSD</entry>
1935</row>
1936<row>
1937 <entry>python-cython</entry>
1938 <entry>0.27.1</entry>
1939 <entry>Cython is a language specially designed for writing Python extension modules. It's designed to bridge the gap between the nice high-level easy-to-use world of Python and the messy low-level world of C.</entry>
1940 <entry>Apache-2.0</entry>
1941</row>
1942<row>
1943 <entry>python-enum34</entry>
1944 <entry>1.1.6</entry>
1945 <entry>backport of Python 3.4's enum package.</entry>
1946 <entry>BSD-3-Clause</entry>
1947</row>
1948<row>
1949 <entry>python-functools32</entry>
1950 <entry>3.2.3-2</entry>
1951 <entry>Backport of the functools module from Python 3.2.3 for use on 2.7 and PyPy..</entry>
1952 <entry>Python-2.0</entry>
1953</row>
1954<row>
1955 <entry>python-futures</entry>
1956 <entry>3.0.5</entry>
1957 <entry>The concurrent.futures module provides a high-level interface for asynchronously executing callables.</entry>
1958 <entry>BSD</entry>
1959</row>
1960<row>
1961 <entry>python-idna</entry>
1962 <entry>2.6</entry>
1963 <entry>Internationalised Domain Names in Applications.</entry>
1964 <entry> BSD-3-Clause, Python-2.0, Unicode</entry>
1965</row>
1966<row>
1967 <entry>python-ipaddress</entry>
1968 <entry>1.0.18</entry>
1969 <entry>Python 3.3+'s ipaddress for Python 2.6 2.7 3.2..</entry>
1970 <entry>Python-2.0</entry>
1971</row>
1972<row>
1973 <entry>python-iso8601</entry>
1974 <entry>0.1.12</entry>
1975 <entry>Simple module to parse ISO 8601 dates.</entry>
1976 <entry>MIT</entry>
1977</row>
1978<row>
1979 <entry>python-jsonpatch</entry>
1980 <entry>1.16</entry>
1981 <entry>Appling JSON patches in Python 2.6+ and 3.x.</entry>
1982 <entry>BSD</entry>
1983</row>
1984<row>
1985 <entry>python-jsonpointer</entry>
1986 <entry>1.12</entry>
1987 <entry>Resolve JSON Pointers in Python.</entry>
1988 <entry>BSD</entry>
1989</row>
1990<row>
1991 <entry>python-jsonschema</entry>
1992 <entry>2.6.0</entry>
1993 <entry>An implementation of JSON Schema validation for Python.</entry>
1994 <entry>MIT</entry>
1995</row>
1996<row>
1997 <entry>python-ndg-httpsclient</entry>
1998 <entry>0.4.3</entry>
1999 <entry>Provides enhanced HTTPS support for httplib and urllib2 using PyOpenSSL</entry>
2000 <entry>BSD</entry>
2001</row>
2002<row>
2003 <entry>python-netaddr</entry>
2004 <entry>0.7.19</entry>
2005 <entry>A network address manipulation library for Python..</entry>
2006 <entry>BSD</entry>
2007</row>
2008<row>
2009 <entry>python-netifaces</entry>
2010 <entry>0.10.6</entry>
2011 <entry>Portable network interface information.</entry>
2012 <entry>MIT</entry>
2013</row>
2014<row>
2015 <entry>python-pip</entry>
2016 <entry>9.0.1</entry>
2017 <entry>PIP is a tool for installing and managing Python packages.</entry>
2018 <entry> MIT, LGPL-2.1</entry>
2019</row>
2020<row>
2021 <entry>python-pretend</entry>
2022 <entry>1.0.8</entry>
2023 <entry>A library for stubbing in Python.</entry>
2024 <entry>BSD</entry>
2025</row>
2026<row>
2027 <entry>python-prettytable</entry>
2028 <entry>0.7.2</entry>
2029 <entry>Python library for displaying tabular data in a ASCII table format.</entry>
2030 <entry>BSD</entry>
2031</row>
2032<row>
2033 <entry>python-psutil</entry>
2034 <entry>5.3.1</entry>
2035 <entry>A cross-platform process and system utilities module for Python.</entry>
2036 <entry>BSD</entry>
2037</row>
2038<row>
2039 <entry>python-py</entry>
2040 <entry>1.4.34</entry>
2041 <entry>Library with cross-python path ini-parsing io code log facilities.</entry>
2042 <entry>MIT</entry>
2043</row>
2044<row>
2045 <entry>python-pyasn1</entry>
2046 <entry>0.3.6</entry>
2047 <entry>Python library implementing ASN.1 types..</entry>
2048 <entry>BSD-2-Clause</entry>
2049</row>
2050<row>
2051 <entry>python-pycparser</entry>
2052 <entry>2.18</entry>
2053 <entry>Parser of the C language written in pure Python.</entry>
2054 <entry>BSD-3-Clause</entry>
2055</row>
2056<row>
2057 <entry>python-pyopenssl</entry>
2058 <entry>17.3.0</entry>
2059 <entry>Simple Python wrapper around the OpenSSL library.</entry>
2060 <entry>Apache-2.0</entry>
2061</row>
2062<row>
2063 <entry>python-pysocks</entry>
2064 <entry>1.6.7</entry>
2065 <entry>A Python SOCKS client module</entry>
2066 <entry>BSD</entry>
2067</row>
2068<row>
2069 <entry>python-pytest-runner</entry>
2070 <entry>2.12.1</entry>
2071 <entry>Invoke py.test as distutils command with dependency resolution.</entry>
2072 <entry>MIT</entry>
2073</row>
2074<row>
2075 <entry>python-pytest</entry>
2076 <entry>3.2.2</entry>
2077 <entry>Simple powerful teting with python.</entry>
2078 <entry>MIT</entry>
2079</row>
2080<row>
2081 <entry>python-pyyaml</entry>
2082 <entry>3.11</entry>
2083 <entry> YAML is a data serialization format designed for human readability and interaction with scripting languages. PyYAML is a YAML parser and emitter for Python. . PyYAML features a complete YAML 1.1 parser Unicode support pickle support capable extension API and sensible error messages. PyYAML supports standard YAML tags and provides Python-specific tags that allow to represent an arbitrary Python object. . PyYAML is applicable for a broad range of tasks from complex configuration files to object serialization and persistance. </entry>
2084 <entry>MIT</entry>
2085</row>
2086<row>
2087 <entry>python-requests</entry>
2088 <entry>2.18.4</entry>
2089 <entry>Python HTTP for Humans.</entry>
2090 <entry>Apache-2.0</entry>
2091</row>
2092<row>
2093 <entry>python-rfc3987</entry>
2094 <entry>1.3.7</entry>
2095 <entry>Parsing and validation of URIs (RFC 3986) and IRIs (RFC 3987).</entry>
2096 <entry>GPL-3.0</entry>
2097</row>
2098<row>
2099 <entry>python-scons</entry>
2100 <entry>2.5.1</entry>
2101 <entry>Software Construction tool (make/autotools replacement).</entry>
2102 <entry>MIT</entry>
2103</row>
2104<row>
2105 <entry>python-setuptools-scm</entry>
2106 <entry>1.15.6</entry>
2107 <entry>the blessed package to manage your versions by scm tags.</entry>
2108 <entry>MIT</entry>
2109</row>
2110<row>
2111 <entry>python-setuptools</entry>
2112 <entry>36.2.7</entry>
2113 <entry>Download build install upgrade and uninstall Python packages.</entry>
2114 <entry>MIT</entry>
2115</row>
2116<row>
2117 <entry>python-six</entry>
2118 <entry>1.11.0</entry>
2119 <entry>Python 2 and 3 compatibility library.</entry>
2120 <entry>MIT</entry>
2121</row>
2122<row>
2123 <entry>python-strict-rfc3339</entry>
2124 <entry>0.7</entry>
2125 <entry>Strict simple lightweight RFC3339 function.s.</entry>
2126 <entry>GPL-3.0</entry>
2127</row>
2128<row>
2129 <entry>python-urllib3</entry>
2130 <entry>1.22</entry>
2131 <entry>Python HTTP library with thread-safe connection pooling file post support sanity friendly and more.</entry>
2132 <entry>MIT</entry>
2133</row>
2134<row>
2135 <entry>python-vcversioner</entry>
2136 <entry>2.16.0.0</entry>
2137 <entry>Python vcversioner automagically update the project's version.</entry>
2138 <entry>ISC</entry>
2139</row>
2140<row>
2141 <entry>python</entry>
2142 <entry>2.7.13</entry>
2143 <entry>The Python Programming Language.</entry>
2144 <entry>Python-2.0</entry>
2145</row>
2146<row>
2147 <entry>python3-netifaces</entry>
2148 <entry>0.10.6</entry>
2149 <entry>Portable network interface information.</entry>
2150 <entry>MIT</entry>
2151</row>
2152<row>
2153 <entry>python3-pip</entry>
2154 <entry>9.0.1</entry>
2155 <entry>The PyPA recommended tool for installing Python packages.</entry>
2156 <entry>MIT</entry>
2157</row>
2158<row>
2159 <entry>python3-setuptools</entry>
2160 <entry>36.2.7</entry>
2161 <entry>Download build install upgrade and uninstall Python packages.</entry>
2162 <entry>MIT</entry>
2163</row>
2164<row>
2165 <entry>python3-six</entry>
2166 <entry>1.10.0</entry>
2167 <entry>Python 2 and 3 compatibility library.</entry>
2168 <entry>MIT</entry>
2169</row>
2170<row>
2171 <entry>python3-twisted</entry>
2172 <entry>13.2.0</entry>
2173 <entry>Twisted is an event-driven networking framework written in Python and licensed under the LGPL. Twisted supports TCP UDP SSL/TLS multicast Unix sockets a large number of protocols (including HTTP NNTP IMAP SSH IRC FTP and others) and much more.</entry>
2174 <entry>MIT</entry>
2175</row>
2176<row>
2177 <entry>python3-zopeinterface</entry>
2178 <entry>4.4.3</entry>
2179 <entry>Interface definitions for Zope products.</entry>
2180 <entry>ZPL-2.1</entry>
2181</row>
2182<row>
2183 <entry>python3</entry>
2184 <entry>3.5.3</entry>
2185 <entry>The Python Programming Language.</entry>
2186 <entry>Python-2.0</entry>
2187</row>
2188<row>
2189 <entry>qemu-helper</entry>
2190 <entry>1.0</entry>
2191 <entry>Helper utilities needed by the runqemu script.</entry>
2192 <entry>GPL-2.0</entry>
2193</row>
2194<row>
2195 <entry>qemu</entry>
2196 <entry>2.11.1</entry>
2197 <entry>Fast open source processor emulator.</entry>
2198 <entry> GPL-2.0, LGPL-2.1</entry>
2199</row>
2200<row>
2201 <entry>qemuwrapper</entry>
2202 <entry>1.0</entry>
2203 <entry>QEMU wrapper script.</entry>
2204 <entry>MIT</entry>
2205</row>
2206<row>
2207 <entry>quilt</entry>
2208 <entry>0.65</entry>
2209 <entry>Tool for working with series of patches.</entry>
2210 <entry>GPL-2.0</entry>
2211</row>
2212<row>
2213 <entry>randrproto</entry>
2214 <entry>1.5.0</entry>
2215 <entry>This package provides the wire protocol for the X Resize Rotate and Reflect extension. This extension provides the ability to resize rotate and reflect the root window of a screen.</entry>
2216 <entry>MIT</entry>
2217</row>
2218<row>
2219 <entry>readline</entry>
2220 <entry>7.0</entry>
2221 <entry>The GNU Readline library provides a set of functions for use by applications that allow users to edit command lines as they are typed in. Both Emacs and vi editing modes are available. The Readline library includes additional functions to maintain a list of previously-entered command lines to recall and perhaps reedit those lines and perform csh-like history expansion on previous commands.</entry>
2222 <entry>GPL-3.0</entry>
2223</row>
2224<row>
2225 <entry>regexp</entry>
2226 <entry>1.5</entry>
2227 <entry>Java Regular Expression package</entry>
2228 <entry>Apache-2.0</entry>
2229</row>
2230<row>
2231 <entry>renderproto</entry>
2232 <entry>0.11.1</entry>
2233 <entry>This package provides the wire protocol for the X Rendering extension. This is the basis the image composition within the X window system.</entry>
2234 <entry>MIT</entry>
2235</row>
2236<row>
2237 <entry>rhino</entry>
2238 <entry>1.7r4</entry>
2239 <entry>Lexical analyzer generator for Java</entry>
2240 <entry>MPL-2.0</entry>
2241</row>
2242<row>
2243 <entry>rpm</entry>
2244 <entry>4.13.90</entry>
2245 <entry>The RPM Package Manager (RPM) is a powerful command line driven package management system capable of installing uninstalling verifying querying and updating software packages. Each software package consists of an archive of files along with information about the package like its version a description etc.</entry>
2246 <entry>GPL-2.0</entry>
2247</row>
2248<row>
2249 <entry>rsync</entry>
2250 <entry>3.1.3</entry>
2251 <entry>File synchronization tool.</entry>
2252 <entry>GPL-3.0</entry>
2253</row>
2254<row>
2255 <entry>run-postinsts</entry>
2256 <entry>1.0</entry>
2257 <entry>Runs postinstall scripts on first boot of the target device.</entry>
2258 <entry>MIT</entry>
2259</row>
2260<row>
2261 <entry>runc-docker</entry>
2262 <entry>1.0.0-rc3</entry>
2263 <entry>runc is a CLI tool for spawning and running containers according to the OCI specification.</entry>
2264 <entry>Apache-2.0</entry>
2265</row>
2266<row>
2267 <entry>sbsigntool</entry>
2268 <entry>0.6</entry>
2269 <entry>Utilities for signing UEFI binaries for use with secure boot.</entry>
2270 <entry>GPL-3.0</entry>
2271</row>
2272<row>
2273 <entry>sed</entry>
2274 <entry>4.2.2</entry>
2275 <entry>Stream EDitor (text filtering utility).</entry>
2276 <entry>GPL-3.0</entry>
2277</row>
2278<row>
2279 <entry>seloader</entry>
2280 <entry>0.4.6</entry>
2281 <entry>The SELoader is designed to authenticate the non-PE files such as grub configuration initrd grub modules which cannot be verified by the MOK Verify Protocol registered by shim loader. In order to conveniently authenticate the PE file with gBS-&gt;LoadImage() and gBS-&gt;StartImage() the SELoader hooks EFI Security2 Architectural Protocol and employs MOK Verify Protocol to verify the PE file. If only UEFI Secure Boot is enabled the SELoader just simplily calls gBS-&gt;LoadImage() and gBS-&gt;StartImage() to allow BIOS to verify PE file. The SELoader publishes MOK2 Verify Protocol which provides a flexible interface to allow the bootloader to verify the file file buffer or memory buffer without knowing the file format. </entry>
2282 <entry>BSD-3-Clause</entry>
2283</row>
2284<row>
2285 <entry>serf</entry>
2286 <entry>1.3.9</entry>
2287 <entry>High-Performance Asynchronous HTTP Client Library.</entry>
2288 <entry>Apache-2.0</entry>
2289</row>
2290<row>
2291 <entry>servlet2.3</entry>
2292 <entry>4.1.37</entry>
2293 <entry>Servlet API 2.3 (from Tomcat 4.1)</entry>
2294 <entry>Apache-2.0</entry>
2295</row>
2296<row>
2297 <entry>shadow-securetty</entry>
2298 <entry>4.2.1</entry>
2299 <entry>Provider of the machine specific securetty file.</entry>
2300 <entry>MIT</entry>
2301</row>
2302<row>
2303 <entry>shadow-sysroot</entry>
2304 <entry>4.2.1</entry>
2305 <entry>Shadow utils requirements for useradd.bbclass.</entry>
2306 <entry> BSD, Artistic-1.0</entry>
2307</row>
2308<row>
2309 <entry>shadow</entry>
2310 <entry>4.2.1</entry>
2311 <entry>Tools to change and administer password and group data.</entry>
2312 <entry> BSD, Artistic-1.0</entry>
2313</row>
2314<row>
2315 <entry>shared-mime-info</entry>
2316 <entry>1.8</entry>
2317 <entry>Shared MIME type database and specification.</entry>
2318 <entry>LGPL-2.0</entry>
2319</row>
2320<row>
2321 <entry>shim</entry>
2322 <entry>12</entry>
2323 <entry>shim is a trivial EFI application that when run attempts to open and execute another application. It will initially attempt to do this via the standard EFI LoadImage() and StartImage() calls. If these fail (because secure boot is enabled and the binary is not signed with an appropriate key for instance) it will then validate the binary against a built-in certificate. If this succeeds and if the binary or signing key are not blacklisted then shim will relocate and execute the binary.</entry>
2324 <entry>BSD-2-Clause</entry>
2325</row>
2326<row>
2327 <entry>simpleproxy</entry>
2328 <entry>1.0</entry>
2329 <entry>Simpleproxy.</entry>
2330 <entry>GPL-2.0</entry>
2331</row>
2332<row>
2333 <entry>slang</entry>
2334 <entry>2.3.1a</entry>
2335 <entry>S-Lang is an interpreted language and a programming library. The S-Lang language was designed so that it can be easily embedded into a program to provide the program with a powerful extension language. The S-Lang library provided in this package provides the S-Lang extension language. S-Lang's syntax resembles C which makes it easy to recode S-Lang procedures in C if you need to.</entry>
2336 <entry>GPL-2.0</entry>
2337</row>
2338<row>
2339 <entry>sqlite3</entry>
2340 <entry>3.20.0</entry>
2341 <entry>Embeddable SQL database engine.</entry>
2342 <entry>PD</entry>
2343</row>
2344<row>
2345 <entry>squashfs-tools</entry>
2346 <entry>4.3</entry>
2347 <entry>Tools for manipulating SquashFS filesystems.</entry>
2348 <entry> GPL-2.0, PD</entry>
2349</row>
2350<row>
2351 <entry>sshpass</entry>
2352 <entry>1.06</entry>
2353 <entry>Tool for non-interactivly performing ssh password authentication</entry>
2354 <entry>GPL-2.0</entry>
2355</row>
2356<row>
2357 <entry>subversion</entry>
2358 <entry>1.9.6</entry>
2359 <entry>Subversion (svn) version control system client.</entry>
2360 <entry>Apache-2.0</entry>
2361</row>
2362<row>
2363 <entry>swig</entry>
2364 <entry>3.0.12</entry>
2365 <entry>SWIG - Simplified Wrapper and Interface Generator.</entry>
2366 <entry> BSD, GPL-3.0</entry>
2367</row>
2368<row>
2369 <entry>sysfsutils</entry>
2370 <entry>2.1.0</entry>
2371 <entry>Tools for working with the sysfs virtual filesystem. The tool 'systool' can query devices by bus class and topology.</entry>
2372 <entry> GPL-2.0, LGPL-2.1</entry>
2373</row>
2374<row>
2375 <entry>sysklogd</entry>
2376 <entry>1.5.1</entry>
2377 <entry>The sysklogd package implements two system log daemons: syslogd klogd</entry>
2378 <entry> GPL-2.0, BSD</entry>
2379</row>
2380<row>
2381 <entry>syslinux</entry>
2382 <entry>6.03</entry>
2383 <entry>Multi-purpose linux bootloader.</entry>
2384 <entry>GPL-2.0</entry>
2385</row>
2386<row>
2387 <entry>systemd-boot</entry>
2388 <entry>234</entry>
2389 <entry>systemd is a system and service manager for Linux compatible with SysV and LSB init scripts. systemd provides aggressive parallelization capabilities uses socket and D-Bus activation for starting services offers on-demand starting of daemons keeps track of processes using Linux cgroups supports snapshotting and restoring of the system state maintains mount and automount points and implements an elaborate transactional dependency-based service control logic. It can work as a drop-in replacement for sysvinit.</entry>
2390 <entry> GPL-2.0, LGPL-2.1</entry>
2391</row>
2392<row>
2393 <entry>systemd-compat-units</entry>
2394 <entry>1.0</entry>
2395 <entry>Enhances systemd compatilibity with existing SysVinit scripts.</entry>
2396 <entry>MIT</entry>
2397</row>
2398<row>
2399 <entry>systemd-serialgetty</entry>
2400 <entry>1.0</entry>
2401 <entry>Serial terminal support for systemd.</entry>
2402 <entry>GPL-2.0</entry>
2403</row>
2404<row>
2405 <entry>systemd-systemctl</entry>
2406 <entry>1.0</entry>
2407 <entry>Wrapper for enabling systemd services.</entry>
2408 <entry>MIT</entry>
2409</row>
2410<row>
2411 <entry>systemd</entry>
2412 <entry>234</entry>
2413 <entry>systemd is a system and service manager for Linux compatible with SysV and LSB init scripts. systemd provides aggressive parallelization capabilities uses socket and D-Bus activation for starting services offers on-demand starting of daemons keeps track of processes using Linux cgroups supports snapshotting and restoring of the system state maintains mount and automount points and implements an elaborate transactional dependency-based service control logic. It can work as a drop-in replacement for sysvinit.</entry>
2414 <entry> GPL-2.0, LGPL-2.1</entry>
2415</row>
2416<row>
2417 <entry>tar</entry>
2418 <entry>1.29</entry>
2419 <entry>GNU tar saves many files together into a single tape or disk archive and can restore individual files from the archive.</entry>
2420 <entry>GPL-3.0</entry>
2421</row>
2422<row>
2423 <entry>tcl</entry>
2424 <entry>8.6.7</entry>
2425 <entry>Tool Command Language.</entry>
2426 <entry> tcl, BSD-3-Clause</entry>
2427</row>
2428<row>
2429 <entry>tcpdump</entry>
2430 <entry>4.9.2</entry>
2431 <entry>A sophisticated network protocol analyzer.</entry>
2432 <entry>BSD</entry>
2433</row>
2434<row>
2435 <entry>texinfo-dummy</entry>
2436 <entry>1.0</entry>
2437 <entry>Fake version of the texinfo utility suite.</entry>
2438 <entry>MIT</entry>
2439</row>
2440<row>
2441 <entry>thin-provisioning-tools</entry>
2442 <entry>0.6.3</entry>
2443 <entry>A suite of tools for manipulating the metadata of the dm-thin device-mapper target.</entry>
2444 <entry>GPL-3.0</entry>
2445</row>
2446<row>
2447 <entry>tunctl</entry>
2448 <entry>1.5</entry>
2449 <entry>Tool for controlling the Linux TUN/TAP driver.</entry>
2450 <entry>GPL-2.0</entry>
2451</row>
2452<row>
2453 <entry>tzcode</entry>
2454 <entry>2018c</entry>
2455 <entry>tzcode timezone zoneinfo utils -- zic zdump tzselect.</entry>
2456 <entry> PD, BSD, BSD-3-Clause</entry>
2457</row>
2458<row>
2459 <entry>tzdata</entry>
2460 <entry>2018c</entry>
2461 <entry>Timezone data.</entry>
2462 <entry> PD, BSD, BSD-3-Clause</entry>
2463</row>
2464<row>
2465 <entry>udev-extraconf</entry>
2466 <entry>1.1</entry>
2467 <entry>Extra machine specific configuration files for udev specifically blacklist information.</entry>
2468 <entry>MIT</entry>
2469</row>
2470<row>
2471 <entry>unifdef</entry>
2472 <entry>2.11</entry>
2473 <entry>Selectively remove #ifdef statements from sources.</entry>
2474 <entry>BSD-2-Clause</entry>
2475</row>
2476<row>
2477 <entry>unzip</entry>
2478 <entry>6.0</entry>
2479 <entry>Utilities for extracting and viewing files in .zip archives.</entry>
2480 <entry>BSD-3-Clause</entry>
2481</row>
2482<row>
2483 <entry>update-rc.d</entry>
2484 <entry>0.7</entry>
2485 <entry>update-rc.d is a utility that allows the management of symlinks to the initscripts in the /etc/rcN.d directory structure.</entry>
2486 <entry>GPL-2.0</entry>
2487</row>
2488<row>
2489 <entry>usb-modeswitch-data</entry>
2490 <entry>20170205</entry>
2491 <entry>Data files for usbmodeswitch.</entry>
2492 <entry>GPL-2.0</entry>
2493</row>
2494<row>
2495 <entry>usb-modeswitch</entry>
2496 <entry>2.5.0</entry>
2497 <entry>A mode switching tool for controlling 'flip flop' (multiple device) USB gear.</entry>
2498 <entry>GPL-2.0</entry>
2499</row>
2500<row>
2501 <entry>usbutils</entry>
2502 <entry>008</entry>
2503 <entry>Contains the lsusb utility for inspecting the devices connected to the USB bus.</entry>
2504 <entry>GPL-2.0</entry>
2505</row>
2506<row>
2507 <entry>util-linux</entry>
2508 <entry>2.30</entry>
2509 <entry>Util-linux includes a suite of basic system administration utilities commonly found on most Linux systems. Some of the more important utilities include disk partitioning kernel message management filesystem creation and system login.</entry>
2510 <entry> GPL-2.0, LGPL-2.1, BSD</entry>
2511</row>
2512<row>
2513 <entry>util-macros</entry>
2514 <entry>1.19.1</entry>
2515 <entry>M4 autotools macros used by various X.org programs.</entry>
2516 <entry> MIT</entry>
2517</row>
2518<row>
2519 <entry>v86d</entry>
2520 <entry>0.1.10</entry>
2521 <entry>User support binary for the uvesafb kernel module.</entry>
2522 <entry>GPL-2.0</entry>
2523</row>
2524<row>
2525 <entry>vala</entry>
2526 <entry>0.36.4</entry>
2527 <entry>Vala is a C#-like language dedicated to ease GObject programming. Vala compiles to plain C and has no runtime environment nor penalities whatsoever.</entry>
2528 <entry>LGPL-2.1</entry>
2529</row>
2530<row>
2531 <entry>volatile-binds</entry>
2532 <entry>1.0</entry>
2533 <entry>Volatile bind mount setup and configuration for read-only-rootfs</entry>
2534 <entry>MIT</entry>
2535</row>
2536<row>
2537 <entry>which</entry>
2538 <entry>2.21</entry>
2539 <entry>Which is a utility that prints out the full path of the executables that bash(1) would execute when the passed program names would have been entered on the shell prompt. It does this by using the exact same algorithm as bash.</entry>
2540 <entry>GPL-3.0</entry>
2541</row>
2542<row>
2543 <entry>wpa-supplicant</entry>
2544 <entry>2.6</entry>
2545 <entry>Client for Wi-Fi Protected Access (WPA).</entry>
2546 <entry>BSD</entry>
2547</row>
2548<row>
2549 <entry>xalan-j</entry>
2550 <entry>2.7.1</entry>
2551 <entry>Java XSLT processor</entry>
2552 <entry>Apache-2.0</entry>
2553</row>
2554<row>
2555 <entry>xcb-proto</entry>
2556 <entry>1.12</entry>
2557 <entry>Function prototypes for the X protocol C-language Binding (XCB). XCB is a replacement for Xlib featuring a small footprint latency hiding direct access to the protocol improved threading support and extensibility.</entry>
2558 <entry>MIT</entry>
2559</row>
2560<row>
2561 <entry>xerces-j</entry>
2562 <entry>2.11.0</entry>
2563 <entry>Reference implementation of XNI the Xerces Native Interface and also a fully conforming XML Schema processor.</entry>
2564 <entry>Apache-2.0</entry>
2565</row>
2566<row>
2567 <entry>xextproto</entry>
2568 <entry>7.3.0</entry>
2569 <entry>This package provides the wire protocol for several X extensions. These protocol extensions include DOUBLE-BUFFER DPMS Extended-Visual-Information LBX MIT_SHM MIT_SUNDRY-NONSTANDARD Multi-Buffering SECURITY SHAPE SYNC TOG-CUP XC-APPGROUP XC-MISC XTEST. In addition a small set of utility functions are also available.</entry>
2570 <entry> MIT</entry>
2571</row>
2572<row>
2573 <entry>xkeyboard-config</entry>
2574 <entry>2.21</entry>
2575 <entry>The non-arch keyboard configuration database for X Window. The goal is to provide the consistent well-structured frequently released open source of X keyboard configuration data for X Window System implementations. The project is targeted to XKB-based systems.</entry>
2576 <entry> MIT</entry>
2577</row>
2578<row>
2579 <entry>xml-commons-resolver1.1</entry>
2580 <entry>1.2</entry>
2581 <entry>Library to resolve various public or system identifiers into accessible URLs (Java)</entry>
2582 <entry>Apache-2.0</entry>
2583</row>
2584<row>
2585 <entry>xproto</entry>
2586 <entry>7.0.31</entry>
2587 <entry>This package provides the basic headers for the X Window System.</entry>
2588 <entry> MIT</entry>
2589</row>
2590<row>
2591 <entry>xtrans</entry>
2592 <entry>1.3.5</entry>
2593 <entry>The X Transport Interface is intended to combine all system and transport specific code into a single place. This API should be used by all libraries clients and servers of the X Window System. Use of this API should allow the addition of new types of transports and support for new platforms without making any changes to the source except in the X Transport Interface code.</entry>
2594 <entry> MIT</entry>
2595</row>
2596<row>
2597 <entry>xz</entry>
2598 <entry>5.2.3</entry>
2599 <entry>Utilities for managing LZMA compressed files.</entry>
2600 <entry> GPL-2.0, GPL-3.0-with-autoconf-exception, LGPL-2.1, PD</entry>
2601</row>
2602<row>
2603 <entry>yajl</entry>
2604 <entry>2.1.0</entry>
2605 <entry>YAJL is a small event-driven (SAX-style) JSON parser written in ANSI C and a small validating JSON generator.</entry>
2606 <entry>ISC</entry>
2607</row>
2608<row>
2609 <entry>zip</entry>
2610 <entry>3.0</entry>
2611 <entry>Compressor/archiver for creating and modifying .zip files.</entry>
2612 <entry>BSD-3-Clause</entry>
2613</row>
2614<row>
2615 <entry>zisofs-tools</entry>
2616 <entry>1.0.8</entry>
2617 <entry>Utilities for creating compressed CD-ROM filesystems.</entry>
2618 <entry>GPL-2.0</entry>
2619</row>
2620<row>
2621 <entry>zlib</entry>
2622 <entry>1.2.11</entry>
2623 <entry>Zlib is a general-purpose patent-free lossless data compression library which is used by many different programs.</entry>
2624 <entry>Zlib</entry>
2625</row>
2626 </tbody>
2627 </tgroup>
2628 </informaltable>
2629 </section>
2630 <section id="open_source_license">
2631 <title>Open Source Licenses</title>
2632<section id="lic_0">
2633<title>AFL-2.0</title>
2634<para><programlisting>
2635
2636The Academic Free License
2637 v. 2.0
2638
2639This Academic Free License (the "License") applies to any original work of authorship
2640(the "Original Work") whose owner (the "Licensor") has placed the following notice
2641immediately following the copyright notice for the Original Work:
2642Licensed under the Academic Free License version 2.0
2643
26441) Grant of Copyright License. Licensor hereby grants You a world-wide, royalty-free,
2645non-exclusive, perpetual, sublicenseable license to do the following:
2646a) to reproduce the Original Work in copies;
2647
2648b) to prepare derivative works ("Derivative Works") based upon the Original Work;
2649
2650c) to distribute copies of the Original Work and Derivative Works to the public;
2651
2652d) to perform the Original Work publicly; and
2653
2654e) to display the Original Work publicly.
2655
26562) Grant of Patent License. Licensor hereby grants You a world-wide, royalty-free,
2657non-exclusive, perpetual, sublicenseable license, under patent claims owned or
2658controlled by the Licensor that are embodied in the Original Work as furnished by the
2659Licensor, to make, use, sell and offer for sale the Original Work and Derivative
2660Works.
2661
26623) Grant of Source Code License. The term "Source Code" means the preferred form of
2663the Original Work for making modifications to it and all available documentation
2664describing how to modify the Original Work. Licensor hereby agrees to provide a
2665machine-readable copy of the Source Code of the Original Work along with each copy of
2666the Original Work that Licensor distributes. Licensor reserves the right to satisfy
2667this obligation by placing a machine-readable copy of the Source Code in an
2668information repository reasonably calculated to permit inexpensive and convenient
2669access by You for as long as Licensor continues to distribute the Original Work, and
2670by publishing the address of that information repository in a notice immediately
2671following the copyright notice that applies to the Original Work.
2672
26734) Exclusions From License Grant. Neither the names of Licensor, nor the names of any
2674contributors to the Original Work, nor any of their trademarks or service marks, may
2675be used to endorse or promote products derived from this Original Work without express
2676prior written permission of the Licensor. Nothing in this License shall be deemed to
2677grant any rights to trademarks, copyrights, patents, trade secrets or any other
2678intellectual property of Licensor except as expressly stated herein. No patent
2679license is granted to make, use, sell or offer to sell embodiments of any patent
2680claims other than the licensed claims defined in Section 2. No right is granted to
2681the trademarks of Licensor even if such marks are included in the Original Work.
2682Nothing in this License shall be interpreted to prohibit Licensor from licensing under
2683different terms from this License any Original Work that Licensor otherwise would have
2684a right to license.
2685
26865) This section intentionally omitted.
2687
26886) Attribution Rights. You must retain, in the Source Code of any Derivative Works
2689that You create, all copyright, patent or trademark notices from the Source Code of
2690the Original Work, as well as any notices of licensing and any descriptive text
2691identified therein as an "Attribution Notice." You must cause the Source Code for any
2692Derivative Works that You create to carry a prominent Attribution Notice reasonably
2693calculated to inform recipients that You have modified the Original Work.
2694
26957) Warranty of Provenance and Disclaimer of Warranty. Licensor warrants that the
2696copyright in and to the Original Work and the patent rights granted herein by Licensor
2697are owned by the Licensor or are sublicensed to You under the terms of this License
2698with the permission of the contributor(s) of those copyrights and patent rights.
2699Except as expressly stated in the immediately proceeding sentence, the Original Work
2700is provided under this License on an "AS IS" BASIS and WITHOUT WARRANTY, either
2701express or implied, including, without limitation, the warranties of NON-INFRINGEMENT,
2702MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
2703QUALITY OF THE ORIGINAL WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an
2704essential part of this License. No license to Original Work is granted hereunder
2705except under this disclaimer.
2706
27078) Limitation of Liability. Under no circumstances and under no legal theory, whether
2708in tort (including negligence), contract, or otherwise, shall the Licensor be liable
2709to any person for any direct, indirect, special, incidental, or consequential damages
2710of any character arising as a result of this License or the use of the Original Work
2711including, without limitation, damages for loss of goodwill, work stoppage, computer
2712failure or malfunction, or any and all other commercial damages or losses. This
2713limitation of liability shall not apply to liability for death or personal injury
2714resulting from Licensor`s negligence to the extent applicable law prohibits such
2715limitation. Some jurisdictions do not allow the exclusion or limitation of incidental
2716or consequential damages, so this exclusion and limitation may not apply to You.
2717
27189) Acceptance and Termination. If You distribute copies of the Original Work or a
2719Derivative Work, You must make a reasonable effort under the circumstances to obtain
2720the express assent of recipients to the terms of this License. Nothing else but this
2721License (or another written agreement between Licensor and You) grants You permission
2722to create Derivative Works based upon the Original Work or to exercise any of the
2723rights granted in Section 1 herein, and any attempt to do so except under the terms of
2724this License (or another written agreement between Licensor and You) is expressly
2725prohibited by U.S. copyright law, the equivalent laws of other countries, and by
2726international treaty. Therefore, by exercising any of the rights granted to You in
2727Section 1 herein, You indicate Your acceptance of this License and all of its terms
2728and conditions.
2729
273010) Termination for Patent Action. This License shall terminate automatically and You
2731may no longer exercise any of the rights granted to You by this License as of the date
2732You commence an action, including a cross-claim or counterclaim, for patent
2733infringement (i) against Licensor with respect to a patent applicable to software or
2734(ii) against any entity with respect to a patent applicable to the Original Work (but
2735excluding combinations of the Original Work with other software or hardware).
2736
273711) Jurisdiction, Venue and Governing Law. Any action or suit relating to this License
2738may be brought only in the courts of a jurisdiction wherein the Licensor resides or in
2739which Licensor conducts its primary business, and under the laws of that jurisdiction
2740excluding its conflict-of-law provisions. The application of the United Nations
2741Convention on Contracts for the International Sale of Goods is expressly excluded.
2742Any use of the Original Work outside the scope of this License or after its
2743termination shall be subject to the requirements and penalties of the U.S. Copyright
2744Act, 17 U.S.C. ¤ 101 et seq., the equivalent laws of other countries, and
2745international treaty. This section shall survive the termination of this License.
2746
274712) Attorneys Fees. In any action to enforce the terms of this License or seeking
2748damages relating thereto, the prevailing party shall be entitled to recover its costs
2749and expenses, including, without limitation, reasonable attorneys` fees and costs
2750incurred in connection with such action, including any appeal of such action. This
2751section shall survive the termination of this License.
2752
275313) Miscellaneous. This License represents the complete agreement concerning the
2754subject matter hereof. If any provision of this License is held to be unenforceable,
2755such provision shall be reformed only to the extent necessary to make it enforceable.
2756
275714) Definition of "You" in This License. "You" throughout this License, whether in
2758upper or lower case, means an individual or a legal entity exercising rights under,
2759and complying with all of the terms of, this License. For legal entities, "You"
2760includes any entity that controls, is controlled by, or is under common control with
2761you. For purposes of this definition, "control" means (i) the power, direct or
2762indirect, to cause the direction or management of such entity, whether by contract or
2763otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares,
2764or (iii) beneficial ownership of such entity.
2765
276615) Right to Use. You may use the Original Work in all ways not otherwise restricted
2767or conditioned by this License or by law, and Licensor promises not to interfere with
2768or be responsible for such uses by You.
2769
2770This license is Copyright (C) 2003 Lawrence E. Rosen. All rights reserved.
2771Permission is hereby granted to copy and distribute this license without modification.
2772This license may not be modified without the express written permission of its
2773copyright owner.
2774
2775</programlisting></para></section>
2776
2777<section id="lic_1">
2778<title>AMD</title>
2779<para><programlisting>
2780� 2005 Advanced Micro Devices, Inc. All rights reserved.
2781
2782Redistribution and use in source and binary forms, with or without
2783modification, are permitted provided that existing copyright notices
2784are retained in all copies, this notice is included verbatim in any
2785distributions, and the terms and conditions hererin are met.
2786
2787Use of the this software manifests acceptance of the terms of this
2788license by performance.
2789
2790The name of Advanced Micro Devices, Inc. may not be used to endorse or
2791promote products derived from this software without specific prior
2792written permission.
2793
2794THIS SOFTWARE IS PROVIDED BY ADVANCED MICRO DEVICES, INC. "AS IS" AND ANY
2795EXPRESS, IMPLIED OR STATUTORY WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
2796THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
2797PURPOSE AND NON-INFRINGEMENT, OR THOSE ARISING FROM CUSTOM OF TRADE OR
2798COURSE OF USAGE ARE DISCLAIMED.
2799
2800IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY DIRECT,
2801INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
2802(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
2803SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
2804CAUSED, AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2805LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2806OUT OF THE USE OF THIS SOFTWARE ITS DOCUMENTATION OR ANY DERIVATIVES
2807THEREOF, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. BY USING THIS
2808SOFTWARE WITHOUT CHARGE, YOU ACCEPT THIS ALLOCATION OF RISK. THIS
2809DISCLAIMER OF LIABILITY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE.
2810ADVANCED MICRO DEVICES, INC. HAS NO OBLIGATION TO PROVIDE MAINTENANCE,
2811SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS OF THIS SOFTWARE.
2812
2813In the redistribution and use of this software, each party shall at all
2814times comply with all applicable governmental laws, statutes, ordinances,
2815rules, regulations, orders, and other requirements, including without
2816limitation such governmental requirements applicable to environmental
2817protection, health, safety, wages, hours, equal employment opportunity,
2818nondiscrimination, working conditions, import or export control, and
2819transportation. Without limiting the foregoing, each party shall adhere
2820to the U.S. Export Administration Regulations (EAR), currently found at
282115 C.F.R. Sections 730 through 744, and, unless properly authorized by
2822the U.S. Government, shall not (1) export, re-export or release restricted
2823technology, software, or source code to a national of a country in Country
2824Groups D:1 or E:1, or (2) export to Country Groups D:1 or E:1 the direct
2825product of such technology or software, if such foreign produced direct
2826product is subject to national security controls as identified on the
2827Commerce Control List (currently found in Supplement 1 to Section 774 of EAR).
2828These export requirements shall survive any expiration or termination
2829of this agreement.
2830</programlisting></para></section>
2831
2832<section id="lic_2">
2833<title>Apache-2.0</title>
2834<para><programlisting>
2835
2836
2837 Apache License
2838 Version 2.0, January 2004
2839 http://www.apache.org/licenses/
2840
2841 TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
2842
2843 1. Definitions.
2844
2845 "License" shall mean the terms and conditions for use, reproduction,
2846 and distribution as defined by Sections 1 through 9 of this document.
2847
2848 "Licensor" shall mean the copyright owner or entity authorized by
2849 the copyright owner that is granting the License.
2850
2851 "Legal Entity" shall mean the union of the acting entity and all
2852 other entities that control, are controlled by, or are under common
2853 control with that entity. For the purposes of this definition,
2854 "control" means (i) the power, direct or indirect, to cause the
2855 direction or management of such entity, whether by contract or
2856 otherwise, or (ii) ownership of fifty percent (50%) or more of the
2857 outstanding shares, or (iii) beneficial ownership of such entity.
2858
2859 "You" (or "Your") shall mean an individual or Legal Entity
2860 exercising permissions granted by this License.
2861
2862 "Source" form shall mean the preferred form for making modifications,
2863 including but not limited to software source code, documentation
2864 source, and configuration files.
2865
2866 "Object" form shall mean any form resulting from mechanical
2867 transformation or translation of a Source form, including but
2868 not limited to compiled object code, generated documentation,
2869 and conversions to other media types.
2870
2871 "Work" shall mean the work of authorship, whether in Source or
2872 Object form, made available under the License, as indicated by a
2873 copyright notice that is included in or attached to the work
2874 (an example is provided in the Appendix below).
2875
2876 "Derivative Works" shall mean any work, whether in Source or Object
2877 form, that is based on (or derived from) the Work and for which the
2878 editorial revisions, annotations, elaborations, or other modifications
2879 represent, as a whole, an original work of authorship. For the purposes
2880 of this License, Derivative Works shall not include works that remain
2881 separable from, or merely link (or bind by name) to the interfaces of,
2882 the Work and Derivative Works thereof.
2883
2884 "Contribution" shall mean any work of authorship, including
2885 the original version of the Work and any modifications or additions
2886 to that Work or Derivative Works thereof, that is intentionally
2887 submitted to Licensor for inclusion in the Work by the copyright owner
2888 or by an individual or Legal Entity authorized to submit on behalf of
2889 the copyright owner. For the purposes of this definition, "submitted"
2890 means any form of electronic, verbal, or written communication sent
2891 to the Licensor or its representatives, including but not limited to
2892 communication on electronic mailing lists, source code control systems,
2893 and issue tracking systems that are managed by, or on behalf of, the
2894 Licensor for the purpose of discussing and improving the Work, but
2895 excluding communication that is conspicuously marked or otherwise
2896 designated in writing by the copyright owner as "Not a Contribution."
2897
2898 "Contributor" shall mean Licensor and any individual or Legal Entity
2899 on behalf of whom a Contribution has been received by Licensor and
2900 subsequently incorporated within the Work.
2901
2902 2. Grant of Copyright License. Subject to the terms and conditions of
2903 this License, each Contributor hereby grants to You a perpetual,
2904 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
2905 copyright license to reproduce, prepare Derivative Works of,
2906 publicly display, publicly perform, sublicense, and distribute the
2907 Work and such Derivative Works in Source or Object form.
2908
2909 3. Grant of Patent License. Subject to the terms and conditions of
2910 this License, each Contributor hereby grants to You a perpetual,
2911 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
2912 (except as stated in this section) patent license to make, have made,
2913 use, offer to sell, sell, import, and otherwise transfer the Work,
2914 where such license applies only to those patent claims licensable
2915 by such Contributor that are necessarily infringed by their
2916 Contribution(s) alone or by combination of their Contribution(s)
2917 with the Work to which such Contribution(s) was submitted. If You
2918 institute patent litigation against any entity (including a
2919 cross-claim or counterclaim in a lawsuit) alleging that the Work
2920 or a Contribution incorporated within the Work constitutes direct
2921 or contributory patent infringement, then any patent licenses
2922 granted to You under this License for that Work shall terminate
2923 as of the date such litigation is filed.
2924
2925 4. Redistribution. You may reproduce and distribute copies of the
2926 Work or Derivative Works thereof in any medium, with or without
2927 modifications, and in Source or Object form, provided that You
2928 meet the following conditions:
2929
2930 (a) You must give any other recipients of the Work or
2931 Derivative Works a copy of this License; and
2932
2933 (b) You must cause any modified files to carry prominent notices
2934 stating that You changed the files; and
2935
2936 (c) You must retain, in the Source form of any Derivative Works
2937 that You distribute, all copyright, patent, trademark, and
2938 attribution notices from the Source form of the Work,
2939 excluding those notices that do not pertain to any part of
2940 the Derivative Works; and
2941
2942 (d) If the Work includes a "NOTICE" text file as part of its
2943 distribution, then any Derivative Works that You distribute must
2944 include a readable copy of the attribution notices contained
2945 within such NOTICE file, excluding those notices that do not
2946 pertain to any part of the Derivative Works, in at least one
2947 of the following places: within a NOTICE text file distributed
2948 as part of the Derivative Works; within the Source form or
2949 documentation, if provided along with the Derivative Works; or,
2950 within a display generated by the Derivative Works, if and
2951 wherever such third-party notices normally appear. The contents
2952 of the NOTICE file are for informational purposes only and
2953 do not modify the License. You may add Your own attribution
2954 notices within Derivative Works that You distribute, alongside
2955 or as an addendum to the NOTICE text from the Work, provided
2956 that such additional attribution notices cannot be construed
2957 as modifying the License.
2958
2959 You may add Your own copyright statement to Your modifications and
2960 may provide additional or different license terms and conditions
2961 for use, reproduction, or distribution of Your modifications, or
2962 for any such Derivative Works as a whole, provided Your use,
2963 reproduction, and distribution of the Work otherwise complies with
2964 the conditions stated in this License.
2965
2966 5. Submission of Contributions. Unless You explicitly state otherwise,
2967 any Contribution intentionally submitted for inclusion in the Work
2968 by You to the Licensor shall be under the terms and conditions of
2969 this License, without any additional terms or conditions.
2970 Notwithstanding the above, nothing herein shall supersede or modify
2971 the terms of any separate license agreement you may have executed
2972 with Licensor regarding such Contributions.
2973
2974 6. Trademarks. This License does not grant permission to use the trade
2975 names, trademarks, service marks, or product names of the Licensor,
2976 except as required for reasonable and customary use in describing the
2977 origin of the Work and reproducing the content of the NOTICE file.
2978
2979 7. Disclaimer of Warranty. Unless required by applicable law or
2980 agreed to in writing, Licensor provides the Work (and each
2981 Contributor provides its Contributions) on an "AS IS" BASIS,
2982 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
2983 implied, including, without limitation, any warranties or conditions
2984 of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
2985 PARTICULAR PURPOSE. You are solely responsible for determining the
2986 appropriateness of using or redistributing the Work and assume any
2987 risks associated with Your exercise of permissions under this License.
2988
2989 8. Limitation of Liability. In no event and under no legal theory,
2990 whether in tort (including negligence), contract, or otherwise,
2991 unless required by applicable law (such as deliberate and grossly
2992 negligent acts) or agreed to in writing, shall any Contributor be
2993 liable to You for damages, including any direct, indirect, special,
2994 incidental, or consequential damages of any character arising as a
2995 result of this License or out of the use or inability to use the
2996 Work (including but not limited to damages for loss of goodwill,
2997 work stoppage, computer failure or malfunction, or any and all
2998 other commercial damages or losses), even if such Contributor
2999 has been advised of the possibility of such damages.
3000
3001 9. Accepting Warranty or Additional Liability. While redistributing
3002 the Work or Derivative Works thereof, You may choose to offer,
3003 and charge a fee for, acceptance of support, warranty, indemnity,
3004 or other liability obligations and/or rights consistent with this
3005 License. However, in accepting such obligations, You may act only
3006 on Your own behalf and on Your sole responsibility, not on behalf
3007 of any other Contributor, and only if You agree to indemnify,
3008 defend, and hold each Contributor harmless for any liability
3009 incurred by, or claims asserted against, such Contributor by reason
3010 of your accepting any such warranty or additional liability.
3011
3012 END OF TERMS AND CONDITIONS
3013
3014 APPENDIX: How to apply the Apache License to your work.
3015
3016 To apply the Apache License to your work, attach the following
3017 boilerplate notice, with the fields enclosed by brackets "[]"
3018 replaced with your own identifying information. (Don`t include
3019 the brackets!) The text should be enclosed in the appropriate
3020 comment syntax for the file format. We also recommend that a
3021 file or class name and description of purpose be included on the
3022 same "printed page" as the copyright notice for easier
3023 identification within third-party archives.
3024
3025 Copyright [yyyy] [name of copyright owner]
3026
3027 Licensed under the Apache License, Version 2.0 (the "License");
3028 you may not use this file except in compliance with the License.
3029 You may obtain a copy of the License at
3030
3031 http://www.apache.org/licenses/LICENSE-2.0
3032
3033 Unless required by applicable law or agreed to in writing, software
3034 distributed under the License is distributed on an "AS IS" BASIS,
3035 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
3036 See the License for the specific language governing permissions and
3037 limitations under the License.
3038
3039</programlisting></para></section>
3040
3041<section id="lic_3">
3042<title>Artistic-1.0</title>
3043<para><programlisting>
3044
3045The Artistic License
3046Preamble
3047
3048The intent of this document is to state the conditions under which a Package may be
3049copied, such that the Copyright Holder maintains some semblance of artistic control
3050over the development of the package, while giving the users of the package the right
3051to use and distribute the Package in a more-or-less customary fashion, plus the right
3052to make reasonable modifications.
3053
3054Definitions:
3055
3056"Package" refers to the collection of files distributed by the Copyright Holder, and
3057derivatives of that collection of files created through textual modification.
3058"Standard Version" refers to such a Package if it has not been modified, or has been
3059modified in accordance with the wishes of the Copyright Holder.
3060"Copyright Holder" is whoever is named in the copyright or copyrights for the package.
3061"You" is you, if you`re thinking about copying or distributing this Package.
3062"Reasonable copying fee" is whatever you can justify on the basis of media cost,
3063duplication charges, time of people involved, and so on. (You will not be required to
3064justify it to the Copyright Holder, but only to the computing community at large as a
3065market that must bear the fee.)
3066"Freely Available" means that no fee is charged for the item itself, though there may
3067be fees involved in handling the item. It also means that recipients of the item may
3068redistribute it under the same conditions they received it.
30691. You may make and give away verbatim copies of the source form of the Standard
3070Version of this Package without restriction, provided that you duplicate all of the
3071original copyright notices and associated disclaimers.
3072
30732. You may apply bug fixes, portability fixes and other modifications derived from the
3074Public Domain or from the Copyright Holder. A Package modified in such a way shall
3075still be considered the Standard Version.
3076
30773. You may otherwise modify your copy of this Package in any way, provided that you
3078insert a prominent notice in each changed file stating how and when you changed that
3079file, and provided that you do at least ONE of the following:
3080
3081a) place your modifications in the Public Domain or otherwise make them Freely
3082Available, such as by posting said modifications to Usenet or an equivalent medium, or
3083placing the modifications on a major archive site such as ftp.uu.net, or by allowing
3084the Copyright Holder to include your modifications in the Standard Version of the
3085Package.
3086
3087b) use the modified Package only within your corporation or organization.
3088
3089c) rename any non-standard executables so the names do not conflict with standard
3090executables, which must also be provided, and provide a separate manual page for each
3091non-standard executable that clearly documents how it differs from the Standard
3092Version.
3093
3094d) make other distribution arrangements with the Copyright Holder.
3095
30964. You may distribute the programs of this Package in object code or executable form,
3097provided that you do at least ONE of the following:
3098
3099a) distribute a Standard Version of the executables and library files, together with
3100instructions (in the manual page or equivalent) on where to get the Standard Version.
3101
3102b) accompany the distribution with the machine-readable source of the Package with
3103your modifications.
3104
3105c) accompany any non-standard executables with their corresponding Standard Version
3106executables, giving the non-standard executables non-standard names, and clearly
3107documenting the differences in manual pages (or equivalent), together with
3108instructions on where to get the Standard Version.
3109
3110d) make other distribution arrangements with the Copyright Holder.
3111
31125. You may charge a reasonable copying fee for any distribution of this Package. You
3113may charge any fee you choose for support of this Package. You may not charge a fee
3114for this Package itself. However, you may distribute this Package in aggregate with
3115other (possibly commercial) programs as part of a larger (possibly commercial)
3116software distribution provided that you do not advertise this Package as a product of
3117your own.
3118
31196. The scripts and library files supplied as input to or produced as output from the
3120programs of this Package do not automatically fall under the copyright of this
3121Package, but belong to whomever generated them, and may be sold commercially, and may
3122be aggregated with this Package.
3123
31247. C or perl subroutines supplied by you and linked into this Package shall not be
3125considered part of this Package.
3126
31278. The name of the Copyright Holder may not be used to endorse or promote products
3128derived from this software without specific prior written permission.
3129
31309. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,
3131INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS
3132FOR A PARTICULAR PURPOSE.
3133
3134The End
3135
3136</programlisting></para></section>
3137
3138<section id="lic_4">
3139<title>BSD</title>
3140<para><programlisting>
3141Copyright (c) The Regents of the University of California.
3142All rights reserved.
3143
3144Redistribution and use in source and binary forms, with or without
3145modification, are permitted provided that the following conditions
3146are met:
31471. Redistributions of source code must retain the above copyright
3148 notice, this list of conditions and the following disclaimer.
31492. Redistributions in binary form must reproduce the above copyright
3150 notice, this list of conditions and the following disclaimer in the
3151 documentation and/or other materials provided with the distribution.
31523. Neither the name of the University nor the names of its contributors
3153 may be used to endorse or promote products derived from this software
3154 without specific prior written permission.
3155
3156THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
3157ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
3158IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
3159ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
3160FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
3161DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
3162OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
3163HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
3164LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
3165OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3166SUCH DAMAGE.
3167</programlisting></para></section>
3168
3169<section id="lic_5">
3170<title>BSD-2-Clause</title>
3171<para><programlisting>
3172
3173The FreeBSD Copyright
3174
3175Copyright 1992-2010 The FreeBSD Project. All rights reserved.
3176
3177Redistribution and use in source and binary forms, with or without modification, are
3178permitted provided that the following conditions are met:
3179
3180Redistributions of source code must retain the above copyright notice, this list of
3181conditions and the following disclaimer.
3182Redistributions in binary form must reproduce the above copyright notice, this list of
3183conditions and the following disclaimer in the documentation and/or other materials
3184provided with the distribution.
3185THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS`` AND ANY EXPRESS OR IMPLIED
3186WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
3187AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD
3188PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
3189EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
3190SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
3191HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
3192OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
3193SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3194
3195The views and conclusions contained in the software and documentation are those of the
3196authors and should not be interpreted as representing official policies, either
3197expressed or implied, of the FreeBSD Project.
3198
3199</programlisting></para></section>
3200
3201<section id="lic_6">
3202<title>BSD-3-Clause</title>
3203<para><programlisting>
3204
3205Copyright (c) &lt;YEAR&gt;, &lt;OWNER&gt;
3206All rights reserved.
3207
3208Redistribution and use in source and binary forms, with or without modification, are
3209permitted provided that the following conditions are met:
3210
3211Redistributions of source code must retain the above copyright notice, this list of
3212conditions and the following disclaimer.
3213Redistributions in binary form must reproduce the above copyright notice, this list of
3214conditions and the following disclaimer in the documentation and/or other materials
3215provided with the distribution.
3216Neither the name of the &lt;ORGANIZATION&gt; nor the names of its contributors may be
3217used to endorse or promote products derived from this software without specific prior
3218written permission.
3219THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
3220EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
3221OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
3222SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
3223INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
3224TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
3225BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
3226CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
3227WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
3228DAMAGE.
3229
3230</programlisting></para></section>
3231
3232<section id="lic_7">
3233<title>BSD-4-Clause</title>
3234<para><programlisting>
3235
3236Copyright (c) &lt;year&gt;, &lt;copyright holder&gt;
3237All rights reserved.
3238
3239Redistribution and use in source and binary forms, with or without
3240modification, are permitted provided that the following conditions are met:
32411. Redistributions of source code must retain the above copyright
3242 notice, this list of conditions and the following disclaimer.
32432. Redistributions in binary form must reproduce the above copyright
3244 notice, this list of conditions and the following disclaimer in the
3245 documentation and/or other materials provided with the distribution.
32463. All advertising materials mentioning features or use of this software
3247 must display the following acknowledgement:
3248 This product includes software developed by the &lt;organization&gt;.
32494. Neither the name of the &lt;organization&gt; nor the
3250 names of its contributors may be used to endorse or promote products
3251 derived from this software without specific prior written permission.
3252
3253THIS SOFTWARE IS PROVIDED BY &lt;COPYRIGHT HOLDER&gt; ``AS IS`` AND ANY
3254EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
3255WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
3256DISCLAIMED. IN NO EVENT SHALL &lt;COPYRIGHT HOLDER&gt; BE LIABLE FOR ANY
3257DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
3258(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
3259LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
3260ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
3261(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
3262SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3263
3264</programlisting></para></section>
3265
3266<section id="lic_8">
3267<title>BSL-1.0</title>
3268<para><programlisting>
3269
3270Boost Software License - Version 1.0 - August 17th, 2003
3271
3272Permission is hereby granted, free of charge, to any person or organization
3273obtaining a copy of the software and accompanying documentation covered by
3274this license (the "Software") to use, reproduce, display, distribute,
3275execute, and transmit the Software, and to prepare derivative works of the
3276Software, and to permit third-parties to whom the Software is furnished to
3277do so, all subject to the following:
3278
3279The copyright notices in the Software and this entire statement, including
3280the above license grant, this restriction and the following disclaimer,
3281must be included in all copies of the Software, in whole or in part, and
3282all derivative works of the Software, unless such copies or derivative
3283works are solely in the form of machine-executable object code generated by
3284a source language processor.
3285
3286THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
3287IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
3288FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
3289SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
3290FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
3291ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
3292DEALINGS IN THE SOFTWARE.
3293
3294</programlisting></para></section>
3295
3296<section id="lic_9">
3297<title>CDDL-1.0</title>
3298<para><programlisting>
3299
3300COMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL)
3301Version 1.0
33021. Definitions.
3303
33041.1. &amp;#8220;Contributor&amp;#8221; means each individual or entity that creates or
3305contributes to the creation of Modifications.
3306
33071.2. &amp;#8220;Contributor Version&amp;#8221; means the combination of the Original
3308Software, prior Modifications used by a Contributor (if any), and the Modifications
3309made by that particular Contributor.
3310
33111.3. &amp;#8220;Covered Software&amp;#8221; means (a) the Original Software, or (b)
3312Modifications, or (c) the combination of files containing Original Software with files
3313containing Modifications, in each case including portions thereof.
3314
33151.4. &amp;#8220;Executable&amp;#8221; means the Covered Software in any form other
3316than Source Code.
3317
33181.5. &amp;#8220;Initial Developer&amp;#8221; means the individual or entity that first
3319makes Original Software available under this License.
3320
33211.6. &amp;#8220;Larger Work&amp;#8221; means a work which combines Covered Software or
3322portions thereof with code not governed by the terms of this License.
3323
33241.7. &amp;#8220;License&amp;#8221; means this document.
3325
33261.8. &amp;#8220;Licensable&amp;#8221; means having the right to grant, to the maximum
3327extent possible, whether at the time of the initial grant or subsequently acquired,
3328any and all of the rights conveyed herein.
3329
33301.9. &amp;#8220;Modifications&amp;#8221; means the Source Code and Executable form of
3331any of the following:
3332
3333A. Any file that results from an addition to, deletion from or modification of the
3334contents of a file containing Original Software or previous Modifications;
3335
3336B. Any new file that contains any part of the Original Software or previous
3337Modification; or
3338
3339C. Any new file that is contributed or otherwise made available under the terms of
3340this License.
3341
33421.10. &amp;#8220;Original Software&amp;#8221; means the Source Code and Executable
3343form of computer software code that is originally released under this License.
3344
33451.11. &amp;#8220;Patent Claims&amp;#8221; means any patent claim(s), now owned or
3346hereafter acquired, including without limitation, method, process, and apparatus
3347claims, in any patent Licensable by grantor.
3348
33491.12. &amp;#8220;Source Code&amp;#8221; means (a) the common form of computer software
3350code in which modifications are made and (b) associated documentation included in or
3351with such code.
3352
33531.13. &amp;#8220;You&amp;#8221; (or &amp;#8220;Your&amp;#8221;) means an individual or
3354a legal entity exercising rights under, and complying with all of the terms of, this
3355License. For legal entities, &amp;#8220;You&amp;#8221; includes any entity which
3356controls, is controlled by, or is under common control with You. For purposes of this
3357definition, &amp;#8220;control&amp;#8221; means (a) the power, direct or indirect, to
3358cause the direction or management of such entity, whether by contract or otherwise, or
3359(b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial
3360ownership of such entity.
3361
33622. License Grants.
3363
33642.1. The Initial Developer Grant.
3365
3366Conditioned upon Your compliance with Section 3.1 below and subject to third party
3367intellectual property claims, the Initial Developer hereby grants You a world-wide,
3368royalty-free, non-exclusive license:
3369
3370(a) under intellectual property rights (other than patent or trademark) Licensable by
3371Initial Developer, to use, reproduce, modify, display, perform, sublicense and
3372distribute the Original Software (or portions thereof), with or without Modifications,
3373and/or as part of a Larger Work; and
3374
3375(b) under Patent Claims infringed by the making, using or selling of Original
3376Software, to make, have made, use, practice, sell, and offer for sale, and/or
3377otherwise dispose of the Original Software (or portions thereof).
3378
3379(c) The licenses granted in Sections 2.1(a) and (b) are effective on the date Initial
3380Developer first distributes or otherwise makes the Original Software available to a
3381third party under the terms of this License.
3382
3383(d) Notwithstanding Section 2.1(b) above, no patent license is granted: (1) for code
3384that You delete from the Original Software, or (2) for infringements caused by: (i)
3385the modification of the Original Software, or (ii) the combination of the Original
3386Software with other software or devices.
3387
33882.2. Contributor Grant.
3389
3390Conditioned upon Your compliance with Section 3.1 below and subject to third party
3391intellectual property claims, each Contributor hereby grants You a world-wide,
3392royalty-free, non-exclusive license:
3393
3394(a) under intellectual property rights (other than patent or trademark) Licensable by
3395Contributor to use, reproduce, modify, display, perform, sublicense and distribute the
3396Modifications created by such Contributor (or portions thereof), either on an
3397unmodified basis, with other Modifications, as Covered Software and/or as part of a
3398Larger Work; and
3399
3400(b) under Patent Claims infringed by the making, using, or selling of Modifications
3401made by that Contributor either alone and/or in combination with its Contributor
3402Version (or portions of such combination), to make, use, sell, offer for sale, have
3403made, and/or otherwise dispose of: (1) Modifications made by that Contributor (or
3404portions thereof); and (2) the combination of Modifications made by that Contributor
3405with its Contributor Version (or portions of such combination).
3406
3407(c) The licenses granted in Sections 2.2(a) and 2.2(b) are effective on the date
3408Contributor first distributes or otherwise makes the Modifications available to a
3409third party.
3410
3411(d) Notwithstanding Section 2.2(b) above, no patent license is granted: (1) for any
3412code that Contributor has deleted from the Contributor Version; (2) for infringements
3413caused by: (i) third party modifications of Contributor Version, or (ii) the
3414combination of Modifications made by that Contributor with other software (except as
3415part of the Contributor Version) or other devices; or (3) under Patent Claims
3416infringed by Covered Software in the absence of Modifications made by that
3417Contributor.
3418
34193. Distribution Obligations.
3420
34213.1. Availability of Source Code.
3422
3423Any Covered Software that You distribute or otherwise make available in Executable
3424form must also be made available in Source Code form and that Source Code form must be
3425distributed only under the terms of this License. You must include a copy of this
3426License with every copy of the Source Code form of the Covered Software You distribute
3427or otherwise make available. You must inform recipients of any such Covered Software
3428in Executable form as to how they can obtain such Covered Software in Source Code form
3429in a reasonable manner on or through a medium customarily used for software exchange.
3430
34313.2. Modifications.
3432
3433The Modifications that You create or to which You contribute are governed by the terms
3434of this License. You represent that You believe Your Modifications are Your original
3435creation(s) and/or You have sufficient rights to grant the rights conveyed by this
3436License.
3437
34383.3. Required Notices.
3439
3440You must include a notice in each of Your Modifications that identifies You as the
3441Contributor of the Modification. You may not remove or alter any copyright, patent or
3442trademark notices contained within the Covered Software, or any notices of licensing
3443or any descriptive text giving attribution to any Contributor or the Initial
3444Developer.
3445
34463.4. Application of Additional Terms.
3447
3448You may not offer or impose any terms on any Covered Software in Source Code form that
3449alters or restricts the applicable version of this License or the
3450recipients&amp;#8217; rights hereunder. You may choose to offer, and to charge a fee
3451for, warranty, support, indemnity or liability obligations to one or more recipients
3452of Covered Software. However, you may do so only on Your own behalf, and not on behalf
3453of the Initial Developer or any Contributor. You must make it absolutely clear that
3454any such warranty, support, indemnity or liability obligation is offered by You alone,
3455and You hereby agree to indemnify the Initial Developer and every Contributor for any
3456liability incurred by the Initial Developer or such Contributor as a result of
3457warranty, support, indemnity or liability terms You offer.
3458
34593.5. Distribution of Executable Versions.
3460
3461You may distribute the Executable form of the Covered Software under the terms of this
3462License or under the terms of a license of Your choice, which may contain terms
3463different from this License, provided that You are in compliance with the terms of
3464this License and that the license for the Executable form does not attempt to limit or
3465alter the recipient&amp;#8217;s rights in the Source Code form from the rights set
3466forth in this License. If You distribute the Covered Software in Executable form under
3467a different license, You must make it absolutely clear that any terms which differ
3468from this License are offered by You alone, not by the Initial Developer or
3469Contributor. You hereby agree to indemnify the Initial Developer and every Contributor
3470for any liability incurred by the Initial Developer or such Contributor as a result of
3471any such terms You offer.
3472
34733.6. Larger Works.
3474
3475You may create a Larger Work by combining Covered Software with other code not
3476governed by the terms of this License and distribute the Larger Work as a single
3477product. In such a case, You must make sure the requirements of this License are
3478fulfilled for the Covered Software.
3479
34804. Versions of the License.
3481
34824.1. New Versions.
3483
3484Sun Microsystems, Inc. is the initial license steward and may publish revised and/or
3485new versions of this License from time to time. Each version will be given a
3486distinguishing version number. Except as provided in Section 4.3, no one other than
3487the license steward has the right to modify this License.
3488
34894.2. Effect of New Versions.
3490
3491You may always continue to use, distribute or otherwise make the Covered Software
3492available under the terms of the version of the License under which You originally
3493received the Covered Software. If the Initial Developer includes a notice in the
3494Original Software prohibiting it from being distributed or otherwise made available
3495under any subsequent version of the License, You must distribute and make the Covered
3496Software available under the terms of the version of the License under which You
3497originally received the Covered Software. Otherwise, You may also choose to use,
3498distribute or otherwise make the Covered Software available under the terms of any
3499subsequent version of the License published by the license steward.
3500
35014.3. Modified Versions.
3502
3503When You are an Initial Developer and You want to create a new license for Your
3504Original Software, You may create and use a modified version of this License if You:
3505(a) rename the license and remove any references to the name of the license steward
3506(except to note that the license differs from this License); and (b) otherwise make it
3507clear that the license contains terms which differ from this License.
3508
35095. DISCLAIMER OF WARRANTY.
3510
3511COVERED SOFTWARE IS PROVIDED UNDER THIS LICENSE ON AN &amp;#8220;AS IS&amp;#8221;
3512BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
3513LIMITATION, WARRANTIES THAT THE COVERED SOFTWARE IS FREE OF DEFECTS, MERCHANTABLE, FIT
3514FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND
3515PERFORMANCE OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE
3516DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR)
3517ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF
3518WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY COVERED SOFTWARE
3519IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER.
3520
35216. TERMINATION.
3522
35236.1. This License and the rights granted hereunder will terminate automatically if You
3524fail to comply with terms herein and fail to cure such breach within 30 days of
3525becoming aware of the breach. Provisions which, by their nature, must remain in effect
3526beyond the termination of this License shall survive.
3527
35286.2. If You assert a patent infringement claim (excluding declaratory judgment
3529actions) against Initial Developer or a Contributor (the Initial Developer or
3530Contributor against whom You assert such claim is referred to as
3531&amp;#8220;Participant&amp;#8221;) alleging that the Participant Software (meaning the
3532Contributor Version where the Participant is a Contributor or the Original Software
3533where the Participant is the Initial Developer) directly or indirectly infringes any
3534patent, then any and all rights granted directly or indirectly to You by such
3535Participant, the Initial Developer (if the Initial Developer is not the Participant)
3536and all Contributors under Sections 2.1 and/or 2.2 of this License shall, upon 60 days
3537notice from Participant terminate prospectively and automatically at the expiration of
3538such 60 day notice period, unless if within such 60 day period You withdraw Your claim
3539with respect to the Participant Software against such Participant either unilaterally
3540or pursuant to a written agreement with Participant.
3541
35426.3. In the event of termination under Sections 6.1 or 6.2 above, all end user
3543licenses that have been validly granted by You or any distributor hereunder prior to
3544termination (excluding licenses granted to You by any distributor) shall survive
3545termination.
3546
35477. LIMITATION OF LIABILITY.
3548
3549UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT (INCLUDING NEGLIGENCE),
3550CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL DEVELOPER, ANY OTHER CONTRIBUTOR, OR
3551ANY DISTRIBUTOR OF COVERED SOFTWARE, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE
3552TO ANY PERSON FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY
3553CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOST PROFITS, LOSS OF GOODWILL,
3554WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER COMMERCIAL
3555DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF
3556SUCH DAMAGES. THIS LIMITATION OF LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR
3557PERSONAL INJURY RESULTING FROM SUCH PARTY&amp;#8217;S NEGLIGENCE TO THE EXTENT
3558APPLICABLE LAW PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE
3559EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND
3560LIMITATION MAY NOT APPLY TO YOU.
3561
35628. U.S. GOVERNMENT END USERS.
3563
3564The Covered Software is a &amp;#8220;commercial item,&amp;#8221; as that term is
3565defined in 48 C.F.R. 2.101 (Oct. 1995), consisting of &amp;#8220;commercial computer
3566software&amp;#8221; (as that term is defined at 48 C.F.R. &amp;#167;
3567252.227-7014(a)(1)) and &amp;#8220;commercial computer software
3568documentation&amp;#8221; as such terms are used in 48 C.F.R. 12.212 (Sept. 1995).
3569Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (June
35701995), all U.S. Government End Users acquire Covered Software with only those rights
3571set forth herein. This U.S. Government Rights clause is in lieu of, and supersedes,
3572any other FAR, DFAR, or other clause or provision that addresses Government rights in
3573computer software under this License.
3574
35759. MISCELLANEOUS.
3576
3577This License represents the complete agreement concerning subject matter hereof. If
3578any provision of this License is held to be unenforceable, such provision shall be
3579reformed only to the extent necessary to make it enforceable. This License shall be
3580governed by the law of the jurisdiction specified in a notice contained within the
3581Original Software (except to the extent applicable law, if any, provides otherwise),
3582excluding such jurisdiction&amp;#8217;s conflict-of-law provisions. Any litigation
3583relating to this License shall be subject to the jurisdiction of the courts located in
3584the jurisdiction and venue specified in a notice contained within the Original
3585Software, with the losing party responsible for costs, including, without limitation,
3586court costs and reasonable attorneys&amp;#8217; fees and expenses. The application of
3587the United Nations Convention on Contracts for the International Sale of Goods is
3588expressly excluded. Any law or regulation which provides that the language of a
3589contract shall be construed against the drafter shall not apply to this License. You
3590agree that You alone are responsible for compliance with the United States export
3591administration regulations (and the export control laws and regulation of any other
3592countries) when You use, distribute or otherwise make available any Covered Software.
3593
359410. RESPONSIBILITY FOR CLAIMS.
3595
3596As between Initial Developer and the Contributors, each party is responsible for
3597claims and damages arising, directly or indirectly, out of its utilization of rights
3598under this License and You agree to work with Initial Developer and Contributors to
3599distribute such responsibility on an equitable basis. Nothing herein is intended or
3600shall be deemed to constitute any admission of liability.
3601
3602</programlisting></para></section>
3603
3604<section id="lic_10">
3605<title>CDS</title>
3606<para><programlisting>
3607This software is copyrighted by Cadence Design Systems, Inc., and other
3608parties. The following terms apply to all files associated with the
3609software unless explicitly disclaimed in individual files.
3610
3611The authors hereby grant permission to use, copy, modify, distribute,
3612and license this software and its documentation for any purpose, provided
3613that existing copyright notices are retained in all copies and that this
3614notice is included verbatim in any distributions. No written agreement,
3615license, or royalty fee is required for any of the authorized uses.
3616Modifications to this software may be copyrighted by their authors
3617and need not follow the licensing terms described here, provided that
3618the new terms are clearly indicated on the first page of each file where
3619they apply.
3620
3621IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
3622FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
3623ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
3624DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
3625POSSIBILITY OF SUCH DAMAGE.
3626
3627THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
3628INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
3629FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE
3630IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
3631NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
3632MODIFICATIONS.
3633
3634GOVERNMENT USE: If you are acquiring this software on behalf of the
3635U.S. government, the Government shall have only "Restricted Rights"
3636in the software and related documentation as defined in the Federal
3637Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2). If you
3638are acquiring the software on behalf of the Department of Defense, the
3639software shall be classified as "Commercial Computer Software" and the
3640Government shall have only "Restricted Rights" as defined in Clause
3641252.227-7013 (c) (1) of DFARs. Notwithstanding the foregoing, the
3642authors grant the U.S. Government and others acting in its behalf
3643permission to use and distribute the software in accordance with the
3644terms specified in this license.
3645
3646-----------------------------------------------------------------------
3647 Following is the original agreement for the Tcl/Tk software from
3648 Sun Microsystems.
3649-----------------------------------------------------------------------
3650
3651This software is copyrighted by the Regents of the University of
3652California, Sun Microsystems, Inc., and other parties. The following
3653terms apply to all files associated with the software unless explicitly
3654disclaimed in individual files.
3655
3656The authors hereby grant permission to use, copy, modify, distribute,
3657and license this software and its documentation for any purpose, provided
3658that existing copyright notices are retained in all copies and that this
3659notice is included verbatim in any distributions. No written agreement,
3660license, or royalty fee is required for any of the authorized uses.
3661Modifications to this software may be copyrighted by their authors
3662and need not follow the licensing terms described here, provided that
3663the new terms are clearly indicated on the first page of each file where
3664they apply.
3665
3666IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
3667FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
3668ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
3669DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
3670POSSIBILITY OF SUCH DAMAGE.
3671
3672THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
3673INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
3674FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE
3675IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
3676NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
3677MODIFICATIONS.
3678
3679GOVERNMENT USE: If you are acquiring this software on behalf of the
3680U.S. government, the Government shall have only "Restricted Rights"
3681in the software and related documentation as defined in the Federal
3682Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2). If you
3683are acquiring the software on behalf of the Department of Defense, the
3684software shall be classified as "Commercial Computer Software" and the
3685Government shall have only "Restricted Rights" as defined in Clause
3686252.227-7013 (c) (1) of DFARs. Notwithstanding the foregoing, the
3687authors grant the U.S. Government and others acting in its behalf
3688permission to use and distribute the software in accordance with the
3689terms specified in this license.
3690</programlisting></para></section>
3691
3692<section id="lic_11">
3693<title>CPL-1.0</title>
3694<para><programlisting>
3695
3696Common Public License Version 1.0
3697
3698THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC
3699LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM
3700CONSTITUTES RECIPIENT`S ACCEPTANCE OF THIS AGREEMENT.
3701
37021. DEFINITIONS
3703
3704"Contribution" means:
3705
3706a) in the case of the initial Contributor, the initial code and
3707documentation distributed under this Agreement, and
3708
3709b) in the case of each subsequent Contributor:
3710
3711i) changes to the Program, and
3712
3713ii) additions to the Program;
3714
3715where such changes and/or additions to the Program originate from and are
3716distributed by that particular Contributor. A Contribution `originates` from a
3717Contributor if it was added to the Program by such Contributor itself or anyone
3718acting on such Contributor`s behalf. Contributions do not include additions to
3719the Program which: (i) are separate modules of software distributed in
3720conjunction with the Program under their own license agreement, and (ii) are not
3721derivative works of the Program.
3722
3723"Contributor" means any person or entity that distributes the Program.
3724
3725"Licensed Patents " mean patent claims licensable by a Contributor which are
3726necessarily infringed by the use or sale of its Contribution alone or when
3727combined with the Program.
3728
3729"Program" means the Contributions distributed in accordance with this Agreement.
3730
3731"Recipient" means anyone who receives the Program under this Agreement,
3732including all Contributors.
3733
37342. GRANT OF RIGHTS
3735
3736a) Subject to the terms of this Agreement, each Contributor hereby grants
3737Recipient a non-exclusive, worldwide, royalty-free copyright license to
3738reproduce, prepare derivative works of, publicly display, publicly perform,
3739distribute and sublicense the Contribution of such Contributor, if any, and such
3740derivative works, in source code and object code form.
3741
3742b) Subject to the terms of this Agreement, each Contributor hereby grants
3743Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed
3744Patents to make, use, sell, offer to sell, import and otherwise transfer the
3745Contribution of such Contributor, if any, in source code and object code form.
3746This patent license shall apply to the combination of the Contribution and the
3747Program if, at the time the Contribution is added by the Contributor, such
3748addition of the Contribution causes such combination to be covered by the
3749Licensed Patents. The patent license shall not apply to any other combinations
3750which include the Contribution. No hardware per se is licensed hereunder.
3751
3752c) Recipient understands that although each Contributor grants the licenses
3753to its Contributions set forth herein, no assurances are provided by any
3754Contributor that the Program does not infringe the patent or other intellectual
3755property rights of any other entity. Each Contributor disclaims any liability to
3756Recipient for claims brought by any other entity based on infringement of
3757intellectual property rights or otherwise. As a condition to exercising the
3758rights and licenses granted hereunder, each Recipient hereby assumes sole
3759responsibility to secure any other intellectual property rights needed, if any.
3760For example, if a third party patent license is required to allow Recipient to
3761distribute the Program, it is Recipient`s responsibility to acquire that license
3762before distributing the Program.
3763
3764d) Each Contributor represents that to its knowledge it has sufficient
3765copyright rights in its Contribution, if any, to grant the copyright license set
3766forth in this Agreement.
3767
37683. REQUIREMENTS
3769
3770A Contributor may choose to distribute the Program in object code form under its
3771own license agreement, provided that:
3772
3773a) it complies with the terms and conditions of this Agreement; and
3774
3775b) its license agreement:
3776
3777i) effectively disclaims on behalf of all Contributors all warranties and
3778conditions, express and implied, including warranties or conditions of title and
3779non-infringement, and implied warranties or conditions of merchantability and
3780fitness for a particular purpose;
3781
3782ii) effectively excludes on behalf of all Contributors all liability for
3783damages, including direct, indirect, special, incidental and consequential
3784damages, such as lost profits;
3785
3786iii) states that any provisions which differ from this Agreement are offered
3787by that Contributor alone and not by any other party; and
3788
3789iv) states that source code for the Program is available from such
3790Contributor, and informs licensees how to obtain it in a reasonable manner on or
3791through a medium customarily used for software exchange.
3792
3793When the Program is made available in source code form:
3794
3795a) it must be made available under this Agreement; and
3796
3797b) a copy of this Agreement must be included with each copy of the Program.
3798
3799Contributors may not remove or alter any copyright notices contained within the
3800Program.
3801
3802Each Contributor must identify itself as the originator of its Contribution, if
3803any, in a manner that reasonably allows subsequent Recipients to identify the
3804originator of the Contribution.
3805
38064. COMMERCIAL DISTRIBUTION
3807
3808Commercial distributors of software may accept certain responsibilities with
3809respect to end users, business partners and the like. While this license is
3810intended to facilitate the commercial use of the Program, the Contributor who
3811includes the Program in a commercial product offering should do so in a manner
3812which does not create potential liability for other Contributors. Therefore, if
3813a Contributor includes the Program in a commercial product offering, such
3814Contributor ("Commercial Contributor") hereby agrees to defend and indemnify
3815every other Contributor ("Indemnified Contributor") against any losses, damages
3816and costs (collectively "Losses") arising from claims, lawsuits and other legal
3817actions brought by a third party against the Indemnified Contributor to the
3818extent caused by the acts or omissions of such Commercial Contributor in
3819connection with its distribution of the Program in a commercial product
3820offering. The obligations in this section do not apply to any claims or Losses
3821relating to any actual or alleged intellectual property infringement. In order
3822to qualify, an Indemnified Contributor must: a) promptly notify the Commercial
3823Contributor in writing of such claim, and b) allow the Commercial Contributor to
3824control, and cooperate with the Commercial Contributor in, the defense and any
3825related settlement negotiations. The Indemnified Contributor may participate in
3826any such claim at its own expense.
3827
3828For example, a Contributor might include the Program in a commercial product
3829offering, Product X. That Contributor is then a Commercial Contributor. If that
3830Commercial Contributor then makes performance claims, or offers warranties
3831related to Product X, those performance claims and warranties are such
3832Commercial Contributor`s responsibility alone. Under this section, the
3833Commercial Contributor would have to defend claims against the other
3834Contributors related to those performance claims and warranties, and if a court
3835requires any other Contributor to pay any damages as a result, the Commercial
3836Contributor must pay those damages.
3837
38385. NO WARRANTY
3839
3840EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN
3841"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
3842IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE,
3843NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each
3844Recipient is solely responsible for determining the appropriateness of using and
3845distributing the Program and assumes all risks associated with its exercise of
3846rights under this Agreement, including but not limited to the risks and costs of
3847program errors, compliance with applicable laws, damage to or loss of data,
3848programs or equipment, and unavailability or interruption of operations.
3849
38506. DISCLAIMER OF LIABILITY
3851
3852EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY
3853CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL,
3854SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
3855PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
3856STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
3857OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS
3858GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
3859
38607. GENERAL
3861
3862If any provision of this Agreement is invalid or unenforceable under applicable
3863law, it shall not affect the validity or enforceability of the remainder of the
3864terms of this Agreement, and without further action by the parties hereto, such
3865provision shall be reformed to the minimum extent necessary to make such
3866provision valid and enforceable.
3867
3868If Recipient institutes patent litigation against a Contributor with respect to
3869a patent applicable to software (including a cross-claim or counterclaim in a
3870lawsuit), then any patent licenses granted by that Contributor to such Recipient
3871under this Agreement shall terminate as of the date such litigation is filed. In
3872addition, if Recipient institutes patent litigation against any entity
3873(including a cross-claim or counterclaim in a lawsuit) alleging that the Program
3874itself (excluding combinations of the Program with other software or hardware)
3875infringes such Recipient`s patent(s), then such Recipient`s rights granted under
3876Section 2(b) shall terminate as of the date such litigation is filed.
3877
3878All Recipient`s rights under this Agreement shall terminate if it fails to
3879comply with any of the material terms or conditions of this Agreement and does
3880not cure such failure in a reasonable period of time after becoming aware of
3881such noncompliance. If all Recipient`s rights under this Agreement terminate,
3882Recipient agrees to cease use and distribution of the Program as soon as
3883reasonably practicable. However, Recipient`s obligations under this Agreement
3884and any licenses granted by Recipient relating to the Program shall continue and
3885survive.
3886
3887Everyone is permitted to copy and distribute copies of this Agreement, but in
3888order to avoid inconsistency the Agreement is copyrighted and may only be
3889modified in the following manner. The Agreement Steward reserves the right to
3890publish new versions (including revisions) of this Agreement from time to time.
3891No one other than the Agreement Steward has the right to modify this Agreement.
3892IBM is the initial Agreement Steward. IBM may assign the responsibility to serve
3893as the Agreement Steward to a suitable separate entity. Each new version of the
3894Agreement will be given a distinguishing version number. The Program (including
3895Contributions) may always be distributed subject to the version of the Agreement
3896under which it was received. In addition, after a new version of the Agreement
3897is published, Contributor may elect to distribute the Program (including its
3898Contributions) under the new version. Except as expressly stated in Sections
38992(a) and 2(b) above, Recipient receives no rights or licenses to the
3900intellectual property of any Contributor under this Agreement, whether
3901expressly, by implication, estoppel or otherwise. All rights in the Program not
3902expressly granted under this Agreement are reserved.
3903
3904This Agreement is governed by the laws of the State of New York and the
3905intellectual property laws of the United States of America. No party to this
3906Agreement will bring a legal action under this Agreement more than one year
3907after the cause of action arose. Each party waives its rights to a jury trial in
3908any resulting litigation.
3909
3910</programlisting></para></section>
3911
3912<section id="lic_12">
3913<title>CUP</title>
3914<para><programlisting>
3915CUP PARSER GENERATOR COPYRIGHT NOTICE, LICENSE AND DISCLAIMER.
3916
3917Copyright 1996 by Scott Hudson, Frank Flannery, C. Scott Ananian
3918
3919Permission to use, copy, modify, and distribute this software and its
3920documentation for any purpose and without fee is hereby granted,
3921provided that the above copyright notice appear in all copies and that
3922both the copyright notice and this permission notice and warranty
3923disclaimer appear in supporting documentation, and that the names of
3924the authors or their employers not be used in advertising or publicity
3925pertaining to distribution of the software without specific, written
3926prior permission.
3927
3928The authors and their employers disclaim all warranties with regard to
3929this software, including all implied warranties of merchantability and
3930fitness. In no event shall the authors or their employers be liable
3931for any special, indirect or consequential damages or any damages
3932whatsoever resulting from loss of use, data or profits, whether in an
3933action of contract, negligence or other tortious action, arising out of
3934or in connection with the use or performance of this software.
3935</programlisting></para></section>
3936
3937<section id="lic_13">
3938<title>EPL-1.0</title>
3939<para><programlisting>
3940
3941Eclipse Public License - v 1.0
3942
3943THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE PUBLIC LICENSE
3944("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES
3945RECIPIENT`S ACCEPTANCE OF THIS AGREEMENT.
3946
39471. DEFINITIONS
3948
3949"Contribution" means:
3950
3951a) in the case of the initial Contributor, the initial code and documentation
3952distributed under this Agreement, and
3953b) in the case of each subsequent Contributor:
3954i) changes to the Program, and
3955ii) additions to the Program;
3956where such changes and/or additions to the Program originate from and are distributed
3957by that particular Contributor. A Contribution `originates` from a Contributor if it
3958was added to the Program by such Contributor itself or anyone acting on such
3959Contributor`s behalf. Contributions do not include additions to the Program which: (i)
3960are separate modules of software distributed in conjunction with the Program under
3961their own license agreement, and (ii) are not derivative works of the Program.
3962"Contributor" means any person or entity that distributes the Program.
3963
3964"Licensed Patents" mean patent claims licensable by a Contributor which are
3965necessarily infringed by the use or sale of its Contribution alone or when combined
3966with the Program.
3967
3968"Program" means the Contributions distributed in accordance with this Agreement.
3969
3970"Recipient" means anyone who receives the Program under this Agreement, including all
3971Contributors.
3972
39732. GRANT OF RIGHTS
3974
3975a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a
3976non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare
3977derivative works of, publicly display, publicly perform, distribute and sublicense the
3978Contribution of such Contributor, if any, and such derivative works, in source code
3979and object code form.
3980b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a
3981non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make,
3982use, sell, offer to sell, import and otherwise transfer the Contribution of such
3983Contributor, if any, in source code and object code form. This patent license shall
3984apply to the combination of the Contribution and the Program if, at the time the
3985Contribution is added by the Contributor, such addition of the Contribution causes
3986such combination to be covered by the Licensed Patents. The patent license shall not
3987apply to any other combinations which include the Contribution. No hardware per se is
3988licensed hereunder.
3989c) Recipient understands that although each Contributor grants the licenses to its
3990Contributions set forth herein, no assurances are provided by any Contributor that the
3991Program does not infringe the patent or other intellectual property rights of any
3992other entity. Each Contributor disclaims any liability to Recipient for claims brought
3993by any other entity based on infringement of intellectual property rights or
3994otherwise. As a condition to exercising the rights and licenses granted hereunder,
3995each Recipient hereby assumes sole responsibility to secure any other intellectual
3996property rights needed, if any. For example, if a third party patent license is
3997required to allow Recipient to distribute the Program, it is Recipient`s
3998responsibility to acquire that license before distributing the Program.
3999d) Each Contributor represents that to its knowledge it has sufficient copyright
4000rights in its Contribution, if any, to grant the copyright license set forth in this
4001Agreement.
40023. REQUIREMENTS
4003
4004A Contributor may choose to distribute the Program in object code form under its own
4005license agreement, provided that:
4006
4007a) it complies with the terms and conditions of this Agreement; and
4008b) its license agreement:
4009i) effectively disclaims on behalf of all Contributors all warranties and conditions,
4010express and implied, including warranties or conditions of title and non-infringement,
4011and implied warranties or conditions of merchantability and fitness for a particular
4012purpose;
4013ii) effectively excludes on behalf of all Contributors all liability for damages,
4014including direct, indirect, special, incidental and consequential damages, such as
4015lost profits;
4016iii) states that any provisions which differ from this Agreement are offered by that
4017Contributor alone and not by any other party; and
4018iv) states that source code for the Program is available from such Contributor, and
4019informs licensees how to obtain it in a reasonable manner on or through a medium
4020customarily used for software exchange.
4021When the Program is made available in source code form:
4022
4023a) it must be made available under this Agreement; and
4024b) a copy of this Agreement must be included with each copy of the Program.
4025Contributors may not remove or alter any copyright notices contained within the
4026Program.
4027
4028Each Contributor must identify itself as the originator of its Contribution, if any,
4029in a manner that reasonably allows subsequent Recipients to identify the originator of
4030the Contribution.
4031
40324. COMMERCIAL DISTRIBUTION
4033
4034Commercial distributors of software may accept certain responsibilities with respect
4035to end users, business partners and the like. While this license is intended to
4036facilitate the commercial use of the Program, the Contributor who includes the Program
4037in a commercial product offering should do so in a manner which does not create
4038potential liability for other Contributors. Therefore, if a Contributor includes the
4039Program in a commercial product offering, such Contributor ("Commercial Contributor")
4040hereby agrees to defend and indemnify every other Contributor ("Indemnified
4041Contributor") against any losses, damages and costs (collectively "Losses") arising
4042from claims, lawsuits and other legal actions brought by a third party against the
4043Indemnified Contributor to the extent caused by the acts or omissions of such
4044Commercial Contributor in connection with its distribution of the Program in a
4045commercial product offering. The obligations in this section do not apply to any
4046claims or Losses relating to any actual or alleged intellectual property infringement.
4047In order to qualify, an Indemnified Contributor must: a) promptly notify the
4048Commercial Contributor in writing of such claim, and b) allow the Commercial
4049Contributor to control, and cooperate with the Commercial Contributor in, the defense
4050and any related settlement negotiations. The Indemnified Contributor may participate
4051in any such claim at its own expense.
4052
4053For example, a Contributor might include the Program in a commercial product offering,
4054Product X. That Contributor is then a Commercial Contributor. If that Commercial
4055Contributor then makes performance claims, or offers warranties related to Product X,
4056those performance claims and warranties are such Commercial Contributor`s
4057responsibility alone. Under this section, the Commercial Contributor would have to
4058defend claims against the other Contributors related to those performance claims and
4059warranties, and if a court requires any other Contributor to pay any damages as a
4060result, the Commercial Contributor must pay those damages.
4061
40625. NO WARRANTY
4063
4064EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS"
4065BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED
4066INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE,
4067NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient
4068is solely responsible for determining the appropriateness of using and distributing
4069the Program and assumes all risks associated with its exercise of rights under this
4070Agreement , including but not limited to the risks and costs of program errors,
4071compliance with applicable laws, damage to or loss of data, programs or equipment, and
4072unavailability or interruption of operations.
4073
40746. DISCLAIMER OF LIABILITY
4075
4076EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY
4077CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
4078EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS),
4079HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
4080OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
4081DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF
4082ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
4083
40847. GENERAL
4085
4086If any provision of this Agreement is invalid or unenforceable under applicable law,
4087it shall not affect the validity or enforceability of the remainder of the terms of
4088this Agreement, and without further action by the parties hereto, such provision shall
4089be reformed to the minimum extent necessary to make such provision valid and
4090enforceable.
4091
4092If Recipient institutes patent litigation against any entity (including a cross-claim
4093or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations
4094of the Program with other software or hardware) infringes such Recipient`s patent(s),
4095then such Recipient`s rights granted under Section 2(b) shall terminate as of the date
4096such litigation is filed.
4097
4098All Recipient`s rights under this Agreement shall terminate if it fails to comply with
4099any of the material terms or conditions of this Agreement and does not cure such
4100failure in a reasonable period of time after becoming aware of such noncompliance. If
4101all Recipient`s rights under this Agreement terminate, Recipient agrees to cease use
4102and distribution of the Program as soon as reasonably practicable. However,
4103Recipient`s obligations under this Agreement and any licenses granted by Recipient
4104relating to the Program shall continue and survive.
4105
4106Everyone is permitted to copy and distribute copies of this Agreement, but in order to
4107avoid inconsistency the Agreement is copyrighted and may only be modified in the
4108following manner. The Agreement Steward reserves the right to publish new versions
4109(including revisions) of this Agreement from time to time. No one other than the
4110Agreement Steward has the right to modify this Agreement. The Eclipse Foundation is
4111the initial Agreement Steward. The Eclipse Foundation may assign the responsibility to
4112serve as the Agreement Steward to a suitable separate entity. Each new version of the
4113Agreement will be given a distinguishing version number. The Program (including
4114Contributions) may always be distributed subject to the version of the Agreement under
4115which it was received. In addition, after a new version of the Agreement is published,
4116Contributor may elect to distribute the Program (including its Contributions) under
4117the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
4118receives no rights or licenses to the intellectual property of any Contributor under
4119this Agreement, whether expressly, by implication, estoppel or otherwise. All rights
4120in the Program not expressly granted under this Agreement are reserved.
4121
4122This Agreement is governed by the laws of the State of New York and the intellectual
4123property laws of the United States of America. No party to this Agreement will bring a
4124legal action under this Agreement more than one year after the cause of action arose.
4125Each party waives its rights to a jury trial in any resulting litigation.
4126
4127</programlisting></para></section>
4128
4129<section id="lic_14">
4130<title>Elfutils-Exception</title>
4131<para><programlisting>
4132 This file describes the limits of the Exception under which you are allowed
4133 to distribute Non-GPL Code in linked combination with Red Hat elfutils.
4134 For the full text of the license, please see one of the header files
4135 included with the source distribution or the file COPYING found in the
4136 top level directory of the source.
4137
4138 The Approved Interfaces are the functions declared in the files:
4139
4140 libelf.h
4141 libdw.h
4142 libdwfl.h
4143
4144</programlisting></para></section>
4145
4146<section id="lic_15">
4147<title>FSF-Unlimited</title>
4148<para><programlisting>
4149Copyright (C) 1997-2010 Free Software Foundation, Inc.
4150This file is free software; the Free Software Foundation
4151gives unlimited permission to copy and/or distribute it,
4152with or without modifications, as long as this notice is preserved.
4153</programlisting></para></section>
4154
4155<section id="lic_16">
4156<title>FreeType</title>
4157<para><programlisting>
4158 The FreeType Project LICENSE
4159 ----------------------------
4160
4161 2006-Jan-27
4162
4163 Copyright 1996-2002, 2006 by
4164 David Turner, Robert Wilhelm, and Werner Lemberg
4165
4166
4167
4168Introduction
4169============
4170
4171 The FreeType Project is distributed in several archive packages;
4172 some of them may contain, in addition to the FreeType font engine,
4173 various tools and contributions which rely on, or relate to, the
4174 FreeType Project.
4175
4176 This license applies to all files found in such packages, and
4177 which do not fall under their own explicit license. The license
4178 affects thus the FreeType font engine, the test programs,
4179 documentation and makefiles, at the very least.
4180
4181 This license was inspired by the BSD, Artistic, and IJG
4182 (Independent JPEG Group) licenses, which all encourage inclusion
4183 and use of free software in commercial and freeware products
4184 alike. As a consequence, its main points are that:
4185
4186 o We don't promise that this software works. However, we will be
4187 interested in any kind of bug reports. (`as is' distribution)
4188
4189 o You can use this software for whatever you want, in parts or
4190 full form, without having to pay us. (`royalty-free' usage)
4191
4192 o You may not pretend that you wrote this software. If you use
4193 it, or only parts of it, in a program, you must acknowledge
4194 somewhere in your documentation that you have used the
4195 FreeType code. (`credits')
4196
4197 We specifically permit and encourage the inclusion of this
4198 software, with or without modifications, in commercial products.
4199 We disclaim all warranties covering The FreeType Project and
4200 assume no liability related to The FreeType Project.
4201
4202
4203 Finally, many people asked us for a preferred form for a
4204 credit/disclaimer to use in compliance with this license. We thus
4205 encourage you to use the following text:
4206
4207 """
4208 Portions of this software are copyright � &lt;year&gt; The FreeType
4209 Project (www.freetype.org). All rights reserved.
4210 """
4211
4212 Please replace &lt;year&gt; with the value from the FreeType version you
4213 actually use.
4214
4215
4216Legal Terms
4217===========
4218
42190. Definitions
4220--------------
4221
4222 Throughout this license, the terms `package', `FreeType Project',
4223 and `FreeType archive' refer to the set of files originally
4224 distributed by the authors (David Turner, Robert Wilhelm, and
4225 Werner Lemberg) as the `FreeType Project', be they named as alpha,
4226 beta or final release.
4227
4228 `You' refers to the licensee, or person using the project, where
4229 `using' is a generic term including compiling the project's source
4230 code as well as linking it to form a `program' or `executable'.
4231 This program is referred to as `a program using the FreeType
4232 engine'.
4233
4234 This license applies to all files distributed in the original
4235 FreeType Project, including all source code, binaries and
4236 documentation, unless otherwise stated in the file in its
4237 original, unmodified form as distributed in the original archive.
4238 If you are unsure whether or not a particular file is covered by
4239 this license, you must contact us to verify this.
4240
4241 The FreeType Project is copyright (C) 1996-2000 by David Turner,
4242 Robert Wilhelm, and Werner Lemberg. All rights reserved except as
4243 specified below.
4244
42451. No Warranty
4246--------------
4247
4248 THE FREETYPE PROJECT IS PROVIDED `AS IS' WITHOUT WARRANTY OF ANY
4249 KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
4250 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
4251 PURPOSE. IN NO EVENT WILL ANY OF THE AUTHORS OR COPYRIGHT HOLDERS
4252 BE LIABLE FOR ANY DAMAGES CAUSED BY THE USE OR THE INABILITY TO
4253 USE, OF THE FREETYPE PROJECT.
4254
42552. Redistribution
4256-----------------
4257
4258 This license grants a worldwide, royalty-free, perpetual and
4259 irrevocable right and license to use, execute, perform, compile,
4260 display, copy, create derivative works of, distribute and
4261 sublicense the FreeType Project (in both source and object code
4262 forms) and derivative works thereof for any purpose; and to
4263 authorize others to exercise some or all of the rights granted
4264 herein, subject to the following conditions:
4265
4266 o Redistribution of source code must retain this license file
4267 (`FTL.TXT') unaltered; any additions, deletions or changes to
4268 the original files must be clearly indicated in accompanying
4269 documentation. The copyright notices of the unaltered,
4270 original files must be preserved in all copies of source
4271 files.
4272
4273 o Redistribution in binary form must provide a disclaimer that
4274 states that the software is based in part of the work of the
4275 FreeType Team, in the distribution documentation. We also
4276 encourage you to put an URL to the FreeType web page in your
4277 documentation, though this isn't mandatory.
4278
4279 These conditions apply to any software derived from or based on
4280 the FreeType Project, not just the unmodified files. If you use
4281 our work, you must acknowledge us. However, no fee need be paid
4282 to us.
4283
42843. Advertising
4285--------------
4286
4287 Neither the FreeType authors and contributors nor you shall use
4288 the name of the other for commercial, advertising, or promotional
4289 purposes without specific prior written permission.
4290
4291 We suggest, but do not require, that you use one or more of the
4292 following phrases to refer to this software in your documentation
4293 or advertising materials: `FreeType Project', `FreeType Engine',
4294 `FreeType library', or `FreeType Distribution'.
4295
4296 As you have not signed this license, you are not required to
4297 accept it. However, as the FreeType Project is copyrighted
4298 material, only this license, or another one contracted with the
4299 authors, grants you the right to use, distribute, and modify it.
4300 Therefore, by using, distributing, or modifying the FreeType
4301 Project, you indicate that you understand and accept all the terms
4302 of this license.
4303
43044. Contacts
4305-----------
4306
4307 There are two mailing lists related to FreeType:
4308
4309 o freetype@nongnu.org
4310
4311 Discusses general use and applications of FreeType, as well as
4312 future and wanted additions to the library and distribution.
4313 If you are looking for support, start in this list if you
4314 haven't found anything to help you in the documentation.
4315
4316 o freetype-devel@nongnu.org
4317
4318 Discusses bugs, as well as engine internals, design issues,
4319 specific licenses, porting, etc.
4320
4321 Our home page can be found at
4322
4323 http://www.freetype.org
4324
4325
4326--- end of FTL.TXT ---
4327
4328</programlisting></para></section>
4329
4330<section id="lic_17">
4331<title>GPL-1.0</title>
4332<para><programlisting>
4333
4334GNU General Public License, version 1
4335
4336 GNU GENERAL PUBLIC LICENSE
4337 Version 1, February 1989
4338
4339 Copyright (C) 1989 Free Software Foundation, Inc.
4340 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
4341 Everyone is permitted to copy and distribute verbatim copies
4342 of this license document, but changing it is not allowed.
4343
4344 Preamble
4345
4346 The license agreements of most software companies try to keep users
4347at the mercy of those companies. By contrast, our General Public
4348License is intended to guarantee your freedom to share and change free
4349software--to make sure the software is free for all its users. The
4350General Public License applies to the Free Software Foundation`s
4351software and to any other program whose authors commit to using it.
4352You can use it for your programs, too.
4353
4354 When we speak of free software, we are referring to freedom, not
4355price. Specifically, the General Public License is designed to make
4356sure that you have the freedom to give away or sell copies of free
4357software, that you receive source code or can get it if you want it,
4358that you can change the software or use pieces of it in new free
4359programs; and that you know you can do these things.
4360
4361 To protect your rights, we need to make restrictions that forbid
4362anyone to deny you these rights or to ask you to surrender the rights.
4363These restrictions translate to certain responsibilities for you if you
4364distribute copies of the software, or if you modify it.
4365
4366 For example, if you distribute copies of a such a program, whether
4367gratis or for a fee, you must give the recipients all the rights that
4368you have. You must make sure that they, too, receive or can get the
4369source code. And you must tell them their rights.
4370
4371 We protect your rights with two steps: (1) copyright the software, and
4372(2) offer you this license which gives you legal permission to copy,
4373distribute and/or modify the software.
4374
4375 Also, for each author`s protection and ours, we want to make certain
4376that everyone understands that there is no warranty for this free
4377software. If the software is modified by someone else and passed on, we
4378want its recipients to know that what they have is not the original, so
4379that any problems introduced by others will not reflect on the original
4380authors` reputations.
4381
4382 The precise terms and conditions for copying, distribution and
4383modification follow.
4384
4385 GNU GENERAL PUBLIC LICENSE
4386 TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
4387
4388 0. This License Agreement applies to any program or other work which
4389contains a notice placed by the copyright holder saying it may be
4390distributed under the terms of this General Public License. The
4391"Program", below, refers to any such program or work, and a "work based
4392on the Program" means either the Program or any work containing the
4393Program or a portion of it, either verbatim or with modifications. Each
4394licensee is addressed as "you".
4395
4396 1. You may copy and distribute verbatim copies of the Program`s source
4397code as you receive it, in any medium, provided that you conspicuously and
4398appropriately publish on each copy an appropriate copyright notice and
4399disclaimer of warranty; keep intact all the notices that refer to this
4400General Public License and to the absence of any warranty; and give any
4401other recipients of the Program a copy of this General Public License
4402along with the Program. You may charge a fee for the physical act of
4403transferring a copy.
4404
4405 2. You may modify your copy or copies of the Program or any portion of
4406it, and copy and distribute such modifications under the terms of Paragraph
44071 above, provided that you also do the following:
4408
4409 a) cause the modified files to carry prominent notices stating that
4410 you changed the files and the date of any change; and
4411
4412 b) cause the whole of any work that you distribute or publish, that
4413 in whole or in part contains the Program or any part thereof, either
4414 with or without modifications, to be licensed at no charge to all
4415 third parties under the terms of this General Public License (except
4416 that you may choose to grant warranty protection to some or all
4417 third parties, at your option).
4418
4419 c) If the modified program normally reads commands interactively when
4420 run, you must cause it, when started running for such interactive use
4421 in the simplest and most usual way, to print or display an
4422 announcement including an appropriate copyright notice and a notice
4423 that there is no warranty (or else, saying that you provide a
4424 warranty) and that users may redistribute the program under these
4425 conditions, and telling the user how to view a copy of this General
4426 Public License.
4427
4428 d) You may charge a fee for the physical act of transferring a
4429 copy, and you may at your option offer warranty protection in
4430 exchange for a fee.
4431
4432Mere aggregation of another independent work with the Program (or its
4433derivative) on a volume of a storage or distribution medium does not bring
4434the other work under the scope of these terms.
4435
4436 3. You may copy and distribute the Program (or a portion or derivative of
4437it, under Paragraph 2) in object code or executable form under the terms of
4438Paragraphs 1 and 2 above provided that you also do one of the following:
4439
4440 a) accompany it with the complete corresponding machine-readable
4441 source code, which must be distributed under the terms of
4442 Paragraphs 1 and 2 above; or,
4443
4444 b) accompany it with a written offer, valid for at least three
4445 years, to give any third party free (except for a nominal charge
4446 for the cost of distribution) a complete machine-readable copy of the
4447 corresponding source code, to be distributed under the terms of
4448 Paragraphs 1 and 2 above; or,
4449
4450 c) accompany it with the information you received as to where the
4451 corresponding source code may be obtained. (This alternative is
4452 allowed only for noncommercial distribution and only if you
4453 received the program in object code or executable form alone.)
4454
4455Source code for a work means the preferred form of the work for making
4456modifications to it. For an executable file, complete source code means
4457all the source code for all modules it contains; but, as a special
4458exception, it need not include source code for modules which are standard
4459libraries that accompany the operating system on which the executable
4460file runs, or for standard header files or definitions files that
4461accompany that operating system.
4462
4463 4. You may not copy, modify, sublicense, distribute or transfer the
4464Program except as expressly provided under this General Public License.
4465Any attempt otherwise to copy, modify, sublicense, distribute or transfer
4466the Program is void, and will automatically terminate your rights to use
4467the Program under this License. However, parties who have received
4468copies, or rights to use copies, from you under this General Public
4469License will not have their licenses terminated so long as such parties
4470remain in full compliance.
4471
4472 5. By copying, distributing or modifying the Program (or any work based
4473on the Program) you indicate your acceptance of this license to do so,
4474and all its terms and conditions.
4475
4476 6. Each time you redistribute the Program (or any work based on the
4477Program), the recipient automatically receives a license from the original
4478licensor to copy, distribute or modify the Program subject to these
4479terms and conditions. You may not impose any further restrictions on the
4480recipients` exercise of the rights granted herein.
4481
4482 7. The Free Software Foundation may publish revised and/or new versions
4483of the General Public License from time to time. Such new versions will
4484be similar in spirit to the present version, but may differ in detail to
4485address new problems or concerns.
4486
4487Each version is given a distinguishing version number. If the Program
4488specifies a version number of the license which applies to it and "any
4489later version", you have the option of following the terms and conditions
4490either of that version or of any later version published by the Free
4491Software Foundation. If the Program does not specify a version number of
4492the license, you may choose any version ever published by the Free Software
4493Foundation.
4494
4495 8. If you wish to incorporate parts of the Program into other free
4496programs whose distribution conditions are different, write to the author
4497to ask for permission. For software which is copyrighted by the Free
4498Software Foundation, write to the Free Software Foundation; we sometimes
4499make exceptions for this. Our decision will be guided by the two goals
4500of preserving the free status of all derivatives of our free software and
4501of promoting the sharing and reuse of software generally.
4502
4503 NO WARRANTY
4504
4505 9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
4506FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
4507OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
4508PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
4509OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
4510MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
4511TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
4512PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
4513REPAIR OR CORRECTION.
4514
4515 10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
4516WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
4517REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
4518INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
4519OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
4520TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
4521YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
4522PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
4523POSSIBILITY OF SUCH DAMAGES.
4524
4525 END OF TERMS AND CONDITIONS
4526
4527 Appendix: How to Apply These Terms to Your New Programs
4528
4529 If you develop a new program, and you want it to be of the greatest
4530possible use to humanity, the best way to achieve this is to make it
4531free software which everyone can redistribute and change under these
4532terms.
4533
4534 To do so, attach the following notices to the program. It is safest to
4535attach them to the start of each source file to most effectively convey
4536the exclusion of warranty; and each file should have at least the
4537"copyright" line and a pointer to where the full notice is found.
4538
4539 &lt;one line to give the program`s name and a brief idea of what it does.&gt;
4540 Copyright (C) 19yy &lt;name of author&gt;
4541
4542 This program is free software; you can redistribute it and/or modify
4543 it under the terms of the GNU General Public License as published by
4544 the Free Software Foundation; either version 1, or (at your option)
4545 any later version.
4546
4547 This program is distributed in the hope that it will be useful,
4548 but WITHOUT ANY WARRANTY; without even the implied warranty of
4549 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4550 GNU General Public License for more details.
4551
4552 You should have received a copy of the GNU General Public License
4553 along with this program; if not, write to the Free Software
4554 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
4555
4556Also add information on how to contact you by electronic and paper mail.
4557
4558If the program is interactive, make it output a short notice like this
4559when it starts in an interactive mode:
4560
4561 Gnomovision version 69, Copyright (C) 19xx name of author
4562 Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w`.
4563 This is free software, and you are welcome to redistribute it
4564 under certain conditions; type `show c` for details.
4565
4566The hypothetical commands `show w` and `show c` should show the
4567appropriate parts of the General Public License. Of course, the
4568commands you use may be called something other than `show w` and `show
4569c`; they could even be mouse-clicks or menu items--whatever suits your
4570program.
4571
4572You should also get your employer (if you work as a programmer) or your
4573school, if any, to sign a "copyright disclaimer" for the program, if
4574necessary. Here a sample; alter the names:
4575
4576 Yoyodyne, Inc., hereby disclaims all copyright interest in the
4577 program `Gnomovision` (a program to direct compilers to make passes
4578 at assemblers) written by James Hacker.
4579
4580 &lt;signature of Ty Coon&gt;, 1 April 1989
4581 Ty Coon, President of Vice
4582
4583That`s all there is to it!
4584
4585</programlisting></para></section>
4586
4587<section id="lic_18">
4588<title>GPL-2.0</title>
4589<para><programlisting>
4590
4591GNU GENERAL PUBLIC LICENSE
4592
4593Version 2, June 1991
4594
4595Copyright (C) 1989, 1991 Free Software Foundation, Inc.
459651 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
4597
4598Everyone is permitted to copy and distribute verbatim copies
4599of this license document, but changing it is not allowed.
4600Preamble
4601
4602The licenses for most software are designed to take away your freedom to share and
4603change it. By contrast, the GNU General Public License is intended to guarantee your
4604freedom to share and change free software--to make sure the software is free for all
4605its users. This General Public License applies to most of the Free Software
4606Foundation`s software and to any other program whose authors commit to using it. (Some
4607other Free Software Foundation software is covered by the GNU Lesser General Public
4608License instead.) You can apply it to your programs, too.
4609
4610When we speak of free software, we are referring to freedom, not price. Our General
4611Public Licenses are designed to make sure that you have the freedom to distribute
4612copies of free software (and charge for this service if you wish), that you receive
4613source code or can get it if you want it, that you can change the software or use
4614pieces of it in new free programs; and that you know you can do these things.
4615
4616To protect your rights, we need to make restrictions that forbid anyone to deny you
4617these rights or to ask you to surrender the rights. These restrictions translate to
4618certain responsibilities for you if you distribute copies of the software, or if you
4619modify it.
4620
4621For example, if you distribute copies of such a program, whether gratis or for a fee,
4622you must give the recipients all the rights that you have. You must make sure that
4623they, too, receive or can get the source code. And you must show them these terms so
4624they know their rights.
4625
4626We protect your rights with two steps: (1) copyright the software, and (2) offer you
4627this license which gives you legal permission to copy, distribute and/or modify the
4628software.
4629
4630Also, for each author`s protection and ours, we want to make certain that everyone
4631understands that there is no warranty for this free software. If the software is
4632modified by someone else and passed on, we want its recipients to know that what they
4633have is not the original, so that any problems introduced by others will not reflect
4634on the original authors` reputations.
4635
4636Finally, any free program is threatened constantly by software patents. We wish to
4637avoid the danger that redistributors of a free program will individually obtain patent
4638licenses, in effect making the program proprietary. To prevent this, we have made it
4639clear that any patent must be licensed for everyone`s free use or not licensed at all.
4640
4641The precise terms and conditions for copying, distribution and modification follow.
4642
4643TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
4644
46450. This License applies to any program or other work which contains a notice placed by
4646the copyright holder saying it may be distributed under the terms of this General
4647Public License. The "Program", below, refers to any such program or work, and a "work
4648based on the Program" means either the Program or any derivative work under copyright
4649law: that is to say, a work containing the Program or a portion of it, either verbatim
4650or with modifications and/or translated into another language. (Hereinafter,
4651translation is included without limitation in the term "modification".) Each licensee
4652is addressed as "you".
4653
4654Activities other than copying, distribution and modification are not covered by this
4655License; they are outside its scope. The act of running the Program is not restricted,
4656and the output from the Program is covered only if its contents constitute a work
4657based on the Program (independent of having been made by running the Program). Whether
4658that is true depends on what the Program does.
4659
46601. You may copy and distribute verbatim copies of the Program`s source code as you
4661receive it, in any medium, provided that you conspicuously and appropriately publish
4662on each copy an appropriate copyright notice and disclaimer of warranty; keep intact
4663all the notices that refer to this License and to the absence of any warranty; and
4664give any other recipients of the Program a copy of this License along with the
4665Program.
4666
4667You may charge a fee for the physical act of transferring a copy, and you may at your
4668option offer warranty protection in exchange for a fee.
4669
46702. You may modify your copy or copies of the Program or any portion of it, thus
4671forming a work based on the Program, and copy and distribute such modifications or
4672work under the terms of Section 1 above, provided that you also meet all of these
4673conditions:
4674
4675a) You must cause the modified files to carry prominent notices stating that you
4676changed the files and the date of any change.
4677b) You must cause any work that you distribute or publish, that in whole or in part
4678contains or is derived from the Program or any part thereof, to be licensed as a whole
4679at no charge to all third parties under the terms of this License.
4680c) If the modified program normally reads commands interactively when run, you must
4681cause it, when started running for such interactive use in the most ordinary way, to
4682print or display an announcement including an appropriate copyright notice and a
4683notice that there is no warranty (or else, saying that you provide a warranty) and
4684that users may redistribute the program under these conditions, and telling the user
4685how to view a copy of this License. (Exception: if the Program itself is interactive
4686but does not normally print such an announcement, your work based on the Program is
4687not required to print an announcement.)
4688These requirements apply to the modified work as a whole. If identifiable sections of
4689that work are not derived from the Program, and can be reasonably considered
4690independent and separate works in themselves, then this License, and its terms, do not
4691apply to those sections when you distribute them as separate works. But when you
4692distribute the same sections as part of a whole which is a work based on the Program,
4693the distribution of the whole must be on the terms of this License, whose permissions
4694for other licensees extend to the entire whole, and thus to each and every part
4695regardless of who wrote it.
4696
4697Thus, it is not the intent of this section to claim rights or contest your rights to
4698work written entirely by you; rather, the intent is to exercise the right to control
4699the distribution of derivative or collective works based on the Program.
4700
4701In addition, mere aggregation of another work not based on the Program with the
4702Program (or with a work based on the Program) on a volume of a storage or distribution
4703medium does not bring the other work under the scope of this License.
4704
47053. You may copy and distribute the Program (or a work based on it, under Section 2) in
4706object code or executable form under the terms of Sections 1 and 2 above provided that
4707you also do one of the following:
4708
4709a) Accompany it with the complete corresponding machine-readable source code, which
4710must be distributed under the terms of Sections 1 and 2 above on a medium customarily
4711used for software interchange; or,
4712b) Accompany it with a written offer, valid for at least three years, to give any
4713third party, for a charge no more than your cost of physically performing source
4714distribution, a complete machine-readable copy of the corresponding source code, to be
4715distributed under the terms of Sections 1 and 2 above on a medium customarily used for
4716software interchange; or,
4717c) Accompany it with the information you received as to the offer to distribute
4718corresponding source code. (This alternative is allowed only for noncommercial
4719distribution and only if you received the program in object code or executable form
4720with such an offer, in accord with Subsection b above.)
4721The source code for a work means the preferred form of the work for making
4722modifications to it. For an executable work, complete source code means all the source
4723code for all modules it contains, plus any associated interface definition files, plus
4724the scripts used to control compilation and installation of the executable. However,
4725as a special exception, the source code distributed need not include anything that is
4726normally distributed (in either source or binary form) with the major components
4727(compiler, kernel, and so on) of the operating system on which the executable runs,
4728unless that component itself accompanies the executable.
4729
4730If distribution of executable or object code is made by offering access to copy from a
4731designated place, then offering equivalent access to copy the source code from the
4732same place counts as distribution of the source code, even though third parties are
4733not compelled to copy the source along with the object code.
4734
47354. You may not copy, modify, sublicense, or distribute the Program except as expressly
4736provided under this License. Any attempt otherwise to copy, modify, sublicense or
4737distribute the Program is void, and will automatically terminate your rights under
4738this License. However, parties who have received copies, or rights, from you under
4739this License will not have their licenses terminated so long as such parties remain in
4740full compliance.
4741
47425. You are not required to accept this License, since you have not signed it. However,
4743nothing else grants you permission to modify or distribute the Program or its
4744derivative works. These actions are prohibited by law if you do not accept this
4745License. Therefore, by modifying or distributing the Program (or any work based on the
4746Program), you indicate your acceptance of this License to do so, and all its terms and
4747conditions for copying, distributing or modifying the Program or works based on it.
4748
47496. Each time you redistribute the Program (or any work based on the Program), the
4750recipient automatically receives a license from the original licensor to copy,
4751distribute or modify the Program subject to these terms and conditions. You may not
4752impose any further restrictions on the recipients` exercise of the rights granted
4753herein. You are not responsible for enforcing compliance by third parties to this
4754License.
4755
47567. If, as a consequence of a court judgment or allegation of patent infringement or
4757for any other reason (not limited to patent issues), conditions are imposed on you
4758(whether by court order, agreement or otherwise) that contradict the conditions of
4759this License, they do not excuse you from the conditions of this License. If you
4760cannot distribute so as to satisfy simultaneously your obligations under this License
4761and any other pertinent obligations, then as a consequence you may not distribute the
4762Program at all. For example, if a patent license would not permit royalty-free
4763redistribution of the Program by all those who receive copies directly or indirectly
4764through you, then the only way you could satisfy both it and this License would be to
4765refrain entirely from distribution of the Program.
4766
4767If any portion of this section is held invalid or unenforceable under any particular
4768circumstance, the balance of the section is intended to apply and the section as a
4769whole is intended to apply in other circumstances.
4770
4771It is not the purpose of this section to induce you to infringe any patents or other
4772property right claims or to contest validity of any such claims; this section has the
4773sole purpose of protecting the integrity of the free software distribution system,
4774which is implemented by public license practices. Many people have made generous
4775contributions to the wide range of software distributed through that system in
4776reliance on consistent application of that system; it is up to the author/donor to
4777decide if he or she is willing to distribute software through any other system and a
4778licensee cannot impose that choice.
4779
4780This section is intended to make thoroughly clear what is believed to be a consequence
4781of the rest of this License.
4782
47838. If the distribution and/or use of the Program is restricted in certain countries
4784either by patents or by copyrighted interfaces, the original copyright holder who
4785places the Program under this License may add an explicit geographical distribution
4786limitation excluding those countries, so that distribution is permitted only in or
4787among countries not thus excluded. In such case, this License incorporates the
4788limitation as if written in the body of this License.
4789
47909. The Free Software Foundation may publish revised and/or new versions of the General
4791Public License from time to time. Such new versions will be similar in spirit to the
4792present version, but may differ in detail to address new problems or concerns.
4793
4794Each version is given a distinguishing version number. If the Program specifies a
4795version number of this License which applies to it and "any later version", you have
4796the option of following the terms and conditions either of that version or of any
4797later version published by the Free Software Foundation. If the Program does not
4798specify a version number of this License, you may choose any version ever published by
4799the Free Software Foundation.
4800
480110. If you wish to incorporate parts of the Program into other free programs whose
4802distribution conditions are different, write to the author to ask for permission. For
4803software which is copyrighted by the Free Software Foundation, write to the Free
4804Software Foundation; we sometimes make exceptions for this. Our decision will be
4805guided by the two goals of preserving the free status of all derivatives of our free
4806software and of promoting the sharing and reuse of software generally.
4807
4808NO WARRANTY
4809
481011. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
4811PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
4812WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
4813WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
4814IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
4815RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM
4816PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
4817
481812. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
4819COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS
4820PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
4821INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
4822PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
4823OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
4824WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
4825POSSIBILITY OF SUCH DAMAGES.
4826
4827END OF TERMS AND CONDITIONS
4828
4829How to Apply These Terms to Your New Programs
4830
4831If you develop a new program, and you want it to be of the greatest possible use to
4832the public, the best way to achieve this is to make it free software which everyone
4833can redistribute and change under these terms.
4834
4835To do so, attach the following notices to the program. It is safest to attach them to
4836the start of each source file to most effectively convey the exclusion of warranty;
4837and each file should have at least the "copyright" line and a pointer to where the
4838full notice is found.
4839
4840one line to give the program`s name and an idea of what it does.
4841Copyright (C) yyyy name of author
4842
4843This program is free software; you can redistribute it and/or
4844modify it under the terms of the GNU General Public License
4845as published by the Free Software Foundation; either version 2
4846of the License, or (at your option) any later version.
4847
4848This program is distributed in the hope that it will be useful,
4849but WITHOUT ANY WARRANTY; without even the implied warranty of
4850MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4851GNU General Public License for more details.
4852
4853You should have received a copy of the GNU General Public License
4854along with this program; if not, write to the Free Software
4855Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
4856Also add information on how to contact you by electronic and paper mail.
4857
4858If the program is interactive, make it output a short notice like this when it starts
4859in an interactive mode:
4860
4861Gnomovision version 69, Copyright (C) year name of author
4862Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
4863type `show w`. This is free software, and you are welcome
4864to redistribute it under certain conditions; type `show c`
4865for details.
4866The hypothetical commands `show w` and `show c` should show the appropriate parts of
4867the General Public License. Of course, the commands you use may be called something
4868other than `show w` and `show c`; they could even be mouse-clicks or menu
4869items--whatever suits your program.
4870
4871You should also get your employer (if you work as a programmer) or your school, if
4872any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample;
4873alter the names:
4874
4875Yoyodyne, Inc., hereby disclaims all copyright
4876interest in the program `Gnomovision`
4877(which makes passes at compilers) written
4878by James Hacker.
4879
4880signature of Ty Coon, 1 April 1989
4881Ty Coon, President of Vice
4882This General Public License does not permit incorporating your program into
4883proprietary programs. If your program is a subroutine library, you may consider it
4884more useful to permit linking proprietary applications with the library. If this is
4885what you want to do, use the GNU Lesser General Public License instead of this
4886License.
4887
4888</programlisting></para></section>
4889
4890<section id="lic_19">
4891<title>GPL-2.0-with-GCC-exception</title>
4892<para><programlisting>
4893
4894insert GPL v2 text here
4895
4896GCC Linking Exception
4897In addition to the permissions in the GNU General Public License, the Free
4898Software Foundation gives you unlimited permission to link the compiled version
4899of this file into combinations with other programs, and to distribute those
4900combinations without any restriction coming from the use of this file. (The
4901General Public License restrictions do apply in other respects; for example,
4902they cover modification of the file, and distribution when not linked into a
4903combine executable.)
4904
4905
4906
4907
4908
4909
4910</programlisting></para></section>
4911
4912<section id="lic_20">
4913<title>GPL-2.0-with-classpath-exception</title>
4914<para><programlisting>
4915
4916insert GPL v2 license text here
4917
4918Linking this library statically or dynamically with other modules is making a combined
4919work based on this library. Thus, the terms and conditions of the GNU General Public
4920License cover the whole combination.
4921
4922As a special exception, the copyright holders of this library give you permission to
4923link this library with independent modules to produce an executable, regardless of the
4924license terms of these independent modules, and to copy and distribute the resulting
4925executable under terms of your choice, provided that you also meet, for each linked
4926independent module, the terms and conditions of the license of that module. An
4927independent module is a module which is not derived from or based on this library. If
4928you modify this library, you may extend this exception to your version of the library,
4929but you are not obligated to do so. If you do not wish to do so, delete this exception
4930statement from your version.
4931
4932</programlisting></para></section>
4933
4934<section id="lic_21">
4935<title>GPL-3.0</title>
4936<para><programlisting>
4937GNU GENERAL PUBLIC LICENSE
4938
4939Version 3, 29 June 2007
4940
4941Copyright © 2007 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
4942
4943Everyone is permitted to copy and distribute verbatim copies of this license document,
4944but changing it is not allowed.
4945Preamble
4946
4947The GNU General Public License is a free, copyleft license for software and other
4948kinds of works.
4949
4950The licenses for most software and other practical works are designed to take away
4951your freedom to share and change the works. By contrast, the GNU General Public
4952License is intended to guarantee your freedom to share and change all versions of a
4953program--to make sure it remains free software for all its users. We, the Free
4954Software Foundation, use the GNU General Public License for most of our software; it
4955applies also to any other work released this way by its authors. You can apply it to
4956your programs, too.
4957
4958When we speak of free software, we are referring to freedom, not price. Our General
4959Public Licenses are designed to make sure that you have the freedom to distribute
4960copies of free software (and charge for them if you wish), that you receive source
4961code or can get it if you want it, that you can change the software or use pieces of
4962it in new free programs, and that you know you can do these things.
4963
4964To protect your rights, we need to prevent others from denying you these rights or
4965asking you to surrender the rights. Therefore, you have certain responsibilities if
4966you distribute copies of the software, or if you modify it: responsibilities to
4967respect the freedom of others.
4968
4969For example, if you distribute copies of such a program, whether gratis or for a fee,
4970you must pass on to the recipients the same freedoms that you received. You must make
4971sure that they, too, receive or can get the source code. And you must show them these
4972terms so they know their rights.
4973
4974Developers that use the GNU GPL protect your rights with two steps: (1) assert
4975copyright on the software, and (2) offer you this License giving you legal permission
4976to copy, distribute and/or modify it.
4977
4978For the developers' and authors' protection, the GPL clearly explains that there is no
4979warranty for this free software. For both users' and authors' sake, the GPL requires
4980that modified versions be marked as changed, so that their problems will not be
4981attributed erroneously to authors of previous versions.
4982
4983Some devices are designed to deny users access to install or run modified versions of
4984the software inside them, although the manufacturer can do so. This is fundamentally
4985incompatible with the aim of protecting users' freedom to change the software. The
4986systematic pattern of such abuse occurs in the area of products for individuals to
4987use, which is precisely where it is most unacceptable. Therefore, we have designed
4988this version of the GPL to prohibit the practice for those products. If such problems
4989arise substantially in other domains, we stand ready to extend this provision to those
4990domains in future versions of the GPL, as needed to protect the freedom of users.
4991
4992Finally, every program is threatened constantly by software patents. States should not
4993allow patents to restrict development and use of software on general-purpose
4994computers, but in those that do, we wish to avoid the special danger that patents
4995applied to a free program could make it effectively proprietary. To prevent this, the
4996GPL assures that patents cannot be used to render the program non-free.
4997
4998The precise terms and conditions for copying, distribution and modification follow.
4999TERMS AND CONDITIONS
50000. Definitions.
5001
5002&rdquor;This License&rdquo; refers to version 3 of the GNU General Public License.
5003
5004&rdquor;Copyright&rdquo; also means copyright-like laws that apply to other kinds of
5005works, such as semiconductor masks.
5006
5007&rdquor;The Program&rdquo; refers to any copyrightable work licensed under this
5008License. Each licensee is addressed as &rdquor;you&rdquo;. &rdquor;Licensees&rdquo;
5009and &rdquor;recipients&rdquo; may be individuals or organizations.
5010
5011To &rdquor;modify&rdquo; a work means to copy from or adapt all or part of the work in
5012a fashion requiring copyright permission, other than the making of an exact copy. The
5013resulting work is called a &rdquor;modified version&rdquo; of the earlier work or a
5014work &rdquor;based on&rdquo; the earlier work.
5015
5016A &rdquor;covered work&rdquo; means either the unmodified Program or a work based on
5017the Program.
5018
5019To &rdquor;propagate&rdquo; a work means to do anything with it that, without
5020permission, would make you directly or secondarily liable for infringement under
5021applicable copyright law, except executing it on a computer or modifying a private
5022copy. Propagation includes copying, distribution (with or without modification),
5023making available to the public, and in some countries other activities as well.
5024
5025To &rdquor;convey&rdquo; a work means any kind of propagation that enables other
5026parties to make or receive copies. Mere interaction with a user through a computer
5027network, with no transfer of a copy, is not conveying.
5028
5029An interactive user interface displays &rdquor;Appropriate Legal Notices&rdquo; to the
5030extent that it includes a convenient and prominently visible feature that (1) displays
5031an appropriate copyright notice, and (2) tells the user that there is no warranty for
5032the work (except to the extent that warranties are provided), that licensees may
5033convey the work under this License, and how to view a copy of this License. If the
5034interface presents a list of user commands or options, such as a menu, a prominent
5035item in the list meets this criterion.
50361. Source Code.
5037
5038The &rdquor;source code&rdquo; for a work means the preferred form of the work for
5039making modifications to it. &rdquor;Object code&rdquo; means any non-source form of a
5040work.
5041
5042A &rdquor;Standard Interface&rdquo; means an interface that either is an official
5043standard defined by a recognized standards body, or, in the case of interfaces
5044specified for a particular programming language, one that is widely used among
5045developers working in that language.
5046
5047The &rdquor;System Libraries&rdquo; of an executable work include anything, other than
5048the work as a whole, that (a) is included in the normal form of packaging a Major
5049Component, but which is not part of that Major Component, and (b) serves only to
5050enable use of the work with that Major Component, or to implement a Standard Interface
5051for which an implementation is available to the public in source code form. A
5052&rdquor;Major Component&rdquo;, in this context, means a major essential component
5053(kernel, window system, and so on) of the specific operating system (if any) on which
5054the executable work runs, or a compiler used to produce the work, or an object code
5055interpreter used to run it.
5056
5057The &rdquor;Corresponding Source&rdquo; for a work in object code form means all the
5058source code needed to generate, install, and (for an executable work) run the object
5059code and to modify the work, including scripts to control those activities. However,
5060it does not include the work's System Libraries, or general-purpose tools or generally
5061available free programs which are used unmodified in performing those activities but
5062which are not part of the work. For example, Corresponding Source includes interface
5063definition files associated with source files for the work, and the source code for
5064shared libraries and dynamically linked subprograms that the work is specifically
5065designed to require, such as by intimate data communication or control flow between
5066those subprograms and other parts of the work.
5067
5068The Corresponding Source need not include anything that users can regenerate
5069automatically from other parts of the Corresponding Source.
5070
5071The Corresponding Source for a work in source code form is that same work.
50722. Basic Permissions.
5073
5074All rights granted under this License are granted for the term of copyright on the
5075Program, and are irrevocable provided the stated conditions are met. This License
5076explicitly affirms your unlimited permission to run the unmodified Program. The output
5077from running a covered work is covered by this License only if the output, given its
5078content, constitutes a covered work. This License acknowledges your rights of fair use
5079or other equivalent, as provided by copyright law.
5080
5081You may make, run and propagate covered works that you do not convey, without
5082conditions so long as your license otherwise remains in force. You may convey covered
5083works to others for the sole purpose of having them make modifications exclusively for
5084you, or provide you with facilities for running those works, provided that you comply
5085with the terms of this License in conveying all material for which you do not control
5086copyright. Those thus making or running the covered works for you must do so
5087exclusively on your behalf, under your direction and control, on terms that prohibit
5088them from making any copies of your copyrighted material outside their relationship
5089with you.
5090
5091Conveying under any other circumstances is permitted solely under the conditions
5092stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
50933. Protecting Users' Legal Rights From Anti-Circumvention Law.
5094
5095No covered work shall be deemed part of an effective technological measure under any
5096applicable law fulfilling obligations under article 11 of the WIPO copyright treaty
5097adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention
5098of such measures.
5099
5100When you convey a covered work, you waive any legal power to forbid circumvention of
5101technological measures to the extent such circumvention is effected by exercising
5102rights under this License with respect to the covered work, and you disclaim any
5103intention to limit operation or modification of the work as a means of enforcing,
5104against the work's users, your or third parties' legal rights to forbid circumvention
5105of technological measures.
51064. Conveying Verbatim Copies.
5107
5108You may convey verbatim copies of the Program's source code as you receive it, in any
5109medium, provided that you conspicuously and appropriately publish on each copy an
5110appropriate copyright notice; keep intact all notices stating that this License and
5111any non-permissive terms added in accord with section 7 apply to the code; keep intact
5112all notices of the absence of any warranty; and give all recipients a copy of this
5113License along with the Program.
5114
5115You may charge any price or no price for each copy that you convey, and you may offer
5116support or warranty protection for a fee.
51175. Conveying Modified Source Versions.
5118
5119You may convey a work based on the Program, or the modifications to produce it from
5120the Program, in the form of source code under the terms of section 4, provided that
5121you also meet all of these conditions:
5122
5123 * a) The work must carry prominent notices stating that you modified it, and
5124giving a relevant date.
5125 * b) The work must carry prominent notices stating that it is released under this
5126License and any conditions added under section 7. This requirement modifies the
5127requirement in section 4 to &rdquor;keep intact all notices&rdquo;.
5128 * c) You must license the entire work, as a whole, under this License to anyone
5129who comes into possession of a copy. This License will therefore apply, along with any
5130applicable section 7 additional terms, to the whole of the work, and all its parts,
5131regardless of how they are packaged. This License gives no permission to license the
5132work in any other way, but it does not invalidate such permission if you have
5133separately received it.
5134 * d) If the work has interactive user interfaces, each must display Appropriate
5135Legal Notices; however, if the Program has interactive interfaces that do not display
5136Appropriate Legal Notices, your work need not make them do so.
5137
5138A compilation of a covered work with other separate and independent works, which are
5139not by their nature extensions of the covered work, and which are not combined with it
5140such as to form a larger program, in or on a volume of a storage or distribution
5141medium, is called an &rdquor;aggregate&rdquo; if the compilation and its resulting
5142copyright are not used to limit the access or legal rights of the compilation's users
5143beyond what the individual works permit. Inclusion of a covered work in an aggregate
5144does not cause this License to apply to the other parts of the aggregate.
51456. Conveying Non-Source Forms.
5146
5147You may convey a covered work in object code form under the terms of sections 4 and 5,
5148provided that you also convey the machine-readable Corresponding Source under the
5149terms of this License, in one of these ways:
5150
5151 * a) Convey the object code in, or embodied in, a physical product (including a
5152physical distribution medium), accompanied by the Corresponding Source fixed on a
5153durable physical medium customarily used for software interchange.
5154 * b) Convey the object code in, or embodied in, a physical product (including a
5155physical distribution medium), accompanied by a written offer, valid for at least
5156three years and valid for as long as you offer spare parts or customer support for
5157that product model, to give anyone who possesses the object code either (1) a copy of
5158the Corresponding Source for all the software in the product that is covered by this
5159License, on a durable physical medium customarily used for software interchange, for a
5160price no more than your reasonable cost of physically performing this conveying of
5161source, or (2) access to copy the Corresponding Source from a network server at no
5162charge.
5163 * c) Convey individual copies of the object code with a copy of the written offer
5164to provide the Corresponding Source. This alternative is allowed only occasionally and
5165noncommercially, and only if you received the object code with such an offer, in
5166accord with subsection 6b.
5167 * d) Convey the object code by offering access from a designated place (gratis or
5168for a charge), and offer equivalent access to the Corresponding Source in the same way
5169through the same place at no further charge. You need not require recipients to copy
5170the Corresponding Source along with the object code. If the place to copy the object
5171code is a network server, the Corresponding Source may be on a different server
5172(operated by you or a third party) that supports equivalent copying facilities,
5173provided you maintain clear directions next to the object code saying where to find
5174the Corresponding Source. Regardless of what server hosts the Corresponding Source,
5175you remain obligated to ensure that it is available for as long as needed to satisfy
5176these requirements.
5177 * e) Convey the object code using peer-to-peer transmission, provided you inform
5178other peers where the object code and Corresponding Source of the work are being
5179offered to the general public at no charge under subsection 6d.
5180
5181A separable portion of the object code, whose source code is excluded from the
5182Corresponding Source as a System Library, need not be included in conveying the object
5183code work.
5184
5185A &rdquor;User Product&rdquo; is either (1) a &rdquor;consumer product&rdquo;, which
5186means any tangible personal property which is normally used for personal, family, or
5187household purposes, or (2) anything designed or sold for incorporation into a
5188dwelling. In determining whether a product is a consumer product, doubtful cases shall
5189be resolved in favor of coverage. For a particular product received by a particular
5190user, &rdquor;normally used&rdquo; refers to a typical or common use of that class of
5191product, regardless of the status of the particular user or of the way in which the
5192particular user actually uses, or expects or is expected to use, the product. A
5193product is a consumer product regardless of whether the product has substantial
5194commercial, industrial or non-consumer uses, unless such uses represent the only
5195significant mode of use of the product.
5196
5197&rdquor;Installation Information&rdquo; for a User Product means any methods,
5198procedures, authorization keys, or other information required to install and execute
5199modified versions of a covered work in that User Product from a modified version of
5200its Corresponding Source. The information must suffice to ensure that the continued
5201functioning of the modified object code is in no case prevented or interfered with
5202solely because modification has been made.
5203
5204If you convey an object code work under this section in, or with, or specifically for
5205use in, a User Product, and the conveying occurs as part of a transaction in which the
5206right of possession and use of the User Product is transferred to the recipient in
5207perpetuity or for a fixed term (regardless of how the transaction is characterized),
5208the Corresponding Source conveyed under this section must be accompanied by the
5209Installation Information. But this requirement does not apply if neither you nor any
5210third party retains the ability to install modified object code on the User Product
5211(for example, the work has been installed in ROM).
5212
5213The requirement to provide Installation Information does not include a requirement to
5214continue to provide support service, warranty, or updates for a work that has been
5215modified or installed by the recipient, or for the User Product in which it has been
5216modified or installed. Access to a network may be denied when the modification itself
5217materially and adversely affects the operation of the network or violates the rules
5218and protocols for communication across the network.
5219
5220Corresponding Source conveyed, and Installation Information provided, in accord with
5221this section must be in a format that is publicly documented (and with an
5222implementation available to the public in source code form), and must require no
5223special password or key for unpacking, reading or copying.
52247. Additional Terms.
5225
5226&rdquor;Additional permissions&rdquo; are terms that supplement the terms of this
5227License by making exceptions from one or more of its conditions. Additional
5228permissions that are applicable to the entire Program shall be treated as though they
5229were included in this License, to the extent that they are valid under applicable law.
5230If additional permissions apply only to part of the Program, that part may be used
5231separately under those permissions, but the entire Program remains governed by this
5232License without regard to the additional permissions.
5233
5234When you convey a copy of a covered work, you may at your option remove any additional
5235permissions from that copy, or from any part of it. (Additional permissions may be
5236written to require their own removal in certain cases when you modify the work.) You
5237may place additional permissions on material, added by you to a covered work, for
5238which you have or can give appropriate copyright permission.
5239
5240Notwithstanding any other provision of this License, for material you add to a covered
5241work, you may (if authorized by the copyright holders of that material) supplement the
5242terms of this License with terms:
5243
5244 * a) Disclaiming warranty or limiting liability differently from the terms of
5245sections 15 and 16 of this License; or
5246 * b) Requiring preservation of specified reasonable legal notices or author
5247attributions in that material or in the Appropriate Legal Notices displayed by works
5248containing it; or
5249 * c) Prohibiting misrepresentation of the origin of that material, or requiring
5250that modified versions of such material be marked in reasonable ways as different from
5251the original version; or
5252 * d) Limiting the use for publicity purposes of names of licensors or authors of
5253the material; or
5254 * e) Declining to grant rights under trademark law for use of some trade names,
5255trademarks, or service marks; or
5256 * f) Requiring indemnification of licensors and authors of that material by anyone
5257who conveys the material (or modified versions of it) with contractual assumptions of
5258liability to the recipient, for any liability that these contractual assumptions
5259directly impose on those licensors and authors.
5260
5261All other non-permissive additional terms are considered &rdquor;further
5262restrictions&rdquo; within the meaning of section 10. If the Program as you received
5263it, or any part of it, contains a notice stating that it is governed by this License
5264along with a term that is a further restriction, you may remove that term. If a
5265license document contains a further restriction but permits relicensing or conveying
5266under this License, you may add to a covered work material governed by the terms of
5267that license document, provided that the further restriction does not survive such
5268relicensing or conveying.
5269
5270If you add terms to a covered work in accord with this section, you must place, in the
5271relevant source files, a statement of the additional terms that apply to those files,
5272or a notice indicating where to find the applicable terms.
5273
5274Additional terms, permissive or non-permissive, may be stated in the form of a
5275separately written license, or stated as exceptions; the above requirements apply
5276either way.
52778. Termination.
5278
5279You may not propagate or modify a covered work except as expressly provided under this
5280License. Any attempt otherwise to propagate or modify it is void, and will
5281automatically terminate your rights under this License (including any patent licenses
5282granted under the third paragraph of section 11).
5283
5284However, if you cease all violation of this License, then your license from a
5285particular copyright holder is reinstated (a) provisionally, unless and until the
5286copyright holder explicitly and finally terminates your license, and (b) permanently,
5287if the copyright holder fails to notify you of the violation by some reasonable means
5288prior to 60 days after the cessation.
5289
5290Moreover, your license from a particular copyright holder is reinstated permanently if
5291the copyright holder notifies you of the violation by some reasonable means, this is
5292the first time you have received notice of violation of this License (for any work)
5293from that copyright holder, and you cure the violation prior to 30 days after your
5294receipt of the notice.
5295
5296Termination of your rights under this section does not terminate the licenses of
5297parties who have received copies or rights from you under this License. If your rights
5298have been terminated and not permanently reinstated, you do not qualify to receive new
5299licenses for the same material under section 10.
53009. Acceptance Not Required for Having Copies.
5301
5302You are not required to accept this License in order to receive or run a copy of the
5303Program. Ancillary propagation of a covered work occurring solely as a consequence of
5304using peer-to-peer transmission to receive a copy likewise does not require
5305acceptance. However, nothing other than this License grants you permission to
5306propagate or modify any covered work. These actions infringe copyright if you do not
5307accept this License. Therefore, by modifying or propagating a covered work, you
5308indicate your acceptance of this License to do so.
530910. Automatic Licensing of Downstream Recipients.
5310
5311Each time you convey a covered work, the recipient automatically receives a license
5312from the original licensors, to run, modify and propagate that work, subject to this
5313License. You are not responsible for enforcing compliance by third parties with this
5314License.
5315
5316An &rdquor;entity transaction&rdquo; is a transaction transferring control of an
5317organization, or substantially all assets of one, or subdividing an organization, or
5318merging organizations. If propagation of a covered work results from an entity
5319transaction, each party to that transaction who receives a copy of the work also
5320receives whatever licenses to the work the party's predecessor in interest had or
5321could give under the previous paragraph, plus a right to possession of the
5322Corresponding Source of the work from the predecessor in interest, if the predecessor
5323has it or can get it with reasonable efforts.
5324
5325You may not impose any further restrictions on the exercise of the rights granted or
5326affirmed under this License. For example, you may not impose a license fee, royalty,
5327or other charge for exercise of rights granted under this License, and you may not
5328initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging
5329that any patent claim is infringed by making, using, selling, offering for sale, or
5330importing the Program or any portion of it.
533111. Patents.
5332
5333A &rdquor;contributor&rdquo; is a copyright holder who authorizes use under this
5334License of the Program or a work on which the Program is based. The work thus licensed
5335is called the contributor's &rdquor;contributor version&rdquo;.
5336
5337A contributor's &rdquor;essential patent claims&rdquo; are all patent claims owned or
5338controlled by the contributor, whether already acquired or hereafter acquired, that
5339would be infringed by some manner, permitted by this License, of making, using, or
5340selling its contributor version, but do not include claims that would be infringed
5341only as a consequence of further modification of the contributor version. For purposes
5342of this definition, &rdquor;control&rdquo; includes the right to grant patent
5343sublicenses in a manner consistent with the requirements of this License.
5344
5345Each contributor grants you a non-exclusive, worldwide, royalty-free patent license
5346under the contributor's essential patent claims, to make, use, sell, offer for sale,
5347import and otherwise run, modify and propagate the contents of its contributor
5348version.
5349
5350In the following three paragraphs, a &rdquor;patent license&rdquo; is any express
5351agreement or commitment, however denominated, not to enforce a patent (such as an
5352express permission to practice a patent or covenant not to sue for patent
5353infringement). To &rdquor;grant&rdquo; such a patent license to a party means to make
5354such an agreement or commitment not to enforce a patent against the party.
5355
5356If you convey a covered work, knowingly relying on a patent license, and the
5357Corresponding Source of the work is not available for anyone to copy, free of charge
5358and under the terms of this License, through a publicly available network server or
5359other readily accessible means, then you must either (1) cause the Corresponding
5360Source to be so available, or (2) arrange to deprive yourself of the benefit of the
5361patent license for this particular work, or (3) arrange, in a manner consistent with
5362the requirements of this License, to extend the patent license to downstream
5363recipients. &rdquor;Knowingly relying&rdquo; means you have actual knowledge that, but
5364for the patent license, your conveying the covered work in a country, or your
5365recipient's use of the covered work in a country, would infringe one or more
5366identifiable patents in that country that you have reason to believe are valid.
5367
5368If, pursuant to or in connection with a single transaction or arrangement, you convey,
5369or propagate by procuring conveyance of, a covered work, and grant a patent license to
5370some of the parties receiving the covered work authorizing them to use, propagate,
5371modify or convey a specific copy of the covered work, then the patent license you
5372grant is automatically extended to all recipients of the covered work and works based
5373on it.
5374
5375A patent license is &rdquor;discriminatory&rdquo; if it does not include within the
5376scope of its coverage, prohibits the exercise of, or is conditioned on the
5377non-exercise of one or more of the rights that are specifically granted under this
5378License. You may not convey a covered work if you are a party to an arrangement with a
5379third party that is in the business of distributing software, under which you make
5380payment to the third party based on the extent of your activity of conveying the work,
5381and under which the third party grants, to any of the parties who would receive the
5382covered work from you, a discriminatory patent license (a) in connection with copies
5383of the covered work conveyed by you (or copies made from those copies), or (b)
5384primarily for and in connection with specific products or compilations that contain
5385the covered work, unless you entered into that arrangement, or that patent license was
5386granted, prior to 28 March 2007.
5387
5388Nothing in this License shall be construed as excluding or limiting any implied
5389license or other defenses to infringement that may otherwise be available to you under
5390applicable patent law.
539112. No Surrender of Others' Freedom.
5392
5393If conditions are imposed on you (whether by court order, agreement or otherwise) that
5394contradict the conditions of this License, they do not excuse you from the conditions
5395of this License. If you cannot convey a covered work so as to satisfy simultaneously
5396your obligations under this License and any other pertinent obligations, then as a
5397consequence you may not convey it at all. For example, if you agree to terms that
5398obligate you to collect a royalty for further conveying from those to whom you convey
5399the Program, the only way you could satisfy both those terms and this License would be
5400to refrain entirely from conveying the Program.
540113. Use with the GNU Affero General Public License.
5402
5403Notwithstanding any other provision of this License, you have permission to link or
5404combine any covered work with a work licensed under version 3 of the GNU Affero
5405General Public License into a single combined work, and to convey the resulting work.
5406The terms of this License will continue to apply to the part which is the covered
5407work, but the special requirements of the GNU Affero General Public License, section
540813, concerning interaction through a network will apply to the combination as such.
540914. Revised Versions of this License.
5410
5411The Free Software Foundation may publish revised and/or new versions of the GNU
5412General Public License from time to time. Such new versions will be similar in spirit
5413to the present version, but may differ in detail to address new problems or concerns.
5414
5415Each version is given a distinguishing version number. If the Program specifies that a
5416certain numbered version of the GNU General Public License &rdquor;or any later
5417version&rdquo; applies to it, you have the option of following the terms and
5418conditions either of that numbered version or of any later version published by the
5419Free Software Foundation. If the Program does not specify a version number of the GNU
5420General Public License, you may choose any version ever published by the Free Software
5421Foundation.
5422
5423If the Program specifies that a proxy can decide which future versions of the GNU
5424General Public License can be used, that proxy's public statement of acceptance of a
5425version permanently authorizes you to choose that version for the Program.
5426
5427Later license versions may give you additional or different permissions. However, no
5428additional obligations are imposed on any author or copyright holder as a result of
5429your choosing to follow a later version.
543015. Disclaimer of Warranty.
5431
5432THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
5433EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
5434PROVIDE THE PROGRAM &rdquor;AS IS&rdquo; WITHOUT WARRANTY OF ANY KIND, EITHER
5435EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
5436MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
5437QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
5438DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
543916. Limitation of Liability.
5440
5441IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
5442COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS
5443PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
5444INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
5445PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
5446OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
5447WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
5448POSSIBILITY OF SUCH DAMAGES.
544917. Interpretation of Sections 15 and 16.
5450
5451If the disclaimer of warranty and limitation of liability provided above cannot be
5452given local legal effect according to their terms, reviewing courts shall apply local
5453law that most closely approximates an absolute waiver of all civil liability in
5454connection with the Program, unless a warranty or assumption of liability accompanies
5455a copy of the Program in return for a fee.
5456
5457END OF TERMS AND CONDITIONS
5458How to Apply These Terms to Your New Programs
5459
5460If you develop a new program, and you want it to be of the greatest possible use to
5461the public, the best way to achieve this is to make it free software which everyone
5462can redistribute and change under these terms.
5463
5464To do so, attach the following notices to the program. It is safest to attach them to
5465the start of each source file to most effectively state the exclusion of warranty; and
5466each file should have at least the &rdquor;copyright&rdquo; line and a pointer to
5467where the full notice is found.
5468
5469 &lt;one line to give the program's name and a brief idea of what it does.&gt;
5470 Copyright (C) &lt;year&gt; &lt;name of author&gt;
5471
5472 This program is free software: you can redistribute it and/or modify
5473 it under the terms of the GNU General Public License as published by
5474 the Free Software Foundation, either version 3 of the License, or
5475 (at your option) any later version.
5476
5477 This program is distributed in the hope that it will be useful,
5478 but WITHOUT ANY WARRANTY; without even the implied warranty of
5479 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
5480 GNU General Public License for more details.
5481
5482 You should have received a copy of the GNU General Public License
5483 along with this program. If not, see &lt;http://www.gnu.org/licenses/&gt;.
5484
5485Also add information on how to contact you by electronic and paper mail.
5486
5487If the program does terminal interaction, make it output a short notice like this when
5488it starts in an interactive mode:
5489
5490 &lt;program&gt; Copyright (C) &lt;year&gt; &lt;name of author&gt;
5491 This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
5492 This is free software, and you are welcome to redistribute it
5493 under certain conditions; type `show c' for details.
5494
5495The hypothetical commands `show w' and `show c' should show the appropriate parts of
5496the General Public License. Of course, your program's commands might be different; for
5497a GUI interface, you would use an &rdquor;about box&rdquo;.
5498
5499You should also get your employer (if you work as a programmer) or school, if any, to
5500sign a &rdquor;copyright disclaimer&rdquo; for the program, if necessary. For more
5501information on this, and how to apply and follow the GNU GPL, see
5502&lt;http://www.gnu.org/licenses/&gt;.
5503
5504The GNU General Public License does not permit incorporating your program into
5505proprietary programs. If your program is a subroutine library, you may consider it
5506more useful to permit linking proprietary applications with the library. If this is
5507what you want to do, use the GNU Lesser General Public License instead of this
5508License. But first, please read
5509&lt;http://www.gnu.org/philosophy/why-not-lgpl.html&gt;.
5510</programlisting></para></section>
5511
5512<section id="lic_22">
5513<title>GPL-3.0-with-GCC-exception</title>
5514<para><programlisting>
5515
5516insert GPL v3 text here
5517
5518GCC RUNTIME LIBRARY EXCEPTION
5519Version 3.1, 31 March 2009
5520
5521General information:
5522http://www.gnu.org/licenses/gcc-exception.html
5523Copyright (C) 2009 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
5524Everyone is permitted to copy and distribute verbatim copies of this license document,
5525but changing it is not allowed.
5526This GCC Runtime Library Exception ("Exception") is an additional permission under
5527section 7 of the GNU General Public License, version 3 ("GPLv3"). It applies to a
5528given file (the "Runtime Library") that bears a notice placed by the copyright holder
5529of the file stating that the file is governed by GPLv3 along with this Exception.
5530When you use GCC to compile a program, GCC may combine portions of certain GCC header
5531files and runtime libraries with the compiled program. The purpose of this Exception
5532is to allow compilation of non-GPL (including proprietary) programs to use, in this
5533way, the header files and runtime libraries covered by this Exception.
5534
55350. Definitions.
5536A file is an "Independent Module" if it either requires the Runtime Library for
5537execution after a Compilation Process, or makes use of an interface provided by the
5538Runtime Library, but is not otherwise based on the Runtime Library.
5539"GCC" means a version of the GNU Compiler Collection, with or without modifications,
5540governed by version 3 (or a specified later version) of the GNU General Public License
5541(GPL) with the option of using any subsequent versions published by the FSF.
5542"GPL-compatible Software" is software whose conditions of propagation, modification
5543and use would permit combination with GCC in accord with the license of GCC.
5544"Target Code" refers to output from any compiler for a real or virtual target
5545processor architecture, in executable form or suitable for input to an assembler,
5546loader, linker and/or execution phase. Notwithstanding that, Target Code does not
5547include data in any format that is used as a compiler intermediate representation, or
5548used for producing a compiler intermediate representation.
5549The "Compilation Process" transforms code entirely represented in non-intermediate
5550languages designed for human-written code, and/or in Java Virtual Machine byte code,
5551into Target Code. Thus, for example, use of source code generators and preprocessors
5552need not be considered part of the Compilation Process, since the Compilation Process
5553can be understood as starting with the output of the generators or preprocessors.
5554A Compilation Process is "Eligible" if it is done using GCC, alone or with other
5555GPL-compatible software, or if it is done without using any work based on GCC. For
5556example, using non-GPL-compatible Software to optimize any GCC intermediate
5557representations would not qualify as an Eligible Compilation Process.
5558
55591. Grant of Additional Permission.
5560You have permission to propagate a work of Target Code formed by combining the Runtime
5561Library with Independent Modules, even if such propagation would otherwise violate the
5562terms of GPLv3, provided that all Target Code was generated by Eligible Compilation
5563Processes. You may then convey such a combination under terms of your choice,
5564consistent with the licensing of the Independent Modules.
5565
55662. No Weakening of GCC Copyleft.
5567The availability of this Exception does not imply any general presumption that
5568third-party software is unaffected by the copyleft requirements of the license of GCC.
5569
5570</programlisting></para></section>
5571
5572<section id="lic_23">
5573<title>GPL-3.0-with-autoconf-exception</title>
5574<para><programlisting>
5575
5576insert GPL v3 text here
5577
5578AUTOCONF CONFIGURE SCRIPT EXCEPTION
5579
5580Version 3.0, 18 August 2009
5581
5582Copyright &amp;#169; 2009 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
5583
5584Everyone is permitted to copy and distribute verbatim copies of this license document,
5585but changing it is not allowed.
5586
5587This Exception is an additional permission under section 7 of the GNU General Public
5588License, version 3 ("GPLv3"). It applies to a given file that bears a notice placed by
5589the copyright holder of the file stating that the file is governed by GPLv3 along with
5590this Exception.
5591
5592The purpose of this Exception is to allow distribution of Autoconf`s typical output
5593under terms of the recipient`s choice (including proprietary).
5594
55950. Definitions.
5596"Covered Code" is the source or object code of a version of Autoconf that is a covered
5597work under this License.
5598
5599"Normally Copied Code" for a version of Autoconf means all parts of its Covered Code
5600which that version can copy from its code (i.e., not from its input file) into its
5601minimally verbose, non-debugging and non-tracing output.
5602
5603"Ineligible Code" is Covered Code that is not Normally Copied Code.
5604
56051. Grant of Additional Permission.
5606You have permission to propagate output of Autoconf, even if such propagation would
5607otherwise violate the terms of GPLv3. However, if by modifying Autoconf you cause any
5608Ineligible Code of the version you received to become Normally Copied Code of your
5609modified version, then you void this Exception for the resulting covered work. If you
5610convey that resulting covered work, you must remove this Exception in accordance with
5611the second paragraph of Section 7 of GPLv3.
5612
56132. No Weakening of Autoconf Copyleft.
5614The availability of this Exception does not imply any general presumption that
5615third-party software is unaffected by the copyleft requirements of the license of
5616Autoconf.
5617
5618</programlisting></para></section>
5619
5620<section id="lic_24">
5621<title>ICU</title>
5622<para><programlisting>
5623COPYRIGHT AND PERMISSION NOTICE
5624
5625Copyright (c) 1995-2012 International Business Machines Corporation and others
5626
5627All rights reserved.
5628
5629Permission is hereby granted, free of charge, to any person obtaining a copy of this
5630software and associated documentation files (the "Software"), to deal in the Software
5631without restriction, including without limitation the rights to use, copy, modify,
5632merge, publish, distribute, and/or sell copies of the Software, and to permit persons
5633to whom the Software is furnished to do so, provided that the above copyright
5634notice(s) and this permission notice appear in all copies of the Software and that
5635both the above copyright notice(s) and this permission notice appear in supporting
5636documentation.
5637
5638THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
5639INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
5640PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE
5641COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY
5642SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM
5643LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
5644TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
5645SOFTWARE.
5646
5647Except as contained in this notice, the name of a copyright holder shall not be used
5648in advertising or otherwise to promote the sale, use or other dealings in this
5649Software without prior written authorization of the copyright holder.
5650
5651All trademarks and registered trademarks mentioned herein are the property of their
5652respective owners.
5653</programlisting></para></section>
5654
5655<section id="lic_25">
5656<title>IPL-1.0</title>
5657<para><programlisting>
5658
5659IBM Public License Version 1.0
5660
5661THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS IBM
5662PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION
5663OF THE PROGRAM CONSTITUTES RECIPIENT`S ACCEPTANCE OF THIS AGREEMENT.
5664
56651. DEFINITIONS
5666"Contribution" means:
5667
5668in the case of International Business Machines Corporation ("IBM"), the Original
5669Program, and
5670in the case of each Contributor,
5671changes to the Program, and
5672additions to the Program;
5673where such changes and/or additions to the Program originate from and
5674are distributed by that particular Contributor. A Contribution
5675`originates` from a Contributor if it was added to the Program by
5676such Contributor itself or anyone acting on such Contributor`s
5677behalf. Contributions do not include additions to the Program which:
5678(i) are separate modules of software distributed in conjunction with
5679the Program under their own license agreement, and (ii) are not
5680derivative works of the Program.
5681
5682"Contributor" means IBM and any other entity that distributes the Program.
5683
5684"Licensed Patents " mean patent claims licensable by a
5685Contributor which are necessarily infringed by the use or sale of its
5686Contribution alone or when combined with the Program.
5687
5688"Original Program" means the original version of the software
5689accompanying this Agreement as released by IBM, including source
5690code, object code and documentation, if any.
5691
5692"Program" means the Original Program and Contributions.
5693
5694"Recipient" means anyone who receives the Program under this
5695Agreement, including all Contributors.
5696
56972. GRANT OF RIGHTS
5698Subject to the terms of this Agreement, each Contributor hereby
5699grants Recipient a non-exclusive, worldwide, royalty-free copyright
5700license to reproduce, prepare derivative works of, publicly display,
5701publicly perform, distribute and sublicense the Contribution of such
5702Contributor, if any, and such derivative works, in source code and
5703object code form.
5704Subject to the terms of this Agreement, each Contributor hereby
5705grants Recipient a non-exclusive, worldwide, royalty-free patent
5706license under Licensed Patents to make, use, sell, offer to sell,
5707import and otherwise transfer the Contribution of such Contributor,
5708if any, in source code and object code form. This patent license
5709shall apply to the combination of the Contribution and the Program
5710if, at the time the Contribution is added by the Contributor, such
5711addition of the Contribution causes such combination to be covered by
5712the Licensed Patents. The patent license shall not apply to any
5713other combinations which include the Contribution. No hardware per
5714se is licensed hereunder.
5715
5716Recipient understands that although each Contributor grants the
5717licenses to its Contributions set forth herein, no assurances are
5718provided by any Contributor that the Program does not infringe the
5719patent or other intellectual property rights of any other entity.
5720Each Contributor disclaims any liability to Recipient for claims
5721brought by any other entity based on infringement of intellectual
5722property rights or otherwise. As a condition to exercising the
5723rights and licenses granted hereunder, each Recipient hereby assumes
5724sole responsibility to secure any other intellectual property rights
5725needed, if any. For example, if a third party patent license is
5726required to allow Recipient to distribute the Program, it is
5727Recipient`s responsibility to acquire that license before
5728distributing the Program.
5729Each Contributor represents that to its knowledge it has
5730sufficient copyright rights in its Contribution, if any, to grant the
5731copyright license set forth in this Agreement.
57323. REQUIREMENTS
5733A Contributor may choose to distribute
5734the Program in object code form under its own license agreement,
5735provided that:
5736
5737it complies with the terms and conditions of this Agreement; and
5738its license agreement:
5739effectively disclaims on behalf of all Contributors all warranties
5740and conditions, express and implied, including warranties or
5741conditions of title and non-infringement, and implied warranties or
5742conditions of merchantability and fitness for a particular purpose;
5743effectively excludes on behalf of all Contributors all liability
5744for damages, including direct, indirect, special, incidental and
5745consequential damages, such as lost profits;
5746states that any provisions which differ from this Agreement are
5747offered by that Contributor alone and not by any other party; and
5748
5749states that source code for the Program is available from such
5750Contributor, and informs licensees how to obtain it in a reasonable
5751manner on or through a medium customarily used for software exchange.
5752When the Program is made available in source code form:
5753
5754it must be made available under this Agreement; and
5755a copy of this Agreement must be included with each copy of the
5756Program.
5757Each Contributor must include the following in a conspicuous location in the Program:
5758
5759Copyright (C) 1996, 1999 International Business Machines Corporation and others. All
5760Rights Reserved.
5761
5762In addition, each Contributor must identify itself as the originator
5763of its Contribution, if any, in a manner that reasonably allows
5764subsequent Recipients to identify the originator of the Contribution.
5765
57664. COMMERCIAL DISTRIBUTION
5767Commercial distributors of software may accept certain
5768responsibilities with respect to end users, business partners and the
5769like. While this license is intended to facilitate the commercial
5770use of the Program, the Contributor who includes the Program in a
5771commercial product offering should do so in a manner which does not
5772create potential liability for other Contributors. Therefore, if a
5773Contributor includes the Program in a commercial product offering,
5774such Contributor ("Commercial Contributor") hereby agrees to defend
5775and indemnify every other Contributor ("Indemnified Contributor")
5776against any losses, damages and costs (collectively "Losses") arising
5777from claims, lawsuits and other legal actions brought by a third
5778party against the Indemnified Contributor to the extent caused by the
5779acts or omissions of such Commercial Contributor in connection with
5780its distribution of the Program in a commercial product offering.
5781The obligations in this section do not apply to any claims or Losses
5782relating to any actual or alleged intellectual property infringement.
5783In order to qualify, an Indemnified Contributor must: a) promptly
5784notify the Commercial Contributor in writing of such claim, and b)
5785allow the Commercial Contributor to control, and cooperate with the
5786Commercial Contributor in, the defense and any related settlement
5787negotiations. The Indemnified Contributor may participate in any
5788such claim at its own expense.
5789
5790For example, a Contributor might include the Program in a commercial
5791product offering, Product X. That Contributor is then a Commercial
5792Contributor. If that Commercial Contributor then makes performance
5793claims, or offers warranties related to Product X, those performance
5794claims and warranties are such Commercial Contributor`s
5795responsibility alone. Under this section, the Commercial Contributor
5796would have to defend claims against the other Contributors related to
5797those performance claims and warranties, and if a court requires any
5798other Contributor to pay any damages as a result, the Commercial
5799Contributor must pay those damages.
5800
58015. NO WARRANTY
5802EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS
5803PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
5804KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY
5805WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY
5806OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely
5807responsible for determining the appropriateness of using and
5808distributing the Program and assumes all risks associated with its
5809exercise of rights under this Agreement, including but not limited to
5810the risks and costs of program errors, compliance with applicable
5811laws, damage to or loss of data, programs or equipment, and
5812unavailability or interruption of operations.
5813
58146. DISCLAIMER OF LIABILITY
5815EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT
5816NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT,
5817INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
5818(INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON
5819ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
5820TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
5821THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS
5822GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
5823
58247. GENERAL
5825If any provision of this Agreement is invalid or unenforceable under
5826applicable law, it shall not affect the validity or enforceability of
5827the remainder of the terms of this Agreement, and without further
5828action by the parties hereto, such provision shall be reformed to the
5829minimum extent necessary to make such provision valid and enforceable.
5830
5831If Recipient institutes patent litigation against a Contributor with
5832respect to a patent applicable to software (including a cross-claim
5833or counterclaim in a lawsuit), then any patent licenses granted by
5834that Contributor to such Recipient under this Agreement shall
5835terminate as of the date such litigation is filed. In addition, if
5836Recipient institutes patent litigation against any entity (including
5837a cross-claim or counterclaim in a lawsuit) alleging that the Program
5838itself (excluding combinations of the Program with other software or
5839hardware) infringes such Recipient`s patent(s), then such Recipient`s
5840rights granted under Section 2(b) shall terminate as of the date such
5841litigation is filed.
5842
5843All Recipient`s rights under this Agreement shall terminate if it
5844fails to comply with any of the material terms or conditions of this
5845Agreement and does not cure such failure in a reasonable period of
5846time after becoming aware of such noncompliance. If all Recipient`s
5847rights under this Agreement terminate, Recipient agrees to cease use
5848and distribution of the Program as soon as reasonably practicable.
5849However, Recipient`s obligations under this Agreement and any
5850licenses granted by Recipient relating to the Program shall continue
5851and survive.
5852
5853IBM may publish new versions (including revisions) of this Agreement
5854from time to time. Each new version of the Agreement will be given a
5855distinguishing version number. The Program (including Contributions)
5856may always be distributed subject to the version of the Agreement
5857under which it was received. In addition, after a new version of the
5858Agreement is published, Contributor may elect to distribute the
5859Program (including its Contributions) under the new version. No one
5860other than IBM has the right to modify this Agreement. Except as
5861expressly stated in Sections 2(a) and 2(b) above, Recipient receives
5862no rights or licenses to the intellectual property of any Contributor
5863under this Agreement, whether expressly, by implication, estoppel or
5864otherwise. All rights in the Program not expressly granted under
5865this Agreement are reserved.
5866
5867This Agreement is governed by the laws of the State of New York and
5868the intellectual property laws of the United States of America. No
5869party to this Agreement will bring a legal action under this
5870Agreement more than one year after the cause of action arose. Each
5871party waives its rights to a jury trial in any resulting litigation.
5872
5873</programlisting></para></section>
5874
5875<section id="lic_26">
5876<title>ISC</title>
5877<para><programlisting>
5878
5879ISC License:
5880
5881Copyright &amp;#169; 2004-2010 by Internet Systems Consortium, Inc. ("ISC")
5882Copyright &amp;#169; 1995-2003 by Internet Software Consortium
5883
5884Permission to use, copy, modify, and/or distribute this software for any purpose with
5885or without fee is hereby granted, provided that the above copyright notice and this
5886permission notice appear in all copies.
5887
5888THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
5889SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT
5890SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
5891DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
5892OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH
5893THE USE OR PERFORMANCE OF THIS SOFTWARE.
5894
5895</programlisting></para></section>
5896
5897<section id="lic_27">
5898<title>JLEX</title>
5899<para><programlisting>
5900 JLEX COPYRIGHT NOTICE, LICENSE, AND DISCLAIMER
5901 Copyright 1996-2000 by Elliot Joel Berk and C. Scott Ananian
5902
5903 Permission to use, copy, modify, and distribute this software and its
5904 documentation for any purpose and without fee is hereby granted,
5905 provided that the above copyright notice appear in all copies and that
5906 both the copyright notice and this permission notice and warranty
5907 disclaimer appear in supporting documentation, and that the name of
5908 the authors or their employers not be used in advertising or publicity
5909 pertaining to distribution of the software without specific, written
5910 prior permission.
5911
5912 The authors and their employers disclaim all warranties with regard to
5913 this software, including all implied warranties of merchantability and
5914 fitness. In no event shall the authors or their employers be liable
5915 for any special, indirect or consequential damages or any damages
5916 whatsoever resulting from loss of use, data or profits, whether in an
5917 action of contract, negligence or other tortious action, arising out
5918 of or in connection with the use or performance of this software.
5919</programlisting></para></section>
5920
5921<section id="lic_28">
5922<title>LGPL-2.0</title>
5923<para><programlisting>
5924GNU LIBRARY GENERAL PUBLIC LICENSE
5925
5926
5927
5928Version 2, June 1991
5929
5930
5931
5932Copyright (C) 1991 Free Software Foundation, Inc.
5933
593451 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
5935
5936Everyone is permitted to copy and distribute verbatim copies
5937
5938of this license document, but changing it is not allowed.
5939
5940
5941
5942[This is the first released version of the library GPL. It is
5943
5944 numbered 2 because it goes with version 2 of the ordinary GPL.]
5945
5946Preamble
5947
5948
5949
5950The licenses for most software are designed to take away your freedom to share and
5951change it. By contrast, the GNU General Public Licenses are intended to guarantee your
5952freedom to share and change free software--to make sure the software is free for all
5953its users.
5954
5955
5956
5957This license, the Library General Public License, applies to some specially designated
5958Free Software Foundation software, and to any other libraries whose authors decide to
5959use it. You can use it for your libraries, too.
5960
5961
5962
5963When we speak of free software, we are referring to freedom, not price. Our General
5964Public Licenses are designed to make sure that you have the freedom to distribute
5965copies of free software (and charge for this service if you wish), that you receive
5966source code or can get it if you want it, that you can change the software or use
5967pieces of it in new free programs; and that you know you can do these things.
5968
5969
5970
5971To protect your rights, we need to make restrictions that forbid anyone to deny you
5972these rights or to ask you to surrender the rights. These restrictions translate to
5973certain responsibilities for you if you distribute copies of the library, or if you
5974modify it.
5975
5976
5977
5978For example, if you distribute copies of the library, whether gratis or for a fee, you
5979must give the recipients all the rights that we gave you. You must make sure that
5980they, too, receive or can get the source code. If you link a program with the library,
5981you must provide complete object files to the recipients so that they can relink them
5982with the library, after making changes to the library and recompiling it. And you must
5983show them these terms so they know their rights.
5984
5985
5986
5987Our method of protecting your rights has two steps: (1) copyright the library, and (2)
5988offer you this license which gives you legal permission to copy, distribute and/or
5989modify the library.
5990
5991
5992
5993Also, for each distributor's protection, we want to make certain that everyone
5994understands that there is no warranty for this free library. If the library is
5995modified by someone else and passed on, we want its recipients to know that what they
5996have is not the original version, so that any problems introduced by others will not
5997reflect on the original authors' reputations.
5998
5999
6000
6001Finally, any free program is threatened constantly by software patents. We wish to
6002avoid the danger that companies distributing free software will individually obtain
6003patent licenses, thus in effect transforming the program into proprietary software. To
6004prevent this, we have made it clear that any patent must be licensed for everyone's
6005free use or not licensed at all.
6006
6007
6008
6009Most GNU software, including some libraries, is covered by the ordinary GNU General
6010Public License, which was designed for utility programs. This license, the GNU Library
6011General Public License, applies to certain designated libraries. This license is quite
6012different from the ordinary one; be sure to read it in full, and don't assume that
6013anything in it is the same as in the ordinary license.
6014
6015
6016
6017The reason we have a separate public license for some libraries is that they blur the
6018distinction we usually make between modifying or adding to a program and simply using
6019it. Linking a program with a library, without changing the library, is in some sense
6020simply using the library, and is analogous to running a utility program or application
6021program. However, in a textual and legal sense, the linked executable is a combined
6022work, a derivative of the original library, and the ordinary General Public License
6023treats it as such.
6024
6025
6026
6027Because of this blurred distinction, using the ordinary General Public License for
6028libraries did not effectively promote software sharing, because most developers did
6029not use the libraries. We concluded that weaker conditions might promote sharing
6030better.
6031
6032
6033
6034However, unrestricted linking of non-free programs would deprive the users of those
6035programs of all benefit from the free status of the libraries themselves. This Library
6036General Public License is intended to permit developers of non-free programs to use
6037free libraries, while preserving your freedom as a user of such programs to change the
6038free libraries that are incorporated in them. (We have not seen how to achieve this as
6039regards changes in header files, but we have achieved it as regards changes in the
6040actual functions of the Library.) The hope is that this will lead to faster
6041development of free libraries.
6042
6043
6044
6045The precise terms and conditions for copying, distribution and modification follow.
6046Pay close attention to the difference between a "work based on the library" and a
6047"work that uses the library". The former contains code derived from the library, while
6048the latter only works together with the library.
6049
6050
6051
6052Note that it is possible for a library to be covered by the ordinary General Public
6053License rather than by this special one.
6054
6055
6056
6057TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
6058
6059
6060
60610. This License Agreement applies to any software library which contains a notice
6062placed by the copyright holder or other authorized party saying it may be distributed
6063under the terms of this Library General Public License (also called "this License").
6064Each licensee is addressed as "you".
6065
6066
6067
6068A "library" means a collection of software functions and/or data prepared so as to be
6069conveniently linked with application programs (which use some of those functions and
6070data) to form executables.
6071
6072
6073
6074The "Library", below, refers to any such software library or work which has been
6075distributed under these terms. A "work based on the Library" means either the Library
6076or any derivative work under copyright law: that is to say, a work containing the
6077Library or a portion of it, either verbatim or with modifications and/or translated
6078straightforwardly into another language. (Hereinafter, translation is included without
6079limitation in the term "modification".)
6080
6081
6082
6083"Source code" for a work means the preferred form of the work for making modifications
6084to it. For a library, complete source code means all the source code for all modules
6085it contains, plus any associated interface definition files, plus the scripts used to
6086control compilation and installation of the library.
6087
6088
6089
6090Activities other than copying, distribution and modification are not covered by this
6091License; they are outside its scope. The act of running a program using the Library is
6092not restricted, and output from such a program is covered only if its contents
6093constitute a work based on the Library (independent of the use of the Library in a
6094tool for writing it). Whether that is true depends on what the Library does and what
6095the program that uses the Library does.
6096
6097
6098
60991. You may copy and distribute verbatim copies of the Library's complete source code
6100as you receive it, in any medium, provided that you conspicuously and appropriately
6101publish on each copy an appropriate copyright notice and disclaimer of warranty; keep
6102intact all the notices that refer to this License and to the absence of any warranty;
6103and distribute a copy of this License along with the Library.
6104
6105
6106
6107You may charge a fee for the physical act of transferring a copy, and you may at your
6108option offer warranty protection in exchange for a fee.
6109
6110
6111
61122. You may modify your copy or copies of the Library or any portion of it, thus
6113forming a work based on the Library, and copy and distribute such modifications or
6114work under the terms of Section 1 above, provided that you also meet all of these
6115conditions:
6116
6117
6118
6119a) The modified work must itself be a software library.
6120
6121b) You must cause the files modified to carry prominent notices stating that you
6122changed the files and the date of any change.
6123
6124c) You must cause the whole of the work to be licensed at no charge to all third
6125parties under the terms of this License.
6126
6127d) If a facility in the modified Library refers to a function or a table of data to be
6128supplied by an application program that uses the facility, other than as an argument
6129passed when the facility is invoked, then you must make a good faith effort to ensure
6130that, in the event an application does not supply such function or table, the facility
6131still operates, and performs whatever part of its purpose remains meaningful.
6132
6133(For example, a function in a library to compute square roots has a purpose that is
6134entirely well-defined independent of the application. Therefore, Subsection 2d
6135requires that any application-supplied function or table used by this function must be
6136optional: if the application does not supply it, the square root function must still
6137compute square roots.)
6138
6139
6140
6141These requirements apply to the modified work as a whole. If identifiable sections of
6142that work are not derived from the Library, and can be reasonably considered
6143independent and separate works in themselves, then this License, and its terms, do not
6144apply to those sections when you distribute them as separate works. But when you
6145distribute the same sections as part of a whole which is a work based on the Library,
6146the distribution of the whole must be on the terms of this License, whose permissions
6147for other licensees extend to the entire whole, and thus to each and every part
6148regardless of who wrote it.
6149
6150
6151
6152Thus, it is not the intent of this section to claim rights or contest your rights to
6153work written entirely by you; rather, the intent is to exercise the right to control
6154the distribution of derivative or collective works based on the Library.
6155
6156
6157
6158In addition, mere aggregation of another work not based on the Library with the
6159Library (or with a work based on the Library) on a volume of a storage or distribution
6160medium does not bring the other work under the scope of this License.
6161
6162
6163
61643. You may opt to apply the terms of the ordinary GNU General Public License instead
6165of this License to a given copy of the Library. To do this, you must alter all the
6166notices that refer to this License, so that they refer to the ordinary GNU General
6167Public License, version 2, instead of to this License. (If a newer version than
6168version 2 of the ordinary GNU General Public License has appeared, then you can
6169specify that version instead if you wish.) Do not make any other change in these
6170notices.
6171
6172
6173
6174Once this change is made in a given copy, it is irreversible for that copy, so the
6175ordinary GNU General Public License applies to all subsequent copies and derivative
6176works made from that copy.
6177
6178
6179
6180This option is useful when you wish to copy part of the code of the Library into a
6181program that is not a library.
6182
6183
6184
61854. You may copy and distribute the Library (or a portion or derivative of it, under
6186Section 2) in object code or executable form under the terms of Sections 1 and 2 above
6187provided that you accompany it with the complete corresponding machine-readable source
6188code, which must be distributed under the terms of Sections 1 and 2 above on a medium
6189customarily used for software interchange.
6190
6191
6192
6193If distribution of object code is made by offering access to copy from a designated
6194place, then offering equivalent access to copy the source code from the same place
6195satisfies the requirement to distribute the source code, even though third parties are
6196not compelled to copy the source along with the object code.
6197
6198
6199
62005. A program that contains no derivative of any portion of the Library, but is
6201designed to work with the Library by being compiled or linked with it, is called a
6202"work that uses the Library". Such a work, in isolation, is not a derivative work of
6203the Library, and therefore falls outside the scope of this License.
6204
6205
6206
6207However, linking a "work that uses the Library" with the Library creates an executable
6208that is a derivative of the Library (because it contains portions of the Library),
6209rather than a "work that uses the library". The executable is therefore covered by
6210this License. Section 6 states terms for distribution of such executables.
6211
6212
6213
6214When a "work that uses the Library" uses material from a header file that is part of
6215the Library, the object code for the work may be a derivative work of the Library even
6216though the source code is not. Whether this is true is especially significant if the
6217work can be linked without the Library, or if the work is itself a library. The
6218threshold for this to be true is not precisely defined by law.
6219
6220
6221
6222If such an object file uses only numerical parameters, data structure layouts and
6223accessors, and small macros and small inline functions (ten lines or less in length),
6224then the use of the object file is unrestricted, regardless of whether it is legally a
6225derivative work. (Executables containing this object code plus portions of the Library
6226will still fall under Section 6.)
6227
6228
6229
6230Otherwise, if the work is a derivative of the Library, you may distribute the object
6231code for the work under the terms of Section 6. Any executables containing that work
6232also fall under Section 6, whether or not they are linked directly with the Library
6233itself.
6234
6235
6236
62376. As an exception to the Sections above, you may also compile or link a "work that
6238uses the Library" with the Library to produce a work containing portions of the
6239Library, and distribute that work under terms of your choice, provided that the terms
6240permit modification of the work for the customer's own use and reverse engineering for
6241debugging such modifications.
6242
6243
6244
6245You must give prominent notice with each copy of the work that the Library is used in
6246it and that the Library and its use are covered by this License. You must supply a
6247copy of this License. If the work during execution displays copyright notices, you
6248must include the copyright notice for the Library among them, as well as a reference
6249directing the user to the copy of this License. Also, you must do one of these things:
6250
6251
6252
6253a) Accompany the work with the complete corresponding machine-readable source code for
6254the Library including whatever changes were used in the work (which must be
6255distributed under Sections 1 and 2 above); and, if the work is an executable linked
6256with the Library, with the complete machine-readable "work that uses the Library", as
6257object code and/or source code, so that the user can modify the Library and then
6258relink to produce a modified executable containing the modified Library. (It is
6259understood that the user who changes the contents of definitions files in the Library
6260will not necessarily be able to recompile the application to use the modified
6261definitions.)
6262
6263b) Accompany the work with a written offer, valid for at least three years, to give
6264the same user the materials specified in Subsection 6a, above, for a charge no more
6265than the cost of performing this distribution.
6266
6267c) If distribution of the work is made by offering access to copy from a designated
6268place, offer equivalent access to copy the above specified materials from the same
6269place.
6270
6271d) Verify that the user has already received a copy of these materials or that you
6272have already sent this user a copy.
6273
6274For an executable, the required form of the "work that uses the Library" must include
6275any data and utility programs needed for reproducing the executable from it. However,
6276as a special exception, the source code distributed need not include anything that is
6277normally distributed (in either source or binary form) with the major components
6278(compiler, kernel, and so on) of the operating system on which the executable runs,
6279unless that component itself accompanies the executable.
6280
6281
6282
6283It may happen that this requirement contradicts the license restrictions of other
6284proprietary libraries that do not normally accompany the operating system. Such a
6285contradiction means you cannot use both them and the Library together in an executable
6286that you distribute.
6287
6288
6289
62907. You may place library facilities that are a work based on the Library side-by-side
6291in a single library together with other library facilities not covered by this
6292License, and distribute such a combined library, provided that the separate
6293distribution of the work based on the Library and of the other library facilities is
6294otherwise permitted, and provided that you do these two things:
6295
6296
6297
6298a) Accompany the combined library with a copy of the same work based on the Library,
6299uncombined with any other library facilities. This must be distributed under the terms
6300of the Sections above.
6301
6302b) Give prominent notice with the combined library of the fact that part of it is a
6303work based on the Library, and explaining where to find the accompanying uncombined
6304form of the same work.
6305
63068. You may not copy, modify, sublicense, link with, or distribute the Library except
6307as expressly provided under this License. Any attempt otherwise to copy, modify,
6308sublicense, link with, or distribute the Library is void, and will automatically
6309terminate your rights under this License. However, parties who have received copies,
6310or rights, from you under this License will not have their licenses terminated so long
6311as such parties remain in full compliance.
6312
6313
6314
63159. You are not required to accept this License, since you have not signed it. However,
6316nothing else grants you permission to modify or distribute the Library or its
6317derivative works. These actions are prohibited by law if you do not accept this
6318License. Therefore, by modifying or distributing the Library (or any work based on the
6319Library), you indicate your acceptance of this License to do so, and all its terms and
6320conditions for copying, distributing or modifying the Library or works based on it.
6321
6322
6323
632410. Each time you redistribute the Library (or any work based on the Library), the
6325recipient automatically receives a license from the original licensor to copy,
6326distribute, link with or modify the Library subject to these terms and conditions. You
6327may not impose any further restrictions on the recipients' exercise of the rights
6328granted herein. You are not responsible for enforcing compliance by third parties to
6329this License.
6330
6331
6332
633311. If, as a consequence of a court judgment or allegation of patent infringement or
6334for any other reason (not limited to patent issues), conditions are imposed on you
6335(whether by court order, agreement or otherwise) that contradict the conditions of
6336this License, they do not excuse you from the conditions of this License. If you
6337cannot distribute so as to satisfy simultaneously your obligations under this License
6338and any other pertinent obligations, then as a consequence you may not distribute the
6339Library at all. For example, if a patent license would not permit royalty-free
6340redistribution of the Library by all those who receive copies directly or indirectly
6341through you, then the only way you could satisfy both it and this License would be to
6342refrain entirely from distribution of the Library.
6343
6344
6345
6346If any portion of this section is held invalid or unenforceable under any particular
6347circumstance, the balance of the section is intended to apply, and the section as a
6348whole is intended to apply in other circumstances.
6349
6350
6351
6352It is not the purpose of this section to induce you to infringe any patents or other
6353property right claims or to contest validity of any such claims; this section has the
6354sole purpose of protecting the integrity of the free software distribution system
6355which is implemented by public license practices. Many people have made generous
6356contributions to the wide range of software distributed through that system in
6357reliance on consistent application of that system; it is up to the author/donor to
6358decide if he or she is willing to distribute software through any other system and a
6359licensee cannot impose that choice.
6360
6361
6362
6363This section is intended to make thoroughly clear what is believed to be a consequence
6364of the rest of this License.
6365
6366
6367
636812. If the distribution and/or use of the Library is restricted in certain countries
6369either by patents or by copyrighted interfaces, the original copyright holder who
6370places the Library under this License may add an explicit geographical distribution
6371limitation excluding those countries, so that distribution is permitted only in or
6372among countries not thus excluded. In such case, this License incorporates the
6373limitation as if written in the body of this License.
6374
6375
6376
637713. The Free Software Foundation may publish revised and/or new versions of the
6378Library General Public License from time to time. Such new versions will be similar in
6379spirit to the present version, but may differ in detail to address new problems or
6380concerns.
6381
6382
6383
6384Each version is given a distinguishing version number. If the Library specifies a
6385version number of this License which applies to it and "any later version", you have
6386the option of following the terms and conditions either of that version or of any
6387later version published by the Free Software Foundation. If the Library does not
6388specify a license version number, you may choose any version ever published by the
6389Free Software Foundation.
6390
6391
6392
639314. If you wish to incorporate parts of the Library into other free programs whose
6394distribution conditions are incompatible with these, write to the author to ask for
6395permission. For software which is copyrighted by the Free Software Foundation, write
6396to the Free Software Foundation; we sometimes make exceptions for this. Our decision
6397will be guided by the two goals of preserving the free status of all derivatives of
6398our free software and of promoting the sharing and reuse of software generally.
6399
6400
6401
6402NO WARRANTY
6403
6404
6405
640615. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
6407LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
6408WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT
6409WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
6410IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
6411RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY
6412PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
6413
6414
6415
641616. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
6417COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS
6418PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
6419INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
6420LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
6421OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE
6422WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
6423POSSIBILITY OF SUCH DAMAGES.
6424
6425
6426
6427END OF TERMS AND CONDITIONS
6428
6429
6430
6431How to Apply These Terms to Your New Libraries
6432
6433
6434
6435If you develop a new library, and you want it to be of the greatest possible use to
6436the public, we recommend making it free software that everyone can redistribute and
6437change. You can do so by permitting redistribution under these terms (or,
6438alternatively, under the terms of the ordinary General Public License).
6439
6440
6441
6442To apply these terms, attach the following notices to the library. It is safest to
6443attach them to the start of each source file to most effectively convey the exclusion
6444of warranty; and each file should have at least the "copyright" line and a pointer to
6445where the full notice is found.
6446
6447
6448
6449one line to give the library's name and an idea of what it does.
6450
6451Copyright (C) year name of author
6452
6453
6454
6455This library is free software; you can redistribute it and/or
6456
6457modify it under the terms of the GNU Library General Public
6458
6459License as published by the Free Software Foundation; either
6460
6461version 2 of the License, or (at your option) any later version.
6462
6463
6464
6465This library is distributed in the hope that it will be useful,
6466
6467but WITHOUT ANY WARRANTY; without even the implied warranty of
6468
6469MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
6470
6471Library General Public License for more details.
6472
6473
6474
6475You should have received a copy of the GNU Library General Public
6476
6477License along with this library; if not, write to the
6478
6479Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
6480
6481Boston, MA 02110-1301, USA.
6482
6483Also add information on how to contact you by electronic and paper mail.
6484
6485
6486
6487You should also get your employer (if you work as a programmer) or your school, if
6488any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample;
6489alter the names:
6490
6491
6492
6493Yoyodyne, Inc., hereby disclaims all copyright interest in
6494
6495the library `Frob' (a library for tweaking knobs) written
6496
6497by James Random Hacker.
6498
6499
6500
6501signature of Ty Coon, 1 April 1990
6502
6503Ty Coon, President of Vice
6504
6505That's all there is to it!
6506
6507</programlisting></para></section>
6508
6509<section id="lic_29">
6510<title>LGPL-2.1</title>
6511<para><programlisting>
6512
6513GNU LESSER GENERAL PUBLIC LICENSE
6514
6515Version 2.1, February 1999
6516
6517Copyright (C) 1991, 1999 Free Software Foundation, Inc.
651851 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
6519Everyone is permitted to copy and distribute verbatim copies
6520of this license document, but changing it is not allowed.
6521
6522[This is the first released version of the Lesser GPL. It also counts
6523 as the successor of the GNU Library Public License, version 2, hence
6524 the version number 2.1.]
6525Preamble
6526
6527The licenses for most software are designed to take away your freedom to share and
6528change it. By contrast, the GNU General Public Licenses are intended to guarantee your
6529freedom to share and change free software--to make sure the software is free for all
6530its users.
6531
6532This license, the Lesser General Public License, applies to some specially designated
6533software packages--typically libraries--of the Free Software Foundation and other
6534authors who decide to use it. You can use it too, but we suggest you first think
6535carefully about whether this license or the ordinary General Public License is the
6536better strategy to use in any particular case, based on the explanations below.
6537
6538When we speak of free software, we are referring to freedom of use, not price. Our
6539General Public Licenses are designed to make sure that you have the freedom to
6540distribute copies of free software (and charge for this service if you wish); that you
6541receive source code or can get it if you want it; that you can change the software and
6542use pieces of it in new free programs; and that you are informed that you can do these
6543things.
6544
6545To protect your rights, we need to make restrictions that forbid distributors to deny
6546you these rights or to ask you to surrender these rights. These restrictions translate
6547to certain responsibilities for you if you distribute copies of the library or if you
6548modify it.
6549
6550For example, if you distribute copies of the library, whether gratis or for a fee, you
6551must give the recipients all the rights that we gave you. You must make sure that
6552they, too, receive or can get the source code. If you link other code with the
6553library, you must provide complete object files to the recipients, so that they can
6554relink them with the library after making changes to the library and recompiling it.
6555And you must show them these terms so they know their rights.
6556
6557We protect your rights with a two-step method: (1) we copyright the library, and (2)
6558we offer you this license, which gives you legal permission to copy, distribute and/or
6559modify the library.
6560
6561To protect each distributor, we want to make it very clear that there is no warranty
6562for the free library. Also, if the library is modified by someone else and passed on,
6563the recipients should know that what they have is not the original version, so that
6564the original author`s reputation will not be affected by problems that might be
6565introduced by others.
6566
6567Finally, software patents pose a constant threat to the existence of any free program.
6568We wish to make sure that a company cannot effectively restrict the users of a free
6569program by obtaining a restrictive license from a patent holder. Therefore, we insist
6570that any patent license obtained for a version of the library must be consistent with
6571the full freedom of use specified in this license.
6572
6573Most GNU software, including some libraries, is covered by the ordinary GNU General
6574Public License. This license, the GNU Lesser General Public License, applies to
6575certain designated libraries, and is quite different from the ordinary General Public
6576License. We use this license for certain libraries in order to permit linking those
6577libraries into non-free programs.
6578
6579When a program is linked with a library, whether statically or using a shared library,
6580the combination of the two is legally speaking a combined work, a derivative of the
6581original library. The ordinary General Public License therefore permits such linking
6582only if the entire combination fits its criteria of freedom. The Lesser General Public
6583License permits more lax criteria for linking other code with the library.
6584
6585We call this license the "Lesser" General Public License because it does Less to
6586protect the user`s freedom than the ordinary General Public License. It also provides
6587other free software developers Less of an advantage over competing non-free programs.
6588These disadvantages are the reason we use the ordinary General Public License for many
6589libraries. However, the Lesser license provides advantages in certain special
6590circumstances.
6591
6592For example, on rare occasions, there may be a special need to encourage the widest
6593possible use of a certain library, so that it becomes a de-facto standard. To achieve
6594this, non-free programs must be allowed to use the library. A more frequent case is
6595that a free library does the same job as widely used non-free libraries. In this case,
6596there is little to gain by limiting the free library to free software only, so we use
6597the Lesser General Public License.
6598
6599In other cases, permission to use a particular library in non-free programs enables a
6600greater number of people to use a large body of free software. For example, permission
6601to use the GNU C Library in non-free programs enables many more people to use the
6602whole GNU operating system, as well as its variant, the GNU/Linux operating system.
6603
6604Although the Lesser General Public License is Less protective of the users` freedom,
6605it does ensure that the user of a program that is linked with the Library has the
6606freedom and the wherewithal to run that program using a modified version of the
6607Library.
6608
6609The precise terms and conditions for copying, distribution and modification follow.
6610Pay close attention to the difference between a "work based on the library" and a
6611"work that uses the library". The former contains code derived from the library,
6612whereas the latter must be combined with the library in order to run.
6613
6614TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
6615
66160. This License Agreement applies to any software library or other program which
6617contains a notice placed by the copyright holder or other authorized party saying it
6618may be distributed under the terms of this Lesser General Public License (also called
6619"this License"). Each licensee is addressed as "you".
6620
6621A "library" means a collection of software functions and/or data prepared so as to be
6622conveniently linked with application programs (which use some of those functions and
6623data) to form executables.
6624
6625The "Library", below, refers to any such software library or work which has been
6626distributed under these terms. A "work based on the Library" means either the Library
6627or any derivative work under copyright law: that is to say, a work containing the
6628Library or a portion of it, either verbatim or with modifications and/or translated
6629straightforwardly into another language. (Hereinafter, translation is included without
6630limitation in the term "modification".)
6631
6632"Source code" for a work means the preferred form of the work for making modifications
6633to it. For a library, complete source code means all the source code for all modules
6634it contains, plus any associated interface definition files, plus the scripts used to
6635control compilation and installation of the library.
6636
6637Activities other than copying, distribution and modification are not covered by this
6638License; they are outside its scope. The act of running a program using the Library is
6639not restricted, and output from such a program is covered only if its contents
6640constitute a work based on the Library (independent of the use of the Library in a
6641tool for writing it). Whether that is true depends on what the Library does and what
6642the program that uses the Library does.
6643
66441. You may copy and distribute verbatim copies of the Library`s complete source code
6645as you receive it, in any medium, provided that you conspicuously and appropriately
6646publish on each copy an appropriate copyright notice and disclaimer of warranty; keep
6647intact all the notices that refer to this License and to the absence of any warranty;
6648and distribute a copy of this License along with the Library.
6649
6650You may charge a fee for the physical act of transferring a copy, and you may at your
6651option offer warranty protection in exchange for a fee.
6652
66532. You may modify your copy or copies of the Library or any portion of it, thus
6654forming a work based on the Library, and copy and distribute such modifications or
6655work under the terms of Section 1 above, provided that you also meet all of these
6656conditions:
6657
6658a) The modified work must itself be a software library.
6659b) You must cause the files modified to carry prominent notices stating that you
6660changed the files and the date of any change.
6661c) You must cause the whole of the work to be licensed at no charge to all third
6662parties under the terms of this License.
6663d) If a facility in the modified Library refers to a function or a table of data to be
6664supplied by an application program that uses the facility, other than as an argument
6665passed when the facility is invoked, then you must make a good faith effort to ensure
6666that, in the event an application does not supply such function or table, the facility
6667still operates, and performs whatever part of its purpose remains meaningful.
6668(For example, a function in a library to compute square roots has a purpose that is
6669entirely well-defined independent of the application. Therefore, Subsection 2d
6670requires that any application-supplied function or table used by this function must be
6671optional: if the application does not supply it, the square root function must still
6672compute square roots.)
6673
6674These requirements apply to the modified work as a whole. If identifiable sections of
6675that work are not derived from the Library, and can be reasonably considered
6676independent and separate works in themselves, then this License, and its terms, do not
6677apply to those sections when you distribute them as separate works. But when you
6678distribute the same sections as part of a whole which is a work based on the Library,
6679the distribution of the whole must be on the terms of this License, whose permissions
6680for other licensees extend to the entire whole, and thus to each and every part
6681regardless of who wrote it.
6682
6683Thus, it is not the intent of this section to claim rights or contest your rights to
6684work written entirely by you; rather, the intent is to exercise the right to control
6685the distribution of derivative or collective works based on the Library.
6686
6687In addition, mere aggregation of another work not based on the Library with the
6688Library (or with a work based on the Library) on a volume of a storage or distribution
6689medium does not bring the other work under the scope of this License.
6690
66913. You may opt to apply the terms of the ordinary GNU General Public License instead
6692of this License to a given copy of the Library. To do this, you must alter all the
6693notices that refer to this License, so that they refer to the ordinary GNU General
6694Public License, version 2, instead of to this License. (If a newer version than
6695version 2 of the ordinary GNU General Public License has appeared, then you can
6696specify that version instead if you wish.) Do not make any other change in these
6697notices.
6698
6699Once this change is made in a given copy, it is irreversible for that copy, so the
6700ordinary GNU General Public License applies to all subsequent copies and derivative
6701works made from that copy.
6702
6703This option is useful when you wish to copy part of the code of the Library into a
6704program that is not a library.
6705
67064. You may copy and distribute the Library (or a portion or derivative of it, under
6707Section 2) in object code or executable form under the terms of Sections 1 and 2 above
6708provided that you accompany it with the complete corresponding machine-readable source
6709code, which must be distributed under the terms of Sections 1 and 2 above on a medium
6710customarily used for software interchange.
6711
6712If distribution of object code is made by offering access to copy from a designated
6713place, then offering equivalent access to copy the source code from the same place
6714satisfies the requirement to distribute the source code, even though third parties are
6715not compelled to copy the source along with the object code.
6716
67175. A program that contains no derivative of any portion of the Library, but is
6718designed to work with the Library by being compiled or linked with it, is called a
6719"work that uses the Library". Such a work, in isolation, is not a derivative work of
6720the Library, and therefore falls outside the scope of this License.
6721
6722However, linking a "work that uses the Library" with the Library creates an executable
6723that is a derivative of the Library (because it contains portions of the Library),
6724rather than a "work that uses the library". The executable is therefore covered by
6725this License. Section 6 states terms for distribution of such executables.
6726
6727When a "work that uses the Library" uses material from a header file that is part of
6728the Library, the object code for the work may be a derivative work of the Library even
6729though the source code is not. Whether this is true is especially significant if the
6730work can be linked without the Library, or if the work is itself a library. The
6731threshold for this to be true is not precisely defined by law.
6732
6733If such an object file uses only numerical parameters, data structure layouts and
6734accessors, and small macros and small inline functions (ten lines or less in length),
6735then the use of the object file is unrestricted, regardless of whether it is legally a
6736derivative work. (Executables containing this object code plus portions of the Library
6737will still fall under Section 6.)
6738
6739Otherwise, if the work is a derivative of the Library, you may distribute the object
6740code for the work under the terms of Section 6. Any executables containing that work
6741also fall under Section 6, whether or not they are linked directly with the Library
6742itself.
6743
67446. As an exception to the Sections above, you may also combine or link a "work that
6745uses the Library" with the Library to produce a work containing portions of the
6746Library, and distribute that work under terms of your choice, provided that the terms
6747permit modification of the work for the customer`s own use and reverse engineering for
6748debugging such modifications.
6749
6750You must give prominent notice with each copy of the work that the Library is used in
6751it and that the Library and its use are covered by this License. You must supply a
6752copy of this License. If the work during execution displays copyright notices, you
6753must include the copyright notice for the Library among them, as well as a reference
6754directing the user to the copy of this License. Also, you must do one of these things:
6755
6756a) Accompany the work with the complete corresponding machine-readable source code for
6757the Library including whatever changes were used in the work (which must be
6758distributed under Sections 1 and 2 above); and, if the work is an executable linked
6759with the Library, with the complete machine-readable "work that uses the Library", as
6760object code and/or source code, so that the user can modify the Library and then
6761relink to produce a modified executable containing the modified Library. (It is
6762understood that the user who changes the contents of definitions files in the Library
6763will not necessarily be able to recompile the application to use the modified
6764definitions.)
6765b) Use a suitable shared library mechanism for linking with the Library. A suitable
6766mechanism is one that (1) uses at run time a copy of the library already present on
6767the user`s computer system, rather than copying library functions into the executable,
6768and (2) will operate properly with a modified version of the library, if the user
6769installs one, as long as the modified version is interface-compatible with the version
6770that the work was made with.
6771c) Accompany the work with a written offer, valid for at least three years, to give
6772the same user the materials specified in Subsection 6a, above, for a charge no more
6773than the cost of performing this distribution.
6774d) If distribution of the work is made by offering access to copy from a designated
6775place, offer equivalent access to copy the above specified materials from the same
6776place.
6777e) Verify that the user has already received a copy of these materials or that you
6778have already sent this user a copy.
6779For an executable, the required form of the "work that uses the Library" must include
6780any data and utility programs needed for reproducing the executable from it. However,
6781as a special exception, the materials to be distributed need not include anything that
6782is normally distributed (in either source or binary form) with the major components
6783(compiler, kernel, and so on) of the operating system on which the executable runs,
6784unless that component itself accompanies the executable.
6785
6786It may happen that this requirement contradicts the license restrictions of other
6787proprietary libraries that do not normally accompany the operating system. Such a
6788contradiction means you cannot use both them and the Library together in an executable
6789that you distribute.
6790
67917. You may place library facilities that are a work based on the Library side-by-side
6792in a single library together with other library facilities not covered by this
6793License, and distribute such a combined library, provided that the separate
6794distribution of the work based on the Library and of the other library facilities is
6795otherwise permitted, and provided that you do these two things:
6796
6797a) Accompany the combined library with a copy of the same work based on the Library,
6798uncombined with any other library facilities. This must be distributed under the terms
6799of the Sections above.
6800b) Give prominent notice with the combined library of the fact that part of it is a
6801work based on the Library, and explaining where to find the accompanying uncombined
6802form of the same work.
68038. You may not copy, modify, sublicense, link with, or distribute the Library except
6804as expressly provided under this License. Any attempt otherwise to copy, modify,
6805sublicense, link with, or distribute the Library is void, and will automatically
6806terminate your rights under this License. However, parties who have received copies,
6807or rights, from you under this License will not have their licenses terminated so long
6808as such parties remain in full compliance.
6809
68109. You are not required to accept this License, since you have not signed it. However,
6811nothing else grants you permission to modify or distribute the Library or its
6812derivative works. These actions are prohibited by law if you do not accept this
6813License. Therefore, by modifying or distributing the Library (or any work based on the
6814Library), you indicate your acceptance of this License to do so, and all its terms and
6815conditions for copying, distributing or modifying the Library or works based on it.
6816
681710. Each time you redistribute the Library (or any work based on the Library), the
6818recipient automatically receives a license from the original licensor to copy,
6819distribute, link with or modify the Library subject to these terms and conditions. You
6820may not impose any further restrictions on the recipients` exercise of the rights
6821granted herein. You are not responsible for enforcing compliance by third parties with
6822this License.
6823
682411. If, as a consequence of a court judgment or allegation of patent infringement or
6825for any other reason (not limited to patent issues), conditions are imposed on you
6826(whether by court order, agreement or otherwise) that contradict the conditions of
6827this License, they do not excuse you from the conditions of this License. If you
6828cannot distribute so as to satisfy simultaneously your obligations under this License
6829and any other pertinent obligations, then as a consequence you may not distribute the
6830Library at all. For example, if a patent license would not permit royalty-free
6831redistribution of the Library by all those who receive copies directly or indirectly
6832through you, then the only way you could satisfy both it and this License would be to
6833refrain entirely from distribution of the Library.
6834
6835If any portion of this section is held invalid or unenforceable under any particular
6836circumstance, the balance of the section is intended to apply, and the section as a
6837whole is intended to apply in other circumstances.
6838
6839It is not the purpose of this section to induce you to infringe any patents or other
6840property right claims or to contest validity of any such claims; this section has the
6841sole purpose of protecting the integrity of the free software distribution system
6842which is implemented by public license practices. Many people have made generous
6843contributions to the wide range of software distributed through that system in
6844reliance on consistent application of that system; it is up to the author/donor to
6845decide if he or she is willing to distribute software through any other system and a
6846licensee cannot impose that choice.
6847
6848This section is intended to make thoroughly clear what is believed to be a consequence
6849of the rest of this License.
6850
685112. If the distribution and/or use of the Library is restricted in certain countries
6852either by patents or by copyrighted interfaces, the original copyright holder who
6853places the Library under this License may add an explicit geographical distribution
6854limitation excluding those countries, so that distribution is permitted only in or
6855among countries not thus excluded. In such case, this License incorporates the
6856limitation as if written in the body of this License.
6857
685813. The Free Software Foundation may publish revised and/or new versions of the Lesser
6859General Public License from time to time. Such new versions will be similar in spirit
6860to the present version, but may differ in detail to address new problems or concerns.
6861
6862Each version is given a distinguishing version number. If the Library specifies a
6863version number of this License which applies to it and "any later version", you have
6864the option of following the terms and conditions either of that version or of any
6865later version published by the Free Software Foundation. If the Library does not
6866specify a license version number, you may choose any version ever published by the
6867Free Software Foundation.
6868
686914. If you wish to incorporate parts of the Library into other free programs whose
6870distribution conditions are incompatible with these, write to the author to ask for
6871permission. For software which is copyrighted by the Free Software Foundation, write
6872to the Free Software Foundation; we sometimes make exceptions for this. Our decision
6873will be guided by the two goals of preserving the free status of all derivatives of
6874our free software and of promoting the sharing and reuse of software generally.
6875
6876NO WARRANTY
6877
687815. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
6879LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
6880WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT
6881WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
6882IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
6883RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY
6884PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
6885
688616. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
6887COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS
6888PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
6889INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
6890LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
6891OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE
6892WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
6893POSSIBILITY OF SUCH DAMAGES.
6894
6895END OF TERMS AND CONDITIONS
6896
6897How to Apply These Terms to Your New Libraries
6898
6899If you develop a new library, and you want it to be of the greatest possible use to
6900the public, we recommend making it free software that everyone can redistribute and
6901change. You can do so by permitting redistribution under these terms (or,
6902alternatively, under the terms of the ordinary General Public License).
6903
6904To apply these terms, attach the following notices to the library. It is safest to
6905attach them to the start of each source file to most effectively convey the exclusion
6906of warranty; and each file should have at least the "copyright" line and a pointer to
6907where the full notice is found.
6908
6909one line to give the library`s name and an idea of what it does.
6910Copyright (C) year name of author
6911
6912This library is free software; you can redistribute it and/or
6913modify it under the terms of the GNU Lesser General Public
6914License as published by the Free Software Foundation; either
6915version 2.1 of the License, or (at your option) any later version.
6916
6917This library is distributed in the hope that it will be useful,
6918but WITHOUT ANY WARRANTY; without even the implied warranty of
6919MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
6920Lesser General Public License for more details.
6921
6922You should have received a copy of the GNU Lesser General Public
6923License along with this library; if not, write to the Free Software
6924Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
6925Also add information on how to contact you by electronic and paper mail.
6926
6927You should also get your employer (if you work as a programmer) or your school, if
6928any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample;
6929alter the names:
6930
6931Yoyodyne, Inc., hereby disclaims all copyright interest in
6932the library `Frob` (a library for tweaking knobs) written
6933by James Random Hacker.
6934
6935signature of Ty Coon, 1 April 1990
6936Ty Coon, President of Vice
6937That`s all there is to it!
6938
6939</programlisting></para></section>
6940
6941<section id="lic_30">
6942<title>LGPL-3.0</title>
6943<para><programlisting>
6944GNU LESSER GENERAL PUBLIC LICENSE
6945
6946Version 3, 29 June 2007
6947
6948Copyright © 2007 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
6949
6950Everyone is permitted to copy and distribute verbatim copies of this license document,
6951but changing it is not allowed.
6952
6953This version of the GNU Lesser General Public License incorporates the terms and
6954conditions of version 3 of the GNU General Public License, supplemented by the
6955additional permissions listed below.
69560. Additional Definitions.
6957
6958As used herein, &rdquor;this License&rdquo; refers to version 3 of the GNU Lesser
6959General Public License, and the &rdquor;GNU GPL&rdquo; refers to version 3 of the GNU
6960General Public License.
6961
6962&rdquor;The Library&rdquo; refers to a covered work governed by this License, other
6963than an Application or a Combined Work as defined below.
6964
6965An &rdquor;Application&rdquo; is any work that makes use of an interface provided by
6966the Library, but which is not otherwise based on the Library. Defining a subclass of a
6967class defined by the Library is deemed a mode of using an interface provided by the
6968Library.
6969
6970A &rdquor;Combined Work&rdquo; is a work produced by combining or linking an
6971Application with the Library. The particular version of the Library with which the
6972Combined Work was made is also called the &rdquor;Linked Version&rdquo;.
6973
6974The &rdquor;Minimal Corresponding Source&rdquo; for a Combined Work means the
6975Corresponding Source for the Combined Work, excluding any source code for portions of
6976the Combined Work that, considered in isolation, are based on the Application, and not
6977on the Linked Version.
6978
6979The &rdquor;Corresponding Application Code&rdquo; for a Combined Work means the object
6980code and/or source code for the Application, including any data and utility programs
6981needed for reproducing the Combined Work from the Application, but excluding the
6982System Libraries of the Combined Work.
69831. Exception to Section 3 of the GNU GPL.
6984
6985You may convey a covered work under sections 3 and 4 of this License without being
6986bound by section 3 of the GNU GPL.
69872. Conveying Modified Versions.
6988
6989If you modify a copy of the Library, and, in your modifications, a facility refers to
6990a function or data to be supplied by an Application that uses the facility (other than
6991as an argument passed when the facility is invoked), then you may convey a copy of the
6992modified version:
6993
6994 * a) under this License, provided that you make a good faith effort to ensure
6995that, in the event an Application does not supply the function or data, the facility
6996still operates, and performs whatever part of its purpose remains meaningful, or
6997 * b) under the GNU GPL, with none of the additional permissions of this License
6998applicable to that copy.
6999
70003. Object Code Incorporating Material from Library Header Files.
7001
7002The object code form of an Application may incorporate material from a header file
7003that is part of the Library. You may convey such object code under terms of your
7004choice, provided that, if the incorporated material is not limited to numerical
7005parameters, data structure layouts and accessors, or small macros, inline functions
7006and templates (ten or fewer lines in length), you do both of the following:
7007
7008 * a) Give prominent notice with each copy of the object code that the Library is
7009used in it and that the Library and its use are covered by this License.
7010 * b) Accompany the object code with a copy of the GNU GPL and this license
7011document.
7012
70134. Combined Works.
7014
7015You may convey a Combined Work under terms of your choice that, taken together,
7016effectively do not restrict modification of the portions of the Library contained in
7017the Combined Work and reverse engineering for debugging such modifications, if you
7018also do each of the following:
7019
7020 * a) Give prominent notice with each copy of the Combined Work that the Library is
7021used in it and that the Library and its use are covered by this License.
7022 * b) Accompany the Combined Work with a copy of the GNU GPL and this license
7023document.
7024 * c) For a Combined Work that displays copyright notices during execution, include
7025the copyright notice for the Library among these notices, as well as a reference
7026directing the user to the copies of the GNU GPL and this license document.
7027 * d) Do one of the following:
7028 o 0) Convey the Minimal Corresponding Source under the terms of this
7029License, and the Corresponding Application Code in a form suitable for, and under
7030terms that permit, the user to recombine or relink the Application with a modified
7031version of the Linked Version to produce a modified Combined Work, in the manner
7032specified by section 6 of the GNU GPL for conveying Corresponding Source.
7033 o 1) Use a suitable shared library mechanism for linking with the Library. A
7034suitable mechanism is one that (a) uses at run time a copy of the Library already
7035present on the user's computer system, and (b) will operate properly with a modified
7036version of the Library that is interface-compatible with the Linked Version.
7037 * e) Provide Installation Information, but only if you would otherwise be required
7038to provide such information under section 6 of the GNU GPL, and only to the extent
7039that such information is necessary to install and execute a modified version of the
7040Combined Work produced by recombining or relinking the Application with a modified
7041version of the Linked Version. (If you use option 4d0, the Installation Information
7042must accompany the Minimal Corresponding Source and Corresponding Application Code. If
7043you use option 4d1, you must provide the Installation Information in the manner
7044specified by section 6 of the GNU GPL for conveying Corresponding Source.)
7045
70465. Combined Libraries.
7047
7048You may place library facilities that are a work based on the Library side by side in
7049a single library together with other library facilities that are not Applications and
7050are not covered by this License, and convey such a combined library under terms of
7051your choice, if you do both of the following:
7052
7053 * a) Accompany the combined library with a copy of the same work based on the
7054Library, uncombined with any other library facilities, conveyed under the terms of
7055this License.
7056 * b) Give prominent notice with the combined library that part of it is a work
7057based on the Library, and explaining where to find the accompanying uncombined form of
7058the same work.
7059
70606. Revised Versions of the GNU Lesser General Public License.
7061
7062The Free Software Foundation may publish revised and/or new versions of the GNU Lesser
7063General Public License from time to time. Such new versions will be similar in spirit
7064to the present version, but may differ in detail to address new problems or concerns.
7065
7066Each version is given a distinguishing version number. If the Library as you received
7067it specifies that a certain numbered version of the GNU Lesser General Public License
7068&rdquor;or any later version&rdquo; applies to it, you have the option of following
7069the terms and conditions either of that published version or of any later version
7070published by the Free Software Foundation. If the Library as you received it does not
7071specify a version number of the GNU Lesser General Public License, you may choose any
7072version of the GNU Lesser General Public License ever published by the Free Software
7073Foundation.
7074
7075If the Library as you received it specifies that a proxy can decide whether future
7076versions of the GNU Lesser General Public License shall apply, that proxy's public
7077statement of acceptance of any version is permanent authorization for you to choose
7078that version for the Library.
7079</programlisting></para></section>
7080
7081<section id="lic_31">
7082<title>Libpng</title>
7083<para><programlisting>
7084
7085This copy of the libpng notices is provided for your convenience. In case of
7086any discrepancy between this copy and the notices in the file png.h that is
7087included in the libpng distribution, the latter shall prevail.
7088
7089COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
7090
7091If you modify libpng you may insert additional notices immediately following
7092this sentence.
7093
7094This code is released under the libpng license.
7095
7096libpng versions 1.2.6, August 15, 2004, through 1.4.5, December 9, 2010, are
7097Copyright (c) 2004, 2006-2010 Glenn Randers-Pehrson, and are
7098distributed according to the same disclaimer and license as libpng-1.2.5
7099with the following individual added to the list of Contributing Authors
7100
7101 Cosmin Truta
7102
7103libpng versions 1.0.7, July 1, 2000, through 1.2.5 - October 3, 2002, are
7104Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
7105distributed according to the same disclaimer and license as libpng-1.0.6
7106with the following individuals added to the list of Contributing Authors
7107
7108 Simon-Pierre Cadieux
7109 Eric S. Raymond
7110 Gilles Vollant
7111
7112and with the following additions to the disclaimer:
7113
7114 There is no warranty against interference with your enjoyment of the
7115 library or against infringement. There is no warranty that our
7116 efforts or the library will fulfill any of your particular purposes
7117 or needs. This library is provided with all faults, and the entire
7118 risk of satisfactory quality, performance, accuracy, and effort is with
7119 the user.
7120
7121libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
7122Copyright (c) 1998, 1999 Glenn Randers-Pehrson, and are
7123distributed according to the same disclaimer and license as libpng-0.96,
7124with the following individuals added to the list of Contributing Authors:
7125
7126 Tom Lane
7127 Glenn Randers-Pehrson
7128 Willem van Schaik
7129
7130libpng versions 0.89, June 1996, through 0.96, May 1997, are
7131Copyright (c) 1996, 1997 Andreas Dilger
7132Distributed according to the same disclaimer and license as libpng-0.88,
7133with the following individuals added to the list of Contributing Authors:
7134
7135 John Bowler
7136 Kevin Bracey
7137 Sam Bushell
7138 Magnus Holmgren
7139 Greg Roelofs
7140 Tom Tanner
7141
7142libpng versions 0.5, May 1995, through 0.88, January 1996, are
7143Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
7144
7145For the purposes of this copyright and license, "Contributing Authors"
7146is defined as the following set of individuals:
7147
7148 Andreas Dilger
7149 Dave Martindale
7150 Guy Eric Schalnat
7151 Paul Schmidt
7152 Tim Wegner
7153
7154The PNG Reference Library is supplied "AS IS". The Contributing Authors
7155and Group 42, Inc. disclaim all warranties, expressed or implied,
7156including, without limitation, the warranties of merchantability and of
7157fitness for any purpose. The Contributing Authors and Group 42, Inc.
7158assume no liability for direct, indirect, incidental, special, exemplary,
7159or consequential damages, which may result from the use of the PNG
7160Reference Library, even if advised of the possibility of such damage.
7161
7162Permission is hereby granted to use, copy, modify, and distribute this
7163source code, or portions hereof, for any purpose, without fee, subject
7164to the following restrictions:
7165
71661. The origin of this source code must not be misrepresented.
7167
71682. Altered versions must be plainly marked as such and must not
7169 be misrepresented as being the original source.
7170
71713. This Copyright notice may not be removed or altered from any
7172 source or altered source distribution.
7173
7174The Contributing Authors and Group 42, Inc. specifically permit, without
7175fee, and encourage the use of this source code as a component to
7176supporting the PNG file format in commercial products. If you use this
7177source code in a product, acknowledgment is not required but would be
7178appreciated.
7179
7180
7181A "png_get_copyright" function is available, for convenient use in "about"
7182boxes and the like:
7183
7184 printf("%s",png_get_copyright(NULL));
7185
7186Also, the PNG logo (in PNG format, of course) is supplied in the
7187files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
7188
7189Libpng is OSI Certified Open Source Software. OSI Certified Open Source is a
7190certification mark of the Open Source Initiative.
7191
7192Glenn Randers-Pehrson
7193glennrp at users.sourceforge.net
7194December 9, 2010
7195
7196</programlisting></para></section>
7197
7198<section id="lic_32">
7199<title>MIT</title>
7200<para><programlisting>
7201
7202MIT License
7203
7204Copyright (c) &lt;year&gt; &lt;copyright holders&gt;
7205
7206Permission is hereby granted, free of charge, to any person obtaining a copy
7207of this software and associated documentation files (the "Software"), to deal
7208in the Software without restriction, including without limitation the rights
7209to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7210copies of the Software, and to permit persons to whom the Software is
7211furnished to do so, subject to the following conditions:
7212
7213The above copyright notice and this permission notice shall be included in
7214all copies or substantial portions of the Software.
7215
7216THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
7217IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
7218FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
7219AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
7220LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
7221OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
7222THE SOFTWARE.
7223
7224</programlisting></para></section>
7225
7226<section id="lic_33">
7227<title>MPL-2.0</title>
7228<para><programlisting>
7229Mozilla Public License Version 2.0
7230==================================
7231
72321. Definitions
7233--------------
7234
72351.1. "Contributor"
7236 means each individual or legal entity that creates, contributes to
7237 the creation of, or owns Covered Software.
7238
72391.2. "Contributor Version"
7240 means the combination of the Contributions of others (if any) used
7241 by a Contributor and that particular Contributor's Contribution.
7242
72431.3. "Contribution"
7244 means Covered Software of a particular Contributor.
7245
72461.4. "Covered Software"
7247 means Source Code Form to which the initial Contributor has attached
7248 the notice in Exhibit A, the Executable Form of such Source Code
7249 Form, and Modifications of such Source Code Form, in each case
7250 including portions thereof.
7251
72521.5. "Incompatible With Secondary Licenses"
7253 means
7254
7255 (a) that the initial Contributor has attached the notice described
7256 in Exhibit B to the Covered Software; or
7257
7258 (b) that the Covered Software was made available under the terms of
7259 version 1.1 or earlier of the License, but not also under the
7260 terms of a Secondary License.
7261
72621.6. "Executable Form"
7263 means any form of the work other than Source Code Form.
7264
72651.7. "Larger Work"
7266 means a work that combines Covered Software with other material, in
7267 a separate file or files, that is not Covered Software.
7268
72691.8. "License"
7270 means this document.
7271
72721.9. "Licensable"
7273 means having the right to grant, to the maximum extent possible,
7274 whether at the time of the initial grant or subsequently, any and
7275 all of the rights conveyed by this License.
7276
72771.10. "Modifications"
7278 means any of the following:
7279
7280 (a) any file in Source Code Form that results from an addition to,
7281 deletion from, or modification of the contents of Covered
7282 Software; or
7283
7284 (b) any new file in Source Code Form that contains any Covered
7285 Software.
7286
72871.11. "Patent Claims" of a Contributor
7288 means any patent claim(s), including without limitation, method,
7289 process, and apparatus claims, in any patent Licensable by such
7290 Contributor that would be infringed, but for the grant of the
7291 License, by the making, using, selling, offering for sale, having
7292 made, import, or transfer of either its Contributions or its
7293 Contributor Version.
7294
72951.12. "Secondary License"
7296 means either the GNU General Public License, Version 2.0, the GNU
7297 Lesser General Public License, Version 2.1, the GNU Affero General
7298 Public License, Version 3.0, or any later versions of those
7299 licenses.
7300
73011.13. "Source Code Form"
7302 means the form of the work preferred for making modifications.
7303
73041.14. "You" (or "Your")
7305 means an individual or a legal entity exercising rights under this
7306 License. For legal entities, "You" includes any entity that
7307 controls, is controlled by, or is under common control with You. For
7308 purposes of this definition, "control" means (a) the power, direct
7309 or indirect, to cause the direction or management of such entity,
7310 whether by contract or otherwise, or (b) ownership of more than
7311 fifty percent (50%) of the outstanding shares or beneficial
7312 ownership of such entity.
7313
73142. License Grants and Conditions
7315--------------------------------
7316
73172.1. Grants
7318
7319Each Contributor hereby grants You a world-wide, royalty-free,
7320non-exclusive license:
7321
7322(a) under intellectual property rights (other than patent or trademark)
7323 Licensable by such Contributor to use, reproduce, make available,
7324 modify, display, perform, distribute, and otherwise exploit its
7325 Contributions, either on an unmodified basis, with Modifications, or
7326 as part of a Larger Work; and
7327
7328(b) under Patent Claims of such Contributor to make, use, sell, offer
7329 for sale, have made, import, and otherwise transfer either its
7330 Contributions or its Contributor Version.
7331
73322.2. Effective Date
7333
7334The licenses granted in Section 2.1 with respect to any Contribution
7335become effective for each Contribution on the date the Contributor first
7336distributes such Contribution.
7337
73382.3. Limitations on Grant Scope
7339
7340The licenses granted in this Section 2 are the only rights granted under
7341this License. No additional rights or licenses will be implied from the
7342distribution or licensing of Covered Software under this License.
7343Notwithstanding Section 2.1(b) above, no patent license is granted by a
7344Contributor:
7345
7346(a) for any code that a Contributor has removed from Covered Software;
7347 or
7348
7349(b) for infringements caused by: (i) Your and any other third party's
7350 modifications of Covered Software, or (ii) the combination of its
7351 Contributions with other software (except as part of its Contributor
7352 Version); or
7353
7354(c) under Patent Claims infringed by Covered Software in the absence of
7355 its Contributions.
7356
7357This License does not grant any rights in the trademarks, service marks,
7358or logos of any Contributor (except as may be necessary to comply with
7359the notice requirements in Section 3.4).
7360
73612.4. Subsequent Licenses
7362
7363No Contributor makes additional grants as a result of Your choice to
7364distribute the Covered Software under a subsequent version of this
7365License (see Section 10.2) or under the terms of a Secondary License (if
7366permitted under the terms of Section 3.3).
7367
73682.5. Representation
7369
7370Each Contributor represents that the Contributor believes its
7371Contributions are its original creation(s) or it has sufficient rights
7372to grant the rights to its Contributions conveyed by this License.
7373
73742.6. Fair Use
7375
7376This License is not intended to limit any rights You have under
7377applicable copyright doctrines of fair use, fair dealing, or other
7378equivalents.
7379
73802.7. Conditions
7381
7382Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
7383in Section 2.1.
7384
73853. Responsibilities
7386-------------------
7387
73883.1. Distribution of Source Form
7389
7390All distribution of Covered Software in Source Code Form, including any
7391Modifications that You create or to which You contribute, must be under
7392the terms of this License. You must inform recipients that the Source
7393Code Form of the Covered Software is governed by the terms of this
7394License, and how they can obtain a copy of this License. You may not
7395attempt to alter or restrict the recipients' rights in the Source Code
7396Form.
7397
73983.2. Distribution of Executable Form
7399
7400If You distribute Covered Software in Executable Form then:
7401
7402(a) such Covered Software must also be made available in Source Code
7403 Form, as described in Section 3.1, and You must inform recipients of
7404 the Executable Form how they can obtain a copy of such Source Code
7405 Form by reasonable means in a timely manner, at a charge no more
7406 than the cost of distribution to the recipient; and
7407
7408(b) You may distribute such Executable Form under the terms of this
7409 License, or sublicense it under different terms, provided that the
7410 license for the Executable Form does not attempt to limit or alter
7411 the recipients' rights in the Source Code Form under this License.
7412
74133.3. Distribution of a Larger Work
7414
7415You may create and distribute a Larger Work under terms of Your choice,
7416provided that You also comply with the requirements of this License for
7417the Covered Software. If the Larger Work is a combination of Covered
7418Software with a work governed by one or more Secondary Licenses, and the
7419Covered Software is not Incompatible With Secondary Licenses, this
7420License permits You to additionally distribute such Covered Software
7421under the terms of such Secondary License(s), so that the recipient of
7422the Larger Work may, at their option, further distribute the Covered
7423Software under the terms of either this License or such Secondary
7424License(s).
7425
74263.4. Notices
7427
7428You may not remove or alter the substance of any license notices
7429(including copyright notices, patent notices, disclaimers of warranty,
7430or limitations of liability) contained within the Source Code Form of
7431the Covered Software, except that You may alter any license notices to
7432the extent required to remedy known factual inaccuracies.
7433
74343.5. Application of Additional Terms
7435
7436You may choose to offer, and to charge a fee for, warranty, support,
7437indemnity or liability obligations to one or more recipients of Covered
7438Software. However, You may do so only on Your own behalf, and not on
7439behalf of any Contributor. You must make it absolutely clear that any
7440such warranty, support, indemnity, or liability obligation is offered by
7441You alone, and You hereby agree to indemnify every Contributor for any
7442liability incurred by such Contributor as a result of warranty, support,
7443indemnity or liability terms You offer. You may include additional
7444disclaimers of warranty and limitations of liability specific to any
7445jurisdiction.
7446
74474. Inability to Comply Due to Statute or Regulation
7448---------------------------------------------------
7449
7450If it is impossible for You to comply with any of the terms of this
7451License with respect to some or all of the Covered Software due to
7452statute, judicial order, or regulation then You must: (a) comply with
7453the terms of this License to the maximum extent possible; and (b)
7454describe the limitations and the code they affect. Such description must
7455be placed in a text file included with all distributions of the Covered
7456Software under this License. Except to the extent prohibited by statute
7457or regulation, such description must be sufficiently detailed for a
7458recipient of ordinary skill to be able to understand it.
7459
74605. Termination
7461--------------
7462
74635.1. The rights granted under this License will terminate automatically
7464if You fail to comply with any of its terms. However, if You become
7465compliant, then the rights granted under this License from a particular
7466Contributor are reinstated (a) provisionally, unless and until such
7467Contributor explicitly and finally terminates Your grants, and (b) on an
7468ongoing basis, if such Contributor fails to notify You of the
7469non-compliance by some reasonable means prior to 60 days after You have
7470come back into compliance. Moreover, Your grants from a particular
7471Contributor are reinstated on an ongoing basis if such Contributor
7472notifies You of the non-compliance by some reasonable means, this is the
7473first time You have received notice of non-compliance with this License
7474from such Contributor, and You become compliant prior to 30 days after
7475Your receipt of the notice.
7476
74775.2. If You initiate litigation against any entity by asserting a patent
7478infringement claim (excluding declaratory judgment actions,
7479counter-claims, and cross-claims) alleging that a Contributor Version
7480directly or indirectly infringes any patent, then the rights granted to
7481You by any and all Contributors for the Covered Software under Section
74822.1 of this License shall terminate.
7483
74845.3. In the event of termination under Sections 5.1 or 5.2 above, all
7485end user license agreements (excluding distributors and resellers) which
7486have been validly granted by You or Your distributors under this License
7487prior to termination shall survive termination.
7488
7489************************************************************************
7490* *
7491* 6. Disclaimer of Warranty *
7492* ------------------------- *
7493* *
7494* Covered Software is provided under this License on an "as is" *
7495* basis, without warranty of any kind, either expressed, implied, or *
7496* statutory, including, without limitation, warranties that the *
7497* Covered Software is free of defects, merchantable, fit for a *
7498* particular purpose or non-infringing. The entire risk as to the *
7499* quality and performance of the Covered Software is with You. *
7500* Should any Covered Software prove defective in any respect, You *
7501* (not any Contributor) assume the cost of any necessary servicing, *
7502* repair, or correction. This disclaimer of warranty constitutes an *
7503* essential part of this License. No use of any Covered Software is *
7504* authorized under this License except under this disclaimer. *
7505* *
7506************************************************************************
7507
7508************************************************************************
7509* *
7510* 7. Limitation of Liability *
7511* -------------------------- *
7512* *
7513* Under no circumstances and under no legal theory, whether tort *
7514* (including negligence), contract, or otherwise, shall any *
7515* Contributor, or anyone who distributes Covered Software as *
7516* permitted above, be liable to You for any direct, indirect, *
7517* special, incidental, or consequential damages of any character *
7518* including, without limitation, damages for lost profits, loss of *
7519* goodwill, work stoppage, computer failure or malfunction, or any *
7520* and all other commercial damages or losses, even if such party *
7521* shall have been informed of the possibility of such damages. This *
7522* limitation of liability shall not apply to liability for death or *
7523* personal injury resulting from such party's negligence to the *
7524* extent applicable law prohibits such limitation. Some *
7525* jurisdictions do not allow the exclusion or limitation of *
7526* incidental or consequential damages, so this exclusion and *
7527* limitation may not apply to You. *
7528* *
7529************************************************************************
7530
75318. Litigation
7532-------------
7533
7534Any litigation relating to this License may be brought only in the
7535courts of a jurisdiction where the defendant maintains its principal
7536place of business and such litigation shall be governed by laws of that
7537jurisdiction, without reference to its conflict-of-law provisions.
7538Nothing in this Section shall prevent a party's ability to bring
7539cross-claims or counter-claims.
7540
75419. Miscellaneous
7542----------------
7543
7544This License represents the complete agreement concerning the subject
7545matter hereof. If any provision of this License is held to be
7546unenforceable, such provision shall be reformed only to the extent
7547necessary to make it enforceable. Any law or regulation which provides
7548that the language of a contract shall be construed against the drafter
7549shall not be used to construe this License against a Contributor.
7550
755110. Versions of the License
7552---------------------------
7553
755410.1. New Versions
7555
7556Mozilla Foundation is the license steward. Except as provided in Section
755710.3, no one other than the license steward has the right to modify or
7558publish new versions of this License. Each version will be given a
7559distinguishing version number.
7560
756110.2. Effect of New Versions
7562
7563You may distribute the Covered Software under the terms of the version
7564of the License under which You originally received the Covered Software,
7565or under the terms of any subsequent version published by the license
7566steward.
7567
756810.3. Modified Versions
7569
7570If you create software not governed by this License, and you want to
7571create a new license for such software, you may create and use a
7572modified version of this License if you rename the license and remove
7573any references to the name of the license steward (except to note that
7574such modified license differs from this License).
7575
757610.4. Distributing Source Code Form that is Incompatible With Secondary
7577Licenses
7578
7579If You choose to distribute Source Code Form that is Incompatible With
7580Secondary Licenses under the terms of this version of the License, the
7581notice described in Exhibit B of this License must be attached.
7582
7583Exhibit A - Source Code Form License Notice
7584-------------------------------------------
7585
7586 This Source Code Form is subject to the terms of the Mozilla Public
7587 License, v. 2.0. If a copy of the MPL was not distributed with this
7588 file, You can obtain one at http://mozilla.org/MPL/2.0/.
7589
7590If it is not possible or desirable to put the notice in a particular
7591file, then You may include the notice in a location (such as a LICENSE
7592file in a relevant directory) where a recipient would be likely to look
7593for such a notice.
7594
7595You may add additional accurate notices of copyright ownership.
7596
7597Exhibit B - "Incompatible With Secondary Licenses" Notice
7598---------------------------------------------------------
7599
7600 This Source Code Form is "Incompatible With Secondary Licenses", as
7601 defined by the Mozilla Public License, v. 2.0.
7602</programlisting></para></section>
7603
7604<section id="lic_34">
7605<title>NTP</title>
7606<para><programlisting>
7607
7608NTP License (NTP)
7609
7610Copyright (c) (CopyrightHoldersName) (From 4-digit-year)-(To 4-digit-year)
7611
7612Permission to use, copy, modify, and distribute this software and its documentation
7613for any purpose with or without fee is hereby granted, provided that the above
7614copyright notice appears in all copies and that both the copyright notice and this
7615permission notice appear in supporting documentation, and that the name
7616(TrademarkedName) not be used in advertising or publicity pertaining to distribution
7617of the software without specific, written prior permission. (TrademarkedName) makes no
7618representations about the suitability this software for any purpose. It is provided
7619"as is" without express or implied warranty.
7620
7621</programlisting></para></section>
7622
7623<section id="lic_35">
7624<title>OpenSSL</title>
7625<para><programlisting>
7626
7627OpenSSL License
7628
7629 ====================================================================
7630 Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved.
7631
7632 Redistribution and use in source and binary forms, with or without
7633 modification, are permitted provided that the following conditions
7634 are met:
7635
7636 1. Redistributions of source code must retain the above copyright
7637 notice, this list of conditions and the following disclaimer.
7638
7639 2. Redistributions in binary form must reproduce the above copyright
7640 notice, this list of conditions and the following disclaimer in
7641 the documentation and/or other materials provided with the
7642 distribution.
7643
7644 3. All advertising materials mentioning features or use of this
7645 software must display the following acknowledgment:
7646 "This product includes software developed by the OpenSSL Project
7647 for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
7648
7649 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
7650 endorse or promote products derived from this software without
7651 prior written permission. For written permission, please contact
7652 openssl-core@openssl.org.
7653
7654 5. Products derived from this software may not be called "OpenSSL"
7655 nor may "OpenSSL" appear in their names without prior written
7656 permission of the OpenSSL Project.
7657
7658 6. Redistributions of any form whatsoever must retain the following
7659 acknowledgment:
7660 "This product includes software developed by the OpenSSL Project
7661 for use in the OpenSSL Toolkit (http://www.openssl.org/)"
7662
7663 THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS`` AND ANY
7664 EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
7665 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
7666 PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
7667 ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
7668 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
7669 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
7670 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
7671 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
7672 STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
7673 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
7674 OF THE POSSIBILITY OF SUCH DAMAGE.
7675 ====================================================================
7676
7677 This product includes cryptographic software written by Eric Young
7678 (eay@cryptsoft.com). This product includes software written by Tim
7679 Hudson (tjh@cryptsoft.com).
7680
7681
7682 Original SSLeay License
7683 -----------------------
7684
7685Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
7686All rights reserved.
7687
7688 This package is an SSL implementation written
7689 by Eric Young (eay@cryptsoft.com).
7690 The implementation was written so as to conform with Netscapes SSL.
7691
7692 This library is free for commercial and non-commercial use as long as
7693 the following conditions are aheared to. The following conditions
7694 apply to all code found in this distribution, be it the RC4, RSA,
7695 lhash, DES, etc., code; not just the SSL code. The SSL documentation
7696 included with this distribution is covered by the same copyright terms
7697 except that the holder is Tim Hudson (tjh@cryptsoft.com).
7698
7699 Copyright remains Eric Young`s, and as such any Copyright notices in
7700 the code are not to be removed.
7701 If this package is used in a product, Eric Young should be given attribution
7702 as the author of the parts of the library used.
7703 This can be in the form of a textual message at program startup or
7704 in documentation (online or textual) provided with the package.
7705
7706 Redistribution and use in source and binary forms, with or without
7707 modification, are permitted provided that the following conditions
7708 are met:
7709 1. Redistributions of source code must retain the copyright
7710 notice, this list of conditions and the following disclaimer.
7711 2. Redistributions in binary form must reproduce the above copyright
7712 notice, this list of conditions and the following disclaimer in the
7713 documentation and/or other materials provided with the distribution.
7714 3. All advertising materials mentioning features or use of this software
7715 must display the following acknowledgement:
7716 "This product includes cryptographic software written by
7717 Eric Young (eay@cryptsoft.com)"
7718 The word `cryptographic` can be left out if the rouines from the library
7719 being used are not cryptographic related :-).
7720 4. If you include any Windows specific code (or a derivative thereof) from
7721 the apps directory (application code) you must include an acknowledgement:
7722 "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
7723
7724 THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS`` AND ANY EXPRESS OR IMPLIED
7725WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
7726AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR
7727CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7728CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
7729OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
7730HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
7731OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
7732SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
7733
7734 The licence and distribution terms for any publically available version or
7735derivative of this code cannot be changed. i.e. this code cannot simply be copied and
7736put under another distribution licence
7737 [including the GNU Public Licence.]
7738
7739
7740
7741
7742</programlisting></para></section>
7743
7744<section id="lic_36">
7745<title>PD</title>
7746<para><programlisting>
7747This is a placeholder for the Public Domain License
7748</programlisting></para></section>
7749
7750<section id="lic_37">
7751<title>Python-2.0</title>
7752<para><programlisting>
7753
7754PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
7755--------------------------------------------
7756
77571. This LICENSE AGREEMENT is between the Python Software Foundation
7758("PSF"), and the Individual or Organization ("Licensee") accessing and
7759otherwise using this software ("Python") in source or binary form and
7760its associated documentation.
7761
77622. Subject to the terms and conditions of this License Agreement, PSF
7763hereby grants Licensee a nonexclusive, royalty-free, world-wide
7764license to reproduce, analyze, test, perform and/or display publicly,
7765prepare derivative works, distribute, and otherwise use Python
7766alone or in any derivative version, provided, however, that PSF`s
7767License Agreement and PSF`s notice of copyright, i.e., "Copyright (c)
77682001, 2002, 2003, 2004, 2005, 2006 Python Software Foundation; All Rights
7769Reserved" are retained in Python alone or in any derivative version
7770prepared by Licensee.
7771
77723. In the event Licensee prepares a derivative work that is based on
7773or incorporates Python or any part thereof, and wants to make
7774the derivative work available to others as provided herein, then
7775Licensee hereby agrees to include in any such work a brief summary of
7776the changes made to Python.
7777
77784. PSF is making Python available to Licensee on an "AS IS"
7779basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
7780IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
7781DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
7782FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
7783INFRINGE ANY THIRD PARTY RIGHTS.
7784
77855. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
7786FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
7787A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
7788OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
7789
77906. This License Agreement will automatically terminate upon a material
7791breach of its terms and conditions.
7792
77937. Nothing in this License Agreement shall be deemed to create any
7794relationship of agency, partnership, or joint venture between PSF and
7795Licensee. This License Agreement does not grant permission to use PSF
7796trademarks or trade name in a trademark sense to endorse or promote
7797products or services of Licensee, or any third party.
7798
77998. By copying, installing or otherwise using Python, Licensee
7800agrees to be bound by the terms and conditions of this License
7801Agreement.
7802
7803BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0
7804-------------------------------------------
7805
7806BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1
7807
78081. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an
7809office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the
7810Individual or Organization ("Licensee") accessing and otherwise using
7811this software in source or binary form and its associated
7812documentation ("the Software").
7813
78142. Subject to the terms and conditions of this BeOpen Python License
7815Agreement, BeOpen hereby grants Licensee a non-exclusive,
7816royalty-free, world-wide license to reproduce, analyze, test, perform
7817and/or display publicly, prepare derivative works, distribute, and
7818otherwise use the Software alone or in any derivative version,
7819provided, however, that the BeOpen Python License is retained in the
7820Software, alone or in any derivative version prepared by Licensee.
7821
78223. BeOpen is making the Software available to Licensee on an "AS IS"
7823basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
7824IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND
7825DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
7826FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT
7827INFRINGE ANY THIRD PARTY RIGHTS.
7828
78294. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE
7830SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
7831AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY
7832DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
7833
78345. This License Agreement will automatically terminate upon a material
7835breach of its terms and conditions.
7836
78376. This License Agreement shall be governed by and interpreted in all
7838respects by the law of the State of California, excluding conflict of
7839law provisions. Nothing in this License Agreement shall be deemed to
7840create any relationship of agency, partnership, or joint venture
7841between BeOpen and Licensee. This License Agreement does not grant
7842permission to use BeOpen trademarks or trade names in a trademark
7843sense to endorse or promote products or services of Licensee, or any
7844third party. As an exception, the "BeOpen Python" logos available at
7845http://www.pythonlabs.com/logos.html may be used according to the
7846permissions granted on that web page.
7847
78487. By copying, installing or otherwise using the software, Licensee
7849agrees to be bound by the terms and conditions of this License
7850Agreement.
7851
7852CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1
7853---------------------------------------
7854
78551. This LICENSE AGREEMENT is between the Corporation for National
7856Research Initiatives, having an office at 1895 Preston White Drive,
7857Reston, VA 20191 ("CNRI"), and the Individual or Organization
7858("Licensee") accessing and otherwise using Python 1.6.1 software in
7859source or binary form and its associated documentation.
7860
78612. Subject to the terms and conditions of this License Agreement, CNRI
7862hereby grants Licensee a nonexclusive, royalty-free, world-wide
7863license to reproduce, analyze, test, perform and/or display publicly,
7864prepare derivative works, distribute, and otherwise use Python 1.6.1
7865alone or in any derivative version, provided, however, that CNRI`s
7866License Agreement and CNRI`s notice of copyright, i.e., "Copyright (c)
78671995-2001 Corporation for National Research Initiatives; All Rights
7868Reserved" are retained in Python 1.6.1 alone or in any derivative
7869version prepared by Licensee. Alternately, in lieu of CNRI`s License
7870Agreement, Licensee may substitute the following text (omitting the
7871quotes): "Python 1.6.1 is made available subject to the terms and
7872conditions in CNRI`s License Agreement. This Agreement together with
7873Python 1.6.1 may be located on the Internet using the following
7874unique, persistent identifier (known as a handle): 1895.22/1013. This
7875Agreement may also be obtained from a proxy server on the Internet
7876using the following URL: http://hdl.handle.net/1895.22/1013".
7877
78783. In the event Licensee prepares a derivative work that is based on
7879or incorporates Python 1.6.1 or any part thereof, and wants to make
7880the derivative work available to others as provided herein, then
7881Licensee hereby agrees to include in any such work a brief summary of
7882the changes made to Python 1.6.1.
7883
78844. CNRI is making Python 1.6.1 available to Licensee on an "AS IS"
7885basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
7886IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND
7887DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
7888FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT
7889INFRINGE ANY THIRD PARTY RIGHTS.
7890
78915. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
78921.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
7893A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1,
7894OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
7895
78966. This License Agreement will automatically terminate upon a material
7897breach of its terms and conditions.
7898
78997. This License Agreement shall be governed by the federal
7900intellectual property law of the United States, including without
7901limitation the federal copyright law, and, to the extent such
7902U.S. federal law does not apply, by the law of the Commonwealth of
7903Virginia, excluding Virginia`s conflict of law provisions.
7904Notwithstanding the foregoing, with regard to derivative works based
7905on Python 1.6.1 that incorporate non-separable material that was
7906previously distributed under the GNU General Public License (GPL), the
7907law of the Commonwealth of Virginia shall govern this License
7908Agreement only as to issues arising under or with respect to
7909Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this
7910License Agreement shall be deemed to create any relationship of
7911agency, partnership, or joint venture between CNRI and Licensee. This
7912License Agreement does not grant permission to use CNRI trademarks or
7913trade name in a trademark sense to endorse or promote products or
7914services of Licensee, or any third party.
7915
79168. By clicking on the "ACCEPT" button where indicated, or by copying,
7917installing or otherwise using Python 1.6.1, Licensee agrees to be
7918bound by the terms and conditions of this License Agreement.
7919
7920ACCEPT
7921
7922CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2
7923--------------------------------------------------
7924
7925Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam,
7926The Netherlands. All rights reserved.
7927
7928Permission to use, copy, modify, and distribute this software and its
7929documentation for any purpose and without fee is hereby granted,
7930provided that the above copyright notice appear in all copies and that
7931both that copyright notice and this permission notice appear in
7932supporting documentation, and that the name of Stichting Mathematisch
7933Centrum or CWI not be used in advertising or publicity pertaining to
7934distribution of the software without specific, written prior
7935permission.
7936
7937STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
7938THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
7939FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
7940FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
7941WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
7942ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
7943OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
7944
7945</programlisting></para></section>
7946
7947<section id="lic_38">
7948<title>SAX-PD</title>
7949<para><programlisting>
7950
7951Copyright Status for SAX
7952
7953SAX is free!
7954
7955In fact, it`s not possible to own a license to SAX, since it`s been placed in the
7956public domain.
7957
7958No Warranty
7959
7960Because SAX is released to the public domain, there is no warranty for the design or
7961for the software implementation, to the extent permitted by applicable law. Except
7962when otherwise stated in writing the copyright holders and/or other parties provide
7963SAX "as is" without warranty of any kind, either expressed or implied, including, but
7964not limited to, the implied warranties of merchantability and fitness for a particular
7965purpose. The entire risk as to the quality and performance of SAX is with you. Should
7966SAX prove defective, you assume the cost of all necessary servicing, repair or
7967correction.
7968
7969In no event unless required by applicable law or agreed to in writing will any
7970copyright holder, or any other party who may modify and/or redistribute SAX, be liable
7971to you for damages, including any general, special, incidental or consequential
7972damages arising out of the use or inability to use SAX (including but not limited to
7973loss of data or data being rendered inaccurate or losses sustained by you or third
7974parties or a failure of the SAX to operate with any other programs), even if such
7975holder or other party has been advised of the possibility of such damages.
7976
7977Copyright Disclaimers
7978
7979This page includes statements to that effect by David Megginson, who would have been
7980able to claim copyright for the original work.
7981
7982SAX 1.0
7983
7984Version 1.0 of the Simple API for XML (SAX), created collectively by the membership of
7985the XML-DEV mailing list, is hereby released into the public domain.
7986
7987No one owns SAX: you may use it freely in both commercial and non-commercial
7988applications, bundle it with your software distribution, include it on a CD-ROM, list
7989the source code in a book, mirror the documentation at your own web site, or use it in
7990any other way you see fit.
7991
7992David Megginson, Megginson Technologies Ltd.
79931998-05-11
7994
7995SAX 2.0
7996
7997I hereby abandon any property rights to SAX 2.0 (the Simple API for XML), and release
7998all of the SAX 2.0 source code, compiled code, and documentation contained in this
7999distribution into the Public Domain. SAX comes with NO WARRANTY or guarantee of
8000fitness for any purpose.
8001
8002David Megginson, Megginson Technologies Ltd.
80032000-05-05
8004
8005</programlisting></para></section>
8006
8007<section id="lic_39">
8008<title>SMAIL_GPL</title>
8009<para><programlisting>
8010This is the Debian GNU/Linux package debianutils.
8011
8012It is an original Debian package. Programs in it were maintained by
8013Guy Maor &lt;maor@debian.org&gt;, and are now maintained by Clint Adams
8014&lt;schizo@debian.org&gt;.
8015
8016All its programs except readlink, savelog, and which may be
8017redistributed under the terms of the GNU GPL, Version 2 or later,
8018found on Debian systems in the file /usr/share/common-licenses/GPL.
8019
8020which is in the public domain.
8021
8022readlink is Copyright (c) 1997 Kenneth Stailey, and may also be
8023distributed under the terms of the BSD copyright.
8024
8025savelog may be redistributed under the following terms: (The rest of
8026this file consists of savelog's distribution terms.)
8027
8028#ident "@(#)smail:RELEASE-3_2:COPYING,v 1.2 1996/06/14 18:59:10 woods Exp"
8029
8030 SMAIL GENERAL PUBLIC LICENSE
8031 (Clarified 11 Feb 1988)
8032
8033 Copyright (C) 1988 Landon Curt Noll &amp; Ronald S. Karr
8034 Copyright (C) 1992 Ronald S. Karr
8035 Copyleft (GNU) 1988 Landon Curt Noll &amp; Ronald S. Karr
8036
8037 Everyone is permitted to copy and distribute verbatim copies
8038 of this license, but changing it is not allowed. You can also
8039 use this wording to make the terms for other programs.
8040
8041 The license agreements of most software companies keep you at the
8042mercy of those companies. By contrast, our general public license is
8043intended to give everyone the right to share SMAIL. To make sure that
8044you get the rights we want you to have, we need to make restrictions
8045that forbid anyone to deny you these rights or to ask you to surrender
8046the rights. Hence this license agreement.
8047
8048 Specifically, we want to make sure that you have the right to give
8049away copies of SMAIL, that you receive source code or else can get it
8050if you want it, that you can change SMAIL or use pieces of it in new
8051free programs, and that you know you can do these things.
8052
8053 To make sure that everyone has such rights, we have to forbid you to
8054deprive anyone else of these rights. For example, if you distribute
8055copies of SMAIL, you must give the recipients all the rights that you
8056have. You must make sure that they, too, receive or can get the
8057source code. And you must tell them their rights.
8058
8059 Also, for our own protection, we must make certain that everyone
8060finds out that there is no warranty for SMAIL. If SMAIL is modified by
8061someone else and passed on, we want its recipients to know that what
8062they have is not what we distributed, so that any problems introduced
8063by others will not reflect on our reputation.
8064
8065 Therefore we (Landon Curt Noll and Ronald S. Karr) make the following
8066terms which say what you must do to be allowed to distribute or change
8067SMAIL.
8068
8069
8070 COPYING POLICIES
8071
8072 1. You may copy and distribute verbatim copies of SMAIL source code
8073as you receive it, in any medium, provided that you conspicuously and
8074appropriately publish on each copy a valid copyright notice "Copyright
8075(C) 1988 Landon Curt Noll &amp; Ronald S. Karr" (or with whatever year is
8076appropriate); keep intact the notices on all files that refer to this
8077License Agreement and to the absence of any warranty; and give any
8078other recipients of the SMAIL program a copy of this License
8079Agreement along with the program. You may charge a distribution fee
8080for the physical act of transferring a copy.
8081
8082 2. You may modify your copy or copies of SMAIL or any portion of it,
8083and copy and distribute such modifications under the terms of
8084Paragraph 1 above, provided that you also do the following:
8085
8086 a) cause the modified files to carry prominent notices stating
8087 that you changed the files and the date of any change; and
8088
8089 b) cause the whole of any work that you distribute or publish,
8090 that in whole or in part contains or is a derivative of SMAIL or
8091 any part thereof, to be licensed at no charge to all third
8092 parties on terms identical to those contained in this License
8093 Agreement (except that you may choose to grant more extensive
8094 warranty protection to some or all third parties, at your option).
8095
8096 c) You may charge a distribution fee for the physical act of
8097 transferring a copy, and you may at your option offer warranty
8098 protection in exchange for a fee.
8099
8100Mere aggregation of another unrelated program with this program (or its
8101derivative) on a volume of a storage or distribution medium does not bring
8102the other program under the scope of these terms.
8103
8104 3. You may copy and distribute SMAIL (or a portion or derivative of it,
8105under Paragraph 2) in object code or executable form under the terms of
8106Paragraphs 1 and 2 above provided that you also do one of the following:
8107
8108 a) accompany it with the complete corresponding machine-readable
8109 source code, which must be distributed under the terms of
8110 Paragraphs 1 and 2 above; or,
8111
8112 b) accompany it with a written offer, valid for at least three
8113 years, to give any third party free (except for a nominal
8114 shipping charge) a complete machine-readable copy of the
8115 corresponding source code, to be distributed under the terms of
8116 Paragraphs 1 and 2 above; or,
8117
8118 c) accompany it with the information you received as to where the
8119 corresponding source code may be obtained. (This alternative is
8120 allowed only for non-commercial distribution and only if you
8121 received the program in object code or executable form alone.)
8122
8123For an executable file, complete source code means all the source code for
8124all modules it contains; but, as a special exception, it need not include
8125source code for modules which are standard libraries that accompany the
8126operating system on which the executable file runs.
8127
8128 4. You may not copy, sublicense, distribute or transfer SMAIL
8129except as expressly provided under this License Agreement. Any attempt
8130otherwise to copy, sublicense, distribute or transfer SMAIL is void and
8131your rights to use the program under this License agreement shall be
8132automatically terminated. However, parties who have received computer
8133software programs from you with this License Agreement will not have
8134their licenses terminated so long as such parties remain in full compliance.
8135
8136 5. If you wish to incorporate parts of SMAIL into other free
8137programs whose distribution conditions are different, write to Landon
8138Curt Noll &amp; Ronald S. Karr via the Free Software Foundation at 51
8139Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. We have not yet
8140worked out a simple rule that can be stated here, but we will often
8141permit this. We will be guided by the two goals of preserving the
8142free status of all derivatives of our free software and of promoting
8143the sharing and reuse of software.
8144
8145Your comments and suggestions about our licensing policies and our
8146software are welcome! This contract was based on the contract made by
8147the Free Software Foundation. Please contact the Free Software
8148Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,
8149USA, or call (617) 542-5942 for details on copylefted material in
8150general.
8151
8152 NO WARRANTY
8153
8154 BECAUSE SMAIL IS LICENSED FREE OF CHARGE, WE PROVIDE ABSOLUTELY NO
8155WARRANTY, TO THE EXTENT PERMITTED BY APPLICABLE STATE LAW. EXCEPT WHEN
8156OTHERWISE STATED IN WRITING, LANDON CURT NOLL &amp; RONALD S. KARR AND/OR
8157OTHER PARTIES PROVIDE SMAIL "AS IS" WITHOUT WARRANTY OF ANY KIND,
8158EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
8159WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
8160THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF SMAIL IS WITH
8161YOU. SHOULD SMAIL PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
8162NECESSARY SERVICING, REPAIR OR CORRECTION.
8163
8164 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL LANDON CURT NOLL &amp;
8165RONALD S. KARR AND/OR ANY OTHER PARTY WHO MAY MODIFY AND REDISTRIBUTE
8166SMAIL AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
8167LOST PROFITS, LOST MONIES, OR OTHER SPECIAL, INCIDENTAL OR
8168CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
8169(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
8170INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE
8171PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS) SMAIL, EVEN IF YOU HAVE
8172BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY
8173ANY OTHER PARTY.
8174</programlisting></para></section>
8175
8176<section id="lic_40">
8177<title>SUN</title>
8178<para><programlisting>
8179SUN MICROSYSTEMS, INC. THROUGH ITS SUN MICROSYSTEMS LABORATORIES
8180DIVISION ("SUN") WILL LICENSE THIS SOFTWARE AND THE ACCOMPANYING
8181DOCUMENTATION TO YOU (a "Licensee") ONLY ON YOUR ACCEPTANCE OF ALL
8182THE TERMS SET FORTH BELOW.
8183
8184Sun grants Licensee a non-exclusive, royalty-free right to download,
8185install, compile, use, copy and distribute the Software, modify or
8186otherwise create derivative works from the Software (each, a
8187"Modification") and distribute any Modification in source code and/or
8188binary code form to its customers with a license agreement containing
8189these terms and noting that the Software has been modified. The
8190Software is copyrighted by Sun and other third parties and Licensee
8191shall retain and reproduce all copyright and other notices presently
8192on the Software. As between Sun and Licensee, Sun is the sole owner of
8193all rights in and to the Software other than the limited rights
8194granted to Licensee herein; Licensee will own its Modifications,
8195expressly subject to Sun's continuing ownership of the
8196Software. Licensee will, at its expense, defend and indemnify Sun and
8197its licensors from and against any third party claims, including costs
8198and reasonable attorneys' fees, and be wholly responsible for any
8199liabilities arising out of or related to Licensee's development, use
8200or distribution of the Software or Modifications. Any distribution of
8201the Software and Modifications must comply with all applicable United
8202States export control laws.
8203
8204THE SOFTWARE IS BEING PROVIDED TO LICENSEE "AS IS" AND ALL EXPRESS OR
8205IMPLIED CONDITIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
8206MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
8207ARE DISCLAIMED. IN NO EVENT WILL SUN BE LIABLE HEREUNDER FOR ANY
8208DIRECT DAMAGES OR ANY INDIRECT, PUNITIVE, SPECIAL, INCIDENTAL OR
8209CONSEQUENTIAL DAMAGES OF ANY KIND.
8210</programlisting></para></section>
8211
8212<section id="lic_41">
8213<title>Sleepycat</title>
8214<para><programlisting>
8215
8216The Sleepycat License
8217Copyright (c) 1990-1999
8218Sleepycat Software. All rights reserved.
8219
8220Redistribution and use in source and binary forms, with or without
8221modification, are permitted provided that the following conditions
8222are met:
8223
8224Redistributions of source code must retain the above copyright
8225notice, this list of conditions and the following disclaimer.
8226Redistributions in binary form must reproduce the above copyright
8227notice, this list of conditions and the following disclaimer in the
8228documentation and/or other materials provided with the distribution.
8229Redistributions in any form must be accompanied by information on
8230how to obtain complete source code for the DB software and any
8231accompanying software that uses the DB software. The source code
8232must either be included in the distribution or be available for no
8233more than the cost of distribution plus a nominal fee, and must be
8234freely redistributable under reasonable conditions. For an
8235executable file, complete source code means the source code for all
8236modules it contains. It does not include source code for modules or
8237files that typically accompany the major components of the operating
8238system on which the executable file runs.
8239THIS SOFTWARE IS PROVIDED BY SLEEPYCAT SOFTWARE ``AS IS`` AND ANY EXPRESS
8240OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
8241WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
8242NON-INFRINGEMENT, ARE DISCLAIMED. IN NO EVENT SHALL SLEEPYCAT SOFTWARE
8243BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8244CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
8245SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
8246INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
8247CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
8248ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
8249THE POSSIBILITY OF SUCH DAMAGE.
8250
8251Copyright (c) 1990, 1993, 1994, 1995
8252The Regents of the University of California. All rights reserved.
8253
8254Redistribution and use in source and binary forms, with or without
8255modification, are permitted provided that the following conditions
8256are met:
8257
8258Redistributions of source code must retain the above copyright
8259notice, this list of conditions and the following disclaimer.
8260Redistributions in binary form must reproduce the above copyright
8261notice, this list of conditions and the following disclaimer in the
8262documentation and/or other materials provided with the distribution.
8263Neither the name of the University nor the names of its contributors
8264may be used to endorse or promote products derived from this software
8265without specific prior written permission.
8266THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS`` AND
8267ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
8268IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
8269ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
8270FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
8271DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
8272OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8273HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
8274LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
8275OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
8276SUCH DAMAGE.
8277
8278Copyright (c) 1995, 1996
8279The President and Fellows of Harvard University. All rights reserved.
8280
8281Redistribution and use in source and binary forms, with or without
8282modification, are permitted provided that the following conditions
8283are met:
8284
8285Redistributions of source code must retain the above copyright
8286notice, this list of conditions and the following disclaimer.
8287Redistributions in binary form must reproduce the above copyright
8288notice, this list of conditions and the following disclaimer in the
8289documentation and/or other materials provided with the distribution.
8290Neither the name of the University nor the names of its contributors
8291may be used to endorse or promote products derived from this software
8292without specific prior written permission.
8293THIS SOFTWARE IS PROVIDED BY HARVARD AND ITS CONTRIBUTORS ``AS IS`` AND
8294ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
8295IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
8296ARE DISCLAIMED. IN NO EVENT SHALL HARVARD OR ITS CONTRIBUTORS BE LIABLE
8297FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
8298DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
8299OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8300HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
8301LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
8302OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
8303SUCH DAMAGE.
8304
8305</programlisting></para></section>
8306
8307<section id="lic_42">
8308<title>UCB</title>
8309<para><programlisting>
8310 Copyright (c) 1987, 1989, 1990, 1991, 1992, 1993, 1994
8311 The Regents of the University of California. All rights reserved.
8312
8313 Redistribution and use in source and binary forms, with or without
8314 modification, are permitted provided that the following conditions
8315 are met:
8316 1. Redistributions of source code must retain the above copyright
8317 notice, this list of conditions and the following disclaimer.
8318 2. Redistributions in binary form must reproduce the above copyright
8319 notice, this list of conditions and the following disclaimer in the
8320 documentation and/or other materials provided with the distribution.
8321 3. Neither the name of the University nor the names of its contributors
8322 may be used to endorse or promote products derived from this software
8323 without specific prior written permission.
8324
8325 THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
8326 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
8327 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
8328 ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
8329 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
8330 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
8331 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8332 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
8333 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
8334 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
8335 SUCH DAMAGE.
8336</programlisting></para></section>
8337
8338<section id="lic_43">
8339<title>Unicode</title>
8340<para><programlisting>
8341COPYRIGHT AND PERMISSION NOTICE
8342
8343Copyright 1991-2015 Unicode, Inc. All rights reserved.
8344Distributed under the Terms of Use in
8345http://www.unicode.org/copyright.html.
8346
8347Permission is hereby granted, free of charge, to any person obtaining
8348a copy of the Unicode data files and any associated documentation
8349(the "Data Files") or Unicode software and any associated documentation
8350(the "Software") to deal in the Data Files or Software
8351without restriction, including without limitation the rights to use,
8352copy, modify, merge, publish, distribute, and/or sell copies of
8353the Data Files or Software, and to permit persons to whom the Data Files
8354or Software are furnished to do so, provided that
8355(a) this copyright and permission notice appear with all copies
8356of the Data Files or Software,
8357(b) this copyright and permission notice appear in associated
8358documentation, and
8359(c) there is clear notice in each modified Data File or in the Software
8360as well as in the documentation associated with the Data File(s) or
8361Software that the data or software has been modified.
8362
8363THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF
8364ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
8365WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
8366NONINFRINGEMENT OF THIRD PARTY RIGHTS.
8367IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS
8368NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL
8369DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
8370DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
8371TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
8372PERFORMANCE OF THE DATA FILES OR SOFTWARE.
8373
8374Except as contained in this notice, the name of a copyright holder
8375shall not be used in advertising or otherwise to promote the sale,
8376use or other dealings in these Data Files or Software without prior
8377written authorization of the copyright holder.
8378</programlisting></para></section>
8379
8380<section id="lic_44">
8381<title>W3C</title>
8382<para><programlisting>
8383
8384W3C SOFTWARE NOTICE AND LICENSE
8385This work (and included software, documentation such as READMEs, or other related
8386items) is being provided by the copyright holders under the following license.
8387License
8388By obtaining, using and/or copying this work, you (the licensee) agree that you have
8389read, understood, and will comply with the following terms and conditions.
8390Permission to copy, modify, and distribute this software and its documentation, with
8391or without modification, for any purpose and without fee or royalty is hereby granted,
8392provided that you include the following on ALL copies of the software and
8393documentation or portions thereof, including modifications:
8394The full text of this NOTICE in a location viewable to users of the redistributed or
8395derivative work.
8396Any pre-existing intellectual property disclaimers, notices, or terms and conditions.
8397If none exist, the W3C Software Short Notice should be included (hypertext is
8398preferred, text is permitted) within the body of any redistributed or derivative code.
8399Notice of any changes or modifications to the files, including the date changes were
8400made. (We recommend you provide URIs to the location from which the code is derived.)
8401Disclaimers
8402THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO
8403REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO,
8404WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF
8405THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS,
8406TRADEMARKS OR OTHER RIGHTS.
8407COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
8408CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
8409The name and trademarks of copyright holders may NOT be used in advertising or
8410publicity pertaining to the software without specific, written prior permission. Title
8411to copyright in this software and any associated documentation will at all times
8412remain with copyright holders.
8413Notes
8414This version: http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
8415This formulation of W3C`s notice and license became active on December 31 2002. This
8416version removes the copyright ownership notice such that this license can be used with
8417materials other than those owned by the W3C, reflects that ERCIM is now a host of the
8418W3C, includes references to this specific dated version of the license, and removes
8419the ambiguous grant of "use". Otherwise, this version is the same as the previous
8420version and is written so as to preserve the Free Software Foundation`s assessment of
8421GPL compatibility and OSI`s certification under the Open Source Definition.
8422
8423</programlisting></para></section>
8424
8425<section id="lic_45">
8426<title>ZPL-2.1</title>
8427<para><programlisting>
8428
8429ZPL 2.1
8430Zope Public License (ZPL) Version 2.1
8431
8432A copyright notice accompanies this license document that identifies the copyright
8433holders.
8434
8435This license has been certified as open source. It has also been designated as GPL
8436compatible by the Free Software Foundation (FSF).
8437
8438Redistribution and use in source and binary forms, with or without modification, are
8439permitted provided that the following conditions are met:
8440
8441Redistributions in source code must retain the accompanying copyright notice, this
8442list of conditions, and the following disclaimer.
8443Redistributions in binary form must reproduce the accompanying copyright notice, this
8444list of conditions, and the following disclaimer in the documentation and/or other
8445materials provided with the distribution.
8446Names of the copyright holders must not be used to endorse or promote products derived
8447from this software without prior written permission from the copyright holders.
8448The right to distribute this software or to use it for any purpose does not give you
8449the right to use Servicemarks (sm) or Trademarks (tm) of the copyright holders. Use of
8450them is covered by separate agreement with the copyright holders.
8451If any files are modified, you must cause the modified files to carry prominent
8452notices stating that you changed the files and the date of any change.
8453Disclaimer
8454THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS`` AND ANY EXPRESSED OR
8455IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
8456MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
8457THE COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
8458EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
8459SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8460HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
8461OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
8462SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
8463
8464</programlisting></para></section>
8465
8466<section id="lic_46">
8467<title>Zlib</title>
8468<para><programlisting>
8469
8470zlib License
8471
8472
8473 This software is provided `as-is`, without any express or implied
8474 warranty. In no event will the authors be held liable for any damages
8475 arising from the use of this software.
8476
8477 Permission is granted to anyone to use this software for any purpose,
8478 including commercial applications, and to alter it and redistribute it
8479 freely, subject to the following restrictions:
8480
8481 1. The origin of this software must not be misrepresented; you must not
8482 claim that you wrote the original software. If you use this software
8483 in a product, an acknowledgment in the product documentation would be
8484 appreciated but is not required.
8485 2. Altered source versions must be plainly marked as such, and must not be
8486 misrepresented as being the original software.
8487 3. This notice may not be removed or altered from any source distribution.
8488
8489
8490</programlisting></para></section>
8491
8492<section id="lic_47">
8493<title>tcl</title>
8494<para><programlisting>
8495This software is copyrighted by the Regents of the University of
8496California, Sun Microsystems, Inc., Scriptics Corporation, ActiveState
8497Corporation and other parties. The following terms apply to all files
8498associated with the software unless explicitly disclaimed in
8499individual files.
8500
8501The authors hereby grant permission to use, copy, modify, distribute,
8502and license this software and its documentation for any purpose, provided
8503that existing copyright notices are retained in all copies and that this
8504notice is included verbatim in any distributions. No written agreement,
8505license, or royalty fee is required for any of the authorized uses.
8506Modifications to this software may be copyrighted by their authors
8507and need not follow the licensing terms described here, provided that
8508the new terms are clearly indicated on the first page of each file where
8509they apply.
8510
8511IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
8512FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
8513ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
8514DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
8515POSSIBILITY OF SUCH DAMAGE.
8516
8517THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
8518INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
8519FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE
8520IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
8521NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
8522MODIFICATIONS.
8523
8524GOVERNMENT USE: If you are acquiring this software on behalf of the
8525U.S. government, the Government shall have only "Restricted Rights"
8526in the software and related documentation as defined in the Federal
8527Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2). If you
8528are acquiring the software on behalf of the Department of Defense, the
8529software shall be classified as "Commercial Computer Software" and the
8530Government shall have only "Restricted Rights" as defined in Clause
8531252.227-7014 (b) (3) of DFARs. Notwithstanding the foregoing, the
8532authors grant the U.S. Government and others acting in its behalf
8533permission to use and distribute the software in accordance with the
8534terms specified in this license.
8535</programlisting></para></section>
8536
8537 </section>
8538 <section id="proprietary_license">
8539 <title>Proprietary Licenses</title>
8540<section id="lic_48">
8541<title>Enea</title>
8542<para><programlisting>
8543 Copyright (C) 2006 by Enea.
8544 All rights reserved.
8545
8546 This Software is furnished under a software license agreement and
8547 may be used only in accordance with the terms of such agreement.
8548 Any other use or reproduction is prohibited. No title to and
8549 ownership of the Software is hereby transferred.
8550
8551 PROPRIETARY NOTICE
8552 This Software consists of confidential information.
8553 Trade secret law and copyright law protect this Software.
8554 The above notice of copyright on this Software does not indicate
8555 any actual or intended publication of such Software.
8556</programlisting></para></section>
8557
8558<section id="lic_49">
8559<title>Windbase</title>
8560<para><programlisting>
8561This file contains valuable trade secrets and proprietary
8562assets of Windbase Software Inc. Embodying substantial
8563creative efforts and confidential information. Unauthorized
8564use, copying, decompiling, translating, disclosure or
8565transfer, of any kind, is strictly prohibited.
8566
8567
8568COPYRIGHT (C) 1992, 1993, 1994. Windbase Software Inc.
8569ALL RIGHTS RESERVED.
8570</programlisting></para></section>
8571
8572 </section>
8573</chapter>
diff --git a/doc/book-enea-nfv-access-esdk-open-source/swcomp.mk b/doc/book-enea-nfv-access-esdk-open-source/swcomp.mk
deleted file mode 100644
index 93f242e..0000000
--- a/doc/book-enea-nfv-access-esdk-open-source/swcomp.mk
+++ /dev/null
@@ -1,10 +0,0 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-access-esdk-open-source
9BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access eSDK Open Source Report"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-nfv-access-guide/doc/benchmarks.xml b/doc/book-enea-nfv-access-guide/doc/benchmarks.xml
deleted file mode 100644
index 34748b8..0000000
--- a/doc/book-enea-nfv-access-guide/doc/benchmarks.xml
+++ /dev/null
@@ -1,1474 +0,0 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="benchmarks">
5 <title>Benchmarks</title>
6
7 <section id="hw-setup">
8 <title>Hardware Setup</title>
9
10 <para>The following table describes all the needed prequisites for an apt
11 hardware setup:</para>
12
13 <table>
14 <title>Hardware Setup</title>
15
16 <tgroup cols="2">
17 <colspec align="left" />
18
19 <thead>
20 <row>
21 <entry align="center">Item</entry>
22
23 <entry align="center">Description</entry>
24 </row>
25 </thead>
26
27 <tbody>
28 <row>
29 <entry align="left">Server Platform</entry>
30
31 <entry align="left">Cavium CN8304</entry>
32 </row>
33
34 <row>
35 <entry align="left">ARCH</entry>
36
37 <entry>aarch64</entry>
38 </row>
39
40 <row>
41 <entry align="left">Processor</entry>
42
43 <entry>Cavium OcteonTX CN83XX</entry>
44 </row>
45
46 <row>
47 <entry align="left">CPU freq</entry>
48
49 <entry>1.8 GHz</entry>
50 </row>
51
52 <row>
53 <entry align="left">RAM</entry>
54
55 <entry>16GB</entry>
56 </row>
57
58 <row>
59 <entry align="left">Network</entry>
60
61 <entry>2x10G ports</entry>
62 </row>
63
64 <row>
65 <entry align="left">Storage</entry>
66
67 <entry>Seagate 500GB HDD</entry>
68 </row>
69 </tbody>
70 </tgroup>
71 </table>
72
73 <para>Generic tests configuration:</para>
74
75 <itemizedlist>
76 <listitem>
77 <para>All tests use one port, one core and one Rx/TX queue for fast
78 path traffic.</para>
79 </listitem>
80 </itemizedlist>
81 </section>
82
83 <section id="use-cases">
84 <title>Use Cases</title>
85
86 <section id="docker-benchmarks">
87 <title>Docker related benchmarks</title>
88
89 <section>
90 <title>Forward traffic in Docker</title>
91
92 <para>Benchmarking traffic forwarding using the testpmd application in
93 a Docker container.</para>
94
95 <para>Pktgen is used to generate UDP traffic that will reach testpmd,
96 running in a Docker image. It will then be forwarded back to source on
97 the return trip (<emphasis role="bold">Forwarding</emphasis>).</para>
98
99 <para>This test measures:</para>
100
101 <itemizedlist>
102 <listitem>
103 <para>pktgen TX, RX in packets per second (pps) and MBps</para>
104 </listitem>
105
106 <listitem>
107 <para>testpmd TX, RX in packets per second (pps)</para>
108 </listitem>
109
110 <listitem>
111 <para>divide testpmd RX / pktgen TX in pps to obtain throughput in
112 percentages (%)</para>
113 </listitem>
114 </itemizedlist>
115
116 <section id="usecase-one">
117 <title>Test Setup for Target 1</title>
118
119 <para>Start by following the steps below:</para>
120
121 <para>Boot the NFV Access Linux using the following kernel
122 parameters in U-Boot: <programlisting>&gt; setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
123rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
124nosoftlockup audit=0'</programlisting></para>
125
126 <para>Configure hugepages and set up the DPDK:<programlisting>echo 4 &gt; /proc/sys/vm/nr_hugepages
127modprobe vfio-pci
128ifconfig enP1p1s0f1 down
129dpdk-devbind -b vfio-pci 0001:01:00.1</programlisting>Run
130 pktgen:<programlisting>cd /usr/share/apps/pktgen/
131./pktgen -v -c 0x7 -n 4 --proc-type auto -d /usr/lib/librte_pmd_thunderx_nicvf.so.1.1 \
132-w 0001:01:00.1 -- -P -m "[1:2].0"</programlisting>In the pktgen console
133 run:<programlisting>str</programlisting>Choose one of the values
134 from [64, 128, 256, 512] to change the packet size:<programlisting>set 0 size &lt;number&gt;</programlisting></para>
135 </section>
136
137 <section id="usecase-two">
138 <title>Test Setup for Target 2</title>
139
140 <para>Start by following the steps below:</para>
141
142 <para>Boot the NFV Access Linux using the following kernel
143 parameters in U-Boot:</para>
144
145 <programlisting>&gt; setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
146rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
147nosoftlockup audit=0'</programlisting>
148
149 <para>It is expected that a NFV Access guest image is present on the
150 target.</para>
151
152 <para>Set up the DPDK and configure the OVS bridge:<programlisting># Clean up old OVS old config
153killall ovsdb-server ovs-vswitchd
154rm -rf /etc/openvswitch/*
155rm -rf /var/run/openvswitch/*
156rm -rf /var/log/openvswitch/*
157mkdir -p /var/run/openvswitch
158
159# Configure hugepages and bind interfaces to dpdk
160echo 20 &gt; /proc/sys/vm/nr_hugepages
161modprobe vfio-pci
162ifconfig enP1p1s0f1 down
163dpdk-devbind --b vfio-pci 0001:01:00.1
164
165# configure openvswitch with DPDK
166export DB_SOCK=/var/run/openvswitch/db.sock
167ovsdb-tool create /etc/openvswitch/conf.db /usr/share/openvswitch/vswitch.ovsschema
168ovsdb-server --remote=punix:$DB_SOCK \
169 --remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
170ovs-vsctl --no-wait init
171ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
172ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
173ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
174ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
175ovs-vswitchd unix:$DB_SOCK --pidfile --detach \
176 --log-file=/var/log/openvswitch/ovs-vswitchd.log
177
178ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
179ovs-vsctl add-port ovsbr0 vhost-user1 -- set Interface vhost-user1 \
180 type=dpdkvhostuser -- set Interface vhost-user1 ofport_request=2
181ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 type=dpdk \
182 options:dpdk-devargs=0001:01:00.1 -- set Interface dpdk0 ofport_request=1
183
184# configure static flows
185ovs-ofctl del-flows ovsbr0
186ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
187ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
188 Docker container:<programlisting>docker import enea-nfv-access-guest-qemuarm64.tar.gz nfv_container</programlisting>Start
189 the Docker container:<programlisting>docker run -v /var/run/openvswitch/:/var/run/openvswitch/ \
190 -v /dev/hugepages/:/dev/hugepages/ -p nfv_container /bin/bash</programlisting>Start
191 the testpmd application in Docker:<programlisting>testpmd -c 0x30 -n 2 --file-prefix prog1 --socket-mem 512 \
192 --no-pci --vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 \
193 -d /usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 --disable-hw-vlan \
194 --disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 --rxq=1 \
195 --txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>To
196 start traffic <emphasis role="bold">forwarding</emphasis>, run the
197 following command in testpmd CLI:<programlisting>start</programlisting>To
198 start traffic but in <emphasis role="bold">termination</emphasis>
199 mode (no traffic sent on TX), run the following commands in testpmd
200 CLI:<programlisting>set fwd rxonly
201start</programlisting><table>
202 <title>Results in forwarding mode</title>
203
204 <tgroup cols="8">
205 <tbody>
206 <row>
207 <entry align="center"><emphasis
208 role="bold">Bytes</emphasis></entry>
209
210 <entry align="center"><emphasis role="bold">pktgen pps
211 TX</emphasis></entry>
212
213 <entry align="center"><emphasis role="bold">pktgen MBits/s
214 TX</emphasis></entry>
215
216 <entry align="center"><emphasis role="bold">pktgen pps
217 RX</emphasis></entry>
218
219 <entry align="center"><emphasis role="bold">pktgen MBits/s
220 RX</emphasis></entry>
221
222 <entry align="center"><emphasis role="bold">testpmd pps
223 RX</emphasis></entry>
224
225 <entry align="center"><emphasis role="bold">testpmd pps
226 TX</emphasis></entry>
227
228 <entry align="center"><emphasis role="bold">throughput
229 (%)</emphasis></entry>
230 </row>
231
232 <row>
233 <entry role="bold"><emphasis
234 role="bold">64</emphasis></entry>
235
236 <entry>14682363</entry>
237
238 <entry>9867</entry>
239
240 <entry>1666666</entry>
241
242 <entry>1119</entry>
243
244 <entry>1976488</entry>
245
246 <entry>1666694</entry>
247
248 <entry>13.46%</entry>
249 </row>
250
251 <row>
252 <entry><emphasis role="bold">128</emphasis></entry>
253
254 <entry>8445993</entry>
255
256 <entry>10000</entry>
257
258 <entry>1600567</entry>
259
260 <entry>1894</entry>
261
262 <entry>1886851</entry>
263
264 <entry>1600573</entry>
265
266 <entry>22.34%</entry>
267 </row>
268
269 <row>
270 <entry role="bold"><emphasis
271 role="bold">256</emphasis></entry>
272
273 <entry>4529011</entry>
274
275 <entry>10000</entry>
276
277 <entry>1491449</entry>
278
279 <entry>3292</entry>
280
281 <entry>1715763</entry>
282
283 <entry>1491445</entry>
284
285 <entry>37.88%</entry>
286 </row>
287
288 <row>
289 <entry><emphasis role="bold">512</emphasis></entry>
290
291 <entry>2349638</entry>
292
293 <entry>10000</entry>
294
295 <entry>1422338</entry>
296
297 <entry>6052</entry>
298
299 <entry>1555351</entry>
300
301 <entry>1422330</entry>
302
303 <entry>66.20%</entry>
304 </row>
305
306 <row>
307 <entry><emphasis role="bold">1024</emphasis></entry>
308
309 <entry>1197323</entry>
310
311 <entry>10000</entry>
312
313 <entry>1197325</entry>
314
315 <entry>9999</entry>
316
317 <entry>1197320</entry>
318
319 <entry>1197320</entry>
320
321 <entry>100.00%</entry>
322 </row>
323 </tbody>
324 </tgroup>
325 </table><table>
326 <title>Results in termination mode</title>
327
328 <tgroup cols="4">
329 <tbody>
330 <row>
331 <entry align="center"><emphasis
332 role="bold">Bytes</emphasis></entry>
333
334 <entry align="center"><emphasis role="bold">pktgen pps
335 TX</emphasis></entry>
336
337 <entry align="center"><emphasis role="bold">testpmd pps
338 RX</emphasis></entry>
339
340 <entry align="center"><emphasis role="bold">throughput
341 (%)</emphasis></entry>
342 </row>
343
344 <row>
345 <entry role="bold"><emphasis
346 role="bold">64</emphasis></entry>
347
348 <entry>14676922</entry>
349
350 <entry>1984693</entry>
351
352 <entry>13.52%</entry>
353 </row>
354
355 <row>
356 <entry><emphasis role="bold">128</emphasis></entry>
357
358 <entry>8445991</entry>
359
360 <entry>1895099</entry>
361
362 <entry>22.44%</entry>
363 </row>
364
365 <row>
366 <entry role="bold"><emphasis
367 role="bold">256</emphasis></entry>
368
369 <entry>4528379</entry>
370
371 <entry>1722004</entry>
372
373 <entry>38.03%</entry>
374 </row>
375
376 <row>
377 <entry><emphasis role="bold">512</emphasis></entry>
378
379 <entry>2349639</entry>
380
381 <entry>1560988</entry>
382
383 <entry>66.44%</entry>
384 </row>
385
386 <row>
387 <entry><emphasis role="bold">1024</emphasis></entry>
388
389 <entry>1197325</entry>
390
391 <entry>1197325</entry>
392
393 <entry>100.00%</entry>
394 </row>
395 </tbody>
396 </tgroup>
397 </table></para>
398 </section>
399 </section>
400
401 <section id="usecase-three-four">
402 <title>Forward traffic from Docker to another Docker on the same
403 host</title>
404
405 <para>Benchmark a combo test using testpmd running in two Docker
406 instances, one which forwards traffic to the second one, which
407 terminates it.</para>
408
409 <para>Packets are generated with pktgen and transmitted to the first
410 testpmd instance, which will forward them to the second testpmd
411 instance, which terminates them.</para>
412
413 <para>This test measures:</para>
414
415 <itemizedlist>
416 <listitem>
417 <para>pktgen TX, RX in packets per second (pps) and MBps</para>
418 </listitem>
419
420 <listitem>
421 <para>testpmd TX, RX in packets per second in the first Docker
422 container</para>
423 </listitem>
424
425 <listitem>
426 <para>testpmd TX, RX in packets per second in the second Docker
427 container</para>
428 </listitem>
429
430 <listitem>
431 <para>divide testpmd RX pps for the second Docker container to
432 pktgen TX pps to obtain throughput in percentages (%)</para>
433 </listitem>
434 </itemizedlist>
435
436 <section id="target-one-usecase-three">
437 <title>Test Setup for Target 1</title>
438
439 <para>Start by following the steps below:</para>
440
441 <para>Boot the NFV Access Linux using the following kernel
442 parameters in U-Boot:</para>
443
444 <programlisting>setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
445rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
446nosoftlockup audit=0'</programlisting>
447
448 <para>Configure hugepages and set up the DPDK:<programlisting>echo 4 &gt; /proc/sys/vm/nr_hugepages
449modprobe vfio-pci
450ifconfig enP1p1s0f1 down
451dpdk-devbind -b vfio-pci 0001:01:00.1</programlisting>Run
452 pktgen:<programlisting>cd /usr/share/apps/pktgen/
453./pktgen -v -c 0x7 -n 4 --proc-type auto -d /usr/lib/librte_pmd_thunderx_nicvf.so.1.1 \
454-w 0001:01:00.1 -- -P -m "[1:2].0"</programlisting>Choose one of the values
455 from [64, 128, 256, 512] to change the packet size:<programlisting>set 0 size &lt;number&gt;</programlisting></para>
456 </section>
457
458 <section id="target-two-usecase-four">
459 <title>Test Setup for Target 2</title>
460
461 <para>Start by following the steps below:</para>
462
463 <para>Boot the NFV Access Linux using the following kernel
464 parameters in U-Boot:</para>
465
466 <programlisting>setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
467rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
468nosoftlockup audit=0'</programlisting>
469
470 <para>Set up the DPDK and configure the OVS bridge:<programlisting># Clean up old OVS old config
471killall ovsdb-server ovs-vswitchd
472rm -rf /etc/openvswitch/*
473rm -rf /var/run/openvswitch/*
474rm -rf /var/log/openvswitch/*
475mkdir -p /var/run/openvswitch
476
477# Configure hugepages and bind interfaces to dpdk
478echo 20 &gt; /proc/sys/vm/nr_hugepages
479modprobe vfio-pci
480ifconfig enP1p1s0f1 down
481dpdk-devbind --b vfio-pci 0001:01:00.1
482
483# configure openvswitch with DPDK
484export DB_SOCK=/var/run/openvswitch/db.sock
485ovsdb-tool create /etc/openvswitch/conf.db /usr/share/openvswitch/vswitch.ovsschema
486ovsdb-server --remote=punix:$DB_SOCK \
487 --remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
488ovs-vsctl --no-wait init
489ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
490ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
491ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
492ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
493ovs-vswitchd unix:$DB_SOCK --pidfile --detach \
494 --log-file=/var/log/openvswitch/ovs-vswitchd.log
495
496ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
497ovs-vsctl add-port ovsbr0 vhost-user1 -- set Interface vhost-user1 \
498 type=dpdkvhostuser -- set Interface vhost-user1 ofport_request=1
499ovs-vsctl add-port ovsbr0 vhost-user2 -- set Interface vhost-user2 \
500 type=dpdkvhostuser -- set Interface vhost-user2 ofport_request=2
501ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 type=dpdk \
502 options:dpdk-devargs=0001:01:00.1 -- set Interface dpdk0 ofport_request=3
503
504# configure static flows
505ovs-ofctl del-flows ovsbr0
506ovs-ofctl add-flow ovsbr0 in_port=3,action=output:2
507ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
508 Docker container:<programlisting>docker import enea-nfv-access-guest-qemuarm64.tar.gz nfv_container</programlisting>Start
509 the first Docker container:<programlisting>docker run -v /var/run/openvswitch/:/var/run/openvswitch/ \
510 -v /dev/hugepages/:/dev/hugepages/ nfv_container /bin/bash</programlisting>Start
511 testpmd in the first Docker container:<programlisting>testpmd -c 0x300 -n 4 --file-prefix prog2 --socket-mem 512 \
512 --no-pci --vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 \
513 -d /usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 --disable-hw-vlan \
514 --disable-rss -i --portmask=0x1 --coremask=0x200 --nb-cores=1 --rxq=1 \
515 --txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>Configure
516 it in termination mode:<programlisting>set fwd rxonly</programlisting>Run
517 the testpmd application:<programlisting>start</programlisting>Open a
518 new console to the host and start the second Docker
519 instance:<programlisting>docker run -v /var/run/openvswitch/:/var/run/openvswitch/ \
520 -v /dev/hugepages/:/dev/hugepages/ nfv_container /bin/bash</programlisting>In
521 the second container start testpmd:<programlisting>testpmd -c 0x0F --file-prefix prog2 --socket-mem 512 --no-pci \
522--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 \
523-d /usr/lib/librte_pmd_virtio.so.1.1 -- -i --disable-hw-vlan</programlisting>Start
524 testpmd in the second Docker container:<programlisting>testpmd -c 0x30 -n 4 --file-prefix prog1 --socket-mem 512 \
525 --no-pci --vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 \
526 -d /usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 --disable-hw-vlan \
527 --disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 --rxq=1 \
528 --txq=1 --txd=512 --rxd=512 --txqflags=0xf00 --port-topology=chained</programlisting>In
529 the testpmd shell, run:<programlisting>start</programlisting>Start
530 pktgen traffic by running the following command in pktgen
531 CLI:<programlisting>start 0</programlisting>To record traffic
532 results, run:<programlisting>show port stats 0</programlisting></para>
533
534 <table>
535 <title>Results</title>
536
537 <tgroup cols="6">
538 <tbody>
539 <row>
540 <entry align="center"><emphasis
541 role="bold">Bytes</emphasis></entry>
542
543 <entry align="center"><emphasis role="bold">Target 1 -
544 pktgen pps TX</emphasis></entry>
545
546 <entry align="center"><emphasis role="bold">Target 2 -
547 (forwarding) testpmd pps RX</emphasis></entry>
548
549 <entry align="center"><emphasis role="bold">Target 2 -
550 (forwarding) testpmd pps TX</emphasis></entry>
551
552 <entry align="center"><emphasis role="bold">Target 2 -
553 (termination) testpmd pps RX</emphasis></entry>
554
555 <entry align="center"><emphasis role="bold">Throughput
556 (%)</emphasis></entry>
557 </row>
558
559 <row>
560 <entry role="bold"><emphasis
561 role="bold">64</emphasis></entry>
562
563 <entry>14683140</entry>
564
565 <entry>1979807</entry>
566
567 <entry>1366712</entry>
568
569 <entry>1366690</entry>
570
571 <entry>9.31%</entry>
572 </row>
573
574 <row>
575 <entry><emphasis role="bold">128</emphasis></entry>
576
577 <entry>8446005</entry>
578
579 <entry>1893514</entry>
580
581 <entry>1286628</entry>
582
583 <entry>1286621</entry>
584
585 <entry>15.23%</entry>
586 </row>
587
588 <row>
589 <entry role="bold"><emphasis
590 role="bold">256</emphasis></entry>
591
592 <entry>4529011</entry>
593
594 <entry>1716427</entry>
595
596 <entry>1140234</entry>
597
598 <entry>1140232</entry>
599
600 <entry>25.18%</entry>
601 </row>
602
603 <row>
604 <entry><emphasis role="bold">512</emphasis></entry>
605
606 <entry>2349638</entry>
607
608 <entry>1556898</entry>
609
610 <entry>1016661</entry>
611
612 <entry>1016659</entry>
613
614 <entry>43.27%</entry>
615 </row>
616
617 <row>
618 <entry><emphasis role="bold">1024</emphasis></entry>
619
620 <entry>1197326</entry>
621
622 <entry>1197319</entry>
623
624 <entry>869654</entry>
625
626 <entry>869652</entry>
627
628 <entry>72.63%</entry>
629 </row>
630
631 <row>
632 <entry><emphasis role="bold">1500</emphasis></entry>
633
634 <entry>822373</entry>
635
636 <entry>822369</entry>
637
638 <entry>760826</entry>
639
640 <entry>760821</entry>
641
642 <entry>92.52%</entry>
643 </row>
644 </tbody>
645 </tgroup>
646 </table>
647 </section>
648 </section>
649 </section>
650
651 <section id="vm-benchmarks">
652 <title>VM related benchmarks</title>
653
654 <section id="usecase-four">
655 <title>Forward/termination traffic in one VM</title>
656
657 <para>Benchmarking traffic (UDP) forwarding and termination using
658 testpmd in a virtual machine.</para>
659
660 <para>The pktgen application is used to generate traffic that will
661 reach testpmd running in a virtual machine, from where it will be
662 forwarded back to source. Within the same setup, a second measurement
663 will be done with traffic termination in the virtual machine.</para>
664
665 <para>This test case measures:</para>
666
667 <itemizedlist>
668 <listitem>
669 <para>pktgen TX, RX in packets per second (pps) and MBps</para>
670 </listitem>
671
672 <listitem>
673 <para>testpmd TX, RX in packets per second (pps)</para>
674 </listitem>
675
676 <listitem>
677 <para>divide <emphasis role="bold">testpmd RX</emphasis> by
678 <emphasis role="bold">pktgen TX</emphasis> in pps to obtain the
679 throughput in percentages (%)</para>
680 </listitem>
681 </itemizedlist>
682
683 <section id="targetone-usecasefour">
684 <title>Test Setup for Target 1</title>
685
686 <para>Start with the steps below:</para>
687
688 <para>Boot the NFV Access Linux using the following kernel
689 parameters in U-Boot: <programlisting>setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
690rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
691nosoftlockup audit=0'</programlisting></para>
692
693 <para>Configure hugepages and set up the DPDK:<programlisting>echo 4 &gt; /proc/sys/vm/nr_hugepages
694modprobe vfio-pci
695ifconfig enP1p1s0f1 down
696dpdk-devbind -b vfio-pci 0001:01:00.1</programlisting>Run
697 pktgen:<programlisting>cd /usr/share/apps/pktgen/
698./pktgen -v -c 0x7 -n 4 --proc-type auto -d /usr/lib/librte_pmd_thunderx_nicvf.so.1.1 \
699-w 0001:01:00.1 -- -P -m "[1:2].0"</programlisting>Choose one of the values
700 from [64, 128, 256, 512] to change the packet size:<programlisting>set 0 size &lt;number&gt;</programlisting></para>
701 </section>
702
703 <section id="targettwo-usecasefive">
704 <title>Test Setup for Target 2</title>
705
706 <para>Start by following the steps below:</para>
707
708 <para>Boot the NFV Access Linux using the following kernel
709 parameters in U-Boot: <programlisting>setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
710rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
711nosoftlockup audit=0'</programlisting>Kill unnecessary services:
712 <programlisting>killall ovsdb-server ovs-vswitchd
713rm -rf /etc/openvswitch/*
714rm -rf /var/run/openvswitch/*
715mkdir -p /var/run/openvswitch</programlisting>Configure hugepages, set up the
716 DPDK:<programlisting>echo 20 &gt; /proc/sys/vm/nr_hugepages
717modprobe vfio-pci
718dpdk-devbind --bind=vfio-pci 0001:01:00.1</programlisting>Configure
719 OVS:<programlisting>export DB_SOCK=/var/run/openvswitch/db.sock
720ovsdb-tool create /etc/openvswitch/conf.db /usr/share/openvswitch/vswitch.ovsschema
721ovsdb-server --remote=punix:$DB_SOCK \
722 --remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
723ovs-vsctl --no-wait init
724ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
725ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
726ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
727ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
728ovs-vswitchd unix:$DB_SOCK --pidfile --detach \
729 --log-file=/var/log/openvswitch/ovs-vswitchd.log
730
731ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 \
732 datapath_type=netdev
733ovs-vsctl add-port ovsbr0 vhost-user1 -- set Interface \
734 vhost-user1 type=dpdkvhostuser -- set Interface vhost-user1 ofport_request=2
735ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 \
736 type=dpdk options:dpdk-devargs=0001:01:00.1 -- set Interface dpdk0 ofport_request=1
737
738ovs-ofctl del-flows ovsbr0
739ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
740ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Create an
741 XML file with the content below (e.g.
742 <filename>/home/root/guest.xml</filename>):<programlisting>&lt;domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'&gt;
743 &lt;name&gt;nfv-ovs-vm&lt;/name&gt;
744 &lt;uuid&gt;ed204646-1ad5-11e7-93ae-92361f002671&lt;/uuid&gt;
745 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
746 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
747
748 &lt;memoryBacking&gt;
749 &lt;hugepages&gt;
750 &lt;page size='512' unit='M' nodeset='0'/&gt;
751 &lt;/hugepages&gt;
752 &lt;/memoryBacking&gt;
753
754 &lt;os&gt;
755 &lt;type arch='aarch64' machine='virt,gic_version=3'&gt;hvm&lt;/type&gt;
756 &lt;kernel&gt;Image&lt;/kernel&gt;
757 &lt;cmdline&gt;root=/dev/vda console=ttyAMA0,115200n8 maxcpus=24 coherent_pool=16M \
758 debug hugepagesz=512M hugepages=3 audit=0 isolcpus=1 nohz_full=1 rcu_nocbs=1 \
759 irqaffinity=0&lt;/cmdline&gt;
760 &lt;boot dev='hd'/&gt;
761 &lt;/os&gt;
762
763 &lt;features&gt;
764 &lt;acpi/&gt;
765 &lt;apic/&gt;
766 &lt;/features&gt;
767
768 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
769
770 &lt;cpu mode='host-model'&gt;
771 &lt;model fallback='allow'/&gt;
772 &lt;topology sockets='1' cores='2' threads='1'/&gt;
773 &lt;numa&gt;
774 &lt;cell id='0' cpus='0' memory='4194304' unit='KiB' memAccess='shared'/&gt;
775 &lt;/numa&gt;
776 &lt;/cpu&gt;
777
778 &lt;cputune&gt;
779 &lt;vcpupin vcpu="0" cpuset="4"/&gt;
780 &lt;vcpupin vcpu="1" cpuset="5"/&gt;
781 &lt;/cputune&gt;
782
783 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
784 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
785 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
786
787 &lt;devices&gt;
788 &lt;emulator&gt;/usr/bin/qemu-system-aarch64&lt;/emulator&gt;
789 &lt;disk type='file' device='disk'&gt;
790 &lt;driver name='qemu' type='raw' cache='none'/&gt;
791 &lt;source file='enea-nfv-access-guest-qemuarm64.ext4'/&gt;
792 &lt;target dev='vda' bus='virtio'/&gt;
793 &lt;/disk&gt;
794
795 &lt;serial type='pty'&gt;
796 &lt;target port='0'/&gt;
797 &lt;/serial&gt;
798
799 &lt;console type='pty'&gt;
800 &lt;target type='serial' port='0'/&gt;
801 &lt;/console&gt;
802 &lt;/devices&gt;
803
804 &lt;qemu:commandline&gt;
805 &lt;qemu:arg value='-chardev'/&gt;
806 &lt;qemu:arg value='socket,id=charnet0,path=/var/run/openvswitch/vhost-user1'/&gt;
807
808 &lt;qemu:arg value='-netdev'/&gt;
809 &lt;qemu:arg value='type=vhost-user,id=hostnet0,chardev=charnet0'/&gt;
810
811 &lt;qemu:arg value='-device'/&gt;
812 &lt;qemu:arg value='virtio-net-pci,netdev=hostnet0,id=net0,mac=00:00:00:00:00:01,
813 bus=pcie.0,addr=0x2'/&gt;
814 &lt;/qemu:commandline&gt;
815&lt;/domain&gt;</programlisting></para>
816
817 <para>Start the virtual machine by running:</para>
818
819 <para><programlisting>virsh create /home/root/guest.xml</programlisting></para>
820
821 <para>Connect to the virtual machine console:</para>
822
823 <para><programlisting>virsh console nfv-ovs-vm</programlisting></para>
824
825 <para>Inside the VM, configure the DPDK: <programlisting>ifconfig enp0s2 down
826echo 1 &gt; /sys/module/vfio/parameters/enable_unsafe_noiommu_mode
827modprobe vfio-pci
828dpdk-devbind -b vfio-pci 0000:00:02.0</programlisting>Inside the VM, start
829 testpmd: <programlisting>testpmd -v -c 0x3 -n 4 -d /usr/lib/librte_pmd_virtio.so.1.1 \
830-w 0000:00:02.0 -- -i --disable-hw-vlan-filter --no-flush-rx \
831--port-topology=chained</programlisting>For the <emphasis
832 role="bold">Forwarding test</emphasis>, run:<programlisting>set fwd io
833start</programlisting>For the <emphasis role="bold">Termination
834 test</emphasis>, set testpmd to only receive, then start
835 it:<programlisting>set fwd rxonly
836start</programlisting>On target 1, you may start pktgen traffic
837 now:<programlisting>start 0</programlisting>On target 2, use this
838 command to refresh the testpmd display traffic
839 statistics:<programlisting>show port stats 0</programlisting>To stop
840 generating traffic in order to choose a different frame size,
841 run:<programlisting>stop 0</programlisting>To clear numbers in
842 testpmd:<programlisting>clear port stats
843show port stats 0</programlisting><table>
844 <title>Results in forwarding mode</title>
845
846 <tgroup cols="8">
847 <tbody>
848 <row>
849 <entry align="center"><emphasis
850 role="bold">Bytes</emphasis></entry>
851
852 <entry align="center"><emphasis role="bold">pktgen pps
853 RX</emphasis></entry>
854
855 <entry align="center"><emphasis role="bold">pktgen pps
856 TX</emphasis></entry>
857
858 <entry align="center"><emphasis role="bold">testpmd pps
859 RX</emphasis></entry>
860
861 <entry align="center"><emphasis role="bold">testpmd pps
862 TX</emphasis></entry>
863
864 <entry align="center"><emphasis role="bold">pktgen MBits/s
865 RX</emphasis></entry>
866
867 <entry align="center"><emphasis role="bold">pktgen MBits/s
868 TX</emphasis></entry>
869
870 <entry align="center"><emphasis role="bold">throughput
871 (%)</emphasis></entry>
872 </row>
873
874 <row>
875 <entry role="bold"><emphasis
876 role="bold">64</emphasis></entry>
877
878 <entry>1555163</entry>
879
880 <entry>14686542</entry>
881
882 <entry>1978791</entry>
883
884 <entry>1554707</entry>
885
886 <entry>1044</entry>
887
888 <entry>9867</entry>
889
890 <entry>13.47%</entry>
891 </row>
892
893 <row>
894 <entry><emphasis role="bold">128</emphasis></entry>
895
896 <entry>1504275</entry>
897
898 <entry>8447999</entry>
899
900 <entry>1901468</entry>
901
902 <entry>1504266</entry>
903
904 <entry>1781</entry>
905
906 <entry>10000</entry>
907
908 <entry>22.51%</entry>
909 </row>
910
911 <row>
912 <entry role="bold"><emphasis
913 role="bold">256</emphasis></entry>
914
915 <entry>1423564</entry>
916
917 <entry>4529012</entry>
918
919 <entry>1718299</entry>
920
921 <entry>1423553</entry>
922
923 <entry>3142</entry>
924
925 <entry>10000</entry>
926
927 <entry>37.94%</entry>
928 </row>
929
930 <row>
931 <entry><emphasis role="bold">512</emphasis></entry>
932
933 <entry>1360379</entry>
934
935 <entry>2349636</entry>
936
937 <entry>1554844</entry>
938
939 <entry>1360456</entry>
940
941 <entry>5789</entry>
942
943 <entry>10000</entry>
944
945 <entry>66.17%</entry>
946 </row>
947
948 <row>
949 <entry><emphasis role="bold">1024</emphasis></entry>
950
951 <entry>1197327</entry>
952
953 <entry>1197329</entry>
954
955 <entry>1197319</entry>
956
957 <entry>1197329</entry>
958
959 <entry>9999</entry>
960
961 <entry>10000</entry>
962
963 <entry>100.00%</entry>
964 </row>
965 </tbody>
966 </tgroup>
967 </table><table>
968 <title>Results in termination mode</title>
969
970 <tgroup cols="5">
971 <tbody>
972 <row>
973 <entry align="center"><emphasis
974 role="bold">Bytes</emphasis></entry>
975
976 <entry align="center"><emphasis role="bold">pktgen pps
977 TX</emphasis></entry>
978
979 <entry align="center"><emphasis role="bold">testpmd pps
980 RX</emphasis></entry>
981
982 <entry align="center"><emphasis role="bold">pktgen MBits/s
983 TX</emphasis></entry>
984
985 <entry align="center"><emphasis role="bold">throughput
986 (%)</emphasis></entry>
987 </row>
988
989 <row>
990 <entry role="bold"><emphasis
991 role="bold">64</emphasis></entry>
992
993 <entry>14695621</entry>
994
995 <entry>1983227</entry>
996
997 <entry>9875</entry>
998
999 <entry>13.50%</entry>
1000 </row>
1001
1002 <row>
1003 <entry><emphasis role="bold">128</emphasis></entry>
1004
1005 <entry>8446022</entry>
1006
1007 <entry>1897546</entry>
1008
1009 <entry>10000</entry>
1010
1011 <entry>22.47%</entry>
1012 </row>
1013
1014 <row>
1015 <entry><emphasis role="bold">256</emphasis></entry>
1016
1017 <entry>4529011</entry>
1018
1019 <entry>1724323</entry>
1020
1021 <entry>10000</entry>
1022
1023 <entry>38.07%</entry>
1024 </row>
1025
1026 <row>
1027 <entry><emphasis role="bold">512</emphasis></entry>
1028
1029 <entry>2349638</entry>
1030
1031 <entry>1562212</entry>
1032
1033 <entry>10000</entry>
1034
1035 <entry>66.49%</entry>
1036 </row>
1037
1038 <row>
1039 <entry role="bold"><emphasis
1040 role="bold">1024</emphasis></entry>
1041
1042 <entry>1197323</entry>
1043
1044 <entry>1197324</entry>
1045
1046 <entry>10000</entry>
1047
1048 <entry>100.00%</entry>
1049 </row>
1050 </tbody>
1051 </tgroup>
1052 </table></para>
1053 </section>
1054 </section>
1055
1056 <section id="usecase-six">
1057 <title>Forward traffic between two VMs</title>
1058
1059 <para>Benchmark a combo test using two virtual machines, the first
1060 with traffic forwarding to the second, which terminates it.</para>
1061
1062 <para>Measurements are made in:</para>
1063
1064 <itemizedlist>
1065 <listitem>
1066 <para>pktgen TX in pps and MBps</para>
1067 </listitem>
1068
1069 <listitem>
1070 <para>testpmd TX and RX pps in VM1</para>
1071 </listitem>
1072
1073 <listitem>
1074 <para>testpmd RX pps in VM2</para>
1075 </listitem>
1076
1077 <listitem>
1078 <para>divide<emphasis role="bold"> VM2 testpmd RX pps</emphasis>
1079 by <emphasis role="bold">pktgen TX pps </emphasis>to obtain the
1080 throughput in percentages (%)</para>
1081 </listitem>
1082 </itemizedlist>
1083
1084 <section id="targetone-usecase-five">
1085 <title>Test Setup for Target 1</title>
1086
1087 <para>Start by doing the following:</para>
1088
1089 <para>Boot the NFV Access Linux using the following kernel
1090 parameters in U-Boot: <programlisting>setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
1091rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
1092nosoftlockup audit=0'</programlisting>Configure hugepages and set up the
1093 DPDK:<programlisting>echo 4 &gt; /proc/sys/vm/nr_hugepages
1094modprobe vfio-pci
1095ifconfig enP1p1s0f1 down
1096dpdk-devbind -b vfio-pci 0001:01:00.1</programlisting>Run
1097 pktgen:<programlisting>cd /usr/share/apps/pktgen/
1098./pktgen -v -c 0x7 -n 4 --proc-type auto -d /usr/lib/librte_pmd_thunderx_nicvf.so.1.1 \
1099-w 0001:01:00.1 -- -P -m "[1:2].0"</programlisting>Choose one of the values
1100 from [64, 128, 256, 512] to change the packet size:<programlisting>set 0 size &lt;number&gt;</programlisting></para>
1101 </section>
1102
1103 <section id="targettwo-usecase-six">
1104 <title>Test Setup for Target 2</title>
1105
1106 <para>Start by doing the following:</para>
1107
1108 <para>Boot the NFV Access Linux using the following kernel
1109 parameters in U-Boot: <programlisting>setenv bootargs 'nohz_full=1-23 isolcpus=1-23 \
1110rcu-nocbs=1-23 rcu_nocb_poll clocksource=tsc tsc=reliable nohpet \
1111nosoftlockup audit=0'</programlisting>Kill Services:<programlisting>killall ovsdb-server ovs-vswitchd
1112rm -rf /etc/openvswitch/*
1113mkdir -p /var/run/openvswitch</programlisting>Configure hugepages, set up the
1114 DPDK:<programlisting>echo 20 &gt; /proc/sys/vm/nr_hugepages
1115modprobe vfio-pci
1116dpdk-devbind --bind=vfio-pci 0001:01:00.1</programlisting>Configure the
1117 OVS:<programlisting>export DB_SOCK=/var/run/openvswitch/db.sock
1118ovsdb-tool create /etc/openvswitch/conf.db /usr/share/openvswitch/vswitch.ovsschema
1119ovsdb-server --remote=punix:$DB_SOCK \
1120 --remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
1121ovs-vsctl --no-wait init
1122ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
1123ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
1124ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
1125ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
1126ovs-vswitchd unix:$DB_SOCK --pidfile --detach \
1127 --log-file=/var/log/openvswitch/ovs-vswitchd.log
1128
1129ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
1130ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 type=dpdk \
1131 options:dpdk-devargs=0001:01:00.1 -- set Interface dpdk0 ofport_request=1
1132ovs-vsctl add-port ovsbr0 vhost-user1 -- set Interface vhost-user1 type=dpdkvhostuser \
1133 -- set Interface vhost-user1 ofport_request=2
1134ovs-vsctl add-port ovsbr0 vhost-user2 -- set Interface vhost-user2 type=dpdkvhostuser \
1135 -- set Interface vhost-user2 ofport_request=3
1136
1137ovs-ofctl del-flows ovsbr0
1138ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
1139ovs-ofctl add-flow ovsbr0 in_port=2,action=output:3</programlisting>Create an
1140 XML with the content below and then run <command>virsh create
1141 &lt;XML_FILE&gt;</command><programlisting>&lt;domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'&gt;
1142 &lt;name&gt;nfv-ovs-vm1&lt;/name&gt;
1143 &lt;uuid&gt;ed204646-1ad5-11e7-93ae-92361f002671&lt;/uuid&gt;
1144 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
1145 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
1146
1147 &lt;memoryBacking&gt;
1148 &lt;hugepages&gt;
1149 &lt;page size='512' unit='M' nodeset='0'/&gt;
1150 &lt;/hugepages&gt;
1151 &lt;/memoryBacking&gt;
1152
1153 &lt;os&gt;
1154 &lt;type arch='aarch64' machine='virt,gic_version=3'&gt;hvm&lt;/type&gt;
1155 &lt;kernel&gt;Image&lt;/kernel&gt;
1156 &lt;cmdline&gt;root=/dev/vda console=ttyAMA0,115200n8 maxcpus=24 coherent_pool=16M \
1157 debug hugepagesz=512M hugepages=3 audit=0 isolcpus=1 nohz_full=1 rcu_nocbs=1 \
1158 irqaffinity=0&lt;/cmdline&gt;
1159 &lt;boot dev='hd'/&gt;
1160 &lt;/os&gt;
1161
1162 &lt;features&gt;
1163 &lt;acpi/&gt;
1164 &lt;apic/&gt;
1165 &lt;/features&gt;
1166
1167 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
1168
1169 &lt;cpu mode='host-model'&gt;
1170 &lt;model fallback='allow'/&gt;
1171 &lt;topology sockets='1' cores='2' threads='1'/&gt;
1172 &lt;numa&gt;
1173 &lt;cell id='0' cpus='0' memory='4194304' unit='KiB' memAccess='shared'/&gt;
1174 &lt;/numa&gt;
1175 &lt;/cpu&gt;
1176
1177 &lt;cputune&gt;
1178 &lt;vcpupin vcpu="0" cpuset="4"/&gt;
1179 &lt;vcpupin vcpu="1" cpuset="5"/&gt;
1180 &lt;/cputune&gt;
1181
1182 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
1183 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
1184 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
1185
1186 &lt;devices&gt;
1187 &lt;emulator&gt;/usr/bin/qemu-system-aarch64&lt;/emulator&gt;
1188 &lt;disk type='file' device='disk'&gt;
1189 &lt;driver name='qemu' type='raw' cache='none'/&gt;
1190 &lt;source file='enea-nfv-access-guest-qemuarm64.ext4'/&gt;
1191 &lt;target dev='vda' bus='virtio'/&gt;
1192 &lt;/disk&gt;
1193
1194 &lt;serial type='pty'&gt;
1195 &lt;target port='0'/&gt;
1196 &lt;/serial&gt;
1197
1198 &lt;console type='pty'&gt;
1199 &lt;target type='serial' port='0'/&gt;
1200 &lt;/console&gt;
1201 &lt;/devices&gt;
1202
1203 &lt;qemu:commandline&gt;
1204 &lt;qemu:arg value='-chardev'/&gt;
1205 &lt;qemu:arg value='socket,id=charnet0,path=/var/run/openvswitch/vhost-user1'/&gt;
1206
1207 &lt;qemu:arg value='-netdev'/&gt;
1208 &lt;qemu:arg value='type=vhost-user,id=hostnet0,chardev=charnet0'/&gt;
1209
1210 &lt;qemu:arg value='-device'/&gt;
1211 &lt;qemu:arg value='virtio-net-pci,netdev=hostnet0,id=net0,mac=00:00:00:00:00:01,/
1212 bus=pcie.0,addr=0x2'/&gt;
1213 &lt;/qemu:commandline&gt;
1214&lt;/domain&gt;</programlisting></para>
1215
1216 <para>The first virtual machine shall be called VM1. Connect to the
1217 first virtual machine console, by running:</para>
1218
1219 <para><programlisting>virsh console nfv-ovs-vm1</programlisting></para>
1220
1221 <para>Connect to Target 2 through a new <literal>SSH</literal>
1222 session, and launch a second VM by creating another XML file and
1223 running <command>virsh create
1224 &lt;XML_FILE2&gt;:</command><programlisting>&lt;domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'&gt;
1225 &lt;name&gt;nfv-ovs-vm2&lt;/name&gt;
1226 &lt;uuid&gt;ed204646-1ad5-11e7-93ae-92361f002623&lt;/uuid&gt;
1227 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
1228 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
1229
1230 &lt;memoryBacking&gt;
1231 &lt;hugepages&gt;
1232 &lt;page size='512' unit='M' nodeset='0'/&gt;
1233 &lt;/hugepages&gt;
1234 &lt;/memoryBacking&gt;
1235
1236 &lt;os&gt;
1237 &lt;type arch='aarch64' machine='virt,gic_version=3'&gt;hvm&lt;/type&gt;
1238 &lt;kernel&gt;Image&lt;/kernel&gt;
1239 &lt;cmdline&gt;root=/dev/vda console=ttyAMA0,115200n8 maxcpus=24 coherent_pool=16M \
1240 debug hugepagesz=512M hugepages=3 audit=0 isolcpus=1 nohz_full=1 rcu_nocbs=1 \
1241 irqaffinity=0&lt;/cmdline&gt;
1242 &lt;boot dev='hd'/&gt;
1243 &lt;/os&gt;
1244
1245 &lt;features&gt;
1246 &lt;acpi/&gt;
1247 &lt;apic/&gt;
1248 &lt;/features&gt;
1249
1250 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
1251
1252 &lt;cpu mode='host-model'&gt;
1253 &lt;model fallback='allow'/&gt;
1254 &lt;topology sockets='1' cores='2' threads='1'/&gt;
1255 &lt;numa&gt;
1256 &lt;cell id='0' cpus='0' memory='4194304' unit='KiB' memAccess='shared'/&gt;
1257 &lt;/numa&gt;
1258 &lt;/cpu&gt;
1259
1260 &lt;cputune&gt;
1261 &lt;vcpupin vcpu="0" cpuset="6"/&gt;
1262 &lt;vcpupin vcpu="1" cpuset="7"/&gt;
1263 &lt;/cputune&gt;
1264
1265 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
1266 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
1267 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
1268
1269 &lt;devices&gt;
1270 &lt;emulator&gt;/usr/bin/qemu-system-aarch64&lt;/emulator&gt;
1271 &lt;disk type='file' device='disk'&gt;
1272 &lt;driver name='qemu' type='raw' cache='none'/&gt;
1273 &lt;source file='enea-nfv-access-guest-qemuarm64.ext4'/&gt;
1274 &lt;target dev='vda' bus='virtio'/&gt;
1275 &lt;/disk&gt;
1276
1277 &lt;serial type='pty'&gt;
1278 &lt;target port='0'/&gt;
1279 &lt;/serial&gt;
1280
1281 &lt;console type='pty'&gt;
1282 &lt;target type='serial' port='0'/&gt;
1283 &lt;/console&gt;
1284 &lt;/devices&gt;
1285
1286 &lt;qemu:commandline&gt;
1287 &lt;qemu:arg value='-chardev'/&gt;
1288 &lt;qemu:arg value='socket,id=charnet1,path=/var/run/openvswitch/vhost-user2'/&gt;
1289
1290 &lt;qemu:arg value='-netdev'/&gt;
1291 &lt;qemu:arg value='type=vhost-user,id=hostnet0,chardev=charnet1'/&gt;
1292
1293 &lt;qemu:arg value='-device'/&gt;
1294 &lt;qemu:arg value='virtio-net-pci,netdev=hostnet0,id=net0,mac=00:00:00:00:00:02,/
1295 bus=pcie.0,addr=0x2'/&gt;
1296 &lt;/qemu:commandline&gt;
1297&lt;/domain&gt;</programlisting></para>
1298
1299 <para>The second virtual machine shall be called VM2. Connect to the
1300 second virtual machine console, by running:</para>
1301
1302 <para><programlisting>virsh console nfv-ovs-vm2</programlisting></para>
1303
1304 <para>Configure the DPDK inside VM1:<programlisting>ifconfig enp0s2 down
1305echo 1 &gt; /sys/module/vfio/parameters/enable_unsafe_noiommu_mode
1306modprobe vfio-pci
1307dpdk-devbind -b vfio-pci 0000:00:02.0</programlisting>Run testpmd inside
1308 VM1:<programlisting>testpmd -v -c 0x3 -n 4 -d /usr/lib/librte_pmd_virtio.so.1.1 \
1309 -w 0000:00:02.0 -- -i --disable-hw-vlan-filter \
1310 --no-flush-rx --port-topology=chained</programlisting>Start testpmd inside
1311 VM1:<programlisting>start</programlisting>Configure the DPDK inside
1312 VM2:<programlisting>ifconfig enp0s2 down
1313echo 1 &gt; /sys/module/vfio/parameters/enable_unsafe_noiommu_mode
1314modprobe vfio-pci
1315dpdk-devbind -b vfio-pci 0000:00:02.0</programlisting>Run testpmd inside
1316 VM2:<programlisting>testpmd -v -c 0x3 -n 4 -d /usr/lib/librte_pmd_virtio.so.1.1 \
1317 -w 0000:00:02.0 -- -i --disable-hw-vlan-filter \
1318 --no-flush-rx --port-topology=chained</programlisting>Set VM2 for
1319 termination and start testpmd:<programlisting>set fwd rxonly
1320start</programlisting>On target 1, start pktgen traffic:<programlisting>start 0</programlisting>Use
1321 this command to refresh the testpmd display in VM1 and VM2 and note
1322 the highest values:<programlisting>show port stats 0</programlisting>To
1323 stop traffic from pktgen, in order to choose a different frame
1324 size:<programlisting>stop 0</programlisting>To clear numbers in
1325 testpmd:<programlisting>clear port stats
1326show port stats 0</programlisting>For VM1, we record the stats relevant for
1327 <emphasis role="bold">forwarding</emphasis>:</para>
1328
1329 <itemizedlist>
1330 <listitem>
1331 <para>RX, TX in pps</para>
1332 </listitem>
1333 </itemizedlist>
1334
1335 <para>Only Rx-pps and Tx-pps numbers are important here, they change
1336 every time stats are displayed as long as there is traffic. Run the
1337 command a few times and pick the best (maximum) values
1338 observed.</para>
1339
1340 <para>For VM2, we record the stats relevant for <emphasis
1341 role="bold">termination</emphasis>:</para>
1342
1343 <itemizedlist>
1344 <listitem>
1345 <para>RX in pps (TX will be 0)</para>
1346 </listitem>
1347 </itemizedlist>
1348
1349 <para>For pktgen, we record only the TX side, because flow is
1350 terminated, with no RX traffic reaching pktgen:</para>
1351
1352 <itemizedlist>
1353 <listitem>
1354 <para>TX in pps and Mbit/s</para>
1355 </listitem>
1356 </itemizedlist>
1357
1358 <table>
1359 <title>Results in forwarding mode</title>
1360
1361 <tgroup cols="7">
1362 <tbody>
1363 <row>
1364 <entry align="center"><emphasis
1365 role="bold">Bytes</emphasis></entry>
1366
1367 <entry align="center"><emphasis role="bold">pktgen pps
1368 TX</emphasis></entry>
1369
1370 <entry align="center"><emphasis role="bold">VM1 testpmd pps
1371 RX</emphasis></entry>
1372
1373 <entry align="center"><emphasis role="bold">VM1 testpmd pps
1374 TX</emphasis></entry>
1375
1376 <entry align="center"><emphasis role="bold">VM2 testpmd pps
1377 RX</emphasis></entry>
1378
1379 <entry align="center"><emphasis role="bold">pktgen MBits/s
1380 TX</emphasis></entry>
1381
1382 <entry align="center"><emphasis role="bold">throughput
1383 (%)</emphasis></entry>
1384 </row>
1385
1386 <row>
1387 <entry role="bold"><emphasis
1388 role="bold">64</emphasis></entry>
1389
1390 <entry>14692306</entry>
1391
1392 <entry>1986888</entry>
1393
1394 <entry>1278884</entry>
1395
1396 <entry>1278792</entry>
1397
1398 <entry>9870</entry>
1399
1400 <entry>8.70%</entry>
1401 </row>
1402
1403 <row>
1404 <entry><emphasis role="bold">128</emphasis></entry>
1405
1406 <entry>8445997</entry>
1407
1408 <entry>1910675</entry>
1409
1410 <entry>1205371</entry>
1411
1412 <entry>1205371</entry>
1413
1414 <entry>10000</entry>
1415
1416 <entry>14.27%</entry>
1417 </row>
1418
1419 <row>
1420 <entry role="bold"><emphasis
1421 role="bold">256</emphasis></entry>
1422
1423 <entry>4529126</entry>
1424
1425 <entry>1723468</entry>
1426
1427 <entry>1080976</entry>
1428
1429 <entry>1080977</entry>
1430
1431 <entry>10000</entry>
1432
1433 <entry>23.87%</entry>
1434 </row>
1435
1436 <row>
1437 <entry><emphasis role="bold">512</emphasis></entry>
1438
1439 <entry>2349638</entry>
1440
1441 <entry>1559367</entry>
1442
1443 <entry>972923</entry>
1444
1445 <entry>972921</entry>
1446
1447 <entry>10000</entry>
1448
1449 <entry>41.41%</entry>
1450 </row>
1451
1452 <row>
1453 <entry><emphasis role="bold">1024</emphasis></entry>
1454
1455 <entry>1197322</entry>
1456
1457 <entry>1197318</entry>
1458
1459 <entry>839508</entry>
1460
1461 <entry>839508</entry>
1462
1463 <entry>10000</entry>
1464
1465 <entry>70.12%</entry>
1466 </row>
1467 </tbody>
1468 </tgroup>
1469 </table>
1470 </section>
1471 </section>
1472 </section>
1473 </section>
1474</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/book.xml b/doc/book-enea-nfv-access-guide/doc/book.xml
deleted file mode 100644
index ca2f31c..0000000
--- a/doc/book-enea-nfv-access-guide/doc/book.xml
+++ /dev/null
@@ -1,30 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
5]>
6<book id="book_enea_nfv_access_guide">
7 <title><trademark class="registered">Enea</trademark> NFV Access Guide</title>
8 <subtitle>Release Version
9 <xi:include href="eltf_params_updated.xml" xpointer="element(EneaLinux_REL_VER/1)"
10 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle>
11 <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb -->
12 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml"
13 xmlns:xi="http://www.w3.org/2001/XInclude" />
14 <xi:include href="overview.xml"
15 xmlns:xi="http://www.w3.org/2001/XInclude" />
16 <xi:include href="getting_started.xml"
17 xmlns:xi="http://www.w3.org/2001/XInclude" />
18 <xi:include href="hypervisor_virtualization.xml"
19 xmlns:xi="http://www.w3.org/2001/XInclude" />
20 <xi:include href="container_virtualization.xml"
21 xmlns:xi="http://www.w3.org/2001/XInclude" />
22 <xi:include href="ovs.xml"
23 xmlns:xi="http://www.w3.org/2001/XInclude" />
24 <xi:include href="dpdk.xml"
25 xmlns:xi="http://www.w3.org/2001/XInclude" />
26 <xi:include href="benchmarks.xml"
27 xmlns:xi="http://www.w3.org/2001/XInclude" />
28 <xi:include href="using_nfv_access_sdks.xml"
29 xmlns:xi="http://www.w3.org/2001/XInclude" />
30</book>
diff --git a/doc/book-enea-nfv-access-guide/doc/container_virtualization.xml b/doc/book-enea-nfv-access-guide/doc/container_virtualization.xml
deleted file mode 100644
index 52716bd..0000000
--- a/doc/book-enea-nfv-access-guide/doc/container_virtualization.xml
+++ /dev/null
@@ -1,136 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="container-virtualization">
5 <title>Container Virtualization</title>
6
7 <section id="docker">
8 <title>Docker</title>
9
10 <para>Docker is an open-source project that automates the deployment of
11 applications inside software containers, by providing an additional layer
12 of abstraction and automation of operating-system-level virtualization on
13 Linux.</para>
14
15 <para>The software container mechanism uses resource isolation features
16 inside the Linux kernel, such as cgroups and kernel namespaces to allow
17 multiple containers to run within a single Linux instance, avoiding the
18 overhead of starting and maintaining virtual machines.</para>
19
20 <para>Containers are lightweight and include everything needed to run
21 themselves: code, runtime, system tools, system libraries and settings.
22 The main advantage provided by containers is that the encapsulated
23 software is isolated from its surroundings. For example, differences
24 between development and staging environments can be kept separate in order
25 to reduce conflicts between teams running different software on the same
26 infrastructure.</para>
27
28 <para>For a better understanding of what Docker is and how it works, the
29 official documentation provided on the Docker website should be consulted:
30 <ulink
31 url="https://docs.docker.com/">https://docs.docker.com/</ulink>.</para>
32
33 <section id="launch-docker-container">
34 <title>Launching a Docker container</title>
35
36 <para>Docker provides a hello-world container which checks whether your
37 system is running the daemon correctly. This container can be launched
38 by simply running:</para>
39
40 <programlisting>docker run hello-world</programlisting>
41
42 <para>If your installation is working correctly, the following message
43 should be outputted:<programlisting>Hello from Docker!</programlisting></para>
44 </section>
45
46 <section id="run-enfv-guest-image">
47 <title>Run an Enea NFV Access guest image</title>
48
49 <para>Enea NFV Access guest images can run inside Docker as any other
50 container can. Before starting an Enea NFV Access guest image, a root
51 filesystem has to be imported in Docker:</para>
52
53 <programlisting>docker import enea-nfv-access-guest-qemuarm64.tar.gz nfv_guest</programlisting>
54
55 <para>To check that the Docker image has been imported successfully,
56 run:</para>
57
58 <programlisting>docker images</programlisting>
59
60 <para>Finally, start an Enea NFV Access container with
61 <literal>bash</literal> running as the shell, by running:</para>
62
63 <programlisting>docker run -it nfv_guest /bin/bash</programlisting>
64 </section>
65
66 <section id="attach-ext-resources-docker-containers">
67 <title>Attach external resources to Docker containers</title>
68
69 <para>Any system resource present on the host machine can be attached or
70 accessed by a Docker container.</para>
71
72 <para>Typically, if a file or folder on the host machine needs to be
73 attached to a container, that container should be launched with the
74 <literal>-v</literal> parameter. For example, to attach the
75 <literal>roots</literal> home folder to a container, the command line
76 for Docker should have the following format:</para>
77
78 <programlisting>docker run -it -v /home/root:/home/host_root/ nfv_guest /bin/bash</programlisting>
79
80 <para>To check that folders have been properly passed from the host to
81 the container, create a file in the source folder on the host root
82 filesystem and check for its existence inside the containers destination
83 location.</para>
84
85 <section id="attach-vhost-descriptors">
86 <title>Attach vhost file descriptors</title>
87
88 <para>If OVS is running on the host and vhost file descriptors need to
89 be passed to the container, this can be done by either mapping the
90 folder where all the file descriptors are located or mapping the file
91 descriptor itself:</para>
92
93 <itemizedlist>
94 <listitem>
95 <para>Mapping the folder can be done as exemplified above:</para>
96
97 <programlisting>docker run -it --rm -v /var/run/openvswitch/:/var/run/openvswitch/ nfv_guest /bin/bash</programlisting>
98 </listitem>
99
100 <listitem>
101 <para>Mapping a file descriptor is done in a similar way, but the
102 <literal>-v</literal> flag needs to point directly to it:</para>
103
104 <programlisting>docker run -it --rm -v /var/run/openvswitch/vhost-user1 nfv_guest /bin/bash</programlisting>
105 </listitem>
106 </itemizedlist>
107 </section>
108
109 <section id="attach-hugepages-mount-folders">
110 <title>Attach hugepages mount folders</title>
111
112 <para>Hugepages mount folders can also be accessed by a container
113 similarly to how a plain folder is mapped, as shown in 1.3.</para>
114
115 <para>For example, if the host system has hugepages mounted in the
116 <literal>/mnt/huge</literal> location, a container can also access
117 hugepages by being launched with:</para>
118
119 <programlisting>docker run -it -v /mnt/huge nfv_guest /bin/bash</programlisting>
120 </section>
121
122 <section id="access-pci-bus">
123 <title>Access the PCI bus</title>
124
125 <para>If the host machine has multiple SRIOV instances created, a
126 container can access the instances by being given privileged access to
127 the host system. Unlike folders, PCI devices do not have to be mounted
128 explicitly in order to be accessed and will be available to the
129 container if the <literal>--privileged</literal> flag is passed to the
130 command line:</para>
131
132 <programlisting>docker run --privileged -it nfv_guest /bin/bash</programlisting>
133 </section>
134 </section>
135 </section>
136</chapter>
diff --git a/doc/book-enea-nfv-access-guide/doc/dpdk.xml b/doc/book-enea-nfv-access-guide/doc/dpdk.xml
deleted file mode 100644
index bc3f479..0000000
--- a/doc/book-enea-nfv-access-guide/doc/dpdk.xml
+++ /dev/null
@@ -1,125 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="dpdk">
5 <title>Data Plane Development Kit</title>
6
7 <para>The Intel Data Plane Development Kit (DPDK) is a set of user-space
8 libraries and drivers that provides a programming framework for high-speed
9 packet processing applications. The DPDK includes a number of Poll Mode
10 Drivers that enable direct packet transfer between the physical NIC and
11 user-space without using interrupts, bypassing the Linux kernel network
12 stack entirely.</para>
13
14 <para>In order to take advantage of DPDK, Linux <ulink
15 url="https://www.kernel.org/doc/Documentation/vm/hugetlbpage.txt">huge
16 pages</ulink> must be enabled in the system. The allocation of huge pages
17 should preferably be done at boot time by passing parameters on the kernel
18 command line. Add the following to the kernel boot parameters:</para>
19
20 <programlisting>default_hugepagesz=512MB hugepagesz=512MB hugepages=20</programlisting>
21
22 <para>For DPDK documentation, see <ulink
23 url="http://dpdk.org/doc/guides-17.08/index.html">http://dpdk.org/doc/guides-17.08/index.html</ulink></para>
24
25 <section id="pktgen">
26 <title>Pktgen</title>
27
28 <para>In addition to DPDK, Enea NFV Access includes Pktgen, a software
29 traffic generator that is powered by the DPDK packet processing framework.
30 Pktgen can act as a transmitter or receiver and is capable of generating
31 10Gbit wire rate traffic with 64 byte frames.</para>
32
33 <para>Pktgen is installed in <literal>/usr/share/apps/pktgen/</literal>
34 and needs to be executed from this directory.</para>
35
36 <para>For Pktgen documentation, see <ulink
37 url="http://pktgen-dpdk.readthedocs.io">http://pktgen-dpdk.readthedocs.io</ulink></para>
38 </section>
39
40 <section id="dpdk-setup">
41 <title>DPDK setup instructions</title>
42
43 <para>The following setup instructions apply to both host and
44 guest.</para>
45
46 <orderedlist>
47 <listitem>
48 <para>To make the hugepage memory available for DPDK, it must be
49 mounted:</para>
50
51 <programlisting>mkdir /mnt/huge
52mount -t hugetlbfs nodev /mnt/huge</programlisting>
53 </listitem>
54
55 <listitem>
56 <para>Load the DPDK vfio-pci kernel module:</para>
57
58 <programlisting>modprobe vfio-pci</programlisting>
59 </listitem>
60
61 <listitem>
62 <para>Bind the device to the vfio-pci driver:</para>
63
64 <para><programlisting>dpdk-devbind --bind=vfio-pci &lt;PCI device number&gt;</programlisting>The
65 DPDK provides the dpdk-devbind tool to help bind or unbind devices
66 from specific drivers. See <ulink
67 url="http://dpdk.org/doc/guides-17.08/tools/devbind.html">http://dpdk.org/doc/guides-17.08/tools/devbind.html</ulink>
68 for more information.</para>
69 </listitem>
70
71 <listitem>
72 <para>VFIO-NOMMU needs to be set if run on VM: <programlisting>echo 1 &gt; /sys/module/vfio/parameters/enable_unsafe_noiommu_mode</programlisting></para>
73 </listitem>
74 </orderedlist>
75
76 <para>To print the current status of all known network
77 interfaces:<programlisting>dpdk-devbind --status</programlisting></para>
78
79 <para>At this point the system is ready to run DPDK applications.</para>
80 </section>
81
82 <section id="dpdk-example-test-setup">
83 <title>DPDK example test setup</title>
84
85 <para>This is a simple DPDK test setup using two boards connected
86 back-to-back. One board generates traffic using the Pktgen application,
87 and the other board runs the DPDK testpmd example to forward packets back
88 on the same interface.</para>
89
90 <programlisting>Pktgen [DPDK] - Board 1 PHY &lt;--&gt; Board 2 PHY - [DPDK] testpmd</programlisting>
91
92 <orderedlist>
93 <listitem>
94 <para>Setup DPDK on both boards, following the instructions in <xref
95 linkend="dpdk-setup" />.</para>
96 </listitem>
97
98 <listitem>
99 <para>On board 1, start the Pktgen application:</para>
100
101 <programlisting>cd /usr/share/apps/pktgen/
102./pktgen -v -c 0x7 -n 4 --proc-type auto -d \
103/usr/lib/librte_pmd_thunderx_nicvf.so.1.1 -w &lt;PCI device number&gt; -- -P -m "[1:2].0"</programlisting>
104
105 <para>In the Pktgen console, run:</para>
106
107 <programlisting>start 0</programlisting>
108
109 <para>The Pktgen output will display the traffic configuration and
110 statistics.</para>
111 </listitem>
112
113 <listitem>
114 <para>On board 2, start the testpmd application:</para>
115
116 <programlisting>testpmd -v -c 0x3 -n 4 -d /usr/lib/librte_pmd_thunderx_nicvf.so.1.1 -w &lt;PCI device \
117number&gt; -- -i --disable-hw-vlan-filter --no-flush-rx --port-topology=chained</programlisting>
118
119 <para>For more information, refer to the testpmd application user
120 guide: <ulink
121 url="http://dpdk.org/doc/guides-17.08/testpmd_app_ug/index.html">http://dpdk.org/doc/guides-17.08/testpmd_app_ug/index.html</ulink>.</para>
122 </listitem>
123 </orderedlist>
124 </section>
125</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/eltf_params_template.xml b/doc/book-enea-nfv-access-guide/doc/eltf_params_template.xml
deleted file mode 100644
index eaa7ebd..0000000
--- a/doc/book-enea-nfv-access-guide/doc/eltf_params_template.xml
+++ /dev/null
@@ -1,151 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting>ELTF_PL_HOST_PREREQ</programlisting></para>
26
27 <bridgehead>A programlisting, ID
28 "eltf-getting-repo-install-command"</bridgehead>
29
30 <para id="eltf-getting-repo-install-command"><programlisting>ELTF_PL_GET_REPO</programlisting></para>
31
32 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
33 correct also compared to the "previous" REL VER in pardoc-distro.xml
34 "prev_baseline".</bridgehead>
35
36 <para id="EneaLinux_REL_VER"><phrase>ELTF_EL_REL_VER</phrase></para>
37
38 <para id="Yocto_VER"><phrase>ELTF_YOCTO_VER</phrase></para>
39
40 <para id="Yocto_NAME"><phrase>ELTF_YOCTO_NAME</phrase></para>
41
42 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
43 url="ELTF_YOCTO_PROJ_DOWNLOAD_URL">ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL</ulink></para>
44
45 <para id="ULINK_ENEA_LINUX_URL"><ulink
46 url="ELTF_EL_DOWNLOAD_URL">ELTF_EL_DOWNLOAD_TXTURL</ulink></para>
47
48 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
49 $MACHINE/default.xml as parameter, where MACHINE is one of the target
50 directory names in the manifest.</bridgehead>
51
52 <para id="eltf-repo-cloning-enea-linux"><programlisting>ELTF_PL_CLONE_W_REPO</programlisting></para>
53
54 <bridgehead>A table with ONE row, only the row with ID
55 "eltf-eclipse-version-row" is included in the book. MANUALLY BOTH in the
56 template.xml and in the updated.xml, set condition hidden on the
57 &lt;row&gt;, if eclipse is not in the release.</bridgehead>
58
59 <informaltable>
60 <tgroup cols="1">
61 <tbody>
62 <row id="eltf-eclipse-version-row">
63 <entry>Eclipse version ELTF_ECLIPSE_VERSION plus command line
64 development tools are included in this Enea NFV Access release.</entry>
65 </row>
66 </tbody>
67 </tgroup>
68 </informaltable>
69
70 <bridgehead>Below is one big section with title "Supported Targets with
71 Parameters". The entire section is included completely in the book via ID
72 "eltf-target-tables-section" and shall be LAST in the template. The
73 template contains ONE target subsection. COPY/APPEND it, if multiple
74 targets exist in the release and optionally add rows with additional
75 target parameters in each target subsection table.</bridgehead>
76 </section>
77
78 <section id="eltf-target-tables-section">
79 <title>Supported Targets with Parameters</title>
80
81 <para>The tables below describes the target(s) supported in this Enea
82 NFV Access release.</para>
83
84 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
85 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
86
87 <para><informaltable>
88 <tgroup cols="2">
89 <colspec colwidth="6*" />
90
91 <colspec colwidth="9*" />
92
93 <tbody>
94 <row>
95 <entry>Target official name</entry>
96
97 <entry>ELTF_T_NAME</entry>
98 </row>
99
100 <row>
101 <entry>Architecture and Description</entry>
102
103 <entry>ELTF_T_ARC_DESC</entry>
104 </row>
105
106 <row>
107 <entry>Link to target datasheet</entry>
108
109 <entry>See <ulink
110 url="ELTF_T_DS_URL">ELTF_T_DS_TXTURL</ulink></entry>
111 </row>
112
113 <row>
114 <entry>Poky version</entry>
115
116 <entry>ELTF_T_POKY_VER</entry>
117 </row>
118
119 <row>
120 <entry>GCC version</entry>
121
122 <entry>ELTF_T_GCC_VER</entry>
123 </row>
124
125 <row>
126 <entry>Linux Kernel Version</entry>
127
128 <entry>ELTF_T_KERN_VER</entry>
129 </row>
130
131 <row>
132 <entry>Supported Drivers</entry>
133
134 <entry>ELTF_T_DRIVERS</entry>
135 </row>
136
137 <row>
138 <entry>Enea rpm folder for downloading RPM packages for this
139 target</entry>
140
141 <entry><ulink
142 url="ELTF_T_EL_RPM_URL">ELTF_T_EL_RPM_TXTURL</ulink></entry>
143 </row>
144 </tbody>
145 </tgroup>
146 </informaltable></para>
147 </section>
148
149 <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->
150 </section>
151</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/eltf_params_updated.xml b/doc/book-enea-nfv-access-guide/doc/eltf_params_updated.xml
deleted file mode 100644
index 608fa09..0000000
--- a/doc/book-enea-nfv-access-guide/doc/eltf_params_updated.xml
+++ /dev/null
@@ -1,165 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 14.04.5 LTS 64bit
26sudo apt-get -y update
27sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
28 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
29 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
30 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
31 libxml-parser-perl</programlisting></para>
32
33 <bridgehead>A programlisting, ID
34 "eltf-getting-repo-install-command"</bridgehead>
35
36 <para id="eltf-getting-repo-install-command"><programlisting>mkdir -p ~/bin
37curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo
38chmod a+x ~/bin/repo
39export PATH=~/bin:$PATH</programlisting></para>
40
41 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
42 correct also compared to the "previous" REL VER in pardoc-distro.xml
43 "prev_baseline".</bridgehead>
44
45 <para id="EneaLinux_REL_VER"><phrase>2.0</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.1</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>krogoth</phrase></para>
50
51 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
52 url="http://www.yoctoproject.org/downloads/core/krogoth/21">http://www.yoctoproject.org/downloads/core/krogoth/21</ulink></para>
53
54 <para id="ULINK_ENEA_LINUX_URL"><ulink
55 url="https://linux.enea.com/6">https://linux.enea.com/6</ulink></para>
56
57 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
58 $MACHINE/default.xml as parameter, where MACHINE is one of the target
59 directory names in the manifest.</bridgehead>
60
61 <para id="eltf-repo-cloning-enea-linux"><programlisting>mkdir enea-linux
62cd enea-linux
63repo init -u git@git.enea.com:linux/manifests/el_manifests-virtualization.git \
64 -b refs/tags/EL6 -m $MACHINE/default.xml
65repo sync</programlisting></para>
66
67 <bridgehead>A table with ONE row, only the row with ID
68 "eltf-eclipse-version-row" is included in the book. MANUALLY in book, set
69 condition hidden if eclipse is not in the release. Do this both in
70 template.xml and updated.xml.</bridgehead>
71
72 <informaltable>
73 <tgroup cols="1">
74 <tbody>
75 <row condition="hidden" id="eltf-eclipse-version-row">
76 <entry>Eclipse version 4.3 (Mars) plus command line development
77 tools are included in this Enea NFV Access release.</entry>
78 </row>
79 </tbody>
80 </tgroup>
81 </informaltable>
82
83 <bridgehead>Below is one big section with title "Supported Targets with
84 Parameters". The entire section is included completely in the book via ID
85 "eltf-target-tables-section" and shall be LAST in the template. The
86 template contains ONE target subsection. COPY/APPEND it, if multiple
87 targets exist in the release and optionally add rows with additional
88 target parameters in each target subsection table.</bridgehead>
89 </section>
90
91 <section id="eltf-target-tables-section">
92 <title>Supported Reference Boards with Parameters</title>
93
94 <para>The tables below describes the target(s) supported in this Enea NFV
95 Access release.</para>
96
97 <section id="eltf-target-table-p2041rdb">
98 <title>MACHINE p2041rdb - Information</title>
99
100 <para><informaltable>
101 <tgroup cols="2">
102 <colspec colwidth="6*" />
103
104 <colspec colwidth="9*" />
105
106 <tbody>
107 <row>
108 <entry>Target official name</entry>
109
110 <entry>P2041RDB</entry>
111 </row>
112
113 <row>
114 <entry>Architecture and Description</entry>
115
116 <entry>Power, e500mc</entry>
117 </row>
118
119 <row>
120 <entry>Link to target datasheet</entry>
121
122 <entry>See <ulink
123 url="http://www.nxp.com/products/microcontrollers-and-processors/power-architecture-processors/qoriq-power-architecture-processors/p2041-qoriq-reference-design-board:RDP2041BOARD">link
124 to NXP's datasheet</ulink></entry>
125 </row>
126
127 <row>
128 <entry>Poky version</entry>
129
130 <entry>Git-commit-id:
131 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
132 </row>
133
134 <row>
135 <entry>GCC version</entry>
136
137 <entry>5.3</entry>
138 </row>
139
140 <row>
141 <entry>Linux Kernel Version</entry>
142
143 <entry>3.12</entry>
144 </row>
145
146 <row>
147 <entry>Supported Drivers</entry>
148
149 <entry>Ethernet, I2C, SPI, PCI Express, USB, Flash,
150 SD/SDHC/SDXC, RTC</entry>
151 </row>
152
153 <row>
154 <entry>Enea rpm folder for downloading RPM packages for this
155 target</entry>
156
157 <entry><ulink
158 url="https://linux.enea.com/6/p2041rgb/rpm">https://linux.enea.com/6/p2041rgb/rpm</ulink></entry>
159 </row>
160 </tbody>
161 </tgroup>
162 </informaltable></para>
163 </section>
164 </section>
165</section>
diff --git a/doc/book-enea-nfv-access-guide/doc/getting_started.xml b/doc/book-enea-nfv-access-guide/doc/getting_started.xml
deleted file mode 100644
index 4e2b3a3..0000000
--- a/doc/book-enea-nfv-access-guide/doc/getting_started.xml
+++ /dev/null
@@ -1,244 +0,0 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="plat-release-content">
5 <title>Getting Started with Enea NFV Access</title>
6
7 <para>Using Enea NFV Access requires access to a Linux machine, which is
8 used for preparing a boot setup or for developing applications. System
9 requirements for the development host are detailed in the <xi:include
10 href="../../s_docbuild/olinkdb/pardoc-common.xml"
11 xmlns:xi="http://www.w3.org/2001/XInclude"
12 xpointer="element(book_enea_nfv_access_release_info/1)" /></para>
13
14 <section condition="hidden" id="release-content">
15 <title>NFV Access Release content</title>
16
17 <para>The NFV Access 1.1 Release contains along with other items,
18 documentation, pre-built kernels and images, a bootloader and a
19 SDK.</para>
20
21 <para>The directories structure is detailed below:</para>
22
23 <programlisting>-- documentation/
24 /* NFV Access documentation */
25-- inteld1521/
26 /* artifacts for the host side */
27 -- deb/
28 /* deb packages */
29 -- images/
30 -- enea-image-virtualization-host
31 /* precompiled artifacts for the Host release image */
32 -- various artifacts
33 -- enea-image-virtualization-host-sdk
34 /* precompiled artifacts for the Host SDK image.
35 The SDK image contains userspace tools and kernel
36 configurations necessary for developing, debugging
37 and profiling applications and kernel modules */
38 -- various artifacts
39 -- sdk
40 /* NFV Access SDK for the host */
41 -- enea-glibc-x86_64-enea-image-virtualization-host-sdk /
42 -corei7-64-toolchain-7.0.sh
43 /* self-extracting archive installing
44 cross-compilation toolchain for the host */
45-- qemux86-64
46 /* artifacts for the guest side */
47 -- deb/
48 /* deb packages */
49 -- images/
50 -- enea-image-virtualization-guest
51 /* precompiled artifacts for the Guest image */
52 -- various artifacts
53 -- sdk
54 /* NFV Access SDK for the guest */
55 -- enea-glibc-x86_64-enea-image-virtualization-guest-sdk /
56 -core2-64-toolchain-7.0.sh
57 /* self-extracting archive installing cross-compilation
58 toolchain for the guest (QEMU x86-64) */</programlisting>
59
60 <para>For each combination of image and target, the following set of
61 artifacts is available:</para>
62
63 <programlisting format="linespecific">-- bzImage
64 /* kernel image */
65-- bzImage-&lt;target&gt;.bin
66 /* kernel image, same as above */
67-- config-&lt;target&gt;.config
68 /* kernel configuration file */
69-- core-image-minimal-initramfs-&lt;target&gt;.cpio.gz
70 /* cpio archive of the initramfs */
71-- core-image-minimal-initramfs-&lt;target&gt;.qemuboot.conf
72 /* qemu config file for the initramfs image */
73-- &lt;image-name&gt;-&lt;target&gt;.ext4
74 /* EXT4 image of the rootfs */
75-- &lt;image-name&gt;-&lt;target&gt;.hddimg
76 /* msdos filesystem containing syslinux, kernel, initrd and rootfs image */
77-- &lt;image-name&gt;-&lt;target&gt;.iso
78 /* CD .iso image */
79-- &lt;image-name&gt;-&lt;target&gt;.qemuboot.conf
80 /* qemu config file for the image */
81-- &lt;image-name&gt;-&lt;target&gt;.tar.gz
82 /* tar archive of the image */
83-- &lt;image-name&gt;-&lt;target&gt;.wic
84 /* Wic image */
85-- microcode.cpio
86 /* kernel microcode data */
87-- modules-&lt;target&gt;.tgz
88 /* external kernel modules */
89-- ovmf.*.qcow2
90 /* ovmf firmware for uefi support in qemu */
91-- rmc.db
92 /* Central RMC Database */
93-- systemd-bootx64.efi
94 /* systemd-boot EFI file */
95-- grub-efi-bootx64.efi
96 /* GRUB EFI file */</programlisting>
97 </section>
98
99 <section id="prebuilt-artifacts">
100 <title>How to use the Prebuilt Artifacts</title>
101
102 <section id="sysshell_config">
103 <title>Booting NFV Access to RAM</title>
104
105 <para>Enea NFV Access can be booted on a target using the RAMDISK
106 images. How to set the environment, configure the bootloader (U-Boot),
107 load and boot on the target, is detailed below. Please check the <link
108 linkend="boot_prereq">Prerequisites</link> section before starting the
109 boot process.</para>
110
111 <para><emphasis role="bold">Setting up the environment and booting on
112 the target</emphasis></para>
113
114 <itemizedlist>
115 <listitem>
116 <para>Connect to the target over serial and stop the default boot
117 process in the U-Boot command line interface.</para>
118 </listitem>
119
120 <listitem>
121 <para>Set up the U-Boot network configuration for the ethernet port,
122 which connects the target to the network.</para>
123 </listitem>
124
125 <listitem>
126 <para>If the target is not connected on a specific network, Enea
127 provides DHCP and TFTP servers that can be used to setup a local
128 network. Please see <link linkend="boot_docker">Docker
129 Installer</link> section, on how to install these two servers on a
130 development host.</para>
131
132 <programlisting>&gt; setenv ethact &lt;vnic0/vnic1&gt;
133&gt; setenv gatewayip &lt;GatewayIP&gt;
134&gt; setenv serverip &lt;TFTPserverIP&gt;
135&gt; setenv netmask &lt;netmask&gt;
136&gt; setenv ipaddr &lt;target IP&gt;</programlisting>
137 </listitem>
138
139 <listitem>
140 <para>Boot the Enea NFV Access images:</para>
141
142 <programlisting>&gt; tftpboot $kernel_addr Image
143&gt; setenv rootfs_addr 0x60000000
144&gt; tftpboot $rootfs_addr enea-nfv-access-cn8304.ext4.gz.u-boot
145&gt; booti $kernel_addr $rootfs_addr $fdtcontroladdr
146&gt; setenv bootargs root=/dev/ram0 rw ramdisk_size=1000000 console=ttyAMA0,115200n8 \
147 earlycon=pl011,0x87e028000000 coherent_pool=16M</programlisting>
148 </listitem>
149 </itemizedlist>
150
151 <section id="boot_prereq">
152 <title>Prerequisites</title>
153
154 <para>The following requirements are needed in order to successfully
155 boot Enea NFV Access to RAM:</para>
156
157 <itemizedlist>
158 <listitem>
159 <para>Enea NFV Acccess images - see the <xi:include
160 href="../../s_docbuild/olinkdb/pardoc-common.xml"
161 xmlns:xi="http://www.w3.org/2001/XInclude"
162 xpointer="element(book_enea_nfv_access_release_info/1)" />, under
163 section <emphasis role="bold">Release Content</emphasis>, for
164 details on the images provided.</para>
165 </listitem>
166 </itemizedlist>
167
168 <itemizedlist>
169 <listitem>
170 <para>DHCP server - If the board is not connected to a specific
171 network, Enea provides a Docker image with a DHCP server. Please
172 see the <link linkend="boot_docker">Docker Installer</link>
173 section for further details.</para>
174 </listitem>
175 </itemizedlist>
176
177 <itemizedlist>
178 <listitem>
179 <para>TFTP server - If the board is not connected to a specific
180 network, Enea provides a Docker image with a TFTP server. Please
181 see the <link linkend="boot_docker">Docker Installer</link>
182 section for further details.</para>
183 </listitem>
184 </itemizedlist>
185
186 <itemizedlist>
187 <listitem>
188 <para>The reference board, with U-Boot connected to a development
189 host over serial and ethernet.</para>
190 </listitem>
191 </itemizedlist>
192 </section>
193
194 <section id="boot_docker">
195 <title>Docker Installer</title>
196
197 <para>A suite of tools are provided in order to create a complete boot
198 process setup. System requirements for the development host are
199 detailed in the <xi:include
200 href="../../s_docbuild/olinkdb/pardoc-common.xml"
201 xmlns:xi="http://www.w3.org/2001/XInclude"
202 xpointer="element(book_enea_nfv_access_release_info/1)" /> included
203 with this release.</para>
204
205 <para>All required tools are leveraged by the Docker image, which must
206 be built and run on a development host. DHCP and TFTP servers will be
207 installed and configured in order to facilitate a RAMDISK boot process
208 on the target.</para>
209
210 <para>The example procedure below details how to build and run a
211 provided Docker image. In this case, the host is directly connected to
212 a target on <literal>eth1</literal>. For more details about the Docker
213 installer, please see <filename>README</filename> file from the Docker
214 installer folder.</para>
215
216 <para>Prior to using this example setup, on the target side, U-Boot
217 needs to be configured with these values, before booting Linux. Note
218 that the first eth port (<literal>vnic0</literal>) is connected to a
219 network in this example:</para>
220
221 <programlisting>&gt; setenv ethact vnic0
222&gt; setenv gatewayip 192.168.1.1
223&gt; setenv serverip 192.168.1.1
224&gt; setenv netmask 255.255.255.0
225&gt; setenv ipaddr 192.168.1.150</programlisting>
226
227 <para><emphasis role="bold">How to build and run a provided Docker
228 image</emphasis></para>
229
230 <programlisting>&gt; cd nfv-access-tools/nfv-installer/docker-pxe-ramboot/
231&gt; mkdir -p ./images
232&gt; cp &lt;NFVAccessReleasePath&gt;/Image $(pwd)/images/Image
233&gt; cp &lt;NFVAccessReleasePath&gt;/enea-nfv-access-cn8304.ext4.gz.u-boot \
234 $(pwd)/images/enea-nfv-access-cn8304.ext4.gz.u-boot
235&gt; docker build . -t el_installer
236&gt; docker run -it --net=host --privileged \
237-v $(pwd)/dhcpd.conf:/etc/dhcp/dhcpd.conf \
238-v $(pwd)/images/Image:/var/lib/tftpboot/Image \
239-v $(pwd)/images/eenea-nfv-access-cn8304.ext4.gz.u-boot:/var/lib/tftpboot/ \
240enea-nfv-access-cn8304.ext4.gz.u-boot el_installer eth1</programlisting>
241 </section>
242 </section>
243 </section>
244</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/hypervisor_virtualization.xml b/doc/book-enea-nfv-access-guide/doc/hypervisor_virtualization.xml
deleted file mode 100644
index 3f14719..0000000
--- a/doc/book-enea-nfv-access-guide/doc/hypervisor_virtualization.xml
+++ /dev/null
@@ -1,774 +0,0 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="hypervisor_virt">
5 <title>Hypervisor Virtualization</title>
6
7 <para>The Kernel-based Virtual Machine (KVM), is a virtualization
8 infrastructure for the Linux kernel, which turns it into a hypervisor. KVM
9 requires a processor with a hardware virtualization extension.</para>
10
11 <para>KVM uses QEMU, an open source machine emulator and virtualizer, to
12 virtualize a complete system. With KVM it is possible to run multiple guests
13 of a variety of operating systems, each with a complete set of virtualized
14 hardware.</para>
15
16 <section id="launch_virt_machine">
17 <title>Launching a Virtual Machine</title>
18
19 <para>QEMU can make use of KVM when running a target architecture that is
20 the same as the host architecture. For instance, when running
21 <filename>qemu-system-aarch64</filename> on an <literal>aarch64</literal>
22 compatible processor with Hardware Virtualization support enabled, you can
23 take advantage of the KVM acceleration, an added benefit for your host and
24 guest system.</para>
25
26 <para>Enea NFV Access includes an optimized version of QEMU with KVM-only
27 support. To use KVM pass <command>--enable-kvm</command> to QEMU.</para>
28
29 <para>The following is an example of starting a guest system:</para>
30
31 <programlisting>taskset -c 0,1 qemu-system-aarch64 \
32-cpu host -machine virt,gic_version=3 -smp cores=2,sockets=1 \
33-vcpu 0,affinity=0 -vcpu 1,affinity=1 \
34-enable-kvm -nographic \
35-kernel Image \
36-drive file=enea-nfv-access-guest-qemuarm64.ext4,if=virtio,format=raw \
37-append 'root=/dev/vda console=ttyAMA0,115200' \
38-m 4096 \
39-object memory-backend-file,id=mem,size=4096M,mem-path=/dev/hugepages,share=on \
40-numa node,memdev=mem -mem-prealloc</programlisting>
41 </section>
42
43 <section id="qemu_boot">
44 <title>Primary QEMU boot options</title>
45
46 <para>Below are detailed all the pertinent boot options for the QEMU
47 emulator:</para>
48
49 <itemizedlist>
50 <listitem>
51 <para>SMP - at least 2 cores should be enabled in order to isolate the
52 application(s) running in the virtual machine(s), on specific cores,
53 for better performance:</para>
54
55 <programlisting>-smp cores=2,threads=1,sockets=1 \</programlisting>
56 </listitem>
57
58 <listitem>
59 <para>CPU affinity - associate virtual CPUs with physical CPUs, and
60 optionally assign a default realtime priority to the virtual CPU
61 process in the host kernel. This option allows you to start QEMU vCPUs
62 on isolated physical CPUs:</para>
63
64 <programlisting>-vcpu 0,affinity=0 \</programlisting>
65 </listitem>
66
67 <listitem>
68 <para>Hugepages - KVM guests can be deployed with hugepage memory
69 support to reduce memory consumption and improve performance, by
70 reducing CPU cache usage. By using hugepages for a KVM guest, less
71 memory is used for page tables and TLB (Translation Lookaside Buffer)
72 misses are reduced, significantly increasing performance, especially
73 for memory-intensive situations.</para>
74
75 <programlisting>-object memory-backend-file,id=mem,size=4096M,mem-path=/dev/hugepages,share=on \</programlisting>
76 </listitem>
77
78 <listitem>
79 <para>Memory preallocation - preallocate hugepages at startup to
80 improve performance. This may affect QEMU boot time.</para>
81
82 <programlisting>-mem-prealloc \</programlisting>
83 </listitem>
84
85 <listitem>
86 <para>Enable realtime characteristics - run QEMU with realtime
87 features.</para>
88
89 <para>In this case, "realtime" is just an identifier for options that
90 are partially realtime. If you're running in a realtime or low latency
91 environment, and you don't want your pages to be swapped out, this can
92 be ensured by using <command>mlock=on</command>. If you want VM
93 density, then you may want swappable VMs, this can be done with
94 <command>mlock=off</command>.</para>
95
96 <programlisting>-realtime mlock=on \</programlisting>
97 </listitem>
98 </itemizedlist>
99
100 <para>If the hardware does not have an IOMMU, it will not be possible to
101 assign devices in KVM.</para>
102 </section>
103
104 <section id="net_in_guest">
105 <title>Networking in guest</title>
106
107 <section id="vhost-user-support">
108 <title>Using vhost-user support</title>
109
110 <para>The goal of <literal>vhost-user</literal> is to implement a Virtio
111 transport, staying as close as possible to the <literal>vhost</literal>
112 paradigm of using: shared memory, <literal>ioeventfds</literal> and
113 <literal>irqfds</literal>. A UNIX domain socket based mechanism, allows
114 for the set up of resources used by various <literal>Vrings</literal>
115 shared between two userspace processes, and will be placed in shared
116 memory.</para>
117
118 <para>To run QEMU with the <literal>vhost-user</literal> backend, you
119 have to provide the named UNIX domain socket, which needs to already be
120 opened by the backend:</para>
121
122 <programlisting>-object memory-backend-file,id=mem,size=4096M,mem-path=/dev/hugepages,share=on \
123-chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1 \
124-netdev type=vhost-user,id=mynet1,chardev=char0,vhostforce \
125-device virtio-net-pci,netdev=mynet1,mac=52:54:00:00:00:01 \</programlisting>
126
127 <para>The vHost User standard uses a client-server model. The server
128 creates and manages the vHost User sockets and the client connects to
129 the sockets created by the server. It is recommended to use QEMU as the
130 server, so that the <literal>vhost-user</literal> client can be
131 restarted without affecting the server, otherwise if the server side
132 dies, all clients need to be restarted.</para>
133
134 <para>Using <literal>vhost-user</literal> in QEMU will offer the
135 flexibility to stop and start the virtual machine with no impact on the
136 virtual switch from the host
137 (<literal>vhost-user-client</literal>).</para>
138
139 <programlisting>-chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1,server \</programlisting>
140 </section>
141
142 <section id="tap-interface">
143 <title>Using TAP Interfaces</title>
144
145 <para>QEMU can use TAP interfaces to provide full networking capability
146 for the guest OS:</para>
147
148 <programlisting>-netdev tap,id=net0,ifname=tap0,script=no,downscript=no \
149-device virtio-net-pci,netdev=net0,mac=22:EA:FB:A8:25:AE \</programlisting>
150 </section>
151
152 <section id="vfio-passthrough">
153 <title>VFIO passthrough VF (SR-IOV) to guest</title>
154
155 <para>KVM hypervisor support for attaching PCI devices on the host
156 system to guests. PCI passthrough allows guests to have exclusive access
157 to PCI devices for a range of tasks. PCI passthrough allows PCI devices
158 to appear and behave as if they were physically attached to the guest
159 operating system.</para>
160
161 <para>Create guest with direct passthrough via VFIO framework like
162 so:</para>
163
164 <programlisting>-device vfio-pci,host=0001:01:00.1 \</programlisting>
165
166 <para>On the host, there are Virtual Functions for each physical
167 Ethernet port. The primary VF has to be used for a guest network to
168 access, before starting QEMU:</para>
169
170 <programlisting>$ modprobe vfio_pci
171$ dpdk-devbind.py --bind=vfio-pci 0001:01:00.1</programlisting>
172
173 <para>For more details related to Virtual Functions, see: <ulink
174 url="http://dpdk.org/doc/guides/nics/thunderx.html">http://dpdk.org/doc/guides/nics/thunderx.html</ulink>.</para>
175 </section>
176
177 <section>
178 <title>Enable VFIO-NOIOMMU mode</title>
179
180 <para>In order to run a DPDK application in VM, the VFIO-NOIOMMU needs
181 to be set: <programlisting>echo 1 &gt; /sys/module/vfio/parameters/enable_unsafe_noiommu_mode</programlisting></para>
182 </section>
183
184 <section id="multiqueue">
185 <title>Multi-queue</title>
186
187 <para>In order to ensure that network performance scales as the number
188 of vCPUs increases, multi-queue support can be used in QEMU.</para>
189
190 <section id="qemu-multiqueue-support">
191 <title>QEMU multi-queue support configuration</title>
192
193 <para>Below is an example of how to set up the QEMU multi-queue
194 support configuration:</para>
195
196 <programlisting>-chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1 \
197-netdev type=vhost-user,id=net0,chardev=char0,queues=2 \
198-device virtio-net-pci,netdev=net0,mac=22:EA:FB:A8:25:AE,mq=on,vectors=6
199where vectors is calculated as: 2 + 2 * queues number.</programlisting>
200 </section>
201
202 <section id="inside-guest">
203 <title>Inside guest</title>
204
205 <para>The Linux kernel <filename>virtio-net</filename> driver, where
206 one queue is enabled by default:</para>
207
208 <programlisting>$ ethtool -L combined 2 eth0
209DPDK Virtio PMD
210$ testpmd -c 0x7 -- -i --rxq=2 --txq=2 --nb-cores=2 ...</programlisting>
211
212 <para>For QEMU documentation, see: <ulink
213 url="https://qemu.weilnetz.de/doc/qemu-doc.html">QEMU User
214 Documentation</ulink>.</para>
215 </section>
216 </section>
217 </section>
218
219 <section id="libvirt">
220 <title>Libvirt</title>
221
222 <para>One way to manage guests in Enea NFV Access is by using
223 <literal>libvirt</literal>. Libvirt is used in conjunction with a daemon
224 (<literal>libvirtd</literal>) and a command line utility
225 (<literal>virsh</literal>) to manage virtualized environments.</para>
226
227 <para>The <literal>libvirt</literal> library is a hypervisor-independent
228 virtualization API and toolkit that is able to interact with the
229 virtualization capabilities of a range of operating systems.
230 <literal>Libvirt</literal> provides a common, generic and stable layer to
231 securely manage domains on a node. As nodes may be remotely located, it
232 provides all methods required to provision, create, modify, monitor,
233 control, migrate and stop the domains, within the limits of hypervisor
234 support for these operations.</para>
235
236 <para>The <literal>libvirt</literal> daemon runs on the Enea NFV Access
237 host. All tools built upon the libvirt API, connect to the daemon to
238 request the desired operation, and to collect information about the
239 configuration and resources of the host system and guests.
240 <literal>virsh</literal> is a command line interface tool for managing
241 guests and the hypervisor. The <literal>virsh</literal> tool is built upon
242 the libvirt management API.</para>
243
244 <para><emphasis role="bold">Major functionality provided by
245 libvirt</emphasis></para>
246
247 <para>The following is a summary from the libvirt <ulink
248 url="http://wiki.libvirt.org/page/FAQ#What_is_libvirt.3F">home
249 page</ulink> describing the major libvirt features:</para>
250
251 <itemizedlist>
252 <listitem>
253 <para><emphasis role="bold">VM management:</emphasis> Various domain
254 lifecycle operations such as start, stop, pause, save, restore, and
255 migrate. Hotplug operations for many device types including disk and
256 network interfaces, memory, and CPUs.</para>
257 </listitem>
258
259 <listitem>
260 <para><emphasis role="bold">Remote machine support:</emphasis> All
261 libvirt functionality is accessible on any machine running the libvirt
262 daemon, including remote machines. A variety of network transports are
263 supported for connecting remotely, with the simplest being
264 <literal>SSH</literal>, which requires no extra explicit
265 configuration. For more information, see: <ulink
266 url="http://libvirt.org/remote.html">http://libvirt.org/remote.html</ulink>.</para>
267 </listitem>
268
269 <listitem>
270 <para><emphasis role="bold">Network interface management:</emphasis>
271 Any host running the libvirt daemon can be used to manage physical and
272 logical network interfaces. Enumerate existing interfaces, as well as
273 configure (and create) interfaces, bridges, vlans, and bond devices.
274 For more details see: <ulink
275 url="https://fedorahosted.org/netcf/">https://fedorahosted.org/netcf/</ulink>.</para>
276 </listitem>
277
278 <listitem>
279 <para><emphasis role="bold">Virtual NAT and Route based
280 networking:</emphasis> Any host running the libvirt daemon can manage
281 and create virtual networks. Libvirt virtual networks use firewall
282 rules to act as a router, providing VMs transparent access to the host
283 machines network. For more information, see: <ulink
284 url="http://libvirt.org/archnetwork.html">http://libvirt.org/archnetwork.html</ulink>.</para>
285 </listitem>
286
287 <listitem>
288 <para><emphasis role="bold">Storage management:</emphasis> Any host
289 running the libvirt daemon can be used to manage various types of
290 storage: create file images of various formats (raw, qcow2, etc.),
291 mount NFS shares, enumerate existing LVM volume groups, create new LVM
292 volume groups and logical volumes, partition raw disk devices, mount
293 iSCSI shares, and much more. For more details, see: <ulink
294 url="http://libvirt.org/storage.html">http://libvirt.org/storage.html</ulink>.</para>
295 </listitem>
296
297 <listitem>
298 <para><emphasis role="bold">Libvirt Configuration:</emphasis> A
299 properly running libvirt requires that the following elements be in
300 place:</para>
301
302 <itemizedlist>
303 <listitem>
304 <para>Configuration files, located in the directory
305 <literal>/etc/libvirt</literal>. They include the daemon's
306 configuration file <literal>libvirtd.conf</literal>, and
307 hypervisor-specific configuration files, like
308 <literal>qemu.conf</literal> for the QEMU.</para>
309 </listitem>
310
311 <listitem>
312 <para>A running libvirtd daemon. The daemon is started
313 automatically in Enea NFV Access host.</para>
314 </listitem>
315
316 <listitem>
317 <para>Configuration files for the libvirt domains, or guests, to
318 be managed by the KVM host. The specifics for guest domains shall
319 be defined in an XML file of a format specified at <ulink
320 url="http://libvirt.org/formatdomain.html">http://libvirt.org/formatdomain.html</ulink>.
321 XML formats for other structures are specified at <ulink type=""
322 url="http://libvirt.org/format.html">http://libvirt.org/format.html</ulink>.</para>
323 </listitem>
324 </itemizedlist>
325 </listitem>
326 </itemizedlist>
327
328 <section id="boot-kvm-guest">
329 <title>Booting a KVM Guest</title>
330
331 <para>There are several ways to boot a KVM guest. Here we describe how
332 to boot using a raw image. A direct kernel boot can be performed by
333 transferring the guest kernel and the file system files to the host and
334 specifying a <literal>&lt;kernel&gt;</literal> and an
335 <literal>&lt;initrd&gt;</literal> element inside the
336 <literal>&lt;os&gt;</literal> element of the guest XML file, as in the
337 following example:</para>
338
339 <programlisting>&lt;os&gt;
340 &lt;kernel&gt;Image&lt;/kernel&gt;
341&lt;/os&gt;
342&lt;devices&gt;
343 &lt;disk type='file' device='disk'&gt;
344 &lt;driver name='qemu' type='raw' cache='none'/&gt;
345 &lt;source file='enea-nfv-access-guest-qemuarm64.ext4'/&gt;
346 &lt;target dev='vda' bus='virtio'/&gt;
347 &lt;/disk&gt;
348&lt;/devices&gt;</programlisting>
349 </section>
350
351 <section id="start-guest">
352 <title>Starting a Guest</title>
353
354 <para>Command <command>virsh create</command> starts a guest:</para>
355
356 <programlisting>virsh create example-guest-arm.xml</programlisting>
357
358 <para>If further configurations are needed before the guest is reachable
359 through <literal>ssh</literal>, a console can be started using command
360 <command>virsh console</command>. The example below shows how to start a
361 console where kvm-example-guest is the name of the guest defined in the
362 guest XML file:</para>
363
364 <programlisting>virsh console kvm-example-guest</programlisting>
365
366 <para>This requires that the guest domain has a console configured in
367 the guest XML file:</para>
368
369 <programlisting>&lt;os&gt;
370 &lt;cmdline&gt;console=ttyAMA0,115200&lt;/cmdline&gt;
371&lt;/os&gt;
372&lt;devices&gt;
373 &lt;console type='pty'&gt;
374 &lt;target type='serial' port='0'/&gt;
375 &lt;/console&gt;
376&lt;/devices&gt;</programlisting>
377 </section>
378
379 <section id="isolation">
380 <title>Isolation</title>
381
382 <para>It may be desirable to isolate execution in a guest, to a specific
383 guest core. It might also be desirable to run a guest on a specific host
384 core.</para>
385
386 <para>To pin the virtual CPUs of the guest to specific cores, configure
387 the <literal>&lt;cputune&gt;</literal> contents as follows:</para>
388
389 <orderedlist>
390 <listitem>
391 <para>First explicitly state on which host core each guest core
392 shall run, by mapping <literal>vcpu</literal> to
393 <literal>cpuset</literal> in the <literal>&lt;vcpupin&gt;</literal>
394 tag.</para>
395 </listitem>
396
397 <listitem>
398 <para>In the <literal>&lt;cputune&gt;</literal> tag it is further
399 possible to specify on which CPU the emulator shall run by adding
400 the <literal>cpuset</literal> to the
401 <literal>&lt;emulatorpin&gt;</literal> tag.</para>
402
403 <programlisting>&lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
404&lt;cputune&gt;
405 &lt;vcpupin vcpu='0' cpuset='2'/&gt;
406 &lt;vcpupin vcpu='1' cpuset='3'/&gt;
407 &lt;emulatorpin cpuset="2"/&gt;
408&lt;/cputune&gt;</programlisting>
409
410 <para><literal>libvirt</literal> will group all threads belonging to
411 a QEMU instance into cgroups that will be created for that purpose.
412 It is possible to supply a base name for those cgroups using the
413 <literal>&lt;resource&gt;</literal> tag:</para>
414
415 <programlisting>&lt;resource&gt;
416 &lt;partition&gt;/rt&lt;/partition&gt;
417&lt;/resource&gt;</programlisting>
418 </listitem>
419 </orderedlist>
420 </section>
421
422 <section id="network-libvirt">
423 <title>Networking using libvirt</title>
424
425 <para>Command <command>virsh net-create</command> starts a network. If
426 any networks are listed in the guest XML file, those networks must be
427 started before the guest is started. As an example, if the network is
428 defined in a file named <filename>example-net.xml</filename>, it will be
429 started as such:</para>
430
431 <programlisting>virsh net-create example-net.xml
432&lt;network&gt;
433 &lt;name&gt;sriov&lt;/name&gt;
434 &lt;forward mode='hostdev' managed='yes'&gt;
435 &lt;pf dev='eno3'/&gt;
436 &lt;/forward&gt;
437&lt;/network&gt;</programlisting>
438
439 <para><literal>libvirt</literal> is a virtualization API that supports
440 virtual network creation. These networks can be connected to guests and
441 containers by referencing the network in the guest XML file. It is
442 possible to have a virtual network persistently running on the host by
443 starting the network with command <command>virsh net-define</command>
444 instead of the previously mentioned <command>virsh
445 net-create</command>.</para>
446
447 <para>An example for the sample network defined in
448 <literal>meta-vt/recipes-example/virt-example/files/example-net.xml</literal>:</para>
449
450 <programlisting>virsh net-define example-net.xml</programlisting>
451
452 <para>Command <command>virsh net-autostart</command> enables a
453 persistent network to start automatically when the libvirt daemon
454 starts:</para>
455
456 <programlisting>virsh net-autostart example-net</programlisting>
457
458 <para>The guest configuration file (xml) must be updated to access the
459 newly created network like so:</para>
460
461 <programlisting> &lt;interface type='network'&gt;
462 &lt;source network='sriov'/&gt;
463 &lt;/interface&gt;</programlisting>
464
465 <para>The following are a few ways of network access from a guest while
466 using <command>virsh</command>:</para>
467
468 <itemizedlist>
469 <listitem>
470 <para><emphasis role="bold">vhost-user interface</emphasis></para>
471
472 <para>See the Open vSwitch chapter on how to create a
473 <literal>vhost-user</literal> interface using Open vSwitch(OVS).
474 Currently there is no Open vSwitch(OVS) support for networks that
475 are managed by <literal>libvirt </literal>(e.g. NAT). Until further
476 notice, only bridged networks are supported (those where the user
477 has to manually create the bridge). In order to pass Open vSwitch
478 configuration the &lt;qemu:commandline&gt; is used.</para>
479
480 <programlisting> &lt;qemu:commandline&gt;
481 &lt;qemu:arg value='-chardev'/&gt;
482 &lt;qemu:arg value='socket,id=charnet0,path=/var/run/openvswitch/vhost-user1'/&gt;
483 &lt;qemu:arg value='-netdev'/&gt;
484 &lt;qemu:arg value='type=vhost-user,id=hostnet0,chardev=charnet0'/&gt;
485 &lt;qemu:arg value='-device'/&gt;
486 &lt;qemu:arg value='virtio-net-pci,netdev=hostnet0,id=net0,mac=00:00:00:00:00:01,/
487 bus=pcie.0,addr=0x2'/&gt;
488 &lt;/qemu:commandline&gt;</programlisting>
489 </listitem>
490
491 <listitem>
492 <para><emphasis role="bold">PCI passthrough
493 (SR-IOV)</emphasis></para>
494
495 <para>KVM hypervisor support for attaching PCI devices on the host
496 system to guests. PCI passthrough allows guests to have exclusive
497 access to PCI devices for a range of tasks. PCI passthrough allows
498 PCI devices to appear and behave as if they were physically attached
499 to the guest operating system.</para>
500
501 <para>Preparing a system for PCI passthrough is done like so:</para>
502
503 <itemizedlist>
504 <listitem>
505 <para>Change the owner of the
506 <literal>/dev/vfio/&lt;group&gt;</literal> to QEMU and edit
507 <literal>/etc/libvirt/qemu.conf</literal> to explicitly allow
508 permission to it:</para>
509
510 <para><programlisting>$ chown qemu:qemu /dev/vfio/66
511$ ls -l /dev/vfio/66
512crw------- 1 qemu qemu 244, 0 Dec 4 08:24 /dev/vfio/66
513
514$ cat /etc/libvirt/qemu.conf
515...
516cgroup_device_acl = [
517 "/dev/null", "/dev/full", "/dev/zero",
518 "/dev/random", "/dev/urandom",
519 "/dev/ptmx", "/dev/kvm", "/dev/kqemu",
520 "/dev/rtc","/dev/hpet", "/dev/vfio/vfio",
521 <command>"/dev/vfio/66"</command>,
522]
523...</programlisting></para>
524 </listitem>
525
526 <listitem>
527 <para>Increase the locked memory limits within the libvirtd
528 service file:</para>
529
530 <para><programlisting>$ cat /lib/systemd/system/libvirtd.service
531...
532[Service]
533Type=forking
534PIDFile=/var/run/libvirtd.pid
535EnvironmentFile=-/etc/sysconfig/libvirtd
536<command>LimitMEMLOCK=infinity</command>
537ExecStart=/usr/sbin/libvirtd $LIBVIRTD_ARGS
538ExecReload=/bin/kill -HUP $MAINPID
539KillMode=process
540Restart=on-failure
541# Override the maximum number of opened files
542#LimitNOFILE=2048
543...</programlisting></para>
544 </listitem>
545
546 <listitem>
547 <para>VFs must be created on the host before starting the
548 guest:</para>
549
550 <programlisting>$ modprobe vfio_pci
551$ dpdk-devbind.py --bind=vfio-pci 0001:01:00.1
552 &lt;qemu:commandline&gt;
553 &lt;qemu:arg value='-device'/&gt;
554 &lt;qemu:arg value='vfio-pci,host=0001:01:00.1'/&gt;
555 &lt;/qemu:commandline&gt;</programlisting>
556 </listitem>
557 </itemizedlist>
558 </listitem>
559
560 <listitem>
561 <para><emphasis role="bold">Bridge interface</emphasis></para>
562
563 <para>In case an OVS bridge exists on host, it can be used to
564 connect the guest:</para>
565
566 <programlisting> &lt;interface type='bridge'&gt;
567 &lt;mac address='52:54:00:71:b1:b6'/&gt;
568 &lt;source bridge='ovsbr0'/&gt;
569 &lt;model type='rtl8139'/&gt;
570 &lt;virtualport type='openvswitch'/&gt;
571 &lt;/interface&gt;</programlisting>
572
573 <para>For further details on the network XML format, see <ulink
574 url="http://libvirt.org/formatnetwork.html">http://libvirt.org/formatnetwork.html</ulink>.</para>
575 </listitem>
576 </itemizedlist>
577 </section>
578
579 <section id="libvirt-guest-config-ex">
580 <title>Libvirt guest configuration examples</title>
581
582 <note>
583 <para>Currently used Libvirt version has some limitations for aarch64
584 which are bypassed using the qemu:commandline option.</para>
585 </note>
586
587 <example>
588 <title>Guest configuration with vhost-user interface</title>
589
590 <programlisting>&lt;domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'&gt;
591 &lt;name&gt;vm_vhost&lt;/name&gt;
592 &lt;uuid&gt;ed204646-1ad5-11e7-93ae-92361f002671&lt;/uuid&gt;
593 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
594 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
595 &lt;memoryBacking&gt;
596 &lt;hugepages&gt;
597 &lt;page size='512' unit='M' nodeset='0'/&gt;
598 &lt;/hugepages&gt;
599 &lt;/memoryBacking&gt;
600 &lt;os&gt;
601 &lt;type arch='aarch64' machine='virt,gic_version=3'&gt;hvm&lt;/type&gt;
602 &lt;kernel&gt;/mnt/qemu/Image&lt;/kernel&gt;
603 &lt;cmdline&gt;root=/dev/vda console=ttyAMA0,115200n8&lt;/cmdline&gt;
604 &lt;boot dev='hd'/&gt;
605 &lt;/os&gt;
606 &lt;features&gt;
607 &lt;acpi/&gt;
608 &lt;apic/&gt;
609 &lt;/features&gt;
610 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
611 &lt;cpu mode='host-model'&gt;
612 &lt;model fallback='allow'/&gt;
613 &lt;topology sockets='1' cores='2' threads='1'/&gt;
614 &lt;numa&gt;
615 &lt;cell id='0' cpus='0' memory='4194304' unit='KiB' memAccess='shared'/&gt;
616 &lt;/numa&gt;
617 &lt;/cpu&gt;
618 &lt;cputune&gt;
619 &lt;vcpupin vcpu="0" cpuset="4"/&gt;
620 &lt;vcpupin vcpu="1" cpuset="5"/&gt;
621 &lt;/cputune&gt;
622 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
623 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
624 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
625 &lt;devices&gt;
626 &lt;emulator&gt;/usr/bin/qemu-system-aarch64&lt;/emulator&gt;
627 &lt;disk type='file' device='disk'&gt;
628 &lt;driver name='qemu' type='raw' cache='none'/&gt;
629 &lt;source file='/mnt/qemu/enea-nfv-access-guest-qemuarm64.ext4'/&gt;
630 &lt;target dev='vda' bus='virtio'/&gt;
631 &lt;/disk&gt;
632 &lt;serial type='pty'&gt;
633 &lt;target port='0'/&gt;
634 &lt;/serial&gt;
635 &lt;console type='pty'&gt;
636 &lt;target type='serial' port='0'/&gt;
637 &lt;/console&gt;
638 &lt;/devices&gt;
639 &lt;qemu:commandline&gt;
640 &lt;qemu:arg value='-chardev'/&gt;
641 &lt;qemu:arg value='socket,id=charnet0,path=/var/run/openvswitch/vhost-user1'/&gt;
642 &lt;qemu:arg value='-netdev'/&gt;
643 &lt;qemu:arg value='type=vhost-user,id=hostnet0,chardev=charnet0'/&gt;
644 &lt;qemu:arg value='-device'/&gt;
645 &lt;qemu:arg value='virtio-net-pci,netdev=hostnet0,id=net0,mac=00:00:00:00:00:01,/
646 bus=pcie.0,addr=0x2'/&gt;
647 &lt;/qemu:commandline&gt;
648&lt;/domain&gt;</programlisting>
649 </example>
650
651 <example>
652 <title>Guest configuration with PCI passthrough</title>
653
654 <programlisting>&lt;domain type='kvm' xmlns:qemu='http://libvirt.org/schemas/domain/qemu/1.0'&gt;
655 &lt;name&gt;vm_sriov&lt;/name&gt;
656 &lt;uuid&gt;ed204646-1ad5-11e7-93ae-92361f002671&lt;/uuid&gt;
657 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
658 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
659 &lt;memoryBacking&gt;
660 &lt;hugepages&gt;
661 &lt;page size='512' unit='M' nodeset='0'/&gt;
662 &lt;/hugepages&gt;
663 &lt;/memoryBacking&gt;
664 &lt;os&gt;
665 &lt;type arch='aarch64' machine='virt,gic_version=3'&gt;hvm&lt;/type&gt;
666 &lt;kernel&gt;/mnt/qemu/Image&lt;/kernel&gt;
667 &lt;cmdline&gt;root=/dev/vda console=ttyAMA0,115200n8&lt;/cmdline&gt;
668 &lt;boot dev='hd'/&gt;
669 &lt;/os&gt;
670 &lt;features&gt;
671 &lt;acpi/&gt;
672 &lt;apic/&gt;
673 &lt;/features&gt;
674 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
675 &lt;cpu mode='host-model'&gt;
676 &lt;model fallback='allow'/&gt;
677 &lt;topology sockets='1' cores='2' threads='1'/&gt;
678 &lt;numa&gt;
679 &lt;cell id='0' cpus='0' memory='4194304' unit='KiB' memAccess='shared'/&gt;
680 &lt;/numa&gt;
681 &lt;/cpu&gt;
682 &lt;cputune&gt;
683 &lt;vcpupin vcpu="0" cpuset="4"/&gt;
684 &lt;vcpupin vcpu="1" cpuset="5"/&gt;
685 &lt;/cputune&gt;
686 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
687 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
688 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
689 &lt;devices&gt;
690 &lt;emulator&gt;/usr/bin/qemu-system-aarch64&lt;/emulator&gt;
691 &lt;disk type='file' device='disk'&gt;
692 &lt;driver name='qemu' type='raw' cache='none'/&gt;
693 &lt;source file='/mnt/qemu/enea-nfv-access-guest-qemuarm64.ext4'/&gt;
694 &lt;target dev='vda' bus='virtio'/&gt;
695 &lt;/disk&gt;
696 &lt;serial type='pty'&gt;
697 &lt;target port='0'/&gt;
698 &lt;/serial&gt;
699 &lt;console type='pty'&gt;
700 &lt;target type='serial' port='0'/&gt;
701 &lt;/console&gt;
702 &lt;/devices&gt;
703 &lt;qemu:commandline&gt;
704 &lt;qemu:arg value='-device'/&gt;
705 &lt;qemu:arg value='vfio-pci,host=0001:01:00.1'/&gt;
706 &lt;/qemu:commandline&gt;
707&lt;/domain&gt;</programlisting>
708 </example>
709
710 <example>
711 <title>Guest configuration with bridge interface</title>
712
713 <programlisting>&lt;domain type='kvm'&gt;
714 &lt;name&gt;vm_bridge&lt;/name&gt;
715 &lt;uuid&gt;4a9b3f53-fa2a-47f3-a757-dd87720d9d1d&lt;/uuid&gt;
716 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
717 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
718 &lt;memoryBacking&gt;
719 &lt;hugepages&gt;
720 &lt;page size='1' unit='G' nodeset='0'/&gt;
721 &lt;/hugepages&gt;
722 &lt;/memoryBacking&gt;
723 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
724 &lt;cputune&gt;
725 &lt;shares&gt;4096&lt;/shares&gt;
726 &lt;vcpupin vcpu='0' cpuset='4'/&gt;
727 &lt;vcpupin vcpu='1' cpuset='5'/&gt;
728 &lt;emulatorpin cpuset='4,5'/&gt;
729 &lt;/cputune&gt;
730 &lt;os&gt;
731 &lt;type arch='x86_64' machine='q35'&gt;hvm&lt;/type&gt;
732 &lt;kernel&gt;/mnt/qemu/bzImage&lt;/kernel&gt;
733 &lt;cmdline&gt;root=/dev/vda console=ttyS0,115200&lt;/cmdline&gt;
734 &lt;boot dev='hd'/&gt;
735 &lt;/os&gt;
736 &lt;features&gt;
737 &lt;acpi/&gt;
738 &lt;apic/&gt;
739 &lt;/features&gt;
740 &lt;cpu mode='host-model'&gt;
741 &lt;model fallback='allow'/&gt;
742 &lt;topology sockets='2' cores='1' threads='1'/&gt;
743 &lt;numa&gt;
744 &lt;cell id='0' cpus='0-1' memory='4194304' unit='KiB' memAccess='shared'/&gt;
745 &lt;/numa&gt;
746 &lt;/cpu&gt;
747 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
748 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
749 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
750 &lt;devices&gt;
751 &lt;emulator&gt;/usr/bin/qemu-system-x86_64&lt;/emulator&gt;
752 &lt;disk type='file' device='disk'&gt;
753 &lt;driver name='qemu' type='raw' cache='none'/&gt;
754 &lt;source file='/mnt/qemu/enea-nfv-access-guest-qemux86-64.ext4'/&gt;
755 &lt;target dev='vda' bus='virtio'/&gt;
756 &lt;/disk&gt;vi
757 &lt;interface type='bridge'&gt;
758 &lt;mac address='52:54:00:71:b1:b6'/&gt;
759 &lt;source bridge='ovsbr0'/&gt;
760 &lt;model type='rtl8139'/&gt;
761 &lt;virtualport type='openvswitch'/&gt;
762 &lt;/interface&gt;
763 &lt;serial type='pty'&gt;
764 &lt;target port='0'/&gt;
765 &lt;/serial&gt;
766 &lt;console type='pty'&gt;
767 &lt;target type='serial' port='0'/&gt;
768 &lt;/console&gt;
769 &lt;/devices&gt;
770&lt;/domain&gt;</programlisting>
771 </example>
772 </section>
773 </section>
774</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.png b/doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.png
deleted file mode 100644
index c28d643..0000000
--- a/doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg b/doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg
deleted file mode 100644
index 319bf7e..0000000
--- a/doc/book-enea-nfv-access-guide/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg
+++ /dev/null
@@ -1,3 +0,0 @@
1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
3<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" preserveAspectRatio="xMidYMid meet" viewBox="0 0 640 640" width="640" height="640"><defs><path d="M0 93L640 93L640 547L0 547L0 93Z" id="b4lgbdl3I5"></path><clipPath id="clipbKzvApRlV"><use xlink:href="#b4lgbdl3I5" opacity="1"></use></clipPath></defs><g><g><g><g clip-path="url(#clipbKzvApRlV)" opacity="1"><image xlink:href="data:image/png;base64,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" x="0" y="0" width="640" height="454" transform="matrix(1 0 0 1 1.1368683772161603e-13 93.00000000000006)"></image></g></g></g></g></svg> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.png b/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.png
deleted file mode 100755
index 4c926e5..0000000
--- a/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.svg b/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.svg
deleted file mode 100755
index f888174..0000000
--- a/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions.svg
+++ /dev/null
@@ -1,1569 +0,0 @@
1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!-- Created with Inkscape (http://www.inkscape.org/) -->
3
4<svg
5 xmlns:dc="http://purl.org/dc/elements/1.1/"
6 xmlns:cc="http://creativecommons.org/ns#"
7 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
8 xmlns:svg="http://www.w3.org/2000/svg"
9 xmlns="http://www.w3.org/2000/svg"
10 xmlns:xlink="http://www.w3.org/1999/xlink"
11 xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
12 xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
13 id="svg2985"
14 version="1.1"
15 inkscape:version="0.48.4 r9939"
16 width="559"
17 height="501"
18 sodipodi:docname="virtual_network_functions.png">
19 <metadata
20 id="metadata2991">
21 <rdf:RDF>
22 <cc:Work
23 rdf:about="">
24 <dc:format>image/svg+xml</dc:format>
25 <dc:type
26 rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
27 <dc:title></dc:title>
28 </cc:Work>
29 </rdf:RDF>
30 </metadata>
31 <defs
32 id="defs2989" />
33 <sodipodi:namedview
34 pagecolor="#ffffff"
35 bordercolor="#666666"
36 borderopacity="1"
37 objecttolerance="10"
38 gridtolerance="10"
39 guidetolerance="10"
40 inkscape:pageopacity="0"
41 inkscape:pageshadow="2"
42 inkscape:window-width="640"
43 inkscape:window-height="480"
44 id="namedview2987"
45 showgrid="false"
46 showborder="false"
47 inkscape:showpageshadow="false"
48 fit-margin-top="0"
49 fit-margin-left="0"
50 fit-margin-right="0"
51 fit-margin-bottom="0"
52 inkscape:zoom="0.47105788"
53 inkscape:cx="279.5"
54 inkscape:cy="250.5"
55 inkscape:window-x="0"
56 inkscape:window-y="0"
57 inkscape:window-maximized="0"
58 inkscape:current-layer="svg2985" />
59 <image
60 width="559"
61 height="501"
62 xlink:href="data:image/png;base64,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
1266xbU8dD+LF94dJBIQBEyFY72R7C+eHEn18xP8ciBHE8dyvONp4a5bccE3796TvWcHS+4GArqpwWa
127S+f44eUPezNsGC4wXnS5sjcF+AXPnvZHid51RjN335Lh608O42iqdUWu1lhK8b/PbWNWIugXglsG
128rbEAQUNxw/JGbtoyzq3bJpiTCnLD8kbeVinATgQMgoZirCBPyRZC/Pk4qfAStgyunpfiq08M8dUn
129hih7mqvnHft3IrkemAb85+V+EeaH7j3AoaxNKmQec/kjmQrqIybrh/L0Tdp0p4JMllyG8g5NEYuA
130obivP8f2sRLjJZeP3XMAKoWyd++e5K9XNRMyFVpTDT9/SsHRLG6K8K7Tm/jUQ4cIGopVlaktXSlc
131ff/qlhM+hiMtbQzzsy0T7J0o86blDYQtg2XNYX6yZZw7dqZZ2hQmGTKZkwoSDxrcuGGMi7oSNEX9
132j2njcIFbt00wty5EZyJAyfWIBky+f3UXIdPgA/ccYDBr0xjxl9dAzna5fG6CL186i7GCwz17J/mH
133hw9y7qwYvfWho9pYdjVzkkHedYwC57qQSdnVrB8qcGG3PyrUN1lCa01gWh8XHI/VHTFevaiebz87
134Uh1lCJkGixvD/LEvy/rBPCtb/b59fCDHvz0zwusX1/PSuSf2O7amwtKypjBF2+N7G8ZY0hSpjuj8
135fs8k9/VleEl3gkTQxPH86cmWqMXHzm7jNbfvwXY1i5vCxCzFVx4f5Jfb03z3yi4+vLYVgJ9uGeNt
136v+nj9h0TLGlqq/bp1MjPlJWtUdZ2RLljRxrTgJWtEU5vmxpd9BtadPy7qt56WiNfenyQkGlUp6M8
137/HPrzcsbqyM6033jpbP5q1VN3L49zcMHcnz6oYMYCj64phVlnExEF0KIF4eTrvB7xYIUN24c5aED
138OS6cHa/WdByLAtpiAU5rifDvV3Txilt285d39XHb9b0nFAAW1If49voR3nLnPla1RelLl9kyUuTD
139a1oAuGvXJAETvnJJJ82VC/wj/Tm+v3GUJw7muGBWnGjA4PGBPB+8px+oXEq05rVL6qsFllO8yoXm
140tUvq+eGmcbaMFKrvGcr/hv7+PxygPnw4HHha867Tm1jY+KdHk05v9adLJooOqyoX7hWtUWIBxd50
141mTdXRkPm1Yd449IGPv/oINfdups1nTG01vx29yRbR0t86/JZhCsjDobya0zmNYT518tnc+0tu3nP
1427/bzs+t6CJoK14PZCb8epiFi8f7VLbzzN338wyMH+Y8ruo8Kdgp/qsbx9IxaD/CnvuJBky89PsSe
143dBkD+OWONLOTQRY1him7/uiHW5n+e8tpDfxyxwRDOQevkjbeeloj9+7L8prb9nJlbxJTwd17Mmwa
144KbC6PcpL/2QvUu37gq05oz3G1fNS/PszI+ybLLOoMUzR8bh9R5psyeN1SxswKiNUWkPB9ThvdpyL
145uhLcsm0crf16nGVNET75wEH+4pd7eGlPEsuAR/tzaA29dYcDRSJo4HiQLh4e6UmFTK5dWMfH/ziA
14668Fnz2+sniNT3Mrxv3FZAz99bpzdE6WjjiddOnr0ZP1ggX9/ZoTXLK7jY2e38ce+DI8N5ChUpiSz
147ZY+i6492CSHEn4uTDi9z60KsaImw5WCeS7oTBKfVehQcj0zZReN/g58sudX6j7l1Id69qol3/aaP
148f3zkEJ+7sONwwaT2/xE+cuj/1Yvr2TRS5JatE9y3e5JA0ODK3iRvWdHIUM7h9u1pVrT4tzJPObM9
149yo82jfHTLeMsawrjac0zg3meOZT3F6jMcSxtjlTDiz9C4VXDS2sswFtOa+A9v9tfnbpxPM1E0eV7
150G8YOf+330wtXzE3MCC+u1mTKLuWp2piK7lSQsKnwNCyqTMX01AVpjlpsGSmxuLINy1B87Ow2DAU/
1512jTGQ49mwFAsb4nw1Us7edsKvzC16HhMll3ylX5b2RrlrSsa+dT9A3yrK85rFzeQs73KVJPv+kX1
152/Py5CW58ZpQLZid4y2mN1fem+sHVx/4uv6AhxMfObuWfHh/k648PATC/KcRH1rbSHLUYyNhkyi6F
153yme+tDnCaxbV8/mHD1Y/20vnJPjGZbP44mOH+NoTQ+BpuhpCfPb8dt66oumofRYcj2zZm1H/VHI1
154mZJLyfUIW4ovXNxJLGjwi21p7tw2gWEZrOmI8t6LOriiMpJTrJybdqUr3nV6E7/ZNcl40SVna67o
155TfL5izr4xlPDfOWxQQBm1wX50JoWrptWjzOvPkRjxGI478xo5wWz48QCJrbrVe8Om+rTbNkjHFDV
156c+CNyxr423v7q+fW1PG4xyjy6ogHcDyPN/96H+CXW13ek6xOG40VXCIBVb3DTggh/hyo++67T69Y
157sYL6+uM/T+JIB7I220aLrO6IkZhWeLkrXWYk77CmPcpIwWXrWJEz2qJEKt/uXfxvswFDsWbaw9EA
158nhrMUxe26D3Gw7aeHiqQKblELINVbREspSh6msf7c8xJBelOBo9a3vU0p7dG2TxSIF1yq/UFAGhY
1592hymftroz7PD/ijLiubDxcQP9+doilosrA8xWnTZPFI8qthVazijPUJ0WoizNaw7mGNufYjWyMx8
160uGG4QM72OHvaqM/28RIHszZrOmYWcgL0ZWz2pEtYSrGwMUzTtFqL/Rmb/Zkyq9tjTNUWF1zNEwM5
1616sImK5ojPHEoT2PYorfucB8N5Gw2jxSZkwoyv27mNMX64QKmUix/nrqk/RmbPekyAHPrgsyKH655
162euJQnlTIZGFl+sPR8PCB7FGfU8b22DBUwPY0Xckgc4/zkLXd6TJjRYczWw+fLwM5mz0TZc5qj86o
163v9lW6cewZbC8OUzMOvyZ7J0s05+xOXdaYe+zwwVKrmZ12+Ft78/621bArGSAnuTR7bri5p20xwJ8
16476ruGa8/NZjH9WD1Eef204MFgqZi2bQ+ffBAlvZ4kHl1QQbzDjvGSqzumHk80z07XGAw5xALGJzT
165GatOFX324UPctXuS+14/b0bRuBBCvBiNj4+zYcOGkw8vzx3M43maaMAgZ3vVqQLwb+8MGIrJkkfQ
166VEQsg6ztVm95tiq3C7uVkZapu5MM/NtYHa3J2zNHXyxDEbUMDMN/wm7B1pQ9D1MpEkGTsufNWMdQ
167/j40/m2v0YBRKbqd/q1WkXcOt11V9g9URyn8tprYniZnu4RMo/IE1SO/HStytjvjTimzcltu0dGU
168pvXP1H4MNXWHlb9OLGASMBW58sztGEoRsRQBw99vydUUHV3tt4hlEKwUwE59aw+aBtGA/4C8guP5
169/erN7NeI5d8yXHRmjnZNtW9qtODoY/WXiQQUQcPvr7LnUbD9NhmV43Y9v9YG/MLreNA8al9+fypQ
170Ctv126ePsb9owMBS/jFOjYyFLYOwqcjaXvXcMpUiEvDrSLTWR/V91DIImKra7wpFIugXjGSnvTb9
1712OxKobk3bUREobhjZ5r9k2XesbKxOno4deyKmZ/t1H48IHvEuTV17oZN//OY/ndlOlMp/zyuHFve
1729qrnyY83jeNqzQ2nNc5opxBC1ArHha6GEG0n8KTwqfBy0tNG920bZ/94ufp0WyH+3MSCBosiJr/Z
173MPZCN4W2oH+L/G3PjLzQTRFCiP+WXNnlquWNtKaCJ3wDwkmHl3DAIBo0TvgOHiFebKZuf46cAkWy
174p1JbhBDiv0PDjDtWT4T8iyeEEEKImiLhRQghhBA1RcKLEEIIIWqKhBchhBBC1BQJL0IIIYSoKRJe
175hBBCCFFTJLwIIYQQoqZIeBFCCCFETZHwIoQQQoiaIuFFCCGEEDVFwosQQgghaoqEFyGEEELUFAkv
176QgghhKgpEl6EEEIIUVMkvAghhBCipkh4EUIIIURNkfAihBBCiJoi4UUIIYQQNUXCixBCCCFqioQX
177IYQQQtQUCS9CCCGEqCkSXoQQQghRUyS8CCGEEKKmSHgRQgghRE2R8CKEEEKImiLhRQghhBA1RcKL
178EEIIIWqKhBchhBBC1BQJL0IIIYSoKRJehBBCCFFTJLwIIYQQoqZYL3QDhBA+T4PjegAETAOlZr5v
179uxqtNZZpoLXG9TSGobAMdcxlTAWO5y93LMfax/Q2HItpKExDHff9U4EGdKVvhBAvThJehDgFaK2J
180BE0ao0FcDSNZG8fV1XChgZZEgEjQZDxnY5mKWMgkW3KZLLhMXadbkwGClsF4zqFgu6QiFvGweYz9
181wVjOpuxM24eGSMCgvi543HZOFhxyJe+o0HOq8DS4niYeMik7HseObUKIWifhRYhTgONCKmLx2jWt
182BAzFTU8MsXMoT9AycFxNMmLxutWthCzFDx8b5PSuOKu6EgykS9z0+BAF2yNoKS5f2khXQ4hfPDPM
183s/uzXLQwztlzU8fc548fH2TPSJGA6ScRx9PMaghy/aqW47bz3q3jPLgzTdg69WactdYETMU581Ik
184wxZ3bxoF1CkbtIQQ/30SXoQ4BZimYmiyzP7REnObw8xribBruIDW4GpNV0OIRNhk66E8/RNlzpzj
185X5E7UiFWdsV5cEeaIAqt/bEGfcSQw0TBYTznVEdoPK0p2O5RF/ap9cqu5lC6hKdh+iLjOQezspLt
186apzKlJQCAubhKSWtwZ42ZWUo/32jsq7raX+Kq7Jd/30DBRQdDwWELAOjMvVVdjWmoQiaCsfV2NOm
187wkylCFqKsquZ3RDmwvl17BwqkCt7RANm5Xg8plYxDeW3pXIMtqexDIWndfV4A6bC9fy+Bwiap/50
188mRB/TiS8CHEKMBSUbM3ukQJzm8PMbQoTDRoUbY+gabB8VgyAnUOFo2pYzupOsP1QnrG8c4xpEv+C
189++SeSX67eZyQ5f9sGYpo0JxRLzPd8GSZ7zx4kLKrq4FHAbGQScBU2J6mtznCss4o4YDJaNbmmb4s
190Y3kbUyk8NEvaoyztiGEo2DdaZMOBHCXHr6epi1qcPjtBcyKApzX7x0s83ZclFjR4+YJGMkWXh3am
191KdoenfVBzuxOMjRZ5vE9k8xuDLFyVpxo0KTsemwfLLDxQJaWRJALF9QB0JYK8rrVLdz73DiZksua
192niQ9TWFcT/PcoQJbD+awPVjcHmVhW5Qdg3maE0GaEwHGcjbr9mWY3xyhtyVCtuSybm+W4UwZy5QA
193I8SpQMKLEKcI04TdwwUKvSka4haz6kJsOphndn2QWXVh0gWHXcP56jQPQNnxp5ROn53gD1vHjxpx
194mTK7IcQ5vSmmZnsm8g4D6TLHuxTHQiZn9SRxPV1dxtWaPSNFCmWPJR1Rrl7eiAeMZGzWzk3S0xjm
195J08Mki25nL8gxUUL6pksuhTLHguWRJnTFOG2Z0YwDbj29Gaa4gH2jhRJhi0uXRRlTmOY320eZ1Z9
196mFTEZNdwgS0DOXqaIizvjPFAzqY9FeRVq5pxXM3BdJnZ9WGWtMdIRSy2HsxX228ohakUylBcsqie
197NT1JRrI2AVOxuD3GXZbi4d2TtKWCLO+MsagtysF0iVTEYlFblMXtMcqOP1qzoDVKUzzIz9cNUXY0
198xqk3YybEnx0JL0KcIkylGM7abB/Ks2JWnO6mMM/25+huDBO0FJsHimSKHoY6PJXzzP4Mi9pirOqO
199s2M4j+3OTC9T00iL2mIsaotVX98xWOCn64YImOqoAKPxR0ZeflrjUW38t/sH8DzNefPqCFgGN68b
200ZuOBLK9Y2cTyzhhzmiKM520umF9Hpujyo8cGGc/bvPasFua3+CGkf6JERyrIockyd20aJVty6W4I
201EwkaTBYdntw7yUsW19PdGGb7YJ72ZBBPw7bBPHObosSCJk/ty3DXpjEiAYPO+hC6UuT80I40r13d
202Qt9oke8/eoiFbVFW9yQ5MFHi238cIBYyeecFHZy/oI7NB/PVkaDRrM2PHx9kdkOYN65pJR4y+f5T
203w6QLDu+8sINZdUEaYgH6J0oYx418Qoj/KRJehDhFKAWOo9k9XGDFrDhzGsM0xwN0N4bwNGwfzOPq
204mbcAD0yUKdqaCxekWNOTImgd+8J6MF2if7xcHTU4MF7i+WZA8mWX7YMFvGlDObaryZddEmGTlkSA
205dMHh4ESJcMDgnq3jPLB9gqLtcVZPAkMpdg0XGM3auJ5m00CO3uYIsxpCbBvMM1l0aEsGec8lnWzq
206z7G5P8fWg3nKrkf/RAnX08xtCtNRF6I1GWQ8bzOac6iL2gCc0Z1gYVt+VluYAAAgAElEQVSUZ/qy
207bD2UZ2CihFJUj98wFOGAQWsyiMIPhufPrwMFpoJ4yKQ+auF5h/uj5Gh05eexnM1QpkwsZFK2PRKV
2086TI/DEp4EeKFJuFFiFNIwFQcmCiRLji0JIOs7IrT2xxhcLLM3tEiljFzpMRU8OTeSZZ3xljQGqkW
2090E5RlQLZ5w7m+f2WiWrNi2n6xa/HovCnlW5/dgTbmVbzovxamVTEL4J1XL8g1zT8YJMruZVpJn+F
210kq3R2l+v7PjtChiKdN7h9vWjnNObpC0ZZMWsOCtmxdk1VODOTaMcGC8xMFFmVn2I3uYwsZDJxv4s
211Jdtj11CBuzaNcfrsOA3xAOfPT3FOb5LH90xy79ZxjnxCTTjgp7X6qMU5vUkA0gWHyaKL41EtWJ4a
212sZr6uexqtPJ/lruVhDj1SHgR4hRiGoqJvEvfWInlnRZre5JYhuK5gzlKjiZoKvS0slzTVIxmbR7f
213k+ZlyxqPW4AbMBXRoHHckZkjGUoRDZjYxuHwAv5dQiVHU7Q9YmGTeMhk35jNgtYo81si7Bstkiu5
214ALSlAgQsRb7s0Z7ynx2TK3sYhqJvtMje0QKxoElXQ5jz56fobYkwpzHCk3sm2difZXZDiDU9KSxD
215sW2wgGn4tz2v25fhqX0Z6mMW81siXLSwnjVzk6zbm5lxt1XJ9pgsOgBsH8pz85PDJMImZ3QnCJqK
216ibyNoSLA0QFFIeMrQpzKJLwIcYpRwI6hPMs7Y4QDBgXbv6PGnFYoqqaNhgQtxab+HMs64sxuCFW3
217ceRyJ7pvgJZkkLed1w5H3L+0eSDHPVsneGZ/hrPnpjh3Xor4AZOXLK6nNRkkXXDZ2J/lULpMd2OY
2188+elGM87rJ2bpORonu7L0FEX5BUrmsiWXB7dNUm+7FZvQ86XXQwD+sZKZEv+FNVI1ubgRAlPa1Z1
219J1g9J8mekSJP78tU7sZSpAuOf+t2ZQSlMW6xuD3GoYky43mH0zrj7B8tkYyYnD+/jj0jRe7fkT5u
220/0wPbHKHtBCnHgkvQpxiDAX94yXGsg6pqMmekQLpglN9Rgr4IyCup/E8f5SkYGse3pnm2tObCJiq
221+kwT15ta9sT27Wn/uSqGgobY0f88JCpP63101ySRgMnyzhjLOmPkSi73bp1g40CWsqO5c+Mo585L
222ce78FAo4mC7zwPYJDqZLhCyDjQM5zuxO8NrV/gPxMkWX328ZZ+9IgbBlMpa32TtaZFlHjJ1DBfJl
223D9NQbDtUoD0ZYnlnjJWz4wAMpMvcv3WcfNllYKLMloM5FrVFecPaVn742CFufWqYy5c1cFWlAHnn
224UIHfbhrDqRTrTu8fzeFn0EyxK9Nj8rReIU4d6r777tMrVqygvr7+hFb47sMH6Z8oH3e+XAjx/0Y0
225aGAaipKjKVUe3DYlHDAImIqi7fn1JJU7kOIhE6WgUPawXU044E8VHWsbR9L4NSmR4PHvBbZdf8rI
2269TSGUiTCJoZSOJ7HZNHFUApD+csFTP99haJgu+TLXqXo1Q8IibBJoDKcZHse2aKLYShsR+Ohec0Z
227LSxqj3Lr08Ns6s8RDhh+TY1SJMOmX7isNQXbo2B71QfNWYb/qxMA/72yRyRgEK0cV7bkUnb95YKW
228QchSlCtTYVZles31/FEgpSAaNDEU5MsezrRbx4UQ/2/kyx4vXVLPOfNSf/Lv1/j4OBs2bJCRFyFO
229VZmiWy14PfLprrmS/55hqOq0hsZ/ki6aan1IwXbJlWYudzyKSjjJOcddxjAqz1Ax/BAytb+pNk7t
230Ymr0Zzx/+P2p59Mo5dfqZEsuWrvV1wxD4XqaFbPjnNEVp7M+xEjWpn+iXA05R+53at2pWh8/SPlP
231AvbvLPKfplt2PYo5r3oMU8sXbY98SVePy3E14zmnejxa+wW+0/tUCPHCk/AixCnq+R5Hf6z3FBxV
232sGsohXH072U8LqU44afIKgXW81zNDcWMqa4Z63LsY9AabNcfSXl6X4Zn9mfJFJ0Zx3VC+zVPrB+O
233XPZYx3+8ImghxAtHwosQ4pQRNBVbD+XZ2J/zw5ipJDwIIY4i4UUIccrQ+CMdEliEEM9HfkuHEEII
234IWqKhBchhBBC1BQJL0IIIYSoKRJehBBCCFFTJLwIIYQQoqZIeBFCCCFETZHwIoQQQoiaIuFFCCGE
235EDVFwosQQgghaoqEFyGEEELUFAkvQgghhKgpEl6EEEIIUVMkvAghhBCipkh4EUIIIURNkfAihBBC
236iJoi4UUIIYQQNUXCixBCCCFqioQXIYQQQtQUCS9CCCGEqCkSXoQQQghRUyS8CCGEEKKmSHgRQggh
237RE2R8CKEEEKImiLhRQghhBA1RcKLEEIIIWqKhBchhBBC1BQJL0IIIYSoKRJehBBCCFFTJLwIIYQQ
238oqZYJ7uC62kcV2Oo/z+aI4QQQog/J46r8bQ+qXVOOrwkwhb1MY+gKelFCCGEEP93wpZHOGie1Don
239HV7+4oxmTi4fCSGEEEIchwbDUJzMkMhJhxdT5ouEEEII8QKSgl0hhBBC1BQJL0IIIYSoKQaAaZ5c
240oYwQQgghxP+0qbxihUIh8vk8SkktixBCCCFOXfl8nmAwiGUYBrt370af5D3WQgghhBD/k5RSmKaJ
241chxHUosQQgghaobSMuQihBBCiBoidxsJIYQQoqZIeBFCCCFETZHwIoQQQoiaIuFFCCGEEDVFwosQ
242QgghaoqEFyGEEELUFAkvQgghhKgpEl6EEEIIUVMkvAghhBCipkh4EUIIIURNsdavX4/jOHie90K3
243RQghhBDiuAzDwLIsLNu26ejoIBqNvtBtEkIIIYQ4rnw+z8DAAFYulyOZTJJIJF7oNgkhhBBCHJdl
244WezcudOveXEc54VujxBCCCHE85rKK1KwK4QQQoiaIuFFCCGEEDVFwosQQgghaoqEFyGEEELUFAkv
245QgghhKgpEl6EEEIIUVMkvAghhBCipkh4EUIIIURNkfAihBBCiJoi4UUIIYQQNUXCixBCCCFqioQX
246IYQQQtQU60QX9DTsnijhac2ChjAAjqfZMV4iYhnMSQUZKzgcyNgY6vB6roaWqIXjacaLLvMbQkSs
247w5kpXXLZPVGiPRagLR446QPI2x67J0q4Glqj1oxtDGRthvMOpgINaA1t8QAtUf+wJ0sufZNlNDDV
2485Kn/704FSQTN6nL7JsvMSgRJhUy2jxUJmoq5dSEASq5mx1iRhrBFRyLAYM5mMOcc1Q+diQCpkMnO
2498RKOq1Hq8P7m1oWIBmZmydGCw750mdnJIM3Roz+q/ozNSMEhYCjm1YcImv4Oy65mz0SJkqtntEED
250plJ0JYOMFBwmSy7GtL5pjweq+zmUsxnJO/TWhYhU2nUo5/dn7xFtPZApM1pwsRQsaAwTqOy0YHvs
251TZdxPP9Yq+3QEDQVs5JBBrI2AUMxJxWs9JNmx1iJcOWcGsj67Zg6Dk9DXdikK+kvX3Q89qTL2NOO
2529VjHI4QQ4sXjhP9lL9ge7/ndfp4dLHD79XNZ3REjXXK5/he7Wdka4cfX9PCrHZO8/w/7cbV/EQLI
253F10+fE4rvfVhPnDPAb5zZRevW9JQ3e6/PT3MZx86xA9e3s31i+pPqvH378vwpccH+WNfFtvTLGkM
25486G1rbxxqb/9bz01wteeHEKh8QDPg2UtYb5ycScXdid4+ECOt/5mH5myS6W5uFpjKsXPr+3hynkp
255AB7cn+PNd+7lm5fN5uXzUrzxV3vJlD3uenUvc+tD7J8sc8XPdvL6pfV86eJZfG/DGP/4yCEAvGn9
2568PUrZnP9onpe/cs97E2X8bRGa7AMxUt7Enzpks5qIAL43COH+Oqjg/x/a1r4+mWzq6+7Gr69foRv
257rBti13iJiGVyRW+Cvzu3nSVNYfomS7z8lt3smvCDZSxg4HqaybJLY9jkJ6/o4bsbRrlt+wSe9i/2
258aFjWHOafLpnFhV1xvvvsKN96epg7r+9lZVsU8Pf5zaeGufMv5nFWe5Si4/GNdcN859lR9qRLhE2D
259q+cl+cS5bSxtirB5pMA1P9/FUMGttsP2NOmSy9y6EDde1cXH/jhAeyzAT6/tASBb9nj1bXtY3Bji
260Z9fO5RvrhvjmUyOVQKJxNcxKBPjkue28eXkD+yfLvPqXe9g1UUb5R4Knoeh6/NPFnXxoTetJnVNC
261CCFOfSf1tTRsGowUHL69foQz22MEDIWp/D/gjyBYhuKcjhgNEX/UIlv2WN4S5ZLuOF98LMBvd09W
262w0vO9vjdngyntUS4fG5yxr6Gcg5bR4ssbgrTHLXI2x7rBwt0pQLMSgR5bCDH236zj7yjubI3hang
263kf4c7/hNH5ZSvHZJPaCJBwzOnx3DMhSO1jzQl+Oj9w/w29fMI2gqFHDurBgtUX/ExtMahZoxgqOU
264P2IxNXoQDRhsHC7wXxtG+ccLOzAr7xscHl4IW4rzZsWJB41qP/TWhXA8jQZ660IsbAyhgLGiy527
265JlnUGOYfLuwAYDjvcH9flqZEgEf7cwzmbFpjfpse3p/lsw8epDVu8aqF9UyUHH65LU3B9vj5dXNJ
266BE1eMifBspw/QvbsYIFUyGRuvT+a1BC2sD1NU8TirPYYhgLb09zXl+GLjx3i/Nm9BE0145gBDDX1
267efs/f+HRQb7w6CFWtER55cI6RvMON2+dYO9kmdtfNZfGiMUVvSnSJRfb02wYKtAdCzIrEaA1FiBe
268Gdkyp++k8vPh1xSxgMGajhhhy/+8Hh/I8flHD3FZT4KQZeBpWN4cZkFDqPIZ+sczvz58Que1EEKI
2692nJS4UUpiAcMbt+R5nVLM1wwK46hqF7gNBrTUHzs7FbOmx2fMR3jac0Fs+M8dCDL3okSc+pCbBoq
270sGGowHvPbK5O0Uy5Z+8kN/x6HzddO4dXLqynb7LMdb/YzcfPaeV9Z7bw7WdGyDuan1wzh4u7EwDc
271uTPNt54eJhbw92q7mo5EgFteObe63Q/f28+NG0Y5mPOntzyt+fCaVl4yJ1k5Bph5KfV/NtTh1w0F
272EcvgR5vHeMPSehoi1ox+cD1NLGDwhYs6WNgYnrHN50aLlGyPN6xo5GPntAFQsF3O+eF29qXL1X0+
273tD9LuuTynlXNfH/TKL/bM8n/WtYIQN9kmUzZ5Z9Wd/LGZX4Q/MA9B7h/X4YDmTJz60L86+X+SE3O
2749njJTTs4b1acf7qks9IvHhNFl9NaItx8XU91n2++Yy/PDhUouxpDqRlTTtP7IWIZ7B4v8Z1nR7h2
275YR3/8pLZtMQscmWXzzx8iKGcje1BT12I717VDcBAxubyn+7k+oV1fHitPxoyXnSw3ZlTSlP9O/Wa
276ozXNEZObr+0hZPkvfvWJIf7psUFG8w4NYZOi4/H2lY28/6yW436GQgghXjxOKrzYnmZhY5iwpfjX
277p4Y5vSWCNe0KZyiFpzVvvbOPgAm2B4mgwXev6mZFS4RL5yT46XPj3LErzXvPaOEP+zKYBlzekzxq
278X5ahiAWN6vYN5Y94hExFufIt/uLuRDW4AFw1L8VLe5IETFVtT7bs8vOt40QDBgVb8/hAjkTIoCVi
279cShrEzQN/uq3+wlV1snbmuUtYW68upuG8LG7p+RqzmiLki65/NvTw/zt2W2Y0/ohYCqyZY9rb92N
280oaDoQFfK4uZrewibCstUbBwucueuNAB96TIDWZsLZx8+ll/vTNNbF+K9Zzbz5ME8t26d4A1LGzCU
281YnlLhLZ4gM8+fIjtY0XOaI/yjhVN/P0FHYStmZftgu2htV+fNMXVEDAUgzmH23eksQwoOppnhwvU
282hU1MNTUBc2ymAVtGi+QdzRuXNtAS8/spFjT50sWdaM1RgaToeGj8c2hKdcrq+falIO9obnpurFq/
283cn9fhoilSAQNPBSJkMk/PzHEd9aPAGC7kAobfO+qbpY1R/7EHoQQQtSakwovZdejMx7gLxbX84F7
284DvDjzWPVqZfpTANMQ6HRWOrw+xd2xelKBrl/X5brFtTx651pzu2Mc1ZH9Jj7m77dqWueoRRFx6Pg
285eMcsxpwKLgBBy79Av/oXe6qFHYmIxQfPaqEhYmG7/kZNRTV8WIY+ahrjSCVHs6o1xPLmCJ9/bJBl
286TdFq+JnOUArTmLlNpRRhS/HL7RPctGmMYMAgGTRZ1R7l7Sv9kZX+rM1Th/Jc2BUHYHFTiFu3TbBj
287vMTChjArWiLccX0vn3n4ID/aPM6/rBumOWrxN2e18Nermme04XjhIGQpNo8UufbmXRimIhkymJMK
2888b6zWgiYCrdSZDt99GVq9MnTkCl7BE1FXcg8atvH6r5jtUPh9/30fSg183MPKMVY0eEtv94HQCJo
2890hq3eM+ZzXSlguyeKIOe6mt/TV2pW5LhFyGEeHE66VsxCq7HNfNT3Lptgm8+NYLjaZY0+bUFnvan
290G7710tmcMytWHb4Pmn7dR1cyyNqOKI8cyPGf60fYOVbiTcsajhkWpi52U5kg73jYrj+KkAiaNEct
291Ng4XZkwRlFzNuoM5ljVHSIVMHFeTCpm88/QmgobCQ7O6PcYr5qdQChzPD2Tfu2oOl845evTn+dge
292vG5pAzdvneBfnhoia3vV47BdTTxocNMr5rCgIVRtY8gyGB0tYruasztjrO2McffuSXJlj78/v706
293SvCHPZPsS5f5+dYJfrEtjas1edvj3r0ZFjaEuXdfhqLj8ZNrenC15omBHN9+ZoRPPXiQrlSQl1cK
294jZ+3/a6mKxng2jObWT9U4KmDed69qonrFtQBUBcysV1/lGaK42lczz+WzniAou3x3GiR82bHq8vs
295HC+RLXusaIkcM8RMF7YM4kGDrO1WXzOm9lMtoIZ4wOSG5Y2MFR1+s2uSV8xL8YHVrdU2Zcouf3NW
296M39TmTYSQgjx4nbSz3lxPE00YPC+s5oZLzmMFBzUEVepSMAgbBlELP+/079Zv25JA0XX4zvPjtKe
297sI57oU2GTFCKiZIHwGDOoeBoNBoFXDYnyRMDOT75xwG2jRXZMV7kkw8M8PKf7+bGZ0erbW2MmHz5
298kk4+d1EHX7iok1curJsxxaMq296XLlf/7J4oMVl2j9Gqw0quRypk8q7TmziQsZkseUddrGNH9IPC
299D2UlV3NJV4LPXdjBf13ZjWXApx48yGTJ3+c9ezOEAwbzG0LMqQuyoCFMMmRw2/Y0Wmvu3j3JVTfv
3004suPD3IwazO3Uvw7WXI5mCkf1dZjKXuauXUh/vHCDm66Zg5nd8T44mODrB/MA9AaCzBZcvnWUyPs
301HC/x7FCB+/ZlqQubxIMmS5vDzKsP8bV1Q/xi2wQ7x0vcu3eS/3XHXt54xx62jxX/ZBtCpkFzJMAD
302fVlu2jzOzvESt26bYP+kTWelYNr2NKmQwT9c0M73r57DW5Y38oNNY9y6baL6+RnKL3o+8jMcKTgn
3031BdCCCFqywmPvGj8Z6pMObsjxuU9SX60YZRC5XXb1WTKHmXHO85WYE1nlJ5UiIf2Zbh2fguzKs/r
304OFJnIkA8aPCvT4/QN1nmd7sz/rYrX8nfeXoT6wfzfPmJIb751DAov25jfn2Ii+f4tSNFRzNZ8pgo
305ucec3vC0puTCX93dVx010UC25PK9q7urBbL+t3sPu3KnUM72p60AruxNsbYjxu92T1KqtK3karLT
3062jpzn5Are4wX/aCysjXCp89v5zW37eHzjx7iTcsauXtPhmvmJ/n2y7qro0qffvAgX3jsEI8N5Hjf
307mS3cty/L3z0wwOcf9W/JLjiaVW1RruidGQa19ttbPOIzmaqFKbuaZMjkS5d0ctFPtvPe3x/g9ut7
308Wd0R5bSWMD/YNMot28bxKsv+9aom2uMBDAX/cEEH77q7j/91xz6Cpj+SZXuat69oZPYRn6un/Tuu
309StP6xDTgsp4kd+6a5G137fPrmVxoCJtcM7+uclwekyWPobxLT9Dk0+e38/hAjvf+bj8rWyKELAOl
310FF9+fJBvrBuqbnui6PKRNa18sVKkLIQQ4sXDvOGGGz7d1tZGJPL8hY2up9kyWqQjEeCKnhSGoZhb
311F6Rv0mZVe5QLZserDzG7al7quA+ci1gGWdsjY3u8a1XTjOeaTNcctZhXH2b9YIGRvMOrFtYRMBVn
312d8ZZ0hQmFjB4WW+S9ngA29W0xQK8YkGKr1zayaJGfxpr90QJQ8E1C+qqD3Cbbqzosj9jMzsZpDsZ
313pKvy31nJIJfPTdJbHzq83GSZy+Yk6U4GeXaowKLGMBd2JQiais5EgP6szXmz4pzZHmVfukzR1Vwz
314L0UqPDM05W2PbWMlzmqPcma7X+vTnQoyVnQZyDo4nh8s3raisbp/8Eeido6XaYhYXNyd4NI5CSxD
315ETAU3ckQ1y2s4x8u7KAnNbM/bU+zZaTI0qYwaztjgB/aNo8U6YgHuGxuElMpGiMWplJsHSsyJxVk
316VVuUC7sSoPwRkjmpEG85rZEPrW0lXHnI4LyGEJd0JwBN2DSY3xjib9f6d4Md+cC9oqPZNlrkzPYo
317K1sP1zgtaw6zpClCyfVoigQ4vTXKp89v4+I5CRT+NJRScPW8FPGgScD027p1tEgiaLCkKcL2sRJN
3180QBzUv5n2JUM0pkIcv7sGGe2x455fgkhhKg9xWKRwcFB1H333adXrFhBff3JPSBOCCGEEOJ/0vj4
319OBs2bJDfbSSEEEKI2iLhRQghhBA1RcKLEEIIIWqKhBchhBBC1BQJL0IIIYSoKRJehBBCCFFTJLwI
320IYQQoqZIeBFCCCFETZHwIoQQQoiaIuFFCCGEEDXlhH8x45QP3ttP31gJrKN/V5AQQgghxEkpubx6
321RRPXL6rjRJPFSYeXW7ZN0Lc/C8f4Lc1CCCGEECclZ9PbFuVVC+tQJ5heTjq8pEImRCwIyoyTEEII
322If4veZqIdXKZQhKIEEIIIWqKhBchhBBC1BQJL0IIIYSoKRJehBBCCFFTJLwIIYQQoqZIeBFCCCFE
323TTnpW6WFOGUpoOyB7Z3ceiETzBfBQxcVUPLA8Q7/HDLBOMaxaQ1FF3Tl55B5+MGTjoaSe+L7tQx/
3243dK07QUM/8/xHLl/S0HwJJ4dpfH351U2oICwxQk/4UoIUdMkvIgXD0dz/twkK1siJ7XaXbsn2Tla
325PPZFvpY4movnJVnW7B9/0fH4yZZxciV35rF5mrqoxStXNBELGGgNd+xMs2+8BPB/2HvvOLmO+8Dz
326Wy90nJ7uyTkPwiAMMkAAjCBIkCAhJlGkZK/XH9nn9Z4tW7rzab3eldfWyrer9cn22bKtj85BliXL
327SpaoQFIMyIHIGRgMJuecejq+dH+87p4ZYEAMQFIEoPf9g8R0v+qq9+pV1a9+qVhc4GFHTfaCq700
328EufqeIJnFwUzssix/ihHe6bnf6YmeF0yH1uZR3Yq2WX7RIKftE7ZQsnNusECRYaX1xWQ47HLR3WT
329fzo/hm5YjgDj4PALgCO8ONw7JE3+/fJcfm1V3i0V++Ufd9AyFLv7hRfN5NdX5fGJZbmZj7JdMl86
3302D83I7ZpUexX+fLjFXhTGqfucJLOoRhYsLXMz19uL19wtT9snuR33urhL7aXZ+SGfV3TPPKNZqz5
331hBHNYGttgH98qirz1Z8eHeInTRO2FudmJA221Af5+tNVc366N6zxetOEk0DTweEXAGeUO9w7CJi+
332VZMRM1aWux4B08m5N/Of7iuivthnm9NmYVgW4zEdsC0vybTGQkDCsLgVDMuiZzjGdy6PZz5bWehl
333cYF3/ocrBNurAxnBI5w0+dfL47YpaQFaFyTB80uuPwPlE8ty7M9urfkODg53IY7mxeGeZSSq89Wz
334I4zHDOQb+LRICM4MRWe0Llb6P6m/08XMWSuiEAtbZK20P8YCrid1/bUL70LL3oACn8Ln7y/hEz9s
335t+/hFrVLmmnxj+fHaB6Jo8xzGKsiBBeGY1imxQ+uTvKxBluAyPXI7KgNcKUvAuqsAoZFIKDOMUsd
336749wtj/67j4ymfImRSEXzy4KXvfVY9XZ1BZ6aR2O3fy30v2cft4CFnSoyux+hdt4FxZazzXvwkLK
337Xdu2hbbPweEuxBFeHO5ZRmMGf3p0iImJxLubI2Qx12E3vbAJYS/4hoVQJVRZoJkWlmba380nEFkW
338aBYoAlWR7OKGmflsfh8Qy3aSdUnIkkCVbYWFblq287FgYeaUG/DxZTl8q2mcH18Yu+UDVXXT4mvn
339RjlydeLGDrWS7Wy7v2uatokEdSE3AE/WZPOVk8O2Vid936bF6kIvq2b5JX3/ygSGbi7M3GPCk7VB
340KrNdAMR1C7ciEECxX+GZRUH+bCj67r4zuml/r0ioqsCysH1lkgbI0vz9mu4jRSDLEpJkPxtLS/3W
341fMKSlapLEiip73XdzHw2bz26Zb9DioSiCCRhX26aqfYp0vXvkIX9nsgCoQhUSaReWwsrrXFbiGDo
3424HAX4QgvDvcsQoArLZjcKJpo9o5WM/nkugIeqMjCNC2+cXGcAx1T/IeNhTxVH6Q26KJzSmN/zzT/
3433+kRhqaScxeFlOnl+RW5PF4TYGOJn6hu0jQa50D3NN+8OIaeNK8r41Ylnl8e4mMNORT4FMqyVEZi
344Ov3TGgd6Inzj/Cj9U9pMNNBt8N/vL2F/5zSTUe2Wy7oVaQHRQ9A/nmBv13RGeLm/Iov6XA+XBmZr
345tiyeXRTMyBXjcYOftk0tzIBtgaxIvLxsxmT0naZxcjwKu+ptTc4nluXy5ZPDJHVzfk1FwqQ838Mv
346L89hVaGX5fkeYppJx5TGj1smeOXKJOG4PldY1G3B4GONuTxUkcXKAi8hj8xgROdQ7zTfuTzOpYGY
347XWa2ps60eHxxiKfqstlc6seyLJrGEhztj/D1c6NMx4y5z1QzyQ+ovNiQwyOVAaqCLoJumcGIRu+0
348xncvj/PTlin73uQZYRALHqnP5vklIZbmeagIuJhKGEzEDXZ3hfnOxTHaxhKOAONwT+EILw73LLbC
349IqXtmEfjIYm51iB0k521AV5YkgPYvh+/vDyHTzbOOAAvyfPweE2AZxcFef77bXRPJG2hwrAIuGX+
350n+1l/Maq/Dn1bC3z82uNeTxZl83vvdVLz0QSVLtyv0vib56o5PdJgEoAACAASURBVFdW5M4pUx20
351NQu76oP80rIcnvu3NtpHE7ckwExrJlmpBWtVoZff3VDA53f33pLpyAKmEgZEdVs4u5ZrhJrvX5ng
352k415CCBLlXi8JptL/RH7S9Miy6eyrSqQuf71tim6xxMLa5NmsK4qwNYyf6ptFv9yaRxFgqfrsxHA
3536iIPD1cGeOPK+FwtU0oL8uzyHP7nI2UsyXXP+emNpfCxpSF+vHSSX/1xJ2Mx3RYQdIuSbBdf3FbG
354v1s+t49WFsD26gD/YXU+v/5aFz+9PG5rpwwLRRZ8/pEyPrOhEM8swXljqZ9fWZHLM4tCfOaNbi4N
355pUxcukl1roevfaSah8r9c+pJt/XjDTl89cwIv/NGt+2XJOz7+k9bi/nj+0twzyOgP1YT4NdX5fHx
356V9o53h1xBBiHewZHeHG4ZynOUvjKjgoimok0zy5clQR7usL81Ykh0lvmuD6zQH+yMRe3LNEynuDC
357SIzGAi+1Ka3C+mIfv7GmgM/t6QHLFl7+89biOYLLGx1h4rrJQxVZBN0yLy3NIeCS+dj32ojoJhgm
358n9pSnBFcLOBQzzTdYY2aoItNpX4EtuDxv63O5w/e7AYWbvb5acskWS6Zp+psrcRn1hfyg+ZJzneG
359F+wGoUiClxpyWJXntk0q13BiIMr5/oitdZAFB3ojNI3GacjzAPDsomz++vgQWsq0sakmm6Wp7ywL
360Xm2bxEya4LnJfaW65SOLQmSp9rVtE0mO9IRxKTLtk0lqgy5kIfj4shBvXZ2wBdP0jeomy4p9/N1T
361VeSl6ppMGJwYiFLiV1mWb7dpV32QL24r439/tQvNsJAF/MnDpXMEl9ODMaaSBhtL/HgVQbFf5WtP
362VbFtMsn5gSgY8JsbC/n9+4pmoq+6pxmL6Wwpy6LIr/B4dYCvfaSaJ751lbGojiQJ/uD+Yh5MCS4n
363BqIc6YkwGddZXezj6Xrbx+c3VufTNpngfx0YwLJg26IgX3igFEWCkZjOz9rDtI0lyPHJPLMoSEXA
364RV3IzT8+Vc3D/3KVkWnt3shp5PALjyO8ONyzBFwyu+qvd+ycjYXFXx0fYr4QFbcs8e2mcX7vzR56
365JpMsKfLxoxdqWZzaCT9RG+Bz+yVbI1AZ4FNrCwDbyfWze/v4y3cGMU2LbXXZfOuZGgp9Cjtrs9le
366n80r58dQvDLlAZXusEa2S+J/Hh3kL48MEk0Y+DwKf7+ripcbbC3Q2qJby10DMBE3+L+PDLK13E/I
367LRPyyPzJg6V85FtX0cx5tCjz4JIEn91UeMPv//jgAOc7whlfjOmwxr81T/BfNhcDsKbIR2OJj5Od
368YZAEj1YHMpqIrnCS3R3TC/PnMS2CARcvNYQyH73WOkU4omNZOm91TGUEx6fqgtQUzHLctbCFgy3F
369GcGleSzBJ3/aybG+CPlumd/aVMgfbC5GAC835PAXJ4a42Bnm0RV5/NIsweW/Hejnb44NMW2YbKnI
3704utPV1MWUMn3KnxiWS5/0DVNbakvI7gYlsWfHh3i83t7iekWa8v8fOvZGhbnuNlQ7OOl5bl85dAA
371gRw3T8yKwPrs3l72HB+x/YD8Cn+1s5Kn6oKcHIgyGDFsASRhsL06kJEpd3eG+XffbMZK+Rj9sDGX
372Lz9eyUhU51h/BM978JtycLjTcIQXh19o9HdZxHunNT67t4+e0QS4Ja70R3ilZZL/a6O9mKdNMmgW
373z9QHyUo5nB7ujfAXRwbs8GRJsPviGP9cF+T/TJV7vCbAK03jGBb87ls9/P6+fqqyXVwciNiOl4pE
374NGkwHNUzbfHIkq35WEgStxR+l8S5rmn+/PgQf3x/CQC76rN5dkUuh3um35eIYt2cFd4sAMvi9bYp
375PrO+EJ8qke2WeaQyi5NtU3j8KjvrZqKM3u4I0z+xQF8M3eSpuuyMP41uWnzr0jiWadf5zYvj/OrK
376PFySoMCnsKsum78YitplDZOqfA8PVWRlfu4rp0c41DwBXoX+qSRffGeIbJftX9IykWRgWoeU1kpN
377mbRODcb4H+8MosV1kCV2X5ngD0P9rCzwcnEkxunBGJYFD1cFKM2yQ6yaxxL80cF+ElHbj+bU1Un+
3789vQIf7atDIFtdvrKiWF0y5pjwvyjrSUszfFwcjDK6YEYn3qti09JtoYPOWUGFTA7EP3hygD/6yPV
3797Oua5tRQjLdbJmnouATGLAdzR+vicI/gCC8O9ywDEZ0vHB5gOKrZvi/XIAtB60TihuGkreMJhiO6
380vfsV9oKRzo0CaX8ZezEpC8zEA3sVwQvLc1ElgRCg6SZ53pmhtrLAi6RImIaFYcF0PEmXZXF/dTZb
381y/1sLPaxNN9DbXDGL0NNR6fMm/VtfoQAFMGfHxvixSWhTObdL9xfwm/8rIv4AhLc6KbFNy+N0zKW
382QL1m4XPJgr3d03OFD5fEO70RzgzF2JLyTXlmUZAvvTPI6pSDbJrvNk1cF9k7LxYIReLFpTmZO78w
383EqdrSiM7SwUBTWMJLo/GWZW6x19ekctfnxpGM6xMUr5cr611iekmJwaitn+KLECWCScMfufVLnuh
384l4R9T4qgJujO1HmsL4KupRyuhQCvwj+cHrGF1HREmCKoCLgyTVeE4IXFIUwshBBouknlrHdlWZ6H
385LJ9MeFrnB1cn+d31BQjgwYosHqzIYiJh0BvWONA9zSstk+ztCBOPG+ASIEu82jLJp9cW4HdJFPoU
386fm9TEZ/ZWET3VJIrY3F+cGWS1zum6ByO22282xMxOjikcIQXh3uWybjBNy+OvXuo9I1CVoG4YWFc
387kzjturnfBDll/kmzscTP956tuWG7qrJdyJLA1EyQJT5zfwm/viqPZXmeOdfNThZ321oSWRAOa3zu
388QD/fe7YGWRIsL/DwnzcXzesHdC2aafHVM6Mcbh6fP8w6vdCnEQI9YfLjlsmM8LKp1E91roedddko
389qTrPj8Q52h9dmCZAM1hRlsXDlTOakxK/yr8+Wz07iIli38x01ljo5bGabF69PA4WFHgVvKl3IK5b
390hJPGXBkwJejhSv2GaSEkQVVwRhCZyJz3NPuFwPbXEXYZZGlOmUW5br75keob3lpl0I1flQibFn9y
391sJ+qbJXnFs+YxkJumZBbZnm+h99ck8/erjCf3dPL8R47L87hjjC//VYPf/5oGaFU/8jCdviuDrrY
392UZNN/7TGnx0f4s+ODmFa1sLyzDg43OE4wovDPYskwKdKTKjSbeVJiWqmvXN/NwSYhjXH0ffiSJy9
393HWE7MV5qndANCxPbh2QkZmCaFrIQfOHhMn7/PtucFNdN3uwM805PhNdaJnlhWU7Gd+Q9oUj88PIE
394/7pkgl9abvvQPF0XZIFuL3a4uSLN67A7rxJIwCtXJ/nc1mJ8ioQqCT61Ln/OmVM/bZlkfDJx87wz
395lv2Du+qDBGddW+RXKPLfePpSJcFzi0O81jyBpVtEdRPTsp+5SxYZE991xFMCiiKwJMFkYkbTlj1v
396mVQiFt3KmGVis7I8d04m+UnLJLI0611I5W1RZEHCsIhrFqgSI2GNj/6gnR212Xx8WQ7rin3Uh9z2
39780/xcGWAv91RyfZvXWUibp9Z9bWTQxzujfDy0hBP1GazKMdN/ixBriRL5U8fKaN1IsEPL45jqY7w
3984nD34wgvDvcslmWbCN71lOlUuvn5NACaaWHdzK4hBFZMp3d6Jn9K02ic3/5Rx4yPQWpHjsRM0jkh
399WF3u5//YYDv56qbFr7/WzTdPD9vfxwx23MTZeMHIgG7x3w72s60qi5KUP8ZCLQgi/Z+Frnmy4Opo
400nN2d0zyd8nH5zdX5GRNRXLd4tW1ywVmH3V6FlxtmTEa6adn9Og8+VUJOaRaeWxzkC3keOvujDEQ0
401xuMG+V4FnyJRE3RxMG0CMixkVfAXj1UQcMlcHI7zevsU5/sitE0keSB1zNPSfE/GrwchIG7wXGMe
402Ly0N0TmZ5Gh/lH+7MEb7ZDLTnr5pjU+91mU70WbehdR7kU5w55KRZNsMJAvY0xnmtaYJ8oMuGgs8
403LM3z8FJDDg9UZCGAlQUeVpX42NcyheSSkF0KHZMJPn+wn88fHGB1sY/FOS4eqsriV5bnZQS1nbXZ
404/PDyxC35TTk43Kk4wovDPYtLFizN8zCgSkjzaQ0ASYLphEn/9PXJ2xY8vwth+1CkeLAii7V12Zxq
405nQQEwqPwg+drqQm6ODcc4yctU3z77AilWa7Mrtq0sP1HUpEiSsjN47NS6L9n51pFonUwyp8cGeDL
406j1W81197dySBHtd5tXWSp+rs/CveWZqvc8MxjvRGFqYN00x2LAllQpkBPv12L989P3q9o69m8sKK
407XP768QoEkOdVeHFJiC8NxOieSNI6kSTfqyAE/MbqAl5tnWJ0LGEneavL4bfWFmT6/MpYnPMdUxwb
408iPIrK3IRwJbSLD66LIfvnh4BC9w+hU+vL+TBCts89qOrk/zg7AjnhqIYtt81jQVedi4N8dNzYxmf
409k7/bVc2WMj9nh2K83Rnm70+NsLYkiy88WMKiHDdeRfDyjzrYf2mc3cMxdicMjvVH2f+JRXhT92ym
410BOL/8VAZj1UHKA+ofO/KBL/1ow7OtE1yxrT4ztkRqgJunkol8BPOUQEO9xCO8OJwz1KWrfKdZ2rQ
411TOuGWgZJCN7sCPNrP2q//YpUie9eHufT6wtYWeClwKfwjaer+MvjQzSNJvjEilyeSZ3F01jo5dW2
412MOgWXVPJzCbYJQv+/NEy/nBfHz5F4tObCnlklo9HerNumNzeApRyKP370yM8vzg0J1HcB4Ii8bP2
413KYajOoW+udPM95rG0RPmAs4fsrUULy4JZRRjfdMaP7w6kcpufI3JyTD5dtMEv39fMZXZtnbpY0tz
414+PLxYSbDGv/viSG+uasaAdxf7uf1l+r5cfMkQY/My8tmNDtnh2Ic7LZDuL99YYzfXJXPygIPHkXw
4151ScqebAiwOBUkm21gYzgAvCty+NYAva0h9nbHWZ7VQC/S+IrOyr48xw3Jwei7KwP8asr85AFNOR5
416ON4fhaTJYERjXZE3Y+758mPl/HePTHdEJ8cl8Usr83CnnlfHpMalkTgkDTyKYHWRFwH8WmMew1Gd
417N9qmEALWFvtYV+LLtO9A97T9Al373Bwc7kIc4cXhnkKdJaWokpjjSHsjakMzDpazy7vmMSXNjlrK
418ZDSVIRzR+f29fXzn2Rr8qkRDnoe/faLyuvJ/dnyIb10YBY9My3CM71+Z4KNLbAfNF5eEeGFJKJMp
419v20iQXXQhSQEtSE3NSE3LcOxd7X3zLn/a9svC+IJk/96oJ/dZVl4Utl6r01ALM9y6PQo0u0FqMgS
420bSNx9nWHeTGVsRhsM97r7VPXHyA4H7rJ0mL/nFw9ezrD9I0lUk6y196fxNhUku83T/CZ9bY5bkOJ
421j8fqsvnxhTG+fXGMzaVZfGqdnQ9mfbGP9cW+OT8xFjP41Js9jIU1cMuMhpN8+u0evv50FWVZKiG3
422zG+vnZtBGeAvTw7znYv22VFJzeS/7Ouj8aN1FPoUygMuvvRo+XVlvnFxjL85OYTllugei/Orr3bx
423z09XkeORWVng5TvP115XJqKZfHZPL6NTGqgSXzjQz+IcN0/UZuOSBX+4tZg/3Hq9n9S/XBznuxfH
424sW6ggXRwuNtwhBeHewcBo3GdgYi2sBBc7PWve0rLlB+O2eUBBiP6NRfbid/S3/eEZ5maVIlXmyd4
4255vttfG5rMSvyPeR6bBNFRDPpCSf5yukR/urEcOpQQEFcM/mPP+tmMm6wa1GQvFQob29E5+/OjPD1
426C2N8fVc1dSnhalWhl5aB6I1HrbCzrKbbN3xt+1PtPNIR5kvHhvhkYy4ilTokps9EVU1rM/cY0037
427u1sl5RvyzxfG2VqWlTlC6u2OMJeH4ws89VlwX6mfpGkxENEwTfv4Actk/oiZ1EGa378yzkfqs/Gr
428EpIQbC3385PmCUzD4jNvdHFxJMan1xdQ6FPJ8cropsV43OCdvgh/cmiAY13TM4dEumR2X53kiW+3
4298vkHi9lU4ifPq+CWBVNJg/5pja+cHuFvTwzbDtCSAFVwrGuand9t5Y/uL2FjiY88r4wsBDHdZDCi
4308/ULo3zxyCDx5MyBnT+9PM5TMZ1PbyzkgXI/+V4FVbIPAx2LGZzoj/KnxwbZ1x7OnKM0HNF4+ZUO
431PrW+gF9ekUuZX834uEwm7H78uzOjfPX0CFHNfE/nYzk43EmIPXv2WKtWrSInJ+fmVwON/9DE+d7I
432wk6AdXD4eWJZ5Prs3bG5QOlFEoKIZjI4rQEWBX6VbJeMBUwnDYZmJYrDgpBHJjeVsyVhmPTOFmBS
4335+cIl8TyfC+1QRduWdA3rXFhJM5kOjX7bFWGboEESwu8LM5xE9VNTg9G7Z01UJLjxqtIiJTgNBrV
434b2w2sizyfGomKiecNGwB5rrwbguXIlEaUBGp1DGDEZ2YZkfaZLllCnwqYCdOG4zoxDXj1kNsLQtZ
435lqgIqCl3D8FYXGc8qi/YW7jIr+JXJSwsTBN6wsl5j1iajSSgNEtFle3TppOGRe90SqBNnQ7t8ynU
43657ipzXET1006JpM0jcTtUKD5BKvUwl8ZdLM4103AJdM/rXFpNM5UWJv/xPBUmSV5XupyXGSpEoNR
437nYvDcUamkte/C+kysqA6x01djpsct8x4wqBjIkn7ZAIzYdhmn9nFUrlsAn6FZfleilNRWF1TGm0T
438CSbDmpOgzuHOJqrzR49X8LktxTedGsbHxzl37pwjvDjcY6RO8124Y4g1k310TnnmP9Bx9vfiBgtC
439+hpj1u/Mt1DNagKGmTqVWsxdaAxrxsRygwMmb9i+d7vessCY9fessO5MexAzic1ud92zmHWgo7Ww
440e5jN7P5caFvSQkq6Wokb92P6gMN0H72bgJb+3XSf3Kxf02UMc6Y9C8l0m35mpjUT2SRx8/al2za7
441/2/WPgeHO4HbEF4cs5HDvcWtLo7XroQ3K7+Q309fs9DRlXKmnfd6WVzfxoXUfdM636V96fa8Hwhm
442mSpuYxG95f5MVXMzLcOt9tHs370VDcbtPMvMM7vF+76dZ+XgcJfiqE8cHBwcHBwc7ioc4cXBwcHB
443wcHhrsIRXhwcHBwcHBzuKhzhxcHBwcHBweGuwhFeHBwcHBwcHO4qHOHFwcHBwcHB4a7CEV4cHBwc
444HBwc7irenzwv7/nIW4f3lflSPejC6ScHh58XinX9OHTG351Dum8MAeaH2pJfDCQL3ufzQN+z8CIL
445cMkWluUkR/qwEcIiaYq56dNT//73NUnKPCZJZ6A6OHxgpBMA/1O3i4GYZE/aOPPknYIQFoYl7HnQ
446FDxVqrE2aBAzblrU4TbxybBvVGb/kIolv38S/HsTXjTBQyUa/3VRgindGZQfNtmqxRdb3PysVwV1
4477kuyq0hjddAgajj95ODwQSGnMvn/eFBlIJr6UBdsKdT4b0sSTDvz5IeKT7Y4PSXz+xc8WAY8kKvz
4488TKNSadfPjByVYuw4Wb/AO+r9uU9a168MpR5LPzzHGDr8PMlpFr4bvByhHXBhCaIOcKLg8MHhpQS
449Xq49PNKTmiennHnyQyVLtuiOzXRO1BCMa4KwI7x8YAgg/gFott6z8GJakDBxzBF3AAlz5kw2BweH
450OwdnnrwzSAjQnDnynsCJNnJwcHBwcHC4q3CEFwcHBwcHh7sUVVFQlPcncPhu4o6/YyEEQsy1R1qW
451hWVdr/tzu90AJBKJ91SnJEnX1SGEwO12YZoWyWTypm12u11YlkUi8e7XOtw6QghcqookS2DZAVVa
452Molh3rpOXlVVADRNe59bOYPL5UKW5dT7kMi8V0II3C4XQpIwDJ1k8oNrw52KEAKXy4WmaZi30X8O
453N8eeQ8G8xqYsSQLLmnkPdUNH027slJOeh+ebexeCZVmoqoJLdZHUNHT93nAAUhUFRVXsiUiArhvv
454y3zicrkwTfNdn5NlwdDwCEIShILB91zn3cQdL7yYpnndYLlWoBFCoBsGR4+dwMKiccVyVFW5brAu
455FF3X59QhSRKRaJSjx0+SnR2gYcliYP5BLEkS0WiMYydO4na7Wd7QgKLItz3gHeYiyxKGYXL67HkG
456hoYAUBSFlcsayM/PwzAW7hkmyzJt7R3EEwmWLKp/3xdPIQSGYXDm3HlGRkbxeDysblyJxzMjZJ86
457c5bw9DSF+QUsWVyfEZx/ERBCoGk65y5cpKK8jLzc3FvqP4ebY1kWhmkizbMJNAwThGByYoJLl69Q
458WlpMbXX1vONAUWQMw8Q0zet+Z6Goqkp3Ty9Xmluor6uhqrLiru5vSZKQZZnOrm6uXG0By8K0TGqr
459q6ivq8U0599kL/S3L11uwuVyUVNdNe9zkmWZyckpvvfKj3ApKi999Dl8Pt8vzCbgjhZeFFmmtb2D
460g4ffQdN1DMOWaDesW8OmDesxDAMhBLIso+k6Z89fwLIsljcsxeVSEcLeXWDZg1gIgTlLoyKEmKNl
461kSSJ/oFB3nx7D5WV5TywZbP9+5LEdCTCoSNHKSkuZMmiOhRFzZRLCzqmaSJJEolEghOnzpKdHWDp
4624iW4XPbu3rKsX5gX64PAfrZJdu87wJXmFvLycnC73MRiMUpLiqkoL0M3DLRkEt0wUBQFVVXRNC21
46361MRQmT6rLunlx/99HUali5hdeNKotEoQghURUFIEpZpouk6pmmiqiqyJGGYBpIkI0RayLUnMMs0
464SabqSZOuq+lKMy2t7Xi9HgoL8llcX4dpWQyPjrL/4BGisRjLly7NCC+KLCMke4HQdSMjTLtcKli2
465QC8rMpYFuqZhpBYUVVXt9x1SY0XPPDdVVRBCshcfu3Ekk0ksy0KWZRRFSb3DM+XS761pWsiyZNen
46668iyjCRJmfGYqSP93CwTTbOfm6Io9sKnG0iSlNEy6bqBqqocOHSEU2fO8vKLL+Bxu4lEozi8P8iy
467zPR0hJ+9vZtYLMaTj28nPy8PgIHBId54ew+F+flUlJdy4PARVq1cQW1NTUZLaFmWLfRIEuMTExw4
468dITFi+pY3tBAMplEkqTM5tKeS21NTnqOkyQpMwbS79nA4DAHDh/B6/VQW1N91wov9r1aHDx0hOOn
469TuP3+wgFg4SnI7hdLupqa5CEQFYUW0OMPY7SGkZ7blIwDHs8SrKMaZpomobbrXKp6So/ef0NHtiy
470mWVLlzAdidhzkCwBAtMw0A0Dj8fNqhUr7N9UVWRZxuVSrxlvM+N0Zp6w173Z7VEUGV03kCUJ0zIx
471UmM0PRdpmn5H9dcdLbyI1AQ7PDrK0kX1VFdXoWkaRYUF9gOXZWLxeEogAa/Xm3m4UmoSjcbiCEgt
472Yrq9OChyZidhL1gSXq8HWZbRdZ2x8XFyc3Mz7dANg9xQiJ1PPIbH7UaS5Iz63+12k0gmMQ0Tr8eN
473JNmCjMfjxu12ZV7yWCyGaZp4PJ7b3rn8oqMoCh2dXVy4dJnKinI+/uLzeL1eRkbHSCaTHD56nOHh
474YdasbqSkuJj2jk7Onr/AigZbK3P85CmmwmH8Pj+VFeWcv3QJ0zTo6e3l1dffYMt9G5FlmSNHjzM4
475NERhQQHr1qzG43Fz8vQZxicmKCspobO7GyxY1biC4ZFRWts6KCrMZ+3qVaiKgnnNbktVVXJyQgC0
476tXewuL4OgKamq2RnB/B43KiqgiRJJJNJ9h8/ydj4OKqisGJZA7U11YSnwhw8fAS3200oFOJqSyt+
477v4+1qxoJhUIkEgneOXaCoZERFFmmYcli6mprMhPU4XeOMTwyQmFBAbIsE0/EWb9mNcFgkJGRUU6c
478Ps30dISa6mpWrVxGPJ7g0JGjKIpCIJBFZ1c3Ab+flSuWc/lKM6NjY9RUV7G8YWlmnB49foL+gUHy
4798/JYv3Y1fr+fi5eb6Onppba2mp7ePsJTYRqWLqG+rpaTp89wpfkqsiyz/9BhxsfHWd6wFP0OmiDv
480ZkzTJCvLj9ftoaWljeGREQry8zObtJ6eXhbX11FfV8fTTz5BXk4ILIt4yuzuUlUSmo4sS5w9d4FL
481l5soLytD0zQMwyCeSKDIMoosY5gm8YSGnBZihSCRSNjCsiThdbsRQqAoMj6vB/Uu9tGwBTWZU2fO
482cuT4Ceqqq9jx2HaCwWxisRjhcBgQGKbF+UsXaGvvRAioKC9j1coVuFwuenr7uHDxEuXlZcRicXp6
483e6koK2Pt6kba2js5evwEsiRxpfkqhqGzfu0aTp05R2dXF0IIaqurWbG8ISMsKoqCLMtcvtJMV1c3
484tTXV9PT1MzU1xdLFi6ivq7UtFLrO0eMn6enpJRQKsnbNanJCQa40t9DW3s7SJYsYGBzC7/OxeFE9
485x06eYnBoGIDGFSuorrpztGV3/BskhEASgpqaKrZs2oSu68TicQzDoL2zi917DzAdCVNcVEw8Hsft
486caekfTh24iQnT51FSIKy0hKGhkdYtnQxD96/lcnJKQ4cOszV1jZcLhcb1q1l/drVKeFGSUm4NpIk
487MRWe5sTJ0xQXFVFdVcnBI0fp6Oiktqaajq5uYtEoa1ev4r5NGzKSqiQEqqpw8vRZjhw9xrKGpTy4
488dTNySsp2uDUsy8LlcuFxexgdHeWdYydYVFdLSUkxhm5w7sJFjp04RU5OiIryctraO7ja0sqSRfW8
489/uZbjI6OUVZWSjQWZXp6epbmze6LRCLB/kPv0NvXR1lpCRcvNzEVnmLH9kfp6unh8uVmqqsrkSWZ
490zq4uOjq7KCosYGxigpbWVoLZ2SxvWIp5jY3aMEyyAwFcLhcdXd2MjU/YKvTuHoqLChgZGcO0bO1J
491b38/IyMj+LxeBoaG+dlbu3n+madxu900X21lbHyCRfV1aJrGpaYrRKYjPPXkDoaGRxgcGsLj8TAy
492Msobb+9hl9tNZUUZb+05zLnzF6isrKB/YIDOrm78fh9rVq1idGyMV37yKpZlkZMT4uCRdzANnaVL
493FtPc0srExAS1NTWEp8NcunyFts4uckJBevv66ento7iwkNzcHN54azfdvX2Ul5XS1HyVyakpnn5y
494B/0Dgxw/dZqevn4KC/Jp7+yip68fn8+b2RmmtZbpfnB4Q2ni3gAAIABJREFUf0hrk+vqamhqbqar
495q4elixdjGAZdPT1kZfmpraliZHSEY8dPsGJ5A8XFRbz+5tskEknqaqq42NSM3+dleGQUv9/PgUOH
496GRkdoaK8nD37DrBx/Vru27Cezu4efvLaz6ivrWH7o4/Q0d7BG2/vJhZP4HK5uH/zJtasXgX3wMZN
497CEE0GuPCpcu4XS623LeRQCCLWCyGEIKcnBwMw2DvvgNcbGqirLQEy7LYu/8gExOTPLbtYSanpjh/
4988RLNLW3UVlcyMjpGS2tbZqMjhGRrtizbtDc+MUFvby+KohCJRNm9bz+qqlBRXs7ZcxdwuV2sXd3I
4990NAQJ0+foae3j8LCAjq7uunu6cXn9VJeXsae/QdpvtpCZYU9P46OjfPsrp2MjI5y7sIlRsbG6O7p
500ZUXDUgaGhrh0+QqVFeXohsFUeOqOOuHizo82EgJFUTh+4jR/97Wv8w9f/wadXV1EYzHe3rsPwzTZ
501sX07paXFTIbDKeleoaWljUNHjlJeXsoTjz2KaZiMjY+nzAAGew8cpLW9g507HmPVyuUcPHyE7p5e
502FOX6LG9CCAzTLm9L1baD6MjYGOHwNPdvuY9AdoCjJ07R1z+Q8fxWFYWunh7eOXacYHaATRvW4XKp
503juBym+i6TmlJEQ89sAVVdfHm7r18+/s/ZP/BwyQ1jWVLl5CXl8vQ0DATExP0DQxQXVWJ3++jb2AA
504t8fD/ZvvY+cTj7FuzSo2rF2DYZjU19byzNM7GRoZpfnqVRoWL+bpJ3dQV1tDa3sHQ0PDeNwevF4v
505D2zZzK6dTxDIykJRFXY+8TiPPPQAIOgfGLR99q5zMDdxuVRqa6qIRCIMDg3R09uHbhgsqq9PXWOb
506FMtKStj+yEM8vn0b921Yx/T0NF3dPfYOV1EoyM/j8Ucf5qPPfYTS4mL6BgaZmpqiuKiQbQ89yI7t
50729i6eROJRIKenl7GxidovnqVJYvq+cSLL/D0kzvIy8tDUWwz2KWmJoZHR9m4YR07d2wnJxTi8pVm
508ItEobrc9ke7csZ1HHnwABOTl5PDi88+ydlUjkUiEsfEx+vr7aW5pY8niep5+8nEWLaqjrb2DwcEh
5093C4XHo+Hdasb+dgLz7JpwzrC4TADg0Ns2rCeyopyLMvi0YcfYt3q1Y7W5X3GMAwqykopKiykq6eX
510SCTC5OQUvb29FBUWUFRQQCwWZ2x8nEjENtlpmkb/4CCnz13ANA2WLK6nrrYGTdNpXL6M9WvXoGsa
51109PTaJqW8e2KRKIkEgkMXSeeSHD/ls187IXnKC0pZt/BwwwODqHIMvMfvnb3IAlBLB4jFouTHQgQ
512CAQyZpm0qa2/f5Dzly5TXVXJx154jpc++jxLFi3i/MXLDA2P4FJdKIpCfW01z+x6ih3bt6EoKp3d
513XdRWV7G6cQVJXadxxQq2PfQAOaEQW7fcx+Pbt/HQ/Vtxu1y0trXb2n+PG7fLBdimQrfbzZpVK3nx
514+WfYvHEDkViM4dFRhoaGudx0heqqSp7csZ0Vyxvo6emlt68Pt9sOKtA0jec+8hSrGlfS1zeAZVms
515XrmC5z/yNEsWLcK8g8bnHa95SePxuAkGg1iWicftZmBgkPGJSR7cupk1qxsZHx+npaUN0zCwLIv2
516zk5UVWHj+nUsrq9DkiTau7oyTk49vf0EsrKIxmJoukFS0+jo6qKupmbe+gVkbP1gO5b7vF42rl/L
517ovpahoaHGRw8xvT0NMHsALIsMzE1xd79h/D5vDy54zGCgQDJDzCq5V4nvZNcs6qR2upqLly6zIVL
518l9l34BAul8qGtWupra6ip7ePto5OJiYm2XLfJspKS1m1YgUnTp3ha9/4FxbX1/HIQw9m1J+maZJI
519JAiHI0iSxOXmZi42NaHrBkLAVEoolmUJj8edaYfb5cr40aTt/9zAQc8wDCrKy/D5fFxtaUOSJHJz
520QxQXFWLodjuEEPT09rFn3wGisVjGDyW93TEtiyy/D1dqonK5XERj9oIzODjMG7v3EJ6eRlUU2/dG
521CCYmJ0kkkhQU5GeiSoLZ2YyOjdoLznQUWZLZf/Awe/YdQNN1gtkBYrE4YEcCpSOypJQ5VAiBJEup
522RcskHI4gJEHz1VaarlzNPNfJcBhJsp9NdnY2hmHgdrszvjeapmEatiCvaRraPRJ9cidhmiZ+v5+a
5236kreOWab9XRdJxqNc9/G2kyEpixJmbkt7Q+xcf1aGlcsQ1VdxOPHMU2D0pISqior6OvrR5LljKCe
5249j0UkoQsSbbms6OD0dFRFEUhkUgwFQ4j3QOaFwvbHzPt36jpOv7U+BcpH6FwJIxpGpSVlmT8fgoL
52582huaWE6EoHUsM4OBmx/PJea8TXSdd32c8OeN3RdZ2Jykrf37mdoaBhFUVJC4/W6Bwsy4800Tdwe
526N1JKs2nXK+jq7uGrf/9PGIaBhcXkZBiREihXLl/GyuXLMQyD1atWsnf/Ib7/yo8pLSnmoQfup6S4
527yDEbLRjLwjAMljUs5b6NtpOuaZh0dR+3fUjcbrujJQlVVbGw0HSdSCSKLCu4VJWkpuFKOVyC7cMi
528BERjMU6dOYtAUFpSjM/jyUz6MBPVdCMflfRLmUg5Ps6+VghIJm3bsDdl472TVG53I0IIorE4LlWl
529qLCAyopyXKrKa2++xfDIKAhYvKielrZ2zp2/gN/vo6qyHNOyeGDLZtasauTE6TMcPX6CgoJ8SoqL
530MxoPt8eD1+NGNwzqamtYt2Y1lmkSjcXIDYVoaWsH5ka/pcvOdgC/EYZpEgoGWVRXy8VUFMHG9Wtt
531HxlsZ8ZoLMaBQ0dQXS4+sWsnLW3tHDh0ZM7vmKaZcQy3LAtZkkkmNQ6+8w6mafDyR5+jt6+f3Xv3
532A/YkK4RgcmoKSZbQdJ3w9DRgC2OqS8UwDTasXUN9XQ2JpB3C6vN6MAxjjlNm+p5npxGQUuPOMAxq
533qqvYsG41WBCJxsjLy2VgcNC+/9SmIq11nP2s7HpsR0JHuH//EUJQXlaGqpyho7OLeCJOdiCL6qqq
534ebXAtpkzi+rKShRFnePwaVh26K5lWZmFMm1qB1tQjScSvLVnD+0dXQSzs0lq2pyN392OZZp4vV4K
5358/Npbmnh/MVLPLhlM36fD03TSCQSeD2elLtBOOMmMDA4Ati+mdqUrcE3DfOG48IWhmyfueMnTzM8
536PMIzT+8kkUjyxtu7sd5lRZlvvLndLkzDoKyygs2bNiBLMpFohNycXC5ebkIIcLvcmXtY3rCUuppq
537mltaeXvPPo4eP8munTsy696HzZ0vvKTQNI1YLI6u6yiKQigUQpYkOrt7WbliOb29fYyOjZOfl4uq
538KOTkhLja2kZ3by+FBQW0tLXbA9ACn8+HJEm4VJXndj1Fbk4OQyk/g7Hx8RvunufjRp2o6wb5eXnU
5391Vaze+8B9h04xM4nHs9M9A63jqqqtLa1c/7iJYoKC7Gw6OjoxOfzUVleARaUFBdRWFhAa2s7a1at
540JD83l66eXs6dv0hubg5T4TBej4fsQIDsQAC/38fl5maC+7MpLyujID+P9o5Osvw+LMt2Ei4rLSap
541aZnoHICkpmVMjKZpkkwm0fX5+1XTdZLJJLIsU1NdxakzZzEtk/KyMiwLkloSTdNQZBmfz8fo6Bgt
542be109/QSTzk9Qko7McusqWk6iVTUh8/rZWTYdh4eGBoiFo+jaxqlJSUp/50ryLJMIp5kbGyMYCon
543RHVVFWfPXeDK1Rbb6TIep6iwgJxQkERSQ0lHSlhW6h71jJkgnvq7sqKCgrw8Ojq7CGT5U35qEuVl
544peiaQTKZzOxKDcMkkUxi6DqqIpOXn0vyQpIDh44QTySoqay8rXw9DjfGMAyKCgsoSPkcabpGTVUV
545wexs+1nfYLqzBWUDIWzhRNcNIpFIZlwIyyISiaLpum0G1e13fHxyiraOLlY0LOXRhx/izd17OHfh
5464s/3pj9AzJTv3eb7NjA6Ps47R48zOTlFTjDIZDhMfl4uq1c1UltTw/mLl7BMC9OyaGltpb6ulqKC
547fEbH7CCDtJnUSo8vTYeU34xLdXHm7AVcLjdutxvDMOns6iYaixGens5oLZOaljHEGcY14820x5uu
548aRTm51NcXER3Ty85oVBmLSotKcnMYXYEr0QsFuf4yZN4vT6i0SiSJBEKZd9RwSZ3vPBimHbY5ZGj
549xzlz7gLJZJKVK5axaf06Vixr4Oz5i/QPDODzetC0ZEYLsnL5Mlrb2nlr917OnDuPIiuZzvL7fNy3
550YR179x/km9/+Hm6XC6/Xw66dTwB2zpgrV1vo7x/AtCwCfj+NjSvQU4sQ2C9MPB7PvCSarhOLxTMS
551bzyeIBqL0rBkESOjYxx+5xhej5dtjzz4C5XL4/3ENE1CoSCGYdDW3pEJ+3tu11NUVZaT1DWy/H5K
552i4vp7OqmqrLCtgG7XExHIgwNDyPLMju2b2PJokUISbB18ybOnrtAV3cPy5Yu4bldT7PvwEFa2tox
553TYt1qxuRZZmC/Dx7wU2FI1eUleF22+Ybr8dDdVUleXk58+YkKi4sRNPtMOrCgnyWLl6E1+u1BYRE
554goqyMnJCITweD1s3b+Lg4SP09vVTXVWJaVoEAgGEEJSVluJxuzITSElxIYGAH4/Xw+aNG0gmk/T0
5559lJTXY2h6wQCWbjdbh7b9ggHDh+hf2CQmqpKSkqKmZoKoxsG9bU1fOSpJzl6/ARNzc2oikp9XS2S
556JFFeWpLZLXvcbqqrqsjPs3PpBINBaquq8Hg8ZGcHeObpnRw4fITWtg5My2RN40pkWSYnJ0h1ZSW+
557VCRgdiCL2uoqAtnZaJrOioYGxscnGBgcYmRklNqqqp/vS/ULgJnSFFRVVrJn3wFkRaaivAxXyhxo
558GCaxeCKjXUkkk8RT0ZT262xRUV5GMJjNnv0HmZoKs37dGkpLSjhxynYOJaVpTsQT5ASDlJeVcu7C
559RYZGRonFopmQXMMwiMVid72JUNd1CgsKeOHZXZw4eYbe/j7GxsYxMamqqsTr8bD9kYc4fuIEnT29
560CCG4b+N61qxqRJJle86orCAnFMoEIlRVVlBQkI+uaVSWlbJl03qarrbQPzDA+rWrU+O7j/r62pR/
561Xw6yLFFRVooi20t5MJhNVWUFPp893rL8fmqrqsjKysLj9fL0Ezs4ePgdOrq6MAyD5Q1LUWSZ7Ows
562qior8Pv9WJaJ6lLRDZPmllYkSbB50wbWrVkD3H6SwvcbsWfPHmvVqlXk5OQsqEDjPzRxvjcCLgk0
563wZNlGl9siH8gR4pLqfwC3T29GIaJZZoYpkFhQT7VVVUktSTNzS3E4nHKS0uJRKPouk5tbQ1ul4vR
5640VH6+gdwuVzE4nF2793PfRs3sHXzJoQQdHR2MTA4hGWZ5OXmUltTzXQkQkdnF3oqv4dlWbhUF6Wl
565JfT39+P1eqmprqK7p5fJqSlqq6vJzs6ip7efwaEhaqqq8Pt9NLe04lJVFtXVEk8kuNrahq7rLFlU
566/4ElEgqqFp9r8vBKtwpq6gVL/e8f18RYmW3c9adKp23r15IWGiPRKD/80U+xgJdeeBa3253JMTHf
5679bb2xFaDmoYxx44PqSRfhmHb81MaB7uckvku3Sb7/by+X9N1z74WyGTOnP1b8jX1w4ypSEnldklr
5687tLX2rlXpOts4Okw6dHRMXJyQni9Xq5cvcqPf/o6Sxcv5onHtiFm+TpcV1+6nbPv0TIxDDNjLjBN
569I5UHZv7nlr4u/dxmys2Yv9L1pz+7m0mfKv2rZ7xcmZRBtkAXPFqs8aXl8Q/t9GIplauqta0DRZap
570rq7E7/MBMDk5SVt7JwUF+ZSWFNPa1o6ma9TV1OByuVLjR6Grq5vB4SFCwSCLF9UzNjZOa3s7Xo+X
5714uIievv6yA4EqKmuYmx8nNbWdrKD2QSy/AwODlNXW00yqdHe2UV5WQnFRT9//wm/bHFsQuY/nvFi
572GYI/XB7n+RLttvslbZadvZyn32NZlpCElPlOCFtQTCcNTJuT0hvgtM/LtfPE7Dxks0mPRUVRwLLQ
573FzDeZFlGmtXea8dpejwDc8a0wFYk3M74DKkWf9Ph4itX3VjqDQSfqM4fPV7B57YUI92kK8bHxzl3
5747tydrXkxTZPcnByKCgszn4lZ6ZdVWWHN6kYEtuZDliQQAkPXGRgcpLunl9LiYuKJBMdPnSErKyuT
575SdUwDKoqK6irqQbsjkkmk2T5/axN/WYq2zNmyomqpLgoo16rq6lGkmWSySSaplNRVkpNdSXJpL3D
576WNO4MuMP4/F4WLdmNUAm94HD7ZEebNciSRJHj5/k8DtH8bg97HhsG16vJ2PKmV1m9s7BdsoVkLLh
577G4aRSeI2+9r0hDL777R5Md2mG+1Irq3bMPQ5lsnZZdP1pNtzbZ3XlktPLoZhIoQF2Lvl2dmhj508
578TXtnJx63m0Q8Tm1NNfdvvQ9Jlm0fsmuypmbqM42M8HvtPaYF+zntnue5XXvdfH+n679TdnT3IqZp
579kuX3s3HdGizImBYAQqEg923agK7raJrGsoYlCERGiw1gGDo1NZXU19ekTBMauTkhioo2Ypr2/Fhc
580VJgxW+SEQmzZvDGz6ayqqCCRTCKEoKSkGO0eOR4gbfaZd/wYJgYzYyvjG8f142m+v9Mm2tljZXaS
581zfnmopuNN8MwMGa190bXpa99r0dCfJDc0cILpB72DaRzM2WeSZMeCmnnsTPnznP0+EkASkqKeej+
582LeTl5WYGjaZp151BYZrmnN+8ti1pkpoGs7IWaro+RxUan3W+kpnyJXB4f5hvIJmmSXVlhZ3FNj+f
583stKSOc6f7zb4rv3O1pRff/3s664rc0t+Ujep/wb1zFfFja+dcSJeu7qR2uoqEAK3S6WmugpVVecs
584HvO1/1baCQt7bjeu686bHO81TNMkNs88ZBgmsVgs8/eNzmOzz96aGVO6YaDHZuZEY9ZCbpuHZr6b
585PTfOrute4Vbmlxt9vpBxMVu4WejvLHS83W3j8o4XXm4HXdfJy83hl17+WGYHmw5r/SAP4HP48LAs
586i+LiIsrLy+zdn9PPgP1cKivKqamuIq2VSTveOjg4ONyt3PXCy43UWkIIPG53xgs7bf+/E9rm8MGQ
587zo/gMJf5NIwODrfCu81lzjzn8GHwoQkvsiwjS7YzU9q+dzu828C5Vd+StJPUe2lLurxI5TxIt8MZ
5882A4ODh8U6ROO046Vs03ccuo7CzB0/bqztxbCu20SnXnO4cPgQxFe3G4XU+FpJiYmADtTbX5eHpqu
589ZTydb0b6ELs9Bw6iJzQe277tPaXeT4cvj4yOEswOzPESX3B502JkdIxQKEg8keDtPfuQZYltDz2I
5902+12HHUdHBzed4QQxOJxwlNhTMskkJWF3+/POHhGolHCqbO8sgPZuN2uBQsZkiShaRpv79lPPB7n
5918e3b7GRnqUixRCLB7r0HME2DRx95CI/H48xzDj8Xfq7CS1oz0dTcwjvHjjMyMmqnWfe42bR+HSuX
592N6RCtuxsjHYIqB1Olv63nTIdwD61dGh4hGQsjiREKpGPjqbpmcFpl7FDTPVZwpGqKkhiJgGXruvs
5933X+QweFhXnzuWTt8FTLtUBQZQzcwLSuVEt72TUyf7WFZFnv2H2R4ZISXPvocSuo4etOaCS9L5yWZ
594XTbdTlVVEdhOcOmzkdLh2g4ODg43QlFketr6+NmbbxOPx1mzqpHt2x7OaGNOnDrD0eMn8fl8PLlj
595O4vqajEMwz7ZWYBpzjWppzPmpufZZDLJ8OgokelpgMw8a6Syw0ajEaLxeGaeFCh22K4QSClN9GxN
596UPrgW9uUr8+ZA9PHB2jO3OdwE36uwouiKLS0tfGT135Gfm4uL330eXxeL/sPHeGNt/dgGgbr165h
597aGSEaDRKfl4ek1Nh3G4X+Xl5JBIJunp6UunLfQSzA7gUFckD05EIPf19uF1uiosKMwc0TkxMMjw6
598gqqolJYUZ86LGRwaJhy2dyM5oRAjY6NcbrqCz++jo6OT0tJiItEY8XicvLxcJiYmyPJn4fN56ejs
599IqklcakqJcUlyLLgamsbl5qaCGRl0dbeQXFRIRvXr8UwDFyqKyMEtXd0oukaLtVFWWkJimKnd+/p
6007UMICAWDDA2P2CGFxUUoiuIMYgcHh3clbb4JZGfT29/PZDhMXk4O4+Pj9PT14fV6kCSRuW4qHGZ4
601eMQOoc7yU1hQgGXZeUCSSY3unl40XcPn9RIKBnGpMobHQyQao39wMDX3FeFyuVi9ehWGruP1ehkd
602HWdyaoqC/DzC09NMRyIU5OVlzrZyqSojo2OMjY/jdrspLSnO5DPp6x8gGo0ihCA/LzeVMM0xQznM
603z89NeEmfeXH6zDmwLB64fwtVlRVgWWy5bwOd3d2cPX+RJYsXc/bcBS5camJ5wxLOnr/AfRvXs3HD
604el574y1a29oRQqK4qIAdjz2KqipMTk3x5u499Pb1I0kS27c9zJqVK2nr6uTtPfuYmJhECMGypUt4
6059OEHudLaxr4DhzLp3leuWMbg4DCGaRKJRHlz9x4e3/4IV6620tHZSX1dHWfPneexRx/G7/fzxlt7
606MruGjevXsnLFMk6cOoNl/f/svXd4HNd57/+Zsr0Bi94IgGADwF7EIkoUSZHqkiVLbrJjO7ETpThx
607nPK7N7mOnZtyHTuxb/LE+SVxi0tsybYkq1MSSVGkKPbeQZAgid6x2D71/jGLBUiRKhYpktL5PM8+
608BGdnZs/O7Jz5znve835tEskkL2/cxE03LmX3nn3YtkVd7SQSiSSvbN6SrwxrWRaNufaYlsUrm19z
609rOYrq+jp6yOVTrNo/jxuXLpYVOQVCARvgVP7o6S4iK6ubtrPtVNaXMy59g5GR+NMqqmmPVfp1bIs
610duzazeGjx/OGs6tvWUFz0wzi8QQbNr1K66k2JFmirKSY29bciqK6SKdHWP/KK3R394AEa1etZEpD
611A6+9vh3TMKidNInjLSfZsnUbNTVVZLNZevv6qa6q5PZbV1NaWsLxlpNs2vwayWQSRZGZO2c2y5cu
6124cDBw7y+c5eTk2NZrFxxE7NnNosEfMElec/EiyRJpNNphoZHiETCFBUW5MVDKBiktKSYgYEhRuNx
6133G43pmXSdvYc06ZOoaK8nO07dtHSeooVy5cxq7mJRDKZuxBtstksc2bPYtGC+Tz17PO0tp5makMD
614m7e8jmVZ/PZvfpoz59p5af1GqiorOHTkGJlMhg9/6F6KooXEE0maG2fw9HMv4HZ7uOfO2wgGApw4
615eYpMJktHZydNjTOIFhbicXt4+GMPUVhQwCuvbmH33n1Mrq/jzttu5fEnn8br9XLPXXegyDLbd+5G
616zbnv7tm7nyPHjnPH2ltpnDGd3Xv28drr2ygtKWFWc6Nj3GjaTJkymVUrb+aZ51/k8NFjNM2YTmlp
617ibiIBQLBpbGdZNrqykpGY6O0nj5NU9MM2s6eo6ykmKJoIWfbOyA3XD21oYEblyxBkuCJp55h5+49
618TK6vZc++/ZxoaeWm5UuZM7OZRDKJIkvYOY+cObNmsnjhAp567gVOtLQyub7eqcyaG+4ZM2AM+gPc
619e+ft7NrrGKGeaW/H5/fx6patBAN+Pv3wxzhw6Ajbd+6ipLiEfQcPIksSDz34AF6fl3Q6LTzgBG/K
620e56wO9FCfeIyJ7rgDI/Ytg22zfy5s7lp2VJGYjE2v/Y6xdEoM5ubCAYC+P1+0uk0hmkQDoeYOrme
621dCZLMBgECWKjMUZHR1FdLta/8irJVIpsNktPXx/lZaWcbjvD+o2baJwxjflz56LpGlLOaTcYCOSH
622ayRJZskNi5g/dw6GrtPZ3cPWbTswDCNvUqZrGtHCgnxOTzAQyI8hS5JMVtPo6ummtLiYKQ2TCQWD
623zJg2lQMHD9Pd3U3jjGnYtkUkEmbK5HoKCsIURZ2Qb1bLXlNmWAKB4NrENC3C4RDVVVWcbjtDW9tZ
624enr6WHzDfDTNwLYsbGy8Xi/pdIZ16zcAkEqnUWSZRCLJufZ2otECZjY25vvZTCaDaVoEg0Gm1Neh
6256QahYNCpyHpBG5yS9BJTGuopKS5yhr4VFV1zDEHHPuvFlzcyMhojlU4zODhIRXk5+w4c5KX1G2lq
626nM7M5qZ8bqBAcDHeM/Fi23bOzTdIT08vI7FRCgsLwIaR2ChDg0OEwyEiEWdsVFVVSoqL0XQ979kw
627Vj5ZkmUka7yUsoRT3dMwjXzp5LEbvpJz3A0Gg1SUlVFVVUFDXT3hUJBTZ86wees2Eokki3Jls+H8
628aYEej4fiXFXegcEhnlv3EgCT62pJpdJI0nhFyYlVTSciITFmFy/LErLkJMHphn6eX8XYlHHDGC/Z
629LoSLQCB4O9i243/VMLmOltZWdu3Zh8fjprqyklNtZwBQFZXWU6d5cf0GKirKKSosZKB/ACkXIR6b
630fGDbVq6ftd68n71EW0zLwjDM86rujvVlqqrg9/sIBgPUVFdRU11JRXk50cJC56Fy02aSqRQ3Ll0C
631iOiL4OLIb73K5cGyLDweD/PnzsG0bTZu2kzbmXP09vXz6mtbGY3HmTdnNuFgMC8ExnxPfD4fVVWV
632DAwNsnffAXr7+mg91UYqnZ5wsY2XTbZMZ7qgz+9HNwyaGqez7IZFNNTXURgp4FRbG1MaJrNg3lzH
633wn1kBFVV8XjcjIzE6OzszrtH2/a490o6kyEej1NTVcmCeXPweDwYhuNT4/G4cee27+rqym9vWRZu
634t4tJNdX0Dw5y+Ohxevv6OXT0GMlkiprqKlRFwbygRsKFPhMCgUDwZow9/NROqqGoKEp7RwcFkQhF
635xcW5fsrpT+KJBJqm0Th9Gk2NM/KzLb1eD1VVVQwNDbN3/0F6+/o5deo0qVQKJN7Qz45FXs5fPhY5
636P79dlmVREIngcbmxLJvZM5tYfMMCJtfV4ff5aTt7jubG6cye1YxtQ2x0NC+QBIKL8Z4OG5mmyZSG
637ydy59la279zNL574FZIk4/N5ufP2tTROn5Y3usqTG0JasmgB6XSa3Xv3sWPXXibVVHLbmtVcTPtb
638loXP62XNqlt4ecMrPPrLJ8GGmqoKVq+8hf0HD3OCc9qgAAAgAElEQVSuvR1FUSgrKWHZksUEgwFm
639NjWxafNrPPXcC9x522pcOcv4sbaXFEdpapzBwUOH6enrw+N256dy+3w+Zjc3s2mLs/2Km5fjUlWs
640XIRo4by5jMYTbH19O6+9vh2Px80tN99I44zpZLWLeykJBALBO2Gs76uqrKCjs4tJk6pxKUq+RIRl
641W0yuq6WqsoKX1m+kpro61085D0+LF84nmUyy98BBdu3dT3VlOXesXXPJCMsbufgDl2VZRCIR1qy+
642hfWvbOYnj/4C27aZOqWBZYtvYMeuPfT39yPLMvW1k7hh4UJnb+IBTnAJpFdeecWeM2cOhYWFb2uD
6432d8/zqHOJLhl0CXuqNL5h8YMsbdpKS5JEm6Xi9honHiuboDP5yVaWJive5JMJslks4RDobwlu6qq
6446LrO0PBwPooTCgYZjcexLZuCggiWZRGLjaIoCuGws21sdJREIgnYBPx+/H4/sdG4ExmxbUKhEOFQ
645ED33ZOLs3yYcCqLpOpqmEQ6FcvVZpHwb/D4fLpeLeDxBOBzKF6EbGh7GtmyCwYBjgmZDJBLOG+EN
646Dg1jWSZut5vioqjjPGqajMbjzgUeDqMoCqPxOJqmEwk7n/12LuKIy+bLx7081e6CMevx3D8/mJdm
647VtgkbYonGYHgSiFLTjj7M/t9nIgpoNhgSKwu1/mn5gzxt9lPvhMkyal5FU8kCAYC+Hw+0pkMiUTS
648KSfhcpFIpUin04RDIXw+H/F4gngiQSQcxjANtKxGJBLG7XZfsp+1LIvCggKnnx11+tlQMEgsNoqN
649TUEkQiaTJZVKEQyOtyMeT+D3+wj4/bhcKsPDTq4LOJM1vF4PIyOjTnQotx+/339FLC0Cis3OEYXf
6503e/DNiX+qjnDAxX6FTkvAocCl82/nXHz7yc92K5L3MdSBl9dW8OXl5Ujv8WpGB4e5uDBg+99wq5t
65122Q1jUDATygUzC2z8sMsAOFwmIJcXZSxm/ZYkbrysjJnG8vCME2KotHz3i8tKcbGxjAca/ZgIEA4
652FAIc9W+aJkXRAiRpvKS1NsEduqy0FCBft0Ce0A47V6CusqIiV3vFJhAI5IvJnbe9aRIIBPJtMwwD
653WZIoLyvNHwfDMPOh0bHvMTZkVhCJnPfZAoFAcDFs20nCDQQCmKaZj74EAwFM08CybEKBgCNUcn1R
654MBggHA5hWSYSElJYQs+9d14/azu5K+f1s7JMafF4P1tcXJR/LxDwEw6H3tAOyzIxTct5IIuEKCiI
655AOSXFxcX5YeILNMUXlyCt+SqeRuZpnnJqXCXem8sB2YiE6cQ27Z9nvX6pfZlGCYXSwR7g3njRba9
656sA2mOf73hdtf2FbLtrEucVFeOBX6zY6PQCAQTOTCfukN/ZRlYZ7Xb126f3nLfhbO62cnvvdW7XDW
657f2P/K0pBCN4p71nCrkAgEAgEAsHl4KpFXt4OztRi+bxpyG/GWL2YXzdikXdmzU19FpEPgUAgEAiu
658Pa5p8ZJKp9E1HZ/P+5ZJq7Ls1CmIJxL4vN53PMVOlmXS6TS79uyjvcOpqDtvziwxZVkgEAgEgmuM
659a3LYaCyCsmvPPn78s8fo7OxCVdX8S5ZlXC5XfgbQWKG3bdt38cJL63OJtY4uUxTlvHWB/PaK4kRa
6603G7nvc1bt7Fn334KCwoIh0NIkmMm6XK5cOUMHSe20TX2nkt9w75dLtd5BegmtmPMiEwgEAgEAsE7
66155qOvFiWlZs+5yTDDgwMIskSoWCQ/oEBQKI4GgUJOjq62HvwIH6fl96+PkqKi/H7/SQSCUZio6iK
662QlFRFEVRSKXSxBNxgoEgNjaapqFpGl3dPQQDAebOnklFRTmGYTI0PIBpWrhdLqJRZzr5WLXIvoFB
663dF1HURQikRA+r49MJkNvXz+SBNFoNC96EglnaqJtQ8Dvy89EEggEAoFA8M64psXLWFRFURR0Xefl
664jZsYHhmhqrLCsWzXdW5cupjG6dPY8vq2nN9Qil898zx337GWgoICXnhpPb29fciKwrzZs1hx0zLa
665OztZ99J6mmZMp39gMG/9nkgkUBSFx574FXesuRXTMtm4aTO2baMoCjcvX8acWc2YpsW2HbvYu/8A
666uq4TDAR44L57MAyTlze8wpmz7UgSzJg+jdW33MzQ0DAvb9zE0PAwmqYxb85sVq64SQxJCQQCgUDw
667a3BNi5cLkWTHmbqivJwbFs5n3csb2LPvAA31ddy66haefu4FXC4Xt69ZRSgY5NkXXiSZTPGZT32C
668c+0dbNy0mbraSaiKgiwrtJw6RUE4TEN9PdOmTeHFlzegZTXuvfN2iouL6ent4eGPPUTAH+DFlzew
669bftOGurraO/oYtuOnTROn8aSGxaRyWZQVZUtr71OR2cXH3voftLpDM88t46K8lK6u3vp7unhrttv
670o7q6kpGRWL6egkAgEAgEgnfGdSVeLNOisLCA5sYZFBaGKS0ppvVUG7puUBgtRJFlVFWhtKSE4eER
671BgaH8Hm97N1/kHg8TlbTaO/opKy0BMuyqKqs5J47b8fv95FKpfMzjYqKokQiYUZH4xw4eBjbtkll
672HIv2RCJJa1sbbrebhQvmUVFRhmlaDI+M0NXTi6q6OHzkmFOd19Bp7+iiIBLBNC327NtPOpOmuXF6
6733rVaIBAIBALBO+O6Ei8wbj6m607lyLFEWcMwsC4wDZMkpzhTIpFAkWVmz2ympLgIK+eaWlFejsfj
674QdeN86Zj27ZNb28fz7ywDkmSKC0pJp3J5Gc0McG52rbsvG+7lDMvS6RSKLJM84zplJeXM2dWMx6P
675m1On23jl1S109/SydvVKVHXcc+RqIgGuazJ1WyC49rBt0K/+ZSsQfKC57sTLxRgr2z/mNTQwMEgg
676EMDj9mADy5cuprCgkN7+PqLRKGfOnMWyLl79EZxcm5HYKCMjI9x84zJmzmzi6edeIJlIoqoqlRXl
677HDt+ggOHjuD3+4nHE7jdLkKBIMlkH4vmz6WqspL+gQFkWaarq5vmxkYm19fx88efoqenD03TcLn8
678XMrI7L1CAgwbBrPC20MgeEtsUGSIqJf/uhVX4OXhSvao4hy9kat1B7umxYuZ87iY6G/keP2c/75l
679WQR8PppmTGPT5q089viT3HPnbay9dSUvvLiBH/30MWRZpqS4iAfuuye3L/280v4T929aFpUVZdTW
680TmLz1m20nm5D03Us08IwDWbPbKa/f5BDh49w+MgxgkE/H77vHlbctJwXXnqZnz/+lDMDKRzkjrVr
681OHT0GMeOt+ByufB4XNy49AZ8Pt81EXXxKjZH4gqPHPA6C8TVKRBcGhNqgzbfmZNGluByXcIS4FXg
682aj/MvB/QLQndvvxdmXOOxPm5EMOW0Kz3/tZxTYqXMbEyb84spjZMpiRn2nXrqluwLBOfz4NhmCxd
683fAPz5symsLAATdeZO3sWZaWlmKZJcVERhQURHrz/XkZiMWzbdtyf3W4qK8r56IP3Ew6F8pEXVVVZ
684s2oltmXhcbvxeNzcvmY1fX0DFBY4Jomj8XjeYfrWVStobpqOphm43S4CwSB+n5f7772bgcFBbNtx
685sS4qirJw/lxmTJuKbUMoFKS8tCRvBnktYNqQHnNVFeJFILg0JiTMy3sDUyUY1iX+/KibjCmJa/Dd
686YEjcWaXzQIVO8jI6RXtkOJuW+NpJr/PwLM6RgyGxvEznMzWX93i/Ha5J8QKOgCkuilJWUoKec22u
687qqxAkkDXHaflstISZFlG13XHtVmWqaudBDhRlHQmQzRaSEnO9dTM1Y0JBAIURCIYEywAJEmiuqoy
688v3/DMAkFgxQWFOTXKSqKous6uq4jyzK1kyYhMW4ImclkCYWCFI45ptoWum5QWlJCRc6l1bKta0q4
689QO46lCb+RyAQXBTJERuXE1lycmi2DavYuhAv7wpdYmbUwHWZj6EiQcqQ2DuoCvEyEV2iPGhe9mvi
6907XDNihdw3EeNCe6jF9qkT3QilSQJ23YKzk1cZhgGF/qVWpZFdsJ6l9r/pfyNLvZZY8sv7mL9xjYI
691BOfhVGJ0sr4v1hHYtrOOfIlewsrFyd+hLYbg2kAC/IpNUtwY3x02uOXLP/iWv/TU3HUozpGD7USl
692rgbXtHgRCK47dMsZh7uQsSldlxAfsgyyJGPZ9kXzKBRZzs2es9/YMdugqjKGJTpWgUDwwUCIF4Hg
693cpATDYtrQ5T6xy8rw3LEiGXb7O5JMZwy3ihgNJOPzCnm71dU8q97+vnm9h5HzThjkgB8+7Ya1taH
694+fhTbexoT4Aqj30Ay+vCPHZfHevPxPncc2fRLa5R1zKBQCC4PAjxIhBcDnK1f/5qWTm3Tw6DBLph
6954VHHVcSSH51gx4iWFyRIUj7GXehVqI+4KfGrkDFBspyBdrezfU3IRX3EjVuRIWU4UZxccZ6saZM1
696bVyKhG7azvaK5ExfsYGs6XymR3GWiwkTAoHgOkeIF4HgciBL2MDHnzmDW5GwdIvioItf3D+Z2SVe
697vvJaN3vOJigu9HD3lAiyBHHN5NnWUdIZ0xnywREit84opDLs5uyoxqttoyBLZE0bw7Ip8Cp8fGEp
698iktme1eS1p4UZ2JZ/nFnLyeHs0wt9rKsOsBAyuC5kzEkReLumVFK/Covto3SOaI5AkYgEAiuY4R4
699EQguI6Npw8l5MW2+fHMFs0u8bG5P8LXXezEk+MtlZfzevBI00yLoVvjBwSE+93Qbek68/OasKL8x
700M0p9xI1h2Xzy2bM8dmAAI1cx+uu3VFIScFHkVTgxlOH2n7ZSUeDm22tqeLFtlC+81MH/ubmKiqDK
7010h+3UORTePrDkznQl+b5k7GrfHQEAoHg8iBGxgWCy4ksgWnz2UWlfHFhKX0pg8+/cA4tayB7FJ45
702OUrFvx4i9A/7eaJlhM/OjlJf6kPLJfmOZE2W/Ndx7v7lKWzgfy4pI+hXMUxQJImX2uLUfOsg/3d3
703H9OjXj45twgzJ3wsG052JfnSxg4My+bf1tbwjZVVDKQNfuPZs/TEsiLqIhAI3heIyItAcDnRTBbW
704BvnGykoA/mJzNy09KfAoSLpF2CPz3EMNhN0KRT7n8vNPKJLw+IkR+oaybDBszo7qVIZcFPld+RlE
705jx4bJh3XeKY1xhcXljKlwM2WXF6NBOBWePTAIPdPK+AjMwoA+PNNnRw8FwevuNwFAsH7AxF5EQgu
706F6aN26Pwj6uqKfKpfH17L997vRssIKGzvC7EE/dPxqfK/PzoEMMZp/rPxKnRQbcChkXYLVMWUElo
707JrGsmZ+g5FVl0C2qQ24ABtMmGWPCDiybkE+hPDAuVOaV+lE8yniisEBg2U4it56zSLEBzRxfljVB
708u8D3zZywzdj2E/dx4XpZ8+JlAwSXl7HzdQ3YzbyXiEcxgeByYNu4Zfj66mpWTAoymjXZ05tmxdQC
709ZJeMljGZXOBGkuBwf4aN5xJ8dk4x4ERMxsTJw02FrG8b5b5pBYRcMk+0JxlJ6Ki54nNfWFiMZFl8
710cWEpABvOxtFytV/GHM//102V3FwT5F/29DO7xMvHmwp5+lSMR/cPgFu5CgdHcE1hQ4FPZeYkHwNp
711g+MDaQAW14YJumXimolLkUjrNvv7Uox515aFXUwt9JLULc7Gskwv8qJIEn0pnZaBDGNmT8UhFzOi
712jlfamViWjlFd1B4aE3sX4pLHyx78GsgSzKoKEHIrHOxPM5oxPzDHWogXgeByYNjUlvp4aHpBftry
713T++tRcmJjqGMyUNPtvFfhwb5ZHOUuWU+BjMGpQEVywbdsskYFm0xjUc/VE+BR+HlM3H+elMXSKCZ
714FrGsSZnfxYaHp2HZ8Pfbenn5xAiLakNkDYuhjMHaGYV8fk4RJ4ay/OWmLm6o8jO/PMBXbyxnd1eK
7151oH0u+osBe8DdIvF9WFe+EgDz7TG+NDPTnLfrCKe+FA9XQmd/7Oth2/eWk1at2j87jG6RzQwbR6Z
716W8JXlpfz7T39PHVyhJc+OhVJgr29KVb+9GQuWR3+aGEpf7m0DAn4qy3d/O2mLmz3B/g3Z9rUFLj5
717/QUlRDwKYbeCBAxnTP7/ff0c7kqBS3rn1bEtG49b4b/uqmNuqZdbftbC5lNxbNcH41gL8SIQXA5U
718mbOjGjf86ER+kcT4Q5AFdMV1Nnck+PKWbmJZExuIeBT6kgZnYhpT/vMoQ2mTsEfGJUv0pwyyGRNc
719Ml9Y38mfvNLFSMak2KdgAZ0xDSSJPT0ppvznUVK6hSpLzPvBceKaSUIz2XgmzozvHMWvyvSmDJGw
720KwDAzA0hjmRMKqJevrGiEsu2+fTzZ9lwYoSHm6MsrQqwtMrPk4MZZJfM8uoAEvC9w4P4FBnNtJBl
721ieZiL7PL/Lx2YoSCQg93TQ6jGTYeVcqXAPhAY9mUB1382Q1lyBLs6k5h2DYfqwzwqZlR/v71br6+
722rRcrty6GNV6LSZac6MzYZTuxgrdtY7kUNNNy3EUgN9MxF30Zi7LqptMBgWPMpcrOerrl7H9sONlz
723fUVlhXgRCC4HEmiGTedw9tLrKDKGYdExnM0/ZSVSBigyummRyjjVd9MZE7DHOy5gMKE7nYws0Z7L
724lUGRQYbs2OeO+SJZOY+kXEG67pHs+PrC+0gwAbcq8XcrKmiIevjKlm42tsRAgidPxlhSFeDuyRGe
7253DdIY5WfG6sCHB3McKQvzdLqILIkcXwww6wSHw83FrL15AjLa4LMLfWxozvJksrA1f561wxGLrJ6
726akRjyY9PYI1qPLyknB/cMYmv3lTJxvYEO1tHKS7y8j+WlDGn1Idm2fzy2DD/tW8AW5HAsFgzvZDf
727m1dM0C3TOpTlb7f1kDWcKt4JzWJSsZevrawCCb6yuYvWvjS/v7ScuxrCZAybr+/sZdvJGKsbC/mt
7282UVsOBOnPOgi7JH5y83d6IZ13fQRH4z4kkDwXiDhPNVc6jWW3KLKjrBQpPHlUu5vWRp/OppoI6BM
729fH/C/iZ+riKdv/8L23R99EmC9wjNtFlTF+Izs4rY1pnkb1/vwVYAWeLJlhFGMyar6kIEIm4WV/rx
730umSeb41hjGq4ZQlVltjVneL4YIb7pkUIRjzcPy1CR1xje2dSFHK+ABvnsiz0KuBR+e99AzzREsOt
731SCyvDlJe6GH9R6fwxUUlpA2L2rCb799Vy/+8qQIpa3J3Y5RnHpjM6toQ6YxJWcBF1Kdg2U4By6BL
7325hurq/loUyGnY1nODWX51u21/PPqamwbZhR5efxD9dSU+JhS6OEjMwr5m5sr+JubKvh4Y9Rxhr6O
733TpoQLwKBQPAOuI769zdFlpzZaqNZ50a5uCoAhg2KxOmhDOvPxpkUdnPXlAj3To2QNSx+0TKCLUl5
734HdyfMnimNUZ5wMXnZkdZURPkyZYRDvWn3z8H6kogS2BZnBzOgA0Bl8yHm6PMLvXxz7v7uO/7x1j+
7353y2cGdX5wsIS6sv9/MXSclRF4t7HT3Hfj07wsSdP0x03UBWJrGHxhwtKuW9ahB8dHuLLGzqpLPLy
736yIJiTg5neeSFc/zTzj5K/S4eaioklZshFnIrPPJSOx/+5Smn1tR1EnUBIV4E5PoYK/eyxUu8xOuS
737r0uYhl+PqLLE650J/m5bD5UhF/+8qopQQAUTLM1iXdsoAJ9sKuSWmiA7u1Ps6U6dl/CtWzaPnxgh
738qVn8f4vLKfIqPNc2ivE+OUZXDNsGSaIq6M4l5NtMLnDKH7zangBVYSRl0DqUIexWmF/hpzqkMpA2
7392NubwvaraLkyCrYNQY/Ch6cXYNvwg0OD2EmD+ogb2Zaoi7g5/XvN/OftNcgSTAq78uLzVy0jfGdH
740LzvbE87v+vrRLiLn5YNO1pKY5LP47vz01W6KQHDtY4/nQV7Puahj9yivIvMvO/tYWxdidV2If7q1
741hkeeP4tlS2w4m2AwZXBHQwRFgqdPxrCyFkjj2wddMrs6k+zsSrKqLsTxwQybz8b57GynDMCFBuof
742ZCTAtGzHWT6pc/PsYu6fHiGlWzxxbJg7p0YAaCzy8YxmEo56aC7xktAtDvenGcpYNBa7mB71sqt/
743BHfETdCtIEuQ0ix+1RLj4ZmF/O3yCu7oTNA+qiPLcGZE4+FnztAf16mIuOkb1Vg5OQzAsGZiK/J1
744eaKEePmAY9ngU2Be5CI1CAQCwRuwkMhc55eLhXPtK7JENmvyp5s6WffQFD4zK8prHQl+vLeftsEM
745T7SM8Pm5xQxnTNafi+PoNSm/vSRJ2FmTdWdGWVEbYuPZBNmk4YyK8P6JUr1bFEnCq8o0Fnv53l21
746ZE2bT8+Kgg2fe+Ecrd0pnsaZZv7VGyuYHHEzo8hLecDFP2zv4URnkv86OMg3V1fxxP31PH8yRsin
7478rXtvbgViaBb5nsHHQ+0T8+K8u3ba/n9ded4rjXG3VMj/PniMtoGMkwq8vBH6zuQc2IlqCpI16nR
748vBAvAiwbUub1p7wFAsGvgUtmW2eSGd89SkKzsN0y+7tTLPjhcQIumbRu5WuFfGljJ9/Y2Ydm2nTE
749tfzst9c7nO1HMia2V+Hbewd4siVGX9LA9ij85MgwL7bFGUwbH5i6I5dEkhjJmjzZMkKRT2VemR9J
750gudaR/n77b3sPRcHv0rbQIY7f97K39xcyZKqAJpp8zvrzjmzjVwK/7Kzl7hh8tlZRSypCbKnJ0VH
751XOO19iQjGZP2uM6fvdKJV5WpDLqYV+HnE788zVdWVXFLbZCpUQ87u1IMJg3OxjQ2no2zvy+FfZ12
752/UK8CLABrwwexb4+JbhA8F4iQdaUyFjXVYrAOBKkdJPWPmdq/tgstc7hrHP9jy0DklmT1pThfFFl
753fMbahdunxtbL7SuWNogl9PEZcB9kVInWoSwP/uLUG/vXifVYXDLH+9I89PNT57+fm5lo2Tbf293P
75493b1j7+nyvzxS+ecMJdLBtvm47885bznkgGbP3up/fz9uWTWtcZYd3xkfNbjdYgQLwLcMhxLyJxL
755yiKFWyB4KyyoC1hMDVpvsPW5bpAkp6rrRC5WeVm+hPi4cPsL17vUdh9U8mLiLXiz6tcXO2cXbiNJ
7564L7gPLgvss2lll9HCPEiIKjYPNur8otTHnCJ0ItA8KboEg9PyTI3kmXEur5vAALB9YoQLwJswCMD
757qu28BALBpbGdaKW4UgSCq4cYJBAIBAKBQHBdISIvAsG1gGGdXzhkrPaCbubGui94ztAtp9DVhTYC
758AoFA8AFAiBeB4Gpi25C1qCnxURN2OTUXbGgdzpLQLWZW+knpFscGM5gW+QJh08v9RDwKJ4YyjKQM
759IWAEAsEHCiFeBIKrhe1MTf+dxaV8ZXkFFUFX/q0/XN/Blo4E239jOkf60yz9SQuJtGN1r6oy/7a2
760mpWTQtz7+CmeOTJ83dnZCwQCwbtBiBeB4GpgA6bNHy8t55urqjg1kuXGH52gO6bRVOEnrVu4ZQnb
761ttEvUod+bJktskYFAsEHECFeBIKrgWlRX+zjr5eXk9QtPv70GXa1xsCj0BbTwLRZ1hB2gjMXEShj
762y4R2eX9gAylDAkO6TivfXSPoEtkrUDxQIpeSZuRq6Ytz5KBfPasMIV4EgquBDXNKvYTcClvaE+zq
763SoFPnZC7cr1WPxO8UyzbKVVwd7lO1hTi5V1hSjQGLbKX+fIxbAi5bNZW6M6DgzhHDqbE3IiFdhW6
764KyFeBIKrhDKxB7Rt0SF+QDFsp1Dk38zIip/AuyVn3ZAypct6LLMWlHlsvt6UuYx7fR8ggXYFjvfb
765QYgXgeAq0Z7QsWxoLvGysCrA7lOjztTnfIx6/M+kboHmxMNN+b3vKARXFhuIG+KsXi6u1LDRqDhH
766F+VqHBUhXgSCq4Eqs7czyb/vH+D35hXz07vreGTdOYYSOk0VfkazJn0pAxsIe2SWVgZIZU1soCNh
7675HNdRFcqEAg+iAjxIhBcDSQwTJv/saGDwbTBny8uZcMnpubf/vCvTpMxLJK6xbSol62fnJZ/774n
768ThPPDTKLhN3rA1WCoGpzkYljgveQoGrjU8ZPgkcW5+VKE1Rt3Feglr8QLwLB1UKRiGsWf7Whkx8c
769GsSfc4e1bTg5nEWWYNGPTqBIUj6P1wbaR3X29KT48pZuOuIauEWNl2saCQY0iVcHVdKmiJVdTbyy
770zbFE7k4qQUtSFuflChNUbM6mLn8iuhAvAsHVRJFAlmjrvyARMCdkWnrTF90mnsJRObntBdcwis2e
771EYXf2uMHSTziX1VsyTkHMiDb/PCsix+ecYvzciWxJZAvv+mvEC8CwdVG4o3eRWNcark8tqHgukAC
772FHGDvPpccA7kiywTXGauzPEVrtICgUAgEAiuK0TkRYCEY1KMKQk5KxC8FaaE/k7L8tiAJSJlgg8o
773Y0N1lxEhXgTEDYn7KwyWFphiJEIgeCtsqPDZJN5uzQ9TYl7U4JFaTSSGCj5wBFWbp3tdPNPhwr6M
774eS9CvAjQbaj3W0wPirFfgeDtoFnvwEPHhlK3za0lhihyJvjAUeiyORRXLnvqixAvAiSc4q2aCGsL
775BG+bd3K1GLYT4Xzb0RqB4H2CKnFFvI+EeBFgA14ZXLKIvAgEb4VlQ0oM/wgEV5UrIl5swK/kquqJ
776++GVI2dCln6XFvAuCU6lZLrTwtFWIHhTbPCpNjNDFhKiexMIrhZXRLz4FZvHu10cGFJAFP+8cpiw
777qNjk3jL9XT0JhlSbX3WrPHbaAy7RHQsEl8SE8pDJLxamkSSnTqDg2kZVVVRFQdN1LOsKjF8IrgpX
778RLx4ZNg5rLKh3SVuhlcSXUJRszxUASnz19+NTa4WmmKLQloCwVvguUYfyCRJwuVSAQld17FzykqW
779ZVyqimlZmKaJy6UiIWGYJqbpdByyJOFyuTBNE8M0URQFVVHOMwCduH7+8ybs953gcqnIkoxuGHlB
780IeXaYNs2hmGgqgqyLGOaFoZhXLCOha4byLKMqo7fxiTAtMbXl2WZ3r4+RkZiVFdV4vN6sd5EcUqS
781hKqq2LaFYbyLTvUaZuw7Wr/GebuWuGLDRj7FdoSLEC9XFO/lT+IWCARvwrU4sqooCsPDI2zftRuX
782y8WyJTfg93pBkujp62PXrj2UlJQwY9pUdkTDjeYAACAASURBVO/bTyqV4oYF86msKMeybQYGBti2
783YzeT6+uYNbOJltZTHD12HCsnBEzTZNbMZppmTM+LDcuy2LF7LwG/n+bG6eg5wQDODRLIC6gxZFkm
784m9V47fXtxBMJltywiJLiImzbIh5Psm3nLmRJYuGCeRw/cZLO7m5mNzcxfdoUTNMilU6zfuOrhEIB
785Fi9aSH//ALv37UfTNAzDxDB06monsWjBfGRZRpIkdu/dz+49+/joQ/fTNN1p51i7JEl6w9/79h9E
786kiRmz2p+g1i78PuMLbtwCPFS3//Nll+sTW/3/bf7mZIkYVkWu3bvxef30dw4Iy/0rjdESbL3Est2
787qsGZQm68L7Fxzq8hQtOC9xbbtvH5fQwMDHLw0BFGRkaQc9GT9vYODh4+iktVsYHTbWc4dOQoW7fv
788IJPN4lJVUuk0J06epK+/H1mWGRoe5tjxE6TTGSKRCKFQCLfbnf8st9tFS+spXnn1VUbjo7jcLsAR
789UaqqoigKiqLgUlVkWT6vnV6Pm1Qqxf6Dh+jp6UGWJBRFpX9gkH0HDqFpOl6Pl/aODo4da2HL1m0M
790DA7hdrswDIPWtjbaOzoBSKZSHG85ydDwMOFwiHA4hNfrzX+WbdvMam5k9coVlJaUYFlWvo1j7VRz
791bXSpKmfPtbP+lU0MjYzkoljnf6exf53lcv57Krl9jEU18stz647tf2zZxP1IknTRNim54ybL8kXf
792HxMlb9z3eGjwwra43S5Otp5m46ubicVG89/xeuTabbkNaOb4jV6WnPEo6Qo/91z4uQBu2RlXsWzI
793Ws7fqvTOQh42RHwqVSEXsaxJZ1y/3C1//5IxnWOvSuMOyjaQyT0xeNU3fxy238V5e7vY4FEl6ov9
7946KbNmZiGeanwtGGNzx1UZc7zi9cmiB+PcuXaey2jW875vlbHZ65BLMsi4PMxtWEyvX19dHZ2U1Nd
795TVbT6OjooqAgQn1dLbLsDC0VFkQ4197B/oOHWL5sKbKs4PG480MwiizjdruZN3sWCxfOQ9d1NE3H
796MAxcLpXjJ1p4fftOPB4vBw4dZnhkhDWrVpJIJNmxazcdXV0ossL0aVOYP3cOsixjWRa2baO4XExp
797aOB4y0naO7toapyBy+Wio7MTRZGZOmUyHo8bRVGIREKMxuPs2LmbO25bg6IoeNxuXC5HLI3duKc0
798NLB21S0gga4baJrmfJaiMDAwRH9/P+a0KfQPDLL5ta2UlpWCDafPnKW8rJSbly+jc2CQzVu3oaoq
799LS0nicdHWbt6Fclkkte2bae3b4DKijKWLllMJBRi+87ddHX3MKu5keMtJ5lcX8ecWTM5cvQY+w4c
800IpVKU1lRxsoVNyFJEvsPHubgkSNYpkVJSRFLF99ASXERPb19vPb6diLhMF6vl5OnTlFUGGXp4oWU
801FBdz5PgJDhw8TMPkOgYGh+jr62NKQwML5s/F43ajaRrb9+ylpfU0fr+fJTcsZFJ1FZIkca6jk917
8029zESi1EUjVJTXcX+A4fweDwcOnyEWCzGLStuwuN2X3f5QNemeDEtQOL+WVGWVQWRJTg6mOF7+wed
803jl29QgEjywYbHppTxMJyP6osYVg2j58YYee5BIpb4beWlLClPcGxvrTj6Pt20UzuaS7kx/fU8bOj
804w3zi6TPOTVU4Al8aG9yKxCcWlVAbdrOtK8lLJ2MgSwQ8Cp9fVIEFfO/AIMmsdfE4om0jyzKfW1zC
8051s4ER3rf4Xl7uxgWU0v87PrMdM7ENG76yUkGEvobP8u0WVAd4O6GCABb2hNsPB13RIphceu0CDdW
806BQD4xfERjr7T39n1jmGxpDbE1EIPPz48eOUfVt5HWLZNfX0d+w8e5My5cyxcMI/BoWE6u3uoqiin
807KFrE4PAghmFQUV6BLEvs2ruP2kmT8rkyF6IbBul05rwcGsuyCQWDFEULSSaTFBQUUFNVRTKZ5Nl1
808LzE6GqdpxnQSySRbtm4jk8lw043L8sMdhmFQXVVBWVkpHZ1dJBIJvF4f59o7KCyIUFVRkR+qKohE
809KC8v48ix49ROmsTk+rqLfnfDMEhns2Db592EJUmit6+fYydaWDBvLoqi0NHVTXtHF3NmNxMOBjlw
8108BBej4dZM5soKY4Si8UIhUNMqqkhmUzxwssbMAyDphnTOHrsBJte3cJdt69lZCRG25mzxGIx+gYG
811qCwv40TLSV54aT3FRUU0TK5DVRVM02TXnr3s2r2XaVOnEAwFOXL0OIODwzx0/32YpkVXdw+tp9uY
812M2smhQUFHDl2HEmGu25bSzKR4Oy5c4zEYjTNmA6SxOvbdxAKBpkzu5lXt2zl+MlW5s2eSW9fPy+t
81338hDD9xHJpPh2edfRHWpTJvSgCzLeD0eokVRYqOjFBQUUFFRhizLFx2Guta59sSLaRPxqfzr2kl8
814srmQroROSrf40qJSHpxWwOdeOEfniOYIHMsGRXb+Hss6HXPhtWznKdbKeSq4FUcoaKZTMUrNRVKs
8153N+qhM8l863V1fzOvGIG0wZDSYOSkIvhrMnOYyP80+2T+KOFJdz6aCvH2kYh5IZsLirAm3x+7v9j
816/XC+P87mxlNV+dLuwR9kLBuPW+ZLi0qZVeKjP2Vw409aONmVJBx28Xc3V6Lb8PNjwyTTJliAbjq/
817BUVyjqlu8Y931PDHi0q47bFWjrTGnCd6SXIShkzbOQ+K5CwfG/bxjP1eJkRCZMmJkiiSs10mt50E
818ZEzn5yhJyORuA7oFWXt83wCmzU3VQb66vAKA1zqSvNbegqZbKKrMXy0r56aaIACtw1mOdiUdTxz9
819Im3IWuNiPv9bzkWnxgyrxiI8EuPfaaxtem6OvZz7Pq5cFMhiPPooAS7FmU+v5bZRJWedsWtHxnlP
820wvnssWjR2GfAeITJyh1vKeejZdjjbdMt5lUFWPeRBnb3pPjJjl5sn/rBEm/vAsuyKCkuorq6mjNn
821zzEwMEhvbx/pTJr6+lrcbnVCEq/E0sWLeOqZ59m2YycL5s1Blib0QZKELMts27mLXXv3Yhoma1av
822ZHJ9HbquU1NTxYyRGKdPtzFtSgPLly1hy9btdHZ2cdONy7h15QriyQSZTIajx1uYPXMmkUgY0zSx
823bRu/38/kulq2bt9Jd08v4XCYwaEhmpsaCYaCpNNpbBxRMmdmM7HRUbbt3EVBJIxLPf+2paoqJ1pO
824cvbsObJalkUL5rNowfx8LoeqqrjdbiRJQsp9r7r6GtasWsnA0BA9fX309Pay4qZlzGxqouXkKWon
825TeKmG5eybfsOunt6WLRgHk0zpjM4NMzptjP09Q/g8TjRiqKiKPfcdQeqqvDCS+vxer3cvnY1NdVV
826ZDJZBgYHOXLsBKWlpdy+ZjXhcJhQIMjGV7fQdvYcZaUlyJJMbXU1t65cQVbT6OsfoL9/kEw2i6yo
827qKqLOTObWb1yBfsPHuLp59cxODzM4OAwJ0+dprS4iBnTp+H3+znb3sGptrMMDDrb37dmFTObGkml
828UsiKM7R18mQrUxrqWXLDIhKJpBAv7xobsG2+elMFn2wu5NGjw3zm6TNkNZNv3TmJLy4s5Wu3VPEb
829T5/htxeWMqXAw5aOJHdPCWPb8MsTMV5uHQFJwuOW+bPlFUyPejgT0/j6jj7iSZ3PLChhfpmfV84l
830WFblJ+BSWHd6lKcPDTG7OsjvzCumP2Uw83vH6OtMUloVoMir8IcrK3m4uRCAv1haRk1A5dGWGH+9
831spKqkJu0bvGzY8NsPBUDJBSXxBeWVzCvzIcswXf3DZAxnB+Ikct9+eyiUhZXBdjdk+K7+wacDl30
8320+dhAyMZExso8at87ZZKPvyLU2imzWDawMjds9FMplQF+JNFpQRcMpvaE3x/bz+/u6SMT+XO2/9c
833WsaNlQG8bpmhtMnXd/Qyo9TH784r5lB/mu/s6eeuGYXc2RDmX3b3caIrxV3NUR6cXoAqw/GhLN/Y
8340YuWMphW4ecLC0o43J9hOGMwM+plQ3uCtGFh2jCqWdw4OczDM6P0pXS+saOPZE6spnO/g4RmMb/M
835x/RiH4fOxFlcG2JumY/BjEGRVyVj2mBY3DG7iE80Ot/hxFCWb+3qI5kyeHB2lJurg2w6l2B+uY9i
836n8qr5xL87MgQmDa3NIT5zdlFSMCZmMa3dvUxlNTBhFVTI3yssRCXDDu7UzQWedlwNs5TR4ZBhs8u
837LGXlpCBJ3eJbu/po6U5x36woq2tD7OhKMrfMj0+VebY1RkK3+K3ZUUayJv93Vz9nhzJg2dwyJcKn
838Z0YBiceOD7Pu6DCTy/18cWEJrcNZ4prJTTVBOuI6/7C9l5oiL99aW0PEozA96uU/PjyZ/721h46Y
839JgTM28CyLNxuN5Nqqmk52UrbmTP09PYTLSxkcl0txoTkU8MwKCkuYemSG3jl1S34vF4kWcrnUZDL
840F6mqrKCivAzDMAiHQli5fRiGiaZpIEkYhkk6kyGZSqEoCsXFRWQ1DQmJcDBId08vmWyGAsK5XTuJ
841o9XVVbhdLto7OvB4PMiSlI8QjN1LLcvC5/exfOlinnj6WfbsP4BhGuPtZEy0FdMwuQ7DMCgrLc0P
842UV0M27bxer15ITWWq2KaJllNy+3TJJ3OkMpkUBWZY8dbOHzkGAA+n49sNpvP/Zk9s4ma6kr6+gdI
843JpIEgwFCwSCpVBpVVTAMg6ymUV9Xi6IqZLJZQqEgiiKTSqewbAsbOy+GxvJypAuijl6vl6yu59sr
844SRKZTAaAgcEhHvvlk07uk9dLOp0mkUji8bgpKIiQzqSxbBtFktA0DSl33rLZ7Lv81V09ri3xYtnU
845Rr18sjlK1rT52vZesprzlPYve/r57TnF3DMlTFOpjw9NLeD2yWE+1qRzdiTL0uogD84oZO2jJznS
846m+bJByazqjbEnt4UD04voLnYy0efOM29UyLcP62Aj8wo4MRwlpurg3x6ZpSVCZ3+tIFp2xT5VH5n
847XjFPuGWOtCfpc8l8alYRSu7HVBlyEfWpPDAtwt0NEfrjGk11Ie6bGuGOn7dyoCPJD++u4xNNUU4M
848ZUjqFk1lfvqSzoUR1yxuqg/xvbtq0UyLHx0cdJ5kr62zcc3gUiRiWZNjAxkemFbAJ+cW88vjI/n3
849k4ZFc3WQZx5qIORROBvL8qmZUcJuGa8qI+eiDeUBFyGvykdmFFAeVPmP/QPcPjmcFyE/ODDII3OL
850uWtKmK/v6OVPl5fz9dXVnI1pDKQNPtkcZXlVgAcebaUq6OIP5pcwmDaIelUkCfY9eRrDgoxh0VDg
8515vt31TIt6uE3XzhHNp2L0kxIYNnRnWR1bYhPz4zyp2fjPDCtAK8qs6cjwS2TQmimjSfk4gvziwm5
852VRQJPtkcpTLo4veePctt9WE+N7uITzVH2deXZuWkIJ+fU0wsa7KuNcYfzC+hKuRCt2w+2RylocDD
853w0+eZlVDmKc+PBm3IrG7O8VHZhTid8nYwFMHB/nHtbX8yeJS9vSkqI24WTEpyI0/PMHNNUG+sKCE
854TzQV0hbTWFju5/NzijgykCHqU6gNu/GrMo88dYYHZxfxw3vq6IxrmDZ8rKmA2zMGKRv+YEEJErC1
855I0ltxE11yEWxT+V7BweJ+pwIVcAlM7nAg0cZK6YixMvbwbIsqiorCYdDtJ4+w2g8TkN9HaFg0LmZ
856T7ifG4bOzKZGzp5r58jxE06C6IQbpm3bTK6rY+GCueiajqZrmOb4kIwsy7lpyToet4dwKIQNDAwM
8574JrZRCKZpKO7B4/bjd/vPy91y7JMSoqLKCstdZJvJYnS0hJKiouwLJOJDdV1g0k11cyfM5ttO3Yh
858yRIlRcXnfeeyslKWLb4BJPK5OW91nMYSeicylpuja7rTbq8PTTeYN3c6SxcvwjJNYqNxCgoinGw9
859lY/kZLMabpeLYCjA4OAQA4NDTK6vIx6Poyoqfp+TTK1pOpGwj86ubnRNIxwKOREvezzBON+uC8SL
860ZVn59XJnCK/Pi2XZFBdFuX3tagJ+PyOxGD6vj63bd5BOZ+jt7aOyopzR0TimaSLLSn46ucvlwjDM
8616zLycm2NVdg2UZ9KxKPQn9bpSGi5sLTESMbk3KhGyK1Q6lcZyT3F/u3WHpZ/+zBf2thJ1Ktw//QC
8627pjmCJufHR1mzQ9P8NixEe6fVsCimiD9KedH/c1d/az496N8e+8AfpfMLXUhTncl+ZMNnYxqJv97
863eQXbPjuDr99diz+o8hcvtbPpXByAR9a1881XOtl0LsE9j59mzY9b+PKWbkr8KstrgqyeVsAnmqKs
864Ox2n+T+OsuA7x/j5wUG8uVydSWE337q1mpGMyYNPnuH1tlzOg+CiSIBPlfnW7j6ODGT4xi2VzC/z
865kTSs/DTFRxYUU1/g5k82drDmZ620jWj8/oIS/nl3Py+cigHwyEvtfOnx02xqT6BIEs3FXuaV+gAo
8668issqQ7QWOzh6ZMxNMPmKzdX0pPQmfeD4yz6t8N8/9Agt08Oc8u0CKOaRdZ0hO639/Zz709P0pXQ
867UWVQZIm/X1HBlEIPX97SzQ9292Mo41G1sTO9rTPJuVGNOxvClJd4ubMhzLOtMY4MOE9TLllCy1r8
8686cYu1jx6ktt+foqjgxk+0liAP6AwmrsGvnNgkFX/eZSvvtaDLMGquhCWYfO/Nndz66OtrHm0lW2d
869ST48PUJxyM1vzC4i4JJ56FdtLPv2Yf51bz8AwxmDmjI/f7y4lEP9adb+90n+aks3jUVe7m8szF9z
8703zkwyKLvHmdPbwq3IvHnr3Sw+metZE2b5TVBigrdfGlxGaoMD/6qjY891YZblvmt+SW4ZQndsjk1
871kuWOX5zi5p+2MKpZ3D+tgEN9aX53XTs2sPFcnDU/OM6pYe3K5bi9DzFNk2hBhPKyctrOnCWeSDCp
872pjpXu8S5KWayGpqmYVo2qqqy5IaFREIhEokkhmHkn8ozmQyZTIZ0OkM6kzlPuNg2lBQXEwwG2bln
873L8+/+BKTJlXTUF/Hrj37+Oljv+SJp55hNDbKvLmznajNhFwU07Twe31Mqqmmp6+f7u5eqqsqCQYC
874WLmhdk3TnAhHLhoxb85samqqiceTTtQH54butDNLOpMlnc68Qbjouk46k8lHNTIZJ4fH+R42mWw2
875n+BbXBQlEglz4NBhnl33IqWlpdTWVHPoyFFeennD/2PvvMPsKOu+/5ly+jnb+2Zrkk1vQCoJJJSQ
8760FERUBQRFQt2RUUQCzyKIvK8dlFERZqIdAIkhJAEQgqkkbolm+399Dbt/WPmbEsC8ZHgAvO5rpRz
877zsw97Z57vvO7f4Vn16ylvqEBp8OJoqgkk8lBC47L5WLWjOlousGTz6zi/oceZvXadXg8Hk6aPZOe
8783l4e/tdj3PfQw+x6Yw8TJoynpqqKtLV/6bS1T0AqlSKVSg9e08x2BGHomFOpNDnZ2UyZNJH2jk6e
879f+FFnl39Aq9ueQ1BgJnTpxEI+Fm99iXue/BhnnrmOSKRCCXFRfh9Pra+9jrPr1mLoqpHWHneDYy5
880d/2kqqPpBh7JGrCsty5BMN/GVN0goerI1tv0Kx0xkAUagqb5q8grMznfBcCHp+Tw0SlzkC1hMCHH
881hWWxp2EgBYJAe9TsMB7JVL//+3Injx4Mct3JhVw5LY9vLijGEOFbq1sRrQvssvwpTirx8OuzK8y3
882Wys6SRJgZpEZqvf8oTBaQgOvRF8oNWgKPacmgCwKPHIgyJP7BkZGm9gcFZcksK8vyVfWtPL8ZRP4
8831vxiHKKAokPAIVIZMMM4f7u8gj+urMQhCkQVjaos5+CN6ZNFkGBja5SPTs1l0Tgf04s8PN0QZlG5
884jxW1WWS7JFYfClPsc+B3iKxqCBGMKCAIbGiJ8ckZ+UzL9zCQiOKSBLZ3J/jG2nZSvQmmTMhG0WFq
885vpuZhR4O9Kf4f9tMYXA0w0FTMM3TDWGunV3AtxeWUBlw8r31Hcy2BJVmGBQ4Rb69sJhLJ+UgiQKG
886Ad1xBXnYYHPA6ssdVl+WBIFch8CXTinkE9PzcEgCmgGhpEqp38G0AjdJVWdrRxxkkS0dccAcNKuz
887nQhAXZ6b9i/PwGUJh8n5bkKWeGmLKqDpxBWzQ7eEFZKqjqob6ECpz0m+R0ISBF6+sg6nLCAK5v3n
888cYjIgkB7RCGa1nBKAnFFRxTAIwt4Ld8vSRjmu2Nz3GQibObMmoEkifi8XsrKStEs4eByuZg+ZTJ+
889vw9RNKcQCgvyOW3xIg42NA5OERUVFjBn1kzy8/OOGoViOv0WsWzJYuobG9F1A4/LxcrlZ7Ht9R30
8909PaS5fcz/5STqa2pHnzAD0fTdSbXTSQWi6HrOhPHjx8UGKIoMmF8LalkCpfLhaKoeDxuTl0wD7/P
891S2FBIQB+v59ZM6ZTXl7G0cLydF2nYlw5YOD3+xEEgVkzplNaWowBOJ1Opk+dgt/rRdcN8nJzWbpk
892MfsOHETXDbKzsrjg3JW8umUrkWgUARhXXoYowLhx5cgOmYDfbx2fztTJk3C73Ozdd4BkKklebg4u
893l5OTZs/E4/ZwsKERXdeYP/cUZs2YhtPlxOV0MmP6VPJyss1Qa1Fk6pQ6RMzpoYL8PGbPmkFhQQGa
894ppGVFWD2zBmUl5YiCAJLT1tMdlYW7R0dKIpCZUUFLpeLcr+fi85byY5du4nF4+RkZ+N2u/H5fCw7
895bTEHGxqPmTPm3cDYEi+iQFMwxWtdCRaV+7h0Ui6/29ABusHyGblUZDlZezjKTuuND6DYK0NSY3qB
896KRgOhxXaI6byfq4pwu0vd5LCnDJ4rTPOmVUBwIxiQTDfbgEU3cDjlkjLIs0tMb55MMzB5Sl+v6KS
897+aU+3E5pMPQ1ouiIHpl7z68mnNJZel89H56cwxdPLkTToTdhbn9SnrlPpHTcbnnQzLW+NUaJT+b8
8988dlcPDWPR3f32WGhx4HfKbF6zwB/3NHHp2bloxuwuydBQjWIWo6hP9vczar9QUSnSI5TpCWSxmM9
899gFXd9CF5tSNOUtX55Ix8JFHgl6/1MDHPxWWTcxEReLktxoD1oC4POAcdUmdaoqItqphtAX0JDR3A
900Y07ruERTSLdHFZZVBrh+fhE3vtBmjqujHsQpTee+vQNcPTOfa2fl0xJWeLktyrxSLwCKZvDRuUV8
901bFoet77SxdrmCH+/sBpZFEYM065MX7buiZii84FZBXxuTgG/3NbDv/YF+dP5leS6JFTdQNENnJJI
902ScBBW3OEmmzXYFv9CfO4G4Ipvvx8K+GkRp5Pprk/yZWzTFO9QxRAFAZ9f52SgKwJCNYhhtIaqm6Q
9030nS+8FwLe7sSeDwSalpHcIgggCwKSKKAw2pHHzmjYRpbUprpVG37u/xbqJpGeVkp1VWVGIaBoqQH
904k635fF7OPnMZhmEMWhsURWVS3USmWgnLFEWhtrqKuokTUBTlmFlYVVVj2tTJzJwxDV3XSafTOJ1O
905Tlu8cPCFQdO0Y05LaJpGdnYWK84+czDEOeOXI0kSpy6Yj2D5aGRETWlJCZUVFeiaRlpRKMjP47yV
906y9FUbUSSvOHbmDljGnNmzxy01py3cjmapqMoCl6Ph+XDzoeiKNRNHM+UyZMwdJ20ouBwyJx95rLB
907WRzV2s/ZM6cjSTNJp4fKDiiKSm11FRMn1AICuq6RTitoms7UKZOYMX0KYEZsqaoZ0p2VFWDl2Wea
90851BRcMgyy05bAgak0mmqKiuYML4WRVFIpVIUFRZy4Xkr0VR10Goyb+7J1vS46bujKAppRaG4uJBz
909y84GQcAwdNJpBUVRmDplMjOmD123d6OAGXPiJZnS+NoLrTz+wfH89pwKpha4GUhqfHVuEe1Rhe+u
910ayee1AafAz9YXMqScX6+OreQUErjH/sGSGmGGZkyzsfm6gAxRafI5+CJ+hB+681OFoXBUFwA1TCY
911VubjZ8vKebEpDAKcM8EMZ33hUIRUWKF+wOz831tUwn17B+iJq+R7ZBaV+1hQZoa3umWR594Y4HBY
9124TOz81ENg7Sqs60rMZiW+lAwzc83d/HYB8fzl/MqOT2UYnt73J46OgoCDL6Nuyzr2E3rO1ha6WdC
913rouAUySlGTzVEOIjU3NZWZvFQEwh1yfTFlGIBQc40J8Esvn2wmJcBqxuifBGb4qTSzysa4nyamuM
914plCa5dUBDoXS7O9PkUyqPLh3gMum5PLXi2toCaW5dnY+h8Np1tQHqbOEjN8hIgmgYAbt+J0iugHf
915ebGDBy928d2FJezvS3Hv9l4MS0RlBHO2S+KVNwY42J9keqGHrZ0x2ntTZLtNISuLAhFLRI3PcSIJ
916AYq9MqGUZgXoCEPtGUPtumWBSNpcryrbydLqADXZLnTDoD+h8o99QRaU+fjjikoerc3ic3MKB9up
917706wrTPOKSVezh2fRXNfkolFHm5si+K02s/cM5nrYmkZPA6RbJdEV0zlmYYwX5tXxPkTsskWBWoK
918Pdy/ZwBV0UdcU0Ewz6FmmNNtDcE0SVXnzKoANy0fx29f66EnptopBf5NtFGp/DMYhnFUJ01FUQan
919UgTBLB2gHkO0HGs9MC0dmemO40HXdZLHcBrNiI3hjD4ucwrlzZ1OR+/j8OWPdj4URUVR1DddZqjd
920o2zPEhXDMUXi0ZfPTF0NfoYR53D4MWcy5GYcdTPrH+1cAVbW4SOv4+hz8m5kbIkXAFnk1cNRlvz9
921AD9cXMZFE7MRBYG1hyN8bU0bDd0JcIrIomluPhROc/WMPJrDCjesa2d/p5kXY/mD9fzy7Ao+e1Ih
922IvDr13pA1dnXn2J7V8L0fZEEDofTbO9K0B5RaI8p5LklPn2yOZjH0jqff66Fe3f0YThFfr6liyn5
923LqYWuJmS7+a651u4fVk5l03J4eW2GA5RoC+p0jmQ5JyH6rnjjHLOH5+FAKxujhJTNLZ3JWiLpnlq
924f5DvrGvjE9PzuXZ2AV/pbSWl6XZei+FYEbzbuxJoOua0hVOkcyDJ19e28YNTS2kKpXDJAvdv70MU
925BG5cVMw3F5WQUg2ue74FJIGfb+kevGanjc/iiYNBHt4/gCTC0/UhBoIpnmkIU+SVWdUYJq5oGDp8
9265ulmOmMqF03MRq4UeLI+zLfXtdEddIsK+gAAIABJREFUTFOV72Z7V4JdPQkz2snqj5vaY7RHFbZ2
927xrh2VQs/XVbGx2fksa45wuFQGgToiClmH0yoqCmNv73RzxVT83hoXxAwaAyafTKY0ljdEOa0cX5O
928HecjrRk80RDCLQmoBjSGzOU6YmY+mUy7bRGFx/YO8NvKAGdXB4ildf65P0iJz4EuwC82dVHsk7lg
929QjYXTMjm6YYQV8/Mxy0JpJIq5z/UwC/OGscH6nKQJYG1zRGiCY1m615piyggwM7uBIIBcUUnqRps
930aovRk1ARBbhxTSuRtM6V03NZUO6jPaLws81dBJzS4Hkzg8QMNrXH0DENXI1dcb7xQhufnVPA5VNy
931eXDvAD0RxRYvNjY2IxDWrl1rzJo1i9zc3ONaYebd+9jVFjP9NBSBleUKt01JElKHBpdsh8ENe908
9322fofFGZUdHPAyjRrhVFnXvOeuXQ8K2qzmHPPfrYfjgxlwM049x1t/UzkgsFQWHKm3WEhgiPQrDwd
933ksCgw8zwNoe3IQpD7ar6yNBnwfrLMIb+r5k5aCRZNKek/t1TpQhcWpXme3UpgopAtsPgpn1uHhte
934ENP6589zEszI0kgcpfp0jsPgtnoX9zY5x2YtqkyunOHnM5ODBMzzbhjm9Rk9xTD6uglWO/qw4xSH
935fc70k8w2hicSzFxnWRz6f2b9o+2rbu6jaLU3uMnhfU7gyH0Z3kcH/28tl1ln9HKj+7JhMKgIhq8H
9361BW4kQSBve0x8rKcPPahWhaP83Peww08vS84dI6G9/PBc3CU/c78NvxzJu/M8HMnjjr3R1vPwMzb
937lPltrIkWDaoDOn+bkxjRbTKIgnmYn9juYX9IMgudqgJnlij8fFqSiDrGjsfG5gST4zD4zSEnvzvo
938wjjW8yWu8v3lFdy0qOQtb/mBgQF27tw5Bi0vGRziqEpXjBj4siwfkYz5GUEYOe1ytPUz/xGGf2ZU
939fpVRZ84xbPCVhJFtigzzZRi1nvwm28/8I2XmhY0jVrcZhjDsnGUYfS0EwbxWo8/50a7b8DbfchvD
940vhBGL3eUiyaMur4G6PqoRTPrCkdZh2G/ZbaX2fcjfD9G9eXh+zRcuA9fT9WZV+rlb+dX0xtT8Lok
941RAFueLGNpw+GzH6bOW8jjpuRQmn4fo8+9sHtjz53x7GewJH3jo2Njc0oxq54gaM/0K2B7kcvd1IR
942cFDfnzSFylGXPY7v3urzv7v+v7N9W7AcH8c6T8d7zY/2/fFex//k+h5vu2/nvr1V/5IE1rfG+OLz
943rVb0ksGWzjivNIZHRve8HffO//VavNm6NjY2Nox18XI0rEFt1d6BoeJtY820/C5DwKpDqVt/bN67
944CCLNvSl+1d459J0kmMLFwLZ4vBXDKh7Y2Nj893h3iJejhJm+LaHFad2cXz+RAihT+8g5dkM+NSAg
945G+S7jbHp82LzNmKAC/CNzi1kX/fjQoNCl32ubGz+24x98aIZQwXn/tNIHNVywLRExJLaLKYWuHmi
946PkR7OP32CxjdYOWUXCqznDzVEKK13wqHezuO5W0koghcUa5waakKgj0w29gck2G+/aOddW1sbN45
947xrZ4UXWq893cc14VzzaF+fHGzqM/9DNfHWswETDrJuW7uGVJKb/b3svGg2G+v7iEM6oC6IbBXVt6
948wHk0x87jaJtjLKMbfGdhCUvG+fjwYypnLSjB6RD41DMtZqrtMTLdZWAGj7lFezS2sXkrDKxpVhsb
949m/8aY1e8GAACPz69jCXj/HxtTauVhtMYGUmRCcccHso5PEQz83okidx55jgunpjNP/YNgKZzyyud
950bGiN8UJz1LTGjA6vPlbbw0NFM7+Pjhiy5sUz9WdawgrPHY7w8MU1vNGb5PaMEBsb+sWMbP1v74SN
951jY2Njc1xMHbFi6JzcqWfSyfl8stt3bzWEgUE5lb5ufW0MqYVuElrBn/Z3cdP1neSVHS+v6yMiyfm
9528FRDmPMnZOOVBf55IMjNa9u5ffk4zq01S7L/+dwqflfmJ5jSWFTu47mmMA3tGrOrA/z49DJmFnlI
953awb37ennlnUdJBSd755WyqWTc3n+UISFZV4KvDJPN4S5cV078aTKlxaWcP28YgQBDvQn+dLqNna1
954RAcPxyUL/HN3P5vnF3PdSYX85vVe4kltTPjBGIBHsi0vNjbHS1ITSOhj5t3DxuZ9x9gUL4b518Iy
955H5KIaRlRdGbXZvH8ZRNIawa/3NrNSSVebj61FJ9D4pvPHKY628msIg/5Hpnfv9bD+RNz+Nb8YpqC
956aZ6vD3FmVYAp+W6ebgyzoSHMJ+cWclZ1gDu2dDOhxMvqyycgAHdu7WFmkYcbFpbgd0h8+almqqy2
957Czwyf9jRyzUz8/nq3CJ2dCe4941+Jue5uHNrN6pucMtpZdy1spLT/7ofxap5IQkCpHWebQpz06IS
958Fpb5WFMfGhPixSsZrOmV2dYnm0m1bGxsjo0mMC9fZWmBetSkjzY2NieesSleACSRqQUuFM3g4IDp
9596Hr55FyyXRJfXdPKnc+24C72sPuaqXxiRh63vNw5WOX25g0d3L2mjfUnx3jxiolcMCGb8+87wOXT
96085mS7+b323vZsKOPq042C80lVJ2LJueQ75G5/sV2fvZMM44CD9M/OZmPz8jj+xs7Btv+2eYu/vfZ
961VqIpnZ+fWc6sYg9/2axw++YeSnyyaXkZSDGj0E22VyZTRT4zxO3tM2tSzCrysOZg8J07n2+CW4Qt
962AxIPj9UMuzY2YwlFQJINzilSSbx1+R8bG5sTwBgVL6YvSanPQVzV6Y6rIIsUex0A7OpJglsmqRj0
963JlTK/W7yvfJg4cOWcBrcEikrLbwogOiScFsZeP0OEVzSoH+tSxIpGWw7AS4JRTWLO47PcVEwrO2E
964qoNbIm2JkpRqUFfk5YGLq5lT7CWtGYgCDCSPMqoZBp0xsxiWNIaijQzM4r047FBpG5vjwW0nAbax
965+a8yOtnD2MEwiCo6fodIdbYDFJ19A6bV4vRKP2g6E/NczCny0BZVaA+lBwXBySVe0AyWVvoBODiQ
966Qk9qg6VoPA7RrD1kkVR19vZbbVf4QYOaXCenlHjpiCm0BtNmFWqGREdmtidthUPPKfby5dWtVP1m
967N21RZbDi72i8Vu2luGq7x76n0Q2zjw3/MzpERRu1zPC6Wsaw34avZnBku8ezjI2Njc17iLFpeREE
968UDReaoly5bQ8JuW52SZGuGdnHx+sy+GmRSWcU5NFdbYT3TC4dWMnyZiCaL0NXXdSIZdMymFeiZeW
969cJrfvdYDmsELh6N8YFIOf1pZxYSAE6dkColct8Qju/u5ZmY+315QzBlVASqzHEiiwC0bO0nEFHLc
970ZlI8j1V3xWOJkIBTZG1TBIDr5xdzUV0OVVlOwLT4ZGowyZKZ2+X0ClNQ7etLjqlcLzZvIwYE3BK5
971bnlEOaRoWqc3oZrCRtEpyHWZVkDMr7rjKkkrfatDEinNdmAAHVEF1RI+siRQHHAhicKwOoYGrcH0
972iJpEFbnmMmBWbu6MKXZekjGKAfglA8fYfZUck4RV4YggT5v3D2NTvAAIAi8ejpJUdS6py+G+nX10
973DaQ49x8NfHVuIeMCTnb2JPjLrn42NITAISILZq2WP+zooybgYGtHnD/v7GNvZxw8Er99vQefQ2RC
974rouutM7D+wdoCadpCKYJxlXOf7iBr84toirLya6eBPfu7ufFhhA4JZ6sD9Gf0Hi1w6yo/Up7lP/d
9752sPa5igvNoW5+ulmFpX7eb0rzpP1IYq8MlFF5/49A+zpS1Lfl0T2ylxSl8PeviRbOuJjJs+LzduM
976qvPxkwu444xxSOKQte5vb/Tz8ccOgQCfnlfMD5eUUuIbugVX/qOBVfuDoMNVcwv53TkVKAZc8XgT
977j+7qB1GgJt/DqkvHUxFw4rCsewlV5/bN3fzopQ68ToEbl5Tx5VMKcVj9qzGYZv5f99MbVcaEg7jN
978SFwirOmVaYkfo0abzRGIAqwoUsiS7Zw771fGrnhxiBzsTnDHlm5uWFjC5TPzeWBnH71Rhe8+2zJk
979JneIZup9TbdSrghsao/xw+291m/W75jVfX+6rt3K2GuWhL5/a49ZHsAjMRBT+d5zR2kbeGhnPw+9
9801mu25xJZ1xRm3f6guYxD5J6tPdzzavdQBWPDALfMn7d1g2IgukR+cnYFE3JdXPBwI+FoerBtm/ce
981TknAKQk8eiDEHZs6QRLpjimIwI+WlnPDwmK2dyf42BNNpFI6C6v8xBUz9lZ2CHxocg6SKCAB59Zm
9828+jeIGgGIqalMKJoXPWvZmRB4PcrK7lpUQkvt8WYVeThG/OKeLoxzC3rO5BkkTOqAoNCx2bs4RYN
983Hu5w8Gq7A2T7SfyWGIAIC3JV8h2GLV7ep4xd8QIgCtzychdx1UAWBOutUQDPqN22Om/GLO6SBPDK
984HGGHFbA8U4fhHNaGdJS2B5ezhFBmWVm0BBCZjR5jPQlkA59boi+hcs0zh3nyQPDIfbN5T5Hpi/v6
985kqx/ox8kEUSBJVNzuX5+EZ0xlUseaeRQR9ys9NwSNfuEbjC/OsCZVQH+9kY/Mws9nDc+i8KAg57+
9865KAuDisaTx0MYwSTfHByDldOy2Nynoup+W4ADofTvHIoAorOhsaQ2T9tATMmMQCfZDnL2+LlrbHe
987PTPTpjbvT06IeBHAzH+g/IeDpSCQiOvcuqrNHHhd0pv0VonrXujkxo09dETSgATKf7b5tw1BIBIz
988uO35dkAwBdTb4UOpCCQ029I8lpmc7+bMmfkgiuzrjjO/1IssCjx2MMihnoQploeXoBAEVtRkIYsC
9899+0ZoGVcmhsWmmUsHuwxnco1w8AnS1w8ORuHkMMFE7IxgPWtMQ72p7hsSi6fnV3A2dUBfvJKFw/t
9906Sec1EaKbRsbG5t3MSdEvMQ1gYtKFGYHtLc5nkl9019TWgJVN3Dni4POimOTNz+O40aH8X6NuJ0o
991a8yRCRy6uC6bi+uyAfjMqsODgT8xRTcF7IiSEgZOt8T5E7IJpzT29ibRdYMbFsLHpuXx4Ou96Dqk
992NINxAQePXFILwOtdCW56qZ1t7XHQdc57oJ7PnlzIhybncNfKSj48JZeP/quJnqRq+1nZ2Ni8Jzgh
9934iWlw6I8lWUFJ6L14+H9kzkqpQvEbevLmCMTYfTnnX3c9GIbSCIDEYWPzMoH4LRxfjx+B4mYYlpE
994dAM0g1Nrspia78YpCez+1JRBp9t5pV4qi9wkVB2XLNIeVbjw4UY6wylCmkE0opiWSQ3W7BtgTWOI
995UyoDPP7BWs6uDrCsNouHdvXZ4sXGxuY9wQmdNrKzT74z2I+jsUs4rdE2kDJ9XoAn60Ps6E5wSqmX
996355TwQ1r29A0gwWVfhr6knxoUg5OSeCeXf2sbQyhCwKfml3A6ZV+Fo/zs6Y5YtUBNTgcTtMzkAKH
997ZPpW6QZXn1TIa11xWgdS9CdUrDyN9MTHyhyqjY2NzX/O2HbYtbF5l5KJ7vFmHLslMwy2M5TmqscP
9988bOzxnHV9Dyump6HYUBC0/nkM4c5d3wAgDu3drPjYAgMcDhETq/089FpuWzvTuCSRNP3XBastoXB
999xHTnjs/i7nMrMazi5wlV5+YNHWxoidoOuzY2Nu8ZbPFiY/N2Iws8uDfI650JWiNpUzRkdINDZEdH
1000jHP/0cBpFf7BTMzhlMb+/hTXxFRSms6eviRkOcGAR/YHORxKk1B1WsMKKx+qx8BMajcoSARAFvnO
1001unb+tLNvMF9dd0zltcMRM1LOnjJ675IJZLAvsc37BFu82Ni83QgCLQMpWnoSprgYHeXjlFBVnRcO
1002DCvMaYmPFw6kBpfBygwQSqisORA0TSkOgQ0N4WHLDHtaiQL1PQnqO+Mj9uWYYfw27w40AzTduv7i
1003kd+LVhoJHfP/b5eAyXiX21FqNmOQEyJeMnkLnHafP+HYDrtjFEkA6U1Eg3gMUXG070Yv+2ZiRBbt
1004V5L3ErpBeY6TUp+DUErjYH9qsAxEabaTcr+DUFzhgsm5fGRqLt98oY21DeH/PI9UWqMox4XPKdI0
1005kLYHGJsxxwkZ5jySwVNdDvaGJJDsNEInDE1gZq7K2YWqmVfn/4iAGSGG+ja+tdnYvFdRBdL6O3Sr
1006qDqLx/m5/8JqdvUkmPuX/aStMPsfLinlmpn5fGttGyV+JycVe8n1SAgJDUMzTAGTmVY0gLQ2Mnt4
10075jer1paZZ8hcds44H3+5oIaXWiN88V9NGD7HkQesG5C2LD9OcWgbMGQ5TOtDGRszPlrD90UaZk0a
1008/E40LUqyaPtp2RyTEyJe3CK82CfzwmGHmTXS5sSgCERqDC4oVv+jyC7FgPFenbmFqp3h08bmrVAF
1009qr36YCTXCUUSef5QhK6YSl2ui5lFbrYeiuL1OVhc7kfTDf62t58vn1QEmOVRzpiSg+gQea0rQV/U
1010ijIT4LQJ2QScIpoBG1qjRGNm3h+nU2RpbRYOSSCu6PRGFK6bV8T0IjeHQimW1mWzsStBWh1WBVE3
1011yPLIzK/1EkrpbOmM4ZAE5ldmIwnwcluMdEJlToWfUkv41A+kONCdAFFg2cQcPA6BlrDCrrYYoktk
1012XnUWbllgf3+KyXlu6geStITStq+WzVE5YdNG3ky6a1u8nFA8b5Z0+DiJqAIXl6pcWmaH09rYHA+K
1013IRBRhRNvfREF+qMKj9cH+fSsApZXZ7Ftf4jFk3Koy3OxpjlC10BqMCnnDQtLmFrgxiUKPNMY4oP/
1014bERA4NcrKrlqRh5YUWgbW6N87LFDtEUV/nJeNZdNyUHXDQZSGs81RfjApBwE4IKJ2UwudLP43gN0
1015h4cV9lQNpuS7efbDE3ijL8lJ9+wjxy3x6CW1eB0Clb/dzRkTC/jDikq8DgFZFPjFlm6++0Ibt59d
1016wedOKkAAgkmNq59p5okDIe4+t5K6PDcvNkc4ozrAN19s4451HRijS7rY2GDPjttgvkwpOqj2nJGN
1017zXGRmWE54QiAalan/+SMfM6pyeKnPpmlVQEEAR47GISEhmztTH1/iisfbeKRD45nZW02xVlOLpyQ
1018zVUz8rhrey83rW7lgzPz+fXyCr59agmP1Ye4bHIOWzrirHiwnuosJ0lVZ1tXnNuXlfOn7X18e00L
1019fYphOvBmkoProFuvTQnFdOw1DDNzdEqDUr+Tm08tIcslsuIf9WxrjVGZ4+KTJxXyuTkF/GBDJ7/a
10203MVLH5vET04v47XOOL1xlSn5ML3Qw8P7grxu1f2ysTkatkutDWC7utjY/Du8o/eLLLKlI86uniTz
1021y3wsm5DNitosumMqTzeGMSQBwbK83L93gL2tUfb3m3Wwspwip1eYuYP+uLOP7oE09+8ZoCOiclqF
1022n6Ri0BpVmFfq5cGLa5hR6GFfR4xwypyHjqY1+gdSTC9ys/qqSbx8zRRevmYKSyZkEUlZomXYrhqY
1023U1fhlMaG9hgG8KuzKvjWgmKaBlLMKfKAAJfUZfPQJTVMzHMxKc/NpHw3imFgAN9a18Zl9x7ghcYw
1024hl3A1uYYjG3Li5V4CzAVuCiM/N4KL82kVh+BKJivAseaU5HFoRFI1UcuN3xbo9sevt7w34Z/rxnm
1025b5l2Rrc/ehv/ZQyGfOnsMq02Nm+BdUsrxjskYiSBWExlVVOY2cUePjWjgNlFHh7YM8ChnuSIUGZV
1026NzBkEdkaWzQddKvQlmYAuo5HFnHLAklNYF1rhDPvO8hn5hTw8el5nH1BFWlDR9XMsVMHMCCpGhwO
1027K7gtS0g8rWeSRqMboCo6cVHAsPyEk6rOZ544xIHuJOfWZfONhSWMz3cTSZvjeV9CpWEgxY7eJElF
1028pzOq4JVEVN1gd3cCwyXZIdo2b8rYFS8GOGWBqnwPDlGgKZgmkdZAEPA4RGoK3UTTOodDafK8MiV+
1029BwKm6gfojas4ZYEsp4RhGIM18ERBQNENGoIplLQOqk5FoYccK/xUt9KuR1I6pDUcHplJRS4EQSCt
1030GezvipsNSSI5Xpkyv4O0ZlDfnxp88BcGHBR6ZdqjCsGERmWeG79TRAQEa/8Oh9OEkmMjxjkgG/y9
10311clzHbLtsGtj81aoAueWqVxWniaqvkM3sADPNIT45txiLq7LRgAetzIww9B7UCYfYuZzXNVZ1RTm
1032g5Ny+PrcIm5LqHx4Vj65Hom/7unnlBIvVQEnd2zsINct8cmZ+RT5HGZINnBSiZe6qgD7+5N88uGG
1033ofFKEKgr85JQDSbkOllcFWBeqZeKbAet4TTjshycV5vFg/sGaIikWVrhp9TvYNOBEACHQ2luXt+J
1034zyNRm+1iX18Kj0NEEgQzO/UYGBdtxjZjV7yoOlV5HtZePpHygIPfvN7LF55uBl1nZpmXTR+fxKrG
1035MCvvO8jHphVy51njRqz+iy3dTM53s7I264imO+Mqc+7eS2da5yunlnDzqaXkDHMKu+iRRh7f0ceC
1036mix+tLSMs6oDg7/dsaWb217upLs/xaWz8/nDikriqs6HH23iqTcGQBb4/JwCvr+4lE89c5g/vdbD
1037XSsqWF4zcj8uf/wQD+7oYywkw3EIcDghsLNPBqctXmxs3pS0wIzcIT+TdwRJYGtHnBdbI5xVFeBQ
1038KM36tiiGCBzFsJvB55S4Z1sP0/I9fGVuIR+ZmgvA39/o50cvtLF0QjYPXFQzmOvwb7v7eWh3P0nF
10394MXDUZZV+Vl1+QTm/3U/3TrDQq8NGvqS/PjVTn64uJSXPjKRDa1R84UM0xrzhZOK+OO5VQC80Zvk
1040O2vb2NIep9Ar8/V5RXxiplmk9IZ17Tx/KIxugGGbfm2Ok7ErXgYxO/Pn5xSwqjHME9t7hzJhCyP/
1041vXNLD3dt6wZZpD+p4ZEFAsAVswv49oJi/ryrjztf6UQVRAaiKj87axzfmFfE5o4YX3qulURKY2FV
1042gM5wmmnlPh7/8HjyPTLXPNPM1kNRvrCwhK/NLaI84OCKfzSgWeZYryxy29JyNrfH6OlPDyU9tf7N
10431Ln5/HOtbDwUAofE4VD6P08k9TZhYGko2bDz8tjYvBXyUFqTdwxRIKHoXPH4IYq9MjFFpy1iVSQ3
1044DG57pYu7Xu/lcFjBcIp89tkW/E6RhmAaTRD42uoW7trRi0MS0HSDN3qSoOqsaY4w68/7EKxZ9l09
1045CWuqXuCSfzVSkeVE1Q36E9rIaW7BbOeWDZ08sj+ILAo0DKQo8sq4ZJFDoTSXPtaEzzpRHTGFnqBZ
1046oPSbq1v5y64+RKu9A/0pDODSx5pwSwKNwbQ9ZWTzlox58SIKAt1xFa8s8vMzylnfHCFuebdnch9l
1047BpH2qMKe7sSQKNANiGvMqzatHi1hhZ0tMQCWTM7lq6cU0hZV+NCjTbR0JkAW2dkVB1HgTxfWUOiV
1048ufWVTu5+tRuAb6xtZXlNgMsm53JndRZJK9FDUzDNtAI331tSxhcfa0Kxcq4YmR2z/n21PcbOgyFw
1049yeCVTUeT95NWMICUNVU21lPWpzVzwt8lnTgT9vBkXS5xZKp/G5vRiAK9EYXeUHrI3w9AEOgIpekY
1050GPKza+5PWs5smcKdBnuHl42QzMRyoYTKrqgy8nur3VBcJZT5zSEeeR9YfoV7OuKDn5viVjiSLNLQ
1051m2DEm6bTuucN2N0xal9EgYaexNA+27eCzVsw5sWLQxToSaj8YX+QGxeVcNOSUv66u39QuMCQSLjl
1052tFJuXlwCwNVPN/MPa1omU/zOmcnmKAgsLPchiQLPNIRo6U2CRzZvGM3A65aYVegGYN1hqxqvQyKS
1053UNncEaM628msIg9ByyP/xcMRdvbIXDengMf2B4krIzPGZXx6L6nLpsYvo4gCLzRHiKa0sf3AymTH
1054HF7UT9HNA3L8m9kvDQOvU+K02iziqs6G1ih6xhHpaGhW1s93+qFugCgKLKo1E3q91BIllh52nTLH
1055PxxROPrg/hbbccoCi6tzcIoCG9uiRN7J/pDJjgrmfjuHibTMuYeRGVDfT6jWdXaeQPH6f0ESjn7f
1056jf5+tOXCqos1AjM06NiBA8fa1pu1+2b7MLgOR+9TtrXF5t9gzIsXAI8s8tvXe5mS7+ErpxTRHVOJ
1057Z6KQGBrvH68P8czBEEgC2yxLyuAgPByBwfnqtJ5xqR9JRhClhj+oDEhbn4ff7zFF59ZX2lhS4efW
105800tNwTOMzPTSdxYWYxgQSmks+NsB6uMq7+zE+XFiGIiiwDeWlDK7yMP3N3aYmTElgU+dUsgZlQHu
10593tXH6oOh43+wqQbleQ6e+fB46oMppv9xL6lMsblRCLrBhAI3151UyO2bu2kJpt65fA+6gdMh8ocV
1060FUzJdzPprj0c6FIH75Rr5xZyekUAv1PEJYtE0xpPN4T58/ZedP4NR0PVIMcv88CFVRR4Hcy6ey+7
10612uNHPmBOBJpBbb6b7ywoxucUOdCf5PsbO62wEYN5lX6+coqZsfXJhjD37ep7X+XbEHWD2eV+rpyW
1062y482djIwvHq3jY3NmOBdIV4copm2+voXWllW6ePr84rwyCKKPvINeM2hCHe/1G6+Lbkk8639aElj
1063dYM2yxx6WkWA3BwnA8G0KSR0g3jCoDmS5pRSL7OLPLy0Pwi6hssnM7PQC8BrXQnG5zgB8DlFGtpj
10643PhSO79ZXkF5wHHE/gNc9ugh1tQHMRwSkbQ2dt80rBDQ88dns6TCx++293JAN6fTllX6uWJqLls6
106546zeF8T0FrTSdmYUnzhkekbVB2unRNM64ZRGLPPGrxtDofBgtiGY6crvv7Cak0u8/GJrtylARckK
1066OTeGlj2aeVkZtkxGpWbC1fXMfmYOclgbmhX2ruskBYFwSiep6YzqYpxdncUHJ+WwpzdJY3+SlbVZ
1067fKAuhyKvzI83dAzFlo7efia8P7Nvmrk70bSOS9JMY07m98z5y+xzBikzBTCqrUxBGkk0t6eZImRE
1068KMrwvqYbFHllPjXLdJhMaTr/3B9kV2sMRIGPTs3jCsuxcyClcd+OXmufh12rTJuD1zBzIYyRx52p
1069fDx6veF9Y/gxZConjz7GzLUyjrE9gTfvf6Ovh3KMfmsI5AZkHvlALYUeiZs3dJjn0hYvNjZjijEv
1070XjJWTZ9TpLE9xg3rO/jd8gpZOl0EAAAgAElEQVTzx8y4Zi1bm+NifFUAZJFIWqPbmn8d4T8rAJLI
10714wdDbGyLcWq5j3vOq+L6NW2oqs6iqgD7exPcvqmLFTVZ3La0nM6YwrbmKNctLGFmkZsH9w7w6qEw
1072004uNNu1zKB/2NbDueOzOX981ojtZqw0wZRGMKaaET3vgsEwYhVZU4c9QGOWJSuS1sAp8vtzK/HK
1073Iju7E1w2NZdwSueOzd08uT8IhsHsch8/WVpGoUdmV2/SSo1joGgGFbkufr+ikmK/g3ha486tPTy6
1074P8hfLqhmVpEHA3jq0vH8z8ud/H1bD59fVMpVM/LQDINfbu3h/l195gM78+w2DL56aglXTM1FN2BL
1075R5wb1rUTjCl8e3EpSyv9PNsU4YxKPz6nyL/2h/jtth5U1aAwy8HPl5UzJd9NfTBFwCkOWtmGk7H4
10763bS+nUfWd/DRZeO494IqLqnL4eebu/niyYV8ZFoeumHwanuMG1/qIBgzhfLVJxfyyRn5eB0im1pj
1077/HRLF4puxleE0xoLarP40Wll9CZUPv9sC0vrsvnuwhIEwawLc8O6Dhp6EwgIfHxOAdfMzMcpC2xs
1078jTGtwM0/9we5a3M3brfEDaeXsbI2i2ha4wcbu3ixYaSVTNUNgkkNSYSAU2J5dRa7mqMU5bq4uC6b
10799qhCmd9h+pepBosmBLj9jHJckkhvXOEHGzt5uT7Eskk5fGtBMVs74mS7JOaUeNndk+B76zvoDqaZ
1080XeHjf88ch98lEU5q/M8rnTxfHwbDYH5lgFtPKyXXI/FKW5zygIOGYIpvvtAGqs5VJxXw2dkFAPxp
1081Zx93vdrNgtoA319cyvauBAVemQk5LrZ2xnmqMcTNp5aiaAZ/3NHHg7v6AJhfFeCWJWY04drmCDe/
10821IEuwK9XVpPlFNncEeeSuhxiis5PXulia0eMv19UQ1WWA1U32HhlHd9d184Te4NjIjLQxsbGZEzf
1083jaYmMOtiiAAOkXte7+VfVq6ATBRPpsLIN+cXUf+F6dRfO5WfLiuzktQZg7lfMvU/EAUGogpXP97E
1084Q/uCXDghm33XTqX+C9P5y/lVOJ0SmxrDXPGvJg4MJHnwohrqvzSDr8wt5Jfbevj8qsOgGTitLE2S
1085YCosTdG5/sU2ei3RNLhdYZjPzfHMI78L0K358mWVAa6clsflU3PZ0ZlgQZmXe86rZGKhm5IcJ09+
1086qJZzarLY0ZtkaoGbHLeEohnohsF547NIaQbr60PkuGT+tLKSxZV+dnTHiSqm1WNPb5K2cJrvLivn
108718vH0RJOE0vr/PX8KlZMzBmaFtR0qnJdLCr3sb4lxq6eJJ+bU8Bty8rBgFNKvZxTk8XX5hbSGVdZ
1088WObn/509jjNrA8gCPHBhNR+bnkdLVCHbJTG1wH1U8ZLBLYvglinymfq/LZKmOsfJgnIf6w9H2NOb
10895AsnFfI/p5eBpnPdvGLuXllJqU9me3sMLNGgG5BSDaoCTn59TiVnVQd4pjFMUtG5cEI22zrjbGyN
1090cUldDn86txJZFLh4Sg73nFdFbY6L3d1Jrppupo2fVmD6af3p/GpuWlTC7p4kWS6Jhy+uZmqJl9GV
1091BF2yOb3aHVe5emY+olfmrOoAlVlOtmQcKq0MhhdNzKYxmGJ9U5hZRV7+fkE1edlOin0OzqnJ4ruL
1092Sgi4JLJdEtfOLuB7p5YgABeOz6YjqrC+IUxNjpO/nl9NVa6L6nw3j32wlqWVfrZ3JTitwsfFE7NZ
1093WuEDVeeLC4q5+9wqehMq3XGVP6yo5LwpOeR6ZJbXZHH9gmJ8DpFpBW6+Pq+IP5xTyUBS46zqAD9e
1094WobfK3NKhZ+nPjSeIp/Mzu4EX59XzK1Ly3CKAsuq/Fw6OZcP1OXQGklzdnWAP59XSVWOi13dcRKq
1095jqIb7OpJWpE2b/MNZGNj8x8xdi0vssjhSJrT7z+IYUBXXAWXREoz+NSqw/x4k5Ng0px6uW9vPxva
1096ooiCMGjl6I6rpknEJfHA3n5eaY/SEVWGHCsdIgf7Ulz2aCM/LfWZwgIzk+SungS4ZZ7YO8CGjhiT
10978twIgvmQea09BhjglvnngSDbusyaHIjmtvZ2JVh07wFy3BJNoTRIIp9e1UKWS+RAf+pd6fx4tEd4
1098Rn4lNYOkqvPZZ1vYsquf9ktquHFRCcuq/CRVg/KAk/95pZPvPtrEyVPz2PSxOpySgCgK/P2NATa2
1099xQmH0/RqBj9aUsrUfDc/frGDj0zJZUKem08/c5h4WueBS2rpT6r8eFMX1VlOzqoO8PHpeaxqsBJ1
1100SSJNwTTfWddBIq2R45U5pybAmVV+HG5p0GL0w42d3LW2nf5Larl+QRFTCjwcjiicUWWKhg/cewBf
1101tpM3rplCgffI20OzrFB3njmOW08rozrbyZ7eJHdu6eFAZ5wbXzK3X+CTWVGTxZJxPmqKvXx7QTF9
1102CZXlDzXQeDiKHHBQkuVAFAQMDG5eXMKMAjc3b+jgr6/3giDww42diJiWqrklXk4t91Gc5eSyKeaU
1103zkefPMS67X0cXFnJT5aWEU7r1JR4uWJqLrt7Ety2sYPzJ+fys6VlXDo5hx90xBk+zyaLAodCaTpj
1104CpdPyWVumY8LJ2SzqyfJ84ciXDQx28yiqhv8Yks3uW6ZeFwlP+Dgyml5TMh3E1fNCjfPNoa5+h8N
1105zB2fzaaP1zG/3AdOgV+/1kOp30EkoiC5RK47qZC6fBe1OS6KfDLffamdHz/RzJI5+bz4kToiaZ1s
1106n4PPzC4gqerc/mo3siRw3vhsPjYznwf2BgF4rinMR+6v55aVldywsJjfvd7Lzzd0sulTU5hf5qU2
110718WV0/LI90jc+nIfTx8IsXicn49MzePeN/oJJXXiXp3PPdvCjuYIRZ+awtIKPwGnyLfWtvPRKfkY
1108gsFVTx1CjWtvTwVUGxubt42xK14ESCoGr1uhzYOiQzKrrPaHUoNz211hha6B1Mj1M/PeokB3RKHb
1109yjEwwurhMOfstx2OMsJPIbMtt8RATGVTODzqN7ONnqiVu2D4HLskcLA7YVp9rO3v74qP+PxuIWMx
1110Us3sUWAMTSFl/GxlAcIpnZaIAm6JHsvqlO92kOcxQyN39STBKdIRVYgrOgYCLlHg07MK+MmyMhyi
1111MNiuboDklpAl057md0rkuGWcokCWU2TTx+qQRTPbcVYmjNnyWZhT5OEP51VxcokXw2prT18CgaFH
1112dn9SA6dE2JoSkwSYkW9aLHZboZpxxaA9qlDsO/L2yBz35o4YOzviBFWDu3b0MhBMc0qFn7vOq2J2
1113sQfDMAvXNQZTlPrMjMsHBpI0DqTAJ6MmNeIeCd0wKPI6OLvaQSilmVbFtEZNkZffLK9ghZVkMTPN
1114U+STqctzk1R1GgZS4JJMUWydhjKfjIBBXZ6bN66dhiiYTuf5HpnRT19RgJSu8+T+CJdPyeWGhcWc
1115VOzhb28M0BA0c28oukHAJXHzqaV8dk7BUH9gZHM9cRVDFlEs/xZNhxynxDfnF/OtBcUj1vPKpsVE
1116ADPfiEukLaKQ1swptFy3hNch4pJEnrt8Ag7revsd0mC0bTht5h3JGMdCKfNzxsE+4BAptMTnT5aW
1117c8eZ41B1g86YaVkzMA1RCVUfnGYG09Kb65aQJPMYcl0yPWnjhAoXAUjqwDuVrffdjgHqO51nx2bM
1118MXbFC1ghnEexVEgCSNKxP7/V8sMRBXC+yaDxluse5bfR1pV3m7VFMKfAGkIpIMCp5T627B2AgJOZ
1119RR7AdFiWRQFNh2yXSJlPplM3WDTOD8C+/iTjc1wAzCn28ICiU5fnwucUiSkadQVufrqsjJ09Cc77
1120RwPXLyjhK6cUQsZ/0sjoPIPWUBrNMAilNS78ZxP7OuOU5roYcnoyHUOvm1fEySVePvrEIfb1JXnx
1121I3U4RkUzOUTTuTNT+0U3oM/KCjqzyAsiFHglKrKcRziEw9BU4J939fHPTd3glsAhgUPkS/OLmV3s
11224cOPHaI5nOKFyyfikgU6Ygp9CZVyv5PJBW72HYqQnevC75SQRYHOmMLTjWGumZnPL84o5/wH4pw3
1123OYcVtVl8b0MHf9/Vz6rLJ1DqcxBXDAaSKm7Zw+R8N62Ho5xc4hk8De1RFQOBhoEkH3ikkZ6oQk2+
1124m/6keoSDuHl7Caw5FGFXd4ILJ2QTTus8fjA0+OBPqgbzqgNcO6eA+/b0c/3qVv54QQ0ragIjnKVl
112567xmpmbjis4pZT6uX1DMUw1hrn2ymTvOGceHJ+eS1o3Bcz672MPjis7kPPeg9bM/oZJSDdKazgce
1126aWLL4QgFOS4kTWeC5TAvCeb2Mu8Cme1nPkcV3Txm4OYNHfxxaw9uj8Q4n4NDkTReh2ilSrH227qu
1127GVGDYU6rpTMOyY4TZ3lRDZji10kWqHaSyOPB8k13iRzhUG/z/mFsixeb/w6WA+zdO3q5cEI2P11W
1128zuJxfgq8MqeW+/nb7n62t8XwuCXSmo5DEvndOZX0nq6ysiaLrR1xnq8PsSfHyTfmFXL9/GIm5rqY
1129WuBBEkwLSn9c5UB/iin5Hm5bVs5plujxyyJ6XGFzR5zJ+W4euaSW773Uzl2v9/KdRSX84oxy9nXF
1130Kct1c/P6dnPkd5g7vK/PtEB8dnYBA0mNgFM0M3wCfktAOq1oHY/1IM9yirzcHGFze5xzagI8f/Vk
1131PJLAuIADzTCOcE/KtFPgsRINZpLtqTr7es1Kvp+fU0BU0fA5RHJcEoeDaX61rYdbTy9jzeUTeKU1
1132SlqHH2/qwu8QKfQ6+NVrPeS5ZS6py+anZ1ew1gq3/9CkHKbmu5mYawrBSFrjzzv7OKMqwAMXVrNm
1133Vj7LKs3yFU5RoLknwaMHQlxSl82vllfQHkxRkOXkC8+1mCO99XSXRQFREMh3ywRDaZ5vjjCjyENn
1134NM3m1ihXTM9DwPTL6QgrxBSdpRUB/ueMcSwZ5wPMB35GcPiHiwEgzy3RFVXpjassKPNy65nlnFVl
1135WpEcosCDe/r58imF/GBxKTOLPEzLdw8K1nBC5d7dffzo9DJuW1bG9rYYJTkuvr+hg7Rl2fFbmVsz
11361zGTyynLepkQgIf2DPDRaXl8bW4RU/Pc+F0iG1pjbH+9hxy3RMApDoqWgNVPvA6RcCTN690JzqkJ
11378MSHarl5XTtrmyIn7CUkpgl8pkpBqk6fkPbfqyQ1AcUWL+9bpE984hPfLykpwePxHNcKv329l+6I
1138YlokdIGJWTpnF6qk9KFR3i3Bml6ZA2EJxngi1Xc1usC0HI3T8zWSuoBbgrW9MvuPct4vLlUpdhmo
1139xpFWJrcEG/tldgaHrSeZWTsfbwyT75Ep9ZkP819s6eamde1omoHHcs5UdINnGsNU+Bxsao/z2eda
11406I4o9MVVNnbEyffI5Lpl/r6nn9Zwmjd6k/xzX5AdvQmKfQ4U3eDRgyEiaZ3VzREO9ibZ0pug0CMj
1141SwK7+5L88uVOehSdqiwneX4HTcEUf98zQFIzBudytvckkEVzumBDa5T6YIpdvQmebYpQYKVUf6Yx
1142TEsoTa7fgSDAC4ej7GyL8VxrlBy3RK5L4sWWGK+0x2gJp3miPkw0rQ9aGYp8DmKKzqrGMIeC6RHT
1143kK93J3BJ5vbXHY7SFEqxqyfJc4eirG8K0xJTyfPIZLlltnbGWX0oYhbBG0jxwN4B1jRHKPTK5Lhk
1144Hq8Psac3SYnPwRu9SV5pj9EcTvN0Y5hNhyJ0JFQkUUDVYFNHnAVlPja1xXnuQJB/NYRBgHEBJ7k+
1145B1s7YjxWb9aOyZwrl0Ok1C+zvjXGprYYQUUn1y1z754BtrbEyPLIZLkkXmqJsvpgkOaoQoHXQVdM
1146YVVjhP6kxuP1IZKaQZ5b5qWWGJvaY7gcIuUBB5s74ty3p599fSmKfDKhpM6TDSGCKY3VhyJsb46w
1147uSeBWxYJyCLPH44yr9RLd1zjnt39vNQYpjmmUJntJN/voDOmcs+ufmRRoMAr81JLlJfbYuT7ZQxg
1148VVOYxoEU5VlOuuMqzzaGeb05wrqOODU5Tgr9DhyiwF9399MSURgXcHBwIM1TDSHCKZ2SgJOBpJmz
1149pzOYYltvkkKvjEsS2dyRoL4vOXStdYE5uRoL87QR4x7W6RWARzsd9KVE09FXF6j165xTpJLWj7z/
1150BDIpdgT7z7/xx9Yt7w7cEmwJSmztl4+tBxSdpeOzOb3C/5Z5OpPJJF1dXQhr1641Zs2aRW5u7nHt
1151yMy797GrLWZO5ygCK8v/P3vvHWbXVR7qv2uXU2fO9N5n1KzeLHfcbWxjbMCYQEiol5YQJ5fkyU3A
1152hHt/uU8ggdwQAoE0SgLBNhj3KldVy7ZsSVaZopnRNGl6PXWX9ftjn3OmaGQZpMEaa73PMxrNOXuv
1153vfaq3/rWt77P4hsXJBifsV+bb0r++I0gz3SZYKomtmBYgvc0JPn6BUlGLUGeKbn7SIAHu2eUe/rX
1154DzfEWRNxiDsnt4x8U/KNNj//1eE7ub7stJ+OzMeayIY1iIQMdv/+MkoCBiv//TCDA2nHgDO979ru
11559CmXtDvxrEfXzHcCb9R3pXevIbzPMyeJTG3aN0dGT5zZUpzZ0tP+ZLKeQzP+O/z6bM/ARjotW3r/
1156NzXv/3bm3ulyO8nD6pt5GJ7v+Zl3lczOf8Yrb9rWAp8+fb9G2s+LTGtLyNocYWpsrgoT8evs6pig
1157It/PY3c2sbQowJX/1cL2Y5Mz/Jhk6gxv20PMyWvKnfagm/GqO/dvQ0w7e3QydYXnzyazpTsznUy6
1158Wvqd5rtPF1QX+rmwPMQT7RMYAv75plp+d2Uhd23t4R9f6vfSs+TJ9S1nPM+nTddjpj4yYR0yXqFn
1159tr9MW9KFF6aCGW1opjdpfZ72N7OuLcEnGlP8SVOScWt2G9CE9+offz1I87jubQPZgmvLLb61KsHk
1160KexalLWLYjHzZrN8vin5XqeP77f6kaeSB2I2X7uhhrsvLT+tWejo6Cj79+9fmG2jpAuXFNrkCKk0
1161LwuJAxvzXZLzeAg+axgCjHkq0ZFpm2aNoKmR49MYDOgnO94ztFNvTp7qO8n8tkan87ORPvE1L6YG
1162Gd+Bcs6zT/W806Xz6zz/VPZbM6+fm4f5bLEsl8Z8P/fcVp/1z9Y7ZfF7D3ayvWtq2u/N6WJHacJb
1163Ep3q2XP/frP3npnO3HTnu892CRkaP7ylnjy/VyYpR/KVbX18b++gl4Y4hS2amPG8ufUIJ9ugnaqN
1164zS2fmXXz67SHs4AkIzOlK1ShWDR42vwZyunfGgsivMQcwe3lFndWzufeVnE2SbmCqCPOuOHIzD9v
1165VVGmCSZTLh98oANTF/RO2qCpIwALjq7xdOck1/y8LavcaRtN0tUf9yb1tL3SOY2m0TlhcdN9RwmZ
1166nhZvKG6zrzvqCcsZL8LnKmf58FFYl3y308drI4Yy2FUsLmzB5aU2n6hNEf0tn5ZbEOFFAHFHEHdO
1167e6niLHA2msxvMmS6ruTVY+lj5nO3JRQLg4DRqMVzzTNcA+hitjbiXEdAynLZ1T4x2/1/RvuxCN7h
1168bGbREHBkSuO1IQOMRfDyCkUGS1CR47wtIfrUaSMFk7bgzgqL64tsJYAoFKdDQqFfMnWWVpoSCGh4
1169gosSXhSLCekdWX87UMKLAltCeUBSHVxI4xmF4p2D7QpSUsn6CsXbhRJeFAi8gxWWGooVireM6i0K
1170xdvHgggvEgjp0tvCVlrQhUNA0hHEz9DSWwJBDfz6wrpBVyjeEQjPQVribThhoVAoPBZEePFp8MqY
1171QW9MqGisC4kLdWGXNRGX1Bns+Pg1ODCp0TGlqfpSKE6HC005Lhfknlm/UygUvzkLIryEdcl9fabn
1172pM6nlvILRkpwa2OSiwuS83rufKuEdcnjAwb3tflVfSkUpyMl+MjSJJvyz6zfKRSK35wF2zYK6tLz
11731qqs5xcO6Z1SONMSlqQtxlV9KRSnJ33CQvWU3xBHkg0H7gXEmhkjYfZnzPncTBe8PcOD9NzrZzL3
11742gyGmI7iOd81YsY1jpztpTnz/cxYV5k86mkP5K70PES/Wd4UZ4Qy2FUoFArFb4ekQ06uSVO+HyG8
11756OMtJ2KgCQpyTOoiPuK2S9toCicdGiIvaFAb8eFKycHBBFguS8uChE1PKHBcz1Fj3JpjhCTBZwga
1176ikL4dOFFeBDgurB/MO6FiPDp+A1BQ3EIUxPZKBApR3JoMA6WS2GuSVWOD5GRdyRMplyO9sc8wUQX
1177FIdNKnJMTkQtBictdENjZVWAgCFoHkkykbA5bdAexa+FEl4UCoVCsbCktRs3LMvn/1xZwUUVXmTy
1178lCP52939fGP7cSrDJjs+uhxXStb98DDtQwlwJB/dVMx3rqvh/pYxPvJwJ1+6tIIvX1LuCS94fg4v
1179+2kLuzomZ4d5cFyq8gM8cecS6vNmx6h4oGWM/7ern23tEzTW5PDM7yylImf2dPjtVwb486d7uH1p
1180Pv/27tpZskfcdvnmSwN855UBBkdTfHRzCX9/TTVf2dbH3zzTw5curebrV1by2kCM2+87yoSTjqOm
1181OGssfuHFnUd5mwn095uSPTvsTgcaVJw52SB7YnqFJJn2sirxAuvp4uQYNXPTOZM6nlu/mUB9bxab
11826HRk3kFLB/VLOWe/7cxs63Ojl73Zd+cLrpzdthTnDrbL1U0RHryjCceV3PGrdo6ciHP31ZV8+bJy
11838oM6f/REN7t7p7i6PpeLKsN09CeQmuDyqhwQ8N3XBrmpMcL/vaKS/YNxPv5oJ8mky1WNEaJztS4z
11848OswkrD50IOdHB9N8qeXV/Cx1YVsrAhx+Y+bidsufkPQH7W444EODAQ/ubWeuzaXsvXYFEnbs8p+
1185sHWcrzzbQ0XEx3dvrOXuy8qpyDH5zEMdpC9hIuWwqiaXuy8tZyLl8PuPHKN7NPnm45niN2LRz8o+
1186UyPk0wn5p3/SZ4h/80Qtl2ub8vjebQ18YHWhNyiqDe4zQheCHL9OyKfPkjmEgKBPJ9fUWFkW5Pu3
1187N/DJzaWIU5W55SI0gW9uAMhfh5TLZXW5fO+2Bm67oIDyXB/fva2BL1xchvbrxHfKYLuAwJ+Ovry5
1188Osw/Z9qOc3YajgACPq/8/ObJBhezvjvfSEfsNk0N/Tx8/XMeKfGZGl+6sAy/Ifjyi33c//owB/tj
1189fOnZXsYSDn+woYQLyoL8vHkUJNzalAdSUlsU4Nr6XE5MWbzUG6Uh3w9A1HLpnrA43Bfln7efYH9/
1190/JQLBQkkHcn+gTgHe6J8+tFjPNUxQU2uj9tWFOBKiZQwlXLZ2TXF8/uH2d4zhQTq88ysuctA1OJg
1191f5ynD4/y0Uc6mUy6/O6qAhpKgyRdT3opCZn83bVVhH0ad23t4VBvzAudojjrLN6u7npRjb9zfQ2t
1192n13J8T9YzfBdaznxh2v4+e31bK7OmT1xZAyqbDn/hOLM+N5yubgyzOc3FHN9fa7X+jPfZ1a4832W
1193ScdJf+YooQcA26UwqPPkh5bQ+tmVXFoV9oRLy2VzeYjDn76AR+5cwhXVOXx2fTGfWV+MqQlPKJhZ
1194lrbL0qIAj9zRxB9uLIG47Wk85tbL3DqeWbfS+25DWYjPbyjm6rocaiImX9hQzBc3leDThaeRseXJ
11957WW+NuRIaiI+fn5bPV+7vAKiNpvLQ3xuQzEfWVmAIP3MU7W/TH7dGdfMbZ+2S2nY4Ik7m2j77Epe
1196/thyavN83nWWy6Z0GbZ+diXfu6F2Oq9z3zvzvJltNPO8mY+ced9czaYz4x5nnnc5VT+Z73nz9Z+5
1197z5j52ay2IKcXFa7kPSvy2f17y1hVHDizhYvi7ONCfshgVXEAAezoiyJNDfw6fVM2r/XHEAJWFwe4
119878gYgzGba+pyKcj3sbE8RHHQ4MmOSeKTFlvbJ2gZTXJpVZiOz6/m27fWs6Ii5I0VroSEM/2TniPA
1199E/5DpgZBHSdh83THFEhYWegnoGukHJc8v84nNhTzh9dV875leSRsl+eOTWVlIkMTnoAUMHjlRIxD
1200wwmChsbSAj9OWvPy6bVFvLshwo8PDPOTvYNInzLWXSgW/bZRZY5BZY7J914b4qWj41yzooCPrS7k
12015sY8brrvKDs6JrwLTY2yXO91E7ZkfNKa3h+1XCI5JsH0nuTYBMTSesCY5U2g4ZBBbnpL4cRECiSU
1202RkyEgNGEQyrpYPh08oMGjpRMplzy/ToTKYdUxlL+fEXXGJpIcXTMG3Qur85hR8ck2J7wUpfn46G2
1203cX7+xjCulLSPpUi5ksJcE00IxpIOuaaG7kruuqiUm5siHBiMUxA0SBgauWGNuC2ZTDqYuqAgbGC5
1204ktH0AFaUY2Jo3vw9ELXAlVlVsO3CgeMxPv14F31TFo6E0nzPOG/mfD8YtTEMjaKg1wZilmQyZhHU
1205NT65sZgPXVDAjw6MUJjn4+G2cXQh2NsfQyLAkhgBPXtvNOUyFbXB1PAbgrywwUTKwZWQ79dJ2JKJ
1206mD1rj9wQgtqIZxRYkWNyQ0Mu/5Y2GLx9aR71eT4AysPpLu1KCnN8mHrmvW1wJKZPo9BvMGW5JBxJ
1207UUDHdiUjUZtMmOr8sIFfF959MdubFDSRNV40dcFUysXUBIYmGE3YOOnlaWmu1ydG4g5W0sH06xSE
1208DWK2S8qR5Pt1Uo5kbDJFXq4Pvy4YTzokLddTw9ku+bkmfl0QtyUTUxaYGvkhA1MXDMZsCgI6pia8
1209vNku1QV+vnVNFcsKA1Tl+Gj3J5iSnN997hwk059SM4RSKWX2oI/fEIyPJnmqc4LfXVXIjU0Rrq+L
1210gIB7joyCrvFGf4z3/LyNj64t5E+2lPFHF5ZyxwUFXPPfrZia4JtXV2cVHX/6bA+9U/b8eUlL61pa
1211DZxyJOU5Jv98Qw2uhF09Ub6yrY9DPVEurgqfIo0M0w1tKuUAJg15fkojPvqnLG/7WHHWWfTCi51e
1212tT3UOs6Trw7yk+YxYpbL5zcUc9emYna0T9BQ6Ofr11Zxx/IChIBj4yn+4KluHmseAwnvXVnAP1xX
1213RX2ep5K844EObw8VTz1ZEDZ49qPLaMjz8cWtPdzz+hB/eVUVf3lJGYYmePbYJJ94sJO4gJd+bxmT
1214KZdXj8f43dWF3PqLo5Fi8OIAACAASURBVDzdMj7bkOx8Q4B0JA+2jvN7qwp579I8/u6lfqQruHVp
1215HhK498gYDQUBvnJpOY8eneDF7il+9f5GGvL8PNA6xkdWFjCedKjO9SbpP7+4jI3lIe47Msa3rqnk
1216xwdG+OKjx9jcmMuTdy5hZ2+Ud/+sleuX5vGL2xvJ9WlYjuTvXurn7q09WVVw0nGpLwzw1cvKeebY
1217JFHL5Yk7m/Drmie4AkfHElx/z1H+5spKPrm2CCQcGUnwvvs7uLgyxNcuqwDg42sKWVUa4If7h/mz
1218LaX89NAou9rGWVMd5hvXVPPuxggABwcTfObJLnY1j/HuDcX853vqODCYQABbKkK0jib5H090s71z
1219MivASLy2PpZ0COiCDyzL50d7h/D5dT6yqoCO8SS1uX5s6Wmo3tUQ4YH3N5If0LEcyT++OshfPNXN
1220muIgT31oCb2TKQbjNlfX5nI8avFHT/dw//5hLqzP5aE7migLG9iu5IcHRvjS091MJRxuW1nAD26s
1221pTRscGQ4QcDQiFsu7/ppC1O2zZevrOR/pfvEM52TfOLBDvxBg50fXcZA1GIy5bK5IkT3RIofHhjh
1222cxuKKQzoPNw2zicfOkY05fCB1YX8w7XVVOWatI0m+R+Pd/FC+wT/ensD19fn8uyxSa6oySHH1PjR
1223gRG+/HwfP7yljmWFAQAeu7OJv9nVz5e3diOVncG5gYCxuEPXpEVDgY81pUEOdE4ibUFpkZ+VRQFS
1224jsvBoQTSgSc6JvjdlYV8eHkBF1aGOTiU4MXuSWS6L7T1x/jaU1G+vWeAX3ygkavrcvngigLubx5j
1225POXgS9t82e5s07q47ULCQYRNrqvPBQGvDsRIOJKQqdEzkeL6e9roG0sRk+AkPIE+k4btyrRW1mVD
1226Yx6riwNMJB2ODMepSxsE/+TgCBcUBfnIygK+fHkFdz1+zBPalCB91nnHzKg5Pg3CBjiSnx0aBWBF
1227UYCqQj8/uKWOO1cU8GfP93L7fUeRwP3vb2BJSYBVFSHuvb2BXFPnIw928rsPdXJ80sp2ACHga1dW
1228sr40yE8PjfCfLw3w+YvL+avLyvnb3f285xdHuaomh7+6qhK/ruHTBWtLg9x5QQH9UcvrMKrhgqHx
1229VMcEB4cTbKkIsaIoQHnEx7V1uXSMJXmpe4r8oE5txEd52BsIQoZGTcTkk2uLiNku/7x3iB+/MQLA
1230jw4M8+XHuxACcn06OemJytAEuT6diE8HXVAZNvn8k11s+f5B7j0yypcvLWdzfSSrWZMSTF1QG/HR
1231kO/jjcE4t9/XzrvvaePwcIIcn8YvmscxBBwdTbLlx83ceG8bjXk+fnBjDVs7J/mnVwcBeLB1jD9+
1232sBPHhbo8H7k+jZywyT3va+SmxgifeaKbDz/YQWWuwUMfaKSkMIArvfxfWBHiB68P8d29Q6woCnD3
1233ZWUIfYb6B/DrGoeHErx0PMaNDREaSwJcVh2mMeJnW3eUuON4HVoT1OSa3PVMD1u+f5D/PDjCn24p
12345YoleaQcl1y/xtrSII8eneAr245TlWPy1++qIBAyqMk1+eq242z5/kH+6dVBPrOuiJuW5lOe5+NH
1235t9Rh6oIP/aqD+5vHaMjzkefXSTiST19Yyt2XlfP13f3c+oujXF2Xw91XVRHQBTk+ndUlQe49MsrP
1236D4/SmO/nc+uL+eoLfbSPJblzRQGrK4KsrQzz8/fWc3AozpX/2ULMcvmPW2opzfVh6oI8v07I1Pj0
1237Y110TVp8bkMxV9Tl8BfP9nJkOAHAH2/t4UevDSHVavfcQROkUg5/t+cEUsJ3r6vm1rWFLCsJ8PfX
1238VlMVMfmX14d5rS8GAY0Xuqbom7K4sTFCedjg4dYx4nEHbMnvrCrkjg3FLCkPURwy0IQnXAzEbA73
1239RvnQz1t5389aeN/PWjjQGyXs0xCAXxdcUBRgWXmIf725jnc3Rnj+2BQ/fX04rUHUkHha9Mm4jeO4
1240WeP9zPBdHDRYVhzgqmX5/Pd768nxaXx1+3G6TsQIpI2tJlMuX36+j+NTNl/cVMLvbyxBpNQ25kLw
1241zuvhQmQnJiEEa0qDXF2Xw87eKH+/8wQP7R3iH18dwK9rvLspjw+tLMCvC/7vrhP8fE8///36ELva
1242JzzbB+CDywv44qYSHmgd438+1YMW1LltSR4A+QGDNcVBUo7kpsYINbkmcUviSskfbe2m4TsH2NET
1243VaeVAHTBZNTmgeYxDE1wfUMu19Xl4tMF9zWPYUUtDJFZMXkTtp2euP/2pX7qv/MG39x2nPYxb5La
1244PxDn5aPjpDLXpn9n5npbSnC9I5GFAYOrmiJZAacuYs6UCab/L2EkavPU/mESjsu60iC7eqN8e08/
1245x4cS7OyNcnlVmC0VYUaTDg35PnonLPaciALQPJJkZ8uY528CSNguq8pDXFAU4FctY/zb7n7u2TPA
1246v74+THHQ4OK6nKwK/eHWcX68p5/v7h3EkVCV4yMwxzBXE5BwJI+0jSME3Lokj9uW5tM5keK+I6OY
1247mkAIARIebBknx9S4qilCXnoQro/4cPG2oF45HuP/7e7n2y8P0DdlUR42yQvqPNQ6DkiuaopQHPIU
1248szW5JhdWhsnz6/z7/iHu29PP3740QNdECokkz6dzc5OnVSoMGKwuCWI5kpsavD7hSs9Y8ts7+3mw
1249ZRwJ/KJ5jP/YcYKdPdH0M3xcV5+LrgkcCReXBTE0QWOenwsrw9ky/fs9Azz48gAPt3nbwRU5Jq90
1250TzEc97YHnuyYpKU/dv6euDpXMQSPNo/xOw92cCJq8+AHmmj+g9X8zop8/vf24/yv5/q8fmho9Iym
1251eKh1HFMXOFLyZOckMm0TVh0xuff2Blq/sJqWz63iytocvrVngF8cGvHsaILG9I/u9QXL9drlcx9e
1252SvMfrOZTawv54f5hPvxAO7G4jd8Qad9ywlu06mJW+8kcMHjf8nyOfGE1z310GSFT4zNPdPGPu/qR
1253uoaeviji0+nqj/G17d77/N1VVWyqy/EyoTirLPptowxOxihSSjaUBgHonUyRsFwMITg+ZXmGfqZG
12543PJmhIhPIzctWAzHHdA1b38yMb1PWhTU05K7RtJx0XXNM9wCbm6K4DqS/YNxOse8gTxgevvyT3VO
12554s53jPt8Jj0Q/cUl5dzcmIeueULGPYfHvO/nzDemJrBdb7J2LRcMQU66vnRNgDE9aFjpwS2eFlwt
1256R1ISNvjpbd52w9HRZNZmyXZlVjg9CUdSWBbk326qxZGSP9zaw+RYig9uLOFH76kj5UoGYzZFQYP2
1257sSS6LrL+JrS0183saSoxnd/eScuTkgyNRDqPuabGiONkiibtMEtLZ2P+tmNq8Fj7BH+6pZQ/2FiC
1258LuCJ9gnax1L4dA3LleQHdX5yaz23Lsnj6GgyK7TZM9qjC5g+zTNixDuNkWPqfOOWKj62upCjY0mC
12596by4UlIf8SGA0XQ/sV3vnqAhMHWBmX7pmxsjuK5k30Cc9tEkrlcMngzm0/AZ0xpNfDrajEkiY3O2
1260oTTI8nw/k7bLi12TxCwnW8+G8I6zZ8rYlV66Zro+/bpAHTk6BxGeUHDvvmGe656iPs9rT1OWy6Hj
1261aWEz0yc1+IsX+/i3/cOkXJfm4WT6xI7k3/cN8/yxKc88C0jakv3Ho9n0Z6Fr9ExZ3HxfG37dO4km
1262gLgtOXA8huei3KB9LMW7ftaC40r6Y/bs9mNq3N88zivHm7OPkHj9uW8okdXO/PTQCC90exojGdD5
12639/3D7DkeI2ho9E7aysfLAvCOEV5MTaBLuGJFPn/9rgoc6dk37O6LciJqcXVdDssrwxwbinPninwA
1264tnVHqcr1tih+b3UBDzePEg4Y5BT6s5PHfx0cpTpi8oFl+fz11dV85fEuOsaTXFET5uu7+/mXl/op
1265yvdTEdIZSbr40xOIoQm1+puLrrH3RIzXB2JcWhVG12BXb5TDQ/FTTjhSpgWV9Gg1lRY8a3N9aKae
1266NpCD2ogPM6BzXZ2nAYjbLo1FAa6vz+Wpzgnee+9Rvn9zLR9fXXTK7NmuxNAF37zWM/78PztOsLdr
1267Ci1ocOOSCCFT48O/bKdlNMErH1uBqQkkMpunmlwfuk/PKks04PBwgpjlcktTHl8vCXp2Hcu99vfq
1268iVj26GdmMj5di/HpGs0jSX7ZPMYXNpYgkdx7ZCzb1CxHUpfv5z1L8tjWM8V1P2vjH66v5vMbimel
1269I2b8gCf8VecafGBZPvsHE1z84yPcfVk5f3FJOa6EN4YTSDyB/bt7fFzdkENdxEffVIrRhE3XZArA
12706xN7TlCcH6AsqCOFwK+LWac+5vudclyaR700nuqY5NMPd2LrgosqQrx8IsafXlw2bzkJAFuSTGuw
1271qiMmBzRPOFOcYwggoDM4YTE4lpr+bK77fE0wHrPZO2l5f5uZ7wWjMZtXJqzZ6Zra/B1HQMqWHDwe
1272O/nUp6llG1PCctnXE50/LwKGohZD46nZ92veu2QYmLQYGEtlwwO4rvTShNmhCBRnjUUvvGRWhz+7
1273tZ7oDTXkBQ16Jy0+9egxnmkdBwR/srWHf7mplsOfvoCplEvIFPzDywPsODZJ0Kfxs0OjfGRlAb13
1274rcUQgo8+coxMC7ZcyV8808sllWG+fEkZzcNxvrmrn3WlQX5wYw1ff1clhi74k2d7eKBlnIL06Y1T
1275LezPa3RBNGrxUOsEX7s8BHgTVSJqg+YJoAC5aePmPL/ureq16RnrqaMT/PnFZXxxcwnLi/x87slu
12769hyPcktThK4vrmEqHea3OGjQMhjnmc5JbqiPcPizKwmnjyH4dJHVvIRMzROOAEPT+OSmEj6xxhNw
1277vrSllLs2FtM8muRf943w+6sKue/2BlpHE4RNjYhPx9A0dnRO0jWR4kMXFFD6qRU82Tnp5SFk0DcQ
127858+e7eUfrq+m4wursFyJBnx123Gae6JsKAvNemc97aI836/P2tPVBOQHvJNIruXyZMckX9hYwkjc
1279YXdvlBXpY6jFQYP2kSSPHh3nPU15tHxuZdZ+y2cIdE0ghFe2Ip1uQUBH1wTdkxb3t4zx+6sLafvc
1280qqx79vyAzgtHx/ll8xh3LM+n70/W0jORIm67GOn0vvNSPxdVhPjBu2v4+pUVGLrgj7b2sr1nCl0I
12818tMrVH+63MOmhpBpW7V0Xf/i4Cj3Ls/jY2sKuX15HtKFh9rG+cTDnVntkS+99M1ou3J8nqb03sNj
1282XF6dwyN3NPFX247z/z3fqwx2z1WMmWLzKdDn0aSA12B9v8bgmtaGnvaaNztQ8VaeOTO/Ek8w+nXy
1283qfi1WbzCixBI4Bu7B7jn8Bh+3RuYLVfyRPsEXYPxrErv5/uHaRlLsaUihC4EraMJnmodB00QTbl8
12849OFOHmwdpzio4wIvdE1SEDD4ZNLhjaE4rUMJbv1lOxvLgp7K8USUG+5p47alefjS20m/PDJG3JZ8
12857JFjuKSPmCpp+2QMje/uHaRrwlvJPN05kR1c9g3E+eRjXXSOp3Ck5EvP9lIQ0GkdTWZXL3v7otx8
128671FWlQQYT7p0jCa541cd3NAQwZGS3X0xLiwPMZywGY07fOzRY9zUFGE04dA9YbGqOMBLfTE0AZ98
1287rIt9A3G6JpJ88rEuuiZSRC2XTz/ehSu9idLQvKPa9x0ZpX08ybICP/sG4pSHTQwdQNIxkuS2X7az
1288uTzEeMrl8HCCgSmbIyOeWvl7ewbYPxRnTUkQARwYjLOtfRJ8Orv7onzysS6OjadAE3SOJ/nEY12M
1289JmwSGY+xGowkHD71WBcJWyJ1wXNdU3z80WP0TdlEUw6d49479EymmEw6/I/Hu7mlaZzJlEvHeJLV
1290xUG29UwxFLf51GNdDMVtLFcynnT5xGNd6AK6Jyz++JkeXuyeImG7HBlJsrYkyGv9MVwJn3mii/86
1291OEJQgNA1vn1dNUlHoiPY1xvl+nvauHWJ1ycSjsuvWsaQ0ivn0YSNBF7onuJTj3VxaDiB9Gt859VB
1292nmifZGdfjHjK5cMPdvJw2wR5fg2BYGvnBC7w1zuOU53r4+UTMfBr/Pu+YXb3RtndF4WgwT/tHaQ/
1293ZlEYMNg3EEeqrSOF4h2NeO655+S6desoKCh4Szes/Y8jHOiNepKqJbipyuIbFyQYt6cn6jxT8peH
1294AzzSY3qRiheSlHOyUy9TO/lsfcol60lIE5675kyWpYSkO2256dfTUUHT7uN9mne/7U67kHek9+wM
1295ft2baDIOsvz6aRcXZ4wl+GBdiq8uSzJmCfJMyd1HAjzYPaPc079+uCHOmohD3Dk5U/mm5Bttfv6r
1296w7fw9QWzy86nT+8HO9Irv0x4gKTnpwW/PlsQzNRlpi5sCZbjlb8hvHqbW0+a8L533GlX3RkX/pnw
1297ALrI+hqZhRBeGOFU2hGWoU23uUC6nme2j4yju0zbkcxup/qM9pcJJZD5zE2XgRCz1NJpN6GkDbCm
1298r8u8pzun7DLvndmot93pZ868L5MuM9Kde58mKMz38ZcXl7OrL0oy6fDFLaXc0BDhc0928y8vD3jG
1299kvP2CTyHYXPrI1M2SXe6TjLReBMz0sj05UxbyFyXKW8zHYLBTb9H2q5oQY3kLcEnGlP8SVOScWt2
1300f9I8WZOPvx6keVwHXYItuLbc4lurEkza4qTkcg3J/zwY4NkTporqrlhcWIL31ab438tP7gsZ8k3J
13019zp9fL/VjzzV/BKz+doNNdx9aflp1/yjo6Ps379/EWteMrxV1bBP45SHq+ZOFOCNQhkBSDI9SGbQ
1302hWfRPpe56ShOZm7ZZY1E5nx+qjhDc+vSEGDMuM94s3qa8d3Mz2f+/1QT38z8zIzzNl/7mNl2YP52
1303KufJ39wyyJC2FzjldXP/npuueYr3npvufPc5kqQlWVsa5PMbihHCc3r3oYc6uO+N0az/jVP2iVPl
1304K21sm62TjLp9vjT8cwS5meWd8aOh+p5Ccd6w+IUXhUKxsOiCqO1y6y+OZj2SOlKSijue4HgmQVAV
1305CoXiN0AJLwqF4i2RnOur4nz2Gq1QKN5WFkR4EXhb2djinegG79zBFqTOggPfjMmGqi/FmzOnpZ2v
1306jkPPUr/LMGu8VEosxWIi3RfeDhZEeLElNIZc1hTZnsGaYmFwBHUhiXWGRWxJqA1KVV8KxVvBEVQH
1307ZTY+1pliS1gadpkoVP1PschwBPWhs9cXfh0WRHiZtAUfr7H4VK11+osVZ4QjvfI+kwXbpC34QIXF
1308nZWqvhSKt8LZ6HcZYo7gc3UWWr3qf4rFhyNh6iz1hV+HBds2cuTJJ5gVC8PZ2DZS9aVQ/HqczcHa
1309lpzsBVahWCS8HbudC2awq/rh4kLVl0Lx9qH6n0Lx66HMMxUKhUKhUCwqlPCiUCgUCoViUXHG20aG
1310gJB+5ideFGdOSJenjLwe0Lzv1UlMhWLhyIQHUGHNFIqF5cyEFwEjlmDvuM7UPDFzFL9dcgzJcGp+
1311XxEtUQ0XnaSr6kmhWCi0dPeLO8zqh4JTB0pWKN7J6AvkvujMhBdDsmNEZ8dw6CxlR3HGCGYHd0u3
1312mr864n9bsqNQnJcIQJvuhxLvRNHb4Q9DoXg7saUXN/Vso8IDnC8I1JEGheLtQJfsGtW5fU9oQQZx
1313heJcRgPGbIE8yxHTz47wolShiwNVTwrFbx8BMVtw7BRbugrFOxqJJ8Gc5bavNC8KhUKx0AhAf7sz
1314oVC8c1BHpRUKhUKhUCwqlPCiUCgUCoViUaGEF4VCoVAoFIsKJbwoFAqFQqFYVCjhRaFQKBQKxaJC
1315CS8KhUKhUCgWFUp4USgUCoVCsahQwotCoVAoFIpFxZk7qZOACsqoWGxo8s1FdweQql0rFArFWUEA
1316+tkLEXBmwost2FRk8/Eai5hzlnKkUCwwIQOeHdL5VbdvdhDLDK7gUw1J1kVcLzqwQqFQKH5j/Bq0
1317xTS+2+47a2vCMxNeJFQFJLeWWYzZapWqWBzkm5L+hOBXp1oESNiU7/DuEpsJ1a4VCoXijAjrkj1j
1318Ot/Dd9biA5/xtpElYcIWTKpBXrFI0AQkThPeN+4I1a4VCoXiLOBIiJ1l8xJlsKtQKBQKhWJRoYQX
1319hUKhUCgUiwolvCxyNE3D7/ej6/rbnRWFQvEWyfRbwzjzA59nA9MwCPj9aNrCTQlCCHw+H6ZpLtgz
1320FOcP50bPWeRomoZhGAiR2dOTWJaN657GsOIsPHcqGmVgYJCiwgLy8vIAMAwD21745ysU5xJCCEzT
1321RBMC27axHSf7uc/nw3UcLNt+0zR0XUfXdSzLQsqzd6xzJpqmEY3GODHQT25ODiXFxad9lmEYGIaO
132268qznjdNaBw/0c/E5CQV5WWEw+GzNnZkxkXbtnFsh56eXgzTpLysdMHKV3F+oDQvZ4ih68TjcV7Y
1323toN773+A++5/gIcefYLRsbEF1YYIvIGh7WgH//mze9h34A0Mw2BqKsqL23cyMjp6zqzqFIqFRtM0
1324EokEz724jV899Cg9vX2YpoGmaUxOTvHo40/y2v4DCCFmLDJOTmN4eIQXt+8kFostWP81DIOBwUF+
13259dCjvLZv/5vmCSHQdZ3WtjZ+8cDDvLh9JynLOqsaEl3XefX1fdx3/4Oc6B84a++taRqdx7rZvedl
1326NE1jYmqS+x96hCe3PnPW30Fx/qFmtzNA1zTGJiZ47MmtDA4NUVdTjWmaTE1FmZqaoqSoCGBWJ3Uc
1327B9d1EUJgGDogEIDjuriui2EYSCmx0ytE0zBACCzLSt9jIKWLwBvwamuquOaqd9FQV4sQgu07d3Ok
1328pZUlTY2YpokQgCS74jRNAynJpq9QvBMQQmDZNm1H2+k7foJoLMp7i24mkpNDPJnkjcNHsB2HNatW
1329ItICQUZgkFJm+9wzz7/I8MgI69aswjQ84Ue6LrbjpLUyGo7j4jhOdnFg2zaapp006TuOg5O9T0e6
1330LkLznq1pGn6fL62ZAF2fTmumRkJLp7PvwEEOHWkhLzeH+roaaqqrstoRw9ARQiPd1bN9O/OOAnDT
13317zc3n9NpGPj9vuxYZeg6Yp5xK6NJcV0XTdNw0tqtuWlqQjA2Ns6TTz9Dfn6Eiy7cTF4kwuWXXuxp
1332kdLXz9ZYky1rmB77kNL7nU4780zF+Y0SXs4AwzDo6u6h81gXa1ZdwAfffxuGYTA8PIJl20hgbHyc
1333XS+9zNDwMNWVlVx04aasWnb/gUMcOtJMMplk2ZImLlixjG07XyInJ8zll1yE4zg8/+J2LMvi6iuv
1334YHRsjJ27X2ZJUwOpVIp4PE51ZRXj4xMkEgl27NpNe2cnhmGw9dnnqagoIxqNUVRQwEVbNiMlPPXM
133586RSKa664jKCwaDaWlK8Y/C2jXzk5+XRd/wEr+59nWuuvBxdEwT8/rQw7wkPR5pbeH3/ARzHZcO6
1336tSxpauD5F7fTPzCApmk88viT1NfWMjg8QnVVBZs2rKe5pZXXD7zB+jWrWb50CTtfepmx8XGuftfl
1337aJpg955XaO/sRBMa9XW1bN64gUDAz9GODva+to8Vy5cyMT6JRFJeVpbVuOiawZ5X9tLWfpRlS5ey
1338fu3qrECl6zq93T0MDA6xfs0qunv76OrppbqqylvM6DrH+wd4+dXXGBsbIxwOc/W7LqOoqIjmllb2
1339HXiDWCxORUU5V11+GS4uu156mY7OTnLCOVx80YVUV1XOKkfDMOjt7WPXnpeZmJikoaGOLZs3IYDn
1340X9xOMplkSVMjh4+0sGH9GnRd9zRCKYtIbg6XX3oJPtNk63PPE0/EcUddfvnAQ2zasJ7xiQkCPn/6
13413TWOtnew9/X9JJNJ8vIiXHzhZsrLyxifmOCZ519E1zSKi713CQYCXHThZkpLS5QAo1DbRmeClJJI
1342bg7hcIhjXd08+fSztLd3khMOkxfJZXR0lIcefYKBwUHqamtoa+/ghe070TTBa6/v58mtzyKlpLKi
1343HF3XiccTdB47Rm9fXzb9rp5eOo91IaUkFovTeayLV/e+zo5dL3Gif4CRsVH2v3GQgcEhCvLzCQYD
1344CAEFBXmUlZQwNDzC/oMHSSQSxOIxDh9pRghBMBBQe86KdxyO41BaUsySpiZe33+AjmPdmMa0gaih
13456xw8fIQntz5LOByioCCfZ194kaPtHRQXF+HzedqHwsJC8vPz6O3r42h7B47j0NbewZEjLfT0HSdl
1346WRw6fAQrlUIIweNPPsMre1+jpLiY/Pw8du95medf3IYQgmg0RkfnMfa88ho797xMf/9ANj8+0+RY
1347Vzcv7thJLJ6gqb4eIcR03xSCto5OdE1j3bo15OVF6Ow8RjKZxDAM+gcHeejRx+np7aW8vIycnDCu
1348K2lpbeORx58iGotTVVmO3+cjmUry/IvbeW3ffqqrKkkkEzzx1FbGxyfQtWlNyMDAIA899jjRaJTq
13496kr2HzjE7j0vI4Sgf2CQIy2tvLBtB4eamxmfmORE/wAF+fnU19dyon+Arc89T9JKUVhYiK7r+EyT
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
13806erq4dEnnuKKSy+hsqKcYDBI57Eurr36SsrLStF0jWMd3Vx68RZMw6CyopxlS5dw4OBhr587Dr29
1381faxfu4aSokJ6e/tm9VuY1nDous6FmzfSd7yfp555jnAoRGNDPRIYHR2jpaWVUDDIrTd728uO4/DQ
1382o4+z78AbdPf0sXr1StraO3j2hW0cbe/AlZJLL9rCxvXreOLpZ3jksScoLSnBH/Bz8YWbWNrUxJHm
1383Vp7ftp1AIABIrrrichzbIZGI49gOTY0N7D94kL2v72doeCS9TVRJUVEhKcsikdGiSEk4HCYnHOZo
1384RyfJVIq+EydIWTaO42R92HR2HuPRx59m2bIl2LZNMpHE5/ezfu1qntr6LA8/+gSFhQV0dfdQVlrK
1385iqVLsB2HZCqFrk/btqRSVla7pFDoH//4x79WXu510LfCP782xMCkBboAV7A04nJ9iU3SPf/UeZmj
1386icPDIySTSWzbobiokBuuuZri4kKCwQB1tbVEo3GisSiO67C0qZGCgnwqy8uJ5OYSjUVJJlNUVpRT
1387V1tDSXExlm1jWSlWLFtCUVEhkUiEutoaXNfFtm2qqyspKS4CIUikO3N9bQ1FhYUUFhQgNA3LsijI
1388z6eqsgKBZyhXUlzMxvVrEEI7rweAgA77JnR2Dhkwn0sLKbixzKYx5JI6D9v1YiRzfDeR8LYiqqsq
1389EUIQCoXIyclB0wQ1VV6/qayoID8/z1v1x+LkhHNYtrQJ0+ejsKAge2y6pLiIstISkpaFz2eycsVy
1390CgsKSCaThMM5rFy5nEgkgqZp1NfWoOs6Y+PjgODCzRvZvHEDmhDEEwkkktrqaooKCwCwUha2Y1NR
1391Xk5TQwMF+Z6ti+04VJSXYRgGY2PjxONxli9bQk11FY7jIKXEl7aJy8uLsLSxgcrKcpLJFLF4nFAo
1392xJLGBqqrqigqKCAai5FIemXS2FBHY309ABOTk8TjCaorK6mpriIaixPw+6mvq6GyspLKigomJiaz
1393214rli0lFAoRjcXIi0Soq63FMA1C4SC5OTmMjo9TWFBAfV0toVCQurpaIpFc8vIi2LaFRFJRVoam
1394a5QUF1NdVUlZWQnFRUWMT0yQSCSprani2quvpCA/n1QqRSKRoKiwkJrqKnRNJxqLEsnNpb6uFr/f
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
1565"
1566 id="image2993"
1567 x="0"
1568 y="0" />
1569</svg>
diff --git a/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions_old.png b/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions_old.png
deleted file mode 100644
index 4011de8..0000000
--- a/doc/book-enea-nfv-access-guide/doc/images/virtual_network_functions_old.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-guide/doc/overview.xml b/doc/book-enea-nfv-access-guide/doc/overview.xml
deleted file mode 100644
index c173e82..0000000
--- a/doc/book-enea-nfv-access-guide/doc/overview.xml
+++ /dev/null
@@ -1,147 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="overview">
5 <title>Overview</title>
6
7 <para>The Enea NFV Access Guide available with this release seeks to provide
8 further information that will help all intended users make the most out of
9 the virtualization features.</para>
10
11 <section id="description">
12 <title>Enea NFV Access Description</title>
13
14 <para>Enea NFV Access is a lightweight virtualization software designed
15 for deployment on edge devices at customer premises. It has been
16 streamlined for high networking performance and low footprints for both
17 host platforms and VNFs, enabling high compute density. This software also
18 provides a foundation for vCPE agility and innovation, reducing cost and
19 complexity for computing at the network edge.</para>
20
21 <para>Enea NFV Access supports multiple architectures and scales from
22 small white box edge devices up to high-end network servers. It can also
23 be deployed on systems as small as single 2-core ARM devices. It scales up
24 to clustered 24 core OCTEON TX&trade; ARM Micro-servers and beyond,
25 allowing multiple VNFs on the same machine, and eliminating the need to
26 use different virtualization software for different hardware platforms,
27 saving costs through single source provisioning.</para>
28
29 <para>Optimized virtual networking performance provides low virtualized
30 networking latency, high virtualized networking throughput (10 Gb wire
31 speed), and low processing overhead. It allows high compute density on
32 white box hardware, maintaining performance when moving functionality from
33 application specific appliances, to software on standard hardware. The
34 optimized boot speed minimizes the time from reboot to active services,
35 improving availability.</para>
36
37 <para>Enea NFV Access provides virtualization using both containers and
38 virtual machines. Containers provide lightweight virtualization for a
39 smaller VNF footprint and a very short time interval from start to enabled
40 network services. VMs provide virtualization with secure VNF sandboxing
41 and are the preferred virtualization method for OPNFV compliance. Enea NFV
42 Access allows combinations of containers and VMs for the highest possible
43 user adaptability.</para>
44
45 <para>Flexible interfaces for VNF lifecycle management and service
46 function chaining, are important to allow for a smooth transition from
47 traditional network appliances to virtualized network functions in
48 existing networks. Enea NFV Access supports VNF lifecycle management and
49 service function chaining through NETCONF, REST, CLI and Docker. It
50 integrates a powerful device management framework that enables full FCAPS
51 functionality for powerful management of the platform.</para>
52
53 <para>Building on open source, Enea NFV Access prevents vendor lock-in
54 thanks to its completely open standards and interfaces. It includes
55 optimized components with open interfaces to allow full portability and
56 interoperability.</para>
57 </section>
58
59 <section id="components">
60 <title>Components</title>
61
62 <para>Enea NFV Access is built on highly optimized open source components
63 that provide standard interfaces with boosted performance.</para>
64
65 <mediaobject>
66 <imageobject role="fo">
67 <imagedata align="center" contentwidth="600"
68 fileref="images/virtual_network_functions.svg" />
69 </imageobject>
70
71 <imageobject role="html">
72 <imagedata align="center"
73 fileref="images/virtual_network_functions.png" />
74 </imageobject>
75 </mediaobject>
76
77 <para>The Access Platform includes the following key components:</para>
78
79 <itemizedlist>
80 <listitem>
81 <para>Linux Kernel - Optimized Linux kernel with the focus on vCPE
82 systems characteristics.</para>
83 </listitem>
84
85 <listitem>
86 <para>KVM - Virtualization with virtual machines. KVM is the standard
87 virtualization engine for Linux based systems.</para>
88 </listitem>
89
90 <listitem>
91 <para>Docker - Provides a lightweight configuration using containers.
92 Docker is the standard platform for container virtualization.</para>
93 </listitem>
94
95 <listitem>
96 <para>Virtual switching - Optimized OVS-DPDK provides high throughput
97 and low latency.</para>
98 </listitem>
99
100 <listitem>
101 <para>Edge Link - Provides interfaces to orchestration for centralized
102 VNF lifecycle management and service function chaining:</para>
103
104 <orderedlist>
105 <listitem>
106 <para>NETCONF</para>
107 </listitem>
108
109 <listitem>
110 <para>Docker</para>
111 </listitem>
112
113 <listitem>
114 <para>REST</para>
115 </listitem>
116
117 <listitem>
118 <para>CLI</para>
119 </listitem>
120 </orderedlist>
121 </listitem>
122
123 <listitem>
124 <para>APT packet management - Feature rich repository of prebuilt open
125 source packages for extending and adapting the platform using APT
126 Package Management.</para>
127 </listitem>
128
129 <listitem>
130 <para>CLI based VNF management - CLI access over
131 <literal><filename>virsh</filename></literal> and
132 <filename>libvirt</filename>.</para>
133 </listitem>
134
135 <listitem>
136 <para>FCAPS framework - Device management framework for managing the
137 platform, capable of providing full FCAPS functionality to
138 orchestration or network management systems.</para>
139 </listitem>
140
141 <listitem>
142 <para>Data plane - High performance data plane that includes the DPDK
143 optimized data plane driver.</para>
144 </listitem>
145 </itemizedlist>
146 </section>
147</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/ovs.xml b/doc/book-enea-nfv-access-guide/doc/ovs.xml
deleted file mode 100644
index de14f76..0000000
--- a/doc/book-enea-nfv-access-guide/doc/ovs.xml
+++ /dev/null
@@ -1,162 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="ovs">
5 <title>Open Virtual Switch</title>
6
7 <para>Open vSwitch (OVS) is an open-source multilayer virtual switch
8 designed to be used in virtualized environments to forward traffic between
9 different VMs on the same host, and also between VMs and the physical
10 network.</para>
11
12 <para>Native OVS forwarding is handled by two major components: a user-space
13 daemon called <literal>ovs-vswitchd</literal> and a
14 <literal>fastpath</literal> kernel module used to accelerate the data path.
15 The fastpath kernel module will handle packets received on the NIC by simply
16 consulting a flow table with corresponding action rules (e.g to forward the
17 packet or modify its headers). If no matching entry is found in the flow
18 table, the packet is copied to the user-space and sent to the ovs-vswitchd
19 deamon which determines how it should be handled ("slowpath").</para>
20
21 <para>The packet is then passed back to the kernel module together with the
22 desired action and the flow table is updated, so that subsequent packets in
23 the same flow can be handled in fastpath without any user-space interaction.
24 In this way, OVS eliminates a lot of the context switching between
25 kernel-space and user-space, but the throughput is still limited by the
26 capacity of the Linux kernel stack.</para>
27
28 <section id="ovs-dpdk">
29 <title>OVS-DPDK</title>
30
31 <para>To improve performance, OVS supports integration with Intel DPDK
32 libraries to operate entirely in user-space (OVS-DPDK). DPDK Poll Mode
33 Drivers (PMDs) enable direct transfers of packets between the physical NIC
34 and user-space, thereby eliminating the overhead of interrupt handling and
35 Linux kernel network stack processing. OVS-DPDK provides DPDK-backed
36 vhost-user ports as the primary way to connect guests to this datapath.
37 The vhost-user interfaces are transparent to the guest.</para>
38 </section>
39
40 <section id="ovs-commands">
41 <title>OVS commands</title>
42
43 <para>OVS provides a rich set of command line management tools, most
44 importantly:</para>
45
46 <itemizedlist>
47 <listitem>
48 <para>ovs-vsctl: Used to manage and inspect switch configurations,
49 e.g. to create bridges and to add/remove ports.</para>
50 </listitem>
51
52 <listitem>
53 <para>ovs-ofctl: Used to configure and monitor flows.</para>
54 </listitem>
55 </itemizedlist>
56
57 <para>For more information about Open vSwitch, see <ulink
58 url="http://openvswitch.org">http://openvswitch.org</ulink>.</para>
59 </section>
60
61 <section id="config-ovs-dpdk">
62 <title>Configuring OVS-DPDK for improved performance</title>
63
64 <section id="dpdk-lcore-mask">
65 <title>dpdk-lcore-mask</title>
66
67 <para>Specifies the CPU core affinity for DPDK lcore threads. The lcore
68 threads are used for DPDK library tasks. For performance it is best to
69 set this to a single core on the system, and it should not overlap the
70 pmd-cpu-mask, as seen in the example below.</para>
71
72 <para>Example: To use core 1:</para>
73
74 <programlisting>ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x1</programlisting>
75 </section>
76
77 <section id="pmd-cpu-mask">
78 <title>pmd-cpu-mask</title>
79
80 <para>The DPDK PMD threads polling for incoming packets are CPU bound
81 and should be pinned to isolated cores for optimal performance.</para>
82
83 <para>If OVS-DPDK receives traffic on multiple ports, for example when
84 DPDK and vhost-user ports are used for bi-directional traffic, the
85 performance can be significantly improved by creating multiple PMD
86 threads and affinitizing them to separate cores in order to share the
87 workload, by each being responsible for an individual port. The cores
88 should not be hyperthreads on the same CPU.</para>
89
90 <para>The PMD core affinity is specified by setting an appropriate core
91 mask. Example: using cores 2 and 3:</para>
92
93 <programlisting>ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc</programlisting>
94 </section>
95 </section>
96
97 <section id="setup-ovs-dpdk">
98 <title>How to set up OVS-DPDK</title>
99
100 <para>The DPDK must be configured prior to setting up OVS-DPDK. See <xref
101 linkend="dpdk-setup" /> for DPDK setup instructions, then follow these
102 steps:</para>
103
104 <orderedlist>
105 <listitem>
106 <para>Clean up the environment:</para>
107
108 <programlisting>killall ovsdb-server ovs-vswitchd
109rm -f /var/run/openvswitch/vhost-user*
110rm -f /etc/openvswitch/conf.db</programlisting>
111 </listitem>
112
113 <listitem>
114 <para>Start the ovsdb-server:</para>
115
116 <programlisting>export DB_SOCK=/var/run/openvswitch/db.sock
117ovsdb-tool create /etc/openvswitch/conf.db /usr/share/openvswitch/vswitch.ovsschema
118ovsdb-server --remote=punix:$DB_SOCK \
119--remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach</programlisting>
120 </listitem>
121
122 <listitem>
123 <para>Start ovs-vswitchd with DPDK support enabled:</para>
124
125 <programlisting>ovs-vsctl --no-wait init
126ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x1
127ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
128ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
129ovs-vswitchd unix:$DB_SOCK --pidfile --detach \
130--log-file=/var/log/openvswitch/ovs-vswitchd.log</programlisting>
131 </listitem>
132
133 <listitem>
134 <para>Create the OVS bridge and attach ports:</para>
135
136 <programlisting>ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
137ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 type=dpdk \
138:dpdk-devargs=&lt;PCI device&gt;</programlisting>
139 </listitem>
140
141 <listitem>
142 <para>Add DPDK vhost-user ports:</para>
143
144 <programlisting>ovs-vsctl add-port ovsbr0 vhost-user1 -- set Interface vhost-user1 type=dpdkvhostuser</programlisting>
145
146 <para>This command creates a socket at
147 <literal>/var/run/openvswitch/vhost-user1</literal>, which can be
148 provided to the VM on the QEMU command line. See <xref
149 linkend="net_in_guest" /> for details.</para>
150 </listitem>
151
152 <listitem>
153 <para>Define flows:</para>
154
155 <programlisting>ovs-ofctl del-flows ovsbr0
156ovs-ofctl show ovsbr0
157ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
158ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>
159 </listitem>
160 </orderedlist>
161 </section>
162</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/doc/using_nfv_access_sdks.xml b/doc/book-enea-nfv-access-guide/doc/using_nfv_access_sdks.xml
deleted file mode 100644
index df5df43..0000000
--- a/doc/book-enea-nfv-access-guide/doc/using_nfv_access_sdks.xml
+++ /dev/null
@@ -1,473 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="workflow">
5 <title>Using Enea NFV Access SDKs</title>
6
7 <para>Enea NFV Access comes with a standard SDK which can be used to develop
8 user-applications and kernel modules for both host and guest images.</para>
9
10 <para>The standard SDK consists of:</para>
11
12 <itemizedlist>
13 <listitem>
14 <para>Cross-Development Toolchain: cross-compiler and
15 cross-debugger</para>
16 </listitem>
17
18 <listitem>
19 <para>Libraries, Headers and Symbols that are specific to the
20 image</para>
21 </listitem>
22
23 <listitem>
24 <para>Environment Setup Script which defines the environment
25 variables</para>
26 </listitem>
27 </itemizedlist>
28
29 <para>To install the SDK on your host development machine, there is an
30 installation script available under the Download section on <ulink
31 url="https://portal.enea.com/">portal.enea.com</ulink>:</para>
32
33 <itemizedlist>
34 <listitem>
35 <para>aarch/install/install-sdk.sh</para>
36 </listitem>
37 </itemizedlist>
38
39 <para>After installing the SDK, a developer will be able to compile and
40 generate executables for the preferred target machine. Cross-gdb
41 (<filename>enea-linux-gdb</filename>) is created by the Cross-Development
42 toolchain. It can be used to debug applications on the target platform from
43 the development workstation. For kernel debugging, <command>ftrace</command>
44 and <command>kgdb</command> are enabled on the host sdk image.</para>
45
46 <para>Various user-space tools helpful in the development process, are also
47 provided. The tools include <emphasis role="bold">LatencyTop</emphasis>,
48 <emphasis role="bold">Perf</emphasis>, <emphasis
49 role="bold">CrossTap</emphasis>, <emphasis role="bold">OProfile</emphasis>,
50 <emphasis role="bold">Lttng-ust</emphasis> and <emphasis
51 role="bold">GDBserver</emphasis>.</para>
52
53 <section id="install-crosscomp">
54 <title>Installing the Cross-Compilation Toolchain</title>
55
56 <para>Before cross-compiling applications for your target, you need to
57 install the corresponding toolchain on your workstation. To do that,
58 simply run the installer and follow the steps included with it:</para>
59
60 <orderedlist>
61 <listitem>
62 <para><programlisting>$ ./install-sdk.sh</programlisting>When
63 prompted, select to install the toolchain in the desired directory,
64 referred to as <literal>sdkdir</literal>.</para>
65
66 <para>A default path where the toolchain will be installed will be
67 shown in the prompt. The installer unpacks the environment setup
68 script in <literal>sdkdir</literal> and the toolchain under
69 <literal>sdkdir/sysroots</literal>.</para>
70
71 <note>
72 <para>Choose a unique directory for each toolchain. Installing a
73 second toolchain of any type in the same directory as a previously
74 installed one will break the <literal>$PATH</literal> variable of
75 the first one.</para>
76 </note>
77 </listitem>
78
79 <listitem>
80 <para>Setup the toolchain environment for your target by sourcing the
81 environment-setup script. Example: <programlisting>$ source sdkdir/environment-setup-aarch64-enea-linux</programlisting></para>
82 </listitem>
83 </orderedlist>
84 </section>
85
86 <section id="crosscomp-apps">
87 <title>Cross-Compiling Applications from Command Line</title>
88
89 <para>Once the environment-setup script is sourced, you can make your
90 applications as per usual and get them compiled for your target. Below you
91 see how to cross-compile from command line.</para>
92
93 <orderedlist>
94 <listitem>
95 <para>Create a Makefile for your application. Example: a simple
96 Makefile and application:</para>
97
98 <programlisting>helloworld:helloworld.o
99 $(CC) -o helloworld helloworld.o
100clean:
101 rm -f *.o helloworld
102#include &lt;stdio.h&gt;
103int main(void) {
104 printf("Hello World\n");
105 return 0;
106}</programlisting>
107 </listitem>
108
109 <listitem>
110 <para>Run <command>make</command> to cross-compile your application
111 according to the environment set up:</para>
112
113 <programlisting>$ make</programlisting>
114 </listitem>
115
116 <listitem>
117 <para>Deploy the helloworld program to your target and run it:</para>
118
119 <programlisting># ./helloworld
120hello world</programlisting>
121 </listitem>
122 </orderedlist>
123 </section>
124
125 <section id="crosscomp-kern-mod">
126 <title>Cross-Compiling Kernel Modules</title>
127
128 <para>Before cross-compiling kernle modules, you need to make sure the
129 installed toolchain includes the kernel source tree, which should be
130 available at:
131 <literal>sdkdir/sysroots/targetarch-enea-linux/usr/src/kernel</literal>.</para>
132
133 <para>Once the environment-setup script is sourced, you can make your
134 kernel modules as usual and get them compiled for your target. Below you
135 see how to cross-compile a kernel module.</para>
136
137 <orderedlist>
138 <listitem>
139 <para>Create a Makefile for the kernel module. Example: a simple
140 Makefile and kernel module:</para>
141
142 <programlisting>obj-m := hello.o
143PWD := $(shell pwd)
144
145KERNEL_SRC := full path to kernel source tree
146
147all: scripts
148 $(MAKE) -C $(KERNEL_SRC) M=$(PWD) LDFLAGS="" modules
149scripts:
150 $(MAKE) -C $(KERNEL_SRC) scripts
151clean:
152 $(MAKE) -C $(KERNEL_SRC) M=$(PWD) LDFLAGS="" clean
153#include &lt;linux/module.h&gt; /* Needed by all modules */
154#include &lt;linux/kernel.h&gt; /* Needed for KERN_INFO */
155#include &lt;linux/init.h&gt; /* Needed for the macros */
156
157static int __init hello_start(void)
158{
159 printk(KERN_INFO "Loading hello module...\n");
160 printk(KERN_INFO "Hello, world\n");
161 return 0;
162}
163
164static void __exit hello_end(void)
165{
166 printk(KERN_INFO "Goodbye, world\n");
167}
168
169module_init(hello_start);
170module_exit(hello_end);
171
172MODULE_LICENSE("GPL");</programlisting>
173 </listitem>
174
175 <listitem>
176 <para>Run <command>make</command> to cross-compile your kernel module
177 according to the environment set up:</para>
178
179 <programlisting>$ make</programlisting>
180 </listitem>
181
182 <listitem>
183 <para>Deploy the kernel module <literal>hello.ko</literal> to your
184 target and install/remove it:</para>
185
186 <programlisting># insmod hello.ko
187# rmmod hello.ko</programlisting>
188 </listitem>
189 </orderedlist>
190
191 <para>If you build a module using the SDK for development image, and
192 insert to the release image you will get error when running
193 <literal>rmmod</literal>: <programlisting>root@cn8304:~# rmmod hello.ko &lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;&lt;
194rmmod: ERROR: could not remove module hello.ko: Device or resource busy</programlisting></para>
195 </section>
196
197 <section id="deploy-artifacts">
198 <title>Deploying your artifacts</title>
199
200 <section id="deploy_onhost">
201 <title>Deploying on host</title>
202
203 <para>You can use <literal>ssh</literal> to deploy your artifacts on the
204 host target. For this you will need a network connection to the target,
205 to use <literal>scp</literal> to copy to the desired location.</para>
206
207 <para><programlisting>$ scp helloworld root@&lt;target_ip_address&gt;:/tmp</programlisting></para>
208 </section>
209
210 <section id="deploy_onguest">
211 <title>Deploying on guest</title>
212
213 <para>You can deploy your artifacts onto the guest VM running on the
214 target, by using TAP Networking. You can use the
215 <filename>/etc/qemu-ifup</filename> script to create the tap interface
216 on the host and attach it to the existing virtual bridge
217 (<literal>virbr0</literal>). This bridge interface is created by the
218 <filename>libvirt</filename> library and can be used to connect to the
219 outside network. To be able to transfer files to the guest via
220 <literal>scp</literal>, port forwarding should be enabled on the host.
221 The script sets iptables rules to forward traffic from a host port to
222 the guest default SSH port (22).</para>
223
224 <para>Follow the steps below to create this setup:</para>
225
226 <orderedlist>
227 <listitem>
228 <para>On the host, run the <literal>qemu-ifup</literal> script
229 located in <literal>/etc</literal> directory:</para>
230
231 <para><programlisting># /etc/qemu-ifup -t tap0 -a 192.168.122.10 -p 1050 -g 22</programlisting></para>
232
233 <itemizedlist>
234 <listitem>
235 <para><emphasis role="bold">tap0</emphasis> - the tap interface
236 name which will be created and added to the virtual bridge
237 (virbr0).</para>
238 </listitem>
239
240 <listitem>
241 <para><emphasis role="bold">192.168.122.10</emphasis> - the IP
242 address of the guest virtual network device. It has to be in the
243 same network with the IP address of the virbr0 interface.</para>
244 </listitem>
245
246 <listitem>
247 <para><emphasis role="bold">1050</emphasis> - the host port
248 which is set to forward traffic from the host to the
249 guest.</para>
250 </listitem>
251
252 <listitem>
253 <para><emphasis role="bold">22</emphasis> - the default SSH
254 guest port used in port forwarding.</para>
255 </listitem>
256 </itemizedlist>
257 </listitem>
258
259 <listitem>
260 <para>Launch the virtual machine specifying the newly created tap
261 interface:</para>
262
263 <para><programlisting>-device e1000,netdev=net0 \
264-netdev tap,id=net0,ifname=tap0,script=no,downscript=no</programlisting></para>
265 </listitem>
266
267 <listitem>
268 <para>On the guest, after logging, configure the virtual network
269 device and set the default gateway as the <literal>virbr0</literal>
270 ip address:</para>
271
272 <para><programlisting># ip addr add 192.168.122.10/24 dev enp0s2
273# ip link set enp0s2 up
274# ip route add default via 192.168.122.1 dev enp0s2</programlisting></para>
275 </listitem>
276
277 <listitem>
278 <para>Now you can use <literal>scp</literal> from your development
279 machine to deploy your artifacts on the guest, by giving the host
280 port for forwarding as a command parameter: <programlisting>$ scp -P 1050 helloworld root@target_ip_address:/tmp</programlisting></para>
281 </listitem>
282
283 <listitem>
284 <para>On the host, after finishing the deployment session and
285 stopping the virtual machine, you can use the
286 <literal>qemu-ifdown</literal> script to clean up the configuration
287 on host. The following command will remove the tap interface and all
288 the iptables rules for the specific ip address: <programlisting># /etc/qemu-ifdown -t tap0 -a 192.168.122.10</programlisting>If
289 we need to remove only a particular port forwarding rule from
290 iptables, this should be run: <programlisting># /etc/qemu-ifdown -t tap0 -a 192.168.122.10 -p 1050 -g 22</programlisting></para>
291 </listitem>
292 </orderedlist>
293 </section>
294 </section>
295
296 <section id="crossdebugging">
297 <title>Cross-Debugging on Enea NFV Access</title>
298
299 <para>The cross-debugger (<literal>aarch64-enea-linux-gdb</literal>) is
300 created when installing the SDK on the development machine. It is helpful
301 for debugging both the kernel and user-applications. In order to perform
302 this task, we need the following tools to be available on the target
303 machine:</para>
304
305 <itemizedlist>
306 <listitem>
307 <para>Kgdb - for kernel cross-debugging</para>
308 </listitem>
309
310 <listitem>
311 <para>GDBServer - for application cross-debugging</para>
312 </listitem>
313 </itemizedlist>
314
315 <para>The Host Development image provides both of these tools and has to
316 be booted on the target machine for cross-debugging sessions.</para>
317
318 <section id="ua_debug_host">
319 <title>User-application Cross-Debugging on Host</title>
320
321 <para>To debug a user-application on host, a TCP connection has to be
322 established between the host and development machines. GDBserver is the
323 program which runs on the target machine and allows you to run GDB on
324 your workstation. Below you can find how a simple
325 <filename>helloworld</filename> application can be debugged using
326 GDBServer and cross-gdb.</para>
327
328 <para>On target, launch the GDBServer, specifying how to communicate
329 with GDB and the name of your program:<programlisting># gdbserver :&lt;port_no&gt; /tmp/helloworld</programlisting>The
330 target will now be listening on the port given as a parameter to the
331 gdbserver. On the development machine, from the
332 <literal>&lt;sdkdir&gt;</literal>, start the cross-gdb:<programlisting>$ aarch64-enea-linux-gdb &lt;path_to_the_program&gt;/helloworld</programlisting>Connect
333 the GDB to the target: <programlisting>(gdb) target remote &lt;target_ip_address&gt;:&lt;port_no&gt;</programlisting>Now
334 remote debugging is started and the GDB commands are available to debug
335 your program from the target machine.</para>
336 </section>
337
338 <section id="us_debug_guest">
339 <title>User-application Cross-Debugging on Guest</title>
340
341 <para>To debug a user-application on guest, a TCP connection has to be
342 established between the host and development machines. Similarly, as
343 when deploying artifacts on guest, for a cross-debugging session, TAP
344 Networking is required.</para>
345
346 <para>A tap interface should be added to the existing virtual bridge
347 (<literal>virbr0</literal>), along with port forwarding rules created in
348 iptables. In order to do this, the script
349 <filename>/etc/qemu-ifup</filename> can pe used:</para>
350
351 <orderedlist>
352 <listitem>
353 <para>On the host, run the script <literal>qemu-ifup</literal>
354 located in <literal>/etc</literal> directory: <programlisting># /etc/qemu-ifup -t tap0 -a 192.168.122.10 -p 1051 -g 1025</programlisting></para>
355
356 <itemizedlist>
357 <listitem>
358 <para><emphasis role="bold">tap0</emphasis> - the tap interface
359 name which will be created and added to virtual bridge
360 (virbr0).</para>
361 </listitem>
362
363 <listitem>
364 <para><emphasis role="bold">192.168.122.10</emphasis> - the IP
365 address of the guest virtual network device. It has to be in the
366 same network with the IP address of the virbr0 interface.</para>
367 </listitem>
368
369 <listitem>
370 <para><emphasis role="bold">1051</emphasis> - the host port
371 which is set to forward traffic from the host to the guest and
372 is used by gdb target remote command.</para>
373 </listitem>
374
375 <listitem>
376 <para><emphasis role="bold">1025</emphasis> - the port used by
377 GDBServer on guest for listening.</para>
378 </listitem>
379 </itemizedlist>
380 </listitem>
381
382 <listitem>
383 <para>Launch the virtual machine, specifying the newly created tap
384 interface:<programlisting>-device e1000,netdev=net0 \
385-netdev tap,id=net0,ifname=tap0,script=no,downscript=no</programlisting></para>
386 </listitem>
387
388 <listitem>
389 <para>On the guest, after logging, configure the virtual network
390 device and set the default gateway to virbr0 ip
391 address:<programlisting>ip addr add 192.168.122.10/24 dev enp0s2
392ip link set enp0s2 up
393ip route add default via 192.168.122.1 dev enp0s2</programlisting></para>
394 </listitem>
395
396 <listitem>
397 <para>GDBserver is the program which runs on the guest VM and allows
398 you to run GDB on your workstation. On the guest, launch GBDserver
399 specifying how to communicate with GDB and the name of your program:
400 <programlisting># gdbserver :1025 /tmp/helloworld</programlisting>The
401 guest is now listening on port 1025, given as a parameter to the
402 gdbserver.</para>
403 </listitem>
404
405 <listitem>
406 <para>On the development machine, from the<filename>
407 &lt;sdkdir&gt;</filename>, start the cross-gdb:<programlisting>$ aarch64-enea-linux-gdb &lt;path_to_the_program&gt;/helloworld</programlisting></para>
408 </listitem>
409
410 <listitem>
411 <para>Connect GDB to the target:<programlisting>(gdb) target remote &lt;target_ip_address&gt;:1051</programlisting>Now
412 remote debugging is started and the GDB commands are available to
413 debug your program from the guest VM.</para>
414 </listitem>
415
416 <listitem>
417 <para>On the host, after finishing the cross-debugging session and
418 stopping the virtual machine, you can use the
419 <filename>qemu-ifdown</filename> script to clean up the
420 configuration on host:<programlisting># /etc/qemu-ifdown -t tap0 -a 192.168.122.10</programlisting></para>
421 </listitem>
422 </orderedlist>
423 </section>
424
425 <section id="kernel_crossdebug">
426 <title>Kernel Cross-Debugging</title>
427
428 <para>In order to debug the kernel, a serial connection is required
429 between the development and target machines. Debugging commands will be
430 sent from your workstation to the target machine via a serial
431 port.</para>
432
433 <para>The KGDB kernel options are enabled in the Enea NFV Access Host
434 SDK image and the tool can be used in the following way:</para>
435
436 <itemizedlist>
437 <listitem>
438 <para>On target, once serial communication is established, configure
439 <literal>kgdboc</literal> after the kernel boots:<programlisting># echo ttyS0,115200 &gt; /sys/module/kgdboc/parameters/kgdboc</programlisting></para>
440 </listitem>
441
442 <listitem>
443 <para>In order to connect to gdb via kgdboc, the kernel must first
444 be stopped:<programlisting># echo g &gt; /proc/sysrq-trigger</programlisting></para>
445 </listitem>
446
447 <listitem>
448 <para>Close the console to the target, eg.: <command>Ctrl +
449 ]</command> for a telnet session.</para>
450 </listitem>
451
452 <listitem>
453 <para>On your development machine, start cross-gdb using the vmlinux
454 kernel image as a parameter. The image is located in
455 <filename>&lt;sdkdir&gt;/sysroots/aarch64-enea-linux/boot/</filename>
456 and should be the same as the image found in the
457 <literal>/boot</literal> directory from the target:<programlisting>$ aarch64-enea-linux-gdb \
458 ./sysroots/aarch64-enea-linux/boot/ \
459 vmlinux-4.9.0-octeontx.sdk.6.1.0.p3.build.22-cavium-tiny</programlisting></para>
460 </listitem>
461
462 <listitem>
463 <para>Connect GDB to the target machine using the target command and
464 the serial device:<programlisting>(gdb) set remotebaud 115200
465(gdb) target remote /dev/ttyS0</programlisting></para>
466 </listitem>
467 </itemizedlist>
468
469 <para>The kernel can now be debugged in a similar manner as an
470 application program.</para>
471 </section>
472 </section>
473</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-guide/swcomp.mk b/doc/book-enea-nfv-access-guide/swcomp.mk
deleted file mode 100644
index 0d205f3..0000000
--- a/doc/book-enea-nfv-access-guide/swcomp.mk
+++ /dev/null
@@ -1,10 +0,0 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-access-guide
9BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access $(PROD_VER) Guide"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/benchmarks.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/benchmarks.xml
deleted file mode 100644
index 4063515..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/benchmarks.xml
+++ /dev/null
@@ -1,1488 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter condition="hidden" id="benchmarks">
5 <title>Benchmarks</title>
6
7 <section id="hw-setup">
8 <title>Hardware Setup</title>
9
10 <para>The following table describes all the needed prequisites for an apt
11 hardware setup:</para>
12
13 <table>
14 <title>Hardware Setup</title>
15
16 <tgroup cols="2">
17 <colspec align="left" />
18
19 <thead>
20 <row>
21 <entry align="center">Item</entry>
22
23 <entry align="center">Description</entry>
24 </row>
25 </thead>
26
27 <tbody>
28 <row>
29 <entry align="left">Server Platform</entry>
30
31 <entry align="left">Supermicro X10SDV-4C-TLN2F
32 http://www.supermicro.com/products/motherboard/xeon/d/X10SDV-4C-TLN2F.cfm</entry>
33 </row>
34
35 <row>
36 <entry align="left">ARCH</entry>
37
38 <entry>x86-64</entry>
39 </row>
40
41 <row>
42 <entry align="left">Processor</entry>
43
44 <entry>1 x Intel Xeon D-1521 (Broadwell), 4 cores, 8
45 hyper-threaded cores per processor</entry>
46 </row>
47
48 <row>
49 <entry align="left">CPU freq</entry>
50
51 <entry>2.40 GHz</entry>
52 </row>
53
54 <row>
55 <entry align="left">RAM</entry>
56
57 <entry>16GB</entry>
58 </row>
59
60 <row>
61 <entry align="left">Network</entry>
62
63 <entry>Dual integrated 10G ports</entry>
64 </row>
65
66 <row>
67 <entry align="left">Storage</entry>
68
69 <entry>Samsung 850 Pro 128GB SSD</entry>
70 </row>
71 </tbody>
72 </tgroup>
73 </table>
74
75 <para>Generic tests configuration:</para>
76
77 <itemizedlist>
78 <listitem>
79 <para>All tests use one port, one core and one Rx/TX queue for fast
80 path traffic.</para>
81 </listitem>
82 </itemizedlist>
83 </section>
84
85 <section condition="hidden" id="use-cases">
86 <title>Use Cases</title>
87
88 <section id="docker-benchmarks">
89 <title>Docker related benchmarks</title>
90
91 <section id="fwd_traffic_dock">
92 <title>Forward traffic in Docker</title>
93
94 <para>Benchmarking traffic forwarding using testpmd in a Docker
95 container.</para>
96
97 <para>Pktgen is used to generate UDP traffic that will reach testpmd,
98 running in a Docker image. It will then be forwarded back to source on
99 the return trip (<emphasis role="bold">Forwarding</emphasis>).</para>
100
101 <para>This test measures:</para>
102
103 <itemizedlist>
104 <listitem>
105 <para>pktgen TX, RX in packets per second (pps) and Mbps</para>
106 </listitem>
107
108 <listitem>
109 <para>testpmd TX, RX in packets per second (pps)</para>
110 </listitem>
111
112 <listitem>
113 <para>divide testpmd RX / pktgen TX in pps to obtain throughput in
114 percentages (%)</para>
115 </listitem>
116 </itemizedlist>
117
118 <section id="usecase-one">
119 <title>Test Setup for Target 1</title>
120
121 <para>Start by following the steps below:</para>
122
123 <para>SSD boot using the following <literal>grub.cfg</literal>
124 entry: <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
125isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
126clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
127processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
128intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
129hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting></para>
130
131 <para>Kill unnecessary services:<programlisting>killall ovsdb-server ovs-vswitchd
132rm -rf /etc/openvswitch/*
133mkdir -p /var/run/openvswitch</programlisting>Mount hugepages and configure
134 DPDK:<programlisting>mkdir -p /mnt/huge
135mount -t hugetlbfs nodev /mnt/huge
136modprobe igb_uio
137dpdk-devbind --bind=igb_uio 0000:03:00.0</programlisting>Run
138 pktgen:<programlisting>cd /usr/share/apps/pktgen/
139./pktgen -c 0xF -n 1 -- -P -m "[3:2].0"</programlisting>In the pktgen console
140 run:<programlisting>str</programlisting>To change framesize for
141 pktgen, from [64, 128, 256, 512]:<programlisting>set 0 size &amp;lt;number&amp;gt;</programlisting></para>
142 </section>
143
144 <section id="usecase-two">
145 <title>Test Setup for Target 2</title>
146
147 <para>Start by following the steps below:</para>
148
149 <para>SSD boot using the following <literal>grub.cfg</literal>
150 entry:</para>
151
152 <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
153isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
154clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
155processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
156intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
157hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>
158
159 <para>It is expected to have Docker/guest image on target. Configure
160 the OVS bridge:<programlisting># OVS old config clean-up
161killall ovsdb-server ovs-vswitchd
162rm -rf /etc/openvswitch/*
163mkdir -p /var/run/openvswitch
164
165# Mount hugepages and bind interfaces to dpdk
166mkdir -p /mnt/huge
167mount -t hugetlbfs nodev /mnt/huge
168modprobe igb_uio
169dpdk-devbind --bind=igb_uio 0000:03:00.0
170
171# configure openvswitch with DPDK
172export DB_SOCK=/var/run/openvswitch/db.sock
173ovsdb-tool create /etc/openvswitch/conf.db /
174/usr/share/openvswitch/vswitch.ovsschema
175ovsdb-server --remote=punix:$DB_SOCK /
176--remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
177ovs-vsctl --no-wait init
178ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
179ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
180ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
181ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
182ovs-vswitchd unix:$DB_SOCK --pidfile --detach /
183--log-file=/var/log/openvswitch/ovs-vswitchd.log
184
185ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
186ovs-vsctl add-port ovsbr0 vhost-user1 /
187-- set Interface vhost-user1 type=dpdkvhostuser ofport_request=1
188ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface /
189dpdk0 type=dpdk options:dpdk-devargs=0000:03:00.0 ofport_request=2
190
191# configure static flows
192ovs-ofctl del-flows ovsbr0
193ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
194ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
195 Docker container:<programlisting>docker import enea-nfv-access-guest-qemux86-64.tar.gz el7_guest</programlisting>Start
196 the Docker container:<programlisting>docker run -it --rm -v /var/run/openvswitch/:/var/run/openvswitch/ /
197-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>Start the testpmd
198 application in Docker:<programlisting>testpmd -c 0x30 -n 2 --file-prefix prog1 --socket-mem 512 --no-pci /
199--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 /
200/usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 /
201--disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 /
202--rxq=1 --txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>To
203 start traffic <emphasis role="bold">forwarding</emphasis>, run the
204 following command in testpmd CLI:<programlisting>start</programlisting>To
205 start traffic but in <emphasis role="bold">termination</emphasis>
206 mode (no traffic sent on TX), run following command in testpmd
207 CLI:<programlisting>set fwd rxonly
208start</programlisting><table>
209 <title>Results in forwarding mode</title>
210
211 <tgroup cols="8">
212 <tbody>
213 <row>
214 <entry align="center"><emphasis
215 role="bold">Bytes</emphasis></entry>
216
217 <entry align="center"><emphasis role="bold">pktgen pps
218 TX</emphasis></entry>
219
220 <entry align="center"><emphasis role="bold">pktgen MBits/s
221 TX</emphasis></entry>
222
223 <entry align="center"><emphasis role="bold">pktgen pps
224 RX</emphasis></entry>
225
226 <entry align="center"><emphasis role="bold">pktgen MBits/s
227 RX</emphasis></entry>
228
229 <entry align="center"><emphasis role="bold">testpmd pps
230 RX</emphasis></entry>
231
232 <entry align="center"><emphasis role="bold">testpmd pps
233 TX</emphasis></entry>
234
235 <entry align="center"><emphasis role="bold">throughput
236 (%)</emphasis></entry>
237 </row>
238
239 <row>
240 <entry role="bold"><emphasis
241 role="bold">64</emphasis></entry>
242
243 <entry>14877658</entry>
244
245 <entry>9997</entry>
246
247 <entry>7832352</entry>
248
249 <entry>5264</entry>
250
251 <entry>7831250</entry>
252
253 <entry>7831250</entry>
254
255 <entry>52,65%</entry>
256 </row>
257
258 <row>
259 <entry><emphasis role="bold">128</emphasis></entry>
260
261 <entry>8441305</entry>
262
263 <entry>9994</entry>
264
265 <entry>7533893</entry>
266
267 <entry>8922</entry>
268
269 <entry>7535127</entry>
270
271 <entry>7682007</entry>
272
273 <entry>89,27%</entry>
274 </row>
275
276 <row>
277 <entry role="bold"><emphasis
278 role="bold">256</emphasis></entry>
279
280 <entry>4528831</entry>
281
282 <entry>9999</entry>
283
284 <entry>4528845</entry>
285
286 <entry>9999</entry>
287
288 <entry>4528738</entry>
289
290 <entry>4528738</entry>
291
292 <entry>100%</entry>
293 </row>
294 </tbody>
295 </tgroup>
296 </table><table>
297 <title>Results in termination mode</title>
298
299 <tgroup cols="4">
300 <tbody>
301 <row>
302 <entry align="center"><emphasis
303 role="bold">Bytes</emphasis></entry>
304
305 <entry align="center"><emphasis role="bold">pktgen pps
306 TX</emphasis></entry>
307
308 <entry align="center"><emphasis role="bold">testpmd pps
309 RX</emphasis></entry>
310
311 <entry align="center"><emphasis role="bold">throughput
312 (%)</emphasis></entry>
313 </row>
314
315 <row>
316 <entry role="bold"><emphasis
317 role="bold">64</emphasis></entry>
318
319 <entry>14877775</entry>
320
321 <entry>8060974</entry>
322
323 <entry>54,1%</entry>
324 </row>
325
326 <row>
327 <entry><emphasis role="bold">128</emphasis></entry>
328
329 <entry>8441403</entry>
330
331 <entry>8023555</entry>
332
333 <entry>95,0%</entry>
334 </row>
335
336 <row>
337 <entry role="bold"><emphasis
338 role="bold">256</emphasis></entry>
339
340 <entry>4528864</entry>
341
342 <entry>4528840</entry>
343
344 <entry>99,9%</entry>
345 </row>
346 </tbody>
347 </tgroup>
348 </table></para>
349 </section>
350 </section>
351
352 <section id="usecase-three-four">
353 <title>Forward traffic from Docker to another Docker on the same
354 host</title>
355
356 <para>Benchmark a combo test using testpmd running in two Docker
357 instances, one which Forwards traffic to the second one, which
358 Terminates it.</para>
359
360 <para>Packets are generated with pktgen and TX-d to the first testpmd,
361 which will RX and Forward them to the second testpmd, which will RX
362 and terminate them.</para>
363
364 <para>Measurements are made in:</para>
365
366 <itemizedlist>
367 <listitem>
368 <para>pktgen TX in pps and Mbits/s</para>
369 </listitem>
370
371 <listitem>
372 <para>testpmd TX and RX pps in Docker1</para>
373 </listitem>
374
375 <listitem>
376 <para>testpmd RX pps in Docker2</para>
377 </listitem>
378 </itemizedlist>
379
380 <para>Throughput found as a percent, by dividing Docker2 <emphasis
381 role="bold">testpmd RX pps</emphasis> by <emphasis role="bold">pktgen
382 TX pps</emphasis>.</para>
383
384 <section id="target-one-usecase-three">
385 <title>Test Setup for Target 1</title>
386
387 <para>Start by following the steps below:</para>
388
389 <para>SSD boot using the following <literal>grub.cfg</literal>
390 entry:</para>
391
392 <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
393isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
394clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
395processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
396intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
397hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>
398
399 <para>Configure DPDK:<programlisting>mkdir -p /mnt/huge
400mount -t hugetlbfs nodev /mnt/huge
401modprobe igb_uio
402dpdk-devbind --bind=igb_uio 0000:03:00.0</programlisting>Run
403 pktgen:<programlisting>cd /usr/share/apps/pktgen/
404./pktgen -c 0xF -n 1 -- -P -m "[3:2].0"</programlisting>Choose one of the
405 values from [64, 128, 256, 512] to change the packet
406 size:<programlisting>set 0 size &lt;number&gt;</programlisting></para>
407 </section>
408
409 <section id="target-two-usecase-four">
410 <title>Test Setup for Target 2</title>
411
412 <para>Start by following the steps below:</para>
413
414 <para>SSD boot using the following <literal>grub.cfg</literal>
415 entry:</para>
416
417 <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
418isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
419clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
420processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 /
421iommu=pt intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
422hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>
423
424 <para><programlisting>killall ovsdb-server ovs-vswitchd
425rm -rf /etc/openvswitch/*
426mkdir -p /var/run/openvswitch</programlisting>Configure DPDK:<programlisting>mkdir -p /mnt/huge
427mount -t hugetlbfs nodev /mnt/huge
428modprobe igb_uio
429dpdk-devbind --bind=igb_uio 0000:03:00.0</programlisting>Configure the OVS
430 bridge:<programlisting>export DB_SOCK=/var/run/openvswitch/db.sock
431ovsdb-tool create /etc/openvswitch/conf.db /
432/usr/share/openvswitch/vswitch.ovsschema
433ovsdb-server --remote=punix:$DB_SOCK /
434--remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
435ovs-vsctl --no-wait init
436ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
437ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xcc
438ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
439ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
440ovs-vswitchd unix:$DB_SOCK --pidfile --detach /
441--log-file=/var/log/openvswitch/ovs-vswitchd.log
442ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
443ovs-vsctl add-port ovsbr0 vhost-user1 -- set Interface /
444vhost-user1 type=dpdkvhostuser ofport_request=1
445ovs-vsctl add-port ovsbr0 vhost-user2 -- set Interface /
446vhost-user2 type=dpdkvhostuser ofport_request=2
447ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 /
448type=dpdk options:dpdk-devargs=0000:03:00.0 ofport_request=3
449ovs-ofctl del-flows ovsbr0
450ovs-ofctl add-flow ovsbr0 in_port=3,action=output:2
451ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Import a
452 Docker container:<programlisting>docker import enea-nfv-access-guest-qemux86-64.tar.gz el7_guest</programlisting>Start
453 the first Docker:<programlisting>docker run -it --rm --cpuset-cpus=4,5 /
454-v /var/run/openvswitch/:/var/run/openvswitch/ /
455-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>Start the testpmd
456 application in Docker1:<programlisting>testpmd -c 0x30 -n 2 --file-prefix prog1 --socket-mem 512 --no-pci /
457--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user1 /
458/usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 /
459--disable-rss -i --portmask=0x1 --coremask=0x20 --nb-cores=1 /
460--rxq=1 --txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>Configure
461 it in termination mode:<programlisting>set fwd rxonly</programlisting>Run
462 the testpmd application:<programlisting>start</programlisting>Open a
463 new console to the host and start the second Docker
464 instance:<programlisting>docker run -it --rm --cpuset-cpus=0,1 -v /var/run/openvswitch/:/var/run/openvswitch/ /
465-v /mnt/huge:/mnt/huge el7_guest /bin/bash</programlisting>In the second
466 container start testpmd:<programlisting>testpmd -c 0x0F --file-prefix prog2 --socket-mem 512 --no-pci /
467--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 /
468/usr/lib/librte_pmd_virtio.so.1.1 -- -i</programlisting>Run the TestPmd
469 application in the second Docker:<programlisting>testpmd -c 0x3 -n 2 --file-prefix prog2 --socket-mem 512 --no-pci /
470--vdev=virtio_user0,path=/var/run/openvswitch/vhost-user2 /
471/usr/lib/librte_pmd_virtio.so.1.1 -- --burst 64 /
472--disable-rss -i --portmask=0x1 --coremask=0x2 --nb-cores=1 --rxq=1 /
473--txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>In the
474 testpmd shell, run:<programlisting>start</programlisting>Start
475 pktgen traffic by running the following command in pktgen
476 CLI:<programlisting>start 0</programlisting>To record traffic
477 results:<programlisting>show port stats 0</programlisting>This
478 should be used in testpmd applications.</para>
479
480 <table>
481 <title>Results</title>
482
483 <tgroup cols="5">
484 <tbody>
485 <row>
486 <entry align="center"><emphasis
487 role="bold">Bytes</emphasis></entry>
488
489 <entry align="center"><emphasis role="bold">Target 1 -
490 pktgen pps TX</emphasis></entry>
491
492 <entry align="center"><emphasis role="bold">Target 2 -
493 (forwarding) testpmd pps RX</emphasis></entry>
494
495 <entry align="center"><emphasis role="bold">Target 2 -
496 (forwarding) testpmd pps TX</emphasis></entry>
497
498 <entry align="center"><emphasis role="bold">Target 2 -
499 (termination) testpmd pps RX</emphasis></entry>
500 </row>
501
502 <row>
503 <entry role="bold"><emphasis
504 role="bold">64</emphasis></entry>
505
506 <entry>14877713</entry>
507
508 <entry>5031270</entry>
509
510 <entry>5031214</entry>
511
512 <entry>5031346</entry>
513 </row>
514
515 <row>
516 <entry><emphasis role="bold">128</emphasis></entry>
517
518 <entry>8441271</entry>
519
520 <entry>4670165</entry>
521
522 <entry>4670165</entry>
523
524 <entry>4670261</entry>
525 </row>
526
527 <row>
528 <entry role="bold"><emphasis
529 role="bold">256</emphasis></entry>
530
531 <entry>4528844</entry>
532
533 <entry>4490268</entry>
534
535 <entry>4490268</entry>
536
537 <entry>4490234</entry>
538 </row>
539
540 <row>
541 <entry><emphasis role="bold">512</emphasis></entry>
542
543 <entry>2349458</entry>
544
545 <entry>2349553</entry>
546
547 <entry>2349553</entry>
548
549 <entry>2349545</entry>
550 </row>
551 </tbody>
552 </tgroup>
553 </table>
554 </section>
555 </section>
556
557 <section id="pxe-config-docker">
558 <title>SR-IOV in in Docker</title>
559
560 <para>PCI passthrough tests using pktgen and testpmd in Docker.</para>
561
562 <para>pktgen[DPDK]Docker - PHY - Docker[DPDK] testpmd</para>
563
564 <para>Measurements:</para>
565
566 <itemizedlist>
567 <listitem>
568 <para>RX packets per second in testpmd (with testpmd configured in
569 rxonly mode).</para>
570 </listitem>
571 </itemizedlist>
572
573 <section id="target-setup">
574 <title>Test Setup</title>
575
576 <para>Boot Enea NFV Access from SSD:<programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
577isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable clocksource=tsc /
578tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 processor.max_cstate=0 /
579mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt intel_iommu=on hugepagesz=1GB /
580hugepages=8 default_hugepagesz=1GB hugepagesz=2M hugepages=2048 /
581vfio_iommu_type1.allow_unsafe_interrupts=1l</programlisting>Allow unsafe
582 interrupts:<programlisting>echo 1 &gt; /sys/module/vfio_iommu_type1/parameters/allow_unsafe_interrupts</programlisting>Configure
583 DPDK:<programlisting>mkdir -p /mnt/huge
584mount -t hugetlbfs nodev /mnt/huge
585dpdk-devbind.py --bind=ixgbe 0000:03:00.0
586ifconfig eno3 192.168.1.2
587echo 2 &gt; /sys/class/net/eno3/device/sriov_numvfs
588modprobe vfio-pci
589dpdk-devbind.py --bind=vfio-pci 0000:03:10.0
590dpdk-devbind.py --bind=vfio-pci 0000:03:10.2</programlisting>Start two docker
591 containers:<programlisting>docker run --privileged -it --rm -v /mnt/huge:/mnt/huge/ /
592--device /dev/vfio/vfio el7_guest /bin/bash
593docker run --privileged -it --rm -v /mnt/huge:/mnt/huge/ /
594--device /dev/vfio/vfio el7_guest /bin/bash</programlisting>In the first
595 container start pktgen:<programlisting>cd /usr/share/apps/pktgen/
596./pktgen -c 0x1f -w 0000:03:10.0 -n 1 --file-prefix pg1 /
597--socket-mem 1024 -- -P -m "[3:4].0"</programlisting>In the pktgen prompt set
598 the destination MAC address:<programlisting>set mac 0 XX:XX:XX:XX:XX:XX
599str</programlisting>In the second container start testpmd:<programlisting>testpmd -c 0x7 -n 1 -w 0000:03:10.2 -- -i --portmask=0x1 /
600--txd=256 --rxd=256 --port-topology=chained</programlisting>In the testpmd
601 prompt set <emphasis role="bold">forwarding</emphasis>
602 rxonly:<programlisting>set fwd rxonly
603start</programlisting><table>
604 <title>Results</title>
605
606 <tgroup cols="5">
607 <tbody>
608 <row>
609 <entry align="center"><emphasis
610 role="bold">Bytes</emphasis></entry>
611
612 <entry align="center"><emphasis role="bold">pktgen pps
613 TX</emphasis></entry>
614
615 <entry align="center"><emphasis role="bold">testpmd pps
616 RX</emphasis></entry>
617
618 <entry align="center"><emphasis role="bold">pktgen MBits/s
619 TX</emphasis></entry>
620
621 <entry align="center"><emphasis role="bold">throughput
622 (%)</emphasis></entry>
623 </row>
624
625 <row>
626 <entry role="bold"><emphasis
627 role="bold">64</emphasis></entry>
628
629 <entry>14204211</entry>
630
631 <entry>14204561</entry>
632
633 <entry>9545</entry>
634
635 <entry>100</entry>
636 </row>
637
638 <row>
639 <entry><emphasis role="bold">128</emphasis></entry>
640
641 <entry>8440340</entry>
642
643 <entry>8440201</entry>
644
645 <entry>9993</entry>
646
647 <entry>99.9</entry>
648 </row>
649
650 <row>
651 <entry role="bold"><emphasis
652 role="bold">256</emphasis></entry>
653
654 <entry>4533828</entry>
655
656 <entry>4533891</entry>
657
658 <entry>10010</entry>
659
660 <entry>100</entry>
661 </row>
662
663 <row>
664 <entry><emphasis role="bold">512</emphasis></entry>
665
666 <entry>2349886</entry>
667
668 <entry>2349715</entry>
669
670 <entry>10000</entry>
671
672 <entry>99.9</entry>
673 </row>
674 </tbody>
675 </tgroup>
676 </table></para>
677 </section>
678 </section>
679 </section>
680
681 <section id="vm-benchmarks">
682 <title>VM related benchmarks</title>
683
684 <section id="usecase-four">
685 <title>Forward/termination traffic in one VM</title>
686
687 <para>Benchmarking traffic (UDP) forwarding and termination using
688 testpmd in a virtual machine.</para>
689
690 <para>The Pktgen application is used to generate traffic that will
691 reach testpmd running on a virtual machine, and be forwarded back to
692 source on the return trip. With the same setup a second measurement
693 will be done with traffic termination in the virtual machine.</para>
694
695 <para>This test case measures:</para>
696
697 <itemizedlist>
698 <listitem>
699 <para>pktgen TX, RX in packets per second (pps) and Mbps</para>
700 </listitem>
701
702 <listitem>
703 <para>testpmd TX, RX in packets per second (pps)</para>
704 </listitem>
705
706 <listitem>
707 <para>divide <emphasis role="bold">testpmd RX</emphasis> by
708 <emphasis role="bold">pktgen TX</emphasis> in pps to obtain the
709 throughput in percentages (%)</para>
710 </listitem>
711 </itemizedlist>
712
713 <section id="targetone-usecasefour">
714 <title>Test Setup for Target 1</title>
715
716 <para>Start with the steps below:</para>
717
718 <para>SSD boot using the following <literal>grub.cfg
719 </literal>entry: <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
720isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
721clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
722processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
723intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
724hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting></para>
725
726 <para>Kill unnecessary services: <programlisting>killall ovsdb-server ovs-vswitchd
727rm -rf /etc/openvswitch/*
728mkdir -p /var/run/openvswitch</programlisting>Configure DPDK:<programlisting>mkdir -p /mnt/huge
729mount -t hugetlbfs nodev /mnt/huge
730modprobe igb_uio
731dpdk-devbind --bind=igb_uio 0000:03:00.0</programlisting>Run
732 pktgen:<programlisting>cd /usr/share/apps/pktgen/
733./pktgen -c 0x7 -n 4 --proc-type auto --socket-mem 256 /
734-w 0000:03:00.0 -- -P -m "[1:2].0"</programlisting>Set pktgen frame size to
735 use from [64, 128, 256, 512]:<programlisting>set 0 size 64</programlisting></para>
736 </section>
737
738 <section id="targettwo-usecasefive">
739 <title>Test Setup for Target 2</title>
740
741 <para>Start by following the steps below:</para>
742
743 <para>SSD boot using the following <literal>grub.cfg</literal>
744 entry: <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
745isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
746clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
747processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
748intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
749hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>Kill
750 unnecessary services: <programlisting>killall ovsdb-server ovs-vswitchd
751rm -rf /etc/openvswitch/*
752mkdir -p /var/run/openvswitch</programlisting>Configure DPDK:<programlisting>mkdir -p /mnt/huge
753mount -t hugetlbfs nodev /mnt/huge
754modprobe igb_uio
755dpdk-devbind --bind=igb_uio 0000:03:00.0</programlisting>Configure
756 OVS:<programlisting>export DB_SOCK=/var/run/openvswitch/db.sock
757ovsdb-tool create /etc/openvswitch/conf.db /
758/usr/share/openvswitch/vswitch.ovsschema
759ovsdb-server --remote=punix:$DB_SOCK /
760--remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
761ovs-vsctl --no-wait init
762ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
763ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
764ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
765ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
766ovs-vswitchd unix:$DB_SOCK --pidfile --detach /
767--log-file=/var/log/openvswitch/ovs-vswitchd.log
768
769ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
770ovs-vsctl add-port ovsbr0 vhost-user1 /
771-- set Interface vhost-user1 type=dpdkvhostuser -- set Interface /
772vhost-user1 ofport_request=2
773ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 /
774type=dpdk options:dpdk-devargs=0000:03:00.0 /
775-- set Interface dpdk0 ofport_request=1
776chmod 777 /var/run/openvswitch/vhost-user1
777
778ovs-ofctl del-flows ovsbr0
779ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
780ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>Launch
781 QEMU:<programlisting>taskset -c 0,1 qemu-system-x86_64 -cpu host,+invtsc,migratable=no /
782-M q35 -smp cores=2,sockets=1 -vcpu 0,affinity=0 -vcpu 1,affinity=1 /
783-enable-kvm -nographic -realtime mlock=on -kernel /mnt/qemu/bzImage /
784-drive file=/mnt/qemu/enea-nfv-access-guest-qemux86-64.ext4,/
785if=virtio,format=raw -m 4096 -object memory-backend-file,id=mem,/
786size=4096M,mem-path=/mnt/huge,share=on -numa node,memdev=mem /
787-mem-prealloc -chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1 /
788-netdev type=vhost-user,id=mynet1,chardev=char0,vhostforce /
789-device virtio-net-pci,mac=52:54:00:00:00:01,netdev=mynet1,/
790mrg_rxbuf=on,rx_queue_size=1024,csum=off,gso=off,guest_tso4=off,/
791guest_tso6=off,guest_ecn=off -append 'root=/dev/vda console=ttyS0 /
792hugepagesz=2M hugepages=1024 isolcpus=1 nohz_full=1 rcu_nocbs=1 /
793irqaffinity=0 rcu_nocb_poll intel_pstate=disable intel_idle.max_cstate=0 /
794processor.max_cstate=0 mce=ignore_ce audit=0'</programlisting>Inside QEMU,
795 configure DPDK: <programlisting>mkdir -p /mnt/huge
796mount -t hugetlbfs nodev /mnt/huge
797modprobe igb_uio
798dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Inside QEMU, run
799 testpmd: <programlisting>testpmd -c 0x3 -n 2 librte_pmd_virtio.so.1.1 /
800-- --burst 64 --disable-rss -i --portmask=0x1 /
801--coremask=0x2 --nb-cores=1 --rxq=1 --txq=1 --txd=512 --rxd=512 /
802--port-topology=chained</programlisting>For the <emphasis
803 role="bold">Forwarding test</emphasis>, start testpmd
804 directly:<programlisting>start</programlisting>For the <emphasis
805 role="bold">Termination test</emphasis>, set testpmd to only
806 receive, then start it:<programlisting>set fwd rxonly
807start</programlisting>On target 1, you may start pktgen traffic
808 now:<programlisting>start 0</programlisting>On target 2, use this
809 command to refresh the testpmd display and note the highest
810 values:<programlisting>show port stats 0</programlisting>To stop
811 traffic from pktgen, in order to choose a different frame
812 size:<programlisting>stop 0</programlisting>To clear numbers in
813 testpmd:<programlisting>clear port stats
814show port stats 0</programlisting><table>
815 <title>Results in forwarding mode</title>
816
817 <tgroup cols="8">
818 <tbody>
819 <row>
820 <entry align="center"><emphasis
821 role="bold">Bytes</emphasis></entry>
822
823 <entry align="center"><emphasis role="bold">pktgen pps
824 RX</emphasis></entry>
825
826 <entry align="center"><emphasis role="bold">pktgen pps
827 TX</emphasis></entry>
828
829 <entry align="center"><emphasis role="bold">testpmd pps
830 RX</emphasis></entry>
831
832 <entry align="center"><emphasis role="bold">testpmd pps
833 TX</emphasis></entry>
834
835 <entry align="center"><emphasis role="bold">pktgen MBits/s
836 RX</emphasis></entry>
837
838 <entry align="center"><emphasis role="bold">pktgen MBits/s
839 TX</emphasis></entry>
840
841 <entry align="center"><emphasis role="bold">throughput
842 (%)</emphasis></entry>
843 </row>
844
845 <row>
846 <entry role="bold"><emphasis
847 role="bold">64</emphasis></entry>
848
849 <entry>7926325</entry>
850
851 <entry>14877576</entry>
852
853 <entry>7926515</entry>
854
855 <entry>7926515</entry>
856
857 <entry>5326</entry>
858
859 <entry>9997</entry>
860
861 <entry>53.2</entry>
862 </row>
863
864 <row>
865 <entry><emphasis role="bold">128</emphasis></entry>
866
867 <entry>7502802</entry>
868
869 <entry>8441253</entry>
870
871 <entry>7785983</entry>
872
873 <entry>7494959</entry>
874
875 <entry>8883</entry>
876
877 <entry>9994</entry>
878
879 <entry>88.8</entry>
880 </row>
881
882 <row>
883 <entry role="bold"><emphasis
884 role="bold">256</emphasis></entry>
885
886 <entry>4528631</entry>
887
888 <entry>4528782</entry>
889
890 <entry>4529515</entry>
891
892 <entry>4529515</entry>
893
894 <entry>9999</entry>
895
896 <entry>9999</entry>
897
898 <entry>99.9</entry>
899 </row>
900 </tbody>
901 </tgroup>
902 </table><table>
903 <title>Results in termination mode</title>
904
905 <tgroup cols="5">
906 <tbody>
907 <row>
908 <entry align="center"><emphasis
909 role="bold">Bytes</emphasis></entry>
910
911 <entry align="center"><emphasis role="bold">pktgen pps
912 TX</emphasis></entry>
913
914 <entry align="center"><emphasis role="bold">testpmd pps
915 RX</emphasis></entry>
916
917 <entry align="center"><emphasis role="bold">pktgen MBits/s
918 TX</emphasis></entry>
919
920 <entry align="center"><emphasis role="bold">throughput
921 (%)</emphasis></entry>
922 </row>
923
924 <row>
925 <entry role="bold"><emphasis
926 role="bold">64</emphasis></entry>
927
928 <entry>14877764</entry>
929
930 <entry>8090855</entry>
931
932 <entry>9997</entry>
933
934 <entry>54.3</entry>
935 </row>
936
937 <row>
938 <entry><emphasis role="bold">128</emphasis></entry>
939
940 <entry>8441309</entry>
941
942 <entry>8082971</entry>
943
944 <entry>9994</entry>
945
946 <entry>95.7</entry>
947 </row>
948
949 <row>
950 <entry role="bold"><emphasis
951 role="bold">256</emphasis></entry>
952
953 <entry>4528867</entry>
954
955 <entry>4528780</entry>
956
957 <entry>9999</entry>
958
959 <entry>99.9</entry>
960 </row>
961 </tbody>
962 </tgroup>
963 </table></para>
964 </section>
965 </section>
966
967 <section id="usecase-six">
968 <title>Forward traffic between two VMs</title>
969
970 <para>Benchmark a combo test using two virtual machines, the first
971 with traffic forwarding to the second, which terminates it.</para>
972
973 <para>Measurements are made in:</para>
974
975 <itemizedlist>
976 <listitem>
977 <para>pktgen TX in pps and Mbits/s</para>
978 </listitem>
979
980 <listitem>
981 <para>testpmd TX and RX pps in VM1</para>
982 </listitem>
983
984 <listitem>
985 <para>testpmd RX pps in VM2</para>
986 </listitem>
987
988 <listitem>
989 <para>throughput in percents, by dividing<emphasis role="bold">
990 VM2 testpmd RX pps</emphasis> by <emphasis role="bold">pktgen TX
991 pps</emphasis></para>
992 </listitem>
993 </itemizedlist>
994
995 <section id="targetone-usecase-five">
996 <title>Test Setup for Target 1</title>
997
998 <para>Start by doing the following:</para>
999
1000 <para>SSD boot using the following <literal>grub.cfg</literal>
1001 entry: <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
1002isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
1003clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
1004processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
1005intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
1006hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>Kill
1007 Services:<programlisting>killall ovsdb-server ovs-vswitchd
1008rm -rf /etc/openvswitch/*
1009mkdir -p /var/run/openvswitch</programlisting>Configure DPDK:<programlisting>mkdir -p /mnt/huge
1010mount -t hugetlbfs nodev /mnt/huge
1011modprobe igb_uio
1012dpdk-devbind --bind=igb_uio 0000:03:00.0</programlisting>Run
1013 pktgen:<programlisting>cd /usr/share/apps/pktgen/
1014./pktgen -c 0x7 -n 4 --proc-type auto --socket-mem 256 /
1015-w 0000:03:00.0 -- -P -m "[1:2].0"</programlisting>Set pktgen frame size to
1016 use from [64, 128, 256, 512]:<programlisting>set 0 size 64</programlisting></para>
1017 </section>
1018
1019 <section id="targettwo-usecase-six">
1020 <title>Test Setup for Target 2</title>
1021
1022 <para>Start by doing the following:</para>
1023
1024 <para>SSD boot using the following <literal>grub.cfg</literal>
1025 entry: <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
1026isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
1027clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
1028processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
1029intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
1030hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>Kill
1031 Services:<programlisting>killall ovsdb-server ovs-vswitchd
1032rm -rf /etc/openvswitch/*
1033mkdir -p /var/run/openvswitch</programlisting>Configure DPDK:<programlisting>mkdir -p /mnt/huge
1034mount -t hugetlbfs nodev /mnt/huge
1035modprobe igb_uio
1036dpdk-devbind --bind=igb_uio 0000:03:00.0</programlisting>Configure
1037 OVS:<programlisting>export DB_SOCK=/var/run/openvswitch/db.sock
1038ovsdb-tool create /etc/openvswitch/conf.db /
1039/usr/share/openvswitch/vswitch.ovsschema
1040ovsdb-server --remote=punix:$DB_SOCK /
1041--remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach
1042ovs-vsctl --no-wait init
1043ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x10
1044ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
1045ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-socket-mem=2048
1046ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
1047ovs-vswitchd unix:$DB_SOCK --pidfile /
1048--detach --log-file=/var/log/openvswitch/ovs-vswitchd.log
1049
1050
1051ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
1052ovs-vsctl add-port ovsbr0 dpdk0 /
1053-- set Interface dpdk0 type=dpdk options:dpdk-devargs=0000:03:00.0 ofport_request=1
1054ovs-vsctl add-port ovsbr0 vhost-user1 /
1055-- set Interface vhost-user1 type=dpdkvhostuser ofport_request=2
1056ovs-vsctl add-port ovsbr0 vhost-user2 /
1057-- set Interface vhost-user2 type=dpdkvhostuser ofport_request=3
1058
1059
1060ovs-ofctl del-flows ovsbr0
1061ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
1062ovs-ofctl add-flow ovsbr0 in_port=2,action=output:3</programlisting>Launch
1063 first QEMU instance, VM1:<programlisting>taskset -c 0,1 qemu-system-x86_64 -cpu host,+invtsc,migratable=no -M q35 /
1064-smp cores=2,sockets=1 -vcpu 0,affinity=0 -vcpu 1,affinity=1 -enable-kvm /
1065-nographic -realtime mlock=on -kernel /home/root/qemu/bzImage /
1066-drive file=/home/root/qemu/enea-nfv-access-guest-qemux86-64.ext4,/
1067if=virtio,format=raw -m 2048 -object memory-backend-file,id=mem,/
1068size=2048M,mem-path=/mnt/huge,share=on -numa node,memdev=mem /
1069-mem-prealloc -chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1 /
1070-netdev type=vhost-user,id=mynet1,chardev=char0,vhostforce /
1071-device virtio-net-pci,mac=52:54:00:00:00:01,netdev=mynet1,/
1072mrg_rxbuf=on,rx_queue_size=1024,csum=off,gso=off,guest_tso4=off,/
1073guest_tso6=off,guest_ecn=off -append 'root=/dev/vda console=ttyS0 /
1074hugepagesz=2M hugepages=512 isolcpus=1 nohz_full=1 rcu_nocbs=1 /
1075irqaffinity=0 rcu_nocb_poll intel_pstate=disable intel_idle.max_cstate=0 /
1076processor.max_cstate=0 mce=ignore_ce audit=0'</programlisting>Connect to
1077 Target 2 through a new SSH session and run a second QEMU instance
1078 (to get its own console, separate from instance VM1). We shall call
1079 this VM2:<programlisting>taskset -c 4,5 qemu-system-x86_64 -cpu host,+invtsc,migratable=no /
1080-M q35 -smp cores=2,sockets=1 -vcpu 0,affinity=4 -vcpu 1,affinity=5 /
1081-enable-kvm -nographic -realtime mlock=on -kernel /home/root/qemu2/bzImage /
1082-drive file=/home/root/qemu2/enea-nfv-access-guest-qemux86-64.ext4,/
1083if=virtio,format=raw -m 2048 -object memory-backend-file,id=mem,size=2048M,/
1084mem-path=/mnt/huge,share=on -numa node,memdev=mem -mem-prealloc /
1085-chardev socket,id=char1,path=/var/run/openvswitch/vhost-user2 /
1086-netdev type=vhost-user,id=mynet1,chardev=char1,vhostforce /
1087-device virtio-net-pci,mac=52:54:00:00:00:02,netdev=mynet1,/
1088mrg_rxbuf=on,rx_queue_size=1024,csum=off,gso=off,guest_tso4=off,/
1089guest_tso6=off,guest_ecn=off -append 'root=/dev/vda console=ttyS0 /
1090hugepagesz=2M hugepages=512 isolcpus=1 nohz_full=1 rcu_nocbs=1 /
1091irqaffinity=0 rcu_nocb_poll intel_pstate=disable intel_idle.max_cstate=0 /
1092processor.max_cstate=0 mce=ignore_ce audit=0'</programlisting>Configure DPDK
1093 inside VM1:<programlisting>mkdir -p /mnt/huge
1094mount -t hugetlbfs nodev /mnt/huge
1095modprobe igb_uio
1096dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Run testpmd inside
1097 VM1:<programlisting>testpmd -c 0x3 -n 2 librte_pmd_virtio.so.1.1 /
1098-- --burst 64 --disable-rss -i /
1099--portmask=0x1 --coremask=0x2 --nb-cores=1 --rxq=1 /
1100--txq=1 --txd=512 --rxd=512 --port-topology=chained</programlisting>Start
1101 testpmd inside VM1:<programlisting>start</programlisting>Configure
1102 DPDK inside VM2:<programlisting>mkdir -p /mnt/huge
1103mount -t hugetlbfs nodev /mnt/huge
1104modprobe igb_uio
1105dpdk-devbind --bind=igb_uio 0000:00:02.0</programlisting>Run testpmd inside
1106 VM2:<programlisting>testpmd -c 0x3 -n 2 librte_pmd_virtio.so.1.1 /
1107-- --burst 64 --disable-rss -i --portmask=0x1 /
1108--coremask=0x2 --nb-cores=1 --rxq=1 --txq=1 --txd=512 /
1109--rxd=512 --port-topology=chained</programlisting>Set VM2 for termination and
1110 start testpmd:<programlisting>set fwd rxonly
1111start</programlisting>On target 1, start pktgen traffic:<programlisting>start 0</programlisting>Use
1112 this command to refresh testpmd display in VM1 and VM2 and note the
1113 highest values:<programlisting>show port stats 0</programlisting>To
1114 stop traffic from pktgen, in order to choose a different frame
1115 size:<programlisting>stop 0</programlisting>To clear numbers in
1116 testpmd:<programlisting>clear port stats
1117show port stats 0</programlisting>For VM1, we record the stats relevant for
1118 <emphasis role="bold">forwarding</emphasis>:</para>
1119
1120 <itemizedlist>
1121 <listitem>
1122 <para>RX, TX in pps</para>
1123 </listitem>
1124 </itemizedlist>
1125
1126 <para>Only Rx-pps and Tx-pps numbers are important here, they change
1127 every time stats are displayed as long as there is traffic. Run the
1128 command a few times and pick the best (maximum) values seen.</para>
1129
1130 <para>For VM2, we record the stats relevant for <emphasis
1131 role="bold">termination</emphasis>:</para>
1132
1133 <itemizedlist>
1134 <listitem>
1135 <para>RX in pps (TX will be 0)</para>
1136 </listitem>
1137 </itemizedlist>
1138
1139 <para>For pktgen, we record only the TX side, because flow is
1140 terminated, with no RX traffic reaching pktgen:</para>
1141
1142 <itemizedlist>
1143 <listitem>
1144 <para>TX in pps and Mbit/s</para>
1145 </listitem>
1146 </itemizedlist>
1147
1148 <table>
1149 <title>Results in forwarding mode</title>
1150
1151 <tgroup cols="7">
1152 <tbody>
1153 <row>
1154 <entry align="center"><emphasis
1155 role="bold">Bytes</emphasis></entry>
1156
1157 <entry align="center"><emphasis role="bold">pktgen pps
1158 TX</emphasis></entry>
1159
1160 <entry align="center"><emphasis role="bold">VM1 testpmd pps
1161 RX</emphasis></entry>
1162
1163 <entry align="center"><emphasis role="bold">VM1 testpmd pps
1164 TX</emphasis></entry>
1165
1166 <entry align="center"><emphasis role="bold">VM2 testpmd pps
1167 RX</emphasis></entry>
1168
1169 <entry align="center"><emphasis role="bold">pktgen MBits/s
1170 TX</emphasis></entry>
1171
1172 <entry align="center"><emphasis role="bold">throughput
1173 (%)</emphasis></entry>
1174 </row>
1175
1176 <row>
1177 <entry role="bold"><emphasis
1178 role="bold">64</emphasis></entry>
1179
1180 <entry>14877757</entry>
1181
1182 <entry>7712835</entry>
1183
1184 <entry>6024320</entry>
1185
1186 <entry>6015525</entry>
1187
1188 <entry>9997</entry>
1189
1190 <entry>40.0</entry>
1191 </row>
1192
1193 <row>
1194 <entry><emphasis role="bold">128</emphasis></entry>
1195
1196 <entry>8441333</entry>
1197
1198 <entry>7257432</entry>
1199
1200 <entry>5717540</entry>
1201
1202 <entry>5716752</entry>
1203
1204 <entry>9994</entry>
1205
1206 <entry>67.7</entry>
1207 </row>
1208
1209 <row>
1210 <entry role="bold"><emphasis
1211 role="bold">256</emphasis></entry>
1212
1213 <entry>4528865</entry>
1214
1215 <entry>4528717</entry>
1216
1217 <entry>4528717</entry>
1218
1219 <entry>4528621</entry>
1220
1221 <entry>9999</entry>
1222
1223 <entry>99.9</entry>
1224 </row>
1225 </tbody>
1226 </tgroup>
1227 </table>
1228 </section>
1229 </section>
1230
1231 <section id="pxe-config-vm">
1232 <title>SR-IOV in Virtual Machines</title>
1233
1234 <para>PCI passthrough tests using pktgen and testpmd in virtual
1235 machines.</para>
1236
1237 <para>pktgen[DPDK]VM - PHY - VM[DPDK] testpmd.</para>
1238
1239 <para>Measurements:</para>
1240
1241 <itemizedlist>
1242 <listitem>
1243 <para>pktgen to testpmd in <emphasis
1244 role="bold">forwarding</emphasis> mode.</para>
1245 </listitem>
1246
1247 <listitem>
1248 <para>pktgen to testpmd in <emphasis
1249 role="bold">termination</emphasis> mode.</para>
1250 </listitem>
1251 </itemizedlist>
1252
1253 <section id="test-setup-target-four">
1254 <title>Test Setup</title>
1255
1256 <para>SSD boot using the following <literal>grub.cfg</literal>
1257 entry: <programlisting>linux (hd0,gpt3)/boot/bzImage root=/dev/sda3 ip=dhcp nohz_full=1-7 /
1258isolcpus=1-7 rcu-nocbs=1-7 rcu_nocb_poll intel_pstate=disable /
1259clocksource=tsc tsc=reliable nohpet nosoftlockup intel_idle.max_cstate=0 /
1260processor.max_cstate=0 mce=ignore_ce audit=0 nmi_watchdog=0 iommu=pt /
1261intel_iommu=on hugepagesz=1GB hugepages=8 default_hugepagesz=1GB /
1262hugepagesz=2M hugepages=2048 vfio_iommu_type1.allow_unsafe_interrupts=1</programlisting>Stop
1263 other services and mount hugepages: <programlisting>systemctl stop openvswitch
1264mkdir -p /mnt/huge
1265mount -t hugetlbfs hugetlbfs /mnt/huge</programlisting>Configure SR-IOV
1266 interfaces:<programlisting>/usr/share/usertools/dpdk-devbind.py --bind=ixgbe 0000:03:00.0
1267echo 2 &gt; /sys/class/net/eno3/device/sriov_numvfs
1268ifconfig eno3 10.0.0.1
1269modprobe vfio_pci
1270/usr/share/usertools/dpdk-devbind.py --bind=vfio-pci 0000:03:10.0
1271/usr/share/usertools/dpdk-devbind.py --bind=vfio-pci 0000:03:10.2
1272ip link set eno3 vf 0 mac 0c:c4:7a:E5:0F:48
1273ip link set eno3 vf 1 mac 0c:c4:7a:BF:52:E7</programlisting>Launch two QEMU
1274 instances: <programlisting>taskset -c 4,5 qemu-system-x86_64 -cpu host,+invtsc,migratable=no -M /
1275q35 -smp cores=2,sockets=1 -vcpu 0,affinity=4 -vcpu 1,affinity=5 -enable-kvm /
1276-nographic -kernel /mnt/qemu/bzImage /
1277-drive file=/mnt/qemu/enea-nfv-access-guest-qemux86-64.ext4,if=virtio,/
1278format=raw -m 4096 -object memory-backend-file,id=mem,size=4096M,mem-path=/mnt/huge,/
1279share=on -numa node,memdev=mem -mem-prealloc -device vfio-pci,host=03:10.0 /
1280-append 'root=/dev/vda console=ttyS0 hugepagesz=2M hugepages=1024 /
1281isolcpus=1 nohz_full=1 rcu_nocbs=1 irqaffinity=0 rcu_nocb_poll /
1282intel_pstate=disable intel_idle.max_cstate=0 /
1283processor.max_cstate=0 mce=ignore_ce audit=0'
1284
1285
1286taskset -c 2,3 qemu-system-x86_64 -cpu host,+invtsc,migratable=no -M /
1287q35 -smp cores=2,sockets=1 -vcpu 0,affinity=2 -vcpu 1,affinity=3 -enable-kvm /
1288-nographic -kernel /mnt/qemu/bzImage /
1289-drive file=/mnt/qemu/enea-nfv-access-guest-qemux86-64.ext4,if=virtio,/
1290format=raw -m 4096 -object memory-backend-file,id=mem,size=4096M,mem-path=/mnt/huge,/
1291share=on -numa node,memdev=mem -mem-prealloc -device vfio-pci,host=03:10.2 /
1292-append 'root=/dev/vda console=ttyS0 hugepagesz=2M hugepages=1024 /
1293isolcpus=1 nohz_full=1 rcu_nocbs=1 irqaffinity=0 rcu_nocb_poll /
1294intel_pstate=disable intel_idle.max_cstate=0 processor.max_cstate=0 /
1295mce=ignore_ce audit=0'</programlisting>In the first VM, mount hugepages and
1296 start pktgen:<programlisting>mkdir -p /mnt/huge &amp;&amp; \
1297mount -t hugetlbfs hugetlbfs /mnt/huge
1298modprobe igb_uio
1299/usr/share/usertools/dpdk-devbind.py --bind=igb_uio 0000:00:03.0
1300cd /usr/share/apps/pktgen
1301./pktgen -c 0x3 -- -P -m "1.0"</programlisting>In the pktgen console set the
1302 MAC of the destination and start generating
1303 packages:<programlisting>set mac 0 0C:C4:7A:BF:52:E7
1304str</programlisting>In the second VM, mount hugepages and start
1305 testpmd:<programlisting>mkdir -p /mnt/huge &amp;&amp; \
1306mount -t hugetlbfs hugetlbfs /mnt/huge
1307modprobe igb_uio
1308/usr/share/usertools/dpdk-devbind.py --bind=igb_uio 0000:00:03.0
1309testpmd -c 0x3 -n 2 -- -i --txd=512 --rxd=512 --port-topology=chained /
1310--eth-peer=0,0c:c4:7a:e5:0f:48</programlisting>In order to enable <emphasis
1311 role="bold">forwarding</emphasis> mode, in the testpmd console,
1312 run:<programlisting>set fwd mac
1313start</programlisting>In order to enable <emphasis
1314 role="bold">termination</emphasis> mode, in the testpmd console,
1315 run:<programlisting>set fwd rxonly
1316start</programlisting><table>
1317 <title>Results in forwarding mode</title>
1318
1319 <tgroup cols="5">
1320 <tbody>
1321 <row>
1322 <entry align="center"><emphasis
1323 role="bold">Bytes</emphasis></entry>
1324
1325 <entry align="center"><emphasis role="bold">VM1 pktgen pps
1326 TX</emphasis></entry>
1327
1328 <entry align="center"><emphasis role="bold">VM1 pktgen pps
1329 RX</emphasis></entry>
1330
1331 <entry align="center"><emphasis role="bold">VM2 testpmd
1332 pps RX</emphasis></entry>
1333
1334 <entry align="center"><emphasis role="bold">VM2 testpmd
1335 pps TX</emphasis></entry>
1336 </row>
1337
1338 <row>
1339 <entry role="bold"><emphasis
1340 role="bold">64</emphasis></entry>
1341
1342 <entry>7102096</entry>
1343
1344 <entry>7101897</entry>
1345
1346 <entry>7103853</entry>
1347
1348 <entry>7103793</entry>
1349 </row>
1350
1351 <row>
1352 <entry><emphasis role="bold">128</emphasis></entry>
1353
1354 <entry>5720016</entry>
1355
1356 <entry>5720256</entry>
1357
1358 <entry>5722081</entry>
1359
1360 <entry>5722083</entry>
1361 </row>
1362
1363 <row>
1364 <entry role="bold"><emphasis
1365 role="bold">256</emphasis></entry>
1366
1367 <entry>3456619</entry>
1368
1369 <entry>3456164</entry>
1370
1371 <entry>3456319</entry>
1372
1373 <entry>3456321</entry>
1374 </row>
1375
1376 <row>
1377 <entry role="bold"><emphasis
1378 role="bold">512</emphasis></entry>
1379
1380 <entry>1846671</entry>
1381
1382 <entry>1846628</entry>
1383
1384 <entry>1846652</entry>
1385
1386 <entry>1846657</entry>
1387 </row>
1388
1389 <row>
1390 <entry role="bold"><emphasis
1391 role="bold">1024</emphasis></entry>
1392
1393 <entry>940799</entry>
1394
1395 <entry>940748</entry>
1396
1397 <entry>940788</entry>
1398
1399 <entry>940788</entry>
1400 </row>
1401
1402 <row>
1403 <entry role="bold"><emphasis
1404 role="bold">1500</emphasis></entry>
1405
1406 <entry>649594</entry>
1407
1408 <entry>649526</entry>
1409
1410 <entry>649563</entry>
1411
1412 <entry>649563</entry>
1413 </row>
1414 </tbody>
1415 </tgroup>
1416 </table><table>
1417 <title>Results in termination mode</title>
1418
1419 <tgroup cols="3">
1420 <tbody>
1421 <row>
1422 <entry align="center"><emphasis
1423 role="bold">Bytes</emphasis></entry>
1424
1425 <entry align="center"><emphasis role="bold">VM1 pktgen pps
1426 TX</emphasis></entry>
1427
1428 <entry align="center"><emphasis role="bold">VM2 testpmd
1429 RX</emphasis></entry>
1430 </row>
1431
1432 <row>
1433 <entry role="bold"><emphasis
1434 role="bold">64</emphasis></entry>
1435
1436 <entry>14202904</entry>
1437
1438 <entry>14203944</entry>
1439 </row>
1440
1441 <row>
1442 <entry><emphasis role="bold">128</emphasis></entry>
1443
1444 <entry>8434766</entry>
1445
1446 <entry>8437525</entry>
1447 </row>
1448
1449 <row>
1450 <entry role="bold"><emphasis
1451 role="bold">256</emphasis></entry>
1452
1453 <entry>4532131</entry>
1454
1455 <entry>4532348</entry>
1456 </row>
1457
1458 <row>
1459 <entry><emphasis role="bold">512</emphasis></entry>
1460
1461 <entry>2349344</entry>
1462
1463 <entry>2349032</entry>
1464 </row>
1465
1466 <row>
1467 <entry><emphasis role="bold">1024</emphasis></entry>
1468
1469 <entry>1197293</entry>
1470
1471 <entry>1196699</entry>
1472 </row>
1473
1474 <row>
1475 <entry><emphasis role="bold">1500</emphasis></entry>
1476
1477 <entry>822321</entry>
1478
1479 <entry>822276</entry>
1480 </row>
1481 </tbody>
1482 </tgroup>
1483 </table></para>
1484 </section>
1485 </section>
1486 </section>
1487 </section>
1488</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/book.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/book.xml
deleted file mode 100644
index cec06b6..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/book.xml
+++ /dev/null
@@ -1,30 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
5]>
6<book id="book_enea_nfv_access_reference_guide_intel">
7 <title><trademark class="registered">Enea</trademark> NFV Access Reference Guide</title>
8 <subtitle>Release Version
9 <xi:include href="eltf_params_updated.xml" xpointer="element(EneaLinux_REL_VER/1)"
10 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle>
11 <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb -->
12 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml"
13 xmlns:xi="http://www.w3.org/2001/XInclude" />
14 <xi:include href="overview.xml"
15 xmlns:xi="http://www.w3.org/2001/XInclude" />
16 <xi:include href="dpdk.xml"
17 xmlns:xi="http://www.w3.org/2001/XInclude" />
18 <xi:include href="ovs.xml"
19 xmlns:xi="http://www.w3.org/2001/XInclude" />
20 <xi:include href="hypervisor_virtualization.xml"
21 xmlns:xi="http://www.w3.org/2001/XInclude" />
22 <xi:include href="container_virtualization.xml"
23 xmlns:xi="http://www.w3.org/2001/XInclude" />
24 <xi:include href="ostree.xml"
25 xmlns:xi="http://www.w3.org/2001/XInclude" />
26 <xi:include href="benchmarks.xml"
27 xmlns:xi="http://www.w3.org/2001/XInclude" />
28 <!-- <xi:include href="using_nfv_access_sdks.xml"
29 xmlns:xi="http://www.w3.org/2001/XInclude" />-->
30</book>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/container_virtualization.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/container_virtualization.xml
deleted file mode 100644
index 06bfbb4..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/container_virtualization.xml
+++ /dev/null
@@ -1,137 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="container-virtualization">
5 <title>Container Virtualization</title>
6
7 <section id="docker">
8 <title>Docker</title>
9
10 <para>Docker is an open-source project that automates the deployment of
11 applications inside software containers, by providing an additional layer
12 of abstraction and automation of operating-system-level virtualization on
13 Linux.</para>
14
15 <para>The software container mechanism uses resource isolation features
16 inside the Linux kernel, such as cgroups and kernel namespaces to allow
17 multiple containers to run within a single Linux instance, avoiding the
18 overhead of starting and maintaining virtual machines.</para>
19
20 <para>Containers are lightweight and include everything needed to run
21 themselves: code, runtime, system tools, system libraries and settings.
22 The main advantage provided by containers is that the encapsulated
23 software is isolated from its surroundings. For example, differences
24 between development and staging environments can be kept separate in order
25 to reduce conflicts between teams running different software on the same
26 infrastructure.</para>
27
28 <para>For a better understanding of what Docker is and how it works, the
29 official documentation provided on the Docker website should be consulted:
30 <ulink
31 url="https://docs.docker.com/">https://docs.docker.com/</ulink>.</para>
32
33 <section id="launch-docker-container">
34 <title>Launching a Docker container</title>
35
36 <para>Docker provides a hello-world container which checks whether your
37 system is running the daemon correctly. This container can be launched
38 by simply running:</para>
39
40 <programlisting>docker run hello-world</programlisting>
41
42 <para>If your installation is working correctly, the following message
43 should be outputted:<programlisting>Hello from Docker!</programlisting></para>
44 </section>
45
46 <section id="run-enfv-guest-image">
47 <title>Run a guest image inside Docker</title>
48
49 <para>Guest images can be run inside Docker as in any other container.
50 You can find an example below of how to configure and run a guest image.
51 Before starting a guest image, a root filesystem has to be imported in
52 Docker:</para>
53
54 <programlisting>docker import guest-qemux86-64.tar.gz guest</programlisting>
55
56 <para>To check that the Docker image has been imported successfully,
57 run:</para>
58
59 <programlisting>docker images</programlisting>
60
61 <para>Finally, start a container with <literal>bash</literal> running as
62 the shell, by running:</para>
63
64 <programlisting>docker run -it guest /bin/bash</programlisting>
65 </section>
66
67 <section id="attach-ext-resources-docker-containers">
68 <title>Attach external resources to Docker containers</title>
69
70 <para>Any system resource present on the host machine can be attached or
71 accessed by a Docker container.</para>
72
73 <para>Typically, if a file or folder on the host machine needs to be
74 attached to a container, that container should be launched with the
75 <literal>-v</literal> parameter. For example, to attach the
76 <literal>roots</literal> home folder to a container, the command line
77 for Docker should have the following format:</para>
78
79 <programlisting>docker run -it -v /home/root:/home/host_root/ guest /bin/bash</programlisting>
80
81 <para>To check that folders have been properly passed from the host to
82 the container, create a file in the source folder on the host root
83 filesystem and check for its existence inside the containers destination
84 location.</para>
85
86 <section id="attach-vhost-descriptors">
87 <title>Attach vhost file descriptors</title>
88
89 <para>If OVS is running on the host and vhost file descriptors need to
90 be passed to the container, this can be done by either mapping the
91 folder where all the file descriptors are located or mapping the file
92 descriptor itself:</para>
93
94 <itemizedlist>
95 <listitem>
96 <para>Mapping the folder can be done as exemplified above:</para>
97
98 <programlisting>docker run -it --rm -v /var/run/openvswitch/:/var/run/openvswitch/ guest /bin/bash</programlisting>
99 </listitem>
100
101 <listitem>
102 <para>Mapping a file descriptor is done in a similar way, but the
103 <literal>-v</literal> flag needs to point directly to it:</para>
104
105 <programlisting>docker run -it --rm -v /var/run/openvswitch/vhost-user1 guest /bin/bash</programlisting>
106 </listitem>
107 </itemizedlist>
108 </section>
109
110 <section id="attach-hugepages-mount-folders">
111 <title>Attach hugepages mount folders</title>
112
113 <para>Hugepages mount folders can also be accessed by a container
114 similarly to how a plain folder is mapped, as shown in 1.3.</para>
115
116 <para>For example, if the host system has hugepages mounted in the
117 <literal>/mnt/huge</literal> location, a container can also access
118 hugepages by being launched with:</para>
119
120 <programlisting>docker run -it -v /mnt/huge guest /bin/bash</programlisting>
121 </section>
122
123 <section id="access-pci-bus">
124 <title>Access the PCI bus</title>
125
126 <para>If the host machine has multiple SRIOV instances created, a
127 container can access the instances by being given privileged access to
128 the host system. Unlike folders, PCI devices do not have to be mounted
129 explicitly in order to be accessed and will be available to the
130 container if the <literal>--privileged</literal> flag is passed to the
131 command line:</para>
132
133 <programlisting>docker run --privileged -it guest /bin/bash</programlisting>
134 </section>
135 </section>
136 </section>
137</chapter>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/dpdk.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/dpdk.xml
deleted file mode 100644
index 523a2d5..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/dpdk.xml
+++ /dev/null
@@ -1,115 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="dpdk">
5 <title>Data Plane Development Kit</title>
6
7 <para>The Intel Data Plane Development Kit (DPDK) is a set of user-space
8 libraries and drivers that provides a programming framework for high-speed
9 packet processing applications. The DPDK includes a number of Poll Mode
10 Drivers that enable direct packet transfer between the physical NIC and
11 user-space without using interrupts, bypassing the Linux kernel network
12 stack entirely.</para>
13
14 <para>In order to take advantage of DPDK, Linux <ulink
15 url="https://www.kernel.org/doc/Documentation/vm/hugetlbpage.txt">huge
16 pages</ulink> must be enabled in the system.</para>
17
18 <para>For DPDK documentation, see <ulink
19 url="http://dpdk.org/doc/guides-18.02/index.html">http://dpdk.org/doc/guides-18.02/index.html</ulink></para>
20
21 <section id="pktgen">
22 <title>Pktgen</title>
23
24 <para>In addition to DPDK, Enea NFV Access includes Pktgen, a software
25 traffic generator that is powered by the DPDK packet processing framework.
26 Pktgen can act as a transmitter or receiver and is capable of generating
27 10Gbit wire rate traffic with 64 byte frames.</para>
28
29 <para>Pktgen is installed in <literal>/usr/share/apps/pktgen/</literal>
30 and needs to be executed from this directory.</para>
31
32 <para>For Pktgen documentation, see <ulink
33 url="http://pktgen-dpdk.readthedocs.io">http://pktgen-dpdk.readthedocs.io</ulink></para>
34 </section>
35
36 <section id="dpdk-setup">
37 <title>DPDK setup instructions</title>
38
39 <para>The following setup instructions apply to both host and
40 guest.</para>
41
42 <orderedlist>
43 <listitem>
44 <para>To make the hugepage memory available for DPDK, it must be
45 mounted:</para>
46
47 <programlisting>$ mkdir /mnt/huge
48mount -t hugetlbfs nodev /mnt/huge</programlisting>
49 </listitem>
50
51 <listitem>
52 <para>Load the vfio-pci kernel module:</para>
53
54 <programlisting>$ modprobe vfio-pci</programlisting>
55 </listitem>
56
57 <listitem>
58 <para>Bind the device to the vfio-pci driver:</para>
59
60 <para><programlisting>$ dpdk-devbind --bind=vfio-pci &lt;PCI device number&gt;</programlisting>The
61 DPDK provides the dpdk-devbind tool to help binding/unbinding devices
62 from specific drivers. See <ulink
63 url="http://dpdk.org/doc/guides-18.02/tools/devbind.html">http://dpdk.org/doc/guides-18.02/tools/devbind.html</ulink>
64 for more information.</para>
65 </listitem>
66 </orderedlist>
67
68 <para>To print the current status of all known network
69 interfaces:<programlisting>$ dpdk-devbind --status</programlisting></para>
70
71 <para>At this point the system is ready to run DPDK applications.</para>
72 </section>
73
74 <section id="dpdk-example-test-setup">
75 <title>DPDK example test setup</title>
76
77 <para>This is a simple DPDK test setup using two boards connected
78 back-to-back. One board generates traffic using the Pktgen application,
79 and the other board runs the DPDK testpmd example to forward packets back
80 on the same interface.</para>
81
82 <programlisting>Pktgen [DPDK] - Board 1 PHY &lt;--&gt; Board 2 PHY - [DPDK] testpmd</programlisting>
83
84 <orderedlist>
85 <listitem>
86 <para>Setup DPDK on both boards, following the instructions in <xref
87 linkend="dpdk-setup" />.</para>
88 </listitem>
89
90 <listitem>
91 <para>On board 1, start the Pktgen application:</para>
92
93 <programlisting>cd /usr/share/apps/pktgen/
94./pktgen -c 0x7 -n 4 --socket-mem 1024 -- -P -m "[1:2].0"</programlisting>
95
96 <para>In the Pktgen console, run:</para>
97
98 <programlisting>start 0</programlisting>
99
100 <para>The Pktgen output will display the traffic configuration and
101 statistics.</para>
102 </listitem>
103
104 <listitem>
105 <para>On board 2, start the testpmd application:</para>
106
107 <programlisting>testpmd -c 0x7 -n 4 -- --txd=512 --rxd=512 --port-topology=chained</programlisting>
108
109 <para>For more information, refer to the testpmd application user
110 guide: <ulink
111 url="http://dpdk.org/doc/guides-18.02/testpmd_app_ug/index.html">http://dpdk.org/doc/guides-18.02/testpmd_app_ug/index.html</ulink>.</para>
112 </listitem>
113 </orderedlist>
114 </section>
115</chapter>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_template.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_template.xml
deleted file mode 100644
index eaa7ebd..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_template.xml
+++ /dev/null
@@ -1,151 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting>ELTF_PL_HOST_PREREQ</programlisting></para>
26
27 <bridgehead>A programlisting, ID
28 "eltf-getting-repo-install-command"</bridgehead>
29
30 <para id="eltf-getting-repo-install-command"><programlisting>ELTF_PL_GET_REPO</programlisting></para>
31
32 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
33 correct also compared to the "previous" REL VER in pardoc-distro.xml
34 "prev_baseline".</bridgehead>
35
36 <para id="EneaLinux_REL_VER"><phrase>ELTF_EL_REL_VER</phrase></para>
37
38 <para id="Yocto_VER"><phrase>ELTF_YOCTO_VER</phrase></para>
39
40 <para id="Yocto_NAME"><phrase>ELTF_YOCTO_NAME</phrase></para>
41
42 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
43 url="ELTF_YOCTO_PROJ_DOWNLOAD_URL">ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL</ulink></para>
44
45 <para id="ULINK_ENEA_LINUX_URL"><ulink
46 url="ELTF_EL_DOWNLOAD_URL">ELTF_EL_DOWNLOAD_TXTURL</ulink></para>
47
48 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
49 $MACHINE/default.xml as parameter, where MACHINE is one of the target
50 directory names in the manifest.</bridgehead>
51
52 <para id="eltf-repo-cloning-enea-linux"><programlisting>ELTF_PL_CLONE_W_REPO</programlisting></para>
53
54 <bridgehead>A table with ONE row, only the row with ID
55 "eltf-eclipse-version-row" is included in the book. MANUALLY BOTH in the
56 template.xml and in the updated.xml, set condition hidden on the
57 &lt;row&gt;, if eclipse is not in the release.</bridgehead>
58
59 <informaltable>
60 <tgroup cols="1">
61 <tbody>
62 <row id="eltf-eclipse-version-row">
63 <entry>Eclipse version ELTF_ECLIPSE_VERSION plus command line
64 development tools are included in this Enea NFV Access release.</entry>
65 </row>
66 </tbody>
67 </tgroup>
68 </informaltable>
69
70 <bridgehead>Below is one big section with title "Supported Targets with
71 Parameters". The entire section is included completely in the book via ID
72 "eltf-target-tables-section" and shall be LAST in the template. The
73 template contains ONE target subsection. COPY/APPEND it, if multiple
74 targets exist in the release and optionally add rows with additional
75 target parameters in each target subsection table.</bridgehead>
76 </section>
77
78 <section id="eltf-target-tables-section">
79 <title>Supported Targets with Parameters</title>
80
81 <para>The tables below describes the target(s) supported in this Enea
82 NFV Access release.</para>
83
84 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
85 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
86
87 <para><informaltable>
88 <tgroup cols="2">
89 <colspec colwidth="6*" />
90
91 <colspec colwidth="9*" />
92
93 <tbody>
94 <row>
95 <entry>Target official name</entry>
96
97 <entry>ELTF_T_NAME</entry>
98 </row>
99
100 <row>
101 <entry>Architecture and Description</entry>
102
103 <entry>ELTF_T_ARC_DESC</entry>
104 </row>
105
106 <row>
107 <entry>Link to target datasheet</entry>
108
109 <entry>See <ulink
110 url="ELTF_T_DS_URL">ELTF_T_DS_TXTURL</ulink></entry>
111 </row>
112
113 <row>
114 <entry>Poky version</entry>
115
116 <entry>ELTF_T_POKY_VER</entry>
117 </row>
118
119 <row>
120 <entry>GCC version</entry>
121
122 <entry>ELTF_T_GCC_VER</entry>
123 </row>
124
125 <row>
126 <entry>Linux Kernel Version</entry>
127
128 <entry>ELTF_T_KERN_VER</entry>
129 </row>
130
131 <row>
132 <entry>Supported Drivers</entry>
133
134 <entry>ELTF_T_DRIVERS</entry>
135 </row>
136
137 <row>
138 <entry>Enea rpm folder for downloading RPM packages for this
139 target</entry>
140
141 <entry><ulink
142 url="ELTF_T_EL_RPM_URL">ELTF_T_EL_RPM_TXTURL</ulink></entry>
143 </row>
144 </tbody>
145 </tgroup>
146 </informaltable></para>
147 </section>
148
149 <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->
150 </section>
151</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_updated.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_updated.xml
deleted file mode 100644
index f5dcbb9..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/eltf_params_updated.xml
+++ /dev/null
@@ -1,165 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 14.04.5 LTS 64bit
26sudo apt-get -y update
27sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
28 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
29 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
30 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
31 libxml-parser-perl</programlisting></para>
32
33 <bridgehead>A programlisting, ID
34 "eltf-getting-repo-install-command"</bridgehead>
35
36 <para id="eltf-getting-repo-install-command"><programlisting>mkdir -p ~/bin
37curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo
38chmod a+x ~/bin/repo
39export PATH=~/bin:$PATH</programlisting></para>
40
41 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
42 correct also compared to the "previous" REL VER in pardoc-distro.xml
43 "prev_baseline".</bridgehead>
44
45 <para id="EneaLinux_REL_VER"><phrase>2.2</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.4</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>rocko</phrase></para>
50
51 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
52 url="http://www.yoctoproject.org/downloads/core/rocko/242">http://www.yoctoproject.org/downloads/core/rocko/242</ulink></para>
53
54 <para id="ULINK_ENEA_LINUX_URL"><ulink
55 url="https://linux.enea.com/6">https://linux.enea.com/6</ulink></para>
56
57 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
58 $MACHINE/default.xml as parameter, where MACHINE is one of the target
59 directory names in the manifest.</bridgehead>
60
61 <para id="eltf-repo-cloning-enea-linux"><programlisting>mkdir enea-linux
62cd enea-linux
63repo init -u git@git.enea.com:linux/manifests/el_manifests-virtualization.git \
64 -b refs/tags/EL6 -m $MACHINE/default.xml
65repo sync</programlisting></para>
66
67 <bridgehead>A table with ONE row, only the row with ID
68 "eltf-eclipse-version-row" is included in the book. MANUALLY in book, set
69 condition hidden if eclipse is not in the release. Do this both in
70 template.xml and updated.xml.</bridgehead>
71
72 <informaltable>
73 <tgroup cols="1">
74 <tbody>
75 <row condition="hidden" id="eltf-eclipse-version-row">
76 <entry>Eclipse version 4.3 (Mars) plus command line development
77 tools are included in this Enea NFV Access release.</entry>
78 </row>
79 </tbody>
80 </tgroup>
81 </informaltable>
82
83 <bridgehead>Below is one big section with title "Supported Targets with
84 Parameters". The entire section is included completely in the book via ID
85 "eltf-target-tables-section" and shall be LAST in the template. The
86 template contains ONE target subsection. COPY/APPEND it, if multiple
87 targets exist in the release and optionally add rows with additional
88 target parameters in each target subsection table.</bridgehead>
89 </section>
90
91 <section id="eltf-target-tables-section">
92 <title>Supported Reference Boards with Parameters</title>
93
94 <para>The tables below describes the target(s) supported in this Enea NFV
95 Access release.</para>
96
97 <section id="eltf-target-table-p2041rdb">
98 <title>MACHINE p2041rdb - Information</title>
99
100 <para><informaltable>
101 <tgroup cols="2">
102 <colspec colwidth="6*" />
103
104 <colspec colwidth="9*" />
105
106 <tbody>
107 <row>
108 <entry>Target official name</entry>
109
110 <entry>P2041RDB</entry>
111 </row>
112
113 <row>
114 <entry>Architecture and Description</entry>
115
116 <entry>Power, e500mc</entry>
117 </row>
118
119 <row>
120 <entry>Link to target datasheet</entry>
121
122 <entry>See <ulink
123 url="http://www.nxp.com/products/microcontrollers-and-processors/power-architecture-processors/qoriq-power-architecture-processors/p2041-qoriq-reference-design-board:RDP2041BOARD">link
124 to NXP's datasheet</ulink></entry>
125 </row>
126
127 <row>
128 <entry>Poky version</entry>
129
130 <entry>Git-commit-id:
131 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
132 </row>
133
134 <row>
135 <entry>GCC version</entry>
136
137 <entry>5.3</entry>
138 </row>
139
140 <row>
141 <entry>Linux Kernel Version</entry>
142
143 <entry>3.12</entry>
144 </row>
145
146 <row>
147 <entry>Supported Drivers</entry>
148
149 <entry>Ethernet, I2C, SPI, PCI Express, USB, Flash,
150 SD/SDHC/SDXC, RTC</entry>
151 </row>
152
153 <row>
154 <entry>Enea rpm folder for downloading RPM packages for this
155 target</entry>
156
157 <entry><ulink
158 url="https://linux.enea.com/6/p2041rgb/rpm">https://linux.enea.com/6/p2041rgb/rpm</ulink></entry>
159 </row>
160 </tbody>
161 </tgroup>
162 </informaltable></para>
163 </section>
164 </section>
165</section>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/hypervisor_virtualization.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/hypervisor_virtualization.xml
deleted file mode 100644
index cf712b4..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/hypervisor_virtualization.xml
+++ /dev/null
@@ -1,744 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="hypervisor_virt">
5 <title>Hypervisor Virtualization</title>
6
7 <para>The KVM, Kernel-based Virtual Machine, is a virtualization
8 infrastructure for the Linux kernel which turns it into a hypervisor. KVM
9 requires a processor with a hardware virtualization extension.</para>
10
11 <para>KVM uses QEMU, an open source machine emulator and virtualizer, to
12 virtualize a complete system. With KVM it is possible to run multiple guests
13 of a variety of operating systems, each with a complete set of virtualized
14 hardware.</para>
15
16 <section id="launch_virt_machine">
17 <title>Launching a Virtual Machine</title>
18
19 <para>QEMU can make use of KVM when running a target architecture that is
20 the same as the host architecture. For instance, when running
21 qemu-system-x86_64 on an x86-64 compatible processor (containing
22 virtualization extensions Intel VT or AMD-V), you can take advantage of
23 the KVM acceleration, giving you benefit for your host and your guest
24 system.</para>
25
26 <para>Enea NFV Access includes an optimizied version of QEMU with KVM-only
27 support. To use KVM pass<command> --enable-kvm</command> to QEMU.</para>
28
29 <para>The following is an example of starting a guest:</para>
30
31 <programlisting>taskset -c 0,1 qemu-system-x86_64 \
32-cpu host -M q35 -smp cores=2,sockets=1 \
33-vcpu 0,affinity=0 -vcpu 1,affinity=1 \
34-enable-kvm -nographic \
35-kernel bzImage \
36-drive file=enea-nfv-access-guest-qemux86-64.ext4,if=virtio,format=raw \
37-append 'root=/dev/vda console=ttyS0,115200' \
38-m 4096 \
39-object memory-backend-file,id=mem,size=4096M,mem-path=/dev/hugepages,share=on \
40-numa node,memdev=mem -mem-prealloc</programlisting>
41 </section>
42
43 <section id="qemu_boot">
44 <title>Main QEMU boot options</title>
45
46 <para>Below are detailed all the pertinent boot options for the QEMU
47 emulator:</para>
48
49 <itemizedlist>
50 <listitem>
51 <para>SMP - at least 2 cores should be enabled in order to isolate
52 application(s) running in virtual machine(s) on specific cores for
53 better performance.</para>
54
55 <programlisting>-smp cores=2,threads=1,sockets=1 \</programlisting>
56 </listitem>
57
58 <listitem>
59 <para>CPU affinity - associate virtual CPUs with physical CPUs and
60 optionally assign a default real time priority to the virtual CPU
61 process in the host kernel. This option allows you to start qemu vCPUs
62 on isolated physical CPUs.</para>
63
64 <programlisting>-vcpu 0,affinity=0 \</programlisting>
65 </listitem>
66
67 <listitem>
68 <para>Hugepages - KVM guests can be deployed with huge page memory
69 support in order to reduce memory consumption and improve performance,
70 by reducing CPU cache usage. By using huge pages for a KVM guest, less
71 memory is used for page tables and TLB (Translation Lookaside Buffer)
72 misses are reduced, thereby significantly increasing performance,
73 especially for memory-intensive situations.</para>
74
75 <programlisting>-object memory-backend-file,id=mem,size=4096M,mem-path=/dev/hugepages,share=on \</programlisting>
76 </listitem>
77
78 <listitem>
79 <para>Memory preallocation - preallocate huge pages at startup time
80 can improve performance but it may affect the qemu boot time.</para>
81
82 <programlisting>-mem-prealloc \</programlisting>
83 </listitem>
84
85 <listitem>
86 <para>Enable realtime characteristics - run qemu with realtime
87 features. While that mildly implies that "-realtime" alone might do
88 something, it's just an identifier for options that are partially
89 realtime. If you're running in a realtime or low latency environment,
90 you don't want your pages to be swapped out and mlock does that, thus
91 mlock=on. If you want VM density, then you may want swappable VMs,
92 thus mlock=off.</para>
93
94 <programlisting>-realtime mlock=on \</programlisting>
95 </listitem>
96 </itemizedlist>
97
98 <para>If the hardware does not have an IOMMU (known as "Intel VT-d" on
99 Intel-based machines and "AMD I/O Virtualization Technology" on AMD-based
100 machines), it will not be possible to assign devices in KVM.
101 Virtualization Technology features (VT-d, VT-x, etc.) must be enabled from
102 BIOS on the host target before starting a virtual machine.</para>
103 </section>
104
105 <section id="net_in_guest">
106 <title>Networking in guest</title>
107
108 <section id="vhost-user-support">
109 <title>Using vhost-user support</title>
110
111 <para>The goal of vhost-user is to implement a Virtio transport, staying
112 as close as possible to the vhost paradigm of using shared memory,
113 ioeventfds and irqfds. A UNIX domain socket based mechanism allows the
114 set up of resources used by a number of Vrings shared between two
115 userspace processes, which will be placed in shared memory.</para>
116
117 <para>To run QEMU with the vhost-user backend, you have to provide the
118 named UNIX domain socket which needs to be already opened by the
119 backend:</para>
120
121 <programlisting>-object memory-backend-file,id=mem,size=4096M,mem-path=/dev/hugepages,share=on \
122-chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1 \
123-netdev type=vhost-user,id=mynet1,chardev=char0,vhostforce \
124-device virtio-net-pci,netdev=mynet1,mac=52:54:00:00:00:01 \</programlisting>
125
126 <para>The vHost User standard uses a client-server model. The server
127 creates and manages the vHost User sockets and the client connects to
128 the sockets created by the server. It is recommended to use QEMU as
129 server so the vhost-user client can be restarted without affecting the
130 server, otherwise if the server side dies all clients need to be
131 restarted.</para>
132
133 <para>Using vhost-user in QEMU as server will offer the flexibility to
134 stop and start the virtual machine with no impact on virtual switch from
135 the host (vhost-user-client).</para>
136
137 <programlisting>-chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1,server \</programlisting>
138 </section>
139
140 <section id="tap-interface">
141 <title>Using TAP Interfaces</title>
142
143 <para>QEMU can use TAP interfaces to provide full networking capability
144 for the guest OS:</para>
145
146 <programlisting>-netdev tap,id=net0,ifname=tap0,script=no,downscript=no \
147-device virtio-net-pci,netdev=net0,mac=22:EA:FB:A8:25:AE \</programlisting>
148 </section>
149
150 <section id="vfio-passthrough">
151 <title>VFIO passthrough VF (SR-IOV) to guest</title>
152
153 <para>KVM hypervisor support for attaching PCI devices on the host
154 system to guests. PCI passthrough allows guests to have exclusive access
155 to PCI devices for a range of tasks. PCI passthrough allows PCI devices
156 to appear and behave as if they were physically attached to the guest
157 operating system.</para>
158
159 <para>Preparing an Intel system for PCI passthrough:</para>
160
161 <itemizedlist>
162 <listitem>
163 <para>Enable the Intel VT-d extensions in BIOS</para>
164 </listitem>
165
166 <listitem>
167 <para>Activate Intel VT-d in the kernel by using
168 <literal>intel_iommu=on</literal> as a kernel boot parameter</para>
169 </listitem>
170
171 <listitem>
172 <para>Allow unsafe interrupts in case the system doesn't support
173 interrupt remapping. This can be done using
174 <literal>vfio_iommu_type1.allow_unsafe_interrupts=1</literal> as a
175 boot kernel parameter.</para>
176 </listitem>
177 </itemizedlist>
178
179 <para>Create guest with direct passthrough via VFIO framework like
180 so:</para>
181
182 <programlisting>-device vfio-pci,host=0000:03:10.2 \</programlisting>
183
184 <para>On the host, one or more Virtual Functions (VFs) must be created in
185 order to be allocated for a guest network to access, before starting
186 QEMU:</para>
187
188 <programlisting>$ echo 2 &gt; /sys/class/net/eno3/device/sriov_numvfs
189$ modprobe vfio_pci
190$ dpdk-devbind --bind=vfio-pci 0000:03:10.2</programlisting>
191 </section>
192
193 <section id="multiqueue">
194 <title>Multi-queue</title>
195
196 <para>In order to ensure that network performance scales as the number
197 of vCPUs increases, multi-queue support can be used in QEMU.</para>
198
199 <section id="qemu-multiqueue-support">
200 <title>QEMU multi queue support configuration</title>
201
202 <programlisting>-chardev socket,id=char0,path=/var/run/openvswitch/vhost-user1 \
203-netdev type=vhost-user,id=net0,chardev=char0,queues=2 \
204-device virtio-net-pci,netdev=net0,mac=22:EA:FB:A8:25:AE,mq=on,vectors=6
205where vectors is calculated as: 2 + 2 * queues number.</programlisting>
206 </section>
207
208 <section id="inside-guest">
209 <title>Inside guest</title>
210
211 <para>Linux kernel virtio-net driver (one queue is enabled by
212 default):</para>
213
214 <programlisting>$ ethtool -L combined 2 eth0
215DPDK Virtio PMD
216$ testpmd -c 0x7 -- -i --rxq=2 --txq=2 --nb-cores=2 ...</programlisting>
217
218 <para>For QEMU documentation please see: <ulink
219 url="https://qemu.weilnetz.de/doc/qemu-doc.html">https://qemu.weilnetz.de/doc/qemu-doc.html</ulink>.</para>
220 </section>
221 </section>
222 </section>
223
224 <section id="libvirt">
225 <title>Libvirt</title>
226
227 <para>One way to manage guests in Enea NFV Access is by using
228 <literal>libvirt</literal>. Libvirt is used in conjunction with a daemon
229 (<literal>libvirtd</literal>) and a command line utility (virsh) to manage
230 virtualized environments.</para>
231
232 <para>The libvirt library is a hypervisor-independent virtualization API
233 and toolkit that is able to interact with the virtualization capabilities
234 of a range of operating systems. Libvirt provides a common, generic and
235 stable layer to securely manage domains on a node. As nodes may be
236 remotely located, libvirt provides all methods required to provision,
237 create, modify, monitor, control, migrate and stop the domains, within the
238 limits of hypervisor support for these operations.</para>
239
240 <para>The libvirt daemon runs on the Enea NFV Access host. All tools built
241 on libvirt API connect to the daemon to request the desired operation, and
242 to collect information about the configuration and resources of the host
243 system and guests. <literal>virsh</literal> is a command line interface
244 tool for managing guests and the hypervisor. The virsh tool is built on
245 the libvirt management API.</para>
246
247 <para><emphasis role="bold">Major functionality provided by
248 libvirt</emphasis></para>
249
250 <para>The following is a summary from the libvirt <ulink
251 url="http://wiki.libvirt.org/page/FAQ#What_is_libvirt.3F">home
252 page</ulink> describing the major libvirt features:</para>
253
254 <itemizedlist>
255 <listitem>
256 <para><emphasis role="bold">VM management:</emphasis> Various domain
257 lifecycle operations such as start, stop, pause, save, restore, and
258 migrate. Hotplug operations for many device types including disk and
259 network interfaces, memory, and cpus.</para>
260 </listitem>
261
262 <listitem>
263 <para><emphasis role="bold">Remote machine support:</emphasis> All
264 libvirt functionality is accessible on any machine running the libvirt
265 daemon, including remote machines. A variety of network transports are
266 supported for connecting remotely, with the simplest being
267 <literal>SSH</literal>, which requires no extra explicit
268 configuration. For more information, see: <ulink
269 url="http://libvirt.org/remote.html">http://libvirt.org/remote.html</ulink>.</para>
270 </listitem>
271
272 <listitem>
273 <para><emphasis role="bold">Network interface management:</emphasis>
274 Any host running the libvirt daemon can be used to manage physical and
275 logical network interfaces. Enumerate existing interfaces, as well as
276 configure (and create) interfaces, bridges, vlans, and bond devices.
277 For more details see: <ulink
278 url="https://fedorahosted.org/netcf/">https://fedorahosted.org/netcf/</ulink>.</para>
279 </listitem>
280
281 <listitem>
282 <para><emphasis role="bold">Virtual NAT and Route based
283 networking:</emphasis> Any host running the libvirt daemon can manage
284 and create virtual networks. Libvirt virtual networks use firewall
285 rules to act as a router, providing VMs transparent access to the host
286 machines network. For more information, see: <ulink
287 url="http://libvirt.org/archnetwork.html">http://libvirt.org/archnetwork.html</ulink>.</para>
288 </listitem>
289
290 <listitem>
291 <para><emphasis role="bold">Storage management:</emphasis> Any host
292 running the libvirt daemon can be used to manage various types of
293 storage: create file images of various formats (raw, qcow2, etc.),
294 mount NFS shares, enumerate existing LVM volume groups, create new LVM
295 volume groups and logical volumes, partition raw disk devices, mount
296 iSCSI shares, and much more. For more details, see: <ulink
297 url="http://libvirt.org/storage.html">http://libvirt.org/storage.html</ulink>.</para>
298 </listitem>
299
300 <listitem>
301 <para><emphasis role="bold">Libvirt Configuration:</emphasis> A
302 properly running libvirt requires that the following elements be in
303 place:</para>
304
305 <itemizedlist>
306 <listitem>
307 <para>Configuration files, located in the directory
308 <literal>/etc/libvirt</literal>. They include the daemon's
309 configuration file <literal>libvirtd.conf</literal>, and
310 hypervisor-specific configuration files, like
311 <literal>qemu.conf</literal> for the QEMU.</para>
312 </listitem>
313
314 <listitem>
315 <para>A running libvirtd daemon. The daemon is started
316 automatically in Enea NFV Access host.</para>
317 </listitem>
318
319 <listitem>
320 <para>Configuration files for the libvirt domains, or guests, to
321 be managed by the KVM host. The specifics for guest domains shall
322 be defined in an XML file of a format specified at <ulink
323 url="http://libvirt.org/formatdomain.html">http://libvirt.org/formatdomain.html</ulink>.
324 XML formats for other structures are specified at <ulink type=""
325 url="http://libvirt.org/format.html">http://libvirt.org/format.html</ulink>.</para>
326 </listitem>
327 </itemizedlist>
328 </listitem>
329 </itemizedlist>
330
331 <section id="boot-kvm-guest">
332 <title>Booting a KVM Guest</title>
333
334 <para>There are several ways to boot a KVM guest. Here we describe how
335 to boot using a raw image. A direct kernel boot can be performed by
336 transferring the guest kernel and the file system files to the host and
337 specifying a <literal>&lt;kernel&gt;</literal> and an
338 <literal>&lt;initrd&gt;</literal> element inside the
339 <literal>&lt;os&gt;</literal> element of the guest XML file, as in the
340 following example:</para>
341
342 <programlisting>&lt;os&gt;
343 &lt;kernel&gt;bzImage&lt;/kernel&gt;
344&lt;/os&gt;
345&lt;devices&gt;
346 &lt;disk type='file' device='disk'&gt;
347 &lt;driver name='qemu' type='raw' cache='none'/&gt;
348 &lt;source file='enea-nfv-access-guest-qemux86-64.ext4'/&gt;
349 &lt;target dev='vda' bus='virtio'/&gt;
350 &lt;/disk&gt;
351&lt;/devices&gt;</programlisting>
352 </section>
353
354 <section id="start-guest">
355 <title>Starting a Guest</title>
356
357 <para>Command <command>virsh create</command> starts a guest:</para>
358
359 <programlisting>virsh create example-guest-x86.xml</programlisting>
360
361 <para>If further configurations are needed before the guest is reachable
362 through <literal>ssh</literal>, a console can be started using command
363 <command>virsh console</command>. The example below shows how to start a
364 console where kvm-example-guest is the name of the guest defined in the
365 guest XML file:</para>
366
367 <programlisting>virsh console kvm-example-guest</programlisting>
368
369 <para>This requires that the guest domain has a console configured in
370 the guest XML file:</para>
371
372 <programlisting>&lt;os&gt;
373 &lt;cmdline&gt;console=ttyS0,115200&lt;/cmdline&gt;
374&lt;/os&gt;
375&lt;devices&gt;
376 &lt;console type='pty'&gt;
377 &lt;target type='serial' port='0'/&gt;
378 &lt;/console&gt;
379&lt;/devices&gt;</programlisting>
380 </section>
381
382 <section id="isolation">
383 <title>Isolation</title>
384
385 <para>It may be desirable to isolate execution in a guest, to a specific
386 guest core. It might also be desirable to run a guest on a specific host
387 core.</para>
388
389 <para>To pin the virtual CPUs of the guest to specific cores, configure
390 the <literal>&lt;cputune&gt;</literal> contents as follows:</para>
391
392 <orderedlist>
393 <listitem>
394 <para>First explicitly state on which host core each guest core
395 shall run, by mapping <literal>vcpu</literal> to
396 <literal>cpuset</literal> in the <literal>&lt;vcpupin&gt;</literal>
397 tag.</para>
398 </listitem>
399
400 <listitem>
401 <para>In the <literal>&lt;cputune&gt;</literal> tag it is further
402 possible to specify on which CPU the emulator shall run by adding
403 the cpuset to the <literal>&lt;emulatorpin&gt;</literal> tag.</para>
404
405 <programlisting>&lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
406&lt;cputune&gt;
407 &lt;vcpupin vcpu='0' cpuset='2'/&gt;
408 &lt;vcpupin vcpu='1' cpuset='3'/&gt;
409 &lt;emulatorpin cpuset="2"/&gt;
410&lt;/cputune&gt;</programlisting>
411
412 <para><literal>libvirt</literal> will group all threads belonging to
413 a qemu instance into cgroups that will be created for that purpose.
414 It is possible to supply a base name for those cgroups using the
415 <literal>&lt;resource&gt;</literal> tag:</para>
416
417 <programlisting>&lt;resource&gt;
418 &lt;partition&gt;/rt&lt;/partition&gt;
419&lt;/resource&gt;</programlisting>
420 </listitem>
421 </orderedlist>
422 </section>
423
424 <section id="network-libvirt">
425 <title>Networking using libvirt</title>
426
427 <para>Command <command>virsh net-create</command> starts a network. If
428 any networks are listed in the guest XML file, those networks must be
429 started before the guest is started. As an example, if the network is
430 defined in a file named example-net.xml, it is started as
431 follows:</para>
432
433 <programlisting>virsh net-create example-net.xml
434&lt;network&gt;
435 &lt;name&gt;sriov&lt;/name&gt;
436 &lt;forward mode='hostdev' managed='yes'&gt;
437 &lt;pf dev='eno3'/&gt;
438 &lt;/forward&gt;
439&lt;/network&gt;</programlisting>
440
441 <para><literal>libvirt</literal> is a virtualization API that supports
442 virtual network creation. These networks can be connected to guests and
443 containers by referencing the network in the guest XML file. It is
444 possible to have a virtual network persistently running on the host by
445 starting the network with command <command>virsh net-define</command>
446 instead of the previously mentioned <command>virsh
447 net-create</command>.</para>
448
449 <para>An example for the sample network defined in
450 <literal>meta-vt/recipes-example/virt-example/files/example-net.xml</literal>:</para>
451
452 <programlisting>virsh net-define example-net.xml</programlisting>
453
454 <para>Command <command>virsh net-autostart</command> enables a
455 persistent network to start automatically when the libvirt daemon
456 starts:</para>
457
458 <programlisting>virsh net-autostart example-net</programlisting>
459
460 <para>Guest configuration file (xml) must be updated to access newly
461 created network like so:</para>
462
463 <programlisting> &lt;interface type='network'&gt;
464 &lt;source network='sriov'/&gt;
465 &lt;/interface&gt;</programlisting>
466
467 <para>The following presented here are a few modes of network access
468 from guest using <command>virsh</command>:</para>
469
470 <itemizedlist>
471 <listitem>
472 <para><emphasis role="bold">vhost-user interface</emphasis></para>
473
474 <para>See the Open vSwitch chapter on how to create vhost-user
475 interface using Open vSwitch. Currently there is no Open vSwitch
476 support for networks that are managed by libvirt (e.g. NAT). As of
477 now, only bridged networks are supported (those where the user has
478 to manually create the bridge).</para>
479
480 <programlisting> &lt;interface type='vhostuser'&gt;
481 &lt;mac address='00:00:00:00:00:01'/&gt;
482 &lt;source type='unix' path='/var/run/openvswitch/vhost-user1' mode='client'/&gt;
483 &lt;model type='virtio'/&gt;
484 &lt;driver queues='1'&gt;
485 &lt;host mrg_rxbuf='off'/&gt;
486 &lt;/driver&gt;
487 &lt;/interface&gt;</programlisting>
488 </listitem>
489
490 <listitem>
491 <para><emphasis role="bold">PCI passthrough
492 (SR-IOV)</emphasis></para>
493
494 <para>KVM hypervisor support for attaching PCI devices on the host
495 system to guests. PCI passthrough allows guests to have exclusive
496 access to PCI devices for a range of tasks. PCI passthrough allows
497 PCI devices to appear and behave as if they were physically attached
498 to the guest operating system.</para>
499
500 <para>Preparing an Intel system for PCI passthrough is done like
501 so:</para>
502
503 <itemizedlist>
504 <listitem>
505 <para>Enable the Intel VT-d extensions in BIOS</para>
506 </listitem>
507
508 <listitem>
509 <para>Activate Intel VT-d in the kernel by using
510 <literal>intel_iommu=on</literal> as a kernel boot
511 parameter</para>
512 </listitem>
513
514 <listitem>
515 <para>Allow unsafe interrupts in case the system doesn't support
516 interrupt remapping. This can be done using
517 <literal>vfio_iommu_type1.allow_unsafe_interrupts=1</literal> as
518 a boot kernel parameter.</para>
519 </listitem>
520 </itemizedlist>
521
522 <para>VFs must be created on the host before starting the
523 guest:</para>
524
525 <programlisting>$ echo 2 &gt; /sys/class/net/eno3/device/sriov_numvfs
526$ modprobe vfio_pci
527$ dpdk-devbind.py --bind=vfio-pci 0000:03:10.0
528 &lt;interface type='hostdev' managed='yes'&gt;
529 &lt;source&gt;
530 &lt;address type='pci' domain='0x0' bus='0x03' slot='0x10' function='0x0'/&gt;
531 &lt;/source&gt;
532 &lt;mac address='52:54:00:6d:90:02'/&gt;
533 &lt;/interface&gt;</programlisting>
534 </listitem>
535
536 <listitem>
537 <para><emphasis role="bold">Bridge interface</emphasis></para>
538
539 <para>In case an OVS bridge exists on host, it can be used to
540 connect the guest:</para>
541
542 <programlisting> &lt;interface type='bridge'&gt;
543 &lt;mac address='52:54:00:71:b1:b6'/&gt;
544 &lt;source bridge='ovsbr0'/&gt;
545 &lt;virtualport type='openvswitch'/&gt;
546 &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x03' function='0x0'/&gt;
547 &lt;/interface&gt;</programlisting>
548
549 <para>For further details on the network XML format, see <ulink
550 url="http://libvirt.org/formatnetwork.html">http://libvirt.org/formatnetwork.html</ulink>.</para>
551 </listitem>
552 </itemizedlist>
553 </section>
554
555 <section id="libvirt-guest-config-ex">
556 <title>Libvirt guest configuration examples</title>
557
558 <section id="guest-config-vhost-user-interface">
559 <title>Guest configuration with vhost-user interface</title>
560
561 <programlisting>&lt;domain type='kvm'&gt;
562 &lt;name&gt;vm_vhost&lt;/name&gt;
563 &lt;uuid&gt;4a9b3f53-fa2a-47f3-a757-dd87720d9d1d&lt;/uuid&gt;
564 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
565 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
566 &lt;memoryBacking&gt;
567 &lt;hugepages&gt;
568 &lt;page size='1' unit='G' nodeset='0'/&gt;
569 &lt;/hugepages&gt;
570 &lt;/memoryBacking&gt;
571 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
572 &lt;cputune&gt;
573 &lt;shares&gt;4096&lt;/shares&gt;
574 &lt;vcpupin vcpu='0' cpuset='4'/&gt;
575 &lt;vcpupin vcpu='1' cpuset='5'/&gt;
576 &lt;emulatorpin cpuset='4,5'/&gt;
577 &lt;/cputune&gt;
578 &lt;os&gt;
579 &lt;type arch='x86_64' machine='pc'&gt;hvm&lt;/type&gt;
580 &lt;kernel&gt;/mnt/qemu/bzImage&lt;/kernel&gt;
581 &lt;cmdline&gt;root=/dev/vda console=ttyS0,115200&lt;/cmdline&gt;
582 &lt;boot dev='hd'/&gt;
583 &lt;/os&gt;
584 &lt;features&gt;
585 &lt;acpi/&gt;
586 &lt;apic/&gt;
587 &lt;/features&gt;
588 &lt;cpu mode='host-model'&gt;
589 &lt;model fallback='allow'/&gt;
590 &lt;topology sockets='2' cores='1' threads='1'/&gt;
591 &lt;numa&gt;
592 &lt;cell id='0' cpus='0-1' memory='4194304' unit='KiB' memAccess='shared'/&gt;
593 &lt;/numa&gt;
594 &lt;/cpu&gt;
595 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
596 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
597 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
598 &lt;devices&gt;
599 &lt;emulator&gt;/usr/bin/qemu-system-x86_64&lt;/emulator&gt;
600 &lt;disk type='file' device='disk'&gt;
601 &lt;driver name='qemu' type='raw' cache='none'/&gt;
602 &lt;source file='/mnt/qemu/enea-nfv-access-guest-qemux86-64.ext4'/&gt;
603 &lt;target dev='vda' bus='virtio'/&gt;
604 &lt;/disk&gt;
605 &lt;interface type='vhostuser'&gt;
606 &lt;mac address='00:00:00:00:00:01'/&gt;
607 &lt;source type='unix' path='/var/run/openvswitch/vhost-user1' mode='client'/&gt;
608 &lt;model type='virtio'/&gt;
609 &lt;driver queues='1'&gt;
610 &lt;host mrg_rxbuf='off'/&gt;
611 &lt;/driver&gt;
612 &lt;/interface&gt;
613 &lt;serial type='pty'&gt;
614 &lt;target port='0'/&gt;
615 &lt;/serial&gt;
616 &lt;console type='pty'&gt;
617 &lt;target type='serial' port='0'/&gt;
618 &lt;/console&gt;
619 &lt;/devices&gt;
620&lt;/domain&gt;</programlisting>
621 </section>
622
623 <section id="guest-config-pci-passthrough">
624 <title>Guest configuration with PCI passthrough</title>
625
626 <programlisting>&lt;domain type='kvm'&gt;
627 &lt;name&gt;vm_sriov1&lt;/name&gt;
628 &lt;uuid&gt;4a9b3f53-fa2a-47f3-a757-dd87720d9d1d&lt;/uuid&gt;
629 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
630 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
631 &lt;memoryBacking&gt;
632 &lt;hugepages&gt;
633 &lt;page size='1' unit='G' nodeset='0'/&gt;
634 &lt;/hugepages&gt;
635 &lt;/memoryBacking&gt;
636 &lt;vcpu&gt;2&lt;/vcpu&gt;
637 &lt;os&gt;
638 &lt;type arch='x86_64' machine='q35'&gt;hvm&lt;/type&gt;
639 &lt;kernel&gt;/mnt/qemu/bzImage&lt;/kernel&gt;
640 &lt;cmdline&gt;root=/dev/vda console=ttyS0,115200&lt;/cmdline&gt;
641 &lt;boot dev='hd'/&gt;
642 &lt;/os&gt;
643 &lt;features&gt;
644 &lt;acpi/&gt;
645 &lt;apic/&gt;
646 &lt;/features&gt;
647 &lt;cpu mode='host-model'&gt;
648 &lt;model fallback='allow'/&gt;
649 &lt;topology sockets='1' cores='2' threads='1'/&gt;
650 &lt;numa&gt;
651 &lt;cell id='0' cpus='0' memory='4194304' unit='KiB' memAccess='shared'/&gt;
652 &lt;/numa&gt;
653 &lt;/cpu&gt;
654 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
655 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
656 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
657 &lt;devices&gt;
658 &lt;emulator&gt;/usr/bin/qemu-system-x86_64&lt;/emulator&gt;
659 &lt;disk type='file' device='disk'&gt;
660 &lt;driver name='qemu' type='raw' cache='none'/&gt;
661 &lt;source file='/mnt/qemu/enea-nfv-access-guest-qemux86-64.ext4'/&gt;
662 &lt;target dev='vda' bus='virtio'/&gt;
663 &lt;/disk&gt;
664 &lt;interface type='hostdev' managed='yes'&gt;
665 &lt;source&gt;
666 &lt;address type='pci' domain='0x0' bus='0x03' slot='0x10' function='0x0'/&gt;
667 &lt;/source&gt;
668 &lt;mac address='52:54:00:6d:90:02'/&gt;
669 &lt;/interface&gt;
670 &lt;serial type='pty'&gt;
671 &lt;target port='0'/&gt;
672 &lt;/serial&gt;
673 &lt;console type='pty'&gt;
674 &lt;target type='serial' port='0'/&gt;
675 &lt;/console&gt;
676 &lt;/devices&gt;
677&lt;/domain&gt;</programlisting>
678 </section>
679
680 <section id="guest-config-bridge-interface">
681 <title>Guest configuration with bridge interface</title>
682
683 <programlisting>&lt;domain type='kvm'&gt;
684 &lt;name&gt;vm_bridge&lt;/name&gt;
685 &lt;uuid&gt;4a9b3f53-fa2a-47f3-a757-dd87720d9d1d&lt;/uuid&gt;
686 &lt;memory unit='KiB'&gt;4194304&lt;/memory&gt;
687 &lt;currentMemory unit='KiB'&gt;4194304&lt;/currentMemory&gt;
688 &lt;memoryBacking&gt;
689 &lt;hugepages&gt;
690 &lt;page size='1' unit='G' nodeset='0'/&gt;
691 &lt;/hugepages&gt;
692 &lt;/memoryBacking&gt;
693 &lt;vcpu placement='static'&gt;2&lt;/vcpu&gt;
694 &lt;cputune&gt;
695 &lt;shares&gt;4096&lt;/shares&gt;
696 &lt;vcpupin vcpu='0' cpuset='4'/&gt;
697 &lt;vcpupin vcpu='1' cpuset='5'/&gt;
698 &lt;emulatorpin cpuset='4,5'/&gt;
699 &lt;/cputune&gt;
700 &lt;os&gt;
701 &lt;type arch='x86_64' machine='q35'&gt;hvm&lt;/type&gt;
702 &lt;kernel&gt;/mnt/qemu/bzImage&lt;/kernel&gt;
703 &lt;cmdline&gt;root=/dev/vda console=ttyS0,115200&lt;/cmdline&gt;
704 &lt;boot dev='hd'/&gt;
705 &lt;/os&gt;
706 &lt;features&gt;
707 &lt;acpi/&gt;
708 &lt;apic/&gt;
709 &lt;/features&gt;
710 &lt;cpu mode='host-model'&gt;
711 &lt;model fallback='allow'/&gt;
712 &lt;topology sockets='2' cores='1' threads='1'/&gt;
713 &lt;numa&gt;
714 &lt;cell id='0' cpus='0-1' memory='4194304' unit='KiB' memAccess='shared'/&gt;
715 &lt;/numa&gt;
716 &lt;/cpu&gt;
717 &lt;on_poweroff&gt;destroy&lt;/on_poweroff&gt;
718 &lt;on_reboot&gt;restart&lt;/on_reboot&gt;
719 &lt;on_crash&gt;destroy&lt;/on_crash&gt;
720 &lt;devices&gt;
721 &lt;emulator&gt;/usr/bin/qemu-system-x86_64&lt;/emulator&gt;
722 &lt;disk type='file' device='disk'&gt;
723 &lt;driver name='qemu' type='raw' cache='none'/&gt;
724 &lt;source file='/mnt/qemu/enea-nfv-access-guest-qemux86-64.ext4'/&gt;
725 &lt;target dev='vda' bus='virtio'/&gt;
726 &lt;/disk&gt;
727 &lt;interface type='bridge'&gt;
728 &lt;mac address='52:54:00:71:b1:b6'/&gt;
729 &lt;source bridge='ovsbr0'/&gt;
730 &lt;virtualport type='openvswitch'/&gt;
731 &lt;address type='pci' domain='0x0000' bus='0x00' slot='0x03' function='0x0'/&gt;
732 &lt;/interface&gt;
733 &lt;serial type='pty'&gt;
734 &lt;target port='0'/&gt;
735 &lt;/serial&gt;
736 &lt;console type='pty'&gt;
737 &lt;target type='serial' port='0'/&gt;
738 &lt;/console&gt;
739 &lt;/devices&gt;
740&lt;/domain&gt;</programlisting>
741 </section>
742 </section>
743 </section>
744</chapter>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.png b/doc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.png
deleted file mode 100755
index 5e1d009..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.svg b/doc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.svg
deleted file mode 100755
index f43ce97..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/edit_boot_params.svg
+++ /dev/null
@@ -1,213 +0,0 @@
1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!-- Created with Inkscape (http://www.inkscape.org/) -->
3
4<svg
5 xmlns:dc="http://purl.org/dc/elements/1.1/"
6 xmlns:cc="http://creativecommons.org/ns#"
7 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
8 xmlns:svg="http://www.w3.org/2000/svg"
9 xmlns="http://www.w3.org/2000/svg"
10 xmlns:xlink="http://www.w3.org/1999/xlink"
11 xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
12 xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
13 id="svg2985"
14 version="1.1"
15 inkscape:version="0.48.4 r9939"
16 width="802"
17 height="602"
18 sodipodi:docname="edit_boot_params.png">
19 <metadata
20 id="metadata2991">
21 <rdf:RDF>
22 <cc:Work
23 rdf:about="">
24 <dc:format>image/svg+xml</dc:format>
25 <dc:type
26 rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
27 <dc:title></dc:title>
28 </cc:Work>
29 </rdf:RDF>
30 </metadata>
31 <defs
32 id="defs2989" />
33 <sodipodi:namedview
34 pagecolor="#ffffff"
35 bordercolor="#666666"
36 borderopacity="1"
37 objecttolerance="10"
38 gridtolerance="10"
39 guidetolerance="10"
40 inkscape:pageopacity="0"
41 inkscape:pageshadow="2"
42 inkscape:window-width="640"
43 inkscape:window-height="480"
44 id="namedview2987"
45 showgrid="false"
46 inkscape:zoom="0.37780549"
47 inkscape:cx="401"
48 inkscape:cy="301"
49 inkscape:window-x="0"
50 inkscape:window-y="0"
51 inkscape:window-maximized="0"
52 inkscape:current-layer="svg2985" />
53 <image
54 width="802"
55 height="602"
56 xlink:href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAyIAAAJaCAYAAADTS/NGAAAABHNCSVQICAgIfAhkiAAAIABJREFU
57eJzt3V3Sq7jBLlD7VI8otxnmHlPG5XORcn80QUgg9PDjtapS6f1ihBAC6zHIfv/58+fz73//+wUA
58AJDwn//85/XX6/V6/etf/zq7LgAAwI/48+fP6/+dXQkAAOD3CCIAAECcIAIAAMQJIgAAQJwgAgAA
59xAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJ
60IgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIA
61AECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABA
62nCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwg
63AgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIA
64AMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADE
65CSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAki
66AABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxP11dgUAEj6fzz/+/X6///H377/nf6stP2r7
67c1vrV1qffkttvLV9p2UsrVtbDvBE7ogAjzcduJcCQGlAP3r700HnWv1Kete/k8/nE9+v+bHb077z
68Y13qe08+dgBLBBHg0UoD/rXXnrV9rmcaPvaYH/952KgtB3gyj2YBP+nsMHD29u9ImwE8iyACQFHp
69saGlOStTS68vzYNomYOxNoeid/sAnMOjWQCvazwSM50DsWeg3Lv+HrU5FNN/Ly1vnYNRe5xu7/Z7
709nfvunuXAzyNOyLAz6gNbte+hSqx/drfa6aD7O/A+4pq9bpqvdMhD+DpBBHgZ5x916PlK3uvHiJK
719rbpdJ/nf7+SI0LIXQMYwCiCCMDE6LsiT3XkAP1qYcydEIAxzBEBuJCz79rwT1tCyBm/cwJwZ4II
728GhnD+zP3n6v+byT6d9KtgzI7zp43/qDk62/G+LuC/BLPJoFPN7SPITWgd4RcxjWtl8b0Na2P/37
73qK+nnT6uVprg31q/retP110qJzXHpCV4rH35wFqQqy0HeCpBBPgJW76hammgeNXtpwate+vQUr/e
7412ydBL41RB7BRHWA/+XRLAAAIE4QAQAA4gQRAAAgThABAADiBBEAACBOEAEAAOIEEQAAIE4QAQAA
754gQRAAAgThABAADiBBEAACBOEAEAAOIEEQAAIE4QAQAA4gQRAAAgThABAADiBBEAACBOEAEAAOIE
76EQAAIE4QAQAA4gQRAAAgThABAADiBBEAACBOEAEAAOIEEQAAIE4QAQAA4gQRAAAgThABAADiBBEA
77ACBOEAEAAOIEEQAAIO6vsyvwaz6fz9lVAAB4pPf7fXYV2EAQOYkTBQDgGD7ovSePZgEAAHGCCAAA
78ECeIAAAAcYIIAAAQJ4gAAABxgggAABAniAAAAHGCCAAAECeIAAAAcYIIAAAQJ4jwUz6fz+vz+Zxd
79DYA41z/gav46uwJkfT6f1/v9Prsal/J9Y562y/Rva2/c0+Wl9bfW5ReOT619Ssunx2JkO/Ucv68t
806y71se/6e+vya45o+9Ft/CvnN0Ard0R+iE/C1pXaZzpweL/fwwYS3+0//Tj1DKyvPojbU79pe0z7
8117ydnt4veu3tG6k+1XL83LEAfo0gws9oGQC3DgKOHrwYdP6fs+8ApLc/MtzC19nnFcASQYSfcfSA
8276iy5gOEJ4cRg6F9ntwn+D8jQ6nAC1yROSI3sfYMeW35fFnp0/f5fIi18lvmU2xdf15G6/6dIf2s
83d8/xTyw/ylpQWRuEb5lj0bKNtbkp8/L31O9OA8I95/d0eW39Pef/6Mcja9vfsrx2/W3ddmv7l9oQ
844IrcEbmB2jPkLc+Yr81zmL5+af21so9Yv7bftf07Sku5ZzzD3Xv8Ry9PaA0PI+rXUn5t4Lelblcb
85RNbO7y1zXLYcn97rxx4jzo/a9Xf691KdvuW1bP9q/QdgjTsiN3X1N5m99Ttrjsa03LU6jBwIbSmz
86tv+97TO6/CW1T4pH9/kt2yl9Yp2sw55y5866jpS269EzgN8iiNzAd3Bcezxh5Jt4b9kt63/3c+kR
87hJb9Txqx7dqjHr3WBqNr7XvF9l8y8lPy3v3fcgdwdN+6qtL5/3oJKABPJYjcxFLomM9TGDXYKD1j
88n1p/uu60zFHzNGp3Re5qra1q7Tu6/Y8YhPes2/Jo1fz1rfvf0v89TlN2xPUDgGsyRwQ6rT2zzT8Z
89TP6vlv6iTwHwRILIDeyZIF1b54xJ13vdoa6lCbqj9B7f6fKz+8qINpvWeXpslrZV2/5Z/e/qfZ79
907nBNA0gQRG5gPpCaD5xqy5fKWVo+LWOt/NIdgPl/l+q/9VPx1v0bpbZ/X6XHmHr1Hv/Ry3v2Z+vr
91l45FS/16HmHc2j61+pX2f1r+WjlXU2uf1vOntfy19uvZznQb0+2mrr9761/qfwB3YI7ITRz1LUZ7
92yym9qbZuu3X90mB+5CBsqey9A9c99axtv6Xcs5dv1dt/ti5fe01i+z3nzxUCSK0/bpl/tLa89fxv
93OWe2SJ0fe9tpS3sII8CduCMCADflTghwZ4IIhzzSAEBebQ4UwJV5NAtvWgA35hoO3JU7IgAAQJwg
94AgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIA
95AMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADE
96/XV2BbiPz+fz93+/3+8Ta9Lvuy/v93vTfq299grt8/l8Frc9rdvX93XTttiyne86yf0u7d/S6771
976a3fUtvtLevpWo9PSzmv13nn2J5zYrre1nXXzs8rWdq/K1z37iDRTrXzb+/52dI/e/u+vvO73BGh
98WesAsDRwu4r5hW/LBbD02nmZZ7RBaZvTun3/N//72vo1qTeQs+o3bbOlf/NfiT5/9XbvGeSVzs+t
99ZY08Dkv7d/VjchWJD2l6ltfWW+ufV3j/474EEehUCjZXuRgfPXC++idYV68f684+funtC7bcWe/7
10039XeL8kTRDjU1d9Uzx7kXJU3A7i/q19/AebMEeEwpWdEa8/rl27rrs1hGBUoWueAHG2+3aU2q7Xf
101vKwRA5Ja2bU+MNW6fMv+7anf2nHdMh/l+/q1/loqt1ZGzxyClvkyqeOzpa6lZWvrrdWvZU5Uy9yU
102efl76jfy3JyXf9R8qZbr357+dUT9jui/o86PFkec3/N/t56ftffXb7tM55cc3X+XtsHvcEeEw5Qu
103INML3p5noOevH31Xo+UZ2JK9z3V/y14ahNbab+schpHtt1S/2jPGLXNYjpqjUep/020f1S6l8ufL
104ase/dw5Brf+MPj7fAcbS/1q1hoc97bNl2y3HcMmWuu09P/def1uOz5Y67ek/a/WrOaL/1tqnp/wj
1056r92fGrn3xHXz2mdtn4gADXuiHAL009Mvv8etZ250dtMGvVp9RUcNYA7oo2uLnkMW7dVuxsxus57
106Bttb1zuyDkdp/XBla7sc8bq97l7+WdtaMw8jR9dr+h5/lX0mQxCBA135Anr1IHEFPW30fSOd3tWY
107l3tE3Vg2qn3mH4JM/96qpW7Oz2s64vi3uMv5vRYY9F32EES4hemb9J0/NTlrsNG73asPko6o36h9
108LD1qtdVV275mbX9Lj8nsMfLYL92lab0GtRz/M8+vluPz63qO/95tTLe1dZ2rajnP7vz+zj6CCD/l
109Fy90LYOcqweN0X59/0fSpuvO7nuOz7WdfXzO7p88n8nqXN78Qnj0ZNRea5MXz9IyGXjPZMqrmO7f
1100+/2LNk62TttS/1GtP/SfLLSHLPa9s9q6ysf316j2/TI8s84/r3bbJlUftQ+Hf3+d7X3d8ZzR4Rm
1110wvD0h2F2vKSpYnoI+9azMuvXfBKzwhP69cymb60rFT+kulrauWsHZ+Weu2xVL/aM9atz2Af8YUF
112a+231D5r8z2O6t+149/7jHrtvLzS8VlSO/9a6jc9jlvrtbd9SvUrXd96B14t19+1/l9S27+918/R
1139dvaf0eXXzo+R81BqZ1/peVHXH963v9AEKFZ7QKytnzpotj676Vyey9mW8tv2d5R7bP2xr5nGz31
114alme2kbpdb31O7Lu87t2pTLW/l0KRHsljt/W121dZ2QfPaN/164/exyxH3vWO+r6ueV1W9frOT5H
115lF97TaoPtJ4De0LRUdeQra/l/gQRHq/lE7sz+aTotzn+wFW4HpFmjgic7HvBrz3DPv9vnqF2/KHH
1161a8fV6/f032vO64/nMUdEbiAxG17rssxZpSr962r1+/ptD9nE0R4PBdaAIDr8WgWAAAQJ4gAAABx
117Hs26mdpkstpk57npRNnSsqVyjvoO+KSr169F7fdbever9tste3/b5Yj+tWU7zg8AuD53RG6k9o0i
118LV9TO//fdL3S3+evWdpWbfkVXGHwt/bDUS3rLjlqv3r7V229nv61ZTt7l//6+QEAaYLITYwaJL5e
119r38MrtbKnv9Y2/fvteWw5oj+4/wAgPvxaNZN1AYvBjf3kLor82vfB+/8AID7EUS4hNoz+PPlS8ve
1207/eu5/DX5g1MyyyV37r90rLW8tfqu2V56fWl9VuXl/bpu1/T+SW/EpAAgDKPZv2QpV9QLb3u9apP
121uF1bd2u9vtsrPYNfW/b9W+k1PWrlt26/NPhuKX+67tqjQqVQUPpfS/lbtl8y3aeWvneGq54fAPBU
1227oj8gNKAae0bmO7+ifXZ9T9z+/Ntn90WX/MwcrV6TT39/ACAKxBE+FvLIKs2AOsZoF31k/K7udIg
123f8nSo1rTZVd19vkBAE8jiPB6va7xSW/r40ZCSdnSIL/ldzLu4qx+eoXzAwCeRhDBIOvhzj6ud+9f
124d68/AFyVyeo/YO+P6JXuRGz93YRknX/FWvscceeoZcL2iC8DmP5/8quO73Z+AMATuCNyEz1fsTp9
125XGdq7etl5+ZlLD3bv7Z8Ta1+S2VPHz+arrc2P6L0utL2a2Ustf2e7bcqtfGRgWDPMa61X0v/a+k/
126W76t6knnBwA8lSByE72TYHsm2B5VhyPLng9ie7fROuhcKmPE9mtf9XtUnbau11qv1q8uPmLbvev2
127ln1UHQDg13g0C2Z8at1H+wEALdwR4ect3f2YDqJ7H6l6ulr7AQAsEUT4eR6p6aN9AIA9PJoFAADE
128CSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAki
129AABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAA
130QJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECc
131IAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCAC
132AADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAA
133xAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJ
134IgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIA
135AECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABA
136nCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwg
137AgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIA
138AMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADE
139CSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAki
140AABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAA
141QJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECc
142IAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCAC
143AADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAA
144xAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJ
145IgAAQJwgAgAAxAkiAABA3F9nV+BXfT6fs6sAAACnEUTC3u/32VUAAIDTeTQLAACIE0QAAIA4QQQA
146AIgTRAAAgDhBBAAAiBNEAACAOEEEAACIE0QAAIA4QQQAAIgTRAAAgDhBBAAAiBNEAACAOEEEAACI
147E0QAAIA4QQQAAIgTRAAAgDhBBAAAiBNEAACAOEEEAACIE0QAAIA4QQQAAIgTRAAAgDhBBAAAiBNE
148AACAOEEEAACIE0QAAIA4QQQAAIgTRAAAgDhBBAAAiBNEAACAuL/OrgDn+3w+r9fr9Xq/36t/e6rv
149vi650/5P92NLvfeux3a9bf35fByjG+s9fiPO1dL1b6n8pfpvWb+1HqP6uPMHrscdEf72fSNYG5h/
150Pp/V5S3b6Fl/hOkb0/v9vu0bVUu9l9r/rvt7R7W2Xjs/Ws6bs8+vs7d/ZUe0y5nnaun9oXT93Lq/
151e69frfRLuCZBBBYYnAO/Yh4m5uZ3yA3qgaN4NIt/qL3B9A7Q7zTAv1NdW7Xu0y89mncldz+/zt4+
1522y0ds7XHdN/v9993JtLHW/+C5xFEaFZ6hnf6RrX2nG9t/XkZ80/fav8urb/V/A22pfza405LAW9t
153/aUyerU+g92yf7Uy1ra9tP7a8pb+Nbr8mpb2qYX81n0r9e+e8/OIc6j13C+9prXs+fpbrhdLdezt
154X63lz8vaen79+l2Ivf3rqPYHxvBoFn+bfuK1trz09+8AvvQG0DN5cY89629ZZ/7GWNr36Rvf0mtq
155y4/S+gz2/LW99evd/1r/Gl1+7/4tbWvJ2vnVMo9p7/k5r//eIF96/ej+01qv0v739q+W8teO31H9
1565wqmcziOruve/nVE+wPjuCPCP5z9RndG+Jiaf6p5dPnT7WxZXtruiOOV6ANb93/r8iu5yyAyqbct
157rt6WR9bvKv2n5do3HcSf8ejWvB5nrQ+0E0S4jG8IqIWBUetPy9lafu/2pp8kLtUj+cZYGkDs3ceW
158/TvClkefRvAJ6rLe45/qP2e7ev9ZuotwBfoX3JsgAp1Kz6RvsXQH5IxPFKdvyvNt99QlsX9n30Ux
159cCnrPf5XOT9GetK+pOlfcF/miEDBlT71A6hZ+mQf4MoEEViQeIxnOhn2SoOHljs7W+q8Z/9626S2
160/ug2v3v5Rxp9LO/o7P75JL3XF20N5xJEaLb0LS6J9UsTII9685jXa2u5tfrNl8//Xlu+dz9al9f2
161t7d+vftfq2uqfY/av9K+bNnPpfofdX7tVdp+uv+sXR9q2x/RP5f2Y0v5rf3n+9o9/brn2l66fqau
162X639a2/7A2OZI8LiBbf1b6VlW9ZfmpRdK680kbu0/potcwv21G/rNvbau42WYzX6W2i29K2jy19a
163vnV/jzi+va/pOT+PmIjcewz3lr20fEtf713viGvNlec31a4PRwf6Pcv3zgXZuj5wPHdEAH6YR1MA
164OIsgAvDDlh79edInxHsf+QFgPI9mAfy4JwWPubMfewKgzB0RAAAgThABAADiBBEAACDOHBEuY+m7
1654feU8bRnvksTaO+2n/P9KP2OQ8+xXyv7rlp+m2L+2lLbltbbUpej2zZ53EZeH/Tvfbb89srSsp5t
166Pakd4a7cEeEyet8UWr7x5o5fVTr/zv61N+ermg6QS/Xv3Z+nDipKx39urf3WfoSv1aj+ljpuI88X
167/Xu/Wv+et+3ePtxyjIA8QQQYaulT+qcOqlJKg7Ula78kTT/9+3it4bt3G44TnM+jWfwUbzzX4Vj0
168WRr4ChfXoX/30X7wGwQRXq9X/RncteXzZ5dLj4FMl83L76lf6RGItU+NWz5R3lL/o55h3uOI+vUu
16971E7fkf0n5btL+1v6zZ6+89WyblQLefXiGf4j+qfrdeHUc7u30t12Fr+k/v3d3tzyeMDv8yjWVSf
170wd37jO7SG+6e53Nr25/fYi/dcq89W79W/lr9j3qGea/e+o06/lvqv3b8evtPy/an5e0NIXv7zxa9
171c5z2rFs7Pkf2jxH9s/X6MMrZ/bv3+Fytf+8JktMy14Lh6P0D/pc7Iiza+0bt4vxfowY6rZ/I9W6/
172tv7ZnwZu3X6pX37L+X7amfq0fG/5BkG/4ej+3Vv+VqP6997zc3o344h9P/v6B08iiHCY78V+fgv7
173KFcdfM0HsdO/j9jWXmuDlbX6J/dvlDvVtUXvQI9nedpxXdqf9CN1QIYgwm1c+Q1oXrfvwP1Kdd5y
174B2Ve/zvsX4/5c+BP2jfaGexek+MCz2WOCAT1PuP/JNqBJ9O/jyGEwLMJIiy6+oC5Vr9k/a/eVkum
175dR7dlkvPfbdMSE0ev9fr9T93f+52TEt6J+MvuWOfnzqy/lfv31fc/hHuXn/gvzyaRXSOwNpk6/kb
176+dbt1yYc95ZfsmX93jZbemSotrz3+B5x/JfKaD1+tf2bLmt53dFq7dNbr5b1174JaKmOe9qmVMbo
17768NR/bP1+nBE22zZ/uj+Pfr6lujf89dttbaN0fsHrBNEeL1efd+SNL+or71+7zc9bXnTHFH+0qBi
178y/o9eo7NUWWkvmmmJ7wdOYF7z7fy7FnWW/bRr9lbxuh9PKp/XvE4je7fvevW1j/72I/ehuABY3k0
179CwAAiBNEGG7Ls9MAAPwGj2YxnFvbAADMuSMCAADECSIAAECcIAIAAMSZIwITa78DMHLdO1v7AoK1
180Hwdc+z2UpeWtdRnZ9nc/xqPr31v+1X+n4ezjf4f2GX3+rV03Uuf+dFul6998+bRu07/V1oenc0cE
181JkZ/V/8TftF4bv47Mms/FDddvvRtaqXlLRLtWjvGVz++owc3Pe1z5Xb7OnNwePX2GV2/Mwfsa9en
1820vWvtT1614e7E0SAw20ZHJTe0AHO5voEY3k0C4J+6Q0s8UvVV3PHOidpH55CX4ZjCCK8Xq/+5/Nr
183cwDWls+f8Z1/AlVbXqt/6Xnc2hyFo5W23VK/ljkWrduer9/aPlu2Nf/08PtIzvfvR76Jz/etpX/s
184qUOtf2ztW1vqd3b/3jPHZ62MtX0bcfzObL/e87vWPlv+vbT93vN/9PFrKX/ptUef/1e15/1xunxL
185/1j6N/TyaBav12v9+f2a2hyAljkCa+W2LF8re/q3ljkKo5TKrtVvb/t91dZvaZ9WLRM3jw5883kp
18683/3tt+8jLV61Nbde3zP7N9b5/iUrPX/0cfvzPbrPb9r7dO7/d7zf/Tx27r/R18/t5he3/aea0e9
187F23pX99/j24fWOKOCEPsvYj2hpOeba7VuTbAfpq9+zX/VG2pzPndkasbEVJrZfVuqzQQHOGMT0iT
1882zrj+I929vZHGb1fa3fWjqhH7zVSeOCOBBFer9c1LmDfQWxpMLu2fHT9r/DGfYVj1KJlkH23MNJj
189ur/zv7e6wrE/qw5Pab+aO9Txzo5o39rdgjOvbbX3T/2LqxJEKD4Dehd3r3+rXxi0P9X82G0ZrFyl
190f5/Z/57QfjXO77F+vX1/ff+5LnNEgCGmzygfOd8E4KquHnhHGjEHkOcTRBjCBWmsq7fv1onE83V6
1919+1K7bOnLleq/5LR9ZuWf/W2GKG2z1dvk2T/GL3+E4PF1fsPv0UQoThBbs+FeulbP2rLr1b/rz2D
192x7V195bd23619XsDwHz90rP8a/VfOgZb+0fp22CObr+vtXlK0//uPT9q/bt2/Hr799b6lcrfUs+1
1938nuPX/r6sPX4lPavtX229o+jjDp+tfJr+3TE9teuT73bL10/R70/jjx/pt+6Ba3MEeH1epXf9Pau
194v2X50oB06W+l5SP+vcdRbdDy7622bPvIso9+zd4yzt7Hnr6xtLx0fuwtv3f90X3g6Ponrw9HHp/W
1959untH3v3d9TxWyun5W/pa8uW7R/Zt1vfH2t1SLxfwpc7IgAAQJwgAgAAxAkiAABAnCACAADECSIA
196AECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABA
197nCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwg
198AgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIA
199AMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADE
200CSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIALPwcpVAAABlElEQVQAAMQJ
201IgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIA
202AECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABA
203nCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwg
204AgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIA
205AMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADE
206CSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAki
207AABAnCACAADECSIAAECcIAIAAMQJIgAAQJwgAgAAxAkiAABA3F+v1+v158+fs+sBAAD8kP8PqJM5
208YoCUyU4AAAAASUVORK5CYII=
209"
210 id="image2993"
211 x="0"
212 y="0" />
213</svg>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.png b/doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.png
deleted file mode 100644
index c28d643..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg b/doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg
deleted file mode 100644
index 319bf7e..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/select-linux-kernel-in-grub2-boot-loader-on-ubuntu-14.04.svg
+++ /dev/null
@@ -1,3 +0,0 @@
1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
3<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" preserveAspectRatio="xMidYMid meet" viewBox="0 0 640 640" width="640" height="640"><defs><path d="M0 93L640 93L640 547L0 547L0 93Z" id="b4lgbdl3I5"></path><clipPath id="clipbKzvApRlV"><use xlink:href="#b4lgbdl3I5" opacity="1"></use></clipPath></defs><g><g><g><g clip-path="url(#clipbKzvApRlV)" opacity="1"><image xlink:href="data:image/png;base64,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" x="0" y="0" width="640" height="454" transform="matrix(1 0 0 1 1.1368683772161603e-13 93.00000000000006)"></image></g></g></g></g></svg> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.png b/doc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.png
deleted file mode 100755
index 4c926e5..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.svg b/doc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.svg
deleted file mode 100755
index f888174..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/images/virtual_network_functions.svg
+++ /dev/null
@@ -1,1569 +0,0 @@
1<?xml version="1.0" encoding="UTF-8" standalone="no"?>
2<!-- Created with Inkscape (http://www.inkscape.org/) -->
3
4<svg
5 xmlns:dc="http://purl.org/dc/elements/1.1/"
6 xmlns:cc="http://creativecommons.org/ns#"
7 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
8 xmlns:svg="http://www.w3.org/2000/svg"
9 xmlns="http://www.w3.org/2000/svg"
10 xmlns:xlink="http://www.w3.org/1999/xlink"
11 xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
12 xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
13 id="svg2985"
14 version="1.1"
15 inkscape:version="0.48.4 r9939"
16 width="559"
17 height="501"
18 sodipodi:docname="virtual_network_functions.png">
19 <metadata
20 id="metadata2991">
21 <rdf:RDF>
22 <cc:Work
23 rdf:about="">
24 <dc:format>image/svg+xml</dc:format>
25 <dc:type
26 rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
27 <dc:title></dc:title>
28 </cc:Work>
29 </rdf:RDF>
30 </metadata>
31 <defs
32 id="defs2989" />
33 <sodipodi:namedview
34 pagecolor="#ffffff"
35 bordercolor="#666666"
36 borderopacity="1"
37 objecttolerance="10"
38 gridtolerance="10"
39 guidetolerance="10"
40 inkscape:pageopacity="0"
41 inkscape:pageshadow="2"
42 inkscape:window-width="640"
43 inkscape:window-height="480"
44 id="namedview2987"
45 showgrid="false"
46 showborder="false"
47 inkscape:showpageshadow="false"
48 fit-margin-top="0"
49 fit-margin-left="0"
50 fit-margin-right="0"
51 fit-margin-bottom="0"
52 inkscape:zoom="0.47105788"
53 inkscape:cx="279.5"
54 inkscape:cy="250.5"
55 inkscape:window-x="0"
56 inkscape:window-y="0"
57 inkscape:window-maximized="0"
58 inkscape:current-layer="svg2985" />
59 <image
60 width="559"
61 height="501"
62 xlink:href="data:image/png;base64,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
1266xbU8dD+LF94dJBIQBEyFY72R7C+eHEn18xP8ciBHE8dyvONp4a5bccE3796TvWcHS+4GArqpwWa
127S+f44eUPezNsGC4wXnS5sjcF+AXPnvZHid51RjN335Lh608O42iqdUWu1lhK8b/PbWNWIugXglsG
128rbEAQUNxw/JGbtoyzq3bJpiTCnLD8kbeVinATgQMgoZirCBPyRZC/Pk4qfAStgyunpfiq08M8dUn
129hih7mqvnHft3IrkemAb85+V+EeaH7j3AoaxNKmQec/kjmQrqIybrh/L0Tdp0p4JMllyG8g5NEYuA
130obivP8f2sRLjJZeP3XMAKoWyd++e5K9XNRMyFVpTDT9/SsHRLG6K8K7Tm/jUQ4cIGopVlaktXSlc
131ff/qlhM+hiMtbQzzsy0T7J0o86blDYQtg2XNYX6yZZw7dqZZ2hQmGTKZkwoSDxrcuGGMi7oSNEX9
132j2njcIFbt00wty5EZyJAyfWIBky+f3UXIdPgA/ccYDBr0xjxl9dAzna5fG6CL186i7GCwz17J/mH
133hw9y7qwYvfWho9pYdjVzkkHedYwC57qQSdnVrB8qcGG3PyrUN1lCa01gWh8XHI/VHTFevaiebz87
134Uh1lCJkGixvD/LEvy/rBPCtb/b59fCDHvz0zwusX1/PSuSf2O7amwtKypjBF2+N7G8ZY0hSpjuj8
135fs8k9/VleEl3gkTQxPH86cmWqMXHzm7jNbfvwXY1i5vCxCzFVx4f5Jfb03z3yi4+vLYVgJ9uGeNt
136v+nj9h0TLGlqq/bp1MjPlJWtUdZ2RLljRxrTgJWtEU5vmxpd9BtadPy7qt56WiNfenyQkGlUp6M8
137/HPrzcsbqyM6033jpbP5q1VN3L49zcMHcnz6oYMYCj64phVlnExEF0KIF4eTrvB7xYIUN24c5aED
138OS6cHa/WdByLAtpiAU5rifDvV3Txilt285d39XHb9b0nFAAW1If49voR3nLnPla1RelLl9kyUuTD
139a1oAuGvXJAETvnJJJ82VC/wj/Tm+v3GUJw7muGBWnGjA4PGBPB+8px+oXEq05rVL6qsFllO8yoXm
140tUvq+eGmcbaMFKrvGcr/hv7+PxygPnw4HHha867Tm1jY+KdHk05v9adLJooOqyoX7hWtUWIBxd50
141mTdXRkPm1Yd449IGPv/oINfdups1nTG01vx29yRbR0t86/JZhCsjDobya0zmNYT518tnc+0tu3nP
1427/bzs+t6CJoK14PZCb8epiFi8f7VLbzzN338wyMH+Y8ruo8Kdgp/qsbx9IxaD/CnvuJBky89PsSe
143dBkD+OWONLOTQRY1him7/uiHW5n+e8tpDfxyxwRDOQevkjbeeloj9+7L8prb9nJlbxJTwd17Mmwa
144KbC6PcpL/2QvUu37gq05oz3G1fNS/PszI+ybLLOoMUzR8bh9R5psyeN1SxswKiNUWkPB9ThvdpyL
145uhLcsm0crf16nGVNET75wEH+4pd7eGlPEsuAR/tzaA29dYcDRSJo4HiQLh4e6UmFTK5dWMfH/ziA
14668Fnz2+sniNT3Mrxv3FZAz99bpzdE6WjjiddOnr0ZP1ggX9/ZoTXLK7jY2e38ce+DI8N5ChUpiSz
147ZY+i6492CSHEn4uTDi9z60KsaImw5WCeS7oTBKfVehQcj0zZReN/g58sudX6j7l1Id69qol3/aaP
148f3zkEJ+7sONwwaT2/xE+cuj/1Yvr2TRS5JatE9y3e5JA0ODK3iRvWdHIUM7h9u1pVrT4tzJPObM9
149yo82jfHTLeMsawrjac0zg3meOZT3F6jMcSxtjlTDiz9C4VXDS2sswFtOa+A9v9tfnbpxPM1E0eV7
150G8YOf+330wtXzE3MCC+u1mTKLuWp2piK7lSQsKnwNCyqTMX01AVpjlpsGSmxuLINy1B87Ow2DAU/
1512jTGQ49mwFAsb4nw1Us7edsKvzC16HhMll3ylX5b2RrlrSsa+dT9A3yrK85rFzeQs73KVJPv+kX1
152/Py5CW58ZpQLZid4y2mN1fem+sHVx/4uv6AhxMfObuWfHh/k648PATC/KcRH1rbSHLUYyNhkyi6F
153yme+tDnCaxbV8/mHD1Y/20vnJPjGZbP44mOH+NoTQ+BpuhpCfPb8dt66oumofRYcj2zZm1H/VHI1
154mZJLyfUIW4ovXNxJLGjwi21p7tw2gWEZrOmI8t6LOriiMpJTrJybdqUr3nV6E7/ZNcl40SVna67o
155TfL5izr4xlPDfOWxQQBm1wX50JoWrptWjzOvPkRjxGI478xo5wWz48QCJrbrVe8Om+rTbNkjHFDV
156c+CNyxr423v7q+fW1PG4xyjy6ogHcDyPN/96H+CXW13ek6xOG40VXCIBVb3DTggh/hyo++67T69Y
157sYL6+uM/T+JIB7I220aLrO6IkZhWeLkrXWYk77CmPcpIwWXrWJEz2qJEKt/uXfxvswFDsWbaw9EA
158nhrMUxe26D3Gw7aeHiqQKblELINVbREspSh6msf7c8xJBelOBo9a3vU0p7dG2TxSIF1yq/UFAGhY
1592hymftroz7PD/ijLiubDxcQP9+doilosrA8xWnTZPFI8qthVazijPUJ0WoizNaw7mGNufYjWyMx8
160uGG4QM72OHvaqM/28RIHszZrOmYWcgL0ZWz2pEtYSrGwMUzTtFqL/Rmb/Zkyq9tjTNUWF1zNEwM5
1616sImK5ojPHEoT2PYorfucB8N5Gw2jxSZkwoyv27mNMX64QKmUix/nrqk/RmbPekyAHPrgsyKH655
162euJQnlTIZGFl+sPR8PCB7FGfU8b22DBUwPY0Xckgc4/zkLXd6TJjRYczWw+fLwM5mz0TZc5qj86o
163v9lW6cewZbC8OUzMOvyZ7J0s05+xOXdaYe+zwwVKrmZ12+Ft78/621bArGSAnuTR7bri5p20xwJ8
16476ruGa8/NZjH9WD1Eef204MFgqZi2bQ+ffBAlvZ4kHl1QQbzDjvGSqzumHk80z07XGAw5xALGJzT
165GatOFX324UPctXuS+14/b0bRuBBCvBiNj4+zYcOGkw8vzx3M43maaMAgZ3vVqQLwb+8MGIrJkkfQ
166VEQsg6ztVm95tiq3C7uVkZapu5MM/NtYHa3J2zNHXyxDEbUMDMN/wm7B1pQ9D1MpEkGTsufNWMdQ
167/j40/m2v0YBRKbqd/q1WkXcOt11V9g9URyn8tprYniZnu4RMo/IE1SO/HStytjvjTimzcltu0dGU
168pvXP1H4MNXWHlb9OLGASMBW58sztGEoRsRQBw99vydUUHV3tt4hlEKwUwE59aw+aBtGA/4C8guP5
169/erN7NeI5d8yXHRmjnZNtW9qtODoY/WXiQQUQcPvr7LnUbD9NhmV43Y9v9YG/MLreNA8al9+fypQ
170Ctv126ePsb9owMBS/jFOjYyFLYOwqcjaXvXcMpUiEvDrSLTWR/V91DIImKra7wpFIugXjGSnvTb9
1712OxKobk3bUREobhjZ5r9k2XesbKxOno4deyKmZ/t1H48IHvEuTV17oZN//OY/ndlOlMp/zyuHFve
1729qrnyY83jeNqzQ2nNc5opxBC1ArHha6GEG0n8KTwqfBy0tNG920bZ/94ufp0WyH+3MSCBosiJr/Z
173MPZCN4W2oH+L/G3PjLzQTRFCiP+WXNnlquWNtKaCJ3wDwkmHl3DAIBo0TvgOHiFebKZuf46cAkWy
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
133586RSKa664jKCwaDaWlK8Y/C2jXzk5+XRd/wEr+59nWuuvBxdEwT8/rQw7wkPR5pbeH3/ARzHZcO6
1336tSxpauD5F7fTPzCApmk88viT1NfWMjg8QnVVBZs2rKe5pZXXD7zB+jWrWb50CTtfepmx8XGuftfl
1337aJpg955XaO/sRBMa9XW1bN64gUDAz9GODva+to8Vy5cyMT6JRFJeVpbVuOiawZ5X9tLWfpRlS5ey
1338fu3qrECl6zq93T0MDA6xfs0qunv76OrppbqqylvM6DrH+wd4+dXXGBsbIxwOc/W7LqOoqIjmllb2
1339HXiDWCxORUU5V11+GS4uu156mY7OTnLCOVx80YVUV1XOKkfDMOjt7WPXnpeZmJikoaGOLZs3IYDn
1340X9xOMplkSVMjh4+0sGH9GnRd9zRCKYtIbg6XX3oJPtNk63PPE0/EcUddfvnAQ2zasJ7xiQkCPn/6
13413TWOtnew9/X9JJNJ8vIiXHzhZsrLyxifmOCZ519E1zSKi713CQYCXHThZkpLS5QAo1DbRmeClJJI
1342bg7hcIhjXd08+fSztLd3khMOkxfJZXR0lIcefYKBwUHqamtoa+/ghe070TTBa6/v58mtzyKlpLKi
1343HF3XiccTdB47Rm9fXzb9rp5eOo91IaUkFovTeayLV/e+zo5dL3Gif4CRsVH2v3GQgcEhCvLzCQYD
1344CAEFBXmUlZQwNDzC/oMHSSQSxOIxDh9pRghBMBBQe86KdxyO41BaUsySpiZe33+AjmPdmMa0gaih
13456xw8fIQntz5LOByioCCfZ194kaPtHRQXF+HzedqHwsJC8vPz6O3r42h7B47j0NbewZEjLfT0HSdl
1346WRw6fAQrlUIIweNPPsMre1+jpLiY/Pw8du95medf3IYQgmg0RkfnMfa88ho797xMf/9ANj8+0+RY
1347Vzcv7thJLJ6gqb4eIcR03xSCto5OdE1j3bo15OVF6Ow8RjKZxDAM+gcHeejRx+np7aW8vIycnDCu
1348K2lpbeORx58iGotTVVmO3+cjmUry/IvbeW3ffqqrKkkkEzzx1FbGxyfQtWlNyMDAIA899jjRaJTq
13496kr2HzjE7j0vI4Sgf2CQIy2tvLBtB4eamxmfmORE/wAF+fnU19dyon+Arc89T9JKUVhYiK7r+EyT
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
13806erq4dEnnuKKSy+hsqKcYDBI57Eurr36SsrLStF0jWMd3Vx68RZMw6CyopxlS5dw4OBhr587Dr29
1381faxfu4aSokJ6e/tm9VuY1nDous6FmzfSd7yfp555jnAoRGNDPRIYHR2jpaWVUDDIrTd728uO4/DQ
1382o4+z78AbdPf0sXr1StraO3j2hW0cbe/AlZJLL9rCxvXreOLpZ3jksScoLSnBH/Bz8YWbWNrUxJHm
1383Vp7ftp1AIABIrrrichzbIZGI49gOTY0N7D94kL2v72doeCS9TVRJUVEhKcsikdGiSEk4HCYnHOZo
1384RyfJVIq+EydIWTaO42R92HR2HuPRx59m2bIl2LZNMpHE5/ezfu1qntr6LA8/+gSFhQV0dfdQVlrK
1385iqVLsB2HZCqFrk/btqRSVla7pFDoH//4x79WXu510LfCP782xMCkBboAV7A04nJ9iU3SPf/UeZmj
1386icPDIySTSWzbobiokBuuuZri4kKCwQB1tbVEo3GisSiO67C0qZGCgnwqy8uJ5OYSjUVJJlNUVpRT
1387V1tDSXExlm1jWSlWLFtCUVEhkUiEutoaXNfFtm2qqyspKS4CIUikO3N9bQ1FhYUUFhQgNA3LsijI
1388z6eqsgKBZyhXUlzMxvVrEEI7rweAgA77JnR2Dhkwn0sLKbixzKYx5JI6D9v1YiRzfDeR8LYiqqsq
1389EUIQCoXIyclB0wQ1VV6/qayoID8/z1v1x+LkhHNYtrQJ0+ejsKAge2y6pLiIstISkpaFz2eycsVy
1390CgsKSCaThMM5rFy5nEgkgqZp1NfWoOs6Y+PjgODCzRvZvHEDmhDEEwkkktrqaooKCwCwUha2Y1NR
1391Xk5TQwMF+Z6ti+04VJSXYRgGY2PjxONxli9bQk11FY7jIKXEl7aJy8uLsLSxgcrKcpLJFLF4nFAo
1392xJLGBqqrqigqKCAai5FIemXS2FBHY309ABOTk8TjCaorK6mpriIaixPw+6mvq6GyspLKigomJiaz
1393214rli0lFAoRjcXIi0Soq63FMA1C4SC5OTmMjo9TWFBAfV0toVCQurpaIpFc8vIi2LaFRFJRVoam
1394a5QUF1NdVUlZWQnFRUWMT0yQSCSprani2quvpCA/n1QqRSKRoKiwkJrqKnRNJxqLEsnNpb6uFr/f
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
1565"
1566 id="image2993"
1567 x="0"
1568 y="0" />
1569</svg>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/ostree.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/ostree.xml
deleted file mode 100644
index 56bdda9..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/ostree.xml
+++ /dev/null
@@ -1,209 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="ostree">
5 <title>Software Update</title>
6
7 <para>Enea's Software Update solution is based on OSTree.</para>
8 <para>OSTree is an upgrade system for Linux-based operating systems that
9 performs atomic upgrades of complete filesystem trees. The underlying
10 architecture might be summarized as "git for operating system binaries". It
11 operates in userspace, and will work on top of any Linux filesystem. At its
12 core is a git-like content-addressed object store with branches (or "refs")
13 to track meaningful filesystem trees within the store. Similarly, one can
14 check out or commit to these branches.</para>
15
16 <para>For in-depth information on how OSTree works, consult the OSTree User
17 Manual, <ulink
18 url="https://ostree.readthedocs.io/en/latest/manual/introduction">ostree.readthedocs</ulink>.
19 The set of OSTree commands can be found at the following OSTree <ulink
20 url="https://www.mankier.com/package/ostree">man page.</ulink></para>
21
22 <section id="installing_system_upgrades">
23 <title>Installing system upgrades</title>
24
25 <para>OSTree works by downloading system updates from remote servers,
26 which have to be set up before installing any system upgrades. There are
27 multiple ways through which system upgrades can be installed. Similarly to
28 git, one of the methods consists of pulling the branch related information
29 from the repository and checking out a commit ID. Another method, consists
30 of using a repository and a branch as the origin for future updates and
31 periodically pull the latest updates. Both of these techniques will be
32 detailed in the sections below.</para>
33
34 <section id="installing_by_commit_id">
35 <title>Installing a system upgrade by using a commit ID</title>
36
37 <para>To upgrade a system by using a commit ID, a remote repository has
38 to be added on the board running NFV Access:</para>
39
40 <para><emphasis role="bold">How to upgrade a system by using a commit
41 ID</emphasis></para>
42
43 <orderedlist>
44 <listitem>
45 <para>Add a remote repository on the board running NFV
46 Access:</para>
47
48 <programlisting>ostree remote add nfv-access-remote https://&lt;ostree-repository&gt;:&lt;port&gt;</programlisting>
49 </listitem>
50
51 <listitem>
52 <para>Pull the branch related information from the
53 repository:</para>
54
55 <programlisting>ostree pull nfv-access-remote &lt;branch-name&gt;</programlisting>
56 </listitem>
57
58 <listitem>
59
60 <para>Inspect the branch commits:</para>
61
62 <programlisting>ostree log &lt;branch-name&gt;</programlisting>
63
64 Inspecting the branch commits, outputs data in the following format:
65
66 <programlisting>commit &lt;COMMIT-ID&gt;
67ContentChecksum: &lt;CHECKSUM&gt;
68Date: &lt;COMMIT-DATE&gt;
69
70&lt;COMMIT-DESCRIPTION&gt;</programlisting>
71
72 <para>Example:</para>
73 <programlisting>ostree log nfv-access-latest
74commit 83e66d4376b415fca6a243ac4cf7704b8fceb0220621ff5aa59b4ee0715b9567
75ContentChecksum: dc5e7d46151acccae052751730e22062bd2d9ca6fa9990a622000e909e879467
76Date: 2018-12-20 16:04:22 +0000
77
78Commit example number 2
79
80commit 6e03344470b35385e584a79cd395ca90d134851b4cc512edeea5380f3cccc812
81ContentChecksum: 1d6a362491ecb25d5f56b9d6300463c0263bb68c8b50a368b1250c061225ba60
82Date: 2018-12-20 15:16:09 +0000
83
84Commit example number 1</programlisting>
85
86 </listitem>
87
88 <listitem>
89 <para>Specify the commit ID you wish to deploy</para>
90
91 <programlisting>ostree admin deploy &lt;COMMIT-ID&gt;</programlisting>
92 </listitem>
93 </orderedlist>
94
95 <note>
96 <para>Running <literal>ostree admin deploy</literal> will upgrade the
97 GRUB configuration to set the newly deployed commit as the default NFV
98 Access version.</para>
99 </note>
100 </section>
101
102 <section id="installing_by_update_channel">
103 <title>Installing a system upgrade by using an update channel</title>
104
105 <para>To upgrade a system by using an update channel, a remote
106 repository has to be configured as the origin for future updates:</para>
107
108 <programlisting>ostree admin set-origin nfv-access-remote \
109 https://&lt;ostree-repository&gt;:&lt;port&gt; &lt;branch-name&gt;</programlisting>
110
111 <para>Each time the remote branch is updated, the changes can be
112 deployed on a board with the <literal>ostree admin upgrade</literal>
113 command.</para>
114 </section>
115
116 <section id="removing_invalid_sys_upgrade">
117 <title>How to remove an invalid ostree version</title>
118
119 <orderedlist>
120 <listitem>
121 <para> Identify which commit is invalid by running <literal>ostree
122 admin status,</literal> which lists current commits. Example output:
123 </para>
124
125 <programlisting>ostree admin status
126 poky 210f327ab52730c33910f9a40108333b353b36adfadf44a7d7579d3f57d0.0 (pending)
127 origin refspec: 210f327ab52730c33910f9a40108333b353b36adfadf44a7d7579d3f57d0
128 * poky 884256bab349d7d4e1bfd603d70b59cae9143b4d7e996256246760815c12.0
129 origin refspec: 884256bab349d7d4e1bfd603d70b59cae9143b4d7e996256246760815c12
130 poky 8791932934bcfd33e2d3c0c9d2fbd63f90486cd62c5ddae40f8d2b94ba4a.0 (rollback)
131 origin refspec: my-remote:test-branch</programlisting>
132 </listitem>
133
134 <listitem>
135 <para>Undeploy the faulty commit by running <literal>ostree admin
136 undeploy &lt;commit number&gt;</literal>, where <literal>&lt;commit
137 number&gt;</literal>is the index of the commits listed in the
138 <literal>ostree admin status</literal> command.</para>
139
140 <programlisting>ostree undeploy 2</programlisting>
141 </listitem>
142
143 <listitem>
144 <para>Run the <literal>ostree admin status</literal> command to verify
145 the invalid version has been removed:</para>
146
147 <programlisting>ostree admin status
148 poky 210f327ab52730c33910f9a40108333b353b36adfadf44a7d7579d3f57d0.0 (pending)
149 origin refspec: 210f327ab52730c33910f9a40108333b353b36adfadf44a7d7579d3f57d0
150 * poky 884256bab349d7d4e1bfd603d70b59cae9143b4d7e996256246760815c12.0
151 origin refspec: 884256bab349d7d4e1bfd603d70b59cae9143b4d7e996256246760815c12</programlisting>
152 </listitem>
153 </orderedlist>
154 </section>
155 </section>
156
157 <section id="change_builtin_kernel_param">
158 <title>Changing built-in kernel parameters</title>
159
160 <para>Each time OSTree deploys or undeploys a commit, the GRUB
161 configuration file is generated automatically. System administrators can
162 change what kernel parameters are specified in the GRUB configuration
163 file, by editing <literal>/etc/enea-nfv-access/boot/00_default</literal>
164 or creating a file in the same folder, for example
165 <literal>/etc/enea-nfv-access/boot/10_custom</literal>.</para>
166
167 <para>When a GRUB configuration file is created, files in the
168 <literal>/etc/enea-nfv-access/boot/</literal> folder are evaluated in
169 alphanumeric order, making, for example, a file named
170 <literal><literal>10_custom</literal></literal> override settings set in
171 <literal><literal>00_default</literal></literal>.</para>
172
173 <para><emphasis role="bold">There are 3 keywords that can change the way
174 GRUB configurations are created:</emphasis></para>
175
176 <itemizedlist>
177 <listitem>
178 <para><literal>base_folder</literal>: specifies where boot specific
179 files are located, such as kernel binaries, initrd files or GRUB
180 configurations.</para>
181 </listitem>
182
183 <listitem>
184 <para><literal>machine_config</literal>: specifies machine-specific
185 kernel parameters. For example this keyword should specify what serial
186 port is used for kernel boot messages or how to initialize network
187 connections.</para>
188 </listitem>
189
190 <listitem>
191 <para><literal>extra_config</literal>: specifies what other kernel
192 parameters should be added to the command line. This keyword should be
193 followed by kernel parameters that are not specific to the machine
194 (e.g. number of hugepages).</para>
195 </listitem>
196 </itemizedlist>
197
198 <para>A keyword should always be followed by a <literal>space</literal>
199 character and the content that is associated with that keyword:
200 <literal>&lt;keyword&gt; &lt;content&gt;</literal>.</para>
201
202 <para>If a change has been done in the
203 <literal>/etc/enea-nfv-access/boot</literal> folder, the GRUB
204 configuration can be explicitly regenerated by running <literal>
205 /usr/lib/ostree/ostree-grub-generator -o /boot/loader/grub.cfg
206 </literal> or waiting until the
207 next OSTree version is deployed.</para>
208 </section>
209</chapter>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/overview.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/overview.xml
deleted file mode 100644
index 3439937..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/overview.xml
+++ /dev/null
@@ -1,153 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="overview">
5 <title>Overview</title>
6
7 <para>The Enea NFV Access Reference Guide seeks to provide further
8 information that will help users understand the high-level architecture
9 and features of the Enea NFV Access Platform. Focus is placed
10 on data-path and virtualization components.</para>
11
12 <section id="description">
13 <title>Enea NFV Access Description</title>
14
15 <para>Enea NFV Access is a lightweight virtualization software designed
16 for deployment on edge devices at customer premises. Streamlined for high
17 networking performance and minimal footprints for both host platform and
18 VNFs, it enables very high compute density.</para>
19
20 <para>Enea NFV Access also provides a foundation for vCPE agility and
21 innovation, reducing cost and complexity for computing at the network
22 edge. It supports multiple architectures and scales from small white box
23 edge devices up to high-end network servers. Thanks to the streamlined
24 footprint, Enea NFV Access can be deployed on systems as small as single
25 2-core ARM devices. It scales up to clustered 24 core x86 Xeon servers and
26 beyond, allowing multiple VNFs on the same machine, and eliminating the
27 need to use different virtualization software for different hardware
28 platforms, saving costs through single source provisioning.</para>
29
30 <para>Optimized virtual networking performance provides low virtualized
31 networking latency, high virtualized networking throughput (10 Gb wire
32 speed), and low processing overhead. It allows high compute density on
33 white box hardware, maintaining performance when moving functionality from
34 application specific appliances to software on standard hardware. The
35 optimized boot speed minimizes the time from reboot to active services,
36 improving availability.</para>
37
38 <para>Enea NFV Access provides virtualization using both containers and
39 virtual machines. Containers provide lightweight virtualization for a
40 smaller VNF footprint and a very short time interval from start to enabled
41 network services. VMs provide virtualization with secure VNF sandboxing
42 and is the preferred virtualization method for OPNFV compliance. Enea NFV
43 Access allows combinations of containers and VMs for highest possible user
44 adaptability.</para>
45
46 <para>Flexible interfaces for VNF lifecycle management and service
47 function chaining, are important to allow a smooth transition from
48 traditional network appliances to virtualized network functions in
49 existing networks, as they plug into a variety of interfaces. Enea NFV
50 Access supports VNF lifecycle management and service function chaining
51 through OpenStack, NETCONF, REST, CLI and Docker. It integrates a powerful
52 device management framework that enables full FCAPS functionality for
53 powerful management of the platform.</para>
54
55 <para>Building on open source, Enea NFV Access prevents vendor lock-in
56 thanks to its completely open standards and interfaces. Unlike proprietary
57 platforms that either do not allow decoupling of software from hardware,
58 or prevent NVF portability, Enea NFV Access includes optimized components
59 with open interfaces to allow full portability and
60 interoperability.</para>
61 </section>
62
63 <section id="components">
64 <title>Components</title>
65
66 <para>Enea NFV Access is built on highly optimized open source and
67 value-adding components that provide standard interfaces but with boosted
68 performance.</para>
69
70 <mediaobject>
71 <imageobject role="fo">
72 <imagedata align="center"
73 fileref="images/virtual_network_functions.svg" />
74 </imageobject>
75
76 <imageobject role="html">
77 <imagedata align="center"
78 fileref="images/virtual_network_functions.png" />
79 </imageobject>
80 </mediaobject>
81
82 <para>The Access Platform includes the following key components:</para>
83
84 <itemizedlist>
85 <listitem>
86 <para>Linux Kernel - Optimized Linux kernel with the focus on vCPE
87 systems characteristics.</para>
88 </listitem>
89
90 <listitem>
91 <para>KVM - Virtualization with virtual machines. KVM is the standard
92 virtualization engine for Linux based systems.</para>
93 </listitem>
94
95 <listitem>
96 <para>Docker - Docker provides a lightweight configuration using
97 containers. Docker is the standard platform for container
98 virtualization.</para>
99 </listitem>
100
101 <listitem>
102 <para>Virtual switching - Optimized OVS-DPDK provides high throughput
103 and low latency.</para>
104 </listitem>
105
106 <listitem>
107 <para>Edge Link - Edge Link provides interfaces to orchestration for
108 centralized VNF lifecycle management and service function
109 chaining:</para>
110
111 <orderedlist>
112 <listitem>
113 <para>NETCONF</para>
114 </listitem>
115
116 <listitem>
117 <para>Docker</para>
118 </listitem>
119
120 <listitem>
121 <para>REST</para>
122 </listitem>
123
124 <listitem>
125 <para>CLI</para>
126 </listitem>
127 </orderedlist>
128 </listitem>
129
130 <listitem>
131 <para>APT packet management - Feature rich repository of prebuilt open
132 source packages for extending and adapting the platform using APT
133 Package Management.</para>
134 </listitem>
135
136 <listitem>
137 <para>CLI based VNF management - CLI access over virsh and
138 libvirt.</para>
139 </listitem>
140
141 <listitem>
142 <para>FCAPS framework - The device management framework for managing
143 the platform is capable of providing full FCAPS functionality to
144 orchestration or network management systems.</para>
145 </listitem>
146
147 <listitem>
148 <para>Data plane - High performance data plane that includes the DPDK
149 optimized data plane driver.</para>
150 </listitem>
151 </itemizedlist>
152 </section>
153</chapter>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/ovs.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/ovs.xml
deleted file mode 100644
index fdbd692..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/ovs.xml
+++ /dev/null
@@ -1,161 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="ovs">
5 <title>Open Virtual Switch</title>
6
7 <para>Open vSwitch (OVS) is an open-source multilayer virtual switch
8 designed to be used in virtualized environments to forward traffic between
9 different VMs on the same host, and also between VMs and the physical
10 network.</para>
11
12 <para>Native OVS forwarding is handled by two major components: a user-space
13 daemon called <literal>ovs-vswitchd</literal> and a
14 <literal>fastpath</literal> kernel module used to accelerate the data path.
15 The fastpath kernel module will handle packets received on the NIC by simply
16 consulting a flow table with corresponding action rules (e.g to forward the
17 packet or modify its headers). If no matching entry is found in the flow
18 table, the packet is copied to the user-space and sent to the ovs-vswitchd
19 deamon which determines how it should be handled ("slowpath").</para>
20
21 <para>The packet is then passed back to the kernel module together with the
22 desired action and the flow table is updated, so that subsequent packets in
23 the same flow can be handled in fastpath without any user-space interaction.
24 In this way, OVS eliminates a lot of the context switching between
25 kernel-space and user-space, but the throughput is still limited by the
26 capacity of the Linux kernel stack.</para>
27
28 <section id="ovs-dpdk">
29 <title>OVS-DPDK</title>
30
31 <para>To improve performance, OVS supports integration with Intel DPDK
32 libraries to operate entirely in user-space (OVS-DPDK). DPDK Poll Mode
33 Drivers (PMDs) enable direct transfers of packets between the physical NIC
34 and user-space, thereby eliminating the overhead of interrupt handling and
35 Linux kernel network stack processing. OVS-DPDK provides DPDK-backed
36 vhost-user ports as the primary way to connect guests to this datapath.
37 The vhost-user interfaces are transparent to the guest.</para>
38 </section>
39
40 <section id="ovs-commands">
41 <title>OVS commands</title>
42
43 <para>OVS provides a rich set of command line management tools, most
44 importantly:</para>
45
46 <itemizedlist>
47 <listitem>
48 <para>ovs-vsctl: Used to manage and inspect switch configurations,
49 e.g. to create bridges and to add/remove ports.</para>
50 </listitem>
51
52 <listitem>
53 <para>ovs-ofctl: Used to configure and monitor flows.</para>
54 </listitem>
55 </itemizedlist>
56
57 <para>For more information about Open vSwitch, see <ulink
58 url="http://openvswitch.org">http://openvswitch.org</ulink>.</para>
59 </section>
60
61 <section id="config-ovs-dpdk">
62 <title>Configuring OVS-DPDK for improved performance</title>
63
64 <section id="dpdk-lcore-mask">
65 <title>dpdk-lcore-mask</title>
66
67 <para>Specifies the CPU core affinity for DPDK lcore threads. The lcore
68 threads are used for DPDK library tasks. For performance it is best to
69 set this to a single core on the system, and it should not overlap the
70 pmd-cpu-mask, as seen in the example below.</para>
71
72 <para>Example: To use core 1:</para>
73
74 <programlisting>ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x1</programlisting>
75 </section>
76
77 <section id="pmd-cpu-mask">
78 <title>pmd-cpu-mask</title>
79
80 <para>The DPDK PMD threads polling for incoming packets are CPU bound
81 and should be pinned to isolated cores for optimal performance.</para>
82
83 <para>If OVS-DPDK receives traffic on multiple ports, for example when
84 DPDK and vhost-user ports are used for bi-directional traffic, the
85 performance can be significantly improved by creating multiple PMD
86 threads and affinitizing them to separate cores in order to share the
87 workload, by each being responsible for an individual port. The cores
88 should not be hyperthreads on the same CPU.</para>
89
90 <para>The PMD core affinity is specified by setting an appropriate core
91 mask. Example: using cores 2 and 3:</para>
92
93 <programlisting>ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc</programlisting>
94 </section>
95 </section>
96
97 <section id="setup-ovs-dpdk">
98 <title>How to set up OVS-DPDK</title>
99
100 <para>The DPDK must be configured prior to setting up OVS-DPDK. See
101 <xref linkend="dpdk-setup"/> for DPDK setup instructions, then follow these steps:</para>
102
103 <orderedlist>
104 <listitem>
105 <para>Clean up the environment:</para>
106
107 <programlisting>killall ovsdb-server ovs-vswitchd
108rm -f /var/run/openvswitch/vhost-user*
109rm -f /etc/openvswitch/conf.db</programlisting>
110 </listitem>
111
112 <listitem>
113 <para>Start the ovsdb-server:</para>
114
115 <programlisting>export DB_SOCK=/var/run/openvswitch/db.sock
116ovsdb-tool create /etc/openvswitch/conf.db /usr/share/openvswitch/vswitch.ovsschema
117ovsdb-server --remote=punix:$DB_SOCK /
118--remote=db:Open_vSwitch,Open_vSwitch,manager_options --pidfile --detach</programlisting>
119 </listitem>
120
121 <listitem>
122 <para>Start ovs-vswitchd with DPDK support enabled:</para>
123
124 <programlisting>ovs-vsctl --no-wait init
125ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-lcore-mask=0x1
126ovs-vsctl --no-wait set Open_vSwitch . other_config:pmd-cpu-mask=0xc
127ovs-vsctl --no-wait set Open_vSwitch . other_config:dpdk-init=true
128ovs-vswitchd unix:$DB_SOCK --pidfile --detach /
129--log-file=/var/log/openvswitch/ovs-vswitchd.log</programlisting>
130 </listitem>
131
132 <listitem>
133 <para>Create the OVS bridge and attach ports:</para>
134
135 <programlisting>ovs-vsctl add-br ovsbr0 -- set bridge ovsbr0 datapath_type=netdev
136ovs-vsctl add-port ovsbr0 dpdk0 -- set Interface dpdk0 type=dpdk /
137:dpdk-devargs=&lt;PCI device&gt;</programlisting>
138 </listitem>
139
140 <listitem>
141 <para>Add DPDK vhost-user ports:</para>
142
143 <programlisting>ovs-vsctl add-port ovsbr0 vhost-user1 -- set Interface vhost-user1 type=dpdkvhostuser</programlisting>
144
145 <para>This command creates a socket at
146 <literal>/var/run/openvswitch/vhost-user1</literal>, which can be
147 provided to the VM on the QEMU command line. See <xref linkend="net_in_guest"/> for
148 details.</para>
149 </listitem>
150
151 <listitem>
152 <para>Define flows:</para>
153
154 <programlisting>ovs-ofctl del-flows ovsbr0
155ovs-ofctl show ovsbr0
156ovs-ofctl add-flow ovsbr0 in_port=1,action=output:2
157ovs-ofctl add-flow ovsbr0 in_port=2,action=output:1</programlisting>
158 </listitem>
159 </orderedlist>
160 </section>
161</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/doc/using_nfv_access_sdks.xml b/doc/book-enea-nfv-access-reference-guide-intel/doc/using_nfv_access_sdks.xml
deleted file mode 100644
index 6280338..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/doc/using_nfv_access_sdks.xml
+++ /dev/null
@@ -1,549 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="using_sdks">
5 <title>Using the Enea NFV Access SDKs</title>
6
7 <para>Enea NFV Access comes with two Software Development Kits: the
8 <emphasis role="bold">Standard SDK </emphasis>and the <emphasis
9 role="bold">Extensible SDK</emphasis>.</para>
10
11 <para>The Standard SDK can be used to develop, debug and run on a target
12 device (i.e. Xeon D, Atom C3000) user-applications and kernel modules which
13 are specific to the target architecture on host. The Extensible SDK can be
14 used to add a new Yocto recipe, build, test and package software, and
15 optionally deploy it to a target device.</para>
16
17 <note>
18 <para>The Extensible SDK is based on core-i7 architecture and can't be
19 used for building kernel modules specific to other architectures.</para>
20 </note>
21
22 <para><emphasis role="bold">Benefits of the Extensible
23 SDK:</emphasis><itemizedlist>
24 <listitem>
25 <para>Shared development environment.</para>
26 </listitem>
27
28 <listitem>
29 <para>Ease in adding new applications and libraries, modifying the
30 source of an existing component or adding new Yocto
31 layers/recipes.</para>
32 </listitem>
33
34 <listitem>
35 <para>Shared state for faster builds.</para>
36 </listitem>
37
38 <listitem>
39 <para>Devtool support.</para>
40 </listitem>
41
42 <listitem>
43 <para>One-time SDK installation with easy updates and extensions
44 available as needed.</para>
45 </listitem>
46
47 <listitem>
48 <para>Runs on a range of host distributions.</para>
49 </listitem>
50 </itemizedlist></para>
51
52 <para>For additional information about SDKs, please refer to the <ulink
53 url="https://wiki.yoctoproject.org/wiki/Application_Development_with_Extensible_SDK#Extensible_SDK">Application
54 Development with Extensible SDK, </ulink> <ulink
55 url="https://wiki.yoctoproject.org/wiki/Extensible_SDK">Extensible SDK Wiki
56 page</ulink> and the <ulink
57 url="https://www.yoctoproject.org/docs/current/sdk-manual/sdk-manual.html">Yocto
58 SDK Manual</ulink>.</para>
59
60 <section id="std_sdk">
61 <title>Standard SDK</title>
62
63 <para>The Standard SDK consists of:</para>
64
65 <itemizedlist>
66 <listitem>
67 <para>A Cross-Development Toolchain. Comprised of a cross-compiler and
68 a cross-debugger.</para>
69 </listitem>
70
71 <listitem>
72 <para>Libraries, Headers and Symbols, specific to the image.</para>
73 </listitem>
74
75 <listitem>
76 <para>The <literal>environment-setup</literal> script. Defines the
77 environment variables.</para>
78 </listitem>
79
80 <listitem>
81 <para>The Element ODM SDK.</para>
82 </listitem>
83 </itemizedlist>
84
85 <section id="install-crosscomp">
86 <title>Installing the Cross-Compilation Toolchain</title>
87
88 <para>Before cross-compiling applications for your target, you need to
89 install the corresponding toolchain on your workstation.</para>
90
91 <para><emphasis role="bold">How to install a toolchain using the
92 Installer</emphasis></para>
93
94 <orderedlist>
95 <listitem>
96 <para>Download the zip image from <ulink
97 url="https://portal.enea.com/access/">portal.enea.com/access</ulink>
98 and unzip it on the host machine e.g. in the
99 <literal>Enea_NFV_Access_2.0 </literal>directory.</para>
100 </listitem>
101
102 <listitem>
103 <para>Run the install script located at
104 <literal>Enea_NFV_Access_2.0/x86_64/install/sdk</literal> directory,
105 when prompted, select to install the toolchain in a desired
106 directory, referred to henceforth as
107 <literal>[sdkdir]</literal>.</para>
108
109 <programlisting>$ ./install-sdk.sh</programlisting>
110
111 <para>A default path where the toolchain will be installed will be
112 shown in the prompt. The installer will unpack the
113 <literal>environment-setup</literal> script in
114 <literal>[sdkdir]</literal> and the toolchain under
115 <literal>[sdkdir]/sysroots</literal>.</para>
116
117 <note>
118 <para>Choose a unique directory for each toolchain. Installing a
119 second toolchain of any type in the same directory as a previously
120 installed one will break the <literal>$PATH</literal> variable of
121 the first one.</para>
122 </note>
123 </listitem>
124
125 <listitem>
126 <para>Set up the toolchain environment for your target by sourcing
127 the <literal>environment-setup</literal> script: <programlisting>$ source [sdkdir]/environment-setup-corei7-64-enea-linux</programlisting></para>
128 </listitem>
129
130 <listitem>
131 <para>Make sure you have <literal>libelf-dev</literal> installed
132 into your host distribution. This is needed for working with the
133 kernel and building kernel modules.<programlisting>$ sudo apt-get install libelf-dev</programlisting></para>
134 </listitem>
135 </orderedlist>
136 </section>
137
138 <section id="crosscomp-apps">
139 <title>Cross-Compiling Applications from the Command Line</title>
140
141 <para>Once the <literal>environment-setup</literal> script is sourced,
142 you can create and compile your applications for your target.</para>
143
144 <para><emphasis role="bold">How to cross-compile from the command
145 line</emphasis></para>
146
147 <orderedlist>
148 <listitem>
149 <para>Create a Makefile for your application, example:</para>
150
151 <programlisting>helloworld:helloworld.o
152 $(CC) -o helloworld helloworld.o
153clean:
154 rm -f *.o helloworld
155#include stdio.h;
156int main(void) {
157 printf("Hello World\n");
158 return 0;
159}</programlisting>
160 </listitem>
161
162 <listitem>
163 <para>Run <command>make</command> to cross-compile your application
164 according to the environment set up:</para>
165
166 <programlisting>$ make</programlisting>
167 </listitem>
168
169 <listitem>
170 <para>Deploy the application to your target and run it:</para>
171
172 <programlisting># ./helloworld
173hello world</programlisting>
174 </listitem>
175 </orderedlist>
176 </section>
177
178 <section id="crosscomp-kern-mod">
179 <title>Cross-Compiling Kernel Modules</title>
180
181 <para>Before cross-compiling kernel modules, inside the kernel source
182 tree in the installed SDK, available at
183 <literal>[sdkdir]/sysroots/targetarch-enea-linux/usr/src/kernel</literal>,
184 run the following command:</para>
185
186 <programlisting>make scripts prepare</programlisting>
187
188 <para>Once the <literal>environment-setup</literal> script is sourced,
189 you can make and compile your kernel modules as intended for your
190 target.</para>
191
192 <para><emphasis role="bold">How to cross-compile a kernel
193 module</emphasis></para>
194
195 <orderedlist>
196 <listitem>
197 <para>Create a Makefile for the kernel module, example:</para>
198
199 <programlisting>obj-m := hello.ko
200PWD := $(shell pwd)
201
202KERNEL_SRC := full path to kernel source tree
203
204all: scripts
205 $(MAKE) -C $(KERNEL_SRC) M=$(PWD) LDFLAGS="" modules
206scripts:
207 $(MAKE) -C $(KERNEL_SRC) scripts
208clean:
209 $(MAKE) -C $(KERNEL_SRC) M=$(PWD) LDFLAGS="" clean
210#include linux/module.h /* Needed by all modules */
211#include linux/kernel.h /* Needed for KERN_INFO */
212#include linux/init.h /* Needed for the macros */
213
214static int __init hello_start(void)
215{
216 printk(KERN_INFO "Loading hello module...\n");
217 printk(KERN_INFO "Hello, world\n");
218 return 0;
219}
220
221static void __exit hello_end(void)
222{
223 printk(KERN_INFO "Goodbye, world\n");
224}
225
226module_init(hello_start);
227module_exit(hello_end);
228
229MODULE_LICENSE("GPL");</programlisting>
230 </listitem>
231
232 <listitem>
233 <para>Run the <command>make</command> command to cross-compile your
234 kernel module according to the environment set up:</para>
235
236 <programlisting>$ make</programlisting>
237 </listitem>
238
239 <listitem>
240 <para>Deploy the kernel module <literal>hello.ko</literal> to your
241 target and install/remove it:</para>
242
243 <programlisting># insmod hello.ko
244# rmmod hello.ko
245# dmesg
246[...] Loading hello module...
247[...] Hello, world
248[...] Goodbye, world</programlisting>
249 </listitem>
250 </orderedlist>
251 </section>
252
253 <section id="deploy-artifacts">
254 <title>Deploying your artifacts</title>
255
256 <para>A network connection is needed to deploy the artifacts on the host
257 target. Use <command>scp</command> to copy it to the desired
258 location:</para>
259
260 <programlisting># scp helloworld root@[target_ip_address]:/tmp</programlisting>
261 </section>
262
263 <section id="install-odm-sdk">
264 <title>Element ODM SDK</title>
265
266 <para>The Element ODM SDK is included in the Enea NFV Access SDK. Please
267 refer to the Element ODM documentation located in the Documentation
268 folder included with your release, on how to use the ODM SDK and how to
269 build ODM applications:</para>
270
271 <programlisting>Documentation/
272 Element_ODM_Kick_Start_Guide.pdf
273 Element_On_Device_Mgmt_Guide.pdf</programlisting>
274
275 <para>To build the ODM target kit, access the location of the ODM SDK
276 and run the <command>make</command> command:</para>
277
278 <programlisting>$ cd [sdkdir]/sysroots/corei7-64-enea-linux/usr/local/odm/odm-sdk-4.0.3-x86_64/
279$ make</programlisting>
280 </section>
281 </section>
282
283 <section id="esdk">
284 <title>Extensible SDK</title>
285
286 <para>The Extensible SDK helps you easily build, test and package
287 software, and deploy it to the target device.</para>
288
289 <para><emphasis role="bold">The Extensible SDK consists
290 of:</emphasis></para>
291
292 <itemizedlist>
293 <listitem>
294 <para>A Cross-Development Toolchain.</para>
295 </listitem>
296
297 <listitem>
298 <para>Libraries, Headers and Symbols for the x86 architecture.</para>
299 </listitem>
300
301 <listitem>
302 <para>The <literal>environment-setup</literal> script. Defines the
303 environment variables.</para>
304 </listitem>
305
306 <listitem>
307 <para>Devtool. A command-line tool used to automatically create
308 recipes for an existing source code, modify an existing recipe, build
309 and deploy the application to target.</para>
310 </listitem>
311 </itemizedlist>
312
313 <section id="install-esdk">
314 <title>Installing the Extensible SDK</title>
315
316 <para>To install the Extensible SDK on your host development machine,
317 run the installation script provided in the
318 <literal>Enea_NFV_Access_2.0/x86_64/install/esdk</literal>
319 folder:</para>
320
321 <orderedlist>
322 <listitem>
323 <para><programlisting>$ ./install-sdk.sh</programlisting>When
324 prompted, select to install the toolchain in a desired directory,
325 referred to henceforth as <literal>[sdkdir]</literal>.</para>
326
327 <para>A default path where the toolchain will be installed will be
328 shown in the prompt. The installer unpacks the
329 <literal>environment-setup</literal> script in
330 <literal>[sdkdir]</literal> and the toolchain under
331 <literal>[sdkdir]/sysroots</literal>.</para>
332
333 <note>
334 <para>Choose a unique directory for each toolchain. Installing a
335 second toolchain of any type in the same directory as a previously
336 installed one will break the <literal>$PATH</literal> variable of
337 the first one.</para>
338 </note>
339 </listitem>
340
341 <listitem>
342 <para>Set up the toolchain environment for your target by sourcing
343 the <literal>environment-setup</literal> script. Example:
344 <programlisting>$ source [sdkdir]/environment-setup-corei7-64-enea-linux</programlisting></para>
345
346 <para>With the SDK environment now set up, you may run
347 <command>devtool</command> to perform development tasks. Run
348 <command>devtool --help</command> to display the command manual for
349 further options available for use.</para>
350 </listitem>
351 </orderedlist>
352 </section>
353
354 <section id="add_new_comp_esdk">
355 <title>Adding a new component</title>
356
357 <para>The <command>devtool add</command> command is used to create a new
358 recipe and the <command>devtool modify</command> command is used to work
359 on an existing recipe.</para>
360
361 <para>To add a component, you can do the following:</para>
362
363 <itemizedlist>
364 <listitem>
365 <para><emphasis role="bold">Generate a recipe from an existing
366 application code and Makefile</emphasis></para>
367
368 <para>Run <command>devtool add [recipe]
369 [/path/to/your_application]</command> to generate a recipe:</para>
370
371 <programlisting>$ devtool add bbexample /path/to/bbexample</programlisting>
372
373 <para>Or alternatively, you can download from an upstream git
374 repository:<programlisting>$ devtool add bbexample https://github.com/whbruce/bbexample.git</programlisting></para>
375
376 <para><literal><command>devtool</command></literal> creates a Git
377 repository locally during extraction at:
378 <literal>[sdkdir]/workspace/source/bbexample</literal>, where the
379 recipe will be created automatically. E.g:
380 <literal>[sdkdir]/workspace/recipes/bbexample/bbexample.bb</literal>.</para>
381 </listitem>
382
383 <listitem>
384 <para><emphasis role="bold">Use an existing recipe from a Yocto
385 layer</emphasis></para>
386
387 <para>Use <command>devtool modify [recipe]</command> on any recipe
388 from <literal>[sdkdir]/layers/poky/meta*</literal>, example:</para>
389
390 <programlisting>$ devtool modify curl</programlisting>
391 </listitem>
392
393 <listitem>
394 <para><emphasis role="bold">Clone a new recipe from the upstream
395 Yocto project if the recipe is not included in your Extensible SDK
396 </emphasis></para>
397
398 <orderedlist>
399 <listitem>
400 <para>Clone a recipe from the upstream Yocto project, e.g.
401 <literal>meta-security</literal>:</para>
402
403 <programlisting>$ pushd [sdkdir]/layers/poky
404$ git clone -b rocko git://git.yoctoproject.org/meta-security
405$ popd</programlisting>
406 </listitem>
407
408 <listitem>
409 <para>Use the <literal>bitbake-layers</literal> script to add
410 <literal>meta-security</literal> to BBLAYERS:</para>
411
412 <programlisting>$ layers/poky/bitbake/bin/bitbake-layers add-layer layers/poky/meta-security</programlisting>
413
414 <para>If all required layers are not present you can get a
415 dependency ERROR:<programlisting>ERROR: Layer 'security' depends on layer 'perl-layer', but this layer is not \
416enabled in your configuration</programlisting>To rectify the dependency issue
417 exemplified above, clone <literal>meta-perl</literal> from
418 openembedded and run <command>add-layers</command>
419 again:<programlisting>$ layers/poky/bitbake/bin/bitbake-layers add-layer layers/poky/meta-security</programlisting>Now
420 <literal>[sdkdir]/layers/poky/meta-security</literal> is created
421 and the layer has been added to
422 <literal>[sdkdir]/conf/bblayers.conf</literal>:</para>
423
424 <note condition="hidden">
425 <para>The image build result can be seen at:
426 <literal>[sdkdir]/tmp/deploy/images/qemux86-64</literal></para>
427 </note>
428 </listitem>
429
430 <listitem>
431 <para>Use <command>devtool modify [recipe]</command> to change
432 an existing recipe inside the <literal>meta-security</literal>
433 layer:</para>
434
435 <programlisting>$ devtool modify isic</programlisting>
436
437 <para>The following directories and files will be created:
438 <literal>[sdkdir]/workspace/appends/isic_0.07.bbappend</literal>
439 and <literal>[sdkdir]/workspace/sources/isic</literal>.</para>
440 </listitem>
441 </orderedlist>
442 </listitem>
443 </itemizedlist>
444 </section>
445
446 <section id="devtool_build">
447 <title>Building an application</title>
448
449 <para>Use <command>devtool build [recipe]</command> to build the an
450 application:</para>
451
452 <para><programlisting>$ devtool build bbexample</programlisting><note>
453 <para>The image build result can be seen at
454 <literal>&lt;[sdkdir]&gt;/tmp/work/&lt;arch&gt;/&lt;recipe&gt;</literal>.
455 E.g.
456 <literal>[sdkdir]/tmp/work/corei7-64-enea-linux/bbexample</literal>.</para>
457 </note></para>
458 </section>
459 </section>
460
461 <section id="deploy">
462 <title>Deploy your application to a target</title>
463
464 <para>Deploy your application to a target by using the <command>devtool
465 deploy-target</command> command or by building a docker image and
466 deploying it.</para>
467
468 <section id="deploy-artifacts-esdk">
469 <title>Using devtool deploy-target</title>
470
471 <para>When deploying an application to a target device two scenarios can
472 occur.</para>
473
474 <itemizedlist>
475 <listitem>
476 <para>Example 1, where application deployment has no
477 issues:<programlisting>$ devtool deploy-target bbexample root@[target_ip_address]</programlisting>Now
478 run bbexample application on target:<programlisting># bbexample
479Hello Yocto World...
480Hello World (from a shared library!)</programlisting></para>
481 </listitem>
482
483 <listitem>
484 <para>Example 2, where application deployment encounters dependency
485 issues:<programlisting>$ devtool deploy-target isic root@[target_ip_address]
486# isic
487isic: error while loading shared libraries: libnet.so.9: cannot open shared
488object file: No such file or directory</programlisting>It is mandatory to add
489 required dependecies. The example application used above is
490 dependent on <literal>libnet</literal>, and requires you to build
491 and deploy libnet separately to the target in order for the
492 application to work:<programlisting>$ devtool modify libnet
493$ devtool build libnet
494$ devtool deploy-target libnet root@[target_ip_address]</programlisting>Now
495 run the application on target again:<programlisting># isic
496usage: isic [-v] [-D] -s [source ip] -d [destination ip] [-r [random seed]]
497...</programlisting></para>
498 </listitem>
499
500 <listitem>
501 <para>Remove/uninstall the application from target as needed:</para>
502
503 <programlisting>$ devtool undeploy-target isic root@[target_ip_address]</programlisting>
504 </listitem>
505 </itemizedlist>
506 </section>
507
508 <section id="docker_deploy">
509 <title>Creating and deploying a Docker image</title>
510
511 <para>You can build a docker container image from your Extensible SDK
512 and add your application into the container image.</para>
513
514 <orderedlist>
515 <listitem>
516 <para>Create a container image recipe in the workspace layer, e.g.
517 <literal>cont-image</literal> and add the following lines:</para>
518
519 <programlisting>IMAGE_INSTALL += "your_application"
520
521LICENSE = "MIT"
522
523IMAGE_FSTYPES = "container"
524
525inherit core-image</programlisting>
526 </listitem>
527
528 <listitem>
529 <para>Build the container image:</para>
530
531 <programlisting>$ devtool build-image cont-image </programlisting>
532
533 <note>
534 <para>The image build result can be seen at:
535 <literal>[sdkdir]/tmp/deploy/images/&lt;target&gt;</literal>.
536 E.g.:
537 <literal>[sdkdir]/tmp/deploy/images/qemux86-64</literal></para>
538 </note>
539 </listitem>
540
541 <listitem>
542 <para>Copy the image to the target and import it into Docker:</para>
543
544 <programlisting># docker import cont-image-qemux86.tar.bz2 [your_application]</programlisting>
545 </listitem>
546 </orderedlist>
547 </section>
548 </section>
549</chapter>
diff --git a/doc/book-enea-nfv-access-reference-guide-intel/swcomp.mk b/doc/book-enea-nfv-access-reference-guide-intel/swcomp.mk
deleted file mode 100644
index 514a457..0000000
--- a/doc/book-enea-nfv-access-reference-guide-intel/swcomp.mk
+++ /dev/null
@@ -1,10 +0,0 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-access-reference-guide-intel
9BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access $(PROD_VER) Reference Guide"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-nfv-access-sdk-open-source/doc/README b/doc/book-enea-nfv-access-sdk-open-source/doc/README
deleted file mode 100644
index 1077acb..0000000
--- a/doc/book-enea-nfv-access-sdk-open-source/doc/README
+++ /dev/null
@@ -1,4 +0,0 @@
1The licenses.xml in the git repository of Enea NFV Access Open Source Report
2is the frozen version belonging to the last official release of Enea NFV Access.
3The contents must be generated from the release script to obtain the latest
4lists of packages and licenses.
diff --git a/doc/book-enea-nfv-access-sdk-open-source/doc/about.xml b/doc/book-enea-nfv-access-sdk-open-source/doc/about.xml
deleted file mode 100644
index 0ca3155..0000000
--- a/doc/book-enea-nfv-access-sdk-open-source/doc/about.xml
+++ /dev/null
@@ -1,12 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="enea-linux-open-source-packages-and-licenses">
5 <title>About this Report</title>
6
7 <para>This document contains the open source and license information
8 pertaining to packages provided with Enea NFV Access <xi:include
9 href="../../book-enea-nfv-access-release-info/doc/eltf_params_updated.xml"
10 xmlns:xi="http://www.w3.org/2001/XInclude"
11 xpointer="element(EneaLinux_REL_VER/1)" />.</para>
12</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-sdk-open-source/doc/book.xml b/doc/book-enea-nfv-access-sdk-open-source/doc/book.xml
deleted file mode 100644
index 49c7e40..0000000
--- a/doc/book-enea-nfv-access-sdk-open-source/doc/book.xml
+++ /dev/null
@@ -1,15 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
5]>
6<book id="book_enea_nfv_access_open_source">
7 <title><trademark class="registered">Enea</trademark> NFV Access Open Source Report</title>
8 <subtitle>Release Version
9 <xi:include href="../../book-enea-nfv-access-release-info/doc/eltf_params_updated.xml" xpointer="element(EneaLinux_REL_VER/1)"
10 xmlns:xi="http://www.w3.org/2001/XInclude" /></subtitle>
11 <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb -->
12 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
13 <xi:include href="about.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
14 <xi:include href="licenses.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
15</book>
diff --git a/doc/book-enea-nfv-access-sdk-open-source/doc/licenses.xml b/doc/book-enea-nfv-access-sdk-open-source/doc/licenses.xml
deleted file mode 100644
index 8ff32d0..0000000
--- a/doc/book-enea-nfv-access-sdk-open-source/doc/licenses.xml
+++ /dev/null
@@ -1,8573 +0,0 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="enea_linux_packages">
5 <title>Packages and Licenses</title>
6 <section id="licenses_packages">
7
8 <title>Packages</title>
9
10
11 <!--This chapter contains a generated list of all packages that Enea Linux
12supports, e.g. busybox, with a short explanatory blurb and links to package
13specific documentation.-->
14
15 <informaltable>
16 <tgroup cols="4">
17 <colspec colwidth="2*"/>
18 <colspec colwidth="1*"/>
19 <colspec colwidth="5*"/>
20 <colspec colwidth="2*"/>
21
22
23 <thead>
24 <row>
25 <entry align="center">Package Name</entry>
26 <entry align="center">Version</entry>
27 <entry align="center">Description</entry>
28 <entry align="center">License</entry>
29
30 </row>
31 </thead>
32
33 <tbody valign="top">
34<row>
35 <entry>4g-sierra</entry>
36 <entry>1.0</entry>
37 <entry>Scripts to setup 4G modems from Sierra</entry>
38 <entry>Enea</entry>
39</row>
40<row>
41 <entry>acl</entry>
42 <entry>2.2.52</entry>
43 <entry>Utilities for managing POSIX Access Control Lists.</entry>
44 <entry> LGPL-2.1, GPL-2.0</entry>
45</row>
46<row>
47 <entry>alsa-lib</entry>
48 <entry>1.1.4.1</entry>
49 <entry>ALSA sound library.</entry>
50 <entry> LGPL-2.1, GPL-2.0</entry>
51</row>
52<row>
53 <entry>ant</entry>
54 <entry>1.8.1</entry>
55 <entry>Another Neat Tool - build system for Java</entry>
56 <entry>Apache-2.0</entry>
57</row>
58<row>
59 <entry>antlr</entry>
60 <entry>2.7.7</entry>
61 <entry>Framework for constructing recognizers interpreters compilers and translators</entry>
62 <entry>PD</entry>
63</row>
64<row>
65 <entry>apache2</entry>
66 <entry>2.4.27</entry>
67 <entry>The Apache HTTP Server is a powerful efficient and extensible web server.</entry>
68 <entry>Apache-2.0</entry>
69</row>
70<row>
71 <entry>apr-util</entry>
72 <entry>1.6.0</entry>
73 <entry>Apache Portable Runtime (APR) companion library.</entry>
74 <entry>Apache-2.0</entry>
75</row>
76<row>
77 <entry>apr</entry>
78 <entry>1.6.2</entry>
79 <entry>Apache Portable Runtime (APR) library.</entry>
80 <entry>Apache-2.0</entry>
81</row>
82<row>
83 <entry>apt</entry>
84 <entry>1.2.24</entry>
85 <entry>Advanced front-end for dpkg.</entry>
86 <entry>GPL-2.0</entry>
87</row>
88<row>
89 <entry>attr</entry>
90 <entry>2.4.47</entry>
91 <entry>Utilities for manipulating filesystem extended attributes.</entry>
92 <entry> LGPL-2.1, GPL-2.0</entry>
93</row>
94<row>
95 <entry>aufs-util</entry>
96 <entry>4.4</entry>
97 <entry>Tools for managing AUFS mounts.</entry>
98 <entry>GPL-2.0</entry>
99</row>
100<row>
101 <entry>augeas</entry>
102 <entry>1.5.0</entry>
103 <entry>Augeas configuration API.</entry>
104 <entry>LGPL-2.1</entry>
105</row>
106<row>
107 <entry>autoconf-archive</entry>
108 <entry>2016.09.16</entry>
109 <entry>a collection of freely re-usable Autoconf macros.</entry>
110 <entry>GPL-3.0-with-autoconf-exception</entry>
111</row>
112<row>
113 <entry>autoconf</entry>
114 <entry>2.69</entry>
115 <entry>Autoconf is an extensible package of M4 macros that produce shell scripts to automatically configure software source code packages. Autoconf creates a configuration script for a package from a template file that lists the operating system features that the package can use in the form of M4 macro calls.</entry>
116 <entry> GPL-2.0, GPL-3.0</entry>
117</row>
118<row>
119 <entry>automake</entry>
120 <entry>1.15.1</entry>
121 <entry>Automake is a tool for automatically generating `Makefile.in' files compliant with the GNU Coding Standards. Automake requires the use of Autoconf.</entry>
122 <entry>GPL-2.0</entry>
123</row>
124<row>
125 <entry>avahi</entry>
126 <entry>0.6.32</entry>
127 <entry>"Avahi is a fully LGPL framework for Multicast DNS Service Discovery. It allows programs to publish and discover services and hosts running on a local network with no specific configuration. This tool implements IPv4LL ""Dynamic Configuration of IPv4 Link-Local Addresses"" (IETF RFC3927) a protocol for automatic IP address configuration from the link-local 169.254.0.0/16 range without the need for a central server."</entry>
128 <entry> GPL-2.0, LGPL-2.1</entry>
129</row>
130<row>
131 <entry>avalon-framework-api</entry>
132 <entry>4.3</entry>
133 <entry>Common way for components to be created initialized configured started. (API-only)</entry>
134 <entry>Apache-2.0</entry>
135</row>
136<row>
137 <entry>base-files</entry>
138 <entry>3.0.14</entry>
139 <entry>The base-files package creates the basic system directory structure and provides a small set of key configuration files for the system.</entry>
140 <entry>GPL-2.0</entry>
141</row>
142<row>
143 <entry>base-passwd</entry>
144 <entry>3.5.29</entry>
145 <entry>The master copies of the user database files (/etc/passwd and /etc/group). The update-passwd tool is also provided to keep the system databases synchronized with these master files.</entry>
146 <entry>GPL-2.0</entry>
147</row>
148<row>
149 <entry>bash-completion</entry>
150 <entry>2.7</entry>
151 <entry>Programmable Completion for Bash 4.</entry>
152 <entry>GPL-2.0</entry>
153</row>
154<row>
155 <entry>bash</entry>
156 <entry>4.4</entry>
157 <entry>An sh-compatible command language interpreter.</entry>
158 <entry>GPL-3.0</entry>
159</row>
160<row>
161 <entry>bc</entry>
162 <entry>1.06</entry>
163 <entry>Arbitrary precision calculator language.</entry>
164 <entry> GPL-2.0, LGPL-2.1</entry>
165</row>
166<row>
167 <entry>bcel</entry>
168 <entry>5.2</entry>
169 <entry>Java Bytecode manipulation library</entry>
170 <entry>Apache-2.0</entry>
171</row>
172<row>
173 <entry>bind</entry>
174 <entry>9.10.5-P3</entry>
175 <entry>ISC Internet Domain Name Server.</entry>
176 <entry> ISC, BSD</entry>
177</row>
178<row>
179 <entry>binutils-cross-x86_64</entry>
180 <entry>2.29.1</entry>
181 <entry>The GNU Binutils are a collection of binary tools. The main ones are ld (GNU Linker) and as (GNU Assembler). This package also includes addition tools such as addr2line (Converts addresses into filenames and line numbers) ar (utility for creating modifying and extracting archives) nm (list symbols in object files) objcopy (copy and translate object files) objdump (Display object information) and other tools and related libraries.</entry>
182 <entry>GPL-3.0</entry>
183</row>
184<row>
185 <entry>binutils</entry>
186 <entry>2.29.1</entry>
187 <entry>The GNU Binutils are a collection of binary tools. The main ones are ld (GNU Linker) and as (GNU Assembler). This package also includes addition tools such as addr2line (Converts addresses into filenames and line numbers) ar (utility for creating modifying and extracting archives) nm (list symbols in object files) objcopy (copy and translate object files) objdump (Display object information) and other tools and related libraries.</entry>
188 <entry>GPL-3.0</entry>
189</row>
190<row>
191 <entry>bison</entry>
192 <entry>3.0.4</entry>
193 <entry>Bison is a general-purpose parser generator that converts an annotated context-free grammar into an LALR(1) or GLR parser for that grammar. Bison is upward compatible with Yacc: all properly-written Yacc grammars ought to work with Bison with no change. Anyone familiar with Yacc should be able to use Bison with little trouble.</entry>
194 <entry>GPL-3.0</entry>
195</row>
196<row>
197 <entry>bjam</entry>
198 <entry>1.64.0</entry>
199 <entry>Portable Boost.Jam build tool for boost.</entry>
200 <entry> BSL-1.0, MIT, Python-2.0</entry>
201</row>
202<row>
203 <entry>bmap-tools</entry>
204 <entry>3.4</entry>
205 <entry>"Bmap-tools - tools to generate block map (AKA bmap) and flash images using bmap. Bmaptool is a generic tool for creating the block map (bmap) for a file and copying files using the block map. The idea is that large file containing unused blocks like raw system image files can be copied or flashed a lot faster with bmaptool than with traditional tools like ""dd"" or ""cp""."</entry>
206 <entry>GPL-2.0</entry>
207</row>
208<row>
209 <entry>boost</entry>
210 <entry>1.64.0</entry>
211 <entry>Free peer-reviewed portable C++ source libraries.</entry>
212 <entry> BSL-1.0, MIT, Python-2.0</entry>
213</row>
214<row>
215 <entry>bridge-utils</entry>
216 <entry>1.5</entry>
217 <entry>Tools for ethernet bridging.</entry>
218 <entry>GPL-2.0</entry>
219</row>
220<row>
221 <entry>bsf</entry>
222 <entry>2.4.0</entry>
223 <entry>Bean Scripting Framework package</entry>
224 <entry>Apache-2.0</entry>
225</row>
226<row>
227 <entry>btrfs-tools</entry>
228 <entry>4.12</entry>
229 <entry>Btrfs is a new copy on write filesystem for Linux aimed at implementing advanced features while focusing on fault tolerance repair and easy administration. This package contains utilities (mkfs fsck btrfsctl) used to work with btrfs and an utility (btrfs-convert) to make a btrfs filesystem from an ext3.</entry>
230 <entry>GPL-2.0</entry>
231</row>
232<row>
233 <entry>busybox</entry>
234 <entry>1.24.1</entry>
235 <entry>BusyBox combines tiny versions of many common UNIX utilities into a single small executable. It provides minimalist replacements for most of the utilities you usually find in GNU fileutils shellutils etc. The utilities in BusyBox generally have fewer options than their full-featured GNU cousins; however the options that are included provide the expected functionality and behave very much like their GNU counterparts. BusyBox provides a fairly complete POSIX environment for any small or embedded system.</entry>
236 <entry> GPL-2.0, BSD-4-Clause</entry>
237</row>
238<row>
239 <entry>bzip2</entry>
240 <entry>1.0.6</entry>
241 <entry>bzip2 compresses files using the Burrows-Wheeler block-sorting text compression algorithm and Huffman coding. Compression is generally considerably better than that achieved by more conventional LZ77/LZ78-based compressors and approaches the performance of the PPM family of statistical compressors.</entry>
242 <entry>BSD-4-Clause</entry>
243</row>
244<row>
245 <entry>ca-certificates</entry>
246 <entry>20170717</entry>
247 <entry>This package includes PEM files of CA certificates to allow SSL-based applications to check for the authenticity of SSL connections. This derived from Debian's CA Certificates.</entry>
248 <entry> GPL-2.0, MPL-2.0</entry>
249</row>
250<row>
251 <entry>cacao-initial</entry>
252 <entry>0.98</entry>
253 <entry>CacaoVM for use as OpenEmbedded's Java VM</entry>
254 <entry>GPL-2.0</entry>
255</row>
256<row>
257 <entry>cdrkit</entry>
258 <entry>1.1.11</entry>
259 <entry>CD/DVD command line tools.</entry>
260 <entry>GPL-2.0</entry>
261</row>
262<row>
263 <entry>cdrtools</entry>
264 <entry>3.01a31</entry>
265 <entry>A set of tools for CD recording including cdrecord.</entry>
266 <entry> GPL-2.0, CDDL-1.0, LGPL-2.1</entry>
267</row>
268<row>
269 <entry>classpath-initial</entry>
270 <entry>0.93</entry>
271 <entry>Java1.4-compatible GNU Classpath variant that is used as bootclasspath for jikes-native.</entry>
272 <entry> GPL-2.0, SAX-PD</entry>
273</row>
274<row>
275 <entry>classpath</entry>
276 <entry>0.99</entry>
277 <entry>GNU Classpath standard Java libraries - For native Java-dependent programs</entry>
278 <entry> GPL-2.0, SAX-PD</entry>
279</row>
280<row>
281 <entry>cloud-init</entry>
282 <entry>0.7.6</entry>
283 <entry>Init scripts for use on cloud images</entry>
284 <entry>GPL-3.0</entry>
285</row>
286<row>
287 <entry>cmake</entry>
288 <entry>3.8.2</entry>
289 <entry>Cross-platform open-source make system.</entry>
290 <entry>BSD</entry>
291</row>
292<row>
293 <entry>commons-logging</entry>
294 <entry>1.1.1</entry>
295 <entry>Java Internet protocol suite library</entry>
296 <entry>Apache-2.0</entry>
297</row>
298<row>
299 <entry>commons-net</entry>
300 <entry>1.4.1</entry>
301 <entry>Java Internet protocol suite library</entry>
302 <entry>Apache-2.0</entry>
303</row>
304<row>
305 <entry>compose-file</entry>
306 <entry>3.0</entry>
307 <entry>Parser for the Compose file format (version 3)</entry>
308 <entry>Apache-2.0</entry>
309</row>
310<row>
311 <entry>containerd-docker</entry>
312 <entry>v0.2.x</entry>
313 <entry>containerd is a daemon to control runC built for performance and density. containerd leverages runC's advanced features such as seccomp and user namespace support as well as checkpoint and restore for cloning and live migration of containers.</entry>
314 <entry>Apache-2.0</entry>
315</row>
316<row>
317 <entry>core-image-minimal-initramfs</entry>
318 <entry>1.0</entry>
319 <entry>Small image capable of booting a device. The kernel includes the Minimal RAM-based Initial Root Filesystem (initramfs) which finds the first 'init' program more efficiently.</entry>
320 <entry>MIT</entry>
321</row>
322<row>
323 <entry>coreutils</entry>
324 <entry>8.27</entry>
325 <entry>The GNU Core Utilities provide the basic file shell and text manipulation utilities. These are the core utilities which are expected to exist on every system.</entry>
326 <entry>GPL-3.0</entry>
327</row>
328<row>
329 <entry>cross-localedef</entry>
330 <entry>2.26</entry>
331 <entry>Cross locale generation tool for glibc.</entry>
332 <entry>LGPL-2.1</entry>
333</row>
334<row>
335 <entry>cryptodev-linux</entry>
336 <entry>1.9</entry>
337 <entry>A /dev/crypto device driver header file.</entry>
338 <entry>GPL-2.0</entry>
339</row>
340<row>
341 <entry>cup</entry>
342 <entry>0.10k</entry>
343 <entry>Lexical analyzer generator for Java</entry>
344 <entry>CUP</entry>
345</row>
346<row>
347 <entry>curl</entry>
348 <entry>7.58.0</entry>
349 <entry>Command line tool and library for client-side URL transfers.</entry>
350 <entry>MIT</entry>
351</row>
352<row>
353 <entry>cwautomacros</entry>
354 <entry>20110201</entry>
355 <entry>Collection of autoconf m4 macros.</entry>
356 <entry>GPL-2.0</entry>
357</row>
358<row>
359 <entry>db</entry>
360 <entry>5.3.28</entry>
361 <entry>Berkeley Database v5.</entry>
362 <entry>Sleepycat</entry>
363</row>
364<row>
365 <entry>dbus-glib</entry>
366 <entry>0.108</entry>
367 <entry>GLib bindings for the D-Bus message bus that integrate the D-Bus library with the GLib thread abstraction and main loop.</entry>
368 <entry> AFL-2.0, GPL-2.0</entry>
369</row>
370<row>
371 <entry>dbus-test</entry>
372 <entry>1.10.20</entry>
373 <entry>D-Bus test package (for D-bus functionality testing only).</entry>
374 <entry> AFL-2.0, GPL-2.0</entry>
375</row>
376<row>
377 <entry>dbus</entry>
378 <entry>1.10.20</entry>
379 <entry>"D-Bus is a message bus system a simple way for applications to talk to one another. In addition to interprocess communication D-Bus helps coordinate process lifecycle; it makes it simple and reliable to code a \""single instance\"" application or daemon and to launch applications and daemons on demand when their services are needed."</entry>
380 <entry> AFL-2.0, GPL-2.0</entry>
381</row>
382<row>
383 <entry>debianutils</entry>
384 <entry>4.8.1.1</entry>
385 <entry>Miscellaneous utilities specific to Debian.</entry>
386 <entry> GPL-2.0, SMAIL_GPL</entry>
387</row>
388<row>
389 <entry>depmodwrapper</entry>
390 <entry>1.0</entry>
391 <entry>Wrapper script for the Linux kernel module dependency indexer.</entry>
392 <entry>MIT</entry>
393</row>
394<row>
395 <entry>dhcp</entry>
396 <entry>4.3.6</entry>
397 <entry>DHCP (Dynamic Host Configuration Protocol) is a protocol which allows individual devices on an IP network to get their own network configuration information from a server. DHCP helps make it easier to administer devices.</entry>
398 <entry>ISC</entry>
399</row>
400<row>
401 <entry>diffutils</entry>
402 <entry>3.6</entry>
403 <entry>Diffutils contains the GNU diff diff3 sdiff and cmp utilities. These programs are usually used for creating patch files.</entry>
404 <entry>GPL-3.0</entry>
405</row>
406<row>
407 <entry>dmidecode</entry>
408 <entry>3.1</entry>
409 <entry>DMI (Desktop Management Interface) table related utilities.</entry>
410 <entry>GPL-2.0</entry>
411</row>
412<row>
413 <entry>dnsmasq</entry>
414 <entry>2.78</entry>
415 <entry>Lightweight easy to configure DNS forwarder and DHCP server.</entry>
416 <entry> GPL-2.0, GPL-3.0</entry>
417</row>
418<row>
419 <entry>docker</entry>
420 <entry>17.06.0</entry>
421 <entry>Linux container runtime Docker complements kernel namespacing with a high-level API which operates at the process level. It runs unix processes with strong guarantees of isolation and repeatability across servers. . Docker is a great building block for automating distributed systems: large-scale web deployments database clusters continuous deployment systems private PaaS service-oriented architectures etc. . This package contains the daemon and client. Using docker.io is officially supported on x86_64 and arm (32-bit) hosts. Other architectures are considered experimental. . Also note that kernel version 3.10 or above is required for proper operation of the daemon process and that any lower versions may have subtle and/or glaring issues. </entry>
422 <entry>Apache-2.0</entry>
423</row>
424<row>
425 <entry>dosfstools</entry>
426 <entry>4.1</entry>
427 <entry>DOS FAT Filesystem Utilities.</entry>
428 <entry>GPL-3.0</entry>
429</row>
430<row>
431 <entry>dpdk-dev-libibverbs</entry>
432 <entry>1.2.1-3.4-2.0.0.0</entry>
433 <entry>libibverbs library to support Mellanox config</entry>
434 <entry>GPL-2.0</entry>
435</row>
436<row>
437 <entry>dpdk</entry>
438 <entry>18.02</entry>
439 <entry>Intel(r) Data Plane Development Kit</entry>
440 <entry> BSD, LGPL-2.0, GPL-2.0</entry>
441</row>
442<row>
443 <entry>dpkg</entry>
444 <entry>1.18.24</entry>
445 <entry>Package maintenance system from Debian.</entry>
446 <entry>GPL-2.0</entry>
447</row>
448<row>
449 <entry>dtc</entry>
450 <entry>1.4.4</entry>
451 <entry>The Device Tree Compiler is a tool used to manipulate the Open-Firmware-like device tree used by PowerPC kernels.</entry>
452 <entry> GPL-2.0, BSD</entry>
453</row>
454<row>
455 <entry>e2fsprogs</entry>
456 <entry>1.43.5</entry>
457 <entry>The Ext2 Filesystem Utilities (e2fsprogs) contain all of the standard utilities for creating fixing configuring and debugging ext2 filesystems.</entry>
458 <entry> GPL-2.0, LGPL-2.0, BSD, MIT</entry>
459</row>
460<row>
461 <entry>ebtables</entry>
462 <entry>2.0.10-4</entry>
463 <entry>Utility for basic Ethernet frame filtering on a Linux bridge advanced logging MAC DNAT/SNAT and brouting.</entry>
464 <entry>GPL-2.0</entry>
465</row>
466<row>
467 <entry>ecj-bootstrap</entry>
468 <entry>1.0</entry>
469 <entry>JDT Core Batch Compiler - Bootstrap variant</entry>
470 <entry>MIT</entry>
471</row>
472<row>
473 <entry>ecj-initial</entry>
474 <entry>1.0</entry>
475 <entry>JDT Core Batch Compiler - Bootstrap variant</entry>
476 <entry>MIT</entry>
477</row>
478<row>
479 <entry>efibootmgr</entry>
480 <entry>0.15</entry>
481 <entry>Linux user-space application to modify the EFI Boot Manager.</entry>
482 <entry>GPL-2.0</entry>
483</row>
484<row>
485 <entry>efitools</entry>
486 <entry>1.7.0</entry>
487 <entry>From the EFI Tools package in the Linux user-space it's now possible to read and manipulate the UEFI signatures database via the new efi-readvar and efi-updatevar commands. Aside from needing efitools 1.4 the EFIVARFS file-system is also needed which was only introduced in the Linux 3.8 kernel. </entry>
488 <entry>GPL-2.0</entry>
489</row>
490<row>
491 <entry>efivar</entry>
492 <entry>0.31</entry>
493 <entry>efivar provides a simple command line interface to the UEFI variable facility</entry>
494 <entry>LGPL-2.1</entry>
495</row>
496<row>
497 <entry>element-vcpe</entry>
498 <entry>4.1.0</entry>
499 <entry>vCPE(based on Element-ODM)</entry>
500 <entry> Enea, Windbase, BSD</entry>
501</row>
502<row>
503 <entry>elfutils</entry>
504 <entry>0.170</entry>
505 <entry>Utilities and libraries for handling compiled object files.</entry>
506 <entry> GPL-3.0, Elfutils-Exception</entry>
507</row>
508<row>
509 <entry>enea-nfv-access-vnf</entry>
510 <entry>1.0</entry>
511 <entry>VNF image of the Enea NFV Access Platform includes kernel rootfs and boot parameters</entry>
512 <entry>MIT</entry>
513</row>
514<row>
515 <entry>enea-nfv-access</entry>
516 <entry>1.0</entry>
517 <entry>Image for the host side of the Enea NFV Access Platform with ODM and NETCONF Edgelink customizations</entry>
518 <entry>MIT</entry>
519</row>
520<row>
521 <entry>ethtool</entry>
522 <entry>4.11</entry>
523 <entry>A small utility for examining and tuning the settings of your ethernet-based network interfaces.</entry>
524 <entry>GPL-2.0</entry>
525</row>
526<row>
527 <entry>expat</entry>
528 <entry>2.2.3</entry>
529 <entry>Expat is an XML parser library written in C. It is a stream-oriented parser in which an application registers handlers for things the parser might find in the XML document (like start tags)</entry>
530 <entry>MIT</entry>
531</row>
532<row>
533 <entry>fastjar</entry>
534 <entry>0.98</entry>
535 <entry>jar replacement written in C.</entry>
536 <entry>GPL-2.0</entry>
537</row>
538<row>
539 <entry>file</entry>
540 <entry>5.31</entry>
541 <entry>File attempts to classify files depending on their contents and prints a description if a match is found.</entry>
542 <entry>BSD</entry>
543</row>
544<row>
545 <entry>findutils</entry>
546 <entry>4.6.0</entry>
547 <entry>The GNU Find Utilities are the basic directory searching utilities of the GNU operating system. These programs are typically used in conjunction with other programs to provide modular and powerful directory search and file locating capabilities to other commands.</entry>
548 <entry>GPL-3.0</entry>
549</row>
550<row>
551 <entry>flex</entry>
552 <entry>2.6.0</entry>
553 <entry>Flex is a fast lexical analyser generator. Flex is a tool for generating programs that recognize lexical patterns in text.</entry>
554 <entry>BSD</entry>
555</row>
556<row>
557 <entry>fontconfig</entry>
558 <entry>2.12.4</entry>
559 <entry>Fontconfig is a font configuration and customization library which does not depend on the X Window System. It is designed to locate fonts within the system and select them according to requirements specified by applications. Fontconfig is not a rasterization library nor does it impose a particular rasterization library on the application. The X-specific library 'Xft' uses fontconfig along with freetype to specify and rasterize fonts.</entry>
560 <entry> MIT, PD</entry>
561</row>
562<row>
563 <entry>freetype</entry>
564 <entry>2.8</entry>
565 <entry>FreeType is a software font engine that is designed to be small efficient highly customizable and portable while capable of producing high-quality output (glyph images). It can be used in graphics libraries display servers font conversion tools text image generation tools and many other products as well.</entry>
566 <entry> FreeType, GPL-2.0</entry>
567</row>
568<row>
569 <entry>fuse</entry>
570 <entry>2.9.7</entry>
571 <entry>FUSE (Filesystem in Userspace) is a simple interface for userspace programs to export a virtual filesystem to the Linux kernel. FUSE also aims to provide a secure method for non privileged users to create and mount their own filesystem implementations. </entry>
572 <entry> GPL-2.0, LGPL-2.0</entry>
573</row>
574<row>
575 <entry>gawk</entry>
576 <entry>4.1.4</entry>
577 <entry>The GNU version of awk a text processing utility. Awk interprets a special-purpose programming language to do quick and easy text pattern matching and reformatting jobs.</entry>
578 <entry>GPL-3.0</entry>
579</row>
580<row>
581 <entry>gcc-cross-initial-x86_64</entry>
582 <entry>7.3.0</entry>
583 <entry>GNU cc and gcc C compilers.</entry>
584 <entry> GPL-3.0-with-GCC-exception, GPL-3.0</entry>
585</row>
586<row>
587 <entry>gcc-cross-x86_64</entry>
588 <entry>7.3.0</entry>
589 <entry>GNU cc and gcc C compilers.</entry>
590 <entry> GPL-3.0-with-GCC-exception, GPL-3.0</entry>
591</row>
592<row>
593 <entry>gcc-source-7.3.0</entry>
594 <entry>7.3.0</entry>
595 <entry>GNU cc and gcc C compilers.</entry>
596 <entry> GPL-3.0-with-GCC-exception, GPL-3.0</entry>
597</row>
598<row>
599 <entry>gcc</entry>
600 <entry>7.3.0</entry>
601 <entry>Runtime libraries from GCC.</entry>
602 <entry>GPL-3.0-with-GCC-exception</entry>
603</row>
604<row>
605 <entry>gdbm</entry>
606 <entry>1.13</entry>
607 <entry>Key/value database library with extensible hashing.</entry>
608 <entry>GPL-3.0</entry>
609</row>
610<row>
611 <entry>gettext-minimal</entry>
612 <entry>0.19.8.1</entry>
613 <entry>Contains the m4 macros sufficient to support building autoconf/automake. This provides a significant build time speedup by the removal of gettext-native from most dependency chains (now only needed for gettext for the target).</entry>
614 <entry>FSF-Unlimited</entry>
615</row>
616<row>
617 <entry>gettext</entry>
618 <entry>0.19.8.1</entry>
619 <entry>GNU gettext is a set of tools that provides a framework to help other programs produce multi-lingual messages. These tools include a set of conventions about how programs should be written to support message catalogs a directory and file naming organization for the message catalogs themselves a runtime library supporting the retrieval of translated messages and a few stand-alone programs to massage in various ways the sets of translatable and already translated strings.</entry>
620 <entry> GPL-3.0, LGPL-2.1</entry>
621</row>
622<row>
623 <entry>giflib</entry>
624 <entry>5.1.4</entry>
625 <entry>shared library for GIF images.</entry>
626 <entry>MIT</entry>
627</row>
628<row>
629 <entry>git</entry>
630 <entry>2.13.3</entry>
631 <entry>Distributed version control system.</entry>
632 <entry>GPL-2.0</entry>
633</row>
634<row>
635 <entry>glib-2.0</entry>
636 <entry>2.52.3</entry>
637 <entry>GLib is a general-purpose utility library which provides many useful data types macros type conversions string utilities file utilities a main loop abstraction and so on.</entry>
638 <entry> LGPL-2.0, BSD, PD</entry>
639</row>
640<row>
641 <entry>glibc-locale</entry>
642 <entry>2.26</entry>
643 <entry>Locale data from glibc.</entry>
644 <entry> GPL-2.0, LGPL-2.1</entry>
645</row>
646<row>
647 <entry>glibc</entry>
648 <entry>2.26</entry>
649 <entry>The GNU C Library is used as the system C library in most systems with the Linux kernel.</entry>
650 <entry> GPL-2.0, LGPL-2.1</entry>
651</row>
652<row>
653 <entry>gmp</entry>
654 <entry>6.1.2</entry>
655 <entry>GMP is a free library for arbitrary precision arithmetic operating on signed integers rational numbers and floating point numbers</entry>
656 <entry> GPL-2.0, LGPL-3.0</entry>
657</row>
658<row>
659 <entry>gnome-desktop-testing</entry>
660 <entry>2014.1</entry>
661 <entry>Test runner for GNOME-style installed tests.</entry>
662 <entry>LGPL-2.0</entry>
663</row>
664<row>
665 <entry>gnu-config</entry>
666 <entry>20150728</entry>
667 <entry>Tool that installs the GNU config.guess / config.sub into a directory tree</entry>
668 <entry>GPL-3.0-with-autoconf-exception</entry>
669</row>
670<row>
671 <entry>gnu-efi</entry>
672 <entry>3.0.6</entry>
673 <entry>Libraries for producing EFI binaries.</entry>
674 <entry> GPL-2.0, BSD-2-Clause</entry>
675</row>
676<row>
677 <entry>gnujaf</entry>
678 <entry>1.1.1</entry>
679 <entry>Provides a mean to type data and locate components suitable for performing various kinds of action on it.</entry>
680 <entry>GPL-2.0-with-GCC-exception</entry>
681</row>
682<row>
683 <entry>gnulib</entry>
684 <entry>2017-08-20.18</entry>
685 <entry>A collection of software subroutines which are designed to be usable on many operating systems. The goal of the project is to make it easy for free software authors to make their software run on many operating systems. Since source is designed to be copied from gnulib it is not a library per-se as much as a collection of portable idioms to be used in other projects.</entry>
686 <entry>LGPL-2.0</entry>
687</row>
688<row>
689 <entry>gnumail</entry>
690 <entry>1.1.2</entry>
691 <entry>GNU's free implementation of the JavaMail API specification</entry>
692 <entry>GPL-2.0-with-GCC-exception</entry>
693</row>
694<row>
695 <entry>gnutls</entry>
696 <entry>3.5.13</entry>
697 <entry>GNU Transport Layer Security Library.</entry>
698 <entry> GPL-3.0, LGPL-2.1</entry>
699</row>
700<row>
701 <entry>go-capability</entry>
702 <entry>0.0</entry>
703 <entry>Utilities for manipulating POSIX capabilities in Go.</entry>
704 <entry>BSD-2-Clause</entry>
705</row>
706<row>
707 <entry>go-cli</entry>
708 <entry>1.1.0</entry>
709 <entry>A small package for building command line apps in Go</entry>
710 <entry>MIT</entry>
711</row>
712<row>
713 <entry>go-connections</entry>
714 <entry>0.2.1</entry>
715 <entry>Utility package to work with network connections</entry>
716 <entry>Apache-2.0</entry>
717</row>
718<row>
719 <entry>go-context</entry>
720 <entry>git</entry>
721 <entry>A golang registry for global request variables.</entry>
722 <entry>BSD-3-Clause</entry>
723</row>
724<row>
725 <entry>go-cross-x86_64</entry>
726 <entry>1.9.4</entry>
727 <entry> The Go programming language is an open source project to make programmers more productive. Go is expressive concise clean and efficient. Its concurrency mechanisms make it easy to write programs that get the most out of multicore and networked machines while its novel type system enables flexible and modular program construction. Go compiles quickly to machine code yet has the convenience of garbage collection and the power of run-time reflection. It's a fast statically typed compiled language that feels like a dynamically typed interpreted language.</entry>
728 <entry>BSD-3-Clause</entry>
729</row>
730<row>
731 <entry>go-dbus</entry>
732 <entry>4.0.0</entry>
733 <entry>Native Go bindings for D-Bus</entry>
734 <entry>BSD-2-Clause</entry>
735</row>
736<row>
737 <entry>go-distribution</entry>
738 <entry>2.6.0</entry>
739 <entry>The Docker toolset to pack ship store and deliver content</entry>
740 <entry>Apache-2.0</entry>
741</row>
742<row>
743 <entry>go-fsnotify</entry>
744 <entry>1.2.11</entry>
745 <entry>A golang registry for global request variables.</entry>
746 <entry>BSD-3-Clause</entry>
747</row>
748<row>
749 <entry>go-libtrust</entry>
750 <entry>0.0</entry>
751 <entry>Primitives for identity and authorization</entry>
752 <entry>Apache-2.0</entry>
753</row>
754<row>
755 <entry>go-logrus</entry>
756 <entry>0.11.0</entry>
757 <entry>A golang registry for global request variables.</entry>
758 <entry>MIT</entry>
759</row>
760<row>
761 <entry>go-mux</entry>
762 <entry>git</entry>
763 <entry>A powerful URL router and dispatcher for golang.</entry>
764 <entry>BSD-3-Clause</entry>
765</row>
766<row>
767 <entry>go-patricia</entry>
768 <entry>2.2.6</entry>
769 <entry>A generic patricia trie (also called radix tree) implemented in Go (Golang)</entry>
770 <entry>MIT</entry>
771</row>
772<row>
773 <entry>go-pty</entry>
774 <entry>git</entry>
775 <entry>PTY interface for Go</entry>
776 <entry>MIT</entry>
777</row>
778<row>
779 <entry>go-systemd</entry>
780 <entry>4</entry>
781 <entry>Go bindings to systemd socket activation journal D-Bus and unit files</entry>
782 <entry>Apache-2.0</entry>
783</row>
784<row>
785 <entry>go</entry>
786 <entry>1.9.4</entry>
787 <entry> The Go programming language is an open source project to make programmers more productive. Go is expressive concise clean and efficient. Its concurrency mechanisms make it easy to write programs that get the most out of multicore and networked machines while its novel type system enables flexible and modular program construction. Go compiles quickly to machine code yet has the convenience of garbage collection and the power of run-time reflection. It's a fast statically typed compiled language that feels like a dynamically typed interpreted language.</entry>
788 <entry>BSD-3-Clause</entry>
789</row>
790<row>
791 <entry>gobject-introspection</entry>
792 <entry>1.52.1</entry>
793 <entry>Middleware layer between GObject-using C libraries and language bindings.</entry>
794 <entry> LGPL-2.0, GPL-2.0</entry>
795</row>
796<row>
797 <entry>gperf</entry>
798 <entry>3.1</entry>
799 <entry>GNU gperf is a perfect hash function generator</entry>
800 <entry>GPL-3.0</entry>
801</row>
802<row>
803 <entry>gpgme</entry>
804 <entry>1.9.0</entry>
805 <entry>GnuPG Made Easy (GPGME) is a library designed to make access to GnuPG easier for applications. It provides a High-Level Crypto API for encryption decryption signing signature verification and key management</entry>
806 <entry> GPL-2.0, LGPL-2.1</entry>
807</row>
808<row>
809 <entry>gptfdisk</entry>
810 <entry>1.0.3</entry>
811 <entry>GPT fdisk is a disk partitioning tool loosely modeled on Linux fdisk but used for modifying GUID Partition Table (GPT) disks. The related FixParts utility fixes some common problems on Master Boot Record (MBR) disks.</entry>
812 <entry>GPL-2.0</entry>
813</row>
814<row>
815 <entry>grep</entry>
816 <entry>3.1</entry>
817 <entry>GNU grep utility.</entry>
818 <entry>GPL-3.0</entry>
819</row>
820<row>
821 <entry>groff</entry>
822 <entry>1.22.3</entry>
823 <entry>The groff (GNU troff) software is a typesetting package which reads plain text mixed with formatting commands and produces formatted output.</entry>
824 <entry>GPL-3.0</entry>
825</row>
826<row>
827 <entry>grpc-go</entry>
828 <entry>1.4.0</entry>
829 <entry>The Go language implementation of gRPC. HTTP/2 based RPC</entry>
830 <entry>BSD</entry>
831</row>
832<row>
833 <entry>grub-disable-fallback</entry>
834 <entry>1.0</entry>
835 <entry>Enea service to disable grub fallback when boot is successful</entry>
836 <entry>Enea</entry>
837</row>
838<row>
839 <entry>grub-efi</entry>
840 <entry>2.02</entry>
841 <entry>GRUB2 is the next generaion of a GPLed bootloader intended to unify bootloading across x86 operating systems. In addition to loading the Linux kernel it implements the Multiboot standard which allows for flexible loading of multiple boot images.</entry>
842 <entry>GPL-3.0</entry>
843</row>
844<row>
845 <entry>grub</entry>
846 <entry>2.02</entry>
847 <entry>GRUB2 is the next generaion of a GPLed bootloader intended to unify bootloading across x86 operating systems. In addition to loading the Linux kernel it implements the Multiboot standard which allows for flexible loading of multiple boot images.</entry>
848 <entry>GPL-3.0</entry>
849</row>
850<row>
851 <entry>gtk-doc</entry>
852 <entry>1.25</entry>
853 <entry>Gtk-doc is a set of scripts that extract specially formatted comments from glib-based software and produce a set of html documentation files from them</entry>
854 <entry>GPL-2.0</entry>
855</row>
856<row>
857 <entry>gzip</entry>
858 <entry>1.8</entry>
859 <entry>GNU Gzip is a popular data compression program originally written by Jean-loup Gailly for the GNU project. Mark Adler wrote the decompression part</entry>
860 <entry>GPL-3.0</entry>
861</row>
862<row>
863 <entry>help2man</entry>
864 <entry>1.47.4</entry>
865 <entry>Program for creating simple man pages.</entry>
866 <entry>GPL-3.0</entry>
867</row>
868<row>
869 <entry>htop</entry>
870 <entry>1.0.3</entry>
871 <entry>htop process monitor.</entry>
872 <entry>GPL-2.0</entry>
873</row>
874<row>
875 <entry>hugepage-reservation</entry>
876 <entry>1.0</entry>
877 <entry>Reserve hugepages on system startup.</entry>
878 <entry>Enea</entry>
879</row>
880<row>
881 <entry>icedtea7</entry>
882 <entry>2.1.3</entry>
883 <entry>Harness to build the source code from OpenJDK using Free Software build tools</entry>
884 <entry>GPL-2.0-with-classpath-exception</entry>
885</row>
886<row>
887 <entry>icu</entry>
888 <entry>59.1</entry>
889 <entry>The International Component for Unicode (ICU) is a mature portable set of C/C++ and Java libraries for Unicode support software internationalization (I18N) and globalization (G11N) giving applications the same results on all platforms.</entry>
890 <entry>ICU</entry>
891</row>
892<row>
893 <entry>inetlib</entry>
894 <entry>1.1.1</entry>
895 <entry>GNU Classpath inetlib is an extension library to provide extra network protocol support for GNU Classpath and ClasspathX project but it can also used standalone to add http imap pop3 and smtp client support applications. </entry>
896 <entry>GPL-2.0-with-GCC-exception</entry>
897</row>
898<row>
899 <entry>initramfs-framework</entry>
900 <entry>1.0</entry>
901 <entry>Modular initramfs system.</entry>
902 <entry>MIT</entry>
903</row>
904<row>
905 <entry>initramfs-module-install-efi</entry>
906 <entry>1.0</entry>
907 <entry>initramfs-framework module for EFI installation option.</entry>
908 <entry>MIT</entry>
909</row>
910<row>
911 <entry>initramfs-module-install</entry>
912 <entry>1.0</entry>
913 <entry>initramfs-framework module for installation option.</entry>
914 <entry>MIT</entry>
915</row>
916<row>
917 <entry>initramfs-module-setup-live</entry>
918 <entry>1.0</entry>
919 <entry>initramfs-framework module for live booting.</entry>
920 <entry>MIT</entry>
921</row>
922<row>
923 <entry>initramfs-ostree-image</entry>
924 <entry>1.0</entry>
925 <entry>OSTree initramfs image</entry>
926 <entry>MIT</entry>
927</row>
928<row>
929 <entry>inputproto</entry>
930 <entry>2.3.2</entry>
931 <entry>This package provides the wire protocol for the X Input extension. The extension supports input devices other then the core X keyboard and pointer.</entry>
932 <entry> MIT</entry>
933</row>
934<row>
935 <entry>intltool</entry>
936 <entry>0.51.0</entry>
937 <entry>Utility scripts for internationalizing XML.</entry>
938 <entry>GPL-2.0</entry>
939</row>
940<row>
941 <entry>iperf3</entry>
942 <entry>3.2</entry>
943 <entry>iperf is a tool for active measurements of the maximum achievable bandwidth on IP networks. It supports tuning of various parameters related to timing protocols and buffers. For each test it reports the bandwidth loss and other parameters.</entry>
944 <entry>BSD</entry>
945</row>
946<row>
947 <entry>iproute2</entry>
948 <entry>4.11.0</entry>
949 <entry>Iproute2 is a collection of utilities for controlling TCP / IP networking and traffic control in Linux. Of the utilities ip and tc are the most important. ip controls IPv4 and IPv6 configuration and tc stands for traffic control.</entry>
950 <entry>GPL-2.0</entry>
951</row>
952<row>
953 <entry>iptables</entry>
954 <entry>1.6.1</entry>
955 <entry>iptables is the userspace command line program used to configure and control network packet filtering code in Linux.</entry>
956 <entry>GPL-2.0</entry>
957</row>
958<row>
959 <entry>iw</entry>
960 <entry>4.9</entry>
961 <entry>iw is a new nl80211 based CLI configuration utility for wireless devices. It supports almost all new drivers that have been added to the kernel recently. </entry>
962 <entry>BSD</entry>
963</row>
964<row>
965 <entry>jacl</entry>
966 <entry>1.4.1</entry>
967 <entry>Tcl interpreter for Java</entry>
968 <entry> UCB, SUN, AMD, CDS</entry>
969</row>
970<row>
971 <entry>jamvm</entry>
972 <entry>2.0.0-devel</entry>
973 <entry>A compact Java Virtual Machine which conforms to the JVM specification version 2.</entry>
974 <entry>GPL-2.0</entry>
975</row>
976<row>
977 <entry>jansson</entry>
978 <entry>2.9</entry>
979 <entry>Jansson is a C library for encoding decoding and manipulating JSON data.</entry>
980 <entry>MIT</entry>
981</row>
982<row>
983 <entry>jaxp1.3</entry>
984 <entry>1.4.01</entry>
985 <entry>Java XML parser and transformer APIs (DOM SAX JAXP TrAX)</entry>
986 <entry> Apache-2.0, W3C, PD</entry>
987</row>
988<row>
989 <entry>jdepend</entry>
990 <entry>2.9.1</entry>
991 <entry>Design quality metrics generator for each Java</entry>
992 <entry>BSD</entry>
993</row>
994<row>
995 <entry>jikes-initial</entry>
996 <entry>1.0</entry>
997 <entry>Initial Java 1.4-compatible (and not higher) compiler.</entry>
998 <entry>MIT</entry>
999</row>
1000<row>
1001 <entry>jikes</entry>
1002 <entry>1.22</entry>
1003 <entry>Java compiler adhering to language and VM specifications</entry>
1004 <entry>IPL-1.0</entry>
1005</row>
1006<row>
1007 <entry>jlex</entry>
1008 <entry>1.2.6</entry>
1009 <entry>Lexical analyzer generator for Java</entry>
1010 <entry>JLEX</entry>
1011</row>
1012<row>
1013 <entry>jsch</entry>
1014 <entry>0.1.40</entry>
1015 <entry>SSH implementation in Java</entry>
1016 <entry>BSD</entry>
1017</row>
1018<row>
1019 <entry>junit</entry>
1020 <entry>3.8.2</entry>
1021 <entry>JUnit is a testing framework for Java</entry>
1022 <entry>CPL-1.0</entry>
1023</row>
1024<row>
1025 <entry>jzlib</entry>
1026 <entry>1.0.7</entry>
1027 <entry>zlib implementation in Java</entry>
1028 <entry>BSD</entry>
1029</row>
1030<row>
1031 <entry>kbd</entry>
1032 <entry>2.0.4</entry>
1033 <entry>Keytable files and keyboard utilities.</entry>
1034 <entry>GPL-2.0</entry>
1035</row>
1036<row>
1037 <entry>kbproto</entry>
1038 <entry>1.0.7</entry>
1039 <entry>This package provides the wire protocol for the X Keyboard extension. This extension is used to control options related to keyboard handling and layout.</entry>
1040 <entry>MIT</entry>
1041</row>
1042<row>
1043 <entry>kern-tools</entry>
1044 <entry>0.2</entry>
1045 <entry>Tools for managing Yocto Project style branched kernels.</entry>
1046 <entry>GPL-2.0</entry>
1047</row>
1048<row>
1049 <entry>keymaps</entry>
1050 <entry>1.0</entry>
1051 <entry>Keymaps and initscript to set the keymap on bootup.</entry>
1052 <entry>GPL-2.0</entry>
1053</row>
1054<row>
1055 <entry>keyutils</entry>
1056 <entry>1.5.10</entry>
1057 <entry> Utilities to control the kernel key management facility and to provide a mechanism by which the kernel call back to userspace to get a key instantiated. </entry>
1058 <entry> LGPL-2.1, GPL-2.0</entry>
1059</row>
1060<row>
1061 <entry>kmod</entry>
1062 <entry>24</entry>
1063 <entry>kmod is a set of tools to handle common tasks with Linux kernel modules like insert remove list check properties resolve dependencies and aliases.</entry>
1064 <entry> GPL-2.0, LGPL-2.1</entry>
1065</row>
1066<row>
1067 <entry>krb5</entry>
1068 <entry>1.15.1</entry>
1069 <entry>"Kerberos is a system for authenticating users and services on a network. Kerberos is a trusted third-party service. That means that there is a third party (the Kerberos server) that is trusted by all the entities on the network (users and services usually called ""principals""). . This is the MIT reference implementation of Kerberos V5. . This package contains the Kerberos key server (KDC). The KDC manages all authentication credentials for a Kerberos realm holds the master keys for the realm and responds to authentication requests. This package should be installed on both master and slave KDCs."</entry>
1070 <entry>MIT</entry>
1071</row>
1072<row>
1073 <entry>ldconfig</entry>
1074 <entry>2.12.1</entry>
1075 <entry>A standalone native ldconfig build.</entry>
1076 <entry>GPL-2.0</entry>
1077</row>
1078<row>
1079 <entry>libaio</entry>
1080 <entry>0.3.110</entry>
1081 <entry>Asynchronous input/output library that uses the kernels native interface</entry>
1082 <entry>LGPL-2.1</entry>
1083</row>
1084<row>
1085 <entry>libarchive</entry>
1086 <entry>3.3.2</entry>
1087 <entry>C library and command-line tools for reading and writing tar cpio zip ISO and other archive formats</entry>
1088 <entry>BSD</entry>
1089</row>
1090<row>
1091 <entry>libassuan</entry>
1092 <entry>2.4.3</entry>
1093 <entry>IPC library used by GnuPG and GPGME.</entry>
1094 <entry> GPL-3.0, LGPL-2.1</entry>
1095</row>
1096<row>
1097 <entry>libbsd</entry>
1098 <entry>0.8.6</entry>
1099 <entry>This library provides useful functions commonly found on BSD systems and lacking on others like GNU systems thus making it easier to port projects with strong BSD origins without needing to embed the same code over and over again on each project.</entry>
1100 <entry> BSD-4-Clause, ISC, PD</entry>
1101</row>
1102<row>
1103 <entry>libcap</entry>
1104 <entry>2.25</entry>
1105 <entry>Library for getting/setting POSIX.1e capabilities.</entry>
1106 <entry> BSD, GPL-2.0</entry>
1107</row>
1108<row>
1109 <entry>libcgroup</entry>
1110 <entry>0.41</entry>
1111 <entry>libcgroup is a library that abstracts the control group file system in Linux. Control groups allow you to limit account and isolate resource usage (CPU memory disk I/O etc.) of groups of processes.</entry>
1112 <entry>LGPL-2.1</entry>
1113</row>
1114<row>
1115 <entry>libcheck</entry>
1116 <entry>0.10.0</entry>
1117 <entry>Check - unit testing framework for C code.</entry>
1118 <entry>LGPL-2.1</entry>
1119</row>
1120<row>
1121 <entry>libdaemon</entry>
1122 <entry>0.14</entry>
1123 <entry>Lightweight C library which eases the writing of UNIX daemons.</entry>
1124 <entry>LGPL-2.1</entry>
1125</row>
1126<row>
1127 <entry>libdevmapper</entry>
1128 <entry>2.02.171</entry>
1129 <entry>LVM2 is a set of utilities to manage logical volumes in Linux.</entry>
1130 <entry> GPL-2.0, LGPL-2.0</entry>
1131</row>
1132<row>
1133 <entry>libecj-bootstrap</entry>
1134 <entry>3.6.2</entry>
1135 <entry>JDT Core Batch Compiler - Jar only</entry>
1136 <entry>EPL-1.0</entry>
1137</row>
1138<row>
1139 <entry>libevent</entry>
1140 <entry>2.1.8</entry>
1141 <entry>An asynchronous event notification library.</entry>
1142 <entry> BSD, MIT</entry>
1143</row>
1144<row>
1145 <entry>libffi</entry>
1146 <entry>3.2.1</entry>
1147 <entry>The `libffi' library provides a portable high level programming interface to various calling conventions. This allows a programmer to call any function specified by a call interface description at run time. FFI stands for Foreign Function Interface. A foreign function interface is the popular name for the interface that allows code written in one language to call code written in another language. The `libffi' library really only provides the lowest machine dependent layer of a fully featured foreign function interface. A layer must exist above `libffi' that handles type conversions for values passed between the two languages.</entry>
1148 <entry>MIT</entry>
1149</row>
1150<row>
1151 <entry>libfile-slurp-perl</entry>
1152 <entry>9999.19</entry>
1153 <entry>This module provides subroutines to read or write entire files with a simple call. It also has a subroutine for reading the list of filenames in a directory. </entry>
1154 <entry> Artistic-1.0, GPL-1.0</entry>
1155</row>
1156<row>
1157 <entry>libgcc</entry>
1158 <entry>7.3.0</entry>
1159 <entry>GNU cc and gcc C compilers.</entry>
1160 <entry>GPL-3.0-with-GCC-exception</entry>
1161</row>
1162<row>
1163 <entry>libgcrypt</entry>
1164 <entry>1.8.0</entry>
1165 <entry>General purpose cryptographic library based on the code from GnuPG.</entry>
1166 <entry> GPL-2.0, LGPL-2.1, GPL-3.0</entry>
1167</row>
1168<row>
1169 <entry>libgpg-error</entry>
1170 <entry>1.27</entry>
1171 <entry>Small library that defines common error values for all GnuPG components.</entry>
1172 <entry> GPL-2.0, LGPL-2.1</entry>
1173</row>
1174<row>
1175 <entry>libgudev</entry>
1176 <entry>231</entry>
1177 <entry>GObject wrapper for libudev.</entry>
1178 <entry>LGPL-2.1</entry>
1179</row>
1180<row>
1181 <entry>libice</entry>
1182 <entry>1.0.9</entry>
1183 <entry>The Inter-Client Exchange (ICE) protocol provides a generic framework for building protocols on top of reliable byte-stream transport connections. It provides basic mechanisms for setting up and shutting down connections for performing authentication for negotiating versions and for reporting errors. </entry>
1184 <entry>MIT</entry>
1185</row>
1186<row>
1187 <entry>libidn</entry>
1188 <entry>1.33</entry>
1189 <entry>Implementation of the Stringprep Punycode and IDNA specifications defined by the IETF Internationalized Domain Names (IDN) working group.</entry>
1190 <entry> LGPL-2.1, LGPL-3.0, GPL-3.0</entry>
1191</row>
1192<row>
1193 <entry>libjpeg-turbo</entry>
1194 <entry>1.5.2</entry>
1195 <entry>libjpeg-turbo is a derivative of libjpeg that uses SIMD instructions (MMX SSE2 NEON) to accelerate baseline JPEG compression and decompression</entry>
1196 <entry>BSD-3-Clause</entry>
1197</row>
1198<row>
1199 <entry>libmbim</entry>
1200 <entry>1.16.0</entry>
1201 <entry>libmbim is a glib-based library for talking to WWAN modems and devices which speak the Mobile Interface Broadband Model (MBIM) protocol</entry>
1202 <entry> GPL-2.0, LGPL-2.1</entry>
1203</row>
1204<row>
1205 <entry>libmnl</entry>
1206 <entry>1.0.4</entry>
1207 <entry>Minimalistic user-space library oriented to Netlink developers providing functions for common tasks in parsing validating and constructing both the Netlink header and TLVs.</entry>
1208 <entry>LGPL-2.1</entry>
1209</row>
1210<row>
1211 <entry>libmpc</entry>
1212 <entry>1.0.3</entry>
1213 <entry>Mpc is a C library for the arithmetic of complex numbers with arbitrarily high precision and correct rounding of the result. It is built upon and follows the same principles as Mpfr</entry>
1214 <entry>LGPL-3.0</entry>
1215</row>
1216<row>
1217 <entry>libndp</entry>
1218 <entry>1.6</entry>
1219 <entry>Library for IPv6 Neighbor Discovery Protocol.</entry>
1220 <entry>LGPL-2.1</entry>
1221</row>
1222<row>
1223 <entry>libnewt</entry>
1224 <entry>0.52.20</entry>
1225 <entry>Newt is a programming library for color text mode widget based user interfaces. Newt can be used to add stacked windows entry widgets checkboxes radio buttons labels plain text fields scrollbars etc. to text mode user interfaces. This package also contains the shared library needed by programs built with newt as well as a /usr/bin/dialog replacement called whiptail. Newt is based on the slang library.</entry>
1226 <entry>LGPL-2.0</entry>
1227</row>
1228<row>
1229 <entry>libnl</entry>
1230 <entry>3.4.0</entry>
1231 <entry>A library for applications dealing with netlink sockets.</entry>
1232 <entry>LGPL-2.1</entry>
1233</row>
1234<row>
1235 <entry>libnss-mdns</entry>
1236 <entry>0.10</entry>
1237 <entry>Name Service Switch module for Multicast DNS (zeroconf) name resolution.</entry>
1238 <entry>LGPL-2.1</entry>
1239</row>
1240<row>
1241 <entry>libpcap</entry>
1242 <entry>1.8.1</entry>
1243 <entry>Libpcap provides a portable framework for low-level network monitoring. Libpcap can provide network statistics collection security monitoring and network debugging.</entry>
1244 <entry>BSD</entry>
1245</row>
1246<row>
1247 <entry>libpciaccess</entry>
1248 <entry>0.13.5</entry>
1249 <entry>libpciaccess provides functionality for X to access the PCI bus and devices in a platform-independent way.</entry>
1250 <entry> MIT</entry>
1251</row>
1252<row>
1253 <entry>libpcre</entry>
1254 <entry>8.41</entry>
1255 <entry>The PCRE library is a set of functions that implement regular expression pattern matching using the same syntax and semantics as Perl 5. PCRE has its own native API as well as a set of wrapper functions that correspond to the POSIX regular expression API.</entry>
1256 <entry>BSD</entry>
1257</row>
1258<row>
1259 <entry>libpng</entry>
1260 <entry>1.6.31</entry>
1261 <entry>PNG image format decoding library.</entry>
1262 <entry>Libpng</entry>
1263</row>
1264<row>
1265 <entry>libpthread-stubs</entry>
1266 <entry>0.4</entry>
1267 <entry>This library provides weak aliases for pthread functions not provided in libc or otherwise available by default.</entry>
1268 <entry>MIT</entry>
1269</row>
1270<row>
1271 <entry>libqmi</entry>
1272 <entry>1.20.2</entry>
1273 <entry>libqmi is a glib-based library for talking to WWAN modems and devices which speak the Qualcomm MSM Interface (QMI) protocol</entry>
1274 <entry> GPL-2.0, LGPL-2.1</entry>
1275</row>
1276<row>
1277 <entry>libsdl</entry>
1278 <entry>1.2.15</entry>
1279 <entry>Simple DirectMedia Layer is a cross-platform multimedia library designed to provide low level access to audio keyboard mouse joystick 3D hardware via OpenGL and 2D video framebuffer.</entry>
1280 <entry>LGPL-2.1</entry>
1281</row>
1282<row>
1283 <entry>libsign</entry>
1284 <entry>0.3.2</entry>
1285 <entry>This project targets to provide a generic signing framework. This framework separates the signing request and signing process and correspondingly forms the so-called signlet and signaturelet. Each signaturelet only concerns about the details about how to construct the layout of a signature format and signlet only cares how to construct the signing request. </entry>
1286 <entry>BSD-3-Clause</entry>
1287</row>
1288<row>
1289 <entry>libsm</entry>
1290 <entry>1.2.2</entry>
1291 <entry>"The Session Management Library (SMlib) is a low-level \""C\"" language interface to XSMP. The purpose of the X Session Management Protocol (XSMP) is to provide a uniform mechanism for users to save and restore their sessions. A session is a group of clients each of which has a particular state."</entry>
1292 <entry>MIT</entry>
1293</row>
1294<row>
1295 <entry>libtasn1</entry>
1296 <entry>4.12</entry>
1297 <entry>Library for ASN.1 and DER manipulation.</entry>
1298 <entry> GPL-3.0, LGPL-2.1</entry>
1299</row>
1300<row>
1301 <entry>libtool</entry>
1302 <entry>2.4.6</entry>
1303 <entry>This is GNU libtool a generic library support script. Libtool hides the complexity of generating special library types (such as shared libraries) behind a consistent interface.</entry>
1304 <entry> GPL-2.0, LGPL-2.1</entry>
1305</row>
1306<row>
1307 <entry>libunistring</entry>
1308 <entry>0.9.7</entry>
1309 <entry>Text files are nowadays usually encoded in Unicode and may consist of very different scripts from Latin letters to Chinese Hanzi with many kinds of special characters accents right-to-left writing marks hyphens Roman numbers and much more. But the POSIX platform APIs for text do not contain adequate functions for dealing with particular properties of many Unicode characters. In fact the POSIX APIs for text have several assumptions at their base which don't hold for Unicode text. This library provides functions for manipulating Unicode strings and for manipulating C strings according to the Unicode standard. This package contains documentation.</entry>
1310 <entry> LGPL-3.0, GPL-2.0</entry>
1311</row>
1312<row>
1313 <entry>libusb-compat</entry>
1314 <entry>0.1.5</entry>
1315 <entry>libusb-0.1 compatible layer for libusb1 a drop-in replacement that aims to look feel and behave exactly like libusb-0.1</entry>
1316 <entry>LGPL-2.1</entry>
1317</row>
1318<row>
1319 <entry>libusb1</entry>
1320 <entry>1.0.21</entry>
1321 <entry>Userspace library to access USB (version 1.0).</entry>
1322 <entry>LGPL-2.1</entry>
1323</row>
1324<row>
1325 <entry>libvirt</entry>
1326 <entry>4.2.0</entry>
1327 <entry>A toolkit to interact with the virtualization capabilities of recent versions of Linux.</entry>
1328 <entry> LGPL-2.1, GPL-2.0</entry>
1329</row>
1330<row>
1331 <entry>libx11</entry>
1332 <entry>1.6.5</entry>
1333 <entry>This package provides a client interface to the X Window System otherwise known as 'Xlib'. It provides a complete API for the basic functions of the window system.</entry>
1334 <entry> MIT, BSD</entry>
1335</row>
1336<row>
1337 <entry>libxau</entry>
1338 <entry>1.0.8</entry>
1339 <entry>libxau provides the main interfaces to the X11 authorisation handling which controls authorisation for X connections both client-side and server-side.</entry>
1340 <entry>MIT</entry>
1341</row>
1342<row>
1343 <entry>libxcb</entry>
1344 <entry>1.12</entry>
1345 <entry>The X protocol C-language Binding (XCB) is a replacement for Xlib featuring a small footprint latency hiding direct access to the protocol improved threading support and extensibility.</entry>
1346 <entry>MIT</entry>
1347</row>
1348<row>
1349 <entry>libxdmcp</entry>
1350 <entry>1.1.2</entry>
1351 <entry>The purpose of the X Display Manager Control Protocol (XDMCP) is to provide a uniform mechanism for an autonomous display to request login service from a remote host. An X terminal (screen keyboard mouse processor network interface) is a prime example of an autonomous display.</entry>
1352 <entry>MIT</entry>
1353</row>
1354<row>
1355 <entry>libxext</entry>
1356 <entry>1.3.3</entry>
1357 <entry>libXext provides an X Window System client interface to several extensions to the X protocol. The supported protocol extensions are DOUBLE-BUFFER DPMS Extended-Visual-Information LBX MIT_SHM MIT_SUNDRY-NONSTANDARD Multi-Buffering SECURITY SHAPE SYNC TOG-CUP XC-APPGROUP XC-MISC XTEST. libXext also provides a small set of utility functions to aid authors of client APIs for X protocol extensions.</entry>
1358 <entry>MIT</entry>
1359</row>
1360<row>
1361 <entry>libxkbcommon</entry>
1362 <entry>0.7.1</entry>
1363 <entry>libxkbcommon is a keymap compiler and support library which processes a reduced subset of keymaps as defined by the XKB specification.</entry>
1364 <entry> MIT</entry>
1365</row>
1366<row>
1367 <entry>libxml-parser-perl</entry>
1368 <entry>2.44</entry>
1369 <entry>XML::Parser - A perl module for parsing XML documents.</entry>
1370 <entry> Artistic-1.0, GPL-1.0</entry>
1371</row>
1372<row>
1373 <entry>libxml2</entry>
1374 <entry>2.9.5</entry>
1375 <entry>The XML Parser Library allows for manipulation of XML files. Libxml2 exports Push and Pull type parser interfaces for both XML and HTML. It can do DTD validation at parse time on a parsed document instance or with an arbitrary DTD. Libxml2 includes complete XPath XPointer and Xinclude implementations. It also has a SAX like interface which is designed to be compatible with Expat.</entry>
1376 <entry>MIT</entry>
1377</row>
1378<row>
1379 <entry>libxrandr</entry>
1380 <entry>1.5.1</entry>
1381 <entry>The X Resize Rotate and Reflect Extension called RandR for short brings the ability to resize rotate and reflect the root window of a screen. It is based on the X Resize and Rotate Extension as specified in the Proceedings of the 2001 Usenix Technical Conference [RANDR].</entry>
1382 <entry>MIT</entry>
1383</row>
1384<row>
1385 <entry>libxrender</entry>
1386 <entry>0.9.10</entry>
1387 <entry>The X Rendering Extension (Render) introduces digital image composition as the foundation of a new rendering model within the X Window System. Rendering geometric figures is accomplished by client-side tessellation into either triangles or trapezoids. Text is drawn by loading glyphs into the server and rendering sets of them.</entry>
1388 <entry>MIT</entry>
1389</row>
1390<row>
1391 <entry>libxslt</entry>
1392 <entry>1.1.29</entry>
1393 <entry>GNOME XSLT library.</entry>
1394 <entry>MIT</entry>
1395</row>
1396<row>
1397 <entry>libyaml</entry>
1398 <entry>0.1.7</entry>
1399 <entry>LibYAML is a C library for parsing and emitting data in YAML 1.1 a human-readable data serialization format. </entry>
1400 <entry>MIT</entry>
1401</row>
1402<row>
1403 <entry>linux-firmware</entry>
1404 <entry>0.0</entry>
1405 <entry>Firmware files for use with Linux kernel.</entry>
1406 <entry>Redistributable binaries</entry>
1407</row>
1408<row>
1409 <entry>linux-intel-guest</entry>
1410 <entry>4.14.123</entry>
1411 <entry>Linux kernel.</entry>
1412 <entry>GPL-2.0</entry>
1413</row>
1414<row>
1415 <entry>linux-intel-host</entry>
1416 <entry>4.14.123</entry>
1417 <entry>Linux kernel.</entry>
1418 <entry>GPL-2.0</entry>
1419</row>
1420<row>
1421 <entry>linux-libc-headers</entry>
1422 <entry>4.12</entry>
1423 <entry>Sanitized set of kernel headers for the C library's use.</entry>
1424 <entry>GPL-2.0</entry>
1425</row>
1426<row>
1427 <entry>log4j1.2</entry>
1428 <entry>1.2.17</entry>
1429 <entry>Java library to help the programmer output log statements to a variety of output targets</entry>
1430 <entry>Apache-2.0</entry>
1431</row>
1432<row>
1433 <entry>logkit</entry>
1434 <entry>1.2.2</entry>
1435 <entry>Logging toolkit designed for secure performance orientated logging in Java applications</entry>
1436 <entry>Apache-2.0</entry>
1437</row>
1438<row>
1439 <entry>logrotate</entry>
1440 <entry>3.12.3</entry>
1441 <entry>Rotates compresses removes and mails system log files.</entry>
1442 <entry>GPL-2.0</entry>
1443</row>
1444<row>
1445 <entry>lsb</entry>
1446 <entry>4.1</entry>
1447 <entry>LSB support for OpenEmbedded.</entry>
1448 <entry>GPL-2.0</entry>
1449</row>
1450<row>
1451 <entry>lsbinitscripts</entry>
1452 <entry>9.72</entry>
1453 <entry>SysV init scripts which are only used in an LSB image.</entry>
1454 <entry>GPL-2.0</entry>
1455</row>
1456<row>
1457 <entry>lshw</entry>
1458 <entry>02.17</entry>
1459 <entry>A small tool to provide detailed information on the hardware configuration of the machine. It can report exact memory configuration firmware version mainboard configuration CPU version and speed cache configuration bus speed etc. on DMI-capable or EFI systems.</entry>
1460 <entry>GPL-2.0</entry>
1461</row>
1462<row>
1463 <entry>lsof</entry>
1464 <entry>4.89</entry>
1465 <entry>Lsof is a Unix-specific diagnostic tool. Its name stands for LiSt Open Files and it does just that.</entry>
1466 <entry>BSD</entry>
1467</row>
1468<row>
1469 <entry>lvm2</entry>
1470 <entry>2.02.171</entry>
1471 <entry>LVM2 is a set of utilities to manage logical volumes in Linux.</entry>
1472 <entry> GPL-2.0, LGPL-2.0</entry>
1473</row>
1474<row>
1475 <entry>lxc</entry>
1476 <entry>2.0.8</entry>
1477 <entry>lxc aims to use these new functionnalities to provide an userspace container object</entry>
1478 <entry>GPL-2.0</entry>
1479</row>
1480<row>
1481 <entry>lxd</entry>
1482 <entry>git</entry>
1483 <entry>"LXD is a container ""hypervisor"" and a new user experience for LXC Specifically it's made of three components: - A system-wide daemon (lxd) - A command line client (lxc) - An OpenStack Nova plugin (nova-compute-lxd)"</entry>
1484 <entry>Apache-2.0</entry>
1485</row>
1486<row>
1487 <entry>lz4</entry>
1488 <entry>1.7.4</entry>
1489 <entry>LZ4 is a very fast lossless compression algorithm providing compression speed at 400 MB/s per core scalable with multi-cores CPU. It also features an extremely fast decoder with speed in multiple GB/s per core typically reaching RAM speed limits on multi-core systems.</entry>
1490 <entry> BSD, BSD-2-Clause, GPL-2.0</entry>
1491</row>
1492<row>
1493 <entry>lzo</entry>
1494 <entry>2.10</entry>
1495 <entry>Lossless data compression library.</entry>
1496 <entry>GPL-2.0</entry>
1497</row>
1498<row>
1499 <entry>lzop</entry>
1500 <entry>1.03</entry>
1501 <entry>lzop is a compression utility which is designed to be a companion to gzip. \nIt is based on the LZO data compression library and its main advantages over \ngzip are much higher compression and decompression speed at the cost of some \ncompression ratio. The lzop compression utility was designed with the goals \nof reliability speed portability and with reasonable drop-in compatibility \nto gzip.</entry>
1502 <entry>GPL-2.0</entry>
1503</row>
1504<row>
1505 <entry>m4</entry>
1506 <entry>1.4.18</entry>
1507 <entry>GNU m4 is an implementation of the traditional Unix macro processor. It is mostly SVR4 compatible although it has some extensions (for example handling more than 9 positional parameters to macros). GNU M4 also has built-in functions for including files running shell commands doing arithmetic etc.</entry>
1508 <entry>GPL-3.0</entry>
1509</row>
1510<row>
1511 <entry>make</entry>
1512 <entry>4.2.1</entry>
1513 <entry>Make is a tool which controls the generation of executables and other non-source files of a program from the program's source files. Make gets its knowledge of how to build your program from a file called the makefile which lists each of the non-source files and how to compute it from other files.</entry>
1514 <entry> GPL-3.0, LGPL-2.0</entry>
1515</row>
1516<row>
1517 <entry>makedepend</entry>
1518 <entry>1.0.5</entry>
1519 <entry>The makedepend program reads each sourcefile in sequence and parses it like a C-preprocessor processing all #include #define #undef #ifdef #ifndef #endif #if #elif and #else directives so that it can correctly tell which #include directives would be used in a compilation. Any #include directives can reference files having other #include directives and parsing will occur in these files as well.</entry>
1520 <entry>MIT</entry>
1521</row>
1522<row>
1523 <entry>makedevs</entry>
1524 <entry>1.0.1</entry>
1525 <entry>Tool for creating device nodes.</entry>
1526 <entry>GPL-2.0</entry>
1527</row>
1528<row>
1529 <entry>mklibs</entry>
1530 <entry>0.1.43</entry>
1531 <entry>mklibs produces cut-down shared libraries that contain only the routines required by a particular set of executables.</entry>
1532 <entry>GPL-2.0</entry>
1533</row>
1534<row>
1535 <entry>modemmanager</entry>
1536 <entry>1.7.991</entry>
1537 <entry>ModemManager is a DBus-activated daemon which controls mobile broadband (2G/3G/4G) devices and connections</entry>
1538 <entry> GPL-2.0, LGPL-2.1</entry>
1539</row>
1540<row>
1541 <entry>mokutil</entry>
1542 <entry>0.3.0</entry>
1543 <entry>The utility to manipulate machines owner keys which managed in shim.</entry>
1544 <entry>GPL-3.0</entry>
1545</row>
1546<row>
1547 <entry>mozjs</entry>
1548 <entry>17.0.0</entry>
1549 <entry>SpiderMonkey is Mozilla's JavaScript engine written in C/C++.</entry>
1550 <entry>MPL-2.0</entry>
1551</row>
1552<row>
1553 <entry>mpfr</entry>
1554 <entry>3.1.5</entry>
1555 <entry>C library for multiple-precision floating-point computations with exact rounding.</entry>
1556 <entry> GPL-3.0, LGPL-3.0</entry>
1557</row>
1558<row>
1559 <entry>mtools</entry>
1560 <entry>4.0.18</entry>
1561 <entry>Mtools is a collection of utilities to access MS-DOS disks from GNU and Unix without mounting them.</entry>
1562 <entry>GPL-3.0</entry>
1563</row>
1564<row>
1565 <entry>nasm</entry>
1566 <entry>2.13.01</entry>
1567 <entry>General-purpose x86 assembler.</entry>
1568 <entry>BSD-2-Clause</entry>
1569</row>
1570<row>
1571 <entry>ncurses</entry>
1572 <entry>6.0</entry>
1573 <entry>SVr4 and XSI-Curses compatible curses library and terminfo tools including tic infocmp captoinfo. Supports color multiple highlights forms-drawing characters and automatic recognition of keypad and function-key sequences. Extensions include resizable windows and mouse support on both xterm and Linux console using the gpm library.</entry>
1574 <entry>MIT</entry>
1575</row>
1576<row>
1577 <entry>net-snmp</entry>
1578 <entry>5.7.3</entry>
1579 <entry>Various tools relating to the Simple Network Management Protocol.</entry>
1580 <entry>BSD</entry>
1581</row>
1582<row>
1583 <entry>netbase</entry>
1584 <entry>5.4</entry>
1585 <entry>This package provides the necessary infrastructure for basic TCP/IP based networking</entry>
1586 <entry>GPL-2.0</entry>
1587</row>
1588<row>
1589 <entry>netcat-openbsd</entry>
1590 <entry>1.105</entry>
1591 <entry>A simple Unix utility which reads and writes data across network connections using TCP or UDP protocol. It is designed to be a reliable 'back-end' tool that can be used directly or easily driven by other programs and scripts. At the same time it is a feature-rich network debugging and exploration tool since it can create almost any kind of connection you would need and has several interesting built-in capabilities.</entry>
1592 <entry>BSD-3-Clause</entry>
1593</row>
1594<row>
1595 <entry>netcf</entry>
1596 <entry>0.2.8</entry>
1597 <entry>netcf is a cross-platform network configuration library.</entry>
1598 <entry>LGPL-2.1</entry>
1599</row>
1600<row>
1601 <entry>nettle</entry>
1602 <entry>3.3</entry>
1603 <entry>A low level cryptographic library.</entry>
1604 <entry> LGPL-3.0, GPL-2.0</entry>
1605</row>
1606<row>
1607 <entry>networkmanager</entry>
1608 <entry>1.10.10</entry>
1609 <entry>NetworkManager.</entry>
1610 <entry>GPL-2.0</entry>
1611</row>
1612<row>
1613 <entry>nfv-init</entry>
1614 <entry>1.0</entry>
1615 <entry>Enea service expected to be run after cloud-init</entry>
1616 <entry>Enea</entry>
1617</row>
1618<row>
1619 <entry>nfv-installer</entry>
1620 <entry>1.0</entry>
1621 <entry>Enea NFV Access installer</entry>
1622 <entry>Enea</entry>
1623</row>
1624<row>
1625 <entry>nfva-startup</entry>
1626 <entry>1.0</entry>
1627 <entry>Service that configures the network according to installer settings</entry>
1628 <entry>Enea</entry>
1629</row>
1630<row>
1631 <entry>notary</entry>
1632 <entry>0.4.2</entry>
1633 <entry>Notary is a Docker project that allows anyone to have trust over arbitrary collections of data</entry>
1634 <entry>Apache-2.0</entry>
1635</row>
1636<row>
1637 <entry>nspr</entry>
1638 <entry>4.16</entry>
1639 <entry>Netscape Portable Runtime Library.</entry>
1640 <entry> GPL-2.0, MPL-2.0, LGPL-2.1</entry>
1641</row>
1642<row>
1643 <entry>nss</entry>
1644 <entry>3.31.1</entry>
1645 <entry>Network Security Services (NSS) is a set of libraries designed to support cross-platform development of security-enabled client and server applications. Applications built with NSS can support SSL v2 and v3 TLS PKCS 5 PKCS 7 PKCS 11 PKCS 12 S/MIME X.509 v3 certificates and other security standards.</entry>
1646 <entry> MPL-2.0, GPL-2.0, MPL-2.0, LGPL-2.1</entry>
1647</row>
1648<row>
1649 <entry>ntp</entry>
1650 <entry>4.2.8p10</entry>
1651 <entry>The Network Time Protocol (NTP) is used to synchronize the time of a computer client or server to another server or reference time source such as a radio or satellite receiver or modem.</entry>
1652 <entry>NTP</entry>
1653</row>
1654<row>
1655 <entry>numactl</entry>
1656 <entry>2.0.11</entry>
1657 <entry>Simple NUMA policy support. It consists of a numactl program to run other programs with a specific NUMA policy and a libnuma to do allocations with NUMA policy in applications.</entry>
1658 <entry> GPL-2.0, LGPL-2.1</entry>
1659</row>
1660<row>
1661 <entry>openjdk-8</entry>
1662 <entry>102b14</entry>
1663 <entry>Java runtime based upon the OpenJDK Project</entry>
1664 <entry>GPL-2.0-with-classpath-exception</entry>
1665</row>
1666<row>
1667 <entry>openssh</entry>
1668 <entry>7.5p1</entry>
1669 <entry>Secure rlogin/rsh/rcp/telnet replacement (OpenSSH) Ssh (Secure Shell) is a program for logging into a remote machine and for executing commands on a remote machine.</entry>
1670 <entry>BSD</entry>
1671</row>
1672<row>
1673 <entry>openssl</entry>
1674 <entry>1.0.2o</entry>
1675 <entry>Secure Socket Layer (SSL) binary and related cryptographic tools.</entry>
1676 <entry>OpenSSL</entry>
1677</row>
1678<row>
1679 <entry>openvswitch</entry>
1680 <entry>2.9</entry>
1681 <entry> Open vSwitch is a production quality multilayer virtual switch licensed under the open source Apache 2.0 license. It is designed to enable massive network automation through programmatic extension while still supporting standard management interfaces and protocols (e.g. NetFlow sFlow SPAN RSPAN CLI LACP 802.1ag) </entry>
1682 <entry>Apache-2.0</entry>
1683</row>
1684<row>
1685 <entry>opkg-utils</entry>
1686 <entry>0.3.5</entry>
1687 <entry>Additional utilities for the opkg package manager.</entry>
1688 <entry>GPL-2.0</entry>
1689</row>
1690<row>
1691 <entry>oro</entry>
1692 <entry>2.0.8</entry>
1693 <entry>Perl5-compatible regular expressions library for Java</entry>
1694 <entry>Apache-2.0</entry>
1695</row>
1696<row>
1697 <entry>os-release</entry>
1698 <entry>1.0</entry>
1699 <entry>The /etc/os-release file contains operating system identification data.</entry>
1700 <entry>MIT</entry>
1701</row>
1702<row>
1703 <entry>ostree-initrd</entry>
1704 <entry>3</entry>
1705 <entry>Extremely basic live image init script.</entry>
1706 <entry>MIT</entry>
1707</row>
1708<row>
1709 <entry>ostree-rw</entry>
1710 <entry>1.0</entry>
1711 <entry>Enea bash script to make current ostree hash writable</entry>
1712 <entry>Enea</entry>
1713</row>
1714<row>
1715 <entry>ostree</entry>
1716 <entry>v2018.7</entry>
1717 <entry>Tool for managing bootable immutable versioned filesystem trees.</entry>
1718 <entry>LGPL-2.0</entry>
1719</row>
1720<row>
1721 <entry>packagegroup-core-boot</entry>
1722 <entry>1.0</entry>
1723 <entry>The minimal set of packages required to boot the system</entry>
1724 <entry>MIT</entry>
1725</row>
1726<row>
1727 <entry>packagegroup-core-ssh-openssh</entry>
1728 <entry>1.0</entry>
1729 <entry>OpenSSH SSH client/server.</entry>
1730 <entry>MIT</entry>
1731</row>
1732<row>
1733 <entry>packagegroup-efi-secure-boot</entry>
1734 <entry>1.0</entry>
1735 <entry>EFI Secure Boot packages for secure-environment.</entry>
1736 <entry>MIT</entry>
1737</row>
1738<row>
1739 <entry>packagegroup-enea-virtualization-4gusb-modems</entry>
1740 <entry>1.0</entry>
1741 <entry>Packagegroup for 4G usb modems.</entry>
1742 <entry>MIT</entry>
1743</row>
1744<row>
1745 <entry>packagegroup-enea-virtualization-docker</entry>
1746 <entry>1.0</entry>
1747 <entry>Packagegroup for Docker.</entry>
1748 <entry>MIT</entry>
1749</row>
1750<row>
1751 <entry>packagegroup-enea-virtualization-dpdk</entry>
1752 <entry>1.0</entry>
1753 <entry>Packagegroup for DPDK.</entry>
1754 <entry>MIT</entry>
1755</row>
1756<row>
1757 <entry>packagegroup-enea-virtualization-guest</entry>
1758 <entry>1.0</entry>
1759 <entry>This package group includes packages and packagegroups specific to the guest side of the Enea Linux Virtualization Profile.</entry>
1760 <entry>MIT</entry>
1761</row>
1762<row>
1763 <entry>packagegroup-enea-virtualization-host</entry>
1764 <entry>1.0</entry>
1765 <entry>This package group includes packages and packagegroups specific to the host side of the Enea Linux Virtualization Profile.</entry>
1766 <entry>MIT</entry>
1767</row>
1768<row>
1769 <entry>packagegroup-enea-virtualization-libvirt</entry>
1770 <entry>1.0</entry>
1771 <entry>Package group for libvirt.</entry>
1772 <entry>MIT</entry>
1773</row>
1774<row>
1775 <entry>packagegroup-enea-virtualization-lxc</entry>
1776 <entry>1.0</entry>
1777 <entry>Packagegroup for LXC.</entry>
1778 <entry>MIT</entry>
1779</row>
1780<row>
1781 <entry>packagegroup-enea-virtualization-lxd</entry>
1782 <entry>1.0</entry>
1783 <entry>Packagegroup for LXD.</entry>
1784 <entry>MIT</entry>
1785</row>
1786<row>
1787 <entry>packagegroup-enea-virtualization-ovs</entry>
1788 <entry>1.0</entry>
1789 <entry>Packagegroup for Open vSwitch.</entry>
1790 <entry>MIT</entry>
1791</row>
1792<row>
1793 <entry>packagegroup-enea-virtualization-qemu</entry>
1794 <entry>1.0</entry>
1795 <entry>Packagegroup for QEMU.</entry>
1796 <entry>MIT</entry>
1797</row>
1798<row>
1799 <entry>packagegroup-enea-virtualization</entry>
1800 <entry>1.0</entry>
1801 <entry>This packagegroup includes packages and packagegroups required for both host and guest images of the Enea Linux Virtualization Profile.</entry>
1802 <entry>MIT</entry>
1803</row>
1804<row>
1805 <entry>packagegroup-enea-wifi</entry>
1806 <entry>1.0</entry>
1807 <entry>This package group includes packages and packagegroups that enable WiFi connectivity in the Enea NFV Access platform</entry>
1808 <entry>MIT</entry>
1809</row>
1810<row>
1811 <entry>parted</entry>
1812 <entry>3.2</entry>
1813 <entry>Disk partition editing/resizing utility.</entry>
1814 <entry>GPL-3.0</entry>
1815</row>
1816<row>
1817 <entry>partrt</entry>
1818 <entry>1.1</entry>
1819 <entry>partrt is a tool for dividing a SMP Linux system into a real time domain and a non-real time domain.</entry>
1820 <entry>BSD</entry>
1821</row>
1822<row>
1823 <entry>pciutils</entry>
1824 <entry>3.5.5</entry>
1825 <entry>The PCI Utilities package contains a library for portable access to PCI bus configuration space and several utilities based on this library.</entry>
1826 <entry>GPL-2.0</entry>
1827</row>
1828<row>
1829 <entry>perl</entry>
1830 <entry>5.24.1</entry>
1831 <entry>Perl scripting language.</entry>
1832 <entry> Artistic-1.0, GPL-1.0</entry>
1833</row>
1834<row>
1835 <entry>pigz</entry>
1836 <entry>2.3.4</entry>
1837 <entry>pigz which stands for parallel implementation of gzip is a fully functional replacement for gzip that exploits multiple processors and multiple cores to the hilt when compressing data. pigz was written by Mark Adler and uses the zlib and pthread libraries.</entry>
1838 <entry> Zlib, Apache-2.0</entry>
1839</row>
1840<row>
1841 <entry>pixman</entry>
1842 <entry>0.34.0</entry>
1843 <entry>Pixman provides a library for manipulating pixel regions -- a set of Y-X banded rectangles image compositing using the Porter/Duff model and implicit mask generation for geometric primitives including trapezoids triangles and rectangles.</entry>
1844 <entry> MIT, PD</entry>
1845</row>
1846<row>
1847 <entry>pkgconfig</entry>
1848 <entry>0.29.2</entry>
1849 <entry>pkg-config is a helper tool used when compiling applications and libraries. It helps determined the correct compiler/link options. It is also language-agnostic.</entry>
1850 <entry>GPL-2.0</entry>
1851</row>
1852<row>
1853 <entry>pm-utils</entry>
1854 <entry>1.4.1</entry>
1855 <entry>Simple shell command line tools to suspend and hibernate.</entry>
1856 <entry>GPL-2.0</entry>
1857</row>
1858<row>
1859 <entry>polkit</entry>
1860 <entry>0.113</entry>
1861 <entry>The polkit package is an application-level toolkit for defining and handling the policy that allows unprivileged processes to speak to privileged processes.</entry>
1862 <entry>LGPL-2.0</entry>
1863</row>
1864<row>
1865 <entry>popt</entry>
1866 <entry>1.16</entry>
1867 <entry>Library for parsing command line options.</entry>
1868 <entry>MIT</entry>
1869</row>
1870<row>
1871 <entry>pps-tools</entry>
1872 <entry>0.0.0</entry>
1873 <entry>User-space tools for LinuxPPS.</entry>
1874 <entry>GPL-2.0</entry>
1875</row>
1876<row>
1877 <entry>prelink</entry>
1878 <entry>1.0</entry>
1879 <entry>The prelink package contains a utility which modifies ELF shared libraries and executables so that far fewer relocations need to be resolved at runtime and thus programs come up faster.</entry>
1880 <entry>GPL-2.0</entry>
1881</row>
1882<row>
1883 <entry>procps</entry>
1884 <entry>3.3.12</entry>
1885 <entry>Procps contains a set of system utilities that provide system information about processes using the /proc filesystem. The package includes the programs ps top vmstat w kill and skill.</entry>
1886 <entry> GPL-2.0, LGPL-2.0</entry>
1887</row>
1888<row>
1889 <entry>pseudo</entry>
1890 <entry>1.8.2</entry>
1891 <entry>Pseudo gives fake root capabilities to a normal user.</entry>
1892 <entry>LGPL-2.1</entry>
1893</row>
1894<row>
1895 <entry>ptest-runner</entry>
1896 <entry>2.1</entry>
1897 <entry>The ptest-runner2 package installs a ptest-runner program which loops through all installed ptest test suites and runs them in sequence.</entry>
1898 <entry>GPL-2.0</entry>
1899</row>
1900<row>
1901 <entry>python-asn1crypto</entry>
1902 <entry>0.23.0</entry>
1903 <entry>Python binding to the Networking and Cryptography (NaCl) library</entry>
1904 <entry>Apache-2.0</entry>
1905</row>
1906<row>
1907 <entry>python-certifi</entry>
1908 <entry>2017.7.27.1</entry>
1909 <entry>This installable Python package contains a CA Bundle that you can reference in your Python code. This is useful for verifying HTTP requests for example. This is the same CA Bundle which ships with the Requests codebase and is derived from Mozilla Firefox's canonical set.</entry>
1910 <entry>ISC</entry>
1911</row>
1912<row>
1913 <entry>python-cffi</entry>
1914 <entry>1.11.2</entry>
1915 <entry>Foreign Function Interface for Python calling C code.</entry>
1916 <entry>MIT</entry>
1917</row>
1918<row>
1919 <entry>python-chardet</entry>
1920 <entry>3.0.4</entry>
1921 <entry>Universal encoding detector for Python 2 and 3.</entry>
1922 <entry>LGPL-2.1</entry>
1923</row>
1924<row>
1925 <entry>python-cryptography-vectors</entry>
1926 <entry>2.0.3</entry>
1927 <entry>Test vectors for the cryptography package..</entry>
1928 <entry> Apache-2.0, BSD</entry>
1929</row>
1930<row>
1931 <entry>python-cryptography</entry>
1932 <entry>2.0.3</entry>
1933 <entry>Provides cryptographic recipes and primitives to python developers.</entry>
1934 <entry> Apache-2.0, BSD</entry>
1935</row>
1936<row>
1937 <entry>python-cython</entry>
1938 <entry>0.27.1</entry>
1939 <entry>Cython is a language specially designed for writing Python extension modules. It's designed to bridge the gap between the nice high-level easy-to-use world of Python and the messy low-level world of C.</entry>
1940 <entry>Apache-2.0</entry>
1941</row>
1942<row>
1943 <entry>python-enum34</entry>
1944 <entry>1.1.6</entry>
1945 <entry>backport of Python 3.4's enum package.</entry>
1946 <entry>BSD-3-Clause</entry>
1947</row>
1948<row>
1949 <entry>python-functools32</entry>
1950 <entry>3.2.3-2</entry>
1951 <entry>Backport of the functools module from Python 3.2.3 for use on 2.7 and PyPy..</entry>
1952 <entry>Python-2.0</entry>
1953</row>
1954<row>
1955 <entry>python-futures</entry>
1956 <entry>3.0.5</entry>
1957 <entry>The concurrent.futures module provides a high-level interface for asynchronously executing callables.</entry>
1958 <entry>BSD</entry>
1959</row>
1960<row>
1961 <entry>python-idna</entry>
1962 <entry>2.6</entry>
1963 <entry>Internationalised Domain Names in Applications.</entry>
1964 <entry> BSD-3-Clause, Python-2.0, Unicode</entry>
1965</row>
1966<row>
1967 <entry>python-ipaddress</entry>
1968 <entry>1.0.18</entry>
1969 <entry>Python 3.3+'s ipaddress for Python 2.6 2.7 3.2..</entry>
1970 <entry>Python-2.0</entry>
1971</row>
1972<row>
1973 <entry>python-iso8601</entry>
1974 <entry>0.1.12</entry>
1975 <entry>Simple module to parse ISO 8601 dates.</entry>
1976 <entry>MIT</entry>
1977</row>
1978<row>
1979 <entry>python-jsonpatch</entry>
1980 <entry>1.16</entry>
1981 <entry>Appling JSON patches in Python 2.6+ and 3.x.</entry>
1982 <entry>BSD</entry>
1983</row>
1984<row>
1985 <entry>python-jsonpointer</entry>
1986 <entry>1.12</entry>
1987 <entry>Resolve JSON Pointers in Python.</entry>
1988 <entry>BSD</entry>
1989</row>
1990<row>
1991 <entry>python-jsonschema</entry>
1992 <entry>2.6.0</entry>
1993 <entry>An implementation of JSON Schema validation for Python.</entry>
1994 <entry>MIT</entry>
1995</row>
1996<row>
1997 <entry>python-ndg-httpsclient</entry>
1998 <entry>0.4.3</entry>
1999 <entry>Provides enhanced HTTPS support for httplib and urllib2 using PyOpenSSL</entry>
2000 <entry>BSD</entry>
2001</row>
2002<row>
2003 <entry>python-netaddr</entry>
2004 <entry>0.7.19</entry>
2005 <entry>A network address manipulation library for Python..</entry>
2006 <entry>BSD</entry>
2007</row>
2008<row>
2009 <entry>python-netifaces</entry>
2010 <entry>0.10.6</entry>
2011 <entry>Portable network interface information.</entry>
2012 <entry>MIT</entry>
2013</row>
2014<row>
2015 <entry>python-pip</entry>
2016 <entry>9.0.1</entry>
2017 <entry>PIP is a tool for installing and managing Python packages.</entry>
2018 <entry> MIT, LGPL-2.1</entry>
2019</row>
2020<row>
2021 <entry>python-pretend</entry>
2022 <entry>1.0.8</entry>
2023 <entry>A library for stubbing in Python.</entry>
2024 <entry>BSD</entry>
2025</row>
2026<row>
2027 <entry>python-prettytable</entry>
2028 <entry>0.7.2</entry>
2029 <entry>Python library for displaying tabular data in a ASCII table format.</entry>
2030 <entry>BSD</entry>
2031</row>
2032<row>
2033 <entry>python-psutil</entry>
2034 <entry>5.3.1</entry>
2035 <entry>A cross-platform process and system utilities module for Python.</entry>
2036 <entry>BSD</entry>
2037</row>
2038<row>
2039 <entry>python-py</entry>
2040 <entry>1.4.34</entry>
2041 <entry>Library with cross-python path ini-parsing io code log facilities.</entry>
2042 <entry>MIT</entry>
2043</row>
2044<row>
2045 <entry>python-pyasn1</entry>
2046 <entry>0.3.6</entry>
2047 <entry>Python library implementing ASN.1 types..</entry>
2048 <entry>BSD-2-Clause</entry>
2049</row>
2050<row>
2051 <entry>python-pycparser</entry>
2052 <entry>2.18</entry>
2053 <entry>Parser of the C language written in pure Python.</entry>
2054 <entry>BSD-3-Clause</entry>
2055</row>
2056<row>
2057 <entry>python-pyopenssl</entry>
2058 <entry>17.3.0</entry>
2059 <entry>Simple Python wrapper around the OpenSSL library.</entry>
2060 <entry>Apache-2.0</entry>
2061</row>
2062<row>
2063 <entry>python-pysocks</entry>
2064 <entry>1.6.7</entry>
2065 <entry>A Python SOCKS client module</entry>
2066 <entry>BSD</entry>
2067</row>
2068<row>
2069 <entry>python-pytest-runner</entry>
2070 <entry>2.12.1</entry>
2071 <entry>Invoke py.test as distutils command with dependency resolution.</entry>
2072 <entry>MIT</entry>
2073</row>
2074<row>
2075 <entry>python-pytest</entry>
2076 <entry>3.2.2</entry>
2077 <entry>Simple powerful teting with python.</entry>
2078 <entry>MIT</entry>
2079</row>
2080<row>
2081 <entry>python-pyyaml</entry>
2082 <entry>3.11</entry>
2083 <entry> YAML is a data serialization format designed for human readability and interaction with scripting languages. PyYAML is a YAML parser and emitter for Python. . PyYAML features a complete YAML 1.1 parser Unicode support pickle support capable extension API and sensible error messages. PyYAML supports standard YAML tags and provides Python-specific tags that allow to represent an arbitrary Python object. . PyYAML is applicable for a broad range of tasks from complex configuration files to object serialization and persistance. </entry>
2084 <entry>MIT</entry>
2085</row>
2086<row>
2087 <entry>python-requests</entry>
2088 <entry>2.18.4</entry>
2089 <entry>Python HTTP for Humans.</entry>
2090 <entry>Apache-2.0</entry>
2091</row>
2092<row>
2093 <entry>python-rfc3987</entry>
2094 <entry>1.3.7</entry>
2095 <entry>Parsing and validation of URIs (RFC 3986) and IRIs (RFC 3987).</entry>
2096 <entry>GPL-3.0</entry>
2097</row>
2098<row>
2099 <entry>python-scons</entry>
2100 <entry>2.5.1</entry>
2101 <entry>Software Construction tool (make/autotools replacement).</entry>
2102 <entry>MIT</entry>
2103</row>
2104<row>
2105 <entry>python-setuptools-scm</entry>
2106 <entry>1.15.6</entry>
2107 <entry>the blessed package to manage your versions by scm tags.</entry>
2108 <entry>MIT</entry>
2109</row>
2110<row>
2111 <entry>python-setuptools</entry>
2112 <entry>36.2.7</entry>
2113 <entry>Download build install upgrade and uninstall Python packages.</entry>
2114 <entry>MIT</entry>
2115</row>
2116<row>
2117 <entry>python-six</entry>
2118 <entry>1.11.0</entry>
2119 <entry>Python 2 and 3 compatibility library.</entry>
2120 <entry>MIT</entry>
2121</row>
2122<row>
2123 <entry>python-strict-rfc3339</entry>
2124 <entry>0.7</entry>
2125 <entry>Strict simple lightweight RFC3339 function.s.</entry>
2126 <entry>GPL-3.0</entry>
2127</row>
2128<row>
2129 <entry>python-urllib3</entry>
2130 <entry>1.22</entry>
2131 <entry>Python HTTP library with thread-safe connection pooling file post support sanity friendly and more.</entry>
2132 <entry>MIT</entry>
2133</row>
2134<row>
2135 <entry>python-vcversioner</entry>
2136 <entry>2.16.0.0</entry>
2137 <entry>Python vcversioner automagically update the project's version.</entry>
2138 <entry>ISC</entry>
2139</row>
2140<row>
2141 <entry>python</entry>
2142 <entry>2.7.13</entry>
2143 <entry>The Python Programming Language.</entry>
2144 <entry>Python-2.0</entry>
2145</row>
2146<row>
2147 <entry>python3-netifaces</entry>
2148 <entry>0.10.6</entry>
2149 <entry>Portable network interface information.</entry>
2150 <entry>MIT</entry>
2151</row>
2152<row>
2153 <entry>python3-pip</entry>
2154 <entry>9.0.1</entry>
2155 <entry>The PyPA recommended tool for installing Python packages.</entry>
2156 <entry>MIT</entry>
2157</row>
2158<row>
2159 <entry>python3-setuptools</entry>
2160 <entry>36.2.7</entry>
2161 <entry>Download build install upgrade and uninstall Python packages.</entry>
2162 <entry>MIT</entry>
2163</row>
2164<row>
2165 <entry>python3-six</entry>
2166 <entry>1.10.0</entry>
2167 <entry>Python 2 and 3 compatibility library.</entry>
2168 <entry>MIT</entry>
2169</row>
2170<row>
2171 <entry>python3-twisted</entry>
2172 <entry>13.2.0</entry>
2173 <entry>Twisted is an event-driven networking framework written in Python and licensed under the LGPL. Twisted supports TCP UDP SSL/TLS multicast Unix sockets a large number of protocols (including HTTP NNTP IMAP SSH IRC FTP and others) and much more.</entry>
2174 <entry>MIT</entry>
2175</row>
2176<row>
2177 <entry>python3-zopeinterface</entry>
2178 <entry>4.4.3</entry>
2179 <entry>Interface definitions for Zope products.</entry>
2180 <entry>ZPL-2.1</entry>
2181</row>
2182<row>
2183 <entry>python3</entry>
2184 <entry>3.5.3</entry>
2185 <entry>The Python Programming Language.</entry>
2186 <entry>Python-2.0</entry>
2187</row>
2188<row>
2189 <entry>qemu-helper</entry>
2190 <entry>1.0</entry>
2191 <entry>Helper utilities needed by the runqemu script.</entry>
2192 <entry>GPL-2.0</entry>
2193</row>
2194<row>
2195 <entry>qemu</entry>
2196 <entry>2.11.1</entry>
2197 <entry>Fast open source processor emulator.</entry>
2198 <entry> GPL-2.0, LGPL-2.1</entry>
2199</row>
2200<row>
2201 <entry>qemuwrapper</entry>
2202 <entry>1.0</entry>
2203 <entry>QEMU wrapper script.</entry>
2204 <entry>MIT</entry>
2205</row>
2206<row>
2207 <entry>quilt</entry>
2208 <entry>0.65</entry>
2209 <entry>Tool for working with series of patches.</entry>
2210 <entry>GPL-2.0</entry>
2211</row>
2212<row>
2213 <entry>randrproto</entry>
2214 <entry>1.5.0</entry>
2215 <entry>This package provides the wire protocol for the X Resize Rotate and Reflect extension. This extension provides the ability to resize rotate and reflect the root window of a screen.</entry>
2216 <entry>MIT</entry>
2217</row>
2218<row>
2219 <entry>readline</entry>
2220 <entry>7.0</entry>
2221 <entry>The GNU Readline library provides a set of functions for use by applications that allow users to edit command lines as they are typed in. Both Emacs and vi editing modes are available. The Readline library includes additional functions to maintain a list of previously-entered command lines to recall and perhaps reedit those lines and perform csh-like history expansion on previous commands.</entry>
2222 <entry>GPL-3.0</entry>
2223</row>
2224<row>
2225 <entry>regexp</entry>
2226 <entry>1.5</entry>
2227 <entry>Java Regular Expression package</entry>
2228 <entry>Apache-2.0</entry>
2229</row>
2230<row>
2231 <entry>renderproto</entry>
2232 <entry>0.11.1</entry>
2233 <entry>This package provides the wire protocol for the X Rendering extension. This is the basis the image composition within the X window system.</entry>
2234 <entry>MIT</entry>
2235</row>
2236<row>
2237 <entry>rhino</entry>
2238 <entry>1.7r4</entry>
2239 <entry>Lexical analyzer generator for Java</entry>
2240 <entry>MPL-2.0</entry>
2241</row>
2242<row>
2243 <entry>rpm</entry>
2244 <entry>4.13.90</entry>
2245 <entry>The RPM Package Manager (RPM) is a powerful command line driven package management system capable of installing uninstalling verifying querying and updating software packages. Each software package consists of an archive of files along with information about the package like its version a description etc.</entry>
2246 <entry>GPL-2.0</entry>
2247</row>
2248<row>
2249 <entry>rsync</entry>
2250 <entry>3.1.3</entry>
2251 <entry>File synchronization tool.</entry>
2252 <entry>GPL-3.0</entry>
2253</row>
2254<row>
2255 <entry>run-postinsts</entry>
2256 <entry>1.0</entry>
2257 <entry>Runs postinstall scripts on first boot of the target device.</entry>
2258 <entry>MIT</entry>
2259</row>
2260<row>
2261 <entry>runc-docker</entry>
2262 <entry>1.0.0-rc3</entry>
2263 <entry>runc is a CLI tool for spawning and running containers according to the OCI specification.</entry>
2264 <entry>Apache-2.0</entry>
2265</row>
2266<row>
2267 <entry>sbsigntool</entry>
2268 <entry>0.6</entry>
2269 <entry>Utilities for signing UEFI binaries for use with secure boot.</entry>
2270 <entry>GPL-3.0</entry>
2271</row>
2272<row>
2273 <entry>sed</entry>
2274 <entry>4.2.2</entry>
2275 <entry>Stream EDitor (text filtering utility).</entry>
2276 <entry>GPL-3.0</entry>
2277</row>
2278<row>
2279 <entry>seloader</entry>
2280 <entry>0.4.6</entry>
2281 <entry>The SELoader is designed to authenticate the non-PE files such as grub configuration initrd grub modules which cannot be verified by the MOK Verify Protocol registered by shim loader. In order to conveniently authenticate the PE file with gBS-&gt;LoadImage() and gBS-&gt;StartImage() the SELoader hooks EFI Security2 Architectural Protocol and employs MOK Verify Protocol to verify the PE file. If only UEFI Secure Boot is enabled the SELoader just simplily calls gBS-&gt;LoadImage() and gBS-&gt;StartImage() to allow BIOS to verify PE file. The SELoader publishes MOK2 Verify Protocol which provides a flexible interface to allow the bootloader to verify the file file buffer or memory buffer without knowing the file format. </entry>
2282 <entry>BSD-3-Clause</entry>
2283</row>
2284<row>
2285 <entry>serf</entry>
2286 <entry>1.3.9</entry>
2287 <entry>High-Performance Asynchronous HTTP Client Library.</entry>
2288 <entry>Apache-2.0</entry>
2289</row>
2290<row>
2291 <entry>servlet2.3</entry>
2292 <entry>4.1.37</entry>
2293 <entry>Servlet API 2.3 (from Tomcat 4.1)</entry>
2294 <entry>Apache-2.0</entry>
2295</row>
2296<row>
2297 <entry>shadow-securetty</entry>
2298 <entry>4.2.1</entry>
2299 <entry>Provider of the machine specific securetty file.</entry>
2300 <entry>MIT</entry>
2301</row>
2302<row>
2303 <entry>shadow-sysroot</entry>
2304 <entry>4.2.1</entry>
2305 <entry>Shadow utils requirements for useradd.bbclass.</entry>
2306 <entry> BSD, Artistic-1.0</entry>
2307</row>
2308<row>
2309 <entry>shadow</entry>
2310 <entry>4.2.1</entry>
2311 <entry>Tools to change and administer password and group data.</entry>
2312 <entry> BSD, Artistic-1.0</entry>
2313</row>
2314<row>
2315 <entry>shared-mime-info</entry>
2316 <entry>1.8</entry>
2317 <entry>Shared MIME type database and specification.</entry>
2318 <entry>LGPL-2.0</entry>
2319</row>
2320<row>
2321 <entry>shim</entry>
2322 <entry>12</entry>
2323 <entry>shim is a trivial EFI application that when run attempts to open and execute another application. It will initially attempt to do this via the standard EFI LoadImage() and StartImage() calls. If these fail (because secure boot is enabled and the binary is not signed with an appropriate key for instance) it will then validate the binary against a built-in certificate. If this succeeds and if the binary or signing key are not blacklisted then shim will relocate and execute the binary.</entry>
2324 <entry>BSD-2-Clause</entry>
2325</row>
2326<row>
2327 <entry>simpleproxy</entry>
2328 <entry>1.0</entry>
2329 <entry>Simpleproxy.</entry>
2330 <entry>GPL-2.0</entry>
2331</row>
2332<row>
2333 <entry>slang</entry>
2334 <entry>2.3.1a</entry>
2335 <entry>S-Lang is an interpreted language and a programming library. The S-Lang language was designed so that it can be easily embedded into a program to provide the program with a powerful extension language. The S-Lang library provided in this package provides the S-Lang extension language. S-Lang's syntax resembles C which makes it easy to recode S-Lang procedures in C if you need to.</entry>
2336 <entry>GPL-2.0</entry>
2337</row>
2338<row>
2339 <entry>sqlite3</entry>
2340 <entry>3.20.0</entry>
2341 <entry>Embeddable SQL database engine.</entry>
2342 <entry>PD</entry>
2343</row>
2344<row>
2345 <entry>squashfs-tools</entry>
2346 <entry>4.3</entry>
2347 <entry>Tools for manipulating SquashFS filesystems.</entry>
2348 <entry> GPL-2.0, PD</entry>
2349</row>
2350<row>
2351 <entry>sshpass</entry>
2352 <entry>1.06</entry>
2353 <entry>Tool for non-interactivly performing ssh password authentication</entry>
2354 <entry>GPL-2.0</entry>
2355</row>
2356<row>
2357 <entry>subversion</entry>
2358 <entry>1.9.6</entry>
2359 <entry>Subversion (svn) version control system client.</entry>
2360 <entry>Apache-2.0</entry>
2361</row>
2362<row>
2363 <entry>swig</entry>
2364 <entry>3.0.12</entry>
2365 <entry>SWIG - Simplified Wrapper and Interface Generator.</entry>
2366 <entry> BSD, GPL-3.0</entry>
2367</row>
2368<row>
2369 <entry>sysfsutils</entry>
2370 <entry>2.1.0</entry>
2371 <entry>Tools for working with the sysfs virtual filesystem. The tool 'systool' can query devices by bus class and topology.</entry>
2372 <entry> GPL-2.0, LGPL-2.1</entry>
2373</row>
2374<row>
2375 <entry>sysklogd</entry>
2376 <entry>1.5.1</entry>
2377 <entry>The sysklogd package implements two system log daemons: syslogd klogd</entry>
2378 <entry> GPL-2.0, BSD</entry>
2379</row>
2380<row>
2381 <entry>syslinux</entry>
2382 <entry>6.03</entry>
2383 <entry>Multi-purpose linux bootloader.</entry>
2384 <entry>GPL-2.0</entry>
2385</row>
2386<row>
2387 <entry>systemd-boot</entry>
2388 <entry>234</entry>
2389 <entry>systemd is a system and service manager for Linux compatible with SysV and LSB init scripts. systemd provides aggressive parallelization capabilities uses socket and D-Bus activation for starting services offers on-demand starting of daemons keeps track of processes using Linux cgroups supports snapshotting and restoring of the system state maintains mount and automount points and implements an elaborate transactional dependency-based service control logic. It can work as a drop-in replacement for sysvinit.</entry>
2390 <entry> GPL-2.0, LGPL-2.1</entry>
2391</row>
2392<row>
2393 <entry>systemd-compat-units</entry>
2394 <entry>1.0</entry>
2395 <entry>Enhances systemd compatilibity with existing SysVinit scripts.</entry>
2396 <entry>MIT</entry>
2397</row>
2398<row>
2399 <entry>systemd-serialgetty</entry>
2400 <entry>1.0</entry>
2401 <entry>Serial terminal support for systemd.</entry>
2402 <entry>GPL-2.0</entry>
2403</row>
2404<row>
2405 <entry>systemd-systemctl</entry>
2406 <entry>1.0</entry>
2407 <entry>Wrapper for enabling systemd services.</entry>
2408 <entry>MIT</entry>
2409</row>
2410<row>
2411 <entry>systemd</entry>
2412 <entry>234</entry>
2413 <entry>systemd is a system and service manager for Linux compatible with SysV and LSB init scripts. systemd provides aggressive parallelization capabilities uses socket and D-Bus activation for starting services offers on-demand starting of daemons keeps track of processes using Linux cgroups supports snapshotting and restoring of the system state maintains mount and automount points and implements an elaborate transactional dependency-based service control logic. It can work as a drop-in replacement for sysvinit.</entry>
2414 <entry> GPL-2.0, LGPL-2.1</entry>
2415</row>
2416<row>
2417 <entry>tar</entry>
2418 <entry>1.29</entry>
2419 <entry>GNU tar saves many files together into a single tape or disk archive and can restore individual files from the archive.</entry>
2420 <entry>GPL-3.0</entry>
2421</row>
2422<row>
2423 <entry>tcl</entry>
2424 <entry>8.6.7</entry>
2425 <entry>Tool Command Language.</entry>
2426 <entry> tcl, BSD-3-Clause</entry>
2427</row>
2428<row>
2429 <entry>tcpdump</entry>
2430 <entry>4.9.2</entry>
2431 <entry>A sophisticated network protocol analyzer.</entry>
2432 <entry>BSD</entry>
2433</row>
2434<row>
2435 <entry>texinfo-dummy</entry>
2436 <entry>1.0</entry>
2437 <entry>Fake version of the texinfo utility suite.</entry>
2438 <entry>MIT</entry>
2439</row>
2440<row>
2441 <entry>thin-provisioning-tools</entry>
2442 <entry>0.6.3</entry>
2443 <entry>A suite of tools for manipulating the metadata of the dm-thin device-mapper target.</entry>
2444 <entry>GPL-3.0</entry>
2445</row>
2446<row>
2447 <entry>tunctl</entry>
2448 <entry>1.5</entry>
2449 <entry>Tool for controlling the Linux TUN/TAP driver.</entry>
2450 <entry>GPL-2.0</entry>
2451</row>
2452<row>
2453 <entry>tzcode</entry>
2454 <entry>2018c</entry>
2455 <entry>tzcode timezone zoneinfo utils -- zic zdump tzselect.</entry>
2456 <entry> PD, BSD, BSD-3-Clause</entry>
2457</row>
2458<row>
2459 <entry>tzdata</entry>
2460 <entry>2018c</entry>
2461 <entry>Timezone data.</entry>
2462 <entry> PD, BSD, BSD-3-Clause</entry>
2463</row>
2464<row>
2465 <entry>udev-extraconf</entry>
2466 <entry>1.1</entry>
2467 <entry>Extra machine specific configuration files for udev specifically blacklist information.</entry>
2468 <entry>MIT</entry>
2469</row>
2470<row>
2471 <entry>unifdef</entry>
2472 <entry>2.11</entry>
2473 <entry>Selectively remove #ifdef statements from sources.</entry>
2474 <entry>BSD-2-Clause</entry>
2475</row>
2476<row>
2477 <entry>unzip</entry>
2478 <entry>6.0</entry>
2479 <entry>Utilities for extracting and viewing files in .zip archives.</entry>
2480 <entry>BSD-3-Clause</entry>
2481</row>
2482<row>
2483 <entry>update-rc.d</entry>
2484 <entry>0.7</entry>
2485 <entry>update-rc.d is a utility that allows the management of symlinks to the initscripts in the /etc/rcN.d directory structure.</entry>
2486 <entry>GPL-2.0</entry>
2487</row>
2488<row>
2489 <entry>usb-modeswitch-data</entry>
2490 <entry>20170205</entry>
2491 <entry>Data files for usbmodeswitch.</entry>
2492 <entry>GPL-2.0</entry>
2493</row>
2494<row>
2495 <entry>usb-modeswitch</entry>
2496 <entry>2.5.0</entry>
2497 <entry>A mode switching tool for controlling 'flip flop' (multiple device) USB gear.</entry>
2498 <entry>GPL-2.0</entry>
2499</row>
2500<row>
2501 <entry>usbutils</entry>
2502 <entry>008</entry>
2503 <entry>Contains the lsusb utility for inspecting the devices connected to the USB bus.</entry>
2504 <entry>GPL-2.0</entry>
2505</row>
2506<row>
2507 <entry>util-linux</entry>
2508 <entry>2.30</entry>
2509 <entry>Util-linux includes a suite of basic system administration utilities commonly found on most Linux systems. Some of the more important utilities include disk partitioning kernel message management filesystem creation and system login.</entry>
2510 <entry> GPL-2.0, LGPL-2.1, BSD</entry>
2511</row>
2512<row>
2513 <entry>util-macros</entry>
2514 <entry>1.19.1</entry>
2515 <entry>M4 autotools macros used by various X.org programs.</entry>
2516 <entry> MIT</entry>
2517</row>
2518<row>
2519 <entry>v86d</entry>
2520 <entry>0.1.10</entry>
2521 <entry>User support binary for the uvesafb kernel module.</entry>
2522 <entry>GPL-2.0</entry>
2523</row>
2524<row>
2525 <entry>vala</entry>
2526 <entry>0.36.4</entry>
2527 <entry>Vala is a C#-like language dedicated to ease GObject programming. Vala compiles to plain C and has no runtime environment nor penalities whatsoever.</entry>
2528 <entry>LGPL-2.1</entry>
2529</row>
2530<row>
2531 <entry>volatile-binds</entry>
2532 <entry>1.0</entry>
2533 <entry>Volatile bind mount setup and configuration for read-only-rootfs</entry>
2534 <entry>MIT</entry>
2535</row>
2536<row>
2537 <entry>which</entry>
2538 <entry>2.21</entry>
2539 <entry>Which is a utility that prints out the full path of the executables that bash(1) would execute when the passed program names would have been entered on the shell prompt. It does this by using the exact same algorithm as bash.</entry>
2540 <entry>GPL-3.0</entry>
2541</row>
2542<row>
2543 <entry>wpa-supplicant</entry>
2544 <entry>2.6</entry>
2545 <entry>Client for Wi-Fi Protected Access (WPA).</entry>
2546 <entry>BSD</entry>
2547</row>
2548<row>
2549 <entry>xalan-j</entry>
2550 <entry>2.7.1</entry>
2551 <entry>Java XSLT processor</entry>
2552 <entry>Apache-2.0</entry>
2553</row>
2554<row>
2555 <entry>xcb-proto</entry>
2556 <entry>1.12</entry>
2557 <entry>Function prototypes for the X protocol C-language Binding (XCB). XCB is a replacement for Xlib featuring a small footprint latency hiding direct access to the protocol improved threading support and extensibility.</entry>
2558 <entry>MIT</entry>
2559</row>
2560<row>
2561 <entry>xerces-j</entry>
2562 <entry>2.11.0</entry>
2563 <entry>Reference implementation of XNI the Xerces Native Interface and also a fully conforming XML Schema processor.</entry>
2564 <entry>Apache-2.0</entry>
2565</row>
2566<row>
2567 <entry>xextproto</entry>
2568 <entry>7.3.0</entry>
2569 <entry>This package provides the wire protocol for several X extensions. These protocol extensions include DOUBLE-BUFFER DPMS Extended-Visual-Information LBX MIT_SHM MIT_SUNDRY-NONSTANDARD Multi-Buffering SECURITY SHAPE SYNC TOG-CUP XC-APPGROUP XC-MISC XTEST. In addition a small set of utility functions are also available.</entry>
2570 <entry> MIT</entry>
2571</row>
2572<row>
2573 <entry>xkeyboard-config</entry>
2574 <entry>2.21</entry>
2575 <entry>The non-arch keyboard configuration database for X Window. The goal is to provide the consistent well-structured frequently released open source of X keyboard configuration data for X Window System implementations. The project is targeted to XKB-based systems.</entry>
2576 <entry> MIT</entry>
2577</row>
2578<row>
2579 <entry>xml-commons-resolver1.1</entry>
2580 <entry>1.2</entry>
2581 <entry>Library to resolve various public or system identifiers into accessible URLs (Java)</entry>
2582 <entry>Apache-2.0</entry>
2583</row>
2584<row>
2585 <entry>xproto</entry>
2586 <entry>7.0.31</entry>
2587 <entry>This package provides the basic headers for the X Window System.</entry>
2588 <entry> MIT</entry>
2589</row>
2590<row>
2591 <entry>xtrans</entry>
2592 <entry>1.3.5</entry>
2593 <entry>The X Transport Interface is intended to combine all system and transport specific code into a single place. This API should be used by all libraries clients and servers of the X Window System. Use of this API should allow the addition of new types of transports and support for new platforms without making any changes to the source except in the X Transport Interface code.</entry>
2594 <entry> MIT</entry>
2595</row>
2596<row>
2597 <entry>xz</entry>
2598 <entry>5.2.3</entry>
2599 <entry>Utilities for managing LZMA compressed files.</entry>
2600 <entry> GPL-2.0, GPL-3.0-with-autoconf-exception, LGPL-2.1, PD</entry>
2601</row>
2602<row>
2603 <entry>yajl</entry>
2604 <entry>2.1.0</entry>
2605 <entry>YAJL is a small event-driven (SAX-style) JSON parser written in ANSI C and a small validating JSON generator.</entry>
2606 <entry>ISC</entry>
2607</row>
2608<row>
2609 <entry>zip</entry>
2610 <entry>3.0</entry>
2611 <entry>Compressor/archiver for creating and modifying .zip files.</entry>
2612 <entry>BSD-3-Clause</entry>
2613</row>
2614<row>
2615 <entry>zisofs-tools</entry>
2616 <entry>1.0.8</entry>
2617 <entry>Utilities for creating compressed CD-ROM filesystems.</entry>
2618 <entry>GPL-2.0</entry>
2619</row>
2620<row>
2621 <entry>zlib</entry>
2622 <entry>1.2.11</entry>
2623 <entry>Zlib is a general-purpose patent-free lossless data compression library which is used by many different programs.</entry>
2624 <entry>Zlib</entry>
2625</row>
2626 </tbody>
2627 </tgroup>
2628 </informaltable>
2629 </section>
2630 <section id="open_source_license">
2631 <title>Open Source Licenses</title>
2632<section id="lic_0">
2633<title>AFL-2.0</title>
2634<para><programlisting>
2635
2636The Academic Free License
2637 v. 2.0
2638
2639This Academic Free License (the "License") applies to any original work of authorship
2640(the "Original Work") whose owner (the "Licensor") has placed the following notice
2641immediately following the copyright notice for the Original Work:
2642Licensed under the Academic Free License version 2.0
2643
26441) Grant of Copyright License. Licensor hereby grants You a world-wide, royalty-free,
2645non-exclusive, perpetual, sublicenseable license to do the following:
2646a) to reproduce the Original Work in copies;
2647
2648b) to prepare derivative works ("Derivative Works") based upon the Original Work;
2649
2650c) to distribute copies of the Original Work and Derivative Works to the public;
2651
2652d) to perform the Original Work publicly; and
2653
2654e) to display the Original Work publicly.
2655
26562) Grant of Patent License. Licensor hereby grants You a world-wide, royalty-free,
2657non-exclusive, perpetual, sublicenseable license, under patent claims owned or
2658controlled by the Licensor that are embodied in the Original Work as furnished by the
2659Licensor, to make, use, sell and offer for sale the Original Work and Derivative
2660Works.
2661
26623) Grant of Source Code License. The term "Source Code" means the preferred form of
2663the Original Work for making modifications to it and all available documentation
2664describing how to modify the Original Work. Licensor hereby agrees to provide a
2665machine-readable copy of the Source Code of the Original Work along with each copy of
2666the Original Work that Licensor distributes. Licensor reserves the right to satisfy
2667this obligation by placing a machine-readable copy of the Source Code in an
2668information repository reasonably calculated to permit inexpensive and convenient
2669access by You for as long as Licensor continues to distribute the Original Work, and
2670by publishing the address of that information repository in a notice immediately
2671following the copyright notice that applies to the Original Work.
2672
26734) Exclusions From License Grant. Neither the names of Licensor, nor the names of any
2674contributors to the Original Work, nor any of their trademarks or service marks, may
2675be used to endorse or promote products derived from this Original Work without express
2676prior written permission of the Licensor. Nothing in this License shall be deemed to
2677grant any rights to trademarks, copyrights, patents, trade secrets or any other
2678intellectual property of Licensor except as expressly stated herein. No patent
2679license is granted to make, use, sell or offer to sell embodiments of any patent
2680claims other than the licensed claims defined in Section 2. No right is granted to
2681the trademarks of Licensor even if such marks are included in the Original Work.
2682Nothing in this License shall be interpreted to prohibit Licensor from licensing under
2683different terms from this License any Original Work that Licensor otherwise would have
2684a right to license.
2685
26865) This section intentionally omitted.
2687
26886) Attribution Rights. You must retain, in the Source Code of any Derivative Works
2689that You create, all copyright, patent or trademark notices from the Source Code of
2690the Original Work, as well as any notices of licensing and any descriptive text
2691identified therein as an "Attribution Notice." You must cause the Source Code for any
2692Derivative Works that You create to carry a prominent Attribution Notice reasonably
2693calculated to inform recipients that You have modified the Original Work.
2694
26957) Warranty of Provenance and Disclaimer of Warranty. Licensor warrants that the
2696copyright in and to the Original Work and the patent rights granted herein by Licensor
2697are owned by the Licensor or are sublicensed to You under the terms of this License
2698with the permission of the contributor(s) of those copyrights and patent rights.
2699Except as expressly stated in the immediately proceeding sentence, the Original Work
2700is provided under this License on an "AS IS" BASIS and WITHOUT WARRANTY, either
2701express or implied, including, without limitation, the warranties of NON-INFRINGEMENT,
2702MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
2703QUALITY OF THE ORIGINAL WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an
2704essential part of this License. No license to Original Work is granted hereunder
2705except under this disclaimer.
2706
27078) Limitation of Liability. Under no circumstances and under no legal theory, whether
2708in tort (including negligence), contract, or otherwise, shall the Licensor be liable
2709to any person for any direct, indirect, special, incidental, or consequential damages
2710of any character arising as a result of this License or the use of the Original Work
2711including, without limitation, damages for loss of goodwill, work stoppage, computer
2712failure or malfunction, or any and all other commercial damages or losses. This
2713limitation of liability shall not apply to liability for death or personal injury
2714resulting from Licensor`s negligence to the extent applicable law prohibits such
2715limitation. Some jurisdictions do not allow the exclusion or limitation of incidental
2716or consequential damages, so this exclusion and limitation may not apply to You.
2717
27189) Acceptance and Termination. If You distribute copies of the Original Work or a
2719Derivative Work, You must make a reasonable effort under the circumstances to obtain
2720the express assent of recipients to the terms of this License. Nothing else but this
2721License (or another written agreement between Licensor and You) grants You permission
2722to create Derivative Works based upon the Original Work or to exercise any of the
2723rights granted in Section 1 herein, and any attempt to do so except under the terms of
2724this License (or another written agreement between Licensor and You) is expressly
2725prohibited by U.S. copyright law, the equivalent laws of other countries, and by
2726international treaty. Therefore, by exercising any of the rights granted to You in
2727Section 1 herein, You indicate Your acceptance of this License and all of its terms
2728and conditions.
2729
273010) Termination for Patent Action. This License shall terminate automatically and You
2731may no longer exercise any of the rights granted to You by this License as of the date
2732You commence an action, including a cross-claim or counterclaim, for patent
2733infringement (i) against Licensor with respect to a patent applicable to software or
2734(ii) against any entity with respect to a patent applicable to the Original Work (but
2735excluding combinations of the Original Work with other software or hardware).
2736
273711) Jurisdiction, Venue and Governing Law. Any action or suit relating to this License
2738may be brought only in the courts of a jurisdiction wherein the Licensor resides or in
2739which Licensor conducts its primary business, and under the laws of that jurisdiction
2740excluding its conflict-of-law provisions. The application of the United Nations
2741Convention on Contracts for the International Sale of Goods is expressly excluded.
2742Any use of the Original Work outside the scope of this License or after its
2743termination shall be subject to the requirements and penalties of the U.S. Copyright
2744Act, 17 U.S.C. ¤ 101 et seq., the equivalent laws of other countries, and
2745international treaty. This section shall survive the termination of this License.
2746
274712) Attorneys Fees. In any action to enforce the terms of this License or seeking
2748damages relating thereto, the prevailing party shall be entitled to recover its costs
2749and expenses, including, without limitation, reasonable attorneys` fees and costs
2750incurred in connection with such action, including any appeal of such action. This
2751section shall survive the termination of this License.
2752
275313) Miscellaneous. This License represents the complete agreement concerning the
2754subject matter hereof. If any provision of this License is held to be unenforceable,
2755such provision shall be reformed only to the extent necessary to make it enforceable.
2756
275714) Definition of "You" in This License. "You" throughout this License, whether in
2758upper or lower case, means an individual or a legal entity exercising rights under,
2759and complying with all of the terms of, this License. For legal entities, "You"
2760includes any entity that controls, is controlled by, or is under common control with
2761you. For purposes of this definition, "control" means (i) the power, direct or
2762indirect, to cause the direction or management of such entity, whether by contract or
2763otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares,
2764or (iii) beneficial ownership of such entity.
2765
276615) Right to Use. You may use the Original Work in all ways not otherwise restricted
2767or conditioned by this License or by law, and Licensor promises not to interfere with
2768or be responsible for such uses by You.
2769
2770This license is Copyright (C) 2003 Lawrence E. Rosen. All rights reserved.
2771Permission is hereby granted to copy and distribute this license without modification.
2772This license may not be modified without the express written permission of its
2773copyright owner.
2774
2775</programlisting></para></section>
2776
2777<section id="lic_1">
2778<title>AMD</title>
2779<para><programlisting>
2780� 2005 Advanced Micro Devices, Inc. All rights reserved.
2781
2782Redistribution and use in source and binary forms, with or without
2783modification, are permitted provided that existing copyright notices
2784are retained in all copies, this notice is included verbatim in any
2785distributions, and the terms and conditions hererin are met.
2786
2787Use of the this software manifests acceptance of the terms of this
2788license by performance.
2789
2790The name of Advanced Micro Devices, Inc. may not be used to endorse or
2791promote products derived from this software without specific prior
2792written permission.
2793
2794THIS SOFTWARE IS PROVIDED BY ADVANCED MICRO DEVICES, INC. "AS IS" AND ANY
2795EXPRESS, IMPLIED OR STATUTORY WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
2796THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
2797PURPOSE AND NON-INFRINGEMENT, OR THOSE ARISING FROM CUSTOM OF TRADE OR
2798COURSE OF USAGE ARE DISCLAIMED.
2799
2800IN NO EVENT SHALL ADVANCED MICRO DEVICES, INC. BE LIABLE FOR ANY DIRECT,
2801INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
2802(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
2803SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
2804CAUSED, AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2805LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2806OUT OF THE USE OF THIS SOFTWARE ITS DOCUMENTATION OR ANY DERIVATIVES
2807THEREOF, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. BY USING THIS
2808SOFTWARE WITHOUT CHARGE, YOU ACCEPT THIS ALLOCATION OF RISK. THIS
2809DISCLAIMER OF LIABILITY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE.
2810ADVANCED MICRO DEVICES, INC. HAS NO OBLIGATION TO PROVIDE MAINTENANCE,
2811SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS OF THIS SOFTWARE.
2812
2813In the redistribution and use of this software, each party shall at all
2814times comply with all applicable governmental laws, statutes, ordinances,
2815rules, regulations, orders, and other requirements, including without
2816limitation such governmental requirements applicable to environmental
2817protection, health, safety, wages, hours, equal employment opportunity,
2818nondiscrimination, working conditions, import or export control, and
2819transportation. Without limiting the foregoing, each party shall adhere
2820to the U.S. Export Administration Regulations (EAR), currently found at
282115 C.F.R. Sections 730 through 744, and, unless properly authorized by
2822the U.S. Government, shall not (1) export, re-export or release restricted
2823technology, software, or source code to a national of a country in Country
2824Groups D:1 or E:1, or (2) export to Country Groups D:1 or E:1 the direct
2825product of such technology or software, if such foreign produced direct
2826product is subject to national security controls as identified on the
2827Commerce Control List (currently found in Supplement 1 to Section 774 of EAR).
2828These export requirements shall survive any expiration or termination
2829of this agreement.
2830</programlisting></para></section>
2831
2832<section id="lic_2">
2833<title>Apache-2.0</title>
2834<para><programlisting>
2835
2836
2837 Apache License
2838 Version 2.0, January 2004
2839 http://www.apache.org/licenses/
2840
2841 TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
2842
2843 1. Definitions.
2844
2845 "License" shall mean the terms and conditions for use, reproduction,
2846 and distribution as defined by Sections 1 through 9 of this document.
2847
2848 "Licensor" shall mean the copyright owner or entity authorized by
2849 the copyright owner that is granting the License.
2850
2851 "Legal Entity" shall mean the union of the acting entity and all
2852 other entities that control, are controlled by, or are under common
2853 control with that entity. For the purposes of this definition,
2854 "control" means (i) the power, direct or indirect, to cause the
2855 direction or management of such entity, whether by contract or
2856 otherwise, or (ii) ownership of fifty percent (50%) or more of the
2857 outstanding shares, or (iii) beneficial ownership of such entity.
2858
2859 "You" (or "Your") shall mean an individual or Legal Entity
2860 exercising permissions granted by this License.
2861
2862 "Source" form shall mean the preferred form for making modifications,
2863 including but not limited to software source code, documentation
2864 source, and configuration files.
2865
2866 "Object" form shall mean any form resulting from mechanical
2867 transformation or translation of a Source form, including but
2868 not limited to compiled object code, generated documentation,
2869 and conversions to other media types.
2870
2871 "Work" shall mean the work of authorship, whether in Source or
2872 Object form, made available under the License, as indicated by a
2873 copyright notice that is included in or attached to the work
2874 (an example is provided in the Appendix below).
2875
2876 "Derivative Works" shall mean any work, whether in Source or Object
2877 form, that is based on (or derived from) the Work and for which the
2878 editorial revisions, annotations, elaborations, or other modifications
2879 represent, as a whole, an original work of authorship. For the purposes
2880 of this License, Derivative Works shall not include works that remain
2881 separable from, or merely link (or bind by name) to the interfaces of,
2882 the Work and Derivative Works thereof.
2883
2884 "Contribution" shall mean any work of authorship, including
2885 the original version of the Work and any modifications or additions
2886 to that Work or Derivative Works thereof, that is intentionally
2887 submitted to Licensor for inclusion in the Work by the copyright owner
2888 or by an individual or Legal Entity authorized to submit on behalf of
2889 the copyright owner. For the purposes of this definition, "submitted"
2890 means any form of electronic, verbal, or written communication sent
2891 to the Licensor or its representatives, including but not limited to
2892 communication on electronic mailing lists, source code control systems,
2893 and issue tracking systems that are managed by, or on behalf of, the
2894 Licensor for the purpose of discussing and improving the Work, but
2895 excluding communication that is conspicuously marked or otherwise
2896 designated in writing by the copyright owner as "Not a Contribution."
2897
2898 "Contributor" shall mean Licensor and any individual or Legal Entity
2899 on behalf of whom a Contribution has been received by Licensor and
2900 subsequently incorporated within the Work.
2901
2902 2. Grant of Copyright License. Subject to the terms and conditions of
2903 this License, each Contributor hereby grants to You a perpetual,
2904 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
2905 copyright license to reproduce, prepare Derivative Works of,
2906 publicly display, publicly perform, sublicense, and distribute the
2907 Work and such Derivative Works in Source or Object form.
2908
2909 3. Grant of Patent License. Subject to the terms and conditions of
2910 this License, each Contributor hereby grants to You a perpetual,
2911 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
2912 (except as stated in this section) patent license to make, have made,
2913 use, offer to sell, sell, import, and otherwise transfer the Work,
2914 where such license applies only to those patent claims licensable
2915 by such Contributor that are necessarily infringed by their
2916 Contribution(s) alone or by combination of their Contribution(s)
2917 with the Work to which such Contribution(s) was submitted. If You
2918 institute patent litigation against any entity (including a
2919 cross-claim or counterclaim in a lawsuit) alleging that the Work
2920 or a Contribution incorporated within the Work constitutes direct
2921 or contributory patent infringement, then any patent licenses
2922 granted to You under this License for that Work shall terminate
2923 as of the date such litigation is filed.
2924
2925 4. Redistribution. You may reproduce and distribute copies of the
2926 Work or Derivative Works thereof in any medium, with or without
2927 modifications, and in Source or Object form, provided that You
2928 meet the following conditions:
2929
2930 (a) You must give any other recipients of the Work or
2931 Derivative Works a copy of this License; and
2932
2933 (b) You must cause any modified files to carry prominent notices
2934 stating that You changed the files; and
2935
2936 (c) You must retain, in the Source form of any Derivative Works
2937 that You distribute, all copyright, patent, trademark, and
2938 attribution notices from the Source form of the Work,
2939 excluding those notices that do not pertain to any part of
2940 the Derivative Works; and
2941
2942 (d) If the Work includes a "NOTICE" text file as part of its
2943 distribution, then any Derivative Works that You distribute must
2944 include a readable copy of the attribution notices contained
2945 within such NOTICE file, excluding those notices that do not
2946 pertain to any part of the Derivative Works, in at least one
2947 of the following places: within a NOTICE text file distributed
2948 as part of the Derivative Works; within the Source form or
2949 documentation, if provided along with the Derivative Works; or,
2950 within a display generated by the Derivative Works, if and
2951 wherever such third-party notices normally appear. The contents
2952 of the NOTICE file are for informational purposes only and
2953 do not modify the License. You may add Your own attribution
2954 notices within Derivative Works that You distribute, alongside
2955 or as an addendum to the NOTICE text from the Work, provided
2956 that such additional attribution notices cannot be construed
2957 as modifying the License.
2958
2959 You may add Your own copyright statement to Your modifications and
2960 may provide additional or different license terms and conditions
2961 for use, reproduction, or distribution of Your modifications, or
2962 for any such Derivative Works as a whole, provided Your use,
2963 reproduction, and distribution of the Work otherwise complies with
2964 the conditions stated in this License.
2965
2966 5. Submission of Contributions. Unless You explicitly state otherwise,
2967 any Contribution intentionally submitted for inclusion in the Work
2968 by You to the Licensor shall be under the terms and conditions of
2969 this License, without any additional terms or conditions.
2970 Notwithstanding the above, nothing herein shall supersede or modify
2971 the terms of any separate license agreement you may have executed
2972 with Licensor regarding such Contributions.
2973
2974 6. Trademarks. This License does not grant permission to use the trade
2975 names, trademarks, service marks, or product names of the Licensor,
2976 except as required for reasonable and customary use in describing the
2977 origin of the Work and reproducing the content of the NOTICE file.
2978
2979 7. Disclaimer of Warranty. Unless required by applicable law or
2980 agreed to in writing, Licensor provides the Work (and each
2981 Contributor provides its Contributions) on an "AS IS" BASIS,
2982 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
2983 implied, including, without limitation, any warranties or conditions
2984 of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
2985 PARTICULAR PURPOSE. You are solely responsible for determining the
2986 appropriateness of using or redistributing the Work and assume any
2987 risks associated with Your exercise of permissions under this License.
2988
2989 8. Limitation of Liability. In no event and under no legal theory,
2990 whether in tort (including negligence), contract, or otherwise,
2991 unless required by applicable law (such as deliberate and grossly
2992 negligent acts) or agreed to in writing, shall any Contributor be
2993 liable to You for damages, including any direct, indirect, special,
2994 incidental, or consequential damages of any character arising as a
2995 result of this License or out of the use or inability to use the
2996 Work (including but not limited to damages for loss of goodwill,
2997 work stoppage, computer failure or malfunction, or any and all
2998 other commercial damages or losses), even if such Contributor
2999 has been advised of the possibility of such damages.
3000
3001 9. Accepting Warranty or Additional Liability. While redistributing
3002 the Work or Derivative Works thereof, You may choose to offer,
3003 and charge a fee for, acceptance of support, warranty, indemnity,
3004 or other liability obligations and/or rights consistent with this
3005 License. However, in accepting such obligations, You may act only
3006 on Your own behalf and on Your sole responsibility, not on behalf
3007 of any other Contributor, and only if You agree to indemnify,
3008 defend, and hold each Contributor harmless for any liability
3009 incurred by, or claims asserted against, such Contributor by reason
3010 of your accepting any such warranty or additional liability.
3011
3012 END OF TERMS AND CONDITIONS
3013
3014 APPENDIX: How to apply the Apache License to your work.
3015
3016 To apply the Apache License to your work, attach the following
3017 boilerplate notice, with the fields enclosed by brackets "[]"
3018 replaced with your own identifying information. (Don`t include
3019 the brackets!) The text should be enclosed in the appropriate
3020 comment syntax for the file format. We also recommend that a
3021 file or class name and description of purpose be included on the
3022 same "printed page" as the copyright notice for easier
3023 identification within third-party archives.
3024
3025 Copyright [yyyy] [name of copyright owner]
3026
3027 Licensed under the Apache License, Version 2.0 (the "License");
3028 you may not use this file except in compliance with the License.
3029 You may obtain a copy of the License at
3030
3031 http://www.apache.org/licenses/LICENSE-2.0
3032
3033 Unless required by applicable law or agreed to in writing, software
3034 distributed under the License is distributed on an "AS IS" BASIS,
3035 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
3036 See the License for the specific language governing permissions and
3037 limitations under the License.
3038
3039</programlisting></para></section>
3040
3041<section id="lic_3">
3042<title>Artistic-1.0</title>
3043<para><programlisting>
3044
3045The Artistic License
3046Preamble
3047
3048The intent of this document is to state the conditions under which a Package may be
3049copied, such that the Copyright Holder maintains some semblance of artistic control
3050over the development of the package, while giving the users of the package the right
3051to use and distribute the Package in a more-or-less customary fashion, plus the right
3052to make reasonable modifications.
3053
3054Definitions:
3055
3056"Package" refers to the collection of files distributed by the Copyright Holder, and
3057derivatives of that collection of files created through textual modification.
3058"Standard Version" refers to such a Package if it has not been modified, or has been
3059modified in accordance with the wishes of the Copyright Holder.
3060"Copyright Holder" is whoever is named in the copyright or copyrights for the package.
3061"You" is you, if you`re thinking about copying or distributing this Package.
3062"Reasonable copying fee" is whatever you can justify on the basis of media cost,
3063duplication charges, time of people involved, and so on. (You will not be required to
3064justify it to the Copyright Holder, but only to the computing community at large as a
3065market that must bear the fee.)
3066"Freely Available" means that no fee is charged for the item itself, though there may
3067be fees involved in handling the item. It also means that recipients of the item may
3068redistribute it under the same conditions they received it.
30691. You may make and give away verbatim copies of the source form of the Standard
3070Version of this Package without restriction, provided that you duplicate all of the
3071original copyright notices and associated disclaimers.
3072
30732. You may apply bug fixes, portability fixes and other modifications derived from the
3074Public Domain or from the Copyright Holder. A Package modified in such a way shall
3075still be considered the Standard Version.
3076
30773. You may otherwise modify your copy of this Package in any way, provided that you
3078insert a prominent notice in each changed file stating how and when you changed that
3079file, and provided that you do at least ONE of the following:
3080
3081a) place your modifications in the Public Domain or otherwise make them Freely
3082Available, such as by posting said modifications to Usenet or an equivalent medium, or
3083placing the modifications on a major archive site such as ftp.uu.net, or by allowing
3084the Copyright Holder to include your modifications in the Standard Version of the
3085Package.
3086
3087b) use the modified Package only within your corporation or organization.
3088
3089c) rename any non-standard executables so the names do not conflict with standard
3090executables, which must also be provided, and provide a separate manual page for each
3091non-standard executable that clearly documents how it differs from the Standard
3092Version.
3093
3094d) make other distribution arrangements with the Copyright Holder.
3095
30964. You may distribute the programs of this Package in object code or executable form,
3097provided that you do at least ONE of the following:
3098
3099a) distribute a Standard Version of the executables and library files, together with
3100instructions (in the manual page or equivalent) on where to get the Standard Version.
3101
3102b) accompany the distribution with the machine-readable source of the Package with
3103your modifications.
3104
3105c) accompany any non-standard executables with their corresponding Standard Version
3106executables, giving the non-standard executables non-standard names, and clearly
3107documenting the differences in manual pages (or equivalent), together with
3108instructions on where to get the Standard Version.
3109
3110d) make other distribution arrangements with the Copyright Holder.
3111
31125. You may charge a reasonable copying fee for any distribution of this Package. You
3113may charge any fee you choose for support of this Package. You may not charge a fee
3114for this Package itself. However, you may distribute this Package in aggregate with
3115other (possibly commercial) programs as part of a larger (possibly commercial)
3116software distribution provided that you do not advertise this Package as a product of
3117your own.
3118
31196. The scripts and library files supplied as input to or produced as output from the
3120programs of this Package do not automatically fall under the copyright of this
3121Package, but belong to whomever generated them, and may be sold commercially, and may
3122be aggregated with this Package.
3123
31247. C or perl subroutines supplied by you and linked into this Package shall not be
3125considered part of this Package.
3126
31278. The name of the Copyright Holder may not be used to endorse or promote products
3128derived from this software without specific prior written permission.
3129
31309. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,
3131INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS
3132FOR A PARTICULAR PURPOSE.
3133
3134The End
3135
3136</programlisting></para></section>
3137
3138<section id="lic_4">
3139<title>BSD</title>
3140<para><programlisting>
3141Copyright (c) The Regents of the University of California.
3142All rights reserved.
3143
3144Redistribution and use in source and binary forms, with or without
3145modification, are permitted provided that the following conditions
3146are met:
31471. Redistributions of source code must retain the above copyright
3148 notice, this list of conditions and the following disclaimer.
31492. Redistributions in binary form must reproduce the above copyright
3150 notice, this list of conditions and the following disclaimer in the
3151 documentation and/or other materials provided with the distribution.
31523. Neither the name of the University nor the names of its contributors
3153 may be used to endorse or promote products derived from this software
3154 without specific prior written permission.
3155
3156THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
3157ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
3158IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
3159ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
3160FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
3161DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
3162OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
3163HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
3164LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
3165OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3166SUCH DAMAGE.
3167</programlisting></para></section>
3168
3169<section id="lic_5">
3170<title>BSD-2-Clause</title>
3171<para><programlisting>
3172
3173The FreeBSD Copyright
3174
3175Copyright 1992-2010 The FreeBSD Project. All rights reserved.
3176
3177Redistribution and use in source and binary forms, with or without modification, are
3178permitted provided that the following conditions are met:
3179
3180Redistributions of source code must retain the above copyright notice, this list of
3181conditions and the following disclaimer.
3182Redistributions in binary form must reproduce the above copyright notice, this list of
3183conditions and the following disclaimer in the documentation and/or other materials
3184provided with the distribution.
3185THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS`` AND ANY EXPRESS OR IMPLIED
3186WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
3187AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD
3188PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
3189EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
3190SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
3191HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
3192OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
3193SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3194
3195The views and conclusions contained in the software and documentation are those of the
3196authors and should not be interpreted as representing official policies, either
3197expressed or implied, of the FreeBSD Project.
3198
3199</programlisting></para></section>
3200
3201<section id="lic_6">
3202<title>BSD-3-Clause</title>
3203<para><programlisting>
3204
3205Copyright (c) &lt;YEAR&gt;, &lt;OWNER&gt;
3206All rights reserved.
3207
3208Redistribution and use in source and binary forms, with or without modification, are
3209permitted provided that the following conditions are met:
3210
3211Redistributions of source code must retain the above copyright notice, this list of
3212conditions and the following disclaimer.
3213Redistributions in binary form must reproduce the above copyright notice, this list of
3214conditions and the following disclaimer in the documentation and/or other materials
3215provided with the distribution.
3216Neither the name of the &lt;ORGANIZATION&gt; nor the names of its contributors may be
3217used to endorse or promote products derived from this software without specific prior
3218written permission.
3219THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
3220EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
3221OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
3222SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
3223INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
3224TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
3225BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
3226CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
3227WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
3228DAMAGE.
3229
3230</programlisting></para></section>
3231
3232<section id="lic_7">
3233<title>BSD-4-Clause</title>
3234<para><programlisting>
3235
3236Copyright (c) &lt;year&gt;, &lt;copyright holder&gt;
3237All rights reserved.
3238
3239Redistribution and use in source and binary forms, with or without
3240modification, are permitted provided that the following conditions are met:
32411. Redistributions of source code must retain the above copyright
3242 notice, this list of conditions and the following disclaimer.
32432. Redistributions in binary form must reproduce the above copyright
3244 notice, this list of conditions and the following disclaimer in the
3245 documentation and/or other materials provided with the distribution.
32463. All advertising materials mentioning features or use of this software
3247 must display the following acknowledgement:
3248 This product includes software developed by the &lt;organization&gt;.
32494. Neither the name of the &lt;organization&gt; nor the
3250 names of its contributors may be used to endorse or promote products
3251 derived from this software without specific prior written permission.
3252
3253THIS SOFTWARE IS PROVIDED BY &lt;COPYRIGHT HOLDER&gt; ``AS IS`` AND ANY
3254EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
3255WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
3256DISCLAIMED. IN NO EVENT SHALL &lt;COPYRIGHT HOLDER&gt; BE LIABLE FOR ANY
3257DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
3258(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
3259LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
3260ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
3261(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
3262SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
3263
3264</programlisting></para></section>
3265
3266<section id="lic_8">
3267<title>BSL-1.0</title>
3268<para><programlisting>
3269
3270Boost Software License - Version 1.0 - August 17th, 2003
3271
3272Permission is hereby granted, free of charge, to any person or organization
3273obtaining a copy of the software and accompanying documentation covered by
3274this license (the "Software") to use, reproduce, display, distribute,
3275execute, and transmit the Software, and to prepare derivative works of the
3276Software, and to permit third-parties to whom the Software is furnished to
3277do so, all subject to the following:
3278
3279The copyright notices in the Software and this entire statement, including
3280the above license grant, this restriction and the following disclaimer,
3281must be included in all copies of the Software, in whole or in part, and
3282all derivative works of the Software, unless such copies or derivative
3283works are solely in the form of machine-executable object code generated by
3284a source language processor.
3285
3286THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
3287IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
3288FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
3289SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
3290FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
3291ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
3292DEALINGS IN THE SOFTWARE.
3293
3294</programlisting></para></section>
3295
3296<section id="lic_9">
3297<title>CDDL-1.0</title>
3298<para><programlisting>
3299
3300COMMON DEVELOPMENT AND DISTRIBUTION LICENSE (CDDL)
3301Version 1.0
33021. Definitions.
3303
33041.1. &amp;#8220;Contributor&amp;#8221; means each individual or entity that creates or
3305contributes to the creation of Modifications.
3306
33071.2. &amp;#8220;Contributor Version&amp;#8221; means the combination of the Original
3308Software, prior Modifications used by a Contributor (if any), and the Modifications
3309made by that particular Contributor.
3310
33111.3. &amp;#8220;Covered Software&amp;#8221; means (a) the Original Software, or (b)
3312Modifications, or (c) the combination of files containing Original Software with files
3313containing Modifications, in each case including portions thereof.
3314
33151.4. &amp;#8220;Executable&amp;#8221; means the Covered Software in any form other
3316than Source Code.
3317
33181.5. &amp;#8220;Initial Developer&amp;#8221; means the individual or entity that first
3319makes Original Software available under this License.
3320
33211.6. &amp;#8220;Larger Work&amp;#8221; means a work which combines Covered Software or
3322portions thereof with code not governed by the terms of this License.
3323
33241.7. &amp;#8220;License&amp;#8221; means this document.
3325
33261.8. &amp;#8220;Licensable&amp;#8221; means having the right to grant, to the maximum
3327extent possible, whether at the time of the initial grant or subsequently acquired,
3328any and all of the rights conveyed herein.
3329
33301.9. &amp;#8220;Modifications&amp;#8221; means the Source Code and Executable form of
3331any of the following:
3332
3333A. Any file that results from an addition to, deletion from or modification of the
3334contents of a file containing Original Software or previous Modifications;
3335
3336B. Any new file that contains any part of the Original Software or previous
3337Modification; or
3338
3339C. Any new file that is contributed or otherwise made available under the terms of
3340this License.
3341
33421.10. &amp;#8220;Original Software&amp;#8221; means the Source Code and Executable
3343form of computer software code that is originally released under this License.
3344
33451.11. &amp;#8220;Patent Claims&amp;#8221; means any patent claim(s), now owned or
3346hereafter acquired, including without limitation, method, process, and apparatus
3347claims, in any patent Licensable by grantor.
3348
33491.12. &amp;#8220;Source Code&amp;#8221; means (a) the common form of computer software
3350code in which modifications are made and (b) associated documentation included in or
3351with such code.
3352
33531.13. &amp;#8220;You&amp;#8221; (or &amp;#8220;Your&amp;#8221;) means an individual or
3354a legal entity exercising rights under, and complying with all of the terms of, this
3355License. For legal entities, &amp;#8220;You&amp;#8221; includes any entity which
3356controls, is controlled by, or is under common control with You. For purposes of this
3357definition, &amp;#8220;control&amp;#8221; means (a) the power, direct or indirect, to
3358cause the direction or management of such entity, whether by contract or otherwise, or
3359(b) ownership of more than fifty percent (50%) of the outstanding shares or beneficial
3360ownership of such entity.
3361
33622. License Grants.
3363
33642.1. The Initial Developer Grant.
3365
3366Conditioned upon Your compliance with Section 3.1 below and subject to third party
3367intellectual property claims, the Initial Developer hereby grants You a world-wide,
3368royalty-free, non-exclusive license:
3369
3370(a) under intellectual property rights (other than patent or trademark) Licensable by
3371Initial Developer, to use, reproduce, modify, display, perform, sublicense and
3372distribute the Original Software (or portions thereof), with or without Modifications,
3373and/or as part of a Larger Work; and
3374
3375(b) under Patent Claims infringed by the making, using or selling of Original
3376Software, to make, have made, use, practice, sell, and offer for sale, and/or
3377otherwise dispose of the Original Software (or portions thereof).
3378
3379(c) The licenses granted in Sections 2.1(a) and (b) are effective on the date Initial
3380Developer first distributes or otherwise makes the Original Software available to a
3381third party under the terms of this License.
3382
3383(d) Notwithstanding Section 2.1(b) above, no patent license is granted: (1) for code
3384that You delete from the Original Software, or (2) for infringements caused by: (i)
3385the modification of the Original Software, or (ii) the combination of the Original
3386Software with other software or devices.
3387
33882.2. Contributor Grant.
3389
3390Conditioned upon Your compliance with Section 3.1 below and subject to third party
3391intellectual property claims, each Contributor hereby grants You a world-wide,
3392royalty-free, non-exclusive license:
3393
3394(a) under intellectual property rights (other than patent or trademark) Licensable by
3395Contributor to use, reproduce, modify, display, perform, sublicense and distribute the
3396Modifications created by such Contributor (or portions thereof), either on an
3397unmodified basis, with other Modifications, as Covered Software and/or as part of a
3398Larger Work; and
3399
3400(b) under Patent Claims infringed by the making, using, or selling of Modifications
3401made by that Contributor either alone and/or in combination with its Contributor
3402Version (or portions of such combination), to make, use, sell, offer for sale, have
3403made, and/or otherwise dispose of: (1) Modifications made by that Contributor (or
3404portions thereof); and (2) the combination of Modifications made by that Contributor
3405with its Contributor Version (or portions of such combination).
3406
3407(c) The licenses granted in Sections 2.2(a) and 2.2(b) are effective on the date
3408Contributor first distributes or otherwise makes the Modifications available to a
3409third party.
3410
3411(d) Notwithstanding Section 2.2(b) above, no patent license is granted: (1) for any
3412code that Contributor has deleted from the Contributor Version; (2) for infringements
3413caused by: (i) third party modifications of Contributor Version, or (ii) the
3414combination of Modifications made by that Contributor with other software (except as
3415part of the Contributor Version) or other devices; or (3) under Patent Claims
3416infringed by Covered Software in the absence of Modifications made by that
3417Contributor.
3418
34193. Distribution Obligations.
3420
34213.1. Availability of Source Code.
3422
3423Any Covered Software that You distribute or otherwise make available in Executable
3424form must also be made available in Source Code form and that Source Code form must be
3425distributed only under the terms of this License. You must include a copy of this
3426License with every copy of the Source Code form of the Covered Software You distribute
3427or otherwise make available. You must inform recipients of any such Covered Software
3428in Executable form as to how they can obtain such Covered Software in Source Code form
3429in a reasonable manner on or through a medium customarily used for software exchange.
3430
34313.2. Modifications.
3432
3433The Modifications that You create or to which You contribute are governed by the terms
3434of this License. You represent that You believe Your Modifications are Your original
3435creation(s) and/or You have sufficient rights to grant the rights conveyed by this
3436License.
3437
34383.3. Required Notices.
3439
3440You must include a notice in each of Your Modifications that identifies You as the
3441Contributor of the Modification. You may not remove or alter any copyright, patent or
3442trademark notices contained within the Covered Software, or any notices of licensing
3443or any descriptive text giving attribution to any Contributor or the Initial
3444Developer.
3445
34463.4. Application of Additional Terms.
3447
3448You may not offer or impose any terms on any Covered Software in Source Code form that
3449alters or restricts the applicable version of this License or the
3450recipients&amp;#8217; rights hereunder. You may choose to offer, and to charge a fee
3451for, warranty, support, indemnity or liability obligations to one or more recipients
3452of Covered Software. However, you may do so only on Your own behalf, and not on behalf
3453of the Initial Developer or any Contributor. You must make it absolutely clear that
3454any such warranty, support, indemnity or liability obligation is offered by You alone,
3455and You hereby agree to indemnify the Initial Developer and every Contributor for any
3456liability incurred by the Initial Developer or such Contributor as a result of
3457warranty, support, indemnity or liability terms You offer.
3458
34593.5. Distribution of Executable Versions.
3460
3461You may distribute the Executable form of the Covered Software under the terms of this
3462License or under the terms of a license of Your choice, which may contain terms
3463different from this License, provided that You are in compliance with the terms of
3464this License and that the license for the Executable form does not attempt to limit or
3465alter the recipient&amp;#8217;s rights in the Source Code form from the rights set
3466forth in this License. If You distribute the Covered Software in Executable form under
3467a different license, You must make it absolutely clear that any terms which differ
3468from this License are offered by You alone, not by the Initial Developer or
3469Contributor. You hereby agree to indemnify the Initial Developer and every Contributor
3470for any liability incurred by the Initial Developer or such Contributor as a result of
3471any such terms You offer.
3472
34733.6. Larger Works.
3474
3475You may create a Larger Work by combining Covered Software with other code not
3476governed by the terms of this License and distribute the Larger Work as a single
3477product. In such a case, You must make sure the requirements of this License are
3478fulfilled for the Covered Software.
3479
34804. Versions of the License.
3481
34824.1. New Versions.
3483
3484Sun Microsystems, Inc. is the initial license steward and may publish revised and/or
3485new versions of this License from time to time. Each version will be given a
3486distinguishing version number. Except as provided in Section 4.3, no one other than
3487the license steward has the right to modify this License.
3488
34894.2. Effect of New Versions.
3490
3491You may always continue to use, distribute or otherwise make the Covered Software
3492available under the terms of the version of the License under which You originally
3493received the Covered Software. If the Initial Developer includes a notice in the
3494Original Software prohibiting it from being distributed or otherwise made available
3495under any subsequent version of the License, You must distribute and make the Covered
3496Software available under the terms of the version of the License under which You
3497originally received the Covered Software. Otherwise, You may also choose to use,
3498distribute or otherwise make the Covered Software available under the terms of any
3499subsequent version of the License published by the license steward.
3500
35014.3. Modified Versions.
3502
3503When You are an Initial Developer and You want to create a new license for Your
3504Original Software, You may create and use a modified version of this License if You:
3505(a) rename the license and remove any references to the name of the license steward
3506(except to note that the license differs from this License); and (b) otherwise make it
3507clear that the license contains terms which differ from this License.
3508
35095. DISCLAIMER OF WARRANTY.
3510
3511COVERED SOFTWARE IS PROVIDED UNDER THIS LICENSE ON AN &amp;#8220;AS IS&amp;#8221;
3512BASIS, WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
3513LIMITATION, WARRANTIES THAT THE COVERED SOFTWARE IS FREE OF DEFECTS, MERCHANTABLE, FIT
3514FOR A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE RISK AS TO THE QUALITY AND
3515PERFORMANCE OF THE COVERED SOFTWARE IS WITH YOU. SHOULD ANY COVERED SOFTWARE PROVE
3516DEFECTIVE IN ANY RESPECT, YOU (NOT THE INITIAL DEVELOPER OR ANY OTHER CONTRIBUTOR)
3517ASSUME THE COST OF ANY NECESSARY SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER OF
3518WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS LICENSE. NO USE OF ANY COVERED SOFTWARE
3519IS AUTHORIZED HEREUNDER EXCEPT UNDER THIS DISCLAIMER.
3520
35216. TERMINATION.
3522
35236.1. This License and the rights granted hereunder will terminate automatically if You
3524fail to comply with terms herein and fail to cure such breach within 30 days of
3525becoming aware of the breach. Provisions which, by their nature, must remain in effect
3526beyond the termination of this License shall survive.
3527
35286.2. If You assert a patent infringement claim (excluding declaratory judgment
3529actions) against Initial Developer or a Contributor (the Initial Developer or
3530Contributor against whom You assert such claim is referred to as
3531&amp;#8220;Participant&amp;#8221;) alleging that the Participant Software (meaning the
3532Contributor Version where the Participant is a Contributor or the Original Software
3533where the Participant is the Initial Developer) directly or indirectly infringes any
3534patent, then any and all rights granted directly or indirectly to You by such
3535Participant, the Initial Developer (if the Initial Developer is not the Participant)
3536and all Contributors under Sections 2.1 and/or 2.2 of this License shall, upon 60 days
3537notice from Participant terminate prospectively and automatically at the expiration of
3538such 60 day notice period, unless if within such 60 day period You withdraw Your claim
3539with respect to the Participant Software against such Participant either unilaterally
3540or pursuant to a written agreement with Participant.
3541
35426.3. In the event of termination under Sections 6.1 or 6.2 above, all end user
3543licenses that have been validly granted by You or any distributor hereunder prior to
3544termination (excluding licenses granted to You by any distributor) shall survive
3545termination.
3546
35477. LIMITATION OF LIABILITY.
3548
3549UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL THEORY, WHETHER TORT (INCLUDING NEGLIGENCE),
3550CONTRACT, OR OTHERWISE, SHALL YOU, THE INITIAL DEVELOPER, ANY OTHER CONTRIBUTOR, OR
3551ANY DISTRIBUTOR OF COVERED SOFTWARE, OR ANY SUPPLIER OF ANY OF SUCH PARTIES, BE LIABLE
3552TO ANY PERSON FOR ANY INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY
3553CHARACTER INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOST PROFITS, LOSS OF GOODWILL,
3554WORK STOPPAGE, COMPUTER FAILURE OR MALFUNCTION, OR ANY AND ALL OTHER COMMERCIAL
3555DAMAGES OR LOSSES, EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF THE POSSIBILITY OF
3556SUCH DAMAGES. THIS LIMITATION OF LIABILITY SHALL NOT APPLY TO LIABILITY FOR DEATH OR
3557PERSONAL INJURY RESULTING FROM SUCH PARTY&amp;#8217;S NEGLIGENCE TO THE EXTENT
3558APPLICABLE LAW PROHIBITS SUCH LIMITATION. SOME JURISDICTIONS DO NOT ALLOW THE
3559EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THIS EXCLUSION AND
3560LIMITATION MAY NOT APPLY TO YOU.
3561
35628. U.S. GOVERNMENT END USERS.
3563
3564The Covered Software is a &amp;#8220;commercial item,&amp;#8221; as that term is
3565defined in 48 C.F.R. 2.101 (Oct. 1995), consisting of &amp;#8220;commercial computer
3566software&amp;#8221; (as that term is defined at 48 C.F.R. &amp;#167;
3567252.227-7014(a)(1)) and &amp;#8220;commercial computer software
3568documentation&amp;#8221; as such terms are used in 48 C.F.R. 12.212 (Sept. 1995).
3569Consistent with 48 C.F.R. 12.212 and 48 C.F.R. 227.7202-1 through 227.7202-4 (June
35701995), all U.S. Government End Users acquire Covered Software with only those rights
3571set forth herein. This U.S. Government Rights clause is in lieu of, and supersedes,
3572any other FAR, DFAR, or other clause or provision that addresses Government rights in
3573computer software under this License.
3574
35759. MISCELLANEOUS.
3576
3577This License represents the complete agreement concerning subject matter hereof. If
3578any provision of this License is held to be unenforceable, such provision shall be
3579reformed only to the extent necessary to make it enforceable. This License shall be
3580governed by the law of the jurisdiction specified in a notice contained within the
3581Original Software (except to the extent applicable law, if any, provides otherwise),
3582excluding such jurisdiction&amp;#8217;s conflict-of-law provisions. Any litigation
3583relating to this License shall be subject to the jurisdiction of the courts located in
3584the jurisdiction and venue specified in a notice contained within the Original
3585Software, with the losing party responsible for costs, including, without limitation,
3586court costs and reasonable attorneys&amp;#8217; fees and expenses. The application of
3587the United Nations Convention on Contracts for the International Sale of Goods is
3588expressly excluded. Any law or regulation which provides that the language of a
3589contract shall be construed against the drafter shall not apply to this License. You
3590agree that You alone are responsible for compliance with the United States export
3591administration regulations (and the export control laws and regulation of any other
3592countries) when You use, distribute or otherwise make available any Covered Software.
3593
359410. RESPONSIBILITY FOR CLAIMS.
3595
3596As between Initial Developer and the Contributors, each party is responsible for
3597claims and damages arising, directly or indirectly, out of its utilization of rights
3598under this License and You agree to work with Initial Developer and Contributors to
3599distribute such responsibility on an equitable basis. Nothing herein is intended or
3600shall be deemed to constitute any admission of liability.
3601
3602</programlisting></para></section>
3603
3604<section id="lic_10">
3605<title>CDS</title>
3606<para><programlisting>
3607This software is copyrighted by Cadence Design Systems, Inc., and other
3608parties. The following terms apply to all files associated with the
3609software unless explicitly disclaimed in individual files.
3610
3611The authors hereby grant permission to use, copy, modify, distribute,
3612and license this software and its documentation for any purpose, provided
3613that existing copyright notices are retained in all copies and that this
3614notice is included verbatim in any distributions. No written agreement,
3615license, or royalty fee is required for any of the authorized uses.
3616Modifications to this software may be copyrighted by their authors
3617and need not follow the licensing terms described here, provided that
3618the new terms are clearly indicated on the first page of each file where
3619they apply.
3620
3621IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
3622FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
3623ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
3624DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
3625POSSIBILITY OF SUCH DAMAGE.
3626
3627THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
3628INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
3629FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE
3630IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
3631NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
3632MODIFICATIONS.
3633
3634GOVERNMENT USE: If you are acquiring this software on behalf of the
3635U.S. government, the Government shall have only "Restricted Rights"
3636in the software and related documentation as defined in the Federal
3637Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2). If you
3638are acquiring the software on behalf of the Department of Defense, the
3639software shall be classified as "Commercial Computer Software" and the
3640Government shall have only "Restricted Rights" as defined in Clause
3641252.227-7013 (c) (1) of DFARs. Notwithstanding the foregoing, the
3642authors grant the U.S. Government and others acting in its behalf
3643permission to use and distribute the software in accordance with the
3644terms specified in this license.
3645
3646-----------------------------------------------------------------------
3647 Following is the original agreement for the Tcl/Tk software from
3648 Sun Microsystems.
3649-----------------------------------------------------------------------
3650
3651This software is copyrighted by the Regents of the University of
3652California, Sun Microsystems, Inc., and other parties. The following
3653terms apply to all files associated with the software unless explicitly
3654disclaimed in individual files.
3655
3656The authors hereby grant permission to use, copy, modify, distribute,
3657and license this software and its documentation for any purpose, provided
3658that existing copyright notices are retained in all copies and that this
3659notice is included verbatim in any distributions. No written agreement,
3660license, or royalty fee is required for any of the authorized uses.
3661Modifications to this software may be copyrighted by their authors
3662and need not follow the licensing terms described here, provided that
3663the new terms are clearly indicated on the first page of each file where
3664they apply.
3665
3666IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
3667FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
3668ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
3669DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
3670POSSIBILITY OF SUCH DAMAGE.
3671
3672THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
3673INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
3674FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE
3675IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
3676NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
3677MODIFICATIONS.
3678
3679GOVERNMENT USE: If you are acquiring this software on behalf of the
3680U.S. government, the Government shall have only "Restricted Rights"
3681in the software and related documentation as defined in the Federal
3682Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2). If you
3683are acquiring the software on behalf of the Department of Defense, the
3684software shall be classified as "Commercial Computer Software" and the
3685Government shall have only "Restricted Rights" as defined in Clause
3686252.227-7013 (c) (1) of DFARs. Notwithstanding the foregoing, the
3687authors grant the U.S. Government and others acting in its behalf
3688permission to use and distribute the software in accordance with the
3689terms specified in this license.
3690</programlisting></para></section>
3691
3692<section id="lic_11">
3693<title>CPL-1.0</title>
3694<para><programlisting>
3695
3696Common Public License Version 1.0
3697
3698THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC
3699LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM
3700CONSTITUTES RECIPIENT`S ACCEPTANCE OF THIS AGREEMENT.
3701
37021. DEFINITIONS
3703
3704"Contribution" means:
3705
3706a) in the case of the initial Contributor, the initial code and
3707documentation distributed under this Agreement, and
3708
3709b) in the case of each subsequent Contributor:
3710
3711i) changes to the Program, and
3712
3713ii) additions to the Program;
3714
3715where such changes and/or additions to the Program originate from and are
3716distributed by that particular Contributor. A Contribution `originates` from a
3717Contributor if it was added to the Program by such Contributor itself or anyone
3718acting on such Contributor`s behalf. Contributions do not include additions to
3719the Program which: (i) are separate modules of software distributed in
3720conjunction with the Program under their own license agreement, and (ii) are not
3721derivative works of the Program.
3722
3723"Contributor" means any person or entity that distributes the Program.
3724
3725"Licensed Patents " mean patent claims licensable by a Contributor which are
3726necessarily infringed by the use or sale of its Contribution alone or when
3727combined with the Program.
3728
3729"Program" means the Contributions distributed in accordance with this Agreement.
3730
3731"Recipient" means anyone who receives the Program under this Agreement,
3732including all Contributors.
3733
37342. GRANT OF RIGHTS
3735
3736a) Subject to the terms of this Agreement, each Contributor hereby grants
3737Recipient a non-exclusive, worldwide, royalty-free copyright license to
3738reproduce, prepare derivative works of, publicly display, publicly perform,
3739distribute and sublicense the Contribution of such Contributor, if any, and such
3740derivative works, in source code and object code form.
3741
3742b) Subject to the terms of this Agreement, each Contributor hereby grants
3743Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed
3744Patents to make, use, sell, offer to sell, import and otherwise transfer the
3745Contribution of such Contributor, if any, in source code and object code form.
3746This patent license shall apply to the combination of the Contribution and the
3747Program if, at the time the Contribution is added by the Contributor, such
3748addition of the Contribution causes such combination to be covered by the
3749Licensed Patents. The patent license shall not apply to any other combinations
3750which include the Contribution. No hardware per se is licensed hereunder.
3751
3752c) Recipient understands that although each Contributor grants the licenses
3753to its Contributions set forth herein, no assurances are provided by any
3754Contributor that the Program does not infringe the patent or other intellectual
3755property rights of any other entity. Each Contributor disclaims any liability to
3756Recipient for claims brought by any other entity based on infringement of
3757intellectual property rights or otherwise. As a condition to exercising the
3758rights and licenses granted hereunder, each Recipient hereby assumes sole
3759responsibility to secure any other intellectual property rights needed, if any.
3760For example, if a third party patent license is required to allow Recipient to
3761distribute the Program, it is Recipient`s responsibility to acquire that license
3762before distributing the Program.
3763
3764d) Each Contributor represents that to its knowledge it has sufficient
3765copyright rights in its Contribution, if any, to grant the copyright license set
3766forth in this Agreement.
3767
37683. REQUIREMENTS
3769
3770A Contributor may choose to distribute the Program in object code form under its
3771own license agreement, provided that:
3772
3773a) it complies with the terms and conditions of this Agreement; and
3774
3775b) its license agreement:
3776
3777i) effectively disclaims on behalf of all Contributors all warranties and
3778conditions, express and implied, including warranties or conditions of title and
3779non-infringement, and implied warranties or conditions of merchantability and
3780fitness for a particular purpose;
3781
3782ii) effectively excludes on behalf of all Contributors all liability for
3783damages, including direct, indirect, special, incidental and consequential
3784damages, such as lost profits;
3785
3786iii) states that any provisions which differ from this Agreement are offered
3787by that Contributor alone and not by any other party; and
3788
3789iv) states that source code for the Program is available from such
3790Contributor, and informs licensees how to obtain it in a reasonable manner on or
3791through a medium customarily used for software exchange.
3792
3793When the Program is made available in source code form:
3794
3795a) it must be made available under this Agreement; and
3796
3797b) a copy of this Agreement must be included with each copy of the Program.
3798
3799Contributors may not remove or alter any copyright notices contained within the
3800Program.
3801
3802Each Contributor must identify itself as the originator of its Contribution, if
3803any, in a manner that reasonably allows subsequent Recipients to identify the
3804originator of the Contribution.
3805
38064. COMMERCIAL DISTRIBUTION
3807
3808Commercial distributors of software may accept certain responsibilities with
3809respect to end users, business partners and the like. While this license is
3810intended to facilitate the commercial use of the Program, the Contributor who
3811includes the Program in a commercial product offering should do so in a manner
3812which does not create potential liability for other Contributors. Therefore, if
3813a Contributor includes the Program in a commercial product offering, such
3814Contributor ("Commercial Contributor") hereby agrees to defend and indemnify
3815every other Contributor ("Indemnified Contributor") against any losses, damages
3816and costs (collectively "Losses") arising from claims, lawsuits and other legal
3817actions brought by a third party against the Indemnified Contributor to the
3818extent caused by the acts or omissions of such Commercial Contributor in
3819connection with its distribution of the Program in a commercial product
3820offering. The obligations in this section do not apply to any claims or Losses
3821relating to any actual or alleged intellectual property infringement. In order
3822to qualify, an Indemnified Contributor must: a) promptly notify the Commercial
3823Contributor in writing of such claim, and b) allow the Commercial Contributor to
3824control, and cooperate with the Commercial Contributor in, the defense and any
3825related settlement negotiations. The Indemnified Contributor may participate in
3826any such claim at its own expense.
3827
3828For example, a Contributor might include the Program in a commercial product
3829offering, Product X. That Contributor is then a Commercial Contributor. If that
3830Commercial Contributor then makes performance claims, or offers warranties
3831related to Product X, those performance claims and warranties are such
3832Commercial Contributor`s responsibility alone. Under this section, the
3833Commercial Contributor would have to defend claims against the other
3834Contributors related to those performance claims and warranties, and if a court
3835requires any other Contributor to pay any damages as a result, the Commercial
3836Contributor must pay those damages.
3837
38385. NO WARRANTY
3839
3840EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN
3841"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR
3842IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE,
3843NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each
3844Recipient is solely responsible for determining the appropriateness of using and
3845distributing the Program and assumes all risks associated with its exercise of
3846rights under this Agreement, including but not limited to the risks and costs of
3847program errors, compliance with applicable laws, damage to or loss of data,
3848programs or equipment, and unavailability or interruption of operations.
3849
38506. DISCLAIMER OF LIABILITY
3851
3852EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY
3853CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL,
3854SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST
3855PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
3856STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
3857OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS
3858GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
3859
38607. GENERAL
3861
3862If any provision of this Agreement is invalid or unenforceable under applicable
3863law, it shall not affect the validity or enforceability of the remainder of the
3864terms of this Agreement, and without further action by the parties hereto, such
3865provision shall be reformed to the minimum extent necessary to make such
3866provision valid and enforceable.
3867
3868If Recipient institutes patent litigation against a Contributor with respect to
3869a patent applicable to software (including a cross-claim or counterclaim in a
3870lawsuit), then any patent licenses granted by that Contributor to such Recipient
3871under this Agreement shall terminate as of the date such litigation is filed. In
3872addition, if Recipient institutes patent litigation against any entity
3873(including a cross-claim or counterclaim in a lawsuit) alleging that the Program
3874itself (excluding combinations of the Program with other software or hardware)
3875infringes such Recipient`s patent(s), then such Recipient`s rights granted under
3876Section 2(b) shall terminate as of the date such litigation is filed.
3877
3878All Recipient`s rights under this Agreement shall terminate if it fails to
3879comply with any of the material terms or conditions of this Agreement and does
3880not cure such failure in a reasonable period of time after becoming aware of
3881such noncompliance. If all Recipient`s rights under this Agreement terminate,
3882Recipient agrees to cease use and distribution of the Program as soon as
3883reasonably practicable. However, Recipient`s obligations under this Agreement
3884and any licenses granted by Recipient relating to the Program shall continue and
3885survive.
3886
3887Everyone is permitted to copy and distribute copies of this Agreement, but in
3888order to avoid inconsistency the Agreement is copyrighted and may only be
3889modified in the following manner. The Agreement Steward reserves the right to
3890publish new versions (including revisions) of this Agreement from time to time.
3891No one other than the Agreement Steward has the right to modify this Agreement.
3892IBM is the initial Agreement Steward. IBM may assign the responsibility to serve
3893as the Agreement Steward to a suitable separate entity. Each new version of the
3894Agreement will be given a distinguishing version number. The Program (including
3895Contributions) may always be distributed subject to the version of the Agreement
3896under which it was received. In addition, after a new version of the Agreement
3897is published, Contributor may elect to distribute the Program (including its
3898Contributions) under the new version. Except as expressly stated in Sections
38992(a) and 2(b) above, Recipient receives no rights or licenses to the
3900intellectual property of any Contributor under this Agreement, whether
3901expressly, by implication, estoppel or otherwise. All rights in the Program not
3902expressly granted under this Agreement are reserved.
3903
3904This Agreement is governed by the laws of the State of New York and the
3905intellectual property laws of the United States of America. No party to this
3906Agreement will bring a legal action under this Agreement more than one year
3907after the cause of action arose. Each party waives its rights to a jury trial in
3908any resulting litigation.
3909
3910</programlisting></para></section>
3911
3912<section id="lic_12">
3913<title>CUP</title>
3914<para><programlisting>
3915CUP PARSER GENERATOR COPYRIGHT NOTICE, LICENSE AND DISCLAIMER.
3916
3917Copyright 1996 by Scott Hudson, Frank Flannery, C. Scott Ananian
3918
3919Permission to use, copy, modify, and distribute this software and its
3920documentation for any purpose and without fee is hereby granted,
3921provided that the above copyright notice appear in all copies and that
3922both the copyright notice and this permission notice and warranty
3923disclaimer appear in supporting documentation, and that the names of
3924the authors or their employers not be used in advertising or publicity
3925pertaining to distribution of the software without specific, written
3926prior permission.
3927
3928The authors and their employers disclaim all warranties with regard to
3929this software, including all implied warranties of merchantability and
3930fitness. In no event shall the authors or their employers be liable
3931for any special, indirect or consequential damages or any damages
3932whatsoever resulting from loss of use, data or profits, whether in an
3933action of contract, negligence or other tortious action, arising out of
3934or in connection with the use or performance of this software.
3935</programlisting></para></section>
3936
3937<section id="lic_13">
3938<title>EPL-1.0</title>
3939<para><programlisting>
3940
3941Eclipse Public License - v 1.0
3942
3943THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE PUBLIC LICENSE
3944("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES
3945RECIPIENT`S ACCEPTANCE OF THIS AGREEMENT.
3946
39471. DEFINITIONS
3948
3949"Contribution" means:
3950
3951a) in the case of the initial Contributor, the initial code and documentation
3952distributed under this Agreement, and
3953b) in the case of each subsequent Contributor:
3954i) changes to the Program, and
3955ii) additions to the Program;
3956where such changes and/or additions to the Program originate from and are distributed
3957by that particular Contributor. A Contribution `originates` from a Contributor if it
3958was added to the Program by such Contributor itself or anyone acting on such
3959Contributor`s behalf. Contributions do not include additions to the Program which: (i)
3960are separate modules of software distributed in conjunction with the Program under
3961their own license agreement, and (ii) are not derivative works of the Program.
3962"Contributor" means any person or entity that distributes the Program.
3963
3964"Licensed Patents" mean patent claims licensable by a Contributor which are
3965necessarily infringed by the use or sale of its Contribution alone or when combined
3966with the Program.
3967
3968"Program" means the Contributions distributed in accordance with this Agreement.
3969
3970"Recipient" means anyone who receives the Program under this Agreement, including all
3971Contributors.
3972
39732. GRANT OF RIGHTS
3974
3975a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a
3976non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare
3977derivative works of, publicly display, publicly perform, distribute and sublicense the
3978Contribution of such Contributor, if any, and such derivative works, in source code
3979and object code form.
3980b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a
3981non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make,
3982use, sell, offer to sell, import and otherwise transfer the Contribution of such
3983Contributor, if any, in source code and object code form. This patent license shall
3984apply to the combination of the Contribution and the Program if, at the time the
3985Contribution is added by the Contributor, such addition of the Contribution causes
3986such combination to be covered by the Licensed Patents. The patent license shall not
3987apply to any other combinations which include the Contribution. No hardware per se is
3988licensed hereunder.
3989c) Recipient understands that although each Contributor grants the licenses to its
3990Contributions set forth herein, no assurances are provided by any Contributor that the
3991Program does not infringe the patent or other intellectual property rights of any
3992other entity. Each Contributor disclaims any liability to Recipient for claims brought
3993by any other entity based on infringement of intellectual property rights or
3994otherwise. As a condition to exercising the rights and licenses granted hereunder,
3995each Recipient hereby assumes sole responsibility to secure any other intellectual
3996property rights needed, if any. For example, if a third party patent license is
3997required to allow Recipient to distribute the Program, it is Recipient`s
3998responsibility to acquire that license before distributing the Program.
3999d) Each Contributor represents that to its knowledge it has sufficient copyright
4000rights in its Contribution, if any, to grant the copyright license set forth in this
4001Agreement.
40023. REQUIREMENTS
4003
4004A Contributor may choose to distribute the Program in object code form under its own
4005license agreement, provided that:
4006
4007a) it complies with the terms and conditions of this Agreement; and
4008b) its license agreement:
4009i) effectively disclaims on behalf of all Contributors all warranties and conditions,
4010express and implied, including warranties or conditions of title and non-infringement,
4011and implied warranties or conditions of merchantability and fitness for a particular
4012purpose;
4013ii) effectively excludes on behalf of all Contributors all liability for damages,
4014including direct, indirect, special, incidental and consequential damages, such as
4015lost profits;
4016iii) states that any provisions which differ from this Agreement are offered by that
4017Contributor alone and not by any other party; and
4018iv) states that source code for the Program is available from such Contributor, and
4019informs licensees how to obtain it in a reasonable manner on or through a medium
4020customarily used for software exchange.
4021When the Program is made available in source code form:
4022
4023a) it must be made available under this Agreement; and
4024b) a copy of this Agreement must be included with each copy of the Program.
4025Contributors may not remove or alter any copyright notices contained within the
4026Program.
4027
4028Each Contributor must identify itself as the originator of its Contribution, if any,
4029in a manner that reasonably allows subsequent Recipients to identify the originator of
4030the Contribution.
4031
40324. COMMERCIAL DISTRIBUTION
4033
4034Commercial distributors of software may accept certain responsibilities with respect
4035to end users, business partners and the like. While this license is intended to
4036facilitate the commercial use of the Program, the Contributor who includes the Program
4037in a commercial product offering should do so in a manner which does not create
4038potential liability for other Contributors. Therefore, if a Contributor includes the
4039Program in a commercial product offering, such Contributor ("Commercial Contributor")
4040hereby agrees to defend and indemnify every other Contributor ("Indemnified
4041Contributor") against any losses, damages and costs (collectively "Losses") arising
4042from claims, lawsuits and other legal actions brought by a third party against the
4043Indemnified Contributor to the extent caused by the acts or omissions of such
4044Commercial Contributor in connection with its distribution of the Program in a
4045commercial product offering. The obligations in this section do not apply to any
4046claims or Losses relating to any actual or alleged intellectual property infringement.
4047In order to qualify, an Indemnified Contributor must: a) promptly notify the
4048Commercial Contributor in writing of such claim, and b) allow the Commercial
4049Contributor to control, and cooperate with the Commercial Contributor in, the defense
4050and any related settlement negotiations. The Indemnified Contributor may participate
4051in any such claim at its own expense.
4052
4053For example, a Contributor might include the Program in a commercial product offering,
4054Product X. That Contributor is then a Commercial Contributor. If that Commercial
4055Contributor then makes performance claims, or offers warranties related to Product X,
4056those performance claims and warranties are such Commercial Contributor`s
4057responsibility alone. Under this section, the Commercial Contributor would have to
4058defend claims against the other Contributors related to those performance claims and
4059warranties, and if a court requires any other Contributor to pay any damages as a
4060result, the Commercial Contributor must pay those damages.
4061
40625. NO WARRANTY
4063
4064EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS"
4065BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED
4066INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE,
4067NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient
4068is solely responsible for determining the appropriateness of using and distributing
4069the Program and assumes all risks associated with its exercise of rights under this
4070Agreement , including but not limited to the risks and costs of program errors,
4071compliance with applicable laws, damage to or loss of data, programs or equipment, and
4072unavailability or interruption of operations.
4073
40746. DISCLAIMER OF LIABILITY
4075
4076EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY
4077CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
4078EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS),
4079HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
4080OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR
4081DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF
4082ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
4083
40847. GENERAL
4085
4086If any provision of this Agreement is invalid or unenforceable under applicable law,
4087it shall not affect the validity or enforceability of the remainder of the terms of
4088this Agreement, and without further action by the parties hereto, such provision shall
4089be reformed to the minimum extent necessary to make such provision valid and
4090enforceable.
4091
4092If Recipient institutes patent litigation against any entity (including a cross-claim
4093or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations
4094of the Program with other software or hardware) infringes such Recipient`s patent(s),
4095then such Recipient`s rights granted under Section 2(b) shall terminate as of the date
4096such litigation is filed.
4097
4098All Recipient`s rights under this Agreement shall terminate if it fails to comply with
4099any of the material terms or conditions of this Agreement and does not cure such
4100failure in a reasonable period of time after becoming aware of such noncompliance. If
4101all Recipient`s rights under this Agreement terminate, Recipient agrees to cease use
4102and distribution of the Program as soon as reasonably practicable. However,
4103Recipient`s obligations under this Agreement and any licenses granted by Recipient
4104relating to the Program shall continue and survive.
4105
4106Everyone is permitted to copy and distribute copies of this Agreement, but in order to
4107avoid inconsistency the Agreement is copyrighted and may only be modified in the
4108following manner. The Agreement Steward reserves the right to publish new versions
4109(including revisions) of this Agreement from time to time. No one other than the
4110Agreement Steward has the right to modify this Agreement. The Eclipse Foundation is
4111the initial Agreement Steward. The Eclipse Foundation may assign the responsibility to
4112serve as the Agreement Steward to a suitable separate entity. Each new version of the
4113Agreement will be given a distinguishing version number. The Program (including
4114Contributions) may always be distributed subject to the version of the Agreement under
4115which it was received. In addition, after a new version of the Agreement is published,
4116Contributor may elect to distribute the Program (including its Contributions) under
4117the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient
4118receives no rights or licenses to the intellectual property of any Contributor under
4119this Agreement, whether expressly, by implication, estoppel or otherwise. All rights
4120in the Program not expressly granted under this Agreement are reserved.
4121
4122This Agreement is governed by the laws of the State of New York and the intellectual
4123property laws of the United States of America. No party to this Agreement will bring a
4124legal action under this Agreement more than one year after the cause of action arose.
4125Each party waives its rights to a jury trial in any resulting litigation.
4126
4127</programlisting></para></section>
4128
4129<section id="lic_14">
4130<title>Elfutils-Exception</title>
4131<para><programlisting>
4132 This file describes the limits of the Exception under which you are allowed
4133 to distribute Non-GPL Code in linked combination with Red Hat elfutils.
4134 For the full text of the license, please see one of the header files
4135 included with the source distribution or the file COPYING found in the
4136 top level directory of the source.
4137
4138 The Approved Interfaces are the functions declared in the files:
4139
4140 libelf.h
4141 libdw.h
4142 libdwfl.h
4143
4144</programlisting></para></section>
4145
4146<section id="lic_15">
4147<title>FSF-Unlimited</title>
4148<para><programlisting>
4149Copyright (C) 1997-2010 Free Software Foundation, Inc.
4150This file is free software; the Free Software Foundation
4151gives unlimited permission to copy and/or distribute it,
4152with or without modifications, as long as this notice is preserved.
4153</programlisting></para></section>
4154
4155<section id="lic_16">
4156<title>FreeType</title>
4157<para><programlisting>
4158 The FreeType Project LICENSE
4159 ----------------------------
4160
4161 2006-Jan-27
4162
4163 Copyright 1996-2002, 2006 by
4164 David Turner, Robert Wilhelm, and Werner Lemberg
4165
4166
4167
4168Introduction
4169============
4170
4171 The FreeType Project is distributed in several archive packages;
4172 some of them may contain, in addition to the FreeType font engine,
4173 various tools and contributions which rely on, or relate to, the
4174 FreeType Project.
4175
4176 This license applies to all files found in such packages, and
4177 which do not fall under their own explicit license. The license
4178 affects thus the FreeType font engine, the test programs,
4179 documentation and makefiles, at the very least.
4180
4181 This license was inspired by the BSD, Artistic, and IJG
4182 (Independent JPEG Group) licenses, which all encourage inclusion
4183 and use of free software in commercial and freeware products
4184 alike. As a consequence, its main points are that:
4185
4186 o We don't promise that this software works. However, we will be
4187 interested in any kind of bug reports. (`as is' distribution)
4188
4189 o You can use this software for whatever you want, in parts or
4190 full form, without having to pay us. (`royalty-free' usage)
4191
4192 o You may not pretend that you wrote this software. If you use
4193 it, or only parts of it, in a program, you must acknowledge
4194 somewhere in your documentation that you have used the
4195 FreeType code. (`credits')
4196
4197 We specifically permit and encourage the inclusion of this
4198 software, with or without modifications, in commercial products.
4199 We disclaim all warranties covering The FreeType Project and
4200 assume no liability related to The FreeType Project.
4201
4202
4203 Finally, many people asked us for a preferred form for a
4204 credit/disclaimer to use in compliance with this license. We thus
4205 encourage you to use the following text:
4206
4207 """
4208 Portions of this software are copyright � &lt;year&gt; The FreeType
4209 Project (www.freetype.org). All rights reserved.
4210 """
4211
4212 Please replace &lt;year&gt; with the value from the FreeType version you
4213 actually use.
4214
4215
4216Legal Terms
4217===========
4218
42190. Definitions
4220--------------
4221
4222 Throughout this license, the terms `package', `FreeType Project',
4223 and `FreeType archive' refer to the set of files originally
4224 distributed by the authors (David Turner, Robert Wilhelm, and
4225 Werner Lemberg) as the `FreeType Project', be they named as alpha,
4226 beta or final release.
4227
4228 `You' refers to the licensee, or person using the project, where
4229 `using' is a generic term including compiling the project's source
4230 code as well as linking it to form a `program' or `executable'.
4231 This program is referred to as `a program using the FreeType
4232 engine'.
4233
4234 This license applies to all files distributed in the original
4235 FreeType Project, including all source code, binaries and
4236 documentation, unless otherwise stated in the file in its
4237 original, unmodified form as distributed in the original archive.
4238 If you are unsure whether or not a particular file is covered by
4239 this license, you must contact us to verify this.
4240
4241 The FreeType Project is copyright (C) 1996-2000 by David Turner,
4242 Robert Wilhelm, and Werner Lemberg. All rights reserved except as
4243 specified below.
4244
42451. No Warranty
4246--------------
4247
4248 THE FREETYPE PROJECT IS PROVIDED `AS IS' WITHOUT WARRANTY OF ANY
4249 KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
4250 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
4251 PURPOSE. IN NO EVENT WILL ANY OF THE AUTHORS OR COPYRIGHT HOLDERS
4252 BE LIABLE FOR ANY DAMAGES CAUSED BY THE USE OR THE INABILITY TO
4253 USE, OF THE FREETYPE PROJECT.
4254
42552. Redistribution
4256-----------------
4257
4258 This license grants a worldwide, royalty-free, perpetual and
4259 irrevocable right and license to use, execute, perform, compile,
4260 display, copy, create derivative works of, distribute and
4261 sublicense the FreeType Project (in both source and object code
4262 forms) and derivative works thereof for any purpose; and to
4263 authorize others to exercise some or all of the rights granted
4264 herein, subject to the following conditions:
4265
4266 o Redistribution of source code must retain this license file
4267 (`FTL.TXT') unaltered; any additions, deletions or changes to
4268 the original files must be clearly indicated in accompanying
4269 documentation. The copyright notices of the unaltered,
4270 original files must be preserved in all copies of source
4271 files.
4272
4273 o Redistribution in binary form must provide a disclaimer that
4274 states that the software is based in part of the work of the
4275 FreeType Team, in the distribution documentation. We also
4276 encourage you to put an URL to the FreeType web page in your
4277 documentation, though this isn't mandatory.
4278
4279 These conditions apply to any software derived from or based on
4280 the FreeType Project, not just the unmodified files. If you use
4281 our work, you must acknowledge us. However, no fee need be paid
4282 to us.
4283
42843. Advertising
4285--------------
4286
4287 Neither the FreeType authors and contributors nor you shall use
4288 the name of the other for commercial, advertising, or promotional
4289 purposes without specific prior written permission.
4290
4291 We suggest, but do not require, that you use one or more of the
4292 following phrases to refer to this software in your documentation
4293 or advertising materials: `FreeType Project', `FreeType Engine',
4294 `FreeType library', or `FreeType Distribution'.
4295
4296 As you have not signed this license, you are not required to
4297 accept it. However, as the FreeType Project is copyrighted
4298 material, only this license, or another one contracted with the
4299 authors, grants you the right to use, distribute, and modify it.
4300 Therefore, by using, distributing, or modifying the FreeType
4301 Project, you indicate that you understand and accept all the terms
4302 of this license.
4303
43044. Contacts
4305-----------
4306
4307 There are two mailing lists related to FreeType:
4308
4309 o freetype@nongnu.org
4310
4311 Discusses general use and applications of FreeType, as well as
4312 future and wanted additions to the library and distribution.
4313 If you are looking for support, start in this list if you
4314 haven't found anything to help you in the documentation.
4315
4316 o freetype-devel@nongnu.org
4317
4318 Discusses bugs, as well as engine internals, design issues,
4319 specific licenses, porting, etc.
4320
4321 Our home page can be found at
4322
4323 http://www.freetype.org
4324
4325
4326--- end of FTL.TXT ---
4327
4328</programlisting></para></section>
4329
4330<section id="lic_17">
4331<title>GPL-1.0</title>
4332<para><programlisting>
4333
4334GNU General Public License, version 1
4335
4336 GNU GENERAL PUBLIC LICENSE
4337 Version 1, February 1989
4338
4339 Copyright (C) 1989 Free Software Foundation, Inc.
4340 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
4341 Everyone is permitted to copy and distribute verbatim copies
4342 of this license document, but changing it is not allowed.
4343
4344 Preamble
4345
4346 The license agreements of most software companies try to keep users
4347at the mercy of those companies. By contrast, our General Public
4348License is intended to guarantee your freedom to share and change free
4349software--to make sure the software is free for all its users. The
4350General Public License applies to the Free Software Foundation`s
4351software and to any other program whose authors commit to using it.
4352You can use it for your programs, too.
4353
4354 When we speak of free software, we are referring to freedom, not
4355price. Specifically, the General Public License is designed to make
4356sure that you have the freedom to give away or sell copies of free
4357software, that you receive source code or can get it if you want it,
4358that you can change the software or use pieces of it in new free
4359programs; and that you know you can do these things.
4360
4361 To protect your rights, we need to make restrictions that forbid
4362anyone to deny you these rights or to ask you to surrender the rights.
4363These restrictions translate to certain responsibilities for you if you
4364distribute copies of the software, or if you modify it.
4365
4366 For example, if you distribute copies of a such a program, whether
4367gratis or for a fee, you must give the recipients all the rights that
4368you have. You must make sure that they, too, receive or can get the
4369source code. And you must tell them their rights.
4370
4371 We protect your rights with two steps: (1) copyright the software, and
4372(2) offer you this license which gives you legal permission to copy,
4373distribute and/or modify the software.
4374
4375 Also, for each author`s protection and ours, we want to make certain
4376that everyone understands that there is no warranty for this free
4377software. If the software is modified by someone else and passed on, we
4378want its recipients to know that what they have is not the original, so
4379that any problems introduced by others will not reflect on the original
4380authors` reputations.
4381
4382 The precise terms and conditions for copying, distribution and
4383modification follow.
4384
4385 GNU GENERAL PUBLIC LICENSE
4386 TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
4387
4388 0. This License Agreement applies to any program or other work which
4389contains a notice placed by the copyright holder saying it may be
4390distributed under the terms of this General Public License. The
4391"Program", below, refers to any such program or work, and a "work based
4392on the Program" means either the Program or any work containing the
4393Program or a portion of it, either verbatim or with modifications. Each
4394licensee is addressed as "you".
4395
4396 1. You may copy and distribute verbatim copies of the Program`s source
4397code as you receive it, in any medium, provided that you conspicuously and
4398appropriately publish on each copy an appropriate copyright notice and
4399disclaimer of warranty; keep intact all the notices that refer to this
4400General Public License and to the absence of any warranty; and give any
4401other recipients of the Program a copy of this General Public License
4402along with the Program. You may charge a fee for the physical act of
4403transferring a copy.
4404
4405 2. You may modify your copy or copies of the Program or any portion of
4406it, and copy and distribute such modifications under the terms of Paragraph
44071 above, provided that you also do the following:
4408
4409 a) cause the modified files to carry prominent notices stating that
4410 you changed the files and the date of any change; and
4411
4412 b) cause the whole of any work that you distribute or publish, that
4413 in whole or in part contains the Program or any part thereof, either
4414 with or without modifications, to be licensed at no charge to all
4415 third parties under the terms of this General Public License (except
4416 that you may choose to grant warranty protection to some or all
4417 third parties, at your option).
4418
4419 c) If the modified program normally reads commands interactively when
4420 run, you must cause it, when started running for such interactive use
4421 in the simplest and most usual way, to print or display an
4422 announcement including an appropriate copyright notice and a notice
4423 that there is no warranty (or else, saying that you provide a
4424 warranty) and that users may redistribute the program under these
4425 conditions, and telling the user how to view a copy of this General
4426 Public License.
4427
4428 d) You may charge a fee for the physical act of transferring a
4429 copy, and you may at your option offer warranty protection in
4430 exchange for a fee.
4431
4432Mere aggregation of another independent work with the Program (or its
4433derivative) on a volume of a storage or distribution medium does not bring
4434the other work under the scope of these terms.
4435
4436 3. You may copy and distribute the Program (or a portion or derivative of
4437it, under Paragraph 2) in object code or executable form under the terms of
4438Paragraphs 1 and 2 above provided that you also do one of the following:
4439
4440 a) accompany it with the complete corresponding machine-readable
4441 source code, which must be distributed under the terms of
4442 Paragraphs 1 and 2 above; or,
4443
4444 b) accompany it with a written offer, valid for at least three
4445 years, to give any third party free (except for a nominal charge
4446 for the cost of distribution) a complete machine-readable copy of the
4447 corresponding source code, to be distributed under the terms of
4448 Paragraphs 1 and 2 above; or,
4449
4450 c) accompany it with the information you received as to where the
4451 corresponding source code may be obtained. (This alternative is
4452 allowed only for noncommercial distribution and only if you
4453 received the program in object code or executable form alone.)
4454
4455Source code for a work means the preferred form of the work for making
4456modifications to it. For an executable file, complete source code means
4457all the source code for all modules it contains; but, as a special
4458exception, it need not include source code for modules which are standard
4459libraries that accompany the operating system on which the executable
4460file runs, or for standard header files or definitions files that
4461accompany that operating system.
4462
4463 4. You may not copy, modify, sublicense, distribute or transfer the
4464Program except as expressly provided under this General Public License.
4465Any attempt otherwise to copy, modify, sublicense, distribute or transfer
4466the Program is void, and will automatically terminate your rights to use
4467the Program under this License. However, parties who have received
4468copies, or rights to use copies, from you under this General Public
4469License will not have their licenses terminated so long as such parties
4470remain in full compliance.
4471
4472 5. By copying, distributing or modifying the Program (or any work based
4473on the Program) you indicate your acceptance of this license to do so,
4474and all its terms and conditions.
4475
4476 6. Each time you redistribute the Program (or any work based on the
4477Program), the recipient automatically receives a license from the original
4478licensor to copy, distribute or modify the Program subject to these
4479terms and conditions. You may not impose any further restrictions on the
4480recipients` exercise of the rights granted herein.
4481
4482 7. The Free Software Foundation may publish revised and/or new versions
4483of the General Public License from time to time. Such new versions will
4484be similar in spirit to the present version, but may differ in detail to
4485address new problems or concerns.
4486
4487Each version is given a distinguishing version number. If the Program
4488specifies a version number of the license which applies to it and "any
4489later version", you have the option of following the terms and conditions
4490either of that version or of any later version published by the Free
4491Software Foundation. If the Program does not specify a version number of
4492the license, you may choose any version ever published by the Free Software
4493Foundation.
4494
4495 8. If you wish to incorporate parts of the Program into other free
4496programs whose distribution conditions are different, write to the author
4497to ask for permission. For software which is copyrighted by the Free
4498Software Foundation, write to the Free Software Foundation; we sometimes
4499make exceptions for this. Our decision will be guided by the two goals
4500of preserving the free status of all derivatives of our free software and
4501of promoting the sharing and reuse of software generally.
4502
4503 NO WARRANTY
4504
4505 9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
4506FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
4507OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
4508PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
4509OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
4510MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
4511TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
4512PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
4513REPAIR OR CORRECTION.
4514
4515 10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
4516WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
4517REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
4518INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
4519OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
4520TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
4521YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
4522PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
4523POSSIBILITY OF SUCH DAMAGES.
4524
4525 END OF TERMS AND CONDITIONS
4526
4527 Appendix: How to Apply These Terms to Your New Programs
4528
4529 If you develop a new program, and you want it to be of the greatest
4530possible use to humanity, the best way to achieve this is to make it
4531free software which everyone can redistribute and change under these
4532terms.
4533
4534 To do so, attach the following notices to the program. It is safest to
4535attach them to the start of each source file to most effectively convey
4536the exclusion of warranty; and each file should have at least the
4537"copyright" line and a pointer to where the full notice is found.
4538
4539 &lt;one line to give the program`s name and a brief idea of what it does.&gt;
4540 Copyright (C) 19yy &lt;name of author&gt;
4541
4542 This program is free software; you can redistribute it and/or modify
4543 it under the terms of the GNU General Public License as published by
4544 the Free Software Foundation; either version 1, or (at your option)
4545 any later version.
4546
4547 This program is distributed in the hope that it will be useful,
4548 but WITHOUT ANY WARRANTY; without even the implied warranty of
4549 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4550 GNU General Public License for more details.
4551
4552 You should have received a copy of the GNU General Public License
4553 along with this program; if not, write to the Free Software
4554 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
4555
4556Also add information on how to contact you by electronic and paper mail.
4557
4558If the program is interactive, make it output a short notice like this
4559when it starts in an interactive mode:
4560
4561 Gnomovision version 69, Copyright (C) 19xx name of author
4562 Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w`.
4563 This is free software, and you are welcome to redistribute it
4564 under certain conditions; type `show c` for details.
4565
4566The hypothetical commands `show w` and `show c` should show the
4567appropriate parts of the General Public License. Of course, the
4568commands you use may be called something other than `show w` and `show
4569c`; they could even be mouse-clicks or menu items--whatever suits your
4570program.
4571
4572You should also get your employer (if you work as a programmer) or your
4573school, if any, to sign a "copyright disclaimer" for the program, if
4574necessary. Here a sample; alter the names:
4575
4576 Yoyodyne, Inc., hereby disclaims all copyright interest in the
4577 program `Gnomovision` (a program to direct compilers to make passes
4578 at assemblers) written by James Hacker.
4579
4580 &lt;signature of Ty Coon&gt;, 1 April 1989
4581 Ty Coon, President of Vice
4582
4583That`s all there is to it!
4584
4585</programlisting></para></section>
4586
4587<section id="lic_18">
4588<title>GPL-2.0</title>
4589<para><programlisting>
4590
4591GNU GENERAL PUBLIC LICENSE
4592
4593Version 2, June 1991
4594
4595Copyright (C) 1989, 1991 Free Software Foundation, Inc.
459651 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
4597
4598Everyone is permitted to copy and distribute verbatim copies
4599of this license document, but changing it is not allowed.
4600Preamble
4601
4602The licenses for most software are designed to take away your freedom to share and
4603change it. By contrast, the GNU General Public License is intended to guarantee your
4604freedom to share and change free software--to make sure the software is free for all
4605its users. This General Public License applies to most of the Free Software
4606Foundation`s software and to any other program whose authors commit to using it. (Some
4607other Free Software Foundation software is covered by the GNU Lesser General Public
4608License instead.) You can apply it to your programs, too.
4609
4610When we speak of free software, we are referring to freedom, not price. Our General
4611Public Licenses are designed to make sure that you have the freedom to distribute
4612copies of free software (and charge for this service if you wish), that you receive
4613source code or can get it if you want it, that you can change the software or use
4614pieces of it in new free programs; and that you know you can do these things.
4615
4616To protect your rights, we need to make restrictions that forbid anyone to deny you
4617these rights or to ask you to surrender the rights. These restrictions translate to
4618certain responsibilities for you if you distribute copies of the software, or if you
4619modify it.
4620
4621For example, if you distribute copies of such a program, whether gratis or for a fee,
4622you must give the recipients all the rights that you have. You must make sure that
4623they, too, receive or can get the source code. And you must show them these terms so
4624they know their rights.
4625
4626We protect your rights with two steps: (1) copyright the software, and (2) offer you
4627this license which gives you legal permission to copy, distribute and/or modify the
4628software.
4629
4630Also, for each author`s protection and ours, we want to make certain that everyone
4631understands that there is no warranty for this free software. If the software is
4632modified by someone else and passed on, we want its recipients to know that what they
4633have is not the original, so that any problems introduced by others will not reflect
4634on the original authors` reputations.
4635
4636Finally, any free program is threatened constantly by software patents. We wish to
4637avoid the danger that redistributors of a free program will individually obtain patent
4638licenses, in effect making the program proprietary. To prevent this, we have made it
4639clear that any patent must be licensed for everyone`s free use or not licensed at all.
4640
4641The precise terms and conditions for copying, distribution and modification follow.
4642
4643TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
4644
46450. This License applies to any program or other work which contains a notice placed by
4646the copyright holder saying it may be distributed under the terms of this General
4647Public License. The "Program", below, refers to any such program or work, and a "work
4648based on the Program" means either the Program or any derivative work under copyright
4649law: that is to say, a work containing the Program or a portion of it, either verbatim
4650or with modifications and/or translated into another language. (Hereinafter,
4651translation is included without limitation in the term "modification".) Each licensee
4652is addressed as "you".
4653
4654Activities other than copying, distribution and modification are not covered by this
4655License; they are outside its scope. The act of running the Program is not restricted,
4656and the output from the Program is covered only if its contents constitute a work
4657based on the Program (independent of having been made by running the Program). Whether
4658that is true depends on what the Program does.
4659
46601. You may copy and distribute verbatim copies of the Program`s source code as you
4661receive it, in any medium, provided that you conspicuously and appropriately publish
4662on each copy an appropriate copyright notice and disclaimer of warranty; keep intact
4663all the notices that refer to this License and to the absence of any warranty; and
4664give any other recipients of the Program a copy of this License along with the
4665Program.
4666
4667You may charge a fee for the physical act of transferring a copy, and you may at your
4668option offer warranty protection in exchange for a fee.
4669
46702. You may modify your copy or copies of the Program or any portion of it, thus
4671forming a work based on the Program, and copy and distribute such modifications or
4672work under the terms of Section 1 above, provided that you also meet all of these
4673conditions:
4674
4675a) You must cause the modified files to carry prominent notices stating that you
4676changed the files and the date of any change.
4677b) You must cause any work that you distribute or publish, that in whole or in part
4678contains or is derived from the Program or any part thereof, to be licensed as a whole
4679at no charge to all third parties under the terms of this License.
4680c) If the modified program normally reads commands interactively when run, you must
4681cause it, when started running for such interactive use in the most ordinary way, to
4682print or display an announcement including an appropriate copyright notice and a
4683notice that there is no warranty (or else, saying that you provide a warranty) and
4684that users may redistribute the program under these conditions, and telling the user
4685how to view a copy of this License. (Exception: if the Program itself is interactive
4686but does not normally print such an announcement, your work based on the Program is
4687not required to print an announcement.)
4688These requirements apply to the modified work as a whole. If identifiable sections of
4689that work are not derived from the Program, and can be reasonably considered
4690independent and separate works in themselves, then this License, and its terms, do not
4691apply to those sections when you distribute them as separate works. But when you
4692distribute the same sections as part of a whole which is a work based on the Program,
4693the distribution of the whole must be on the terms of this License, whose permissions
4694for other licensees extend to the entire whole, and thus to each and every part
4695regardless of who wrote it.
4696
4697Thus, it is not the intent of this section to claim rights or contest your rights to
4698work written entirely by you; rather, the intent is to exercise the right to control
4699the distribution of derivative or collective works based on the Program.
4700
4701In addition, mere aggregation of another work not based on the Program with the
4702Program (or with a work based on the Program) on a volume of a storage or distribution
4703medium does not bring the other work under the scope of this License.
4704
47053. You may copy and distribute the Program (or a work based on it, under Section 2) in
4706object code or executable form under the terms of Sections 1 and 2 above provided that
4707you also do one of the following:
4708
4709a) Accompany it with the complete corresponding machine-readable source code, which
4710must be distributed under the terms of Sections 1 and 2 above on a medium customarily
4711used for software interchange; or,
4712b) Accompany it with a written offer, valid for at least three years, to give any
4713third party, for a charge no more than your cost of physically performing source
4714distribution, a complete machine-readable copy of the corresponding source code, to be
4715distributed under the terms of Sections 1 and 2 above on a medium customarily used for
4716software interchange; or,
4717c) Accompany it with the information you received as to the offer to distribute
4718corresponding source code. (This alternative is allowed only for noncommercial
4719distribution and only if you received the program in object code or executable form
4720with such an offer, in accord with Subsection b above.)
4721The source code for a work means the preferred form of the work for making
4722modifications to it. For an executable work, complete source code means all the source
4723code for all modules it contains, plus any associated interface definition files, plus
4724the scripts used to control compilation and installation of the executable. However,
4725as a special exception, the source code distributed need not include anything that is
4726normally distributed (in either source or binary form) with the major components
4727(compiler, kernel, and so on) of the operating system on which the executable runs,
4728unless that component itself accompanies the executable.
4729
4730If distribution of executable or object code is made by offering access to copy from a
4731designated place, then offering equivalent access to copy the source code from the
4732same place counts as distribution of the source code, even though third parties are
4733not compelled to copy the source along with the object code.
4734
47354. You may not copy, modify, sublicense, or distribute the Program except as expressly
4736provided under this License. Any attempt otherwise to copy, modify, sublicense or
4737distribute the Program is void, and will automatically terminate your rights under
4738this License. However, parties who have received copies, or rights, from you under
4739this License will not have their licenses terminated so long as such parties remain in
4740full compliance.
4741
47425. You are not required to accept this License, since you have not signed it. However,
4743nothing else grants you permission to modify or distribute the Program or its
4744derivative works. These actions are prohibited by law if you do not accept this
4745License. Therefore, by modifying or distributing the Program (or any work based on the
4746Program), you indicate your acceptance of this License to do so, and all its terms and
4747conditions for copying, distributing or modifying the Program or works based on it.
4748
47496. Each time you redistribute the Program (or any work based on the Program), the
4750recipient automatically receives a license from the original licensor to copy,
4751distribute or modify the Program subject to these terms and conditions. You may not
4752impose any further restrictions on the recipients` exercise of the rights granted
4753herein. You are not responsible for enforcing compliance by third parties to this
4754License.
4755
47567. If, as a consequence of a court judgment or allegation of patent infringement or
4757for any other reason (not limited to patent issues), conditions are imposed on you
4758(whether by court order, agreement or otherwise) that contradict the conditions of
4759this License, they do not excuse you from the conditions of this License. If you
4760cannot distribute so as to satisfy simultaneously your obligations under this License
4761and any other pertinent obligations, then as a consequence you may not distribute the
4762Program at all. For example, if a patent license would not permit royalty-free
4763redistribution of the Program by all those who receive copies directly or indirectly
4764through you, then the only way you could satisfy both it and this License would be to
4765refrain entirely from distribution of the Program.
4766
4767If any portion of this section is held invalid or unenforceable under any particular
4768circumstance, the balance of the section is intended to apply and the section as a
4769whole is intended to apply in other circumstances.
4770
4771It is not the purpose of this section to induce you to infringe any patents or other
4772property right claims or to contest validity of any such claims; this section has the
4773sole purpose of protecting the integrity of the free software distribution system,
4774which is implemented by public license practices. Many people have made generous
4775contributions to the wide range of software distributed through that system in
4776reliance on consistent application of that system; it is up to the author/donor to
4777decide if he or she is willing to distribute software through any other system and a
4778licensee cannot impose that choice.
4779
4780This section is intended to make thoroughly clear what is believed to be a consequence
4781of the rest of this License.
4782
47838. If the distribution and/or use of the Program is restricted in certain countries
4784either by patents or by copyrighted interfaces, the original copyright holder who
4785places the Program under this License may add an explicit geographical distribution
4786limitation excluding those countries, so that distribution is permitted only in or
4787among countries not thus excluded. In such case, this License incorporates the
4788limitation as if written in the body of this License.
4789
47909. The Free Software Foundation may publish revised and/or new versions of the General
4791Public License from time to time. Such new versions will be similar in spirit to the
4792present version, but may differ in detail to address new problems or concerns.
4793
4794Each version is given a distinguishing version number. If the Program specifies a
4795version number of this License which applies to it and "any later version", you have
4796the option of following the terms and conditions either of that version or of any
4797later version published by the Free Software Foundation. If the Program does not
4798specify a version number of this License, you may choose any version ever published by
4799the Free Software Foundation.
4800
480110. If you wish to incorporate parts of the Program into other free programs whose
4802distribution conditions are different, write to the author to ask for permission. For
4803software which is copyrighted by the Free Software Foundation, write to the Free
4804Software Foundation; we sometimes make exceptions for this. Our decision will be
4805guided by the two goals of preserving the free status of all derivatives of our free
4806software and of promoting the sharing and reuse of software generally.
4807
4808NO WARRANTY
4809
481011. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
4811PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
4812WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
4813WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
4814IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
4815RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM
4816PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
4817
481812. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
4819COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS
4820PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
4821INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
4822PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
4823OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
4824WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
4825POSSIBILITY OF SUCH DAMAGES.
4826
4827END OF TERMS AND CONDITIONS
4828
4829How to Apply These Terms to Your New Programs
4830
4831If you develop a new program, and you want it to be of the greatest possible use to
4832the public, the best way to achieve this is to make it free software which everyone
4833can redistribute and change under these terms.
4834
4835To do so, attach the following notices to the program. It is safest to attach them to
4836the start of each source file to most effectively convey the exclusion of warranty;
4837and each file should have at least the "copyright" line and a pointer to where the
4838full notice is found.
4839
4840one line to give the program`s name and an idea of what it does.
4841Copyright (C) yyyy name of author
4842
4843This program is free software; you can redistribute it and/or
4844modify it under the terms of the GNU General Public License
4845as published by the Free Software Foundation; either version 2
4846of the License, or (at your option) any later version.
4847
4848This program is distributed in the hope that it will be useful,
4849but WITHOUT ANY WARRANTY; without even the implied warranty of
4850MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4851GNU General Public License for more details.
4852
4853You should have received a copy of the GNU General Public License
4854along with this program; if not, write to the Free Software
4855Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
4856Also add information on how to contact you by electronic and paper mail.
4857
4858If the program is interactive, make it output a short notice like this when it starts
4859in an interactive mode:
4860
4861Gnomovision version 69, Copyright (C) year name of author
4862Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
4863type `show w`. This is free software, and you are welcome
4864to redistribute it under certain conditions; type `show c`
4865for details.
4866The hypothetical commands `show w` and `show c` should show the appropriate parts of
4867the General Public License. Of course, the commands you use may be called something
4868other than `show w` and `show c`; they could even be mouse-clicks or menu
4869items--whatever suits your program.
4870
4871You should also get your employer (if you work as a programmer) or your school, if
4872any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample;
4873alter the names:
4874
4875Yoyodyne, Inc., hereby disclaims all copyright
4876interest in the program `Gnomovision`
4877(which makes passes at compilers) written
4878by James Hacker.
4879
4880signature of Ty Coon, 1 April 1989
4881Ty Coon, President of Vice
4882This General Public License does not permit incorporating your program into
4883proprietary programs. If your program is a subroutine library, you may consider it
4884more useful to permit linking proprietary applications with the library. If this is
4885what you want to do, use the GNU Lesser General Public License instead of this
4886License.
4887
4888</programlisting></para></section>
4889
4890<section id="lic_19">
4891<title>GPL-2.0-with-GCC-exception</title>
4892<para><programlisting>
4893
4894insert GPL v2 text here
4895
4896GCC Linking Exception
4897In addition to the permissions in the GNU General Public License, the Free
4898Software Foundation gives you unlimited permission to link the compiled version
4899of this file into combinations with other programs, and to distribute those
4900combinations without any restriction coming from the use of this file. (The
4901General Public License restrictions do apply in other respects; for example,
4902they cover modification of the file, and distribution when not linked into a
4903combine executable.)
4904
4905
4906
4907
4908
4909
4910</programlisting></para></section>
4911
4912<section id="lic_20">
4913<title>GPL-2.0-with-classpath-exception</title>
4914<para><programlisting>
4915
4916insert GPL v2 license text here
4917
4918Linking this library statically or dynamically with other modules is making a combined
4919work based on this library. Thus, the terms and conditions of the GNU General Public
4920License cover the whole combination.
4921
4922As a special exception, the copyright holders of this library give you permission to
4923link this library with independent modules to produce an executable, regardless of the
4924license terms of these independent modules, and to copy and distribute the resulting
4925executable under terms of your choice, provided that you also meet, for each linked
4926independent module, the terms and conditions of the license of that module. An
4927independent module is a module which is not derived from or based on this library. If
4928you modify this library, you may extend this exception to your version of the library,
4929but you are not obligated to do so. If you do not wish to do so, delete this exception
4930statement from your version.
4931
4932</programlisting></para></section>
4933
4934<section id="lic_21">
4935<title>GPL-3.0</title>
4936<para><programlisting>
4937GNU GENERAL PUBLIC LICENSE
4938
4939Version 3, 29 June 2007
4940
4941Copyright © 2007 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
4942
4943Everyone is permitted to copy and distribute verbatim copies of this license document,
4944but changing it is not allowed.
4945Preamble
4946
4947The GNU General Public License is a free, copyleft license for software and other
4948kinds of works.
4949
4950The licenses for most software and other practical works are designed to take away
4951your freedom to share and change the works. By contrast, the GNU General Public
4952License is intended to guarantee your freedom to share and change all versions of a
4953program--to make sure it remains free software for all its users. We, the Free
4954Software Foundation, use the GNU General Public License for most of our software; it
4955applies also to any other work released this way by its authors. You can apply it to
4956your programs, too.
4957
4958When we speak of free software, we are referring to freedom, not price. Our General
4959Public Licenses are designed to make sure that you have the freedom to distribute
4960copies of free software (and charge for them if you wish), that you receive source
4961code or can get it if you want it, that you can change the software or use pieces of
4962it in new free programs, and that you know you can do these things.
4963
4964To protect your rights, we need to prevent others from denying you these rights or
4965asking you to surrender the rights. Therefore, you have certain responsibilities if
4966you distribute copies of the software, or if you modify it: responsibilities to
4967respect the freedom of others.
4968
4969For example, if you distribute copies of such a program, whether gratis or for a fee,
4970you must pass on to the recipients the same freedoms that you received. You must make
4971sure that they, too, receive or can get the source code. And you must show them these
4972terms so they know their rights.
4973
4974Developers that use the GNU GPL protect your rights with two steps: (1) assert
4975copyright on the software, and (2) offer you this License giving you legal permission
4976to copy, distribute and/or modify it.
4977
4978For the developers' and authors' protection, the GPL clearly explains that there is no
4979warranty for this free software. For both users' and authors' sake, the GPL requires
4980that modified versions be marked as changed, so that their problems will not be
4981attributed erroneously to authors of previous versions.
4982
4983Some devices are designed to deny users access to install or run modified versions of
4984the software inside them, although the manufacturer can do so. This is fundamentally
4985incompatible with the aim of protecting users' freedom to change the software. The
4986systematic pattern of such abuse occurs in the area of products for individuals to
4987use, which is precisely where it is most unacceptable. Therefore, we have designed
4988this version of the GPL to prohibit the practice for those products. If such problems
4989arise substantially in other domains, we stand ready to extend this provision to those
4990domains in future versions of the GPL, as needed to protect the freedom of users.
4991
4992Finally, every program is threatened constantly by software patents. States should not
4993allow patents to restrict development and use of software on general-purpose
4994computers, but in those that do, we wish to avoid the special danger that patents
4995applied to a free program could make it effectively proprietary. To prevent this, the
4996GPL assures that patents cannot be used to render the program non-free.
4997
4998The precise terms and conditions for copying, distribution and modification follow.
4999TERMS AND CONDITIONS
50000. Definitions.
5001
5002&rdquor;This License&rdquo; refers to version 3 of the GNU General Public License.
5003
5004&rdquor;Copyright&rdquo; also means copyright-like laws that apply to other kinds of
5005works, such as semiconductor masks.
5006
5007&rdquor;The Program&rdquo; refers to any copyrightable work licensed under this
5008License. Each licensee is addressed as &rdquor;you&rdquo;. &rdquor;Licensees&rdquo;
5009and &rdquor;recipients&rdquo; may be individuals or organizations.
5010
5011To &rdquor;modify&rdquo; a work means to copy from or adapt all or part of the work in
5012a fashion requiring copyright permission, other than the making of an exact copy. The
5013resulting work is called a &rdquor;modified version&rdquo; of the earlier work or a
5014work &rdquor;based on&rdquo; the earlier work.
5015
5016A &rdquor;covered work&rdquo; means either the unmodified Program or a work based on
5017the Program.
5018
5019To &rdquor;propagate&rdquo; a work means to do anything with it that, without
5020permission, would make you directly or secondarily liable for infringement under
5021applicable copyright law, except executing it on a computer or modifying a private
5022copy. Propagation includes copying, distribution (with or without modification),
5023making available to the public, and in some countries other activities as well.
5024
5025To &rdquor;convey&rdquo; a work means any kind of propagation that enables other
5026parties to make or receive copies. Mere interaction with a user through a computer
5027network, with no transfer of a copy, is not conveying.
5028
5029An interactive user interface displays &rdquor;Appropriate Legal Notices&rdquo; to the
5030extent that it includes a convenient and prominently visible feature that (1) displays
5031an appropriate copyright notice, and (2) tells the user that there is no warranty for
5032the work (except to the extent that warranties are provided), that licensees may
5033convey the work under this License, and how to view a copy of this License. If the
5034interface presents a list of user commands or options, such as a menu, a prominent
5035item in the list meets this criterion.
50361. Source Code.
5037
5038The &rdquor;source code&rdquo; for a work means the preferred form of the work for
5039making modifications to it. &rdquor;Object code&rdquo; means any non-source form of a
5040work.
5041
5042A &rdquor;Standard Interface&rdquo; means an interface that either is an official
5043standard defined by a recognized standards body, or, in the case of interfaces
5044specified for a particular programming language, one that is widely used among
5045developers working in that language.
5046
5047The &rdquor;System Libraries&rdquo; of an executable work include anything, other than
5048the work as a whole, that (a) is included in the normal form of packaging a Major
5049Component, but which is not part of that Major Component, and (b) serves only to
5050enable use of the work with that Major Component, or to implement a Standard Interface
5051for which an implementation is available to the public in source code form. A
5052&rdquor;Major Component&rdquo;, in this context, means a major essential component
5053(kernel, window system, and so on) of the specific operating system (if any) on which
5054the executable work runs, or a compiler used to produce the work, or an object code
5055interpreter used to run it.
5056
5057The &rdquor;Corresponding Source&rdquo; for a work in object code form means all the
5058source code needed to generate, install, and (for an executable work) run the object
5059code and to modify the work, including scripts to control those activities. However,
5060it does not include the work's System Libraries, or general-purpose tools or generally
5061available free programs which are used unmodified in performing those activities but
5062which are not part of the work. For example, Corresponding Source includes interface
5063definition files associated with source files for the work, and the source code for
5064shared libraries and dynamically linked subprograms that the work is specifically
5065designed to require, such as by intimate data communication or control flow between
5066those subprograms and other parts of the work.
5067
5068The Corresponding Source need not include anything that users can regenerate
5069automatically from other parts of the Corresponding Source.
5070
5071The Corresponding Source for a work in source code form is that same work.
50722. Basic Permissions.
5073
5074All rights granted under this License are granted for the term of copyright on the
5075Program, and are irrevocable provided the stated conditions are met. This License
5076explicitly affirms your unlimited permission to run the unmodified Program. The output
5077from running a covered work is covered by this License only if the output, given its
5078content, constitutes a covered work. This License acknowledges your rights of fair use
5079or other equivalent, as provided by copyright law.
5080
5081You may make, run and propagate covered works that you do not convey, without
5082conditions so long as your license otherwise remains in force. You may convey covered
5083works to others for the sole purpose of having them make modifications exclusively for
5084you, or provide you with facilities for running those works, provided that you comply
5085with the terms of this License in conveying all material for which you do not control
5086copyright. Those thus making or running the covered works for you must do so
5087exclusively on your behalf, under your direction and control, on terms that prohibit
5088them from making any copies of your copyrighted material outside their relationship
5089with you.
5090
5091Conveying under any other circumstances is permitted solely under the conditions
5092stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
50933. Protecting Users' Legal Rights From Anti-Circumvention Law.
5094
5095No covered work shall be deemed part of an effective technological measure under any
5096applicable law fulfilling obligations under article 11 of the WIPO copyright treaty
5097adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention
5098of such measures.
5099
5100When you convey a covered work, you waive any legal power to forbid circumvention of
5101technological measures to the extent such circumvention is effected by exercising
5102rights under this License with respect to the covered work, and you disclaim any
5103intention to limit operation or modification of the work as a means of enforcing,
5104against the work's users, your or third parties' legal rights to forbid circumvention
5105of technological measures.
51064. Conveying Verbatim Copies.
5107
5108You may convey verbatim copies of the Program's source code as you receive it, in any
5109medium, provided that you conspicuously and appropriately publish on each copy an
5110appropriate copyright notice; keep intact all notices stating that this License and
5111any non-permissive terms added in accord with section 7 apply to the code; keep intact
5112all notices of the absence of any warranty; and give all recipients a copy of this
5113License along with the Program.
5114
5115You may charge any price or no price for each copy that you convey, and you may offer
5116support or warranty protection for a fee.
51175. Conveying Modified Source Versions.
5118
5119You may convey a work based on the Program, or the modifications to produce it from
5120the Program, in the form of source code under the terms of section 4, provided that
5121you also meet all of these conditions:
5122
5123 * a) The work must carry prominent notices stating that you modified it, and
5124giving a relevant date.
5125 * b) The work must carry prominent notices stating that it is released under this
5126License and any conditions added under section 7. This requirement modifies the
5127requirement in section 4 to &rdquor;keep intact all notices&rdquo;.
5128 * c) You must license the entire work, as a whole, under this License to anyone
5129who comes into possession of a copy. This License will therefore apply, along with any
5130applicable section 7 additional terms, to the whole of the work, and all its parts,
5131regardless of how they are packaged. This License gives no permission to license the
5132work in any other way, but it does not invalidate such permission if you have
5133separately received it.
5134 * d) If the work has interactive user interfaces, each must display Appropriate
5135Legal Notices; however, if the Program has interactive interfaces that do not display
5136Appropriate Legal Notices, your work need not make them do so.
5137
5138A compilation of a covered work with other separate and independent works, which are
5139not by their nature extensions of the covered work, and which are not combined with it
5140such as to form a larger program, in or on a volume of a storage or distribution
5141medium, is called an &rdquor;aggregate&rdquo; if the compilation and its resulting
5142copyright are not used to limit the access or legal rights of the compilation's users
5143beyond what the individual works permit. Inclusion of a covered work in an aggregate
5144does not cause this License to apply to the other parts of the aggregate.
51456. Conveying Non-Source Forms.
5146
5147You may convey a covered work in object code form under the terms of sections 4 and 5,
5148provided that you also convey the machine-readable Corresponding Source under the
5149terms of this License, in one of these ways:
5150
5151 * a) Convey the object code in, or embodied in, a physical product (including a
5152physical distribution medium), accompanied by the Corresponding Source fixed on a
5153durable physical medium customarily used for software interchange.
5154 * b) Convey the object code in, or embodied in, a physical product (including a
5155physical distribution medium), accompanied by a written offer, valid for at least
5156three years and valid for as long as you offer spare parts or customer support for
5157that product model, to give anyone who possesses the object code either (1) a copy of
5158the Corresponding Source for all the software in the product that is covered by this
5159License, on a durable physical medium customarily used for software interchange, for a
5160price no more than your reasonable cost of physically performing this conveying of
5161source, or (2) access to copy the Corresponding Source from a network server at no
5162charge.
5163 * c) Convey individual copies of the object code with a copy of the written offer
5164to provide the Corresponding Source. This alternative is allowed only occasionally and
5165noncommercially, and only if you received the object code with such an offer, in
5166accord with subsection 6b.
5167 * d) Convey the object code by offering access from a designated place (gratis or
5168for a charge), and offer equivalent access to the Corresponding Source in the same way
5169through the same place at no further charge. You need not require recipients to copy
5170the Corresponding Source along with the object code. If the place to copy the object
5171code is a network server, the Corresponding Source may be on a different server
5172(operated by you or a third party) that supports equivalent copying facilities,
5173provided you maintain clear directions next to the object code saying where to find
5174the Corresponding Source. Regardless of what server hosts the Corresponding Source,
5175you remain obligated to ensure that it is available for as long as needed to satisfy
5176these requirements.
5177 * e) Convey the object code using peer-to-peer transmission, provided you inform
5178other peers where the object code and Corresponding Source of the work are being
5179offered to the general public at no charge under subsection 6d.
5180
5181A separable portion of the object code, whose source code is excluded from the
5182Corresponding Source as a System Library, need not be included in conveying the object
5183code work.
5184
5185A &rdquor;User Product&rdquo; is either (1) a &rdquor;consumer product&rdquo;, which
5186means any tangible personal property which is normally used for personal, family, or
5187household purposes, or (2) anything designed or sold for incorporation into a
5188dwelling. In determining whether a product is a consumer product, doubtful cases shall
5189be resolved in favor of coverage. For a particular product received by a particular
5190user, &rdquor;normally used&rdquo; refers to a typical or common use of that class of
5191product, regardless of the status of the particular user or of the way in which the
5192particular user actually uses, or expects or is expected to use, the product. A
5193product is a consumer product regardless of whether the product has substantial
5194commercial, industrial or non-consumer uses, unless such uses represent the only
5195significant mode of use of the product.
5196
5197&rdquor;Installation Information&rdquo; for a User Product means any methods,
5198procedures, authorization keys, or other information required to install and execute
5199modified versions of a covered work in that User Product from a modified version of
5200its Corresponding Source. The information must suffice to ensure that the continued
5201functioning of the modified object code is in no case prevented or interfered with
5202solely because modification has been made.
5203
5204If you convey an object code work under this section in, or with, or specifically for
5205use in, a User Product, and the conveying occurs as part of a transaction in which the
5206right of possession and use of the User Product is transferred to the recipient in
5207perpetuity or for a fixed term (regardless of how the transaction is characterized),
5208the Corresponding Source conveyed under this section must be accompanied by the
5209Installation Information. But this requirement does not apply if neither you nor any
5210third party retains the ability to install modified object code on the User Product
5211(for example, the work has been installed in ROM).
5212
5213The requirement to provide Installation Information does not include a requirement to
5214continue to provide support service, warranty, or updates for a work that has been
5215modified or installed by the recipient, or for the User Product in which it has been
5216modified or installed. Access to a network may be denied when the modification itself
5217materially and adversely affects the operation of the network or violates the rules
5218and protocols for communication across the network.
5219
5220Corresponding Source conveyed, and Installation Information provided, in accord with
5221this section must be in a format that is publicly documented (and with an
5222implementation available to the public in source code form), and must require no
5223special password or key for unpacking, reading or copying.
52247. Additional Terms.
5225
5226&rdquor;Additional permissions&rdquo; are terms that supplement the terms of this
5227License by making exceptions from one or more of its conditions. Additional
5228permissions that are applicable to the entire Program shall be treated as though they
5229were included in this License, to the extent that they are valid under applicable law.
5230If additional permissions apply only to part of the Program, that part may be used
5231separately under those permissions, but the entire Program remains governed by this
5232License without regard to the additional permissions.
5233
5234When you convey a copy of a covered work, you may at your option remove any additional
5235permissions from that copy, or from any part of it. (Additional permissions may be
5236written to require their own removal in certain cases when you modify the work.) You
5237may place additional permissions on material, added by you to a covered work, for
5238which you have or can give appropriate copyright permission.
5239
5240Notwithstanding any other provision of this License, for material you add to a covered
5241work, you may (if authorized by the copyright holders of that material) supplement the
5242terms of this License with terms:
5243
5244 * a) Disclaiming warranty or limiting liability differently from the terms of
5245sections 15 and 16 of this License; or
5246 * b) Requiring preservation of specified reasonable legal notices or author
5247attributions in that material or in the Appropriate Legal Notices displayed by works
5248containing it; or
5249 * c) Prohibiting misrepresentation of the origin of that material, or requiring
5250that modified versions of such material be marked in reasonable ways as different from
5251the original version; or
5252 * d) Limiting the use for publicity purposes of names of licensors or authors of
5253the material; or
5254 * e) Declining to grant rights under trademark law for use of some trade names,
5255trademarks, or service marks; or
5256 * f) Requiring indemnification of licensors and authors of that material by anyone
5257who conveys the material (or modified versions of it) with contractual assumptions of
5258liability to the recipient, for any liability that these contractual assumptions
5259directly impose on those licensors and authors.
5260
5261All other non-permissive additional terms are considered &rdquor;further
5262restrictions&rdquo; within the meaning of section 10. If the Program as you received
5263it, or any part of it, contains a notice stating that it is governed by this License
5264along with a term that is a further restriction, you may remove that term. If a
5265license document contains a further restriction but permits relicensing or conveying
5266under this License, you may add to a covered work material governed by the terms of
5267that license document, provided that the further restriction does not survive such
5268relicensing or conveying.
5269
5270If you add terms to a covered work in accord with this section, you must place, in the
5271relevant source files, a statement of the additional terms that apply to those files,
5272or a notice indicating where to find the applicable terms.
5273
5274Additional terms, permissive or non-permissive, may be stated in the form of a
5275separately written license, or stated as exceptions; the above requirements apply
5276either way.
52778. Termination.
5278
5279You may not propagate or modify a covered work except as expressly provided under this
5280License. Any attempt otherwise to propagate or modify it is void, and will
5281automatically terminate your rights under this License (including any patent licenses
5282granted under the third paragraph of section 11).
5283
5284However, if you cease all violation of this License, then your license from a
5285particular copyright holder is reinstated (a) provisionally, unless and until the
5286copyright holder explicitly and finally terminates your license, and (b) permanently,
5287if the copyright holder fails to notify you of the violation by some reasonable means
5288prior to 60 days after the cessation.
5289
5290Moreover, your license from a particular copyright holder is reinstated permanently if
5291the copyright holder notifies you of the violation by some reasonable means, this is
5292the first time you have received notice of violation of this License (for any work)
5293from that copyright holder, and you cure the violation prior to 30 days after your
5294receipt of the notice.
5295
5296Termination of your rights under this section does not terminate the licenses of
5297parties who have received copies or rights from you under this License. If your rights
5298have been terminated and not permanently reinstated, you do not qualify to receive new
5299licenses for the same material under section 10.
53009. Acceptance Not Required for Having Copies.
5301
5302You are not required to accept this License in order to receive or run a copy of the
5303Program. Ancillary propagation of a covered work occurring solely as a consequence of
5304using peer-to-peer transmission to receive a copy likewise does not require
5305acceptance. However, nothing other than this License grants you permission to
5306propagate or modify any covered work. These actions infringe copyright if you do not
5307accept this License. Therefore, by modifying or propagating a covered work, you
5308indicate your acceptance of this License to do so.
530910. Automatic Licensing of Downstream Recipients.
5310
5311Each time you convey a covered work, the recipient automatically receives a license
5312from the original licensors, to run, modify and propagate that work, subject to this
5313License. You are not responsible for enforcing compliance by third parties with this
5314License.
5315
5316An &rdquor;entity transaction&rdquo; is a transaction transferring control of an
5317organization, or substantially all assets of one, or subdividing an organization, or
5318merging organizations. If propagation of a covered work results from an entity
5319transaction, each party to that transaction who receives a copy of the work also
5320receives whatever licenses to the work the party's predecessor in interest had or
5321could give under the previous paragraph, plus a right to possession of the
5322Corresponding Source of the work from the predecessor in interest, if the predecessor
5323has it or can get it with reasonable efforts.
5324
5325You may not impose any further restrictions on the exercise of the rights granted or
5326affirmed under this License. For example, you may not impose a license fee, royalty,
5327or other charge for exercise of rights granted under this License, and you may not
5328initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging
5329that any patent claim is infringed by making, using, selling, offering for sale, or
5330importing the Program or any portion of it.
533111. Patents.
5332
5333A &rdquor;contributor&rdquo; is a copyright holder who authorizes use under this
5334License of the Program or a work on which the Program is based. The work thus licensed
5335is called the contributor's &rdquor;contributor version&rdquo;.
5336
5337A contributor's &rdquor;essential patent claims&rdquo; are all patent claims owned or
5338controlled by the contributor, whether already acquired or hereafter acquired, that
5339would be infringed by some manner, permitted by this License, of making, using, or
5340selling its contributor version, but do not include claims that would be infringed
5341only as a consequence of further modification of the contributor version. For purposes
5342of this definition, &rdquor;control&rdquo; includes the right to grant patent
5343sublicenses in a manner consistent with the requirements of this License.
5344
5345Each contributor grants you a non-exclusive, worldwide, royalty-free patent license
5346under the contributor's essential patent claims, to make, use, sell, offer for sale,
5347import and otherwise run, modify and propagate the contents of its contributor
5348version.
5349
5350In the following three paragraphs, a &rdquor;patent license&rdquo; is any express
5351agreement or commitment, however denominated, not to enforce a patent (such as an
5352express permission to practice a patent or covenant not to sue for patent
5353infringement). To &rdquor;grant&rdquo; such a patent license to a party means to make
5354such an agreement or commitment not to enforce a patent against the party.
5355
5356If you convey a covered work, knowingly relying on a patent license, and the
5357Corresponding Source of the work is not available for anyone to copy, free of charge
5358and under the terms of this License, through a publicly available network server or
5359other readily accessible means, then you must either (1) cause the Corresponding
5360Source to be so available, or (2) arrange to deprive yourself of the benefit of the
5361patent license for this particular work, or (3) arrange, in a manner consistent with
5362the requirements of this License, to extend the patent license to downstream
5363recipients. &rdquor;Knowingly relying&rdquo; means you have actual knowledge that, but
5364for the patent license, your conveying the covered work in a country, or your
5365recipient's use of the covered work in a country, would infringe one or more
5366identifiable patents in that country that you have reason to believe are valid.
5367
5368If, pursuant to or in connection with a single transaction or arrangement, you convey,
5369or propagate by procuring conveyance of, a covered work, and grant a patent license to
5370some of the parties receiving the covered work authorizing them to use, propagate,
5371modify or convey a specific copy of the covered work, then the patent license you
5372grant is automatically extended to all recipients of the covered work and works based
5373on it.
5374
5375A patent license is &rdquor;discriminatory&rdquo; if it does not include within the
5376scope of its coverage, prohibits the exercise of, or is conditioned on the
5377non-exercise of one or more of the rights that are specifically granted under this
5378License. You may not convey a covered work if you are a party to an arrangement with a
5379third party that is in the business of distributing software, under which you make
5380payment to the third party based on the extent of your activity of conveying the work,
5381and under which the third party grants, to any of the parties who would receive the
5382covered work from you, a discriminatory patent license (a) in connection with copies
5383of the covered work conveyed by you (or copies made from those copies), or (b)
5384primarily for and in connection with specific products or compilations that contain
5385the covered work, unless you entered into that arrangement, or that patent license was
5386granted, prior to 28 March 2007.
5387
5388Nothing in this License shall be construed as excluding or limiting any implied
5389license or other defenses to infringement that may otherwise be available to you under
5390applicable patent law.
539112. No Surrender of Others' Freedom.
5392
5393If conditions are imposed on you (whether by court order, agreement or otherwise) that
5394contradict the conditions of this License, they do not excuse you from the conditions
5395of this License. If you cannot convey a covered work so as to satisfy simultaneously
5396your obligations under this License and any other pertinent obligations, then as a
5397consequence you may not convey it at all. For example, if you agree to terms that
5398obligate you to collect a royalty for further conveying from those to whom you convey
5399the Program, the only way you could satisfy both those terms and this License would be
5400to refrain entirely from conveying the Program.
540113. Use with the GNU Affero General Public License.
5402
5403Notwithstanding any other provision of this License, you have permission to link or
5404combine any covered work with a work licensed under version 3 of the GNU Affero
5405General Public License into a single combined work, and to convey the resulting work.
5406The terms of this License will continue to apply to the part which is the covered
5407work, but the special requirements of the GNU Affero General Public License, section
540813, concerning interaction through a network will apply to the combination as such.
540914. Revised Versions of this License.
5410
5411The Free Software Foundation may publish revised and/or new versions of the GNU
5412General Public License from time to time. Such new versions will be similar in spirit
5413to the present version, but may differ in detail to address new problems or concerns.
5414
5415Each version is given a distinguishing version number. If the Program specifies that a
5416certain numbered version of the GNU General Public License &rdquor;or any later
5417version&rdquo; applies to it, you have the option of following the terms and
5418conditions either of that numbered version or of any later version published by the
5419Free Software Foundation. If the Program does not specify a version number of the GNU
5420General Public License, you may choose any version ever published by the Free Software
5421Foundation.
5422
5423If the Program specifies that a proxy can decide which future versions of the GNU
5424General Public License can be used, that proxy's public statement of acceptance of a
5425version permanently authorizes you to choose that version for the Program.
5426
5427Later license versions may give you additional or different permissions. However, no
5428additional obligations are imposed on any author or copyright holder as a result of
5429your choosing to follow a later version.
543015. Disclaimer of Warranty.
5431
5432THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
5433EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
5434PROVIDE THE PROGRAM &rdquor;AS IS&rdquo; WITHOUT WARRANTY OF ANY KIND, EITHER
5435EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
5436MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
5437QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
5438DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
543916. Limitation of Liability.
5440
5441IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
5442COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS
5443PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
5444INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
5445PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
5446OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
5447WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
5448POSSIBILITY OF SUCH DAMAGES.
544917. Interpretation of Sections 15 and 16.
5450
5451If the disclaimer of warranty and limitation of liability provided above cannot be
5452given local legal effect according to their terms, reviewing courts shall apply local
5453law that most closely approximates an absolute waiver of all civil liability in
5454connection with the Program, unless a warranty or assumption of liability accompanies
5455a copy of the Program in return for a fee.
5456
5457END OF TERMS AND CONDITIONS
5458How to Apply These Terms to Your New Programs
5459
5460If you develop a new program, and you want it to be of the greatest possible use to
5461the public, the best way to achieve this is to make it free software which everyone
5462can redistribute and change under these terms.
5463
5464To do so, attach the following notices to the program. It is safest to attach them to
5465the start of each source file to most effectively state the exclusion of warranty; and
5466each file should have at least the &rdquor;copyright&rdquo; line and a pointer to
5467where the full notice is found.
5468
5469 &lt;one line to give the program's name and a brief idea of what it does.&gt;
5470 Copyright (C) &lt;year&gt; &lt;name of author&gt;
5471
5472 This program is free software: you can redistribute it and/or modify
5473 it under the terms of the GNU General Public License as published by
5474 the Free Software Foundation, either version 3 of the License, or
5475 (at your option) any later version.
5476
5477 This program is distributed in the hope that it will be useful,
5478 but WITHOUT ANY WARRANTY; without even the implied warranty of
5479 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
5480 GNU General Public License for more details.
5481
5482 You should have received a copy of the GNU General Public License
5483 along with this program. If not, see &lt;http://www.gnu.org/licenses/&gt;.
5484
5485Also add information on how to contact you by electronic and paper mail.
5486
5487If the program does terminal interaction, make it output a short notice like this when
5488it starts in an interactive mode:
5489
5490 &lt;program&gt; Copyright (C) &lt;year&gt; &lt;name of author&gt;
5491 This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
5492 This is free software, and you are welcome to redistribute it
5493 under certain conditions; type `show c' for details.
5494
5495The hypothetical commands `show w' and `show c' should show the appropriate parts of
5496the General Public License. Of course, your program's commands might be different; for
5497a GUI interface, you would use an &rdquor;about box&rdquo;.
5498
5499You should also get your employer (if you work as a programmer) or school, if any, to
5500sign a &rdquor;copyright disclaimer&rdquo; for the program, if necessary. For more
5501information on this, and how to apply and follow the GNU GPL, see
5502&lt;http://www.gnu.org/licenses/&gt;.
5503
5504The GNU General Public License does not permit incorporating your program into
5505proprietary programs. If your program is a subroutine library, you may consider it
5506more useful to permit linking proprietary applications with the library. If this is
5507what you want to do, use the GNU Lesser General Public License instead of this
5508License. But first, please read
5509&lt;http://www.gnu.org/philosophy/why-not-lgpl.html&gt;.
5510</programlisting></para></section>
5511
5512<section id="lic_22">
5513<title>GPL-3.0-with-GCC-exception</title>
5514<para><programlisting>
5515
5516insert GPL v3 text here
5517
5518GCC RUNTIME LIBRARY EXCEPTION
5519Version 3.1, 31 March 2009
5520
5521General information:
5522http://www.gnu.org/licenses/gcc-exception.html
5523Copyright (C) 2009 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
5524Everyone is permitted to copy and distribute verbatim copies of this license document,
5525but changing it is not allowed.
5526This GCC Runtime Library Exception ("Exception") is an additional permission under
5527section 7 of the GNU General Public License, version 3 ("GPLv3"). It applies to a
5528given file (the "Runtime Library") that bears a notice placed by the copyright holder
5529of the file stating that the file is governed by GPLv3 along with this Exception.
5530When you use GCC to compile a program, GCC may combine portions of certain GCC header
5531files and runtime libraries with the compiled program. The purpose of this Exception
5532is to allow compilation of non-GPL (including proprietary) programs to use, in this
5533way, the header files and runtime libraries covered by this Exception.
5534
55350. Definitions.
5536A file is an "Independent Module" if it either requires the Runtime Library for
5537execution after a Compilation Process, or makes use of an interface provided by the
5538Runtime Library, but is not otherwise based on the Runtime Library.
5539"GCC" means a version of the GNU Compiler Collection, with or without modifications,
5540governed by version 3 (or a specified later version) of the GNU General Public License
5541(GPL) with the option of using any subsequent versions published by the FSF.
5542"GPL-compatible Software" is software whose conditions of propagation, modification
5543and use would permit combination with GCC in accord with the license of GCC.
5544"Target Code" refers to output from any compiler for a real or virtual target
5545processor architecture, in executable form or suitable for input to an assembler,
5546loader, linker and/or execution phase. Notwithstanding that, Target Code does not
5547include data in any format that is used as a compiler intermediate representation, or
5548used for producing a compiler intermediate representation.
5549The "Compilation Process" transforms code entirely represented in non-intermediate
5550languages designed for human-written code, and/or in Java Virtual Machine byte code,
5551into Target Code. Thus, for example, use of source code generators and preprocessors
5552need not be considered part of the Compilation Process, since the Compilation Process
5553can be understood as starting with the output of the generators or preprocessors.
5554A Compilation Process is "Eligible" if it is done using GCC, alone or with other
5555GPL-compatible software, or if it is done without using any work based on GCC. For
5556example, using non-GPL-compatible Software to optimize any GCC intermediate
5557representations would not qualify as an Eligible Compilation Process.
5558
55591. Grant of Additional Permission.
5560You have permission to propagate a work of Target Code formed by combining the Runtime
5561Library with Independent Modules, even if such propagation would otherwise violate the
5562terms of GPLv3, provided that all Target Code was generated by Eligible Compilation
5563Processes. You may then convey such a combination under terms of your choice,
5564consistent with the licensing of the Independent Modules.
5565
55662. No Weakening of GCC Copyleft.
5567The availability of this Exception does not imply any general presumption that
5568third-party software is unaffected by the copyleft requirements of the license of GCC.
5569
5570</programlisting></para></section>
5571
5572<section id="lic_23">
5573<title>GPL-3.0-with-autoconf-exception</title>
5574<para><programlisting>
5575
5576insert GPL v3 text here
5577
5578AUTOCONF CONFIGURE SCRIPT EXCEPTION
5579
5580Version 3.0, 18 August 2009
5581
5582Copyright &amp;#169; 2009 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
5583
5584Everyone is permitted to copy and distribute verbatim copies of this license document,
5585but changing it is not allowed.
5586
5587This Exception is an additional permission under section 7 of the GNU General Public
5588License, version 3 ("GPLv3"). It applies to a given file that bears a notice placed by
5589the copyright holder of the file stating that the file is governed by GPLv3 along with
5590this Exception.
5591
5592The purpose of this Exception is to allow distribution of Autoconf`s typical output
5593under terms of the recipient`s choice (including proprietary).
5594
55950. Definitions.
5596"Covered Code" is the source or object code of a version of Autoconf that is a covered
5597work under this License.
5598
5599"Normally Copied Code" for a version of Autoconf means all parts of its Covered Code
5600which that version can copy from its code (i.e., not from its input file) into its
5601minimally verbose, non-debugging and non-tracing output.
5602
5603"Ineligible Code" is Covered Code that is not Normally Copied Code.
5604
56051. Grant of Additional Permission.
5606You have permission to propagate output of Autoconf, even if such propagation would
5607otherwise violate the terms of GPLv3. However, if by modifying Autoconf you cause any
5608Ineligible Code of the version you received to become Normally Copied Code of your
5609modified version, then you void this Exception for the resulting covered work. If you
5610convey that resulting covered work, you must remove this Exception in accordance with
5611the second paragraph of Section 7 of GPLv3.
5612
56132. No Weakening of Autoconf Copyleft.
5614The availability of this Exception does not imply any general presumption that
5615third-party software is unaffected by the copyleft requirements of the license of
5616Autoconf.
5617
5618</programlisting></para></section>
5619
5620<section id="lic_24">
5621<title>ICU</title>
5622<para><programlisting>
5623COPYRIGHT AND PERMISSION NOTICE
5624
5625Copyright (c) 1995-2012 International Business Machines Corporation and others
5626
5627All rights reserved.
5628
5629Permission is hereby granted, free of charge, to any person obtaining a copy of this
5630software and associated documentation files (the "Software"), to deal in the Software
5631without restriction, including without limitation the rights to use, copy, modify,
5632merge, publish, distribute, and/or sell copies of the Software, and to permit persons
5633to whom the Software is furnished to do so, provided that the above copyright
5634notice(s) and this permission notice appear in all copies of the Software and that
5635both the above copyright notice(s) and this permission notice appear in supporting
5636documentation.
5637
5638THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
5639INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
5640PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE
5641COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY
5642SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM
5643LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
5644TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
5645SOFTWARE.
5646
5647Except as contained in this notice, the name of a copyright holder shall not be used
5648in advertising or otherwise to promote the sale, use or other dealings in this
5649Software without prior written authorization of the copyright holder.
5650
5651All trademarks and registered trademarks mentioned herein are the property of their
5652respective owners.
5653</programlisting></para></section>
5654
5655<section id="lic_25">
5656<title>IPL-1.0</title>
5657<para><programlisting>
5658
5659IBM Public License Version 1.0
5660
5661THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS IBM
5662PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION
5663OF THE PROGRAM CONSTITUTES RECIPIENT`S ACCEPTANCE OF THIS AGREEMENT.
5664
56651. DEFINITIONS
5666"Contribution" means:
5667
5668in the case of International Business Machines Corporation ("IBM"), the Original
5669Program, and
5670in the case of each Contributor,
5671changes to the Program, and
5672additions to the Program;
5673where such changes and/or additions to the Program originate from and
5674are distributed by that particular Contributor. A Contribution
5675`originates` from a Contributor if it was added to the Program by
5676such Contributor itself or anyone acting on such Contributor`s
5677behalf. Contributions do not include additions to the Program which:
5678(i) are separate modules of software distributed in conjunction with
5679the Program under their own license agreement, and (ii) are not
5680derivative works of the Program.
5681
5682"Contributor" means IBM and any other entity that distributes the Program.
5683
5684"Licensed Patents " mean patent claims licensable by a
5685Contributor which are necessarily infringed by the use or sale of its
5686Contribution alone or when combined with the Program.
5687
5688"Original Program" means the original version of the software
5689accompanying this Agreement as released by IBM, including source
5690code, object code and documentation, if any.
5691
5692"Program" means the Original Program and Contributions.
5693
5694"Recipient" means anyone who receives the Program under this
5695Agreement, including all Contributors.
5696
56972. GRANT OF RIGHTS
5698Subject to the terms of this Agreement, each Contributor hereby
5699grants Recipient a non-exclusive, worldwide, royalty-free copyright
5700license to reproduce, prepare derivative works of, publicly display,
5701publicly perform, distribute and sublicense the Contribution of such
5702Contributor, if any, and such derivative works, in source code and
5703object code form.
5704Subject to the terms of this Agreement, each Contributor hereby
5705grants Recipient a non-exclusive, worldwide, royalty-free patent
5706license under Licensed Patents to make, use, sell, offer to sell,
5707import and otherwise transfer the Contribution of such Contributor,
5708if any, in source code and object code form. This patent license
5709shall apply to the combination of the Contribution and the Program
5710if, at the time the Contribution is added by the Contributor, such
5711addition of the Contribution causes such combination to be covered by
5712the Licensed Patents. The patent license shall not apply to any
5713other combinations which include the Contribution. No hardware per
5714se is licensed hereunder.
5715
5716Recipient understands that although each Contributor grants the
5717licenses to its Contributions set forth herein, no assurances are
5718provided by any Contributor that the Program does not infringe the
5719patent or other intellectual property rights of any other entity.
5720Each Contributor disclaims any liability to Recipient for claims
5721brought by any other entity based on infringement of intellectual
5722property rights or otherwise. As a condition to exercising the
5723rights and licenses granted hereunder, each Recipient hereby assumes
5724sole responsibility to secure any other intellectual property rights
5725needed, if any. For example, if a third party patent license is
5726required to allow Recipient to distribute the Program, it is
5727Recipient`s responsibility to acquire that license before
5728distributing the Program.
5729Each Contributor represents that to its knowledge it has
5730sufficient copyright rights in its Contribution, if any, to grant the
5731copyright license set forth in this Agreement.
57323. REQUIREMENTS
5733A Contributor may choose to distribute
5734the Program in object code form under its own license agreement,
5735provided that:
5736
5737it complies with the terms and conditions of this Agreement; and
5738its license agreement:
5739effectively disclaims on behalf of all Contributors all warranties
5740and conditions, express and implied, including warranties or
5741conditions of title and non-infringement, and implied warranties or
5742conditions of merchantability and fitness for a particular purpose;
5743effectively excludes on behalf of all Contributors all liability
5744for damages, including direct, indirect, special, incidental and
5745consequential damages, such as lost profits;
5746states that any provisions which differ from this Agreement are
5747offered by that Contributor alone and not by any other party; and
5748
5749states that source code for the Program is available from such
5750Contributor, and informs licensees how to obtain it in a reasonable
5751manner on or through a medium customarily used for software exchange.
5752When the Program is made available in source code form:
5753
5754it must be made available under this Agreement; and
5755a copy of this Agreement must be included with each copy of the
5756Program.
5757Each Contributor must include the following in a conspicuous location in the Program:
5758
5759Copyright (C) 1996, 1999 International Business Machines Corporation and others. All
5760Rights Reserved.
5761
5762In addition, each Contributor must identify itself as the originator
5763of its Contribution, if any, in a manner that reasonably allows
5764subsequent Recipients to identify the originator of the Contribution.
5765
57664. COMMERCIAL DISTRIBUTION
5767Commercial distributors of software may accept certain
5768responsibilities with respect to end users, business partners and the
5769like. While this license is intended to facilitate the commercial
5770use of the Program, the Contributor who includes the Program in a
5771commercial product offering should do so in a manner which does not
5772create potential liability for other Contributors. Therefore, if a
5773Contributor includes the Program in a commercial product offering,
5774such Contributor ("Commercial Contributor") hereby agrees to defend
5775and indemnify every other Contributor ("Indemnified Contributor")
5776against any losses, damages and costs (collectively "Losses") arising
5777from claims, lawsuits and other legal actions brought by a third
5778party against the Indemnified Contributor to the extent caused by the
5779acts or omissions of such Commercial Contributor in connection with
5780its distribution of the Program in a commercial product offering.
5781The obligations in this section do not apply to any claims or Losses
5782relating to any actual or alleged intellectual property infringement.
5783In order to qualify, an Indemnified Contributor must: a) promptly
5784notify the Commercial Contributor in writing of such claim, and b)
5785allow the Commercial Contributor to control, and cooperate with the
5786Commercial Contributor in, the defense and any related settlement
5787negotiations. The Indemnified Contributor may participate in any
5788such claim at its own expense.
5789
5790For example, a Contributor might include the Program in a commercial
5791product offering, Product X. That Contributor is then a Commercial
5792Contributor. If that Commercial Contributor then makes performance
5793claims, or offers warranties related to Product X, those performance
5794claims and warranties are such Commercial Contributor`s
5795responsibility alone. Under this section, the Commercial Contributor
5796would have to defend claims against the other Contributors related to
5797those performance claims and warranties, and if a court requires any
5798other Contributor to pay any damages as a result, the Commercial
5799Contributor must pay those damages.
5800
58015. NO WARRANTY
5802EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS
5803PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
5804KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY
5805WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY
5806OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely
5807responsible for determining the appropriateness of using and
5808distributing the Program and assumes all risks associated with its
5809exercise of rights under this Agreement, including but not limited to
5810the risks and costs of program errors, compliance with applicable
5811laws, damage to or loss of data, programs or equipment, and
5812unavailability or interruption of operations.
5813
58146. DISCLAIMER OF LIABILITY
5815EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT
5816NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT,
5817INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
5818(INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON
5819ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
5820TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
5821THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS
5822GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
5823
58247. GENERAL
5825If any provision of this Agreement is invalid or unenforceable under
5826applicable law, it shall not affect the validity or enforceability of
5827the remainder of the terms of this Agreement, and without further
5828action by the parties hereto, such provision shall be reformed to the
5829minimum extent necessary to make such provision valid and enforceable.
5830
5831If Recipient institutes patent litigation against a Contributor with
5832respect to a patent applicable to software (including a cross-claim
5833or counterclaim in a lawsuit), then any patent licenses granted by
5834that Contributor to such Recipient under this Agreement shall
5835terminate as of the date such litigation is filed. In addition, if
5836Recipient institutes patent litigation against any entity (including
5837a cross-claim or counterclaim in a lawsuit) alleging that the Program
5838itself (excluding combinations of the Program with other software or
5839hardware) infringes such Recipient`s patent(s), then such Recipient`s
5840rights granted under Section 2(b) shall terminate as of the date such
5841litigation is filed.
5842
5843All Recipient`s rights under this Agreement shall terminate if it
5844fails to comply with any of the material terms or conditions of this
5845Agreement and does not cure such failure in a reasonable period of
5846time after becoming aware of such noncompliance. If all Recipient`s
5847rights under this Agreement terminate, Recipient agrees to cease use
5848and distribution of the Program as soon as reasonably practicable.
5849However, Recipient`s obligations under this Agreement and any
5850licenses granted by Recipient relating to the Program shall continue
5851and survive.
5852
5853IBM may publish new versions (including revisions) of this Agreement
5854from time to time. Each new version of the Agreement will be given a
5855distinguishing version number. The Program (including Contributions)
5856may always be distributed subject to the version of the Agreement
5857under which it was received. In addition, after a new version of the
5858Agreement is published, Contributor may elect to distribute the
5859Program (including its Contributions) under the new version. No one
5860other than IBM has the right to modify this Agreement. Except as
5861expressly stated in Sections 2(a) and 2(b) above, Recipient receives
5862no rights or licenses to the intellectual property of any Contributor
5863under this Agreement, whether expressly, by implication, estoppel or
5864otherwise. All rights in the Program not expressly granted under
5865this Agreement are reserved.
5866
5867This Agreement is governed by the laws of the State of New York and
5868the intellectual property laws of the United States of America. No
5869party to this Agreement will bring a legal action under this
5870Agreement more than one year after the cause of action arose. Each
5871party waives its rights to a jury trial in any resulting litigation.
5872
5873</programlisting></para></section>
5874
5875<section id="lic_26">
5876<title>ISC</title>
5877<para><programlisting>
5878
5879ISC License:
5880
5881Copyright &amp;#169; 2004-2010 by Internet Systems Consortium, Inc. ("ISC")
5882Copyright &amp;#169; 1995-2003 by Internet Software Consortium
5883
5884Permission to use, copy, modify, and/or distribute this software for any purpose with
5885or without fee is hereby granted, provided that the above copyright notice and this
5886permission notice appear in all copies.
5887
5888THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
5889SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT
5890SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY
5891DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
5892OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH
5893THE USE OR PERFORMANCE OF THIS SOFTWARE.
5894
5895</programlisting></para></section>
5896
5897<section id="lic_27">
5898<title>JLEX</title>
5899<para><programlisting>
5900 JLEX COPYRIGHT NOTICE, LICENSE, AND DISCLAIMER
5901 Copyright 1996-2000 by Elliot Joel Berk and C. Scott Ananian
5902
5903 Permission to use, copy, modify, and distribute this software and its
5904 documentation for any purpose and without fee is hereby granted,
5905 provided that the above copyright notice appear in all copies and that
5906 both the copyright notice and this permission notice and warranty
5907 disclaimer appear in supporting documentation, and that the name of
5908 the authors or their employers not be used in advertising or publicity
5909 pertaining to distribution of the software without specific, written
5910 prior permission.
5911
5912 The authors and their employers disclaim all warranties with regard to
5913 this software, including all implied warranties of merchantability and
5914 fitness. In no event shall the authors or their employers be liable
5915 for any special, indirect or consequential damages or any damages
5916 whatsoever resulting from loss of use, data or profits, whether in an
5917 action of contract, negligence or other tortious action, arising out
5918 of or in connection with the use or performance of this software.
5919</programlisting></para></section>
5920
5921<section id="lic_28">
5922<title>LGPL-2.0</title>
5923<para><programlisting>
5924GNU LIBRARY GENERAL PUBLIC LICENSE
5925
5926
5927
5928Version 2, June 1991
5929
5930
5931
5932Copyright (C) 1991 Free Software Foundation, Inc.
5933
593451 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
5935
5936Everyone is permitted to copy and distribute verbatim copies
5937
5938of this license document, but changing it is not allowed.
5939
5940
5941
5942[This is the first released version of the library GPL. It is
5943
5944 numbered 2 because it goes with version 2 of the ordinary GPL.]
5945
5946Preamble
5947
5948
5949
5950The licenses for most software are designed to take away your freedom to share and
5951change it. By contrast, the GNU General Public Licenses are intended to guarantee your
5952freedom to share and change free software--to make sure the software is free for all
5953its users.
5954
5955
5956
5957This license, the Library General Public License, applies to some specially designated
5958Free Software Foundation software, and to any other libraries whose authors decide to
5959use it. You can use it for your libraries, too.
5960
5961
5962
5963When we speak of free software, we are referring to freedom, not price. Our General
5964Public Licenses are designed to make sure that you have the freedom to distribute
5965copies of free software (and charge for this service if you wish), that you receive
5966source code or can get it if you want it, that you can change the software or use
5967pieces of it in new free programs; and that you know you can do these things.
5968
5969
5970
5971To protect your rights, we need to make restrictions that forbid anyone to deny you
5972these rights or to ask you to surrender the rights. These restrictions translate to
5973certain responsibilities for you if you distribute copies of the library, or if you
5974modify it.
5975
5976
5977
5978For example, if you distribute copies of the library, whether gratis or for a fee, you
5979must give the recipients all the rights that we gave you. You must make sure that
5980they, too, receive or can get the source code. If you link a program with the library,
5981you must provide complete object files to the recipients so that they can relink them
5982with the library, after making changes to the library and recompiling it. And you must
5983show them these terms so they know their rights.
5984
5985
5986
5987Our method of protecting your rights has two steps: (1) copyright the library, and (2)
5988offer you this license which gives you legal permission to copy, distribute and/or
5989modify the library.
5990
5991
5992
5993Also, for each distributor's protection, we want to make certain that everyone
5994understands that there is no warranty for this free library. If the library is
5995modified by someone else and passed on, we want its recipients to know that what they
5996have is not the original version, so that any problems introduced by others will not
5997reflect on the original authors' reputations.
5998
5999
6000
6001Finally, any free program is threatened constantly by software patents. We wish to
6002avoid the danger that companies distributing free software will individually obtain
6003patent licenses, thus in effect transforming the program into proprietary software. To
6004prevent this, we have made it clear that any patent must be licensed for everyone's
6005free use or not licensed at all.
6006
6007
6008
6009Most GNU software, including some libraries, is covered by the ordinary GNU General
6010Public License, which was designed for utility programs. This license, the GNU Library
6011General Public License, applies to certain designated libraries. This license is quite
6012different from the ordinary one; be sure to read it in full, and don't assume that
6013anything in it is the same as in the ordinary license.
6014
6015
6016
6017The reason we have a separate public license for some libraries is that they blur the
6018distinction we usually make between modifying or adding to a program and simply using
6019it. Linking a program with a library, without changing the library, is in some sense
6020simply using the library, and is analogous to running a utility program or application
6021program. However, in a textual and legal sense, the linked executable is a combined
6022work, a derivative of the original library, and the ordinary General Public License
6023treats it as such.
6024
6025
6026
6027Because of this blurred distinction, using the ordinary General Public License for
6028libraries did not effectively promote software sharing, because most developers did
6029not use the libraries. We concluded that weaker conditions might promote sharing
6030better.
6031
6032
6033
6034However, unrestricted linking of non-free programs would deprive the users of those
6035programs of all benefit from the free status of the libraries themselves. This Library
6036General Public License is intended to permit developers of non-free programs to use
6037free libraries, while preserving your freedom as a user of such programs to change the
6038free libraries that are incorporated in them. (We have not seen how to achieve this as
6039regards changes in header files, but we have achieved it as regards changes in the
6040actual functions of the Library.) The hope is that this will lead to faster
6041development of free libraries.
6042
6043
6044
6045The precise terms and conditions for copying, distribution and modification follow.
6046Pay close attention to the difference between a "work based on the library" and a
6047"work that uses the library". The former contains code derived from the library, while
6048the latter only works together with the library.
6049
6050
6051
6052Note that it is possible for a library to be covered by the ordinary General Public
6053License rather than by this special one.
6054
6055
6056
6057TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
6058
6059
6060
60610. This License Agreement applies to any software library which contains a notice
6062placed by the copyright holder or other authorized party saying it may be distributed
6063under the terms of this Library General Public License (also called "this License").
6064Each licensee is addressed as "you".
6065
6066
6067
6068A "library" means a collection of software functions and/or data prepared so as to be
6069conveniently linked with application programs (which use some of those functions and
6070data) to form executables.
6071
6072
6073
6074The "Library", below, refers to any such software library or work which has been
6075distributed under these terms. A "work based on the Library" means either the Library
6076or any derivative work under copyright law: that is to say, a work containing the
6077Library or a portion of it, either verbatim or with modifications and/or translated
6078straightforwardly into another language. (Hereinafter, translation is included without
6079limitation in the term "modification".)
6080
6081
6082
6083"Source code" for a work means the preferred form of the work for making modifications
6084to it. For a library, complete source code means all the source code for all modules
6085it contains, plus any associated interface definition files, plus the scripts used to
6086control compilation and installation of the library.
6087
6088
6089
6090Activities other than copying, distribution and modification are not covered by this
6091License; they are outside its scope. The act of running a program using the Library is
6092not restricted, and output from such a program is covered only if its contents
6093constitute a work based on the Library (independent of the use of the Library in a
6094tool for writing it). Whether that is true depends on what the Library does and what
6095the program that uses the Library does.
6096
6097
6098
60991. You may copy and distribute verbatim copies of the Library's complete source code
6100as you receive it, in any medium, provided that you conspicuously and appropriately
6101publish on each copy an appropriate copyright notice and disclaimer of warranty; keep
6102intact all the notices that refer to this License and to the absence of any warranty;
6103and distribute a copy of this License along with the Library.
6104
6105
6106
6107You may charge a fee for the physical act of transferring a copy, and you may at your
6108option offer warranty protection in exchange for a fee.
6109
6110
6111
61122. You may modify your copy or copies of the Library or any portion of it, thus
6113forming a work based on the Library, and copy and distribute such modifications or
6114work under the terms of Section 1 above, provided that you also meet all of these
6115conditions:
6116
6117
6118
6119a) The modified work must itself be a software library.
6120
6121b) You must cause the files modified to carry prominent notices stating that you
6122changed the files and the date of any change.
6123
6124c) You must cause the whole of the work to be licensed at no charge to all third
6125parties under the terms of this License.
6126
6127d) If a facility in the modified Library refers to a function or a table of data to be
6128supplied by an application program that uses the facility, other than as an argument
6129passed when the facility is invoked, then you must make a good faith effort to ensure
6130that, in the event an application does not supply such function or table, the facility
6131still operates, and performs whatever part of its purpose remains meaningful.
6132
6133(For example, a function in a library to compute square roots has a purpose that is
6134entirely well-defined independent of the application. Therefore, Subsection 2d
6135requires that any application-supplied function or table used by this function must be
6136optional: if the application does not supply it, the square root function must still
6137compute square roots.)
6138
6139
6140
6141These requirements apply to the modified work as a whole. If identifiable sections of
6142that work are not derived from the Library, and can be reasonably considered
6143independent and separate works in themselves, then this License, and its terms, do not
6144apply to those sections when you distribute them as separate works. But when you
6145distribute the same sections as part of a whole which is a work based on the Library,
6146the distribution of the whole must be on the terms of this License, whose permissions
6147for other licensees extend to the entire whole, and thus to each and every part
6148regardless of who wrote it.
6149
6150
6151
6152Thus, it is not the intent of this section to claim rights or contest your rights to
6153work written entirely by you; rather, the intent is to exercise the right to control
6154the distribution of derivative or collective works based on the Library.
6155
6156
6157
6158In addition, mere aggregation of another work not based on the Library with the
6159Library (or with a work based on the Library) on a volume of a storage or distribution
6160medium does not bring the other work under the scope of this License.
6161
6162
6163
61643. You may opt to apply the terms of the ordinary GNU General Public License instead
6165of this License to a given copy of the Library. To do this, you must alter all the
6166notices that refer to this License, so that they refer to the ordinary GNU General
6167Public License, version 2, instead of to this License. (If a newer version than
6168version 2 of the ordinary GNU General Public License has appeared, then you can
6169specify that version instead if you wish.) Do not make any other change in these
6170notices.
6171
6172
6173
6174Once this change is made in a given copy, it is irreversible for that copy, so the
6175ordinary GNU General Public License applies to all subsequent copies and derivative
6176works made from that copy.
6177
6178
6179
6180This option is useful when you wish to copy part of the code of the Library into a
6181program that is not a library.
6182
6183
6184
61854. You may copy and distribute the Library (or a portion or derivative of it, under
6186Section 2) in object code or executable form under the terms of Sections 1 and 2 above
6187provided that you accompany it with the complete corresponding machine-readable source
6188code, which must be distributed under the terms of Sections 1 and 2 above on a medium
6189customarily used for software interchange.
6190
6191
6192
6193If distribution of object code is made by offering access to copy from a designated
6194place, then offering equivalent access to copy the source code from the same place
6195satisfies the requirement to distribute the source code, even though third parties are
6196not compelled to copy the source along with the object code.
6197
6198
6199
62005. A program that contains no derivative of any portion of the Library, but is
6201designed to work with the Library by being compiled or linked with it, is called a
6202"work that uses the Library". Such a work, in isolation, is not a derivative work of
6203the Library, and therefore falls outside the scope of this License.
6204
6205
6206
6207However, linking a "work that uses the Library" with the Library creates an executable
6208that is a derivative of the Library (because it contains portions of the Library),
6209rather than a "work that uses the library". The executable is therefore covered by
6210this License. Section 6 states terms for distribution of such executables.
6211
6212
6213
6214When a "work that uses the Library" uses material from a header file that is part of
6215the Library, the object code for the work may be a derivative work of the Library even
6216though the source code is not. Whether this is true is especially significant if the
6217work can be linked without the Library, or if the work is itself a library. The
6218threshold for this to be true is not precisely defined by law.
6219
6220
6221
6222If such an object file uses only numerical parameters, data structure layouts and
6223accessors, and small macros and small inline functions (ten lines or less in length),
6224then the use of the object file is unrestricted, regardless of whether it is legally a
6225derivative work. (Executables containing this object code plus portions of the Library
6226will still fall under Section 6.)
6227
6228
6229
6230Otherwise, if the work is a derivative of the Library, you may distribute the object
6231code for the work under the terms of Section 6. Any executables containing that work
6232also fall under Section 6, whether or not they are linked directly with the Library
6233itself.
6234
6235
6236
62376. As an exception to the Sections above, you may also compile or link a "work that
6238uses the Library" with the Library to produce a work containing portions of the
6239Library, and distribute that work under terms of your choice, provided that the terms
6240permit modification of the work for the customer's own use and reverse engineering for
6241debugging such modifications.
6242
6243
6244
6245You must give prominent notice with each copy of the work that the Library is used in
6246it and that the Library and its use are covered by this License. You must supply a
6247copy of this License. If the work during execution displays copyright notices, you
6248must include the copyright notice for the Library among them, as well as a reference
6249directing the user to the copy of this License. Also, you must do one of these things:
6250
6251
6252
6253a) Accompany the work with the complete corresponding machine-readable source code for
6254the Library including whatever changes were used in the work (which must be
6255distributed under Sections 1 and 2 above); and, if the work is an executable linked
6256with the Library, with the complete machine-readable "work that uses the Library", as
6257object code and/or source code, so that the user can modify the Library and then
6258relink to produce a modified executable containing the modified Library. (It is
6259understood that the user who changes the contents of definitions files in the Library
6260will not necessarily be able to recompile the application to use the modified
6261definitions.)
6262
6263b) Accompany the work with a written offer, valid for at least three years, to give
6264the same user the materials specified in Subsection 6a, above, for a charge no more
6265than the cost of performing this distribution.
6266
6267c) If distribution of the work is made by offering access to copy from a designated
6268place, offer equivalent access to copy the above specified materials from the same
6269place.
6270
6271d) Verify that the user has already received a copy of these materials or that you
6272have already sent this user a copy.
6273
6274For an executable, the required form of the "work that uses the Library" must include
6275any data and utility programs needed for reproducing the executable from it. However,
6276as a special exception, the source code distributed need not include anything that is
6277normally distributed (in either source or binary form) with the major components
6278(compiler, kernel, and so on) of the operating system on which the executable runs,
6279unless that component itself accompanies the executable.
6280
6281
6282
6283It may happen that this requirement contradicts the license restrictions of other
6284proprietary libraries that do not normally accompany the operating system. Such a
6285contradiction means you cannot use both them and the Library together in an executable
6286that you distribute.
6287
6288
6289
62907. You may place library facilities that are a work based on the Library side-by-side
6291in a single library together with other library facilities not covered by this
6292License, and distribute such a combined library, provided that the separate
6293distribution of the work based on the Library and of the other library facilities is
6294otherwise permitted, and provided that you do these two things:
6295
6296
6297
6298a) Accompany the combined library with a copy of the same work based on the Library,
6299uncombined with any other library facilities. This must be distributed under the terms
6300of the Sections above.
6301
6302b) Give prominent notice with the combined library of the fact that part of it is a
6303work based on the Library, and explaining where to find the accompanying uncombined
6304form of the same work.
6305
63068. You may not copy, modify, sublicense, link with, or distribute the Library except
6307as expressly provided under this License. Any attempt otherwise to copy, modify,
6308sublicense, link with, or distribute the Library is void, and will automatically
6309terminate your rights under this License. However, parties who have received copies,
6310or rights, from you under this License will not have their licenses terminated so long
6311as such parties remain in full compliance.
6312
6313
6314
63159. You are not required to accept this License, since you have not signed it. However,
6316nothing else grants you permission to modify or distribute the Library or its
6317derivative works. These actions are prohibited by law if you do not accept this
6318License. Therefore, by modifying or distributing the Library (or any work based on the
6319Library), you indicate your acceptance of this License to do so, and all its terms and
6320conditions for copying, distributing or modifying the Library or works based on it.
6321
6322
6323
632410. Each time you redistribute the Library (or any work based on the Library), the
6325recipient automatically receives a license from the original licensor to copy,
6326distribute, link with or modify the Library subject to these terms and conditions. You
6327may not impose any further restrictions on the recipients' exercise of the rights
6328granted herein. You are not responsible for enforcing compliance by third parties to
6329this License.
6330
6331
6332
633311. If, as a consequence of a court judgment or allegation of patent infringement or
6334for any other reason (not limited to patent issues), conditions are imposed on you
6335(whether by court order, agreement or otherwise) that contradict the conditions of
6336this License, they do not excuse you from the conditions of this License. If you
6337cannot distribute so as to satisfy simultaneously your obligations under this License
6338and any other pertinent obligations, then as a consequence you may not distribute the
6339Library at all. For example, if a patent license would not permit royalty-free
6340redistribution of the Library by all those who receive copies directly or indirectly
6341through you, then the only way you could satisfy both it and this License would be to
6342refrain entirely from distribution of the Library.
6343
6344
6345
6346If any portion of this section is held invalid or unenforceable under any particular
6347circumstance, the balance of the section is intended to apply, and the section as a
6348whole is intended to apply in other circumstances.
6349
6350
6351
6352It is not the purpose of this section to induce you to infringe any patents or other
6353property right claims or to contest validity of any such claims; this section has the
6354sole purpose of protecting the integrity of the free software distribution system
6355which is implemented by public license practices. Many people have made generous
6356contributions to the wide range of software distributed through that system in
6357reliance on consistent application of that system; it is up to the author/donor to
6358decide if he or she is willing to distribute software through any other system and a
6359licensee cannot impose that choice.
6360
6361
6362
6363This section is intended to make thoroughly clear what is believed to be a consequence
6364of the rest of this License.
6365
6366
6367
636812. If the distribution and/or use of the Library is restricted in certain countries
6369either by patents or by copyrighted interfaces, the original copyright holder who
6370places the Library under this License may add an explicit geographical distribution
6371limitation excluding those countries, so that distribution is permitted only in or
6372among countries not thus excluded. In such case, this License incorporates the
6373limitation as if written in the body of this License.
6374
6375
6376
637713. The Free Software Foundation may publish revised and/or new versions of the
6378Library General Public License from time to time. Such new versions will be similar in
6379spirit to the present version, but may differ in detail to address new problems or
6380concerns.
6381
6382
6383
6384Each version is given a distinguishing version number. If the Library specifies a
6385version number of this License which applies to it and "any later version", you have
6386the option of following the terms and conditions either of that version or of any
6387later version published by the Free Software Foundation. If the Library does not
6388specify a license version number, you may choose any version ever published by the
6389Free Software Foundation.
6390
6391
6392
639314. If you wish to incorporate parts of the Library into other free programs whose
6394distribution conditions are incompatible with these, write to the author to ask for
6395permission. For software which is copyrighted by the Free Software Foundation, write
6396to the Free Software Foundation; we sometimes make exceptions for this. Our decision
6397will be guided by the two goals of preserving the free status of all derivatives of
6398our free software and of promoting the sharing and reuse of software generally.
6399
6400
6401
6402NO WARRANTY
6403
6404
6405
640615. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
6407LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
6408WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT
6409WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
6410IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
6411RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY
6412PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
6413
6414
6415
641616. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
6417COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS
6418PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
6419INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
6420LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
6421OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE
6422WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
6423POSSIBILITY OF SUCH DAMAGES.
6424
6425
6426
6427END OF TERMS AND CONDITIONS
6428
6429
6430
6431How to Apply These Terms to Your New Libraries
6432
6433
6434
6435If you develop a new library, and you want it to be of the greatest possible use to
6436the public, we recommend making it free software that everyone can redistribute and
6437change. You can do so by permitting redistribution under these terms (or,
6438alternatively, under the terms of the ordinary General Public License).
6439
6440
6441
6442To apply these terms, attach the following notices to the library. It is safest to
6443attach them to the start of each source file to most effectively convey the exclusion
6444of warranty; and each file should have at least the "copyright" line and a pointer to
6445where the full notice is found.
6446
6447
6448
6449one line to give the library's name and an idea of what it does.
6450
6451Copyright (C) year name of author
6452
6453
6454
6455This library is free software; you can redistribute it and/or
6456
6457modify it under the terms of the GNU Library General Public
6458
6459License as published by the Free Software Foundation; either
6460
6461version 2 of the License, or (at your option) any later version.
6462
6463
6464
6465This library is distributed in the hope that it will be useful,
6466
6467but WITHOUT ANY WARRANTY; without even the implied warranty of
6468
6469MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
6470
6471Library General Public License for more details.
6472
6473
6474
6475You should have received a copy of the GNU Library General Public
6476
6477License along with this library; if not, write to the
6478
6479Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
6480
6481Boston, MA 02110-1301, USA.
6482
6483Also add information on how to contact you by electronic and paper mail.
6484
6485
6486
6487You should also get your employer (if you work as a programmer) or your school, if
6488any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample;
6489alter the names:
6490
6491
6492
6493Yoyodyne, Inc., hereby disclaims all copyright interest in
6494
6495the library `Frob' (a library for tweaking knobs) written
6496
6497by James Random Hacker.
6498
6499
6500
6501signature of Ty Coon, 1 April 1990
6502
6503Ty Coon, President of Vice
6504
6505That's all there is to it!
6506
6507</programlisting></para></section>
6508
6509<section id="lic_29">
6510<title>LGPL-2.1</title>
6511<para><programlisting>
6512
6513GNU LESSER GENERAL PUBLIC LICENSE
6514
6515Version 2.1, February 1999
6516
6517Copyright (C) 1991, 1999 Free Software Foundation, Inc.
651851 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
6519Everyone is permitted to copy and distribute verbatim copies
6520of this license document, but changing it is not allowed.
6521
6522[This is the first released version of the Lesser GPL. It also counts
6523 as the successor of the GNU Library Public License, version 2, hence
6524 the version number 2.1.]
6525Preamble
6526
6527The licenses for most software are designed to take away your freedom to share and
6528change it. By contrast, the GNU General Public Licenses are intended to guarantee your
6529freedom to share and change free software--to make sure the software is free for all
6530its users.
6531
6532This license, the Lesser General Public License, applies to some specially designated
6533software packages--typically libraries--of the Free Software Foundation and other
6534authors who decide to use it. You can use it too, but we suggest you first think
6535carefully about whether this license or the ordinary General Public License is the
6536better strategy to use in any particular case, based on the explanations below.
6537
6538When we speak of free software, we are referring to freedom of use, not price. Our
6539General Public Licenses are designed to make sure that you have the freedom to
6540distribute copies of free software (and charge for this service if you wish); that you
6541receive source code or can get it if you want it; that you can change the software and
6542use pieces of it in new free programs; and that you are informed that you can do these
6543things.
6544
6545To protect your rights, we need to make restrictions that forbid distributors to deny
6546you these rights or to ask you to surrender these rights. These restrictions translate
6547to certain responsibilities for you if you distribute copies of the library or if you
6548modify it.
6549
6550For example, if you distribute copies of the library, whether gratis or for a fee, you
6551must give the recipients all the rights that we gave you. You must make sure that
6552they, too, receive or can get the source code. If you link other code with the
6553library, you must provide complete object files to the recipients, so that they can
6554relink them with the library after making changes to the library and recompiling it.
6555And you must show them these terms so they know their rights.
6556
6557We protect your rights with a two-step method: (1) we copyright the library, and (2)
6558we offer you this license, which gives you legal permission to copy, distribute and/or
6559modify the library.
6560
6561To protect each distributor, we want to make it very clear that there is no warranty
6562for the free library. Also, if the library is modified by someone else and passed on,
6563the recipients should know that what they have is not the original version, so that
6564the original author`s reputation will not be affected by problems that might be
6565introduced by others.
6566
6567Finally, software patents pose a constant threat to the existence of any free program.
6568We wish to make sure that a company cannot effectively restrict the users of a free
6569program by obtaining a restrictive license from a patent holder. Therefore, we insist
6570that any patent license obtained for a version of the library must be consistent with
6571the full freedom of use specified in this license.
6572
6573Most GNU software, including some libraries, is covered by the ordinary GNU General
6574Public License. This license, the GNU Lesser General Public License, applies to
6575certain designated libraries, and is quite different from the ordinary General Public
6576License. We use this license for certain libraries in order to permit linking those
6577libraries into non-free programs.
6578
6579When a program is linked with a library, whether statically or using a shared library,
6580the combination of the two is legally speaking a combined work, a derivative of the
6581original library. The ordinary General Public License therefore permits such linking
6582only if the entire combination fits its criteria of freedom. The Lesser General Public
6583License permits more lax criteria for linking other code with the library.
6584
6585We call this license the "Lesser" General Public License because it does Less to
6586protect the user`s freedom than the ordinary General Public License. It also provides
6587other free software developers Less of an advantage over competing non-free programs.
6588These disadvantages are the reason we use the ordinary General Public License for many
6589libraries. However, the Lesser license provides advantages in certain special
6590circumstances.
6591
6592For example, on rare occasions, there may be a special need to encourage the widest
6593possible use of a certain library, so that it becomes a de-facto standard. To achieve
6594this, non-free programs must be allowed to use the library. A more frequent case is
6595that a free library does the same job as widely used non-free libraries. In this case,
6596there is little to gain by limiting the free library to free software only, so we use
6597the Lesser General Public License.
6598
6599In other cases, permission to use a particular library in non-free programs enables a
6600greater number of people to use a large body of free software. For example, permission
6601to use the GNU C Library in non-free programs enables many more people to use the
6602whole GNU operating system, as well as its variant, the GNU/Linux operating system.
6603
6604Although the Lesser General Public License is Less protective of the users` freedom,
6605it does ensure that the user of a program that is linked with the Library has the
6606freedom and the wherewithal to run that program using a modified version of the
6607Library.
6608
6609The precise terms and conditions for copying, distribution and modification follow.
6610Pay close attention to the difference between a "work based on the library" and a
6611"work that uses the library". The former contains code derived from the library,
6612whereas the latter must be combined with the library in order to run.
6613
6614TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
6615
66160. This License Agreement applies to any software library or other program which
6617contains a notice placed by the copyright holder or other authorized party saying it
6618may be distributed under the terms of this Lesser General Public License (also called
6619"this License"). Each licensee is addressed as "you".
6620
6621A "library" means a collection of software functions and/or data prepared so as to be
6622conveniently linked with application programs (which use some of those functions and
6623data) to form executables.
6624
6625The "Library", below, refers to any such software library or work which has been
6626distributed under these terms. A "work based on the Library" means either the Library
6627or any derivative work under copyright law: that is to say, a work containing the
6628Library or a portion of it, either verbatim or with modifications and/or translated
6629straightforwardly into another language. (Hereinafter, translation is included without
6630limitation in the term "modification".)
6631
6632"Source code" for a work means the preferred form of the work for making modifications
6633to it. For a library, complete source code means all the source code for all modules
6634it contains, plus any associated interface definition files, plus the scripts used to
6635control compilation and installation of the library.
6636
6637Activities other than copying, distribution and modification are not covered by this
6638License; they are outside its scope. The act of running a program using the Library is
6639not restricted, and output from such a program is covered only if its contents
6640constitute a work based on the Library (independent of the use of the Library in a
6641tool for writing it). Whether that is true depends on what the Library does and what
6642the program that uses the Library does.
6643
66441. You may copy and distribute verbatim copies of the Library`s complete source code
6645as you receive it, in any medium, provided that you conspicuously and appropriately
6646publish on each copy an appropriate copyright notice and disclaimer of warranty; keep
6647intact all the notices that refer to this License and to the absence of any warranty;
6648and distribute a copy of this License along with the Library.
6649
6650You may charge a fee for the physical act of transferring a copy, and you may at your
6651option offer warranty protection in exchange for a fee.
6652
66532. You may modify your copy or copies of the Library or any portion of it, thus
6654forming a work based on the Library, and copy and distribute such modifications or
6655work under the terms of Section 1 above, provided that you also meet all of these
6656conditions:
6657
6658a) The modified work must itself be a software library.
6659b) You must cause the files modified to carry prominent notices stating that you
6660changed the files and the date of any change.
6661c) You must cause the whole of the work to be licensed at no charge to all third
6662parties under the terms of this License.
6663d) If a facility in the modified Library refers to a function or a table of data to be
6664supplied by an application program that uses the facility, other than as an argument
6665passed when the facility is invoked, then you must make a good faith effort to ensure
6666that, in the event an application does not supply such function or table, the facility
6667still operates, and performs whatever part of its purpose remains meaningful.
6668(For example, a function in a library to compute square roots has a purpose that is
6669entirely well-defined independent of the application. Therefore, Subsection 2d
6670requires that any application-supplied function or table used by this function must be
6671optional: if the application does not supply it, the square root function must still
6672compute square roots.)
6673
6674These requirements apply to the modified work as a whole. If identifiable sections of
6675that work are not derived from the Library, and can be reasonably considered
6676independent and separate works in themselves, then this License, and its terms, do not
6677apply to those sections when you distribute them as separate works. But when you
6678distribute the same sections as part of a whole which is a work based on the Library,
6679the distribution of the whole must be on the terms of this License, whose permissions
6680for other licensees extend to the entire whole, and thus to each and every part
6681regardless of who wrote it.
6682
6683Thus, it is not the intent of this section to claim rights or contest your rights to
6684work written entirely by you; rather, the intent is to exercise the right to control
6685the distribution of derivative or collective works based on the Library.
6686
6687In addition, mere aggregation of another work not based on the Library with the
6688Library (or with a work based on the Library) on a volume of a storage or distribution
6689medium does not bring the other work under the scope of this License.
6690
66913. You may opt to apply the terms of the ordinary GNU General Public License instead
6692of this License to a given copy of the Library. To do this, you must alter all the
6693notices that refer to this License, so that they refer to the ordinary GNU General
6694Public License, version 2, instead of to this License. (If a newer version than
6695version 2 of the ordinary GNU General Public License has appeared, then you can
6696specify that version instead if you wish.) Do not make any other change in these
6697notices.
6698
6699Once this change is made in a given copy, it is irreversible for that copy, so the
6700ordinary GNU General Public License applies to all subsequent copies and derivative
6701works made from that copy.
6702
6703This option is useful when you wish to copy part of the code of the Library into a
6704program that is not a library.
6705
67064. You may copy and distribute the Library (or a portion or derivative of it, under
6707Section 2) in object code or executable form under the terms of Sections 1 and 2 above
6708provided that you accompany it with the complete corresponding machine-readable source
6709code, which must be distributed under the terms of Sections 1 and 2 above on a medium
6710customarily used for software interchange.
6711
6712If distribution of object code is made by offering access to copy from a designated
6713place, then offering equivalent access to copy the source code from the same place
6714satisfies the requirement to distribute the source code, even though third parties are
6715not compelled to copy the source along with the object code.
6716
67175. A program that contains no derivative of any portion of the Library, but is
6718designed to work with the Library by being compiled or linked with it, is called a
6719"work that uses the Library". Such a work, in isolation, is not a derivative work of
6720the Library, and therefore falls outside the scope of this License.
6721
6722However, linking a "work that uses the Library" with the Library creates an executable
6723that is a derivative of the Library (because it contains portions of the Library),
6724rather than a "work that uses the library". The executable is therefore covered by
6725this License. Section 6 states terms for distribution of such executables.
6726
6727When a "work that uses the Library" uses material from a header file that is part of
6728the Library, the object code for the work may be a derivative work of the Library even
6729though the source code is not. Whether this is true is especially significant if the
6730work can be linked without the Library, or if the work is itself a library. The
6731threshold for this to be true is not precisely defined by law.
6732
6733If such an object file uses only numerical parameters, data structure layouts and
6734accessors, and small macros and small inline functions (ten lines or less in length),
6735then the use of the object file is unrestricted, regardless of whether it is legally a
6736derivative work. (Executables containing this object code plus portions of the Library
6737will still fall under Section 6.)
6738
6739Otherwise, if the work is a derivative of the Library, you may distribute the object
6740code for the work under the terms of Section 6. Any executables containing that work
6741also fall under Section 6, whether or not they are linked directly with the Library
6742itself.
6743
67446. As an exception to the Sections above, you may also combine or link a "work that
6745uses the Library" with the Library to produce a work containing portions of the
6746Library, and distribute that work under terms of your choice, provided that the terms
6747permit modification of the work for the customer`s own use and reverse engineering for
6748debugging such modifications.
6749
6750You must give prominent notice with each copy of the work that the Library is used in
6751it and that the Library and its use are covered by this License. You must supply a
6752copy of this License. If the work during execution displays copyright notices, you
6753must include the copyright notice for the Library among them, as well as a reference
6754directing the user to the copy of this License. Also, you must do one of these things:
6755
6756a) Accompany the work with the complete corresponding machine-readable source code for
6757the Library including whatever changes were used in the work (which must be
6758distributed under Sections 1 and 2 above); and, if the work is an executable linked
6759with the Library, with the complete machine-readable "work that uses the Library", as
6760object code and/or source code, so that the user can modify the Library and then
6761relink to produce a modified executable containing the modified Library. (It is
6762understood that the user who changes the contents of definitions files in the Library
6763will not necessarily be able to recompile the application to use the modified
6764definitions.)
6765b) Use a suitable shared library mechanism for linking with the Library. A suitable
6766mechanism is one that (1) uses at run time a copy of the library already present on
6767the user`s computer system, rather than copying library functions into the executable,
6768and (2) will operate properly with a modified version of the library, if the user
6769installs one, as long as the modified version is interface-compatible with the version
6770that the work was made with.
6771c) Accompany the work with a written offer, valid for at least three years, to give
6772the same user the materials specified in Subsection 6a, above, for a charge no more
6773than the cost of performing this distribution.
6774d) If distribution of the work is made by offering access to copy from a designated
6775place, offer equivalent access to copy the above specified materials from the same
6776place.
6777e) Verify that the user has already received a copy of these materials or that you
6778have already sent this user a copy.
6779For an executable, the required form of the "work that uses the Library" must include
6780any data and utility programs needed for reproducing the executable from it. However,
6781as a special exception, the materials to be distributed need not include anything that
6782is normally distributed (in either source or binary form) with the major components
6783(compiler, kernel, and so on) of the operating system on which the executable runs,
6784unless that component itself accompanies the executable.
6785
6786It may happen that this requirement contradicts the license restrictions of other
6787proprietary libraries that do not normally accompany the operating system. Such a
6788contradiction means you cannot use both them and the Library together in an executable
6789that you distribute.
6790
67917. You may place library facilities that are a work based on the Library side-by-side
6792in a single library together with other library facilities not covered by this
6793License, and distribute such a combined library, provided that the separate
6794distribution of the work based on the Library and of the other library facilities is
6795otherwise permitted, and provided that you do these two things:
6796
6797a) Accompany the combined library with a copy of the same work based on the Library,
6798uncombined with any other library facilities. This must be distributed under the terms
6799of the Sections above.
6800b) Give prominent notice with the combined library of the fact that part of it is a
6801work based on the Library, and explaining where to find the accompanying uncombined
6802form of the same work.
68038. You may not copy, modify, sublicense, link with, or distribute the Library except
6804as expressly provided under this License. Any attempt otherwise to copy, modify,
6805sublicense, link with, or distribute the Library is void, and will automatically
6806terminate your rights under this License. However, parties who have received copies,
6807or rights, from you under this License will not have their licenses terminated so long
6808as such parties remain in full compliance.
6809
68109. You are not required to accept this License, since you have not signed it. However,
6811nothing else grants you permission to modify or distribute the Library or its
6812derivative works. These actions are prohibited by law if you do not accept this
6813License. Therefore, by modifying or distributing the Library (or any work based on the
6814Library), you indicate your acceptance of this License to do so, and all its terms and
6815conditions for copying, distributing or modifying the Library or works based on it.
6816
681710. Each time you redistribute the Library (or any work based on the Library), the
6818recipient automatically receives a license from the original licensor to copy,
6819distribute, link with or modify the Library subject to these terms and conditions. You
6820may not impose any further restrictions on the recipients` exercise of the rights
6821granted herein. You are not responsible for enforcing compliance by third parties with
6822this License.
6823
682411. If, as a consequence of a court judgment or allegation of patent infringement or
6825for any other reason (not limited to patent issues), conditions are imposed on you
6826(whether by court order, agreement or otherwise) that contradict the conditions of
6827this License, they do not excuse you from the conditions of this License. If you
6828cannot distribute so as to satisfy simultaneously your obligations under this License
6829and any other pertinent obligations, then as a consequence you may not distribute the
6830Library at all. For example, if a patent license would not permit royalty-free
6831redistribution of the Library by all those who receive copies directly or indirectly
6832through you, then the only way you could satisfy both it and this License would be to
6833refrain entirely from distribution of the Library.
6834
6835If any portion of this section is held invalid or unenforceable under any particular
6836circumstance, the balance of the section is intended to apply, and the section as a
6837whole is intended to apply in other circumstances.
6838
6839It is not the purpose of this section to induce you to infringe any patents or other
6840property right claims or to contest validity of any such claims; this section has the
6841sole purpose of protecting the integrity of the free software distribution system
6842which is implemented by public license practices. Many people have made generous
6843contributions to the wide range of software distributed through that system in
6844reliance on consistent application of that system; it is up to the author/donor to
6845decide if he or she is willing to distribute software through any other system and a
6846licensee cannot impose that choice.
6847
6848This section is intended to make thoroughly clear what is believed to be a consequence
6849of the rest of this License.
6850
685112. If the distribution and/or use of the Library is restricted in certain countries
6852either by patents or by copyrighted interfaces, the original copyright holder who
6853places the Library under this License may add an explicit geographical distribution
6854limitation excluding those countries, so that distribution is permitted only in or
6855among countries not thus excluded. In such case, this License incorporates the
6856limitation as if written in the body of this License.
6857
685813. The Free Software Foundation may publish revised and/or new versions of the Lesser
6859General Public License from time to time. Such new versions will be similar in spirit
6860to the present version, but may differ in detail to address new problems or concerns.
6861
6862Each version is given a distinguishing version number. If the Library specifies a
6863version number of this License which applies to it and "any later version", you have
6864the option of following the terms and conditions either of that version or of any
6865later version published by the Free Software Foundation. If the Library does not
6866specify a license version number, you may choose any version ever published by the
6867Free Software Foundation.
6868
686914. If you wish to incorporate parts of the Library into other free programs whose
6870distribution conditions are incompatible with these, write to the author to ask for
6871permission. For software which is copyrighted by the Free Software Foundation, write
6872to the Free Software Foundation; we sometimes make exceptions for this. Our decision
6873will be guided by the two goals of preserving the free status of all derivatives of
6874our free software and of promoting the sharing and reuse of software generally.
6875
6876NO WARRANTY
6877
687815. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
6879LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
6880WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT
6881WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
6882IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
6883RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY
6884PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
6885
688616. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
6887COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS
6888PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
6889INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
6890LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
6891OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE
6892WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
6893POSSIBILITY OF SUCH DAMAGES.
6894
6895END OF TERMS AND CONDITIONS
6896
6897How to Apply These Terms to Your New Libraries
6898
6899If you develop a new library, and you want it to be of the greatest possible use to
6900the public, we recommend making it free software that everyone can redistribute and
6901change. You can do so by permitting redistribution under these terms (or,
6902alternatively, under the terms of the ordinary General Public License).
6903
6904To apply these terms, attach the following notices to the library. It is safest to
6905attach them to the start of each source file to most effectively convey the exclusion
6906of warranty; and each file should have at least the "copyright" line and a pointer to
6907where the full notice is found.
6908
6909one line to give the library`s name and an idea of what it does.
6910Copyright (C) year name of author
6911
6912This library is free software; you can redistribute it and/or
6913modify it under the terms of the GNU Lesser General Public
6914License as published by the Free Software Foundation; either
6915version 2.1 of the License, or (at your option) any later version.
6916
6917This library is distributed in the hope that it will be useful,
6918but WITHOUT ANY WARRANTY; without even the implied warranty of
6919MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
6920Lesser General Public License for more details.
6921
6922You should have received a copy of the GNU Lesser General Public
6923License along with this library; if not, write to the Free Software
6924Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
6925Also add information on how to contact you by electronic and paper mail.
6926
6927You should also get your employer (if you work as a programmer) or your school, if
6928any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample;
6929alter the names:
6930
6931Yoyodyne, Inc., hereby disclaims all copyright interest in
6932the library `Frob` (a library for tweaking knobs) written
6933by James Random Hacker.
6934
6935signature of Ty Coon, 1 April 1990
6936Ty Coon, President of Vice
6937That`s all there is to it!
6938
6939</programlisting></para></section>
6940
6941<section id="lic_30">
6942<title>LGPL-3.0</title>
6943<para><programlisting>
6944GNU LESSER GENERAL PUBLIC LICENSE
6945
6946Version 3, 29 June 2007
6947
6948Copyright © 2007 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
6949
6950Everyone is permitted to copy and distribute verbatim copies of this license document,
6951but changing it is not allowed.
6952
6953This version of the GNU Lesser General Public License incorporates the terms and
6954conditions of version 3 of the GNU General Public License, supplemented by the
6955additional permissions listed below.
69560. Additional Definitions.
6957
6958As used herein, &rdquor;this License&rdquo; refers to version 3 of the GNU Lesser
6959General Public License, and the &rdquor;GNU GPL&rdquo; refers to version 3 of the GNU
6960General Public License.
6961
6962&rdquor;The Library&rdquo; refers to a covered work governed by this License, other
6963than an Application or a Combined Work as defined below.
6964
6965An &rdquor;Application&rdquo; is any work that makes use of an interface provided by
6966the Library, but which is not otherwise based on the Library. Defining a subclass of a
6967class defined by the Library is deemed a mode of using an interface provided by the
6968Library.
6969
6970A &rdquor;Combined Work&rdquo; is a work produced by combining or linking an
6971Application with the Library. The particular version of the Library with which the
6972Combined Work was made is also called the &rdquor;Linked Version&rdquo;.
6973
6974The &rdquor;Minimal Corresponding Source&rdquo; for a Combined Work means the
6975Corresponding Source for the Combined Work, excluding any source code for portions of
6976the Combined Work that, considered in isolation, are based on the Application, and not
6977on the Linked Version.
6978
6979The &rdquor;Corresponding Application Code&rdquo; for a Combined Work means the object
6980code and/or source code for the Application, including any data and utility programs
6981needed for reproducing the Combined Work from the Application, but excluding the
6982System Libraries of the Combined Work.
69831. Exception to Section 3 of the GNU GPL.
6984
6985You may convey a covered work under sections 3 and 4 of this License without being
6986bound by section 3 of the GNU GPL.
69872. Conveying Modified Versions.
6988
6989If you modify a copy of the Library, and, in your modifications, a facility refers to
6990a function or data to be supplied by an Application that uses the facility (other than
6991as an argument passed when the facility is invoked), then you may convey a copy of the
6992modified version:
6993
6994 * a) under this License, provided that you make a good faith effort to ensure
6995that, in the event an Application does not supply the function or data, the facility
6996still operates, and performs whatever part of its purpose remains meaningful, or
6997 * b) under the GNU GPL, with none of the additional permissions of this License
6998applicable to that copy.
6999
70003. Object Code Incorporating Material from Library Header Files.
7001
7002The object code form of an Application may incorporate material from a header file
7003that is part of the Library. You may convey such object code under terms of your
7004choice, provided that, if the incorporated material is not limited to numerical
7005parameters, data structure layouts and accessors, or small macros, inline functions
7006and templates (ten or fewer lines in length), you do both of the following:
7007
7008 * a) Give prominent notice with each copy of the object code that the Library is
7009used in it and that the Library and its use are covered by this License.
7010 * b) Accompany the object code with a copy of the GNU GPL and this license
7011document.
7012
70134. Combined Works.
7014
7015You may convey a Combined Work under terms of your choice that, taken together,
7016effectively do not restrict modification of the portions of the Library contained in
7017the Combined Work and reverse engineering for debugging such modifications, if you
7018also do each of the following:
7019
7020 * a) Give prominent notice with each copy of the Combined Work that the Library is
7021used in it and that the Library and its use are covered by this License.
7022 * b) Accompany the Combined Work with a copy of the GNU GPL and this license
7023document.
7024 * c) For a Combined Work that displays copyright notices during execution, include
7025the copyright notice for the Library among these notices, as well as a reference
7026directing the user to the copies of the GNU GPL and this license document.
7027 * d) Do one of the following:
7028 o 0) Convey the Minimal Corresponding Source under the terms of this
7029License, and the Corresponding Application Code in a form suitable for, and under
7030terms that permit, the user to recombine or relink the Application with a modified
7031version of the Linked Version to produce a modified Combined Work, in the manner
7032specified by section 6 of the GNU GPL for conveying Corresponding Source.
7033 o 1) Use a suitable shared library mechanism for linking with the Library. A
7034suitable mechanism is one that (a) uses at run time a copy of the Library already
7035present on the user's computer system, and (b) will operate properly with a modified
7036version of the Library that is interface-compatible with the Linked Version.
7037 * e) Provide Installation Information, but only if you would otherwise be required
7038to provide such information under section 6 of the GNU GPL, and only to the extent
7039that such information is necessary to install and execute a modified version of the
7040Combined Work produced by recombining or relinking the Application with a modified
7041version of the Linked Version. (If you use option 4d0, the Installation Information
7042must accompany the Minimal Corresponding Source and Corresponding Application Code. If
7043you use option 4d1, you must provide the Installation Information in the manner
7044specified by section 6 of the GNU GPL for conveying Corresponding Source.)
7045
70465. Combined Libraries.
7047
7048You may place library facilities that are a work based on the Library side by side in
7049a single library together with other library facilities that are not Applications and
7050are not covered by this License, and convey such a combined library under terms of
7051your choice, if you do both of the following:
7052
7053 * a) Accompany the combined library with a copy of the same work based on the
7054Library, uncombined with any other library facilities, conveyed under the terms of
7055this License.
7056 * b) Give prominent notice with the combined library that part of it is a work
7057based on the Library, and explaining where to find the accompanying uncombined form of
7058the same work.
7059
70606. Revised Versions of the GNU Lesser General Public License.
7061
7062The Free Software Foundation may publish revised and/or new versions of the GNU Lesser
7063General Public License from time to time. Such new versions will be similar in spirit
7064to the present version, but may differ in detail to address new problems or concerns.
7065
7066Each version is given a distinguishing version number. If the Library as you received
7067it specifies that a certain numbered version of the GNU Lesser General Public License
7068&rdquor;or any later version&rdquo; applies to it, you have the option of following
7069the terms and conditions either of that published version or of any later version
7070published by the Free Software Foundation. If the Library as you received it does not
7071specify a version number of the GNU Lesser General Public License, you may choose any
7072version of the GNU Lesser General Public License ever published by the Free Software
7073Foundation.
7074
7075If the Library as you received it specifies that a proxy can decide whether future
7076versions of the GNU Lesser General Public License shall apply, that proxy's public
7077statement of acceptance of any version is permanent authorization for you to choose
7078that version for the Library.
7079</programlisting></para></section>
7080
7081<section id="lic_31">
7082<title>Libpng</title>
7083<para><programlisting>
7084
7085This copy of the libpng notices is provided for your convenience. In case of
7086any discrepancy between this copy and the notices in the file png.h that is
7087included in the libpng distribution, the latter shall prevail.
7088
7089COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
7090
7091If you modify libpng you may insert additional notices immediately following
7092this sentence.
7093
7094This code is released under the libpng license.
7095
7096libpng versions 1.2.6, August 15, 2004, through 1.4.5, December 9, 2010, are
7097Copyright (c) 2004, 2006-2010 Glenn Randers-Pehrson, and are
7098distributed according to the same disclaimer and license as libpng-1.2.5
7099with the following individual added to the list of Contributing Authors
7100
7101 Cosmin Truta
7102
7103libpng versions 1.0.7, July 1, 2000, through 1.2.5 - October 3, 2002, are
7104Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
7105distributed according to the same disclaimer and license as libpng-1.0.6
7106with the following individuals added to the list of Contributing Authors
7107
7108 Simon-Pierre Cadieux
7109 Eric S. Raymond
7110 Gilles Vollant
7111
7112and with the following additions to the disclaimer:
7113
7114 There is no warranty against interference with your enjoyment of the
7115 library or against infringement. There is no warranty that our
7116 efforts or the library will fulfill any of your particular purposes
7117 or needs. This library is provided with all faults, and the entire
7118 risk of satisfactory quality, performance, accuracy, and effort is with
7119 the user.
7120
7121libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
7122Copyright (c) 1998, 1999 Glenn Randers-Pehrson, and are
7123distributed according to the same disclaimer and license as libpng-0.96,
7124with the following individuals added to the list of Contributing Authors:
7125
7126 Tom Lane
7127 Glenn Randers-Pehrson
7128 Willem van Schaik
7129
7130libpng versions 0.89, June 1996, through 0.96, May 1997, are
7131Copyright (c) 1996, 1997 Andreas Dilger
7132Distributed according to the same disclaimer and license as libpng-0.88,
7133with the following individuals added to the list of Contributing Authors:
7134
7135 John Bowler
7136 Kevin Bracey
7137 Sam Bushell
7138 Magnus Holmgren
7139 Greg Roelofs
7140 Tom Tanner
7141
7142libpng versions 0.5, May 1995, through 0.88, January 1996, are
7143Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
7144
7145For the purposes of this copyright and license, "Contributing Authors"
7146is defined as the following set of individuals:
7147
7148 Andreas Dilger
7149 Dave Martindale
7150 Guy Eric Schalnat
7151 Paul Schmidt
7152 Tim Wegner
7153
7154The PNG Reference Library is supplied "AS IS". The Contributing Authors
7155and Group 42, Inc. disclaim all warranties, expressed or implied,
7156including, without limitation, the warranties of merchantability and of
7157fitness for any purpose. The Contributing Authors and Group 42, Inc.
7158assume no liability for direct, indirect, incidental, special, exemplary,
7159or consequential damages, which may result from the use of the PNG
7160Reference Library, even if advised of the possibility of such damage.
7161
7162Permission is hereby granted to use, copy, modify, and distribute this
7163source code, or portions hereof, for any purpose, without fee, subject
7164to the following restrictions:
7165
71661. The origin of this source code must not be misrepresented.
7167
71682. Altered versions must be plainly marked as such and must not
7169 be misrepresented as being the original source.
7170
71713. This Copyright notice may not be removed or altered from any
7172 source or altered source distribution.
7173
7174The Contributing Authors and Group 42, Inc. specifically permit, without
7175fee, and encourage the use of this source code as a component to
7176supporting the PNG file format in commercial products. If you use this
7177source code in a product, acknowledgment is not required but would be
7178appreciated.
7179
7180
7181A "png_get_copyright" function is available, for convenient use in "about"
7182boxes and the like:
7183
7184 printf("%s",png_get_copyright(NULL));
7185
7186Also, the PNG logo (in PNG format, of course) is supplied in the
7187files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
7188
7189Libpng is OSI Certified Open Source Software. OSI Certified Open Source is a
7190certification mark of the Open Source Initiative.
7191
7192Glenn Randers-Pehrson
7193glennrp at users.sourceforge.net
7194December 9, 2010
7195
7196</programlisting></para></section>
7197
7198<section id="lic_32">
7199<title>MIT</title>
7200<para><programlisting>
7201
7202MIT License
7203
7204Copyright (c) &lt;year&gt; &lt;copyright holders&gt;
7205
7206Permission is hereby granted, free of charge, to any person obtaining a copy
7207of this software and associated documentation files (the "Software"), to deal
7208in the Software without restriction, including without limitation the rights
7209to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
7210copies of the Software, and to permit persons to whom the Software is
7211furnished to do so, subject to the following conditions:
7212
7213The above copyright notice and this permission notice shall be included in
7214all copies or substantial portions of the Software.
7215
7216THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
7217IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
7218FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
7219AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
7220LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
7221OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
7222THE SOFTWARE.
7223
7224</programlisting></para></section>
7225
7226<section id="lic_33">
7227<title>MPL-2.0</title>
7228<para><programlisting>
7229Mozilla Public License Version 2.0
7230==================================
7231
72321. Definitions
7233--------------
7234
72351.1. "Contributor"
7236 means each individual or legal entity that creates, contributes to
7237 the creation of, or owns Covered Software.
7238
72391.2. "Contributor Version"
7240 means the combination of the Contributions of others (if any) used
7241 by a Contributor and that particular Contributor's Contribution.
7242
72431.3. "Contribution"
7244 means Covered Software of a particular Contributor.
7245
72461.4. "Covered Software"
7247 means Source Code Form to which the initial Contributor has attached
7248 the notice in Exhibit A, the Executable Form of such Source Code
7249 Form, and Modifications of such Source Code Form, in each case
7250 including portions thereof.
7251
72521.5. "Incompatible With Secondary Licenses"
7253 means
7254
7255 (a) that the initial Contributor has attached the notice described
7256 in Exhibit B to the Covered Software; or
7257
7258 (b) that the Covered Software was made available under the terms of
7259 version 1.1 or earlier of the License, but not also under the
7260 terms of a Secondary License.
7261
72621.6. "Executable Form"
7263 means any form of the work other than Source Code Form.
7264
72651.7. "Larger Work"
7266 means a work that combines Covered Software with other material, in
7267 a separate file or files, that is not Covered Software.
7268
72691.8. "License"
7270 means this document.
7271
72721.9. "Licensable"
7273 means having the right to grant, to the maximum extent possible,
7274 whether at the time of the initial grant or subsequently, any and
7275 all of the rights conveyed by this License.
7276
72771.10. "Modifications"
7278 means any of the following:
7279
7280 (a) any file in Source Code Form that results from an addition to,
7281 deletion from, or modification of the contents of Covered
7282 Software; or
7283
7284 (b) any new file in Source Code Form that contains any Covered
7285 Software.
7286
72871.11. "Patent Claims" of a Contributor
7288 means any patent claim(s), including without limitation, method,
7289 process, and apparatus claims, in any patent Licensable by such
7290 Contributor that would be infringed, but for the grant of the
7291 License, by the making, using, selling, offering for sale, having
7292 made, import, or transfer of either its Contributions or its
7293 Contributor Version.
7294
72951.12. "Secondary License"
7296 means either the GNU General Public License, Version 2.0, the GNU
7297 Lesser General Public License, Version 2.1, the GNU Affero General
7298 Public License, Version 3.0, or any later versions of those
7299 licenses.
7300
73011.13. "Source Code Form"
7302 means the form of the work preferred for making modifications.
7303
73041.14. "You" (or "Your")
7305 means an individual or a legal entity exercising rights under this
7306 License. For legal entities, "You" includes any entity that
7307 controls, is controlled by, or is under common control with You. For
7308 purposes of this definition, "control" means (a) the power, direct
7309 or indirect, to cause the direction or management of such entity,
7310 whether by contract or otherwise, or (b) ownership of more than
7311 fifty percent (50%) of the outstanding shares or beneficial
7312 ownership of such entity.
7313
73142. License Grants and Conditions
7315--------------------------------
7316
73172.1. Grants
7318
7319Each Contributor hereby grants You a world-wide, royalty-free,
7320non-exclusive license:
7321
7322(a) under intellectual property rights (other than patent or trademark)
7323 Licensable by such Contributor to use, reproduce, make available,
7324 modify, display, perform, distribute, and otherwise exploit its
7325 Contributions, either on an unmodified basis, with Modifications, or
7326 as part of a Larger Work; and
7327
7328(b) under Patent Claims of such Contributor to make, use, sell, offer
7329 for sale, have made, import, and otherwise transfer either its
7330 Contributions or its Contributor Version.
7331
73322.2. Effective Date
7333
7334The licenses granted in Section 2.1 with respect to any Contribution
7335become effective for each Contribution on the date the Contributor first
7336distributes such Contribution.
7337
73382.3. Limitations on Grant Scope
7339
7340The licenses granted in this Section 2 are the only rights granted under
7341this License. No additional rights or licenses will be implied from the
7342distribution or licensing of Covered Software under this License.
7343Notwithstanding Section 2.1(b) above, no patent license is granted by a
7344Contributor:
7345
7346(a) for any code that a Contributor has removed from Covered Software;
7347 or
7348
7349(b) for infringements caused by: (i) Your and any other third party's
7350 modifications of Covered Software, or (ii) the combination of its
7351 Contributions with other software (except as part of its Contributor
7352 Version); or
7353
7354(c) under Patent Claims infringed by Covered Software in the absence of
7355 its Contributions.
7356
7357This License does not grant any rights in the trademarks, service marks,
7358or logos of any Contributor (except as may be necessary to comply with
7359the notice requirements in Section 3.4).
7360
73612.4. Subsequent Licenses
7362
7363No Contributor makes additional grants as a result of Your choice to
7364distribute the Covered Software under a subsequent version of this
7365License (see Section 10.2) or under the terms of a Secondary License (if
7366permitted under the terms of Section 3.3).
7367
73682.5. Representation
7369
7370Each Contributor represents that the Contributor believes its
7371Contributions are its original creation(s) or it has sufficient rights
7372to grant the rights to its Contributions conveyed by this License.
7373
73742.6. Fair Use
7375
7376This License is not intended to limit any rights You have under
7377applicable copyright doctrines of fair use, fair dealing, or other
7378equivalents.
7379
73802.7. Conditions
7381
7382Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
7383in Section 2.1.
7384
73853. Responsibilities
7386-------------------
7387
73883.1. Distribution of Source Form
7389
7390All distribution of Covered Software in Source Code Form, including any
7391Modifications that You create or to which You contribute, must be under
7392the terms of this License. You must inform recipients that the Source
7393Code Form of the Covered Software is governed by the terms of this
7394License, and how they can obtain a copy of this License. You may not
7395attempt to alter or restrict the recipients' rights in the Source Code
7396Form.
7397
73983.2. Distribution of Executable Form
7399
7400If You distribute Covered Software in Executable Form then:
7401
7402(a) such Covered Software must also be made available in Source Code
7403 Form, as described in Section 3.1, and You must inform recipients of
7404 the Executable Form how they can obtain a copy of such Source Code
7405 Form by reasonable means in a timely manner, at a charge no more
7406 than the cost of distribution to the recipient; and
7407
7408(b) You may distribute such Executable Form under the terms of this
7409 License, or sublicense it under different terms, provided that the
7410 license for the Executable Form does not attempt to limit or alter
7411 the recipients' rights in the Source Code Form under this License.
7412
74133.3. Distribution of a Larger Work
7414
7415You may create and distribute a Larger Work under terms of Your choice,
7416provided that You also comply with the requirements of this License for
7417the Covered Software. If the Larger Work is a combination of Covered
7418Software with a work governed by one or more Secondary Licenses, and the
7419Covered Software is not Incompatible With Secondary Licenses, this
7420License permits You to additionally distribute such Covered Software
7421under the terms of such Secondary License(s), so that the recipient of
7422the Larger Work may, at their option, further distribute the Covered
7423Software under the terms of either this License or such Secondary
7424License(s).
7425
74263.4. Notices
7427
7428You may not remove or alter the substance of any license notices
7429(including copyright notices, patent notices, disclaimers of warranty,
7430or limitations of liability) contained within the Source Code Form of
7431the Covered Software, except that You may alter any license notices to
7432the extent required to remedy known factual inaccuracies.
7433
74343.5. Application of Additional Terms
7435
7436You may choose to offer, and to charge a fee for, warranty, support,
7437indemnity or liability obligations to one or more recipients of Covered
7438Software. However, You may do so only on Your own behalf, and not on
7439behalf of any Contributor. You must make it absolutely clear that any
7440such warranty, support, indemnity, or liability obligation is offered by
7441You alone, and You hereby agree to indemnify every Contributor for any
7442liability incurred by such Contributor as a result of warranty, support,
7443indemnity or liability terms You offer. You may include additional
7444disclaimers of warranty and limitations of liability specific to any
7445jurisdiction.
7446
74474. Inability to Comply Due to Statute or Regulation
7448---------------------------------------------------
7449
7450If it is impossible for You to comply with any of the terms of this
7451License with respect to some or all of the Covered Software due to
7452statute, judicial order, or regulation then You must: (a) comply with
7453the terms of this License to the maximum extent possible; and (b)
7454describe the limitations and the code they affect. Such description must
7455be placed in a text file included with all distributions of the Covered
7456Software under this License. Except to the extent prohibited by statute
7457or regulation, such description must be sufficiently detailed for a
7458recipient of ordinary skill to be able to understand it.
7459
74605. Termination
7461--------------
7462
74635.1. The rights granted under this License will terminate automatically
7464if You fail to comply with any of its terms. However, if You become
7465compliant, then the rights granted under this License from a particular
7466Contributor are reinstated (a) provisionally, unless and until such
7467Contributor explicitly and finally terminates Your grants, and (b) on an
7468ongoing basis, if such Contributor fails to notify You of the
7469non-compliance by some reasonable means prior to 60 days after You have
7470come back into compliance. Moreover, Your grants from a particular
7471Contributor are reinstated on an ongoing basis if such Contributor
7472notifies You of the non-compliance by some reasonable means, this is the
7473first time You have received notice of non-compliance with this License
7474from such Contributor, and You become compliant prior to 30 days after
7475Your receipt of the notice.
7476
74775.2. If You initiate litigation against any entity by asserting a patent
7478infringement claim (excluding declaratory judgment actions,
7479counter-claims, and cross-claims) alleging that a Contributor Version
7480directly or indirectly infringes any patent, then the rights granted to
7481You by any and all Contributors for the Covered Software under Section
74822.1 of this License shall terminate.
7483
74845.3. In the event of termination under Sections 5.1 or 5.2 above, all
7485end user license agreements (excluding distributors and resellers) which
7486have been validly granted by You or Your distributors under this License
7487prior to termination shall survive termination.
7488
7489************************************************************************
7490* *
7491* 6. Disclaimer of Warranty *
7492* ------------------------- *
7493* *
7494* Covered Software is provided under this License on an "as is" *
7495* basis, without warranty of any kind, either expressed, implied, or *
7496* statutory, including, without limitation, warranties that the *
7497* Covered Software is free of defects, merchantable, fit for a *
7498* particular purpose or non-infringing. The entire risk as to the *
7499* quality and performance of the Covered Software is with You. *
7500* Should any Covered Software prove defective in any respect, You *
7501* (not any Contributor) assume the cost of any necessary servicing, *
7502* repair, or correction. This disclaimer of warranty constitutes an *
7503* essential part of this License. No use of any Covered Software is *
7504* authorized under this License except under this disclaimer. *
7505* *
7506************************************************************************
7507
7508************************************************************************
7509* *
7510* 7. Limitation of Liability *
7511* -------------------------- *
7512* *
7513* Under no circumstances and under no legal theory, whether tort *
7514* (including negligence), contract, or otherwise, shall any *
7515* Contributor, or anyone who distributes Covered Software as *
7516* permitted above, be liable to You for any direct, indirect, *
7517* special, incidental, or consequential damages of any character *
7518* including, without limitation, damages for lost profits, loss of *
7519* goodwill, work stoppage, computer failure or malfunction, or any *
7520* and all other commercial damages or losses, even if such party *
7521* shall have been informed of the possibility of such damages. This *
7522* limitation of liability shall not apply to liability for death or *
7523* personal injury resulting from such party's negligence to the *
7524* extent applicable law prohibits such limitation. Some *
7525* jurisdictions do not allow the exclusion or limitation of *
7526* incidental or consequential damages, so this exclusion and *
7527* limitation may not apply to You. *
7528* *
7529************************************************************************
7530
75318. Litigation
7532-------------
7533
7534Any litigation relating to this License may be brought only in the
7535courts of a jurisdiction where the defendant maintains its principal
7536place of business and such litigation shall be governed by laws of that
7537jurisdiction, without reference to its conflict-of-law provisions.
7538Nothing in this Section shall prevent a party's ability to bring
7539cross-claims or counter-claims.
7540
75419. Miscellaneous
7542----------------
7543
7544This License represents the complete agreement concerning the subject
7545matter hereof. If any provision of this License is held to be
7546unenforceable, such provision shall be reformed only to the extent
7547necessary to make it enforceable. Any law or regulation which provides
7548that the language of a contract shall be construed against the drafter
7549shall not be used to construe this License against a Contributor.
7550
755110. Versions of the License
7552---------------------------
7553
755410.1. New Versions
7555
7556Mozilla Foundation is the license steward. Except as provided in Section
755710.3, no one other than the license steward has the right to modify or
7558publish new versions of this License. Each version will be given a
7559distinguishing version number.
7560
756110.2. Effect of New Versions
7562
7563You may distribute the Covered Software under the terms of the version
7564of the License under which You originally received the Covered Software,
7565or under the terms of any subsequent version published by the license
7566steward.
7567
756810.3. Modified Versions
7569
7570If you create software not governed by this License, and you want to
7571create a new license for such software, you may create and use a
7572modified version of this License if you rename the license and remove
7573any references to the name of the license steward (except to note that
7574such modified license differs from this License).
7575
757610.4. Distributing Source Code Form that is Incompatible With Secondary
7577Licenses
7578
7579If You choose to distribute Source Code Form that is Incompatible With
7580Secondary Licenses under the terms of this version of the License, the
7581notice described in Exhibit B of this License must be attached.
7582
7583Exhibit A - Source Code Form License Notice
7584-------------------------------------------
7585
7586 This Source Code Form is subject to the terms of the Mozilla Public
7587 License, v. 2.0. If a copy of the MPL was not distributed with this
7588 file, You can obtain one at http://mozilla.org/MPL/2.0/.
7589
7590If it is not possible or desirable to put the notice in a particular
7591file, then You may include the notice in a location (such as a LICENSE
7592file in a relevant directory) where a recipient would be likely to look
7593for such a notice.
7594
7595You may add additional accurate notices of copyright ownership.
7596
7597Exhibit B - "Incompatible With Secondary Licenses" Notice
7598---------------------------------------------------------
7599
7600 This Source Code Form is "Incompatible With Secondary Licenses", as
7601 defined by the Mozilla Public License, v. 2.0.
7602</programlisting></para></section>
7603
7604<section id="lic_34">
7605<title>NTP</title>
7606<para><programlisting>
7607
7608NTP License (NTP)
7609
7610Copyright (c) (CopyrightHoldersName) (From 4-digit-year)-(To 4-digit-year)
7611
7612Permission to use, copy, modify, and distribute this software and its documentation
7613for any purpose with or without fee is hereby granted, provided that the above
7614copyright notice appears in all copies and that both the copyright notice and this
7615permission notice appear in supporting documentation, and that the name
7616(TrademarkedName) not be used in advertising or publicity pertaining to distribution
7617of the software without specific, written prior permission. (TrademarkedName) makes no
7618representations about the suitability this software for any purpose. It is provided
7619"as is" without express or implied warranty.
7620
7621</programlisting></para></section>
7622
7623<section id="lic_35">
7624<title>OpenSSL</title>
7625<para><programlisting>
7626
7627OpenSSL License
7628
7629 ====================================================================
7630 Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved.
7631
7632 Redistribution and use in source and binary forms, with or without
7633 modification, are permitted provided that the following conditions
7634 are met:
7635
7636 1. Redistributions of source code must retain the above copyright
7637 notice, this list of conditions and the following disclaimer.
7638
7639 2. Redistributions in binary form must reproduce the above copyright
7640 notice, this list of conditions and the following disclaimer in
7641 the documentation and/or other materials provided with the
7642 distribution.
7643
7644 3. All advertising materials mentioning features or use of this
7645 software must display the following acknowledgment:
7646 "This product includes software developed by the OpenSSL Project
7647 for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
7648
7649 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
7650 endorse or promote products derived from this software without
7651 prior written permission. For written permission, please contact
7652 openssl-core@openssl.org.
7653
7654 5. Products derived from this software may not be called "OpenSSL"
7655 nor may "OpenSSL" appear in their names without prior written
7656 permission of the OpenSSL Project.
7657
7658 6. Redistributions of any form whatsoever must retain the following
7659 acknowledgment:
7660 "This product includes software developed by the OpenSSL Project
7661 for use in the OpenSSL Toolkit (http://www.openssl.org/)"
7662
7663 THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS`` AND ANY
7664 EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
7665 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
7666 PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
7667 ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
7668 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
7669 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
7670 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
7671 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
7672 STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
7673 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
7674 OF THE POSSIBILITY OF SUCH DAMAGE.
7675 ====================================================================
7676
7677 This product includes cryptographic software written by Eric Young
7678 (eay@cryptsoft.com). This product includes software written by Tim
7679 Hudson (tjh@cryptsoft.com).
7680
7681
7682 Original SSLeay License
7683 -----------------------
7684
7685Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
7686All rights reserved.
7687
7688 This package is an SSL implementation written
7689 by Eric Young (eay@cryptsoft.com).
7690 The implementation was written so as to conform with Netscapes SSL.
7691
7692 This library is free for commercial and non-commercial use as long as
7693 the following conditions are aheared to. The following conditions
7694 apply to all code found in this distribution, be it the RC4, RSA,
7695 lhash, DES, etc., code; not just the SSL code. The SSL documentation
7696 included with this distribution is covered by the same copyright terms
7697 except that the holder is Tim Hudson (tjh@cryptsoft.com).
7698
7699 Copyright remains Eric Young`s, and as such any Copyright notices in
7700 the code are not to be removed.
7701 If this package is used in a product, Eric Young should be given attribution
7702 as the author of the parts of the library used.
7703 This can be in the form of a textual message at program startup or
7704 in documentation (online or textual) provided with the package.
7705
7706 Redistribution and use in source and binary forms, with or without
7707 modification, are permitted provided that the following conditions
7708 are met:
7709 1. Redistributions of source code must retain the copyright
7710 notice, this list of conditions and the following disclaimer.
7711 2. Redistributions in binary form must reproduce the above copyright
7712 notice, this list of conditions and the following disclaimer in the
7713 documentation and/or other materials provided with the distribution.
7714 3. All advertising materials mentioning features or use of this software
7715 must display the following acknowledgement:
7716 "This product includes cryptographic software written by
7717 Eric Young (eay@cryptsoft.com)"
7718 The word `cryptographic` can be left out if the rouines from the library
7719 being used are not cryptographic related :-).
7720 4. If you include any Windows specific code (or a derivative thereof) from
7721 the apps directory (application code) you must include an acknowledgement:
7722 "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
7723
7724 THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS`` AND ANY EXPRESS OR IMPLIED
7725WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
7726AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR
7727CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
7728CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
7729OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
7730HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
7731OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
7732SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
7733
7734 The licence and distribution terms for any publically available version or
7735derivative of this code cannot be changed. i.e. this code cannot simply be copied and
7736put under another distribution licence
7737 [including the GNU Public Licence.]
7738
7739
7740
7741
7742</programlisting></para></section>
7743
7744<section id="lic_36">
7745<title>PD</title>
7746<para><programlisting>
7747This is a placeholder for the Public Domain License
7748</programlisting></para></section>
7749
7750<section id="lic_37">
7751<title>Python-2.0</title>
7752<para><programlisting>
7753
7754PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
7755--------------------------------------------
7756
77571. This LICENSE AGREEMENT is between the Python Software Foundation
7758("PSF"), and the Individual or Organization ("Licensee") accessing and
7759otherwise using this software ("Python") in source or binary form and
7760its associated documentation.
7761
77622. Subject to the terms and conditions of this License Agreement, PSF
7763hereby grants Licensee a nonexclusive, royalty-free, world-wide
7764license to reproduce, analyze, test, perform and/or display publicly,
7765prepare derivative works, distribute, and otherwise use Python
7766alone or in any derivative version, provided, however, that PSF`s
7767License Agreement and PSF`s notice of copyright, i.e., "Copyright (c)
77682001, 2002, 2003, 2004, 2005, 2006 Python Software Foundation; All Rights
7769Reserved" are retained in Python alone or in any derivative version
7770prepared by Licensee.
7771
77723. In the event Licensee prepares a derivative work that is based on
7773or incorporates Python or any part thereof, and wants to make
7774the derivative work available to others as provided herein, then
7775Licensee hereby agrees to include in any such work a brief summary of
7776the changes made to Python.
7777
77784. PSF is making Python available to Licensee on an "AS IS"
7779basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
7780IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
7781DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
7782FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
7783INFRINGE ANY THIRD PARTY RIGHTS.
7784
77855. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
7786FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
7787A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
7788OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
7789
77906. This License Agreement will automatically terminate upon a material
7791breach of its terms and conditions.
7792
77937. Nothing in this License Agreement shall be deemed to create any
7794relationship of agency, partnership, or joint venture between PSF and
7795Licensee. This License Agreement does not grant permission to use PSF
7796trademarks or trade name in a trademark sense to endorse or promote
7797products or services of Licensee, or any third party.
7798
77998. By copying, installing or otherwise using Python, Licensee
7800agrees to be bound by the terms and conditions of this License
7801Agreement.
7802
7803BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0
7804-------------------------------------------
7805
7806BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1
7807
78081. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an
7809office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the
7810Individual or Organization ("Licensee") accessing and otherwise using
7811this software in source or binary form and its associated
7812documentation ("the Software").
7813
78142. Subject to the terms and conditions of this BeOpen Python License
7815Agreement, BeOpen hereby grants Licensee a non-exclusive,
7816royalty-free, world-wide license to reproduce, analyze, test, perform
7817and/or display publicly, prepare derivative works, distribute, and
7818otherwise use the Software alone or in any derivative version,
7819provided, however, that the BeOpen Python License is retained in the
7820Software, alone or in any derivative version prepared by Licensee.
7821
78223. BeOpen is making the Software available to Licensee on an "AS IS"
7823basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
7824IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND
7825DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
7826FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT
7827INFRINGE ANY THIRD PARTY RIGHTS.
7828
78294. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE
7830SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
7831AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY
7832DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
7833
78345. This License Agreement will automatically terminate upon a material
7835breach of its terms and conditions.
7836
78376. This License Agreement shall be governed by and interpreted in all
7838respects by the law of the State of California, excluding conflict of
7839law provisions. Nothing in this License Agreement shall be deemed to
7840create any relationship of agency, partnership, or joint venture
7841between BeOpen and Licensee. This License Agreement does not grant
7842permission to use BeOpen trademarks or trade names in a trademark
7843sense to endorse or promote products or services of Licensee, or any
7844third party. As an exception, the "BeOpen Python" logos available at
7845http://www.pythonlabs.com/logos.html may be used according to the
7846permissions granted on that web page.
7847
78487. By copying, installing or otherwise using the software, Licensee
7849agrees to be bound by the terms and conditions of this License
7850Agreement.
7851
7852CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1
7853---------------------------------------
7854
78551. This LICENSE AGREEMENT is between the Corporation for National
7856Research Initiatives, having an office at 1895 Preston White Drive,
7857Reston, VA 20191 ("CNRI"), and the Individual or Organization
7858("Licensee") accessing and otherwise using Python 1.6.1 software in
7859source or binary form and its associated documentation.
7860
78612. Subject to the terms and conditions of this License Agreement, CNRI
7862hereby grants Licensee a nonexclusive, royalty-free, world-wide
7863license to reproduce, analyze, test, perform and/or display publicly,
7864prepare derivative works, distribute, and otherwise use Python 1.6.1
7865alone or in any derivative version, provided, however, that CNRI`s
7866License Agreement and CNRI`s notice of copyright, i.e., "Copyright (c)
78671995-2001 Corporation for National Research Initiatives; All Rights
7868Reserved" are retained in Python 1.6.1 alone or in any derivative
7869version prepared by Licensee. Alternately, in lieu of CNRI`s License
7870Agreement, Licensee may substitute the following text (omitting the
7871quotes): "Python 1.6.1 is made available subject to the terms and
7872conditions in CNRI`s License Agreement. This Agreement together with
7873Python 1.6.1 may be located on the Internet using the following
7874unique, persistent identifier (known as a handle): 1895.22/1013. This
7875Agreement may also be obtained from a proxy server on the Internet
7876using the following URL: http://hdl.handle.net/1895.22/1013".
7877
78783. In the event Licensee prepares a derivative work that is based on
7879or incorporates Python 1.6.1 or any part thereof, and wants to make
7880the derivative work available to others as provided herein, then
7881Licensee hereby agrees to include in any such work a brief summary of
7882the changes made to Python 1.6.1.
7883
78844. CNRI is making Python 1.6.1 available to Licensee on an "AS IS"
7885basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
7886IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND
7887DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
7888FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT
7889INFRINGE ANY THIRD PARTY RIGHTS.
7890
78915. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
78921.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
7893A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1,
7894OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
7895
78966. This License Agreement will automatically terminate upon a material
7897breach of its terms and conditions.
7898
78997. This License Agreement shall be governed by the federal
7900intellectual property law of the United States, including without
7901limitation the federal copyright law, and, to the extent such
7902U.S. federal law does not apply, by the law of the Commonwealth of
7903Virginia, excluding Virginia`s conflict of law provisions.
7904Notwithstanding the foregoing, with regard to derivative works based
7905on Python 1.6.1 that incorporate non-separable material that was
7906previously distributed under the GNU General Public License (GPL), the
7907law of the Commonwealth of Virginia shall govern this License
7908Agreement only as to issues arising under or with respect to
7909Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this
7910License Agreement shall be deemed to create any relationship of
7911agency, partnership, or joint venture between CNRI and Licensee. This
7912License Agreement does not grant permission to use CNRI trademarks or
7913trade name in a trademark sense to endorse or promote products or
7914services of Licensee, or any third party.
7915
79168. By clicking on the "ACCEPT" button where indicated, or by copying,
7917installing or otherwise using Python 1.6.1, Licensee agrees to be
7918bound by the terms and conditions of this License Agreement.
7919
7920ACCEPT
7921
7922CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2
7923--------------------------------------------------
7924
7925Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam,
7926The Netherlands. All rights reserved.
7927
7928Permission to use, copy, modify, and distribute this software and its
7929documentation for any purpose and without fee is hereby granted,
7930provided that the above copyright notice appear in all copies and that
7931both that copyright notice and this permission notice appear in
7932supporting documentation, and that the name of Stichting Mathematisch
7933Centrum or CWI not be used in advertising or publicity pertaining to
7934distribution of the software without specific, written prior
7935permission.
7936
7937STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
7938THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
7939FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
7940FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
7941WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
7942ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
7943OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
7944
7945</programlisting></para></section>
7946
7947<section id="lic_38">
7948<title>SAX-PD</title>
7949<para><programlisting>
7950
7951Copyright Status for SAX
7952
7953SAX is free!
7954
7955In fact, it`s not possible to own a license to SAX, since it`s been placed in the
7956public domain.
7957
7958No Warranty
7959
7960Because SAX is released to the public domain, there is no warranty for the design or
7961for the software implementation, to the extent permitted by applicable law. Except
7962when otherwise stated in writing the copyright holders and/or other parties provide
7963SAX "as is" without warranty of any kind, either expressed or implied, including, but
7964not limited to, the implied warranties of merchantability and fitness for a particular
7965purpose. The entire risk as to the quality and performance of SAX is with you. Should
7966SAX prove defective, you assume the cost of all necessary servicing, repair or
7967correction.
7968
7969In no event unless required by applicable law or agreed to in writing will any
7970copyright holder, or any other party who may modify and/or redistribute SAX, be liable
7971to you for damages, including any general, special, incidental or consequential
7972damages arising out of the use or inability to use SAX (including but not limited to
7973loss of data or data being rendered inaccurate or losses sustained by you or third
7974parties or a failure of the SAX to operate with any other programs), even if such
7975holder or other party has been advised of the possibility of such damages.
7976
7977Copyright Disclaimers
7978
7979This page includes statements to that effect by David Megginson, who would have been
7980able to claim copyright for the original work.
7981
7982SAX 1.0
7983
7984Version 1.0 of the Simple API for XML (SAX), created collectively by the membership of
7985the XML-DEV mailing list, is hereby released into the public domain.
7986
7987No one owns SAX: you may use it freely in both commercial and non-commercial
7988applications, bundle it with your software distribution, include it on a CD-ROM, list
7989the source code in a book, mirror the documentation at your own web site, or use it in
7990any other way you see fit.
7991
7992David Megginson, Megginson Technologies Ltd.
79931998-05-11
7994
7995SAX 2.0
7996
7997I hereby abandon any property rights to SAX 2.0 (the Simple API for XML), and release
7998all of the SAX 2.0 source code, compiled code, and documentation contained in this
7999distribution into the Public Domain. SAX comes with NO WARRANTY or guarantee of
8000fitness for any purpose.
8001
8002David Megginson, Megginson Technologies Ltd.
80032000-05-05
8004
8005</programlisting></para></section>
8006
8007<section id="lic_39">
8008<title>SMAIL_GPL</title>
8009<para><programlisting>
8010This is the Debian GNU/Linux package debianutils.
8011
8012It is an original Debian package. Programs in it were maintained by
8013Guy Maor &lt;maor@debian.org&gt;, and are now maintained by Clint Adams
8014&lt;schizo@debian.org&gt;.
8015
8016All its programs except readlink, savelog, and which may be
8017redistributed under the terms of the GNU GPL, Version 2 or later,
8018found on Debian systems in the file /usr/share/common-licenses/GPL.
8019
8020which is in the public domain.
8021
8022readlink is Copyright (c) 1997 Kenneth Stailey, and may also be
8023distributed under the terms of the BSD copyright.
8024
8025savelog may be redistributed under the following terms: (The rest of
8026this file consists of savelog's distribution terms.)
8027
8028#ident "@(#)smail:RELEASE-3_2:COPYING,v 1.2 1996/06/14 18:59:10 woods Exp"
8029
8030 SMAIL GENERAL PUBLIC LICENSE
8031 (Clarified 11 Feb 1988)
8032
8033 Copyright (C) 1988 Landon Curt Noll &amp; Ronald S. Karr
8034 Copyright (C) 1992 Ronald S. Karr
8035 Copyleft (GNU) 1988 Landon Curt Noll &amp; Ronald S. Karr
8036
8037 Everyone is permitted to copy and distribute verbatim copies
8038 of this license, but changing it is not allowed. You can also
8039 use this wording to make the terms for other programs.
8040
8041 The license agreements of most software companies keep you at the
8042mercy of those companies. By contrast, our general public license is
8043intended to give everyone the right to share SMAIL. To make sure that
8044you get the rights we want you to have, we need to make restrictions
8045that forbid anyone to deny you these rights or to ask you to surrender
8046the rights. Hence this license agreement.
8047
8048 Specifically, we want to make sure that you have the right to give
8049away copies of SMAIL, that you receive source code or else can get it
8050if you want it, that you can change SMAIL or use pieces of it in new
8051free programs, and that you know you can do these things.
8052
8053 To make sure that everyone has such rights, we have to forbid you to
8054deprive anyone else of these rights. For example, if you distribute
8055copies of SMAIL, you must give the recipients all the rights that you
8056have. You must make sure that they, too, receive or can get the
8057source code. And you must tell them their rights.
8058
8059 Also, for our own protection, we must make certain that everyone
8060finds out that there is no warranty for SMAIL. If SMAIL is modified by
8061someone else and passed on, we want its recipients to know that what
8062they have is not what we distributed, so that any problems introduced
8063by others will not reflect on our reputation.
8064
8065 Therefore we (Landon Curt Noll and Ronald S. Karr) make the following
8066terms which say what you must do to be allowed to distribute or change
8067SMAIL.
8068
8069
8070 COPYING POLICIES
8071
8072 1. You may copy and distribute verbatim copies of SMAIL source code
8073as you receive it, in any medium, provided that you conspicuously and
8074appropriately publish on each copy a valid copyright notice "Copyright
8075(C) 1988 Landon Curt Noll &amp; Ronald S. Karr" (or with whatever year is
8076appropriate); keep intact the notices on all files that refer to this
8077License Agreement and to the absence of any warranty; and give any
8078other recipients of the SMAIL program a copy of this License
8079Agreement along with the program. You may charge a distribution fee
8080for the physical act of transferring a copy.
8081
8082 2. You may modify your copy or copies of SMAIL or any portion of it,
8083and copy and distribute such modifications under the terms of
8084Paragraph 1 above, provided that you also do the following:
8085
8086 a) cause the modified files to carry prominent notices stating
8087 that you changed the files and the date of any change; and
8088
8089 b) cause the whole of any work that you distribute or publish,
8090 that in whole or in part contains or is a derivative of SMAIL or
8091 any part thereof, to be licensed at no charge to all third
8092 parties on terms identical to those contained in this License
8093 Agreement (except that you may choose to grant more extensive
8094 warranty protection to some or all third parties, at your option).
8095
8096 c) You may charge a distribution fee for the physical act of
8097 transferring a copy, and you may at your option offer warranty
8098 protection in exchange for a fee.
8099
8100Mere aggregation of another unrelated program with this program (or its
8101derivative) on a volume of a storage or distribution medium does not bring
8102the other program under the scope of these terms.
8103
8104 3. You may copy and distribute SMAIL (or a portion or derivative of it,
8105under Paragraph 2) in object code or executable form under the terms of
8106Paragraphs 1 and 2 above provided that you also do one of the following:
8107
8108 a) accompany it with the complete corresponding machine-readable
8109 source code, which must be distributed under the terms of
8110 Paragraphs 1 and 2 above; or,
8111
8112 b) accompany it with a written offer, valid for at least three
8113 years, to give any third party free (except for a nominal
8114 shipping charge) a complete machine-readable copy of the
8115 corresponding source code, to be distributed under the terms of
8116 Paragraphs 1 and 2 above; or,
8117
8118 c) accompany it with the information you received as to where the
8119 corresponding source code may be obtained. (This alternative is
8120 allowed only for non-commercial distribution and only if you
8121 received the program in object code or executable form alone.)
8122
8123For an executable file, complete source code means all the source code for
8124all modules it contains; but, as a special exception, it need not include
8125source code for modules which are standard libraries that accompany the
8126operating system on which the executable file runs.
8127
8128 4. You may not copy, sublicense, distribute or transfer SMAIL
8129except as expressly provided under this License Agreement. Any attempt
8130otherwise to copy, sublicense, distribute or transfer SMAIL is void and
8131your rights to use the program under this License agreement shall be
8132automatically terminated. However, parties who have received computer
8133software programs from you with this License Agreement will not have
8134their licenses terminated so long as such parties remain in full compliance.
8135
8136 5. If you wish to incorporate parts of SMAIL into other free
8137programs whose distribution conditions are different, write to Landon
8138Curt Noll &amp; Ronald S. Karr via the Free Software Foundation at 51
8139Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. We have not yet
8140worked out a simple rule that can be stated here, but we will often
8141permit this. We will be guided by the two goals of preserving the
8142free status of all derivatives of our free software and of promoting
8143the sharing and reuse of software.
8144
8145Your comments and suggestions about our licensing policies and our
8146software are welcome! This contract was based on the contract made by
8147the Free Software Foundation. Please contact the Free Software
8148Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301,
8149USA, or call (617) 542-5942 for details on copylefted material in
8150general.
8151
8152 NO WARRANTY
8153
8154 BECAUSE SMAIL IS LICENSED FREE OF CHARGE, WE PROVIDE ABSOLUTELY NO
8155WARRANTY, TO THE EXTENT PERMITTED BY APPLICABLE STATE LAW. EXCEPT WHEN
8156OTHERWISE STATED IN WRITING, LANDON CURT NOLL &amp; RONALD S. KARR AND/OR
8157OTHER PARTIES PROVIDE SMAIL "AS IS" WITHOUT WARRANTY OF ANY KIND,
8158EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
8159WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
8160THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF SMAIL IS WITH
8161YOU. SHOULD SMAIL PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
8162NECESSARY SERVICING, REPAIR OR CORRECTION.
8163
8164 IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL LANDON CURT NOLL &amp;
8165RONALD S. KARR AND/OR ANY OTHER PARTY WHO MAY MODIFY AND REDISTRIBUTE
8166SMAIL AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
8167LOST PROFITS, LOST MONIES, OR OTHER SPECIAL, INCIDENTAL OR
8168CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
8169(INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
8170INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES OR A FAILURE OF THE
8171PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS) SMAIL, EVEN IF YOU HAVE
8172BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY
8173ANY OTHER PARTY.
8174</programlisting></para></section>
8175
8176<section id="lic_40">
8177<title>SUN</title>
8178<para><programlisting>
8179SUN MICROSYSTEMS, INC. THROUGH ITS SUN MICROSYSTEMS LABORATORIES
8180DIVISION ("SUN") WILL LICENSE THIS SOFTWARE AND THE ACCOMPANYING
8181DOCUMENTATION TO YOU (a "Licensee") ONLY ON YOUR ACCEPTANCE OF ALL
8182THE TERMS SET FORTH BELOW.
8183
8184Sun grants Licensee a non-exclusive, royalty-free right to download,
8185install, compile, use, copy and distribute the Software, modify or
8186otherwise create derivative works from the Software (each, a
8187"Modification") and distribute any Modification in source code and/or
8188binary code form to its customers with a license agreement containing
8189these terms and noting that the Software has been modified. The
8190Software is copyrighted by Sun and other third parties and Licensee
8191shall retain and reproduce all copyright and other notices presently
8192on the Software. As between Sun and Licensee, Sun is the sole owner of
8193all rights in and to the Software other than the limited rights
8194granted to Licensee herein; Licensee will own its Modifications,
8195expressly subject to Sun's continuing ownership of the
8196Software. Licensee will, at its expense, defend and indemnify Sun and
8197its licensors from and against any third party claims, including costs
8198and reasonable attorneys' fees, and be wholly responsible for any
8199liabilities arising out of or related to Licensee's development, use
8200or distribution of the Software or Modifications. Any distribution of
8201the Software and Modifications must comply with all applicable United
8202States export control laws.
8203
8204THE SOFTWARE IS BEING PROVIDED TO LICENSEE "AS IS" AND ALL EXPRESS OR
8205IMPLIED CONDITIONS AND WARRANTIES, INCLUDING ANY IMPLIED WARRANTY OF
8206MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT,
8207ARE DISCLAIMED. IN NO EVENT WILL SUN BE LIABLE HEREUNDER FOR ANY
8208DIRECT DAMAGES OR ANY INDIRECT, PUNITIVE, SPECIAL, INCIDENTAL OR
8209CONSEQUENTIAL DAMAGES OF ANY KIND.
8210</programlisting></para></section>
8211
8212<section id="lic_41">
8213<title>Sleepycat</title>
8214<para><programlisting>
8215
8216The Sleepycat License
8217Copyright (c) 1990-1999
8218Sleepycat Software. All rights reserved.
8219
8220Redistribution and use in source and binary forms, with or without
8221modification, are permitted provided that the following conditions
8222are met:
8223
8224Redistributions of source code must retain the above copyright
8225notice, this list of conditions and the following disclaimer.
8226Redistributions in binary form must reproduce the above copyright
8227notice, this list of conditions and the following disclaimer in the
8228documentation and/or other materials provided with the distribution.
8229Redistributions in any form must be accompanied by information on
8230how to obtain complete source code for the DB software and any
8231accompanying software that uses the DB software. The source code
8232must either be included in the distribution or be available for no
8233more than the cost of distribution plus a nominal fee, and must be
8234freely redistributable under reasonable conditions. For an
8235executable file, complete source code means the source code for all
8236modules it contains. It does not include source code for modules or
8237files that typically accompany the major components of the operating
8238system on which the executable file runs.
8239THIS SOFTWARE IS PROVIDED BY SLEEPYCAT SOFTWARE ``AS IS`` AND ANY EXPRESS
8240OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
8241WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
8242NON-INFRINGEMENT, ARE DISCLAIMED. IN NO EVENT SHALL SLEEPYCAT SOFTWARE
8243BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
8244CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
8245SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
8246INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
8247CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
8248ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
8249THE POSSIBILITY OF SUCH DAMAGE.
8250
8251Copyright (c) 1990, 1993, 1994, 1995
8252The Regents of the University of California. All rights reserved.
8253
8254Redistribution and use in source and binary forms, with or without
8255modification, are permitted provided that the following conditions
8256are met:
8257
8258Redistributions of source code must retain the above copyright
8259notice, this list of conditions and the following disclaimer.
8260Redistributions in binary form must reproduce the above copyright
8261notice, this list of conditions and the following disclaimer in the
8262documentation and/or other materials provided with the distribution.
8263Neither the name of the University nor the names of its contributors
8264may be used to endorse or promote products derived from this software
8265without specific prior written permission.
8266THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS`` AND
8267ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
8268IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
8269ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
8270FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
8271DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
8272OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8273HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
8274LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
8275OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
8276SUCH DAMAGE.
8277
8278Copyright (c) 1995, 1996
8279The President and Fellows of Harvard University. All rights reserved.
8280
8281Redistribution and use in source and binary forms, with or without
8282modification, are permitted provided that the following conditions
8283are met:
8284
8285Redistributions of source code must retain the above copyright
8286notice, this list of conditions and the following disclaimer.
8287Redistributions in binary form must reproduce the above copyright
8288notice, this list of conditions and the following disclaimer in the
8289documentation and/or other materials provided with the distribution.
8290Neither the name of the University nor the names of its contributors
8291may be used to endorse or promote products derived from this software
8292without specific prior written permission.
8293THIS SOFTWARE IS PROVIDED BY HARVARD AND ITS CONTRIBUTORS ``AS IS`` AND
8294ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
8295IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
8296ARE DISCLAIMED. IN NO EVENT SHALL HARVARD OR ITS CONTRIBUTORS BE LIABLE
8297FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
8298DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
8299OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8300HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
8301LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
8302OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
8303SUCH DAMAGE.
8304
8305</programlisting></para></section>
8306
8307<section id="lic_42">
8308<title>UCB</title>
8309<para><programlisting>
8310 Copyright (c) 1987, 1989, 1990, 1991, 1992, 1993, 1994
8311 The Regents of the University of California. All rights reserved.
8312
8313 Redistribution and use in source and binary forms, with or without
8314 modification, are permitted provided that the following conditions
8315 are met:
8316 1. Redistributions of source code must retain the above copyright
8317 notice, this list of conditions and the following disclaimer.
8318 2. Redistributions in binary form must reproduce the above copyright
8319 notice, this list of conditions and the following disclaimer in the
8320 documentation and/or other materials provided with the distribution.
8321 3. Neither the name of the University nor the names of its contributors
8322 may be used to endorse or promote products derived from this software
8323 without specific prior written permission.
8324
8325 THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
8326 ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
8327 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
8328 ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
8329 FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
8330 DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
8331 OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8332 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
8333 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
8334 OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
8335 SUCH DAMAGE.
8336</programlisting></para></section>
8337
8338<section id="lic_43">
8339<title>Unicode</title>
8340<para><programlisting>
8341COPYRIGHT AND PERMISSION NOTICE
8342
8343Copyright 1991-2015 Unicode, Inc. All rights reserved.
8344Distributed under the Terms of Use in
8345http://www.unicode.org/copyright.html.
8346
8347Permission is hereby granted, free of charge, to any person obtaining
8348a copy of the Unicode data files and any associated documentation
8349(the "Data Files") or Unicode software and any associated documentation
8350(the "Software") to deal in the Data Files or Software
8351without restriction, including without limitation the rights to use,
8352copy, modify, merge, publish, distribute, and/or sell copies of
8353the Data Files or Software, and to permit persons to whom the Data Files
8354or Software are furnished to do so, provided that
8355(a) this copyright and permission notice appear with all copies
8356of the Data Files or Software,
8357(b) this copyright and permission notice appear in associated
8358documentation, and
8359(c) there is clear notice in each modified Data File or in the Software
8360as well as in the documentation associated with the Data File(s) or
8361Software that the data or software has been modified.
8362
8363THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF
8364ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
8365WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
8366NONINFRINGEMENT OF THIRD PARTY RIGHTS.
8367IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS
8368NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL
8369DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
8370DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
8371TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
8372PERFORMANCE OF THE DATA FILES OR SOFTWARE.
8373
8374Except as contained in this notice, the name of a copyright holder
8375shall not be used in advertising or otherwise to promote the sale,
8376use or other dealings in these Data Files or Software without prior
8377written authorization of the copyright holder.
8378</programlisting></para></section>
8379
8380<section id="lic_44">
8381<title>W3C</title>
8382<para><programlisting>
8383
8384W3C SOFTWARE NOTICE AND LICENSE
8385This work (and included software, documentation such as READMEs, or other related
8386items) is being provided by the copyright holders under the following license.
8387License
8388By obtaining, using and/or copying this work, you (the licensee) agree that you have
8389read, understood, and will comply with the following terms and conditions.
8390Permission to copy, modify, and distribute this software and its documentation, with
8391or without modification, for any purpose and without fee or royalty is hereby granted,
8392provided that you include the following on ALL copies of the software and
8393documentation or portions thereof, including modifications:
8394The full text of this NOTICE in a location viewable to users of the redistributed or
8395derivative work.
8396Any pre-existing intellectual property disclaimers, notices, or terms and conditions.
8397If none exist, the W3C Software Short Notice should be included (hypertext is
8398preferred, text is permitted) within the body of any redistributed or derivative code.
8399Notice of any changes or modifications to the files, including the date changes were
8400made. (We recommend you provide URIs to the location from which the code is derived.)
8401Disclaimers
8402THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO
8403REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO,
8404WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF
8405THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS,
8406TRADEMARKS OR OTHER RIGHTS.
8407COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
8408CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
8409The name and trademarks of copyright holders may NOT be used in advertising or
8410publicity pertaining to the software without specific, written prior permission. Title
8411to copyright in this software and any associated documentation will at all times
8412remain with copyright holders.
8413Notes
8414This version: http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231
8415This formulation of W3C`s notice and license became active on December 31 2002. This
8416version removes the copyright ownership notice such that this license can be used with
8417materials other than those owned by the W3C, reflects that ERCIM is now a host of the
8418W3C, includes references to this specific dated version of the license, and removes
8419the ambiguous grant of "use". Otherwise, this version is the same as the previous
8420version and is written so as to preserve the Free Software Foundation`s assessment of
8421GPL compatibility and OSI`s certification under the Open Source Definition.
8422
8423</programlisting></para></section>
8424
8425<section id="lic_45">
8426<title>ZPL-2.1</title>
8427<para><programlisting>
8428
8429ZPL 2.1
8430Zope Public License (ZPL) Version 2.1
8431
8432A copyright notice accompanies this license document that identifies the copyright
8433holders.
8434
8435This license has been certified as open source. It has also been designated as GPL
8436compatible by the Free Software Foundation (FSF).
8437
8438Redistribution and use in source and binary forms, with or without modification, are
8439permitted provided that the following conditions are met:
8440
8441Redistributions in source code must retain the accompanying copyright notice, this
8442list of conditions, and the following disclaimer.
8443Redistributions in binary form must reproduce the accompanying copyright notice, this
8444list of conditions, and the following disclaimer in the documentation and/or other
8445materials provided with the distribution.
8446Names of the copyright holders must not be used to endorse or promote products derived
8447from this software without prior written permission from the copyright holders.
8448The right to distribute this software or to use it for any purpose does not give you
8449the right to use Servicemarks (sm) or Trademarks (tm) of the copyright holders. Use of
8450them is covered by separate agreement with the copyright holders.
8451If any files are modified, you must cause the modified files to carry prominent
8452notices stating that you changed the files and the date of any change.
8453Disclaimer
8454THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS`` AND ANY EXPRESSED OR
8455IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
8456MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
8457THE COPYRIGHT HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
8458EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
8459SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
8460HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
8461OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
8462SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
8463
8464</programlisting></para></section>
8465
8466<section id="lic_46">
8467<title>Zlib</title>
8468<para><programlisting>
8469
8470zlib License
8471
8472
8473 This software is provided `as-is`, without any express or implied
8474 warranty. In no event will the authors be held liable for any damages
8475 arising from the use of this software.
8476
8477 Permission is granted to anyone to use this software for any purpose,
8478 including commercial applications, and to alter it and redistribute it
8479 freely, subject to the following restrictions:
8480
8481 1. The origin of this software must not be misrepresented; you must not
8482 claim that you wrote the original software. If you use this software
8483 in a product, an acknowledgment in the product documentation would be
8484 appreciated but is not required.
8485 2. Altered source versions must be plainly marked as such, and must not be
8486 misrepresented as being the original software.
8487 3. This notice may not be removed or altered from any source distribution.
8488
8489
8490</programlisting></para></section>
8491
8492<section id="lic_47">
8493<title>tcl</title>
8494<para><programlisting>
8495This software is copyrighted by the Regents of the University of
8496California, Sun Microsystems, Inc., Scriptics Corporation, ActiveState
8497Corporation and other parties. The following terms apply to all files
8498associated with the software unless explicitly disclaimed in
8499individual files.
8500
8501The authors hereby grant permission to use, copy, modify, distribute,
8502and license this software and its documentation for any purpose, provided
8503that existing copyright notices are retained in all copies and that this
8504notice is included verbatim in any distributions. No written agreement,
8505license, or royalty fee is required for any of the authorized uses.
8506Modifications to this software may be copyrighted by their authors
8507and need not follow the licensing terms described here, provided that
8508the new terms are clearly indicated on the first page of each file where
8509they apply.
8510
8511IN NO EVENT SHALL THE AUTHORS OR DISTRIBUTORS BE LIABLE TO ANY PARTY
8512FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
8513ARISING OUT OF THE USE OF THIS SOFTWARE, ITS DOCUMENTATION, OR ANY
8514DERIVATIVES THEREOF, EVEN IF THE AUTHORS HAVE BEEN ADVISED OF THE
8515POSSIBILITY OF SUCH DAMAGE.
8516
8517THE AUTHORS AND DISTRIBUTORS SPECIFICALLY DISCLAIM ANY WARRANTIES,
8518INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY,
8519FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. THIS SOFTWARE
8520IS PROVIDED ON AN "AS IS" BASIS, AND THE AUTHORS AND DISTRIBUTORS HAVE
8521NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR
8522MODIFICATIONS.
8523
8524GOVERNMENT USE: If you are acquiring this software on behalf of the
8525U.S. government, the Government shall have only "Restricted Rights"
8526in the software and related documentation as defined in the Federal
8527Acquisition Regulations (FARs) in Clause 52.227.19 (c) (2). If you
8528are acquiring the software on behalf of the Department of Defense, the
8529software shall be classified as "Commercial Computer Software" and the
8530Government shall have only "Restricted Rights" as defined in Clause
8531252.227-7014 (b) (3) of DFARs. Notwithstanding the foregoing, the
8532authors grant the U.S. Government and others acting in its behalf
8533permission to use and distribute the software in accordance with the
8534terms specified in this license.
8535</programlisting></para></section>
8536
8537 </section>
8538 <section id="proprietary_license">
8539 <title>Proprietary Licenses</title>
8540<section id="lic_48">
8541<title>Enea</title>
8542<para><programlisting>
8543 Copyright (C) 2006 by Enea.
8544 All rights reserved.
8545
8546 This Software is furnished under a software license agreement and
8547 may be used only in accordance with the terms of such agreement.
8548 Any other use or reproduction is prohibited. No title to and
8549 ownership of the Software is hereby transferred.
8550
8551 PROPRIETARY NOTICE
8552 This Software consists of confidential information.
8553 Trade secret law and copyright law protect this Software.
8554 The above notice of copyright on this Software does not indicate
8555 any actual or intended publication of such Software.
8556</programlisting></para></section>
8557
8558<section id="lic_49">
8559<title>Windbase</title>
8560<para><programlisting>
8561This file contains valuable trade secrets and proprietary
8562assets of Windbase Software Inc. Embodying substantial
8563creative efforts and confidential information. Unauthorized
8564use, copying, decompiling, translating, disclosure or
8565transfer, of any kind, is strictly prohibited.
8566
8567
8568COPYRIGHT (C) 1992, 1993, 1994. Windbase Software Inc.
8569ALL RIGHTS RESERVED.
8570</programlisting></para></section>
8571
8572 </section>
8573</chapter>
diff --git a/doc/book-enea-nfv-access-sdk-open-source/swcomp.mk b/doc/book-enea-nfv-access-sdk-open-source/swcomp.mk
deleted file mode 100644
index 6034736..0000000
--- a/doc/book-enea-nfv-access-sdk-open-source/swcomp.mk
+++ /dev/null
@@ -1,12 +0,0 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-access-open-source
9BOOKPACKAGES := book-enea-nfv-access-esdk-open-source
10BOOKPACKAGES := book-enea-nfv-access-sdk-open-source
11BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access Open Source Report"
12BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/book.xml b/doc/book-enea-nfv-access-user-hardening-guide/doc/book.xml
deleted file mode 100644
index fe6b11f..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/book.xml
+++ /dev/null
@@ -1,18 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
5]>
6<book id="book_enea_nfv_access_user_hardening_guide">
7 <title><trademark class="registered">Enea</trademark> NFV Access User's Hardening Guide</title>
8
9 <subtitle>Release Version <xi:include href="eltf_params_updated.xml"
10 xmlns:xi="http://www.w3.org/2001/XInclude"
11 xpointer="element(EneaLinux_REL_VER/1)" /></subtitle>
12 <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb -->
13 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
14 <xi:include href="introduction.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
15 <xi:include href="intro_info_security.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
16 <xi:include href="guidelines_hardening_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
17 <xi:include href="intro_hardentools_tech.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
18</book> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_template.xml b/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_template.xml
deleted file mode 100644
index eaa7ebd..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_template.xml
+++ /dev/null
@@ -1,151 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting>ELTF_PL_HOST_PREREQ</programlisting></para>
26
27 <bridgehead>A programlisting, ID
28 "eltf-getting-repo-install-command"</bridgehead>
29
30 <para id="eltf-getting-repo-install-command"><programlisting>ELTF_PL_GET_REPO</programlisting></para>
31
32 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
33 correct also compared to the "previous" REL VER in pardoc-distro.xml
34 "prev_baseline".</bridgehead>
35
36 <para id="EneaLinux_REL_VER"><phrase>ELTF_EL_REL_VER</phrase></para>
37
38 <para id="Yocto_VER"><phrase>ELTF_YOCTO_VER</phrase></para>
39
40 <para id="Yocto_NAME"><phrase>ELTF_YOCTO_NAME</phrase></para>
41
42 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
43 url="ELTF_YOCTO_PROJ_DOWNLOAD_URL">ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL</ulink></para>
44
45 <para id="ULINK_ENEA_LINUX_URL"><ulink
46 url="ELTF_EL_DOWNLOAD_URL">ELTF_EL_DOWNLOAD_TXTURL</ulink></para>
47
48 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
49 $MACHINE/default.xml as parameter, where MACHINE is one of the target
50 directory names in the manifest.</bridgehead>
51
52 <para id="eltf-repo-cloning-enea-linux"><programlisting>ELTF_PL_CLONE_W_REPO</programlisting></para>
53
54 <bridgehead>A table with ONE row, only the row with ID
55 "eltf-eclipse-version-row" is included in the book. MANUALLY BOTH in the
56 template.xml and in the updated.xml, set condition hidden on the
57 &lt;row&gt;, if eclipse is not in the release.</bridgehead>
58
59 <informaltable>
60 <tgroup cols="1">
61 <tbody>
62 <row id="eltf-eclipse-version-row">
63 <entry>Eclipse version ELTF_ECLIPSE_VERSION plus command line
64 development tools are included in this Enea NFV Access release.</entry>
65 </row>
66 </tbody>
67 </tgroup>
68 </informaltable>
69
70 <bridgehead>Below is one big section with title "Supported Targets with
71 Parameters". The entire section is included completely in the book via ID
72 "eltf-target-tables-section" and shall be LAST in the template. The
73 template contains ONE target subsection. COPY/APPEND it, if multiple
74 targets exist in the release and optionally add rows with additional
75 target parameters in each target subsection table.</bridgehead>
76 </section>
77
78 <section id="eltf-target-tables-section">
79 <title>Supported Targets with Parameters</title>
80
81 <para>The tables below describes the target(s) supported in this Enea
82 NFV Access release.</para>
83
84 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
85 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
86
87 <para><informaltable>
88 <tgroup cols="2">
89 <colspec colwidth="6*" />
90
91 <colspec colwidth="9*" />
92
93 <tbody>
94 <row>
95 <entry>Target official name</entry>
96
97 <entry>ELTF_T_NAME</entry>
98 </row>
99
100 <row>
101 <entry>Architecture and Description</entry>
102
103 <entry>ELTF_T_ARC_DESC</entry>
104 </row>
105
106 <row>
107 <entry>Link to target datasheet</entry>
108
109 <entry>See <ulink
110 url="ELTF_T_DS_URL">ELTF_T_DS_TXTURL</ulink></entry>
111 </row>
112
113 <row>
114 <entry>Poky version</entry>
115
116 <entry>ELTF_T_POKY_VER</entry>
117 </row>
118
119 <row>
120 <entry>GCC version</entry>
121
122 <entry>ELTF_T_GCC_VER</entry>
123 </row>
124
125 <row>
126 <entry>Linux Kernel Version</entry>
127
128 <entry>ELTF_T_KERN_VER</entry>
129 </row>
130
131 <row>
132 <entry>Supported Drivers</entry>
133
134 <entry>ELTF_T_DRIVERS</entry>
135 </row>
136
137 <row>
138 <entry>Enea rpm folder for downloading RPM packages for this
139 target</entry>
140
141 <entry><ulink
142 url="ELTF_T_EL_RPM_URL">ELTF_T_EL_RPM_TXTURL</ulink></entry>
143 </row>
144 </tbody>
145 </tgroup>
146 </informaltable></para>
147 </section>
148
149 <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->
150 </section>
151</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated.xml b/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated.xml
deleted file mode 100644
index 1db30fd..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated.xml
+++ /dev/null
@@ -1,165 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 14.04.5 LTS 64bit
26sudo apt-get -y update
27sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
28 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
29 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
30 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
31 libxml-parser-perl</programlisting></para>
32
33 <bridgehead>A programlisting, ID
34 "eltf-getting-repo-install-command"</bridgehead>
35
36 <para id="eltf-getting-repo-install-command"><programlisting>mkdir -p ~/bin
37curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo
38chmod a+x ~/bin/repo
39export PATH=~/bin:$PATH</programlisting></para>
40
41 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
42 correct also compared to the "previous" REL VER in pardoc-distro.xml
43 "prev_baseline".</bridgehead>
44
45 <para id="EneaLinux_REL_VER"><phrase>1.1</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.1</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>krogoth</phrase></para>
50
51 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
52 url="http://www.yoctoproject.org/downloads/core/krogoth/21">http://www.yoctoproject.org/downloads/core/krogoth/21</ulink></para>
53
54 <para id="ULINK_ENEA_LINUX_URL"><ulink
55 url="https://linux.enea.com/6">https://linux.enea.com/6</ulink></para>
56
57 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
58 $MACHINE/default.xml as parameter, where MACHINE is one of the target
59 directory names in the manifest.</bridgehead>
60
61 <para id="eltf-repo-cloning-enea-linux"><programlisting>mkdir enea-linux
62cd enea-linux
63repo init -u git@git.enea.com:linux/manifests/el_manifests-virtualization.git \
64 -b refs/tags/EL6 -m $MACHINE/default.xml
65repo sync</programlisting></para>
66
67 <bridgehead>A table with ONE row, only the row with ID
68 "eltf-eclipse-version-row" is included in the book. MANUALLY in book, set
69 condition hidden if eclipse is not in the release. Do this both in
70 template.xml and updated.xml.</bridgehead>
71
72 <informaltable>
73 <tgroup cols="1">
74 <tbody>
75 <row condition="hidden" id="eltf-eclipse-version-row">
76 <entry>Eclipse version 4.3 (Mars) plus command line development
77 tools are included in this Enea NFV Access release.</entry>
78 </row>
79 </tbody>
80 </tgroup>
81 </informaltable>
82
83 <bridgehead>Below is one big section with title "Supported Targets with
84 Parameters". The entire section is included completely in the book via ID
85 "eltf-target-tables-section" and shall be LAST in the template. The
86 template contains ONE target subsection. COPY/APPEND it, if multiple
87 targets exist in the release and optionally add rows with additional
88 target parameters in each target subsection table.</bridgehead>
89 </section>
90
91 <section id="eltf-target-tables-section">
92 <title>Supported Reference Boards with Parameters</title>
93
94 <para>The tables below describes the target(s) supported in this Enea NFV
95 Access release.</para>
96
97 <section id="eltf-target-table-p2041rdb">
98 <title>MACHINE p2041rdb - Information</title>
99
100 <para><informaltable>
101 <tgroup cols="2">
102 <colspec colwidth="6*" />
103
104 <colspec colwidth="9*" />
105
106 <tbody>
107 <row>
108 <entry>Target official name</entry>
109
110 <entry>P2041RDB</entry>
111 </row>
112
113 <row>
114 <entry>Architecture and Description</entry>
115
116 <entry>Power, e500mc</entry>
117 </row>
118
119 <row>
120 <entry>Link to target datasheet</entry>
121
122 <entry>See <ulink
123 url="http://www.nxp.com/products/microcontrollers-and-processors/power-architecture-processors/qoriq-power-architecture-processors/p2041-qoriq-reference-design-board:RDP2041BOARD">link
124 to NXP's datasheet</ulink></entry>
125 </row>
126
127 <row>
128 <entry>Poky version</entry>
129
130 <entry>Git-commit-id:
131 75ca53211488a3e268037a44ee2a7ac5c7181bd2</entry>
132 </row>
133
134 <row>
135 <entry>GCC version</entry>
136
137 <entry>5.3</entry>
138 </row>
139
140 <row>
141 <entry>Linux Kernel Version</entry>
142
143 <entry>3.12</entry>
144 </row>
145
146 <row>
147 <entry>Supported Drivers</entry>
148
149 <entry>Ethernet, I2C, SPI, PCI Express, USB, Flash,
150 SD/SDHC/SDXC, RTC</entry>
151 </row>
152
153 <row>
154 <entry>Enea rpm folder for downloading RPM packages for this
155 target</entry>
156
157 <entry><ulink
158 url="https://linux.enea.com/6/p2041rgb/rpm">https://linux.enea.com/6/p2041rgb/rpm</ulink></entry>
159 </row>
160 </tbody>
161 </tgroup>
162 </informaltable></para>
163 </section>
164 </section>
165</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt b/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt
deleted file mode 100644
index 87a6445..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/eltf_params_updated_template_how_to_use.txt
+++ /dev/null
@@ -1,320 +0,0 @@
1eltf_params_template_updated_howto_use.txt
2
3This is a way to collect all parameters for an Enea NFV Access release
4in one parameter file, easy to automatically update by ELTF regularly.
5
6NOTE: Both the release info AND the open source books use parameters from
7 here, but the XML file is inside the release info book directory.
8
9NOTE: The manifest_conf.mk, or overridden by the environment variable
10 MANIFESTHASH, contains the full tag (or hashvalue) for downloading
11 the manifest when the books are built. The list of target
12 directories are fetched from the manifest into the book.
13 The eltf_params_updates.xml can all the time contain
14 the final next complete tag e.g. refs/tags/EL6 or similar
15 in the ELTF_PL_CLONE_W_REPO parameter command lines.
16
17The ordinary book XML files use xi:include statements to include elements
18from this parameter file. The book XML files can thus be manually edited.
19Before editing, you must run "make init".
20Any other text in the template or updated.xml file, outside the parts that
21are included in the book, are not used but still all must be correct
22DocBook XML files.
23
24ELTF work:
25 template => ELTF replaces ALL ELTF_xxx variables => updated XML file
26 => push to git only if changed
27
28
29eltf_params_template.xml (in git)
30 File used by ELTF to autocreate/update the real parameter
31 file eltf_params_updated.xml.
32
33eltf_params_updated.xml (in git)
34 Real parameter file where ELTF has replaced all ELTF_xx variables with
35 strings, in several cases with multiline strings.
36 No spaces or linefeed allowed in beginning or end of the variable values!
37
38
39xi:include: Each parameter is xi:include'ed in various book files, using
40 the IDs existing in the parameter files.
41 In most cases the 1:st element inside an element with an ID is included
42 using a format like eltf-prereq-apt-get-commands-host/1.
43 In very few cases the element with the ID is included in the book, one
44 example is the target section which has an ID, but which contains
45 multiple subsections, one per target.
46 All IDs in a book must be unique.
47
48DocBook XML: All XML files must be correct DocBook XML files.
49
50Do NOT edit/save the real *updated.xml file with XMLmind to avoid changes
51 not done by ELTF. But it is OK to open the real file in XMLmind to
52 check that the format is correct.
53
54ELTF should autocreate a temporary "real" file but only replace
55 and push the eltf_params_updated.xml if it is changed.
56
57
58make eltf
59 This lists all ELTF_xxx variables and some rules how to treat them
60
61DocBook Format: All elements - rules:
62 Several strict generic XML rules apply for all strings:
63 1. No TABs allowed or any other control chr than "linefeed"
64 2. Only 7-bit ASCII
65 3. Any < > & must be converted to &lt; &gt; and &amp;
66 Similar for any other non-7-bit-ASCII but avoid those!
67 4. No leading spaces or linefeeds when replacing the ELTF_* variable
68 5. No trailing spaces or linefeeds when replacing the ELTF_* variable
69 6. Note: Keep existing spaces before/efter ELTF_* in a few cases.
70
71DocBook Format: <programlisting> - rules: ELTF*PL* variables
72 Several strict rules apply for the multiline string in programlisting
73 in addition to the general XML rules above:
74 7. Max line length < 80 char
75 8. Use backslash (\) to break longer lines
76 9. Use spaces (e.g. 4) to indent continuation lines in programlistings
77 10. No trailing spaces on any line
78 11. No spaces or linefeed immediately after leading <programlisting>
79 12. No spaces or linefeed before trailing </programlisting>
80
81DocBook Format: <ulink> - rules: ELTF_*URL* variables
82 13. ELTF_*URL and corresponding ELTF_*TXTURL shall be identical strings
83 14. Only if the URL is extremely long, the TXTURL can be a separate string
84
85Each target has one section with target parameters:
86 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
87 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
88 ..... with many ELTF_ variables ....
89 </section>
90
91 15. If there is only one target. ELTF just replaces ELTF parameters
92
93 16. It there are multiple targets. ELTF copies the section and appends the
94 section the required number of times.
95 Each section ID will become unique: eltf-target-table-ELTF_T_MANIFEST_DIR
96 Each section title will become unique
97
98Tables with target parameters in each target section:
99 17. It is possible for ELTF to append more rows with one parameter each
100 to these tables, because the entire tables are included in the book
101
102Special - NOT YET READY DEFINED how to handle the optionally included
103 Eclipse and its version, but this is a first suggestion:
104 18. Just now ELTF can define ELFT_ECLIPSE_VERSION as a full string
105 with both version number and name,
106 19. MANUALLY if Eclipse is NOT included in the release,
107 the release manager should manually set condition="hidden" on
108 the entire section in the book XML about Eclipse
109
110
111
112BELOW WE TRY TO EXPLAIN EACH ELTF_* variable, but always check with make eltf
113if there are more new variables, missing in this description file.
114
115_____________________________________________________________________________
116ELTF_PL_HOST_PREREQ Multiline list of host prerequisites, e.g. commands
117 like sudo apt-get install xxxx or similar.
118 First line = comment with the complete host name!
119 It is possible to include multiple hosts by just
120 adding an empty line, comment with host name, etc.
121 xi:include eltf-prereq-apt-get-commands-host/1
122 This is a <programlisting>...</programlisting>
123 Example:
124# Host Ubuntu 14.04.5 LTS 64bit
125sudo apt-get update
126sudo apt-get install sed wget subversion git-core coreutils unzip texi2html \
127 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
128 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
129 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
130 libxml-parser-perl
131
132_____________________________________________________________________________
133ELTF_PL_GET_REPO Multiline commands to download the repo tool
134 xi:include eltf-getting-repo-install-command/1
135 This is a <programlisting>...</programlisting>
136 Example:
137mkdir -p ~/bin
138curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
139chmod a+x ~/bin/repo
140export PATH=~/bin:$PATH
141
142_____________________________________________________________________________
143ELTF_EL_REL_VER General parameter string: The version of this Enea
144 Linux release. Major version and optional .Minor
145 Typically created from MAJOR and MINOR in enea.conf
146 MINOR in enea.conf is empty or contains a dot+minor
147 xi_include EneaLinux_REL_VER/1
148 This is a <phrase>X.x</phrase> used in many places.
149 Examples:
1506
151 or
1526.1
153
154_____________________________________________________________________________
155ELTF_YOCTO_VER General parameter string: Yocto version, created
156 from DISTRO in poky.ent
157 xi:include Yocto_VER/1
158 This is a <phrase>X.x</phrase> used in many places.
159 Example:
1602.1
161
162_____________________________________________________________________________
163ELTF_YOCTO_NAME General parameter string: Yocto name (branch), created
164 from DISTRO_NAME_NO_CAP in poky.ent
165 xi:include Yocto_NAME/1
166 This is a <phrase>X.x</phrase> used in many places.
167 Example:
168krogoth
169
170_____________________________________________________________________________
171ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL
172ELTF_YOCTO_PROJ_DOWNLOAD_URL strings with correct Yocto version string
173 at the end, typically without "dot".
174 xi:include ULINK_YOCTO_PROJECT_DOWNLOAD/1
175 This is an <ulink url="...">...</ulink>
176 Example:
177http://www.yoctoproject.org/downloads/core/krogoth/21
178
179_____________________________________________________________________________
180ELTF_EL_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL strings
181ELTF_EL_DOWNLOAD_URL and shall be the http:/..... address where
182 Enea NFV Access can be downloaded
183 Often containing same version as in ELTF_EL_REL_VER
184 xi:include ULINK_ENEA_LINUX_URL/1
185 This is an <ulink url="...">...</ulink>
186 Example:
187http://linux.enea.com/6
188
189_____________________________________________________________________________
190ELTF_PL_CLONE_W_REPO Multiline commands to run repo to clone everything.
191 Use the variable $MACHINE/default.xml (the text in
192 the book will list the avaiable values of MACHINE,
193 taken from the manifest repository)
194 xi:include eltf-repo-cloning-enea-linux/1
195 This is a <programlisting>...</programlisting>
196 Example:
197mkdir enea-linux
198cd enea-linux
199repo init -u git://git.enea.com/linux/el_manifests-standard.git \
200 -b refs/tags/EL6 -m $MACHINE/default.xml
201repo sync
202
203_____________________________________________________________________________
204ELTF_ECLIPSE_VERSION Optional general parameter string.
205 NOT YET READY DEFINED
206 Just now a release manage must manually set
207 condition="hidden" on the Eclipse section,
208 if Eclipse is not included in the release.
209 ELTF just replaces ELTF_ECLIPSE_VERSION with a full
210 string with "X.Y (name)"
211 It includes the ID and can only be ONCE in the book.
212 xi:include eltf-eclipse-version-row
213 Example.
2144.5 (Mars)
215
216
217_____________________________________________________________________________
218ELTF_T_* All these are in each target (MACHINE) and ELTF
219 must separately replace them with strings for
220 each target
221 NOTE: All (except the MANIFEST_DIR) are in rows
222 in a table and ELTF can select to append
223 more parameters by adding more rows
224
225_____________________________________________________________________________
226ELTF_T_MANIFEST_DIR This happens to be in two places. Must be exactly
227ELTF_T_MANIFEST_DIR the directory name in the manifest, e.g. same
228 as the MACHINE names in $MACHINE/default.xml.
229 In book: a) Part of section ID
230 b) Part of section title
231 Examples:
232p2041rgb
233 or
234ls1021aiot
235 or
236qemuarm
237
238_____________________________________________________________________________
239ELTF_T_NAME Target specific: "Target Official Name"
240 NOT same as the target directory name in most cases.
241 In book: An <entry> element in a row
242 Examples:
243P2041RGB
244 or
245LS1021a-IoT
246 or
247qemuarm
248
249_____________________________________________________________________________
250ELTF_T_ARC_DESC Target specific: "Architecture and Description"
251 It can be a short identification string or
252 it can be a longer descriptive sentence.
253 In book: An <entry> element in a row
254 Examples:
255Power, e500mc
256 or
257ARM Cortex-A7
258
259_____________________________________________________________________________
260ELTF_T_DS_TXTURL Target specific: "Link to target datasheet. These
261ELTF_T_DS_URL two usually are IDENTICAL strings with correct
262 hyperlink to the target's official datasheet.
263 In book: an <ulink url="...">...</ulink>
264 Only if the link is VERY LONG, the text part shall
265 instead be a descriptive string (see 2:nd example).
266 NOTE: Also here no spaces or line-feeds!
267 Examples:
268url="http://wiki.qemu.org">http://wiki.qemu.org
269or
270url="http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/qoriq-arm-processors/qoriq-ls1021a-iot-gateway-reference-design:LS1021A-IoT">link to NXP's datasheet
271
272_____________________________________________________________________________
273ELTF_T_POKY_VER Target specific: "Poky version" created either
274 from POKYVERSION in poky.ent
275 or using a hashvalue with a leading string, in
276 which case it may be different per target.
277 In book: An <entry> in a row
278 Examples:
27915.0.0
280or
281Git commit id: 75ca53211488a3e268037a44ee2a7ac5c7181bd2
282
283_____________________________________________________________________________
284ELTF_T_GCC_VER Target specific: "GCC Version". Should be in poky
285 but not easy to find among various parameters.
286 ELTF would extract it from build logs building SDK
287 and it is possibly different per target.
288 In book: An <entry> in a row
289 Example:
2905.3
291
292_____________________________________________________________________________
293ELTF_T_KERN_VER Target specific: "Linux Kernel Version". Often
294 different per target.
295 In book: An <entry> in a row
296 Example:
2973.12
298
299_____________________________________________________________________________
300ELTF_T_DRIVERS Target specific: "Supported Drivers". This is a
301 comma-separated list of driver names.
302 ELTF should create the list in same order for each
303 target, e.g. alphabetic migth be OK.
304 In book: An <entry> in a row
305 Example:
306Ethernet, I2C, SPI, PCI, USB, SD/SDHC/SDXC
307
308
309_____________________________________________________________________________
310ELTF_T_EL_RPM_TXTURL Target specific: "Enea rpm folder for downloading
311ELTF_T_EL_RPM_URL RPM packages for this target". These two are
312 INDENTICAL strings with hyperlink to the web site
313 at Enea where the customer can download RPMs
314 Note: Often the ELFT_EL_REL_VER value and
315 the ELTF_T_MANIFEST_DIR are used in the link.
316 In book: an <ulink url="...">...</ulink>
317 Example:
318url="https://linux.enea.com/6/ls1021aiot/rpm">https://linux.enea.com/6/ls1021aiot/rpm
319
320_____________________________________________________________________________
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/guidelines_hardening_linux.xml b/doc/book-enea-nfv-access-user-hardening-guide/doc/guidelines_hardening_linux.xml
deleted file mode 100644
index 46245da..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/guidelines_hardening_linux.xml
+++ /dev/null
@@ -1,212 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="linux_hardening">
5 <title>Guidelines on How to Harden a Linux System</title>
6
7 <para>In order to effectively create apt security layers to harden your
8 system correctly, you must first analyze your needs and answer several
9 ideas/questions which are detailed below.</para>
10
11 <orderedlist>
12 <listitem>
13 <para><emphasis role="bold">Analyzing and defining Roles for your
14 system</emphasis></para>
15
16 <itemizedlist>
17 <listitem>
18 <para>What purpose does the system have?</para>
19 </listitem>
20
21 <listitem>
22 <para>What security risks apply to the system?</para>
23 </listitem>
24
25 <listitem>
26 <para>Is it host/server? Does it need to do remote access? Public
27 use?</para>
28 </listitem>
29
30 <listitem>
31 <para>How hardened the system need to be? (This depends on what role
32 it has).</para>
33 </listitem>
34 </itemizedlist>
35 </listitem>
36
37 <listitem>
38 <para><emphasis role="bold">Review Policies and
39 Compliances</emphasis></para>
40
41 <para>What policies and compliances must your system adhere to? Examples
42 of possible standards and polices, among many others, are:</para>
43
44 <itemizedlist>
45 <listitem>
46 <para>PCI DSS (confidentiality of credit card consumer data)</para>
47 </listitem>
48
49 <listitem>
50 <para>HIPAA (protects patient data in health care system)</para>
51 </listitem>
52
53 <listitem>
54 <para>FISMA (Federal Information Security Management Act)</para>
55 </listitem>
56
57 <listitem>
58 <para>ISO 27001 family (Information Security Management
59 Systems)</para>
60 </listitem>
61 </itemizedlist>
62 </listitem>
63
64 <listitem>
65 <para><emphasis role="bold">Keep the Software
66 up-to-date</emphasis></para>
67
68 <para>Apply software updates and security fixes regularly. Upgrade as
69 soon a new version is available. It is easier to hack a system which is
70 running publicly known vulnerable software but this can be avoided.
71 Linux provides all necessary tools to keep the system updated. All
72 security updates should be reviewed and applied as soon as
73 possible.</para>
74 </listitem>
75
76 <listitem>
77 <para><emphasis role="bold">Mandatory Access Control
78 (MAC)</emphasis></para>
79
80 <para>SELinux, TOMOYO, SMACK (Simplified Mandatory Access Control
81 Kernel).</para>
82 </listitem>
83
84 <listitem>
85 <para><emphasis role="bold">Memory Protection and ASLR
86 </emphasis></para>
87
88 <para>There are two major mechanisms in place to protect memory access
89 which turned on by default on most x86-64 Linux systems. The first is
90 the so-called NX bit, which is a setting that gives finer-grained
91 permissions to mapped memory regions. The second is address space layout
92 randomization (ASLR) which randomizes where certain parts of a program
93 are loaded into memory. For further reading on this, see <ulink
94 url="https://eklitzke.org/memory-protection-and-aslr">here</ulink>.</para>
95 </listitem>
96
97 <listitem>
98 <para><emphasis role="bold">Block unauthorized access to a network and
99 Restrict Access</emphasis></para>
100
101 <itemizedlist>
102 <listitem>
103 <para>Enable the firewall (see what rules are already configured
104 iptables -L)</para>
105 </listitem>
106
107 <listitem>
108 <para>Use Intrusion Detection/Intrusion Prevention</para>
109 </listitem>
110
111 <listitem>
112 <para>Disable unused accounts, create user groups and domain
113 policy</para>
114 </listitem>
115
116 <listitem>
117 <para>Remove unused/unsecure/obsolete software</para>
118 </listitem>
119
120 <listitem>
121 <para>Disable unused services</para>
122 </listitem>
123
124 <listitem>
125 <para>Restrict remote access and administration</para>
126 </listitem>
127 </itemizedlist>
128 </listitem>
129
130 <listitem>
131 <para><emphasis role="bold">Use tools to detect
132 vulnerabilities</emphasis></para>
133
134 <itemizedlist>
135 <listitem>
136 <para>Vulnerability scanner, such as Nessus, SAINT, OpenVAS.</para>
137 </listitem>
138
139 <listitem>
140 <para>Network analyzer, such as Nmap, Wireshark.</para>
141 </listitem>
142
143 <listitem>
144 <para>Baseline Analyzer, such as Bastille which can view OS
145 configuration and try to optimize.</para>
146 </listitem>
147 </itemizedlist>
148 </listitem>
149
150 <listitem>
151 <para><emphasis role="bold">Create a Secure logging
152 System</emphasis></para>
153
154 <para>Create a secure Linux logging system that can be expanded to other
155 types of systems for secure logging. By using logs, data can be
156 collected in order to discern why a server crashed. If the server is
157 unrecoverable, remote logs allow you the ability to see what happened
158 prior to the crash, even without the system running. If the crash was
159 related to an intrusion, any information that describes how the system
160 was compromised can help determine new approaches so further intrusions
161 can be prevented.</para>
162 </listitem>
163
164 <listitem>
165 <para><emphasis role="bold">Backup &amp; recovery</emphasis></para>
166
167 <para>If a system is compromised, the first concern is how to recover.
168 To ensure that there is something to recove, backup the data and
169 configurations continually.</para>
170 </listitem>
171
172 <listitem>
173 <para><emphasis role="bold">Physical Security</emphasis></para>
174
175 <para>No matter how many security features may be implemented, there is
176 always a way that an attacker with physical access to the system
177 (hardware and software) may by-pass them. To make this as difficult as
178 possible, there are several actions that can be taken to provide a
179 degree of security against an attacker with physical access to the
180 machine:</para>
181
182 <itemizedlist>
183 <listitem>
184 <para>Make sure unauthorized persons don&rsquo;t have easy access to
185 the hardware and software.</para>
186 </listitem>
187
188 <listitem>
189 <para>Prevent an attacker from booting from another disk/USB.</para>
190 </listitem>
191
192 <listitem>
193 <para>Set permissions and login restrictions as well as a firmware
194 password. It is also important to set a secondary bootloader
195 password (LILO or GRUB) to prevent malicious users from
196 booting.</para>
197 </listitem>
198
199 <listitem>
200 <para>Encrypt disks before they are installed.</para>
201 </listitem>
202 </itemizedlist>
203 </listitem>
204
205 <listitem>
206 <para><emphasis role="bold">Review Process</emphasis></para>
207
208 <para>Review your security process and security policies often, and
209 continually seek to improve them.</para>
210 </listitem>
211 </orderedlist>
212</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/intro_hardentools_tech.xml b/doc/book-enea-nfv-access-user-hardening-guide/doc/intro_hardentools_tech.xml
deleted file mode 100644
index 294d67e..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/intro_hardentools_tech.xml
+++ /dev/null
@@ -1,209 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="intro_hardentools_tech">
3 <title>A Brief Introduction to Hardening Tools and Technologies</title>
4
5 <para>Linux by default, is not a secure operating system however, it has
6 many features and tools that can help secure it thoroughly. Detailed below
7 are several useful tools and features available for Linux which can help
8 harden the Linux system to really high degrees.</para>
9
10 <section id="namespaces">
11 <title>Namespaces</title>
12
13 <para>Namespaces are a feature of the Linux kernel that isolate and
14 virtualize system resources for a collection of processes. Examples of
15 resources that can be virtualized are:</para>
16
17 <itemizedlist>
18 <listitem>
19 <para>Process IDs</para>
20 </listitem>
21
22 <listitem>
23 <para>Hostnames</para>
24 </listitem>
25
26 <listitem>
27 <para>User IDs</para>
28 </listitem>
29
30 <listitem>
31 <para>Network access</para>
32 </listitem>
33
34 <listitem>
35 <para>UTS</para>
36 </listitem>
37
38 <listitem>
39 <para>Control Group (cgroup)</para>
40 </listitem>
41
42 <listitem>
43 <para>Interprocess communication (IPC)</para>
44 </listitem>
45
46 <listitem>
47 <para>Filesystems (mnt)</para>
48 </listitem>
49 </itemizedlist>
50
51 <para>Namespaces are a fundamental aspect of containers on Linux. Tools
52 like Docker make isolating Linux processes into their own little system
53 environments easy. This makes it possible to run a whole range of
54 applications on a single real Linux machine and ensure that no processes
55 can interfere with each other, without having to resort to using virtual
56 machines. </para>
57 </section>
58
59 <section id="intrusion_prev_dev">
60 <title>Linux Intrusion Prevention/Detection Systems</title>
61
62 <para>An Intrusion Prevention System (IPS) and an Intrusion Detection
63 System (IDS) provide an effective layer of security. The Linux Intrusion
64 Detection System (LIDS) is a patch to the Linux kernel and associated
65 administrative tools, and enhances the kernel's security by implementing
66 Mandatory Access Control (MAC).</para>
67
68 <para>When a LIDS system is booted, file restrictions are enforced
69 immediately. Once the system has come on, the <command>lidsadm
70 -I</command> command will seal off the kernel, preventing any additional
71 kernel modules from affecting it.</para>
72 </section>
73
74 <section id="kernel_hardening">
75 <title>Kernel Hardening</title>
76
77 <para>Kernel hardening is primarily about the kernel protecting itself,
78 eliminating classes of exploits, and reducing its attack surface. Two
79 approaches to hardening the standard Linux kernel are: </para>
80
81 <itemizedlist>
82 <listitem>
83 <para>Address space (memory) protection</para>
84 </listitem>
85
86 <listitem>
87 <para>Advance Access Control System</para>
88 </listitem>
89 </itemizedlist>
90
91 <para>Buffer overflows (in languages such as C) are one of the leading
92 vulnerabilities exploited to gain control of a system. The problem arises
93 when a user can insert more data into a buffer than it was originally
94 allocated for. Restrictions however, on an application's address space
95 prevent many types of buffer overflows attacks.</para>
96 </section>
97
98 <section id="lsm">
99 <title>Linux Security Modules (LSM)</title>
100
101 <para>LSM is a framework part of the Linux kernel. LSM API implements
102 hooks at all security-critical points within the kernel. The modules
103 currently accepted in the official kernel are:</para>
104
105 <itemizedlist>
106 <listitem>
107 <para>AppArmor</para>
108 </listitem>
109
110 <listitem>
111 <para>SELinux</para>
112 </listitem>
113
114 <listitem>
115 <para>Smack</para>
116 </listitem>
117
118 <listitem>
119 <para>TOMOYO Linux</para>
120 </listitem>
121
122 <listitem>
123 <para>Yama</para>
124 </listitem>
125 </itemizedlist>
126
127 <section id="selinux">
128 <title>SELinux</title>
129
130 <para><emphasis role="bold">SELinux, Security Enhanced Linux</emphasis>
131 is a Kernel security mechanism for the supporting access control
132 security policy. SELinux has three configuration modes:</para>
133
134 <itemizedlist>
135 <listitem>
136 <para>Disabled: Turned-off</para>
137 </listitem>
138
139 <listitem>
140 <para>Permissive: Prints warnings</para>
141 </listitem>
142
143 <listitem>
144 <para>Enforcing: Policy is enforced</para>
145 </listitem>
146 </itemizedlist>
147
148 <para>Edit the selinux config file to change the
149 configuration:<programlisting># /etc/selinux/config
150SELINUX=enforcing</programlisting></para>
151 </section>
152 </section>
153
154 <section id="acl">
155 <title>POSIX Access Control Lists (ACL)</title>
156
157 <para>In addition to the file owner, the file group etc., additional users
158 and groups can be granted or denied access by using POSIX ACLs. For a
159 file, ACLs can be configured:</para>
160
161 <itemizedlist>
162 <listitem>
163 <para>Per user </para>
164 </listitem>
165
166 <listitem>
167 <para>Per group</para>
168 </listitem>
169
170 <listitem>
171 <para>Via the effective right mask</para>
172 </listitem>
173
174 <listitem>
175 <para>For users not in the user group, for the file</para>
176 </listitem>
177 </itemizedlist>
178 </section>
179
180 <section id="log_audit">
181 <title>Logging and Auditing</title>
182
183 <para>Audit logs are useful for analyzing system behavior, and may help
184 detect attempts at compromising the system. Enea Linux distributions have
185 logging mechanisms that record all system activities. The syslog service
186 manages the logs in <command>/var/log/</command>. These logs are critical
187 for troubleshooting purposes.</para>
188 </section>
189
190 <section id="secure_net_coms">
191 <title>Secure Network Communication</title>
192
193 <para>Encrypt and authenticate network communication using IPsec.</para>
194 </section>
195
196 <section id="hd_encrypting">
197 <title>Hard Disk Encryption and Disk Protection</title>
198
199 <para>Encrypt the disks before they are installed. This is a crucial step
200 as it will prevent unauthorized access to data even when the hard disk is
201 connected to a different machine.</para>
202
203 <para>Disk protection is a key step in securing data. Make sure that you
204 backup data so that situations such as a damaged system and bugs in the OS
205 updates won't affect them. The backup must be transferred offsite
206 for major servers to keep data secure during unforeseen disasters. Backup
207 management must also be well-defined.</para>
208 </section>
209</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/intro_info_security.xml b/doc/book-enea-nfv-access-user-hardening-guide/doc/intro_info_security.xml
deleted file mode 100644
index bbc203b..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/intro_info_security.xml
+++ /dev/null
@@ -1,144 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="intro_info_security">
5 <title>Introduction to Information Security</title>
6
7 <para><remark>I want to add an intro to this chapter, it's too brief and
8 vague, what is the purpose of these 3 lists, what are they intended to
9 introduce?</remark></para>
10
11 <section id="security_categories">
12 <title>Related Security Categories</title>
13
14 <itemizedlist>
15 <listitem>
16 <para>Internet Security</para>
17 </listitem>
18
19 <listitem>
20 <para>Cyberwarfare</para>
21 </listitem>
22
23 <listitem>
24 <para>Computer Security</para>
25 </listitem>
26
27 <listitem>
28 <para>Mobile Security</para>
29 </listitem>
30
31 <listitem>
32 <para>Network Security</para>
33 </listitem>
34 </itemizedlist>
35 </section>
36
37 <section id="threats">
38 <title>Threats</title>
39
40 <itemizedlist>
41 <listitem>
42 <para>Computer Crime</para>
43 </listitem>
44
45 <listitem>
46 <para>Vulnerability</para>
47 </listitem>
48
49 <listitem>
50 <para>Eavesdropping</para>
51 </listitem>
52
53 <listitem>
54 <para>Exploitation</para>
55 </listitem>
56
57 <listitem>
58 <para>Trojan Horse</para>
59 </listitem>
60
61 <listitem>
62 <para>Computer Viruses and Computer Worms</para>
63 </listitem>
64
65 <listitem>
66 <para>Denial of Service</para>
67 </listitem>
68
69 <listitem>
70 <para>Malware</para>
71 </listitem>
72
73 <listitem>
74 <para>Payload</para>
75 </listitem>
76
77 <listitem>
78 <para>Rootkit</para>
79 </listitem>
80
81 <listitem>
82 <para>Keylogger</para>
83 </listitem>
84 </itemizedlist>
85 </section>
86
87 <section id="defenses">
88 <title>Defenses</title>
89
90 <itemizedlist>
91 <listitem>
92 <para>Computer Access Control</para>
93 </listitem>
94
95 <listitem>
96 <para>Application Security</para>
97 </listitem>
98
99 <listitem>
100 <para>Antivirus Software</para>
101 </listitem>
102
103 <listitem>
104 <para>Secure Coding</para>
105 </listitem>
106
107 <listitem>
108 <para>Security by Design</para>
109 </listitem>
110
111 <listitem>
112 <para>Secure Operating Systems</para>
113 </listitem>
114
115 <listitem>
116 <para>Authentication</para>
117 </listitem>
118
119 <listitem>
120 <para>Multi-factor Authentication</para>
121 </listitem>
122
123 <listitem>
124 <para>Authorization</para>
125 </listitem>
126
127 <listitem>
128 <para>Data-centric Security</para>
129 </listitem>
130
131 <listitem>
132 <para>Firewall</para>
133 </listitem>
134
135 <listitem>
136 <para>Intrusion Detection System</para>
137 </listitem>
138
139 <listitem>
140 <para>Intrusion Prevention System</para>
141 </listitem>
142 </itemizedlist>
143 </section>
144</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/doc/introduction.xml b/doc/book-enea-nfv-access-user-hardening-guide/doc/introduction.xml
deleted file mode 100644
index 817ed76..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/doc/introduction.xml
+++ /dev/null
@@ -1,102 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<chapter id="overview">
5 <title>Overview</title>
6
7 <para>This document describes a set of activities needed for securing Enea
8 NFV Access by users. Most security hardening configurations and features
9 affect performance, and should only be set if more security but less
10 performance is required and acceptable. We emphasize to use layers of
11 security to get the desired degree of hardening.</para>
12
13 <section id="intro">
14 <title>Introduction</title>
15
16 <para>This document describes several hardening techniques and Open Source
17 tools available for Enea NFV Access.</para>
18
19 <section id="rev-hist">
20 <title>Revision History</title>
21
22 <table>
23 <tgroup cols="4">
24 <colspec align="center" />
25
26 <thead>
27 <row>
28 <entry align="center">Revision</entry>
29
30 <entry align="center">Author</entry>
31
32 <entry align="center">Date</entry>
33
34 <entry align="center">Purpose of Revision</entry>
35 </row>
36 </thead>
37
38 <tbody>
39 <row>
40 <entry>3</entry>
41
42 <entry>Sona Sarmadi</entry>
43
44 <entry>2017-09-07</entry>
45
46 <entry>Added Introduction to Information Security, sec
47 2.</entry>
48 </row>
49
50 <row>
51 <entry>2</entry>
52
53 <entry>Sona Sarmadi</entry>
54
55 <entry>2017-09-07</entry>
56
57 <entry>Updated section 2.</entry>
58 </row>
59
60 <row>
61 <entry>1</entry>
62
63 <entry>Sona Sarmadi</entry>
64
65 <entry>2017-08-31</entry>
66
67 <entry>Initial Revision, hardening guideline for users.</entry>
68 </row>
69 </tbody>
70 </tgroup>
71 </table>
72 </section>
73
74 <section id="references">
75 <title>References</title>
76
77 <itemizedlist>
78 <listitem>
79 <para><ulink
80 url="https://www.sans.org/reading-room/whitepapers/linux/linux-kernel-hardening-1294">www.sans.org/reading-room/whitepapers/linux/linux-kernel-hardening-1294</ulink></para>
81 </listitem>
82
83 <listitem>
84 <para><ulink
85 url="https://lwn.net/Articles/705262/">lwn.net/Articles/705262/</ulink></para>
86 </listitem>
87 </itemizedlist>
88 </section>
89
90 <section id="def_acro">
91 <title>Definitions and Acronyms</title>
92
93 <para>Definitions</para>
94
95 <para>[FIXME]</para>
96
97 <para>Acronyms</para>
98
99 <para>[FIXME]</para>
100 </section>
101 </section>
102</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-user-hardening-guide/swcomp.mk b/doc/book-enea-nfv-access-user-hardening-guide/swcomp.mk
deleted file mode 100644
index 2fe78b5..0000000
--- a/doc/book-enea-nfv-access-user-hardening-guide/swcomp.mk
+++ /dev/null
@@ -1,10 +0,0 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-access-user-hardening-guide
9BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access $(PROD_VER) User's Hardening Guide"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/book.xml b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/book.xml
deleted file mode 100644
index 7fbbadb..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/book.xml
+++ /dev/null
@@ -1,30 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
4<!ENTITY % local.common.attrib "xml:base CDATA #IMPLIED">
5]>
6<book id="book_enea_nfv_access_vnf_onboarding_guide">
7 <title><trademark class="registered">Enea</trademark> NFV Access VNF Onboarding Guide</title>
8
9 <subtitle>Release Version <xi:include href="eltf_params_updated.xml"
10 xmlns:xi="http://www.w3.org/2001/XInclude"
11 xpointer="element(EneaLinux_REL_VER/1)" /></subtitle>
12
13 <!-- OLINKDBPATH_USED_BY_XMLMIND ../../s_docbuild/olinkdb -->
14
15 <xi:include href="../../s_docbuild/template/docsrc_common/bookinfo_userdoc.xml"
16 xmlns:xi="http://www.w3.org/2001/XInclude" />
17
18 <xi:include href="introduction.xml"
19 xmlns:xi="http://www.w3.org/2001/XInclude" />
20
21 <xi:include href="vnf_onboarding.xml"
22 xmlns:xi="http://www.w3.org/2001/XInclude" />
23
24 <xi:include href="instantiation.xml"
25 xmlns:xi="http://www.w3.org/2001/XInclude" />
26
27 <xi:include href="vnf_configurations.xml"
28 xmlns:xi="http://www.w3.org/2001/XInclude" />
29
30</book>
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_template.xml b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_template.xml
deleted file mode 100644
index eaa7ebd..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_template.xml
+++ /dev/null
@@ -1,151 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting>ELTF_PL_HOST_PREREQ</programlisting></para>
26
27 <bridgehead>A programlisting, ID
28 "eltf-getting-repo-install-command"</bridgehead>
29
30 <para id="eltf-getting-repo-install-command"><programlisting>ELTF_PL_GET_REPO</programlisting></para>
31
32 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
33 correct also compared to the "previous" REL VER in pardoc-distro.xml
34 "prev_baseline".</bridgehead>
35
36 <para id="EneaLinux_REL_VER"><phrase>ELTF_EL_REL_VER</phrase></para>
37
38 <para id="Yocto_VER"><phrase>ELTF_YOCTO_VER</phrase></para>
39
40 <para id="Yocto_NAME"><phrase>ELTF_YOCTO_NAME</phrase></para>
41
42 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
43 url="ELTF_YOCTO_PROJ_DOWNLOAD_URL">ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL</ulink></para>
44
45 <para id="ULINK_ENEA_LINUX_URL"><ulink
46 url="ELTF_EL_DOWNLOAD_URL">ELTF_EL_DOWNLOAD_TXTURL</ulink></para>
47
48 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
49 $MACHINE/default.xml as parameter, where MACHINE is one of the target
50 directory names in the manifest.</bridgehead>
51
52 <para id="eltf-repo-cloning-enea-linux"><programlisting>ELTF_PL_CLONE_W_REPO</programlisting></para>
53
54 <bridgehead>A table with ONE row, only the row with ID
55 "eltf-eclipse-version-row" is included in the book. MANUALLY BOTH in the
56 template.xml and in the updated.xml, set condition hidden on the
57 &lt;row&gt;, if eclipse is not in the release.</bridgehead>
58
59 <informaltable>
60 <tgroup cols="1">
61 <tbody>
62 <row id="eltf-eclipse-version-row">
63 <entry>Eclipse version ELTF_ECLIPSE_VERSION plus command line
64 development tools are included in this Enea NFV Access release.</entry>
65 </row>
66 </tbody>
67 </tgroup>
68 </informaltable>
69
70 <bridgehead>Below is one big section with title "Supported Targets with
71 Parameters". The entire section is included completely in the book via ID
72 "eltf-target-tables-section" and shall be LAST in the template. The
73 template contains ONE target subsection. COPY/APPEND it, if multiple
74 targets exist in the release and optionally add rows with additional
75 target parameters in each target subsection table.</bridgehead>
76 </section>
77
78 <section id="eltf-target-tables-section">
79 <title>Supported Targets with Parameters</title>
80
81 <para>The tables below describes the target(s) supported in this Enea
82 NFV Access release.</para>
83
84 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
85 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
86
87 <para><informaltable>
88 <tgroup cols="2">
89 <colspec colwidth="6*" />
90
91 <colspec colwidth="9*" />
92
93 <tbody>
94 <row>
95 <entry>Target official name</entry>
96
97 <entry>ELTF_T_NAME</entry>
98 </row>
99
100 <row>
101 <entry>Architecture and Description</entry>
102
103 <entry>ELTF_T_ARC_DESC</entry>
104 </row>
105
106 <row>
107 <entry>Link to target datasheet</entry>
108
109 <entry>See <ulink
110 url="ELTF_T_DS_URL">ELTF_T_DS_TXTURL</ulink></entry>
111 </row>
112
113 <row>
114 <entry>Poky version</entry>
115
116 <entry>ELTF_T_POKY_VER</entry>
117 </row>
118
119 <row>
120 <entry>GCC version</entry>
121
122 <entry>ELTF_T_GCC_VER</entry>
123 </row>
124
125 <row>
126 <entry>Linux Kernel Version</entry>
127
128 <entry>ELTF_T_KERN_VER</entry>
129 </row>
130
131 <row>
132 <entry>Supported Drivers</entry>
133
134 <entry>ELTF_T_DRIVERS</entry>
135 </row>
136
137 <row>
138 <entry>Enea rpm folder for downloading RPM packages for this
139 target</entry>
140
141 <entry><ulink
142 url="ELTF_T_EL_RPM_URL">ELTF_T_EL_RPM_TXTURL</ulink></entry>
143 </row>
144 </tbody>
145 </tgroup>
146 </informaltable></para>
147 </section>
148
149 <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->
150 </section>
151</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated.xml b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated.xml
deleted file mode 100644
index feabc9f..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated.xml
+++ /dev/null
@@ -1,286 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
3"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
4<section id="eltf_created_params">
5 <title>File with Parameters in the Book Auto-updated by ELFT</title>
6
7 <note>
8 <para>See the <emphasis
9 role="bold">eltf_params_updated_template_howto_use.txt</emphasis> text
10 file for description of how to create the final <emphasis
11 role="bold">eltf_params_updated.xml</emphasis> from this template and for
12 all <emphasis role="bold">REQUIREMENTS</emphasis>. Use the command
13 "<emphasis role="bold">make eltf</emphasis>" to extract a full list of all
14 ELTF variables, which always begins with ELTF_ and don't only rely on the
15 howto text file list! The plan is that ELTF will auto-update this when
16 needed.</para>
17 </note>
18
19 <section id="host_prereq">
20 <title>Common Parameters</title>
21
22 <bridgehead>A programlisting, ID
23 "eltf-prereq-apt-get-commands-host"</bridgehead>
24
25 <para id="eltf-prereq-apt-get-commands-host"><programlisting># Host Ubuntu 16.04 LTS 64bit
26sudo apt-get -y update
27sudo apt-get -y install sed wget subversion git-core coreutils unzip texi2html \
28 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
29 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
30 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
31 libxml-parser-perl</programlisting></para>
32
33 <bridgehead>A programlisting, ID
34 "eltf-getting-repo-install-command"</bridgehead>
35
36 <para id="eltf-getting-repo-install-command"><programlisting>mkdir -p ~/bin
37curl https://storage.googleapis.com/git-repo-downloads/repo &gt; ~/bin/repo
38chmod a+x ~/bin/repo
39export PATH=~/bin:$PATH</programlisting></para>
40
41 <bridgehead>Several phrase elements, various IDs. Ensure EL_REL_VER is
42 correct also compared to the "previous" REL VER in pardoc-distro.xml
43 "prev_baseline".</bridgehead>
44
45 <para id="EneaLinux_REL_VER"><phrase>2.2.1</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.4</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>rocko</phrase></para>
50
51 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
52 url="http://www.yoctoproject.org/downloads">http://www.yoctoproject.org/downloads</ulink></para>
53
54 <para id="ULINK_ENEA_LINUX_URL"><ulink
55 url="https://linux.enea.com/6">https://linux.enea.com/6</ulink></para>
56
57 <bridgehead>A programlisting, ID "eltf-repo-cloning-enea-linux". Use
58 $MACHINE/default.xml as parameter, where MACHINE is one of the target
59 directory names in the manifest.</bridgehead>
60
61 <para id="eltf-repo-cloning-enea-linux"><programlisting>mkdir enea-linux
62cd enea-linux
63repo init -u git@git.enea.com:linux/manifests/el_manifests-virtualization.git \
64 -b refs/tags/EL6 -m $MACHINE/default.xml
65repo sync</programlisting></para>
66
67 <bridgehead>A table with ONE row, only the row with ID
68 "eltf-eclipse-version-row" is included in the book. MANUALLY in book, set
69 condition hidden if eclipse is not in the release. Do this both in
70 template.xml and updated.xml.</bridgehead>
71
72 <informaltable>
73 <tgroup cols="1">
74 <tbody>
75 <row condition="hidden" id="eltf-eclipse-version-row">
76 <entry>Eclipse version 4.3 (Mars) plus command line development
77 tools are included in this Enea NFV Access release.</entry>
78 </row>
79 </tbody>
80 </tgroup>
81 </informaltable>
82
83 <bridgehead>Below is one big section with title "Supported Targets with
84 Parameters". The entire section is included completely in the book via ID
85 "eltf-target-tables-section" and shall be LAST in the template. The
86 template contains ONE target subsection. COPY/APPEND it, if multiple
87 targets exist in the release and optionally add rows with additional
88 target parameters in each target subsection table.</bridgehead>
89 </section>
90
91 <section id="eltf-target-tables-section">
92 <title>Supported Reference Boards with Parameters</title>
93
94 <para>The table(s) below describes the target(s) supported in this Enea
95 NFV Access release.</para>
96
97 <table>
98 <title>MACHINE Information Intel Xeon D</title>
99
100 <tgroup cols="2">
101 <colspec align="center" />
102
103 <thead>
104 <row>
105 <entry align="center">Component</entry>
106
107 <entry align="center">Description</entry>
108 </row>
109 </thead>
110
111 <tbody>
112 <row>
113 <entry align="left">Target official name</entry>
114
115 <entry>Intel Xeon D</entry>
116 </row>
117
118 <row>
119 <entry align="left">Architecture and Description</entry>
120
121 <entry>x86-64</entry>
122 </row>
123
124 <row>
125 <entry align="left">Link to target datasheet</entry>
126
127 <entry><ulink
128 url="https://www.intel.com/content/www/us/en/processors/xeon/xeon-d-1500-datasheet-vol-1.html">Intel's
129 datasheet</ulink></entry>
130 </row>
131
132 <row>
133 <entry align="left">Poky version</entry>
134
135 <entry>Git-commit-id:
136 7e7ee662f5dea4d090293045f7498093322802cc</entry>
137 </row>
138
139 <row>
140 <entry align="left">GCC version</entry>
141
142 <entry>7.3</entry>
143 </row>
144
145 <row>
146 <entry align="left">Linux Kernel Version</entry>
147
148 <entry>4.14</entry>
149 </row>
150
151 <row condition="hidden">
152 <entry align="left">Supported Drivers</entry>
153
154 <entry>Ethernet, RTC, UART</entry>
155 </row>
156 </tbody>
157 </tgroup>
158 </table>
159
160 <table>
161 <title>MACHINE Information Intel Atom C3000</title>
162
163 <tgroup cols="2">
164 <colspec align="center" />
165
166 <thead>
167 <row>
168 <entry align="center">Component</entry>
169
170 <entry align="center">Description</entry>
171 </row>
172 </thead>
173
174 <tbody>
175 <row>
176 <entry align="left">Target official name</entry>
177
178 <entry>Intel Atom C3000</entry>
179 </row>
180
181 <row>
182 <entry align="left">Architecture and Description</entry>
183
184 <entry>x86-64</entry>
185 </row>
186
187 <row>
188 <entry align="left">Link to target datasheet</entry>
189
190 <entry><ulink
191 url="https://www.intel.com/content/www/us/en/products/docs/processors/atom/c-series/c3000-family-datasheet.html">Intel's
192 datasheet</ulink></entry>
193 </row>
194
195 <row>
196 <entry align="left">Poky version</entry>
197
198 <entry>Git-commit-id:
199 7e7ee662f5dea4d090293045f7498093322802cc</entry>
200 </row>
201
202 <row>
203 <entry align="left">GCC version</entry>
204
205 <entry>7.3</entry>
206 </row>
207
208 <row>
209 <entry align="left">Linux Kernel Version</entry>
210
211 <entry>4.14</entry>
212 </row>
213
214 <row condition="hidden">
215 <entry align="left">Supported Drivers</entry>
216
217 <entry>Ethernet, RTC, UART</entry>
218 </row>
219 </tbody>
220 </tgroup>
221 </table>
222
223 <table condition="arm">
224 <title>MACHINE Information</title>
225
226 <tgroup cols="2">
227 <colspec align="center" />
228
229 <thead>
230 <row>
231 <entry align="center">Component</entry>
232
233 <entry align="center">Description</entry>
234 </row>
235 </thead>
236
237 <tbody>
238 <row>
239 <entry align="left">Target official name</entry>
240
241 <entry>OCTEON TXâ„¢ cn8304</entry>
242 </row>
243
244 <row>
245 <entry align="left">Architecture and Description</entry>
246
247 <entry>arm64</entry>
248 </row>
249
250 <row>
251 <entry align="left">Link to target datasheet</entry>
252
253 <entry><ulink
254 url="http://www.cavium.com/OCTEON-TX-CN82XX-83XX.html">OCTEON
255 TXâ„¢ cn8304 datasheet</ulink></entry>
256 </row>
257
258 <row>
259 <entry align="left">Poky version</entry>
260
261 <entry>Git-commit-id:
262 f01b909a266498853e6b3f10e6b39f2d95148129</entry>
263 </row>
264
265 <row>
266 <entry align="left">GCC version</entry>
267
268 <entry>5.3<remark>FIXME</remark></entry>
269 </row>
270
271 <row>
272 <entry align="left">Linux Kernel Version</entry>
273
274 <entry>3.12<remark>FIXME</remark></entry>
275 </row>
276
277 <row condition="hidden">
278 <entry align="left">Supported Drivers</entry>
279
280 <entry>Ethernet, RTC, UART</entry>
281 </row>
282 </tbody>
283 </tgroup>
284 </table>
285 </section>
286</section> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated_template_how_to_use.txt b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated_template_how_to_use.txt
deleted file mode 100755
index 62e5d02..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/eltf_params_updated_template_how_to_use.txt
+++ /dev/null
@@ -1,320 +0,0 @@
1eltf_params_template_updated_howto_use.txt
2
3This is a way to collect all parameters for an Enea NFV Access release
4in one parameter file, easy to automatically update by ELTF regularly.
5
6NOTE: Both the release info AND the open source books use parameters from
7 here, but the XML file is inside the release info book directory.
8
9NOTE: The manifest_conf.mk, or overridden by the environment variable
10 MANIFESTHASH, contains the full tag (or hashvalue) for downloading
11 the manifest when the books are built. The list of target
12 directories are fetched from the manifest into the book.
13 The eltf_params_updates.xml can all the time contain
14 the final next complete tag e.g. refs/tags/EL6 or similar
15 in the ELTF_PL_CLONE_W_REPO parameter command lines.
16
17The ordinary book XML files use xi:include statements to include elements
18from this parameter file. The book XML files can thus be manually edited.
19Before editing, you must run "make init".
20Any other text in the template or updated.xml file, outside the parts that
21are included in the book, are not used but still all must be correct
22DocBook XML files.
23
24ELTF work:
25 template => ELTF replaces ALL ELTF_xxx variables => updated XML file
26 => push to git only if changed
27
28
29eltf_params_template.xml (in git)
30 File used by ELTF to autocreate/update the real parameter
31 file eltf_params_updated.xml.
32
33eltf_params_updated.xml (in git)
34 Real parameter file where ELTF has replaced all ELTF_xx variables with
35 strings, in several cases with multiline strings.
36 No spaces or linefeed allowed in beginning or end of the variable values!
37
38
39xi:include: Each parameter is xi:include'ed in various book files, using
40 the IDs existing in the parameter files.
41 In most cases the 1:st element inside an element with an ID is included
42 using a format like eltf-prereq-apt-get-commands-host/1.
43 In very few cases the element with the ID is included in the book, one
44 example is the target section which has an ID, but which contains
45 multiple subsections, one per target.
46 All IDs in a book must be unique.
47
48DocBook XML: All XML files must be correct DocBook XML files.
49
50Do NOT edit/save the real *updated.xml file with XMLmind to avoid changes
51 not done by ELTF. But it is OK to open the real file in XMLmind to
52 check that the format is correct.
53
54ELTF should autocreate a temporary "real" file but only replace
55 and push the eltf_params_updated.xml if it is changed.
56
57
58make eltf
59 This lists all ELTF_xxx variables and some rules how to treat them
60
61DocBook Format: All elements - rules:
62 Several strict generic XML rules apply for all strings:
63 1. No TABs allowed or any other control chr than "linefeed"
64 2. Only 7-bit ASCII
65 3. Any < > & must be converted to &lt; &gt; and &amp;
66 Similar for any other non-7-bit-ASCII but avoid those!
67 4. No leading spaces or linefeeds when replacing the ELTF_* variable
68 5. No trailing spaces or linefeeds when replacing the ELTF_* variable
69 6. Note: Keep existing spaces before/efter ELTF_* in a few cases.
70
71DocBook Format: <programlisting> - rules: ELTF*PL* variables
72 Several strict rules apply for the multiline string in programlisting
73 in addition to the general XML rules above:
74 7. Max line length < 80 char
75 8. Use backslash (\) to break longer lines
76 9. Use spaces (e.g. 4) to indent continuation lines in programlistings
77 10. No trailing spaces on any line
78 11. No spaces or linefeed immediately after leading <programlisting>
79 12. No spaces or linefeed before trailing </programlisting>
80
81DocBook Format: <ulink> - rules: ELTF_*URL* variables
82 13. ELTF_*URL and corresponding ELTF_*TXTURL shall be identical strings
83 14. Only if the URL is extremely long, the TXTURL can be a separate string
84
85Each target has one section with target parameters:
86 <section id="eltf-target-table-ELTF_T_MANIFEST_DIR">
87 <title>MACHINE ELTF_T_MANIFEST_DIR - Information</title>
88 ..... with many ELTF_ variables ....
89 </section>
90
91 15. If there is only one target. ELTF just replaces ELTF parameters
92
93 16. It there are multiple targets. ELTF copies the section and appends the
94 section the required number of times.
95 Each section ID will become unique: eltf-target-table-ELTF_T_MANIFEST_DIR
96 Each section title will become unique
97
98Tables with target parameters in each target section:
99 17. It is possible for ELTF to append more rows with one parameter each
100 to these tables, because the entire tables are included in the book
101
102Special - NOT YET READY DEFINED how to handle the optionally included
103 Eclipse and its version, but this is a first suggestion:
104 18. Just now ELTF can define ELFT_ECLIPSE_VERSION as a full string
105 with both version number and name,
106 19. MANUALLY if Eclipse is NOT included in the release,
107 the release manager should manually set condition="hidden" on
108 the entire section in the book XML about Eclipse
109
110
111
112BELOW WE TRY TO EXPLAIN EACH ELTF_* variable, but always check with make eltf
113if there are more new variables, missing in this description file.
114
115_____________________________________________________________________________
116ELTF_PL_HOST_PREREQ Multiline list of host prerequisites, e.g. commands
117 like sudo apt-get install xxxx or similar.
118 First line = comment with the complete host name!
119 It is possible to include multiple hosts by just
120 adding an empty line, comment with host name, etc.
121 xi:include eltf-prereq-apt-get-commands-host/1
122 This is a <programlisting>...</programlisting>
123 Example:
124# Host Ubuntu 14.04.5 LTS 64bit
125sudo apt-get update
126sudo apt-get install sed wget subversion git-core coreutils unzip texi2html \
127 texinfo libsdl1.2-dev docbook-utils fop gawk python-pysqlite2 diffstat \
128 make gcc build-essential xsltproc g++ desktop-file-utils chrpath \
129 libgl1-mesa-dev libglu1-mesa-dev autoconf automake groff libtool xterm \
130 libxml-parser-perl
131
132_____________________________________________________________________________
133ELTF_PL_GET_REPO Multiline commands to download the repo tool
134 xi:include eltf-getting-repo-install-command/1
135 This is a <programlisting>...</programlisting>
136 Example:
137mkdir -p ~/bin
138curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
139chmod a+x ~/bin/repo
140export PATH=~/bin:$PATH
141
142_____________________________________________________________________________
143ELTF_EL_REL_VER General parameter string: The version of this Enea
144 NFV Access release. Major version and optional .Minor
145 Typically created from MAJOR and MINOR in enea.conf
146 MINOR in enea.conf is empty or contains a dot+minor
147 xi_include EneaLinux_REL_VER/1
148 This is a <phrase>X.x</phrase> used in many places.
149 Examples:
1506
151 or
1526.1
153
154_____________________________________________________________________________
155ELTF_YOCTO_VER General parameter string: Yocto version, created
156 from DISTRO in poky.ent
157 xi:include Yocto_VER/1
158 This is a <phrase>X.x</phrase> used in many places.
159 Example:
1602.1
161
162_____________________________________________________________________________
163ELTF_YOCTO_NAME General parameter string: Yocto name (branch), created
164 from DISTRO_NAME_NO_CAP in poky.ent
165 xi:include Yocto_NAME/1
166 This is a <phrase>X.x</phrase> used in many places.
167 Example:
168krogoth
169
170_____________________________________________________________________________
171ELTF_YOCTO_PROJ_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL
172ELTF_YOCTO_PROJ_DOWNLOAD_URL strings with correct Yocto version string
173 at the end, typically without "dot".
174 xi:include ULINK_YOCTO_PROJECT_DOWNLOAD/1
175 This is an <ulink url="...">...</ulink>
176 Example:
177http://www.yoctoproject.org/downloads/core/krogoth/21
178
179_____________________________________________________________________________
180ELTF_EL_DOWNLOAD_TXTURL General parameters. These two are IDENTICAL strings
181ELTF_EL_DOWNLOAD_URL and shall be the http:/..... address where
182 Enea NFV Access can be downloaded
183 Often containing same version as in ELTF_EL_REL_VER
184 xi:include ULINK_ENEA_LINUX_URL/1
185 This is an <ulink url="...">...</ulink>
186 Example:
187http://linux.enea.com/6
188
189_____________________________________________________________________________
190ELTF_PL_CLONE_W_REPO Multiline commands to run repo to clone everything.
191 Use the variable $MACHINE/default.xml (the text in
192 the book will list the avaiable values of MACHINE,
193 taken from the manifest repository)
194 xi:include eltf-repo-cloning-enea-linux/1
195 This is a <programlisting>...</programlisting>
196 Example:
197mkdir enea-linux
198cd enea-linux
199repo init -u git@git.enea.com:linux/manifests/el_manifests-virtualization.git \
200 -b refs/tags/EL6 -m $MACHINE/default.xml
201repo sync
202
203_____________________________________________________________________________
204ELTF_ECLIPSE_VERSION Optional general parameter string.
205 NOT YET READY DEFINED
206 Just now a release manage must manually set
207 condition="hidden" on the Eclipse section,
208 if Eclipse is not included in the release.
209 ELTF just replaces ELTF_ECLIPSE_VERSION with a full
210 string with "X.Y (name)"
211 It includes the ID and can only be ONCE in the book.
212 xi:include eltf-eclipse-version-row
213 Example.
2144.5 (Mars)
215
216
217_____________________________________________________________________________
218ELTF_T_* All these are in each target (MACHINE) and ELTF
219 must separately replace them with strings for
220 each target
221 NOTE: All (except the MANIFEST_DIR) are in rows
222 in a table and ELTF can select to append
223 more parameters by adding more rows
224
225_____________________________________________________________________________
226ELTF_T_MANIFEST_DIR This happens to be in two places. Must be exactly
227ELTF_T_MANIFEST_DIR the directory name in the manifest, e.g. same
228 as the MACHINE names in $MACHINE/default.xml.
229 In book: a) Part of section ID
230 b) Part of section title
231 Examples:
232p2041rgb
233 or
234ls1021aiot
235 or
236qemuarm
237
238_____________________________________________________________________________
239ELTF_T_NAME Target specific: "Target Official Name"
240 NOT same as the target directory name in most cases.
241 In book: An <entry> element in a row
242 Examples:
243P2041RGB
244 or
245LS1021a-IoT
246 or
247qemuarm
248
249_____________________________________________________________________________
250ELTF_T_ARC_DESC Target specific: "Architecture and Description"
251 It can be a short identification string or
252 it can be a longer descriptive sentence.
253 In book: An <entry> element in a row
254 Examples:
255Power, e500mc
256 or
257ARM Cortex-A7
258
259_____________________________________________________________________________
260ELTF_T_DS_TXTURL Target specific: "Link to target datasheet. These
261ELTF_T_DS_URL two usually are IDENTICAL strings with correct
262 hyperlink to the target's official datasheet.
263 In book: an <ulink url="...">...</ulink>
264 Only if the link is VERY LONG, the text part shall
265 instead be a descriptive string (see 2:nd example).
266 NOTE: Also here no spaces or line-feeds!
267 Examples:
268url="http://wiki.qemu.org">http://wiki.qemu.org
269or
270url="http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/qoriq-arm-processors/qoriq-ls1021a-iot-gateway-reference-design:LS1021A-IoT">link to NXP's datasheet
271
272_____________________________________________________________________________
273ELTF_T_POKY_VER Target specific: "Poky version" created either
274 from POKYVERSION in poky.ent
275 or using a hashvalue with a leading string, in
276 which case it may be different per target.
277 In book: An <entry> in a row
278 Examples:
27915.0.0
280or
281Git commit id: 75ca53211488a3e268037a44ee2a7ac5c7181bd2
282
283_____________________________________________________________________________
284ELTF_T_GCC_VER Target specific: "GCC Version". Should be in poky
285 but not easy to find among various parameters.
286 ELTF would extract it from build logs building SDK
287 and it is possibly different per target.
288 In book: An <entry> in a row
289 Example:
2905.3
291
292_____________________________________________________________________________
293ELTF_T_KERN_VER Target specific: "Linux Kernel Version". Often
294 different per target.
295 In book: An <entry> in a row
296 Example:
2973.12
298
299_____________________________________________________________________________
300ELTF_T_DRIVERS Target specific: "Supported Drivers". This is a
301 comma-separated list of driver names.
302 ELTF should create the list in same order for each
303 target, e.g. alphabetic migth be OK.
304 In book: An <entry> in a row
305 Example:
306Ethernet, I2C, SPI, PCI, USB, SD/SDHC/SDXC
307
308
309_____________________________________________________________________________
310ELTF_T_EL_RPM_TXTURL Target specific: "Enea rpm folder for downloading
311ELTF_T_EL_RPM_URL RPM packages for this target". These two are
312 INDENTICAL strings with hyperlink to the web site
313 at Enea where the customer can download RPMs
314 Note: Often the ELFT_EL_REL_VER value and
315 the ELTF_T_MANIFEST_DIR are used in the link.
316 In book: an <ulink url="...">...</ulink>
317 Example:
318url="https://linux.enea.com/6/ls1021aiot/rpm">https://linux.enea.com/6/ls1021aiot/rpm
319
320_____________________________________________________________________________
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/6wind_cloudinit.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/6wind_cloudinit.png
deleted file mode 100755
index 36264e1..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/6wind_cloudinit.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/add_output.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/add_output.png
deleted file mode 100755
index e814d3d..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/add_output.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/coss_vnf_inst.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/coss_vnf_inst.png
deleted file mode 100755
index 862b408..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/coss_vnf_inst.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/cosstream_cloudinit.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/cosstream_cloudinit.png
deleted file mode 100755
index 2a31213..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/cosstream_cloudinit.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_interface.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_interface.png
deleted file mode 100755
index 5344a9a..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_interface.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_ovs_bridge.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_ovs_bridge.png
deleted file mode 100755
index ec8882f..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/create_ovs_bridge.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_cloudinit.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_cloudinit.png
deleted file mode 100755
index 7ce7821..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_cloudinit.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port1.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port1.png
deleted file mode 100755
index 9eee61c..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port1.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port2.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port2.png
deleted file mode 100755
index 9d97543..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port2.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port3.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port3.png
deleted file mode 100755
index 1f33ea7..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/fortios_port3.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/main_net_int.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/main_net_int.png
deleted file mode 100755
index 97e5de6..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/main_net_int.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_6wind.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_6wind.png
deleted file mode 100755
index a0d8210..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_6wind.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_clav_coss.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_clav_coss.png
deleted file mode 100755
index 5704d6a..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_clav_coss.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_fortios.png b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_fortios.png
deleted file mode 100755
index 3c6b2de..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/images/onboard_fortios.png
+++ /dev/null
Binary files differ
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/instantiation.xml b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/instantiation.xml
deleted file mode 100644
index 90ffb23..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/instantiation.xml
+++ /dev/null
@@ -1,126 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="instantiation">
3 <title>Instantiation</title>
4
5 <para>When a VNF is onboarded and available in the VNF catalog, it can be
6 instantiated (deployed) on connected uCPE devices. The instantiation wizard uses
7 the configurations provided when the VNF is onboarded, as a template for
8 instantiation. Before the instantiation, however, the uCPE device needs
9 to be prepared:</para>
10
11 <orderedlist>
12 <listitem>
13 <para>Physical NICs used with the VNF directly (through SR-IOV or PCI
14 Passthrough) or indirectly (through bridges) need to be configured
15 (Device-&gt;Configuration-&gt;OpenVSwitch-&gt;Host Interfaces).</para>
16
17 <note>
18 <para>Before configuring any physical NICs determine which is used for
19 managing the uCPE device. Altering the configuration of a NIC may cause
20 connectivity issues.</para>
21 </note>
22 </listitem>
23
24 <listitem>
25 <para>Add any needed bridges, connecting them to the physical NICs
26 previously configured or making them integration bridges (without
27 physical NIC) for service chaining.</para>
28 </listitem>
29 </orderedlist>
30
31 <para>Once the physical NICs and bridges are configured, the VNF can be
32 instantiated using the Instantiation Wizard.</para>
33
34 <section id="using_wiz">
35 <title>Using the Instantiation Wizard</title>
36
37 <orderedlist>
38 <listitem>
39 <para>Enter the Instantiation Wizard by accessing VNF-&gt;Instances
40 and hitting <literal>Add</literal>.</para>
41 </listitem>
42
43 <listitem>
44 <para>Fill out the following mandatory fields:</para>
45
46 <itemizedlist spacing="compact">
47 <listitem>
48 <para>Name (a descriptive name).</para>
49 </listitem>
50
51 <listitem>
52 <para>Device (the uCPE device to instantiate the VNF on).</para>
53 </listitem>
54
55 <listitem>
56 <para>Networking Configuration:</para>
57
58 <itemizedlist spacing="compact">
59 <listitem>
60 <para>Connect each configured NIC with a bridge, SR-IOV or PCI
61 Passthrough.</para>
62 </listitem>
63
64 <listitem>
65 <para>Set up each NIC with a driver method (DPDK or
66 e1000).</para>
67 </listitem>
68 </itemizedlist>
69
70 <note>
71 <para>All configured NICs must be set up before instantiating a
72 VNF. Failure to do so will end in a failed instantiation.</para>
73 </note>
74 </listitem>
75 </itemizedlist>
76 </listitem>
77
78 <listitem>
79 <para>Add VNF specific configuration by uploading a Cloud-Init file
80 (when the Cloud-Init is used).</para>
81 </listitem>
82
83 <listitem>
84 <para>Add any VNF specific files (e.g license files).</para>
85 </listitem>
86
87 <listitem>
88 <para>Hit the <literal>Create</literal> button to deploy the VNF.</para>
89 </listitem>
90 </orderedlist>
91 </section>
92
93 <section id="enter_console">
94 <title>Entering the VNF Console</title>
95
96 <para>Once the VNF is deployed, the VNF console can be entered using SSH
97 and virsh commands. The VNF Console is a typical starting point for
98 determining a successful deployment and configuring a VNF beyond Day
99 Zero.</para>
100
101 <orderedlist spacing="compact">
102 <listitem>
103 <para>SSH to the uCPE device from the Enea uCPE Manager
104 (Device-&gt;SSH) with default user and password:
105 <literal>root</literal>.</para>
106 </listitem>
107
108 <listitem>
109 <para>In SSH:</para>
110
111 <orderedlist>
112 <listitem>
113 <para>Use the <command>virsh list</command> command to list all
114 running VNFs and to determine the VNF's instance number.</para>
115 </listitem>
116
117 <listitem>
118 <para>Use the <command>virsh console &lt;instance
119 number&gt;</command> command to enter the VNF specific
120 console.</para>
121 </listitem>
122 </orderedlist>
123 </listitem>
124 </orderedlist>
125 </section>
126</chapter>
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/introduction.xml b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/introduction.xml
deleted file mode 100644
index d216d7a..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/introduction.xml
+++ /dev/null
@@ -1,90 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="intro">
3 <title>Introduction</title>
4
5 <para>This document describes the process of onboarding a new VNF onto the
6 Enea uCPE Manager so that it can subsequently instantiate and run the VNF on
7 one or more uCPE devices.</para>
8
9 <section id="prereq">
10 <title>Prerequisites</title>
11
12 <para>In order to onboard a new VNF into the Enea uCPE Manager VNF
13 catalog, specific prerequisites must be known and met:</para>
14
15 <itemizedlist spacing="compact">
16 <listitem>
17 <para>Access to the VNF QCOW2 image.</para>
18 </listitem>
19
20 <listitem>
21 <para>VNF Flavor information:</para>
22
23 <itemizedlist spacing="compact">
24 <listitem>
25 <para>Amount of RAM required.</para>
26 </listitem>
27
28 <listitem>
29 <para>Number of vCPUs needed.</para>
30 </listitem>
31
32 <listitem>
33 <para>Size of disk required.</para>
34 </listitem>
35 </itemizedlist>
36 </listitem>
37
38 <listitem>
39 <para>Network configuration:</para>
40
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Number of Network Interfaces to be used for the VNF.</para>
44 </listitem>
45
46 <listitem>
47 <para>The roles of each network interface (MGMT, WAN, LAN).</para>
48 </listitem>
49
50 <listitem>
51 <para>Driver access for each Network Interface (DPDK, SR-IOV or
52 PCI Passthrough).</para>
53 </listitem>
54
55 <listitem>
56 <para>IP Configuration for each Network Interface (DHCP, Static
57 IP).</para>
58 </listitem>
59 </itemizedlist>
60 </listitem>
61
62 <listitem>
63 <para>Day zero configuration method for the VNF:</para>
64
65 <itemizedlist spacing="compact">
66 <listitem>
67 <para>Cloud-Init, ConfigDrive, NoCloud, raw ISO or none.</para>
68 </listitem>
69
70 <listitem>
71 <para>Cloud-Init mount method (CDROM or disk).</para>
72 </listitem>
73
74 <listitem>
75 <para>Cloud-Init file structure to be used.</para>
76 </listitem>
77
78 <listitem>
79 <para>Availability of a VNF specific day-zero configuration for
80 setting up the VNFs day zero settings.</para>
81 </listitem>
82 </itemizedlist>
83 </listitem>
84 </itemizedlist>
85
86 <para>All this information is provided with each VNF's Getting Started
87 Guide, with configurations typically specific to the intended use case of
88 the VNF.</para>
89 </section>
90</chapter>
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_configurations.xml b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_configurations.xml
deleted file mode 100644
index 3b37328..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_configurations.xml
+++ /dev/null
@@ -1,378 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="vnf_configs">
3 <title>Detailed VNF Configurations</title>
4
5 <para><remark>Perhaps an introduction is needed</remark></para>
6
7 <section id="wind_turbo_router">
8 <title>6Wind Turbo Router</title>
9
10 <remark>Perhaps an introduction is needed</remark>
11
12 <section id="onboard_turbo">
13 <title>Onboarding</title>
14
15 <para>The required fields and their specifications, need to be filled
16 with the following information in order onboard the VNF:</para>
17
18 <table>
19 <title>Main Fields Data</title>
20
21 <tgroup cols="2">
22 <colspec align="center" />
23
24 <thead>
25 <row>
26 <entry align="center">Field</entry>
27
28 <entry align="center">Specification</entry>
29 </row>
30 </thead>
31
32 <tbody>
33 <row>
34 <entry>VM Image File</entry>
35
36 <entry>Choose the 6Wind Turbo Router QCOW image file.</entry>
37 </row>
38
39 <row>
40 <entry>Image Format</entry>
41
42 <entry>QCOW2</entry>
43 </row>
44
45 <row>
46 <entry>VNF Type Name</entry>
47
48 <entry>Turbo_Router</entry>
49 </row>
50
51 <row>
52 <entry>Description</entry>
53
54 <entry>6Winds Turbo Router</entry>
55 </row>
56
57 <row>
58 <entry>Version</entry>
59
60 <entry>1.0</entry>
61 </row>
62
63 <row>
64 <entry>Memory in MB</entry>
65
66 <entry>6244</entry>
67 </row>
68
69 <row>
70 <entry>Nr. of CPUs</entry>
71
72 <entry>3</entry>
73 </row>
74
75 <row>
76 <entry>Storage in GB</entry>
77
78 <entry>10</entry>
79 </row>
80 </tbody>
81 </tgroup>
82 </table>
83
84 <figure>
85 <title>Onboarding the 6wind VNF</title>
86
87 <mediaobject>
88 <imageobject>
89 <imagedata align="center" fileref="images/onboard_6wind.png" />
90 </imageobject>
91 </mediaobject>
92 </figure>
93
94 <para>Interfaces: Create 1 interface, it will instantiate the
95 DPDK.</para>
96
97 <para>Cloud Init:</para>
98
99 <figure>
100 <title>6wind Cloud-Init</title>
101
102 <mediaobject>
103 <imageobject>
104 <imagedata align="center" fileref="images/6wind_cloudinit.png" />
105 </imageobject>
106 </mediaobject>
107 </figure>
108
109 <para>Properties: There are no specific configurations needed.</para>
110 </section>
111
112 <section id="instant_turbo">
113 <title>Instantiation</title>
114
115 <para>You can use a random text file as the Cloud-Init file if you do
116 not wish to set any specific details during the setup stage.
117 Alternatively, you can create a Cloud-Init configuration file according
118 to 6wind documentation, to change the root password:<programlisting>#cloud-config
119chpasswd:
120list: |
121root:karm</programlisting>Interfaces: Set up 1 interface (the DPDK with the
122 preconfigured bridge).</para>
123 </section>
124 </section>
125
126 <section id="clav_cosstream">
127 <title>Clavister CosStream</title>
128
129 <remark>Perhaps an introduction is needed</remark>
130
131 <section id="costream_onbr">
132 <title>Onboarding</title>
133
134 <para>The required fields and their specifications, need to be filled
135 with the following information in order onboard the VNF:</para>
136
137 <table>
138 <title>Main Fields Data</title>
139
140 <tgroup cols="2">
141 <colspec align="center" />
142
143 <thead>
144 <row>
145 <entry align="center">Field</entry>
146
147 <entry align="center">Specification</entry>
148 </row>
149 </thead>
150
151 <tbody>
152 <row>
153 <entry>VM Image File</entry>
154
155 <entry>clavister-cos-stream-3.20.00.25-virtual-x64-generic.qcow2</entry>
156 </row>
157
158 <row>
159 <entry>Image Format</entry>
160
161 <entry>QCOW2</entry>
162 </row>
163
164 <row>
165 <entry>VNF Type Name</entry>
166
167 <entry>CosStream</entry>
168 </row>
169
170 <row>
171 <entry>Description</entry>
172
173 <entry>Clavister CosStream</entry>
174 </row>
175
176 <row>
177 <entry>Version</entry>
178
179 <entry>1.0</entry>
180 </row>
181
182 <row>
183 <entry>Memory in MB</entry>
184
185 <entry>1024</entry>
186 </row>
187
188 <row>
189 <entry>Nr. of CPUs</entry>
190
191 <entry>4</entry>
192 </row>
193
194 <row>
195 <entry>Storage in GB</entry>
196
197 <entry>20</entry>
198 </row>
199 </tbody>
200 </tgroup>
201 </table>
202
203 <para><figure>
204 <title>Onboarding the CosStream VNF - Infertaces
205 Configuration</title>
206
207 <mediaobject>
208 <imageobject>
209 <imagedata align="center" fileref="images/onboard_clav_coss.png"
210 scale="60" />
211 </imageobject>
212 </mediaobject>
213 </figure><figure>
214 <title>Cloud-Init Configuration</title>
215
216 <mediaobject>
217 <imageobject>
218 <imagedata align="center"
219 fileref="images/cosstream_cloudinit.png" />
220 </imageobject>
221 </mediaobject>
222 </figure>Properties: There are no specific configurations
223 needed.</para>
224 </section>
225
226 <section id="costream_inst">
227 <title>Instantiation</title>
228
229 <para>Networking Support: In order to run Clavister CosStream, you must
230 do the following on the Clavister host:<programlisting>create if 0000:07:00.1 igb_uio
231create bridge ovsbr0 0000:07:00.1</programlisting>Alternatively, use the uCPE
232 Manager to create the interface and bridge prior to instantiating the
233 VNF:</para>
234
235 <figure>
236 <title>Create an interface</title>
237
238 <mediaobject>
239 <imageobject>
240 <imagedata align="center" fileref="images/create_interface.png" />
241 </imageobject>
242 </mediaobject>
243 </figure>
244
245 <figure>
246 <title>Create an OVS Bridge</title>
247
248 <mediaobject>
249 <imageobject>
250 <imagedata align="center" fileref="images/create_ovs_bridge.png"
251 scale="70" />
252 </imageobject>
253 </mediaobject>
254 </figure>
255
256 <figure>
257 <title>Instantiate the VNF</title>
258
259 <mediaobject>
260 <imageobject>
261 <imagedata align="center" fileref="images/coss_vnf_inst.png"
262 scale="70" />
263 </imageobject>
264 </mediaobject>
265 </figure>
266
267 <figure>
268 <title>Adding a main Network Interface</title>
269
270 <mediaobject>
271 <imageobject>
272 <imagedata align="center" fileref="images/main_net_int.png"
273 scale="70" />
274 </imageobject>
275 </mediaobject>
276 </figure>
277
278 <figure>
279 <title>Adding Output</title>
280
281 <mediaobject>
282 <imageobject>
283 <imagedata align="center" fileref="images/add_output.png"
284 scale="70" />
285 </imageobject>
286 </mediaobject>
287 </figure>
288 </section>
289 </section>
290
291 <section id="fortios">
292 <title>Fortios</title>
293
294 <remark>Perhaps an introduction is needed</remark>
295
296 <section id="fortios_onbr">
297 <title>Onboarding</title>
298
299 <para>To onboard this VNF three interfaces need to be created:</para>
300
301 <figure>
302 <title>Onboarding Fortios - Interface Creation</title>
303
304 <mediaobject>
305 <imageobject>
306 <imagedata align="center" fileref="images/onboard_fortios.png"
307 scale="60" />
308 </imageobject>
309 </mediaobject>
310 </figure>
311
312 <para>Cloud Init: Fortios requires a license file in addition to a user
313 data Cloud-Init configuration file:</para>
314
315 <figure>
316 <title>Adding the License file</title>
317
318 <mediaobject>
319 <imageobject>
320 <imagedata align="center" fileref="images/fortios_cloudinit.png"
321 scale="60" />
322 </imageobject>
323 </mediaobject>
324 </figure>
325 </section>
326
327 <section id="fortios_inst">
328 <title>Instantiation</title>
329
330 <para>This VNF requires two Cloud-Init files to be specified:</para>
331
332 <itemizedlist spacing="compact">
333 <listitem>
334 <para>Cloud-init.txt</para>
335 </listitem>
336
337 <listitem>
338 <para>License.txt</para>
339 </listitem>
340 </itemizedlist>
341
342 <para>Three ports also need to be created:</para>
343
344 <figure>
345 <title>Port 1</title>
346
347 <mediaobject>
348 <imageobject>
349 <imagedata align="center" fileref="images/fortios_port1.png"
350 scale="60" />
351 </imageobject>
352 </mediaobject>
353 </figure>
354
355 <figure>
356 <title>Port 2</title>
357
358 <mediaobject>
359 <imageobject>
360 <imagedata align="center" fileref="images/fortios_port2.png"
361 scale="60" />
362 </imageobject>
363 </mediaobject>
364 </figure>
365
366 <figure>
367 <title>Port 3</title>
368
369 <mediaobject>
370 <imageobject>
371 <imagedata align="center" fileref="images/fortios_port3.png"
372 scale="60" />
373 </imageobject>
374 </mediaobject>
375 </figure>
376 </section>
377 </section>
378</chapter> \ No newline at end of file
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_onboarding.xml b/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_onboarding.xml
deleted file mode 100644
index f0d4e8f..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/doc/vnf_onboarding.xml
+++ /dev/null
@@ -1,173 +0,0 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="vnf_onboard">
3 <title>VNF Onboarding</title>
4
5 <para>The onboarding of a VNF means adding it to the Enea uCPE Manager VNF
6 Catalog and preparing it for instantiation (deployment on connected uCPE devices).
7 This is accomplished using the Enea uCPE Manager Onboarding Wizard, a
8 graphical user interface specifically designed to make VNF onboarding simple
9 and fast.</para>
10
11 <para>Typically, the VNF's Getting Started Guide contains all necessary
12 information needed to onboard a VNF using the Onboarding Wizard. This
13 present guide however, provides a number of examples of how to onboard
14 specific commercial VNFs.</para>
15
16 <para>The following sections detail the basic steps needed to successfully
17 onboard a VNF in the Enea uCPE Manager.</para>
18
19 <section id="retrieve_art">
20 <title>Retrieving Artifacts</title>
21
22 <para>The user must first retrieve the necessary artifacts from the VNF
23 vendor:</para>
24
25 <orderedlist>
26 <listitem>
27 <para>Download the VNF from the commercial vendor.</para>
28 </listitem>
29
30 <listitem>
31 <para>Get any VNF specific license from the VNF vendor.</para>
32
33 <note>
34 <para>There are no standard ways of managing VNF licenses, therefore
35 no general guidelines can be provided. One example of license
36 handling that can be employed in the uCPE Manager is the adding of a
37 license during the Cloud-Init setup. The ConfigDrive value is
38 provided in the Fortios specific guidelines.</para>
39 </note>
40 </listitem>
41
42 <listitem>
43 <para>Get access to the VNF specific VNF Manager for day 1 and 2
44 configuration (in cloud or for local deployment).</para>
45 </listitem>
46
47 <listitem>
48 <para>Procure the Getting Started Guide from the VNF vendor,
49 preferably for KVM deployment for VNF specific configuration
50 information.</para>
51 </listitem>
52 </orderedlist>
53 </section>
54
55 <section id="onboard_prep">
56 <title>Preparation</title>
57
58 <para>Once all needed downloadables, documentation and more have been
59 attained, preparation for onboarding must be completed:</para>
60
61 <orderedlist>
62 <listitem>
63 <para>Determine the use-case and performance requirements of the VNF
64 you wish to deploy.</para>
65
66 <itemizedlist>
67 <listitem>
68 <para>This decides what resources the VNF is configured for, along
69 with networking and day zero configurations.</para>
70
71 <para>Generally, the Getting Started Guide for the VNF provides
72 guidelines for resource allocation, but since performance is
73 dependent on hardware capacity, the right resource allocation for
74 deployment is typically determined through benchmarking.</para>
75 </listitem>
76
77 <listitem>
78 <para>Determine the amount of hardware resources needed for the
79 VNF (RAM, CPUs and Disk size).</para>
80 </listitem>
81
82 <listitem>
83 <para>Determine how many Network Interfaces the VNF shall
84 use.</para>
85 </listitem>
86 </itemizedlist>
87 </listitem>
88
89 <listitem>
90 <para>Determine the day zero configuration method from the VNF Getting
91 Started guidelines.</para>
92
93 <note>
94 <para>For many VNFs, day zero configuration can be skipped in early
95 onboarding efforts when automation is not of importance.</para>
96 </note>
97 </listitem>
98
99 <listitem>
100 <para>Determine any requirements needed by the Cloud-Init file
101 structure and the content needed for the VNF when Cloud-Init is
102 used.</para>
103 </listitem>
104 </orderedlist>
105 </section>
106
107 <section id="onboarding">
108 <title>Onboarding the VNF</title>
109
110 <orderedlist>
111 <listitem>
112 <para>Enter the Enea uCPE Manager and choose VNF-&gt;Descriptors in
113 the GUI.</para>
114 </listitem>
115
116 <listitem>
117 <para>Click <literal>Onboard</literal> to start the onboarding
118 procedure.</para>
119 </listitem>
120
121 <listitem>
122 <para>Fill in all mandatory fields in the popup menu: Name, Image,
123 RAM, CPUs, Disk.</para>
124 </listitem>
125
126 <listitem>
127 <para>Define the VNF's Network Interfaces and give them descriptive
128 names.</para>
129 </listitem>
130
131 <listitem>
132 <para>Configure the Cloud-Init settings, starting with the
133 Datasource:</para>
134
135 <itemizedlist spacing="compact">
136 <listitem>
137 <para>Choose <literal>None</literal> if Cloud-Init is not
138 used.</para>
139 </listitem>
140
141 <listitem>
142 <para>Choose <literal>ConfigDrive</literal>,
143 <literal>NoCloud</literal> or <literal>ISO</literal> depending on
144 the VNF specific Cloud-Init implementation.</para>
145 </listitem>
146
147 <listitem>
148 <para>Choose the Cloud-Init mount method based on the VNF specific
149 Cloud-Init implementation.</para>
150 </listitem>
151
152 <listitem>
153 <para>Configure any VNF specific Cloud-Init files according to VNF
154 specific documentation.</para>
155 </listitem>
156 </itemizedlist>
157 </listitem>
158
159 <listitem>
160 <para>Additional Properties (in the Properties Tab) are typically not
161 needed and can be ignored.</para>
162 </listitem>
163
164 <listitem>
165 <para>Click <literal>Onboard</literal> to add the VNF to the Enea uCPE
166 Manager VNF Catalog.</para>
167 </listitem>
168 </orderedlist>
169
170 <para>When the onboarding is complete, the VNF will appear in the VNF
171 Catalog and can be used for deploying services on the uCPE devices.</para>
172 </section>
173</chapter>
diff --git a/doc/book-enea-nfv-access-vnf-onboarding-guide/swcomp.mk b/doc/book-enea-nfv-access-vnf-onboarding-guide/swcomp.mk
deleted file mode 100755
index 2e66101..0000000
--- a/doc/book-enea-nfv-access-vnf-onboarding-guide/swcomp.mk
+++ /dev/null
@@ -1,10 +0,0 @@
1# Component build specification
2
3# Version of THIS book
4BOOK_VER ?= $(REL_VER)-dev
5
6DOCBOOK_SRC := $(COMP)/swcomp.mk $(COMP)/doc/book.xml $(shell find $(COMP)/doc -type f \( -name "*.xml" -o -name "*.svg" -o -name "*.png" \) ! -name "book.xml" -print)
7
8BOOKPACKAGES := book-enea-nfv-access-vnf-onboarding-guide
9BOOKDESC_$(BOOKPACKAGES) := "Enea NFV Access $(PROD_VER) VNF Onboarding Guide"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)