Name
GenVtf.exe - generate the Boot Strap File (AKA Volume Top File, or VTF) for IPF images
Synopsis
GenVtf.exe [-v | -q | -d] [-o <OutputFile>] –f <FileName> -r <BaseAddr> -s <Size>
GenVtf.exe –h
GenVtf.exe --version
Description
GenVtf generates the Boot Strap File (AKA Volume Top File, or VTF) for IPF images. This utility parses the input BSF inf file and gets the component information. If all the required components are in a single VTF file, then only one VTF Base Address and Size is needed and only one raw data output file and one symbol output file (which is the symbol of raw data) is needed. If there is a component required for the the second VTF file but there is no second VTF Base Address and Size specified in the command line interface, then this utility will exit with a related error message; if there is a second VTF Base Address and Size specified, then two raw data output files and one symbol output file will be created.
Options
If no options are specified, tool prints usage.
-f, --filename BS_INFFile
      Name of the BS Image INF file to use
-r, --baseaddr hexaddress
      The Base Address is the starting address of the Firmware Volume where the Boot Strapped Image will reside
-s, --size Size
      The size of the Firmware Volume
 -o, --output Filename
      VTF Filename that will be created
--version
	Print version and copyright of this program and exit
-v, --verbose
Turn on verbose output with informational messages printed. This is a count value, so specifying –vv can be used to increase the verbosity level.
-q, --quiet
	Disable all messages except FATAL ERRORS
-d, --debug [#]
	Enable debug messages, at level #
-h, --help
	Print copyright, version and usage of this program and exit
Status codes returned
STATUS_SUCCESS 	0	The action was completed as requested.	
STATUS_ERROR 		2	The action failed.	
Example
Generate one VTF file with inf file name, base address and size specified in command line and without output filename specified. Default filename “VTF1.RAW” will be used.
GenVtf –f bsf.inf –r 0xFFE00000 –s 0x200000
Generate two VTF files with inf file name, base address and size specified in command line and without output filename specified. Default filename “VTF1.RAW” and “VTF2.RAW”will be used.
GenVtf –f bsf.inf –r 0xFFE00000 –s 0x200000 –r 0xFFD00000 –s 0x100000
Generate one VTF file with inf file name, base address and size specified in command line and output filename specified.
GenVtf –o file.tmp –f bsf.inf –r 0xFFE00000 –s 0x200000
Generate two VTF files with inf file name, base address and size specified in command line and output filename specified.
GenVtf –o file1.tmp –o file2.tmp –f bsf.inf –r 0xFFE00000 –s 0x200000 –r 0xFFD00000 –s 0x100000
Bugs
No known bugs.
Report bugs to edk2-devel@lists.01.org
Files
None
See also
None
License
Copyright (c) 1999 - 2011, 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.