Added recovery-mode return code to LoadKernel()

vboot_firmware/include/load_kernel_fw.h

 /* Copyright (c) 2010 The Chromium OS Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  *
  * High-level firmware API for loading and verifying kernel.
  * (Firmware Portion)
  */
 
 #ifndef VBOOT_REFERENCE_LOAD_KERNEL_FW_H_
 #define VBOOT_REFERENCE_LOAD_KERNEL_FW_H_
 
 #include <stdint.h>
 
 /* Interface provided by verified boot library to BDS */
 
 /* Return codes for LoadKernel() */
-#define LOAD_KERNEL_SUCCESS 0
-#define LOAD_KERNEL_NOT_FOUND 1
-#define LOAD_KERNEL_INVALID 2
+#define LOAD_KERNEL_SUCCESS 0    /* Success; good kernel found on device */
+#define LOAD_KERNEL_NOT_FOUND 1  /* No kernel found on device */
+#define LOAD_KERNEL_INVALID 2    /* Only invalid kernels found on device */
+#define LOAD_KERNEL_RECOVERY 3   /* Internal error; reboot to recovery mode */
 
 /* Boot modes for LoadKernel() */
 #define BOOT_MODE_NORMAL 0
 #define BOOT_MODE_DEVELOPER 1
 #define BOOT_MODE_RECOVERY 2
 
 typedef struct LoadKernelParams {
   /* Inputs to LoadKernel() */
   void *header_sign_key_blob;   /* Key blob used to sign the kernel header */
   uint64_t bytes_per_lba;       /* Bytes per lba sector on current device */
@@ skipping 25 matching lines @@
   uint64_t partition_number;    /* Partition number, as returned from
                                  * LoadKernel() in
                                  * LoadKernelParams.partition_number */
   uint64_t original_address;    /* Absolute bootloader start adddress,
                                  * as returned from LoadKernel() in
                                  * LoadKernelParams.bootloader_start */
 } KernelBootloaderOptions;
 
 
 #endif  /* VBOOT_REFERENCE_LOAD_KERNEL_FW_H_ */