summaryrefslogtreecommitdiff
path: root/docs/usermanual/chapters/features.xml
blob: 8eecaa9ed4bf9e60206f2032d70d86b29c9dc7fe (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
<?xml version="1.0" encoding="UTF-8"?>
<chapter id="chapter_special_features">
  <title>Special features</title>

  <section id="special_debian_naming">
    <title>Debian package naming <anchor id="debian" /></title>

    <screen>INHERIT += "debian"</screen>

    <para>Placing the above line into your <emphasis>${DISTRO}.conf</emphasis>
    or <emphasis>local.conf</emphasis> will trigger renaming of packages if
    they only ship one library. Imagine a package where the package name
    (<command>PN</command>) is foo and this packages ships a file named
    <command>libfoo.so.1.2.3</command>. Now this package will be renamed to
    <command>libfoo1</command> to follow the Debian package naming
    policy.</para>
  </section>

  <section id="special_shlibs">
    <title>Shared Library handling (shlibs) <anchor id="shlibs" /></title>

    <para>Run-time Dependencies (<command>RDEPENDS</command>) will be added
    when packaging the software. They should only contain the minimal
    dependencies to run the program. OpenEmbedded will analyze each packaged
    binary and search for <command>SO_NEEDED</command> libraries. The
    libraries are absolutely required by the program then OpenEmbedded is
    searching for packages that installs these libraries. these packages are
    automatically added to the <command>RDEPENDS</command>. As a packager you
    don't need to worry about shared libraries anymore they will be added
    automatically.</para>

    <remark>NOTE: This does not apply to plug-ins used by the
    program.</remark>
  </section>

  <section id="special_bitbake_collections">
    <title>BitBake Collections <anchor id="collections" /></title>

    <para>This section is a stub, help us by expanding it</para>

    <para><screen>
BBFILES := "${OEDIR}/openembedded/packages/*/*.bb ${LOCALDIR}/packages/*/*.bb"
BBFILE_COLLECTIONS = "upstream local"
BBFILE_PATTERN_upstream = "^${OEDIR}/openembedded/packages/"
BBFILE_PATTERN_local = "^${LOCALDIR}/packages/"
BBFILE_PRIORITY_upstream = "5"
BBFILE_PRIORITY_local = "10"
</screen></para>
  </section>

  <section id="special_task_base">
    <title>Task-base <anchor id="task-base" /></title>

    <para>Task-base is new way of creating basic root filesystems. Instead of
    having each machine setting a ton of duplicate variables, this allow a
    machine to specify its features and <command>task-base</command> builds it
    a customised package based on what the machine needs along with what the
    distro supports.</para>

    <para>To illustrate, the distro config file can say: <screen>
DISTRO_FEATURES = "nfs smbfs ipsec wifi ppp alsa bluetooth ext2 irda pcmcia usbgadget usbhost"
</screen> and the machine config: <screen>
MACHINE_FEATURES = "kernel26 apm alsa pcmcia bluetooth irda usbgadget"
</screen> and the resulting <command>task-base</command> would support pcmcia
    but not usbhost.</para>

    <para>Task-base details exactly which options are either machine or distro
    settings (or need to be in both). Machine options are meant to reflect
    capabilities of the machine, distro options list things distribution
    maintainers might want to add or remove from their distros images.</para>
  </section>

  <section id="special_overrides">
    <title>Overrides <anchor id="overrides" /></title>

    <para>This section is a stub, help us by expanding it</para>
  </section>
</chapter>