From: Heinrich Schuchardt <xypron.glpk@gmx.de>
Date: Thu, 16 Jul 2020 05:18:40 +0000 (+0200)
Subject: efi_loader: describe EFI_VAR_FILE_MAGIC
X-Git-Url: http://git.dujemihanovic.xyz/?a=commitdiff_plain;h=627ab390d8ded26f4b8267c55fc4ce39145f24aa;p=u-boot.git

efi_loader: describe EFI_VAR_FILE_MAGIC

Add documentation for EFI_VAR_FILE_MAGIC used in the file format for UEFI
variables.

Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
---

diff --git a/include/efi_variable.h b/include/efi_variable.h
index 17f25ad7a4..2c629e4dca 100644
--- a/include/efi_variable.h
+++ b/include/efi_variable.h
@@ -93,6 +93,10 @@ efi_status_t efi_query_variable_info_int(u32 attributes,
 
 #define EFI_VAR_BUF_SIZE 0x4000
 
+/*
+ * This constant identifies the file format for storing UEFI variables in
+ * struct efi_var_file.
+ */
 #define EFI_VAR_FILE_MAGIC 0x0161566966456255 /* UbEfiVa, version 1 */
 
 /**
@@ -116,7 +120,7 @@ struct efi_var_entry {
  * struct efi_var_file - file for storing UEFI variables
  *
  * @reserved:	unused, may be overwritten by memory probing
- * @magic:	identifies file format
+ * @magic:	identifies file format, takes value %EFI_VAR_FILE_MAGIC
  * @length:	length including header
  * @crc32:	CRC32 without header
  * @var:	variables