EfiRom.exe

Name

EfiRom.exe - build an Option ROM image

Synopsis

EfiRom.exe** -f VendorId -i DeviceId **[options] Filename [Filename]...

Description

EfiRom is used to build an Option ROM image from UEFI PE32 file(s) and/or legacy option ROM images that conform to PCI 2.3 or PCI 3.0 specifications for Option ROM layout. The EfiRom utility performs some rudimentary checking on the input Portable Executable (PE) PE32 files to verify they are indeed PE32 images. These checks include:

Verification that the DOS stub magic value is 0x5A4D

Verification that the PE signature is "PE/0/0"

If either of these checks fails then the utility will abort without creating the output ROM image file.

This utility performs some rudimentary checking of the input binary files to verify they are indeed valid option ROM images. These checks include:

Verification that the signature of the option ROM header is 0xAA55

Verification that the offset to the PCI data structure is within the range of the file size.

Verification that the signature of the PCI data structure is "PCIR".

Options

-o FileName, --output FileName
File will be created to store the output content.
-e EfiFileName
EFI PE32 image files.
-ec EfiFileName
EFI PE32 image files and will be compressed.
-b BinFileName
Legacy binary files.
-l ClassCode
Hex ClassCode in the PCI data structure header.
-r Rev Hex Revision in the PCI data structure header.
-n Not to automatically set the LAST bit in the last file.
-f VendorId
Hex PCI Vendor ID for the device OpROM, must be specified
-i DeviceId
Hex PCI Device ID for the device OpROM, must be specified
-p, --pci23
Default layout meets PCI 3.0 specifications
specifying this flag will for a PCI 2.3 layout.
-d, --dump
Dump the headers of an existing option ROM image.
-v, --verbose
Turn on verbose output with informational messages.
--version Show program's version number and exit.
-h, --help
Show this help message and exit.
-q, --quiet
Disable all messages except FATAL ERRORS.
--debug [#,0-9]
Enable debug messages at level #.

Examples

Generate the Option ROM with two efi binary files and one legacy binary file. Vendor ID and Device ID are both specified in command line. The output filename is not specified in command line, so the output filename will be File1.rom. The output filename is the same as the first input filename with the extension ".rom"

EfiRom -i 0xABCD -f 0x1234 -e File1.efi File2.efi -b Legacy.bin

Generate the Option ROM with two efi binary files and one legacy binary file with the output filename specified on the command line. Vendor ID and Device ID are both specified in command line.

EfiRom -i 0xABCD -f 0x1234 -o file.rom -e File1.efi File2.efi -b Legacy.bin

Generate the Option ROM with two efi binary files and one legacy binary file. The output filename is not specified in command line, so the output filename will be File1.rom. The output filename is the same as the first input filename with the extension ".rom". Vendor ID and Device ID are both specified in command line and the efi binary files will be compressed using the Tiano Compression algorithm.

EfiRom -i 0xABCD -f 0x1234 -ec File1.efi File2.efi -b Legacy.bin

Generate the Option ROM with two efi binary files and one legacy binary file with the output filename is specified in command line. Vendor ID and Device ID are both specified in command line and the efi binary files will be compressed using the Tiano Compression algorithm.

EfiRom -o file.rom -i 0xABCD -f 0x1234 -ec File1.efi File2.efi -b Legacy.bin

Bugs

No known bugs.

Report bugs to [email protected]

Files

None

See also

None

License

Copyright (c) 1999 - 2016, Intel Corporation. All rights reserved.

This program and the accompanying materials are licensed and made available under the terms and conditions of the BSD License which accompanies this distribution. The full text of the license may be found at:

http://opensource.org/licenses/bsd-license.php

THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.