fwupd/plugins/uefi/README.md
Richard Hughes cff38bcb3a Convert the providers to plugins to simplify code and for future features
This is a large commit that removes all the providers and turns them into
plugins. I think having both providers _and_ plugins was super confusing.

Plugins are loaded at runtime so you could in theory develop a new plugin
without putting it in the fwupd source tree, although there are no installed
headers or PC files as I'm not sure it's a good idea at this stage.

This commit moves all the per-provider docs, tests, notes, debug dumps and test
data to plugin-specific directories -- these also allows the plugin author to
"own" more of the source tree so we don't enforce fu- prefixes and the style
guide everywhere.

This allows us to run the same action on all the plugins in the future, so we
could have a prepare(FuPlugin, FuDevice) and cleanup(FuPlugin, FuDevice) run
on *all* plugins, so doing an update using one plugin would allow us to work
around hardware quirks in other plugins.

If I've broken your out-of-tree provider it's trivial to port to the new API
with sed and a fixed up build file. If you need help please let me know.
2016-12-12 12:31:23 +00:00

33 lines
1.1 KiB
Markdown

UEFI Support
============
Introduction
------------
The Unified Extensible Firmware Interface (UEFI) is a specification that
defines the software interface between an OS and platform firmware.
With the UpdateCapsule boot service it can be used to update system firmware.
Build Requirements
------------------
For UEFI capsule support, you need to install fwupdate 0.5 or later.
* source: https://github.com/rhinstaller/fwupdate
* rpms: https://pjones.fedorapeople.org/fwupdate/
* debs (Debian): https://tracker.debian.org/pkg/fwupdate
* debs (Ubuntu): https://launchpad.net/ubuntu/+source/fwupdate
If you don't want or need this functionality you can use the
`--disable-uefi` option.
UEFI Unlock Support
-------------------
On some Dell systems it is possible to turn on and off UEFI capsule
support from within the BIOS. This functionality can also be adjusted
from within the OS by fwupd. This requires using fwupdate 5 or later
and compiling it with libsmbios support.
When fwupd and fwupdate have been compiled with this support you will
be able to enable UEFI support on the device by using the `unlock` command.