audk/BaseTools/UserManuals/MkPkg_Utility_Man_Page.rtf

{\rtf1\ansi\ansicpg936\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 MkPkg.exe\f1\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\f0\fs28 Synopsis\par
\pard\nowidctlpar\sb200\cf2\fs18 MkPkg.exe -m <module_file> -p <package_file> [-o distribution_file]\f1\par
\pard\nowidctlpar\fi360\li720\sb200\f0 [-x xml-file-header] [-t tools-directory] [-f misc-files] \f1\par
\f0 [-q | -v] [-h]\f1\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\f0\fs28 Description\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 MkPkg creates a distribution package file. It packages the specified native packages and native modules, generates an XML formatted description file for these packages and modules and zips them together to a compressed file.\f1\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\f0\fs28 Options\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 [-o --output-file]\par
\pard\nowidctlpar\fi-540\li540\sb200       Specify the distribution file to be created. The default file name is \ldblquote DistributionPackage.zip\rdblquote  \f1\par
\pard\nowidctlpar\sb200\f0 [-m, --module]\par
      The inf file of module to be distributed standalone.\f1\par
\f0 [-p, --package]\par
      The dec file of package to be distributed.\par
[-f --misc-files]\par
      Specify any misc files.\par
[-x --xml-file-header]\par
      Specify the xml file which includes header information for creating the distribution file.\f1\par
\f0 [-t --tools-directory]\par
      Specify the directory name of tools.\par
[-v, --verbose]\par
\pard\nowidctlpar\li360\sb200 Turn on verbose output with informational messages printed. \par
\pard\nowidctlpar\sb200 [-q, --quiet]\par
\tab Disable all messages except FATAL ERRORS.\par
[-h, --help]\par
\tab Print copyright, version and usage of this program and exit.\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\fs28 Example\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 1. Before execute the program, please enter the workspace directory and execute \ldblquote edksetup\rdblquote  to initialize the workspace, in next examples, the workspace is C:\\MyWork\par
2. C:\\MyWork\\MkPkg -p MdeModulePkg\\MdeModulePkg.dec\f1\par
\tab\f0 Generate a \ldblquote DistributionPackage.zip\rdblquote  file to zip all contents of [MdeModulePkg] package \par
3. C:\\MyWork\\MkPkg -p MdePkg\f1\\\f0 MdePkg.dec -m MdeModulePkg\\Application\\HelloWorld\\HelloWorld.inf\f1\par
\tab\f0 Generate a \ldblquote DistributionPackage.zip\rdblquote  file to zip all contents of [MdePkg] package and a standalone module [HelloWorld]\par
4. C:\\MyWork\\MkPkg -m MdeModulePkg\\Application\\HelloWorld\\HelloWorld.inf -o Hello.far\par
\tab Generate a \ldblquote Hello.far\rdblquote  file to zip all contents of a standalone module [HelloWorld]\par
5. C:\\MyWork\\MkPkg -m MdeModulePkg\\Application\\HelloWorld\\HelloWorld.inf -t BaseTools\par
\tab Generate a \ldblquote DistributionPackage.zip\rdblquote  file to zip all contents of a standalone module [HelloWorld] with all files under directory [BaseTools]\par
6. C:\\MyWork\\MkPkg -m MdeModulePkg\\Application\\HelloWorld\\HelloWorld.inf -f Conf\\build_rule.txt\par
\f1\tab\f0 Generate a \ldblquote DistributionPackage.zip\rdblquote  file to zip all contents of a standalone module [HelloWorld] with a misc file [Conf\\build_rule.txt]\par
7. C:\\MyWork\\MkPkg -p MdeModulePkg\\MdeModulePkg.dec -p MdePkg\\MdePkg.dec -x A.xml\f1\par
\tab\f0 Generate a \ldblquote DistributionPackage.zip\rdblquote  file to zip all contents of [MdeModulePkg] package and [MdePkg] package, the header information of this distribution package is read from [A.xml] (Refer to section [Sample of XML header file] for more information of the XML file header)\f1\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\f0\fs28 Bugs\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 Not found yet.\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\fs28 Files \par
\pard\nowidctlpar\sb200\cf2\b0\fs18 None.\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\fs28 See also\par
\pard\nowidctlpar\sb200\cf2\b0\fs18  InstallPkg.exe, RmPkg.exe\par
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\fs28 License\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 Copyright (c) 2008 - 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
\pard\keep\keepn\nowidctlpar\s2\li-1440\sb400\sa60\sl-340\slmult0\tx1440\cf1\b\fs28 Sample of XML header file\par
\pard\nowidctlpar\sb200\cf2\b0\fs18 <DistributionPackage xmlns="http://www.uefi.org/2008/2.1" xmlns:xsi="http:/www.w3.org/2001/XMLSchema-instance">\par
  <DistributionHeader  ReadOnly="true" RePackage="false">\par
\tab   <Name BaseName="Template">DistributionPackageTest</Name>\par
\tab   <GUID Version="1.6"> DF0DDA2E-EA83-480b-B2CE-FC0BB2F894C2 </GUID> \par
\tab   <Vendor> Nosuch Corporation </Vendor>\par
\tab   <Date>2008-03-24T09:30:00</Date> \par
\tab   <Copyright>Copyright (c)  2008, Nosuch Corporation. All rights reserved.</Copyright> \par
\tab   <License>\par
\tab     This program and the accompanying materials are licensed and made available under     \par
\tab     the terms and conditions of the BSD License which accompanies this distribution.  \par
\tab     The full text of the license may be found at: \par
\tab     http://opensource.org/licenses/bsd-license.php\par
\tab     THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, WITHOUT \par
\tab     WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\par
\tab   </License>\par
\tab   <Abstract> Version 1.2 of the NoSuchChipset Distribution Package. </Abstract>\par
\tab   <Description> \par
\tab     Initial release of the NoSuchChipset, Version 1.0 providing the base data types \par
\tab     and libraries for NoSuch UEFI Driver. This includes special libraries for \par
\tab     reporting status codes of the driver. \par
\tab   </Description> \par
\tab   <XmlSpecification> 1.0 </XmlSpecification>\par
\tab </DistributionHeader>\par
</DistributionPackage>\f1\par
}