2008-02-26 11:31:34 +00:00
|
|
|
<!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>
|
2011-06-16 17:29:40 +00:00
|
|
|
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 and the in local.conf and the
|
|
|
|
<glossterm linkend='var-EXTRA_IMAGE_FEATURES'><link linkend='var-EXTRA_IMAGE_FEATURES'>
|
|
|
|
EXTRA_IMAGE_FEATURES</link></glossterm> that you typically configure in your image recipes.
|
|
|
|
Through these varibales you can add several different
|
|
|
|
predefined packages such as development utilities or packages with debug
|
|
|
|
information needed to investigate application problems or profile applications.
|
2008-02-26 11:31:34 +00:00
|
|
|
</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
|
|
|
|
-->
|