documentation/ref-manual/features.rst

1 .. SPDX-License-Identifier: CC-BY-SA-2.0-UK
15 as ``poky.conf``, ``poky-tiny.conf``, ``poky-lsb.conf`` and so forth.
34 .. _ref-features-machine:
41 one-to-one correspondence to packages, and they can go beyond simply
45 specified within the :ref:`ref-tasks-configure` task
51 -  *acpi:* Hardware has ACPI (x86/x86_64 only)
53 -  *alsa:* Hardware has ALSA audio drivers
55 -  *apm:* Hardware uses APM (or APM emulation)
57 -  *bluetooth:* Hardware has integrated BT
59 -  *efi:* Support for booting through EFI
61 -  *ext2:* Hardware HDD or Microdrive
63 -  *keyboard:* Hardware has a keyboard
65 -  *numa:* Hardware has non-uniform memory access
67 -  *pcbios:* Support for booting through BIOS
69 -  *pci:* Hardware has a PCI bus
71 -  *pcmcia:* Hardware has PCMCIA or CompactFlash sockets
73 -  *phone:* Mobile phone (voice) support
75 -  *qvga:* Machine has a QVGA (320x240) display
77 -  *rtc:* Machine has a Real-Time Clock
79 -  *screen:* Hardware has a screen
81 -  *serial:* Hardware has serial support (usually RS232)
83 -  *touchscreen:* Hardware has a touchscreen
85 -  *usbgadget:* Hardware is USB gadget device capable
87 -  *usbhost:* Hardware is USB Host capable
89 -  *vfat:* FAT file system support
91 -  *wifi:* Hardware has integrated WiFi
93 .. _ref-features-distro:
100 your distribution. Features do not have a one-to-one correspondence to
104 script during the :ref:`ref-tasks-configure` task for
116 -  *alsa:* Include ALSA support (OSS compatibility kernel modules
119 -  *api-documentation:* Enables generation of API documentation during
121    when the ``bitbake -c populate_sdk`` command is used. See the
122    ":ref:`sdk-manual/appendix-customizing-standard:adding api documentation to the standard sdk`"
126 -  *bluetooth:* Include bluetooth support (integrated BT only).
128 -  *cramfs:* Include CramFS support.
130 -  *directfb:* Include DirectFB support.
132 -  *ext2:* Include tools for supporting for devices with internal
135 -  *ipsec:* Include IPSec support.
137 -  *ipv6:* Include IPv6 support.
139 -  *keyboard:* Include keyboard support (e.g. keymaps will be loaded
142 -  *ldconfig:* Include support for ldconfig and ``ld.so.conf`` on the
145 -  *nfs:* Include NFS client support (for mounting NFS exports on
148 -  *opengl:* Include the Open Graphics Library, which is a
149    cross-language, multi-platform application programming interface used
150    for rendering two and three-dimensional graphics.
152 -  *pci:* Include PCI bus support.
154 -  *pcmcia:* Include PCMCIA/CompactFlash support.
156 -  *ppp:* Include PPP dialup support.
158 -  *ptest:* Enables building the package tests where supported by
160    ":ref:`dev-manual/common-tasks:testing packages with ptest`" section
163 -  *smbfs:* Include SMB networks client support (for mounting
166 -  *systemd:* Include support for this ``init`` manager, which is a full
171 -  *usbgadget:* Include USB Gadget Device support (for USB
174 -  *usbhost:* Include USB Host support (allows to connect external
177 -  *usrmerge:* Merges the ``/bin``, ``/sbin``, ``/lib``, and ``/lib64``
181 -  *wayland:* Include the Wayland display server protocol and the
184 -  *wifi:* Include WiFi support (integrated only).
186 -  *x11:* Include the X server and libraries.
188 .. _ref-features-image:
203 -  *allow-empty-password:* Allows Dropbear and OpenSSH to accept root
206 -  *dbg-pkgs:* Installs debug symbol packages for all packages installed
209 -  *debug-tweaks:* Makes an image suitable for development (e.g. allows
210    root logins without passwords and enables post-installation logging).
211    See the 'allow-empty-password', 'empty-root-password', and
212    'post-install-logging' features in this list for additional
215 -  *dev-pkgs:* Installs development packages (headers and extra library
218 -  *doc-pkgs:* Installs documentation packages for all packages
221 -  *empty-root-password:* Sets the root password to an empty string,
224 -  *overlayfs-etc:* Configures the ``/etc`` directory to be in ``overlayfs``.
226    if the root filesystem is configured to be read-only.
228 -  *package-management:* Installs package management tools and preserves
231 -  *post-install-logging:* Enables logging postinstall script runs to
240 -  *ptest-pkgs:* Installs ptest packages for all ptest-enabled recipes.
242 -  *read-only-rootfs:* Creates an image whose root filesystem is
243    read-only. See the
244    ":ref:`dev-manual/common-tasks:creating a read-only root filesystem`"
248 -  *splash:* Enables showing a splash screen during boot. By default,
255 -  *staticdev-pkgs:* Installs static development packages, which are
260 :ref:`core-image <ref-classes-core-image>` class. The current list of
263 -  *hwcodecs:* Installs hardware acceleration codecs.
265 -  *nfs-server:* Installs an NFS server.
267 -  *perf:* Installs profiling tools such as ``perf``, ``systemtap``, and
268    ``LTTng``. For general information on user-space tools, see the
269    :doc:`/sdk-manual/index` manual.
271 -  *ssh-server-dropbear:* Installs the Dropbear minimal SSH server.
273 -  *ssh-server-openssh:* Installs the OpenSSH SSH server, which is more
274    full-featured than Dropbear. Note that if both the OpenSSH SSH server
279 -  *tools-debug:* Installs debugging tools such as ``strace`` and
281    ":ref:`dev-manual/common-tasks:debugging with the gnu project debugger (gdb) remotely`" section
283    tracing and profiling, see the :doc:`/profile-manual/index`.
285 -  *tools-sdk:* Installs a full SDK that runs on the device.
287 -  *tools-testapps:* Installs device testing tools (e.g. touchscreen
290 -  *x11:* Installs the X server.
292 -  *x11-base:* Installs the X server with a minimal environment.
294 -  *x11-sato:* Installs the OpenedHand Sato environment.
296 .. _ref-features-backfill:
309 Thus, the OpenEmbedded build system has a mechanism to automatically
329 -  *The "pulseaudio" distro feature option*: Previously, PulseAudio
343 -  *The "rtc" machine feature option*: Previously, real time clock (RTC)