1 /** @file 2 UEFI Firmware Management Protocol definition 3 Firmware Management Protocol provides an abstraction for device to provide firmware 4 management support. The base requirements for managing device firmware images include 5 identifying firmware image revision level and programming the image into the device. 6 7 GetImageInfo() is the only required function. GetImage(), SetImage(), 8 CheckImage(), GetPackageInfo(), and SetPackageInfo() shall return 9 EFI_UNSUPPORTED if not supported by the driver. 10 11 Copyright (c) 2009 - 2015, Intel Corporation. All rights reserved.<BR> 12 Copyright (c) 2013 - 2014, Hewlett-Packard Development Company, L.P.<BR> 13 This program and the accompanying materials 14 are licensed and made available under the terms and conditions of the BSD License 15 which accompanies this distribution. The full text of the license may be found at 16 http://opensource.org/licenses/bsd-license.php 17 18 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, 19 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. 20 21 @par Revision Reference: 22 This Protocol is introduced in UEFI Specification 2.3 23 24 **/ 25 26 #ifndef __EFI_FIRMWARE_MANAGEMENT_PROTOCOL_H__ 27 #define __EFI_FIRMWARE_MANAGEMENT_PROTOCOL_H__ 28 29 30 #define EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GUID \ 31 { \ 32 0x86c77a67, 0xb97, 0x4633, {0xa1, 0x87, 0x49, 0x10, 0x4d, 0x6, 0x85, 0xc7 } \ 33 } 34 35 typedef struct _EFI_FIRMWARE_MANAGEMENT_PROTOCOL EFI_FIRMWARE_MANAGEMENT_PROTOCOL; 36 37 /// 38 /// EFI_FIRMWARE_IMAGE_DESCRIPTOR 39 /// 40 typedef struct { 41 /// 42 /// A unique number identifying the firmware image within the device. The number is 43 /// between 1 and DescriptorCount. 44 /// 45 UINT8 ImageIndex; 46 /// 47 /// A unique GUID identifying the firmware image type. 48 /// 49 EFI_GUID ImageTypeId; 50 /// 51 /// A unique number identifying the firmware image. 52 /// 53 UINT64 ImageId; 54 /// 55 /// A pointer to a null-terminated string representing the firmware image name. 56 /// 57 CHAR16 *ImageIdName; 58 /// 59 /// Identifies the version of the device firmware. The format is vendor specific and new 60 /// version must have a greater value than an old version. 61 /// 62 UINT32 Version; 63 /// 64 /// A pointer to a null-terminated string representing the firmware image version name. 65 /// 66 CHAR16 *VersionName; 67 /// 68 /// Size of the image in bytes. If size=0, then only ImageIndex and ImageTypeId are valid. 69 /// 70 UINTN Size; 71 /// 72 /// Image attributes that are supported by this device. See 'Image Attribute Definitions' 73 /// for possible returned values of this parameter. A value of 1 indicates the attribute is 74 /// supported and the current setting value is indicated in AttributesSetting. A 75 /// value of 0 indicates the attribute is not supported and the current setting value in 76 /// AttributesSetting is meaningless. 77 /// 78 UINT64 AttributesSupported; 79 /// 80 /// Image attributes. See 'Image Attribute Definitions' for possible returned values of 81 /// this parameter. 82 /// 83 UINT64 AttributesSetting; 84 /// 85 /// Image compatibilities. See 'Image Compatibility Definitions' for possible returned 86 /// values of this parameter. 87 /// 88 UINT64 Compatibilities; 89 /// 90 /// Describes the lowest ImageDescriptor version that the device will accept. Only 91 /// present in version 2 or higher. 92 /// 93 UINT32 LowestSupportedImageVersion; 94 /// 95 /// Describes the version that was last attempted to update. If no update attempted the 96 /// value will be 0. If the update attempted was improperly formatted and no version 97 /// number was available then the value will be zero. Only present in version 3 or higher. 98 UINT32 LastAttemptVersion; 99 /// 100 /// Describes the status that was last attempted to update. If no update has been attempted 101 /// the value will be LAST_ATTEMPT_STATUS_SUCCESS. Only present in version 3 or higher. 102 /// 103 UINT32 LastAttemptStatus; 104 /// 105 /// An optional number to identify the unique hardware instance within the system for 106 /// devices that may have multiple instances (Example: a plug in pci network card). This 107 /// number must be unique within the namespace of the ImageTypeId GUID and 108 /// ImageIndex. For FMP instances that have multiple descriptors for a single 109 /// hardware instance, all descriptors must have the same HardwareInstance value. 110 /// This number must be consistent between boots and should be based on some sort of 111 /// hardware identified unique id (serial number, etc) whenever possible. If a hardware 112 /// based number is not available the FMP provider may use some other characteristic 113 /// such as device path, bus/dev/function, slot num, etc for generating the 114 /// HardwareInstance. For implementations that will never have more than one 115 /// instance a zero can be used. A zero means the FMP provider is not able to determine a 116 /// unique hardware instance number or a hardware instance number is not needed. Only 117 /// present in version 3 or higher. 118 /// 119 UINT64 HardwareInstance; 120 } EFI_FIRMWARE_IMAGE_DESCRIPTOR; 121 122 123 // 124 // Image Attribute Definitions 125 // 126 /// 127 /// The attribute IMAGE_ATTRIBUTE_IMAGE_UPDATABLE indicates this device supports firmware 128 /// image update. 129 /// 130 #define IMAGE_ATTRIBUTE_IMAGE_UPDATABLE 0x0000000000000001 131 /// 132 /// The attribute IMAGE_ATTRIBUTE_RESET_REQUIRED indicates a reset of the device is required 133 /// for the new firmware image to take effect after a firmware update. The device is the device hosting 134 /// the firmware image. 135 /// 136 #define IMAGE_ATTRIBUTE_RESET_REQUIRED 0x0000000000000002 137 /// 138 /// The attribute IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED indicates authentication is 139 /// required to perform the following image operations: GetImage(), SetImage(), and 140 /// CheckImage(). See 'Image Attribute - Authentication'. 141 /// 142 #define IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED 0x0000000000000004 143 /// 144 /// The attribute IMAGE_ATTRIBUTE_IN_USE indicates the current state of the firmware image. 145 /// This distinguishes firmware images in a device that supports redundant images. 146 /// 147 #define IMAGE_ATTRIBUTE_IN_USE 0x0000000000000008 148 /// 149 /// The attribute IMAGE_ATTRIBUTE_UEFI_IMAGE indicates that this image is an EFI compatible image. 150 /// 151 #define IMAGE_ATTRIBUTE_UEFI_IMAGE 0x0000000000000010 152 153 154 // 155 // Image Compatibility Definitions 156 // 157 /// Values from 0x0000000000000002 thru 0x000000000000FFFF are reserved for future assignments. 158 /// Values from 0x0000000000010000 thru 0xFFFFFFFFFFFFFFFF are used by firmware vendor for 159 /// compatibility check. 160 /// 161 #define IMAGE_COMPATIBILITY_CHECK_SUPPORTED 0x0000000000000001 162 163 /// 164 /// Descriptor Version exposed by GetImageInfo() function 165 /// 166 #define EFI_FIRMWARE_IMAGE_DESCRIPTOR_VERSION 3 167 168 169 /// 170 /// Image Attribute -Authentication Required 171 /// 172 typedef struct { 173 /// 174 /// It is included in the signature of AuthInfo. It is used to ensure freshness/no replay. 175 /// It is incremented during each firmware image operation. 176 /// 177 UINT64 MonotonicCount; 178 /// 179 /// Provides the authorization for the firmware image operations. It is a signature across 180 /// the image data and the Monotonic Count value. Caller uses the private key that is 181 /// associated with a public key that has been provisioned via the key exchange. 182 /// Because this is defined as a signature, WIN_CERTIFICATE_UEFI_GUID.CertType must 183 /// be EFI_CERT_TYPE_PKCS7_GUID. 184 /// 185 WIN_CERTIFICATE_UEFI_GUID AuthInfo; 186 } EFI_FIRMWARE_IMAGE_AUTHENTICATION; 187 188 189 // 190 // ImageUpdatable Definitions 191 // 192 /// 193 /// IMAGE_UPDATABLE_VALID indicates SetImage() will accept the new image and update the 194 /// device with the new image. The version of the new image could be higher or lower than 195 /// the current image. SetImage VendorCode is optional but can be used for vendor 196 /// specific action. 197 /// 198 #define IMAGE_UPDATABLE_VALID 0x0000000000000001 199 /// 200 /// IMAGE_UPDATABLE_INVALID indicates SetImage() will reject the new image. No additional 201 /// information is provided for the rejection. 202 /// 203 #define IMAGE_UPDATABLE_INVALID 0x0000000000000002 204 /// 205 /// IMAGE_UPDATABLE_INVALID_TYPE indicates SetImage() will reject the new image. The 206 /// rejection is due to the new image is not a firmware image recognized for this device. 207 /// 208 #define IMAGE_UPDATABLE_INVALID_TYPE 0x0000000000000004 209 /// 210 /// IMAGE_UPDATABLE_INVALID_OLD indicates SetImage() will reject the new image. The 211 /// rejection is due to the new image version is older than the current firmware image 212 /// version in the device. The device firmware update policy does not support firmware 213 /// version downgrade. 214 /// 215 #define IMAGE_UPDATABLE_INVALID_OLD 0x0000000000000008 216 /// 217 /// IMAGE_UPDATABLE_VALID_WITH_VENDOR_CODE indicates SetImage() will accept and update 218 /// the new image only if a correct VendorCode is provided or else image would be 219 /// rejected and SetImage will return appropriate error. 220 /// 221 #define IMAGE_UPDATABLE_VALID_WITH_VENDOR_CODE 0x0000000000000010 222 223 224 // 225 // Package Attribute Definitions 226 // 227 /// 228 /// The attribute PACKAGE_ATTRIBUTE_VERSION_UPDATABLE indicates this device supports the 229 /// update of the firmware package version. 230 /// 231 #define PACKAGE_ATTRIBUTE_VERSION_UPDATABLE 0x0000000000000001 232 /// 233 /// The attribute PACKAGE_ATTRIBUTE_RESET_REQUIRED indicates a reset of the device is 234 /// required for the new package info to take effect after an update. 235 /// 236 #define PACKAGE_ATTRIBUTE_RESET_REQUIRED 0x0000000000000002 237 /// 238 /// The attribute PACKAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED indicates authentication 239 /// is required to update the package info. 240 /// 241 #define PACKAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED 0x0000000000000004 242 243 /** 244 Callback function to report the process of the firmware updating. 245 246 @param[in] Completion A value between 1 and 100 indicating the current completion 247 progress of the firmware update. Completion progress is 248 reported as from 1 to 100 percent. A value of 0 is used by 249 the driver to indicate that progress reporting is not supported. 250 251 @retval EFI_SUCCESS SetImage() continues to do the callback if supported. 252 @retval other SetImage() discontinues the callback and completes 253 the update and returns. 254 255 **/ 256 typedef 257 EFI_STATUS 258 (EFIAPI *EFI_FIRMWARE_MANAGEMENT_UPDATE_IMAGE_PROGRESS)( 259 IN UINTN Completion 260 ); 261 262 /** 263 Returns information about the current firmware image(s) of the device. 264 265 This function allows a copy of the current firmware image to be created and saved. 266 The saved copy could later been used, for example, in firmware image recovery or rollback. 267 268 @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. 269 @param[in, out] ImageInfoSize A pointer to the size, in bytes, of the ImageInfo buffer. 270 On input, this is the size of the buffer allocated by the caller. 271 On output, it is the size of the buffer returned by the firmware 272 if the buffer was large enough, or the size of the buffer needed 273 to contain the image(s) information if the buffer was too small. 274 @param[in, out] ImageInfo A pointer to the buffer in which firmware places the current image(s) 275 information. The information is an array of EFI_FIRMWARE_IMAGE_DESCRIPTORs. 276 @param[out] DescriptorVersion A pointer to the location in which firmware returns the version number 277 associated with the EFI_FIRMWARE_IMAGE_DESCRIPTOR. 278 @param[out] DescriptorCount A pointer to the location in which firmware returns the number of 279 descriptors or firmware images within this device. 280 @param[out] DescriptorSize A pointer to the location in which firmware returns the size, in bytes, 281 of an individual EFI_FIRMWARE_IMAGE_DESCRIPTOR. 282 @param[out] PackageVersion A version number that represents all the firmware images in the device. 283 The format is vendor specific and new version must have a greater value 284 than the old version. If PackageVersion is not supported, the value is 285 0xFFFFFFFF. A value of 0xFFFFFFFE indicates that package version comparison 286 is to be performed using PackageVersionName. A value of 0xFFFFFFFD indicates 287 that package version update is in progress. 288 @param[out] PackageVersionName A pointer to a pointer to a null-terminated string representing the 289 package version name. The buffer is allocated by this function with 290 AllocatePool(), and it is the caller's responsibility to free it with a call 291 to FreePool(). 292 293 @retval EFI_SUCCESS The device was successfully updated with the new image. 294 @retval EFI_BUFFER_TOO_SMALL The ImageInfo buffer was too small. The current buffer size 295 needed to hold the image(s) information is returned in ImageInfoSize. 296 @retval EFI_INVALID_PARAMETER ImageInfoSize is NULL. 297 @retval EFI_DEVICE_ERROR Valid information could not be returned. Possible corrupted image. 298 299 **/ 300 typedef 301 EFI_STATUS 302 (EFIAPI *EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_IMAGE_INFO)( 303 IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, 304 IN OUT UINTN *ImageInfoSize, 305 IN OUT EFI_FIRMWARE_IMAGE_DESCRIPTOR *ImageInfo, 306 OUT UINT32 *DescriptorVersion, 307 OUT UINT8 *DescriptorCount, 308 OUT UINTN *DescriptorSize, 309 OUT UINT32 *PackageVersion, 310 OUT CHAR16 **PackageVersionName 311 ); 312 313 /** 314 Retrieves a copy of the current firmware image of the device. 315 316 This function allows a copy of the current firmware image to be created and saved. 317 The saved copy could later been used, for example, in firmware image recovery or rollback. 318 319 @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. 320 @param[in] ImageIndex A unique number identifying the firmware image(s) within the device. 321 The number is between 1 and DescriptorCount. 322 @param[out] Image Points to the buffer where the current image is copied to. 323 @param[out] ImageSize On entry, points to the size of the buffer pointed to by Image, in bytes. 324 On return, points to the length of the image, in bytes. 325 326 @retval EFI_SUCCESS The device was successfully updated with the new image. 327 @retval EFI_BUFFER_TOO_SMALL The buffer specified by ImageSize is too small to hold the 328 image. The current buffer size needed to hold the image is returned 329 in ImageSize. 330 @retval EFI_INVALID_PARAMETER The Image was NULL. 331 @retval EFI_NOT_FOUND The current image is not copied to the buffer. 332 @retval EFI_UNSUPPORTED The operation is not supported. 333 @retval EFI_SECURITY_VIOLATIO The operation could not be performed due to an authentication failure. 334 335 **/ 336 typedef 337 EFI_STATUS 338 (EFIAPI *EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_IMAGE)( 339 IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, 340 IN UINT8 ImageIndex, 341 IN OUT VOID *Image, 342 IN OUT UINTN *ImageSize 343 ); 344 345 /** 346 Updates the firmware image of the device. 347 348 This function updates the hardware with the new firmware image. 349 This function returns EFI_UNSUPPORTED if the firmware image is not updatable. 350 If the firmware image is updatable, the function should perform the following minimal validations 351 before proceeding to do the firmware image update. 352 - Validate the image authentication if image has attribute 353 IMAGE_ATTRIBUTE_AUTHENTICATION_REQUIRED. The function returns 354 EFI_SECURITY_VIOLATION if the validation fails. 355 - Validate the image is a supported image for this device. The function returns EFI_ABORTED if 356 the image is unsupported. The function can optionally provide more detailed information on 357 why the image is not a supported image. 358 - Validate the data from VendorCode if not null. Image validation must be performed before 359 VendorCode data validation. VendorCode data is ignored or considered invalid if image 360 validation failed. The function returns EFI_ABORTED if the data is invalid. 361 362 VendorCode enables vendor to implement vendor-specific firmware image update policy. Null if 363 the caller did not specify the policy or use the default policy. As an example, vendor can implement 364 a policy to allow an option to force a firmware image update when the abort reason is due to the new 365 firmware image version is older than the current firmware image version or bad image checksum. 366 Sensitive operations such as those wiping the entire firmware image and render the device to be 367 non-functional should be encoded in the image itself rather than passed with the VendorCode. 368 AbortReason enables vendor to have the option to provide a more detailed description of the abort 369 reason to the caller. 370 371 @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. 372 @param[in] ImageIndex A unique number identifying the firmware image(s) within the device. 373 The number is between 1 and DescriptorCount. 374 @param[in] Image Points to the new image. 375 @param[in] ImageSize Size of the new image in bytes. 376 @param[in] VendorCode This enables vendor to implement vendor-specific firmware image update policy. 377 Null indicates the caller did not specify the policy or use the default policy. 378 @param[in] Progress A function used by the driver to report the progress of the firmware update. 379 @param[out] AbortReason A pointer to a pointer to a null-terminated string providing more 380 details for the aborted operation. The buffer is allocated by this function 381 with AllocatePool(), and it is the caller's responsibility to free it with a 382 call to FreePool(). 383 384 @retval EFI_SUCCESS The device was successfully updated with the new image. 385 @retval EFI_ABORTED The operation is aborted. 386 @retval EFI_INVALID_PARAMETER The Image was NULL. 387 @retval EFI_UNSUPPORTED The operation is not supported. 388 @retval EFI_SECURITY_VIOLATIO The operation could not be performed due to an authentication failure. 389 390 **/ 391 typedef 392 EFI_STATUS 393 (EFIAPI *EFI_FIRMWARE_MANAGEMENT_PROTOCOL_SET_IMAGE)( 394 IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, 395 IN UINT8 ImageIndex, 396 IN CONST VOID *Image, 397 IN UINTN ImageSize, 398 IN CONST VOID *VendorCode, 399 IN EFI_FIRMWARE_MANAGEMENT_UPDATE_IMAGE_PROGRESS Progress, 400 OUT CHAR16 **AbortReason 401 ); 402 403 /** 404 Checks if the firmware image is valid for the device. 405 406 This function allows firmware update application to validate the firmware image without 407 invoking the SetImage() first. 408 409 @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. 410 @param[in] ImageIndex A unique number identifying the firmware image(s) within the device. 411 The number is between 1 and DescriptorCount. 412 @param[in] Image Points to the new image. 413 @param[in] ImageSize Size of the new image in bytes. 414 @param[out] ImageUpdatable Indicates if the new image is valid for update. It also provides, 415 if available, additional information if the image is invalid. 416 417 @retval EFI_SUCCESS The image was successfully checked. 418 @retval EFI_INVALID_PARAMETER The Image was NULL. 419 @retval EFI_UNSUPPORTED The operation is not supported. 420 @retval EFI_SECURITY_VIOLATIO The operation could not be performed due to an authentication failure. 421 422 **/ 423 typedef 424 EFI_STATUS 425 (EFIAPI *EFI_FIRMWARE_MANAGEMENT_PROTOCOL_CHECK_IMAGE)( 426 IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, 427 IN UINT8 ImageIndex, 428 IN CONST VOID *Image, 429 IN UINTN ImageSize, 430 OUT UINT32 *ImageUpdatable 431 ); 432 433 /** 434 Returns information about the firmware package. 435 436 This function returns package information. 437 438 @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. 439 @param[out] PackageVersion A version number that represents all the firmware images in the device. 440 The format is vendor specific and new version must have a greater value 441 than the old version. If PackageVersion is not supported, the value is 442 0xFFFFFFFF. A value of 0xFFFFFFFE indicates that package version 443 comparison is to be performed using PackageVersionName. A value of 444 0xFFFFFFFD indicates that package version update is in progress. 445 @param[out] PackageVersionName A pointer to a pointer to a null-terminated string representing 446 the package version name. The buffer is allocated by this function with 447 AllocatePool(), and it is the caller's responsibility to free it with a 448 call to FreePool(). 449 @param[out] PackageVersionNameMaxLen The maximum length of package version name if device supports update of 450 package version name. A value of 0 indicates the device does not support 451 update of package version name. Length is the number of Unicode characters, 452 including the terminating null character. 453 @param[out] AttributesSupported Package attributes that are supported by this device. See 'Package Attribute 454 Definitions' for possible returned values of this parameter. A value of 1 455 indicates the attribute is supported and the current setting value is 456 indicated in AttributesSetting. A value of 0 indicates the attribute is not 457 supported and the current setting value in AttributesSetting is meaningless. 458 @param[out] AttributesSetting Package attributes. See 'Package Attribute Definitions' for possible returned 459 values of this parameter 460 461 @retval EFI_SUCCESS The package information was successfully returned. 462 @retval EFI_UNSUPPORTED The operation is not supported. 463 464 **/ 465 typedef 466 EFI_STATUS 467 (EFIAPI *EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_PACKAGE_INFO)( 468 IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, 469 OUT UINT32 *PackageVersion, 470 OUT CHAR16 **PackageVersionName, 471 OUT UINT32 *PackageVersionNameMaxLen, 472 OUT UINT64 *AttributesSupported, 473 OUT UINT64 *AttributesSetting 474 ); 475 476 /** 477 Updates information about the firmware package. 478 479 This function updates package information. 480 This function returns EFI_UNSUPPORTED if the package information is not updatable. 481 VendorCode enables vendor to implement vendor-specific package information update policy. 482 Null if the caller did not specify this policy or use the default policy. 483 484 @param[in] This A pointer to the EFI_FIRMWARE_MANAGEMENT_PROTOCOL instance. 485 @param[in] Image Points to the authentication image. 486 Null if authentication is not required. 487 @param[in] ImageSize Size of the authentication image in bytes. 488 0 if authentication is not required. 489 @param[in] VendorCode This enables vendor to implement vendor-specific firmware 490 image update policy. 491 Null indicates the caller did not specify this policy or use 492 the default policy. 493 @param[in] PackageVersion The new package version. 494 @param[in] PackageVersionName A pointer to the new null-terminated Unicode string representing 495 the package version name. 496 The string length is equal to or less than the value returned in 497 PackageVersionNameMaxLen. 498 499 @retval EFI_SUCCESS The device was successfully updated with the new package 500 information. 501 @retval EFI_INVALID_PARAMETER The PackageVersionName length is longer than the value 502 returned in PackageVersionNameMaxLen. 503 @retval EFI_UNSUPPORTED The operation is not supported. 504 @retval EFI_SECURITY_VIOLATIO The operation could not be performed due to an authentication failure. 505 506 **/ 507 typedef 508 EFI_STATUS 509 (EFIAPI *EFI_FIRMWARE_MANAGEMENT_PROTOCOL_SET_PACKAGE_INFO)( 510 IN EFI_FIRMWARE_MANAGEMENT_PROTOCOL *This, 511 IN CONST VOID *Image, 512 IN UINTN ImageSize, 513 IN CONST VOID *VendorCode, 514 IN UINT32 PackageVersion, 515 IN CONST CHAR16 *PackageVersionName 516 ); 517 518 /// 519 /// EFI_FIRMWARE_MANAGEMENT_PROTOCOL 520 /// The protocol for managing firmware provides the following services. 521 /// - Get the attributes of the current firmware image. Attributes include revision level. 522 /// - Get a copy of the current firmware image. As an example, this service could be used by a 523 /// management application to facilitate a firmware roll-back. 524 /// - Program the device with a firmware image supplied by the user. 525 /// - Label all the firmware images within a device with a single version. 526 /// 527 struct _EFI_FIRMWARE_MANAGEMENT_PROTOCOL { 528 EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_IMAGE_INFO GetImageInfo; 529 EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_IMAGE GetImage; 530 EFI_FIRMWARE_MANAGEMENT_PROTOCOL_SET_IMAGE SetImage; 531 EFI_FIRMWARE_MANAGEMENT_PROTOCOL_CHECK_IMAGE CheckImage; 532 EFI_FIRMWARE_MANAGEMENT_PROTOCOL_GET_PACKAGE_INFO GetPackageInfo; 533 EFI_FIRMWARE_MANAGEMENT_PROTOCOL_SET_PACKAGE_INFO SetPackageInfo; 534 }; 535 536 extern EFI_GUID gEfiFirmwareManagementProtocolGuid; 537 538 #endif 539