3. Output Files:\r
An extended INF file with possible auto-generated EntryPoint.c, CommonHeader.h/CommonHeader.txt, depending on options and module contents.\r
4. Prerequisite:\r
- a. The workspace directory must be specified either by environment variable or \96w option. \r
+ a. The workspace directory must be specified either by environment variable or -w option. \r
b. The Framework Database file must exist to specify the available packages in current workspace. \r
Two possible locations are: (The first location overrides the second)\r
$(WORKSPACE)\Tools\Conf\FrameworkDatabase.db\r
5. Example:\r
WORKSAPCE has already been set: $(WORKSPACE) = c:\work\EdkII. \r
\r
- a. msa2inf \96f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa \96o c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.inf\r
- b. msa2inf \96f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa \96a\r
+ a. msa2inf -f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa -o c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.inf\r
+ b. msa2inf -f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa -a\r
Example a & b are equivalent to migrate WinNtThunk driver from EDKII to EDKII' code base.\r
\r
- c. msa2inf \96f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa \96a -c\r
- The extra "-c" option performs several hardcode mapping due to the naming change in EDKII\92: \r
+ c. msa2inf -f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa -a -c\r
+ The extra "-c" option performs several hardcode mapping due to the naming change in EDKII': \r
OldMdePkg Guid -> MdePkgGuid, \r
EdkModulePkg Guid -> MdeModulePkgGuid, \r
EdkGraphicsLib -> GraphicsLib\r
HiiLib -> HiiLibFramework\r
...\r
\r
- d. msa2inf \96f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa \96m\r
+ d. msa2inf -f c:\work\EdkII\Nt32Pkg\WinNtThunkDxe\WinNtThunk.msa -m\r
The extra "-m" option suppresses the generation of "CommonHeader.h" and leave all C files intact. \r
Instead, it generates "CommonHeader.txt". Developers can manually copy its content to a local common header file in a module. \r
\r
6. Known Limitations:\r
- a. Tool does not Exit Boot Services Callback & Virtual Address Changed Event. Developers need to handle it manually.\r
+ a. Tool does not handle Exit Boot Services Callback & Virtual Address Changed Event. Developers need to handle it manually.\r
b. The #include <Library/AbcLib.h> is based on library class naming convention: The header filename for "AbcLib" class are "AbcLib.h" by convention.\r
c. The #include <Guid/Xyz.h>, <Protocol/Xyz.h> and <Ppi/Xyz.h> are added based on gGuidCName listed in MSA. \r
If a GuidCName cannot map to a package Guid/Protocol/Ppi header file, a warning message is raised.\r