<!DOCTYPE appendix PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">

<appendix id='ref-features'>
    <title>Reference: Features</title>

    <para>'Features' provide a mechanism for working out which packages
        should be included in the generated images. Distributions can
        select which features they want to support through the
        <glossterm linkend='var-DISTRO_FEATURES'><link
        linkend='var-DISTRO_FEATURES'>DISTRO_FEATURES</link></glossterm>
        variable which is set in the distribution configuration file
        (poky.conf for Poky).  Machine features are set in the
        <glossterm linkend='var-MACHINE_FEATURES'><link
        linkend='var-MACHINE_FEATURES'>MACHINE_FEATURES</link></glossterm>
        variable which is set in the machine configuration file and
        specifies which hardware features a given machine has.
    </para>

    <para>These two variables are combined to work out which kernel modules,
        utilities and other packages to include. A given distribution can 
        support a selected subset of features so some machine features might not
        be included if the distribution itself doesn't support them.
    </para>

    <section id='ref-features-distro'>
        <title>Distro</title>

        <para>The items below are valid options for <glossterm linkend='var-DISTRO_FEATURES'><link
        linkend='var-DISTRO_FEATURES'>DISTRO_FEATURES</link></glossterm>.
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    alsa - ALSA support will be included (OSS compatibility
                    kernel modules will be installed if available)
                </para>
            </listitem>
            <listitem>
                <para>
                    bluetooth - Include bluetooth support (integrated BT only)
                </para>
            </listitem>
            <listitem>
                <para>
                    ext2 - Include tools for supporting for devices with internal
                    HDD/Microdrive for storing files (instead of Flash only devices)
                </para>
            </listitem>
            <listitem>
                <para>
                    irda - Include Irda support
                </para>
            </listitem>
            <listitem>
                <para>
                    keyboard - Include keyboard support (e.g. keymaps will be 
                    loaded during boot).
                </para>
            </listitem>
            <listitem>
                <para>
                    pci - Include PCI bus support
                </para>
            </listitem>
            <listitem>
                <para>
                    pcmcia - Include PCMCIA/CompactFlash support
                </para>
            </listitem>
            <listitem>
                <para>
                    usbgadget - USB Gadget Device support (for USB
                    networking/serial/storage)
                </para>
            </listitem>
            <listitem>
                <para>
                    usbhost - USB Host support (allows to connect external
                    keyboard, mouse, storage, network etc)
                </para>
            </listitem>
            <listitem>
                <para>
                    wifi - WiFi support (integrated only)
                </para>
            </listitem>
            <listitem>
                <para>
                    cramfs - CramFS support
                </para>
            </listitem>
            <listitem>
                <para>
                    ipsec - IPSec support
                </para>
            </listitem>
            <listitem>
                <para>
                    ipv6 - IPv6 support
                </para>
            </listitem>
            <listitem>
                <para>
                    nfs - NFS client support (for mounting NFS exports on
                    device)
                </para>
            </listitem>
            <listitem>
                <para>
                    ppp - PPP dialup support
                </para>
            </listitem>
            <listitem>
                <para>
                    smbfs - SMB networks client support (for mounting
                    Samba/Microsoft Windows shares on device)
                </para>
            </listitem>
        </itemizedlist>
    </section>

    <section id='ref-features-machine'>
        <title>Machine</title>

        <para>The items below are valid options for <glossterm linkend='var-MACHINE_FEATURES'><link
        linkend='var-MACHINE_FEATURES'>MACHINE_FEATURES</link></glossterm>.
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    acpi - Hardware has ACPI (x86/x86_64 only)
                </para>
            </listitem>
            <listitem>
                <para>
                    alsa - Hardware has ALSA audio drivers
                </para>
            </listitem>
            <listitem>
                <para>
                    apm - Hardware uses APM (or APM emulation)
                </para>
            </listitem>
            <listitem>
                <para>
                    bluetooth - Hardware has integrated BT
                </para>
            </listitem>
            <listitem>
                <para>
                    ext2 - Hardware HDD or Microdrive
                </para>
            </listitem>
            <listitem>
                <para>
                    irda - Hardware has Irda support
                </para>
            </listitem>
            <listitem>
                <para>
                    keyboard - Hardware has a keyboard
                </para>
            </listitem>
            <listitem>
                <para>
                    pci - Hardware has a PCI bus
                </para>
            </listitem>
            <listitem>
                <para>
                    pcmcia - Hardware has PCMCIA or CompactFlash sockets
                </para>
            </listitem>
            <listitem>
                <para>
                    screen - Hardware has a screen
                </para>
            </listitem>
            <listitem>
                <para>
                    serial - Hardware has serial support (usually RS232)
                </para>
            </listitem>
            <listitem>
                <para>
                    touchscreen - Hardware has a touchscreen
                </para>
            </listitem>
            <listitem>
                <para>
                    usbgadget - Hardware is USB gadget device capable
                </para>
            </listitem>
            <listitem>
                <para>
                    usbhost - Hardware is USB Host capable
                </para>
            </listitem>
            <listitem>
                <para>
                    wifi - Hardware has integrated WiFi
                </para>
            </listitem>
        </itemizedlist>
    </section>

    <section id='ref-features-image'>
        <title>Reference: Images</title>

        <para>
            The contents of images generated by Poky can be controlled by the <glossterm
        linkend='var-IMAGE_FEATURES'><link
        linkend='var-IMAGE_FEATURES'>IMAGE_FEATURES</link></glossterm>
        variable in local.conf. Through this you can add several different
        predefined packages such as development utilities or packages with debug
        information needed to investigate application problems or profile applications.
        </para>

        <para>
            Current list of <glossterm
        linkend='var-IMAGE_FEATURES'><link
        linkend='var-IMAGE_FEATURES'>IMAGE_FEATURES</link></glossterm> contains:
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    apps-console-core - Core console applications such as ssh daemon, 
                    avahi daemon, portmap (for mounting NFS shares)
                </para>
            </listitem>
            <listitem>
                <para>
                    x11-base - X11 server + minimal desktop
                </para>
            </listitem>
            <listitem>
                <para>
                    x11-sato - OpenedHand Sato environment
                </para>
            </listitem>
            <listitem>
                <para>
                    apps-x11-core - Core X11 applications such as an X Terminal, file manager, file editor
                </para>
            </listitem>
            <listitem>
                <para>
                    apps-x11-games - A set of X11 games
                </para>
            </listitem>
            <listitem>
                <para>
                    apps-x11-pimlico - OpenedHand Pimlico application suite
                </para>
            </listitem>
            <listitem>
                <para>
                    tools-sdk - A full SDK which runs on device
                </para>
            </listitem>
            <listitem>
                <para>
                    tools-debug - Debugging tools such as strace and gdb
                </para>
            </listitem>
            <listitem>
                <para>
                    tools-profile - Profiling tools such as oprofile, exmap and LTTng
                </para>
            </listitem>
            <listitem>
                <para>
                    tools-testapps - Device testing tools (e.g. touchscreen debugging)
                </para>
            </listitem>
            <listitem>
                <para>
                    nfs-server - NFS server (exports / over NFS to everybody)
                </para>
            </listitem>
            <listitem>
                <para>
                    dev-pkgs - Development packages (headers and extra library links) for all packages
                    installed in a given image
                </para>
            </listitem>
            <listitem>
                <para>
                    dbg-pkgs - Debug packages for all packages installed in a given image
                </para>
            </listitem>
        </itemizedlist>
    </section>
</appendix>

<!-- 
vim: expandtab tw=80 ts=4 spell spelllang=en_gb
-->
