audk/BaseTools/UserManuals/EfiRom_Utility_Man_Page.rtf

78 lines
7.1 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{\rtf1\ansi\ansicpg1252\deff0\deflang1033\deflangfe2052\deftab360{\fonttbl{\f0\fswiss\fprq2\fcharset0 Verdana;}{\f1\froman\fprq2\fcharset0 Times New Roman;}}
{\colortbl ;\red8\green96\blue168;\red0\green0\blue0;}
{\stylesheet{ Normal;}{\s1 heading 1;}{\s2 heading 2;}}
{\*\generator Msftedit 5.41.15.1515;}\viewkind4\uc1\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\f0\fs28 Name\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 EfiRom.exe - build an Option ROM image\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\fs28 Synopsis\par
\pard\nowidctlpar\sb200\cf2\fs18 EfiRom.exe [options] Filename [Filename]\'85\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\cf1\fs28 Description\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 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:\par
\pard\nowidctlpar\li360\sb200 Verification that the DOS stub magic value is 0x5A4D\par
Verification that the PE signature is \ldblquote PE\\0\\0\rdblquote\par
\pard\nowidctlpar\sb200 If either of these checks fails then the utility will abort without creating the output ROM image file.\par
This utility performs some rudimentary checking of the input binary files to verify they are indeed valid option ROM images. These checks include:\par
\pard\nowidctlpar\li360\sb200 Verification that the signature of the option ROM header is 0xAA55\par
Verification that the offset to the PCI data structure is within the range of the file size.\par
Verification that the signature of the PCI data structure is \ldblquote PCIR\rdblquote .\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\cf1\b\fs28 Options\par
\pard\nowidctlpar\sb200\cf2\fs18 Filename1 [FilenameN]\par
\pard\nowidctlpar\li360\sb200\b0 Input PE/PE32+/COFF or legacy option ROM image file(s).\par
\pard\nowidctlpar\sb200\b -o, --output RomFilename\par
\pard\nowidctlpar\li360\sb200\b0 The ROM filename being created. If not specified, use the first input filename as name and *.rom as the output filename extension.\par
\pard\nowidctlpar\sb200\b -e, --efi\par
\pard\nowidctlpar\li360\sb200\b0 Input PE/PE32+/COFF file(s)\par
\pard\nowidctlpar\sb200\b -b, --binary\par
\pard\nowidctlpar\li360\sb200\b0 Input legacy option ROM image files.\par
\pard\nowidctlpar\sb200\b -ec, --compress\par
\pard\nowidctlpar\li360\sb200\b0 Compress input PE/PE32+/COFF file.\par
\pard\nowidctlpar\sb200\b -n, --no-last-bit\par
\pard\nowidctlpar\li360\sb200\b0 Do not set the LAST bit on the last file.\par
\pard\nowidctlpar\sb200\lang1036\b -l ClassCode, --class-code=ClassCode\par
\pard\nowidctlpar\li360\sb200\lang1033\b0 Use ClassCode in the PCI data structure header in the input file.\par
\pard\nowidctlpar\sb200\b -r Rev, --Revision=Rev\par
\pard\nowidctlpar\li360\sb200\b0 Use Rev in the PCI data structure header in the input file.\par
\pard\nowidctlpar\sb200\b -p, --pci23\par
\pard\nowidctlpar\li360\sb200\b0 Default layout meets PCI 3.0 specifications, specifying this flag will for a PCI 2.3 layout.\par
\pard\nowidctlpar\sb200\b -d, --dump\par
\pard\nowidctlpar\li360\sb200\b0 Dump the header of input option ROM image\par
\pard\nowidctlpar\sb200\b -i, --device-id\par
\pard\nowidctlpar\li360\sb200\b0 Device ID \par
\pard\nowidctlpar\sb200\b -f, --vendor-id\par
\pard\nowidctlpar\li360\sb200\b0 Vendor ID\par
\pard\nowidctlpar\sb200\b --version\par
\pard\nowidctlpar\li360\sb200\b0 Print version and copyright of this program then exit.\par
\pard\nowidctlpar\sb200\b -v, --verbose\par
\pard\nowidctlpar\li360\sb200\b0 Turn on verbose output with informational messages printed. This is a count value, so specifying \endash vv can be used to increase the verbosity level.\par
\pard\nowidctlpar\sb200\b -q, --quiet\par
\pard\nowidctlpar\li360\sb200\b0 Disable all messages except FATAL ERRORS.\par
\pard\nowidctlpar\sb200\b -d, --debug [#]\par
\pard\nowidctlpar\li360\sb200\b0 Enable debug messages, at level #.\par
\pard\nowidctlpar\sb200\b -h, --help\par
\pard\nowidctlpar\li360\sb200\b0 Print the copyright, version and usage of this program then exit.\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\cf1\b\fs28 Examples\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 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 \ldblquote File1.rom\rdblquote . The output filename is the same as the first input filename with the extension \ldblquote .rom\rdblquote\par
\b EfiRom \endash e File1.efi File2.efi \endash b Legacy.bin\par
\b0 Generate the Option ROM with two efi binary files and one legacy binary file with the output filename specified on the command line.\par
\b EfiRom \endash o file.rom \endash e File1.efi File2.efi \endash b Legacy.bin\par
\b0 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 \ldblquote File1.rom\rdblquote . The output filename is the same as the first input filename with the extension \ldblquote .rom\rdblquote . Vendor ID and Device ID are both specified in command line and the efi binary files will be compressed using the Tiano Compression algorithm.\par
\b EfiRom \endash i 0xABCD \endash f 0x1234 \endash ec File1.efi File2.efi \endash b Legacy.bin\par
\b0 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.\par
\b EfiRom \endash o file.rom \endash i 0xABCD \endash f 0x1234 \endash ec File1.efi File2.efi \endash b Legacy.bin\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\cf1\fs28 Bugs\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 No known bugs.\par
Report bugs to edk2-buildtools-devel@lists.sourceforge.net\f1\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\cf1\b\f0\fs28 Files\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 None\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\cf1\b\fs28 See also\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 None\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\cf1\b\fs28 License\par
\pard\nowidctlpar\cf2\b0\fs18 Copyright (c) 1999 - 2009, Intel Corporation. All rights reserved.\par
This program and the accompanying materials are licensed and made available \par
under the terms and conditions of the BSD License which accompanies this \par
distribution. The full text of the license may be found at\par
http://opensource.org/licenses/bsd-license.php\par
\par
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\par
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\par
}