summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSona Sarmadi <sona.sarmadi@enea.com>2018-08-28 07:11:55 +0200
committerSona Sarmadi <sona.sarmadi@enea.com>2018-08-29 12:20:43 +0200
commita6d4e68bf121a3d0e1e626f4d288ad2b594947e2 (patch)
treeca5a1852672f31e3d9ae3eb86c499891bee6e80a
parent77870b91014d5f28f2555149db1c8ef193f24f3b (diff)
downloadel_releases-rt-a6d4e68bf121a3d0e1e626f4d288ad2b594947e2.tar.gz
First draft of doc copied from standard profile
-updated rel-info -updated UG -added new chapterdoc for RT: Real-Time in Enea Linux Change-Id: If8cec0e29d1d6aa4a09507881d815af13dd68ee2 Signed-off-by: Sona Sarmadi <sona.sarmadi@enea.com>
-rw-r--r--doc/Makefile381
-rw-r--r--doc/README21
-rw-r--r--doc/book-enea-linux-open-source/doc/README4
-rw-r--r--doc/book-enea-linux-open-source/doc/about.xml12
-rw-r--r--doc/book-enea-linux-open-source/doc/book.xml15
-rw-r--r--doc/book-enea-linux-open-source/doc/licenses.xml6521
-rw-r--r--doc/book-enea-linux-open-source/swcomp.mk10
-rw-r--r--doc/book-enea-linux-release-info/doc/about_release.xml235
-rw-r--r--doc/book-enea-linux-release-info/doc/book.xml22
-rw-r--r--doc/book-enea-linux-release-info/doc/build_boot_template.xml34
-rw-r--r--doc/book-enea-linux-release-info/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-linux-release-info/doc/eltf_params_updated.xml282
-rw-r--r--doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt320
-rw-r--r--doc/book-enea-linux-release-info/doc/getting_enea_linux.xml185
-rw-r--r--doc/book-enea-linux-release-info/doc/jiraissues_override.xml32
-rw-r--r--doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml377
-rw-r--r--doc/book-enea-linux-release-info/doc/main_changes.xml54
-rw-r--r--doc/book-enea-linux-release-info/doc/prerequisites.xml34
-rw-r--r--doc/book-enea-linux-release-info/doc/system_requirements.xml159
-rw-r--r--doc/book-enea-linux-release-info/swcomp.mk10
-rw-r--r--doc/book-enea-linux-user-guide/doc/application_development.xml282
-rw-r--r--doc/book-enea-linux-user-guide/doc/book.xml22
-rw-r--r--doc/book-enea-linux-user-guide/doc/eltf_params_template.xml151
-rw-r--r--doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml313
-rw-r--r--doc/book-enea-linux-user-guide/doc/eltf_params_updated_template_how_to_use.txt320
-rw-r--r--doc/book-enea-linux-user-guide/doc/getting_enea_linux.xml145
-rw-r--r--doc/book-enea-linux-user-guide/doc/getting_started.xml108
-rw-r--r--doc/book-enea-linux-user-guide/doc/images/install_new_sw.pngbin0 -> 48962 bytes
-rw-r--r--doc/book-enea-linux-user-guide/doc/images/install_new_sw.svg888
-rw-r--r--doc/book-enea-linux-user-guide/doc/introduction.xml55
-rw-r--r--doc/book-enea-linux-user-guide/doc/preface.xml157
-rw-r--r--doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml101
-rw-r--r--doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml26
-rw-r--r--doc/book-enea-linux-user-guide/doc/troubleshooting.xml10
-rw-r--r--doc/book-enea-linux-user-guide/doc/using_eclipse.xml1225
-rw-r--r--doc/book-enea-linux-user-guide/doc/using_enea_linux.xml806
-rw-r--r--doc/book-enea-linux-user-guide/swcomp.mk10
-rw-r--r--doc/docsrc_common/pardoc-distro.xml27
-rw-r--r--doc/enea-linux-security-report1055
-rw-r--r--doc/gen_known_issues.py122
-rw-r--r--doc/gen_pkgdiff.py237
-rw-r--r--doc/init.mk100
-rw-r--r--doc/initbuildboot.sh115
-rw-r--r--doc/manifest_conf.mk7
44 files changed, 15141 insertions, 0 deletions
diff --git a/doc/Makefile b/doc/Makefile
new file mode 100644
index 0000000..f5ab81f
--- /dev/null
+++ b/doc/Makefile
@@ -0,0 +1,381 @@
1#2017-03-27 Replaced poky autocloning for parameter extraction with XML file updated by the ELTF test system
2#2017-11-24 Added support for pdf download in eclipse
3
4#Path to this subsystem's root directory
5SUBSYSROOT := $(shell pwd)
6
7# NOTE: MANIFESTHASH in manifest_conf.mk needs to be the final release tag before a release
8# The manifest_conf.mk defines MANIFESTHASH and MANIFESTURL and PROFILE_NAME(on front+footers)
9include manifest_conf.mk
10MANIFESTDIR := $(shell echo "$(MANIFESTURL)" | sed 's/.*\///;s/\.git//')
11
12# Further down we extract the list of target manifest file names from the manifest itself
13
14
15
16# ***************** Generic docbuild.git auto-clone + s_docbuild symlink ***
17# This also defines TMPCLONEROOT which optionally can be nondefault using BOOK_GLOBALCLONEROOT=yes or a path
18include init.mk
19
20TMPCLONEROOT_MANIFEST := $(TMPCLONEROOT)/manifest
21
22
23# ******************* AutoGenerated chapter from template and target READMEs *******
24BUILDBOOT_XML := book-enea-linux-release-info/doc/build_boot_generated.xml
25BUILDBOOT_TEMPLATE := book-enea-linux-release-info/doc/build_boot_template.xml
26
27PKGDIFF_GEN_XML := book-enea-linux-release-info/doc/pkgdiff_generated.xml
28JIRA_ISSUES_GEN_XML := book-enea-linux-release-info/doc/jiraissues_generated.xml
29
30MACHINE_LIST_XML := book-enea-linux-release-info/doc/machine_list_generated.xml
31
32ELTF_PARAMS_TEMPLATE := book-enea-linux-release-info/doc/eltf_params_template.xml
33ELTF_PARAMS_UPDATED := book-enea-linux-release-info/doc/eltf_params_updated.xml
34
35
36
37# -----------------------------------------------------
38#Path to DocBook make files and templates
39DOCBOOKMAKE = $(SUBSYSROOT)/s_docbuild/docmake
40DOCBOOKTEMPLATE = $(SUBSYSROOT)/s_docbuild/template
41
42#Path to the OLINK database including leading part of file name (will add -$(FORMAT).db)
43DOCBOOKOLINKDB_BASE = $(SUBSYSROOT)/s_docbuild/olinkdb/olink-targetdb-ose5-master
44
45DOCBOOK_OLINKS ?= yes
46DOCBOOK_FO_USEFOP ?= yes
47DOCBOOK_TO_BOOKDIR ?= yes
48DOCBOOK_CLEANTMP ?= yes
49
50#Components (books) in this subsystem. Now use all books found here
51# COMPONENTS := book-enea-linux-release-info book-enea-linux-open-source
52# COMPONENTS += book-enea-linux-eclipse-open-source
53COMPONENTS := $(shell ls -d book-enea* )
54
55# --------------------------------------------------------------
56ifeq ($(VERBOSE),yes)
57VERB :=
58else
59VERB := @
60endif
61MAKEFLAGS += --no-print-directory
62MAKEFLAGS += --directory $(SUBSYSROOT)
63MAKEFLAGS += --no-builtin-rules --no-builting-variables
64
65# Skip xml validation to make it possible to include xml files with unresolved links
66VALIDATE = no
67
68# BL_LABEL is either given on make command line or using BOOK_VER which have defaults below or a timestamp
69
70# ******************************************************************
71
72# Export all parameters including those on the command line
73export
74
75.PHONY: doc books docusage init initbuild initmanifest initpardoc initbuildboot dist
76
77
78docusage:
79 @echo 'make docusage #Shows this help text'
80 @echo ' DOCBOOK_TOOLS_VERSIONS=yes #Displays./testeltfver.sh DocBook tools versions in this machine'
81 @echo 'make doc #Builds doc. ALSO automatically does all inits if needed'
82 @echo 'make dist BOOK_DIST_DIR=xx/doc #Builds doc as above and copies results to BOOK_DIST_DIR'
83 @echo ' # Does not work with DOCBOOK_TO_BOOKDIR or BOOK_BUILD_DIR'
84 @echo ' BOOK_DIST_ECLIPSE=yes #Currently EclipseHelp formated doc will not be in BOOK_DIST_DIR'
85 @echo ' # unless BOOK_DIST_ECLIPSE is set to yes'
86 @echo 'make init #Init all needed init* below'
87 @echo 'make initbuild #Init s_docbuild Docbook build system and central files'
88 @echo 'make initmanifest #Init s_manifest by cloning, to detect which targets are included'
89 @echo 'make initpardoc #Init s_docsrc_common with extracted parameters/'
90 @echo 'make initbuildboot #Init build_boot chapter from READMEs and template in release info'
91 @echo 'make initissues #Init known issues section from Jira'
92 @echo 'make eltf #Test - displays all ELTF_xxx variables that ELTF shall replace'
93 @echo ' MANIFESTHASH=xxxxx #Option for all inits above to use nondefault manifest version'
94 @echo ' #It shall either be ref/tags/<tagvalue> or a hashvalue'
95 @echo ' #Configured tag or hashvalue $(MANIFESTHASH)'
96 @echo ' #Configured MANIFESTURL $(MANIFESTURL)'
97 @echo ' #Configured PROFILE_NAME $(PROFILE_NAME)'
98 @echo ' DOCBOOK_CLEANTMP=no #Option to keep temp files in doc/ and tmp/'
99 @echo ' BOOK_GLOBALCLONEROOT=yes #Option for all init above to clone all outside the doc directory'
100 @echo ' BOOK_GLOBALCLONEROOT=otherpath #Option for all init above to clone all to given path'
101 @echo 'make clean #Clean results and all s_*, but not any external clones'
102 @echo ''
103 @echo 'Optional parameters for make doc:'
104 @echo ' COMP=<book-directory> #Component (book) to build. Book component names are book-*'
105 @echo ' #Default component/s:'
106 @echo ' $(COMPONENTS)'
107 @echo ' FORMAT=<format> #One of: pdf, html, or eclipse (Default all are built)'
108 @echo ' BL_LABEL=<baseline> #Becomes footer in book (default: from poky enea.conf MAJORMINOR'
109 @echo ' # and with profile name taken from the manifest repo name)'
110 @echo ' DOCBOOK_TO_BOOKDIR=no #(default yes) Avoid moving result to book directory'
111 @echo ' # and avoid erasing common doc and tmp directories'
112 @echo ' BOOKFORCE=yes #Force rebuilding (ignore dependency on file times or BL_LABEL)'
113 @echo ' # Dependency only works if common doc directory is kept'
114 @echo ' BOOKCONDITION="xx;yy;.." #Include XML elements with condition any of xx or yy'
115 @echo ' # (if rebuilding, BOOKFORCE=yes may be needed)'
116 @echo ' # Empty=only default. none=none, all=everything.'
117 @echo ' BOOKDEFAULTCONDITION #Default conditions, if no BOOKCONDITION. Used in book-*/swcomp.mk'
118 @echo ' SHOW_COMMENTS=yes #For proofread. Unhide <remark>..</remark> comments Only PDF'
119 @echo ' BOOKVERBOSE=yes #Verbose info building books'
120 @echo ' DOCBOOK_OLINKS=no #Avoid the olink database in Makefile (in book not using it)'
121 @echo ' DOCBOOK_OLINK_TARGETDB=only #Build a target db for this book (for links into it)'
122 @echo ' DOCBOOK_OLINK_TARGETDB=yes #Build a target db AND build the book'
123 @echo ' #Master olinkdb defined in this Makefile, one per generated format, is:'
124 @echo ' $(DOCBOOKOLINKDB_BASE)_*.db'
125 @echo ' Typical examples:'
126 @echo ' make doc Creates all books, all formats'
127 @echo ' make doc COMP=book-xxxx FORMAT=html'
128 @echo ' make doc COMP=book-xxxx FORMAT=pdf'
129 @echo ' make doc BL_LABEL="Version 1.2.3" Creates all with version in footers and front'
130 @echo ''
131 @echo ' Requires docbook-xsl-1.76.1 or later, docbook-xml 4.2, svg1.1, fop-1.0 + fop-hyph.jar'
132 @echo ' fop + the separate fop-hyph can be found together in package "libfop-java"'
133 @echo ' otherwise fetch fop-hyph.jar and place in same place as fop.jar'
134 @echo ' Requires libxml2-2.7.8 or later, libxslt-1.1.26 or later'
135 @echo ' Requires java machine to run fop (creating PDF). jar for optional FORMAT=eclipse'
136 @echo ' Without jar, the optional EclipseHelp format can not be built'
137 @echo ' tools_book_standalone.mk => libxml2, libxslt, and fop (and to catalog-el.xml)'
138 @echo ' catalog-el.xml => svg, docbook-xml, docbook-xsl'
139ifeq ($(DOCBOOK_TOOLS_VERSIONS),yes)
140 $(VERB)$(MAKE) -f $(DOCBOOKMAKE)/tools_book_standalone.mk book_tools_versions
141endif
142
143# We rely on make doing these in order left to right
144init: initbuild initcommon initmanifest initpardoc initbuildboot initpkgdiff initissues
145pullall: pullbuild
146
147# If no COMP, iterate over books-* in COMPONENTS with make doc
148ifeq ($(COMP),)
149doc:
150ifneq ($(filter book-%, $(COMPONENTS)),)
151 $(VERB)for comp in $(filter book-%, $(COMPONENTS)); do \
152 $(MAKE) doc COMP=$$comp; \
153 done
154endif
155
156else
157include $(SUBSYSROOT)/$(COMP)/swcomp.mk
158
159doc: books
160 @#
161endif
162
163dist: doc
164 @echo "Copying resulting built documents to $(BOOK_DIST_DIR)"
165 $(VERB)if [ "$(BOOK_DIST_DIR)" = "" ]; then echo "ERROR: Missing BOOK_DIST_DIR parameter, typically shall be xxx/doc"; exit 10; fi
166 $(VERB)if [ ! -d "`dirname $(BOOK_DIST_DIR)`" ]; then echo "ERROR: Missing parent for BOOK_DIST_DIR"; exit 10; fi
167 $(VERB)if [ -f "$(BOOK_DIST_DIR)/Makefile" ]; then echo "ERROR: Wrong BOOK_DIST_DIR, contains a Makefile?"; exit 10; fi
168 $(VERB)if [ ! -d "$(BOOK_DIST_DIR)" ]; then mkdir -p "$(BOOK_DIST_DIR)" ; fi
169 $(VERB)for book in $(COMPONENTS); do \
170 if ls -d $$book/book*.pdf >/dev/null 2>&1; then cp --preserve=timestamps $$book/book*.pdf "$(BOOK_DIST_DIR)" ; fi ; \
171 if ls -d $$book/html >/dev/null 2>&1; then cp -r --preserve=timestamps $$book/html "$(BOOK_DIST_DIR)" ; fi ; \
172 if [ "$(BOOK_DIST_ECLIPSE)" = "yes" ]; then \
173 if ls -d $$book/eclipse >/dev/null 2>&1; then cp -r --preserve=timestamps $$book/eclipse "$(BOOK_DIST_DIR)" ; fi ; \
174 fi ; \
175 done
176
177# Default FORMATs
178ifeq ($(FORMAT),)
179FORMAT=html pdf eclipse
180endif
181
182
183books: init
184# BOOKPACKAGES is defined in all book-*/swcomp.mk
185 $(VERB)DISTRO_VERSION=`egrep '"EneaLinux_REL_VER"><phrase>' $(ELTF_PARAMS_UPDATED) | sed 's/.*<phrase>//;s/<\/phrase>.*//'` ; \
186 BOOKVER="Profile $(PROFILE_NAME)-$$DISTRO_VERSION" ; \
187 for book in $(BOOKPACKAGES); do \
188 for format in $(FORMAT); do \
189 $(MAKE) -f $(DOCBOOKMAKE)/make_docbook_standalone.mk BOOK=$$book FORMAT=$$format BOOK_VER="$$BOOKVER" books || exit 10; \
190 if [ $$format = eclipse ]; then \
191 if [ ! -f $$COMP/$$book.pdf ]; then \
192 $(MAKE) -f $(DOCBOOKMAKE)/make_docbook_standalone.mk BOOK=$$book FORMAT=pdf BOOK_VER="$$BOOKVER" books || exit 10; \
193 fi; \
194 cp $$COMP/$$book.pdf $$COMP/eclipse/plugins/com.enea.doc.book-*/. ; \
195 fi ; \
196 done ; \
197 done
198ifeq ($(DOCBOOK_TO_BOOKDIR),yes)
199 $(VERB)rm -rf doc tmp
200else
201ifeq ($(DOCBOOK_CLEANTMP),yes)
202# keep only doc/pdf/book-*.pdf doc/eclipse/plugins/com.enea.doc.book-* but delete doc/eclipse/plugins/com.enea.doc.book-*/done*
203 $(VERB)rm -rf tmp 2>/dev/null ; rm -rf doc/pdf/book-*/ ; rm -rf doc/eclipse/plugins/com.enea.doc.book-*/done* 2>/dev/null
204endif
205endif
206
207# cleaninit cleans ALL tmpcommon and all s_*
208clean: cleaninit cleanbuildboot cleanpkgdiff cleanissues cleanmanifest
209 @echo "Cleaning build results and temporary files"
210 $(VERB)rm -rf doc tmp 2>/dev/null
211ifneq ($(filter book-%, $(COMPONENTS)),)
212 $(VERB)for comp in $(filter book-%, $(COMPONENTS)); do \
213 rm -rf $$comp/book*.pdf $$comp/html $$comp/eclipse 2>/dev/null; \
214 done
215 $(VERB)rm -rf doc tmp 2>/dev/null
216endif
217
218
219# ******************************************************************
220# ****************** SUPPORT FOR TARGETS ***************************
221initmanifest: s_manifest
222
223
224# -----------------------------------------
225# We only clone the manifest to be able to autodetect which targets are in it
226# git clone requires only the tag string e.g. EL6, not the entire ref/tags/EL6 that repo requires
227# git clone -b hashvalue is not supported. We must first clone, then git checkout hashvalue
228# These steps work also for a tag so we could use the same stepwise code
229
230s_manifest: $(TMPCLONEROOT_MANIFEST)
231 $(VERB)rm s_manifest 2>/dev/null; ln -s $(TMPCLONEROOT_MANIFEST) s_manifest
232
233cleanmanifest:
234 @echo "Cleaning generated manifest files"
235 $(VERB)rm -f $(MACHINE_LIST_XML) 2>/dev/null
236 $(VERB)rm -rf "$(TMPCLONEROOT_MANIFEST)" s_manifest 2>/dev/null
237
238$(TMPCLONEROOT_MANIFEST):
239 $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi
240 $(VERB)if [ ! -d "$(TMPCLONEROOT_MANIFEST)" ]; then mkdir -p "$(TMPCLONEROOT_MANIFEST)" ; fi
241 $(VERB) MBRANCH=`echo "$(MANIFESTHASH)" | sed 's/.*\///'`; \
242 echo "**** Cloning manifest version $$MBRANCH of $(MANIFESTURL) in $(TMPCLONEROOT_MANIFEST)" ; \
243 cd "$(TMPCLONEROOT_MANIFEST)"; git clone $(MANIFESTURL) ; cd $(MANIFESTDIR) ; git checkout $(MANIFESTHASH)
244 $(VERB)if [ ! -d "$(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR)" ]; then echo "ERROR: Missing $(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR)"; exit 10 ; fi ; \
245 TARGETDEFAULTXMLS=`cd $(TMPCLONEROOT_MANIFEST)/$(MANIFESTDIR); ls -1 */default.xml 2>/dev/null` ; \
246 TARGET_LIST=`echo "$$TARGETDEFAULTXMLS" | sed 's/\/default.xml//;s/^/# export MACHINE=/'` ; \
247 echo "<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>" >$(MACHINE_LIST_XML) ; \
248 echo "<!DOCTYPE para PUBLIC \"-//OASIS//DTD DocBook XML V4.2//EN\"" >>$(MACHINE_LIST_XML) ; \
249 echo "\"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd\">" >>$(MACHINE_LIST_XML) ; \
250 echo "<para id=\"machine-list\">" >>$(MACHINE_LIST_XML) ; \
251 echo "<programlisting># Set MACHINE to ONE of the targets in this release!" >>$(MACHINE_LIST_XML) ; \
252 echo "$$TARGET_LIST</programlisting>" >>$(MACHINE_LIST_XML) ; \
253 echo "</para>" >>$(MACHINE_LIST_XML)
254
255
256# ****************************************************************************
257# ******************** SUPPORT FOR dynamic pardoc with added parameters ******
258# pardoc-distro can contain MAJOR.MINOR-xxxxx keeping -xxxx when replacing MINOR.MINOR from enea.conf
259
260PATH_DOCSRC_COMMON = $(SUBSYSROOT)/s_docsrc_common
261NAME_DOCSRC_COMMON = docsrc_common
262TMPCLONEROOT_DOCSRC_COMMON := $(TMPCLONEROOT)/$(NAME_DOCSRC_COMMON)
263TMPPARDOC := $(TMPCLONEROOT_DOCSRC_COMMON)/pardoc-distro.xml
264
265initpardoc: s_docsrc_common
266
267cleanpardoc:
268 @echo "Cleaning dynamic parameters"
269 $(VERB)rm -rf $(TMPCLONEROOT_DOCSRC_COMMON) ; rm s_docsrc_common
270
271
272s_docsrc_common: $(TMPCLONEROOT_DOCSRC_COMMON)
273 $(VERB)rm s_docsrc_common 2>/dev/null; ln -s $(TMPCLONEROOT_DOCSRC_COMMON) s_docsrc_common
274
275$(TMPCLONEROOT_DOCSRC_COMMON):
276 $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi
277 $(VERB)if [ ! -d $(TMPCLONEROOT_DOCSRC_COMMON) ]; then mkdir -p $(TMPCLONEROOT_DOCSRC_COMMON) ; fi
278 @echo "**** Copy docsrc_common/ files to $(TMPCLONEROOT_DOCSRC_COMMON)"
279 $(VERB)cat docsrc_common/pardoc-distro.xml >$(TMPPARDOC)
280
281# ****************************************************************************
282# ***** Create XML chapter with build/boot commands from all README files in manifest
283
284initbuildboot: $(BUILDBOOT_XML)
285
286cleanbuildboot:
287 @echo "Cleaning generated build-boot command document file"
288 $(VERB)rm -f $(BUILDBOOT_XML) 2>/dev/null
289
290
291$(BUILDBOOT_XML): $(BUILDBOOT_TEMPLATE)
292 @echo "**** Creating $(BUILDBOOT_XML) from READMEs"
293 $(VERB)INITBB_CMD=initbuildboot.sh ; \
294 if [ -f "$$INITBB_CMD" ]; then \
295 sh "$$INITBB_CMD" -xml $(BUILDBOOT_XML) -template $(BUILDBOOT_TEMPLATE) -readmebasedir s_manifest/$(MANIFESTDIR); \
296 else \
297 echo "ERROR: Missing $$INITBB_CMD, can not create $(BUILDBOOT_XML)"; exit 10; \
298 fi
299
300# ****************************************************************************
301# ***** Create Package DIFF XML section
302
303initpkgdiff: $(PKGDIFF_GEN_XML)
304
305cleanpkgdiff:
306 @echo "Cleaning generated package diff document file"
307 $(VERB)rm -f $(PKGDIFF_GEN_XML) 2>/dev/null
308
309$(PKGDIFF_GEN_XML):
310 $(VERB)PREVIOUS_BL=`egrep '"prev_baseline"' docsrc_common/pardoc-distro.xml | sed 's/^.*<phrase>//;s/<\/phrase>.*$$//'` ; \
311 echo "**** Generating $(PKGDIFF_GEN_XML) compared to $$PREVIOUS_BL, using gen_pkgdiff.py" ; \
312 python gen_pkgdiff.py >$(PKGDIFF_GEN_XML)
313
314
315# ****************************************************************************
316# ***** Create Jira Issues XML section for the known bugs chapter
317
318.PHONY: $(JIRA_ISSUES_GEN_XML)
319# We want new issue list to be generated also at build, not only at init
320
321initissues: $(JIRA_ISSUES_GEN_XML)
322
323
324cleanissues:
325 @echo "Cleaning generated known issues document file"
326 $(VERB)rm -f $(JIRA_ISSUES_GEN_XML) 2>/dev/null
327
328$(JIRA_ISSUES_GEN_XML):
329 @echo "**** Generating $(JIRA_ISSUES_GEN_XML), fetching from Jira using gen_known_issues.py"
330 $(VERB)python gen_known_issues.py >$(JIRA_ISSUES_GEN_XML)
331
332# ****************************************************************************
333
334#
335# All ELTF_ variables names only has upper case, underline and digits
336eltf:
337 @echo "# make eltf extracts and displays all ELTF_ variables found here"
338 @echo "# in $(SUBSYSROOT)/$(ELTF_PARAMS_TEMPLATE)"
339 @echo "# Replace all variables, creating a new eltf*updated.xml file from the eltf*template.xml"
340 @echo "#"
341 @echo "# Only replace + push the result file $(ELTF_PARAMS_UPDATED), IF IT WILL BE CHANGED."
342 @echo "#"
343 @echo "# IMPORTANT: See eltf_params_updated_template_how_to_use.txt for requirements and details!"
344 @echo "# Below is only a summary!"
345 @echo "#"
346 @echo "# ELTF_ variables must be UNIQUE, e.g. a variable must not be a part of another variable"
347 @echo "#"
348 @echo "# ELTF_PL_* and ELTF_T_PL_* shall have the format for programlisting and are often multiline - see below."
349 @echo "#"
350 @echo "# ELTF_*_URL and ELTF_*_TXTURL are the URL part and TXT part of ulink; those shall be exactly identical,"
351 @echo "# unless the URL is very very long."
352 @echo "#"
353 @echo "# ELTF_T_* are target (MACHINE) variables in one subsection, replace with machine specific strings."
354 @echo "#"
355 @echo "# Append more target subsections to *updated.xml, if more than one target is in a release!"
356 @echo "# Replace the line <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED --> with appended"
357 @echo "# complete target section elements copied before the variables are replaced."
358 @echo "# In each target section, replace the ELTF_T* variables with machine dependent strings"
359 @echo "# Append final lines seen after <!-- ELTFADD_MORE_TARGET_SECTIONS_BELOW_IF_NEEDED -->"
360 @echo "# but that would often only be two final </section> </section> lines"
361 @echo "#"
362 @echo "# ELTF_ Variables: Replace each variable with a string, for ELTF_*PL* it can be multiline"
363 @echo "# DO NOT use any leading or trailing spaces and DO NOT use TABs"
364 @echo "#"
365 @echo "# ELTF_ Everywhere: Only 7-bit ASCII inside the string replacing a variable. Translate characters"
366 @echo "# like & < > to &amp; &lt; &gt; etc."
367 @echo "# unless real XML shall be inserted like when entire sections are appended."
368 @echo "#"
369 @echo "# ELTF_ programlisting, variables with PL in the name: Max line length < 80 char."
370 @echo "# Use backslash + indent-leading-spaces for continuation lines."
371 @echo "# Multiline. No trailing spaces on any line inside the programlisting."
372 @echo "#"
373 @echo "# The following variables shall be replaced with suitable contents (egrep from the template):"
374 @echo "# Again: See details in eltf_params_updated_template_how_to_use.txt"
375 @echo "# including also examples of contents of each variable!"
376 @echo "#"
377 $(VERB)( egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' $(ELTF_PARAMS_TEMPLATE) 2>/dev/null | sed 's/ELTF_/\nELTF_/g' | egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' | sed 's/\(ELTF_[A-Z_0-9][A-Z_0-9]*\).*/\1/' ) | sort
378 @echo "# The make eltf also here extracts any left-over ELTF variables from $(ELTF_PARAMS_UPDATED)"
379 @echo "# It should not be any left here:"
380 $(VERB)( egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' $(ELTF_PARAMS_UPDATED) 2>/dev/null | sed 's/ELTF_/\nELTF_/g' | egrep 'ELTF_[A-Z_0-9][A-Z_0-9]*' | sed 's/\(ELTF_[A-Z_0-9][A-Z_0-9]*\).*/\1/' ) | sort
381 @echo "# If you see any left-over above, something is wrong"
diff --git a/doc/README b/doc/README
new file mode 100644
index 0000000..957f34a
--- /dev/null
+++ b/doc/README
@@ -0,0 +1,21 @@
1
2rt profile
3
4___Prerequisites-commands:Ubuntu16.04.5LTS
5sudo apt-get -y update
6udo apt-get install gawk wget git-core diffstat unzip texinfo gcc-multilib build-essential chrpath socat cpio python python3 python3-pip python3-pexpect xz-utils debianutils iputils-ping
7___END
8
9___RepoInstall-commands:Ubuntu16.04.5LTS
10mkdir -p ~/bin
11curl https://storage.googleapis.com/git-repo-downloads/repo > ~/bin/repo
12chmod a+x ~/bin/repo
13export PATH=~/bin:$PATH
14___END
15
16___RepoClone-commands:<machine>
17mkdir enea-linux
18cd enea-linux
19repo init -u git@git.enea.com:linux/manifests/el_manifests-rt.git -b refs/tags/Enea_Linux_8.0 -m <machine>/default.xml
20repo sync
21___END
diff --git a/doc/book-enea-linux-open-source/doc/README b/doc/book-enea-linux-open-source/doc/README
new file mode 100644
index 0000000..c40a2d9
--- /dev/null
+++ b/doc/book-enea-linux-open-source/doc/README
@@ -0,0 +1,4 @@
1The licenses.xml in the git repository of Enea Linux Open Source Report
2is the frozen version belonging to the last official release of Enea Linux.
3The contents must be generated from the release script to obtain the latest
4lists of packages and licenses.
diff --git a/doc/book-enea-linux-open-source/doc/about.xml b/doc/book-enea-linux-open-source/doc/about.xml
new file mode 100644
index 0000000..d4b6437
--- /dev/null
+++ b/doc/book-enea-linux-open-source/doc/about.xml
@@ -0,0 +1,12 @@
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 Linux <xi:include
9 href="../../book-enea-linux-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-linux-open-source/doc/book.xml b/doc/book-enea-linux-open-source/doc/book.xml
new file mode 100644
index 0000000..5b71cd0
--- /dev/null
+++ b/doc/book-enea-linux-open-source/doc/book.xml
@@ -0,0 +1,15 @@
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_linux_open_source_rt">
7 <title><trademark class="registered">Enea</trademark> Linux Open Source Report</title>
8 <subtitle>Release Version
9 <xi:include href="../../book-enea-linux-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-linux-open-source/doc/licenses.xml b/doc/book-enea-linux-open-source/doc/licenses.xml
new file mode 100644
index 0000000..541b766
--- /dev/null
+++ b/doc/book-enea-linux-open-source/doc/licenses.xml
@@ -0,0 +1,6521 @@
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
7 <section id="licenses_packages">
8 <title>Packages</title>
9
10 <!--This chapter contains a generated list of all packages that Enea Linux
11supports, e.g. busybox, with a short explanatory blurb and links to package
12specific documentation.-->
13
14 <informaltable>
15 <tgroup cols="4">
16 <colspec colwidth="2*" />
17
18 <colspec colwidth="1*" />
19
20 <colspec colwidth="5*" />
21
22 <colspec colwidth="2*" />
23
24 <thead>
25 <row>
26 <entry align="center">Package Name</entry>
27
28 <entry align="center">Version</entry>
29
30 <entry align="center">Description</entry>
31
32 <entry align="center">License</entry>
33 </row>
34 </thead>
35
36 <tbody valign="top">
37 <row>
38 <entry>acl</entry>
39
40 <entry>2.2.52</entry>
41
42 <entry>Utilities for managing POSIX Access Control Lists.</entry>
43
44 <entry>LGPL-2.1, GPL-2.0</entry>
45 </row>
46
47 <row>
48 <entry>acpica</entry>
49
50 <entry>20170303</entry>
51
52 <entry>The ACPI Component Architecture (ACPICA) project provides
53 an OS-independent reference implementation of the Advanced
54 Configuration and Power Interface Specification (ACPI). ACPICA
55 code contains those portions of ACPI meant to be directly
56 integrated into the host OS as a kernel-resident subsystem and a
57 small set of tools to assist in developing and debugging ACPI
58 tables.</entry>
59
60 <entry>BSD, GPL-2.0</entry>
61 </row>
62
63 <row>
64 <entry>alsa-lib</entry>
65
66 <entry>1.1.5</entry>
67
68 <entry>ALSA sound library.</entry>
69
70 <entry>LGPL-2.1, GPL-2.0</entry>
71 </row>
72
73 <row>
74 <entry>apt</entry>
75
76 <entry>1.2.24</entry>
77
78 <entry>Advanced front-end for dpkg.</entry>
79
80 <entry>GPL-2.0</entry>
81 </row>
82
83 <row>
84 <entry>attr</entry>
85
86 <entry>2.4.47</entry>
87
88 <entry>Utilities for manipulating filesystem extended
89 attributes.</entry>
90
91 <entry>LGPL-2.1, GPL-2.0</entry>
92 </row>
93
94 <row>
95 <entry>autoconf-archive</entry>
96
97 <entry>2016.09.16</entry>
98
99 <entry>a collection of freely re-usable Autoconf macros.</entry>
100
101 <entry>GPL-3.0-with-autoconf-exception</entry>
102 </row>
103
104 <row>
105 <entry>autoconf</entry>
106
107 <entry>2.69</entry>
108
109 <entry>Autoconf is an extensible package of M4 macros that produce
110 shell scripts to automatically configure software source code
111 packages. Autoconf creates a configuration script for a package
112 from a template file that lists the operating system features that
113 the package can use in the form of M4 macro calls.</entry>
114
115 <entry>GPL-2.0, GPL-3.0</entry>
116 </row>
117
118 <row>
119 <entry>automake</entry>
120
121 <entry>1.15.1</entry>
122
123 <entry>Automake is a tool for automatically generating
124 `Makefile.in' files compliant with the GNU Coding Standards.
125 Automake requires the use of Autoconf.</entry>
126
127 <entry>GPL-2.0</entry>
128 </row>
129
130 <row>
131 <entry>base-files</entry>
132
133 <entry>3.0.14</entry>
134
135 <entry>The base-files package creates the basic system directory
136 structure and provides a small set of key configuration files for
137 the system.</entry>
138
139 <entry>GPL-2.0</entry>
140 </row>
141
142 <row>
143 <entry>base-passwd</entry>
144
145 <entry>3.5.29</entry>
146
147 <entry>The master copies of the user database files (/etc/passwd
148 and /etc/group). The update-passwd tool is also provided to keep
149 the system databases synchronized with these master files.</entry>
150
151 <entry>GPL-2.0</entry>
152 </row>
153
154 <row>
155 <entry>bash-completion</entry>
156
157 <entry>2.7</entry>
158
159 <entry>Programmable Completion for Bash 4.</entry>
160
161 <entry>GPL-2.0</entry>
162 </row>
163
164 <row>
165 <entry>bash</entry>
166
167 <entry>4.4.12</entry>
168
169 <entry>An sh-compatible command language interpreter.</entry>
170
171 <entry>GPL-3.0</entry>
172 </row>
173
174 <row>
175 <entry>bc</entry>
176
177 <entry>1.06</entry>
178
179 <entry>Arbitrary precision calculator language.</entry>
180
181 <entry>GPL-2.0, LGPL-2.1</entry>
182 </row>
183
184 <row>
185 <entry>binutils-cross-x86_64</entry>
186
187 <entry>2.30</entry>
188
189 <entry>The GNU Binutils are a collection of binary tools. The main
190 ones are ld (GNU Linker) and as (GNU Assembler). This package also
191 includes addition tools such as addr2line (Converts addresses into
192 filenames and line numbers) ar (utility for creating modifying and
193 extracting archives) nm (list symbols in object files) objcopy
194 (copy and translate object files) objdump (Display object
195 information) and other tools and related libraries.</entry>
196
197 <entry>GPL-3.0</entry>
198 </row>
199
200 <row>
201 <entry>binutils</entry>
202
203 <entry>2.30</entry>
204
205 <entry>The GNU Binutils are a collection of binary tools. The main
206 ones are ld (GNU Linker) and as (GNU Assembler). This package also
207 includes addition tools such as addr2line (Converts addresses into
208 filenames and line numbers) ar (utility for creating modifying and
209 extracting archives) nm (list symbols in object files) objcopy
210 (copy and translate object files) objdump (Display object
211 information) and other tools and related libraries.</entry>
212
213 <entry>GPL-3.0</entry>
214 </row>
215
216 <row>
217 <entry>bison</entry>
218
219 <entry>3.0.4</entry>
220
221 <entry>Bison is a general-purpose parser generator that converts
222 an annotated context-free grammar into an LALR(1) or GLR parser
223 for that grammar. Bison is upward compatible with Yacc: all
224 properly-written Yacc grammars ought to work with Bison with no
225 change. Anyone familiar with Yacc should be able to use Bison with
226 little trouble.</entry>
227
228 <entry>GPL-3.0</entry>
229 </row>
230
231 <row>
232 <entry>bmap-tools</entry>
233
234 <entry>3.4</entry>
235
236 <entry>"Bmap-tools - tools to generate block map (AKA bmap) and
237 flash images using bmap. Bmaptool is a generic tool for creating
238 the block map (bmap) for a file and copying files using the block
239 map. The idea is that large file containing unused blocks like raw
240 system image files can be copied or flashed a lot faster with
241 bmaptool than with traditional tools like ""dd"" or
242 ""cp""."</entry>
243
244 <entry>GPL-2.0</entry>
245 </row>
246
247 <row>
248 <entry>btrfs-tools</entry>
249
250 <entry>4.13.3</entry>
251
252 <entry>Btrfs is a new copy on write filesystem for Linux aimed at
253 implementing advanced features while focusing on fault tolerance
254 repair and easy administration. This package contains utilities
255 (mkfs fsck btrfsctl) used to work with btrfs and an utility
256 (btrfs-convert) to make a btrfs filesystem from an ext3.</entry>
257
258 <entry>GPL-2.0</entry>
259 </row>
260
261 <row>
262 <entry>busybox</entry>
263
264 <entry>1.27.2</entry>
265
266 <entry>BusyBox combines tiny versions of many common UNIX
267 utilities into a single small executable. It provides minimalist
268 replacements for most of the utilities you usually find in GNU
269 fileutils shellutils etc. The utilities in BusyBox generally have
270 fewer options than their full-featured GNU cousins; however the
271 options that are included provide the expected functionality and
272 behave very much like their GNU counterparts. BusyBox provides a
273 fairly complete POSIX environment for any small or embedded
274 system.</entry>
275
276 <entry>GPL-2.0, BSD-4-Clause</entry>
277 </row>
278
279 <row>
280 <entry>bzip2</entry>
281
282 <entry>1.0.6</entry>
283
284 <entry>bzip2 compresses files using the Burrows-Wheeler
285 block-sorting text compression algorithm and Huffman coding.
286 Compression is generally considerably better than that achieved by
287 more conventional LZ77/LZ78-based compressors and approaches the
288 performance of the PPM family of statistical compressors.</entry>
289
290 <entry>BSD-4-Clause</entry>
291 </row>
292
293 <row>
294 <entry>ca-certificates</entry>
295
296 <entry>20170717</entry>
297
298 <entry>This package includes PEM files of CA certificates to allow
299 SSL-based applications to check for the authenticity of SSL
300 connections. This derived from Debian's CA Certificates.</entry>
301
302 <entry>GPL-2.0, MPL-2.0</entry>
303 </row>
304
305 <row>
306 <entry>cdrtools</entry>
307
308 <entry>3.01a31</entry>
309
310 <entry>A set of tools for CD recording including cdrecord.</entry>
311
312 <entry>GPL-2.0, LGPL-2.1</entry>
313 </row>
314
315 <row>
316 <entry>coreutils</entry>
317
318 <entry>8.29</entry>
319
320 <entry>The GNU Core Utilities provide the basic file shell and
321 text manipulation utilities. These are the core utilities which
322 are expected to exist on every system.</entry>
323
324 <entry>GPL-3.0</entry>
325 </row>
326
327 <row>
328 <entry>cross-localedef</entry>
329
330 <entry>2.27</entry>
331
332 <entry>Cross locale generation tool for glibc.</entry>
333
334 <entry>LGPL-2.1</entry>
335 </row>
336
337 <row>
338 <entry>cryptodev-linux</entry>
339
340 <entry>1.9</entry>
341
342 <entry>A /dev/crypto device driver header file.</entry>
343
344 <entry>GPL-2.0</entry>
345 </row>
346
347 <row>
348 <entry>curl</entry>
349
350 <entry>7.61.0</entry>
351
352 <entry>Command line tool and library for client-side URL
353 transfers.</entry>
354
355 <entry>MIT</entry>
356 </row>
357
358 <row>
359 <entry>cwautomacros</entry>
360
361 <entry>20110201</entry>
362
363 <entry>Collection of autoconf m4 macros.</entry>
364
365 <entry>GPL-2.0</entry>
366 </row>
367
368 <row>
369 <entry>db</entry>
370
371 <entry>5.3.28</entry>
372
373 <entry>Berkeley Database v5.</entry>
374
375 <entry>Sleepycat</entry>
376 </row>
377
378 <row>
379 <entry>dbus-glib</entry>
380
381 <entry>0.108</entry>
382
383 <entry>GLib bindings for the D-Bus message bus that integrate the
384 D-Bus library with the GLib thread abstraction and main
385 loop.</entry>
386
387 <entry>AFL-2.0, GPL-2.0</entry>
388 </row>
389
390 <row>
391 <entry>dbus-test</entry>
392
393 <entry>1.12.2</entry>
394
395 <entry>D-Bus test package (for D-bus functionality testing
396 only).</entry>
397
398 <entry>AFL-2.0, GPL-2.0</entry>
399 </row>
400
401 <row>
402 <entry>dbus</entry>
403
404 <entry>1.12.2</entry>
405
406 <entry>"D-Bus is a message bus system a simple way for
407 applications to talk to one another. In addition to interprocess
408 communication D-Bus helps coordinate process lifecycle; it makes
409 it simple and reliable to code a \""single instance\"" application
410 or daemon and to launch applications and daemons on demand when
411 their services are needed."</entry>
412
413 <entry>AFL-2.0, GPL-2.0</entry>
414 </row>
415
416 <row>
417 <entry>debianutils</entry>
418
419 <entry>4.8.4</entry>
420
421 <entry>Miscellaneous utilities specific to Debian.</entry>
422
423 <entry>GPL-2.0</entry>
424 </row>
425
426 <row>
427 <entry>depmodwrapper</entry>
428
429 <entry>1.0</entry>
430
431 <entry>Wrapper script for the Linux kernel module dependency
432 indexer.</entry>
433
434 <entry>MIT</entry>
435 </row>
436
437 <row>
438 <entry>diffutils</entry>
439
440 <entry>3.6</entry>
441
442 <entry>Diffutils contains the GNU diff diff3 sdiff and cmp
443 utilities. These programs are usually used for creating patch
444 files.</entry>
445
446 <entry>GPL-3.0</entry>
447 </row>
448
449 <row>
450 <entry>dosfstools</entry>
451
452 <entry>4.1</entry>
453
454 <entry>DOS FAT Filesystem Utilities.</entry>
455
456 <entry>GPL-3.0</entry>
457 </row>
458
459 <row>
460 <entry>dpkg</entry>
461
462 <entry>1.18.24</entry>
463
464 <entry>Package maintenance system from Debian.</entry>
465
466 <entry>GPL-2.0</entry>
467 </row>
468
469 <row>
470 <entry>dropbear</entry>
471
472 <entry>2017.75</entry>
473
474 <entry>A lightweight SSH and SCP implementation.</entry>
475
476 <entry>MIT, BSD-3-Clause, BSD-2-Clause, PD</entry>
477 </row>
478
479 <row>
480 <entry>dtc</entry>
481
482 <entry>1.4.5</entry>
483
484 <entry>The Device Tree Compiler is a tool used to manipulate the
485 Open-Firmware-like device tree used by PowerPC kernels.</entry>
486
487 <entry>GPL-2.0, BSD</entry>
488 </row>
489
490 <row>
491 <entry>dwarfsrcfiles</entry>
492
493 <entry>1.0</entry>
494
495 <entry>A small utility for printing debig source file locations
496 embedded in binaries.</entry>
497
498 <entry>GPL-2.0</entry>
499 </row>
500
501 <row>
502 <entry>e2fsprogs</entry>
503
504 <entry>1.43.8</entry>
505
506 <entry>The Ext2 Filesystem Utilities (e2fsprogs) contain all of
507 the standard utilities for creating fixing configuring and
508 debugging ext2 filesystems.</entry>
509
510 <entry>GPL-2.0, LGPL-2.0, BSD, MIT</entry>
511 </row>
512
513 <row>
514 <entry>elfutils</entry>
515
516 <entry>0.170</entry>
517
518 <entry>Utilities and libraries for handling compiled object
519 files.</entry>
520
521 <entry>GPL-3.0, Elfutils-Exception</entry>
522 </row>
523
524 <row>
525 <entry>enea-image-standard</entry>
526
527 <entry>1.0</entry>
528
529 <entry>Base image for the Standard profile</entry>
530
531 <entry>MIT</entry>
532 </row>
533
534 <row>
535 <entry>expat</entry>
536
537 <entry>2.2.5</entry>
538
539 <entry>Expat is an XML parser library written in C. It is a
540 stream-oriented parser in which an application registers handlers
541 for things the parser might find in the XML document (like start
542 tags)</entry>
543
544 <entry>MIT</entry>
545 </row>
546
547 <row>
548 <entry>file</entry>
549
550 <entry>5.32</entry>
551
552 <entry>File attempts to classify files depending on their contents
553 and prints a description if a match is found.</entry>
554
555 <entry>BSD</entry>
556 </row>
557
558 <row>
559 <entry>flex</entry>
560
561 <entry>2.6.0</entry>
562
563 <entry>Flex is a fast lexical analyser generator. Flex is a tool
564 for generating programs that recognize lexical patterns in
565 text.</entry>
566
567 <entry>BSD</entry>
568 </row>
569
570 <row>
571 <entry>freetype</entry>
572
573 <entry>2.9</entry>
574
575 <entry>FreeType is a software font engine that is designed to be
576 small efficient highly customizable and portable while capable of
577 producing high-quality output (glyph images). It can be used in
578 graphics libraries display servers font conversion tools text
579 image generation tools and many other products as well.</entry>
580
581 <entry>FreeType, GPL-2.0</entry>
582 </row>
583
584 <row>
585 <entry>gawk</entry>
586
587 <entry>4.2.1</entry>
588
589 <entry>The GNU version of awk a text processing utility. Awk
590 interprets a special-purpose programming language to do quick and
591 easy text pattern matching and reformatting jobs.</entry>
592
593 <entry>GPL-3.0</entry>
594 </row>
595
596 <row>
597 <entry>gcc-cross-initial-x86_64</entry>
598
599 <entry>7.3.0</entry>
600
601 <entry>GNU cc and gcc C compilers.</entry>
602
603 <entry>GPL-3.0-with-GCC-exception, GPL-3.0</entry>
604 </row>
605
606 <row>
607 <entry>gcc-cross-x86_64</entry>
608
609 <entry>7.3.0</entry>
610
611 <entry>GNU cc and gcc C compilers.</entry>
612
613 <entry>GPL-3.0-with-GCC-exception, GPL-3.0</entry>
614 </row>
615
616 <row>
617 <entry>gcc-source-7.3.0</entry>
618
619 <entry>7.3.0</entry>
620
621 <entry>GNU cc and gcc C compilers.</entry>
622
623 <entry>GPL-3.0-with-GCC-exception, GPL-3.0</entry>
624 </row>
625
626 <row>
627 <entry>gcc</entry>
628
629 <entry>7.3.0</entry>
630
631 <entry>Runtime libraries from GCC.</entry>
632
633 <entry>GPL-3.0-with-GCC-exception</entry>
634 </row>
635
636 <row>
637 <entry>gdbm</entry>
638
639 <entry>1.14.1</entry>
640
641 <entry>Key/value database library with extensible hashing.</entry>
642
643 <entry>GPL-3.0</entry>
644 </row>
645
646 <row>
647 <entry>gettext-minimal</entry>
648
649 <entry>0.19.8.1</entry>
650
651 <entry>Contains the m4 macros sufficient to support building
652 autoconf/automake. This provides a significant build time speedup
653 by the removal of gettext-native from most dependency chains (now
654 only needed for gettext for the target).</entry>
655
656 <entry>FSF-Unlimited</entry>
657 </row>
658
659 <row>
660 <entry>gettext</entry>
661
662 <entry>0.19.8.1</entry>
663
664 <entry>GNU gettext is a set of tools that provides a framework to
665 help other programs produce multi-lingual messages. These tools
666 include a set of conventions about how programs should be written
667 to support message catalogs a directory and file naming
668 organization for the message catalogs themselves a runtime library
669 supporting the retrieval of translated messages and a few
670 stand-alone programs to massage in various ways the sets of
671 translatable and already translated strings.</entry>
672
673 <entry>GPL-3.0, LGPL-2.1</entry>
674 </row>
675
676 <row>
677 <entry>glib-2.0</entry>
678
679 <entry>2.54.3</entry>
680
681 <entry>GLib is a general-purpose utility library which provides
682 many useful data types macros type conversions string utilities
683 file utilities a main loop abstraction and so on.</entry>
684
685 <entry>LGPL-2.1, BSD, PD</entry>
686 </row>
687
688 <row>
689 <entry>glibc-locale</entry>
690
691 <entry>2.27</entry>
692
693 <entry>Locale data from glibc.</entry>
694
695 <entry>GPL-2.0, LGPL-2.1</entry>
696 </row>
697
698 <row>
699 <entry>glibc</entry>
700
701 <entry>2.27</entry>
702
703 <entry>The GNU C Library is used as the system C library in most
704 systems with the Linux kernel.</entry>
705
706 <entry>GPL-2.0, LGPL-2.1</entry>
707 </row>
708
709 <row>
710 <entry>gmp</entry>
711
712 <entry>6.1.2</entry>
713
714 <entry>GMP is a free library for arbitrary precision arithmetic
715 operating on signed integers rational numbers and floating point
716 numbers</entry>
717
718 <entry>GPL-2.0, LGPL-3.0</entry>
719 </row>
720
721 <row>
722 <entry>gnome-desktop-testing</entry>
723
724 <entry>2014.1</entry>
725
726 <entry>Test runner for GNOME-style installed tests.</entry>
727
728 <entry>LGPL-2.0</entry>
729 </row>
730
731 <row>
732 <entry>gnu-config</entry>
733
734 <entry>20150728</entry>
735
736 <entry>Tool that installs the GNU config.guess / config.sub into a
737 directory tree</entry>
738
739 <entry>GPL-3.0-with-autoconf-exception</entry>
740 </row>
741
742 <row>
743 <entry>gnu-efi</entry>
744
745 <entry>3.0.6</entry>
746
747 <entry>Libraries for producing EFI binaries.</entry>
748
749 <entry>GPL-2.0, BSD-2-Clause</entry>
750 </row>
751
752 <row>
753 <entry>gnutls</entry>
754
755 <entry>3.6.1</entry>
756
757 <entry>GNU Transport Layer Security Library.</entry>
758
759 <entry>GPL-3.0, LGPL-2.1</entry>
760 </row>
761
762 <row>
763 <entry>gperf</entry>
764
765 <entry>3.1</entry>
766
767 <entry>GNU gperf is a perfect hash function generator</entry>
768
769 <entry>GPL-3.0</entry>
770 </row>
771
772 <row>
773 <entry>gptfdisk</entry>
774
775 <entry>1.0.3</entry>
776
777 <entry>GPT fdisk is a disk partitioning tool loosely modeled on
778 Linux fdisk but used for modifying GUID Partition Table (GPT)
779 disks. The related FixParts utility fixes some common problems on
780 Master Boot Record (MBR) disks.</entry>
781
782 <entry>GPL-2.0</entry>
783 </row>
784
785 <row>
786 <entry>grep</entry>
787
788 <entry>3.1</entry>
789
790 <entry>GNU grep utility.</entry>
791
792 <entry>GPL-3.0</entry>
793 </row>
794
795 <row>
796 <entry>groff</entry>
797
798 <entry>1.22.3</entry>
799
800 <entry>The groff (GNU troff) software is a typesetting package
801 which reads plain text mixed with formatting commands and produces
802 formatted output.</entry>
803
804 <entry>GPL-3.0</entry>
805 </row>
806
807 <row>
808 <entry>grub-bootconf</entry>
809
810 <entry>1.00</entry>
811
812 <entry>Basic grub.cfg for use in EFI systems.</entry>
813
814 <entry>MIT</entry>
815 </row>
816
817 <row>
818 <entry>grub-efi</entry>
819
820 <entry>2.02</entry>
821
822 <entry>GRUB2 is the next generaion of a GPLed bootloader intended
823 to unify bootloading across x86 operating systems. In addition to
824 loading the Linux kernel it implements the Multiboot standard
825 which allows for flexible loading of multiple boot images.</entry>
826
827 <entry>GPL-3.0</entry>
828 </row>
829
830 <row>
831 <entry>grub</entry>
832
833 <entry>2.02</entry>
834
835 <entry>GRUB2 is the next generaion of a GPLed bootloader intended
836 to unify bootloading across x86 operating systems. In addition to
837 loading the Linux kernel it implements the Multiboot standard
838 which allows for flexible loading of multiple boot images.</entry>
839
840 <entry>GPL-3.0</entry>
841 </row>
842
843 <row>
844 <entry>gtk-doc</entry>
845
846 <entry>1.27</entry>
847
848 <entry>Gtk-doc is a set of scripts that extract specially
849 formatted comments from glib-based software and produce a set of
850 html documentation files from them</entry>
851
852 <entry>GPL-2.0</entry>
853 </row>
854
855 <row>
856 <entry>inputproto</entry>
857
858 <entry>2.3.2</entry>
859
860 <entry>This package provides the wire protocol for the X Input
861 extension. The extension supports input devices other then the
862 core X keyboard and pointer.</entry>
863
864 <entry>MIT</entry>
865 </row>
866
867 <row>
868 <entry>intltool</entry>
869
870 <entry>0.51.0</entry>
871
872 <entry>Utility scripts for internationalizing XML.</entry>
873
874 <entry>GPL-2.0</entry>
875 </row>
876
877 <row>
878 <entry>iucode-tool</entry>
879
880 <entry>2.1.2</entry>
881
882 <entry>iucode_tool is a program to manipulate Intel i686 and
883 X86-64 processor microcode update collections and to use the
884 kernel facilities to update the microcode on Intel system
885 processors. It can load microcode data files in text and binary
886 format sort list and filter the microcode updates contained in
887 these files write selected microcode updates to a new file in
888 binary format or upload them to the kernel. It operates on
889 microcode data downloaded directly from Intel:
890 http://feeds.downloadcenter.intel.com/rss/?p=2371</entry>
891
892 <entry>GPL-2.0</entry>
893 </row>
894
895 <row>
896 <entry>kbd</entry>
897
898 <entry>2.0.4</entry>
899
900 <entry>Keytable files and keyboard utilities.</entry>
901
902 <entry>GPL-2.0</entry>
903 </row>
904
905 <row>
906 <entry>kbproto</entry>
907
908 <entry>1.0.7</entry>
909
910 <entry>This package provides the wire protocol for the X Keyboard
911 extension. This extension is used to control options related to
912 keyboard handling and layout.</entry>
913
914 <entry>MIT</entry>
915 </row>
916
917 <row>
918 <entry>kern-tools</entry>
919
920 <entry>0.2</entry>
921
922 <entry>Tools for managing Yocto Project style branched
923 kernels.</entry>
924
925 <entry>GPL-2.0</entry>
926 </row>
927
928 <row>
929 <entry>keymaps</entry>
930
931 <entry>1.0</entry>
932
933 <entry>Keymaps and initscript to set the keymap on bootup.</entry>
934
935 <entry>GPL-2.0</entry>
936 </row>
937
938 <row>
939 <entry>kmod</entry>
940
941 <entry>25</entry>
942
943 <entry>kmod is a set of tools to handle common tasks with Linux
944 kernel modules like insert remove list check properties resolve
945 dependencies and aliases.</entry>
946
947 <entry>GPL-2.0, LGPL-2.1</entry>
948 </row>
949
950 <row>
951 <entry>ldconfig</entry>
952
953 <entry>2.12.1</entry>
954
955 <entry>A standalone native ldconfig build.</entry>
956
957 <entry>GPL-2.0</entry>
958 </row>
959
960 <row>
961 <entry>libarchive</entry>
962
963 <entry>3.3.2</entry>
964
965 <entry>C library and command-line tools for reading and writing
966 tar cpio zip ISO and other archive formats</entry>
967
968 <entry>BSD</entry>
969 </row>
970
971 <row>
972 <entry>libcap</entry>
973
974 <entry>2.25</entry>
975
976 <entry>Library for getting/setting POSIX.1e capabilities.</entry>
977
978 <entry>BSD, GPL-2.0</entry>
979 </row>
980
981 <row>
982 <entry>libcgroup</entry>
983
984 <entry>0.41</entry>
985
986 <entry>libcgroup is a library that abstracts the control group
987 file system in Linux. Control groups allow you to limit account
988 and isolate resource usage (CPU memory disk I/O etc.) of groups of
989 processes.</entry>
990
991 <entry>LGPL-2.1</entry>
992 </row>
993
994 <row>
995 <entry>libcheck</entry>
996
997 <entry>0.12.0</entry>
998
999 <entry>Check - unit testing framework for C code.</entry>
1000
1001 <entry>LGPL-2.1</entry>
1002 </row>
1003
1004 <row>
1005 <entry>libffi</entry>
1006
1007 <entry>3.2.1</entry>
1008
1009 <entry>The `libffi' library provides a portable high level
1010 programming interface to various calling conventions. This allows
1011 a programmer to call any function specified by a call interface
1012 description at run time. FFI stands for Foreign Function
1013 Interface. A foreign function interface is the popular name for
1014 the interface that allows code written in one language to call
1015 code written in another language. The `libffi' library really only
1016 provides the lowest machine dependent layer of a fully featured
1017 foreign function interface. A layer must exist above `libffi' that
1018 handles type conversions for values passed between the two
1019 languages.</entry>
1020
1021 <entry>MIT</entry>
1022 </row>
1023
1024 <row>
1025 <entry>libgcc</entry>
1026
1027 <entry>7.3.0</entry>
1028
1029 <entry>GNU cc and gcc C compilers.</entry>
1030
1031 <entry>GPL-3.0-with-GCC-exception</entry>
1032 </row>
1033
1034 <row>
1035 <entry>libice</entry>
1036
1037 <entry>1.0.9</entry>
1038
1039 <entry>The Inter-Client Exchange (ICE) protocol provides a generic
1040 framework for building protocols on top of reliable byte-stream
1041 transport connections. It provides basic mechanisms for setting up
1042 and shutting down connections for performing authentication for
1043 negotiating versions and for reporting errors.</entry>
1044
1045 <entry>MIT</entry>
1046 </row>
1047
1048 <row>
1049 <entry>libidn</entry>
1050
1051 <entry>1.33</entry>
1052
1053 <entry>Implementation of the Stringprep Punycode and IDNA
1054 specifications defined by the IETF Internationalized Domain Names
1055 (IDN) working group.</entry>
1056
1057 <entry>LGPL-2.1, LGPL-3.0, GPL-3.0</entry>
1058 </row>
1059
1060 <row>
1061 <entry>libmpc</entry>
1062
1063 <entry>1.1.0</entry>
1064
1065 <entry>Mpc is a C library for the arithmetic of complex numbers
1066 with arbitrarily high precision and correct rounding of the
1067 result. It is built upon and follows the same principles as
1068 Mpfr</entry>
1069
1070 <entry>LGPL-3.0</entry>
1071 </row>
1072
1073 <row>
1074 <entry>libpcre</entry>
1075
1076 <entry>8.41</entry>
1077
1078 <entry>The PCRE library is a set of functions that implement
1079 regular expression pattern matching using the same syntax and
1080 semantics as Perl 5. PCRE has its own native API as well as a set
1081 of wrapper functions that correspond to the POSIX regular
1082 expression API.</entry>
1083
1084 <entry>BSD</entry>
1085 </row>
1086
1087 <row>
1088 <entry>libpng</entry>
1089
1090 <entry>1.6.34</entry>
1091
1092 <entry>PNG image format decoding library.</entry>
1093
1094 <entry>Libpng</entry>
1095 </row>
1096
1097 <row>
1098 <entry>libpthread-stubs</entry>
1099
1100 <entry>0.4</entry>
1101
1102 <entry>This library provides weak aliases for pthread functions
1103 not provided in libc or otherwise available by default.</entry>
1104
1105 <entry>MIT</entry>
1106 </row>
1107
1108 <row>
1109 <entry>libsdl</entry>
1110
1111 <entry>1.2.15</entry>
1112
1113 <entry>Simple DirectMedia Layer is a cross-platform multimedia
1114 library designed to provide low level access to audio keyboard
1115 mouse joystick 3D hardware via OpenGL and 2D video
1116 framebuffer.</entry>
1117
1118 <entry>LGPL-2.1</entry>
1119 </row>
1120
1121 <row>
1122 <entry>libsm</entry>
1123
1124 <entry>1.2.2</entry>
1125
1126 <entry>"The Session Management Library (SMlib) is a low-level
1127 \""C\"" language interface to XSMP. The purpose of the X Session
1128 Management Protocol (XSMP) is to provide a uniform mechanism for
1129 users to save and restore their sessions. A session is a group of
1130 clients each of which has a particular state."</entry>
1131
1132 <entry>MIT</entry>
1133 </row>
1134
1135 <row>
1136 <entry>libtool</entry>
1137
1138 <entry>2.4.6</entry>
1139
1140 <entry>This is GNU libtool a generic library support script.
1141 Libtool hides the complexity of generating special library types
1142 (such as shared libraries) behind a consistent interface.</entry>
1143
1144 <entry>GPL-2.0, LGPL-2.1</entry>
1145 </row>
1146
1147 <row>
1148 <entry>libunistring</entry>
1149
1150 <entry>0.9.9</entry>
1151
1152 <entry>Text files are nowadays usually encoded in Unicode and may
1153 consist of very different scripts from Latin letters to Chinese
1154 Hanzi with many kinds of special characters accents right-to-left
1155 writing marks hyphens Roman numbers and much more. But the POSIX
1156 platform APIs for text do not contain adequate functions for
1157 dealing with particular properties of many Unicode characters. In
1158 fact the POSIX APIs for text have several assumptions at their
1159 base which don't hold for Unicode text. This library provides
1160 functions for manipulating Unicode strings and for manipulating C
1161 strings according to the Unicode standard. This package contains
1162 documentation.</entry>
1163
1164 <entry>LGPL-3.0, GPL-2.0</entry>
1165 </row>
1166
1167 <row>
1168 <entry>libx11</entry>
1169
1170 <entry>1.6.5</entry>
1171
1172 <entry>This package provides a client interface to the X Window
1173 System otherwise known as 'Xlib'. It provides a complete API for
1174 the basic functions of the window system.</entry>
1175
1176 <entry>MIT, BSD</entry>
1177 </row>
1178
1179 <row>
1180 <entry>libxau</entry>
1181
1182 <entry>1.0.8</entry>
1183
1184 <entry>libxau provides the main interfaces to the X11
1185 authorisation handling which controls authorisation for X
1186 connections both client-side and server-side.</entry>
1187
1188 <entry>MIT</entry>
1189 </row>
1190
1191 <row>
1192 <entry>libxcb</entry>
1193
1194 <entry>1.12</entry>
1195
1196 <entry>The X protocol C-language Binding (XCB) is a replacement
1197 for Xlib featuring a small footprint latency hiding direct access
1198 to the protocol improved threading support and
1199 extensibility.</entry>
1200
1201 <entry>MIT</entry>
1202 </row>
1203
1204 <row>
1205 <entry>libxdmcp</entry>
1206
1207 <entry>1.1.2</entry>
1208
1209 <entry>The purpose of the X Display Manager Control Protocol
1210 (XDMCP) is to provide a uniform mechanism for an autonomous
1211 display to request login service from a remote host. An X terminal
1212 (screen keyboard mouse processor network interface) is a prime
1213 example of an autonomous display.</entry>
1214
1215 <entry>MIT</entry>
1216 </row>
1217
1218 <row>
1219 <entry>libxext</entry>
1220
1221 <entry>1.3.3</entry>
1222
1223 <entry>libXext provides an X Window System client interface to
1224 several extensions to the X protocol. The supported protocol
1225 extensions are DOUBLE-BUFFER DPMS Extended-Visual-Information LBX
1226 MIT_SHM MIT_SUNDRY-NONSTANDARD Multi-Buffering SECURITY SHAPE SYNC
1227 TOG-CUP XC-APPGROUP XC-MISC XTEST. libXext also provides a small
1228 set of utility functions to aid authors of client APIs for X
1229 protocol extensions.</entry>
1230
1231 <entry>MIT</entry>
1232 </row>
1233
1234 <row>
1235 <entry>libxkbcommon</entry>
1236
1237 <entry>0.8.0</entry>
1238
1239 <entry>libxkbcommon is a keymap compiler and support library which
1240 processes a reduced subset of keymaps as defined by the XKB
1241 specification.</entry>
1242
1243 <entry>MIT</entry>
1244 </row>
1245
1246 <row>
1247 <entry>libxml-parser-perl</entry>
1248
1249 <entry>2.44</entry>
1250
1251 <entry>XML::Parser - A perl module for parsing XML
1252 documents.</entry>
1253
1254 <entry>Artistic-1.0, GPL-1.0</entry>
1255 </row>
1256
1257 <row>
1258 <entry>libxml2</entry>
1259
1260 <entry>2.9.7</entry>
1261
1262 <entry>The XML Parser Library allows for manipulation of XML
1263 files. Libxml2 exports Push and Pull type parser interfaces for
1264 both XML and HTML. It can do DTD validation at parse time on a
1265 parsed document instance or with an arbitrary DTD. Libxml2
1266 includes complete XPath XPointer and Xinclude implementations. It
1267 also has a SAX like interface which is designed to be compatible
1268 with Expat.</entry>
1269
1270 <entry>MIT</entry>
1271 </row>
1272
1273 <row>
1274 <entry>libxrandr</entry>
1275
1276 <entry>1.5.1</entry>
1277
1278 <entry>The X Resize Rotate and Reflect Extension called RandR for
1279 short brings the ability to resize rotate and reflect the root
1280 window of a screen. It is based on the X Resize and Rotate
1281 Extension as specified in the Proceedings of the 2001 Usenix
1282 Technical Conference [RANDR].</entry>
1283
1284 <entry>MIT</entry>
1285 </row>
1286
1287 <row>
1288 <entry>libxrender</entry>
1289
1290 <entry>0.9.10</entry>
1291
1292 <entry>The X Rendering Extension (Render) introduces digital image
1293 composition as the foundation of a new rendering model within the
1294 X Window System. Rendering geometric figures is accomplished by
1295 client-side tessellation into either triangles or trapezoids. Text
1296 is drawn by loading glyphs into the server and rendering sets of
1297 them.</entry>
1298
1299 <entry>MIT</entry>
1300 </row>
1301
1302 <row>
1303 <entry>libxslt</entry>
1304
1305 <entry>1.1.32</entry>
1306
1307 <entry>GNOME XSLT library.</entry>
1308
1309 <entry>MIT</entry>
1310 </row>
1311
1312 <row>
1313 <entry>linux-intel</entry>
1314
1315 <entry>4.14.56</entry>
1316
1317 <entry>Linux kernel.</entry>
1318
1319 <entry>GPL-2.0</entry>
1320 </row>
1321
1322 <row>
1323 <entry>linux-libc-headers</entry>
1324
1325 <entry>4.15.7</entry>
1326
1327 <entry>Sanitized set of kernel headers for the C library's
1328 use.</entry>
1329
1330 <entry>GPL-2.0</entry>
1331 </row>
1332
1333 <row>
1334 <entry>lz4</entry>
1335
1336 <entry>1.7.4</entry>
1337
1338 <entry>LZ4 is a very fast lossless compression algorithm providing
1339 compression speed at 400 MB/s per core scalable with multi-cores
1340 CPU. It also features an extremely fast decoder with speed in
1341 multiple GB/s per core typically reaching RAM speed limits on
1342 multi-core systems.</entry>
1343
1344 <entry>BSD, BSD-2-Clause, GPL-2.0</entry>
1345 </row>
1346
1347 <row>
1348 <entry>lzo</entry>
1349
1350 <entry>2.10</entry>
1351
1352 <entry>Lossless data compression library.</entry>
1353
1354 <entry>GPL-2.0</entry>
1355 </row>
1356
1357 <row>
1358 <entry>lzop</entry>
1359
1360 <entry>1.03</entry>
1361
1362 <entry>lzop is a compression utility which is designed to be a
1363 companion to gzip. \nIt is based on the LZO data compression
1364 library and its main advantages over \ngzip are much higher
1365 compression and decompression speed at the cost of some
1366 \ncompression ratio. The lzop compression utility was designed
1367 with the goals \nof reliability speed portability and with
1368 reasonable drop-in compatibility \nto gzip.</entry>
1369
1370 <entry>GPL-2.0</entry>
1371 </row>
1372
1373 <row>
1374 <entry>m4</entry>
1375
1376 <entry>1.4.18</entry>
1377
1378 <entry>GNU m4 is an implementation of the traditional Unix macro
1379 processor. It is mostly SVR4 compatible although it has some
1380 extensions (for example handling more than 9 positional parameters
1381 to macros). GNU M4 also has built-in functions for including files
1382 running shell commands doing arithmetic etc.</entry>
1383
1384 <entry>GPL-3.0</entry>
1385 </row>
1386
1387 <row>
1388 <entry>make</entry>
1389
1390 <entry>4.2.1</entry>
1391
1392 <entry>Make is a tool which controls the generation of executables
1393 and other non-source files of a program from the program's source
1394 files. Make gets its knowledge of how to build your program from a
1395 file called the makefile which lists each of the non-source files
1396 and how to compute it from other files.</entry>
1397
1398 <entry>GPL-3.0, LGPL-2.0</entry>
1399 </row>
1400
1401 <row>
1402 <entry>makedepend</entry>
1403
1404 <entry>1.0.5</entry>
1405
1406 <entry>The makedepend program reads each sourcefile in sequence
1407 and parses it like a C-preprocessor processing all #include
1408 #define #undef #ifdef #ifndef #endif #if #elif and #else
1409 directives so that it can correctly tell which #include directives
1410 would be used in a compilation. Any #include directives can
1411 reference files having other #include directives and parsing will
1412 occur in these files as well.</entry>
1413
1414 <entry>MIT</entry>
1415 </row>
1416
1417 <row>
1418 <entry>makedevs</entry>
1419
1420 <entry>1.0.1</entry>
1421
1422 <entry>Tool for creating device nodes.</entry>
1423
1424 <entry>GPL-2.0</entry>
1425 </row>
1426
1427 <row>
1428 <entry>meson</entry>
1429
1430 <entry>0.44.1</entry>
1431
1432 <entry>A high performance build system.</entry>
1433
1434 <entry>Apache-2.0</entry>
1435 </row>
1436
1437 <row>
1438 <entry>mklibs</entry>
1439
1440 <entry>0.1.43</entry>
1441
1442 <entry>mklibs produces cut-down shared libraries that contain only
1443 the routines required by a particular set of executables.</entry>
1444
1445 <entry>GPL-2.0</entry>
1446 </row>
1447
1448 <row>
1449 <entry>mpfr</entry>
1450
1451 <entry>3.1.5</entry>
1452
1453 <entry>C library for multiple-precision floating-point
1454 computations with exact rounding.</entry>
1455
1456 <entry>LGPL-3.0</entry>
1457 </row>
1458
1459 <row>
1460 <entry>mtools</entry>
1461
1462 <entry>4.0.18</entry>
1463
1464 <entry>Mtools is a collection of utilities to access MS-DOS disks
1465 from GNU and Unix without mounting them.</entry>
1466
1467 <entry>GPL-3.0</entry>
1468 </row>
1469
1470 <row>
1471 <entry>nasm</entry>
1472
1473 <entry>2.13.03</entry>
1474
1475 <entry>General-purpose x86 assembler.</entry>
1476
1477 <entry>BSD-2-Clause</entry>
1478 </row>
1479
1480 <row>
1481 <entry>ncurses</entry>
1482
1483 <entry>6.0</entry>
1484
1485 <entry>SVr4 and XSI-Curses compatible curses library and terminfo
1486 tools including tic infocmp captoinfo. Supports color multiple
1487 highlights forms-drawing characters and automatic recognition of
1488 keypad and function-key sequences. Extensions include resizable
1489 windows and mouse support on both xterm and Linux console using
1490 the gpm library.</entry>
1491
1492 <entry>MIT</entry>
1493 </row>
1494
1495 <row>
1496 <entry>netbase</entry>
1497
1498 <entry>5.4</entry>
1499
1500 <entry>This package provides the necessary infrastructure for
1501 basic TCP/IP based networking</entry>
1502
1503 <entry>GPL-2.0</entry>
1504 </row>
1505
1506 <row>
1507 <entry>nettle</entry>
1508
1509 <entry>3.4</entry>
1510
1511 <entry>A low level cryptographic library.</entry>
1512
1513 <entry>LGPL-3.0, GPL-2.0</entry>
1514 </row>
1515
1516 <row>
1517 <entry>ninja</entry>
1518
1519 <entry>1.8.2</entry>
1520
1521 <entry>Ninja is a small build system with a focus on
1522 speed..</entry>
1523
1524 <entry>Apache-2.0</entry>
1525 </row>
1526
1527 <row>
1528 <entry>nodejs</entry>
1529
1530 <entry>8.9.4</entry>
1531
1532 <entry>nodeJS Evented I/O for V8 JavaScript</entry>
1533
1534 <entry>MIT, BSD</entry>
1535 </row>
1536
1537 <row>
1538 <entry>nspr</entry>
1539
1540 <entry>4.19</entry>
1541
1542 <entry>Netscape Portable Runtime Library.</entry>
1543
1544 <entry>GPL-2.0, MPL-2.0, LGPL-2.1</entry>
1545 </row>
1546
1547 <row>
1548 <entry>nss</entry>
1549
1550 <entry>3.35</entry>
1551
1552 <entry>Network Security Services (NSS) is a set of libraries
1553 designed to support cross-platform development of security-enabled
1554 client and server applications. Applications built with NSS can
1555 support SSL v2 and v3 TLS PKCS 5 PKCS 7 PKCS 11 PKCS 12 S/MIME
1556 X.509 v3 certificates and other security standards.</entry>
1557
1558 <entry>MPL-2.0, GPL-2.0, MPL-2.0, LGPL-2.1</entry>
1559 </row>
1560
1561 <row>
1562 <entry>openssl</entry>
1563
1564 <entry>1.0.2o</entry>
1565
1566 <entry>Secure Socket Layer (SSL) binary and related cryptographic
1567 tools.</entry>
1568
1569 <entry>OpenSSL</entry>
1570 </row>
1571
1572 <row>
1573 <entry>opkg-utils</entry>
1574
1575 <entry>0.3.6</entry>
1576
1577 <entry>Additional utilities for the opkg package manager.</entry>
1578
1579 <entry>GPL-2.0</entry>
1580 </row>
1581
1582 <row>
1583 <entry>os-release</entry>
1584
1585 <entry>1.0</entry>
1586
1587 <entry>The /etc/os-release file contains operating system
1588 identification data.</entry>
1589
1590 <entry>MIT</entry>
1591 </row>
1592
1593 <row>
1594 <entry>ossp-uuid</entry>
1595
1596 <entry>1.6.2</entry>
1597
1598 <entry>OSSP uuid is a ISO-C:1999 application programming interface
1599 (API) and corresponding command line interface (CLI) for the
1600 generation of DCE 1.1 ISO/IEC 11578:1996 and RFC 4122 compliant
1601 Universally Unique Identifier (UUID). It supports DCE 1.1 variant
1602 UUIDs of version 1 (time and node based) version 3 (name based
1603 MD5) version 4 (random number based) and version 5 (name based
1604 SHA-1).</entry>
1605
1606 <entry>MIT</entry>
1607 </row>
1608
1609 <row>
1610 <entry>ovmf</entry>
1611
1612 <entry>git</entry>
1613
1614 <entry>OVMF is an EDK II based project to enable UEFI support for
1615 Virtual Machines. OVMF contains sample UEFI firmware for QEMU and
1616 KVM</entry>
1617
1618 <entry>BSD</entry>
1619 </row>
1620
1621 <row>
1622 <entry>packagegroup-core-boot</entry>
1623
1624 <entry>1.0</entry>
1625
1626 <entry>The minimal set of packages required to boot the
1627 system</entry>
1628
1629 <entry>MIT</entry>
1630 </row>
1631
1632 <row>
1633 <entry>packagegroup-core-ssh-dropbear</entry>
1634
1635 <entry>1.0</entry>
1636
1637 <entry>Dropbear SSH client/server.</entry>
1638
1639 <entry>MIT</entry>
1640 </row>
1641
1642 <row>
1643 <entry>parted</entry>
1644
1645 <entry>3.2</entry>
1646
1647 <entry>Disk partition editing/resizing utility.</entry>
1648
1649 <entry>GPL-3.0</entry>
1650 </row>
1651
1652 <row>
1653 <entry>perl</entry>
1654
1655 <entry>5.24.1</entry>
1656
1657 <entry>Perl scripting language.</entry>
1658
1659 <entry>Artistic-1.0, GPL-1.0</entry>
1660 </row>
1661
1662 <row>
1663 <entry>pigz</entry>
1664
1665 <entry>2.4</entry>
1666
1667 <entry>pigz which stands for parallel implementation of gzip is a
1668 fully functional replacement for gzip that exploits multiple
1669 processors and multiple cores to the hilt when compressing data.
1670 pigz was written by Mark Adler and uses the zlib and pthread
1671 libraries.</entry>
1672
1673 <entry>Zlib, Apache-2.0</entry>
1674 </row>
1675
1676 <row>
1677 <entry>pixman</entry>
1678
1679 <entry>0.34.0</entry>
1680
1681 <entry>Pixman provides a library for manipulating pixel regions --
1682 a set of Y-X banded rectangles image compositing using the
1683 Porter/Duff model and implicit mask generation for geometric
1684 primitives including trapezoids triangles and rectangles.</entry>
1685
1686 <entry>MIT, PD</entry>
1687 </row>
1688
1689 <row>
1690 <entry>pkgconfig</entry>
1691
1692 <entry>0.29.2</entry>
1693
1694 <entry>pkg-config is a helper tool used when compiling
1695 applications and libraries. It helps determined the correct
1696 compiler/link options. It is also language-agnostic.</entry>
1697
1698 <entry>GPL-2.0</entry>
1699 </row>
1700
1701 <row>
1702 <entry>popt</entry>
1703
1704 <entry>1.16</entry>
1705
1706 <entry>Library for parsing command line options.</entry>
1707
1708 <entry>MIT</entry>
1709 </row>
1710
1711 <row>
1712 <entry>prelink</entry>
1713
1714 <entry>1.0</entry>
1715
1716 <entry>The prelink package contains a utility which modifies ELF
1717 shared libraries and executables so that far fewer relocations
1718 need to be resolved at runtime and thus programs come up
1719 faster.</entry>
1720
1721 <entry>GPL-2.0</entry>
1722 </row>
1723
1724 <row>
1725 <entry>procps</entry>
1726
1727 <entry>3.3.12</entry>
1728
1729 <entry>Procps contains a set of system utilities that provide
1730 system information about processes using the /proc filesystem. The
1731 package includes the programs ps top vmstat w kill and
1732 skill.</entry>
1733
1734 <entry>GPL-2.0, LGPL-2.0</entry>
1735 </row>
1736
1737 <row>
1738 <entry>pseudo</entry>
1739
1740 <entry>1.9.0</entry>
1741
1742 <entry>Pseudo gives fake root capabilities to a normal
1743 user.</entry>
1744
1745 <entry>LGPL-2.1</entry>
1746 </row>
1747
1748 <row>
1749 <entry>ptest-runner</entry>
1750
1751 <entry>2.1.1</entry>
1752
1753 <entry>The ptest-runner2 package installs a ptest-runner program
1754 which loops through all installed ptest test suites and runs them
1755 in sequence.</entry>
1756
1757 <entry>GPL-2.0</entry>
1758 </row>
1759
1760 <row>
1761 <entry>python</entry>
1762
1763 <entry>2.7.14</entry>
1764
1765 <entry>The Python Programming Language.</entry>
1766
1767 <entry>Python-2.0</entry>
1768 </row>
1769
1770 <row>
1771 <entry>python3-setuptools</entry>
1772
1773 <entry>39.0.0</entry>
1774
1775 <entry>Download build install upgrade and uninstall Python
1776 packages.</entry>
1777
1778 <entry>MIT</entry>
1779 </row>
1780
1781 <row>
1782 <entry>python3</entry>
1783
1784 <entry>3.5.5</entry>
1785
1786 <entry>The Python Programming Language.</entry>
1787
1788 <entry>Python-2.0</entry>
1789 </row>
1790
1791 <row>
1792 <entry>qemu-helper</entry>
1793
1794 <entry>1.0</entry>
1795
1796 <entry>Helper utilities needed by the runqemu script.</entry>
1797
1798 <entry>GPL-2.0</entry>
1799 </row>
1800
1801 <row>
1802 <entry>qemu</entry>
1803
1804 <entry>2.11.1</entry>
1805
1806 <entry>Fast open source processor emulator.</entry>
1807
1808 <entry>GPL-2.0, LGPL-2.1</entry>
1809 </row>
1810
1811 <row>
1812 <entry>qemuwrapper</entry>
1813
1814 <entry>1.0</entry>
1815
1816 <entry>QEMU wrapper script.</entry>
1817
1818 <entry>MIT</entry>
1819 </row>
1820
1821 <row>
1822 <entry>quilt</entry>
1823
1824 <entry>0.65</entry>
1825
1826 <entry>Tool for working with series of patches.</entry>
1827
1828 <entry>GPL-2.0</entry>
1829 </row>
1830
1831 <row>
1832 <entry>randrproto</entry>
1833
1834 <entry>1.5.0</entry>
1835
1836 <entry>This package provides the wire protocol for the X Resize
1837 Rotate and Reflect extension. This extension provides the ability
1838 to resize rotate and reflect the root window of a screen.</entry>
1839
1840 <entry>MIT</entry>
1841 </row>
1842
1843 <row>
1844 <entry>re2c</entry>
1845
1846 <entry>0.16</entry>
1847
1848 <entry>Tool for writing very fast and very flexible
1849 scanners.</entry>
1850
1851 <entry>PD</entry>
1852 </row>
1853
1854 <row>
1855 <entry>readline</entry>
1856
1857 <entry>7.0</entry>
1858
1859 <entry>The GNU Readline library provides a set of functions for
1860 use by applications that allow users to edit command lines as they
1861 are typed in. Both Emacs and vi editing modes are available. The
1862 Readline library includes additional functions to maintain a list
1863 of previously-entered command lines to recall and perhaps reedit
1864 those lines and perform csh-like history expansion on previous
1865 commands.</entry>
1866
1867 <entry>GPL-3.0</entry>
1868 </row>
1869
1870 <row>
1871 <entry>renderproto</entry>
1872
1873 <entry>0.11.1</entry>
1874
1875 <entry>This package provides the wire protocol for the X Rendering
1876 extension. This is the basis the image composition within the X
1877 window system.</entry>
1878
1879 <entry>MIT</entry>
1880 </row>
1881
1882 <row>
1883 <entry>rpm</entry>
1884
1885 <entry>4.14.1</entry>
1886
1887 <entry>The RPM Package Manager (RPM) is a powerful command line
1888 driven package management system capable of installing
1889 uninstalling verifying querying and updating software packages.
1890 Each software package consists of an archive of files along with
1891 information about the package like its version a description
1892 etc.</entry>
1893
1894 <entry>GPL-2.0</entry>
1895 </row>
1896
1897 <row>
1898 <entry>rt-tests</entry>
1899
1900 <entry>1.1</entry>
1901
1902 <entry>Real-Time preemption testcases.</entry>
1903
1904 <entry>GPL-2.0</entry>
1905 </row>
1906
1907 <row>
1908 <entry>run-postinsts</entry>
1909
1910 <entry>1.0</entry>
1911
1912 <entry>Runs postinstall scripts on first boot of the target
1913 device.</entry>
1914
1915 <entry>MIT</entry>
1916 </row>
1917
1918 <row>
1919 <entry>sed</entry>
1920
1921 <entry>4.2.2</entry>
1922
1923 <entry>Stream EDitor (text filtering utility).</entry>
1924
1925 <entry>GPL-3.0</entry>
1926 </row>
1927
1928 <row>
1929 <entry>shadow-securetty</entry>
1930
1931 <entry>4.2.1</entry>
1932
1933 <entry>Provider of the machine specific securetty file.</entry>
1934
1935 <entry>MIT</entry>
1936 </row>
1937
1938 <row>
1939 <entry>shadow-sysroot</entry>
1940
1941 <entry>4.2.1</entry>
1942
1943 <entry>Shadow utils requirements for useradd.bbclass.</entry>
1944
1945 <entry>BSD, Artistic-1.0</entry>
1946 </row>
1947
1948 <row>
1949 <entry>shadow</entry>
1950
1951 <entry>4.2.1</entry>
1952
1953 <entry>Tools to change and administer password and group
1954 data.</entry>
1955
1956 <entry>BSD, Artistic-1.0</entry>
1957 </row>
1958
1959 <row>
1960 <entry>shared-mime-info</entry>
1961
1962 <entry>1.9</entry>
1963
1964 <entry>Shared MIME type database and specification.</entry>
1965
1966 <entry>GPL-2.0</entry>
1967 </row>
1968
1969 <row>
1970 <entry>sqlite3</entry>
1971
1972 <entry>3.22.0</entry>
1973
1974 <entry>Embeddable SQL database engine.</entry>
1975
1976 <entry>PD</entry>
1977 </row>
1978
1979 <row>
1980 <entry>squashfs-tools</entry>
1981
1982 <entry>4.3</entry>
1983
1984 <entry>Tools for manipulating SquashFS filesystems.</entry>
1985
1986 <entry>GPL-2.0, PD</entry>
1987 </row>
1988
1989 <row>
1990 <entry>stress</entry>
1991
1992 <entry>1.0.4</entry>
1993
1994 <entry>Deliberately simple workload generator for POSIX systems.
1995 It imposes a configurable amount of CPU memory I/O and disk stress
1996 on the system.</entry>
1997
1998 <entry>GPL-2.0</entry>
1999 </row>
2000
2001 <row>
2002 <entry>syslinux</entry>
2003
2004 <entry>6.03</entry>
2005
2006 <entry>Multi-purpose linux bootloader.</entry>
2007
2008 <entry>GPL-2.0</entry>
2009 </row>
2010
2011 <row>
2012 <entry>systemd-boot</entry>
2013
2014 <entry>237</entry>
2015
2016 <entry>systemd is a system and service manager for Linux
2017 compatible with SysV and LSB init scripts. systemd provides
2018 aggressive parallelization capabilities uses socket and D-Bus
2019 activation for starting services offers on-demand starting of
2020 daemons keeps track of processes using Linux cgroups supports
2021 snapshotting and restoring of the system state maintains mount and
2022 automount points and implements an elaborate transactional
2023 dependency-based service control logic. It can work as a drop-in
2024 replacement for sysvinit.</entry>
2025
2026 <entry>GPL-2.0, LGPL-2.1</entry>
2027 </row>
2028
2029 <row>
2030 <entry>systemd-bootconf</entry>
2031
2032 <entry>1.00</entry>
2033
2034 <entry>Basic systemd-boot configuration files.</entry>
2035
2036 <entry>MIT</entry>
2037 </row>
2038
2039 <row>
2040 <entry>systemd-compat-units</entry>
2041
2042 <entry>1.0</entry>
2043
2044 <entry>Enhances systemd compatilibity with existing SysVinit
2045 scripts.</entry>
2046
2047 <entry>MIT</entry>
2048 </row>
2049
2050 <row>
2051 <entry>systemd-serialgetty</entry>
2052
2053 <entry>1.0</entry>
2054
2055 <entry>Serial terminal support for systemd.</entry>
2056
2057 <entry>GPL-2.0</entry>
2058 </row>
2059
2060 <row>
2061 <entry>systemd-systemctl</entry>
2062
2063 <entry>1.0</entry>
2064
2065 <entry>Wrapper for enabling systemd services.</entry>
2066
2067 <entry>MIT</entry>
2068 </row>
2069
2070 <row>
2071 <entry>systemd</entry>
2072
2073 <entry>237</entry>
2074
2075 <entry>systemd is a system and service manager for Linux
2076 compatible with SysV and LSB init scripts. systemd provides
2077 aggressive parallelization capabilities uses socket and D-Bus
2078 activation for starting services offers on-demand starting of
2079 daemons keeps track of processes using Linux cgroups supports
2080 snapshotting and restoring of the system state maintains mount and
2081 automount points and implements an elaborate transactional
2082 dependency-based service control logic. It can work as a drop-in
2083 replacement for sysvinit.</entry>
2084
2085 <entry>GPL-2.0, LGPL-2.1</entry>
2086 </row>
2087
2088 <row>
2089 <entry>texinfo-dummy</entry>
2090
2091 <entry>1.0</entry>
2092
2093 <entry>Fake version of the texinfo utility suite.</entry>
2094
2095 <entry>MIT</entry>
2096 </row>
2097
2098 <row>
2099 <entry>thermald</entry>
2100
2101 <entry>1.7.1</entry>
2102
2103 <entry>Thermal Daemon is a Linux daemon used to prevent the
2104 overheating of platforms. This daemon monitors temperature and
2105 applies compensation using available cooling methods.</entry>
2106
2107 <entry>GPL-2.0</entry>
2108 </row>
2109
2110 <row>
2111 <entry>tzcode</entry>
2112
2113 <entry>2018d</entry>
2114
2115 <entry>tzcode timezone zoneinfo utils -- zic zdump
2116 tzselect.</entry>
2117
2118 <entry>PD, BSD, BSD-3-Clause</entry>
2119 </row>
2120
2121 <row>
2122 <entry>tzdata</entry>
2123
2124 <entry>2018d</entry>
2125
2126 <entry>Timezone data.</entry>
2127
2128 <entry>PD, BSD, BSD-3-Clause</entry>
2129 </row>
2130
2131 <row>
2132 <entry>unifdef</entry>
2133
2134 <entry>2.11</entry>
2135
2136 <entry>Selectively remove #ifdef statements from sources.</entry>
2137
2138 <entry>BSD-2-Clause</entry>
2139 </row>
2140
2141 <row>
2142 <entry>unzip</entry>
2143
2144 <entry>6.0</entry>
2145
2146 <entry>Utilities for extracting and viewing files in .zip
2147 archives.</entry>
2148
2149 <entry>BSD-3-Clause</entry>
2150 </row>
2151
2152 <row>
2153 <entry>update-rc.d</entry>
2154
2155 <entry>0.7</entry>
2156
2157 <entry>update-rc.d is a utility that allows the management of
2158 symlinks to the initscripts in the /etc/rcN.d directory
2159 structure.</entry>
2160
2161 <entry>GPL-2.0</entry>
2162 </row>
2163
2164 <row>
2165 <entry>util-linux</entry>
2166
2167 <entry>2.32</entry>
2168
2169 <entry>Util-linux includes a suite of basic system administration
2170 utilities commonly found on most Linux systems. Some of the more
2171 important utilities include disk partitioning kernel message
2172 management filesystem creation and system login.</entry>
2173
2174 <entry>GPL-2.0, LGPL-2.1, BSD</entry>
2175 </row>
2176
2177 <row>
2178 <entry>util-macros</entry>
2179
2180 <entry>1.19.1</entry>
2181
2182 <entry>M4 autotools macros used by various X.org programs.</entry>
2183
2184 <entry>MIT</entry>
2185 </row>
2186
2187 <row>
2188 <entry>volatile-binds</entry>
2189
2190 <entry>1.0</entry>
2191
2192 <entry>Volatile bind mount setup and configuration for
2193 read-only-rootfs</entry>
2194
2195 <entry>MIT</entry>
2196 </row>
2197
2198 <row>
2199 <entry>which</entry>
2200
2201 <entry>2.21</entry>
2202
2203 <entry>Which is a utility that prints out the full path of the
2204 executables that bash(1) would execute when the passed program
2205 names would have been entered on the shell prompt. It does this by
2206 using the exact same algorithm as bash.</entry>
2207
2208 <entry>GPL-3.0</entry>
2209 </row>
2210
2211 <row>
2212 <entry>xcb-proto</entry>
2213
2214 <entry>1.12</entry>
2215
2216 <entry>Function prototypes for the X protocol C-language Binding
2217 (XCB). XCB is a replacement for Xlib featuring a small footprint
2218 latency hiding direct access to the protocol improved threading
2219 support and extensibility.</entry>
2220
2221 <entry>MIT</entry>
2222 </row>
2223
2224 <row>
2225 <entry>xextproto</entry>
2226
2227 <entry>7.3.0</entry>
2228
2229 <entry>This package provides the wire protocol for several X
2230 extensions. These protocol extensions include DOUBLE-BUFFER DPMS
2231 Extended-Visual-Information LBX MIT_SHM MIT_SUNDRY-NONSTANDARD
2232 Multi-Buffering SECURITY SHAPE SYNC TOG-CUP XC-APPGROUP XC-MISC
2233 XTEST. In addition a small set of utility functions are also
2234 available.</entry>
2235
2236 <entry>MIT</entry>
2237 </row>
2238
2239 <row>
2240 <entry>xkeyboard-config</entry>
2241
2242 <entry>2.22</entry>
2243
2244 <entry>The non-arch keyboard configuration database for X Window.
2245 The goal is to provide the consistent well-structured frequently
2246 released open source of X keyboard configuration data for X Window
2247 System implementations. The project is targeted to XKB-based
2248 systems.</entry>
2249
2250 <entry>MIT</entry>
2251 </row>
2252
2253 <row>
2254 <entry>xproto</entry>
2255
2256 <entry>7.0.31</entry>
2257
2258 <entry>This package provides the basic headers for the X Window
2259 System.</entry>
2260
2261 <entry>MIT</entry>
2262 </row>
2263
2264 <row>
2265 <entry>xtrans</entry>
2266
2267 <entry>1.3.5</entry>
2268
2269 <entry>The X Transport Interface is intended to combine all system
2270 and transport specific code into a single place. This API should
2271 be used by all libraries clients and servers of the X Window
2272 System. Use of this API should allow the addition of new types of
2273 transports and support for new platforms without making any
2274 changes to the source except in the X Transport Interface
2275 code.</entry>
2276
2277 <entry>MIT</entry>
2278 </row>
2279
2280 <row>
2281 <entry>xz</entry>
2282
2283 <entry>5.2.3</entry>
2284
2285 <entry>Utilities for managing LZMA compressed files.</entry>
2286
2287 <entry>GPL-2.0, GPL-3.0-with-autoconf-exception, LGPL-2.1,
2288 PD</entry>
2289 </row>
2290
2291 <row>
2292 <entry>zlib</entry>
2293
2294 <entry>1.2.11</entry>
2295
2296 <entry>Zlib is a general-purpose patent-free lossless data
2297 compression library which is used by many different
2298 programs.</entry>
2299
2300 <entry>Zlib</entry>
2301 </row>
2302 </tbody>
2303 </tgroup>
2304 </informaltable>
2305 </section>
2306
2307 <section id="open_source_license">
2308 <title>Open Source Licenses</title>
2309
2310 <section id="lic_0">
2311 <title>AFL-2.0</title>
2312
2313 <para><programlisting>
2314
2315The Academic Free License
2316 v. 2.0
2317
2318This Academic Free License (the "License") applies to any original work of authorship
2319(the "Original Work") whose owner (the "Licensor") has placed the following notice
2320immediately following the copyright notice for the Original Work:
2321Licensed under the Academic Free License version 2.0
2322
23231) Grant of Copyright License. Licensor hereby grants You a world-wide, royalty-free,
2324non-exclusive, perpetual, sublicenseable license to do the following:
2325a) to reproduce the Original Work in copies;
2326
2327b) to prepare derivative works ("Derivative Works") based upon the Original Work;
2328
2329c) to distribute copies of the Original Work and Derivative Works to the public;
2330
2331d) to perform the Original Work publicly; and
2332
2333e) to display the Original Work publicly.
2334
23352) Grant of Patent License. Licensor hereby grants You a world-wide, royalty-free,
2336non-exclusive, perpetual, sublicenseable license, under patent claims owned or
2337controlled by the Licensor that are embodied in the Original Work as furnished by the
2338Licensor, to make, use, sell and offer for sale the Original Work and Derivative
2339Works.
2340
23413) Grant of Source Code License. The term "Source Code" means the preferred form of
2342the Original Work for making modifications to it and all available documentation
2343describing how to modify the Original Work. Licensor hereby agrees to provide a
2344machine-readable copy of the Source Code of the Original Work along with each copy of
2345the Original Work that Licensor distributes. Licensor reserves the right to satisfy
2346this obligation by placing a machine-readable copy of the Source Code in an
2347information repository reasonably calculated to permit inexpensive and convenient
2348access by You for as long as Licensor continues to distribute the Original Work, and
2349by publishing the address of that information repository in a notice immediately
2350following the copyright notice that applies to the Original Work.
2351
23524) Exclusions From License Grant. Neither the names of Licensor, nor the names of any
2353contributors to the Original Work, nor any of their trademarks or service marks, may
2354be used to endorse or promote products derived from this Original Work without express
2355prior written permission of the Licensor. Nothing in this License shall be deemed to
2356grant any rights to trademarks, copyrights, patents, trade secrets or any other
2357intellectual property of Licensor except as expressly stated herein. No patent
2358license is granted to make, use, sell or offer to sell embodiments of any patent
2359claims other than the licensed claims defined in Section 2. No right is granted to
2360the trademarks of Licensor even if such marks are included in the Original Work.
2361Nothing in this License shall be interpreted to prohibit Licensor from licensing under
2362different terms from this License any Original Work that Licensor otherwise would have
2363a right to license.
2364
23655) This section intentionally omitted.
2366
23676) Attribution Rights. You must retain, in the Source Code of any Derivative Works
2368that You create, all copyright, patent or trademark notices from the Source Code of
2369the Original Work, as well as any notices of licensing and any descriptive text
2370identified therein as an "Attribution Notice." You must cause the Source Code for any
2371Derivative Works that You create to carry a prominent Attribution Notice reasonably
2372calculated to inform recipients that You have modified the Original Work.
2373
23747) Warranty of Provenance and Disclaimer of Warranty. Licensor warrants that the
2375copyright in and to the Original Work and the patent rights granted herein by Licensor
2376are owned by the Licensor or are sublicensed to You under the terms of this License
2377with the permission of the contributor(s) of those copyrights and patent rights.
2378Except as expressly stated in the immediately proceeding sentence, the Original Work
2379is provided under this License on an "AS IS" BASIS and WITHOUT WARRANTY, either
2380express or implied, including, without limitation, the warranties of NON-INFRINGEMENT,
2381MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
2382QUALITY OF THE ORIGINAL WORK IS WITH YOU. This DISCLAIMER OF WARRANTY constitutes an
2383essential part of this License. No license to Original Work is granted hereunder
2384except under this disclaimer.
2385
23868) Limitation of Liability. Under no circumstances and under no legal theory, whether
2387in tort (including negligence), contract, or otherwise, shall the Licensor be liable
2388to any person for any direct, indirect, special, incidental, or consequential damages
2389of any character arising as a result of this License or the use of the Original Work
2390including, without limitation, damages for loss of goodwill, work stoppage, computer
2391failure or malfunction, or any and all other commercial damages or losses. This
2392limitation of liability shall not apply to liability for death or personal injury
2393resulting from Licensor`s negligence to the extent applicable law prohibits such
2394limitation. Some jurisdictions do not allow the exclusion or limitation of incidental
2395or consequential damages, so this exclusion and limitation may not apply to You.
2396
23979) Acceptance and Termination. If You distribute copies of the Original Work or a
2398Derivative Work, You must make a reasonable effort under the circumstances to obtain
2399the express assent of recipients to the terms of this License. Nothing else but this
2400License (or another written agreement between Licensor and You) grants You permission
2401to create Derivative Works based upon the Original Work or to exercise any of the
2402rights granted in Section 1 herein, and any attempt to do so except under the terms of
2403this License (or another written agreement between Licensor and You) is expressly
2404prohibited by U.S. copyright law, the equivalent laws of other countries, and by
2405international treaty. Therefore, by exercising any of the rights granted to You in
2406Section 1 herein, You indicate Your acceptance of this License and all of its terms
2407and conditions.
2408
240910) Termination for Patent Action. This License shall terminate automatically and You
2410may no longer exercise any of the rights granted to You by this License as of the date
2411You commence an action, including a cross-claim or counterclaim, for patent
2412infringement (i) against Licensor with respect to a patent applicable to software or
2413(ii) against any entity with respect to a patent applicable to the Original Work (but
2414excluding combinations of the Original Work with other software or hardware).
2415
241611) Jurisdiction, Venue and Governing Law. Any action or suit relating to this License
2417may be brought only in the courts of a jurisdiction wherein the Licensor resides or in
2418which Licensor conducts its primary business, and under the laws of that jurisdiction
2419excluding its conflict-of-law provisions. The application of the United Nations
2420Convention on Contracts for the International Sale of Goods is expressly excluded.
2421Any use of the Original Work outside the scope of this License or after its
2422termination shall be subject to the requirements and penalties of the U.S. Copyright
2423Act, 17 U.S.C. ¤ 101 et seq., the equivalent laws of other countries, and
2424international treaty. This section shall survive the termination of this License.
2425
242612) Attorneys Fees. In any action to enforce the terms of this License or seeking
2427damages relating thereto, the prevailing party shall be entitled to recover its costs
2428and expenses, including, without limitation, reasonable attorneys` fees and costs
2429incurred in connection with such action, including any appeal of such action. This
2430section shall survive the termination of this License.
2431
243213) Miscellaneous. This License represents the complete agreement concerning the
2433subject matter hereof. If any provision of this License is held to be unenforceable,
2434such provision shall be reformed only to the extent necessary to make it enforceable.
2435
243614) Definition of "You" in This License. "You" throughout this License, whether in
2437upper or lower case, means an individual or a legal entity exercising rights under,
2438and complying with all of the terms of, this License. For legal entities, "You"
2439includes any entity that controls, is controlled by, or is under common control with
2440you. For purposes of this definition, "control" means (i) the power, direct or
2441indirect, to cause the direction or management of such entity, whether by contract or
2442otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares,
2443or (iii) beneficial ownership of such entity.
2444
244515) Right to Use. You may use the Original Work in all ways not otherwise restricted
2446or conditioned by this License or by law, and Licensor promises not to interfere with
2447or be responsible for such uses by You.
2448
2449This license is Copyright (C) 2003 Lawrence E. Rosen. All rights reserved.
2450Permission is hereby granted to copy and distribute this license without modification.
2451This license may not be modified without the express written permission of its
2452copyright owner.
2453
2454</programlisting></para>
2455 </section>
2456
2457 <section id="lic_1">
2458 <title>Apache-2.0</title>
2459
2460 <para><programlisting>
2461
2462
2463 Apache License
2464 Version 2.0, January 2004
2465 http://www.apache.org/licenses/
2466
2467 TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
2468
2469 1. Definitions.
2470
2471 "License" shall mean the terms and conditions for use, reproduction,
2472 and distribution as defined by Sections 1 through 9 of this document.
2473
2474 "Licensor" shall mean the copyright owner or entity authorized by
2475 the copyright owner that is granting the License.
2476
2477 "Legal Entity" shall mean the union of the acting entity and all
2478 other entities that control, are controlled by, or are under common
2479 control with that entity. For the purposes of this definition,
2480 "control" means (i) the power, direct or indirect, to cause the
2481 direction or management of such entity, whether by contract or
2482 otherwise, or (ii) ownership of fifty percent (50%) or more of the
2483 outstanding shares, or (iii) beneficial ownership of such entity.
2484
2485 "You" (or "Your") shall mean an individual or Legal Entity
2486 exercising permissions granted by this License.
2487
2488 "Source" form shall mean the preferred form for making modifications,
2489 including but not limited to software source code, documentation
2490 source, and configuration files.
2491
2492 "Object" form shall mean any form resulting from mechanical
2493 transformation or translation of a Source form, including but
2494 not limited to compiled object code, generated documentation,
2495 and conversions to other media types.
2496
2497 "Work" shall mean the work of authorship, whether in Source or
2498 Object form, made available under the License, as indicated by a
2499 copyright notice that is included in or attached to the work
2500 (an example is provided in the Appendix below).
2501
2502 "Derivative Works" shall mean any work, whether in Source or Object
2503 form, that is based on (or derived from) the Work and for which the
2504 editorial revisions, annotations, elaborations, or other modifications
2505 represent, as a whole, an original work of authorship. For the purposes
2506 of this License, Derivative Works shall not include works that remain
2507 separable from, or merely link (or bind by name) to the interfaces of,
2508 the Work and Derivative Works thereof.
2509
2510 "Contribution" shall mean any work of authorship, including
2511 the original version of the Work and any modifications or additions
2512 to that Work or Derivative Works thereof, that is intentionally
2513 submitted to Licensor for inclusion in the Work by the copyright owner
2514 or by an individual or Legal Entity authorized to submit on behalf of
2515 the copyright owner. For the purposes of this definition, "submitted"
2516 means any form of electronic, verbal, or written communication sent
2517 to the Licensor or its representatives, including but not limited to
2518 communication on electronic mailing lists, source code control systems,
2519 and issue tracking systems that are managed by, or on behalf of, the
2520 Licensor for the purpose of discussing and improving the Work, but
2521 excluding communication that is conspicuously marked or otherwise
2522 designated in writing by the copyright owner as "Not a Contribution."
2523
2524 "Contributor" shall mean Licensor and any individual or Legal Entity
2525 on behalf of whom a Contribution has been received by Licensor and
2526 subsequently incorporated within the Work.
2527
2528 2. Grant of Copyright License. Subject to the terms and conditions of
2529 this License, each Contributor hereby grants to You a perpetual,
2530 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
2531 copyright license to reproduce, prepare Derivative Works of,
2532 publicly display, publicly perform, sublicense, and distribute the
2533 Work and such Derivative Works in Source or Object form.
2534
2535 3. Grant of Patent License. Subject to the terms and conditions of
2536 this License, each Contributor hereby grants to You a perpetual,
2537 worldwide, non-exclusive, no-charge, royalty-free, irrevocable
2538 (except as stated in this section) patent license to make, have made,
2539 use, offer to sell, sell, import, and otherwise transfer the Work,
2540 where such license applies only to those patent claims licensable
2541 by such Contributor that are necessarily infringed by their
2542 Contribution(s) alone or by combination of their Contribution(s)
2543 with the Work to which such Contribution(s) was submitted. If You
2544 institute patent litigation against any entity (including a
2545 cross-claim or counterclaim in a lawsuit) alleging that the Work
2546 or a Contribution incorporated within the Work constitutes direct
2547 or contributory patent infringement, then any patent licenses
2548 granted to You under this License for that Work shall terminate
2549 as of the date such litigation is filed.
2550
2551 4. Redistribution. You may reproduce and distribute copies of the
2552 Work or Derivative Works thereof in any medium, with or without
2553 modifications, and in Source or Object form, provided that You
2554 meet the following conditions:
2555
2556 (a) You must give any other recipients of the Work or
2557 Derivative Works a copy of this License; and
2558
2559 (b) You must cause any modified files to carry prominent notices
2560 stating that You changed the files; and
2561
2562 (c) You must retain, in the Source form of any Derivative Works
2563 that You distribute, all copyright, patent, trademark, and
2564 attribution notices from the Source form of the Work,
2565 excluding those notices that do not pertain to any part of
2566 the Derivative Works; and
2567
2568 (d) If the Work includes a "NOTICE" text file as part of its
2569 distribution, then any Derivative Works that You distribute must
2570 include a readable copy of the attribution notices contained
2571 within such NOTICE file, excluding those notices that do not
2572 pertain to any part of the Derivative Works, in at least one
2573 of the following places: within a NOTICE text file distributed
2574 as part of the Derivative Works; within the Source form or
2575 documentation, if provided along with the Derivative Works; or,
2576 within a display generated by the Derivative Works, if and
2577 wherever such third-party notices normally appear. The contents
2578 of the NOTICE file are for informational purposes only and
2579 do not modify the License. You may add Your own attribution
2580 notices within Derivative Works that You distribute, alongside
2581 or as an addendum to the NOTICE text from the Work, provided
2582 that such additional attribution notices cannot be construed
2583 as modifying the License.
2584
2585 You may add Your own copyright statement to Your modifications and
2586 may provide additional or different license terms and conditions
2587 for use, reproduction, or distribution of Your modifications, or
2588 for any such Derivative Works as a whole, provided Your use,
2589 reproduction, and distribution of the Work otherwise complies with
2590 the conditions stated in this License.
2591
2592 5. Submission of Contributions. Unless You explicitly state otherwise,
2593 any Contribution intentionally submitted for inclusion in the Work
2594 by You to the Licensor shall be under the terms and conditions of
2595 this License, without any additional terms or conditions.
2596 Notwithstanding the above, nothing herein shall supersede or modify
2597 the terms of any separate license agreement you may have executed
2598 with Licensor regarding such Contributions.
2599
2600 6. Trademarks. This License does not grant permission to use the trade
2601 names, trademarks, service marks, or product names of the Licensor,
2602 except as required for reasonable and customary use in describing the
2603 origin of the Work and reproducing the content of the NOTICE file.
2604
2605 7. Disclaimer of Warranty. Unless required by applicable law or
2606 agreed to in writing, Licensor provides the Work (and each
2607 Contributor provides its Contributions) on an "AS IS" BASIS,
2608 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
2609 implied, including, without limitation, any warranties or conditions
2610 of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
2611 PARTICULAR PURPOSE. You are solely responsible for determining the
2612 appropriateness of using or redistributing the Work and assume any
2613 risks associated with Your exercise of permissions under this License.
2614
2615 8. Limitation of Liability. In no event and under no legal theory,
2616 whether in tort (including negligence), contract, or otherwise,
2617 unless required by applicable law (such as deliberate and grossly
2618 negligent acts) or agreed to in writing, shall any Contributor be
2619 liable to You for damages, including any direct, indirect, special,
2620 incidental, or consequential damages of any character arising as a
2621 result of this License or out of the use or inability to use the
2622 Work (including but not limited to damages for loss of goodwill,
2623 work stoppage, computer failure or malfunction, or any and all
2624 other commercial damages or losses), even if such Contributor
2625 has been advised of the possibility of such damages.
2626
2627 9. Accepting Warranty or Additional Liability. While redistributing
2628 the Work or Derivative Works thereof, You may choose to offer,
2629 and charge a fee for, acceptance of support, warranty, indemnity,
2630 or other liability obligations and/or rights consistent with this
2631 License. However, in accepting such obligations, You may act only
2632 on Your own behalf and on Your sole responsibility, not on behalf
2633 of any other Contributor, and only if You agree to indemnify,
2634 defend, and hold each Contributor harmless for any liability
2635 incurred by, or claims asserted against, such Contributor by reason
2636 of your accepting any such warranty or additional liability.
2637
2638 END OF TERMS AND CONDITIONS
2639
2640 APPENDIX: How to apply the Apache License to your work.
2641
2642 To apply the Apache License to your work, attach the following
2643 boilerplate notice, with the fields enclosed by brackets "[]"
2644 replaced with your own identifying information. (Don`t include
2645 the brackets!) The text should be enclosed in the appropriate
2646 comment syntax for the file format. We also recommend that a
2647 file or class name and description of purpose be included on the
2648 same "printed page" as the copyright notice for easier
2649 identification within third-party archives.
2650
2651 Copyright [yyyy] [name of copyright owner]
2652
2653 Licensed under the Apache License, Version 2.0 (the "License");
2654 you may not use this file except in compliance with the License.
2655 You may obtain a copy of the License at
2656
2657 http://www.apache.org/licenses/LICENSE-2.0
2658
2659 Unless required by applicable law or agreed to in writing, software
2660 distributed under the License is distributed on an "AS IS" BASIS,
2661 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
2662 See the License for the specific language governing permissions and
2663 limitations under the License.
2664
2665</programlisting></para>
2666 </section>
2667
2668 <section id="lic_2">
2669 <title>Artistic-1.0</title>
2670
2671 <para><programlisting>
2672
2673The Artistic License
2674Preamble
2675
2676The intent of this document is to state the conditions under which a Package may be
2677copied, such that the Copyright Holder maintains some semblance of artistic control
2678over the development of the package, while giving the users of the package the right
2679to use and distribute the Package in a more-or-less customary fashion, plus the right
2680to make reasonable modifications.
2681
2682Definitions:
2683
2684"Package" refers to the collection of files distributed by the Copyright Holder, and
2685derivatives of that collection of files created through textual modification.
2686"Standard Version" refers to such a Package if it has not been modified, or has been
2687modified in accordance with the wishes of the Copyright Holder.
2688"Copyright Holder" is whoever is named in the copyright or copyrights for the package.
2689"You" is you, if you`re thinking about copying or distributing this Package.
2690"Reasonable copying fee" is whatever you can justify on the basis of media cost,
2691duplication charges, time of people involved, and so on. (You will not be required to
2692justify it to the Copyright Holder, but only to the computing community at large as a
2693market that must bear the fee.)
2694"Freely Available" means that no fee is charged for the item itself, though there may
2695be fees involved in handling the item. It also means that recipients of the item may
2696redistribute it under the same conditions they received it.
26971. You may make and give away verbatim copies of the source form of the Standard
2698Version of this Package without restriction, provided that you duplicate all of the
2699original copyright notices and associated disclaimers.
2700
27012. You may apply bug fixes, portability fixes and other modifications derived from the
2702Public Domain or from the Copyright Holder. A Package modified in such a way shall
2703still be considered the Standard Version.
2704
27053. You may otherwise modify your copy of this Package in any way, provided that you
2706insert a prominent notice in each changed file stating how and when you changed that
2707file, and provided that you do at least ONE of the following:
2708
2709a) place your modifications in the Public Domain or otherwise make them Freely
2710Available, such as by posting said modifications to Usenet or an equivalent medium, or
2711placing the modifications on a major archive site such as ftp.uu.net, or by allowing
2712the Copyright Holder to include your modifications in the Standard Version of the
2713Package.
2714
2715b) use the modified Package only within your corporation or organization.
2716
2717c) rename any non-standard executables so the names do not conflict with standard
2718executables, which must also be provided, and provide a separate manual page for each
2719non-standard executable that clearly documents how it differs from the Standard
2720Version.
2721
2722d) make other distribution arrangements with the Copyright Holder.
2723
27244. You may distribute the programs of this Package in object code or executable form,
2725provided that you do at least ONE of the following:
2726
2727a) distribute a Standard Version of the executables and library files, together with
2728instructions (in the manual page or equivalent) on where to get the Standard Version.
2729
2730b) accompany the distribution with the machine-readable source of the Package with
2731your modifications.
2732
2733c) accompany any non-standard executables with their corresponding Standard Version
2734executables, giving the non-standard executables non-standard names, and clearly
2735documenting the differences in manual pages (or equivalent), together with
2736instructions on where to get the Standard Version.
2737
2738d) make other distribution arrangements with the Copyright Holder.
2739
27405. You may charge a reasonable copying fee for any distribution of this Package. You
2741may charge any fee you choose for support of this Package. You may not charge a fee
2742for this Package itself. However, you may distribute this Package in aggregate with
2743other (possibly commercial) programs as part of a larger (possibly commercial)
2744software distribution provided that you do not advertise this Package as a product of
2745your own.
2746
27476. The scripts and library files supplied as input to or produced as output from the
2748programs of this Package do not automatically fall under the copyright of this
2749Package, but belong to whomever generated them, and may be sold commercially, and may
2750be aggregated with this Package.
2751
27527. C or perl subroutines supplied by you and linked into this Package shall not be
2753considered part of this Package.
2754
27558. The name of the Copyright Holder may not be used to endorse or promote products
2756derived from this software without specific prior written permission.
2757
27589. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES,
2759INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS
2760FOR A PARTICULAR PURPOSE.
2761
2762The End
2763
2764</programlisting></para>
2765 </section>
2766
2767 <section id="lic_3">
2768 <title>BSD</title>
2769
2770 <para><programlisting>
2771Copyright (c) The Regents of the University of California.
2772All rights reserved.
2773
2774Redistribution and use in source and binary forms, with or without
2775modification, are permitted provided that the following conditions
2776are met:
27771. Redistributions of source code must retain the above copyright
2778 notice, this list of conditions and the following disclaimer.
27792. Redistributions in binary form must reproduce the above copyright
2780 notice, this list of conditions and the following disclaimer in the
2781 documentation and/or other materials provided with the distribution.
27823. Neither the name of the University nor the names of its contributors
2783 may be used to endorse or promote products derived from this software
2784 without specific prior written permission.
2785
2786THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
2787ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2788IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2789ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
2790FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2791DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2792OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2793HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2794LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2795OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
2796SUCH DAMAGE.
2797</programlisting></para>
2798 </section>
2799
2800 <section id="lic_4">
2801 <title>BSD-2-Clause</title>
2802
2803 <para><programlisting>
2804
2805The FreeBSD Copyright
2806
2807Copyright 1992-2010 The FreeBSD Project. All rights reserved.
2808
2809Redistribution and use in source and binary forms, with or without modification, are
2810permitted provided that the following conditions are met:
2811
2812Redistributions of source code must retain the above copyright notice, this list of
2813conditions and the following disclaimer.
2814Redistributions in binary form must reproduce the above copyright notice, this list of
2815conditions and the following disclaimer in the documentation and/or other materials
2816provided with the distribution.
2817THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS`` AND ANY EXPRESS OR IMPLIED
2818WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
2819AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD
2820PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
2821EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
2822SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2823HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
2824OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
2825SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2826
2827The views and conclusions contained in the software and documentation are those of the
2828authors and should not be interpreted as representing official policies, either
2829expressed or implied, of the FreeBSD Project.
2830
2831</programlisting></para>
2832 </section>
2833
2834 <section id="lic_5">
2835 <title>BSD-3-Clause</title>
2836
2837 <para><programlisting>
2838
2839Copyright (c) &lt;YEAR&gt;, &lt;OWNER&gt;
2840All rights reserved.
2841
2842Redistribution and use in source and binary forms, with or without modification, are
2843permitted provided that the following conditions are met:
2844
2845Redistributions of source code must retain the above copyright notice, this list of
2846conditions and the following disclaimer.
2847Redistributions in binary form must reproduce the above copyright notice, this list of
2848conditions and the following disclaimer in the documentation and/or other materials
2849provided with the distribution.
2850Neither the name of the &lt;ORGANIZATION&gt; nor the names of its contributors may be
2851used to endorse or promote products derived from this software without specific prior
2852written permission.
2853THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
2854EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
2855OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
2856SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
2857INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
2858TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
2859BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
2860CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
2861WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
2862DAMAGE.
2863
2864</programlisting></para>
2865 </section>
2866
2867 <section id="lic_6">
2868 <title>BSD-4-Clause</title>
2869
2870 <para><programlisting>
2871
2872Copyright (c) &lt;year&gt;, &lt;copyright holder&gt;
2873All rights reserved.
2874
2875Redistribution and use in source and binary forms, with or without
2876modification, are permitted provided that the following conditions are met:
28771. Redistributions of source code must retain the above copyright
2878 notice, this list of conditions and the following disclaimer.
28792. Redistributions in binary form must reproduce the above copyright
2880 notice, this list of conditions and the following disclaimer in the
2881 documentation and/or other materials provided with the distribution.
28823. All advertising materials mentioning features or use of this software
2883 must display the following acknowledgement:
2884 This product includes software developed by the &lt;organization&gt;.
28854. Neither the name of the &lt;organization&gt; nor the
2886 names of its contributors may be used to endorse or promote products
2887 derived from this software without specific prior written permission.
2888
2889THIS SOFTWARE IS PROVIDED BY &lt;COPYRIGHT HOLDER&gt; ``AS IS`` AND ANY
2890EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
2891WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
2892DISCLAIMED. IN NO EVENT SHALL &lt;COPYRIGHT HOLDER&gt; BE LIABLE FOR ANY
2893DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
2894(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
2895LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
2896ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
2897(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
2898SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
2899
2900</programlisting></para>
2901 </section>
2902
2903 <section id="lic_7">
2904 <title>Elfutils-Exception</title>
2905
2906 <para><programlisting>
2907 This file describes the limits of the Exception under which you are allowed
2908 to distribute Non-GPL Code in linked combination with Red Hat elfutils.
2909 For the full text of the license, please see one of the header files
2910 included with the source distribution or the file COPYING found in the
2911 top level directory of the source.
2912
2913 The Approved Interfaces are the functions declared in the files:
2914
2915 libelf.h
2916 libdw.h
2917 libdwfl.h
2918
2919</programlisting></para>
2920 </section>
2921
2922 <section id="lic_8">
2923 <title>FSF-Unlimited</title>
2924
2925 <para><programlisting>
2926Copyright (C) 1997-2010 Free Software Foundation, Inc.
2927This file is free software; the Free Software Foundation
2928gives unlimited permission to copy and/or distribute it,
2929with or without modifications, as long as this notice is preserved.
2930</programlisting></para>
2931 </section>
2932
2933 <section id="lic_9">
2934 <title>FreeType</title>
2935
2936 <para><programlisting>
2937 The FreeType Project LICENSE
2938 ----------------------------
2939
2940 2006-Jan-27
2941
2942 Copyright 1996-2002, 2006 by
2943 David Turner, Robert Wilhelm, and Werner Lemberg
2944
2945
2946
2947Introduction
2948============
2949
2950 The FreeType Project is distributed in several archive packages;
2951 some of them may contain, in addition to the FreeType font engine,
2952 various tools and contributions which rely on, or relate to, the
2953 FreeType Project.
2954
2955 This license applies to all files found in such packages, and
2956 which do not fall under their own explicit license. The license
2957 affects thus the FreeType font engine, the test programs,
2958 documentation and makefiles, at the very least.
2959
2960 This license was inspired by the BSD, Artistic, and IJG
2961 (Independent JPEG Group) licenses, which all encourage inclusion
2962 and use of free software in commercial and freeware products
2963 alike. As a consequence, its main points are that:
2964
2965 o We don't promise that this software works. However, we will be
2966 interested in any kind of bug reports. (`as is' distribution)
2967
2968 o You can use this software for whatever you want, in parts or
2969 full form, without having to pay us. (`royalty-free' usage)
2970
2971 o You may not pretend that you wrote this software. If you use
2972 it, or only parts of it, in a program, you must acknowledge
2973 somewhere in your documentation that you have used the
2974 FreeType code. (`credits')
2975
2976 We specifically permit and encourage the inclusion of this
2977 software, with or without modifications, in commercial products.
2978 We disclaim all warranties covering The FreeType Project and
2979 assume no liability related to The FreeType Project.
2980
2981
2982 Finally, many people asked us for a preferred form for a
2983 credit/disclaimer to use in compliance with this license. We thus
2984 encourage you to use the following text:
2985
2986 """
2987 Portions of this software are copyright � &lt;year&gt; The FreeType
2988 Project (www.freetype.org). All rights reserved.
2989 """
2990
2991 Please replace &lt;year&gt; with the value from the FreeType version you
2992 actually use.
2993
2994
2995Legal Terms
2996===========
2997
29980. Definitions
2999--------------
3000
3001 Throughout this license, the terms `package', `FreeType Project',
3002 and `FreeType archive' refer to the set of files originally
3003 distributed by the authors (David Turner, Robert Wilhelm, and
3004 Werner Lemberg) as the `FreeType Project', be they named as alpha,
3005 beta or final release.
3006
3007 `You' refers to the licensee, or person using the project, where
3008 `using' is a generic term including compiling the project's source
3009 code as well as linking it to form a `program' or `executable'.
3010 This program is referred to as `a program using the FreeType
3011 engine'.
3012
3013 This license applies to all files distributed in the original
3014 FreeType Project, including all source code, binaries and
3015 documentation, unless otherwise stated in the file in its
3016 original, unmodified form as distributed in the original archive.
3017 If you are unsure whether or not a particular file is covered by
3018 this license, you must contact us to verify this.
3019
3020 The FreeType Project is copyright (C) 1996-2000 by David Turner,
3021 Robert Wilhelm, and Werner Lemberg. All rights reserved except as
3022 specified below.
3023
30241. No Warranty
3025--------------
3026
3027 THE FREETYPE PROJECT IS PROVIDED `AS IS' WITHOUT WARRANTY OF ANY
3028 KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
3029 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
3030 PURPOSE. IN NO EVENT WILL ANY OF THE AUTHORS OR COPYRIGHT HOLDERS
3031 BE LIABLE FOR ANY DAMAGES CAUSED BY THE USE OR THE INABILITY TO
3032 USE, OF THE FREETYPE PROJECT.
3033
30342. Redistribution
3035-----------------
3036
3037 This license grants a worldwide, royalty-free, perpetual and
3038 irrevocable right and license to use, execute, perform, compile,
3039 display, copy, create derivative works of, distribute and
3040 sublicense the FreeType Project (in both source and object code
3041 forms) and derivative works thereof for any purpose; and to
3042 authorize others to exercise some or all of the rights granted
3043 herein, subject to the following conditions:
3044
3045 o Redistribution of source code must retain this license file
3046 (`FTL.TXT') unaltered; any additions, deletions or changes to
3047 the original files must be clearly indicated in accompanying
3048 documentation. The copyright notices of the unaltered,
3049 original files must be preserved in all copies of source
3050 files.
3051
3052 o Redistribution in binary form must provide a disclaimer that
3053 states that the software is based in part of the work of the
3054 FreeType Team, in the distribution documentation. We also
3055 encourage you to put an URL to the FreeType web page in your
3056 documentation, though this isn't mandatory.
3057
3058 These conditions apply to any software derived from or based on
3059 the FreeType Project, not just the unmodified files. If you use
3060 our work, you must acknowledge us. However, no fee need be paid
3061 to us.
3062
30633. Advertising
3064--------------
3065
3066 Neither the FreeType authors and contributors nor you shall use
3067 the name of the other for commercial, advertising, or promotional
3068 purposes without specific prior written permission.
3069
3070 We suggest, but do not require, that you use one or more of the
3071 following phrases to refer to this software in your documentation
3072 or advertising materials: `FreeType Project', `FreeType Engine',
3073 `FreeType library', or `FreeType Distribution'.
3074
3075 As you have not signed this license, you are not required to
3076 accept it. However, as the FreeType Project is copyrighted
3077 material, only this license, or another one contracted with the
3078 authors, grants you the right to use, distribute, and modify it.
3079 Therefore, by using, distributing, or modifying the FreeType
3080 Project, you indicate that you understand and accept all the terms
3081 of this license.
3082
30834. Contacts
3084-----------
3085
3086 There are two mailing lists related to FreeType:
3087
3088 o freetype@nongnu.org
3089
3090 Discusses general use and applications of FreeType, as well as
3091 future and wanted additions to the library and distribution.
3092 If you are looking for support, start in this list if you
3093 haven't found anything to help you in the documentation.
3094
3095 o freetype-devel@nongnu.org
3096
3097 Discusses bugs, as well as engine internals, design issues,
3098 specific licenses, porting, etc.
3099
3100 Our home page can be found at
3101
3102 http://www.freetype.org
3103
3104
3105--- end of FTL.TXT ---
3106
3107</programlisting></para>
3108 </section>
3109
3110 <section id="lic_10">
3111 <title>GPL-1.0</title>
3112
3113 <para><programlisting>
3114
3115GNU General Public License, version 1
3116
3117 GNU GENERAL PUBLIC LICENSE
3118 Version 1, February 1989
3119
3120 Copyright (C) 1989 Free Software Foundation, Inc.
3121 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
3122 Everyone is permitted to copy and distribute verbatim copies
3123 of this license document, but changing it is not allowed.
3124
3125 Preamble
3126
3127 The license agreements of most software companies try to keep users
3128at the mercy of those companies. By contrast, our General Public
3129License is intended to guarantee your freedom to share and change free
3130software--to make sure the software is free for all its users. The
3131General Public License applies to the Free Software Foundation`s
3132software and to any other program whose authors commit to using it.
3133You can use it for your programs, too.
3134
3135 When we speak of free software, we are referring to freedom, not
3136price. Specifically, the General Public License is designed to make
3137sure that you have the freedom to give away or sell copies of free
3138software, that you receive source code or can get it if you want it,
3139that you can change the software or use pieces of it in new free
3140programs; and that you know you can do these things.
3141
3142 To protect your rights, we need to make restrictions that forbid
3143anyone to deny you these rights or to ask you to surrender the rights.
3144These restrictions translate to certain responsibilities for you if you
3145distribute copies of the software, or if you modify it.
3146
3147 For example, if you distribute copies of a such a program, whether
3148gratis or for a fee, you must give the recipients all the rights that
3149you have. You must make sure that they, too, receive or can get the
3150source code. And you must tell them their rights.
3151
3152 We protect your rights with two steps: (1) copyright the software, and
3153(2) offer you this license which gives you legal permission to copy,
3154distribute and/or modify the software.
3155
3156 Also, for each author`s protection and ours, we want to make certain
3157that everyone understands that there is no warranty for this free
3158software. If the software is modified by someone else and passed on, we
3159want its recipients to know that what they have is not the original, so
3160that any problems introduced by others will not reflect on the original
3161authors` reputations.
3162
3163 The precise terms and conditions for copying, distribution and
3164modification follow.
3165
3166 GNU GENERAL PUBLIC LICENSE
3167 TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
3168
3169 0. This License Agreement applies to any program or other work which
3170contains a notice placed by the copyright holder saying it may be
3171distributed under the terms of this General Public License. The
3172"Program", below, refers to any such program or work, and a "work based
3173on the Program" means either the Program or any work containing the
3174Program or a portion of it, either verbatim or with modifications. Each
3175licensee is addressed as "you".
3176
3177 1. You may copy and distribute verbatim copies of the Program`s source
3178code as you receive it, in any medium, provided that you conspicuously and
3179appropriately publish on each copy an appropriate copyright notice and
3180disclaimer of warranty; keep intact all the notices that refer to this
3181General Public License and to the absence of any warranty; and give any
3182other recipients of the Program a copy of this General Public License
3183along with the Program. You may charge a fee for the physical act of
3184transferring a copy.
3185
3186 2. You may modify your copy or copies of the Program or any portion of
3187it, and copy and distribute such modifications under the terms of Paragraph
31881 above, provided that you also do the following:
3189
3190 a) cause the modified files to carry prominent notices stating that
3191 you changed the files and the date of any change; and
3192
3193 b) cause the whole of any work that you distribute or publish, that
3194 in whole or in part contains the Program or any part thereof, either
3195 with or without modifications, to be licensed at no charge to all
3196 third parties under the terms of this General Public License (except
3197 that you may choose to grant warranty protection to some or all
3198 third parties, at your option).
3199
3200 c) If the modified program normally reads commands interactively when
3201 run, you must cause it, when started running for such interactive use
3202 in the simplest and most usual way, to print or display an
3203 announcement including an appropriate copyright notice and a notice
3204 that there is no warranty (or else, saying that you provide a
3205 warranty) and that users may redistribute the program under these
3206 conditions, and telling the user how to view a copy of this General
3207 Public License.
3208
3209 d) You may charge a fee for the physical act of transferring a
3210 copy, and you may at your option offer warranty protection in
3211 exchange for a fee.
3212
3213Mere aggregation of another independent work with the Program (or its
3214derivative) on a volume of a storage or distribution medium does not bring
3215the other work under the scope of these terms.
3216
3217 3. You may copy and distribute the Program (or a portion or derivative of
3218it, under Paragraph 2) in object code or executable form under the terms of
3219Paragraphs 1 and 2 above provided that you also do one of the following:
3220
3221 a) accompany it with the complete corresponding machine-readable
3222 source code, which must be distributed under the terms of
3223 Paragraphs 1 and 2 above; or,
3224
3225 b) accompany it with a written offer, valid for at least three
3226 years, to give any third party free (except for a nominal charge
3227 for the cost of distribution) a complete machine-readable copy of the
3228 corresponding source code, to be distributed under the terms of
3229 Paragraphs 1 and 2 above; or,
3230
3231 c) accompany it with the information you received as to where the
3232 corresponding source code may be obtained. (This alternative is
3233 allowed only for noncommercial distribution and only if you
3234 received the program in object code or executable form alone.)
3235
3236Source code for a work means the preferred form of the work for making
3237modifications to it. For an executable file, complete source code means
3238all the source code for all modules it contains; but, as a special
3239exception, it need not include source code for modules which are standard
3240libraries that accompany the operating system on which the executable
3241file runs, or for standard header files or definitions files that
3242accompany that operating system.
3243
3244 4. You may not copy, modify, sublicense, distribute or transfer the
3245Program except as expressly provided under this General Public License.
3246Any attempt otherwise to copy, modify, sublicense, distribute or transfer
3247the Program is void, and will automatically terminate your rights to use
3248the Program under this License. However, parties who have received
3249copies, or rights to use copies, from you under this General Public
3250License will not have their licenses terminated so long as such parties
3251remain in full compliance.
3252
3253 5. By copying, distributing or modifying the Program (or any work based
3254on the Program) you indicate your acceptance of this license to do so,
3255and all its terms and conditions.
3256
3257 6. Each time you redistribute the Program (or any work based on the
3258Program), the recipient automatically receives a license from the original
3259licensor to copy, distribute or modify the Program subject to these
3260terms and conditions. You may not impose any further restrictions on the
3261recipients` exercise of the rights granted herein.
3262
3263 7. The Free Software Foundation may publish revised and/or new versions
3264of the General Public License from time to time. Such new versions will
3265be similar in spirit to the present version, but may differ in detail to
3266address new problems or concerns.
3267
3268Each version is given a distinguishing version number. If the Program
3269specifies a version number of the license which applies to it and "any
3270later version", you have the option of following the terms and conditions
3271either of that version or of any later version published by the Free
3272Software Foundation. If the Program does not specify a version number of
3273the license, you may choose any version ever published by the Free Software
3274Foundation.
3275
3276 8. If you wish to incorporate parts of the Program into other free
3277programs whose distribution conditions are different, write to the author
3278to ask for permission. For software which is copyrighted by the Free
3279Software Foundation, write to the Free Software Foundation; we sometimes
3280make exceptions for this. Our decision will be guided by the two goals
3281of preserving the free status of all derivatives of our free software and
3282of promoting the sharing and reuse of software generally.
3283
3284 NO WARRANTY
3285
3286 9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
3287FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
3288OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
3289PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
3290OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
3291MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
3292TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
3293PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
3294REPAIR OR CORRECTION.
3295
3296 10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
3297WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
3298REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
3299INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
3300OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
3301TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
3302YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
3303PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
3304POSSIBILITY OF SUCH DAMAGES.
3305
3306 END OF TERMS AND CONDITIONS
3307
3308 Appendix: How to Apply These Terms to Your New Programs
3309
3310 If you develop a new program, and you want it to be of the greatest
3311possible use to humanity, the best way to achieve this is to make it
3312free software which everyone can redistribute and change under these
3313terms.
3314
3315 To do so, attach the following notices to the program. It is safest to
3316attach them to the start of each source file to most effectively convey
3317the exclusion of warranty; and each file should have at least the
3318"copyright" line and a pointer to where the full notice is found.
3319
3320 &lt;one line to give the program`s name and a brief idea of what it does.&gt;
3321 Copyright (C) 19yy &lt;name of author&gt;
3322
3323 This program is free software; you can redistribute it and/or modify
3324 it under the terms of the GNU General Public License as published by
3325 the Free Software Foundation; either version 1, or (at your option)
3326 any later version.
3327
3328 This program is distributed in the hope that it will be useful,
3329 but WITHOUT ANY WARRANTY; without even the implied warranty of
3330 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3331 GNU General Public License for more details.
3332
3333 You should have received a copy of the GNU General Public License
3334 along with this program; if not, write to the Free Software
3335 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
3336
3337Also add information on how to contact you by electronic and paper mail.
3338
3339If the program is interactive, make it output a short notice like this
3340when it starts in an interactive mode:
3341
3342 Gnomovision version 69, Copyright (C) 19xx name of author
3343 Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w`.
3344 This is free software, and you are welcome to redistribute it
3345 under certain conditions; type `show c` for details.
3346
3347The hypothetical commands `show w` and `show c` should show the
3348appropriate parts of the General Public License. Of course, the
3349commands you use may be called something other than `show w` and `show
3350c`; they could even be mouse-clicks or menu items--whatever suits your
3351program.
3352
3353You should also get your employer (if you work as a programmer) or your
3354school, if any, to sign a "copyright disclaimer" for the program, if
3355necessary. Here a sample; alter the names:
3356
3357 Yoyodyne, Inc., hereby disclaims all copyright interest in the
3358 program `Gnomovision` (a program to direct compilers to make passes
3359 at assemblers) written by James Hacker.
3360
3361 &lt;signature of Ty Coon&gt;, 1 April 1989
3362 Ty Coon, President of Vice
3363
3364That`s all there is to it!
3365
3366</programlisting></para>
3367 </section>
3368
3369 <section id="lic_11">
3370 <title>GPL-2.0</title>
3371
3372 <para><programlisting>
3373
3374GNU GENERAL PUBLIC LICENSE
3375
3376Version 2, June 1991
3377
3378Copyright (C) 1989, 1991 Free Software Foundation, Inc.
337951 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
3380
3381Everyone is permitted to copy and distribute verbatim copies
3382of this license document, but changing it is not allowed.
3383Preamble
3384
3385The licenses for most software are designed to take away your freedom to share and
3386change it. By contrast, the GNU General Public License is intended to guarantee your
3387freedom to share and change free software--to make sure the software is free for all
3388its users. This General Public License applies to most of the Free Software
3389Foundation`s software and to any other program whose authors commit to using it. (Some
3390other Free Software Foundation software is covered by the GNU Lesser General Public
3391License instead.) You can apply it to your programs, too.
3392
3393When we speak of free software, we are referring to freedom, not price. Our General
3394Public Licenses are designed to make sure that you have the freedom to distribute
3395copies of free software (and charge for this service if you wish), that you receive
3396source code or can get it if you want it, that you can change the software or use
3397pieces of it in new free programs; and that you know you can do these things.
3398
3399To protect your rights, we need to make restrictions that forbid anyone to deny you
3400these rights or to ask you to surrender the rights. These restrictions translate to
3401certain responsibilities for you if you distribute copies of the software, or if you
3402modify it.
3403
3404For example, if you distribute copies of such a program, whether gratis or for a fee,
3405you must give the recipients all the rights that you have. You must make sure that
3406they, too, receive or can get the source code. And you must show them these terms so
3407they know their rights.
3408
3409We protect your rights with two steps: (1) copyright the software, and (2) offer you
3410this license which gives you legal permission to copy, distribute and/or modify the
3411software.
3412
3413Also, for each author`s protection and ours, we want to make certain that everyone
3414understands that there is no warranty for this free software. If the software is
3415modified by someone else and passed on, we want its recipients to know that what they
3416have is not the original, so that any problems introduced by others will not reflect
3417on the original authors` reputations.
3418
3419Finally, any free program is threatened constantly by software patents. We wish to
3420avoid the danger that redistributors of a free program will individually obtain patent
3421licenses, in effect making the program proprietary. To prevent this, we have made it
3422clear that any patent must be licensed for everyone`s free use or not licensed at all.
3423
3424The precise terms and conditions for copying, distribution and modification follow.
3425
3426TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
3427
34280. This License applies to any program or other work which contains a notice placed by
3429the copyright holder saying it may be distributed under the terms of this General
3430Public License. The "Program", below, refers to any such program or work, and a "work
3431based on the Program" means either the Program or any derivative work under copyright
3432law: that is to say, a work containing the Program or a portion of it, either verbatim
3433or with modifications and/or translated into another language. (Hereinafter,
3434translation is included without limitation in the term "modification".) Each licensee
3435is addressed as "you".
3436
3437Activities other than copying, distribution and modification are not covered by this
3438License; they are outside its scope. The act of running the Program is not restricted,
3439and the output from the Program is covered only if its contents constitute a work
3440based on the Program (independent of having been made by running the Program). Whether
3441that is true depends on what the Program does.
3442
34431. You may copy and distribute verbatim copies of the Program`s source code as you
3444receive it, in any medium, provided that you conspicuously and appropriately publish
3445on each copy an appropriate copyright notice and disclaimer of warranty; keep intact
3446all the notices that refer to this License and to the absence of any warranty; and
3447give any other recipients of the Program a copy of this License along with the
3448Program.
3449
3450You may charge a fee for the physical act of transferring a copy, and you may at your
3451option offer warranty protection in exchange for a fee.
3452
34532. You may modify your copy or copies of the Program or any portion of it, thus
3454forming a work based on the Program, and copy and distribute such modifications or
3455work under the terms of Section 1 above, provided that you also meet all of these
3456conditions:
3457
3458a) You must cause the modified files to carry prominent notices stating that you
3459changed the files and the date of any change.
3460b) You must cause any work that you distribute or publish, that in whole or in part
3461contains or is derived from the Program or any part thereof, to be licensed as a whole
3462at no charge to all third parties under the terms of this License.
3463c) If the modified program normally reads commands interactively when run, you must
3464cause it, when started running for such interactive use in the most ordinary way, to
3465print or display an announcement including an appropriate copyright notice and a
3466notice that there is no warranty (or else, saying that you provide a warranty) and
3467that users may redistribute the program under these conditions, and telling the user
3468how to view a copy of this License. (Exception: if the Program itself is interactive
3469but does not normally print such an announcement, your work based on the Program is
3470not required to print an announcement.)
3471These requirements apply to the modified work as a whole. If identifiable sections of
3472that work are not derived from the Program, and can be reasonably considered
3473independent and separate works in themselves, then this License, and its terms, do not
3474apply to those sections when you distribute them as separate works. But when you
3475distribute the same sections as part of a whole which is a work based on the Program,
3476the distribution of the whole must be on the terms of this License, whose permissions
3477for other licensees extend to the entire whole, and thus to each and every part
3478regardless of who wrote it.
3479
3480Thus, it is not the intent of this section to claim rights or contest your rights to
3481work written entirely by you; rather, the intent is to exercise the right to control
3482the distribution of derivative or collective works based on the Program.
3483
3484In addition, mere aggregation of another work not based on the Program with the
3485Program (or with a work based on the Program) on a volume of a storage or distribution
3486medium does not bring the other work under the scope of this License.
3487
34883. You may copy and distribute the Program (or a work based on it, under Section 2) in
3489object code or executable form under the terms of Sections 1 and 2 above provided that
3490you also do one of the following:
3491
3492a) Accompany it with the complete corresponding machine-readable source code, which
3493must be distributed under the terms of Sections 1 and 2 above on a medium customarily
3494used for software interchange; or,
3495b) Accompany it with a written offer, valid for at least three years, to give any
3496third party, for a charge no more than your cost of physically performing source
3497distribution, a complete machine-readable copy of the corresponding source code, to be
3498distributed under the terms of Sections 1 and 2 above on a medium customarily used for
3499software interchange; or,
3500c) Accompany it with the information you received as to the offer to distribute
3501corresponding source code. (This alternative is allowed only for noncommercial
3502distribution and only if you received the program in object code or executable form
3503with such an offer, in accord with Subsection b above.)
3504The source code for a work means the preferred form of the work for making
3505modifications to it. For an executable work, complete source code means all the source
3506code for all modules it contains, plus any associated interface definition files, plus
3507the scripts used to control compilation and installation of the executable. However,
3508as a special exception, the source code distributed need not include anything that is
3509normally distributed (in either source or binary form) with the major components
3510(compiler, kernel, and so on) of the operating system on which the executable runs,
3511unless that component itself accompanies the executable.
3512
3513If distribution of executable or object code is made by offering access to copy from a
3514designated place, then offering equivalent access to copy the source code from the
3515same place counts as distribution of the source code, even though third parties are
3516not compelled to copy the source along with the object code.
3517
35184. You may not copy, modify, sublicense, or distribute the Program except as expressly
3519provided under this License. Any attempt otherwise to copy, modify, sublicense or
3520distribute the Program is void, and will automatically terminate your rights under
3521this License. However, parties who have received copies, or rights, from you under
3522this License will not have their licenses terminated so long as such parties remain in
3523full compliance.
3524
35255. You are not required to accept this License, since you have not signed it. However,
3526nothing else grants you permission to modify or distribute the Program or its
3527derivative works. These actions are prohibited by law if you do not accept this
3528License. Therefore, by modifying or distributing the Program (or any work based on the
3529Program), you indicate your acceptance of this License to do so, and all its terms and
3530conditions for copying, distributing or modifying the Program or works based on it.
3531
35326. Each time you redistribute the Program (or any work based on the Program), the
3533recipient automatically receives a license from the original licensor to copy,
3534distribute or modify the Program subject to these terms and conditions. You may not
3535impose any further restrictions on the recipients` exercise of the rights granted
3536herein. You are not responsible for enforcing compliance by third parties to this
3537License.
3538
35397. If, as a consequence of a court judgment or allegation of patent infringement or
3540for any other reason (not limited to patent issues), conditions are imposed on you
3541(whether by court order, agreement or otherwise) that contradict the conditions of
3542this License, they do not excuse you from the conditions of this License. If you
3543cannot distribute so as to satisfy simultaneously your obligations under this License
3544and any other pertinent obligations, then as a consequence you may not distribute the
3545Program at all. For example, if a patent license would not permit royalty-free
3546redistribution of the Program by all those who receive copies directly or indirectly
3547through you, then the only way you could satisfy both it and this License would be to
3548refrain entirely from distribution of the Program.
3549
3550If any portion of this section is held invalid or unenforceable under any particular
3551circumstance, the balance of the section is intended to apply and the section as a
3552whole is intended to apply in other circumstances.
3553
3554It is not the purpose of this section to induce you to infringe any patents or other
3555property right claims or to contest validity of any such claims; this section has the
3556sole purpose of protecting the integrity of the free software distribution system,
3557which is implemented by public license practices. Many people have made generous
3558contributions to the wide range of software distributed through that system in
3559reliance on consistent application of that system; it is up to the author/donor to
3560decide if he or she is willing to distribute software through any other system and a
3561licensee cannot impose that choice.
3562
3563This section is intended to make thoroughly clear what is believed to be a consequence
3564of the rest of this License.
3565
35668. If the distribution and/or use of the Program is restricted in certain countries
3567either by patents or by copyrighted interfaces, the original copyright holder who
3568places the Program under this License may add an explicit geographical distribution
3569limitation excluding those countries, so that distribution is permitted only in or
3570among countries not thus excluded. In such case, this License incorporates the
3571limitation as if written in the body of this License.
3572
35739. The Free Software Foundation may publish revised and/or new versions of the General
3574Public License from time to time. Such new versions will be similar in spirit to the
3575present version, but may differ in detail to address new problems or concerns.
3576
3577Each version is given a distinguishing version number. If the Program specifies a
3578version number of this License which applies to it and "any later version", you have
3579the option of following the terms and conditions either of that version or of any
3580later version published by the Free Software Foundation. If the Program does not
3581specify a version number of this License, you may choose any version ever published by
3582the Free Software Foundation.
3583
358410. If you wish to incorporate parts of the Program into other free programs whose
3585distribution conditions are different, write to the author to ask for permission. For
3586software which is copyrighted by the Free Software Foundation, write to the Free
3587Software Foundation; we sometimes make exceptions for this. Our decision will be
3588guided by the two goals of preserving the free status of all derivatives of our free
3589software and of promoting the sharing and reuse of software generally.
3590
3591NO WARRANTY
3592
359311. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
3594PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
3595WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT
3596WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
3597IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
3598RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM
3599PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
3600
360112. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
3602COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS
3603PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
3604INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
3605PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
3606OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
3607WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
3608POSSIBILITY OF SUCH DAMAGES.
3609
3610END OF TERMS AND CONDITIONS
3611
3612How to Apply These Terms to Your New Programs
3613
3614If you develop a new program, and you want it to be of the greatest possible use to
3615the public, the best way to achieve this is to make it free software which everyone
3616can redistribute and change under these terms.
3617
3618To do so, attach the following notices to the program. It is safest to attach them to
3619the start of each source file to most effectively convey the exclusion of warranty;
3620and each file should have at least the "copyright" line and a pointer to where the
3621full notice is found.
3622
3623one line to give the program`s name and an idea of what it does.
3624Copyright (C) yyyy name of author
3625
3626This program is free software; you can redistribute it and/or
3627modify it under the terms of the GNU General Public License
3628as published by the Free Software Foundation; either version 2
3629of the License, or (at your option) any later version.
3630
3631This program is distributed in the hope that it will be useful,
3632but WITHOUT ANY WARRANTY; without even the implied warranty of
3633MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
3634GNU General Public License for more details.
3635
3636You should have received a copy of the GNU General Public License
3637along with this program; if not, write to the Free Software
3638Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
3639Also add information on how to contact you by electronic and paper mail.
3640
3641If the program is interactive, make it output a short notice like this when it starts
3642in an interactive mode:
3643
3644Gnomovision version 69, Copyright (C) year name of author
3645Gnomovision comes with ABSOLUTELY NO WARRANTY; for details
3646type `show w`. This is free software, and you are welcome
3647to redistribute it under certain conditions; type `show c`
3648for details.
3649The hypothetical commands `show w` and `show c` should show the appropriate parts of
3650the General Public License. Of course, the commands you use may be called something
3651other than `show w` and `show c`; they could even be mouse-clicks or menu
3652items--whatever suits your program.
3653
3654You should also get your employer (if you work as a programmer) or your school, if
3655any, to sign a "copyright disclaimer" for the program, if necessary. Here is a sample;
3656alter the names:
3657
3658Yoyodyne, Inc., hereby disclaims all copyright
3659interest in the program `Gnomovision`
3660(which makes passes at compilers) written
3661by James Hacker.
3662
3663signature of Ty Coon, 1 April 1989
3664Ty Coon, President of Vice
3665This General Public License does not permit incorporating your program into
3666proprietary programs. If your program is a subroutine library, you may consider it
3667more useful to permit linking proprietary applications with the library. If this is
3668what you want to do, use the GNU Lesser General Public License instead of this
3669License.
3670
3671</programlisting></para>
3672 </section>
3673
3674 <section id="lic_12">
3675 <title>GPL-3.0</title>
3676
3677 <para><programlisting>
3678GNU GENERAL PUBLIC LICENSE
3679
3680Version 3, 29 June 2007
3681
3682Copyright © 2007 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
3683
3684Everyone is permitted to copy and distribute verbatim copies of this license document,
3685but changing it is not allowed.
3686Preamble
3687
3688The GNU General Public License is a free, copyleft license for software and other
3689kinds of works.
3690
3691The licenses for most software and other practical works are designed to take away
3692your freedom to share and change the works. By contrast, the GNU General Public
3693License is intended to guarantee your freedom to share and change all versions of a
3694program--to make sure it remains free software for all its users. We, the Free
3695Software Foundation, use the GNU General Public License for most of our software; it
3696applies also to any other work released this way by its authors. You can apply it to
3697your programs, too.
3698
3699When we speak of free software, we are referring to freedom, not price. Our General
3700Public Licenses are designed to make sure that you have the freedom to distribute
3701copies of free software (and charge for them if you wish), that you receive source
3702code or can get it if you want it, that you can change the software or use pieces of
3703it in new free programs, and that you know you can do these things.
3704
3705To protect your rights, we need to prevent others from denying you these rights or
3706asking you to surrender the rights. Therefore, you have certain responsibilities if
3707you distribute copies of the software, or if you modify it: responsibilities to
3708respect the freedom of others.
3709
3710For example, if you distribute copies of such a program, whether gratis or for a fee,
3711you must pass on to the recipients the same freedoms that you received. You must make
3712sure that they, too, receive or can get the source code. And you must show them these
3713terms so they know their rights.
3714
3715Developers that use the GNU GPL protect your rights with two steps: (1) assert
3716copyright on the software, and (2) offer you this License giving you legal permission
3717to copy, distribute and/or modify it.
3718
3719For the developers' and authors' protection, the GPL clearly explains that there is no
3720warranty for this free software. For both users' and authors' sake, the GPL requires
3721that modified versions be marked as changed, so that their problems will not be
3722attributed erroneously to authors of previous versions.
3723
3724Some devices are designed to deny users access to install or run modified versions of
3725the software inside them, although the manufacturer can do so. This is fundamentally
3726incompatible with the aim of protecting users' freedom to change the software. The
3727systematic pattern of such abuse occurs in the area of products for individuals to
3728use, which is precisely where it is most unacceptable. Therefore, we have designed
3729this version of the GPL to prohibit the practice for those products. If such problems
3730arise substantially in other domains, we stand ready to extend this provision to those
3731domains in future versions of the GPL, as needed to protect the freedom of users.
3732
3733Finally, every program is threatened constantly by software patents. States should not
3734allow patents to restrict development and use of software on general-purpose
3735computers, but in those that do, we wish to avoid the special danger that patents
3736applied to a free program could make it effectively proprietary. To prevent this, the
3737GPL assures that patents cannot be used to render the program non-free.
3738
3739The precise terms and conditions for copying, distribution and modification follow.
3740TERMS AND CONDITIONS
37410. Definitions.
3742
3743“This License” refers to version 3 of the GNU General Public License.
3744
3745“Copyright” also means copyright-like laws that apply to other kinds of
3746works, such as semiconductor masks.
3747
3748“The Program” refers to any copyrightable work licensed under this
3749License. Each licensee is addressed as “you”. “Licensees”
3750and “recipients” may be individuals or organizations.
3751
3752To “modify” a work means to copy from or adapt all or part of the work in
3753a fashion requiring copyright permission, other than the making of an exact copy. The
3754resulting work is called a “modified version” of the earlier work or a
3755work “based on” the earlier work.
3756
3757A “covered work” means either the unmodified Program or a work based on
3758the Program.
3759
3760To “propagate” a work means to do anything with it that, without
3761permission, would make you directly or secondarily liable for infringement under
3762applicable copyright law, except executing it on a computer or modifying a private
3763copy. Propagation includes copying, distribution (with or without modification),
3764making available to the public, and in some countries other activities as well.
3765
3766To “convey” a work means any kind of propagation that enables other
3767parties to make or receive copies. Mere interaction with a user through a computer
3768network, with no transfer of a copy, is not conveying.
3769
3770An interactive user interface displays “Appropriate Legal Notices” to the
3771extent that it includes a convenient and prominently visible feature that (1) displays
3772an appropriate copyright notice, and (2) tells the user that there is no warranty for
3773the work (except to the extent that warranties are provided), that licensees may
3774convey the work under this License, and how to view a copy of this License. If the
3775interface presents a list of user commands or options, such as a menu, a prominent
3776item in the list meets this criterion.
37771. Source Code.
3778
3779The “source code” for a work means the preferred form of the work for
3780making modifications to it. “Object code” means any non-source form of a
3781work.
3782
3783A “Standard Interface” means an interface that either is an official
3784standard defined by a recognized standards body, or, in the case of interfaces
3785specified for a particular programming language, one that is widely used among
3786developers working in that language.
3787
3788The “System Libraries” of an executable work include anything, other than
3789the work as a whole, that (a) is included in the normal form of packaging a Major
3790Component, but which is not part of that Major Component, and (b) serves only to
3791enable use of the work with that Major Component, or to implement a Standard Interface
3792for which an implementation is available to the public in source code form. A
3793“Major Component”, in this context, means a major essential component
3794(kernel, window system, and so on) of the specific operating system (if any) on which
3795the executable work runs, or a compiler used to produce the work, or an object code
3796interpreter used to run it.
3797
3798The “Corresponding Source” for a work in object code form means all the
3799source code needed to generate, install, and (for an executable work) run the object
3800code and to modify the work, including scripts to control those activities. However,
3801it does not include the work's System Libraries, or general-purpose tools or generally
3802available free programs which are used unmodified in performing those activities but
3803which are not part of the work. For example, Corresponding Source includes interface
3804definition files associated with source files for the work, and the source code for
3805shared libraries and dynamically linked subprograms that the work is specifically
3806designed to require, such as by intimate data communication or control flow between
3807those subprograms and other parts of the work.
3808
3809The Corresponding Source need not include anything that users can regenerate
3810automatically from other parts of the Corresponding Source.
3811
3812The Corresponding Source for a work in source code form is that same work.
38132. Basic Permissions.
3814
3815All rights granted under this License are granted for the term of copyright on the
3816Program, and are irrevocable provided the stated conditions are met. This License
3817explicitly affirms your unlimited permission to run the unmodified Program. The output
3818from running a covered work is covered by this License only if the output, given its
3819content, constitutes a covered work. This License acknowledges your rights of fair use
3820or other equivalent, as provided by copyright law.
3821
3822You may make, run and propagate covered works that you do not convey, without
3823conditions so long as your license otherwise remains in force. You may convey covered
3824works to others for the sole purpose of having them make modifications exclusively for
3825you, or provide you with facilities for running those works, provided that you comply
3826with the terms of this License in conveying all material for which you do not control
3827copyright. Those thus making or running the covered works for you must do so
3828exclusively on your behalf, under your direction and control, on terms that prohibit
3829them from making any copies of your copyrighted material outside their relationship
3830with you.
3831
3832Conveying under any other circumstances is permitted solely under the conditions
3833stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
38343. Protecting Users' Legal Rights From Anti-Circumvention Law.
3835
3836No covered work shall be deemed part of an effective technological measure under any
3837applicable law fulfilling obligations under article 11 of the WIPO copyright treaty
3838adopted on 20 December 1996, or similar laws prohibiting or restricting circumvention
3839of such measures.
3840
3841When you convey a covered work, you waive any legal power to forbid circumvention of
3842technological measures to the extent such circumvention is effected by exercising
3843rights under this License with respect to the covered work, and you disclaim any
3844intention to limit operation or modification of the work as a means of enforcing,
3845against the work's users, your or third parties' legal rights to forbid circumvention
3846of technological measures.
38474. Conveying Verbatim Copies.
3848
3849You may convey verbatim copies of the Program's source code as you receive it, in any
3850medium, provided that you conspicuously and appropriately publish on each copy an
3851appropriate copyright notice; keep intact all notices stating that this License and
3852any non-permissive terms added in accord with section 7 apply to the code; keep intact
3853all notices of the absence of any warranty; and give all recipients a copy of this
3854License along with the Program.
3855
3856You may charge any price or no price for each copy that you convey, and you may offer
3857support or warranty protection for a fee.
38585. Conveying Modified Source Versions.
3859
3860You may convey a work based on the Program, or the modifications to produce it from
3861the Program, in the form of source code under the terms of section 4, provided that
3862you also meet all of these conditions:
3863
3864 * a) The work must carry prominent notices stating that you modified it, and
3865giving a relevant date.
3866 * b) The work must carry prominent notices stating that it is released under this
3867License and any conditions added under section 7. This requirement modifies the
3868requirement in section 4 to “keep intact all notices”.
3869 * c) You must license the entire work, as a whole, under this License to anyone
3870who comes into possession of a copy. This License will therefore apply, along with any
3871applicable section 7 additional terms, to the whole of the work, and all its parts,
3872regardless of how they are packaged. This License gives no permission to license the
3873work in any other way, but it does not invalidate such permission if you have
3874separately received it.
3875 * d) If the work has interactive user interfaces, each must display Appropriate
3876Legal Notices; however, if the Program has interactive interfaces that do not display
3877Appropriate Legal Notices, your work need not make them do so.
3878
3879A compilation of a covered work with other separate and independent works, which are
3880not by their nature extensions of the covered work, and which are not combined with it
3881such as to form a larger program, in or on a volume of a storage or distribution
3882medium, is called an “aggregate” if the compilation and its resulting
3883copyright are not used to limit the access or legal rights of the compilation's users
3884beyond what the individual works permit. Inclusion of a covered work in an aggregate
3885does not cause this License to apply to the other parts of the aggregate.
38866. Conveying Non-Source Forms.
3887
3888You may convey a covered work in object code form under the terms of sections 4 and 5,
3889provided that you also convey the machine-readable Corresponding Source under the
3890terms of this License, in one of these ways:
3891
3892 * a) Convey the object code in, or embodied in, a physical product (including a
3893physical distribution medium), accompanied by the Corresponding Source fixed on a
3894durable physical medium customarily used for software interchange.
3895 * b) Convey the object code in, or embodied in, a physical product (including a
3896physical distribution medium), accompanied by a written offer, valid for at least
3897three years and valid for as long as you offer spare parts or customer support for
3898that product model, to give anyone who possesses the object code either (1) a copy of
3899the Corresponding Source for all the software in the product that is covered by this
3900License, on a durable physical medium customarily used for software interchange, for a
3901price no more than your reasonable cost of physically performing this conveying of
3902source, or (2) access to copy the Corresponding Source from a network server at no
3903charge.
3904 * c) Convey individual copies of the object code with a copy of the written offer
3905to provide the Corresponding Source. This alternative is allowed only occasionally and
3906noncommercially, and only if you received the object code with such an offer, in
3907accord with subsection 6b.
3908 * d) Convey the object code by offering access from a designated place (gratis or
3909for a charge), and offer equivalent access to the Corresponding Source in the same way
3910through the same place at no further charge. You need not require recipients to copy
3911the Corresponding Source along with the object code. If the place to copy the object
3912code is a network server, the Corresponding Source may be on a different server
3913(operated by you or a third party) that supports equivalent copying facilities,
3914provided you maintain clear directions next to the object code saying where to find
3915the Corresponding Source. Regardless of what server hosts the Corresponding Source,
3916you remain obligated to ensure that it is available for as long as needed to satisfy
3917these requirements.
3918 * e) Convey the object code using peer-to-peer transmission, provided you inform
3919other peers where the object code and Corresponding Source of the work are being
3920offered to the general public at no charge under subsection 6d.
3921
3922A separable portion of the object code, whose source code is excluded from the
3923Corresponding Source as a System Library, need not be included in conveying the object
3924code work.
3925
3926A “User Product” is either (1) a “consumer product”, which
3927means any tangible personal property which is normally used for personal, family, or
3928household purposes, or (2) anything designed or sold for incorporation into a
3929dwelling. In determining whether a product is a consumer product, doubtful cases shall
3930be resolved in favor of coverage. For a particular product received by a particular
3931user, “normally used” refers to a typical or common use of that class of
3932product, regardless of the status of the particular user or of the way in which the
3933particular user actually uses, or expects or is expected to use, the product. A
3934product is a consumer product regardless of whether the product has substantial
3935commercial, industrial or non-consumer uses, unless such uses represent the only
3936significant mode of use of the product.
3937
3938“Installation Information” for a User Product means any methods,
3939procedures, authorization keys, or other information required to install and execute
3940modified versions of a covered work in that User Product from a modified version of
3941its Corresponding Source. The information must suffice to ensure that the continued
3942functioning of the modified object code is in no case prevented or interfered with
3943solely because modification has been made.
3944
3945If you convey an object code work under this section in, or with, or specifically for
3946use in, a User Product, and the conveying occurs as part of a transaction in which the
3947right of possession and use of the User Product is transferred to the recipient in
3948perpetuity or for a fixed term (regardless of how the transaction is characterized),
3949the Corresponding Source conveyed under this section must be accompanied by the
3950Installation Information. But this requirement does not apply if neither you nor any
3951third party retains the ability to install modified object code on the User Product
3952(for example, the work has been installed in ROM).
3953
3954The requirement to provide Installation Information does not include a requirement to
3955continue to provide support service, warranty, or updates for a work that has been
3956modified or installed by the recipient, or for the User Product in which it has been
3957modified or installed. Access to a network may be denied when the modification itself
3958materially and adversely affects the operation of the network or violates the rules
3959and protocols for communication across the network.
3960
3961Corresponding Source conveyed, and Installation Information provided, in accord with
3962this section must be in a format that is publicly documented (and with an
3963implementation available to the public in source code form), and must require no
3964special password or key for unpacking, reading or copying.
39657. Additional Terms.
3966
3967“Additional permissions” are terms that supplement the terms of this
3968License by making exceptions from one or more of its conditions. Additional
3969permissions that are applicable to the entire Program shall be treated as though they
3970were included in this License, to the extent that they are valid under applicable law.
3971If additional permissions apply only to part of the Program, that part may be used
3972separately under those permissions, but the entire Program remains governed by this
3973License without regard to the additional permissions.
3974
3975When you convey a copy of a covered work, you may at your option remove any additional
3976permissions from that copy, or from any part of it. (Additional permissions may be
3977written to require their own removal in certain cases when you modify the work.) You
3978may place additional permissions on material, added by you to a covered work, for
3979which you have or can give appropriate copyright permission.
3980
3981Notwithstanding any other provision of this License, for material you add to a covered
3982work, you may (if authorized by the copyright holders of that material) supplement the
3983terms of this License with terms:
3984
3985 * a) Disclaiming warranty or limiting liability differently from the terms of
3986sections 15 and 16 of this License; or
3987 * b) Requiring preservation of specified reasonable legal notices or author
3988attributions in that material or in the Appropriate Legal Notices displayed by works
3989containing it; or
3990 * c) Prohibiting misrepresentation of the origin of that material, or requiring
3991that modified versions of such material be marked in reasonable ways as different from
3992the original version; or
3993 * d) Limiting the use for publicity purposes of names of licensors or authors of
3994the material; or
3995 * e) Declining to grant rights under trademark law for use of some trade names,
3996trademarks, or service marks; or
3997 * f) Requiring indemnification of licensors and authors of that material by anyone
3998who conveys the material (or modified versions of it) with contractual assumptions of
3999liability to the recipient, for any liability that these contractual assumptions
4000directly impose on those licensors and authors.
4001
4002All other non-permissive additional terms are considered “further
4003restrictions” within the meaning of section 10. If the Program as you received
4004it, or any part of it, contains a notice stating that it is governed by this License
4005along with a term that is a further restriction, you may remove that term. If a
4006license document contains a further restriction but permits relicensing or conveying
4007under this License, you may add to a covered work material governed by the terms of
4008that license document, provided that the further restriction does not survive such
4009relicensing or conveying.
4010
4011If you add terms to a covered work in accord with this section, you must place, in the
4012relevant source files, a statement of the additional terms that apply to those files,
4013or a notice indicating where to find the applicable terms.
4014
4015Additional terms, permissive or non-permissive, may be stated in the form of a
4016separately written license, or stated as exceptions; the above requirements apply
4017either way.
40188. Termination.
4019
4020You may not propagate or modify a covered work except as expressly provided under this
4021License. Any attempt otherwise to propagate or modify it is void, and will
4022automatically terminate your rights under this License (including any patent licenses
4023granted under the third paragraph of section 11).
4024
4025However, if you cease all violation of this License, then your license from a
4026particular copyright holder is reinstated (a) provisionally, unless and until the
4027copyright holder explicitly and finally terminates your license, and (b) permanently,
4028if the copyright holder fails to notify you of the violation by some reasonable means
4029prior to 60 days after the cessation.
4030
4031Moreover, your license from a particular copyright holder is reinstated permanently if
4032the copyright holder notifies you of the violation by some reasonable means, this is
4033the first time you have received notice of violation of this License (for any work)
4034from that copyright holder, and you cure the violation prior to 30 days after your
4035receipt of the notice.
4036
4037Termination of your rights under this section does not terminate the licenses of
4038parties who have received copies or rights from you under this License. If your rights
4039have been terminated and not permanently reinstated, you do not qualify to receive new
4040licenses for the same material under section 10.
40419. Acceptance Not Required for Having Copies.
4042
4043You are not required to accept this License in order to receive or run a copy of the
4044Program. Ancillary propagation of a covered work occurring solely as a consequence of
4045using peer-to-peer transmission to receive a copy likewise does not require
4046acceptance. However, nothing other than this License grants you permission to
4047propagate or modify any covered work. These actions infringe copyright if you do not
4048accept this License. Therefore, by modifying or propagating a covered work, you
4049indicate your acceptance of this License to do so.
405010. Automatic Licensing of Downstream Recipients.
4051
4052Each time you convey a covered work, the recipient automatically receives a license
4053from the original licensors, to run, modify and propagate that work, subject to this
4054License. You are not responsible for enforcing compliance by third parties with this
4055License.
4056
4057An “entity transaction” is a transaction transferring control of an
4058organization, or substantially all assets of one, or subdividing an organization, or
4059merging organizations. If propagation of a covered work results from an entity
4060transaction, each party to that transaction who receives a copy of the work also
4061receives whatever licenses to the work the party's predecessor in interest had or
4062could give under the previous paragraph, plus a right to possession of the
4063Corresponding Source of the work from the predecessor in interest, if the predecessor
4064has it or can get it with reasonable efforts.
4065
4066You may not impose any further restrictions on the exercise of the rights granted or
4067affirmed under this License. For example, you may not impose a license fee, royalty,
4068or other charge for exercise of rights granted under this License, and you may not
4069initiate litigation (including a cross-claim or counterclaim in a lawsuit) alleging
4070that any patent claim is infringed by making, using, selling, offering for sale, or
4071importing the Program or any portion of it.
407211. Patents.
4073
4074A “contributor” is a copyright holder who authorizes use under this
4075License of the Program or a work on which the Program is based. The work thus licensed
4076is called the contributor's “contributor version”.
4077
4078A contributor's “essential patent claims” are all patent claims owned or
4079controlled by the contributor, whether already acquired or hereafter acquired, that
4080would be infringed by some manner, permitted by this License, of making, using, or
4081selling its contributor version, but do not include claims that would be infringed
4082only as a consequence of further modification of the contributor version. For purposes
4083of this definition, “control” includes the right to grant patent
4084sublicenses in a manner consistent with the requirements of this License.
4085
4086Each contributor grants you a non-exclusive, worldwide, royalty-free patent license
4087under the contributor's essential patent claims, to make, use, sell, offer for sale,
4088import and otherwise run, modify and propagate the contents of its contributor
4089version.
4090
4091In the following three paragraphs, a “patent license” is any express
4092agreement or commitment, however denominated, not to enforce a patent (such as an
4093express permission to practice a patent or covenant not to sue for patent
4094infringement). To “grant” such a patent license to a party means to make
4095such an agreement or commitment not to enforce a patent against the party.
4096
4097If you convey a covered work, knowingly relying on a patent license, and the
4098Corresponding Source of the work is not available for anyone to copy, free of charge
4099and under the terms of this License, through a publicly available network server or
4100other readily accessible means, then you must either (1) cause the Corresponding
4101Source to be so available, or (2) arrange to deprive yourself of the benefit of the
4102patent license for this particular work, or (3) arrange, in a manner consistent with
4103the requirements of this License, to extend the patent license to downstream
4104recipients. “Knowingly relying” means you have actual knowledge that, but
4105for the patent license, your conveying the covered work in a country, or your
4106recipient's use of the covered work in a country, would infringe one or more
4107identifiable patents in that country that you have reason to believe are valid.
4108
4109If, pursuant to or in connection with a single transaction or arrangement, you convey,
4110or propagate by procuring conveyance of, a covered work, and grant a patent license to
4111some of the parties receiving the covered work authorizing them to use, propagate,
4112modify or convey a specific copy of the covered work, then the patent license you
4113grant is automatically extended to all recipients of the covered work and works based
4114on it.
4115
4116A patent license is “discriminatory” if it does not include within the
4117scope of its coverage, prohibits the exercise of, or is conditioned on the
4118non-exercise of one or more of the rights that are specifically granted under this
4119License. You may not convey a covered work if you are a party to an arrangement with a
4120third party that is in the business of distributing software, under which you make
4121payment to the third party based on the extent of your activity of conveying the work,
4122and under which the third party grants, to any of the parties who would receive the
4123covered work from you, a discriminatory patent license (a) in connection with copies
4124of the covered work conveyed by you (or copies made from those copies), or (b)
4125primarily for and in connection with specific products or compilations that contain
4126the covered work, unless you entered into that arrangement, or that patent license was
4127granted, prior to 28 March 2007.
4128
4129Nothing in this License shall be construed as excluding or limiting any implied
4130license or other defenses to infringement that may otherwise be available to you under
4131applicable patent law.
413212. No Surrender of Others' Freedom.
4133
4134If conditions are imposed on you (whether by court order, agreement or otherwise) that
4135contradict the conditions of this License, they do not excuse you from the conditions
4136of this License. If you cannot convey a covered work so as to satisfy simultaneously
4137your obligations under this License and any other pertinent obligations, then as a
4138consequence you may not convey it at all. For example, if you agree to terms that
4139obligate you to collect a royalty for further conveying from those to whom you convey
4140the Program, the only way you could satisfy both those terms and this License would be
4141to refrain entirely from conveying the Program.
414213. Use with the GNU Affero General Public License.
4143
4144Notwithstanding any other provision of this License, you have permission to link or
4145combine any covered work with a work licensed under version 3 of the GNU Affero
4146General Public License into a single combined work, and to convey the resulting work.
4147The terms of this License will continue to apply to the part which is the covered
4148work, but the special requirements of the GNU Affero General Public License, section
414913, concerning interaction through a network will apply to the combination as such.
415014. Revised Versions of this License.
4151
4152The Free Software Foundation may publish revised and/or new versions of the GNU
4153General Public License from time to time. Such new versions will be similar in spirit
4154to the present version, but may differ in detail to address new problems or concerns.
4155
4156Each version is given a distinguishing version number. If the Program specifies that a
4157certain numbered version of the GNU General Public License “or any later
4158version” applies to it, you have the option of following the terms and
4159conditions either of that numbered version or of any later version published by the
4160Free Software Foundation. If the Program does not specify a version number of the GNU
4161General Public License, you may choose any version ever published by the Free Software
4162Foundation.
4163
4164If the Program specifies that a proxy can decide which future versions of the GNU
4165General Public License can be used, that proxy's public statement of acceptance of a
4166version permanently authorizes you to choose that version for the Program.
4167
4168Later license versions may give you additional or different permissions. However, no
4169additional obligations are imposed on any author or copyright holder as a result of
4170your choosing to follow a later version.
417115. Disclaimer of Warranty.
4172
4173THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
4174EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
4175PROVIDE THE PROGRAM “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER
4176EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
4177MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE
4178QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE
4179DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
418016. Limitation of Liability.
4181
4182IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
4183COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM AS
4184PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
4185INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
4186PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
4187OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE
4188WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
4189POSSIBILITY OF SUCH DAMAGES.
419017. Interpretation of Sections 15 and 16.
4191
4192If the disclaimer of warranty and limitation of liability provided above cannot be
4193given local legal effect according to their terms, reviewing courts shall apply local
4194law that most closely approximates an absolute waiver of all civil liability in
4195connection with the Program, unless a warranty or assumption of liability accompanies
4196a copy of the Program in return for a fee.
4197
4198END OF TERMS AND CONDITIONS
4199How to Apply These Terms to Your New Programs
4200
4201If you develop a new program, and you want it to be of the greatest possible use to
4202the public, the best way to achieve this is to make it free software which everyone
4203can redistribute and change under these terms.
4204
4205To do so, attach the following notices to the program. It is safest to attach them to
4206the start of each source file to most effectively state the exclusion of warranty; and
4207each file should have at least the “copyright” line and a pointer to
4208where the full notice is found.
4209
4210 &lt;one line to give the program's name and a brief idea of what it does.&gt;
4211 Copyright (C) &lt;year&gt; &lt;name of author&gt;
4212
4213 This program is free software: you can redistribute it and/or modify
4214 it under the terms of the GNU General Public License as published by
4215 the Free Software Foundation, either version 3 of the License, or
4216 (at your option) any later version.
4217
4218 This program is distributed in the hope that it will be useful,
4219 but WITHOUT ANY WARRANTY; without even the implied warranty of
4220 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
4221 GNU General Public License for more details.
4222
4223 You should have received a copy of the GNU General Public License
4224 along with this program. If not, see &lt;http://www.gnu.org/licenses/&gt;.
4225
4226Also add information on how to contact you by electronic and paper mail.
4227
4228If the program does terminal interaction, make it output a short notice like this when
4229it starts in an interactive mode:
4230
4231 &lt;program&gt; Copyright (C) &lt;year&gt; &lt;name of author&gt;
4232 This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
4233 This is free software, and you are welcome to redistribute it
4234 under certain conditions; type `show c' for details.
4235
4236The hypothetical commands `show w' and `show c' should show the appropriate parts of
4237the General Public License. Of course, your program's commands might be different; for
4238a GUI interface, you would use an “about box”.
4239
4240You should also get your employer (if you work as a programmer) or school, if any, to
4241sign a “copyright disclaimer” for the program, if necessary. For more
4242information on this, and how to apply and follow the GNU GPL, see
4243&lt;http://www.gnu.org/licenses/&gt;.
4244
4245The GNU General Public License does not permit incorporating your program into
4246proprietary programs. If your program is a subroutine library, you may consider it
4247more useful to permit linking proprietary applications with the library. If this is
4248what you want to do, use the GNU Lesser General Public License instead of this
4249License. But first, please read
4250&lt;http://www.gnu.org/philosophy/why-not-lgpl.html&gt;.
4251</programlisting></para>
4252 </section>
4253
4254 <section id="lic_13">
4255 <title>GPL-3.0-with-GCC-exception</title>
4256
4257 <para><programlisting>
4258
4259insert GPL v3 text here
4260
4261GCC RUNTIME LIBRARY EXCEPTION
4262Version 3.1, 31 March 2009
4263
4264General information:
4265http://www.gnu.org/licenses/gcc-exception.html
4266Copyright (C) 2009 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
4267Everyone is permitted to copy and distribute verbatim copies of this license document,
4268but changing it is not allowed.
4269This GCC Runtime Library Exception ("Exception") is an additional permission under
4270section 7 of the GNU General Public License, version 3 ("GPLv3"). It applies to a
4271given file (the "Runtime Library") that bears a notice placed by the copyright holder
4272of the file stating that the file is governed by GPLv3 along with this Exception.
4273When you use GCC to compile a program, GCC may combine portions of certain GCC header
4274files and runtime libraries with the compiled program. The purpose of this Exception
4275is to allow compilation of non-GPL (including proprietary) programs to use, in this
4276way, the header files and runtime libraries covered by this Exception.
4277
42780. Definitions.
4279A file is an "Independent Module" if it either requires the Runtime Library for
4280execution after a Compilation Process, or makes use of an interface provided by the
4281Runtime Library, but is not otherwise based on the Runtime Library.
4282"GCC" means a version of the GNU Compiler Collection, with or without modifications,
4283governed by version 3 (or a specified later version) of the GNU General Public License
4284(GPL) with the option of using any subsequent versions published by the FSF.
4285"GPL-compatible Software" is software whose conditions of propagation, modification
4286and use would permit combination with GCC in accord with the license of GCC.
4287"Target Code" refers to output from any compiler for a real or virtual target
4288processor architecture, in executable form or suitable for input to an assembler,
4289loader, linker and/or execution phase. Notwithstanding that, Target Code does not
4290include data in any format that is used as a compiler intermediate representation, or
4291used for producing a compiler intermediate representation.
4292The "Compilation Process" transforms code entirely represented in non-intermediate
4293languages designed for human-written code, and/or in Java Virtual Machine byte code,
4294into Target Code. Thus, for example, use of source code generators and preprocessors
4295need not be considered part of the Compilation Process, since the Compilation Process
4296can be understood as starting with the output of the generators or preprocessors.
4297A Compilation Process is "Eligible" if it is done using GCC, alone or with other
4298GPL-compatible software, or if it is done without using any work based on GCC. For
4299example, using non-GPL-compatible Software to optimize any GCC intermediate
4300representations would not qualify as an Eligible Compilation Process.
4301
43021. Grant of Additional Permission.
4303You have permission to propagate a work of Target Code formed by combining the Runtime
4304Library with Independent Modules, even if such propagation would otherwise violate the
4305terms of GPLv3, provided that all Target Code was generated by Eligible Compilation
4306Processes. You may then convey such a combination under terms of your choice,
4307consistent with the licensing of the Independent Modules.
4308
43092. No Weakening of GCC Copyleft.
4310The availability of this Exception does not imply any general presumption that
4311third-party software is unaffected by the copyleft requirements of the license of GCC.
4312
4313</programlisting></para>
4314 </section>
4315
4316 <section id="lic_14">
4317 <title>GPL-3.0-with-autoconf-exception</title>
4318
4319 <para><programlisting>
4320
4321insert GPL v3 text here
4322
4323AUTOCONF CONFIGURE SCRIPT EXCEPTION
4324
4325Version 3.0, 18 August 2009
4326
4327Copyright © 2009 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
4328
4329Everyone is permitted to copy and distribute verbatim copies of this license document,
4330but changing it is not allowed.
4331
4332This Exception is an additional permission under section 7 of the GNU General Public
4333License, version 3 ("GPLv3"). It applies to a given file that bears a notice placed by
4334the copyright holder of the file stating that the file is governed by GPLv3 along with
4335this Exception.
4336
4337The purpose of this Exception is to allow distribution of Autoconf`s typical output
4338under terms of the recipient`s choice (including proprietary).
4339
43400. Definitions.
4341"Covered Code" is the source or object code of a version of Autoconf that is a covered
4342work under this License.
4343
4344"Normally Copied Code" for a version of Autoconf means all parts of its Covered Code
4345which that version can copy from its code (i.e., not from its input file) into its
4346minimally verbose, non-debugging and non-tracing output.
4347
4348"Ineligible Code" is Covered Code that is not Normally Copied Code.
4349
43501. Grant of Additional Permission.
4351You have permission to propagate output of Autoconf, even if such propagation would
4352otherwise violate the terms of GPLv3. However, if by modifying Autoconf you cause any
4353Ineligible Code of the version you received to become Normally Copied Code of your
4354modified version, then you void this Exception for the resulting covered work. If you
4355convey that resulting covered work, you must remove this Exception in accordance with
4356the second paragraph of Section 7 of GPLv3.
4357
43582. No Weakening of Autoconf Copyleft.
4359The availability of this Exception does not imply any general presumption that
4360third-party software is unaffected by the copyleft requirements of the license of
4361Autoconf.
4362
4363</programlisting></para>
4364 </section>
4365
4366 <section id="lic_15">
4367 <title>LGPL-2.0</title>
4368
4369 <para><programlisting>
4370GNU LIBRARY GENERAL PUBLIC LICENSE
4371
4372
4373
4374Version 2, June 1991
4375
4376
4377
4378Copyright (C) 1991 Free Software Foundation, Inc.
4379
438051 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
4381
4382Everyone is permitted to copy and distribute verbatim copies
4383
4384of this license document, but changing it is not allowed.
4385
4386
4387
4388[This is the first released version of the library GPL. It is
4389
4390 numbered 2 because it goes with version 2 of the ordinary GPL.]
4391
4392Preamble
4393
4394
4395
4396The licenses for most software are designed to take away your freedom to share and
4397change it. By contrast, the GNU General Public Licenses are intended to guarantee your
4398freedom to share and change free software--to make sure the software is free for all
4399its users.
4400
4401
4402
4403This license, the Library General Public License, applies to some specially designated
4404Free Software Foundation software, and to any other libraries whose authors decide to
4405use it. You can use it for your libraries, too.
4406
4407
4408
4409When we speak of free software, we are referring to freedom, not price. Our General
4410Public Licenses are designed to make sure that you have the freedom to distribute
4411copies of free software (and charge for this service if you wish), that you receive
4412source code or can get it if you want it, that you can change the software or use
4413pieces of it in new free programs; and that you know you can do these things.
4414
4415
4416
4417To protect your rights, we need to make restrictions that forbid anyone to deny you
4418these rights or to ask you to surrender the rights. These restrictions translate to
4419certain responsibilities for you if you distribute copies of the library, or if you
4420modify it.
4421
4422
4423
4424For example, if you distribute copies of the library, whether gratis or for a fee, you
4425must give the recipients all the rights that we gave you. You must make sure that
4426they, too, receive or can get the source code. If you link a program with the library,
4427you must provide complete object files to the recipients so that they can relink them
4428with the library, after making changes to the library and recompiling it. And you must
4429show them these terms so they know their rights.
4430
4431
4432
4433Our method of protecting your rights has two steps: (1) copyright the library, and (2)
4434offer you this license which gives you legal permission to copy, distribute and/or
4435modify the library.
4436
4437
4438
4439Also, for each distributor's protection, we want to make certain that everyone
4440understands that there is no warranty for this free library. If the library is
4441modified by someone else and passed on, we want its recipients to know that what they
4442have is not the original version, so that any problems introduced by others will not
4443reflect on the original authors' reputations.
4444
4445
4446
4447Finally, any free program is threatened constantly by software patents. We wish to
4448avoid the danger that companies distributing free software will individually obtain
4449patent licenses, thus in effect transforming the program into proprietary software. To
4450prevent this, we have made it clear that any patent must be licensed for everyone's
4451free use or not licensed at all.
4452
4453
4454
4455Most GNU software, including some libraries, is covered by the ordinary GNU General
4456Public License, which was designed for utility programs. This license, the GNU Library
4457General Public License, applies to certain designated libraries. This license is quite
4458different from the ordinary one; be sure to read it in full, and don't assume that
4459anything in it is the same as in the ordinary license.
4460
4461
4462
4463The reason we have a separate public license for some libraries is that they blur the
4464distinction we usually make between modifying or adding to a program and simply using
4465it. Linking a program with a library, without changing the library, is in some sense
4466simply using the library, and is analogous to running a utility program or application
4467program. However, in a textual and legal sense, the linked executable is a combined
4468work, a derivative of the original library, and the ordinary General Public License
4469treats it as such.
4470
4471
4472
4473Because of this blurred distinction, using the ordinary General Public License for
4474libraries did not effectively promote software sharing, because most developers did
4475not use the libraries. We concluded that weaker conditions might promote sharing
4476better.
4477
4478
4479
4480However, unrestricted linking of non-free programs would deprive the users of those
4481programs of all benefit from the free status of the libraries themselves. This Library
4482General Public License is intended to permit developers of non-free programs to use
4483free libraries, while preserving your freedom as a user of such programs to change the
4484free libraries that are incorporated in them. (We have not seen how to achieve this as
4485regards changes in header files, but we have achieved it as regards changes in the
4486actual functions of the Library.) The hope is that this will lead to faster
4487development of free libraries.
4488
4489
4490
4491The precise terms and conditions for copying, distribution and modification follow.
4492Pay close attention to the difference between a "work based on the library" and a
4493"work that uses the library". The former contains code derived from the library, while
4494the latter only works together with the library.
4495
4496
4497
4498Note that it is possible for a library to be covered by the ordinary General Public
4499License rather than by this special one.
4500
4501
4502
4503TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
4504
4505
4506
45070. This License Agreement applies to any software library which contains a notice
4508placed by the copyright holder or other authorized party saying it may be distributed
4509under the terms of this Library General Public License (also called "this License").
4510Each licensee is addressed as "you".
4511
4512
4513
4514A "library" means a collection of software functions and/or data prepared so as to be
4515conveniently linked with application programs (which use some of those functions and
4516data) to form executables.
4517
4518
4519
4520The "Library", below, refers to any such software library or work which has been
4521distributed under these terms. A "work based on the Library" means either the Library
4522or any derivative work under copyright law: that is to say, a work containing the
4523Library or a portion of it, either verbatim or with modifications and/or translated
4524straightforwardly into another language. (Hereinafter, translation is included without
4525limitation in the term "modification".)
4526
4527
4528
4529"Source code" for a work means the preferred form of the work for making modifications
4530to it. For a library, complete source code means all the source code for all modules
4531it contains, plus any associated interface definition files, plus the scripts used to
4532control compilation and installation of the library.
4533
4534
4535
4536Activities other than copying, distribution and modification are not covered by this
4537License; they are outside its scope. The act of running a program using the Library is
4538not restricted, and output from such a program is covered only if its contents
4539constitute a work based on the Library (independent of the use of the Library in a
4540tool for writing it). Whether that is true depends on what the Library does and what
4541the program that uses the Library does.
4542
4543
4544
45451. You may copy and distribute verbatim copies of the Library's complete source code
4546as you receive it, in any medium, provided that you conspicuously and appropriately
4547publish on each copy an appropriate copyright notice and disclaimer of warranty; keep
4548intact all the notices that refer to this License and to the absence of any warranty;
4549and distribute a copy of this License along with the Library.
4550
4551
4552
4553You may charge a fee for the physical act of transferring a copy, and you may at your
4554option offer warranty protection in exchange for a fee.
4555
4556
4557
45582. You may modify your copy or copies of the Library or any portion of it, thus
4559forming a work based on the Library, and copy and distribute such modifications or
4560work under the terms of Section 1 above, provided that you also meet all of these
4561conditions:
4562
4563
4564
4565a) The modified work must itself be a software library.
4566
4567b) You must cause the files modified to carry prominent notices stating that you
4568changed the files and the date of any change.
4569
4570c) You must cause the whole of the work to be licensed at no charge to all third
4571parties under the terms of this License.
4572
4573d) If a facility in the modified Library refers to a function or a table of data to be
4574supplied by an application program that uses the facility, other than as an argument
4575passed when the facility is invoked, then you must make a good faith effort to ensure
4576that, in the event an application does not supply such function or table, the facility
4577still operates, and performs whatever part of its purpose remains meaningful.
4578
4579(For example, a function in a library to compute square roots has a purpose that is
4580entirely well-defined independent of the application. Therefore, Subsection 2d
4581requires that any application-supplied function or table used by this function must be
4582optional: if the application does not supply it, the square root function must still
4583compute square roots.)
4584
4585
4586
4587These requirements apply to the modified work as a whole. If identifiable sections of
4588that work are not derived from the Library, and can be reasonably considered
4589independent and separate works in themselves, then this License, and its terms, do not
4590apply to those sections when you distribute them as separate works. But when you
4591distribute the same sections as part of a whole which is a work based on the Library,
4592the distribution of the whole must be on the terms of this License, whose permissions
4593for other licensees extend to the entire whole, and thus to each and every part
4594regardless of who wrote it.
4595
4596
4597
4598Thus, it is not the intent of this section to claim rights or contest your rights to
4599work written entirely by you; rather, the intent is to exercise the right to control
4600the distribution of derivative or collective works based on the Library.
4601
4602
4603
4604In addition, mere aggregation of another work not based on the Library with the
4605Library (or with a work based on the Library) on a volume of a storage or distribution
4606medium does not bring the other work under the scope of this License.
4607
4608
4609
46103. You may opt to apply the terms of the ordinary GNU General Public License instead
4611of this License to a given copy of the Library. To do this, you must alter all the
4612notices that refer to this License, so that they refer to the ordinary GNU General
4613Public License, version 2, instead of to this License. (If a newer version than
4614version 2 of the ordinary GNU General Public License has appeared, then you can
4615specify that version instead if you wish.) Do not make any other change in these
4616notices.
4617
4618
4619
4620Once this change is made in a given copy, it is irreversible for that copy, so the
4621ordinary GNU General Public License applies to all subsequent copies and derivative
4622works made from that copy.
4623
4624
4625
4626This option is useful when you wish to copy part of the code of the Library into a
4627program that is not a library.
4628
4629
4630
46314. You may copy and distribute the Library (or a portion or derivative of it, under
4632Section 2) in object code or executable form under the terms of Sections 1 and 2 above
4633provided that you accompany it with the complete corresponding machine-readable source
4634code, which must be distributed under the terms of Sections 1 and 2 above on a medium
4635customarily used for software interchange.
4636
4637
4638
4639If distribution of object code is made by offering access to copy from a designated
4640place, then offering equivalent access to copy the source code from the same place
4641satisfies the requirement to distribute the source code, even though third parties are
4642not compelled to copy the source along with the object code.
4643
4644
4645
46465. A program that contains no derivative of any portion of the Library, but is
4647designed to work with the Library by being compiled or linked with it, is called a
4648"work that uses the Library". Such a work, in isolation, is not a derivative work of
4649the Library, and therefore falls outside the scope of this License.
4650
4651
4652
4653However, linking a "work that uses the Library" with the Library creates an executable
4654that is a derivative of the Library (because it contains portions of the Library),
4655rather than a "work that uses the library". The executable is therefore covered by
4656this License. Section 6 states terms for distribution of such executables.
4657
4658
4659
4660When a "work that uses the Library" uses material from a header file that is part of
4661the Library, the object code for the work may be a derivative work of the Library even
4662though the source code is not. Whether this is true is especially significant if the
4663work can be linked without the Library, or if the work is itself a library. The
4664threshold for this to be true is not precisely defined by law.
4665
4666
4667
4668If such an object file uses only numerical parameters, data structure layouts and
4669accessors, and small macros and small inline functions (ten lines or less in length),
4670then the use of the object file is unrestricted, regardless of whether it is legally a
4671derivative work. (Executables containing this object code plus portions of the Library
4672will still fall under Section 6.)
4673
4674
4675
4676Otherwise, if the work is a derivative of the Library, you may distribute the object
4677code for the work under the terms of Section 6. Any executables containing that work
4678also fall under Section 6, whether or not they are linked directly with the Library
4679itself.
4680
4681
4682
46836. As an exception to the Sections above, you may also compile or link a "work that
4684uses the Library" with the Library to produce a work containing portions of the
4685Library, and distribute that work under terms of your choice, provided that the terms
4686permit modification of the work for the customer's own use and reverse engineering for
4687debugging such modifications.
4688
4689
4690
4691You must give prominent notice with each copy of the work that the Library is used in
4692it and that the Library and its use are covered by this License. You must supply a
4693copy of this License. If the work during execution displays copyright notices, you
4694must include the copyright notice for the Library among them, as well as a reference
4695directing the user to the copy of this License. Also, you must do one of these things:
4696
4697
4698
4699a) Accompany the work with the complete corresponding machine-readable source code for
4700the Library including whatever changes were used in the work (which must be
4701distributed under Sections 1 and 2 above); and, if the work is an executable linked
4702with the Library, with the complete machine-readable "work that uses the Library", as
4703object code and/or source code, so that the user can modify the Library and then
4704relink to produce a modified executable containing the modified Library. (It is
4705understood that the user who changes the contents of definitions files in the Library
4706will not necessarily be able to recompile the application to use the modified
4707definitions.)
4708
4709b) Accompany the work with a written offer, valid for at least three years, to give
4710the same user the materials specified in Subsection 6a, above, for a charge no more
4711than the cost of performing this distribution.
4712
4713c) If distribution of the work is made by offering access to copy from a designated
4714place, offer equivalent access to copy the above specified materials from the same
4715place.
4716
4717d) Verify that the user has already received a copy of these materials or that you
4718have already sent this user a copy.
4719
4720For an executable, the required form of the "work that uses the Library" must include
4721any data and utility programs needed for reproducing the executable from it. However,
4722as a special exception, the source code distributed need not include anything that is
4723normally distributed (in either source or binary form) with the major components
4724(compiler, kernel, and so on) of the operating system on which the executable runs,
4725unless that component itself accompanies the executable.
4726
4727
4728
4729It may happen that this requirement contradicts the license restrictions of other
4730proprietary libraries that do not normally accompany the operating system. Such a
4731contradiction means you cannot use both them and the Library together in an executable
4732that you distribute.
4733
4734
4735
47367. You may place library facilities that are a work based on the Library side-by-side
4737in a single library together with other library facilities not covered by this
4738License, and distribute such a combined library, provided that the separate
4739distribution of the work based on the Library and of the other library facilities is
4740otherwise permitted, and provided that you do these two things:
4741
4742
4743
4744a) Accompany the combined library with a copy of the same work based on the Library,
4745uncombined with any other library facilities. This must be distributed under the terms
4746of the Sections above.
4747
4748b) Give prominent notice with the combined library of the fact that part of it is a
4749work based on the Library, and explaining where to find the accompanying uncombined
4750form of the same work.
4751
47528. You may not copy, modify, sublicense, link with, or distribute the Library except
4753as expressly provided under this License. Any attempt otherwise to copy, modify,
4754sublicense, link with, or distribute the Library is void, and will automatically
4755terminate your rights under this License. However, parties who have received copies,
4756or rights, from you under this License will not have their licenses terminated so long
4757as such parties remain in full compliance.
4758
4759
4760
47619. You are not required to accept this License, since you have not signed it. However,
4762nothing else grants you permission to modify or distribute the Library or its
4763derivative works. These actions are prohibited by law if you do not accept this
4764License. Therefore, by modifying or distributing the Library (or any work based on the
4765Library), you indicate your acceptance of this License to do so, and all its terms and
4766conditions for copying, distributing or modifying the Library or works based on it.
4767
4768
4769
477010. Each time you redistribute the Library (or any work based on the Library), the
4771recipient automatically receives a license from the original licensor to copy,
4772distribute, link with or modify the Library subject to these terms and conditions. You
4773may not impose any further restrictions on the recipients' exercise of the rights
4774granted herein. You are not responsible for enforcing compliance by third parties to
4775this License.
4776
4777
4778
477911. If, as a consequence of a court judgment or allegation of patent infringement or
4780for any other reason (not limited to patent issues), conditions are imposed on you
4781(whether by court order, agreement or otherwise) that contradict the conditions of
4782this License, they do not excuse you from the conditions of this License. If you
4783cannot distribute so as to satisfy simultaneously your obligations under this License
4784and any other pertinent obligations, then as a consequence you may not distribute the
4785Library at all. For example, if a patent license would not permit royalty-free
4786redistribution of the Library by all those who receive copies directly or indirectly
4787through you, then the only way you could satisfy both it and this License would be to
4788refrain entirely from distribution of the Library.
4789
4790
4791
4792If any portion of this section is held invalid or unenforceable under any particular
4793circumstance, the balance of the section is intended to apply, and the section as a
4794whole is intended to apply in other circumstances.
4795
4796
4797
4798It is not the purpose of this section to induce you to infringe any patents or other
4799property right claims or to contest validity of any such claims; this section has the
4800sole purpose of protecting the integrity of the free software distribution system
4801which is implemented by public license practices. Many people have made generous
4802contributions to the wide range of software distributed through that system in
4803reliance on consistent application of that system; it is up to the author/donor to
4804decide if he or she is willing to distribute software through any other system and a
4805licensee cannot impose that choice.
4806
4807
4808
4809This section is intended to make thoroughly clear what is believed to be a consequence
4810of the rest of this License.
4811
4812
4813
481412. If the distribution and/or use of the Library is restricted in certain countries
4815either by patents or by copyrighted interfaces, the original copyright holder who
4816places the Library under this License may add an explicit geographical distribution
4817limitation excluding those countries, so that distribution is permitted only in or
4818among countries not thus excluded. In such case, this License incorporates the
4819limitation as if written in the body of this License.
4820
4821
4822
482313. The Free Software Foundation may publish revised and/or new versions of the
4824Library General Public License from time to time. Such new versions will be similar in
4825spirit to the present version, but may differ in detail to address new problems or
4826concerns.
4827
4828
4829
4830Each version is given a distinguishing version number. If the Library specifies a
4831version number of this License which applies to it and "any later version", you have
4832the option of following the terms and conditions either of that version or of any
4833later version published by the Free Software Foundation. If the Library does not
4834specify a license version number, you may choose any version ever published by the
4835Free Software Foundation.
4836
4837
4838
483914. If you wish to incorporate parts of the Library into other free programs whose
4840distribution conditions are incompatible with these, write to the author to ask for
4841permission. For software which is copyrighted by the Free Software Foundation, write
4842to the Free Software Foundation; we sometimes make exceptions for this. Our decision
4843will be guided by the two goals of preserving the free status of all derivatives of
4844our free software and of promoting the sharing and reuse of software generally.
4845
4846
4847
4848NO WARRANTY
4849
4850
4851
485215. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
4853LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
4854WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT
4855WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
4856IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
4857RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY
4858PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
4859
4860
4861
486216. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
4863COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS
4864PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
4865INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
4866LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
4867OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE
4868WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
4869POSSIBILITY OF SUCH DAMAGES.
4870
4871
4872
4873END OF TERMS AND CONDITIONS
4874
4875
4876
4877How to Apply These Terms to Your New Libraries
4878
4879
4880
4881If you develop a new library, and you want it to be of the greatest possible use to
4882the public, we recommend making it free software that everyone can redistribute and
4883change. You can do so by permitting redistribution under these terms (or,
4884alternatively, under the terms of the ordinary General Public License).
4885
4886
4887
4888To apply these terms, attach the following notices to the library. It is safest to
4889attach them to the start of each source file to most effectively convey the exclusion
4890of warranty; and each file should have at least the "copyright" line and a pointer to
4891where the full notice is found.
4892
4893
4894
4895one line to give the library's name and an idea of what it does.
4896
4897Copyright (C) year name of author
4898
4899
4900
4901This library is free software; you can redistribute it and/or
4902
4903modify it under the terms of the GNU Library General Public
4904
4905License as published by the Free Software Foundation; either
4906
4907version 2 of the License, or (at your option) any later version.
4908
4909
4910
4911This library is distributed in the hope that it will be useful,
4912
4913but WITHOUT ANY WARRANTY; without even the implied warranty of
4914
4915MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
4916
4917Library General Public License for more details.
4918
4919
4920
4921You should have received a copy of the GNU Library General Public
4922
4923License along with this library; if not, write to the
4924
4925Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
4926
4927Boston, MA 02110-1301, USA.
4928
4929Also add information on how to contact you by electronic and paper mail.
4930
4931
4932
4933You should also get your employer (if you work as a programmer) or your school, if
4934any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample;
4935alter the names:
4936
4937
4938
4939Yoyodyne, Inc., hereby disclaims all copyright interest in
4940
4941the library `Frob' (a library for tweaking knobs) written
4942
4943by James Random Hacker.
4944
4945
4946
4947signature of Ty Coon, 1 April 1990
4948
4949Ty Coon, President of Vice
4950
4951That's all there is to it!
4952
4953</programlisting></para>
4954 </section>
4955
4956 <section id="lic_16">
4957 <title>LGPL-2.1</title>
4958
4959 <para><programlisting>
4960
4961GNU LESSER GENERAL PUBLIC LICENSE
4962
4963Version 2.1, February 1999
4964
4965Copyright (C) 1991, 1999 Free Software Foundation, Inc.
496651 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
4967Everyone is permitted to copy and distribute verbatim copies
4968of this license document, but changing it is not allowed.
4969
4970[This is the first released version of the Lesser GPL. It also counts
4971 as the successor of the GNU Library Public License, version 2, hence
4972 the version number 2.1.]
4973Preamble
4974
4975The licenses for most software are designed to take away your freedom to share and
4976change it. By contrast, the GNU General Public Licenses are intended to guarantee your
4977freedom to share and change free software--to make sure the software is free for all
4978its users.
4979
4980This license, the Lesser General Public License, applies to some specially designated
4981software packages--typically libraries--of the Free Software Foundation and other
4982authors who decide to use it. You can use it too, but we suggest you first think
4983carefully about whether this license or the ordinary General Public License is the
4984better strategy to use in any particular case, based on the explanations below.
4985
4986When we speak of free software, we are referring to freedom of use, not price. Our
4987General Public Licenses are designed to make sure that you have the freedom to
4988distribute copies of free software (and charge for this service if you wish); that you
4989receive source code or can get it if you want it; that you can change the software and
4990use pieces of it in new free programs; and that you are informed that you can do these
4991things.
4992
4993To protect your rights, we need to make restrictions that forbid distributors to deny
4994you these rights or to ask you to surrender these rights. These restrictions translate
4995to certain responsibilities for you if you distribute copies of the library or if you
4996modify it.
4997
4998For example, if you distribute copies of the library, whether gratis or for a fee, you
4999must give the recipients all the rights that we gave you. You must make sure that
5000they, too, receive or can get the source code. If you link other code with the
5001library, you must provide complete object files to the recipients, so that they can
5002relink them with the library after making changes to the library and recompiling it.
5003And you must show them these terms so they know their rights.
5004
5005We protect your rights with a two-step method: (1) we copyright the library, and (2)
5006we offer you this license, which gives you legal permission to copy, distribute and/or
5007modify the library.
5008
5009To protect each distributor, we want to make it very clear that there is no warranty
5010for the free library. Also, if the library is modified by someone else and passed on,
5011the recipients should know that what they have is not the original version, so that
5012the original author`s reputation will not be affected by problems that might be
5013introduced by others.
5014
5015Finally, software patents pose a constant threat to the existence of any free program.
5016We wish to make sure that a company cannot effectively restrict the users of a free
5017program by obtaining a restrictive license from a patent holder. Therefore, we insist
5018that any patent license obtained for a version of the library must be consistent with
5019the full freedom of use specified in this license.
5020
5021Most GNU software, including some libraries, is covered by the ordinary GNU General
5022Public License. This license, the GNU Lesser General Public License, applies to
5023certain designated libraries, and is quite different from the ordinary General Public
5024License. We use this license for certain libraries in order to permit linking those
5025libraries into non-free programs.
5026
5027When a program is linked with a library, whether statically or using a shared library,
5028the combination of the two is legally speaking a combined work, a derivative of the
5029original library. The ordinary General Public License therefore permits such linking
5030only if the entire combination fits its criteria of freedom. The Lesser General Public
5031License permits more lax criteria for linking other code with the library.
5032
5033We call this license the "Lesser" General Public License because it does Less to
5034protect the user`s freedom than the ordinary General Public License. It also provides
5035other free software developers Less of an advantage over competing non-free programs.
5036These disadvantages are the reason we use the ordinary General Public License for many
5037libraries. However, the Lesser license provides advantages in certain special
5038circumstances.
5039
5040For example, on rare occasions, there may be a special need to encourage the widest
5041possible use of a certain library, so that it becomes a de-facto standard. To achieve
5042this, non-free programs must be allowed to use the library. A more frequent case is
5043that a free library does the same job as widely used non-free libraries. In this case,
5044there is little to gain by limiting the free library to free software only, so we use
5045the Lesser General Public License.
5046
5047In other cases, permission to use a particular library in non-free programs enables a
5048greater number of people to use a large body of free software. For example, permission
5049to use the GNU C Library in non-free programs enables many more people to use the
5050whole GNU operating system, as well as its variant, the GNU/Linux operating system.
5051
5052Although the Lesser General Public License is Less protective of the users` freedom,
5053it does ensure that the user of a program that is linked with the Library has the
5054freedom and the wherewithal to run that program using a modified version of the
5055Library.
5056
5057The precise terms and conditions for copying, distribution and modification follow.
5058Pay close attention to the difference between a "work based on the library" and a
5059"work that uses the library". The former contains code derived from the library,
5060whereas the latter must be combined with the library in order to run.
5061
5062TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
5063
50640. This License Agreement applies to any software library or other program which
5065contains a notice placed by the copyright holder or other authorized party saying it
5066may be distributed under the terms of this Lesser General Public License (also called
5067"this License"). Each licensee is addressed as "you".
5068
5069A "library" means a collection of software functions and/or data prepared so as to be
5070conveniently linked with application programs (which use some of those functions and
5071data) to form executables.
5072
5073The "Library", below, refers to any such software library or work which has been
5074distributed under these terms. A "work based on the Library" means either the Library
5075or any derivative work under copyright law: that is to say, a work containing the
5076Library or a portion of it, either verbatim or with modifications and/or translated
5077straightforwardly into another language. (Hereinafter, translation is included without
5078limitation in the term "modification".)
5079
5080"Source code" for a work means the preferred form of the work for making modifications
5081to it. For a library, complete source code means all the source code for all modules
5082it contains, plus any associated interface definition files, plus the scripts used to
5083control compilation and installation of the library.
5084
5085Activities other than copying, distribution and modification are not covered by this
5086License; they are outside its scope. The act of running a program using the Library is
5087not restricted, and output from such a program is covered only if its contents
5088constitute a work based on the Library (independent of the use of the Library in a
5089tool for writing it). Whether that is true depends on what the Library does and what
5090the program that uses the Library does.
5091
50921. You may copy and distribute verbatim copies of the Library`s complete source code
5093as you receive it, in any medium, provided that you conspicuously and appropriately
5094publish on each copy an appropriate copyright notice and disclaimer of warranty; keep
5095intact all the notices that refer to this License and to the absence of any warranty;
5096and distribute a copy of this License along with the Library.
5097
5098You may charge a fee for the physical act of transferring a copy, and you may at your
5099option offer warranty protection in exchange for a fee.
5100
51012. You may modify your copy or copies of the Library or any portion of it, thus
5102forming a work based on the Library, and copy and distribute such modifications or
5103work under the terms of Section 1 above, provided that you also meet all of these
5104conditions:
5105
5106a) The modified work must itself be a software library.
5107b) You must cause the files modified to carry prominent notices stating that you
5108changed the files and the date of any change.
5109c) You must cause the whole of the work to be licensed at no charge to all third
5110parties under the terms of this License.
5111d) If a facility in the modified Library refers to a function or a table of data to be
5112supplied by an application program that uses the facility, other than as an argument
5113passed when the facility is invoked, then you must make a good faith effort to ensure
5114that, in the event an application does not supply such function or table, the facility
5115still operates, and performs whatever part of its purpose remains meaningful.
5116(For example, a function in a library to compute square roots has a purpose that is
5117entirely well-defined independent of the application. Therefore, Subsection 2d
5118requires that any application-supplied function or table used by this function must be
5119optional: if the application does not supply it, the square root function must still
5120compute square roots.)
5121
5122These requirements apply to the modified work as a whole. If identifiable sections of
5123that work are not derived from the Library, and can be reasonably considered
5124independent and separate works in themselves, then this License, and its terms, do not
5125apply to those sections when you distribute them as separate works. But when you
5126distribute the same sections as part of a whole which is a work based on the Library,
5127the distribution of the whole must be on the terms of this License, whose permissions
5128for other licensees extend to the entire whole, and thus to each and every part
5129regardless of who wrote it.
5130
5131Thus, it is not the intent of this section to claim rights or contest your rights to
5132work written entirely by you; rather, the intent is to exercise the right to control
5133the distribution of derivative or collective works based on the Library.
5134
5135In addition, mere aggregation of another work not based on the Library with the
5136Library (or with a work based on the Library) on a volume of a storage or distribution
5137medium does not bring the other work under the scope of this License.
5138
51393. You may opt to apply the terms of the ordinary GNU General Public License instead
5140of this License to a given copy of the Library. To do this, you must alter all the
5141notices that refer to this License, so that they refer to the ordinary GNU General
5142Public License, version 2, instead of to this License. (If a newer version than
5143version 2 of the ordinary GNU General Public License has appeared, then you can
5144specify that version instead if you wish.) Do not make any other change in these
5145notices.
5146
5147Once this change is made in a given copy, it is irreversible for that copy, so the
5148ordinary GNU General Public License applies to all subsequent copies and derivative
5149works made from that copy.
5150
5151This option is useful when you wish to copy part of the code of the Library into a
5152program that is not a library.
5153
51544. You may copy and distribute the Library (or a portion or derivative of it, under
5155Section 2) in object code or executable form under the terms of Sections 1 and 2 above
5156provided that you accompany it with the complete corresponding machine-readable source
5157code, which must be distributed under the terms of Sections 1 and 2 above on a medium
5158customarily used for software interchange.
5159
5160If distribution of object code is made by offering access to copy from a designated
5161place, then offering equivalent access to copy the source code from the same place
5162satisfies the requirement to distribute the source code, even though third parties are
5163not compelled to copy the source along with the object code.
5164
51655. A program that contains no derivative of any portion of the Library, but is
5166designed to work with the Library by being compiled or linked with it, is called a
5167"work that uses the Library". Such a work, in isolation, is not a derivative work of
5168the Library, and therefore falls outside the scope of this License.
5169
5170However, linking a "work that uses the Library" with the Library creates an executable
5171that is a derivative of the Library (because it contains portions of the Library),
5172rather than a "work that uses the library". The executable is therefore covered by
5173this License. Section 6 states terms for distribution of such executables.
5174
5175When a "work that uses the Library" uses material from a header file that is part of
5176the Library, the object code for the work may be a derivative work of the Library even
5177though the source code is not. Whether this is true is especially significant if the
5178work can be linked without the Library, or if the work is itself a library. The
5179threshold for this to be true is not precisely defined by law.
5180
5181If such an object file uses only numerical parameters, data structure layouts and
5182accessors, and small macros and small inline functions (ten lines or less in length),
5183then the use of the object file is unrestricted, regardless of whether it is legally a
5184derivative work. (Executables containing this object code plus portions of the Library
5185will still fall under Section 6.)
5186
5187Otherwise, if the work is a derivative of the Library, you may distribute the object
5188code for the work under the terms of Section 6. Any executables containing that work
5189also fall under Section 6, whether or not they are linked directly with the Library
5190itself.
5191
51926. As an exception to the Sections above, you may also combine or link a "work that
5193uses the Library" with the Library to produce a work containing portions of the
5194Library, and distribute that work under terms of your choice, provided that the terms
5195permit modification of the work for the customer`s own use and reverse engineering for
5196debugging such modifications.
5197
5198You must give prominent notice with each copy of the work that the Library is used in
5199it and that the Library and its use are covered by this License. You must supply a
5200copy of this License. If the work during execution displays copyright notices, you
5201must include the copyright notice for the Library among them, as well as a reference
5202directing the user to the copy of this License. Also, you must do one of these things:
5203
5204a) Accompany the work with the complete corresponding machine-readable source code for
5205the Library including whatever changes were used in the work (which must be
5206distributed under Sections 1 and 2 above); and, if the work is an executable linked
5207with the Library, with the complete machine-readable "work that uses the Library", as
5208object code and/or source code, so that the user can modify the Library and then
5209relink to produce a modified executable containing the modified Library. (It is
5210understood that the user who changes the contents of definitions files in the Library
5211will not necessarily be able to recompile the application to use the modified
5212definitions.)
5213b) Use a suitable shared library mechanism for linking with the Library. A suitable
5214mechanism is one that (1) uses at run time a copy of the library already present on
5215the user`s computer system, rather than copying library functions into the executable,
5216and (2) will operate properly with a modified version of the library, if the user
5217installs one, as long as the modified version is interface-compatible with the version
5218that the work was made with.
5219c) Accompany the work with a written offer, valid for at least three years, to give
5220the same user the materials specified in Subsection 6a, above, for a charge no more
5221than the cost of performing this distribution.
5222d) If distribution of the work is made by offering access to copy from a designated
5223place, offer equivalent access to copy the above specified materials from the same
5224place.
5225e) Verify that the user has already received a copy of these materials or that you
5226have already sent this user a copy.
5227For an executable, the required form of the "work that uses the Library" must include
5228any data and utility programs needed for reproducing the executable from it. However,
5229as a special exception, the materials to be distributed need not include anything that
5230is normally distributed (in either source or binary form) with the major components
5231(compiler, kernel, and so on) of the operating system on which the executable runs,
5232unless that component itself accompanies the executable.
5233
5234It may happen that this requirement contradicts the license restrictions of other
5235proprietary libraries that do not normally accompany the operating system. Such a
5236contradiction means you cannot use both them and the Library together in an executable
5237that you distribute.
5238
52397. You may place library facilities that are a work based on the Library side-by-side
5240in a single library together with other library facilities not covered by this
5241License, and distribute such a combined library, provided that the separate
5242distribution of the work based on the Library and of the other library facilities is
5243otherwise permitted, and provided that you do these two things:
5244
5245a) Accompany the combined library with a copy of the same work based on the Library,
5246uncombined with any other library facilities. This must be distributed under the terms
5247of the Sections above.
5248b) Give prominent notice with the combined library of the fact that part of it is a
5249work based on the Library, and explaining where to find the accompanying uncombined
5250form of the same work.
52518. You may not copy, modify, sublicense, link with, or distribute the Library except
5252as expressly provided under this License. Any attempt otherwise to copy, modify,
5253sublicense, link with, or distribute the Library is void, and will automatically
5254terminate your rights under this License. However, parties who have received copies,
5255or rights, from you under this License will not have their licenses terminated so long
5256as such parties remain in full compliance.
5257
52589. You are not required to accept this License, since you have not signed it. However,
5259nothing else grants you permission to modify or distribute the Library or its
5260derivative works. These actions are prohibited by law if you do not accept this
5261License. Therefore, by modifying or distributing the Library (or any work based on the
5262Library), you indicate your acceptance of this License to do so, and all its terms and
5263conditions for copying, distributing or modifying the Library or works based on it.
5264
526510. Each time you redistribute the Library (or any work based on the Library), the
5266recipient automatically receives a license from the original licensor to copy,
5267distribute, link with or modify the Library subject to these terms and conditions. You
5268may not impose any further restrictions on the recipients` exercise of the rights
5269granted herein. You are not responsible for enforcing compliance by third parties with
5270this License.
5271
527211. If, as a consequence of a court judgment or allegation of patent infringement or
5273for any other reason (not limited to patent issues), conditions are imposed on you
5274(whether by court order, agreement or otherwise) that contradict the conditions of
5275this License, they do not excuse you from the conditions of this License. If you
5276cannot distribute so as to satisfy simultaneously your obligations under this License
5277and any other pertinent obligations, then as a consequence you may not distribute the
5278Library at all. For example, if a patent license would not permit royalty-free
5279redistribution of the Library by all those who receive copies directly or indirectly
5280through you, then the only way you could satisfy both it and this License would be to
5281refrain entirely from distribution of the Library.
5282
5283If any portion of this section is held invalid or unenforceable under any particular
5284circumstance, the balance of the section is intended to apply, and the section as a
5285whole is intended to apply in other circumstances.
5286
5287It is not the purpose of this section to induce you to infringe any patents or other
5288property right claims or to contest validity of any such claims; this section has the
5289sole purpose of protecting the integrity of the free software distribution system
5290which is implemented by public license practices. Many people have made generous
5291contributions to the wide range of software distributed through that system in
5292reliance on consistent application of that system; it is up to the author/donor to
5293decide if he or she is willing to distribute software through any other system and a
5294licensee cannot impose that choice.
5295
5296This section is intended to make thoroughly clear what is believed to be a consequence
5297of the rest of this License.
5298
529912. If the distribution and/or use of the Library is restricted in certain countries
5300either by patents or by copyrighted interfaces, the original copyright holder who
5301places the Library under this License may add an explicit geographical distribution
5302limitation excluding those countries, so that distribution is permitted only in or
5303among countries not thus excluded. In such case, this License incorporates the
5304limitation as if written in the body of this License.
5305
530613. The Free Software Foundation may publish revised and/or new versions of the Lesser
5307General Public License from time to time. Such new versions will be similar in spirit
5308to the present version, but may differ in detail to address new problems or concerns.
5309
5310Each version is given a distinguishing version number. If the Library specifies a
5311version number of this License which applies to it and "any later version", you have
5312the option of following the terms and conditions either of that version or of any
5313later version published by the Free Software Foundation. If the Library does not
5314specify a license version number, you may choose any version ever published by the
5315Free Software Foundation.
5316
531714. If you wish to incorporate parts of the Library into other free programs whose
5318distribution conditions are incompatible with these, write to the author to ask for
5319permission. For software which is copyrighted by the Free Software Foundation, write
5320to the Free Software Foundation; we sometimes make exceptions for this. Our decision
5321will be guided by the two goals of preserving the free status of all derivatives of
5322our free software and of promoting the sharing and reuse of software generally.
5323
5324NO WARRANTY
5325
532615. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE
5327LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN
5328WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT
5329WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
5330IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
5331RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY
5332PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
5333
533416. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY
5335COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS
5336PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
5337INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
5338LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE
5339OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE
5340WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
5341POSSIBILITY OF SUCH DAMAGES.
5342
5343END OF TERMS AND CONDITIONS
5344
5345How to Apply These Terms to Your New Libraries
5346
5347If you develop a new library, and you want it to be of the greatest possible use to
5348the public, we recommend making it free software that everyone can redistribute and
5349change. You can do so by permitting redistribution under these terms (or,
5350alternatively, under the terms of the ordinary General Public License).
5351
5352To apply these terms, attach the following notices to the library. It is safest to
5353attach them to the start of each source file to most effectively convey the exclusion
5354of warranty; and each file should have at least the "copyright" line and a pointer to
5355where the full notice is found.
5356
5357one line to give the library`s name and an idea of what it does.
5358Copyright (C) year name of author
5359
5360This library is free software; you can redistribute it and/or
5361modify it under the terms of the GNU Lesser General Public
5362License as published by the Free Software Foundation; either
5363version 2.1 of the License, or (at your option) any later version.
5364
5365This library is distributed in the hope that it will be useful,
5366but WITHOUT ANY WARRANTY; without even the implied warranty of
5367MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5368Lesser General Public License for more details.
5369
5370You should have received a copy of the GNU Lesser General Public
5371License along with this library; if not, write to the Free Software
5372Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
5373Also add information on how to contact you by electronic and paper mail.
5374
5375You should also get your employer (if you work as a programmer) or your school, if
5376any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample;
5377alter the names:
5378
5379Yoyodyne, Inc., hereby disclaims all copyright interest in
5380the library `Frob` (a library for tweaking knobs) written
5381by James Random Hacker.
5382
5383signature of Ty Coon, 1 April 1990
5384Ty Coon, President of Vice
5385That`s all there is to it!
5386
5387</programlisting></para>
5388 </section>
5389
5390 <section id="lic_17">
5391 <title>LGPL-3.0</title>
5392
5393 <para><programlisting>
5394GNU LESSER GENERAL PUBLIC LICENSE
5395
5396Version 3, 29 June 2007
5397
5398Copyright © 2007 Free Software Foundation, Inc. &lt;http://fsf.org/&gt;
5399
5400Everyone is permitted to copy and distribute verbatim copies of this license document,
5401but changing it is not allowed.
5402
5403This version of the GNU Lesser General Public License incorporates the terms and
5404conditions of version 3 of the GNU General Public License, supplemented by the
5405additional permissions listed below.
54060. Additional Definitions.
5407
5408As used herein, “this License” refers to version 3 of the GNU Lesser
5409General Public License, and the “GNU GPL” refers to version 3 of the GNU
5410General Public License.
5411
5412“The Library” refers to a covered work governed by this License, other
5413than an Application or a Combined Work as defined below.
5414
5415An “Application” is any work that makes use of an interface provided by
5416the Library, but which is not otherwise based on the Library. Defining a subclass of a
5417class defined by the Library is deemed a mode of using an interface provided by the
5418Library.
5419
5420A “Combined Work” is a work produced by combining or linking an
5421Application with the Library. The particular version of the Library with which the
5422Combined Work was made is also called the “Linked Version”.
5423
5424The “Minimal Corresponding Source” for a Combined Work means the
5425Corresponding Source for the Combined Work, excluding any source code for portions of
5426the Combined Work that, considered in isolation, are based on the Application, and not
5427on the Linked Version.
5428
5429The “Corresponding Application Code” for a Combined Work means the object
5430code and/or source code for the Application, including any data and utility programs
5431needed for reproducing the Combined Work from the Application, but excluding the
5432System Libraries of the Combined Work.
54331. Exception to Section 3 of the GNU GPL.
5434
5435You may convey a covered work under sections 3 and 4 of this License without being
5436bound by section 3 of the GNU GPL.
54372. Conveying Modified Versions.
5438
5439If you modify a copy of the Library, and, in your modifications, a facility refers to
5440a function or data to be supplied by an Application that uses the facility (other than
5441as an argument passed when the facility is invoked), then you may convey a copy of the
5442modified version:
5443
5444 * a) under this License, provided that you make a good faith effort to ensure
5445that, in the event an Application does not supply the function or data, the facility
5446still operates, and performs whatever part of its purpose remains meaningful, or
5447 * b) under the GNU GPL, with none of the additional permissions of this License
5448applicable to that copy.
5449
54503. Object Code Incorporating Material from Library Header Files.
5451
5452The object code form of an Application may incorporate material from a header file
5453that is part of the Library. You may convey such object code under terms of your
5454choice, provided that, if the incorporated material is not limited to numerical
5455parameters, data structure layouts and accessors, or small macros, inline functions
5456and templates (ten or fewer lines in length), you do both of the following:
5457
5458 * a) Give prominent notice with each copy of the object code that the Library is
5459used in it and that the Library and its use are covered by this License.
5460 * b) Accompany the object code with a copy of the GNU GPL and this license
5461document.
5462
54634. Combined Works.
5464
5465You may convey a Combined Work under terms of your choice that, taken together,
5466effectively do not restrict modification of the portions of the Library contained in
5467the Combined Work and reverse engineering for debugging such modifications, if you
5468also do each of the following:
5469
5470 * a) Give prominent notice with each copy of the Combined Work that the Library is
5471used in it and that the Library and its use are covered by this License.
5472 * b) Accompany the Combined Work with a copy of the GNU GPL and this license
5473document.
5474 * c) For a Combined Work that displays copyright notices during execution, include
5475the copyright notice for the Library among these notices, as well as a reference
5476directing the user to the copies of the GNU GPL and this license document.
5477 * d) Do one of the following:
5478 o 0) Convey the Minimal Corresponding Source under the terms of this
5479License, and the Corresponding Application Code in a form suitable for, and under
5480terms that permit, the user to recombine or relink the Application with a modified
5481version of the Linked Version to produce a modified Combined Work, in the manner
5482specified by section 6 of the GNU GPL for conveying Corresponding Source.
5483 o 1) Use a suitable shared library mechanism for linking with the Library. A
5484suitable mechanism is one that (a) uses at run time a copy of the Library already
5485present on the user's computer system, and (b) will operate properly with a modified
5486version of the Library that is interface-compatible with the Linked Version.
5487 * e) Provide Installation Information, but only if you would otherwise be required
5488to provide such information under section 6 of the GNU GPL, and only to the extent
5489that such information is necessary to install and execute a modified version of the
5490Combined Work produced by recombining or relinking the Application with a modified
5491version of the Linked Version. (If you use option 4d0, the Installation Information
5492must accompany the Minimal Corresponding Source and Corresponding Application Code. If
5493you use option 4d1, you must provide the Installation Information in the manner
5494specified by section 6 of the GNU GPL for conveying Corresponding Source.)
5495
54965. Combined Libraries.
5497
5498You may place library facilities that are a work based on the Library side by side in
5499a single library together with other library facilities that are not Applications and
5500are not covered by this License, and convey such a combined library under terms of
5501your choice, if you do both of the following:
5502
5503 * a) Accompany the combined library with a copy of the same work based on the
5504Library, uncombined with any other library facilities, conveyed under the terms of
5505this License.
5506 * b) Give prominent notice with the combined library that part of it is a work
5507based on the Library, and explaining where to find the accompanying uncombined form of
5508the same work.
5509
55106. Revised Versions of the GNU Lesser General Public License.
5511
5512The Free Software Foundation may publish revised and/or new versions of the GNU Lesser
5513General Public License from time to time. Such new versions will be similar in spirit
5514to the present version, but may differ in detail to address new problems or concerns.
5515
5516Each version is given a distinguishing version number. If the Library as you received
5517it specifies that a certain numbered version of the GNU Lesser General Public License
5518“or any later version” applies to it, you have the option of following
5519the terms and conditions either of that published version or of any later version
5520published by the Free Software Foundation. If the Library as you received it does not
5521specify a version number of the GNU Lesser General Public License, you may choose any
5522version of the GNU Lesser General Public License ever published by the Free Software
5523Foundation.
5524
5525If the Library as you received it specifies that a proxy can decide whether future
5526versions of the GNU Lesser General Public License shall apply, that proxy's public
5527statement of acceptance of any version is permanent authorization for you to choose
5528that version for the Library.
5529</programlisting></para>
5530 </section>
5531
5532 <section id="lic_18">
5533 <title>Libpng</title>
5534
5535 <para><programlisting>
5536
5537This copy of the libpng notices is provided for your convenience. In case of
5538any discrepancy between this copy and the notices in the file png.h that is
5539included in the libpng distribution, the latter shall prevail.
5540
5541COPYRIGHT NOTICE, DISCLAIMER, and LICENSE:
5542
5543If you modify libpng you may insert additional notices immediately following
5544this sentence.
5545
5546This code is released under the libpng license.
5547
5548libpng versions 1.2.6, August 15, 2004, through 1.4.5, December 9, 2010, are
5549Copyright (c) 2004, 2006-2010 Glenn Randers-Pehrson, and are
5550distributed according to the same disclaimer and license as libpng-1.2.5
5551with the following individual added to the list of Contributing Authors
5552
5553 Cosmin Truta
5554
5555libpng versions 1.0.7, July 1, 2000, through 1.2.5 - October 3, 2002, are
5556Copyright (c) 2000-2002 Glenn Randers-Pehrson, and are
5557distributed according to the same disclaimer and license as libpng-1.0.6
5558with the following individuals added to the list of Contributing Authors
5559
5560 Simon-Pierre Cadieux
5561 Eric S. Raymond
5562 Gilles Vollant
5563
5564and with the following additions to the disclaimer:
5565
5566 There is no warranty against interference with your enjoyment of the
5567 library or against infringement. There is no warranty that our
5568 efforts or the library will fulfill any of your particular purposes
5569 or needs. This library is provided with all faults, and the entire
5570 risk of satisfactory quality, performance, accuracy, and effort is with
5571 the user.
5572
5573libpng versions 0.97, January 1998, through 1.0.6, March 20, 2000, are
5574Copyright (c) 1998, 1999 Glenn Randers-Pehrson, and are
5575distributed according to the same disclaimer and license as libpng-0.96,
5576with the following individuals added to the list of Contributing Authors:
5577
5578 Tom Lane
5579 Glenn Randers-Pehrson
5580 Willem van Schaik
5581
5582libpng versions 0.89, June 1996, through 0.96, May 1997, are
5583Copyright (c) 1996, 1997 Andreas Dilger
5584Distributed according to the same disclaimer and license as libpng-0.88,
5585with the following individuals added to the list of Contributing Authors:
5586
5587 John Bowler
5588 Kevin Bracey
5589 Sam Bushell
5590 Magnus Holmgren
5591 Greg Roelofs
5592 Tom Tanner
5593
5594libpng versions 0.5, May 1995, through 0.88, January 1996, are
5595Copyright (c) 1995, 1996 Guy Eric Schalnat, Group 42, Inc.
5596
5597For the purposes of this copyright and license, "Contributing Authors"
5598is defined as the following set of individuals:
5599
5600 Andreas Dilger
5601 Dave Martindale
5602 Guy Eric Schalnat
5603 Paul Schmidt
5604 Tim Wegner
5605
5606The PNG Reference Library is supplied "AS IS". The Contributing Authors
5607and Group 42, Inc. disclaim all warranties, expressed or implied,
5608including, without limitation, the warranties of merchantability and of
5609fitness for any purpose. The Contributing Authors and Group 42, Inc.
5610assume no liability for direct, indirect, incidental, special, exemplary,
5611or consequential damages, which may result from the use of the PNG
5612Reference Library, even if advised of the possibility of such damage.
5613
5614Permission is hereby granted to use, copy, modify, and distribute this
5615source code, or portions hereof, for any purpose, without fee, subject
5616to the following restrictions:
5617
56181. The origin of this source code must not be misrepresented.
5619
56202. Altered versions must be plainly marked as such and must not
5621 be misrepresented as being the original source.
5622
56233. This Copyright notice may not be removed or altered from any
5624 source or altered source distribution.
5625
5626The Contributing Authors and Group 42, Inc. specifically permit, without
5627fee, and encourage the use of this source code as a component to
5628supporting the PNG file format in commercial products. If you use this
5629source code in a product, acknowledgment is not required but would be
5630appreciated.
5631
5632
5633A "png_get_copyright" function is available, for convenient use in "about"
5634boxes and the like:
5635
5636 printf("%s",png_get_copyright(NULL));
5637
5638Also, the PNG logo (in PNG format, of course) is supplied in the
5639files "pngbar.png" and "pngbar.jpg (88x31) and "pngnow.png" (98x31).
5640
5641Libpng is OSI Certified Open Source Software. OSI Certified Open Source is a
5642certification mark of the Open Source Initiative.
5643
5644Glenn Randers-Pehrson
5645glennrp at users.sourceforge.net
5646December 9, 2010
5647
5648</programlisting></para>
5649 </section>
5650
5651 <section id="lic_19">
5652 <title>MIT</title>
5653
5654 <para><programlisting>
5655
5656MIT License
5657
5658Copyright (c) &lt;year&gt; &lt;copyright holders&gt;
5659
5660Permission is hereby granted, free of charge, to any person obtaining a copy
5661of this software and associated documentation files (the "Software"), to deal
5662in the Software without restriction, including without limitation the rights
5663to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
5664copies of the Software, and to permit persons to whom the Software is
5665furnished to do so, subject to the following conditions:
5666
5667The above copyright notice and this permission notice shall be included in
5668all copies or substantial portions of the Software.
5669
5670THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
5671IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
5672FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
5673AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
5674LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
5675OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
5676THE SOFTWARE.
5677
5678</programlisting></para>
5679 </section>
5680
5681 <section id="lic_20">
5682 <title>MPL-2.0</title>
5683
5684 <para><programlisting>
5685Mozilla Public License Version 2.0
5686==================================
5687
56881. Definitions
5689--------------
5690
56911.1. "Contributor"
5692 means each individual or legal entity that creates, contributes to
5693 the creation of, or owns Covered Software.
5694
56951.2. "Contributor Version"
5696 means the combination of the Contributions of others (if any) used
5697 by a Contributor and that particular Contributor's Contribution.
5698
56991.3. "Contribution"
5700 means Covered Software of a particular Contributor.
5701
57021.4. "Covered Software"
5703 means Source Code Form to which the initial Contributor has attached
5704 the notice in Exhibit A, the Executable Form of such Source Code
5705 Form, and Modifications of such Source Code Form, in each case
5706 including portions thereof.
5707
57081.5. "Incompatible With Secondary Licenses"
5709 means
5710
5711 (a) that the initial Contributor has attached the notice described
5712 in Exhibit B to the Covered Software; or
5713
5714 (b) that the Covered Software was made available under the terms of
5715 version 1.1 or earlier of the License, but not also under the
5716 terms of a Secondary License.
5717
57181.6. "Executable Form"
5719 means any form of the work other than Source Code Form.
5720
57211.7. "Larger Work"
5722 means a work that combines Covered Software with other material, in
5723 a separate file or files, that is not Covered Software.
5724
57251.8. "License"
5726 means this document.
5727
57281.9. "Licensable"
5729 means having the right to grant, to the maximum extent possible,
5730 whether at the time of the initial grant or subsequently, any and
5731 all of the rights conveyed by this License.
5732
57331.10. "Modifications"
5734 means any of the following:
5735
5736 (a) any file in Source Code Form that results from an addition to,
5737 deletion from, or modification of the contents of Covered
5738 Software; or
5739
5740 (b) any new file in Source Code Form that contains any Covered
5741 Software.
5742
57431.11. "Patent Claims" of a Contributor
5744 means any patent claim(s), including without limitation, method,
5745 process, and apparatus claims, in any patent Licensable by such
5746 Contributor that would be infringed, but for the grant of the
5747 License, by the making, using, selling, offering for sale, having
5748 made, import, or transfer of either its Contributions or its
5749 Contributor Version.
5750
57511.12. "Secondary License"
5752 means either the GNU General Public License, Version 2.0, the GNU
5753 Lesser General Public License, Version 2.1, the GNU Affero General
5754 Public License, Version 3.0, or any later versions of those
5755 licenses.
5756
57571.13. "Source Code Form"
5758 means the form of the work preferred for making modifications.
5759
57601.14. "You" (or "Your")
5761 means an individual or a legal entity exercising rights under this
5762 License. For legal entities, "You" includes any entity that
5763 controls, is controlled by, or is under common control with You. For
5764 purposes of this definition, "control" means (a) the power, direct
5765 or indirect, to cause the direction or management of such entity,
5766 whether by contract or otherwise, or (b) ownership of more than
5767 fifty percent (50%) of the outstanding shares or beneficial
5768 ownership of such entity.
5769
57702. License Grants and Conditions
5771--------------------------------
5772
57732.1. Grants
5774
5775Each Contributor hereby grants You a world-wide, royalty-free,
5776non-exclusive license:
5777
5778(a) under intellectual property rights (other than patent or trademark)
5779 Licensable by such Contributor to use, reproduce, make available,
5780 modify, display, perform, distribute, and otherwise exploit its
5781 Contributions, either on an unmodified basis, with Modifications, or
5782 as part of a Larger Work; and
5783
5784(b) under Patent Claims of such Contributor to make, use, sell, offer
5785 for sale, have made, import, and otherwise transfer either its
5786 Contributions or its Contributor Version.
5787
57882.2. Effective Date
5789
5790The licenses granted in Section 2.1 with respect to any Contribution
5791become effective for each Contribution on the date the Contributor first
5792distributes such Contribution.
5793
57942.3. Limitations on Grant Scope
5795
5796The licenses granted in this Section 2 are the only rights granted under
5797this License. No additional rights or licenses will be implied from the
5798distribution or licensing of Covered Software under this License.
5799Notwithstanding Section 2.1(b) above, no patent license is granted by a
5800Contributor:
5801
5802(a) for any code that a Contributor has removed from Covered Software;
5803 or
5804
5805(b) for infringements caused by: (i) Your and any other third party's
5806 modifications of Covered Software, or (ii) the combination of its
5807 Contributions with other software (except as part of its Contributor
5808 Version); or
5809
5810(c) under Patent Claims infringed by Covered Software in the absence of
5811 its Contributions.
5812
5813This License does not grant any rights in the trademarks, service marks,
5814or logos of any Contributor (except as may be necessary to comply with
5815the notice requirements in Section 3.4).
5816
58172.4. Subsequent Licenses
5818
5819No Contributor makes additional grants as a result of Your choice to
5820distribute the Covered Software under a subsequent version of this
5821License (see Section 10.2) or under the terms of a Secondary License (if
5822permitted under the terms of Section 3.3).
5823
58242.5. Representation
5825
5826Each Contributor represents that the Contributor believes its
5827Contributions are its original creation(s) or it has sufficient rights
5828to grant the rights to its Contributions conveyed by this License.
5829
58302.6. Fair Use
5831
5832This License is not intended to limit any rights You have under
5833applicable copyright doctrines of fair use, fair dealing, or other
5834equivalents.
5835
58362.7. Conditions
5837
5838Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
5839in Section 2.1.
5840
58413. Responsibilities
5842-------------------
5843
58443.1. Distribution of Source Form
5845
5846All distribution of Covered Software in Source Code Form, including any
5847Modifications that You create or to which You contribute, must be under
5848the terms of this License. You must inform recipients that the Source
5849Code Form of the Covered Software is governed by the terms of this
5850License, and how they can obtain a copy of this License. You may not
5851attempt to alter or restrict the recipients' rights in the Source Code
5852Form.
5853
58543.2. Distribution of Executable Form
5855
5856If You distribute Covered Software in Executable Form then:
5857
5858(a) such Covered Software must also be made available in Source Code
5859 Form, as described in Section 3.1, and You must inform recipients of
5860 the Executable Form how they can obtain a copy of such Source Code
5861 Form by reasonable means in a timely manner, at a charge no more
5862 than the cost of distribution to the recipient; and
5863
5864(b) You may distribute such Executable Form under the terms of this
5865 License, or sublicense it under different terms, provided that the
5866 license for the Executable Form does not attempt to limit or alter
5867 the recipients' rights in the Source Code Form under this License.
5868
58693.3. Distribution of a Larger Work
5870
5871You may create and distribute a Larger Work under terms of Your choice,
5872provided that You also comply with the requirements of this License for
5873the Covered Software. If the Larger Work is a combination of Covered
5874Software with a work governed by one or more Secondary Licenses, and the
5875Covered Software is not Incompatible With Secondary Licenses, this
5876License permits You to additionally distribute such Covered Software
5877under the terms of such Secondary License(s), so that the recipient of
5878the Larger Work may, at their option, further distribute the Covered
5879Software under the terms of either this License or such Secondary
5880License(s).
5881
58823.4. Notices
5883
5884You may not remove or alter the substance of any license notices
5885(including copyright notices, patent notices, disclaimers of warranty,
5886or limitations of liability) contained within the Source Code Form of
5887the Covered Software, except that You may alter any license notices to
5888the extent required to remedy known factual inaccuracies.
5889
58903.5. Application of Additional Terms
5891
5892You may choose to offer, and to charge a fee for, warranty, support,
5893indemnity or liability obligations to one or more recipients of Covered
5894Software. However, You may do so only on Your own behalf, and not on
5895behalf of any Contributor. You must make it absolutely clear that any
5896such warranty, support, indemnity, or liability obligation is offered by
5897You alone, and You hereby agree to indemnify every Contributor for any
5898liability incurred by such Contributor as a result of warranty, support,
5899indemnity or liability terms You offer. You may include additional
5900disclaimers of warranty and limitations of liability specific to any
5901jurisdiction.
5902
59034. Inability to Comply Due to Statute or Regulation
5904---------------------------------------------------
5905
5906If it is impossible for You to comply with any of the terms of this
5907License with respect to some or all of the Covered Software due to
5908statute, judicial order, or regulation then You must: (a) comply with
5909the terms of this License to the maximum extent possible; and (b)
5910describe the limitations and the code they affect. Such description must
5911be placed in a text file included with all distributions of the Covered
5912Software under this License. Except to the extent prohibited by statute
5913or regulation, such description must be sufficiently detailed for a
5914recipient of ordinary skill to be able to understand it.
5915
59165. Termination
5917--------------
5918
59195.1. The rights granted under this License will terminate automatically
5920if You fail to comply with any of its terms. However, if You become
5921compliant, then the rights granted under this License from a particular
5922Contributor are reinstated (a) provisionally, unless and until such
5923Contributor explicitly and finally terminates Your grants, and (b) on an
5924ongoing basis, if such Contributor fails to notify You of the
5925non-compliance by some reasonable means prior to 60 days after You have
5926come back into compliance. Moreover, Your grants from a particular
5927Contributor are reinstated on an ongoing basis if such Contributor
5928notifies You of the non-compliance by some reasonable means, this is the
5929first time You have received notice of non-compliance with this License
5930from such Contributor, and You become compliant prior to 30 days after
5931Your receipt of the notice.
5932
59335.2. If You initiate litigation against any entity by asserting a patent
5934infringement claim (excluding declaratory judgment actions,
5935counter-claims, and cross-claims) alleging that a Contributor Version
5936directly or indirectly infringes any patent, then the rights granted to
5937You by any and all Contributors for the Covered Software under Section
59382.1 of this License shall terminate.
5939
59405.3. In the event of termination under Sections 5.1 or 5.2 above, all
5941end user license agreements (excluding distributors and resellers) which
5942have been validly granted by You or Your distributors under this License
5943prior to termination shall survive termination.
5944
5945************************************************************************
5946* *
5947* 6. Disclaimer of Warranty *
5948* ------------------------- *
5949* *
5950* Covered Software is provided under this License on an "as is" *
5951* basis, without warranty of any kind, either expressed, implied, or *
5952* statutory, including, without limitation, warranties that the *
5953* Covered Software is free of defects, merchantable, fit for a *
5954* particular purpose or non-infringing. The entire risk as to the *
5955* quality and performance of the Covered Software is with You. *
5956* Should any Covered Software prove defective in any respect, You *
5957* (not any Contributor) assume the cost of any necessary servicing, *
5958* repair, or correction. This disclaimer of warranty constitutes an *
5959* essential part of this License. No use of any Covered Software is *
5960* authorized under this License except under this disclaimer. *
5961* *
5962************************************************************************
5963
5964************************************************************************
5965* *
5966* 7. Limitation of Liability *
5967* -------------------------- *
5968* *
5969* Under no circumstances and under no legal theory, whether tort *
5970* (including negligence), contract, or otherwise, shall any *
5971* Contributor, or anyone who distributes Covered Software as *
5972* permitted above, be liable to You for any direct, indirect, *
5973* special, incidental, or consequential damages of any character *
5974* including, without limitation, damages for lost profits, loss of *
5975* goodwill, work stoppage, computer failure or malfunction, or any *
5976* and all other commercial damages or losses, even if such party *
5977* shall have been informed of the possibility of such damages. This *
5978* limitation of liability shall not apply to liability for death or *
5979* personal injury resulting from such party's negligence to the *
5980* extent applicable law prohibits such limitation. Some *
5981* jurisdictions do not allow the exclusion or limitation of *
5982* incidental or consequential damages, so this exclusion and *
5983* limitation may not apply to You. *
5984* *
5985************************************************************************
5986
59878. Litigation
5988-------------
5989
5990Any litigation relating to this License may be brought only in the
5991courts of a jurisdiction where the defendant maintains its principal
5992place of business and such litigation shall be governed by laws of that
5993jurisdiction, without reference to its conflict-of-law provisions.
5994Nothing in this Section shall prevent a party's ability to bring
5995cross-claims or counter-claims.
5996
59979. Miscellaneous
5998----------------
5999
6000This License represents the complete agreement concerning the subject
6001matter hereof. If any provision of this License is held to be
6002unenforceable, such provision shall be reformed only to the extent
6003necessary to make it enforceable. Any law or regulation which provides
6004that the language of a contract shall be construed against the drafter
6005shall not be used to construe this License against a Contributor.
6006
600710. Versions of the License
6008---------------------------
6009
601010.1. New Versions
6011
6012Mozilla Foundation is the license steward. Except as provided in Section
601310.3, no one other than the license steward has the right to modify or
6014publish new versions of this License. Each version will be given a
6015distinguishing version number.
6016
601710.2. Effect of New Versions
6018
6019You may distribute the Covered Software under the terms of the version
6020of the License under which You originally received the Covered Software,
6021or under the terms of any subsequent version published by the license
6022steward.
6023
602410.3. Modified Versions
6025
6026If you create software not governed by this License, and you want to
6027create a new license for such software, you may create and use a
6028modified version of this License if you rename the license and remove
6029any references to the name of the license steward (except to note that
6030such modified license differs from this License).
6031
603210.4. Distributing Source Code Form that is Incompatible With Secondary
6033Licenses
6034
6035If You choose to distribute Source Code Form that is Incompatible With
6036Secondary Licenses under the terms of this version of the License, the
6037notice described in Exhibit B of this License must be attached.
6038
6039Exhibit A - Source Code Form License Notice
6040-------------------------------------------
6041
6042 This Source Code Form is subject to the terms of the Mozilla Public
6043 License, v. 2.0. If a copy of the MPL was not distributed with this
6044 file, You can obtain one at http://mozilla.org/MPL/2.0/.
6045
6046If it is not possible or desirable to put the notice in a particular
6047file, then You may include the notice in a location (such as a LICENSE
6048file in a relevant directory) where a recipient would be likely to look
6049for such a notice.
6050
6051You may add additional accurate notices of copyright ownership.
6052
6053Exhibit B - "Incompatible With Secondary Licenses" Notice
6054---------------------------------------------------------
6055
6056 This Source Code Form is "Incompatible With Secondary Licenses", as
6057 defined by the Mozilla Public License, v. 2.0.
6058</programlisting></para>
6059 </section>
6060
6061 <section id="lic_21">
6062 <title>OpenSSL</title>
6063
6064 <para><programlisting>
6065
6066OpenSSL License
6067
6068 ====================================================================
6069 Copyright (c) 1998-2008 The OpenSSL Project. All rights reserved.
6070
6071 Redistribution and use in source and binary forms, with or without
6072 modification, are permitted provided that the following conditions
6073 are met:
6074
6075 1. Redistributions of source code must retain the above copyright
6076 notice, this list of conditions and the following disclaimer.
6077
6078 2. Redistributions in binary form must reproduce the above copyright
6079 notice, this list of conditions and the following disclaimer in
6080 the documentation and/or other materials provided with the
6081 distribution.
6082
6083 3. All advertising materials mentioning features or use of this
6084 software must display the following acknowledgment:
6085 "This product includes software developed by the OpenSSL Project
6086 for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
6087
6088 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
6089 endorse or promote products derived from this software without
6090 prior written permission. For written permission, please contact
6091 openssl-core@openssl.org.
6092
6093 5. Products derived from this software may not be called "OpenSSL"
6094 nor may "OpenSSL" appear in their names without prior written
6095 permission of the OpenSSL Project.
6096
6097 6. Redistributions of any form whatsoever must retain the following
6098 acknowledgment:
6099 "This product includes software developed by the OpenSSL Project
6100 for use in the OpenSSL Toolkit (http://www.openssl.org/)"
6101
6102 THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS`` AND ANY
6103 EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
6104 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
6105 PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
6106 ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
6107 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
6108 NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
6109 LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
6110 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
6111 STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
6112 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
6113 OF THE POSSIBILITY OF SUCH DAMAGE.
6114 ====================================================================
6115
6116 This product includes cryptographic software written by Eric Young
6117 (eay@cryptsoft.com). This product includes software written by Tim
6118 Hudson (tjh@cryptsoft.com).
6119
6120
6121 Original SSLeay License
6122 -----------------------
6123
6124Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
6125All rights reserved.
6126
6127 This package is an SSL implementation written
6128 by Eric Young (eay@cryptsoft.com).
6129 The implementation was written so as to conform with Netscapes SSL.
6130
6131 This library is free for commercial and non-commercial use as long as
6132 the following conditions are aheared to. The following conditions
6133 apply to all code found in this distribution, be it the RC4, RSA,
6134 lhash, DES, etc., code; not just the SSL code. The SSL documentation
6135 included with this distribution is covered by the same copyright terms
6136 except that the holder is Tim Hudson (tjh@cryptsoft.com).
6137
6138 Copyright remains Eric Young`s, and as such any Copyright notices in
6139 the code are not to be removed.
6140 If this package is used in a product, Eric Young should be given attribution
6141 as the author of the parts of the library used.
6142 This can be in the form of a textual message at program startup or
6143 in documentation (online or textual) provided with the package.
6144
6145 Redistribution and use in source and binary forms, with or without
6146 modification, are permitted provided that the following conditions
6147 are met:
6148 1. Redistributions of source code must retain the copyright
6149 notice, this list of conditions and the following disclaimer.
6150 2. Redistributions in binary form must reproduce the above copyright
6151 notice, this list of conditions and the following disclaimer in the
6152 documentation and/or other materials provided with the distribution.
6153 3. All advertising materials mentioning features or use of this software
6154 must display the following acknowledgement:
6155 "This product includes cryptographic software written by
6156 Eric Young (eay@cryptsoft.com)"
6157 The word `cryptographic` can be left out if the rouines from the library
6158 being used are not cryptographic related :-).
6159 4. If you include any Windows specific code (or a derivative thereof) from
6160 the apps directory (application code) you must include an acknowledgement:
6161 "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
6162
6163 THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS`` AND ANY EXPRESS OR IMPLIED
6164WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
6165AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR
6166CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
6167CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
6168OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
6169HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
6170OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
6171SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
6172
6173 The licence and distribution terms for any publically available version or
6174derivative of this code cannot be changed. i.e. this code cannot simply be copied and
6175put under another distribution licence
6176 [including the GNU Public Licence.]
6177
6178
6179
6180
6181</programlisting></para>
6182 </section>
6183
6184 <section id="lic_22">
6185 <title>PD</title>
6186
6187 <para><programlisting>
6188This is a placeholder for the Public Domain License
6189</programlisting></para>
6190 </section>
6191
6192 <section id="lic_23">
6193 <title>Python-2.0</title>
6194
6195 <para><programlisting>
6196
6197PYTHON SOFTWARE FOUNDATION LICENSE VERSION 2
6198--------------------------------------------
6199
62001. This LICENSE AGREEMENT is between the Python Software Foundation
6201("PSF"), and the Individual or Organization ("Licensee") accessing and
6202otherwise using this software ("Python") in source or binary form and
6203its associated documentation.
6204
62052. Subject to the terms and conditions of this License Agreement, PSF
6206hereby grants Licensee a nonexclusive, royalty-free, world-wide
6207license to reproduce, analyze, test, perform and/or display publicly,
6208prepare derivative works, distribute, and otherwise use Python
6209alone or in any derivative version, provided, however, that PSF`s
6210License Agreement and PSF`s notice of copyright, i.e., "Copyright (c)
62112001, 2002, 2003, 2004, 2005, 2006 Python Software Foundation; All Rights
6212Reserved" are retained in Python alone or in any derivative version
6213prepared by Licensee.
6214
62153. In the event Licensee prepares a derivative work that is based on
6216or incorporates Python or any part thereof, and wants to make
6217the derivative work available to others as provided herein, then
6218Licensee hereby agrees to include in any such work a brief summary of
6219the changes made to Python.
6220
62214. PSF is making Python available to Licensee on an "AS IS"
6222basis. PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
6223IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, PSF MAKES NO AND
6224DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
6225FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON WILL NOT
6226INFRINGE ANY THIRD PARTY RIGHTS.
6227
62285. PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
6229FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
6230A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON,
6231OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
6232
62336. This License Agreement will automatically terminate upon a material
6234breach of its terms and conditions.
6235
62367. Nothing in this License Agreement shall be deemed to create any
6237relationship of agency, partnership, or joint venture between PSF and
6238Licensee. This License Agreement does not grant permission to use PSF
6239trademarks or trade name in a trademark sense to endorse or promote
6240products or services of Licensee, or any third party.
6241
62428. By copying, installing or otherwise using Python, Licensee
6243agrees to be bound by the terms and conditions of this License
6244Agreement.
6245
6246BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0
6247-------------------------------------------
6248
6249BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1
6250
62511. This LICENSE AGREEMENT is between BeOpen.com ("BeOpen"), having an
6252office at 160 Saratoga Avenue, Santa Clara, CA 95051, and the
6253Individual or Organization ("Licensee") accessing and otherwise using
6254this software in source or binary form and its associated
6255documentation ("the Software").
6256
62572. Subject to the terms and conditions of this BeOpen Python License
6258Agreement, BeOpen hereby grants Licensee a non-exclusive,
6259royalty-free, world-wide license to reproduce, analyze, test, perform
6260and/or display publicly, prepare derivative works, distribute, and
6261otherwise use the Software alone or in any derivative version,
6262provided, however, that the BeOpen Python License is retained in the
6263Software, alone or in any derivative version prepared by Licensee.
6264
62653. BeOpen is making the Software available to Licensee on an "AS IS"
6266basis. BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
6267IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, BEOPEN MAKES NO AND
6268DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
6269FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE WILL NOT
6270INFRINGE ANY THIRD PARTY RIGHTS.
6271
62724. BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE
6273SOFTWARE FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS
6274AS A RESULT OF USING, MODIFYING OR DISTRIBUTING THE SOFTWARE, OR ANY
6275DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
6276
62775. This License Agreement will automatically terminate upon a material
6278breach of its terms and conditions.
6279
62806. This License Agreement shall be governed by and interpreted in all
6281respects by the law of the State of California, excluding conflict of
6282law provisions. Nothing in this License Agreement shall be deemed to
6283create any relationship of agency, partnership, or joint venture
6284between BeOpen and Licensee. This License Agreement does not grant
6285permission to use BeOpen trademarks or trade names in a trademark
6286sense to endorse or promote products or services of Licensee, or any
6287third party. As an exception, the "BeOpen Python" logos available at
6288http://www.pythonlabs.com/logos.html may be used according to the
6289permissions granted on that web page.
6290
62917. By copying, installing or otherwise using the software, Licensee
6292agrees to be bound by the terms and conditions of this License
6293Agreement.
6294
6295CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1
6296---------------------------------------
6297
62981. This LICENSE AGREEMENT is between the Corporation for National
6299Research Initiatives, having an office at 1895 Preston White Drive,
6300Reston, VA 20191 ("CNRI"), and the Individual or Organization
6301("Licensee") accessing and otherwise using Python 1.6.1 software in
6302source or binary form and its associated documentation.
6303
63042. Subject to the terms and conditions of this License Agreement, CNRI
6305hereby grants Licensee a nonexclusive, royalty-free, world-wide
6306license to reproduce, analyze, test, perform and/or display publicly,
6307prepare derivative works, distribute, and otherwise use Python 1.6.1
6308alone or in any derivative version, provided, however, that CNRI`s
6309License Agreement and CNRI`s notice of copyright, i.e., "Copyright (c)
63101995-2001 Corporation for National Research Initiatives; All Rights
6311Reserved" are retained in Python 1.6.1 alone or in any derivative
6312version prepared by Licensee. Alternately, in lieu of CNRI`s License
6313Agreement, Licensee may substitute the following text (omitting the
6314quotes): "Python 1.6.1 is made available subject to the terms and
6315conditions in CNRI`s License Agreement. This Agreement together with
6316Python 1.6.1 may be located on the Internet using the following
6317unique, persistent identifier (known as a handle): 1895.22/1013. This
6318Agreement may also be obtained from a proxy server on the Internet
6319using the following URL: http://hdl.handle.net/1895.22/1013".
6320
63213. In the event Licensee prepares a derivative work that is based on
6322or incorporates Python 1.6.1 or any part thereof, and wants to make
6323the derivative work available to others as provided herein, then
6324Licensee hereby agrees to include in any such work a brief summary of
6325the changes made to Python 1.6.1.
6326
63274. CNRI is making Python 1.6.1 available to Licensee on an "AS IS"
6328basis. CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR
6329IMPLIED. BY WAY OF EXAMPLE, BUT NOT LIMITATION, CNRI MAKES NO AND
6330DISCLAIMS ANY REPRESENTATION OR WARRANTY OF MERCHANTABILITY OR FITNESS
6331FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF PYTHON 1.6.1 WILL NOT
6332INFRINGE ANY THIRD PARTY RIGHTS.
6333
63345. CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON
63351.6.1 FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS
6336A RESULT OF MODIFYING, DISTRIBUTING, OR OTHERWISE USING PYTHON 1.6.1,
6337OR ANY DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF.
6338
63396. This License Agreement will automatically terminate upon a material
6340breach of its terms and conditions.
6341
63427. This License Agreement shall be governed by the federal
6343intellectual property law of the United States, including without
6344limitation the federal copyright law, and, to the extent such
6345U.S. federal law does not apply, by the law of the Commonwealth of
6346Virginia, excluding Virginia`s conflict of law provisions.
6347Notwithstanding the foregoing, with regard to derivative works based
6348on Python 1.6.1 that incorporate non-separable material that was
6349previously distributed under the GNU General Public License (GPL), the
6350law of the Commonwealth of Virginia shall govern this License
6351Agreement only as to issues arising under or with respect to
6352Paragraphs 4, 5, and 7 of this License Agreement. Nothing in this
6353License Agreement shall be deemed to create any relationship of
6354agency, partnership, or joint venture between CNRI and Licensee. This
6355License Agreement does not grant permission to use CNRI trademarks or
6356trade name in a trademark sense to endorse or promote products or
6357services of Licensee, or any third party.
6358
63598. By clicking on the "ACCEPT" button where indicated, or by copying,
6360installing or otherwise using Python 1.6.1, Licensee agrees to be
6361bound by the terms and conditions of this License Agreement.
6362
6363ACCEPT
6364
6365CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2
6366--------------------------------------------------
6367
6368Copyright (c) 1991 - 1995, Stichting Mathematisch Centrum Amsterdam,
6369The Netherlands. All rights reserved.
6370
6371Permission to use, copy, modify, and distribute this software and its
6372documentation for any purpose and without fee is hereby granted,
6373provided that the above copyright notice appear in all copies and that
6374both that copyright notice and this permission notice appear in
6375supporting documentation, and that the name of Stichting Mathematisch
6376Centrum or CWI not be used in advertising or publicity pertaining to
6377distribution of the software without specific, written prior
6378permission.
6379
6380STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO
6381THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
6382FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH CENTRUM BE LIABLE
6383FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
6384WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
6385ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
6386OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
6387
6388</programlisting></para>
6389 </section>
6390
6391 <section id="lic_24">
6392 <title>Sleepycat</title>
6393
6394 <para><programlisting>
6395
6396The Sleepycat License
6397Copyright (c) 1990-1999
6398Sleepycat Software. All rights reserved.
6399
6400Redistribution and use in source and binary forms, with or without
6401modification, are permitted provided that the following conditions
6402are met:
6403
6404Redistributions of source code must retain the above copyright
6405notice, this list of conditions and the following disclaimer.
6406Redistributions in binary form must reproduce the above copyright
6407notice, this list of conditions and the following disclaimer in the
6408documentation and/or other materials provided with the distribution.
6409Redistributions in any form must be accompanied by information on
6410how to obtain complete source code for the DB software and any
6411accompanying software that uses the DB software. The source code
6412must either be included in the distribution or be available for no
6413more than the cost of distribution plus a nominal fee, and must be
6414freely redistributable under reasonable conditions. For an
6415executable file, complete source code means the source code for all
6416modules it contains. It does not include source code for modules or
6417files that typically accompany the major components of the operating
6418system on which the executable file runs.
6419THIS SOFTWARE IS PROVIDED BY SLEEPYCAT SOFTWARE ``AS IS`` AND ANY EXPRESS
6420OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
6421WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR
6422NON-INFRINGEMENT, ARE DISCLAIMED. IN NO EVENT SHALL SLEEPYCAT SOFTWARE
6423BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
6424CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
6425SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
6426INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
6427CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
6428ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
6429THE POSSIBILITY OF SUCH DAMAGE.
6430
6431Copyright (c) 1990, 1993, 1994, 1995
6432The Regents of the University of California. All rights reserved.
6433
6434Redistribution and use in source and binary forms, with or without
6435modification, are permitted provided that the following conditions
6436are met:
6437
6438Redistributions of source code must retain the above copyright
6439notice, this list of conditions and the following disclaimer.
6440Redistributions in binary form must reproduce the above copyright
6441notice, this list of conditions and the following disclaimer in the
6442documentation and/or other materials provided with the distribution.
6443Neither the name of the University nor the names of its contributors
6444may be used to endorse or promote products derived from this software
6445without specific prior written permission.
6446THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS`` AND
6447ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
6448IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
6449ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
6450FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
6451DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
6452OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
6453HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
6454LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
6455OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
6456SUCH DAMAGE.
6457
6458Copyright (c) 1995, 1996
6459The President and Fellows of Harvard University. All rights reserved.
6460
6461Redistribution and use in source and binary forms, with or without
6462modification, are permitted provided that the following conditions
6463are met:
6464
6465Redistributions of source code must retain the above copyright
6466notice, this list of conditions and the following disclaimer.
6467Redistributions in binary form must reproduce the above copyright
6468notice, this list of conditions and the following disclaimer in the
6469documentation and/or other materials provided with the distribution.
6470Neither the name of the University nor the names of its contributors
6471may be used to endorse or promote products derived from this software
6472without specific prior written permission.
6473THIS SOFTWARE IS PROVIDED BY HARVARD AND ITS CONTRIBUTORS ``AS IS`` AND
6474ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
6475IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
6476ARE DISCLAIMED. IN NO EVENT SHALL HARVARD OR ITS CONTRIBUTORS BE LIABLE
6477FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
6478DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
6479OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
6480HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
6481LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
6482OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
6483SUCH DAMAGE.
6484
6485</programlisting></para>
6486 </section>
6487
6488 <section id="lic_25">
6489 <title>Zlib</title>
6490
6491 <para><programlisting>
6492zlib License
6493
6494
6495 This software is provided `as-is`, without any express or implied
6496 warranty. In no event will the authors be held liable for any damages
6497 arising from the use of this software.
6498
6499 Permission is granted to anyone to use this software for any purpose,
6500 including commercial applications, and to alter it and redistribute it
6501 freely, subject to the following restrictions:
6502
6503 1. The origin of this software must not be misrepresented; you must not
6504 claim that you wrote the original software. If you use this software
6505 in a product, an acknowledgment in the product documentation would be
6506 appreciated but is not required.
6507 2. Altered source versions must be plainly marked as such, and must not be
6508 misrepresented as being the original software.
6509 3. This notice may not be removed or altered from any source distribution.
6510
6511
6512</programlisting></para>
6513 </section>
6514 </section>
6515
6516 <section id="proprietary_license">
6517 <title>Proprietary Licenses</title>
6518
6519 <para>There are no Proprietary Licenses.</para>
6520 </section>
6521</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-open-source/swcomp.mk b/doc/book-enea-linux-open-source/swcomp.mk
new file mode 100644
index 0000000..231fe03
--- /dev/null
+++ b/doc/book-enea-linux-open-source/swcomp.mk
@@ -0,0 +1,10 @@
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-linux-open-source-rt
9BOOKDESC_$(BOOKPACKAGES) := "Enea Linux Open Source Report"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-linux-release-info/doc/about_release.xml b/doc/book-enea-linux-release-info/doc/about_release.xml
new file mode 100644
index 0000000..cb75bc1
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/about_release.xml
@@ -0,0 +1,235 @@
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="relinfo-about-release">
5 <title>About This Release</title>
6
7 <para>This release of Enea Linux <xi:include href="eltf_params_updated.xml"
8 xmlns:xi="http://www.w3.org/2001/XInclude"
9 xpointer="element(EneaLinux_REL_VER/1)" /> provides a publicly available
10 Enea Linux distribution for a selected set of targets. This release is
11 generated from the Yocto Project <xi:include href="eltf_params_updated.xml"
12 xmlns:xi="http://www.w3.org/2001/XInclude"
13 xpointer="element(Yocto_VER/1)" /> distribution using the branch <xi:include
14 href="eltf_params_updated.xml" xmlns:xi="http://www.w3.org/2001/XInclude"
15 xpointer="element(Yocto_NAME/1)" />.<remark>INFO <emphasis
16 role="bold">eltf_params_updated.xml</emphasis> contains many parameters in
17 the book, also in the open source books, and MUST be created FROM <emphasis
18 role="bold">eltf_params_template.xml</emphasis>. </remark></para>
19
20 <para><remark>The parameters are automatically used in the books, via
21 xi:include statements, similar to how parameters from pardoc-distro.xml are
22 included in the book. Read the file <emphasis
23 role="bold">eltf_params_updated_template_how_to_use.txt</emphasis> for
24 important details about formats and how to do! The idea is that ELTF will
25 auto-create/update it.</remark></para>
26
27 <section id="relinfo-provided-contents">
28 <title>Provided Contents</title>
29
30 <para>The current release contains documentation, prebuilt kernels and
31 images, a bootloader and an SDK. The directories structure is detailed
32 below:</para>
33
34 <programlisting>-- Documentation/
35 /* Enea Linux 8 documentation */
36 -- intel-corei7-64/
37 /* artifacts for the reference machine */
38 -- deb/
39 /* deb packages */
40 -- images/
41 -- enea-image-rt
42 /* precompiled artifacts for the platform release image */
43 -- various artifacts (rootfs, kernel, config, dtb etc.)
44 -- enea-image-rt-sdk
45 /* precompiled artifacts for the development process. The image
46 contains userspace tools and kernel configurations necessary
47 for developing, debugging and profiling applications and \
48 kernel modules */
49 -- various artifacts
50 -- sdk
51 /* SDK related artifacts including SDK installer and manifests */
52 /* self-extracting archive installing cross-compilation
53 toolchain for the platform */
54 -- x86_64-buildtools-nativesdk-standalone-8.0.sh
55 /* self-extracting archive installing additional tools
56 for the host machine */</programlisting>
57
58 <para>The following set of artifacts is available:</para>
59
60 <programlisting>-- Image
61 /* kernel image */
62-- Image-target.bin
63 /* kernel image, same as above */
64-- Image-target.dtb
65 /* the device tree blob */
66-- config-target.config
67 /* kernel configuration file */
68-- image-name-target.ext3
69 /* compressed EXT3 image of the rootfs */
70-- image-name-target.tar.bz2
71 /* tar archive of the image */
72-- modules-&lt;target&gt;.tgz
73 /* external kernel modules */</programlisting>
74 </section>
75
76 <section id="relinfo-supported-host-environment">
77 <title>Supported Host Environment</title>
78
79 <para>The following environments have been validated as host environments
80 for this release of Enea Linux: <emphasis role="bold">Ubuntu 16.04 LTS,
81 64-bit</emphasis>.</para>
82
83 <para><remark>INFO Below is a complete section with ID
84 "eltf-target-tables-section" included from elft_params_updated.xml. It
85 contains a variable number of target tables and the section title should
86 be "Supported Targets with Parameters". It has have a short sentence about
87 what it is in the beginning. The subtitles shall have the directory name
88 of the target in the manifest.</remark></para>
89 </section>
90
91 <xi:include href="eltf_params_updated.xml"
92 xmlns:xi="http://www.w3.org/2001/XInclude"
93 xpointer="element(eltf-target-tables-section)" />
94
95 <section id="relinfo-packages">
96 <title>Provided Packages</title>
97
98 <para><informaltable>
99 <tgroup cols="2">
100 <colspec align="left" colname="c1" colwidth="3*" />
101
102 <colspec align="left" colname="c2" colwidth="6*" />
103
104 <thead valign="bottom">
105 <row>
106 <entry>Type of Packages</entry>
107
108 <entry>Reference</entry>
109 </row>
110 </thead>
111
112 <tbody>
113 <row>
114 <entry>Packages in Enea Linux</entry>
115
116 <entry><para>See the <olink
117 targetdoc="book_enea_linux_open_source_rt"
118 targetptr="book_enea_linux_open_source_rt"><trademark
119 class="registered">Enea</trademark> Linux Open Source
120 Report</olink></para></entry>
121 </row>
122 </tbody>
123 </tgroup>
124 </informaltable></para>
125 </section>
126
127 <section id="relinfo-provided-sdk">
128 <title>Provided Toolchains (SDK)</title>
129
130 <para>The SDK contains toolchains supporting cross-compilation of
131 applications for the targets on an aarch64 host. For information on how to
132 build and install a toolchain, see the chapter <olink
133 targetdoc="book_enea_linux_user_guide_rt"
134 targetptr="using_enealinux">Using Enea Linux, in the <xi:include
135 href="../../s_docbuild/olinkdb/pardoc-names.xml"
136 xmlns:xi="http://www.w3.org/2001/XInclude"
137 xpointer="element(book_enea_linux_user_guide_standard/1)" /></olink>.</para>
138 </section>
139
140 <section id="relinfo-documentation">
141 <title>Provided Documentation</title>
142
143 <para>The following Enea Linux manuals are available:</para>
144
145 <itemizedlist spacing="compact">
146 <listitem>
147 <para><trademark class="registered">Enea</trademark> Linux Release
148 Information (this document)</para>
149 </listitem>
150
151 <listitem>
152 <para><olink targetdoc="book_enea_linux_user_guide_rt"
153 targetptr="book_enea_linux_user_guide_rt"><trademark
154 class="registered">Enea</trademark> Linux User's Guide</olink></para>
155 </listitem>
156
157 <listitem>
158 <para><olink targetdoc="book_enea_linux_open_source_rt"
159 targetptr="book_enea_linux_open_source_rt"><trademark
160 class="registered">Enea</trademark> Linux Open Source
161 Report</olink></para>
162 </listitem>
163
164 <listitem>
165 <para><trademark class="registered">Enea</trademark> Linux Test
166 Report</para>
167 </listitem>
168
169 <listitem>
170 <para><trademark class="registered">Enea</trademark> Linux Security
171 Report</para>
172 </listitem>
173
174 <listitem>
175 <para><trademark class="registered">Enea</trademark><ulink
176 url="http://linuxrealtime.org"> Linux Real-Time Guide</ulink></para>
177 </listitem>
178 </itemizedlist>
179 </section>
180
181 <section condition="hidden" id="relinfo-provided-other">
182 <title>Other Provided Functionality</title>
183
184 <para>The functionality in a distribution depends on included packages in
185 the default image. In addition to the supported features, the following
186 functionality is also available, among other:<remark>INFO: This section
187 might be hidden by setting condition hidden on the section, MANUALLY in
188 this file</remark></para>
189
190 <itemizedlist spacing="compact">
191 <listitem>
192 <para>APT Package Management</para>
193 </listitem>
194
195 <listitem>
196 <para>Eclipse ADT (excl. QEMU) and plug-ins for application
197 development: LTTng, Perf, LatencyTOP, PowerTOP, SystemTap</para>
198 </listitem>
199 </itemizedlist>
200 </section>
201
202 <section id="relinfo-security-fixes">
203 <title>Security Fixes</title>
204
205 <para>See the <ulink
206 url="https://www.enea.com/products/security/security-updates/">List of
207 CVEs addressed in Enea Linux</ulink> for details.</para>
208 </section>
209
210 <section condition="hidden" id="relinfo-excluded">
211 <title>Intentional Limitations</title>
212
213 <para>The following functionality supported in other Enea Linux releases
214 has been excluded in this release:<remark>INFO: This section might be
215 hidden by setting condition hidden on the section, MANUALLY in this
216 file.</remark><itemizedlist spacing="compact">
217 <listitem>
218 <para>Eclipse plug-ins for image creation (HOB)</para>
219 </listitem>
220
221 <listitem>
222 <para>Networking features: DPDK vSwitch, DPDK</para>
223 </listitem>
224
225 <listitem>
226 <para>Real-time features: Fully Preemptible Kernel (FPK) from the
227 PREEMPT_RT patch</para>
228 </listitem>
229
230 <listitem>
231 <para>Memory features: NUMA</para>
232 </listitem>
233 </itemizedlist></para>
234 </section>
235</chapter>
diff --git a/doc/book-enea-linux-release-info/doc/book.xml b/doc/book-enea-linux-release-info/doc/book.xml
new file mode 100644
index 0000000..13aff10
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/book.xml
@@ -0,0 +1,22 @@
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_linux_release_info_rt">
7 <title><trademark class="registered">Enea</trademark> Linux Release Information</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" xmlns:xi="http://www.w3.org/2001/XInclude" />
13 <xi:include href="about_release.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
14 <!--
15 <xi:include href="prerequisites.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
16 <xi:include href="getting_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
17 <xi:include href="build_boot_generated.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
18 -->
19 <xi:include href="main_changes.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
20 <xi:include href="known_bugs_and_limitations.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
21 <xi:include href="../../s_docbuild/template/docsrc_common/contacting_enea_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
22</book>
diff --git a/doc/book-enea-linux-release-info/doc/build_boot_template.xml b/doc/book-enea-linux-release-info/doc/build_boot_template.xml
new file mode 100644
index 0000000..e39dd81
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/build_boot_template.xml
@@ -0,0 +1,34 @@
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="relinfo-build-boot">
5 <title>Target Specific Instructions</title>
6
7 <para>If the source has been fetched (<xref
8 linkend="relinfo-getting-source" />), there will be a target specific README
9 file containing the build and boot instructions. To make it easier for the
10 reader, the contents of this file(s) have been extracted into the following
11 sections.</para>
12
13 <note>
14 <para>The build process duration may vary and be longer than expected in
15 some cases, depending on the individual build resources and parameters of
16 each target/machine supported in this release.</para>
17 </note>
18
19 <para><remark>NOTE: Only EDIT THE TEMPLATE build_boot_template.xml file here
20 and also only edit the manifest template ".README" (name starting by a dot)!
21 A new build_boot_generated.xml file is created from the template and
22 sections are added below automatically from the README files for each target
23 when building the book! Only in the template file you see a line below with
24 SCRIPT_...._HERE and the text telling that this is a template
25 file.</remark></para>
26
27 <para>SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</para>
28
29 <para><emphasis role="bold">This is a template file which you can edit. When
30 the book is built, a new XML chapter file is created where the above part of
31 this file is copied to the new XML file and all from the line above is
32 replaced automatically by build and boot sections from the README
33 files!</emphasis></para>
34</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/eltf_params_template.xml b/doc/book-enea-linux-release-info/doc/eltf_params_template.xml
new file mode 100644
index 0000000..278ad71
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/eltf_params_template.xml
@@ -0,0 +1,151 @@
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 Linux 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 Linux 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-linux-release-info/doc/eltf_params_updated.xml b/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml
new file mode 100644
index 0000000..dfcee4a
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/eltf_params_updated.xml
@@ -0,0 +1,282 @@
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.2 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>8</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.5</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>sumo</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="http://linux.enea.com/EneaLinux7.0">http://linux.enea.com/EneaLinux8.0</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-rt.git \
64 -b refs/tags/Enea_Linux_8.0 -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.</bridgehead>
70
71 <informaltable>
72 <tgroup cols="1">
73 <tbody>
74 <row id="eltf-eclipse-version-row">
75 <entry>Eclipse version 4.7 (Oxygen) plus command line development
76 tools are included in this Enea Linux release.</entry>
77 </row>
78 </tbody>
79 </tgroup>
80 </informaltable>
81
82 <bridgehead>Below is one big section with title "Supported Targets with
83 Parameters". The entire section is included completely in the book via ID
84 "eltf-target-tables-section" and shall be LAST in the template. The
85 template contains ONE target subsection. COPY/APPEND it, if multiple
86 targets exist in the release and optionally add rows with additional
87 target parameters in each target subsection table.</bridgehead>
88 </section>
89
90 <section id="eltf-target-tables-section">
91 <title>Supported Reference Boards with Parameters</title>
92
93 <para>The table(s) below describes the target(s) supported in this Enea
94 Linux release.</para>
95
96 <table>
97 <title>MACHINE Information Intel Xeon D</title>
98
99 <tgroup cols="2">
100 <colspec align="center" />
101
102 <thead>
103 <row>
104 <entry align="center">Component</entry>
105
106 <entry align="center">Description</entry>
107 </row>
108 </thead>
109
110 <tbody>
111 <row>
112 <entry align="left">Target official name</entry>
113
114 <entry>Intel Xeon D</entry>
115 </row>
116
117 <row>
118 <entry align="left">Architecture and Description</entry>
119
120 <entry>x86-64</entry>
121 </row>
122
123 <row>
124 <entry align="left">Link to target datasheet</entry>
125
126 <entry><ulink
127 url="https://www.intel.com/content/www/us/en/processors/xeon/xeon-d-1500-datasheet-vol-1.html">Intel
128 Xeon D datasheet</ulink></entry>
129 </row>
130
131 <row>
132 <entry align="left">Poky version</entry>
133
134 <entry>Git-commit-id: TBD</entry>
135 </row>
136
137 <row>
138 <entry align="left">GCC version</entry>
139
140 <entry>7.3</entry>
141 </row>
142
143 <row>
144 <entry align="left">Linux Kernel Version</entry>
145
146 <entry>4.14</entry>
147 </row>
148
149 <row condition="hidden">
150 <entry align="left">Supported Drivers</entry>
151
152 <entry>Ethernet, RTC, UART</entry>
153 </row>
154 </tbody>
155 </tgroup>
156 </table>
157
158 <table>
159 <title>MACHINE Information Intel Atom C3000</title>
160
161 <tgroup cols="2">
162 <colspec align="center" />
163
164 <thead>
165 <row>
166 <entry align="center">Component</entry>
167
168 <entry align="center">Description</entry>
169 </row>
170 </thead>
171
172 <tbody>
173 <row>
174 <entry align="left">Target official name</entry>
175
176 <entry>Intel Atom C3000</entry>
177 </row>
178
179 <row>
180 <entry align="left">Architecture and Description</entry>
181
182 <entry>x86-64</entry>
183 </row>
184
185 <row>
186 <entry align="left">Link to target datasheet</entry>
187
188 <entry><ulink
189 url="https://www.intel.com/content/www/us/en/products/docs/processors/atom/c-series/c3000-family-datasheet.html">Intel
190 Atom datasheet</ulink></entry>
191 </row>
192
193 <row>
194 <entry align="left">Poky version</entry>
195
196 <entry>Git-commit-id: TBD</entry>
197 </row>
198
199 <row>
200 <entry align="left">GCC version</entry>
201
202 <entry>7.3</entry>
203 </row>
204
205 <row>
206 <entry align="left">Linux Kernel Version</entry>
207
208 <entry>4.14</entry>
209 </row>
210
211 <row condition="hidden">
212 <entry align="left">Supported Drivers</entry>
213
214 <entry>Ethernet, RTC, UART</entry>
215 </row>
216 </tbody>
217 </tgroup>
218 </table>
219
220 <table>
221 <title>MACHINE Information Intel NUC Kaby Lake</title>
222
223 <tgroup cols="2">
224 <colspec align="center" />
225
226 <thead>
227 <row>
228 <entry align="center">Component</entry>
229
230 <entry align="center">Description</entry>
231 </row>
232 </thead>
233
234 <tbody>
235 <row>
236 <entry align="left">Target official name</entry>
237
238 <entry>Intel NUC Kaby Lake</entry>
239 </row>
240
241 <row>
242 <entry align="left">Architecture and Description</entry>
243
244 <entry>x86-64</entry>
245 </row>
246
247 <row>
248 <entry align="left">Link to target datasheet</entry>
249
250 <entry><ulink
251 url="https://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/nuc-kit-nuc7i5bnh-nuc7i5bnk-brief.pdf">Intel
252 NUC Kaby Lake datasheet</ulink></entry>
253 </row>
254
255 <row>
256 <entry align="left">Poky version</entry>
257
258 <entry>Git-commit-id: TBD</entry>
259 </row>
260
261 <row>
262 <entry align="left">GCC version</entry>
263
264 <entry>7.3</entry>
265 </row>
266
267 <row>
268 <entry align="left">Linux Kernel Version</entry>
269
270 <entry>4.14</entry>
271 </row>
272
273 <row condition="hidden">
274 <entry align="left">Supported Drivers</entry>
275
276 <entry>Ethernet, RTC, UART</entry>
277 </row>
278 </tbody>
279 </tgroup>
280 </table>
281 </section>
282</section>
diff --git a/doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt b/doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt
new file mode 100644
index 0000000..6e1358f
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/eltf_params_updated_template_how_to_use.txt
@@ -0,0 +1,320 @@
1eltf_params_template_updated_howto_use.txt
2
3This is a way to collect all parameters for an Enea Linux 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.5
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:
168sumo
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
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 Linux 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/8
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-rt.git \
200 -b refs/tags/EL8 -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-linux-release-info/doc/getting_enea_linux.xml b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
new file mode 100644
index 0000000..76487ef
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/getting_enea_linux.xml
@@ -0,0 +1,185 @@
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="relinfo-getting-enea-linux">
5 <title>Getting Enea Linux</title>
6
7 <para>Enea Linux is available as both pre-built binary images and source
8 code. Both serve a specific purpose and each have their advantages. However,
9 using the pre-built binary images allows for getting up and running faster.
10 Please refer to the sections below for details on how to get Enea Linux as
11 pre-built binary images or source code.</para>
12
13 <section id="relinfo-getting-pre-built-images">
14 <title>Getting Pre-built Binaries</title>
15
16 <para>Enea Linux pre-built binaries are available for download on <ulink
17 url="https://portal.enea.com/login/?redirect_to=https%3A%2F%2Fportal.enea.com%2F">portal.enea.com</ulink>.
18 Log in using the credentials provided by Enea for your user account. Using
19 the menu, browse to the Linux section where you will now have access to
20 the <emphasis role="bold">Files</emphasis> and <emphasis
21 role="bold">Online Documentation</emphasis> sections.</para>
22
23 <para>The Files section lists each Enea Linux distribution, one for each
24 version and profile, as a separate download package. Clicking on the name
25 of the distribution will open a new page, which presents further details
26 about the content of the release and a list of downloadable archives, one
27 for each hardware target included in the release. Each archive provides
28 the following content:</para>
29
30 <itemizedlist>
31 <listitem>
32 <para><emphasis>images</emphasis> directory &ndash; this directory
33 includes the binary image files needed to boot the target with Enea
34 Linux. This includes the kernel, the root file system, device tree,
35 etc.</para>
36 </listitem>
37
38 <listitem>
39 <para><emphasis>sdk</emphasis> directory &ndash; this directory
40 includes the installer for the SDK.</para>
41 </listitem>
42
43 <listitem>
44 <para><emphasis>deb</emphasis> directory &ndash; this directory
45 contains all the packages included in the distribution in deb format,
46 which can be installed using the package manager.</para>
47 </listitem>
48 </itemizedlist>
49
50 <para>For faster downloads, each archive is mirrored in several places,
51 geographically. Choose the archive in the region closest to you.</para>
52
53 <para>The Documentation section lists all the documents delivered with the
54 release:</para>
55
56 <itemizedlist>
57 <listitem>
58 <para><emphasis role="bold">Enea Linux User&rsquo;s Guide</emphasis> -
59 intended for Enea Linux platform developers, who want to configure and
60 build customized Linux kernel images for embedded system targets,
61 using the Yocto configuration and build system.</para>
62 </listitem>
63
64 <listitem>
65 <para><emphasis role="bold">Enea Linux Open Source Report</emphasis> -
66 contains the open source and license information pertaining to
67 packages provided with this release of Enea Linux.</para>
68 </listitem>
69
70 <listitem>
71 <para><emphasis role="bold">Enea Linux Release Info</emphasis> -
72 provides information about the current released distribution for a
73 selected set of targets, along with installation requirements and
74 procedures.</para>
75 </listitem>
76 </itemizedlist>
77 </section>
78
79 <section id="relinfo-getting-source">
80 <title>Getting the Sources</title>
81
82 <para>Enea Linux sources are available for cloning from a set of Git
83 repositories on <ulink url="https://git.enea.com">git.enea.com</ulink>.
84 Since Enea Linux requires multiple repositories, Google Repo tool is used
85 in order to manage configurations and make the cloning step simpler. The
86 Google Repo tool uses files, known as manifests, which store a list of
87 tuples (repository URL, version). The Repo tool is then used to traverse
88 the list of tuples in the manifest file and clone the specified versions
89 of each repository. See <ulink
90 url="https://code.google.com/p/git-repo/">Google Code Archive for
91 git-repo</ulink>, for more info.</para>
92
93 <section id="getting-source-code-step-one">
94 <title>Get access to git.enea.com</title>
95
96 <para>In order to get access to git.enea.com, a ssh key is required for
97 Git authentication. If you don't already have such a key, follow the
98 steps below to generate one:</para>
99
100 <orderedlist>
101 <listitem>
102 <para>Generate the ssh key pair:</para>
103
104 <programlisting>$ ssh-keygen -t rsa</programlisting>
105
106 <para>When asked for a password, just press
107 <command>Enter</command>. This will create two files in the
108 <literal>.ssh</literal> directory in your home directory.</para>
109
110 <programlisting>id_rsa
111id_rsa.pub</programlisting>
112 </listitem>
113
114 <listitem>
115 <para>Copy the public key into an authorized_keys file:</para>
116
117 <programlisting>$ cat id_rsa.pub &gt;&gt; authorized_keys</programlisting>
118 </listitem>
119 </orderedlist>
120
121 <para>Once these steps are done and you have a valid ssh key pair, send
122 the public key,
123 <emphasis><emphasis><filename>id_rsa.pub</filename></emphasis></emphasis>,
124 via email to <email>mailto:git_support@list.enea.se</email> in order to
125 get access to <ulink
126 url="https://git.enea.com">git.enea.com</ulink>.</para>
127 </section>
128
129 <section id="getting-source-code-step-two">
130 <title>Get Sources</title>
131
132 <para>To use the Repo tool to download the sources for Enea Linux, do
133 the following:</para>
134
135 <orderedlist>
136 <listitem condition="hidden">
137 <para>Make sure that the repo tool is installed. If not, do the
138 following: <remark>Below is include of ID
139 "eltf-getting-repo-install-command" from
140 eltf_params_updated.xml</remark></para>
141
142 <xi:include href="eltf_params_updated.xml"
143 xmlns:xi="http://www.w3.org/2001/XInclude"
144 xpointer="element(eltf-getting-repo-install-command/1)" />
145 </listitem>
146
147 <listitem>
148 <para>Define the MACHINE to the following target listed
149 here:<remark>Below is the "machine_list" programlisting in
150 machine_list_generated.xml created by the make system by extracting
151 from the manifest</remark></para>
152
153 <xi:include href="machine_list_generated.xml"
154 xmlns:xi="http://www.w3.org/2001/XInclude"
155 xpointer="element(machine-list/1)" />
156 </listitem>
157
158 <listitem>
159 <para>Then use the repo command below:</para>
160
161 <xi:include href="eltf_params_updated.xml"
162 xmlns:xi="http://www.w3.org/2001/XInclude"
163 xpointer="element(eltf-repo-cloning-enea-linux/1)" />
164 </listitem>
165 </orderedlist>
166
167 <para>Once the source code is downloaded, the current directory will
168 contain a README file with instructions on how to build the distro and
169 boot the raspberry pi machine. For ease of use, these instructions are
170 also copied into this document, see <xref
171 linkend="relinfo-build-boot" />.</para>
172
173 <para>It is not necessary to explicitly clone the manifest repository
174 since that is done automatically by the repo tool. To see the current
175 manifest, use the following command:</para>
176
177 <programlisting>$ repo manifest</programlisting>
178
179 <remark>The UG should be updated with instructions on how to add
180 customizations. That section should also contain more info about the
181 manifest: the manifest templates, using a branch instead of the tag EL6,
182 etc. When this is done a reference from here should be added.</remark>
183 </section>
184 </section>
185</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/jiraissues_override.xml b/doc/book-enea-linux-release-info/doc/jiraissues_override.xml
new file mode 100644
index 0000000..331a5ae
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/jiraissues_override.xml
@@ -0,0 +1,32 @@
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="relinfo_extracted_from_jira">
5 <title>Extracted from Jira</title>
6
7 <para>In the table below are the issue(s) that currently affect this specific release. Use the ticket reference provided for each issue, to look up further information if needed.</para>
8
9 <informaltable>
10 <tgroup cols="2">
11 <colspec colname="c1" colwidth="6*" />
12
13 <colspec align="center" colname="c2" colwidth="1*" />
14
15 <thead>
16 <row>
17 <entry align="center">Summary</entry>
18
19 <entry>Enea Ref</entry>
20 </row>
21 </thead>
22
23 <tbody>
24 <row>
25 <entry></entry>
26
27 <entry></entry>
28 </row>
29 </tbody>
30 </tgroup>
31 </informaltable>
32</section> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml b/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
new file mode 100644
index 0000000..6fafb8d
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/known_bugs_and_limitations.xml
@@ -0,0 +1,377 @@
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="bugs-limitations">
5 <title>Known Problems in this Release</title>
6
7 <para>Open source projects are continuously working on correcting reported
8 problems. Fixes and workarounds to bugs detected by Enea are submitted
9 upstream, and included in Enea Linux regardless of when they will be
10 included by the open source project. Issues that still affect the current
11 release are listed below.<remark>INFO: The <emphasis
12 role="bold">Release-Specific Problems</emphasis> section further down is
13 generated from JIRA with gen_known_issues.py, but that script is HARDCODED
14 with affectedversion "Enea Linux 6" and needs to be adapted when a release
15 info for another EL version changes.</remark></para>
16
17 <section id="bugs-limitations-yocto">
18 <title>Yocto Project</title>
19
20 <para>The Yocto Project community uses a <ulink
21 url="https://bugzilla.yoctoproject.org">Bugzilla database</ulink> to track
22 information on reported bugs and other issues.</para>
23 </section>
24
25 <section condition="hidden" id="bugs-limitations-sdk">
26 <title>Toolchain / SDK</title>
27
28 <itemizedlist spacing="compact">
29 <listitem>
30 <para>Building the kernel might fail if GNU Make of version 3.82 has
31 been installed on the host. The mandatory recovery action is to revert
32 to version 3.81.<remark>INFO It is possible to hide this entire
33 subsection by setting condition hidden on the section
34 element</remark></para>
35 </listitem>
36
37 <listitem>
38 <para>Installing a second toolchain in the same directory as a
39 previous one will break the $PATH variable of the first
40 one.<remark>LXCR-3624</remark></para>
41 </listitem>
42 </itemizedlist>
43 </section>
44
45 <section condition="hidden" id="bugs-limitations-eclipse">
46 <title>Eclipse Tools</title>
47
48 <para>The Eclipse tools provided together with Enea Linux are part of the
49 Yocto Project Application Development Toolkit (ADT) and are maintained by
50 different open source projects. The list below outlines current problems
51 with the plug-ins as such, as well as kernel limitations when using a tool
52 towards the mentioned target:<remark>INFO It is possible to hide this
53 setting condition hidden on the section element</remark></para>
54
55 <itemizedlist spacing="compact">
56 <listitem>
57 <para><emphasis role="bold">HOB</emphasis> is currently not supported
58 on Red Hat.<remark>LXCR-2994, LXCR-3222</remark></para>
59 </listitem>
60
61 <listitem>
62 <para><emphasis role="bold">SystemTap</emphasis> is currently not
63 supported on Red Hat.<remark>LXCR-3274</remark></para>
64 </listitem>
65
66 <listitem>
67 <para>When running <emphasis role="bold">SystemTap</emphasis> for the
68 first time on a target, you may need to manually ssh into the target
69 beforehand, in order to add the RSA key of the host to the file
70 known_hosts. Failing to do so will result in Eclipse freezing with the
71 progress window displayed, and a terminal message <literal>The
72 authenticity of host &lt;target_ip&gt; can't be
73 established</literal>.</para>
74 </listitem>
75
76 <listitem>
77 <para><emphasis role="bold">SystemTap</emphasis> scripts sometimes
78 result crosstap error messages about inaccessible variables. This is
79 not an issue with the tool itself, but stems from the compiler
80 optimizing away some of the variables. See workaround in the User's
81 Guide.<remark>LXCR-2204</remark></para>
82 </listitem>
83
84 <listitem>
85 <para>Currently <emphasis role="bold">BitBake Commander</emphasis>
86 projects can only be created for a local connection. Due to an
87 upstream bug, selecting a remote connection causes the Eclipse GUI to
88 freeze such that it must be killed.<remark>LXCR-2801</remark></para>
89 </listitem>
90
91 <listitem>
92 <para>A limitation currently makes <emphasis
93 role="bold">Eclipse</emphasis> non-responding when running a streaming
94 script, i.e. a script that runs continuously.</para>
95 </listitem>
96
97 <listitem>
98 <para>The <emphasis role="bold">LatencyTop</emphasis> plug-in for the
99 P2041 target reports some errors due to the permissions configuration
100 on the target, but it works correctly if the
101 <literal>latencytop</literal> command is issued from the Eclipse
102 console.<remark>LXCR-6303</remark></para>
103 </listitem>
104
105 <listitem>
106 <para>Currently <emphasis role="bold">LatencyTOP</emphasis> is not
107 available for ARM kernels built with SMP support due to an ARM
108 specific limitation in the Linux kernel.</para>
109 </listitem>
110
111 <listitem>
112 <para><emphasis role="bold">PowerTOP</emphasis> sometimes freezes
113 Eclipse after displaying a progress bar with message
114 <literal>Gathering powertop data file
115 remotely</literal>.<remark>LXCR-3143</remark></para>
116 </listitem>
117
118 <listitem>
119 <para>When running <emphasis role="bold">powertop</emphasis> from the
120 Eclipse terminal towards p2020rdb targets it is necessary to specify
121 the full path in order to find the
122 command.<remark>LXCR-2265</remark></para>
123 </listitem>
124
125 <listitem>
126 <para>When running <emphasis role="bold">powertop</emphasis> from the
127 Eclipse terminal towards zynq ZC702 targets it is necessary to specify
128 the full path in order to find the
129 command.<remark>LXCR-2265</remark></para>
130 </listitem>
131
132 <listitem>
133 <para>The <emphasis role="bold">PowerTOP</emphasis> console in Eclipse
134 might display messages like <literal>Cannot load
135 /var/cache/powertop/&lt;filename&gt;</literal>. As a workaround, run
136 <emphasis role="bold">powertop --calibrate</emphasis> for a while to
137 generate the missing files. See <ulink
138 url="https://bugzilla.redhat.com/show_bug.cgi?id=698020">Bugzilla
139 #698020</ulink>.<remark>LXCR-3575</remark></para>
140 </listitem>
141
142 <listitem>
143 <para><emphasis role="bold">ssh-only</emphasis> is currently the only
144 supported connection type when running Eclipse tools towards a
145 target.<remark>LXCR-2799</remark></para>
146 </listitem>
147
148 <listitem>
149 <para>Hyphen character '-' in the name of the <emphasis
150 role="bold">Yocto Project ADT AutoTools project</emphasis> can cause
151 configuration errors.<remark>LXCR-2290</remark></para>
152 </listitem>
153
154 <listitem>
155 <para>The <emphasis role="bold">LTTng</emphasis> tool does not work on
156 <emphasis role="bold">ARM</emphasis> targets, neither from within
157 Eclipse nor when run directly on target, due to a problem with
158 lttng-modules and gcc-4.8.x. See <ulink
159 url="https://bugzilla.yoctoproject.org/show_bug.cgi?id=6015">Bugzilla
160 #6015</ulink>.<remark>LXCR-2653, LXCR-3053</remark></para>
161 </listitem>
162
163 <listitem>
164 <para>When running <emphasis role="bold">LTTng</emphasis> from
165 Eclipse, it sometimes happens that a new session created in the
166 Control View does not immediately appear under Sessions for that
167 target. However, the session is created and will appear after
168 right-clicking "Sessions" and selecting "Refresh".</para>
169 </listitem>
170
171 <listitem>
172 <para>The<emphasis role="bold"> yocto-bsp</emphasis> properties page
173 has some problems in the graphical user interface. Occasionally it is
174 not possible to resize and scroll which makes it impossible to see the
175 lower part of the properties window.<remark>LXCR-3128</remark></para>
176 </listitem>
177
178 <listitem>
179 <para>When connecting an Eclipse project configured for <emphasis
180 role="bold">KGDB</emphasis> (GDB Hardware Debugging) to a 64-bit
181 PowerPC target, GDB fails to connect unless the architecture is
182 specified in <filename>.gdbinit</filename>. See <ulink
183 url="https://bugs.eclipse.org/bugs/show_bug.cgi?id=457697">Bugzilla
184 #457697</ulink>.<remark>LXCR-3984</remark></para>
185 </listitem>
186 </itemizedlist>
187 </section>
188
189 <section condition="hidden" id="bugs-limitations-target-side-tools">
190 <title>Target-Side Tools</title>
191
192 <para>The target-side tools can be run stand-alone on target or from
193 Eclipse on host. The issues below are only observed when running the tools
194 directly on target:<remark>INFO It is possible to hide this setting
195 condition hidden on the section element</remark></para>
196
197 <itemizedlist spacing="compact">
198 <listitem>
199 <para>The <emphasis role="bold">perf report</emphasis> command hangs
200 or crashes due to segmentation fault on ARM
201 targets.<remark>LXCR-2708</remark></para>
202 </listitem>
203
204 <listitem>
205 <para>The <emphasis role="bold">perf report</emphasis> does not show
206 any output for the PandaBoard target.<remark>LXCR-2710</remark></para>
207 </listitem>
208
209 <listitem>
210 <para><emphasis role="bold">perf top</emphasis> displays for a few
211 seconds the error message <literal>Failed to open
212 /tmp/perf-388.map</literal>. Any attempt to exit the subsequent window
213 causes the system to hang.<remark>LXCR-3113</remark></para>
214 </listitem>
215
216 <listitem>
217 <para>When running the <command>perf top</command> command on the i.MX
218 6Quad SABRE Lite target, the console text may become red after running
219 for some time (~ 1 minute).<remark>LXCR-3631</remark></para>
220 </listitem>
221
222 <listitem>
223 <para>The <emphasis role="bold">LTTng</emphasis> tool does not work on
224 <emphasis role="bold">ARM</emphasis> targets, neither from within
225 Eclipse nor when run directly on target, due to a problem with
226 lttng-modules and gcc-4.8.x. See <ulink
227 url="https://bugzilla.yoctoproject.org/show_bug.cgi?id=6015">Bugzilla
228 #6015</ulink>.<remark>LXCR-2653, LXCR-3053</remark></para>
229 </listitem>
230
231 <listitem>
232 <para>The <emphasis role="bold">powertop --calibrate</emphasis>
233 command does not work on the Keystone k2hk-evm
234 target.<remark>LXCR-2660</remark></para>
235 </listitem>
236
237 <listitem>
238 <para>The <emphasis role="bold">powertop</emphasis> command run with
239 <emphasis role="bold">--calibrate</emphasis> or -<emphasis
240 role="bold">-time</emphasis> arguments may show some warnings on
241 PowerPC targets.</para>
242 </listitem>
243
244 <listitem>
245 <para>When running <emphasis role="bold">powertop</emphasis> on
246 <emphasis role="bold">ARM</emphasis> targets, the following
247 warning/error is repeated: <literal>clk_set_rate: failed to set
248 i2c0_aper rate</literal> . Then powertop stops and the statistics are
249 no longer updated. What probably happens here is that the cpufreq
250 governor tries to scale the CPU frequency, but since the I2C clock is
251 derived from the CPU frequency, the I2C driver implements some policy
252 to stay within legal frequency limits and rejects the frequency
253 changes, ending up with the warning message. A <ulink
254 url="https://github.com/Xilinx/linux-xlnx/commit/0fdd34575efae5c8eced09b6b0a1b723bff4d225">fix</ulink>
255 has been merged in the linux-xlnx kernel but is not yet propagated
256 into meta-xilinx.<remark>LXCR-3205, LXCR-3106,
257 LXCR-2660</remark></para>
258 </listitem>
259
260 <listitem>
261 <para>If you get an error message like <literal>Cannot load from file
262 /var/cache/powertop/saved_results.powertop</literal> when running
263 <emphasis role="bold">powertop</emphasis>, there is most likely not
264 enough measurement data collected yet. All you have to do is to keep
265 powertop running for a certain time.<remark>LXCR-2176, LXCR-2660,
266 LXCR-3106</remark></para>
267 </listitem>
268
269 <listitem>
270 <para>The message <literal>Model-specific registers (MSR) not found
271 (try enabling CONFIG_X86_MSR)</literal> appears when you run <emphasis
272 role="bold">powertop</emphasis> on <emphasis
273 role="bold">non-x86</emphasis> targets. powertop is mainly an x86n
274 tool, so it expects X*^_MSR config to be enabled in the kernel. For
275 non-x86 targets this config is not available in the kernel, hence,
276 powertop warns about it, but the message can be ignored on those
277 targets.<remark> LXCR-2176, LXCR-2660, LXCR-3106</remark></para>
278 </listitem>
279
280 <listitem>
281 <para><emphasis role="bold">powertop</emphasis> issues a message
282 <literal>sh: /usr/bin/xset: No such file or directory</literal> when
283 it tries to use xset to configure X display preferences but cannot
284 find the binary since the image by default contains no X system. The
285 message can simply be ignored.<remark>LXCR-2176</remark></para>
286 </listitem>
287 </itemizedlist>
288 </section>
289
290 <section condition="hidden" id="bugs-limitations-virtualization">
291 <title>Virtualization</title>
292
293 <itemizedlist spacing="compact">
294 <listitem>
295 <para><emphasis role="bold">virtualization</emphasis>: CONFIG_BRIDGE
296 is not included in the default p2020rdb
297 kernel.<remark>LXVTCR-273</remark></para>
298 </listitem>
299
300 <listitem>
301 <para><emphasis role="bold">lxc</emphasis>:</para>
302
303 <itemizedlist spacing="compact">
304 <listitem>
305 <para>User namespace is not available on PowerPC targets as it is
306 an experimental feature in the 3.8 kernel.</para>
307 </listitem>
308
309 <listitem>
310 <para>If multiple Linux containers are started from the same
311 process and share resources, destroying the containers might
312 result in a race condition with error message "Error in
313 `./lxc-test-concurrent': double free or corruption (fasttop)"
314 followed by an application
315 crash."<remark>LXVTCR-365</remark></para>
316 </listitem>
317 </itemizedlist>
318 </listitem>
319
320 <listitem>
321 <para><emphasis role="bold">libvirt</emphasis>: Default network does
322 not start.<remark>LXVTCR-240</remark></para>
323 </listitem>
324 </itemizedlist>
325 </section>
326
327 <section condition="hidden" id="bugs-limitations-doc">
328 <title>Documentation</title>
329
330 <itemizedlist spacing="compact">
331 <listitem>
332 <para><emphasis role="bold">PDF navigation</emphasis>: When using
333 links to open other PDFs, or jump to another place in the same PDF,
334 jumping back sometimes fails. This has been observed when opening a
335 PDF in Adobe Reader, inside a browser with PDF add-on, as well as when
336 the browser is configured to open PDF files in an external PDF reader.
337 As a workaround, open the HTML version of the
338 document.<remark>LXCR-3283</remark></para>
339 </listitem>
340
341 <listitem>
342 <para><emphasis role="bold">Internet Explorer (IE) cannot display some
343 web pages</emphasis>: It is recommended to use Firefox or another
344 non-IE browser for opening external links. If you prefer reading the
345 documentation in PDF format in Adobe Reader (not in an Adobe plug-in
346 in a browser), remember to configure a non-IE browser as default
347 browser to be able to follow all links from within Adobe Reader.
348 Example of a link that does not work in IE: <ulink
349 url="https://rt.wiki.kernel.org/">https://rt.wiki.kernel.org/</ulink>.
350 <remark>LXCR-3281</remark></para>
351 </listitem>
352 </itemizedlist>
353 </section>
354
355 <section condition="hidden" id="bugs-limitations-other">
356 <title>Miscellaneous</title>
357
358 <itemizedlist spacing="compact">
359 <listitem>
360 <para>Running <emphasis role="bold">QEMU from an exported
361 rootfs</emphasis> requires sudo privileges on the host.</para>
362 </listitem>
363
364 <listitem>
365 <para><emphasis role="bold">menuconfig</emphasis> requires <emphasis
366 role="bold">Ncurses</emphasis>. If the terminal that pops up
367 immediately closes instead of showing the menuconfig interface, check
368 that the Ncurses development library is installed.</para>
369 </listitem>
370 </itemizedlist>
371 </section>
372
373 <!-- The file with a section below is autocreated by make init -->
374
375 <!-- <xi:include href="jiraissues_generated.xml"
376 xmlns:xi="http://www.w3.org/2001/XInclude" /> -->
377</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/main_changes.xml b/doc/book-enea-linux-release-info/doc/main_changes.xml
new file mode 100644
index 0000000..c2279ee
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/main_changes.xml
@@ -0,0 +1,54 @@
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="relinfo-changes">
5 <title>Main Changes</title>
6
7 <para>This chapter describes the major changes and additions made to this
8 release of Enea Linux.<remark>INFO Just now Hardcoded previous release
9 string in this paragraph.</remark><remark>The list of changed packages
10 further down is created from the open source book licenses.xml by the script
11 gen_pkgdiff.py by comparing with an older open source licenses.xml,
12 depending on the parameter "prev_baseline" in pardoc-distro.xml, e.g. a tag
13 like "EL5". This parameter needs to be changed to a new TAG when a release
14 info for another EL version is created. It must correspond to the release
15 string above.</remark></para>
16
17 <section id="relinfo-changes-other">
18 <title>New Functionality/Enhancements</title>
19
20 <itemizedlist spacing="compact">
21 <listitem>
22 <para><ulink
23 url="http://www.yoctoproject.org/downloads">New Yocto
24 Project version</ulink> (<xi:include href="eltf_params_updated.xml"
25 xmlns:xi="http://www.w3.org/2001/XInclude"
26 xpointer="element(Yocto_VER/1)" />)<remark>INFO Yocto_VER and
27 ULINK_YOCTO_PROJECT_DOWNLOAD in
28 eltf_params_updated.xml</remark></para>
29 </listitem>
30
31 <listitem>
32 <para>New targets: Intel Xeon D, Intel Atom C3000 and Intel NUC Kaby
33 Lake.</para>
34 </listitem>
35 </itemizedlist>
36 </section>
37
38 <section condition="hidden" id="relinfo-fixed">
39 <title>Problems Fixed in this Release</title>
40
41 <para>TBD <remark>FIXME or set condition hidden on the section
42 element</remark></para>
43 </section>
44
45 <section condition="hidden" id="relinfo-added-drivers">
46 <title>Added Drivers</title>
47
48 <para>TBD <remark>FIXME or set condition hidden on the section
49 element</remark></para>
50 </section>
51
52 <xi:include href="pkgdiff_generated.xml"
53 xmlns:xi="http://www.w3.org/2001/XInclude" />
54</chapter>
diff --git a/doc/book-enea-linux-release-info/doc/prerequisites.xml b/doc/book-enea-linux-release-info/doc/prerequisites.xml
new file mode 100644
index 0000000..324bb57
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/prerequisites.xml
@@ -0,0 +1,34 @@
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="prerequisites">
5 <title>Prerequisites</title>
6
7 <para>Building Enea Linux or compiling applications requires that your git
8 environment be setup properly and for certain packages to be installed on
9 your Linux development host.</para>
10
11 <para>Please refer to <ulink
12 url="https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup">Getting
13 Started - First-Time Git Setup</ulink>, for more details on how to set up
14 your git environment correctly, including how to set your identity using the
15 following commands:</para>
16
17 <programlisting>$ git config --global user.name "John Doe"
18$ git config --global user.email johndoe@example.com</programlisting>
19
20 <para>First ensure the system is up-to-date, then for the supported
21 distribution(s), you need the following packages:<remark>INFO: The
22 programlisting below is a parameters in eltf_params_updated.xml with ID:
23 "eltf-prereq-apt-get-command-host". If multiple hosts are supported, store
24 the commands for each host in the same programlisting with empty lines
25 between each - the comment with the FULL HOST name and version is
26 essential.</remark></para>
27
28 <xi:include href="eltf_params_updated.xml"
29 xmlns:xi="http://www.w3.org/2001/XInclude"
30 xpointer="element(eltf-prereq-apt-get-commands-host/1)" />
31
32 <xi:include href="../../s_doceneacommon/doc/system_requirements.xml"
33 xmlns:xi="http://www.w3.org/2001/XInclude" />
34</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/doc/system_requirements.xml b/doc/book-enea-linux-release-info/doc/system_requirements.xml
new file mode 100644
index 0000000..cc1248e
--- /dev/null
+++ b/doc/book-enea-linux-release-info/doc/system_requirements.xml
@@ -0,0 +1,159 @@
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="enea-linux-sysreq">
5 <title>System Requirements</title>
6
7 <para>The host requirements listed below are extensive to allow for the
8 building of Linux images via the Yocto system, and not just
9 applications.</para>
10
11 <para>Please also see the system requirements in the Yocto 2.3 documents:
12 <ulink
13 url="http://www.yoctoproject.org/docs/2.3/yocto-project-qs/yocto-project-qs.html#yp-resources">Yocto
14 Project Start</ulink> and the <ulink
15 url="http://www.yoctoproject.org/docs/2.3/ref-manual/ref-manual.html#intro-requirements">Yocto
16 Project Reference Manual</ulink>. If needed, replace the Yocto version in
17 the links provided with a more recent version.</para>
18
19 <informaltable>
20 <tgroup cols="2">
21 <colspec align="left" colname="1" colwidth="1*" />
22
23 <colspec align="left" colname="2" colwidth="3*" />
24
25 <spanspec nameend="2" namest="1" spanname="onetwo" />
26
27 <tbody>
28 <row>
29 <entry spanname="onetwo"><emphasis role="bold"> Build host
30 requirements<indexterm>
31 <primary>system requirements</primary>
32 </indexterm></emphasis></entry>
33 </row>
34
35 <row>
36 <entry>Linux distribution</entry>
37
38 <entry>The downloaded code shall be built on a Linux host to
39 generate images for your target or for emulation in QEMU. For
40 information about the supported hosts and targets, see the <emphasis
41 role="bold">Enea Linux Release Information</emphasis> in your Enea
42 Linux distribution.</entry>
43 </row>
44
45 <row>
46 <entry>Internet access</entry>
47
48 <entry>Internet access must be available when building an image,
49 since bitbake downloads source files from various servers during the
50 build.</entry>
51 </row>
52
53 <row>
54 <entry>Packages</entry>
55
56 <entry>Depending on the Linux distribution and version on host, some
57 packages may be required, by bitbake for example. You will install
58 any required packages while following the installation
59 instructions.</entry>
60 </row>
61
62 <row>
63 <entry>Targets</entry>
64
65 <entry>Images can be built or downloaded for any of the targets
66 supported in this release.</entry>
67 </row>
68
69 <row>
70 <entry>Disk space</entry>
71
72 <entry><para>Your system should have at least 50 GB of free disk
73 space when bitbaking the basic enea-image-name kernel image.</para>
74 <para>For larger images and to allow for future package extensions
75 and variations in the build process, a minimum of 100 GB free disk
76 space is recommended.</para></entry>
77 </row>
78
79 <row>
80 <entry>Recommended RAM</entry>
81
82 <entry><para>Your system must have at least 4 GB available
83 RAM.</para> <para>It is recommended to have 8 GB RAM available for
84 parallel build jobs.</para></entry>
85 </row>
86
87 <row>
88 <entry>Java</entry>
89
90 <entry>Java <indexterm>
91 <primary>java</primary>
92 </indexterm>is required to run Eclipse. Currently, Eclipse
93 generally recommends at least Java 6 JRE/JDK. More information
94 regarding operating environments for Eclipse is provided in the
95 <ulink
96 url="http://www.eclipse.org/eclipse/development/readme_eclipse_version">Eclipse
97 Project Release Notes</ulink> for the Eclipse version used in this
98 release. See the <emphasis role="bold">Enea Linux Release
99 Information </emphasis>for the Eclipse Version.</entry>
100 </row>
101 </tbody>
102 </tgroup>
103 </informaltable>
104
105 <para>The build time depends on the capacity of the processor and other
106 hardware, available resources, speed of internet connection, load situation,
107 etc. E.g: on a fast 16 core machine with 16 GB RAM and SSD disks, a complete
108 build from source could take about two hours.</para>
109
110 <informaltable>
111 <tgroup cols="2">
112 <colspec align="left" colname="1" colwidth="1*" />
113
114 <colspec align="left" colname="2" colwidth="3*" />
115
116 <spanspec nameend="2" namest="1" spanname="onetwo" />
117
118 <tbody>
119 <row>
120 <entry spanname="onetwo"><emphasis role="bold">Target
121 Requirements</emphasis></entry>
122 </row>
123
124 <row>
125 <entry>External memory</entry>
126
127 <entry>To boot a CGL<indexterm>
128 <primary>CGL</primary>
129 </indexterm> image, you need at least 16 GB on a hard-disk
130 drive<indexterm>
131 <primary>HDD</primary>
132 </indexterm> on an eSATA, USB drive, or SD card.<remark>INFO:
133 (packed rootfs 4.5 GB + unpacked rootfs 1.5 GB + good
134 margins)</remark><remark>INFO: NFS does not support SELinux. In
135 order to have a security-enhanced Linux, one must take off from an
136 NFS-booted system and proceed with boot from external
137 memory.</remark></entry>
138 </row>
139 </tbody>
140 </tgroup>
141 </informaltable>
142
143 <section id="ensure-bash">
144 <title>System Shell Configuration</title>
145
146 <para>Before installing Enea Linux, ensure that bash is the default
147 shell.</para>
148
149 <para>If your system runs Ubuntu, you can use ls -l to ensure
150 <filename>/usr/bin</filename> is a symbolic link to bash. In case the link
151 points to dash, which is default in some Ubuntu versions, change it to
152 bash by running <emphasis role="bold">sudo dpkg-reconfigure
153 dash</emphasis> and answer <emphasis role="bold">No</emphasis> to the
154 question "Use dash as the default system shell (/bin/sh)?":</para>
155
156 <programlisting># ls -l /bin/sh
157 lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; bash</programlisting>
158 </section>
159</section> \ No newline at end of file
diff --git a/doc/book-enea-linux-release-info/swcomp.mk b/doc/book-enea-linux-release-info/swcomp.mk
new file mode 100644
index 0000000..c274604
--- /dev/null
+++ b/doc/book-enea-linux-release-info/swcomp.mk
@@ -0,0 +1,10 @@
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-linux-release-info-rt
9BOOKDESC_$(BOOKPACKAGES) := "Enea Linux $(PROD_VER) Release Information"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/book-enea-linux-user-guide/doc/application_development.xml b/doc/book-enea-linux-user-guide/doc/application_development.xml
new file mode 100644
index 0000000..0e2edf4
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/application_development.xml
@@ -0,0 +1,282 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="app_dev">
3 <title>Application Development</title>
4
5 <section id="cross_comp_apps">
6 <title>Cross-Compiling Applications</title>
7
8 <para>Running <command>make</command> cross-compiles your applications
9 according to the environment settings. By installing a Cross-Compilation
10 Toolchain for your target, the environment variables are set up for
11 cross-compilation. For more details, see <xref
12 linkend="install_el_sdk" />.</para>
13
14 <para>Once the cross-compilation environment is set up, you can make your
15 applications as usual and get them compiled for your target. Below you see
16 how to cross-compile from the command line. If Eclipse is installed, you
17 can also cross-compile your code from the Eclipse IDE. For more details,
18 see <xref linkend="crosscomp" />.</para>
19
20 <orderedlist>
21 <listitem>
22 <para>Create a Makefile for your application. Example of a simple
23 Makefile and application:</para>
24
25 <programlisting>helloworld:helloworld.o
26 $(CC) -o helloworld helloworld.o
27
28clean:
29 rm -f *.o helloworld</programlisting>
30
31 <programlisting>#include &lt;stdio.h&gt;
32
33int main(void) {
34 printf("Hello World\n");
35 return 0;
36}</programlisting>
37 </listitem>
38
39 <listitem>
40 <para>Run <command>make</command> to cross-compile your application
41 according to the environment set up:</para>
42
43 <programlisting>$ make</programlisting>
44
45 <tip>
46 <para>If the build fails, check if the GNU Make workaround solves
47 your problem.</para>
48 </tip>
49 </listitem>
50
51 <listitem>
52 <para>Copy the <filename>helloworld</filename> program to your target
53 and run it:</para>
54
55 <programlisting># ./helloworld
56Hello World</programlisting>
57 </listitem>
58 </orderedlist>
59 </section>
60
61 <section id="cross_comp_kern_mod">
62 <title>Cross-Compiling Kernel modules</title>
63
64 <para>Running <command>make</command> cross-compiles your kernel modules
65 according to the environment settings. By installing a Cross-Compilation
66 Toolchain for your target, the environment variables are set up for
67 cross-compilation. For more details, see <xref
68 linkend="install_el_sdk" />.</para>
69
70 <para>Before cross-compiling kernel modules, you need to make sure the
71 installed toolchain includes the kernel source tree, which should be
72 available at:
73 <literal>&lt;sdkdir&gt;/sysroots/&lt;targetarch&gt;-enea-linux/usr/src/kernel</literal>.
74 If the kernel source tree is not included in the toolchain, you need to
75 add the kernel-dev package into the image recipe enea-image-&lt;name&gt;
76 and build the toolchain again.</para>
77
78 <para>Once the cross-compilation environment is set up, you can make your
79 kernel modules as usual and get them compiled for your target. Below you
80 see how to cross-compile a kernel module.</para>
81
82 <orderedlist>
83 <listitem>
84 <para>Create a Makefile for the kernel module. Example of a simple
85 Makefile and kernel module:</para>
86
87 <programlisting>obj-m := hello.o
88PWD := $(shell pwd)
89
90KERNEL_SRC := &lt;full path to kernel source tree&gt;
91
92all: scripts
93 $(MAKE) -C $(KERNEL_SRC) M=$(PWD) LDFLAGS="" modules
94scripts:
95 $(MAKE) -C $(KERNEL_SRC) scripts
96clean:
97 $(MAKE) -C $(KERNEL_SRC) M=$(PWD) LDFLAGS="" clean</programlisting>
98
99 <programlisting>#include &lt;linux/module.h&gt; /* Needed by all modules */
100#include &lt;linux/kernel.h&gt; /* Needed for KERN_INFO */
101#include &lt;linux/init.h&gt; /* Needed for the macros */
102
103static int __init hello_start(void)
104{
105 printk(KERN_INFO "Loading hello module...\n");
106 printk(KERN_INFO "Hello, world\n");
107 return 0;
108}
109
110static void __exit hello_end(void)
111{
112 printk(KERN_INFO "Goodbye, world\n");
113}
114
115module_init(hello_start);
116module_exit(hello_end);
117
118MODULE_LICENSE("GPL");</programlisting>
119 </listitem>
120
121 <listitem>
122 <para>Run <command>make</command> to cross-compile your kernel module
123 according to the environment set up:</para>
124
125 <programlisting>$ make</programlisting>
126 </listitem>
127
128 <listitem>
129 <para>Copy the kernel module <filename>hello.ko</filename> to your
130 target and install/remove it:</para>
131
132 <programlisting># insmod hello.ko
133# rmmod hello.ko
134# dmesg
135[...] Loading hello module...
136[...] Hello, world
137[...] Goodbye, world</programlisting>
138 </listitem>
139 </orderedlist>
140 </section>
141
142 <section id="use_devtool">
143 <title>Add an Application using devtool</title>
144
145 <para>As a prerequisite, you need to install the SDK and set up the
146 environment. For this, see <xref linkend="install_el_sdk" />.</para>
147
148 <para>The following section, <ulink
149 url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#sdk-use-devtool-to-add-an-application">Use
150 devtool add to Add an Application</ulink>, in Yocto Project Software
151 Development Kit (SDK) Developer's Guide, explains how to use devtool to
152 generate recipes from existing application code, edit and build recipes,
153 and deploy the output on target. If needed, replace the Yocto version in
154 the link.</para>
155
156 <para>This example will show how to generate a recipe from the existing
157 application code and Makefile, edit the recipe in order to provide an
158 installation path for the application, build the recipe, and deploy the
159 output on a target, or create a DEB package from the recipe and install
160 the package.</para>
161
162 <orderedlist>
163 <listitem>
164 <para>Create a simple application and Makefile in
165 <literal>&lt;workspace_dir&gt;/my_app</literal>:</para>
166
167 <para><literal>&lt;workspace_dir&gt;/my_app/my_hello_app.c</literal></para>
168
169 <programlisting>#include &lt;stdio.h&gt;
170
171int main(void)
172{
173 printf("Hello world!\n");
174 return 0;
175}</programlisting>
176
177 <para><literal>&lt;workspace_dir&gt;/my_app/Makefile</literal></para>
178
179 <programlisting>my_hello_app:</programlisting>
180 </listitem>
181
182 <listitem>
183 <para>Generate a recipe (my-hello-recipe) using the source tree of the
184 application (<literal>&lt;workspace_dir&gt;/my_app</literal>):</para>
185
186 <programlisting>$ devtool add my-hello-recipe &lt;workspace_dir&gt;/my_app
187NOTE: Using source tree as build directory since that would be the default for this
188recipe
189NOTE: Recipe &lt;SDK_dir&gt;/workspace/recipes/my-hello-recipe/my-hello-recipe.bb has been
190automatically created; further editing may be required to make it fully functional</programlisting>
191
192 <programlisting>$ cat &lt;SDK_dir&gt;/workspace/recipes/my-hello-recipe/my-hello-recipe.bb
193# Recipe created by recipetool
194# This is the basis of a recipe and may need further editing in order to be fully
195# functional.
196# (Feel free to remove these comments when editing.)
197#
198# Unable to find any files that looked like license statements. Check the
199# accompanying documentation and source headers and set LICENSE and
200# LIC_FILES_CHKSUM accordingly.
201#
202# NOTE: LICENSE is being set to "CLOSED" to allow you to at least start building - if
203# this is not accurate with respect to the licensing of the software being built (it
204# will not be in most cases) you must specify the correct value before using this
205# recipe for anything other than initial testing/development!
206LICENSE = "CLOSED"
207LIC_FILES_CHKSUM = ""
208
209# No information for SRC_URI yet (only an external source tree was specified)
210SRC_URI = ""
211
212
213# NOTE: this is a Makefile-only piece of software, so we cannot generate much of the
214# recipe automatically - you will need to examine the Makefile yourself and ensure
215# that the appropriate arguments are passed in.
216
217do_configure () {
218 # Specify any needed configure commands here
219 :
220}
221
222do_compile () {
223 # You will almost certainly need to add additional arguments here
224 oe_runmake
225}
226
227do_install () {
228 # NOTE: unable to determine what to put here - there is a Makefile but no
229 # target named "install", so you will need to define this yourself
230 :
231}</programlisting>
232 </listitem>
233
234 <listitem>
235 <para>Edit the recipe to provide an installation path for the
236 application:</para>
237
238 <programlisting>$ devtool edit-recipe my-hello-recipe</programlisting>
239
240 <programlisting>$ cat &lt;SDK_dir&gt;/workspace/recipes/my-hello-recipe/my-hello-recipe.bb
241...
242do_install () {
243 # NOTE: unable to determine what to put here - there is a Makefile but no
244 # target named "install", so you will need to define this yourself
245 install -d ${D}${bindir}
246 install -m 0777 ${S}/my_hello_app ${D}${bindir}
247}
248...</programlisting>
249 </listitem>
250
251 <listitem>
252 <para>Build the recipe:</para>
253
254 <programlisting>$ devtool build my-hello-recipe</programlisting>
255
256 <para>The recipe build results can be seen here:
257 <literal>&lt;SDK_dir&gt;/tmp/work/&lt;arch&gt;-enea-linux/my-hello-recipe/1.0-r0/</literal></para>
258 </listitem>
259
260 <listitem>
261 <para>Deploy the output (in this case, the application) on
262 target:</para>
263
264 <programlisting>$ devtool deploy-target my-hello-recipe root@&lt;target_ip_address&gt;
265Parsing recipes..done.
266NOTE: Successfully deployed
267&lt;SDK_dir&gt;/tmp/work/&lt;arch&gt;-enea-linux/my-hello-recipe/1.0-r0/image</programlisting>
268
269 <para>As an alternative you can create a DEB package:</para>
270
271 <programlisting>$ devtool package my-hello-recipe
272...
273NOTE: Your packages are in &lt;SDK_dir&gt;/tmp/deploy/deb</programlisting>
274
275 <para>Then copy the DEB package on the target and install it using
276 dpkg:</para>
277
278 <programlisting># dpkg -i my-hello-recipe-1.0-r0.1.&lt;arch&gt;.deb</programlisting>
279 </listitem>
280 </orderedlist>
281 </section>
282</chapter>
diff --git a/doc/book-enea-linux-user-guide/doc/book.xml b/doc/book-enea-linux-user-guide/doc/book.xml
new file mode 100644
index 0000000..48747ef
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/book.xml
@@ -0,0 +1,22 @@
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_linux_user_guide_rt">
7 <title><trademark class="registered">Enea</trademark> Linux User's 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" xmlns:xi="http://www.w3.org/2001/XInclude" />
13 <xi:include href="preface.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="prerequisites_and_requirements.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
16 <xi:include href="getting_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
17 <xi:include href="using_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
18 <xi:include href="application_development.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
19 <xi:include href="using_eclipse.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
20 <xi:include href="real_time_in_enea_linux.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
21 <xi:include href="troubleshooting.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />
22</book>
diff --git a/doc/book-enea-linux-user-guide/doc/eltf_params_template.xml b/doc/book-enea-linux-user-guide/doc/eltf_params_template.xml
new file mode 100644
index 0000000..eaa7ebd
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/eltf_params_template.xml
@@ -0,0 +1,151 @@
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-linux-user-guide/doc/eltf_params_updated.xml b/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml
new file mode 100644
index 0000000..b557335
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/eltf_params_updated.xml
@@ -0,0 +1,313 @@
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.2 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>8</phrase></para>
46
47 <para id="Yocto_VER"><phrase>2.5</phrase></para>
48
49 <para id="Yocto_NAME"><phrase>sumo</phrase></para>
50
51 <para id="ULINK_YOCTO_PROJECT_DOWNLOAD"><ulink
52 url="http://www.yoctoproject.org/downloads/core/pyro23">http://www.yoctoproject.org/downloads</ulink></para>
53
54 <para id="ULINK_ENEA_LINUX_URL"><ulink
55 url="http://linux.enea.com/EneaLinux8.0">http://linux.enea.com/EneaLinux8.0</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_manrtt.git \
64 -b refs/tags/Enea_Linux_8.0 -m intel-corei7-64/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.</bridgehead>
70
71 <informaltable>
72 <tgroup cols="1">
73 <tbody>
74 <row id="eltf-eclipse-version-row">
75 <entry>Eclipse version 4.7 (Oxygen) plus command line development
76 tools are included in this Enea Linux release.</entry>
77 </row>
78 </tbody>
79 </tgroup>
80 </informaltable>
81
82 <bridgehead>Below is one big section with title "Supported Targets with
83 Parameters". The entire section is included completely in the book via ID
84 "eltf-target-tables-section" and shall be LAST in the template. The
85 template contains ONE target subsection. COPY/APPEND it, if multiple
86 targets exist in the release and optionally add rows with additional
87 target parameters in each target subsection table.</bridgehead>
88 </section>
89
90 <section id="eltf-machine-tables-section">
91 <title>Supported Targets with Parameters</title>
92
93 <para>The section(s) below describe the target(s) supported in this Enea
94 Linux release.</para>
95
96 <section id="eltf-target-tables-section">
97 <title>MACHINE Information</title>
98
99 <para>The table(s) below describes the target(s) supported in this Enea
100 Linux release.</para>
101
102 <table>
103 <title>MACHINE Information Intel Xeon D</title>
104
105 <tgroup cols="2">
106 <colspec align="center" />
107
108 <thead>
109 <row>
110 <entry align="center">Component</entry>
111
112 <entry align="center">Description</entry>
113 </row>
114 </thead>
115
116 <tbody>
117 <row>
118 <entry align="left">Target official name</entry>
119
120 <entry>Intel Xeon D</entry>
121 </row>
122
123 <row>
124 <entry align="left">Architecture and Description</entry>
125
126 <entry>x86-64</entry>
127 </row>
128
129 <row>
130 <entry align="left">Link to target datasheet</entry>
131
132 <entry><ulink
133 url="https://www.intel.com/content/www/us/en/processors/xeon/xeon-d-1500-datasheet-vol-1.html">Intel
134 Xeon D datasheet</ulink></entry>
135 </row>
136
137 <row>
138 <entry align="left">Poky version</entry>
139
140 <entry>Git-commit-id: TBD</entry>
141 </row>
142
143 <row>
144 <entry align="left">GCC version</entry>
145
146 <entry>7.3</entry>
147 </row>
148
149 <row>
150 <entry align="left">Linux Kernel Version</entry>
151
152 <entry>4.14</entry>
153 </row>
154
155 <row condition="hidden">
156 <entry align="left">Supported Drivers</entry>
157
158 <entry>Ethernet, RTC, UART</entry>
159 </row>
160
161 <row>
162 <entry>Enea deb folder for downloading DEB packages for this
163 target</entry>
164
165 <entry><ulink
166 url="http://linux.enea.com/EneaLinux8.0/deb">http://linux.enea.com/EneaLinux8.0/deb</ulink></entry>
167 </row>
168 </tbody>
169 </tgroup>
170 </table>
171
172 <table>
173 <title>MACHINE Information Intel Atom C3000</title>
174
175 <tgroup cols="2">
176 <colspec align="center" />
177
178 <thead>
179 <row>
180 <entry align="center">Component</entry>
181
182 <entry align="center">Description</entry>
183 </row>
184 </thead>
185
186 <tbody>
187 <row>
188 <entry align="left">Target official name</entry>
189
190 <entry>Intel Atom C3000</entry>
191 </row>
192
193 <row>
194 <entry align="left">Architecture and Description</entry>
195
196 <entry>x86-64</entry>
197 </row>
198
199 <row>
200 <entry align="left">Link to target datasheet</entry>
201
202 <entry><ulink
203 url="https://www.intel.com/content/www/us/en/products/docs/processors/atom/c-series/c3000-family-datasheet.html">Intel
204 Atom datasheet</ulink></entry>
205 </row>
206
207 <row>
208 <entry align="left">Poky version</entry>
209
210 <entry>Git-commit-id: TBD</entry>
211 </row>
212
213 <row>
214 <entry align="left">GCC version</entry>
215
216 <entry>7.3</entry>
217 </row>
218
219 <row>
220 <entry align="left">Linux Kernel Version</entry>
221
222 <entry>4.14</entry>
223 </row>
224
225 <row condition="hidden">
226 <entry align="left">Supported Drivers</entry>
227
228 <entry>Ethernet, RTC, UART</entry>
229 </row>
230
231 <row>
232 <entry>Enea deb folder for downloading DEB packages for this
233 target</entry>
234
235 <entry><ulink
236 url="http://linux.enea.com/EneaLinux8.0/deb">http://linux.enea.com/EneaLinux8.0/deb</ulink></entry>
237 </row>
238 </tbody>
239 </tgroup>
240 </table>
241
242 <table>
243 <title>MACHINE Information Intel NUC Kaby Lake</title>
244
245 <tgroup cols="2">
246 <colspec align="center" />
247
248 <thead>
249 <row>
250 <entry align="center">Component</entry>
251
252 <entry align="center">Description</entry>
253 </row>
254 </thead>
255
256 <tbody>
257 <row>
258 <entry align="left">Target official name</entry>
259
260 <entry>Intel NUC Kaby Lake</entry>
261 </row>
262
263 <row>
264 <entry align="left">Architecture and Description</entry>
265
266 <entry>x86-64</entry>
267 </row>
268
269 <row>
270 <entry align="left">Link to target datasheet</entry>
271
272 <entry><ulink
273 url="https://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/nuc-kit-nuc7i5bnh-nuc7i5bnk-brief.pdf">Intel
274 NUC Kaby Lake datasheet</ulink></entry>
275 </row>
276
277 <row>
278 <entry align="left">Poky version</entry>
279
280 <entry>Git-commit-id: TBD</entry>
281 </row>
282
283 <row>
284 <entry align="left">GCC version</entry>
285
286 <entry>7.3</entry>
287 </row>
288
289 <row>
290 <entry align="left">Linux Kernel Version</entry>
291
292 <entry>4.14</entry>
293 </row>
294
295 <row condition="hidden">
296 <entry align="left">Supported Drivers</entry>
297
298 <entry>Ethernet, RTC, UART</entry>
299 </row>
300
301 <row>
302 <entry>Enea deb folder for downloading DEB packages for this
303 target</entry>
304
305 <entry><ulink
306 url="http://linux.enea.com/EneaLinux8.0/deb">http://linux.enea.com/EneaLinux8.0/deb</ulink></entry>
307 </row>
308 </tbody>
309 </tgroup>
310 </table>
311 </section>
312 </section>
313</section>
diff --git a/doc/book-enea-linux-user-guide/doc/eltf_params_updated_template_how_to_use.txt b/doc/book-enea-linux-user-guide/doc/eltf_params_updated_template_how_to_use.txt
new file mode 100644
index 0000000..62e5d02
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/eltf_params_updated_template_how_to_use.txt
@@ -0,0 +1,320 @@
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-linux-user-guide/doc/getting_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/getting_enea_linux.xml
new file mode 100644
index 0000000..e58726e
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/getting_enea_linux.xml
@@ -0,0 +1,145 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="getting_el">
3 <title>Getting Enea Linux</title>
4
5 <para>Enea Linux is available as both pre-built binary images and source
6 code. Both serve a specific purpose and each have their advantages. However,
7 using the pre-built binary images allows for getting up and running faster.
8 Please refer to the sections below for details on how to get Enea Linux as
9 pre-built binary images or source code.</para>
10
11 <section id="get_prebuilt_bin">
12 <title>Getting Pre-Built Binaries</title>
13
14 <para>Enea Linux pre-built binaries are available for download on <ulink
15 url="https://portal.enea.com/login/?redirect_to=https%3A%2F%2Fportal.enea.com%2F">Enea
16 Download Portal</ulink>. Log in using the credentials provided. Using the
17 menu, browse to the <emphasis role="bold">Linux</emphasis> section. You
18 will now have access to the <emphasis role="bold">Files</emphasis> section
19 and the <emphasis role="bold">Online Documentation</emphasis>
20 section.</para>
21
22 <para>The Files section lists each Enea Linux distribution, one for each
23 version and profile, as a separate download package. Clicking on the name
24 of the distribution will open a new page, which presents further details
25 about the content of the release and a list of downloadable archives, one
26 for each hardware target included in the release. Each archive provides
27 the following content:</para>
28
29 <itemizedlist>
30 <listitem>
31 <para><emphasis>images</emphasis> directory - this directory includes
32 the binary image files needed to boot the target with Enea Linux. This
33 includes the kernel, the root file system, device tree, etc.</para>
34 </listitem>
35
36 <listitem>
37 <para><emphasis>sdk</emphasis> directory - this directory includes the
38 installer for the SDK.</para>
39 </listitem>
40
41 <listitem>
42 <para><emphasis>deb</emphasis> directory - this directory contains all
43 the packages included in the distribution in deb format, which can be
44 installed using the package manager.</para>
45 </listitem>
46 </itemizedlist>
47
48 <para>For faster downloads, each archive is mirrored in several places,
49 geographically. Choose the archive in the region closest to you.</para>
50
51 <para>The Documentation section lists all the documents delivered with the
52 release.</para>
53 </section>
54
55 <section id="getting_sources">
56 <title>Getting the Sources</title>
57
58 <para>Enea Linux sources are available for cloning from a set of Git
59 repositories on <ulink url="https://git.enea.com">git.enea.com</ulink>.
60 Since Enea Linux requires multiple repositories, Google Repo tool is used
61 in order to manage configurations and make the cloning step simpler.
62 Google Repo tool uses files, known as manifests, which store a list of
63 tuples (repository URL, version). The Repo tool is then used to traverse
64 the list of tuples in the manifest file and clone the specified versions
65 of each repository. See <ulink
66 url="https://code.google.com/p/git-repo/">https://code.google.com/p/git-repo/</ulink>
67 for more info.</para>
68
69 <section id="get_sourcecode_stepone">
70 <title>Get access to git.enea.com</title>
71
72 <para>In order to get access to git.enea.com, a ssh key is required for
73 Git authentication. If you don't already have such a key, follow the
74 steps below to generate one:</para>
75
76 <orderedlist>
77 <listitem>
78 <para>Generate the ssh key pair:</para>
79
80 <programlisting>$ ssh-keygen -t rsa</programlisting>
81
82 <para>When asked for a password, just press Enter. This will create
83 two files in the .ssh directory in your home directory.</para>
84
85 <programlisting>id_rsa
86id_rsa.pub</programlisting>
87 </listitem>
88
89 <listitem>
90 <para>Copy the public key into an authorized_keys file:</para>
91
92 <programlisting>$ cat id_rsa.pub &gt;&gt; authorized_keys</programlisting>
93 </listitem>
94 </orderedlist>
95
96 <para>Once these steps are done and you have a valid ssh key pair, send
97 the public key, <emphasis>id_rsa.pub</emphasis>, via email to
98 <email>mailto:git_support@list.enea.se</email> in order to get access to
99 <ulink url="https://git.enea.com">git.enea.com</ulink>.</para>
100 </section>
101
102 <section id="get_sourcecode_steptwo">
103 <title>Get Sources</title>
104
105 <para>To use the Repo tool to download the sources for Enea Linux, do
106 the following:</para>
107
108 <orderedlist>
109 <listitem>
110 <para>Make sure that the repo tool is installed. If not, do the
111 following: <remark>Below is include of ID
112 "eltf-getting-repo-install-command" from
113 eltf_params_updated.xml</remark></para>
114
115 <xi:include href="../../book-enea-linux-release-info/doc/eltf_params_updated.xml"
116 xmlns:xi="http://www.w3.org/2001/XInclude"
117 xpointer="element(eltf-getting-repo-install-command/1)" />
118 </listitem>
119
120 <listitem>
121 <para>Then use the repo command below:</para>
122
123 <xi:include href="../../book-enea-linux-release-info/doc/eltf_params_updated.xml"
124 xmlns:xi="http://www.w3.org/2001/XInclude"
125 xpointer="element(eltf-repo-cloning-enea-linux/1)" />
126 </listitem>
127 </orderedlist>
128
129 <para>Once the source code is downloaded, the current directory will
130 contain a <filename>README</filename> file with instructions on how to
131 build the distro and boot the machine you choose. .</para>
132
133 <para>It's not necessary to explicitly clone the manifest repository
134 since that is done automatically by the repo tool. To see the current
135 manifest, use the following command:</para>
136
137 <programlisting>$ repo manifest</programlisting>
138
139 <remark>The UG should be updated with instructions on how to add
140 customizations. That section should also contain more info about the
141 manifest: the manifest templates, using a branch instead of the tag EL6,
142 etc. When this is done a reference from here should be added.</remark>
143 </section>
144 </section>
145</chapter>
diff --git a/doc/book-enea-linux-user-guide/doc/getting_started.xml b/doc/book-enea-linux-user-guide/doc/getting_started.xml
new file mode 100644
index 0000000..61ffea5
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/getting_started.xml
@@ -0,0 +1,108 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="getting_started">
3 <title>Getting Started</title>
4
5 <section id="use_enealinux">
6 <title>Using Enea Linux</title>
7
8 <para></para>
9
10 <section id="sys_req">
11 <title>System Requirements</title>
12
13 <para></para>
14 </section>
15
16 <section id="install_el">
17 <title>Installing Enea Linux</title>
18
19 <para>(downloading prebuit artifacts, brief description of files
20 etc.)</para>
21 </section>
22
23 <section id="install_el_sdk">
24 <title>Installing Enea Linux SDK</title>
25
26 <para></para>
27 </section>
28
29 <section id="boot_images">
30 <title>Booting the images (RAM, SD Card)</title>
31
32 <para></para>
33 </section>
34
35 <section id="pkg_mg">
36 <title>Package Management</title>
37
38 <para></para>
39 </section>
40 </section>
41
42 <section id="build_enealinux">
43 <title>Building Enea Linux</title>
44
45 <para></para>
46
47 <section id="build_sys_req">
48 <title>System Requirements</title>
49
50 <para>(covers shell configurations, required host packages, etc.)</para>
51 </section>
52
53 <section id="getting_sources">
54 <title>Getting Enea Linux sources</title>
55
56 <para>(covers repo tool basic info, instructions how to clone repos,
57 etc.)</para>
58 </section>
59
60 <section id="setup_buildenv">
61 <title>Set up the build environment</title>
62
63 <para></para>
64 </section>
65
66 <section id="build_elimages_sources">
67 <title>Build Enea Linux Images from sources</title>
68
69 <para></para>
70 </section>
71
72 <section id="build_crosscomp_tc">
73 <title>Build Cross-Compilation Toolchain</title>
74
75 <para></para>
76 </section>
77 </section>
78
79 <section id="custom_enealinux">
80 <title>Customizing Enea Linux</title>
81
82 <para></para>
83
84 <section id="layers_adaptations">
85 <title>Layers and Adaptations</title>
86
87 <para>(covers building with a new layer etc.)</para>
88 </section>
89
90 <section id="add_recipe">
91 <title>Adding a Recipe</title>
92
93 <para></para>
94 </section>
95
96 <section id="config_pkg_recipes">
97 <title>Configuring Packages via Recipes</title>
98
99 <para></para>
100 </section>
101
102 <section id="build_com_licenses">
103 <title>Building with Commercial Licenses</title>
104
105 <para></para>
106 </section>
107 </section>
108</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-user-guide/doc/images/install_new_sw.png b/doc/book-enea-linux-user-guide/doc/images/install_new_sw.png
new file mode 100644
index 0000000..fe1ccd9
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/images/install_new_sw.png
Binary files differ
diff --git a/doc/book-enea-linux-user-guide/doc/images/install_new_sw.svg b/doc/book-enea-linux-user-guide/doc/images/install_new_sw.svg
new file mode 100644
index 0000000..d73f03d
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/images/install_new_sw.svg
@@ -0,0 +1,888 @@
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="635"
17 height="536"
18 sodipodi:docname="install_new_sw.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="1618"
43 inkscape:window-height="1027"
44 id="namedview2987"
45 showgrid="false"
46 inkscape:zoom="1.5671642"
47 inkscape:cx="317.5"
48 inkscape:cy="268"
49 inkscape:window-x="1358"
50 inkscape:window-y="-8"
51 inkscape:window-maximized="1"
52 inkscape:current-layer="svg2985"
53 showborder="false"
54 inkscape:showpageshadow="false"
55 fit-margin-top="0"
56 fit-margin-left="0"
57 fit-margin-right="0"
58 fit-margin-bottom="0" />
59 <image
60 width="635"
61 height="536"
62 xlink:href="data:image/png;base64,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
94zyz+DggIsN14iZOTU9++fbOzs5ctW9a9e/fhw4f36NHj888/v3fvXt++fR0dHe3s7ON0CiGEkDlC
95gEl7fksvNgEoC7rSKVHiTmauLPSSspOnZOJvo+hLiNE9qR7/OO6OHTtycnIGDx5sPEMfPHhwdnb2
96zp07AWDUqFGBgYHbtm3btm1b48aNR44cKW4o7il1d3fXarULFy60p+5yN5k3b15mZmZWVtb8+fMB
97YM6cOeZ5Zs2aBQDz58/PyckpKirav3//0KFDLVbXr1+/nTt33r17V6/Xx8bGAkBISIi46rXXXgOA
98r776qqCg4MsvvwSAadOmWWu2t7c3PDzhFg/WXrhwISwsDADCwsIuXboEDx/ErdD42N8phBBCtpRd
99w1N2RFAMuFB2FRCA0Y0dSelVQMToPzB6AYSIlwYxxkC8nPexzlX+7rvvAOD11183ThRfiicTcRw3
100Y8aMe/fuZWdnv/322+K5tQCwdevWdu3aDR48uE2bNuJhyHKVu8n48eOHDx/epEmTGzdurFu3zqRV
101olmzZm3btu3WrVvBwcENGjT49ttv582bZ7E6d3f3hQsXNmnSxMXFZc6cOdOnT1+3bp246t13312y
102ZMnff//t6+t76NChr7/+WjxlzKJPP/20bt26wcHB0nnLYmR1cHCYMGECAISGhioUCgAYNmyY/Z19
103tE4hhBCygZZGyLIpKQCAuKO57L/S31JElv5PnBmLp0eRsvylK8TZLa3gHLdi+6ARQgihWk56dtBP
104P+3Zs3U5lB58LdtpLO5tLrsjhhhCS0OvFJ6lyFqazgTKeIHqeao3UJ2e1xmojhd4nvGUnrpye3A7
105T+kujyEDepTGVsaAgHhrKwaE4X2VEUIIPcXKJqulOyVZ6VVCxuEWrIXbsiKY0VS4dKLM4FHmuBhx
106EUIIPYXEw36UsdJTiwlhTLwlBnk43D6Irybh9sH0l5Xtl6bM+H7LzJ67PBLC85RS4AWGERchhNDT
1075sEJxaVBlAADRhhj4n0wHgq3RodzLYTbspXMeHYLZeHWNOCWTaUFgQkGKgBQyihlAIQynOMihBB6
108uhjfVZgyxhFCgFEGMnGGC6bh1sJkF4zCLZP+VzrZZdL5z5bOVdbrqUCBMuk+Vw9YfXYQQggh9MR7
1098OwgKZoaHb21K9waHesF6RkGYOE4LiEAIFjfzYwRFyGE0FOLGT/yVjoLyjT2moRbeCjcPjhnqvR4
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
158Fn355ZcffPCBQqGQ2jNr1qy0tLS0tLRZs2ZJh+E7der01VdfqdXq5ORkKTybGDZs2Ny5c6dMmQIA
159kydPnjFjhslBXHv6a41JR6y1s0IsNsakImsDaxFeWYRQrcQAaNrdIq86jgAciKHWKOgWF+UUFhbl
160F3O5+axEwyhlTACBB8aAyGmOPsHR2+DkKcic9EymM/AleoNaqy9uFexxKzVXoZArFTKL//QvXIy9
161cLH0PM0LF2IvXIgFAAJw/kLs+Qul6cbLtpX/ddm0adOoqKgTJ04899xzbm5uM2bMKDcghYeHjxo1
162auzYsW5ubpMnT5a+Sd95552ePXv269cvODg4ICDAeBM/P7+jR4/+/PPPixcvNint/fff79mzZ7nf
163g9YqtcikzApta2706NFjx451d3f/8MMPt2zZUm511mzYsOH99993dXUdMGBAv3797NxcJpM1bdr0
1641VdflVI++OCDli1bdu7cuXPnzq1bt160aJGYvm7duv3793t7ew8YMMA8joqGDh169+5d8S0ODQ3N
165ysoaOnRoRftrjUlHrLWzQiw2xqQiawOLEHpyUACaW6BxcVIygAexlpQuFObfIwT0POQVkIy8+mn5
166jXL0dTSUyFWgcGZEpSnmU5m8mBcK9Xo1z7Q81THg5XIil8s0OoODnOM4C9+xXbq06dKljfGymKlr
167lzZdy9KNl23Dw1dPvFGjRk2cOPHRJogIIfSE4AF0fx9PrOflVsfdnRcAyh5nC8C0Wu3t5Bgxn1JV
168p0njwGaB/joD/+OOo0F1BYWCAie4u9UJahwMAAQIIYQjhAEBgC9+Oj6oq//V+NtnLt8q0ejNK960
1696kOgAgMCjFACBAgDoFQgQChjAIQxIp21XHYhcNlxXPGekWXHcZ+tuzw+ZSil69evv3379oQJE2q6
170LQghVNWYziA4yGSEEI4jZTd0BADCmIEjpY+9VShc3FzcBAEUcrnA4H5xcT1PGVDCC3pKBfFKfQYc
171ZSDuBVPIZYIAKoWDs0oJZlf0Vi6MuE8wmUwWGBi4e/fuCh1MRQihJxORccQgCBwhwBEGRJxWEmBK
172pUImHtslDpoS/tbtQldHVyCGlPScwHZyShkhjAARIy4jRHxJOA4ASnQGhYJzkMtUSofK2udrbecx
173RtwnGB4RQAg9MwgAOKkcdHqeIwCEADACQDiQAXFycM519uANMgKuAnVOTVHvP34oX53TMoApHBwY
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
22204wZMwYOHLhr1y4pMTU1tVGjRoWFhXq9fsaMGT4+Pg0bNlyxYoVCoRAzMMaWLVvWtGnT+vXrv/nm
223myUlJWK6QqH48ccfmzZt6ubm1qdPn/j4eBuNNAcA5puLM1qFQiHWbvJSTFmxYkWDBg18fHxmzZpl
224MBikAqU8hJDIyMjBgwebLBsMhpkzZ4od/Prrr6VR1ev18+bNa9iwYcOGDefNm6fX6wkhLVq0uHbt
225mpjh559/FheuXbvWokULG323XSYh5ObNm6GhoT4+Pt7e3i+//HJubq6Ybq1txqy9EYIgfPLJJ02a
226NKlXr96qVatMWlLu0B05cqRr165ubm5Nmzb96aefbNdlzFofFQrF6tWrg4KClEqlmM3i58r4rTHZ
227xFrtUqesZbA2vFIfzXshlVzu19DWHTv7hwyz+LPx5y0V/RYTPeY3Y0WdO3/Bzc119MgX3N3dz124
228KKXr9fpV33436qXxL74cun3Xbqlh1tJrj6obVQCYMmni9l2/SCk7du8OmzxJKj81Le2jTxePemn8
229iDFjP/j40/z8fDG9f8iw3//cNyHslZDnR/5n1uyk5GTb+XU63dervxUHedvOXf1DhonpgiBs3rot
230NOzVkS+NW/7VCo1GUyn9sofJeFqNuN27dkm8fiM/vwAAYq9d69ypY2xcHADk5OYmJSV379ply46d
231t1Pu/Pe7b//73be3kpO37tgpbftPdPTa1d9EHfhbSjlz9tx7H3w4O3zGS2NGG9fSpVOnf6JjACA7
232J2f1d9+XaDQAcDU6ukunjlIecd/ykYP7jY/pXrh0adWXX/z+y65uXbp8vXqNtV5UVGRk5JQpU4xT
233wsLCIiMjAWDlypWbNm3avXs3AOzatWvz5s2rVq1asGDBkiVLpF0HS5YsCQ8Pd3d3X7p06Z07d65c
234uXL+/PmoqCiptNWrVx87duzw4cOJiYk8z3/88cfSqkOHDkVGRmZlZQ0bNuw///lPRVtuvrnBYBB/
235SwvGL0WHDx8+f/785cuXr1+/vnz5cvNi9Xr9qVOnBgwYYLL8+eef37hx4/Lly2fPnj1w4ICUf9my
236ZfHx8WfPnj179mxMTMznn38OACEhISdOnACAtLS02bNnFxUVAcDx48eHDh1qT98tlgkAEyZMmD59
237+u3bt5OSkvz8/BYtWiSmW2ubMWtvxJdffnny5MmIiIjr16+npaXZGHCLQ/faa68tWLAgJycnKirq
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
270it7Zo5w7YAwdMnjDTxvbt30OANq3a7txy5ahIaXnQw7s3+/b79dl5+Rk5+R8u3bdwP79rBVS19v7
271m6+++vvAwW07d5mv7dq583frfggZNBAAhgwc8M2a77p27mySx93dPeVOqj39eczriD788MPvv/9+
2721apVWVlZWVlZq1atWrt27QcffAAAarX6lVde+fnnn8eMGfPdd9+FhoaKf48TQhYuXPjVV18tXLhQ
273uvwmNDR0/vz5GRkZGRkZ8+fPl8qfOnXq1KlTr127ptfrY2NjJ02a9DitLZe3t/e1a9esvQSAefPm
274paenp6enz5s3z7gx4nw6Ly/v+vXr3bt3N1kGgIkTJ0rbzpnzYIdEaGjonDlz0tLSxEO2oaGhYvrQ
275oUPnz58/efJkAJg0adLMmTOlg7jlslamWq12c3NzdnZOSUmZNu3B/klrbQOj/QTW3ohXXnll5syZ
276SUlJeXl58+bNs9Eqi0M3efLk+Ph4cZ+89FBMG2+61B5rfTQfCvPPlclbY6Lcj5y1DNaG17iP1ti/
277z02r1YZNmhg2aWKFTmZ5zEof05Fjx9q0buXk6JhXxtnJqVWLFkePHWeMDQ0ZsvbH9eIX4/f//VFq
278mLV0xtjgES+Uu1wNqm5UpXImjB937sSxCeNeMknXarUKhcKg1yckJn68eImUbtKAcvMPHTL4v+v/
279l5OTm5OTu279Bil97JjRHy/+7J/omOzs7MtXrs57b4FUZlUPvsl4lhNxBw/ory4pad+uHQC0a/uc
280wcAPHtBfXBU2eVJAQMOpb4dPfTs8sFGjKZMm2ijHy8tz1VdfHDp8+Oet20xWde3cKS8/f0C/vgAw
281sH//+3l55gdxJ708fsacuZV1Va61cywJIS1atIiIiIiIiGjevHnz5s0PHTp06NCh5s2bE0JmzJgR
282Hh7et29fQsjIkSPDwsLCw8PFreRyedOmTV999VWpnEWLFjVs2LBdu3adO3fu1auXg4ODmB4eHj5q
2831Kjx48d7eHiEhYVNnDhROr3T5GxPG400Z23z9957r0+fPnK53OJLABg0aFCXLl3at28fHBy8YMEC
284kxKOHj3aq1cv8YRY42VCyMKFC4OCgtq3b9+lSxfxcKzU8ZYtW3br1q1bt26tW7deuHChmD506NC7
285d++GhoYSQkJDQ7OysoYOHWq78eWWuX79+oULF9apU2fw4MH9+vWT8ltrm3GZ1t6Id955p2fPngMH
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
430f/9+WlpaTk7Ojz/+SBauWbMmMzMzNTU1NTU1LS1t7dq1ZHloaOiSJUsqKytv3Lhx584dnf3SRlv7
4312sopGgMAAACAEELC1w4dOkRoceTosdmR88h/q9dFP83L11bz0KFDZQyUlJTEx8crLzj/5DZB2UFB
4322cH5J7cRBHF+c3tc9AQXPTm/uT1BEOHRSUXl1UXl1eHRScpLGRkZ1dbWqp8IJV96eHg8fvyYnC4t
433LXV1daWqkQ8TJAhCJBJxOByd9Z89e6axv1VVVW3atKGqqVegCvl8fnBwcHBwsMbK1EuVdSGEMjMz
434yemMjAx3d3dyun379lR5eno6Vd62bdvY2NjCwkLlxrX1iyZabe1rK6cW1BgAAAAAgiAa/xcw6nmM
435q8AlckIiJzAFjhDCMQJhMqSQ4q/PKssxTIZhKse4dnZ2RUVFKomWellQUODh4cFischvIinXpL6Y
436ZGZmJhaLddZ3cXGhplNTU/v162djY8NisaysrEpKSugHhGzQ09PT0NCQyTVm5XUhhNq3b09OuLu7
4378/l8clogEFDlHTp0oMrPnDmTnJzs6enZsWPHS5cu6eyXNtra11ZO0RgAAAAAVNffnHJychw44It2
438bq40dZhcx8UwjHjz1DSGYVUSRZVYQZ5AxhSEorJIUVWEKf7NuNUS6SuJVCXjBgYGHjhwQFskLi4u
439+fn51B8X1KnpetRXvuwaHBw8adKk3NxchUIhFAp1Nku2VlZWFh8fb29vTxay2eza2lpyurS0VLm+
440yiXevLw8aqJ169bkNI/Ho8pzc3Opci8vr9OnT5eXl8fExEydOrV+40DTvrZyisYAAAAAoDplXDLd
441MvmOkM4DXPUWcAyvEmNVEgzHyGNcXFFZpKgsJl9iGPZKIqmWSHD8jWyxcuXKw4cPz58/Pzs7WywW
442v3z5MjExkZo7c+bMadOmZWdny2Sy9PT04OBg+rAZ1heJRJaWllwut6CgYPr06fRtatOjR4+NGzeK
443RKL8/PxvvvmGpmZUVBSfz+fz+VFRURMmTCALQ0JCIiIiiouLi4uLIyIiQkJCqPKsrCzy21nkvVfM
444+6WMpn2N5coLqgcAAAAAMc+4DNMti8XCcdzQ0JAm3RoaGuI4rrI7NjU0PnH31Ym7r4xZhgghQxPL
44586dXnT+9ysCIixBimxjuO/pw/9GHJkZvLOXq6nr79u2XL1/279/f0tLygw8+2L9//59//knOnTNn
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
510x+N16tRJ2zdrAQAAgBapkTNuSUnJo0ePevfuHRAQoK1OdXX1rVu3yMe3Ne7amWOxWBp/aoN5BX0G
5118z6AQQAAtHiMziqXlT1nuDfMycnx8fHhcrk0jwDicrk+Pj45OTkNi7xJaPxV5+auRXYKAACaHUbH
512uGkZGTY21l7du+vcdxcVFfn6+pLPeqPB5XIFAoFyybrkeLFchhBiGxl/2y/0+qGeckklQsjIxMJ/
513SuqKPX/WShUIIY6p0cppvailWCxW586dMzIyqMAIgujSpUt2dnb9DpjencMsskcsFsvCwqJ9+/aB
514gYH/+9//7O3t69FUwzvViME0F3DMDQBodMyOcZ8/v/zblfsPH+rcBxEEofMxtwqFQiaTqVzlrZFI
515ZngazvA0FEmlCCG5pLJfaGK/0ESF7BVCSCSRzw32nBvsWStRzeVmZmaJiYnUy7Nnz3K5LeS3lAmC
516wHFcIBDs379fLBZ379792bNnEAwAADRTTO9VLi0tY5h0MQbUb6rCFbjyBIYRr1sjEELY6yfMY5jq
517ggsXLoyOjqZeRkdHL1q0iHoplUojIyOdnJycnJwiIyOlUik1a/369Y6Ojra2trNnz5bJZGSh+kE8
518juOrV69u166djY3N1KlTRSKRepefPHkyevRoW1tbKyuroKCgiooKqrW4uDg3NzcOh+Pn55eRkUGW
519y2Sy8PBwW1tbJyenDRs20I0mQlwu19PTc+vWrV999dWyZcu0RfXixQt7e/uXL19SC7548cLR0fHl
520y5dUpxQKxfLly11dXa2trTdt2sS8g40YjM7VadtkLBZL2ybbuXNn+/btTU1Nu3btevPmzYMHD3bs
5212JEc88ePH9N3U+M2oo7p4YQ8AKAR1eHbQQyTLpNjXIVCobIUhmHKE2oJmJqrmnFHjRr1/PnzP//8
522EyGUkpIiFAqDgoKouWvWrMnMzExNTU1NTU1LS1u7di0168qVK/fv309LS8vJyfnxxx+1dWfLli0p
523KSnJyclPnz6Vy+XLly9XrzNmzJjw8PDi4uLCwsLWrVt/++231KykpKSUlJSKiopBgwbNmDGDLFy7
524du2TJ0/S0tJSU1MvXbqkfSzf8PXXX1+9elVbVDY2NqNHj969ezdVf/fu3ePHj7e2tqZKoqOj//jj
525j+Tk5Ly8vOLiYuYdbMRgdK6uHpvswoULV65cefHixfjx4wcPHnz69OnLly9XVFQMHTqUGnOa9apv
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
606ExOp6SFDhqhXFb54YWlpSU6XlpWFfTWNmmVgoDlz5/zzz669+3KfPn31qoamGkJo9YrvDyckHIpP
607MDc3nzNrRk8fH+V4AAAAgObujeu4GhMt5cLlpB6e3clpRweH9WtXq99FxWKxlF+uWrsubMJ436VL
608zLncGpFo+Oix2hr/oIP7qu+XEwRx96+/12+KOXX8KH0wAAAAQPOi+6yyVCr9Jzd32864i5cvT50U
609RhYOHzpkY8zWgsIiuVyel//sh7XryHIrK6uCwiJqWbFYbGZmxjY1LS0r27RlK81aVv24rqCwUKFQ
610IIRYBiyamgAAAEBzRHevckDgIBaLxWabtnbm+Xj32LtjR6tWVuSskcOGGrBYy39YVVpW1qY1b+qk
611SWT5+LFjZkfNq6mpIW+eWjAvaseu3SvXrLW1sRk3etSNm7e0rau3n9+ylavKyspcXV2XLlrUeB0E
612AAAA3gksoVBITiUmJsKJXAAAAKCJwJMMAAAAAH2AjAsAAADoA2RcAAAAQB8g4wIAAAD6ABkXAAAA
6130AfIuAAAAIA+QMYFAAAA9AEyLgAAAKAPkHEBAAAAfYCMCwAAAOjDG7+rbGNj87biAAAAAFq2Rj7G
614VXlaH43bt2937NiRef2W533uOwAAvIfe2lnlhQsXRkdHEwTxtgIAAAAA9OmNjMvSpIlWnJaWNnjw
6154HovXlVV9e2333bs2NHMzMzGxmbEiBHXrl2j5mZkZAwePNjCwsLCwmLw4MHp6ekqi2/YsMHIyGjD
616hg3a2if7bmBgYGVl5enpuXjx4vLy8npHCwAAALyRcYnXVKabQnV1tampab0XHzdunFAovHDhQmVl
617ZU5Ozvjx41etWkXOys3N7du3b//+/f/5559//vnniy++6NevX25uLrUsjuM7d+6MiYmJi4vDcVzb
618KgiCwHFcIBDs379fLBZ379792bNn9Q4YAADA+0742qFDh9QzrkQiiYiIcHR0dHR0jIiIkEgk9OXU
619glevXvX09GSz2a6urnv27CHepBwAfWubN29u06YNi8VSaYHD4VRWVhKaTJgw4fvvv1cuWb58+cSJ
620E6mXiYmJXl5eBEH4+PhcuHBBYyNI6W8O0rJly6hGMAxbtWqVm5ubtbX1lClTampqhEKhnZ3dixcv
621qPpCodDBweHFixfqlVVWQdP96OhoBwcHGxub8PBwqVSqbe0ah4t+EwAAANAzHddx16xZk5mZmZqa
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
7346tMMOLVdNMassb8A1ImRkVHA559d/f13hFBGZubk0InpmVkIod+uXgvo87mR0b/n26LmznFydGSz
7352eNGj3ryzz9k4d6dO7p//JGJiQmXy/16yuS//k6tw3oNDYVCYWVVlaODw4KoSPUKB6e4ebqYmRqx
736zE0Npn9ur55UEEIR/R3szP+N8NzDynkDHHmtjC3YhuF97a8/qaFv57esVxH9HO0tjOwtjCL7O5CF
737n7TjcowNrmVXI4SKX8rv5otGe9NdpJsf6ORsZcw2ZoX0tHlS+u8n3dAQVdRglbW4o6XxokFOGhdk
7380jv6fmmMn/L9qtXTpk75ol8/muABRcO9ygqFAiFEJsXBAwP/FzGXIIiNW7Ze/u0KQqiVldW2mM2O
739DqrjTrr7d+rWjXQn9B+lpe2M3Wpra4MQij9+4llB4a7tPyGE1q7fkHD8xJSwUPpw791/sGfHdoTQ
740ug2bjp44OWmi5mTwe9IllROwp06fefgobfP6deZc8592xu0/fGTW9GnkrDt//73hxzW2Njanzpxd
741vHRZ948/Wr92tY219akzZ2Nit8VsiEYIrYneEBE+y/cTn5eVlYcTjqqfmNIY28Tg4O27dvl//pmB
742gQFC6HDC0VEjhnO5XOWljp38OS09fdP/27vzuCaufQHgJ6SQSAgISciCil5pe/teq1RAlnolUJf6
743WnEBRVBs1SrIouBG3607LogiooCEVSkgonaxraJWQKvv3daliO21fV4XsJDEJFplCTAkeX+MneYm
744k0lCNVj6+3766SeZmXPO73fOkDNb4o7tzmznsooKfOHGLVsT4+I+TF2DYVjxgYOFpQdWJS+3PKny
745Q1Vy+f0SST5CKD0zk9ieosOJcbl0+YpxzNSDAoCF3po0cUdm1rR33m5ra//PV15pa3vc09NTc/rM
746+r9/QGzj5uqKv2AwGMRB4U83b0qKiv9161ZbWztCCN85LbRl44ayioqD5RVOTk5J8XH+foZ3uH6S
747deXVKW7e727r0iCE6HY040r4zvbEa/ljbG7hHeItsbmpehSPMZHrk+JD3ByIgu++wdlfpwj9K7v4
748gnKuP4fxAkm7BDfWk0vBjBdo3b1PTo23zxxy4KKy9KKSzbRbPoEf8BeWcUFLsqPOy1T8uNt37gb/
749bRxF5ECfyXNcR0dHhNCJmlNZe3PSd2Xi062zs3POnt0iocDUjd5Hjx6583jEW/yETP+cNWnpUny6
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
884"
885 id="image2993"
886 x="0"
887 y="0" />
888</svg>
diff --git a/doc/book-enea-linux-user-guide/doc/introduction.xml b/doc/book-enea-linux-user-guide/doc/introduction.xml
new file mode 100644
index 0000000..ccbdb0a
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/introduction.xml
@@ -0,0 +1,55 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="intro">
3 <title>Introduction</title>
4
5 <para>Welcome to Enea<trademark class="registered"></trademark> Linux</para>
6
7 <para>Enea<trademark class="registered"></trademark> Linux is based on the
8 open source configuration system Yocto which is becoming the de facto
9 standard for building and configuring embedded Linux. Yocto development is
10 coordinated by the Yocto Project which was initiated by the Linux
11 Foundation.</para>
12
13 <para>The Yocto-based development environment of Enea Linux allows you to
14 build embedded Linux kernels and tool chains on a Linux host. It aids you in
15 customizing embedded Linux kernels for a specific hardware architecture, and
16 in building and troubleshooting embedded Linux applications on targets or
17 emulated in QEMU.</para>
18
19 <para>Enea Linux also provides verified and easily installed board support
20 packages (BSP) for a number of hardware architectures. Each BSP includes a
21 Linux kernel and a root filesystem (rootfs), plus a number of packages that
22 can be extended on request.</para>
23
24 <para>Providing true open source Linux with customer interests in mind, is
25 the cornerstone for Enea when supplying Enea Linux. We provide:</para>
26
27 <itemizedlist>
28 <listitem>
29 <para>A Yocto compatible environment, familiar for those who have used
30 Yocto from any other distribution.</para>
31 </listitem>
32
33 <listitem>
34 <para>The Enea Linux environment is fully independent from hardware
35 vendor leverage and does not push for a particular hardware
36 architecture.</para>
37 </listitem>
38
39 <listitem>
40 <para>Enea has initiated and contributes the ptest package test
41 framework to the Yocto Project. Enea also uses ptest to verify the
42 packages on target.</para>
43 </listitem>
44 </itemizedlist>
45
46 <para>By using, testing Yocto and sharing Linux patches with upstream
47 projects, Enea assists the open source community in providing mature
48 software in less time. As an Enea Linux user, you are welcome to contribute
49 to the global development of Linux by propagating your Linux patches through
50 Enea.</para>
51
52 <para>Enea can also assist a customer by analyzing source code and producing
53 valid open source reports, as required by the community when open source
54 components are used.</para>
55</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-user-guide/doc/preface.xml b/doc/book-enea-linux-user-guide/doc/preface.xml
new file mode 100644
index 0000000..1752ff5
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/preface.xml
@@ -0,0 +1,157 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="preface">
3 <title>Preface</title>
4
5 <section id="guide_purpose">
6 <title>The Purpose of this Guide</title>
7
8 <para>This guide is intended for all Enea Linux developers who want to
9 configure and build customized Linux kernel images for embedded system
10 targets, but also for developers who want to build and run applications in
11 Enea Linux.</para>
12
13 <note>
14 <para>Always read the README files and the Release Information before
15 this User's Guide.</para>
16 </note>
17
18 <para>The recommended order of operations for developers are:</para>
19
20 <orderedlist>
21 <listitem>
22 <para>Receive information from Enea and read the initial documentation
23 online.</para>
24 </listitem>
25
26 <listitem>
27 <para>Update the development host with the needed packages, then
28 download and install Enea Linux.</para>
29 </listitem>
30
31 <listitem>
32 <para>Download and install the Cross-Compilation Toolchain.</para>
33 </listitem>
34
35 <listitem>
36 <para>Start developing your own Enea Linux applications or building
37 your own Enea Linux images.</para>
38 </listitem>
39 </orderedlist>
40
41 <para>It is assumed that the reader of this User's Guide has a deep
42 knowledge about Linux, how to configure the Linux kernel, and knows how to
43 use the Yocto build system. The variety of information provided in this
44 guide can serve as a quick start introduction to the standards and best
45 practices we share with the Linux community. In this spirit, Enea provides
46 <ulink url="http://www.enea.com/training">training courses</ulink>.</para>
47
48 <para>With this Enea Linux release you have a verified and easy to install
49 board support package for a number of supported hardware types. The board
50 support package includes a set of prebuilt utilities, accessible and setup
51 to rapidly reach your objectives as a developer. In this regard, the
52 support package contains a Linux kernel and root file system, a Software
53 Development Kit (SDK) which includes the cross-compilation toolchain, a
54 variety of tools and scripts for development and customization, and if
55 opted for, a user-friendly Eclipse version with an integrated development
56 environment.</para>
57
58 <para>The documentation for Enea Linux consists of generic and
59 distribution-specific documents. The generic documents are common for
60 several Enea Linux distributions. The main documents are:</para>
61
62 <table>
63 <tgroup cols="2">
64 <tbody>
65 <row>
66 <entry>Enea Linux Release Information</entry>
67
68 <entry>A distribution specific document detailing what the current
69 release contains, including supported features, references to
70 other documentation, known problems and limitations, and Enea
71 support contact information.</entry>
72 </row>
73
74 <row>
75 <entry>README files for the distribution</entry>
76
77 <entry>Distribution specific documents that serve as an
78 introduction and how-to for this release, where you also find
79 target specific commands and parameters, replacing the generic
80 examples in the User's Guide. These files also point to Build,
81 Boot, and Configuration information details for this
82 distribution.</entry>
83 </row>
84
85 <row>
86 <entry>Enea Linux User's Guide</entry>
87
88 <entry>The generic manual for developers who build Linux kernels
89 for embedded systems or use prebuilt Linux kernels.</entry>
90 </row>
91
92 <row>
93 <entry>Enea Linux Open Source Report</entry>
94
95 <entry>The distribution specific list of software packages with
96 corresponding Open Source Licenses, that are included in the Enea
97 Linux distribution.</entry>
98 </row>
99
100 <row>
101 <entry>Enea Linux Security Report</entry>
102
103 <entry>The release specific document listing the CVEs affecting
104 this distribuition.</entry>
105 </row>
106 </tbody>
107 </tgroup>
108 </table>
109
110 <para>See also the following generic documentation related to the Yocto
111 project, which actually is based on OpenEmbedded.</para>
112
113 <itemizedlist>
114 <listitem>
115 <para><ulink
116 url="https://www.yoctoproject.org/documentation/archived">https://www.yoctoproject.org/documentation/archived</ulink>
117 - Yocto project documentation. Search for the Yocto version included
118 in your Enea Linux distribution.</para>
119 </listitem>
120 </itemizedlist>
121
122 <itemizedlist>
123 <listitem>
124 <para><ulink
125 url="http://docs.openembedded.org">http://docs.openembedded.org</ulink>
126 - OpenEmbedded documentation, useful since Yocto is based on
127 OpenEmbedded.</para>
128 </listitem>
129 </itemizedlist>
130
131 <itemizedlist>
132 <listitem>
133 <para><ulink
134 url="https://wiki.yoctoproject.org/wiki">https://wiki.yoctoproject.org/wiki
135 </ulink>- Yocto Wiki, useful information for Yocto users</para>
136 </listitem>
137 </itemizedlist>
138
139 <itemizedlist>
140 <listitem>
141 <para><ulink
142 url="https://wiki.yoctoproject.org/wiki/Ptest">https://wiki.yoctoproject.org/wiki/Ptest</ulink>
143 - Ptest wiki. Ptest was initiated by Enea, for building, installing
144 and running package test suites</para>
145 </listitem>
146 </itemizedlist>
147
148 <itemizedlist>
149 <listitem>
150 <para><ulink
151 url="http://www.crashcourse.ca/wiki/index.php/Poky_Variable_Glossary">http://www.crashcourse.ca/wiki/index.php/Poky_Variable_Glossary</ulink>
152 - Explanation of some Yocto/Poky variables used in the build
153 configuration files.</para>
154 </listitem>
155 </itemizedlist>
156 </section>
157</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml b/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml
new file mode 100644
index 0000000..2215ba8
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/prerequisites_and_requirements.xml
@@ -0,0 +1,101 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="prereq_reqs">
3 <title>Prerequisites and Requirements</title>
4
5 <para>Building Enea Linux or compiling applications requires that your git
6 environment be setup properly and for certain packages to be installed on
7 your Linux development host. The following chapter details the
8 configurations needed on the build environment in order to properly use Enea
9 Linux.</para>
10
11 <section id="gitconfig">
12 <title>Git Configuration</title>
13
14 <para>If you intend to get Enea Linux sources and build Enea Linux
15 yourself, you will need Git installed in your build environemtn. Please
16 refer to <ulink
17 url="https://git-scm.com/book/en/v2/Getting-Started-First-Time-Git-Setup">Getting
18 Started - First-Time Git Setup</ulink>, for more details on how to set up
19 your git environment correctly, including how to set your identity using
20 the following commands:</para>
21
22 <programlisting>$ git config --global user.name "John Doe"
23$ git config --global user.email johndoe@example.com</programlisting>
24 </section>
25
26 <section id="hostpackages">
27 <title>Host Packages</title>
28
29 <para>In order to work with Enea Linux, you need a set of tools installed
30 on the build machine, depending on the scenario you use. The following
31 chapters will describe what tools to install on the build machine.</para>
32
33 <section id="prebuiltprereq">
34 <title>Using Pre-Build Binaries</title>
35
36 <para>Using the pre-built binaries, you can get up and running more
37 quickly. Since building is not required, there are not a lot of packaes
38 and tools that need to be installed but a few are still required:</para>
39
40 <itemizedlist>
41 <listitem>
42 <para>wget - for downloading the Enea Linux binaries</para>
43 </listitem>
44
45 <listitem>
46 <para>tar - for decompressing the Enea Linux release</para>
47 </listitem>
48
49 <listitem>
50 <para>tftpboot server - for deploying Enea Linux on target</para>
51 </listitem>
52
53 <listitem>
54 <para>NFS server - in case you want to mount the root file system
55 over NFS</para>
56 </listitem>
57 </itemizedlist>
58 </section>
59
60 <section id="hostprereqpackages">
61 <title>Required Packages for the Host Development System</title>
62
63 <para>Building Enea Linux requires a set of packages to be installed on
64 your Linux development host. The list of required packages is described
65 in the <ulink
66 url="https://www.yoctoproject.org/docs/2.5/ref-manual/ref-manual.html#required-packages-for-the-host-development-system">Yocto
67 Project reference manual</ulink>.</para>
68 </section>
69 </section>
70
71 <section id="sysshell_config">
72 <title>Default Shell Configuration</title>
73
74 <para>Before installing Enea Linux, make sure that
75 <filename>bash</filename> is the default shell.</para>
76
77 <para><emphasis role="bold">To verify the default system
78 shell</emphasis></para>
79
80 <itemizedlist>
81 <listitem>
82 <para>If your system runs Ubuntu, use list to verify if
83 <filename>/usr/bin</filename> is a symbolic link to <emphasis
84 role="bold">bash</emphasis>:</para>
85
86 <programlisting># ls -l /bin/sh
87lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; bash</programlisting>
88 </listitem>
89
90 <listitem>
91 <para>Optionally, in case the link points to <literal>dash</literal>,
92 change it through the following steps:</para>
93
94 <programlisting># ls -l /bin/sh
95lrwxrwxrwx 1 root root 4 2012-03-02 11:53 /bin/sh -&gt; dash
96# sudo dpkg-reconfigure dash
97Use dash as the default system shell (/bin/sh)? No</programlisting>
98 </listitem>
99 </itemizedlist>
100 </section>
101</chapter>
diff --git a/doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml
new file mode 100644
index 0000000..8f3ada0
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/real_time_in_enea_linux.xml
@@ -0,0 +1,26 @@
1<?xml version="1.0" encoding="UTF-8"?>
2<chapter id="real_time">
3 <title>Real-Time in Enea Linux</title>
4
5 <para>Additional packages providded by RT profile:</para>
6
7 <itemizedlist>
8 <listitem>
9 <para>bitcalc, 1.0-r0.0</para>
10 </listitem>
11
12 <listitem>
13 <para>count-ticks, 1.1-r1.0</para>
14 </listitem>
15
16 <listitem>
17 <para>partrt, 1.1-r0.0</para>
18 </listitem>
19 </itemizedlist>
20
21 <section id="Benchmark">
22 <title>Benchmark</title>
23
24 <para>TBD.</para>
25 </section>
26</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-user-guide/doc/troubleshooting.xml b/doc/book-enea-linux-user-guide/doc/troubleshooting.xml
new file mode 100644
index 0000000..298bdd9
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/troubleshooting.xml
@@ -0,0 +1,10 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter condition="hidden" id="troubleshooting">
3 <title>Troubleshooting</title>
4
5 <section id="placeholder_id">
6 <title></title>
7
8 <para></para>
9 </section>
10</chapter> \ No newline at end of file
diff --git a/doc/book-enea-linux-user-guide/doc/using_eclipse.xml b/doc/book-enea-linux-user-guide/doc/using_eclipse.xml
new file mode 100644
index 0000000..f6c7759
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/using_eclipse.xml
@@ -0,0 +1,1225 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="use_eclipse">
3 <title>Using Eclipse</title>
4
5 <section id="install_eclipse">
6 <title>Installing Eclipse</title>
7
8 <para>For instructions on how to install Eclipse Oxygen, please refer to
9 the <ulink
10 url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">Yocto
11 Project Software Development Kit (SDK) Developer's Guide</ulink>, chapter
12 4.3.2.1. Although the instructions listed there currently, refer to the
13 Neon release of Eclipse, the same steps still apply to the Oxygen release,
14 with some small differences:</para>
15
16 <itemizedlist>
17 <listitem>
18 <para>In <emphasis role="bold">step 1</emphasis> from chapter
19 4.3.2.1.1, the URL for downloading Eclipse should be <ulink
20 url="http://www.eclipse.org/oxygen">http://www.eclipse.org/oxygen</ulink>
21 instead.</para>
22 </listitem>
23
24 <listitem>
25 <para>In <emphasis role="bold">step 3</emphasis> from chapter
26 4.3.2.1.2, the correct option in the drop-down menu should look like:
27 <emphasis>Oxygen -
28 http://download.eclipse.org/releases/oxygen</emphasis>.</para>
29 </listitem>
30
31 <listitem>
32 <para>In <emphasis role="bold">step 5</emphasis> from chapter
33 4.3.2.1.2, under the category <emphasis role="bold">Mobile and Device
34 Development</emphasis>, select <emphasis role="bold">C/C++ GDB
35 Hardware Debugging</emphasis> as well.</para>
36 </listitem>
37 </itemizedlist>
38 </section>
39
40 <section id="install_yocto">
41 <title>Installing Yocto Plug-ins</title>
42
43 <para>Retrieve the archive containing the Yocto Plug-ins from the Enea
44 Linux release location and save it on your local machine. The archive file
45 has the following format:
46 <filename>org.yocto.sdk-&lt;release&gt;-&lt;date&gt;-archive.zip</filename>.</para>
47
48 <para>To install the Yocto Plugins in Eclipse, follow the instructions in
49 <ulink
50 url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html#adt-eclipse">chapter
51 4.3.2.1.3.2</ulink>. of the Yocto Manual, starting with <emphasis
52 role="bold">step 8</emphasis>. In <emphasis role="bold">step 12</emphasis>
53 use the local archive that you downloaded previously.</para>
54
55 <para>To make sure that all required packages have been installed, go to
56 the menu <emphasis role="bold">Help &gt; Install New Software &gt; Eclipse
57 version</emphasis>, and select the version you use (e.g. Oxygen), to add
58 any missing packages. You can also check what packages are currently
59 installed by pressing the <emphasis role="bold">What is Already
60 Installed?</emphasis> link, as seen below.</para>
61
62 <mediaobject>
63 <imageobject role="fo">
64 <imagedata align="center" contentwidth="600"
65 fileref="images/install_new_sw.svg" />
66 </imageobject>
67
68 <imageobject role="html">
69 <imagedata align="center" fileref="images/install_new_sw.png" />
70 </imageobject>
71 </mediaobject>
72 </section>
73
74 <section id="eclipse_remote_connection">
75 <title>Setting up a TCF Connection from Eclipse</title>
76
77 <para>Eclipse supports several types of remote connections to reference
78 boards. Among these is the Target Communication Framework (TCF) type of
79 connection. This information will be referenced throughout this guide, as
80 it is used by several features.</para>
81
82 <para><emphasis role="bold">How to set up a TCF connection to the target
83 to be used later on</emphasis><remark>Should we add images to this
84 procedure to make it easier to understand?</remark></para>
85
86 <orderedlist>
87 <listitem>
88 <para>Make sure the <literal>tcf-agent</literal> is running on the
89 target:</para>
90
91 <programlisting>ps aux | grep tcf-agent
92root 329 0.0 0.2 1864824 2600 ? Ssl 12:47 0:08 /usr/sbin/tcf-agent -d -L- -l0</programlisting>
93 </listitem>
94
95 <listitem>
96 <para>Open the Target Explorer perspective from <emphasis
97 role="bold">Window &gt; Perspective &gt; Open Perspective &gt;
98 Other... &gt; Target Explorer</emphasis>.</para>
99
100 <para>This will open a new perspective, containing the <emphasis
101 role="bold">System Management</emphasis> view.</para>
102 </listitem>
103
104 <listitem>
105 <para>The <emphasis role="bold">System Management</emphasis> window
106 displays all existing TCF connections and allows you to manage them.
107 To create a new connection, go to <emphasis role="bold">Connections
108 &gt; Create New Connection...</emphasis></para>
109 </listitem>
110
111 <listitem>
112 <para>Type in an appropriate name in the <emphasis
113 role="bold">Connection Name</emphasis> field.</para>
114 </listitem>
115
116 <listitem>
117 <para>Select <literal>TCP</literal> in the <emphasis
118 role="bold">Transport Type</emphasis> section.</para>
119 </listitem>
120
121 <listitem>
122 <para>Fill in the target's IP address and leave the <emphasis
123 role="bold">Port</emphasis> as it is (1534).</para>
124 </listitem>
125
126 <listitem>
127 <para>Check the <emphasis role="bold">Connect on finish</emphasis>
128 checkbox and click <emphasis role="bold">Finish</emphasis>.</para>
129 </listitem>
130 </orderedlist>
131
132 <para>The connections created will be persistent and accessible from the
133 <emphasis role="bold">Debug Configurations</emphasis> plugins.</para>
134 </section>
135
136 <section id="eclipse_devapps">
137 <title>Developing Applications in Eclipse</title>
138
139 <section id="crosscomp">
140 <title>Cross-Compiling from Eclipse</title>
141
142 <tip>
143 <para>Watch Enea's video about <ulink
144 url="https://www.youtube.com/watch?v=i6KaMrhVOw8&amp;list=PLF6PIT9GsZ19sUvQOCQnfgoWkQTc5CvGS">Cross-compiling
145 and Remote Debugging of Applications</ulink>.</para>
146 </tip>
147
148 <para>In order to use Eclipse to compile an application for a certain
149 target architecture, you need to first install a cross-compilation
150 toolchain<indexterm>
151 <primary>cross-compilation toolchain</primary>
152 </indexterm><indexterm>
153 <primary>toolchain</primary>
154
155 <secondary>cross-compilation</secondary>
156 </indexterm> (SDK<indexterm>
157 <primary>SDK</primary>
158 </indexterm>), configure the cross-compiler in Eclipse, and then
159 create a <emphasis>Yocto ADT Autotools project</emphasis> , which uses
160 the Yocto SDK.<remark>INFO: This project type is still called ADT in
161 Eclipse even though Yocto talks about standard and extentible
162 SDK</remark></para>
163
164 <para>Installing the cross-compilation toolchain is pretty
165 straightforward. All you have to do is to run the shell script provided
166 with the release and follow the instructions, see <link
167 linkend="install_el_sdk">Installing a Cross-Compilation Toolchain
168 (SDK)</link>.</para>
169
170 <para>Before creating the project, you must first configure the
171 cross-compiler<indexterm>
172 <primary>cross-compiler</primary>
173 </indexterm> in Eclipse:<remark>Should images be added to the
174 procedure below for ease of understanding?</remark></para>
175
176 <orderedlist>
177 <listitem>
178 <para>Select <emphasis role="bold">Window &gt; Preferences &gt;
179 Yocto Project ADT</emphasis> to open a dialog.<remark>INFO: This
180 project type is still called ADT in Eclipse even though Yocto talks
181 about standard and extentible SDK</remark></para>
182 </listitem>
183
184 <listitem>
185 <para>Choose a <emphasis role="bold">Stand-alone pre-built
186 toolchain</emphasis>.</para>
187 </listitem>
188
189 <listitem>
190 <para>For the <emphasis role="bold">Toolchain Root
191 Location</emphasis> option, specify the path to the
192 cross-compilation toolchain, e.g.
193 <filename>/opt/enea/&lt;sdkversion&gt;</filename>.</para>
194 </listitem>
195
196 <listitem>
197 <para>For the <emphasis role="bold">Sysroot Location</emphasis>
198 option, specify the path to the target sysroot directory inside the
199 toolchain root location e.g.
200 <literal>&lt;extsdkdir&gt;/tmp/sysroots/corei7-64-enea-linux/</literal></para>
201 </listitem>
202
203 <listitem>
204 <para>If multiple architectures are supported by the SDK, select the
205 desired target architecture from the drop-down list.</para>
206
207 <tip>
208 <para>You can save different profiles with different
209 configurations. This makes it easy to compile the same code for
210 different architectures by simply choosing the desired development
211 profile.</para>
212 </tip>
213 </listitem>
214
215 <listitem>
216 <para>In <emphasis role="bold">Target Options</emphasis>, select the
217 <emphasis role="bold">External HW</emphasis> option.</para>
218 </listitem>
219 </orderedlist>
220
221 <tip>
222 <para>More details on how to configure the cross-compiler can be found
223 in the <ulink
224 url="http://www.yoctoproject.org/docs/2.5/sdk-manual/sdk-manual.html"><emphasis>Yocto
225 Project Software Development Kit (SDK) Developer's Guide
226 2.5</emphasis></ulink>. Change the Yocto version in the link if
227 needed.</para>
228
229 <para>There is also a good cheat sheet available in Eclipse, under
230 <emphasis role="bold">Help &gt; Cheat Sheets &gt; Yocto Project &gt;
231 Creating a Hello World ANSI C or C++ Autotools Project</emphasis>.
232 This cheat sheet covers all the steps up to building the
233 project.</para>
234 </tip>
235
236 <para>Once you have configured the default options for the
237 cross-compiler you can create a project:</para>
238
239 <orderedlist>
240 <listitem>
241 <para>Follow the steps in the wizard to create the project:</para>
242
243 <orderedlist numeration="loweralpha" spacing="compact">
244 <listitem>
245 <para>Select <emphasis role="bold">File &gt; New &gt; Project
246 &gt; C Project</emphasis> and click <emphasis
247 role="bold">Next</emphasis>.</para>
248 </listitem>
249
250 <listitem>
251 <para>Select <emphasis role="bold">Yocto Project ADT Autotools
252 Project &gt; Hello World ANSI C Autotools Project</emphasis>,
253 and give the project a <emphasis role="bold">Project
254 name</emphasis> before clicking <emphasis
255 role="bold">Next</emphasis>.<note>
256 <para>Having a hyphen character '<literal>-</literal>' in
257 the name can cause configuration errors.</para>
258 </note></para>
259 </listitem>
260
261 <listitem>
262 <para>Enter the <emphasis role="bold">Author</emphasis> and
263 click <emphasis role="bold">Finish</emphasis>.</para>
264 </listitem>
265 </orderedlist>
266
267 <para>This will automatically generate all the files needed,
268 creating all necessary configurations for cross-compiling. For more
269 on how to create a project, watch <ulink
270 url="https://www.youtube.com/watch?v=2qxWae7srzE&amp;list=PLF6PIT9GsZ19sUvQOCQnfgoWkQTc5CvGS">Enea's
271 video about setting up an ADT project</ulink>.</para>
272 </listitem>
273
274 <listitem>
275 <para>Optionally, if you want to have specific options for
276 cross-compiling this project, select <emphasis role="bold">Project
277 &gt; Change Yocto Project Settings</emphasis> and modify the options
278 for this project only.</para>
279 </listitem>
280
281 <listitem>
282 <para>Right-click on the project from the Project Explorer and
283 choose <emphasis role="bold">Reconfigure Project</emphasis>. This
284 will generate the necessary makefiles to build the project.</para>
285 </listitem>
286
287 <listitem>
288 <para>Finally, build the project from <emphasis role="bold">Project
289 &gt; Build Project</emphasis>, or by right-clicking on the project
290 in the Project Explorer and selecting <emphasis role="bold">Build
291 Project</emphasis>. A binary file for the target architecture is
292 created in the project directory.</para>
293 </listitem>
294 </orderedlist>
295
296 <tip>
297 <para>If you need to add more files or compiler flags or parameters to
298 the Makefile, edit <filename>Makefile.am</filename> accordingly and
299 then reconfigure the project.</para>
300 </tip>
301
302 <note>
303 <para>Eclipse displays the results from building a project in one
304 Eclipse console, and reconfiguring a project in another one. Switching
305 between the two consoles is necessary to view both outputs.</para>
306 </note>
307 </section>
308
309 <section id="eclipse_debug">
310 <title>Debugging Applications from Eclipse</title>
311
312 <tip>
313 <para>Watch Enea's video about <ulink
314 url="https://www.youtube.com/watch?v=i6KaMrhVOw8&amp;list=PLF6PIT9GsZ19sUvQOCQnfgoWkQTc5CvGS">Cross-compiling
315 and Remote Debugging of Applications</ulink>.</para>
316 </tip>
317
318 <para>Using Eclipse you can build an application, deploy it on the
319 target, and debug <indexterm>
320 <primary>debug</primary>
321 </indexterm>the source code remotely, all with a single mouse click.
322 However, in order to achieve this you need to make certain
323 configurations.</para>
324
325 <para>When setting the cross-compiler options for a target, a run/debug
326 configuration is created as a <emphasis role="bold">C/C++ Remote
327 Application</emphasis> instance. The configuration is named according to
328 this syntax <literal>&lt;project&gt;_gdb_-&lt;suffix&gt;</literal>, for
329 example: <filename>hello_gdb_aarch64-enea-linux</filename>.</para>
330
331 <note>
332 <para>If a run/debug configuration is not created when setting the
333 cross-compiler options, perform the steps in <link
334 linkend="troubleshoot_build_debug_config">Run/Debug Configuration Not
335 Created</link>.</para>
336 </note>
337
338 <para>The instructions below describes how to use Eclipse to debug
339 single-process applications on a target. For information on how to debug
340 multi-process applications, see <link
341 linkend="eclipse_multi_debug">Debugging Multi-Process Applications from
342 Eclipse</link>.</para>
343
344 <para>Use the run/debug configuration to connect the Eclipse GDB
345 interface to the remote target, by doing the following:</para>
346
347 <remark>Should we add images for the procedure below as well?</remark>
348
349 <orderedlist>
350 <listitem>
351 <para>Select <emphasis role="bold">Run &gt; Debug Configurations
352 &gt; C/C++ Remote application</emphasis> from the menu and choose
353 the run/debug configuration from the instances under <literal>C/C++
354 Remote Application</literal> in the left pane. You can rename,
355 duplicate or remove the configuration as needed.</para>
356 </listitem>
357
358 <listitem>
359 <para>In the <emphasis role="bold">Main</emphasis> tab, do the
360 following:</para>
361
362 <orderedlist spacing="compact">
363 <listitem>
364 <para>Select an existing <emphasis
365 role="bold">Connection</emphasis> from the drop-down list, or
366 create a new one following the steps below:</para>
367
368 <orderedlist>
369 <listitem>
370 <para>To create a new connection, click the <emphasis
371 role="bold">New...</emphasis> button and select a connection
372 type. For debugging applications an <emphasis
373 role="bold">SSH</emphasis> connection is recommended.</para>
374 </listitem>
375
376 <listitem>
377 <para>Choose a connection name and fill in the <emphasis
378 role="bold">Host information</emphasis> section with the
379 target's IP and the username.</para>
380
381 <note>
382 <para>For Enea Linux, the default username is <emphasis
383 role="bold">root</emphasis> and there is no password
384 set.</para>
385 </note>
386 </listitem>
387
388 <listitem>
389 <para>Depending on your network setup, select either
390 <emphasis role="bold">Public key</emphasis> or <emphasis
391 role="bold">Password-based authentication</emphasis>. If
392 using Password-based authentication, leave the field empty
393 when using the default <emphasis role="bold">root</emphasis>
394 username.</para>
395 </listitem>
396
397 <listitem>
398 <para>Click Finish. The new connection should now be
399 available in the dropdown menu. This connection will be
400 persist through all Run/Debug configurations.</para>
401
402 <para>You can manage your saved connections in the <emphasis
403 role="bold">Connections </emphasis>view from <emphasis
404 role="bold">Window -&gt; Show View -&gt; Other... -&gt;
405 Connections</emphasis>.</para>
406 </listitem>
407 </orderedlist>
408 </listitem>
409
410 <listitem>
411 <para>Select the binary <emphasis role="bold">C/C++
412 Application</emphasis> you want to deploy.</para>
413
414 <para>If you click the <emphasis role="bold">Search
415 Project</emphasis> button, Eclipse will parse the project and
416 provide a list of all compiled binaries to choose from.
417 Alternatively, you can <emphasis role="bold">Browse</emphasis>
418 the file system for a binary, or use <emphasis
419 role="bold">Variables</emphasis> to manually define the
420 path.</para>
421 </listitem>
422
423 <listitem>
424 <para>The <emphasis role="bold">Remote Absolute File
425 Path</emphasis> is the path to which the binary on the target
426 shall be deployed. Type it directly or click the <emphasis
427 role="bold">Browse</emphasis> button and select a location on
428 the remote target. Note that you need to specify the path
429 including the filename.</para>
430 </listitem>
431
432 <listitem>
433 <para>Optionally, you may choose not to download the application
434 to the target, but instead debug an already downloaded
435 application.</para>
436 </listitem>
437
438 <listitem>
439 <para>You can also configure Eclipse to execute commands prior
440 to launching the application, by specifying the commands in the
441 corresponding field.</para>
442 </listitem>
443 </orderedlist>
444 </listitem>
445
446 <listitem>
447 <para>In the <emphasis role="bold">Arguments</emphasis> tab you can
448 specify various arguments to be passed to your application at
449 launch-time.</para>
450 </listitem>
451
452 <listitem>
453 <para>The <emphasis role="bold">Debugger</emphasis> tab deals with
454 GDB specific configurations. This is automatically populated when
455 configuring the cross-compiler. You may optionally choose
456 additionally useful options as with any Eclipse GDB interface, e.g.
457 whether to break at entering the main function or uploading shared
458 libraries.</para>
459 </listitem>
460
461 <listitem>
462 <para>To enable debugging with shared libraries, do the
463 following:</para>
464
465 <itemizedlist>
466 <listitem>
467 <para>Retrieve the debug sources from the target, and store them
468 in a dedicated folder on the local host. They are found in
469 <literal>/usr/src/debug</literal> in the target rootfs.</para>
470 </listitem>
471
472 <listitem>
473 <para>Set a path mapping your debug configuration. In the
474 <emphasis role="bold">Source</emphasis> tab, click <emphasis
475 role="bold">Add</emphasis>, select <emphasis role="bold">Path
476 Mapping</emphasis>, and assign paths to the mapping:</para>
477
478 <simplelist>
479 <member><emphasis role="bold">Compilation path</emphasis>:
480 <filename>/usr/src/debug</filename></member>
481
482 <member><emphasis role="bold">Local file system
483 path</emphasis> (path to the debug sources retrieved from the
484 target):<filename>
485 &lt;path_to_chosen_folder&gt;/usr/src/debug</filename></member>
486 </simplelist>
487 </listitem>
488
489 <listitem>
490 <para>In the <emphasis role="bold">Debugger/Shared
491 Libraries</emphasis> tab, select option <emphasis
492 role="bold">Load shared library symbols automatically</emphasis>
493 and set the path to the shared library. The path depends on the
494 processor architecture of your target.</para>
495
496 <para>For <emphasis role="bold">32-bit</emphasis> targets:
497 <filename>&lt;extsdkdir&gt;/sysroots/&lt;arch&gt;-enea-linux/lib/.debug
498 </filename></para>
499
500 <para>For <emphasis role="bold">64-bit</emphasis> targets:
501 <filename>&lt;extsdkdir&gt;/sysroots/&lt;arch&gt;-enea-linux/lib64/.debug</filename></para>
502
503 <para>Note that inside Eclipse you must load the shared
504 libraries with debug information (not stripped). Shared
505 libraries that get built into the rootfs of the target image
506 have debug information stripped off, for size and speed
507 optimizations.</para>
508 </listitem>
509
510 <listitem>
511 <para>To debug applications that depend on shared libraries
512 built outside the rootfs of the target image, the same procedure
513 applies, with the exception that you must upload the required
514 shared libraries to the target prior to starting the debugging
515 session.</para>
516
517 <para>If you upload them to <literal>/lib</literal> or
518 <literal>/lib64</literal> (depending on the target architecture)
519 they get loaded by default. Otherwise, you must correctly update
520 the <emphasis role="bold"><literal>
521 LD_LIBRARY_PATH</literal></emphasis> environment variable to
522 match their look-up path. In Eclipse, you can automatically
523 update this variable by setting the <emphasis
524 role="bold">Commands to execute before application</emphasis>
525 field to: <emphasis role="bold">export
526 <literal>LD_LIBRARY_PATH=&lt;path to uploaded shared
527 libs&gt;</literal> </emphasis></para>
528 </listitem>
529 </itemizedlist>
530 </listitem>
531
532 <listitem>
533 <para>Once you have set up all the debug configurations, click
534 <emphasis role="bold">Apply</emphasis> and <emphasis
535 role="bold">Debug</emphasis>. This will launch the GDB on the target
536 and open the <literal>Debug perspective</literal>. This is the
537 standard Eclipse GDB interface when debugging a remote target. You
538 can use all GDB features, such as setting breakpoints, stepping
539 through code, reading variable values, reading registers, viewing
540 memory, etc.</para>
541 </listitem>
542 </orderedlist>
543
544 <para>When the debugger starts, Eclipse opens three consoles:</para>
545
546 <orderedlist numeration="upperalpha" spacing="compact">
547 <listitem>
548 <para>The <emphasis role="bold">Remote Shell</emphasis> - used to
549 launch the application and display its output.</para>
550 </listitem>
551
552 <listitem>
553 <para>The <emphasis role="bold">GDB console</emphasis> - named as
554 the path to its GDB binary. You can use this console to control the
555 GDB from the command line.</para>
556 </listitem>
557
558 <listitem>
559 <para>The third console is named as the path of the binary on the
560 local machine, and is in fact an artifact that must be
561 ignored.</para>
562 </listitem>
563 </orderedlist>
564
565 <para>After having set up the debug configuration once, you can modify
566 and rebuild your application and then relaunch it by simply clicking the
567 <emphasis role="bold">Debug</emphasis> icon (the bug symbol) on the
568 toolbar. You can also select the drop-down list for more configurations,
569 and even add your configuration to the <emphasis
570 role="bold">Favorites</emphasis> to easily retrieve it next time.</para>
571
572 <para>If you only want to deploy and run the application, without
573 debugging, you can use the same configuration as the one set up for
574 debugging, but simply click the <emphasis role="bold">Run</emphasis>
575 icon (the Play button symbol) from the toolbar menu, or select <emphasis
576 role="bold">Run &gt; Run Configurations</emphasis> and Run the chosen
577 configuration.</para>
578 </section>
579
580 <section id="eclipse_multi_debug">
581 <title>Debugging Multi-Process Applications from Eclipse</title>
582
583 <para>In Eclipse, remote debugging of an application that uses multiple
584 processes<indexterm>
585 <primary>multiple processes</primary>
586 </indexterm> is slightly different compared to debugging a single
587 process application as described in <link
588 linkend="eclipse_debug">Debugging Applications from
589 Eclipse</link>.</para>
590
591 <para>The following limitations exist for multi-process
592 debugging:</para>
593
594 <itemizedlist spacing="compact">
595 <listitem>
596 <para>All debugged processes must share the same binary.</para>
597 </listitem>
598
599 <listitem>
600 <para>Debugging only works in non-stop mode, i.e. stopping at a
601 breakpoint only stops the current thread while other threads
602 continue to execute.</para>
603 </listitem>
604 </itemizedlist>
605
606 <note>
607 <para>When using the GDB to debug multiple instances of the same
608 process or thread, using the same symbols file, breakpoints will be
609 common to all instances. That is, when setting a breakpoint in the
610 code, all instances will stop there, and there is no way to filter
611 them. The current thread filter in Eclipse is ineffective.</para>
612 </note>
613
614 <para><emphasis role="bold">Use the run/debug configuration to connect
615 the Eclipse GDB client to the remote target</emphasis>:</para>
616
617 <orderedlist>
618 <listitem>
619 <para>Go to <emphasis role="bold">Window &gt; Preferences &gt;
620 Run/Debug &gt; Launching &gt; Default Launchers</emphasis>. Under
621 <emphasis role="bold">C/C++ Attach to Applicaton &gt;
622 Debug</emphasis> select the checkbox <emphasis role="bold">GDB (DSF)
623 Attach to Process via TCF/TE Launcher</emphasis>.</para>
624 </listitem>
625
626 <listitem>
627 <para>Select <emphasis role="bold">Run &gt; Debug Configurations...
628 </emphasis> from the menu and choose the run/debug configuration
629 from the instances under <literal>C/C++ Attach to
630 Application</literal> in the left pane. You can create, rename,
631 duplicate, or remove the configurations as needed.</para>
632 </listitem>
633
634 <listitem>
635 <para>If you followed <emphasis role="bold">step 1</emphasis>, in
636 the lower part of the dialog you will see that <emphasis
637 role="bold">Using GDB (DSF) Attach to Process via TCF/TE
638 Launcher</emphasis> is selected. If not, redo <emphasis
639 role="bold">step 1</emphasis> or click the <emphasis
640 role="bold">Select Other...</emphasis> link, and use configuration
641 specific settings by selecting the checkbox <emphasis
642 role="bold">GDB (DSF) Attach to Process via TCF/TE
643 Launcher</emphasis>.</para>
644 </listitem>
645
646 <listitem>
647 <para>In the <emphasis role="bold">Main</emphasis> tab, do the
648 following:</para>
649
650 <orderedlist spacing="compact">
651 <listitem>
652 <para>Select the binary <emphasis role="bold">C/C++
653 Application</emphasis> you want to deploy. If you click the
654 <emphasis role="bold">Search Project</emphasis> button, Eclipse
655 will parse the project and provide a list of all compiled
656 binaries to choose from. Alternatively, you can <emphasis
657 role="bold">Browse</emphasis> the file system for a binary, or
658 use <emphasis role="bold">Variables</emphasis> to manually
659 define the path.</para>
660 </listitem>
661
662 <listitem>
663 <para>Select an existing <emphasis
664 role="bold">Connection</emphasis> from the drop-down list. If a
665 connection is not available, create a new one following the
666 steps in <link linkend="eclipse_remote_connection">Setting up a
667 TCF Connection from Eclipse</link>.</para>
668 </listitem>
669
670 <listitem>
671 <para>The <emphasis role="bold">Remote Absolute File
672 Path</emphasis> is the path to the binary of the process you are
673 planning to debug. Type it directly or click the <emphasis
674 role="bold">Browse</emphasis> button and select a location on
675 the remote target. You need an active TCF connection to the
676 target for the <emphasis role="bold">Browse</emphasis> button to
677 work (see chapter <emphasis role="bold">Setting up a TCF
678 Connection from Eclipse</emphasis>). Note that you need to
679 specify the path including the filename.</para>
680 </listitem>
681
682 <listitem>
683 <para>Specify the PID of the remote process you are planning to
684 attach.</para>
685 </listitem>
686 </orderedlist>
687 </listitem>
688
689 <listitem>
690 <para>The <emphasis role="bold">Debugger</emphasis> tab deals with
691 GDB specific configurations. Select the <emphasis
692 role="bold">gdbserver</emphasis> in the Debugger dropdown. You may
693 also choose other useful options as with any Eclipse GDB interface,
694 e.g. whether to break at entering the main function or uploading
695 shared libraries. The following actions are important:</para>
696
697 <orderedlist spacing="compact">
698 <listitem>
699 <para>In the <emphasis role="bold">Main</emphasis> tab, enter
700 the path to the GDB binary in the SDK. For example:
701 <literal>&lt;extsdkdir&gt;/tmp/sysroots/x86_64-linux/usr/bin/&lt;arch&gt;-enea-linux/&lt;arch&gt;-enea-linux-gdb</literal>.</para>
702 </listitem>
703
704 <listitem>
705 <para>Select option <literal>Non-stop mode</literal>.</para>
706 </listitem>
707 </orderedlist>
708 </listitem>
709
710 <listitem>
711 <para>Once you have set up all the debug configurations, click
712 <emphasis role="bold">Apply</emphasis> and <emphasis
713 role="bold">Debug</emphasis>. This will launch the GDB and
714 optionally open the <literal>Debug perspective</literal> for the
715 process you selected. This is the standard Eclipse GDB interface
716 when debugging a remote target. You can use all GDB features, such
717 as setting breakpoints, stepping through code, reading variable
718 values, reading registers, viewing memory, etc.</para>
719 </listitem>
720 </orderedlist>
721
722 <para>Repeat these steps for each process you want to debug. You can
723 have multiple debug sessions running simultaneously for multiple
724 processes sharing the same source code.</para>
725 </section>
726
727 <section id="eclipse_postmortem">
728 <title>Using the Postmortem Debugger</title>
729
730 <para>When a program crashes<indexterm>
731 <primary>post-mortem debugging</primary>
732 </indexterm><indexterm>
733 <primary>core dump</primary>
734 </indexterm>, it may leave a core dump which can be used to figure out
735 exactly why the program crashed. Core dumps are disabled by default and
736 have to be activated before debugging. After retrieving and transferring
737 a core dump file to a host machine, Eclipse and the SDK tool generated
738 for the target, can be used to analyze the application state at the time
739 of the crash.</para>
740
741 <para>If deep debugging within Linux libraries is needed, the debug SDK
742 is required. See <link linkend="install_el_sdk">Installing Enea Linux
743 SDK</link>.</para>
744
745 <para>To enable writing core dump files, two steps need to be performed
746 on the target: <emphasis>allowing resources for core dumps</emphasis>
747 and <emphasis>defining a core file name pattern</emphasis>. These
748 settings are valid until the next reboot, unless made permanent by
749 configuration changes in the root file system.</para>
750
751 <para>Use the <command>ulimit</command> command to allow the system to
752 use resources for core dumps. The <command>ulimit</command> command
753 controls the resources available to a process started by the shell, on
754 systems that allow such control. Type the following to use this
755 command:</para>
756
757 <programlisting>ulimit -c unlimited</programlisting>
758
759 <para>To verify the result, type <command>ulimit -a</command> and see if
760 the core file size is set to <literal>unlimited</literal>. User limits
761 can also be changed from the application code using the function
762 <function>setrlimit(...)</function> declared in the
763 <literal>sys/resource.h</literal> header (see the manual available
764 through <command>man setrlimit</command>). To make this permanent across
765 a reboot, adjust the configuration in
766 <filename>/etc/security/limits.conf</filename>.</para>
767
768 <para>The next step is to specify the core pattern which defines the
769 core dump file pattern name. The core pattern is defined in the
770 <literal>/proc/sys/kernel/core_pattern</literal>.</para>
771
772 <para>The format of a core pattern follows certain rules:</para>
773
774 <itemizedlist>
775 <listitem>
776 <para>The maximum length is 128 characters</para>
777 </listitem>
778
779 <listitem>
780 <para>Default core dump name is <filename>core</filename></para>
781 </listitem>
782
783 <listitem>
784 <para>The string stored in <literal>core_pattern</literal> is used
785 as a pattern template for the output filename. Certain string
786 patterns (beginning with <literal>%</literal>) are substituted with
787 their actual values. The patterns are:</para>
788
789 <programlisting>%&lt;NUL&gt; '%' is dropped
790%% output one '%'
791%p pid
792%P global pid (init PID namespace)
793%i tid
794%I global tid (init PID namespace)
795%u uid (in initial user namespace)
796%g gid (in initial user namespace)
797%d dump mode, matches PR_SET_DUMPABLE and /proc/sys/fs/suid_dumpable
798%s signal number
799%t UNIX time of dump
800%h hostname
801%e executable filename (may be shortened)
802%E executable path
803%&lt;OTHER&gt; both are dropped</programlisting>
804 </listitem>
805
806 <listitem>
807 <para>If the first character of the pattern is a
808 '<literal>|</literal>', the kernel will treat the rest of the
809 pattern as a command to run. The core dump will be written to the
810 standard input of that program instead of to a file.</para>
811 </listitem>
812
813 <listitem>
814 <para>By setting the value <literal>core_uses_pid</literal> to
815 <literal>1</literal>, the core dump filename gets the extension
816 <filename>.PID</filename>, if the <literal>core_pattern</literal>
817 does not contain "<literal><literal>%p</literal></literal>".</para>
818
819 <para>For example, the default file name <filename>core</filename>
820 becomes <filename>core.PID</filename> if the
821 <literal>core_uses_pid</literal> is set, and no
822 <literal>core_pattern</literal> is defined.</para>
823 </listitem>
824 </itemizedlist>
825
826 <para>Specify a core pattern by writing it to
827 <literal>/proc/sys/kernel/core_pattern</literal>. For example:
828 <programlisting><literal>echo "&lt;suitable_directory&gt;/core.%e.%p.%h.%t" &gt; /proc/sys/kernel/core_pattern</literal></programlisting></para>
829
830 <para>To make the core dump file name permanent across a reboot,
831 configure <filename>/etc/sysctl.conf</filename>. to reflect this choice,
832 by adding a line like in the following example:
833 <literal>kernel.core_pattern=&lt;suitable_directory&gt;/core.%e.%p.%h.%t</literal>.</para>
834
835 <para>How to use the Eclipse post mortem debug configuration in order to
836 view the call trace, for the core dump in the Eclipse GDB
837 interface:</para>
838
839 <orderedlist spacing="compact">
840 <listitem>
841 <para>Ensure a core dump can be created on the target, see the
842 information above. To see the full call stack, the application
843 object files, compiled with debug information, are needed (the
844 <literal>-g</literal> option in gcc).</para>
845 </listitem>
846
847 <listitem>
848 <para>After a core dump has been created, retrieve the core dump
849 file from the target and store it on the host.</para>
850 </listitem>
851
852 <listitem>
853 <para>In Eclipse on the host, you need the core dump file, the SDK
854 for the target, the application executable, and access to the source
855 code. Once you have those, do the following:<orderedlist
856 spacing="compact">
857 <listitem>
858 <para>Switch to the <literal>Debug</literal> perspective in
859 Eclipse.</para>
860 </listitem>
861
862 <listitem>
863 <para>Select <emphasis role="bold">Run -&gt; Debug
864 Configurations ...</emphasis> (scroll down if you don't see
865 the option at first glance) <emphasis role="bold">-&gt; C/C++
866 Postmortem Debugger</emphasis>.</para>
867 </listitem>
868
869 <listitem>
870 <para>Make sure the <literal>C/C++ Application</literal> field
871 refers to your project executable, and fill in the
872 <literal>Core file</literal> field with the path to the
873 downloaded core file.</para>
874 </listitem>
875
876 <listitem>
877 <para>Under the <emphasis role="bold">Debugger</emphasis> tab,
878 fill in the <literal>GDB Debugger</literal> field with the
879 path to the GDB binary from the SDK. Example path:
880 <filename>&lt;extsdkdir&gt;/tmp/sysroots/x86_64-linux/usr/bin/&lt;arch&gt;-enea-linux/&lt;arch&gt;-enea-linux-gdb</filename></para>
881 </listitem>
882
883 <listitem>
884 <para>Click the <literal>Debug</literal> button. Eclipse
885 should switch into the <literal>Debug</literal> perspective
886 (if it hasn't already) and the debugging instance should break
887 somewhere inside the application. The call stack should be
888 observable in the console and should show a termination
889 message.</para>
890 </listitem>
891 </orderedlist></para>
892 </listitem>
893 </orderedlist>
894 </section>
895 </section>
896
897 <section id="eclipse_kern_debug">
898 <title>Debugging the Linux Kernel in Eclipse</title>
899
900 <para>In this section you learn to set up Eclipse for KGDB<indexterm>
901 <primary>KGDB</primary>
902 </indexterm> kernel debugging over the serial port, with examples for
903 the <literal>raspberrypi3</literal> target. This is only given as an
904 example, your Enea Linux distribution may contain other targets. The
905 corresponding instruction for debugging outside Eclipse is available in
906 Debugging the Linux Kernel (KGDB) from Command Line.<remark>LATER: Merge
907 the two instructions to shrink the amount of text; most of it is the
908 same.</remark></para>
909
910 <para>How to set up Eclipse for KGDB kernel debugging over a serial
911 port:</para>
912
913 <orderedlist>
914 <listitem>
915 <para>Make sure that the cross-compilation toolchain<indexterm>
916 <primary>cross-compilation toolchain</primary>
917 </indexterm><indexterm>
918 <primary>toolchain</primary>
919
920 <secondary>cross-compilation</secondary>
921 </indexterm> (SDK<indexterm>
922 <primary>SDK</primary>
923 </indexterm>) is installed on the host, see <link
924 linkend="install_el_sdk">Installing Enea Linux SDK</link>.</para>
925 </listitem>
926
927 <listitem>
928 <para>Ensure that the kernel debug image
929 (<literal>vmlinux)</literal>is accessible on the host where you run
930 Eclipse, and that you have permissions to execute it. You will later
931 point to it in Eclipse.</para>
932
933 <para>If you are using the default kernel delivered with Enea Linux,
934 you can find it in the rootfs under the <literal>/boot</literal>
935 folder. If you build your own kernel using bitbake, it should be
936 available in your build folder. Located in, for example:
937 <filename><filename>tmp/work/raspberrypi3_64-enea-linux/linux-raspberrypi/1_4.9.59+gitAUTOINC+meta_machine-r0/image/boot/vmlinux-4.9.59</filename></filename></para>
938 </listitem>
939
940 <listitem>
941 <para>In Eclipse:</para>
942
943 <orderedlist>
944 <listitem>
945 <para>Optional: The Linux kernel has a considerable amount of
946 sources, and indexing the whole of it might take a lot of time.
947 Save time by disabling C/C++ project indexing:<orderedlist
948 spacing="compact">
949 <listitem>
950 <para>Select <emphasis role="bold">Window &gt; Preferences
951 &gt; C/C++ &gt; Indexer</emphasis>.</para>
952 </listitem>
953
954 <listitem>
955 <para>Unselect the <emphasis role="bold">Enable
956 indexer</emphasis> checkbox.</para>
957 </listitem>
958 </orderedlist></para>
959 </listitem>
960
961 <listitem>
962 <para>Create a project from the kernel tree:</para>
963
964 <orderedlist spacing="compact">
965 <listitem>
966 <para>Select <emphasis role="bold">File &gt; New &gt; Project
967 &gt; C/C++ &gt; C project</emphasis>.</para>
968 </listitem>
969
970 <listitem>
971 <para>In the left panel, select <emphasis role="bold">Makefile
972 project &gt; Empty project</emphasis>, and give the project a
973 name.</para>
974 </listitem>
975
976 <listitem>
977 <para>Unselect the <emphasis role="bold">Use default
978 location</emphasis> option.</para>
979 </listitem>
980
981 <listitem>
982 <para>Click <emphasis role="bold">Browse</emphasis> and
983 navigate to the location of the kernel sources (git
984 folder).</para>
985 </listitem>
986
987 <listitem>
988 <para>Click <emphasis role="bold">Finish</emphasis>.</para>
989 </listitem>
990 </orderedlist>
991 </listitem>
992
993 <listitem>
994 <para>Create a C/C++ GDB Hardware Debugging configuration:</para>
995
996 <orderedlist spacing="compact">
997 <listitem>
998 <para>Go to <emphasis role="bold">Run -&gt; Debug
999 Configurations</emphasis>.</para>
1000 </listitem>
1001
1002 <listitem>
1003 <para>Double-click <emphasis role="bold">GDB Hardware
1004 Debugging</emphasis>.</para>
1005 </listitem>
1006 </orderedlist>
1007
1008 <para>This will create a default configuration named
1009 <literal>project_name Default</literal>.</para>
1010 </listitem>
1011
1012 <listitem>
1013 <para>In the <emphasis role="bold">Main</emphasis> tab:</para>
1014
1015 <orderedlist spacing="compact">
1016 <listitem>
1017 <para>Browse to the location of the
1018 <filename>vmlinux</filename> image. As an alternative, you may
1019 select a different project to debug, but if you followed the
1020 steps above you should not need to modify this.</para>
1021 </listitem>
1022
1023 <listitem>
1024 <para>Select the <emphasis role="bold">Disable auto
1025 build</emphasis> radio button.</para>
1026 </listitem>
1027
1028 <listitem>
1029 <para>At the bottom of the window, make sure <emphasis
1030 role="bold">GDB (DSF) Hardware Debugging Launcher</emphasis>
1031 is selected.</para>
1032 </listitem>
1033 </orderedlist>
1034 </listitem>
1035
1036 <listitem>
1037 <para>In the <emphasis role="bold">Debugger</emphasis> tab for
1038 <emphasis role="bold">C/C++ Application</emphasis>:</para>
1039
1040 <orderedlist spacing="compact">
1041 <listitem>
1042 <para>Browse to the location of the <emphasis role="bold">GDB
1043 binary</emphasis> installed by the cross-compilation toolchain
1044 installer, by default:
1045 <filename>&lt;extsdkdir&gt;/tmp/sysroots/x86_64-linux/usr/bin/&lt;arch&gt;-enea-linux/&lt;arch&gt;-enea-linux-gdb</filename>.</para>
1046 </listitem>
1047
1048 <listitem>
1049 <para>Select option <emphasis role="bold">Use remote
1050 target</emphasis>.</para>
1051 </listitem>
1052
1053 <listitem>
1054 <para>In the <emphasis role="bold">JTAG Device</emphasis>,
1055 select <emphasis role="bold">Generic Serial</emphasis> from
1056 the dropdown list.</para>
1057 </listitem>
1058
1059 <listitem>
1060 <para>In the <emphasis role="bold">GDB Connection
1061 String</emphasis> field, type the host's tty device used for
1062 the serial connection to the target, e.g.
1063 <literal>/dev/ttyUSB0</literal>.</para>
1064 </listitem>
1065 </orderedlist>
1066 </listitem>
1067
1068 <listitem>
1069 <para>In the <emphasis role="bold">Startup</emphasis> tab:</para>
1070
1071 <orderedlist spacing="compact">
1072 <listitem>
1073 <para>Deselect the <emphasis role="bold">Load image</emphasis>
1074 option.</para>
1075 </listitem>
1076
1077 <listitem>
1078 <para>Select the <emphasis role="bold">Load symbols</emphasis>
1079 option.</para>
1080 </listitem>
1081
1082 <listitem>
1083 <para>Ensure that the <emphasis role="bold">Use project
1084 binary</emphasis> option defaults to your
1085 <literal>vmlinux</literal> image.</para>
1086 </listitem>
1087
1088 <listitem>
1089 <para>Click <emphasis role="bold">Apply</emphasis> to store
1090 the configurations above.</para>
1091 </listitem>
1092 </orderedlist>
1093 </listitem>
1094 </orderedlist>
1095 </listitem>
1096
1097 <listitem>
1098 <para>Prepare the target for KGDB debugging:</para>
1099
1100 <orderedlist>
1101 <listitem>
1102 <para>Configure a serial communication on the target, using the
1103 appropriate device for the target (e.g. <literal>ttyS0</literal>
1104 for <literal>p2020rdb</literal>, <literal>ttyS2</literal> for
1105 <literal>pandaboard</literal>, <literal>ttyPS0</literal> for
1106 <literal>zynq</literal>):</para>
1107
1108 <programlisting><command>echo ttyS0,115200 &gt; /sys/module/kgdboc/parameters/kgdboc</command></programlisting>
1109 </listitem>
1110
1111 <listitem>
1112 <para>Start KGDB on the target SysRq:</para>
1113
1114 <programlisting><command>echo g &gt; /proc/sysrq-trigger</command></programlisting>
1115 </listitem>
1116
1117 <listitem>
1118 <para>Keep the serial connection open, but close the terminal to
1119 the target.</para>
1120 </listitem>
1121 </orderedlist>
1122 </listitem>
1123
1124 <listitem>
1125 <para>Launch the debug session in Eclipse:</para>
1126
1127 <orderedlist spacing="compact">
1128 <listitem>
1129 <para>Select <emphasis role="bold">Run &gt; Debug
1130 Configurations</emphasis>.</para>
1131 </listitem>
1132
1133 <listitem>
1134 <para>Select the configuration created above.</para>
1135 </listitem>
1136
1137 <listitem>
1138 <para>Click the <emphasis role="bold">Debug</emphasis>
1139 button.</para>
1140 </listitem>
1141 </orderedlist>
1142
1143 <para>The target halts in function
1144 <literal>kgdb_breakpoint()</literal>. The GDB view opens in Eclipse,
1145 and from here you can debug the kernel by giving ordinary GDB commands
1146 (<command>resume</command>, <command>step</command>, <command>set
1147 breakpoint,</command> etc.).</para>
1148 </listitem>
1149 </orderedlist>
1150 </section>
1151
1152 <section id="workarounds">
1153 <title>Workarounds</title>
1154
1155 <section id="troubleshoot_build_debug_config">
1156 <title>Run/Debug Configuration Not Created</title>
1157
1158 <itemizedlist>
1159 <listitem>
1160 <para><emphasis role="bold">Description:</emphasis> When setting up
1161 <link linkend="eclipse_debug">Remote Debugging from Eclipse</link>,
1162 a run/debug configuration is not created when setting the
1163 cross-compiler options, thus there is nothing to select under
1164 <emphasis role="bold">C/C++ Remote Application</emphasis> in the
1165 first step.</para>
1166 </listitem>
1167
1168 <listitem>
1169 <para><emphasis role="bold">Solution:</emphasis> Manually create a
1170 run/debug configuration.</para>
1171
1172 <para>Perform the following steps:</para>
1173
1174 <orderedlist>
1175 <listitem>
1176 <para>Double-click the <emphasis role="bold">C/C++ Remote
1177 Application</emphasis>. This will create a new debug
1178 configuration named after your project.</para>
1179 </listitem>
1180
1181 <listitem>
1182 <para>In the <emphasis role="bold">Debugger</emphasis> tab,
1183 select a <emphasis role="bold">GDB debugger</emphasis> by
1184 browsing for and selecting the debugger of your
1185 cross-compilation toolchain, from your <emphasis
1186 role="bold">Sysroot Location</emphasis>. Example:</para>
1187
1188 <programlisting>$ &lt;extsdkdir&gt;/tmp/sysroots/x86_64-linux/usr/bin/\
1189&lt;arch&gt;-enea-linux/&lt;arch&gt;-enea-linux-gdb</programlisting>
1190
1191 <para>where <filename>&lt;sdkdir&gt;</filename> is e.g.
1192 <filename>/opt/enea/&lt;sdkversion&gt;</filename>.</para>
1193 </listitem>
1194
1195 <listitem>
1196 <para>Outside Eclipse, create a new file named
1197 <filename>.gdbinit</filename> within your Eclipse workspace,
1198 under your project directory, e.g. <filename>&lt;path to
1199 workspace&gt;/&lt;project name&gt;/.gdbinit</filename>, with the
1200 following command, using your <emphasis role="bold">Sysroot
1201 Location</emphasis>:</para>
1202
1203 <programlisting>$ set sysroot &lt;extsdkdir&gt;/sysroots</programlisting>
1204 </listitem>
1205
1206 <listitem>
1207 <para>Back in Eclipse in the <emphasis
1208 role="bold">Debugger</emphasis> tab, browse for the newly
1209 created <emphasis role="bold">.gdbinit</emphasis> file and
1210 select it under <emphasis role="bold">GDB command
1211 file</emphasis>.</para>
1212 </listitem>
1213
1214 <listitem>
1215 <para>Click <emphasis role="bold">Apply</emphasis>, then go back
1216 to the <emphasis role="bold">Main</emphasis> tab and continue
1217 with the remaining steps in the <emphasis role="bold">Remote
1218 Debugging</emphasis> section.</para>
1219 </listitem>
1220 </orderedlist>
1221 </listitem>
1222 </itemizedlist>
1223 </section>
1224 </section>
1225</chapter>
diff --git a/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml
new file mode 100644
index 0000000..f22f6a2
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/doc/using_enea_linux.xml
@@ -0,0 +1,806 @@
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<chapter id="using_enealinux">
3 <title>Using Enea Linux</title>
4
5 <section id="build_enealinux">
6 <title>Building Enea Linux</title>
7
8 <para>Enea Linux is made available as sources, this allows for of building
9 various Enea Linux artifacts and is detailed in the following
10 sections:</para>
11
12 <section id="build_images">
13 <title>Building the images</title>
14
15 <para>Build Enea Linux images using the following steps:</para>
16
17 <procedure>
18 <step>
19 <para>Set the $MACHINE/&lt;machine&gt; variable to the target you
20 need, e.g. <literal>intel-corei7-64</literal>.</para>
21 </step>
22
23 <step>
24 <para>Clone Enea Linux sources using Repo tool. Please refer to
25 <xref linkend="getting_sources" /> for more details.</para>
26
27 <programlisting>$ mkdir enea-linux
28$ cd enea-linux
29$ repo init -u git@git.enea.com:linux/manifests/el_manifests-rt.git \
30 -b refs/tags/Enea_Linux_8.0 -m $MACHINE/default.xml
31$ repo sync</programlisting>
32 </step>
33
34 <step>
35 <para>Source the build environment</para>
36
37 <programlisting>$ cd poky
38$ TEMPLATECONF=meta-el-rt/conf/template.&lt;machine&gt; \
39. ./oe-init-build-env &lt;build_dir&gt;</programlisting>
40
41 <para>Sourcing the build environment is needed everytime a new shell
42 is used. However, sourcing using the <literal>TEMPLATECONF</literal>
43 is only needed the first time around. After the first time, it is
44 enough to source the build directory created before.</para>
45
46 <note>
47 <para>The build directory may reside on an NFS mount, but the
48 <literal>TMPDIR</literal>
49 (<literal>&lt;build_dir&gt;/tmp</literal>) may not. Either build
50 all on a local disk, or update <literal>TMPDIR</literal> in
51 <literal>conf/local.conf</literal> to point to a local
52 disk.</para>
53 </note>
54 </step>
55
56 <step>
57 <para>Build Enea Linux image</para>
58
59 <programlisting># You have already initiated the build environment and are in the &lt;build_dir&gt;
60$ bitbake &lt;enea-image-name&gt;
61$ cd &lt;build_dir&gt;/tmp/deploy/images/&lt;target&gt;/ # Here are the build binaries</programlisting>
62
63 <note>
64 <para>Some builds have restrictions on the length of the path
65 name. If you get a build error indicating that the length is too
66 long, you need to move your build to obtain a shorter path.</para>
67 </note>
68
69 <para>Generated images are by default saved in
70 <literal><literal>&lt;build_dir&gt;/tmp/deploy/images/&lt;target&gt;</literal></literal>,
71 where <literal>&lt;build_dir&gt;</literal> by default is the current
72 working directory. Images are created for emulation on host or for
73 booting a physical target, according to how the build environment
74 was set up before running bitbake.</para>
75
76 <para>Depending on the number of processors and cores, the amount or
77 RAM, the speed of your Internet connection and other factors, the
78 build process can take several hours the first time you run it.
79 Subsequent builds run much faster since parts of the build are
80 cached.</para>
81
82 <note>
83 <para>Make sure that the user running the build has access to the
84 Git repositories on git.enea.com. The build process fetches
85 information from git.enea.com so the user running the build shall
86 have the ssh key properly configured. Please refer to <xref
87 linkend="getting_sources" /> for more details on how to get access
88 to Enea Linux sources.</para>
89 </note>
90 </step>
91 </procedure>
92 </section>
93
94 <section id="build_sdk">
95 <title>Building the SDK</title>
96
97 <para>If you want to rebuild a cross-compilation toolchain to be used by
98 in application development, use the following steps:</para>
99
100 <procedure>
101 <step>
102 <para>Clone Enea Linux sources using Repo tool. Please refer to
103 <xref linkend="getting_sources" /> for more details on how to do
104 this.</para>
105
106 <programlisting>$ mkdir enea-linux
107$ cd enea-linux
108$ repo init -u git@git.enea.com:linux/manifests/el_manifests-rt.git \
109 -b refs/tags/Enea_Linux_8.0 -m $MACHINE/default.xml
110$ repo sync</programlisting>
111 </step>
112
113 <step>
114 <para>Source the build environment</para>
115
116 <programlisting>$ cd poky
117$ TEMPLATECONF=meta-el-rt/conf/template.&lt;machine&gt; \
118. ./oe-init-build-env &lt;build_dir&gt;</programlisting>
119
120 <para>Sourcing the build environment is needed everytime a new shell
121 is used. However, sourcing using the <literal>TEMPLATECONF</literal>
122 is only needed the first time around. Afterwards it is enough to
123 source the build directory created before.</para>
124
125 <note>
126 <para>The build directory may reside on an NFS mount, but the
127 <literal>TMPDIR</literal>
128 (<literal>&lt;build_dir&gt;/tmp</literal>) may not. Either build
129 all on a local disk, or update TMPDIR in conf/local.conf to point
130 to a local disk.</para>
131 </note>
132 </step>
133
134 <step>
135 <para>Build Enea Linux SDK</para>
136
137 <programlisting># You have already initiated the build environment and are in the &lt;build_dir&gt;
138$ bitbake &lt;enea-image-name&gt; -c populate_sdk_ext
139$ cd &lt;build_dir&gt;/tmp/deploy/sdk/ # Here is the SDK installer script</programlisting>
140
141 <note>
142 <para>Some builds have restrictions on the length of the path
143 name. If you get a build error indicating that the length is too
144 long, you need to move your build to obtain a shorter path.</para>
145 </note>
146
147 <para>Generated SDK installer script is by default saved in
148 <literal>&lt;build_dir&gt;/tmp/deploy/sdk</literal>, where
149 <literal>&lt;build_dir&gt;</literal> by default is the current
150 working directory.</para>
151
152 <para>Depending on the number of processors and cores, the amount or
153 RAM, the speed of your Internet connection and other factors, the
154 build process can take several hours the first time you run it.
155 Subsequent builds run much faster since parts of the build are
156 cached.</para>
157
158 <para>For more details on how to install and use the SDK, please
159 refer to <xref linkend="install_el_sdk" />.</para>
160 </step>
161 </procedure>
162 </section>
163 </section>
164
165 <section id="boot_enealinux">
166 <title>Booting Enea Linux</title>
167
168 <para>Regardless whether you decide to use the pre-built images or if you
169 choose to build your own, the end result should be similar. Once you have
170 the artifacts availalbe, you may proceed to booting Enea Linux on
171 target.</para>
172
173 <para>Enea Linux supports multiple booting methods so those will be
174 described in the following sections.</para>
175
176 <section id="enea-linux-x86-pxe">
177 <title>Boot via PXE using DHCP, TFTP, and NFS servers</title>
178
179 <para>Below you find an example of how to boot Enea Linux in a target
180 supporting PXE. The PXE boot is handled by the target BIOS.</para>
181
182 <para>This requires the setup of DHCP, TFTP and NFS servers on the host.
183 The DHCP server contains a configuration for the target, found via the
184 target MAC address, and refers to the TFTP server for the boot image and
185 to the NFS server for the root file system.</para>
186
187 <para>For the DHCP server, in addition to the general configuration, the
188 DHCPD configuration should contain an entry for the target with the
189 following information:</para>
190
191 <itemizedlist spacing="compact">
192 <listitem>
193 <para>Host name</para>
194 </listitem>
195
196 <listitem>
197 <para>MAC hardware ethernet address (also available in the TFTP
198 configuration)</para>
199 </listitem>
200
201 <listitem>
202 <para>IP address, (assuming a fixed IP address is used)</para>
203 </listitem>
204
205 <listitem>
206 <para>The TFTP server shall be defined as
207 <literal>next-server</literal></para>
208 </listitem>
209
210 <listitem>
211 <para>The relative path in the TFTP server to the PXE file
212 <filename><literal>pxelinux.0</literal></filename></para>
213 </listitem>
214
215 <listitem>
216 <para>The NFS server IP address and the path to the rootfs on the
217 NFS server, defined as <literal>option root-path</literal></para>
218 </listitem>
219 </itemizedlist>
220
221 <para>Example of a DHCP server configuration:</para>
222
223 <programlisting>host intel-corei7-64_host {
224 hardware ethernet 01:00:25:90:c8:c5:98;
225 fixed-address 192.168.1.38;
226 next-server 192.168.2.10;
227 filename "intel-corei7-64_tftp/pxelinux.0";
228 option root-path "192.168.2.20:/export/intel-corei7-64_rootfs";
229}</programlisting>
230
231 <para>For the TFTP server, the TFTP path to the target's pxelinux.0 file
232 is given in the DHCP Configuration. Examples of files included in the
233 TFTP subdirectory indicated by the DHCP configuration are:</para>
234
235 <programlisting>pxelinux.0
236vesamenu.c32
237boot/device01/bzImage (bootable image file)
238pxelinux.cfg/01-00-25-90-c8-c5-98 (Configuration file)</programlisting>
239
240 <para>One configuration file has the same name as the target's MAC
241 address (but with hyphens instead of a colon). This configuration file
242 contains a pointer to the bootable image and also a list of command line
243 arguments to append when the image is started. The same NFS path to the
244 root file system is both in the DHCP and the TFTP configuration.</para>
245
246 <para>Example of a configuration file:</para>
247
248 <programlisting>default vesamenu.c32
249prompt 0
250timeout 100
251
252label device01
253 menu label ^EneaLinuxNFS
254 menu default
255 kernel boot/device01/bzImage
256 <emphasis role="bold">append</emphasis> root=/dev/nfs nfsmount=192.168.2.20:/export/intel-corei7-64_rootfs ip=dhcp
257 console=ttyS0,115200</programlisting>
258
259 <para><emphasis role="bold">NFS server</emphasis>: The NFS server shall
260 contain an unpacked root file system in the path indicated both in the
261 DHCP and in the TFTP configuration.</para>
262
263 <para>After configuring the servers, copy files from the build directory
264 into the correctly configured paths:</para>
265
266 <orderedlist spacing="compact">
267 <listitem>
268 <para>Ensure the target is not already running an OS, otherwise the
269 target might attempt to change files on the root file system while
270 it is populated with new files.</para>
271 </listitem>
272
273 <listitem>
274 <para>Copy <filename>pxelinux.0</filename> and
275 <filename>vesamenu.c32</filename> from the build directory, e.g.
276 from
277 <filename>&lt;build_dir&gt;tmp/work/corei7-64-enea-linux/syslinux/6.03-r0/image/usr/share/syslinux/</filename>.</para>
278 </listitem>
279
280 <listitem>
281 <para>Copy <filename>bzImage</filename> from
282 <filename>&lt;build_dir&gt;/tmp/deploy/images/&lt;target&gt;/</filename>.</para>
283 </listitem>
284
285 <listitem>
286 <para>Populate the root file system in the NFS directory by
287 unpacking
288 <filename>enea-image-rt-intel-corei7-64.tar.gz</filename>
289 found at
290 <filename>&lt;build_dir&gt;/tmp/deploy/images/&lt;target&gt;/</filename>.</para>
291 </listitem>
292 </orderedlist>
293
294 <para>Boot the target by:</para>
295
296 <orderedlist>
297 <listitem>
298 <para>Use the BIOS or boot setup to select PXE boot, if not already
299 selected.</para>
300 </listitem>
301
302 <listitem>
303 <para>Reboot the target.</para>
304 </listitem>
305 </orderedlist>
306
307 <para>The boot setup menu is usually launched by pressing F12 or ESC
308 during BIOS power up tests. Look up the manufacturer's documentation for
309 your board model to find the appropriate key.</para>
310 </section>
311 </section>
312
313 <section id="custom_enealinux">
314 <title>Customizing Enea Linux</title>
315
316 <section id="layers_adaptations">
317 <title>Layers and Adaptations</title>
318
319 <para>Bitbake allows a modular approach of Metadata, by building images
320 for the layers listed in the conf/bblayers.conf file from your build
321 directory.</para>
322
323 <para>To avoid polluting the build with unnecessary packages, before
324 adding a new layer, it is recommended to check if the Metadata you need
325 is already available in the enabled layers, in which case, for the
326 intended configuration, it may require less modification.</para>
327
328 <para>To ease further use of the layer, try to follow as many best
329 practices as possible when creating it:</para>
330
331 <itemizedlist>
332 <listitem>
333 <para>Use names starting with the meta prefix (although this is not
334 a requirement)</para>
335 </listitem>
336 </itemizedlist>
337
338 <itemizedlist>
339 <listitem>
340 <para>Place your layer under poky</para>
341 </listitem>
342 </itemizedlist>
343
344 <itemizedlist>
345 <listitem>
346 <para>Isolate different customizations by layer</para>
347 </listitem>
348 </itemizedlist>
349
350 <itemizedlist>
351 <listitem>
352 <para>Assign the layer to a repository (to easily have access to
353 maintenance)</para>
354 </listitem>
355 </itemizedlist>
356
357 <para>To enable a layer, its top path must be specified in the
358 <filename>BBLAYERS</filename> variable, as follows:</para>
359
360 <programlisting># POKY_BBLAYERS_CONF_VERSION is increased each time build/conf/bblayers.conf
361# changes incompatibly
362POKY_BBLAYERS_CONF_VERSION = "2"
363
364BBPATH = "${TOPDIR}"
365BBFILES ?= ""
366
367BBLAYERS ?= " \
368 /path/to/poky/meta \
369 /path/to/poky/meta-el-common \
370 /path/to/poky/meta-el-rt \
371 /path/to/poky/meta-enea-bsp-common \
372 /path/to/poky/meta-enea-bsp-x86 \
373 /path/to/poky/meta-openembedded/meta-oe \
374 /path/to/poky/meta-openembedded/meta-networking \
375 /path/to/poky/meta-openembedded/meta-filesystems \
376 /path/to/poky/meta-openembedded/meta-python \
377 /path/to/poky/meta-poky \
378 /path/to/poky/meta-&lt;layer&gt; \
379 "</programlisting>
380
381 <para>Before adding an extra layer, please keep in mind that the order
382 of layers is important (due to BitBake parsing conf/layer.conf as
383 specified in <filename>BBLAYERS</filename>). To add an extra layer, you
384 can modify the <filename>build/conf/bblayers.conf</filename> file in the
385 source code editor you prefer, as described above, or use one of the
386 specially designed Yocto tools.</para>
387
388 <para>To do such, you can simply modify the build/conf/bblayers.conf
389 file in the source code editor you prefer, as described above, or use
390 one of the specially designed Yocto tools.</para>
391
392 <para>For instance, in addition to the above, the Yocto Bitbake layers
393 utility ensures a very useful checking of some basic layer requirements.
394 Bitbake layers are available, as most of the BitBake tools, when
395 sourcing oe-init-build-env. Therefore, to enable a custom meta layer,
396 you should simply run the following from the build directory:</para>
397
398 <programlisting>bitbake-layers add-layer &lt;meta-layer&gt;</programlisting>
399
400 <para>If the specified layer doesn't contain a
401 <filename>conf/layer.conf</filename> file, you should add one with the
402 needed configuration. Also, to make sure the layer insertion is done in
403 the right metadata, the utility looks for the bblayers.conf
404 configuration file in the corresponding path, which should be satisfied
405 if running the command from the generated build directory.</para>
406
407 <para>For further information on this or on other utilities belonging to
408 the same suite, run:</para>
409
410 <programlisting>bitbake-layers -h</programlisting>
411
412 <para>As a result, <filename>BBLAYERS</filename> shall be extended with
413 the bsp-layer/s layer for your target and any other additional layer/s.
414 For details on how to do this, see the <ulink
415 url="http://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#understanding-and-creating-layers">Yocto
416 2.5 Dev Manual, section "Understanding and Creating Layers".</ulink> If
417 needed replace the Yocto version.</para>
418
419 <para>Layers can be added when you initialize the build environment. The
420 layers required for each target are specified in the build commands in
421 the Enea Linux distribution's Release Information.</para>
422
423 <para>Each Enea Linux customer is advised to add a custom layer for
424 customer-specific additions and customizations, instead of modifying
425 existing layers.</para>
426
427 <para>The recommended way to modify a package is to edit directly in the
428 recipe file. Utilizing the devshell, <literal>bitbake -c devshell
429 &lt;image_name&gt;</literal>, when constructing or modifying recipes is
430 really handy when experimenting, but do not forget to make the final
431 updates directly in the recipe file. It is difficult to keep track of
432 exactly what in the user environment is "dirty" and not in sync with
433 current recipes. Therefore, always make sure to <literal>bitbake -c
434 clean &lt;image_name&gt;</literal> after finishing up a devshell
435 session, and adapt recipes accordingly to ensure a shareable and
436 repeatable build environment.</para>
437 </section>
438
439 <section id="add_recipe">
440 <title>Adding a Recipe</title>
441
442 <para>Study the <ulink
443 url="https://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#new-recipe-single-c-file-package-hello-world"><ulink
444 url="https://www.yoctoproject.org/docs/2.5/dev-manual/dev-manual.html#new-recipe-single-c-file-package-hello-world">Hello
445 World recipe</ulink></ulink> in the Yocto Project Development Manual. If
446 needed replace the example version (2.5) with the Yocto version in your
447 Enea Linux distribution.</para>
448 </section>
449
450 <section id="config_pkg_recipes">
451 <title>Configuring Packages via Recipes</title>
452
453 <para>The default configuration produces a standard Linux installation,
454 but it is often desirable to configure specific packages in more detail.
455 Different packages implement their configuration in different ways, and
456 there is no single method that is valid for all packages. As always, in
457 a collaborative development environment, the developer should make sure
458 that the recipes in the custom layer are upgraded accordingly when a
459 reconfiguration of a specific package is done.</para>
460
461 <para>In subsequent sections you find examples on how to configure some
462 common packages.</para>
463
464 <section id="linux_kern">
465 <title>The Linux Kernel</title>
466
467 <para>The Linux kernel provides a vast array of configuration options,
468 managed using its own configuration system. The kernel package can be
469 supplied from different providers, and this example uses the
470 virtual/kernel package name to refer to the kernel used in the
471 build:</para>
472
473 <programlisting>$ bitbake -c menuconfig virtual/kernel</programlisting>
474
475 <note>
476 <para>menuconfig requires Ncurses. If the terminal that pops up
477 immediately closes instead of showing the menuconfig interface,
478 check that the Ncurses development library is installed.</para>
479 </note>
480
481 <para>First build the kernel:</para>
482
483 <programlisting>$ bitbake -f -c compile -c install -c deploy virtual/kernel</programlisting>
484
485 <para>Then build the whole distribution:</para>
486
487 <programlisting>$ bitbake enea-image-&lt;name&gt;</programlisting>
488 </section>
489
490 <section id="busybox">
491 <title>Busybox</title>
492
493 <para>Busybox uses the same configuration system as the Linux kernel
494 and is therefore invoked similarly. In contrast to the kernel, there
495 is generally only one variant of busybox in a distribution and we can
496 therefore refer to it by the package name alone:</para>
497
498 <programlisting>$ bitbake -c menuconfig busybox</programlisting>
499 </section>
500 </section>
501
502 <section id="build_com_licenses">
503 <title>Building with Commercial Licenses</title>
504
505 <note>
506 <para>Adding commercial-licensed packages might pose distribution
507 problems due to license agreements or patents.</para>
508 </note>
509
510 <para>Commercial-licensed packages are not provided with Enea Linux.
511 Depending on your use case, you might need to extend the initial image
512 with more packages by adding recipes and updating the image definition,
513 always in accordance with the license conditions. To succeed with
514 building the customized image, you might need to solve dependencies by
515 adding even more packages.</para>
516
517 <para>Below is an example with steps on how to add a package with a
518 commercial license. The configuration is updated in two places and the
519 recipes are selected for the packages and any dependencies.</para>
520
521 <note>
522 <para>This is only an illustrating example, the exact configuration
523 may differ between different packages. Some packages could require
524 other defines added to local.conf and some packages might need an
525 added <filename>DEPENDS</filename> in the *.inc file, or other
526 particular changes.</para>
527 </note>
528
529 <itemizedlist>
530 <listitem>
531 <para>Append the package name to the
532 <filename>IMAGE_INSTALL</filename> definition, used in the recipe
533 corresponding to the image you will build, as in one of the examples
534 below:</para>
535
536 <orderedlist>
537 <listitem>
538 <para>If you need the package in a set of images, to avoid
539 defining it in each recipe, add the following line to
540 <filename>IMAGE_INSTALL</filename> in
541 <filename>meta-el-common/images/enea-image-common.inc</filename></para>
542
543 <programlisting> package_name \</programlisting>
544 </listitem>
545
546 <listitem>
547 <para>If you have specific images in which you need the package,
548 add the following line in the corresponding recipes in
549 meta-el-&lt;profile&gt;/images/enea-image-&lt;profile&gt;.bb</para>
550
551 <programlisting> IMAGE_INSTALL += " \
552 package_name \
553 "</programlisting>
554 </listitem>
555 </orderedlist>
556 </listitem>
557
558 <listitem>
559 <para>Add the required license to the
560 <filename>LICENSE_FLAGS_WHITELIST</filename> definition. This can be
561 done by adding script lines in the corresponding
562 scripts/conf_setup.sh file, which appends
563 <filename>LICENSE_FLAGS_WHITELIST +=
564 "&lt;suitable-license&gt;</filename> to
565 <filename>conf/local.conf.</filename></para>
566 </listitem>
567
568 <listitem>
569 <para>To mitigate the build errors caused by packages with
570 commercial licenses, you might also need to append the generic
571 license <filename>LICENSE_FLAGS_WHITELIST += "commercial"</filename>
572 in the same way as above.</para>
573 </listitem>
574
575 <listitem>
576 <para>Select the needed recipes for the packages and add these to
577 the build configuration.</para>
578 </listitem>
579
580 <listitem>
581 <para>Select the needed recipes to resolve dependencies for the new
582 packages and add these to the build configuration.</para>
583 </listitem>
584 </itemizedlist>
585
586 <para>More information about recipes can be found here:</para>
587
588 <itemizedlist>
589 <listitem>
590 <para><ulink
591 url="http://git.openembedded.org/">http://git.openembedded.org/</ulink></para>
592 </listitem>
593 </itemizedlist>
594
595 <itemizedlist>
596 <listitem>
597 <para><ulink
598 url="https://wiki.yoctoproject.org/wiki/Building_your_own_recipes_from_first_principles">https://wiki.yoctoproject.org/wiki/Building_your_own_recipes_from_first_principles</ulink></para>
599 </listitem>
600 </itemizedlist>
601
602 <itemizedlist>
603 <listitem>
604 <para><ulink
605 url="http://www.yoctoproject.org/docs/current/dev-manual/dev-manual.html#new-recipe-writing-a-new-recipe">http://www.yoctoproject.org/docs/current/dev-manual/dev-manual.html#new-recipe-writing-a-new-recipe</ulink></para>
606 </listitem>
607 </itemizedlist>
608 </section>
609 </section>
610
611 <section id="install_el_sdk">
612 <title>Installing the Enea Linux SDK</title>
613
614 <para>Before cross-compiling applications for your target, you need to
615 install the Software Development Kit (SDK) - which contains the
616 cross-compilation toolchain - and set up the cross-compilation environment
617 on your host. The toolchain for each supported target contains a 64-bit
618 library for gcc. The toolchain and the environment-setup script are
619 wrapped together inside a toolchain installer in the form of a shell
620 script.</para>
621
622 <para>The cross-compilation toolchain is packaged as follows:</para>
623
624 <itemizedlist>
625 <listitem>
626 <para>The &lt;target&gt; toolchain contains the lib64 (64-bit)
627 library.</para>
628 </listitem>
629
630 <listitem>
631 <para>The &lt;target&gt; installer has an environment-setup script
632 which will select the lib64 to be used by gcc. This way, a 64-bit
633 application can be cross-compiled.</para>
634 </listitem>
635 </itemizedlist>
636
637 <para>Do as in the example below to install the SDK and set up the
638 cross-compilation environment:</para>
639
640 <orderedlist>
641 <listitem>
642 <para>The fastest alternative is to use a precompiled
643 cross-compilation toolchain installer for your host and target.</para>
644
645 <para>Please refer to the Release Information document, in section 1.1
646 Provided Contents, for more details on where to find the pre-compiled
647 SDK installer.</para>
648 </listitem>
649
650 <listitem>
651 <para>Run the installer to unpack the cross-compilation toolchain and
652 the environment-setup script:</para>
653
654 <programlisting>$ chmod 770 enea-*-toolchain-&lt;version&gt;.sh
655$ ./enea-*-toolchain-&lt;version&gt;.sh</programlisting>
656
657 <para>When prompted, select to install the SDK in the desired
658 directory, referred to as &lt;sdkdir&gt;. The default path where the
659 SDK will be installed, will be shown in the prompt. The installer
660 unpacks the environment setup script in &lt;sdkdir&gt; and the
661 toolchain under &lt;sdkdir&gt;/sysroots.</para>
662
663 <note>
664 <para>Choose a unique directory for each toolchain. Installing a
665 second toolchain of any type (buildtools toolchain or
666 cross-compilation toolchain) in the same directory as a previously
667 installed one will break the $PATH variable of the first one.</para>
668 </note>
669 </listitem>
670
671 <listitem>
672 <para>Setup the toolchain environment for your target by sourcing the
673 environment-setup script:</para>
674
675 <programlisting>$ . &lt;sdkdir&gt;/environment-setup-&lt;arch&gt;-enea-linux</programlisting>
676
677 <para>Example:</para>
678
679 <programlisting>$ . /opt/enea/environment-setup-corei7-64-enea-linux</programlisting>
680 </listitem>
681 </orderedlist>
682
683 <para>Once the cross-compilation toolchain is in place and the environment
684 set up, you can proceed with Cross-Compiling Applications from Command
685 Line (4.1) or, if Eclipse is installed, Cross-Compiling from Eclipse
686 (5.4.1).</para>
687 </section>
688
689 <section id="pkg_mg">
690 <title>Using Package Management</title>
691
692 <para>A Package Management System (PMS) can be used to customize your
693 image in a consistent way, e.g. to install, upgrade, or delete packages
694 considering the dependencies. The package management systems supported by
695 Enea Linux are described in this section. More information about PMS can
696 be found in the Yocto 2.5 document <ulink
697 url="http://www.yoctoproject.org/docs/2.5/mega-manual/mega-manual.html">Yocto
698 Project Mega Manual</ulink>. If needed replace the Yocto version in the
699 link.</para>
700
701 <section id="apt_pktmgmt">
702 <title>APT Package Management (DEB Packages)</title>
703
704 <para>Enea Linux provides DEB packages on <ulink
705 url="http://linux.enea.com/EneaLinux8.0/">linux.enea.com</ulink> site,
706 in directory
707 <literal><literal>&lt;release&gt;/&lt;target&gt;/deb</literal>/</literal>.</para>
708
709 <para>The application for performing runtime package management of DEB
710 packages on the target is called <filename>apt-get</filename>.</para>
711
712 <para>Use the <literal>apt-get</literal> command to install, upgrade, or
713 remove packages. Before using any apt-get options that require network
714 access, please check that the network is configured and working
715 properly.</para>
716
717 <para>The <literal>apt-get</literal> command is by default included in
718 Enea Linux images.</para>
719
720 <section id="apt_config">
721 <title>Configuring</title>
722
723 <para>APT relies on the concept of repositories in order to find
724 packages and resolve dependencies.</para>
725
726 <para>Any number of additional repositories can be added to APT's
727 configuration files (.list extension) located in sources.list.d
728 directory (e.g:
729 <filename>/etc/apt/sources.list.d/repos.list</filename>) and then be
730 queried by APT.</para>
731
732 <programlisting># touch /etc/apt/sources.list.d/repos.list
733# echo "deb [trusted=yes] http://server-address/path/to/the/package/directory ./" | \
734tee -a /etc/apt/sources.list.d/repos.list</programlisting>
735
736 <para>Run <literal>apt-get update</literal> to fetch information from
737 the new repository:</para>
738
739 <programlisting># apt-get update</programlisting>
740 </section>
741
742 <section id="apt_install">
743 <title>Installing</title>
744
745 <para>DEB packages typically have file names like
746 foo-1.0.1-r0.0_arm64.deb The file name includes the package name
747 (foo), version (1.0.1), revison (r0.0), and architecture (arm64). To
748 install a package, log in as root and type the following command at a
749 shell prompt:</para>
750
751 <programlisting># apt-get install foo</programlisting>
752
753 <para>The <literal>apt-get install</literal> command will install one
754 or more packages in the system.</para>
755 </section>
756
757 <section id="apt_upgrade">
758 <title>Upgrading</title>
759
760 <para>The <literal>apt-get upgrade</literal> command will upgrade one
761 or more packages which are currently installed in the system. If no
762 packages are given, all installed packages will be checked.</para>
763
764 <programlisting># apt-get upgrade foo</programlisting>
765 </section>
766
767 <section id="apt_rm">
768 <title>Removing</title>
769
770 <para>The <literal>apt-get remove</literal> command will remove one or
771 more packages which are currently installed in the system.
772 Example:</para>
773
774 <programlisting># apt-get remove ptest-runner
775Reading package lists... Done
776Building dependency tree
777Reading state information... Done
778The following packages were automatically installed and are no longer required:
779 libc6-dbg libc6-dev libc6-extra-nss libc6-thread-db libcidn1
780 linux-libc-headers-dev
781Use 'apt autoremove' to remove them.
782The following packages will be REMOVED:
783 ptest-runner
7840 upgraded, 0 newly installed, 1 to remove and 0 not upgraded.
785After this operation, 0 B of additional disk space will be used.
786Do you want to continue? [Y/n] y
787(Reading database ... 5766 files and directories currently installed.)
788Removing ptest-runner (2.0.2+git0+6d2872116c-r0.0) ...
789</programlisting>
790 </section>
791
792 <section id="pm_searching">
793 <title>Searching</title>
794
795 <para>The <literal>apt-cache search</literal> allows searching for the
796 given expressions in the name, summary and description of known
797 packages. Example:</para>
798
799 <programlisting># apt-cache search ptest-runner
800ptest-runner - A C program to run all installed ptests
801ptest-runner-dbg - A C program to run all installed ptests - Debugging files
802ptest-runner-dev - A C program to run all installed ptests - Development files</programlisting>
803 </section>
804 </section>
805 </section>
806</chapter>
diff --git a/doc/book-enea-linux-user-guide/swcomp.mk b/doc/book-enea-linux-user-guide/swcomp.mk
new file mode 100644
index 0000000..8b81e97
--- /dev/null
+++ b/doc/book-enea-linux-user-guide/swcomp.mk
@@ -0,0 +1,10 @@
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-linux-user-guide-rt
9BOOKDESC_$(BOOKPACKAGES) := "Enea Linux $(PROD_VER) User's Guide"
10BOOKDEFAULTCONDITION := $(DEFAULTCONDITIONS)
diff --git a/doc/docsrc_common/pardoc-distro.xml b/doc/docsrc_common/pardoc-distro.xml
new file mode 100644
index 0000000..880b2fa
--- /dev/null
+++ b/doc/docsrc_common/pardoc-distro.xml
@@ -0,0 +1,27 @@
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
5<!-- Declarations to inherit by xi:include
6========================================== -->
7<section id="pardoc_names">
8 <title>Enea Linux DocBook XML Based UserDoc Names and Parameters</title>
9
10 <para>NOTE: DO NOT EDIT THIS FILE IN xmlmind but you can open it to see any errors, don't save!!!!</para>
11
12 <para>NOTE: Use xi:include to include parameters into a docbook XML file.
13 Note: Only full elements can be included and the included element must
14 be allowed in that place. Example: For ulink, entire ulink elements
15 must be included, not just parts of them.</para>
16
17 <para>**** The phrase elements below can be used as variables in several
18 places in XML files and/or in make script files ****</para>
19
20<!-- Distribution and release -->
21<!--
22 The parameter 'prev_baseline' is intentionally undefined here since this
23 is the first release of the RT profile.
24-->
25<para id="prev_lic_file"><phrase>doc/book-enea-linux-open-source/doc/licenses.xml</phrase></para>
26<para id="new_lic_file"><phrase>doc/book-enea-linux-open-source/doc/licenses.xml</phrase></para>
27</section>
diff --git a/doc/enea-linux-security-report b/doc/enea-linux-security-report
new file mode 100644
index 0000000..60b4597
--- /dev/null
+++ b/doc/enea-linux-security-report
@@ -0,0 +1,1055 @@
1CVE-2017-1000380
2Package: kernel
3Score: 2.1 (Low)
4Description: sound/core/timer.c in the Linux kernel before 4.11.5 is vulnerable to a data race in the ALSA /dev/snd/timer driver resulting in local users being able to read information belonging to other users, i.e., uninitialized memory contents may be disclosed when a read and an ioctl happen at the same time.
5Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000380
6
7CVE-2017-1000366
8Package: glibc
9Score: 7.2 (High)
10Description: glibc contains a vulnerability that allows specially crafted LD_LIBRARY_PATH values to manipulate the heap/stack, causing them to alias, potentially resulting in arbitrary code execution. Please note that additional hardening changes have been made to glibc to prevent manipulation of stack and heap memory but these issues are not directly exploitable, as such they have not been given a CVE.
11Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000366
12
13CVE-2017-1000365
14Package: kernel
15Score: 7.2 (High)
16Description: The Linux Kernel imposes a size restriction on the arguments and environmental strings passed through RLIMIT_STACK/RLIM_INFINITY (1/4 of the size), but does not take the argument and environment pointers into account, which allows attackers to bypass this limitation. This affects Linux Kernel versions 4.11.5 and earlier. It appears that this feature was introduced in the Linux Kernel version 2.6.23.
17Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000365
18
19CVE-2017-1000253
20Package: kernel
21Score: 8.0 (High)
22Description: A flaw was found in the way the Linux kernel loaded ELF executables. Provided that an application was built as Position Independent Executable (PIE), the loader could allow part of that application's data segment to map over the memory area reserved for its stack, potentially resulting in memory corruption. An unprivileged local user with access to SUID (or otherwise privileged) PIE binary could use this flaw to escalate their privileges on the system.Upstream patch:https://git.kernel.org/linus/a87938b2e246b81b4fb713edb371a9fa3c5c3c86
23Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name= CVE-2017-1000253
24
25CVE-2017-1000251
26Package: kernel
27Score: 8.3 (High)
28Description: The native Bluetooth stack in the Linux Kernel (BlueZ), starting at the Linux kernel version 2.6.32 and up to and including 4.13.1, are vulnerable to a stack overflow vulnerability in the processing of L2CAP configuration responses resulting in Remote code execution in kernel space.
29Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000251
30
31CVE-2017-1000250
32Package: bluez5
33Score: 3.3 (Minor)
34Description: All versions of the SDP server in BlueZ 5.46 and earlier are vulnerable to an information disclosure vulnerability which allows remote attackers to obtain sensitive information from the bluetoothd process memory. This vulnerability lies in the processing of SDP search attribute requests.
35Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000250
36
37CVE-2017-1000111
38Package: kernel
39Score: 7.2 (High)
40Description: Linux kernel: heap out-of-bounds in AF_PACKET sockets. This new issue is analogous to previously disclosed CVE-2016-8655. In both cases, a socket option that changes socket state may race with safety checks in packet_set_ring. Previously with PACKET_VERSION. This time with PACKET_RESERVE. The solution is similar: lock the socket for the update. This issue may be exploitable, we did not investigate further. As this issue affects PF_PACKET sockets, it requires CAP_NET_RAW in the process namespace. But note that with user namespaces enabled, any process can create a namespace in which it has CAP_NET_RAW.
41Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000111
42
43CVE-2017-1000101
44Package: curl
45Score: 4.0 (Medium)
46Description: curl supports "globbing" of URLs, in which a user can pass a numerical rangeto have the tool iterate over those numbers to do a sequence of transfers.In the globbing function that parses the numerical range, there was anomission that made curl read a byte beyond the end of the URL if given acarefully crafted, or just wrongly written, URL. The URL is stored in a heapbased buffer, so it could then be made to wrongly read something else insteadof crashing.
47Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000101
48
49CVE-2017-1000100
50Package: curl
51Score: 4.0 (Medium)
52Description: When doing an TFTP upload and curl/libcurl is given a URL that contains a verylong file name (longer than about 515 bytes), the file name is truncated tofit within the buffer boundaries, but the buffer size is still wrongly updatedto use the untruncated length. This too large value is then used in the`send()` call, making curl attempt to send more data than what is actually putinto the buffer. The `send()` function will then read beyond the end of theheap based buffer.
53Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000100
54
55CVE-2017-1000082
56Package: systemd
57Score: 10.0 (High)
58Description: systemd v233 and earlier fails to safely parse usernames starting with a numeric digit (e.g. "0day"), running the service in question with root privileges rather than the user intended.
59Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-1000082
60
61CVE-2017-18017
62Package: kernel
63Score: 5.0 (Medium)
64Description: The tcpmss_mangle_packet function in net/netfilter/xt_TCPMSS.c in the Linux kernel before 4.11, and 4.9.x before 4.9.36, allows remote attackers to cause a denial of service (use-after-free and memory corruption) or possibly have unspecified other impact by leveraging the presence of xt_TCPMSS in an iptables action.
65Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-18017
66
67CVE-2017-14496
68Package: dnsmasq
69Score: 7.0 (High)
70Description: Integer underflow in the add_pseudoheader function in dnsmasq before 2.78 , when the --add-mac, --add-cpe-id or --add-subnet option is specified, allows remote attackers to cause a denial of service via a crafted DNS request.
71Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-14496
72
73CVE-2017-14106
74Package: kernel
75Score: 4.9 (Medium)
76Description: The tcp_disconnect function in net/ipv4/tcp.c in the Linux kernel before 4.12 allows local users to cause a denial of service (__tcp_select_window divide-by-zero error and system crash) by triggering a disconnect within a certain tcp_recvmsg code path.
77Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-14106
78
79CVE-2017-13081
80Package: linux-firmware
81Score: 2.9 (Minor)
82Description: Wi-Fi Protected Access (WPA and WPA2) that supports IEEE 802.11w allows reinstallation of the Integrity Group Temporal Key (IGTK) during the group key handshake, allowing an attacker within radio range to spoof frames from access points to clients.
83Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-13081
84
85CVE-2017-13080
86Package: linux-firmware
87Score: 2.9 (Minor)
88Description: Wi-Fi Protected Access (WPA and WPA2) allows reinstallation of the Group Temporal Key (GTK) during the group key handshake, allowing an attacker within radio range to replay frames from access points to clients.
89Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-13080
90
91CVE-2017-12132
92Package: glibc
93Score: 4.3 (Medium)
94Description: The DNS stub resolver in the GNU C Library (aka glibc or libc6) before version 2.26, when EDNS support is enabled, will solicit large UDP responses from name servers, potentially simplifying off-path DNS spoofing attacks due to IP fragmentation.
95Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-12132
96
97CVE-2017-11176
98Package: kernel
99Score: 10.0 (High)
100Description: The mq_notify function in the Linux kernel through 4.11.9 does not set the sock pointer to NULL upon entry into the retry logic. During a user-space close of a Netlink socket, it allows attackers to cause a denial of service (use-after-free) or possibly have unspecified other impact.
101Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-11176
102
103CVE-2017-9955
104Package: GNU Binutils
105Score: 4.3 (Medium)
106Description: The get_build_id function in opncls.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, allows remote attackers to cause a denial of service (heap-based buffer over-read and application crash) via a crafted file in which a certain size field is larger than a corresponding data field, as demonstrated by mishandling within the objdump program.
107Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9955
108
109CVE-2017-9954
110Package: GNU Binutils
111Score: 4.3 (Medium)
112Description: The getvalue function in tekhex.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, allows remote attackers to cause a denial of service (stack-based buffer over-read and application crash) via a crafted tekhex file, as demonstrated by mishandling within the nm program.
113Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9954
114
115CVE-2017-9756
116Package: GNU Binutils
117Score: 6.8 (Medium)
118Description: The aarch64_ext_ldst_reglist function in opcodes/aarch64-dis.c in GNU Binutils 2.28 allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
119Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9756
120
121CVE-2017-9755
122Package: GNU Binutils (objdump)
123Score: 6.8 (Medium)
124Description: opcodes/i386-dis.c in GNU Binutils 2.28 does not consider the number of registers for bnd mode, which allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
125Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9755
126
127CVE-2017-9753
128Package: GNU Binutils
129Score: 6.8 (Medium)
130Description: The versados_mkobject function in bfd/versados.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, does not initialize a certain data structure, which allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
131Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9753
132
133CVE-2017-9752
134Package: GNU Binutils, libbfd
135Score: 6.8 (Medium)
136Description: bfd/vms-alpha.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file in the _bfd_vms_get_value and _bfd_vms_slurp_etir functions during \"objdump -D\" execution.
137Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9752
138
139CVE-2017-9751
140Package: GNU Binutils
141Score: 6.8 (Medium)
142Description: opcodes/rl78-decode.opc in GNU Binutils 2.28 has an unbounded GETBYTE macro, which allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
143Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9751
144
145CVE-2017-9750
146Package: GNU Binutils
147Score: 6.8 (Medium)
148Description: opcodes/rx-decode.opc in GNU Binutils 2.28 lacks bounds checks for certain scale arrays, which allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
149Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9750
150
151CVE-2017-9749
152Package: GNU Binutils
153Score: 6.8 (Medium)
154Description: The *regs* macros in opcodes/bfin-dis.c in GNU Binutils 2.28 allow remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
155Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9749
156
157CVE-2017-9748
158Package: GNU Binutils
159Score: 6.8 (Medium)
160Description: The ieee_object_p function in bfd/ieee.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, might allow remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution. NOTE: this may be related to a compiler bug.
161Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9748
162
163CVE-2017-9747
164Package: GNU Binutils (libbfd)
165Score: 6.8 (Medium)
166Description: The ieee_archive_p function in bfd/ieee.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, might allow remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution. NOTE: this may be related to a compiler bug.
167Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9747
168
169CVE-2017-9746
170Package: GNU Binutils
171Score: 6.8 (Medium)
172Description: The disassemble_bytes function in objdump.c in GNU Binutils 2.28 allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of rae insns printing for this file during \"objdump -D\" execution.
173Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9746
174
175CVE-2017-9745
176Package: GNU Binutils (libbfd)
177Score: 6.8 (Medium)
178Description: The _bfd_vms_slurp_etir function in bfd/vms-alpha.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
179Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9745
180
181CVE-2017-9744
182Package: GNU Binutils (libbfd)
183Score: 6.8 (Medium)
184Description: The sh_elf_set_mach_from_flags function in bfd/elf32-sh.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
185Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9744
186
187CVE-2017-9742
188Package: GNU Binutils (objdump)
189Score: 6.8 (Medium)
190Description: The score_opcodes function in opcodes/score7-dis.c in GNU Binutils 2.28 allows remote attackers to cause a denial of service (buffer overflow and application crash) or possibly have unspecified other impact via a crafted binary file, as demonstrated by mishandling of this file during \"objdump -D\" execution.
191Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9742
192
193CVE-2017-9445
194Package: systemd
195Score: 5.0 (Medium)
196Description: In systemd through 233, certain sizes passed to dns_packet_new in systemd-resolved can cause it to allocate a buffer that's too small. A malicious DNS server can exploit this via a response with a specially crafted TCP payload to trick systemd-resolved into allocating a buffer that's too small, and subsequently write arbitrary data beyond the end of it.
197Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9445
198
199CVE-2017-9050
200Package: libxml2-native
201Score: 5.0 (Medium)
202Description: libxml2 20904-GITv2.9.4-16-g0741801 is vulnerable to a heap-based buffer over-read in the xmlDictAddString function in dict.c. This vulnerability causes programs that use libxml2, such as PHP, to crash. This vulnerability exists because of an incomplete fix for CVE-2016-1839.
203Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9050
204
205CVE-2017-9049
206Package: libxml2-native
207Score: 5.0 (Medium)
208Description: libxml2 20904-GITv2.9.4-16-g0741801 is vulnerable to a heap-based buffer over-read in the xmlDictComputeFastKey function in dict.c. This vulnerability causes programs that use libxml2, such as PHP, to crash. This vulnerability exists because of an incomplete fix for libxml2 Bug 759398.
209Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9049
210
211CVE-2017-9048
212Package: libxml2-native
213Score: 5.0 (Medium)
214Description: libxml2 20904-GITv2.9.4-16-g0741801 is vulnerable to a stack-based buffer overflow. The function xmlSnprintfElementContent in valid.c is supposed to recursively dump the element content definition into a char buffer 'buf' of size 'size'. At the end of the routine, the function may strcat two more characters without checking whether the current strlen(buf) + 2 < size. This vulnerability causes programs that use libxml2, such as PHP, to crash.
215Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9048
216
217CVE-2017-9047
218Package: libxml2-native
219Score: 5.0 (Medium)
220Description: A buffer overflow was discovered in libxml2 20904-GITv2.9.4-16-g0741801. The function xmlSnprintfElementContent in valid.c is supposed to recursively dump the element content definition into a char buffer 'buf' of size 'size'. The variable len is assigned strlen(buf). If the content->type is XML_ELEMENT_CONTENT_ELEMENT, then (i) the content->prefix is appended to buf (if it actually fits) whereupon (ii) content->name is written to the buffer. However, the check for whether the content->name actually fits also uses 'len' rather than the updated buffer length strlen(buf). This allows us to write about "size" many bytes beyond the allocated memory. This vulnerability causes programs that use libxml2, such as PHP, to crash.
221Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9047
222
223CVE-2017-9044
224Package: GNU Binutils (readelf)
225Score: 4.3 (Medium)
226Description: The print_symbol_for_build_attribute function in readelf.c in GNU Binutils 2017-04-12 allows remote attackers to cause a denial of service (invalid read and SEGV) via a crafted ELF file.
227Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9044
228
229CVE-2017-9042
230Package: GNU Binutils
231Score: 6.8 (Medium)
232Description: readelf.c in GNU Binutils 2017-04-12 has a \"cannot be represented in type long\" issue, which might allow remote attackers to cause a denial of service (application crash) or possibly have unspecified other impact via a crafted ELF file.
233Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9042
234
235CVE-2017-9040
236Package: GNU Binutils
237Score: 4.3 (Medium)
238Description: GNU Binutils 2017-04-03 allows remote attackers to cause a denial of service (NULL pointer dereference and application crash), related to the process_mips_specific function in readelf.c, via a crafted ELF file that triggers a large memory-allocation attempt.
239Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9040
240
241CVE-2017-9039
242Package: GNU Binutils (readelf)
243Score: 4.3 (Medium)
244Description: GNU Binutils 2.28 allows remote attackers to cause a denial of service (memory consumption) via a crafted ELF file with many program headers, related to the get_program_headers function in readelf.c.
245Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9039
246
247CVE-2017-9038
248Package: GNU Binutils (readelf)
249Score: 4.3 (Medium)
250Description: GNU Binutils 2.28 allows remote attackers to cause a denial of service (heap-based buffer over-read and application crash) via a crafted ELF file, related to the byte_get_little_endian function in elfcomm.c, the get_unwind_section_word function in readelf.c, and ARM unwind information that contains invalid word offsets.
251Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-9038
252
253CVE-2017-8872
254Package: libxml2-native
255Score: 6.4 (Medium)
256Description: The htmlParseTryOrFinish function in HTMLparser.c in libxml2 2.9.4 allows attackers to cause a denial of service (buffer over-read) or information disclosure.
257Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8872
258
259CVE-2017-8831
260Package: kernel
261Score: 7.2 (High)
262Description: The saa7164_bus_get function in drivers/media/pci/saa7164/saa7164-bus.c in the Linux kernel through 4.10.14 allows local users to cause a denial of service (out-of-bounds array access) or possibly have unspecified other impact by changing a certain sequence-number value, aka a "double fetch" vulnerability.
263Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8831
264
265CVE-2017-8804
266Package: glibc
267Score: 7.8 (High)
268Description: The xdr_bytes and xdr_string functions in the GNU C Library (aka glibc or libc6) 2.25 mishandle failures of buffer deserialization, which allows remote attackers to cause a denial of service (virtual memory allocation, or memory consumption if an overcommit setting is not used) via a crafted UDP packet to port 111, a related issue to CVE-2017-8779.
269Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8804
270
271CVE-2017-8779
272Package: rpcbind
273Score: 7.8 (High)
274Description: rpcbind through 0.2.4, LIBTIRPC through 1.0.1 and 1.0.2-rc through 1.0.2-rc3, and NTIRPC through 1.4.3 do not consider the maximum RPC data size during memory allocation for XDR strings, which allows remote attackers to cause a denial of service (memory consumption with no subsequent free) via a crafted UDP packet to port 111, aka rpcbomb
275Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8779
276
277CVE-2017-8421
278Package: GNU Binutils
279Score: 7.1 (High)
280Description: The function coff_set_alignment_hook in coffcode.h in Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, has a memory leak vulnerability which can cause memory exhaustion in objdump via a crafted PE file. Additional validation in dump_relocs_in_section in objdump.c can resolve this.
281Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8421
282
283CVE-2017-8398
284Package: GNU Binutils
285Score: 5.0 (Medium)
286Description: dwarf.c in GNU Binutils 2.28 is vulnerable to an invalid read of size 1 during dumping of debug information from a corrupt binary. This vulnerability causes programs that conduct an analysis of binary programs, such as objdump and readelf, to crash.
287Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8398
288
289CVE-2017-8397
290Package: GNU Binutils
291Score: 5.0 (Medium)
292Description: The Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, is vulnerable to an invalid read of size 1 and an invalid write of size 1 during processing of a corrupt binary containing reloc(s) with negative addresses. This vulnerability causes programs that conduct an analysis of binary programs using the libbfd library, such as objdump, to crash.
293Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8397
294
295CVE-2017-8396
296Package: GNU Binutils
297Score: 5.0 (Medium)
298Description: The Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, is vulnerable to an invalid read of size 1 because the existing reloc offset range tests didn't catch small negative offsets less than the size of the reloc field. This vulnerability causes programs that conduct an analysis of binary programs using the libbfd library, such as objdump, to crash.
299Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8396
300
301CVE-2017-8395
302Package: GNU Binutils
303Score: 5.0 (Medium)
304Description: The Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, is vulnerable to an invalid write of size 8 because of missing a malloc() return-value check to see if memory had actually been allocated in the _bfd_generic_get_section_contents function. This vulnerability causes programs that conduct an analysis of binary programs using the libbfd library, such as objcopy, to crash.
305Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8395
306
307CVE-2017-8394
308Package: GNU Binutils
309Score: 5.0 (Medium)
310Description: The Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, is vulnerable to an invalid read of size 4 due to NULL pointer dereferencing of _bfd_elf_large_com_section. This vulnerability causes programs that conduct an analysis of binary programs using the libbfd library, such as objcopy, to crash.
311Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8394
312
313CVE-2017-8393
314Package: GNU Binutils
315Score: 5.0 (Medium)
316Description: The Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, is vulnerable to a global buffer over-read error because of an assumption made by code that runs for objcopy and strip, that SHT_REL/SHR_RELA sections are always named starting with a .rel/.rela prefix. This vulnerability causes programs that conduct an analysis of binary programs using the libbfd library, such as objcopy and strip, to crash.
317Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8393
318
319CVE-2017-8392
320Package: GNU Binutils
321Score: 5.0 (Medium)
322Description: The Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, is vulnerable to an invalid read of size 8 because of missing a check to determine whether symbols are NULL in the _bfd_dwarf2_find_nearest_line function. This vulnerability causes programs that conduct an analysis of binary programs using the libbfd library, such as objdump, to crash.
323Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8392
324
325CVE-2017-8283
326Package: dpkg
327Score: 7.5 (High)
328Description: dpkg-source in dpkg 1.3.0 through 1.18.23 is able to use a non-GNU patch program and does not offer a protection mechanism for blank-indented diff hunks, which allows remote attackers to conduct directory traversal attacks via a crafted Debian source package, as demonstrated by use of dpkg-source on NetBSD.
329Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8283
330
331CVE-2017-8105
332Package: freetype
333Score: 7.5 (High)
334Description: FreeType 2 before 2017-03-24 has an out-of-bounds write caused by a heap-based buffer overflow related to the t1_decoder_parse_charstrings function in psaux/t1decode.c.
335Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8105
336
337CVE-2017-8072
338Package: kernel
339Score: 7.2 (High)
340Description: The cp2112_gpio_direction_input function in drivers/hid/hid-cp2112.c in the Linux kernel 4.9.x before 4.9.9 does not have the expected EIO error status for a zero-length report, which allows local users to have an unspecified impact via unknown vectors.
341Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8072
342
343CVE-2017-8071
344Package: kernel
345Score: 2.1 (Low)
346Description: drivers/hid/hid-cp2112.c in the Linux kernel 4.9.x before 4.9.9 uses a spinlock without considering that sleeping is possible in a USB HID request callback, which allows local users to cause a denial of service (deadlock) via unspecified vectors.
347Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8071
348
349CVE-2017-8070
350Package: kernel
351Score: 7.2 (High)
352Description: drivers/net/usb/catc.c in the Linux kernel 4.9.x before 4.9.11 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
353Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8070
354
355CVE-2017-8069
356Package: kernel
357Score: 7.2 (High)
358Description: drivers/net/usb/rtl8150.c in the Linux kernel 4.9.x before 4.9.11 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
359Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8069
360
361CVE-2017-8068
362Package: kernel
363Score: 7.2 (High)
364Description: drivers/net/usb/pegasus.c in the Linux kernel 4.9.x before 4.9.11 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
365Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8068
366
367CVE-2017-8067
368Package: kernel
369Score: 7.2 (High)
370Description: drivers/char/virtio_console.c in the Linux kernel 4.9.x and 4.10.x before 4.10.12 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
371Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8067
372
373CVE-2017-8066
374Package: kernel
375Score: 7.2 (High)
376Description: drivers/net/can/usb/gs_usb.c in the Linux kernel 4.9.x and 4.10.x before 4.10.2 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
377Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8066
378
379CVE-2017-8065
380Package: kernel
381Score: 7.2 (High)
382Description: rypto/ccm.c in the Linux kernel 4.9.x and 4.10.x through 4.10.12 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
383Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8065
384
385CVE-2017-8064
386Package: kernel
387Score: 7.2 (High)
388Description: drivers/media/usb/dvb-usb-v2/dvb_usb_core.c in the Linux kernel 4.9.x and 4.10.x before 4.10.12 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
389Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8064
390
391CVE-2017-8063
392Package: kernel
393Score: 7.2 (High)
394Description: drivers/media/usb/dvb-usb/cxusb.c in the Linux kernel 4.9.x and 4.10.x before 4.10.12 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
395Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8063
396
397CVE-2017-8062
398Package: kernel
399Score: 7.2 (High)
400Description: drivers/media/usb/dvb-usb/dw2102.c in the Linux kernel 4.9.x and 4.10.x before 4.10.4 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
401Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8062
402
403CVE-2017-8061
404Package: kernel
405Score: 7.2 (High)
406Description: drivers/media/usb/dvb-usb/dvb-usb-firmware.c in the Linux kernel 4.9.x and 4.10.x before 4.10.7 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
407Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-8061
408
409CVE-2017-7895
410Package: kernel
411Score: 10.0 (High)
412Description: The NFSv2 and NFSv3 server implementations in the Linux kernel through 4.10.13 lack certain checks for the end of a buffer, which allows remote attackers to trigger pointer-arithmetic errors or possibly have unspecified other impact via crafted requests, related to fs/nfsd/nfs3xdr.c and fs/nfsd/nfsxdr.c.
413Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7895
414
415CVE-2017-7869
416Package: gnutls
417Score: 5.0 (Medium)
418Description: GnuTLS before 2017-02-20 has an out-of-bounds write caused by an integer overflow and heap-based buffer overflow related to the cdk_pkt_read function in opencdk/read-packet.c. This issue (which is a subset of the vendor's GNUTLS-SA-2017-3 report) is fixed in 3.5.10.
419Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7869
420
421CVE-2017-7645
422Package: kernel
423Score: 7.8 (High)
424Description: The NFSv2/NFSv3 server in the nfsd subsystem in the Linux kernel through 4.10.11 allows remote attackers to cause a denial of service (system crash) via a long RPC reply, related to net/sunrpc/svc.c, fs/nfsd/nfs3xdr.c, and fs/nfsd/nfsxdr.c.
425Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7645
426
427CVE-2017-7618
428Package: kernel
429Score: 7.8 (High)
430Description: crypto/ahash.c in the Linux kernel through 4.10.9 allows attackers to cause a denial of service (API operation calling its own callback, and infinite recursion) by triggering EBUSY on a full queue.
431Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7618
432
433CVE-2017-7614
434Package: GNU Binutils
435Score: 7.5 (High)
436Description: elflink.c in the Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, has a \"member access within null pointer\" undefined behavior issue, which might allow remote attackers to cause a denial of service (application crash) or possibly have unspecified other impact via an \"int main() {return 0;}\" program.
437Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7614
438
439CVE-2017-7487
440Package: kernel
441Score: 7.2 (High)
442Description: The ipxitf_ioctl function in net/ipx/af_ipx.c in the Linux kernel through 4.11.1 mishandles reference counts, which allows local users to cause a denial of service (use-after-free) or possibly have unspecified other impact via a failed SIOCGIFADDR ioctl call for an IPX interface.
443Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7487
444
445CVE-2017-7472
446Package: kernel
447Score: 4.9 (Medium)
448Description: The KEYS subsystem in the Linux kernel before 4.10.13 allows local users to cause a denial of service (memory consumption) via a series of KEY_REQKEY_DEFL_THREAD_KEYRING keyctl_set_reqkey_keyring calls.
449Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7472
450
451CVE-2017-7468
452Package: curl
453Score: 6.0 (Medium)
454Description: libcurl would attempt to resume a TLS session even if the client certificate had changed. That is unacceptable since a server by specification is allowed to skip the client certificate check on resume, and may instead use the old identity which was established by the previous certificate (or no certificate).
455Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7468
456
457CVE-2017-7407
458Package: curl
459Score: 2.1 (Low)
460Description: The ourWriteOut function in tool_writeout.c in curl 7.53.1 might allow physically proximate attackers to obtain sensitive information from process memory in opportunistic circumstances by reading a workstation screen during use of a --write-out argument ending in a '%' character, which leads to a heap-based buffer over-read.
461Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7407
462
463CVE-2017-7304
464Package: Binutils
465Score: 5.0 (Medium)
466Description: The Binary File Descriptor (BFD) library (aka libbfd), as distributed in GNU Binutils 2.28, is vulnerable to an invalid read (of size 8) because of missing a check (in the copy_special_section_fields function) for an invalid sh_link field before attempting to follow it. This vulnerability causes Binutils utilities like strip to crash.
467Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7304
468
469CVE-2017-7223
470Package: GNU Binutils
471Score: 5.0 (Medium)
472Description: GNU assembler in GNU Binutils 2.28 is vulnerable to a global buffer overflow (of size 1) while attempting to unget an EOF character from the input stream, potentially leading to a program crash.
473Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7223
474
475CVE-2017-7210
476Package: binutils
477Score: 7.8 (High)
478Description: objdump in GNU Binutils 2.28 is vulnerable to multiple heap-based buffer over-reads (of size 1 and size 8) while handling corrupt STABS enum type strings in a crafted object file, leading to program crash.
479Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7210
480
481CVE-2017-7209
482Package: binutils
483Score: 4.3 (Medium)
484Description: The dump_section_as_bytes function in readelf in GNU Binutils 2.28 accesses a NULL pointer while reading section contents in a corrupt binary, leading to a program crash.
485Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-7209
486
487CVE-2017-6969
488Package: binutils
489Score: 6.4 (Medium)
490Description: readelf in GNU Binutils 2.28 is vulnerable to a heap-based buffer over-read while processing corrupt RL78 binaries. The vulnerability can trigger program crashes. It may lead to an information leak as well.
491Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6969
492
493CVE-2017-6966
494Package: binutil
495Score: 4.0 (Medium)
496Description: readelf in GNU Binutils 2.28 has a use-after-free (specifically read-after-free) error while processing multiple, relocated sections in an MSP430 binary. This is caused by mishandling of an invalid symbol index, and mishandling of state across invocations.
497Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6966
498
499CVE-2017-6965
500Package: binutils
501Score: 4.3 (Medium)
502Description: readelf in GNU Binutils 2.28 writes to illegal addresses while processing corrupt input files containing symbol-difference relocations, leading to a heap-based buffer overflow.
503Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6965
504
505CVE-2017-6874
506Package: Kernel
507Score: 7.0 (High)
508Description: Race condition in kernel/ucount.c in the Linux kernel through 4.10.2 allows local users to cause a denial of service (use-after-free and system crash) or possibly have unspecified other impact via crafted system calls that leverage certain decrement behavior that causes incorrect interaction between put_ucounts and get_ucounts.
509Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6874
510
511CVE-2017-6353
512Package: Kernel
513Score: 5.0 (Medium)
514Description: net/sctp/socket.c in the Linux kernel through 4.10.1 does not properly restrict association peel-off operations during certain wait states, which allows local users to cause a denial of service (invalid unlock and double free) via a multithreaded application. NOTE: this vulnerability exists because of an incorrect fix for CVE-2017-5986.
515Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6353
516
517CVE-2017-6348
518Package: Kernel
519Score: 5.0 (Medium)
520Description: The hashbin_delete function in net/irda/irqueue.c in the Linux kernel before 4.9.13 improperly manages lock dropping, which allows local users to cause a denial of service (deadlock) via crafted operations on IrDA devices.
521Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6348
522
523CVE-2017-6347
524Package: Kernel
525Score: 7.0 (High)
526Description: The ip_cmsg_recv_checksum function in net/ipv4/ip_sockglue.c in the Linux kernel before 4.10.1 has incorrect expectations about skb data layout, which allows local users to cause a denial of service (buffer over-read) or possibly have unspecified other impact via crafted system calls, as demonstrated by use of the MSG_MORE flag in conjunction with loopback UDP transmission.
527Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6347
528
529CVE-2017-6346
530Package: Kernel
531Score: 7.0 (High)
532Description: Race condition in net/packet/af_packet.c in the Linux kernel before 4.9.13 allows local users to cause a denial of service (use-after-free) or possibly have unspecified other impact via a multithreaded application that makes PACKET_FANOUT setsockopt system calls.
533Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6346
534
535CVE-2017-6345
536Package: Kernel
537Score: 5.0 (Medium)
538Description: The LLC subsystem in the Linux kernel before 4.9.13 does not ensure that a certain destructor exists in required circumstances, which allows local users to cause a denial of service (BUG_ON) or possibly have unspecified other impact via crafted system calls.
539Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6345
540
541CVE-2017-6214
542Package: Kernel
543Score: 5.0 (Medium)
544Description: The tcp_splice_read function in net/ipv4/tcp.c in the Linux kernel before 4.9.11 allows remote attackers to cause a denial of service (infinite loop and soft lockup) via vectors involving a TCP packet with the URG flag.
545Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6214
546
547CVE-2017-6074
548Package: Kernel
549Score: 8.0 (High)
550Description: The dccp_rcv_state_process function in net/dccp/input.c in the Linux kernel through 4.9.11 mishandles DCCP_PKT_REQUEST packet data structures in the LISTEN state, which allows local users to obtain root privileges or cause a denial of service (double free) via an application that makes an IPV6_RECVPKTINFO setsockopt system call.
551Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6074
552
553CVE-2017-6001
554Package: Kernel
555Score: 8.0 (High)
556Description: Race condition in kernel/events/core.c in the Linux kernel before 4.9.7 allows local users to gain privileges via a crafted application that makes concurrent perf_event_open system calls for moving a software group into a hardware context. NOTE: this vulnerability exists because of an incomplete fix for CVE-2016-6786.
557Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-6001
558
559CVE-2017-5986
560Package: Kernel
561Score: 7.0 (High)
562Description: Race condition in the sctp_wait_for_sndbuf function in net/sctp/socket.c in the Linux kernel before 4.9.11 allows local users to cause a denial of service (assertion failure and panic) via a multithreaded application that peels off an association in a certain buffer-full state.
563Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5986
564
565CVE-2017-5970
566Package: Kernel
567Score: 5.0 (Medium)
568Description: The ipv4_pktinfo_prepare function in net/ipv4/ip_sockglue.c in the Linux kernel through 4.9.9 allows attackers to cause a denial of service (system crash) via (1) an application that makes crafted system calls or possibly (2) IPv4 traffic with invalid IP options.
569Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5970
570
571CVE-2017-5969
572Package: libxml2-native
573Score: 2.6 (Low)
574Description: libxml2 2.9.4, when used in recover mode, allows remote attackers to cause a denial of service (NULL pointer dereference) via a crafted XML document. NOTE: The maintainer states "I would disagree of a CVE with the Recover parsing option which should only be used for manual recovery at least for XML parser."
575Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5969
576
577CVE-2017-5848
578Package: gstreamer
579Score: 5.0 (Medium)
580Description: The gst_ps_demux_parse_psm function in gst/mpegdemux/gstmpegdemux.c in gst-plugins-bad in GStreamer allows remote attackers to cause a denial of service (invalid memory read and crash) via vectors involving PSM parsing.
581Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5848
582
583CVE-2017-5847
584Package: gstreamer
585Score: 5.0 (Medium)
586Description: The gst_asf_demux_process_ext_content_desc function in gst/asfdemux/gstasfdemux.c in gst-plugins-ugly in GStreamer allows remote attackers to cause a denial of service (out-of-bounds heap read) via vectors involving extended content descriptors.
587Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5847
588
589CVE-2017-5669
590Package: Kernel
591Score: 5.0 (Medium)
592Description: The do_shmat function in ipc/shm.c in the Linux kernel through 4.9.12 does not restrict the address calculated by a certain rounding operation, which allows local users to map page zero, and consequently bypass a protection mechanism that exists for the mmap system call, by making crafted shmget and shmat system calls in a privileged context.
593Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5669
594
595CVE-2017-5618
596Package: GNU screen
597Score: 7.2 (High)
598Description: GNU screen before 4.5.1 allows local users to modify arbitrary files and consequently gain root privileges by leveraging improper checking of logfile permissions.
599Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5618
600
601CVE-2017-5601
602Package: libarchive
603Score: 5.0 (Medium)
604Description: An error in the lha_read_file_header_1() function (archive_read_support_format_lha.c) in libarchive 3.2.2 allows remote attackers to trigger an out-of-bounds read memory access and subsequently cause a crash via a specially crafted archive.
605Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5601
606
607CVE-2017-5577
608Package: Kernel
609Score: 5.0 (Medium)
610Description: The vc4_get_bcl function in drivers/gpu/drm/vc4/vc4_gem.c in the VideoCore DRM driver in the Linux kernel before 4.9.7 does not set an errno value upon certain overflow detections, which allows local users to cause a denial of service (incorrect pointer dereference and OOPS) via inconsistent size values in a VC4_SUBMIT_CL ioctl call.
611Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5577
612
613CVE-2017-5576
614Package: Kernel
615Score: 7.0 (High)
616Description: Integer overflow in the vc4_get_bcl function in drivers/gpu/drm/vc4/vc4_gem.c in the VideoCore DRM driver in the Linux kernel before 4.9.7 allows local users to cause a denial of service or possibly have unspecified other impact via a crafted size value in a VC4_SUBMIT_CL ioctl call.
617Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5576
618
619CVE-2017-5551
620Package: Kernel
621Score: 4.0 (Medium)
622Description: The simple_set_acl function in fs/posix_acl.c in the Linux kernel before 4.9.6 preserves the setgid bit during a setxattr call involving a tmpfs filesystem, which allows local users to gain group privileges by leveraging the existence of a setgid program with restrictions on execute permissions. NOTE: this vulnerability exists because of an incomplete fix for CVE-2016-7097.
623Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5551
624
625CVE-2017-5548
626Package: Kernel
627Score: 7.0 (High)
628Description: drivers/net/ieee802154/atusb.c in the Linux kernel 4.9.x before 4.9.6 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
629Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5548
630
631CVE-2017-5547
632Package: Kernel
633Score: 7.0 (High)
634Description: drivers/hid/hid-corsair.c in the Linux kernel 4.9.x before 4.9.6 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a DMA scatterlist.
635Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5547
636
637CVE-2017-5546
638Package: Kernel
639Score: 7.0 (High)
640Description: The freelist-randomization feature in mm/slab.c in the Linux kernel 4.8.x and 4.9.x before 4.9.5 allows local users to cause a denial of service (duplicate freelist entries and system crash) or possibly have unspecified other impact in opportunistic circumstances by leveraging the selection of a large value for a random number.
641Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5546
642
643CVE-2017-5335
644Package: GnuTLS
645Score: 5.0 (Medium)
646Description: The stream reading functions in lib/opencdk/read-packet.c in GnuTLS before 3.3.26 and 3.5.x before 3.5.8 allow remote attackers to cause a denial of service (out-of-memory error and crash) via a crafted OpenPGP certificate.
647Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5335
648
649CVE-2017-5225
650Package: tiff
651Score: 7.5 (High)
652Description: LibTIFF version 4.0.7 is vulnerable to a heap buffer overflow in the tools/tiffcp resulting in DoS or code execution via a crafted BitsPerSample value.
653Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5225
654
655CVE-2017-5029
656Package: libxslt
657Score: 6.8 (Medium)
658Description: The xsltAddTextString function in transform.c in libxslt 1.1.29, as used in Blink in Google Chrome prior to 57.0.2987.98 for Mac, Windows, and Linux and 57.0.2987.108 for Android, lacked a check for integer overflow during a size calculation, which allowed a remote attacker to perform an out of bounds memory write via a crafted HTML page.
659Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-5029
660
661CVE-2017-3731
662Package: OpenSSL
663Score: 5.0 (Medium)
664Description: If an SSL/TLS server or client is running on a 32-bit host, and a specific cipher is being used, then a truncated packet can cause that server or client to perform an out-of-bounds read, usually resulting in a crash. For OpenSSL 1.1.0, the crash can be triggered when using CHACHA20/POLY1305; users should upgrade to 1.1.0d. For Openssl 1.0.2, the crash can be triggered when using RC4-MD5; users who have not disabled that algorithm should update to 1.0.2k.
665Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-3731
666
667CVE-2017-3136
668Package: bind
669Score: 5.9 (Medium)
670Description: A query with a specific set of characteristics could cause a server using DNS64 to encounter an assertion failure and terminate.An attacker could deliberately construct a query, enabling denial-of-service against a server if it was configured to use the DNS64 feature and other preconditions were met.
671Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-3136
672
673CVE-2017-3135
674Package: bind
675Score: 6.0 (Medium)
676Description: Under some conditions when using both DNS64 and RPZ to rewrite query responses, query processing can resume in an inconsistent state leading to either an INSIST assertion failure or an attempt to read through a NULL pointer.
677Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-3135
678
679CVE-2017-2636
680Package: Kernel
681Score: 7.2 (High)
682Description: Race condition in drivers/tty/n_hdlc.c in the Linux kernel through 4.10.1 allows local users to gain privileges or cause a denial of service (double free) by setting the HDLC line discipline.
683Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-2636
684
685CVE-2017-2628
686Package: curl
687Score: 0.0 (Low)
688Description: It was found that the fix for CVE-2015-3148 in curl was incomplete. An application using libcurl with HTTP Negotiate authentication could incorrectly re-use credentials for subsequent requests to the same server.
689Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2017-2628
690
691CVE-2016-10350
692Package: libarchive
693Score: 4.3 (Medium)
694Description: The archive_read_format_cab_read_header function in archive_read_support_format_cab.c in libarchive 3.2.2 allows remote attackers to cause a denial of service (heap-based buffer over-read and application crash) via a crafted file.
695Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10350
696
697CVE-2016-10349
698Package: libarchive
699Score: 4.2 (Medium)
700Description: The archive_le32dec function in archive_endian.h in libarchive 3.2.2 allows remote attackers to cause a denial of service (heap-based buffer over-read and application crash) via a crafted file.
701Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10349
702
703CVE-2016-10229
704Package: kernel
705Score: 10.0 (High)
706Description: udp.c in the Linux kernel before 4.5 allows remote attackers to execute arbitrary code via UDP traffic that triggers an unsafe second checksum calculation during execution of a recv system call with the MSG_PEEK flag.
707Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10229
708
709CVE-2016-10228
710Package: glibc
711Score: 4.2 (Medium)
712Description: The iconv program in the GNU C Library (aka glibc or libc6) 2.25 and earlier, when invoked with the -c option, enters an infinite loop when processing invalid multi-byte input sequences, leading to a denial of service.
713Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10228
714
715CVE-2016-10208
716Package: Kernel
717Score: 5.0 (Medium)
718Description: The ext4_fill_super function in fs/ext4/super.c in the Linux kernel through 4.9.8 does not properly validate meta block groups, which allows physically proximate attackers to cause a denial of service (out-of-bounds read and system crash) via a crafted ext4 image.
719Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10208
720
721CVE-2016-10200
722Package: Kernel
723Score: 7.0 (High)
724Description: Race condition in the L2TPv3 IP Encapsulation feature in the Linux kernel before 4.8.14 allows local users to gain privileges or cause a denial of service (use-after-free) by making multiple bind system calls without properly ascertaining whether a socket has the SOCK_ZAPPED status, related to net/l2tp/l2tp_ip.c and net/l2tp/l2tp_ip6.c.
725Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10200
726
727CVE-2016-10154
728Package: Kernel
729Score: 5.0 (Medium)
730Description: The smbhash function in fs/cifs/smbencrypt.c in the Linux kernel 4.9.x before 4.9.1 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging use of more than one virtual page for a scatterlist.
731Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10154
732
733CVE-2016-10153
734Package: Kernel
735Score: 7.0 (High)
736Description: The crypto scatterlist API in the Linux kernel 4.9.x before 4.9.6 interacts incorrectly with the CONFIG_VMAP_STACK option, which allows local users to cause a denial of service (system crash or memory corruption) or possibly have unspecified other impact by leveraging reliance on earlier net/ceph/crypto.c code.
737Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10153
738
739CVE-2016-10150
740Package: KVM
741Score: 10.0 (High)
742Description: Use-after-free vulnerability in the kvm_ioctl_create_device function in virt/kvm/kvm_main.c in the Linux kernel before 4.8.13 allows host OS users to cause a denial of service (host OS crash) or possibly gain privileges via crafted ioctl calls on the /dev/kvm device.
743Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10150
744
745CVE-2016-10147
746Package: Kernel
747Score: 5.0 (Medium)
748Description: crypto/mcryptd.c in the Linux kernel before 4.8.15 allows local users to cause a denial of service (NULL pointer dereference and system crash) by using an AF_ALG socket with an incompatible algorithm, as demonstrated by mcryptd(md5).
749Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10147
750
751CVE-2016-10044
752Package: Kernel
753Score: 7.0 (High)
754Description: The aio_mount function in fs/aio.c in the Linux kernel before 4.7.7 does not properly restrict execute access, which makes it easier for local users to bypass intended SELinux W^X policy restrictions, and consequently gain privileges, via an io_setup system call.
755Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-10044
756
757CVE-2016-9844
758Package: unzip
759Score: 2.1 (Low)
760Description: Buffer overflow in the zi_short function in zipinfo.c in Info-Zip UnZip 6.0 allows remote attackers to cause a denial of service (crash) via a large compression method value in the central directory file header.
761Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-9844
762
763CVE-2016-9754
764Package: Kernel
765Score: 7.0 (High)
766Description: The ring_buffer_resize function in kernel/trace/ring_buffer.c in the profiling subsystem in the Linux kernel before 4.6.1 mishandles certain integer calculations, which allows local users to gain privileges by writing to the /sys/kernel/debug/tracing/buffer_size_kb file.
767Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-9754
768
769CVE-2016-9444
770Package: bind
771Score: 7.0 (High)
772Description: named in ISC BIND 9.x before 9.9.9-P5, 9.10.x before 9.10.4-P5, and 9.11.x before 9.11.0-P2 allows remote attackers to cause a denial of service (assertion failure and daemon exit) via a crafted DS resource record in an answer.
773Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-9444
774
775CVE-2016-9401
776Package: bash
777Score: 2.0 (Low)
778Description: ref to yocto patch: http://git.yoctoproject.org/cgit/cgit.cgi/poky/commit/?id=1b2857a781b6666feaf5d3c91dc02ac263d0c4f6
779Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-9401
780
781CVE-2016-9318
782Package: libxml2-native
783Score: 6.8 (Medium)
784Description: libxml2 2.9.4 and earlier, as used in XMLSec 1.2.23 and earlier and other products, does not offer a flag directly indicating that the current document may be read but other files may not be opened, which makes it easier for remote attackers to conduct XML External Entity (XXE) attacks via a crafted document.
785Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-9318
786
787CVE-2016-9083
788Package: Kernel
789Score: 8.0 (High)
790Description: drivers/vfio/pci/vfio_pci.c in the Linux kernel through 4.8.11 allows local users to bypass integer overflow checks, and cause a denial of service (memory corruption) or have unspecified other impact, by leveraging access to a vfio PCI device file for a VFIO_DEVICE_SET_IRQS ioctl call, aka a "state machine confusion bug."
791Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-9083
792
793CVE-2016-8864
794Package: bind
795Score: 5.0 (Medium)
796Description: named in ISC BIND 9.x before 9.9.9-P4, 9.10.x before 9.10.4-P4, and 9.11.x before 9.11.0-P1 allows remote attackers to cause a denial of service (assertion failure and daemon exit) via a DNAME record in the answer section of a response to a recursive query, related to db.c and resolver.c.
797Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8864
798
799CVE-2016-8858
800Package: OpenSSL
801Score: 7.8 (High)
802Description: A memory exhaustion issue in OpenSSH that can be triggered before user authentication was found. An unauthenticated attacker could consume approx. 400 MB of memory per each connection. The attacker could set up multiple such connections to run out of server’s memory.
803Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8858
804
805CVE-2016-8655
806Package: Kernel
807Score: 8.0 (High)
808Description: Race condition in net/packet/af_packet.c in the Linux kernel through 4.8.12 allows local users to gain privileges or cause a denial of service (use-after-free) by leveraging the CAP_NET_RAW capability to change a socket version, related to the packet_set_ring and packet_setsockopt functions.
809Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8655
810
811CVE-2016-8636
812Package: Kernel
813Score: 7.0 (High)
814Description: Integer overflow in the mem_check_range function in drivers/infiniband/sw/rxe/rxe_mr.c in the Linux kernel before 4.9.10 allows local users to cause a denial of service (memory corruption), obtain sensitive information from kernel memory, or possibly have unspecified other impact via a write or read request involving the "RDMA protocol over infiniband" (aka Soft RoCE) technology.
815Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8636
816
817CVE-2016-8630
818Package: Kernel
819Score: 6.0 (Medium)
820Description: The x86_decode_insn function in arch/x86/kvm/emulate.c in the Linux kernel before 4.8.7, when KVM is enabled, allows local users to cause a denial of service (host OS crash) via a certain use of a ModR/M byte in an undefined instruction.
821Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8630
822
823CVE-2016-8625
824Package: curl
825Score: 6.9 (Medium)
826Description: When curl is built with libidn to handle International Domain Names (IDNA), ittranslates them to puny code for DNS resolving using the IDNA 2003 standard,while IDNA 2008 is the modern and up-to-date IDNA standard.This misalignment causes problems with for example domains using the German ßcharacter (known as the Unicode Character 'LATIN SMALL LETTER SHARP S') whichis used at times in the .de TLD and is translated differently in the two IDNAstandards, leading to users potentially and unknowingly issuing networktransfer requests to the wrong host.For example, `straße.de` is translated into `strasse.de` using IDNA 2003 butis translated into `xn--strae-oqa.de` using IDNA 2008. Needless to say, thosehost names could very well resolve to different addresses and be twocompletely independent servers. IDNA 2008 is mandatory for .de domains.curl is not alone with this problem, as there's currently a big flux in theworld of network user-agents about which IDNA version to support and use.This name problem exists for DNS-using protocols in curl, but only when builtto use libidn.
827Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8625
828
829CVE-2016-8624
830Package: curl
831Score: 6.9 (Medium)
832Description: curl doesn't parse the authority component of the URL correctly when the hostname part ends with a '#' character, and could instead be tricked intoconnecting to a different host. This may have security implications if you forexample use an URL parser that follows the RFC to check for allowed domainsbefore using curl to request them.Passing in `http://example.com#@evil.com/x.txt` would wrongly make curl send arequest to evil.com while your browser would connect to example.com given thesame URL.The problem exists for most protocol schemes.
833Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8624
834
835CVE-2016-8623
836Package: curl
837Score: 4.9 (Medium)
838Description: libcurl explicitly allows users to share cookies between multiple easy handlesthat are concurrently employed by different threads.When cookies to be sent to a server are collected, the matching functioncollects all cookies to send and the cookie lock is released immediatelyafterwards. That function however only returns a list with *references* back tothe original strings for name, value, path and so on. Therefore, if anotherthread quickly takes the lock and frees one of the original cookie structstogether with its strings, a use-after-free can occur and lead to informationdisclosure. Another thread can also replace the contents of the cookies fromseparate HTTP responses or API calls.
839Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8623
840
841CVE-2016-8622
842Package: curl
843Score: 4.9 (Medium)
844Description: The URL percent-encoding decode function in libcurl is called`curl_easy_unescape`. Internally, even if this function would be made toallocate a unscape destination buffer larger than 2GB, it would return thatnew length in a signed 32 bit integer variable, thus the length would geteither just truncated or both truncated and turned negative. That could thenlead to libcurl writing outside of its heap based buffer.This can be triggered by a user on a 64bit system if the user can send in acustom (very large) URL to a libcurl using program.
845Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8622
846
847CVE-2016-8621
848Package: curl
849Score: 4.9 (Medium)
850Description: The `curl_getdate` converts a given date string into a numerical timestamp andit supports a range of different formats and possibilites to express a dateand time. The underlying date parsing function is also used internally whenparsing for example HTTP cookies (possibly received from remote servers) andit can be used when doing conditional HTTP requests.The date parser function uses the libc sscanf() function at two places, withthe parsing strings "%02d:%02d" and ""%02d:%02d:%02d". The intent being thatit would parse either a string with HH:MM (two digits colon two digits) orHH:MM:SS (two digits colon two digits colon two digits). If instead the pieceof time that was sent in had the final digit cut off, thus ending with asingle-digit, the date parser code would advance its read pointer one byte toomuch and end up reading out of bounds.
851Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8621
852
853CVE-2016-8620
854Package: curl
855Score: 6.9 (Medium)
856Description: The curl tool's "globbing" feature allows a user to specify a numerical rangethrough which curl will iterate. It is typically specified as [1-5],specifying the first and the last numbers in the range. Or with [a-z], usingletters.1. The curl code for parsing the second *unsigned* number did not check for aleading minus character, which allowed a user to specify `[1--1]` with nocomplaints and have the latter `-1` number get turned into the largestunsigned long value the system can handle. This would ultimately cause curl towrite outside the dedicated malloced buffer after no less than 100,000iterations, since it would have room for 5 digits but not 6.2. When the range is specified with letters, and the ending letter is left out`[L-]`, the code would still advance its read pointer 5 bytes even if thestring was just 4 bytes and end up reading outside the given buffer.
857Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8620
858
859CVE-2016-8619
860Package: curl
861Score: 6.9 (Medium)
862Description: In curl's implementation of the Kerberos authentication mechanism, thefunction `read_data()` in security.c is used to fill the necessary krb5structures. When reading one of the length fields from the socket, it fails toensure that the length parameter passed to realloc() is not set to 0.This would lead to realloc() getting called with a zero size and when doing sorealloc() returns NULL *and* frees the memory - in contrary to normalrealloc() fails where it only returns NULL - causing libcurl to free thememory *again* in the error path.This flaw could be triggered by a malicious or just otherwise ill-behavingserver.
863Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8619
864
865CVE-2016-8618
866Package: curl
867Score: 6.9 (Medium)
868Description: The libcurl API function called `curl_maprintf()` can be tricked into doing adouble-free due to an unsafe `size_t` multiplication, on systems using 32 bit`size_t` variables. The function is also used internallty in numeroussituations.The function doubles an allocated memory area with realloc() and allows thesize to wrap and become zero and when doing so realloc() returns NULL *and*frees the memory - in contrary to normal realloc() fails where it only returnsNULL - causing libcurl to free the memory *again* in the error path.Systems with 64 bit versions of the `size_t` type are not affected by thisissue.This behavior is triggable using the publicly exposed function.
869Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8618
870
871CVE-2016-8617
872Package: curl
873Score: 6.9 (Medium)
874Description: In libcurl's base64 encode function, the output buffer is allocated as followswithout any checks on insize: malloc( insize * 4 / 3 + 4 )On systems with 32-bit addresses in userspace (e.g. x86, ARM, x32), themultiplication in the expression wraps around if insize is at least 1GB ofdata. If this happens, an undersized output buffer will be allocated, but thefull result will be written, thus causing the memory behind the output bufferto be overwritten.If a username is set directly via `CURLOPT_USERNAME` (or curl's `-u, --user`option), this vulnerability can be triggered. The name has to be at least512MB big in a 32bit system.Systems with 64 bit versions of the `size_t` type are not affected by thisissue.
875Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8617
876
877CVE-2016-8616
878Package: curl
879Score: 3.9 (Low)
880Description: When re-using a connection, curl was doing case insensitive comparisons of user name and password with the existing connections.This means that if an unused connection with proper credentials exists for a protocol that has connection-scoped credentials, an attacker can cause that connection to be reused if s/he knows the case-insensitive version of the correct password.We are not aware of any exploit of this flaw.
881Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8616
882
883CVE-2016-8615
884Package: curl
885Score: 6.9 (Medium)
886Description: If cookie state is written into a cookie jar file that is later read back and used for subsequent requests, a malicious HTTP server can inject new cookies for arbitrary domains into said cookie jar.The issue pertains to the function that loads cookies into memory, which reads the specified file into a fixed-size buffer in a line-by-line manner using the fgets() function. If an invocation of fgets() cannot read the whole line into the destination buffer due to it being too small, it truncates the output. This way, a very long cookie (name + value) sent by a malicious server would be stored in the file and subsequently that cookie could be read partially and crafted correctly, it could be treated as a different cookie for another server.We are not aware of any exploit of this flaw.
887Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-8615
888
889CVE-2016-7795
890Package: systemd
891Score: 4.9 (Medium)
892Description: The manager_invoke_notify_message function in systemd 231 and earlier allows local users to cause a denial of service (assertion failure and PID 1 hang) via a zero-length message received over a notify socket.
893Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-7795
894
895CVE-2016-7097
896Package: Kernel
897Score: 3.6 (Low)
898Description: The filesystem implementation in the Linux kernel through 4.8.2 preserves the setgid bit during a setxattr call, which allows local users to gain group privileges by leveraging the existence of a setgid program with restrictions on execute permissions.
899Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-7097
900
901CVE-2016-6489
902Package: nettle
903Score: 5.0 (Medium)
904Description: The RSA and DSA decryption code in Nettle makes it easier for attackers to discover private keys via a cache side channel attack.
905Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6489
906
907CVE-2016-6480
908Package: Kernel
909Score: 4.7 (Medium)
910Description: Race condition in the ioctl_send_fib function in drivers/scsi/aacraid/commctrl.c in the Linux kernel through 4.7 allows local users to cause a denial of service (out-of-bounds access or system crash) by changing a certain size value, aka a "double fetch" vulnerability.
911Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6480
912
913CVE-2016-6354
914Package: flex
915Score: 7.5 (High)
916Description: Heap-based buffer overflow in the yy_get_next_buffer function in Flex before 2.6.1 might allow context-dependent attackers to cause a denial of service or possibly execute arbitrary code via vectors involving num_to_read.
917Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6354
918
919CVE-2016-6323
920Package: glibc
921Score: 5.0 (Medium)
922Description: The makecontext function in the GNU C Library (aka glibc or libc6) before 2.25 creates execution contexts incompatible with the unwinder on ARM EABI (32-bit) platforms, which might allow context-dependent attackers to cause a denial of service (hang), as demonstrated by applications compiled using gccgo, related to backtrace generation.
923Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6323
924
925CVE-2016-6321
926Package: Tar (Gnu)
927Score: 5.0 (Medium)
928Description: Directory traversal vulnerability in the safer_name_suffix function in GNU tar 1.14 through 1.29 might allow remote attackers to bypass an intended protection mechanism and write to arbitrary files via vectors related to improper sanitization of the file_name parameter, aka POINTYFEATHER.
929Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6321
930
931CVE-2016-6318
932Package: cracklib
933Score: 7.5 (High)
934Description: Stack-based buffer overflow in the FascistGecosUser function in lib/fascist.c in cracklib allows local users to cause a denial of service (application crash) or gain privileges via a long GECOS field, involving longbuffer.
935Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6318
936
937CVE-2016-6301
938Package: busybox
939Score: 7.1 (High)
940Description: The recv_and_process_client_pkt function in networking/ntpd.c in busybox allows remote attackers to cause a denial of service (CPU and bandwidth consumption) via a forged NTP packet, which triggers a communication loop.
941Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6301
942
943CVE-2016-6252
944Package: shadow
945Score: 5.0 (Medium)
946Description: Integer overflow in shadow 4.2.1 allows local users to gain privileges via crafted input to newuidmap. Patch: https://bugzilla.suse.com/attachment.cgi?id=684679&action=diff
947Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6252
948
949CVE-2016-6185
950Package: Perl
951Score: 5.0 (Medium)
952Description: The XSLoader::load method in XSLoader in Perl does not properly locate .so files when called in a string eval, which might allow local users to execute arbitrary code via a Trojan horse library under the current working directory.
953Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6185
954
955CVE-2016-6170
956Package: bind
957Score: 6.0 (Medium)
958Description: DNS protocols were designed with the assumption that a certain amount of trust could be presumed between the operators of primary and secondary servers for a given zone. However, in current practice some organizations have scenarios which require them to accept zone data from sources that are not fully trusted (for example: providers of secondary name service). A party who is allowed to feed data into a zone (e.g. by AXFR, IXFR, or Dynamic DNS updates) can overwhelm the server which is accepting data by intentionally or accidentally exhausting that server's memory.https://kb.isc.org/article/AA-01390
959Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6170
960
961CVE-2016-6131
962Package: gcc
963Score: 4.9 (Medium)
964Description: A stack overflow vulnerability in the libiberty demangler was found, which causes its host application to crash on a tainted branch instruction. The problem is caused by a self-reference in a mangled type string that is "remembered" for later reference. This leads to an infinite recursion during the demangling.
965Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-6131
966
967CVE-2016-5636
968Package: CPython
969Score: 10.0 (High)
970Description: Integer overflow in the get_data function in zipimport.c in CPython (aka Python) before 2.7.12, 3.x before 3.4.5, and 3.5.x before 3.5.2 allows remote attackers to have unspecified impact via a negative data size value, which triggers a heap-based buffer overflow.
971Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-5636
972
973CVE-2016-5300
974Package: expat
975Score: 7.8 (High)
976Description: The XML parser in Expat does not use sufficient entropy for hash initialization, which allows context-dependent attackers to cause a denial of service (CPU consumption) via crafted identifiers in an XML document. NOTE: this vulnerability exists because of an incomplete fix for CVE-2012-0876.
977Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-5300
978
979CVE-2016-5131
980Package: libxml2
981Score: 10.0 (High)
982Description: Use-after-free vulnerability in libxml2 (used in chromium-browser) through 2.9.4, as used in Google Chrome before 52.0.2743.82, allows remote attackers to cause a denial of service or possibly have unspecified other impact via vectors related to the XPointer range-to function.
983Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-5131
984
985CVE-2016-4658
986Package: libxml2
987Score: 10.0 (High)
988Description: libxml2 in Apple iOS before 10, OS X before 10.12, tvOS before 10, and watchOS before 3 allows remote attackers to execute arbitrary code or cause a denial of service (memory corruption) via a crafted XML document.
989Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-4658
990
991CVE-2016-4448
992Package: libxml2
993Score: 10.0 (High)
994Description: Format string vulnerability in libxml2 before 2.9.4 allows attackers to have unspecified impact via format string specifiers in unknown vectors.
995Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-4448
996
997CVE-2016-2775
998Package: bind
999Score: 4.3 (Medium)
1000Description: ISC BIND 9.x before 9.9.9-P2, 9.10.x before 9.10.4-P2, and 9.11.x before 9.11.0b2, when lwresd or the named lwres option is enabled, allows remote attackers to cause a denial of service (daemon crash) via a long request that uses the lightweight resolver protocol.
1001Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-2775
1002
1003CVE-2016-2381
1004Package: Perl
1005Score: 5.0 (Medium)
1006Description: Perl might allow context-dependent attackers to bypass the taint protection mechanism in a child process via duplicate environment variables in envp.
1007Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-2381
1008
1009CVE-2016-2183
1010Package: OpenSSL
1011Score: 5.0 (Medium)
1012Description: The DES and Triple DES ciphers, as used in the TLS, SSH, and IPSec protocols and other protocols and products, have a birthday bound of approximately four billion blocks, which makes it easier for remote attackers to obtain cleartext data via a birthday attack against a long-duration encrypted session, as demonstrated by an HTTPS session using Triple DES in CBC mode, aka a "Sweet32" attack.
1013Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-2183
1014
1015CVE-2016-2147
1016Package: busybox
1017Score: 5.0 (Medium)
1018Description: Integer overflow in the DHCP client (udhcpc) in BusyBox before 1.25.0 allows remote attackers to cause a denial of service (crash) via a malformed RFC1035-encoded domain name, which triggers an out-of-bounds heap write.
1019Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-2147
1020
1021CVE-2016-0800
1022Package: OpenSSL
1023Score: 4.3 (Medium)
1024Description: The SSLv2 protocol, as used in OpenSSL before 1.0.1s and 1.0.2 before 1.0.2g and other products, requires a server to send a ServerVerify message before establishing that a client possesses certain plaintext RSA data, which makes it easier for remote attackers to decrypt TLS ciphertext data by leveraging a Bleichenbacher RSA padding oracle, aka a "DROWN" attack.
1025Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-0800
1026
1027CVE-2016-0718
1028Package: expat
1029Score: 7.5 (High)
1030Description: Expat allows context-dependent attackers to cause a denial of service (crash) or possibly execute arbitrary code via a malformed input document, which triggers a buffer overflow.
1031Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-0718
1032
1033CVE-2016-0634
1034Package: bash
1035Score: 5.0 (Medium)
1036Description: A vulnerability was found in a way bash expands the $HOSTNAME. Injecting the hostname with malicious code would cause it to run each time bash expanded \h in the prompt string.
1037Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2016-0634
1038
1039CVE-2015-9019
1040Package: libxslt-native
1041Score: 5.0 (Medium)
1042Description: In libxslt 1.1.29 and earlier, the EXSLT math.random function was not initialized with a random seed during startup, which could cause usage of this function to produce predictable outputs
1043Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-9019
1044
1045CVE-2015-5224
1046Package: util-linux
1047Score: 7.5 (High)
1048Description: The mkostemp function in login-utils in util-linux when used incorrectly allows remote attackers to cause file name collision and possibly other attacks.
1049Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2015-5224
1050
1051CVE-2014-9365
1052Package: python
1053Score: 5.8 (Medium)
1054Description: The HTTP clients in the (1) httplib, (2) urllib, (3) urllib2, and (4) xmlrpclib libraries in CPython (aka Python) 2.x before 2.7.9 and 3.x before 3.4.3, when accessing an HTTPS URL, do not (a) check the certificate against a trust store or verify that the server hostname matches a domain name in the subject's (b) Common Name or (c) subjectAltName field of the X.509 certificate, which allows man-in-the-middle attackers to spoof SSL servers via an arbitrary valid certificate.
1055Ref: https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2014-9365
diff --git a/doc/gen_known_issues.py b/doc/gen_known_issues.py
new file mode 100644
index 0000000..f926f9f
--- /dev/null
+++ b/doc/gen_known_issues.py
@@ -0,0 +1,122 @@
1#!/usr/bin/python
2
3#------------------------------------------------------------------------------
4#
5# This script generates an XML file with a table with issues in Jira. See the
6# variable 'conditions' for query details. It is used bu the make system in
7# the generation of the release notes.
8#
9# The result is printed to STDOUT.
10#
11# It is possible to override the generation. If there is a file named
12# jiraissues_override.xml in the current directory, then that file will be
13# printed instead. This mechanism can be used if the table needs manual
14# modifications.
15#
16#------------------------------------------------------------------------------
17
18from subprocess import check_output
19import json, re, datetime
20import time
21
22try:
23 with open("book-enea-linux-release-info/doc/jiraissues_override.xml") as f:
24 print f.read(),
25
26 exit(0)
27
28except SystemExit:
29 # Printing the override file was successful. Exception raised by
30 # the exit() call in the try block.
31 exit(0)
32
33except IOError:
34 # Accessing the override file failed. Assume that it does not exist
35 # and proceed with normal operation.
36 pass
37
38jd = json.JSONDecoder()
39
40def jira_query(query):
41 jira_url = "http://eneaissues.enea.com"
42 fields = "key,summary"
43 query = query.replace(" ", "+")
44
45 cmd = ["curl",
46 "-s",
47 "-D-",
48 "-u", "rest_reader:jira123",
49 "-X", "GET",
50 "-H", "Content-Type: application/json",
51 jira_url + "/rest/api/2/search?jql=" + query + "&fields=" + fields
52 ]
53
54 tmp = check_output(cmd).splitlines()
55 tmp = jd.decode(tmp[-1])
56 return tmp["issues"]
57
58conditions = ("project=LXCR",
59 "issueType=bug",
60 "resolution=Unresolved",
61 'affectedversion="EL7_Std_ARM"'
62 )
63
64bugs = []
65
66time_str = time.strftime("%Y-%m-%d, %H:%M:%S (%Z)")
67
68for issue in jira_query(" and ".join(conditions)):
69 bugs.append((issue["key"], issue["fields"]["summary"]))
70
71print '<?xml version="1.0" encoding="ISO-8859-1"?>'
72print '<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"'
73print '"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">'
74print '<section id="relinfo_extracted_from_jira">'
75print ' <title>Extracted from Jira</title>'
76print
77print ' <para>'
78print ' In the table below are the issue(s) that currently affect this specific release. Use the ticket reference provided for each issue, to look up further information if needed. Extracted at %s.' % time_str
79print ' </para>'
80print
81print ' <remark>Jira query: (%s)</remark>' % "\n and ".join(conditions)
82print
83print ' <informaltable>'
84print ' <tgroup cols="2">'
85print ' <colspec colwidth="6*" colname="c1"/>'
86print
87print ' <colspec align="center" colwidth="1*" colname="c2"/>'
88print
89print ' <thead>'
90print ' <row>'
91print ' <entry align="center">Summary</entry>'
92print
93print ' <entry>Enea Ref</entry>'
94print ' </row>'
95print ' </thead>'
96print
97print ' <tbody>',
98
99if bugs:
100 for bug in sorted(bugs):
101 print
102 print ' <row>'
103 print ' <entry>%s</entry>' % bug[1]
104 print
105 print ' <entry>%s</entry>' % bug[0]
106 print ' </row>'
107
108else:
109 print ' <row>'
110 print ' <entry namest="c1" nameend="c2" align="center">'
111 print ' No issues found'
112 print ' </entry>'
113 print ' </row>'
114
115print ' </tbody>'
116print ' </tgroup>'
117print ' </informaltable>'
118
119if bugs:
120 print ' <para>Number of open bugs: %d</para>' % len(bugs)
121
122print '</section>'
diff --git a/doc/gen_pkgdiff.py b/doc/gen_pkgdiff.py
new file mode 100644
index 0000000..7697469
--- /dev/null
+++ b/doc/gen_pkgdiff.py
@@ -0,0 +1,237 @@
1#!/bin/python
2###############################################################################
3#
4# Diff two licenses.xml files. There are two cases:
5# * Two arguments
6# In this case, the two arguments are the two files to compare
7#
8# * No arguments
9# In this casem the license files are specified by the following
10# parameters in pardoc-distro.xml:
11# - prev_baseline
12# - prev_lic_file
13# - new_lic_file
14#
15# The result is presented as three sets:
16# 1) Removed
17# Packages present in the previous file, but not in the new.
18#
19# 2) Added
20# Packages present in the new file, but not in the previous.
21#
22# 3) Changed
23# Packages present in both files, but with different versions. If more than
24# one version of a package is included, then all difference in the version
25# set causes the package to be listed as changed.
26# E.g.
27# (v1) -> (v2)
28# (v1, v2) -> (v2, v3)
29#
30# Note that packages with the unchanged version is not listed.
31#
32# The output is presented as XML code printed to stdout. A summary is printed
33# to STDERR at the end.
34#
35###############################################################################
36
37import os
38import sys
39import subprocess as sp
40import xml.etree.ElementTree as ET
41import re
42
43repo_root = sp.check_output(["git", "rev-parse", "--show-toplevel"]).rstrip()
44script_root = os.path.dirname(os.path.realpath(__file__))
45param_file = os.path.join(script_root, "docsrc_common/pardoc-distro.xml")
46
47def get_param(param_name):
48 pat = re.compile("%s.*>([^<>]+)</" % param_name)
49
50 with open(param_file) as f:
51 for line in f:
52 m = pat.search(line)
53 if m:
54 return m.group(1)
55
56 return None
57
58def get_pkgs(file_spec):
59 if file_spec.find(":") >= 0:
60 s = sp.check_output(("git", "show", file_spec))
61 else:
62 f = open(file_spec)
63 s = f.read()
64 f.close()
65 del f
66
67 # ET can't handle some special quotes
68 for old, new in (("&rdquor;", "&quot;"), ("&rdquo;", "&quot;")):
69 s = s.replace(old, new)
70
71 root = ET.fromstring(s)
72
73 for node in root.iter("section"):
74 if "id" in node.attrib:
75 if node.attrib["id"] == "licenses_packages":
76 break
77
78 else:
79 return None
80
81 for node in node:
82 if node.tag == "informaltable":
83 break
84 else:
85 return None
86
87 tab = node[0][-1]
88
89 plist = dict()
90 for row in tab:
91 pname = row[0].text
92 pver = row[1].text
93 if not pname in plist:
94 plist[pname] = set()
95
96 plist[pname].add(pver)
97
98 return set(plist), plist
99
100#----------------------------------------
101
102
103if len(sys.argv) == 3:
104 new_file, prev_file = sys.argv[1:3]
105
106elif len(sys.argv) == 1:
107 prev_baseline = get_param("prev_baseline")
108 prev_lic_file = get_param("prev_lic_file")
109 new_lic_file = get_param("new_lic_file")
110
111 if not (prev_baseline and prev_lic_file and new_lic_file):
112 print '<?xml version="1.0" encoding="ISO-8859-1"?>'
113 print '<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"'
114 print '"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">'
115 print '<section id="relinfo-package-set-changes">'
116 print ' <title>Changes in the Set of Provided Package</title>'
117 print ' <para>'
118 print ' N/A. No previous baseline defined.'
119 print ' </para>'
120 print '</section>'
121 exit(0)
122
123 new_file = os.path.relpath(os.path.join(repo_root, new_lic_file))
124 prev_file = "%s:%s" % (prev_baseline, prev_lic_file)
125
126else:
127 sys.stderr.write("Usage:\n")
128 sys.stderr.write(" 1) %s\n" % sys.argv[0])
129 sys.stderr.write(" 2) %s " % sys.argv[0])
130 sys.stderr.write("<new license file> <old license file>\n")
131 sys.stderr.write("\n")
132 sys.stderr.write("In case 1, the files are specified using the following\n")
133 sys.stderr.write("parameters in pardoc-distro.xml:\n")
134 sys.stderr.write(" - prev_baseline\n")
135 sys.stderr.write(" - prev_lic_file\n")
136 sys.stderr.write(" - new_lic_file\n")
137 exit()
138
139sys.stderr.write("New license file : %s\n" % new_file)
140sys.stderr.write("Prev license file : %s\n" % prev_file)
141
142old_pset, old_pdict = get_pkgs(prev_file)
143new_pset, new_pdict = get_pkgs(new_file)
144
145added = new_pset - old_pset # Set subtraction
146removed = old_pset - new_pset # Set subtraction
147common = old_pset & new_pset
148changed = [ p for p in common if old_pdict[p] != new_pdict[p] ]
149
150print '<?xml version="1.0" encoding="ISO-8859-1"?>'
151print '<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"'
152print '"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">'
153print '<section id="relinfo-package-set-changes">'
154print ' <title>Changes in the Set of Provided Package</title>'
155print ' <para>'
156print ' This section describes changes in the provided packages.'
157print ' </para>'
158print ' <section id="relinfo-added-packages">'
159print ' <title>Added Packages</title>'
160print ' <para>The following packages were added to this Enea Linux release:</para>'
161print ' <informaltable>'
162print ' <tgroup cols="2">'
163print ' <thead>'
164print ' <row>'
165print ' <entry>Package</entry>'
166print ' <entry>Version(s)</entry>'
167print ' </row>'
168print ' </thead>'
169print ' <tbody>'
170
171for p in sorted(list(added)):
172 print ' <row>'
173 print ' <entry>%s</entry>' % p
174 print ' <entry>%s</entry>' % ", ".join(sorted(new_pdict[p]))
175 print ' </row>'
176
177print ' </tbody>'
178print ' </tgroup>'
179print ' </informaltable>'
180print ' </section>'
181
182print ' <section id="relinfo-removed-packages">'
183print ' <title>Removed Packages</title>'
184print ' <para>The following packages were removed from this Enea Linux release:</para>'
185print ' <informaltable>'
186print ' <tgroup cols="2">'
187print ' <thead>'
188print ' <row>'
189print ' <entry>Package</entry>'
190print ' <entry>Version(s)</entry>'
191print ' </row>'
192print ' </thead>'
193print ' <tbody>'
194for p in sorted(list(removed)):
195 print ' <row>'
196 print ' <entry>%s</entry>' % p
197 print ' <entry>%s</entry>' % ", ".join(sorted(old_pdict[p]))
198 print ' </row>'
199print ' </tbody>'
200print ' </tgroup>'
201print ' </informaltable>'
202print ' </section>'
203
204print ' <section id="relinfo-changed-packages">'
205print ' <title>Changed Package Versions</title>'
206print ' <para>The following packages were updated to a newer version in this Enea Linux release:</para>'
207print ' <informaltable>'
208print ' <tgroup cols="3">'
209print ' <thead>'
210print ' <row>'
211print ' <entry>Package</entry>'
212print ' <entry>Previous Version(s)</entry>'
213print ' <entry>New Version(s)</entry>'
214print ' </row>'
215print ' </thead>'
216print ' <tbody>'
217for p in sorted(list(changed)):
218 print ' <row>'
219 print ' <entry>%s</entry>' % p
220 print ' <entry>%s</entry>' % ", ".join(sorted(old_pdict[p]))
221 print ' <entry>%s</entry>' % ", ".join(sorted(new_pdict[p]))
222 print ' </row>'
223
224print ' </tbody>'
225print ' </tgroup>'
226print ' </informaltable>'
227print ' </section>'
228print '</section>'
229
230sys.stderr.write("Package Summary:\n")
231sys.stderr.write(" Prev file : %3d\n" % len(old_pset))
232sys.stderr.write(" New file : %3d\n" % len(new_pset))
233sys.stderr.write(" Added : %3d\n" % len(added))
234sys.stderr.write(" Removed : %3d\n" % len(removed))
235sys.stderr.write(" Changed : %3d\n" % len(changed))
236sys.stderr.write(" Unchanged : %3d\n" % (len(common) - len(changed)))
237sys.stderr.write("Done\n")
diff --git a/doc/init.mk b/doc/init.mk
new file mode 100644
index 0000000..7dc5efd
--- /dev/null
+++ b/doc/init.mk
@@ -0,0 +1,100 @@
1# Makefile including this should first set nondefault BRANCH_DOCENEACOMMON before including it
2# and should have targets init: s_docbuild and optional initcommon: s_doceneacommon
3# Typically let doc: depend on init and initcommon inside Makefile
4# Manually optionally set GLOBALTMPCLONEROOT to yes or to a parent dir for tmpcommon
5# This init.mk file ver
6# R1.00/2016-04-29
7# R2.00/2017-03-30 changed linux/documentation.git and it's old branch to linux/el_releases-common.git and it's new branch
8
9ifeq ($(VERBOSE),yes)
10VERB :=
11else
12VERB := @
13endif
14
15#Git repositories to be cloned
16REPO_DOCBUILD := build/docbuild.git
17NAME_DOCBUILD := docbuild
18REPO_DOCENEACOMMON := linux/el_releases-common.git
19NAME_DOCENEACOMMON := doceneacommon
20
21# Set nondefault BRANCH_DOCENEACOMMON in Makefile
22BRANCH_DOCENEACOMMON ?= master
23# Separate clones of el_releases-common.git with different branches, needed if cloned globally with risk that different distros can be at same place
24ifneq ($(BRANCH_DOCENEACOMMON),master)
25NAME_DOCENEACOMMON := doceneacommon_$(BRANCH_DOCENEACOMMON)
26endif
27
28GLOBALTMPCLONEROOT = ../../tmpcommon
29ifeq ($(BOOK_GLOBALCLONEROOT),)
30 TMPCLONEROOT := tmpcommon
31else
32 ifeq ($(BOOK_GLOBALCLONEROOT),yes)
33 TMPCLONEROOT := $(GLOBALTMPCLONEROOT)
34 else
35 TMPCLONEROOT := $(BOOK_GLOBALCLONEROOT)/tmpcommon
36 endif
37endif
38DIR_TMPCLONEROOT := $(dir $(TMPCLONEROOT))
39ifeq ($(wildcard $(DIR_TMPCLONEROOT)),)
40$(error Parent of selected clone root does not exist ($(DIR_TMPCLONEROOT)))
41endif
42
43.PHONY: initbuild initcommon usageinit cleaninit
44# Keep usageinit as default target here to avoid init by mistake
45
46usageinit: docusage
47 @echo 'make initbuild Create s_docbuild and if not exists, clone docbuild.git'
48 @echo 'make initcommon Create s_doceneacommon and if not exists, clone el_releases-common.git'
49 @echo ' Default clone in tmpcommon'
50 @echo ' BOOK_GLOBALCLONEROOT=yes Clone in $(GLOBALTMPCLONEROOT)'
51 @echo ' BOOK_GLOBALCLONEROOT=parentdir Clone in parentdir/tmpcommon'
52 @echo ' Default branch for el_releases-common.git is master'
53 @echo ' BRANCH_DOCENEACOMMON=... If another branch, Makefile should set this'
54 @echo 'make pullbuild git pull in s_docbuild'
55 @echo 'make pullcommon git pull in s_doceneacommon'
56 @echo 'make cleaninit Delete all s_* symlinks and local tmpcommon/'
57
58
59# MOVE these to Makefile and set also non-default BRANCH_DOCENEACOMMON in Makefile
60initbuild: s_docbuild
61initcommon: s_doceneacommon
62pullbuild:
63 $(VERB)if [ ! -d s_docbuild ]; then echo "ERROR: No s_docbuild exists?" ; exit 10 ; fi
64 $(VERB)cd s_docbuild ; git pull
65pullcommon:
66 $(VERB)if [ ! -d s_doceneacommon ]; then echo "ERROR: No s_doceneacommon exists?" ; exit 10 ; fi
67 $(VERB)cd s_doceneacommon ; git pull
68
69s_docbuild: $(TMPCLONEROOT)/$(NAME_DOCBUILD)
70 $(VERB)rm s_docbuild 2>/dev/null; ln -s $(TMPCLONEROOT)/$(NAME_DOCBUILD) s_docbuild
71
72s_doceneacommon: $(TMPCLONEROOT)/$(NAME_DOCENEACOMMON)
73 $(VERB)rm s_doceneacommon 2>/dev/null; ln -s $(TMPCLONEROOT)/$(NAME_DOCENEACOMMON) s_doceneacommon
74
75$(TMPCLONEROOT)/$(NAME_DOCBUILD):
76 $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi
77 $(VERB)if [ -d "$(TMPCLONEROOT)/$(NAME_DOCBUILD)" ] ; then \
78 echo "Already exists $(TMPCLONEROOT)/$(NAME_DOCBUILD)" ; \
79 echo "Doing git pull instead"; cd $(TMPCLONEROOT)/$(NAME_DOCBUILD) ; git pull ; \
80 else \
81 echo "Cloning $(REPO_DOCBUILD) in $(TMPCLONEROOT)" ; \
82 cd "$(TMPCLONEROOT)" ; \
83 git clone -b master git@git.enea.se:$(REPO_DOCBUILD) $(NAME_DOCBUILD) ; \
84 fi
85
86$(TMPCLONEROOT)/$(NAME_DOCENEACOMMON):
87 $(VERB)if [ ! -d "$(TMPCLONEROOT)" ] ; then mkdir -p "$(TMPCLONEROOT)" ; fi
88 $(VERB)if [ -d "$(TMPCLONEROOT)/$(NAME_DOCENEACOMMON)" ] ; then \
89 echo "Already exists $(TMPCLONEROOT)/$(NAME_DOCENEACOMMON)" ; \
90 echo "Doing git pull instead"; cd $(TMPCLONEROOT)/$(NAME_DOCENEACOMMON) ; git pull ; \
91 else \
92 echo "Cloning $(REPO_DOCENEACOMMON) in $(TMPCLONEROOT) as $(NAME_DOCENEACOMMON)" ; \
93 cd "$(TMPCLONEROOT)"; \
94 git clone -b $(BRANCH_DOCENEACOMMON) git@git.enea.se:$(REPO_DOCENEACOMMON) $(NAME_DOCENEACOMMON) ; \
95 fi
96
97cleaninit:
98 @echo "Clean only local tmpcommon/ and all local temporary symlinks s_docbuild s_targets etc."
99 $(VERB)rm -rf tmpcommon 2>/dev/null ; true
100 $(VERB)rm s_* 2>/dev/null ; true
diff --git a/doc/initbuildboot.sh b/doc/initbuildboot.sh
new file mode 100644
index 0000000..37b691f
--- /dev/null
+++ b/doc/initbuildboot.sh
@@ -0,0 +1,115 @@
1#!/bin/sh
2VER="R0.07"
3# R0.07/lejo 2017-01-20 Add -readmebasedir to the README files from the manifest instead of s_targets
4
5BBTEMPLATE=
6BBXML=
7BB_TARGETREADME_BASE=
8
9USAGE="`basename $0` -xml buildbootxml-to-create -template templatexml-file -readmebasedir targetreadmebase ($VER)
10 Currently only supports sequence types Build-command: and Boot-command:
11 Both files should have path book-*release-info/doc/
12 Creates the XML file from the template, inserting build/boot commands
13 from the various s_manifests/el_manifest-XXX/XXXtargetXXX/README files
14 at the place in template with >SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE<
15 ignoring rest of template
16 The code tries to fold too long lines, but this is not perfect. Best would
17 be if the command lines already in README are short enough, e.g. by
18 using short variables, which work both on shell and uboot command lines"
19
20while echo "x$1" | egrep '^x-' >/dev/null 2>&1
21do
22 OPT="$1" ; shift
23 if [ "$OPT" = "--help" -o "$OPT" = "-h" -o "$OPT" = "-help" ] ; then echo "$USAGE" ; exit ; fi
24 if [ "$OPT" = "-xml" ] ; then BBXML="$1" ; shift; fi
25 if [ "$OPT" = "-template" ] ; then BBTEMPLATE="$1" ; shift; fi
26 if [ "$OPT" = "-readmebasedir" ] ; then BB_TARGETREADME_BASE="$1" ; shift; fi
27done
28if [ "$BBTEMPLATE" = "" ]; then echo "ERROR: Missing option -template templatefile"; exit ; fi
29if [ "$BBXML" = "" ]; then echo "ERROR: Missing option -xml buildbootxml-to-create"; exit ; fi
30if [ ! -f "$BBTEMPLATE" ]; then echo "ERROR: Missing templatefile '$BBTEMPLATE'"; exit; fi
31if [ ! -d "`dirname \"$BBXML\"`" ]; then echo "ERROR: Missing parent directory for '$BBXML'"; exit ; fi
32if [ ! -d "$BB_TARGETREADME_BASE" ]; then echo "ERROR: Missing basedir for README files '$BB_TARGETREADME_BASE'"; exit; fi
33
34echo "`basename $0` Creating $BBXML from"
35TARGETREADMES=`cd $BB_TARGETREADME_BASE ; ls -d */README | tr '\n' ' '`
36echo " $TARGETREADMES"
37
38# README file formats:
39# a) Sequence starts: ___ XXXX:yyyy or ___ XXXX:yyyy conffile
40# where XXXX is a type, yyyy is text to be in title
41# b) Inside sequence: ___ END ends the sequence (ignore rest of line)
42# c) Inside sequence: # Documentation line
43# d) Inside sequence: Anything else is command or config lines
44# Conv.to XML: ">" "<" "&" and put all inside <programlisting>
45# *) Anywhere ____xxxx Leading 4 underlines or more, always ignored
46# unless one of the recognized XXXX
47# *) Anywhere outside sequence, ignore all
48# *) There can be multiple of each type of sequence in each README file
49# with different yyyy
50
51
52cat $BBTEMPLATE | awk '
53 />SCRIPT_INCLUDES_BUILD_BOOT_SECTIONS_HERE</ {exit 0; }
54 { print $0; }
55' >$BBXML
56
57
58# Long command lines: The awk code below breaks too long lines, but this is not perfect.
59extractcmds_filter() {
60 echo " <programlisting>" | tr -d '\n'
61 sed '/^___/d;s/\&/\&amp;/g' | sed 's/</\&lt;/g;s/>/\&gt;/g;/^$/d' | \
62 awk 'BEGIN { MAX=90; }
63 ( length($0) > MAX ) {
64 LINE=$0;
65 while (length(LINE) > MAX) {
66 if (index(LINE," ") == 0 ) {
67 print "ERROR: PROBLEM: No space in too long line:" LINE > "/dev/stderr";
68 print $LINE;
69 next;
70 }
71 i=MAX; while ( substr(LINE,i,1) != " " ) { i=i-1; if (i==0) {break;} }
72 print substr(LINE,0,i) "\\";
73 REST=substr(LINE,i+1);
74 if ( length(REST) == 0 ) { next ; }
75 LINE=" " REST;
76 }
77 if ( length(LINE) > 0 ) { print LINE; next ; }
78 }
79 { print;}'
80 echo "</programlisting>"
81}
82
83extractcmds_for_type() { # target/README BOOTorBUILD
84 README=$BB_TARGETREADME_BASE/"$1"
85 CMDTYPE="$2"
86 COMMANDSFOR=`egrep "___$CMDTYPE:" $README`
87 for CMDS in $COMMANDSFOR
88 do
89 cmdsfor=`echo "$CMDS" | sed 's/[^:]*://'`
90#-- echo " <para>$CMDTYPE for $cmdsfor</para>"
91 cat "$README" | sed -n "/$COMMANDSFOR/,/___END/p" | extractcmds_filter
92 done
93}
94
95for targetreadme in $TARGETREADMES
96do
97 TARGET=`dirname $targetreadme`
98 echo "" >>$BBXML
99 echo " <section id=\"target_$TARGET\">" >>$BBXML
100 echo " <title>Target $TARGET</title>" >>$BBXML
101 echo " <remark>NOTE: DO NOT EDIT THIS GENERATED FILE! Only edit the template file.</remark>" >>$BBXML
102 echo " <section>" >>$BBXML
103 echo " <title>Build Instructions for $TARGET</title>" >>$BBXML
104 extractcmds_for_type $targetreadme Build-command >>$BBXML
105 echo " </section>" >>$BBXML
106 echo "" >>$BBXML
107 echo " <section>" >>$BBXML
108 echo " <title>Boot Instructions for $TARGET</title>" >>$BBXML
109 extractcmds_for_type $targetreadme Boot-command >>$BBXML
110 echo " </section>" >>$BBXML
111 echo " </section>" >>$BBXML
112done
113
114echo "</chapter>" >>$BBXML
115echo "Ready created $BBXML"
diff --git a/doc/manifest_conf.mk b/doc/manifest_conf.mk
new file mode 100644
index 0000000..3bab6f4
--- /dev/null
+++ b/doc/manifest_conf.mk
@@ -0,0 +1,7 @@
1# To be included in Makefile
2# NOTE: MANIFESTHASH needs to be changed to final release tag in format refs/tags/ELnnn before a release
3# The values are shown in the release info
4# The manifest is used to fetch information into the release info from the distro files
5MANIFESTHASH ?= sumo
6MANIFESTURL := git@git.enea.com:linux/manifests/el_manifests-rt.git
7PROFILE_NAME := rt