166  *	@nb: Info about handler function to be called
167  *	@nb->priority:	Handler priority. Handlers should follow the
169  *			0:	Restart handler of last resort,
171  *			128:	Default restart handler; use if no other
172  *				restart handler is expected to be available,
175  *			255:	Highest priority restart handler, will
186  *	If more than one function is registered, the restart handler priority
192  *	restart handlers may exist; for example, one restart handler might
194  *	In such cases, the restart handler which only restarts part of the
209  *				     restart handler
212  *	Unregisters a previously registered restart handler function.
223  *	do_kernel_restart - Execute kernel restart handler call chain
230  *	Restarts the system immediately if a restart handler function has been
332 	struct sys_off_handler *handler;  in sys_off_notify()  local
335 	handler = container_of(nb, struct sys_off_handler, nb);  in sys_off_notify()
336 	data.cb_data = handler->cb_data;  in sys_off_notify()
339 	data.dev = handler->dev;  in sys_off_notify()
341 	return handler->sys_off_cb(&data);  in sys_off_notify()
348 	struct sys_off_handler *handler;  in alloc_sys_off_handler()  local
352 	 * Platforms like m68k can't allocate sys_off handler dynamically  in alloc_sys_off_handler()
356 		handler = &platform_sys_off_handler;  in alloc_sys_off_handler()
357 		if (handler->cb_data)  in alloc_sys_off_handler()
365 		handler = kzalloc(sizeof(*handler), flags);  in alloc_sys_off_handler()
366 		if (!handler)  in alloc_sys_off_handler()
370 	return handler;  in alloc_sys_off_handler()
373 static void free_sys_off_handler(struct sys_off_handler *handler)  in free_sys_off_handler()  argument
375 	if (handler == &platform_sys_off_handler)  in free_sys_off_handler()
376 		memset(handler, 0, sizeof(*handler));  in free_sys_off_handler()
378 		kfree(handler);  in free_sys_off_handler()
382  *	register_sys_off_handler - Register sys-off handler
384  *	@priority: Handler priority
388  *	Registers system power-off or restart handler that will be invoked
389  *	at the step corresponding to the given sys-off mode. Handler's callback
390  *	should return NOTIFY_DONE to permit execution of the next handler in
396  *	Only one handler can be registered at the non-default priority level,
408 	struct sys_off_handler *handler;  in register_sys_off_handler()  local
411 	handler = alloc_sys_off_handler(priority);  in register_sys_off_handler()
412 	if (IS_ERR(handler))  in register_sys_off_handler()
413 		return handler;  in register_sys_off_handler()
417 		handler->list = &power_off_prep_handler_list;  in register_sys_off_handler()
418 		handler->blocking = true;  in register_sys_off_handler()
422 		handler->list = &power_off_handler_list;  in register_sys_off_handler()
426 		handler->list = &restart_prep_handler_list;  in register_sys_off_handler()
427 		handler->blocking = true;  in register_sys_off_handler()
431 		handler->list = &restart_handler_list;  in register_sys_off_handler()
435 		free_sys_off_handler(handler);  in register_sys_off_handler()
439 	handler->nb.notifier_call = sys_off_notify;  in register_sys_off_handler()
440 	handler->nb.priority = priority;  in register_sys_off_handler()
441 	handler->sys_off_cb = callback;  in register_sys_off_handler()
442 	handler->cb_data = cb_data;  in register_sys_off_handler()
443 	handler->mode = mode;  in register_sys_off_handler()
445 	if (handler->blocking) {  in register_sys_off_handler()
447 			err = blocking_notifier_chain_register(handler->list,  in register_sys_off_handler()
448 							       &handler->nb);  in register_sys_off_handler()
450 			err = blocking_notifier_chain_register_unique_prio(handler->list,  in register_sys_off_handler()
451 									   &handler->nb);  in register_sys_off_handler()
454 			err = atomic_notifier_chain_register(handler->list,  in register_sys_off_handler()
455 							     &handler->nb);  in register_sys_off_handler()
457 			err = atomic_notifier_chain_register_unique_prio(handler->list,  in register_sys_off_handler()
458 									 &handler->nb);  in register_sys_off_handler()
462 		free_sys_off_handler(handler);  in register_sys_off_handler()
466 	return handler;  in register_sys_off_handler()
471  *	unregister_sys_off_handler - Unregister sys-off handler
472  *	@handler: Sys-off handler
474  *	Unregisters given sys-off handler.
476 void unregister_sys_off_handler(struct sys_off_handler *handler)  in unregister_sys_off_handler()  argument
480 	if (IS_ERR_OR_NULL(handler))  in unregister_sys_off_handler()
483 	if (handler->blocking)  in unregister_sys_off_handler()
484 		err = blocking_notifier_chain_unregister(handler->list,  in unregister_sys_off_handler()
485 							 &handler->nb);  in unregister_sys_off_handler()
487 		err = atomic_notifier_chain_unregister(handler->list,  in unregister_sys_off_handler()
488 						       &handler->nb);  in unregister_sys_off_handler()
493 	free_sys_off_handler(handler);  in unregister_sys_off_handler()
499 	struct sys_off_handler *handler = data;  in devm_unregister_sys_off_handler()  local
501 	unregister_sys_off_handler(handler);  in devm_unregister_sys_off_handler()
505  *	devm_register_sys_off_handler - Register sys-off handler
506  *	@dev: Device that registers handler
508  *	@priority: Handler priority
512  *	Registers resource-managed sys-off handler.
522 	struct sys_off_handler *handler;  in devm_register_sys_off_handler()  local
524 	handler = register_sys_off_handler(mode, priority, callback, cb_data);  in devm_register_sys_off_handler()
525 	if (IS_ERR(handler))  in devm_register_sys_off_handler()
526 		return PTR_ERR(handler);  in devm_register_sys_off_handler()
527 	handler->dev = dev;  in devm_register_sys_off_handler()
530 					handler);  in devm_register_sys_off_handler()
535  *	devm_register_power_off_handler - Register power-off handler
540  *	Registers resource-managed sys-off handler with a default priority
557  *	devm_register_restart_handler - Register restart handler
562  *	Registers resource-managed sys-off handler with a default priority
602 	struct sys_off_handler *handler;  in register_platform_power_off()  local
604 	handler = register_sys_off_handler(SYS_OFF_MODE_POWER_OFF,  in register_platform_power_off()
608 	if (IS_ERR(handler))  in register_platform_power_off()
609 		return PTR_ERR(handler);  in register_platform_power_off()
611 	platform_power_off_handler = handler;  in register_platform_power_off()
647  *	do_kernel_power_off - Execute kernel power-off handler call chain
651  *	Powers off the system immediately if a power-off handler function has
678  *	Returns true if power-off handler is registered and system can be