mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-08-28 20:02:17 +00:00
![Kai-Heng Feng](/assets/img/avatar_default.png)
Add SYS_OFF_MODE_RESTART_PREPARE callbacks to be invoked before a system restart. Suggested-by: Dmitry Osipenko <dmitry.osipenko@collabora.com> Reviewed-by: Dmitry Osipenko <dmitry.osipenko@collabora.com> Signed-off-by: Kai-Heng Feng <kai.heng.feng@canonical.com> [ rjw: Changelog edits ] Signed-off-by: Rafael J. Wysocki <rafael.j.wysocki@intel.com>
186 lines
4.5 KiB
C
186 lines
4.5 KiB
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
#ifndef _LINUX_REBOOT_H
|
|
#define _LINUX_REBOOT_H
|
|
|
|
|
|
#include <linux/notifier.h>
|
|
#include <uapi/linux/reboot.h>
|
|
|
|
struct device;
|
|
struct sys_off_handler;
|
|
|
|
#define SYS_DOWN 0x0001 /* Notify of system down */
|
|
#define SYS_RESTART SYS_DOWN
|
|
#define SYS_HALT 0x0002 /* Notify of system halt */
|
|
#define SYS_POWER_OFF 0x0003 /* Notify of system power off */
|
|
|
|
enum reboot_mode {
|
|
REBOOT_UNDEFINED = -1,
|
|
REBOOT_COLD = 0,
|
|
REBOOT_WARM,
|
|
REBOOT_HARD,
|
|
REBOOT_SOFT,
|
|
REBOOT_GPIO,
|
|
};
|
|
extern enum reboot_mode reboot_mode;
|
|
extern enum reboot_mode panic_reboot_mode;
|
|
|
|
enum reboot_type {
|
|
BOOT_TRIPLE = 't',
|
|
BOOT_KBD = 'k',
|
|
BOOT_BIOS = 'b',
|
|
BOOT_ACPI = 'a',
|
|
BOOT_EFI = 'e',
|
|
BOOT_CF9_FORCE = 'p',
|
|
BOOT_CF9_SAFE = 'q',
|
|
};
|
|
extern enum reboot_type reboot_type;
|
|
|
|
extern int reboot_default;
|
|
extern int reboot_cpu;
|
|
extern int reboot_force;
|
|
|
|
|
|
extern int register_reboot_notifier(struct notifier_block *);
|
|
extern int unregister_reboot_notifier(struct notifier_block *);
|
|
|
|
extern int devm_register_reboot_notifier(struct device *, struct notifier_block *);
|
|
|
|
extern int register_restart_handler(struct notifier_block *);
|
|
extern int unregister_restart_handler(struct notifier_block *);
|
|
extern void do_kernel_restart(char *cmd);
|
|
|
|
/*
|
|
* Architecture-specific implementations of sys_reboot commands.
|
|
*/
|
|
|
|
extern void migrate_to_reboot_cpu(void);
|
|
extern void machine_restart(char *cmd);
|
|
extern void machine_halt(void);
|
|
extern void machine_power_off(void);
|
|
|
|
extern void machine_shutdown(void);
|
|
struct pt_regs;
|
|
extern void machine_crash_shutdown(struct pt_regs *);
|
|
|
|
void do_kernel_power_off(void);
|
|
|
|
/*
|
|
* sys-off handler API.
|
|
*/
|
|
|
|
/*
|
|
* Standard sys-off priority levels. Users are expected to set priorities
|
|
* relative to the standard levels.
|
|
*
|
|
* SYS_OFF_PRIO_PLATFORM: Use this for platform-level handlers.
|
|
*
|
|
* SYS_OFF_PRIO_LOW: Use this for handler of last resort.
|
|
*
|
|
* SYS_OFF_PRIO_DEFAULT: Use this for normal handlers.
|
|
*
|
|
* SYS_OFF_PRIO_HIGH: Use this for higher priority handlers.
|
|
*
|
|
* SYS_OFF_PRIO_FIRMWARE: Use this if handler uses firmware call.
|
|
*/
|
|
#define SYS_OFF_PRIO_PLATFORM -256
|
|
#define SYS_OFF_PRIO_LOW -128
|
|
#define SYS_OFF_PRIO_DEFAULT 0
|
|
#define SYS_OFF_PRIO_HIGH 192
|
|
#define SYS_OFF_PRIO_FIRMWARE 224
|
|
|
|
enum sys_off_mode {
|
|
/**
|
|
* @SYS_OFF_MODE_POWER_OFF_PREPARE:
|
|
*
|
|
* Handlers prepare system to be powered off. Handlers are
|
|
* allowed to sleep.
|
|
*/
|
|
SYS_OFF_MODE_POWER_OFF_PREPARE,
|
|
|
|
/**
|
|
* @SYS_OFF_MODE_POWER_OFF:
|
|
*
|
|
* Handlers power-off system. Handlers are disallowed to sleep.
|
|
*/
|
|
SYS_OFF_MODE_POWER_OFF,
|
|
|
|
/**
|
|
* @SYS_OFF_MODE_RESTART_PREPARE:
|
|
*
|
|
* Handlers prepare system to be restarted. Handlers are
|
|
* allowed to sleep.
|
|
*/
|
|
SYS_OFF_MODE_RESTART_PREPARE,
|
|
|
|
/**
|
|
* @SYS_OFF_MODE_RESTART:
|
|
*
|
|
* Handlers restart system. Handlers are disallowed to sleep.
|
|
*/
|
|
SYS_OFF_MODE_RESTART,
|
|
};
|
|
|
|
/**
|
|
* struct sys_off_data - sys-off callback argument
|
|
*
|
|
* @mode: Mode ID. Currently used only by the sys-off restart mode,
|
|
* see enum reboot_mode for the available modes.
|
|
* @cb_data: User's callback data.
|
|
* @cmd: Command string. Currently used only by the sys-off restart mode,
|
|
* NULL otherwise.
|
|
*/
|
|
struct sys_off_data {
|
|
int mode;
|
|
void *cb_data;
|
|
const char *cmd;
|
|
};
|
|
|
|
struct sys_off_handler *
|
|
register_sys_off_handler(enum sys_off_mode mode,
|
|
int priority,
|
|
int (*callback)(struct sys_off_data *data),
|
|
void *cb_data);
|
|
void unregister_sys_off_handler(struct sys_off_handler *handler);
|
|
|
|
int devm_register_sys_off_handler(struct device *dev,
|
|
enum sys_off_mode mode,
|
|
int priority,
|
|
int (*callback)(struct sys_off_data *data),
|
|
void *cb_data);
|
|
|
|
int devm_register_power_off_handler(struct device *dev,
|
|
int (*callback)(struct sys_off_data *data),
|
|
void *cb_data);
|
|
|
|
int devm_register_restart_handler(struct device *dev,
|
|
int (*callback)(struct sys_off_data *data),
|
|
void *cb_data);
|
|
|
|
int register_platform_power_off(void (*power_off)(void));
|
|
void unregister_platform_power_off(void (*power_off)(void));
|
|
|
|
/*
|
|
* Architecture independent implemenations of sys_reboot commands.
|
|
*/
|
|
|
|
extern void kernel_restart_prepare(char *cmd);
|
|
extern void kernel_restart(char *cmd);
|
|
extern void kernel_halt(void);
|
|
extern void kernel_power_off(void);
|
|
extern bool kernel_can_power_off(void);
|
|
|
|
void ctrl_alt_del(void);
|
|
|
|
extern void orderly_poweroff(bool force);
|
|
extern void orderly_reboot(void);
|
|
void hw_protection_shutdown(const char *reason, int ms_until_forced);
|
|
|
|
/*
|
|
* Emergency restart, callable from an interrupt handler.
|
|
*/
|
|
|
|
extern void emergency_restart(void);
|
|
#include <asm/emergency-restart.h>
|
|
|
|
#endif /* _LINUX_REBOOT_H */
|