iPXE
efi_reboot.c
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2013 Michael Brown <mbrown@fensystems.co.uk>.
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License as
6  * published by the Free Software Foundation; either version 2 of the
7  * License, or any later version.
8  *
9  * This program is distributed in the hope that it will be useful, but
10  * WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12  * General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
17  * 02110-1301, USA.
18  *
19  * You can also choose to distribute this program under the terms of
20  * the Unmodified Binary Distribution Licence (as given in the file
21  * COPYING.UBDL), provided that you have satisfied its requirements.
22  */
23 
24 FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );
25 
26 /**
27  * @file
28  *
29  * EFI reboot mechanism
30  *
31  */
32 
33 #include <errno.h>
34 #include <string.h>
35 #include <ipxe/efi/efi.h>
37 #include <ipxe/reboot.h>
38 
39 /**
40  * Reboot system
41  *
42  * @v flags Reboot flags
43  */
44 static void efi_reboot ( int flags ) {
47  UINT64 osind;
48  UINT32 attrs;
50  EFI_STATUS efirc;
51  int rc;
52 
53  /* Request boot to firmware setup, if applicable */
54  if ( flags & REBOOT_SETUP ) {
59  if ( ( efirc = rs->SetVariable ( wname, &efi_global_variable,
60  attrs, sizeof ( osind ),
61  &osind ) ) != 0 ) {
62  rc = -EEFI ( efirc );
63  DBGC ( efi_systab, "EFI could not set %ls: %s\n",
64  wname, strerror ( rc ) );
65  /* Continue to reboot anyway */
66  }
67  }
68 
69  /* Use runtime services to reset system */
71  rs->ResetSystem ( type, 0, 0, NULL );
72 }
73 
74 /**
75  * Power off system
76  *
77  * @ret rc Return status code
78  */
79 static int efi_poweroff ( void ) {
81 
82  /* Use runtime services to power off system */
83  rs->ResetSystem ( EfiResetShutdown, 0, 0, NULL );
84 
85  /* Should never happen */
86  return -ECANCELED;
87 }
88 
#define EFI_VARIABLE_RUNTIME_ACCESS
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
#define EEFI(efirc)
Convert an EFI status code to an iPXE status code.
Definition: efi.h:174
Error codes.
EFI_RESET_TYPE
Enumeration of reset types.
uint32_t type
Operating system type.
Definition: ena.h:12
#define REBOOT_SETUP
Reboot to firmware setup.
Definition: reboot.h:59
static int efi_poweroff(void)
Power off system.
Definition: efi_reboot.c:79
#define DBGC(...)
Definition: compiler.h:505
#define EFI_VARIABLE_BOOTSERVICE_ACCESS
unsigned int UINT32
Definition: ProcessorBind.h:98
unsigned short CHAR16
#define EFI_OS_INDICATIONS_BOOT_TO_FW_UI
Definition: UefiSpec.h:1843
#define ECANCELED
Operation canceled.
Definition: errno.h:343
iPXE reboot API
int poweroff(void)
Power off system.
Used to induce a system-wide reset.
Used to induce a system-wide initialization.
#define EFI_OS_INDICATIONS_VARIABLE_NAME
Allows the OS to request the firmware to enable certain features and to take certain actions.
EFI_SET_VARIABLE SetVariable
Definition: UefiSpec.h:1904
PROVIDE_REBOOT(efi, reboot, efi_reboot)
EFI_GUID efi_global_variable
Global variable GUID.
Definition: efi_guid.c:468
static void efi_reboot(int flags)
Reboot system.
Definition: efi_reboot.c:44
EFI Runtime Services Table.
Definition: UefiSpec.h:1879
EFI_RESET_SYSTEM ResetSystem
Definition: UefiSpec.h:1910
uint8_t flags
Flags.
Definition: ena.h:18
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
Used to induce an entry into a power state equivalent to the ACPI G2/S5 or G3 state.
#define REBOOT_WARM
Perform a warm reboot.
Definition: reboot.h:58
unsigned long long UINT64
Definition: ProcessorBind.h:96
EFI API.
GUID for EFI (NVRAM) Variables.
EFI_RUNTIME_SERVICES * RuntimeServices
A pointer to the EFI Runtime Services Table.
Definition: UefiSpec.h:2094
RETURN_STATUS EFI_STATUS
Function return status for EFI API.
Definition: UefiBaseType.h:31
EFI_SYSTEM_TABLE * efi_systab
FILE_LICENCE(GPL2_OR_LATER_OR_UBDL)
#define EFI_VARIABLE_NON_VOLATILE
Attributes of variable.
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
String functions.
void reboot(int flags)
Reboot system.