summaryrefslogtreecommitdiff
path: root/util/me_cleaner/README.md
blob: 0ca3d32bf9f1c7c9bc6a3d5a3e4410be28d783fa (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
# ME cleaner

A cleaner for Intel ME/TXE images.

This tools removes any unnecessary partition from an Intel ME/TXE firmware, reducing
its size and its ability to interact with the system.
It should work both with coreboot and with the factory firmware.

Currently this tool:
 * Scans the FPT (partition table) and checks that everything is correct
 * Removes any partition entry (except for FTPR) from FPT
 * Removes any partition except for the fundamental one (FTPR)
 * Removes the EFFS presence flag
 * Corrects the FPT checksum
 * Removes any non-essential LZMA or Huffman compressed module from the FTPR partition (pre-Skylake only)
 * Relocates the remaining parts of the FTPR partition to the top of the ME region (pre-Skylake only)
 * Checks the validity of the RSA signature of the FTPR partition

Don't forget to power cycle your PC after flashing the modified ME/TXE image
(power off and power on, not just reboot).

See the [current status](https://github.com/corna/me_cleaner/wiki/me_cleaner-status)
or [a more detailed description](https://github.com/corna/me_cleaner/wiki/How-does-it-work%3F)
of me_cleaner.

Special thanks to Federico Amedeo Izzo for his help during the study of Intel ME.