mirror_edk2/BaseTools/Source/Python
Kinney, Michael D 8b63877aca BaseTools/Capsule: Add Capsule Generation Tools
https://bugzilla.tianocore.org/show_bug.cgi?id=945

Based on content from the following branch

https://github.com/Microsoft/MS_UEFI/tree/share/beta/CapsuleTools

* Convert C tools to Python
* Add common python modules to:
    BaseTools/Source/Python/Common/Uefi/Capsule
    BaseTools/Source/Python/Common/Edk2/Capsule
* Add GenerateCapsule.py to BaseTools/Source/Python/Capsule
* Add Windows and Posix wrappers for GenerateCapsule.py

usage: GenerateCapsule [-h] [-o OUTPUTFILE] (-e | -d | --dump-info)
                       [--capflag {PersistAcrossReset,PopulateSystemTable,InitiateReset}]
                       [--capoemflag CAPSULEOEMFLAG] [--guid GUID]
                       [--hardware-instance HARDWAREINSTANCE]
                       [--monotonic-count MONOTONICCOUNT]
                       [--fw-version FWVERSION] [--lsv LOWESTSUPPORTEDVERSION]
                       [--pfx-file SIGNTOOLPFXFILE]
                       [--signer-private-cert OPENSSLSIGNERPRIVATECERTFILE]
                       [--other-public-cert OPENSSLOTHERPUBLICCERTFILE]
                       [--trusted-public-cert OPENSSLTRUSTEDPUBLICCERTFILE]
                       [--signing-tool-path SIGNINGTOOLPATH] [--version] [-v]
                       [-q] [--debug [0-9]]
                       InputFile

Generate a capsule. Copyright (c) 2018, Intel Corporation. All rights
reserved.

positional arguments:
  InputFile             Input binary payload filename.

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUTFILE, --output OUTPUTFILE
                        Output filename.
  -e, --encode          Encode file
  -d, --decode          Decode file
  --dump-info           Display FMP Payload Header information
  --capflag {PersistAcrossReset,PopulateSystemTable,InitiateReset}
                        Capsule flag can be PersistAcrossReset, or
                        PopulateSystemTable or InitiateReset or not set
  --capoemflag CAPSULEOEMFLAG
                        Capsule OEM Flag is an integer between 0x0000 and
                        0xffff.
  --guid GUID           The FMP/ESRT GUID in registry format. Required for
                        encode operations.
  --hardware-instance HARDWAREINSTANCE
                        The 64-bit hardware instance. The default is
                        0x0000000000000000
  --monotonic-count MONOTONICCOUNT
                        64-bit monotonic count value in header. Default is
                        0x0000000000000000.
  --fw-version FWVERSION
                        The 32-bit version of the binary payload (e.g.
                        0x11223344 or 5678).
  --lsv LOWESTSUPPORTEDVERSION
                        The 32-bit lowest supported version of the binary
                        payload (e.g. 0x11223344 or 5678).
  --pfx-file SIGNTOOLPFXFILE
                        signtool PFX certificate filename.
  --signer-private-cert OPENSSLSIGNERPRIVATECERTFILE
                        OpenSSL signer private certificate filename.
  --other-public-cert OPENSSLOTHERPUBLICCERTFILE
                        OpenSSL other public certificate filename.
  --trusted-public-cert OPENSSLTRUSTEDPUBLICCERTFILE
                        OpenSSL trusted public certificate filename.
  --signing-tool-path SIGNINGTOOLPATH
                        Path to signtool or OpenSSL tool. Optional if path to
                        tools are already in PATH.
  --version             show program's version number and exit
  -v, --verbose         Turn on verbose output with informational messages
                        printed, including capsule headers and warning
                        messages.
  -q, --quiet           Disable all messages except fatal errors.
  --debug [0-9]         Set debug level

Cc: Sean Brogan <sean.brogan@microsoft.com>
Cc: Jiewen Yao <jiewen.yao@intel.com>
Cc: Yonghong Zhu <yonghong.zhu@intel.com>
Cc: Liming Gao <liming.gao@intel.com>
Contributed-under: TianoCore Contribution Agreement 1.1
Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com>
Reviewed-by: Yonghong Zhu <yonghong.zhu@intel.com>
2018-08-02 14:35:20 -07:00
..
AutoGen BaseTools: AutoGen - change class variable to funciton variable 2018-07-25 09:40:49 +08:00
BPDG BaseTools: Use absolute import in BPDG 2018-07-16 11:22:15 +08:00
build BaseTools: Update build report for StructurePcd value 2018-07-30 09:30:04 +08:00
Capsule BaseTools/Capsule: Add Capsule Generation Tools 2018-08-02 14:35:20 -07:00
Common BaseTools/Capsule: Add Capsule Generation Tools 2018-08-02 14:35:20 -07:00
CommonDataClass BaseTools: Clean up source files 2018-07-09 10:25:47 +08:00
Ecc BaseTools/Ecc: Add some new checkpoints 2018-07-26 08:45:04 +08:00
Eot BaseTools: Use absolute import in Eot 2018-07-16 11:22:17 +08:00
GenFds BaseTools: Fix build crash when fdf is empty file 2018-07-30 09:29:10 +08:00
GenPatchPcdTable BaseTools: Clean up source files 2018-07-09 10:25:47 +08:00
PatchPcdValue BaseTools: Clean up source files 2018-07-09 10:25:47 +08:00
Pkcs7Sign BaseTools: Adjust the spaces around commas and colons 2018-06-27 16:33:25 +08:00
Rsa2048Sha256Sign BaseTools: Clean up source files 2018-07-09 10:25:47 +08:00
Table BaseTools: Use absolute import in Table 2018-07-16 11:22:17 +08:00
TargetTool BaseTools: Clean up source files 2018-07-09 10:25:47 +08:00
Trim BaseTools: Clean up source files 2018-07-09 10:25:47 +08:00
UPT BaseTools: Use absolute import in UPT 2018-07-16 11:22:18 +08:00
Workspace BaseTools: Parse decimal format INF_VERSION incorrect 2018-07-27 13:43:40 +08:00
GNUmakefile Sync BaseTool trunk (version r2599) into EDKII BaseTools. 2013-08-23 02:18:16 +00:00
Makefile BaseTools: Rename String to StringUtils. 2018-05-28 13:05:00 +08:00
sitecustomize.py BaseTools: Clean up source files 2018-07-09 10:25:47 +08:00