1 // SPDX-License-Identifier: GPL-2.0-or-later
4 * Procedures for interfacing to the RTAS on CHRP machines.
6 * Peter Bergner, IBM March 2001.
7 * Copyright (C) 2001 IBM.
11 #include <linux/kernel.h>
12 #include <linux/types.h>
13 #include <linux/spinlock.h>
14 #include <linux/export.h>
15 #include <linux/init.h>
16 #include <linux/capability.h>
17 #include <linux/delay.h>
18 #include <linux/cpu.h>
19 #include <linux/sched.h>
20 #include <linux/smp.h>
21 #include <linux/completion.h>
22 #include <linux/cpumask.h>
23 #include <linux/memblock.h>
24 #include <linux/slab.h>
25 #include <linux/reboot.h>
26 #include <linux/syscalls.h>
30 #include <asm/hvcall.h>
31 #include <asm/machdep.h>
32 #include <asm/firmware.h>
34 #include <asm/param.h>
35 #include <asm/delay.h>
36 #include <linux/uaccess.h>
38 #include <asm/syscalls.h>
40 #include <linux/atomic.h>
43 #include <asm/topology.h>
46 /* This is here deliberately so it's only used in this file */
47 void enter_rtas(unsigned long);
49 struct rtas_t rtas
= {
50 .lock
= __ARCH_SPIN_LOCK_UNLOCKED
54 DEFINE_SPINLOCK(rtas_data_buf_lock
);
55 EXPORT_SYMBOL(rtas_data_buf_lock
);
57 char rtas_data_buf
[RTAS_DATA_BUF_SIZE
] __cacheline_aligned
;
58 EXPORT_SYMBOL(rtas_data_buf
);
60 unsigned long rtas_rmo_buf
;
63 * If non-NULL, this gets called when the kernel terminates.
64 * This is done like this so rtas_flash can be a module.
66 void (*rtas_flash_term_hook
)(int);
67 EXPORT_SYMBOL(rtas_flash_term_hook
);
69 /* RTAS use home made raw locking instead of spin_lock_irqsave
70 * because those can be called from within really nasty contexts
71 * such as having the timebase stopped which would lockup with
72 * normal locks and spinlock debugging enabled
74 static unsigned long lock_rtas(void)
78 local_irq_save(flags
);
80 arch_spin_lock(&rtas
.lock
);
84 static void unlock_rtas(unsigned long flags
)
86 arch_spin_unlock(&rtas
.lock
);
87 local_irq_restore(flags
);
92 * call_rtas_display_status and call_rtas_display_status_delay
93 * are designed only for very early low-level debugging, which
94 * is why the token is hard-coded to 10.
96 static void call_rtas_display_status(unsigned char c
)
104 rtas_call_unlocked(&rtas
.args
, 10, 1, 1, NULL
, c
);
108 static void call_rtas_display_status_delay(char c
)
110 static int pending_newline
= 0; /* did last write end with unprinted newline? */
111 static int width
= 16;
115 call_rtas_display_status(' ');
120 if (pending_newline
) {
121 call_rtas_display_status('\r');
122 call_rtas_display_status('\n');
126 call_rtas_display_status(c
);
132 void __init
udbg_init_rtas_panel(void)
134 udbg_putc
= call_rtas_display_status_delay
;
137 #ifdef CONFIG_UDBG_RTAS_CONSOLE
139 /* If you think you're dying before early_init_dt_scan_rtas() does its
140 * work, you can hard code the token values for your firmware here and
141 * hardcode rtas.base/entry etc.
143 static unsigned int rtas_putchar_token
= RTAS_UNKNOWN_SERVICE
;
144 static unsigned int rtas_getchar_token
= RTAS_UNKNOWN_SERVICE
;
146 static void udbg_rtascon_putc(char c
)
153 /* Add CRs before LFs */
155 udbg_rtascon_putc('\r');
157 /* if there is more than one character to be displayed, wait a bit */
158 for (tries
= 0; tries
< 16; tries
++) {
159 if (rtas_call(rtas_putchar_token
, 1, 1, NULL
, c
) == 0)
165 static int udbg_rtascon_getc_poll(void)
172 if (rtas_call(rtas_getchar_token
, 0, 2, &c
))
178 static int udbg_rtascon_getc(void)
182 while ((c
= udbg_rtascon_getc_poll()) == -1)
189 void __init
udbg_init_rtas_console(void)
191 udbg_putc
= udbg_rtascon_putc
;
192 udbg_getc
= udbg_rtascon_getc
;
193 udbg_getc_poll
= udbg_rtascon_getc_poll
;
195 #endif /* CONFIG_UDBG_RTAS_CONSOLE */
197 void rtas_progress(char *s
, unsigned short hex
)
199 struct device_node
*root
;
203 static int display_character
, set_indicator
;
204 static int display_width
, display_lines
, form_feed
;
205 static const int *row_width
;
206 static DEFINE_SPINLOCK(progress_lock
);
207 static int current_line
;
208 static int pending_newline
= 0; /* did last write end with unprinted newline? */
213 if (display_width
== 0) {
214 display_width
= 0x10;
215 if ((root
= of_find_node_by_path("/rtas"))) {
216 if ((p
= of_get_property(root
,
217 "ibm,display-line-length", NULL
)))
218 display_width
= be32_to_cpu(*p
);
219 if ((p
= of_get_property(root
,
220 "ibm,form-feed", NULL
)))
221 form_feed
= be32_to_cpu(*p
);
222 if ((p
= of_get_property(root
,
223 "ibm,display-number-of-lines", NULL
)))
224 display_lines
= be32_to_cpu(*p
);
225 row_width
= of_get_property(root
,
226 "ibm,display-truncation-length", NULL
);
229 display_character
= rtas_token("display-character");
230 set_indicator
= rtas_token("set-indicator");
233 if (display_character
== RTAS_UNKNOWN_SERVICE
) {
234 /* use hex display if available */
235 if (set_indicator
!= RTAS_UNKNOWN_SERVICE
)
236 rtas_call(set_indicator
, 3, 1, NULL
, 6, 0, hex
);
240 spin_lock(&progress_lock
);
243 * Last write ended with newline, but we didn't print it since
244 * it would just clear the bottom line of output. Print it now
247 * If no newline is pending and form feed is supported, clear the
248 * display with a form feed; otherwise, print a CR to start output
249 * at the beginning of the line.
251 if (pending_newline
) {
252 rtas_call(display_character
, 1, 1, NULL
, '\r');
253 rtas_call(display_character
, 1, 1, NULL
, '\n');
258 rtas_call(display_character
, 1, 1, NULL
,
261 rtas_call(display_character
, 1, 1, NULL
, '\r');
265 width
= row_width
[current_line
];
267 width
= display_width
;
270 if (*os
== '\n' || *os
== '\r') {
271 /* If newline is the last character, save it
272 * until next call to avoid bumping up the
275 if (*os
== '\n' && !os
[1]) {
278 if (current_line
> display_lines
-1)
279 current_line
= display_lines
-1;
280 spin_unlock(&progress_lock
);
284 /* RTAS wants CR-LF, not just LF */
287 rtas_call(display_character
, 1, 1, NULL
, '\r');
288 rtas_call(display_character
, 1, 1, NULL
, '\n');
290 /* CR might be used to re-draw a line, so we'll
291 * leave it alone and not add LF.
293 rtas_call(display_character
, 1, 1, NULL
, *os
);
297 width
= row_width
[current_line
];
299 width
= display_width
;
302 rtas_call(display_character
, 1, 1, NULL
, *os
);
307 /* if we overwrite the screen length */
309 while ((*os
!= 0) && (*os
!= '\n') && (*os
!= '\r'))
313 spin_unlock(&progress_lock
);
315 EXPORT_SYMBOL(rtas_progress
); /* needed by rtas_flash module */
317 int rtas_token(const char *service
)
320 if (rtas
.dev
== NULL
)
321 return RTAS_UNKNOWN_SERVICE
;
322 tokp
= of_get_property(rtas
.dev
, service
, NULL
);
323 return tokp
? be32_to_cpu(*tokp
) : RTAS_UNKNOWN_SERVICE
;
325 EXPORT_SYMBOL(rtas_token
);
327 int rtas_service_present(const char *service
)
329 return rtas_token(service
) != RTAS_UNKNOWN_SERVICE
;
331 EXPORT_SYMBOL(rtas_service_present
);
333 #ifdef CONFIG_RTAS_ERROR_LOGGING
335 * Return the firmware-specified size of the error log buffer
336 * for all rtas calls that require an error buffer argument.
337 * This includes 'check-exception' and 'rtas-last-error'.
339 int rtas_get_error_log_max(void)
341 static int rtas_error_log_max
;
342 if (rtas_error_log_max
)
343 return rtas_error_log_max
;
345 rtas_error_log_max
= rtas_token ("rtas-error-log-max");
346 if ((rtas_error_log_max
== RTAS_UNKNOWN_SERVICE
) ||
347 (rtas_error_log_max
> RTAS_ERROR_LOG_MAX
)) {
348 printk (KERN_WARNING
"RTAS: bad log buffer size %d\n",
350 rtas_error_log_max
= RTAS_ERROR_LOG_MAX
;
352 return rtas_error_log_max
;
354 EXPORT_SYMBOL(rtas_get_error_log_max
);
357 static char rtas_err_buf
[RTAS_ERROR_LOG_MAX
];
358 static int rtas_last_error_token
;
360 /** Return a copy of the detailed error text associated with the
361 * most recent failed call to rtas. Because the error text
362 * might go stale if there are any other intervening rtas calls,
363 * this routine must be called atomically with whatever produced
364 * the error (i.e. with rtas.lock still held from the previous call).
366 static char *__fetch_rtas_last_error(char *altbuf
)
368 struct rtas_args err_args
, save_args
;
372 if (rtas_last_error_token
== -1)
375 bufsz
= rtas_get_error_log_max();
377 err_args
.token
= cpu_to_be32(rtas_last_error_token
);
378 err_args
.nargs
= cpu_to_be32(2);
379 err_args
.nret
= cpu_to_be32(1);
380 err_args
.args
[0] = cpu_to_be32(__pa(rtas_err_buf
));
381 err_args
.args
[1] = cpu_to_be32(bufsz
);
382 err_args
.args
[2] = 0;
384 save_args
= rtas
.args
;
385 rtas
.args
= err_args
;
387 enter_rtas(__pa(&rtas
.args
));
389 err_args
= rtas
.args
;
390 rtas
.args
= save_args
;
392 /* Log the error in the unlikely case that there was one. */
393 if (unlikely(err_args
.args
[2] == 0)) {
398 if (slab_is_available())
399 buf
= kmalloc(RTAS_ERROR_LOG_MAX
, GFP_ATOMIC
);
402 memcpy(buf
, rtas_err_buf
, RTAS_ERROR_LOG_MAX
);
408 #define get_errorlog_buffer() kmalloc(RTAS_ERROR_LOG_MAX, GFP_KERNEL)
410 #else /* CONFIG_RTAS_ERROR_LOGGING */
411 #define __fetch_rtas_last_error(x) NULL
412 #define get_errorlog_buffer() NULL
417 va_rtas_call_unlocked(struct rtas_args
*args
, int token
, int nargs
, int nret
,
422 args
->token
= cpu_to_be32(token
);
423 args
->nargs
= cpu_to_be32(nargs
);
424 args
->nret
= cpu_to_be32(nret
);
425 args
->rets
= &(args
->args
[nargs
]);
427 for (i
= 0; i
< nargs
; ++i
)
428 args
->args
[i
] = cpu_to_be32(va_arg(list
, __u32
));
430 for (i
= 0; i
< nret
; ++i
)
433 enter_rtas(__pa(args
));
436 void rtas_call_unlocked(struct rtas_args
*args
, int token
, int nargs
, int nret
, ...)
440 va_start(list
, nret
);
441 va_rtas_call_unlocked(args
, token
, nargs
, nret
, list
);
445 int rtas_call(int token
, int nargs
, int nret
, int *outputs
, ...)
450 struct rtas_args
*rtas_args
;
451 char *buff_copy
= NULL
;
454 if (!rtas
.entry
|| token
== RTAS_UNKNOWN_SERVICE
)
459 /* We use the global rtas args buffer */
460 rtas_args
= &rtas
.args
;
462 va_start(list
, outputs
);
463 va_rtas_call_unlocked(rtas_args
, token
, nargs
, nret
, list
);
466 /* A -1 return code indicates that the last command couldn't
467 be completed due to a hardware error. */
468 if (be32_to_cpu(rtas_args
->rets
[0]) == -1)
469 buff_copy
= __fetch_rtas_last_error(NULL
);
471 if (nret
> 1 && outputs
!= NULL
)
472 for (i
= 0; i
< nret
-1; ++i
)
473 outputs
[i
] = be32_to_cpu(rtas_args
->rets
[i
+1]);
474 ret
= (nret
> 0)? be32_to_cpu(rtas_args
->rets
[0]): 0;
479 log_error(buff_copy
, ERR_TYPE_RTAS_LOG
, 0);
480 if (slab_is_available())
485 EXPORT_SYMBOL(rtas_call
);
487 /* For RTAS_BUSY (-2), delay for 1 millisecond. For an extended busy status
488 * code of 990n, perform the hinted delay of 10^n (last digit) milliseconds.
490 unsigned int rtas_busy_delay_time(int status
)
495 if (status
== RTAS_BUSY
) {
497 } else if (status
>= RTAS_EXTENDED_DELAY_MIN
&&
498 status
<= RTAS_EXTENDED_DELAY_MAX
) {
499 order
= status
- RTAS_EXTENDED_DELAY_MIN
;
500 for (ms
= 1; order
> 0; order
--)
506 EXPORT_SYMBOL(rtas_busy_delay_time
);
508 /* For an RTAS busy status code, perform the hinted delay. */
509 unsigned int rtas_busy_delay(int status
)
514 ms
= rtas_busy_delay_time(status
);
515 if (ms
&& need_resched())
520 EXPORT_SYMBOL(rtas_busy_delay
);
522 static int rtas_error_rc(int rtas_rc
)
527 case -1: /* Hardware Error */
530 case -3: /* Bad indicator/domain/etc */
533 case -9000: /* Isolation error */
536 case -9001: /* Outstanding TCE/PTE */
539 case -9002: /* No usable slot */
543 printk(KERN_ERR
"%s: unexpected RTAS error %d\n",
551 int rtas_get_power_level(int powerdomain
, int *level
)
553 int token
= rtas_token("get-power-level");
556 if (token
== RTAS_UNKNOWN_SERVICE
)
559 while ((rc
= rtas_call(token
, 1, 2, level
, powerdomain
)) == RTAS_BUSY
)
563 return rtas_error_rc(rc
);
566 EXPORT_SYMBOL(rtas_get_power_level
);
568 int rtas_set_power_level(int powerdomain
, int level
, int *setlevel
)
570 int token
= rtas_token("set-power-level");
573 if (token
== RTAS_UNKNOWN_SERVICE
)
577 rc
= rtas_call(token
, 2, 2, setlevel
, powerdomain
, level
);
578 } while (rtas_busy_delay(rc
));
581 return rtas_error_rc(rc
);
584 EXPORT_SYMBOL(rtas_set_power_level
);
586 int rtas_get_sensor(int sensor
, int index
, int *state
)
588 int token
= rtas_token("get-sensor-state");
591 if (token
== RTAS_UNKNOWN_SERVICE
)
595 rc
= rtas_call(token
, 2, 2, state
, sensor
, index
);
596 } while (rtas_busy_delay(rc
));
599 return rtas_error_rc(rc
);
602 EXPORT_SYMBOL(rtas_get_sensor
);
604 int rtas_get_sensor_fast(int sensor
, int index
, int *state
)
606 int token
= rtas_token("get-sensor-state");
609 if (token
== RTAS_UNKNOWN_SERVICE
)
612 rc
= rtas_call(token
, 2, 2, state
, sensor
, index
);
613 WARN_ON(rc
== RTAS_BUSY
|| (rc
>= RTAS_EXTENDED_DELAY_MIN
&&
614 rc
<= RTAS_EXTENDED_DELAY_MAX
));
617 return rtas_error_rc(rc
);
621 bool rtas_indicator_present(int token
, int *maxindex
)
623 int proplen
, count
, i
;
624 const struct indicator_elem
{
629 indicators
= of_get_property(rtas
.dev
, "rtas-indicators", &proplen
);
633 count
= proplen
/ sizeof(struct indicator_elem
);
635 for (i
= 0; i
< count
; i
++) {
636 if (__be32_to_cpu(indicators
[i
].token
) != token
)
639 *maxindex
= __be32_to_cpu(indicators
[i
].maxindex
);
645 EXPORT_SYMBOL(rtas_indicator_present
);
647 int rtas_set_indicator(int indicator
, int index
, int new_value
)
649 int token
= rtas_token("set-indicator");
652 if (token
== RTAS_UNKNOWN_SERVICE
)
656 rc
= rtas_call(token
, 3, 1, NULL
, indicator
, index
, new_value
);
657 } while (rtas_busy_delay(rc
));
660 return rtas_error_rc(rc
);
663 EXPORT_SYMBOL(rtas_set_indicator
);
666 * Ignoring RTAS extended delay
668 int rtas_set_indicator_fast(int indicator
, int index
, int new_value
)
671 int token
= rtas_token("set-indicator");
673 if (token
== RTAS_UNKNOWN_SERVICE
)
676 rc
= rtas_call(token
, 3, 1, NULL
, indicator
, index
, new_value
);
678 WARN_ON(rc
== RTAS_BUSY
|| (rc
>= RTAS_EXTENDED_DELAY_MIN
&&
679 rc
<= RTAS_EXTENDED_DELAY_MAX
));
682 return rtas_error_rc(rc
);
688 * rtas_ibm_suspend_me() - Call ibm,suspend-me to suspend the LPAR.
690 * @fw_status: RTAS call status will be placed here if not NULL.
692 * rtas_ibm_suspend_me() should be called only on a CPU which has
693 * received H_CONTINUE from the H_JOIN hcall. All other active CPUs
694 * should be waiting to return from H_JOIN.
696 * rtas_ibm_suspend_me() may suspend execution of the OS
697 * indefinitely. Callers should take appropriate measures upon return, such as
698 * resetting watchdog facilities.
700 * Callers may choose to retry this call if @fw_status is
701 * %RTAS_THREADS_ACTIVE.
704 * 0 - The partition has resumed from suspend, possibly after
705 * migration to a different host.
706 * -ECANCELED - The operation was aborted.
707 * -EAGAIN - There were other CPUs not in H_JOIN at the time of the call.
708 * -EBUSY - Some other condition prevented the suspend from succeeding.
709 * -EIO - Hardware/platform error.
711 int rtas_ibm_suspend_me(int *fw_status
)
716 fwrc
= rtas_call(rtas_token("ibm,suspend-me"), 0, 1, NULL
);
722 case RTAS_SUSPEND_ABORTED
:
725 case RTAS_THREADS_ACTIVE
:
728 case RTAS_NOT_SUSPENDABLE
:
729 case RTAS_OUTSTANDING_COPROC
:
744 void __noreturn
rtas_restart(char *cmd
)
746 if (rtas_flash_term_hook
)
747 rtas_flash_term_hook(SYS_RESTART
);
748 printk("RTAS system-reboot returned %d\n",
749 rtas_call(rtas_token("system-reboot"), 0, 1, NULL
));
753 void rtas_power_off(void)
755 if (rtas_flash_term_hook
)
756 rtas_flash_term_hook(SYS_POWER_OFF
);
757 /* allow power on only with power button press */
758 printk("RTAS power-off returned %d\n",
759 rtas_call(rtas_token("power-off"), 2, 1, NULL
, -1, -1));
763 void __noreturn
rtas_halt(void)
765 if (rtas_flash_term_hook
)
766 rtas_flash_term_hook(SYS_HALT
);
767 /* allow power on only with power button press */
768 printk("RTAS power-off returned %d\n",
769 rtas_call(rtas_token("power-off"), 2, 1, NULL
, -1, -1));
773 /* Must be in the RMO region, so we place it here */
774 static char rtas_os_term_buf
[2048];
776 void rtas_os_term(char *str
)
781 * Firmware with the ibm,extended-os-term property is guaranteed
782 * to always return from an ibm,os-term call. Earlier versions without
783 * this property may terminate the partition which we want to avoid
784 * since it interferes with panic_timeout.
786 if (RTAS_UNKNOWN_SERVICE
== rtas_token("ibm,os-term") ||
787 RTAS_UNKNOWN_SERVICE
== rtas_token("ibm,extended-os-term"))
790 snprintf(rtas_os_term_buf
, 2048, "OS panic: %s", str
);
793 status
= rtas_call(rtas_token("ibm,os-term"), 1, 1, NULL
,
794 __pa(rtas_os_term_buf
));
795 } while (rtas_busy_delay(status
));
798 printk(KERN_EMERG
"ibm,os-term call failed %d\n", status
);
802 * rtas_activate_firmware() - Activate a new version of firmware.
804 * Activate a new version of partition firmware. The OS must call this
805 * after resuming from a partition hibernation or migration in order
806 * to maintain the ability to perform live firmware updates. It's not
807 * catastrophic for this method to be absent or to fail; just log the
808 * condition in that case.
810 * Context: This function may sleep.
812 void rtas_activate_firmware(void)
817 token
= rtas_token("ibm,activate-firmware");
818 if (token
== RTAS_UNKNOWN_SERVICE
) {
819 pr_notice("ibm,activate-firmware method unavailable\n");
824 fwrc
= rtas_call(token
, 0, 1, NULL
);
825 } while (rtas_busy_delay(fwrc
));
828 pr_err("ibm,activate-firmware failed (%i)\n", fwrc
);
831 static int ibm_suspend_me_token
= RTAS_UNKNOWN_SERVICE
;
832 #ifdef CONFIG_PPC_PSERIES
834 * rtas_call_reentrant() - Used for reentrant rtas calls
835 * @token: Token for desired reentrant RTAS call
836 * @nargs: Number of Input Parameters
837 * @nret: Number of Output Parameters
838 * @outputs: Array of outputs
839 * @...: Inputs for desired RTAS call
841 * According to LoPAR documentation, only "ibm,int-on", "ibm,int-off",
842 * "ibm,get-xive" and "ibm,set-xive" are currently reentrant.
843 * Reentrant calls need their own rtas_args buffer, so not using rtas.args, but
846 * Return: -1 on error,
847 * First output value of RTAS call if (nret > 0),
850 int rtas_call_reentrant(int token
, int nargs
, int nret
, int *outputs
, ...)
853 struct rtas_args
*args
;
857 if (!rtas
.entry
|| token
== RTAS_UNKNOWN_SERVICE
)
860 local_irq_save(flags
);
863 /* We use the per-cpu (PACA) rtas args buffer */
864 args
= local_paca
->rtas_args_reentrant
;
866 va_start(list
, outputs
);
867 va_rtas_call_unlocked(args
, token
, nargs
, nret
, list
);
870 if (nret
> 1 && outputs
)
871 for (i
= 0; i
< nret
- 1; ++i
)
872 outputs
[i
] = be32_to_cpu(args
->rets
[i
+ 1]);
875 ret
= be32_to_cpu(args
->rets
[0]);
877 local_irq_restore(flags
);
883 #endif /* CONFIG_PPC_PSERIES */
886 * Find a specific pseries error log in an RTAS extended event log.
887 * @log: RTAS error/event log
888 * @section_id: two character section identifier
890 * Returns a pointer to the specified errorlog or NULL if not found.
892 struct pseries_errorlog
*get_pseries_errorlog(struct rtas_error_log
*log
,
895 struct rtas_ext_event_log_v6
*ext_log
=
896 (struct rtas_ext_event_log_v6
*)log
->buffer
;
897 struct pseries_errorlog
*sect
;
898 unsigned char *p
, *log_end
;
899 uint32_t ext_log_length
= rtas_error_extended_log_length(log
);
900 uint8_t log_format
= rtas_ext_event_log_format(ext_log
);
901 uint32_t company_id
= rtas_ext_event_company_id(ext_log
);
903 /* Check that we understand the format */
904 if (ext_log_length
< sizeof(struct rtas_ext_event_log_v6
) ||
905 log_format
!= RTAS_V6EXT_LOG_FORMAT_EVENT_LOG
||
906 company_id
!= RTAS_V6EXT_COMPANY_ID_IBM
)
909 log_end
= log
->buffer
+ ext_log_length
;
910 p
= ext_log
->vendor_log
;
912 while (p
< log_end
) {
913 sect
= (struct pseries_errorlog
*)p
;
914 if (pseries_errorlog_id(sect
) == section_id
)
916 p
+= pseries_errorlog_length(sect
);
922 #ifdef CONFIG_PPC_RTAS_FILTER
925 * The sys_rtas syscall, as originally designed, allows root to pass
926 * arbitrary physical addresses to RTAS calls. A number of RTAS calls
927 * can be abused to write to arbitrary memory and do other things that
928 * are potentially harmful to system integrity, and thus should only
929 * be used inside the kernel and not exposed to userspace.
931 * All known legitimate users of the sys_rtas syscall will only ever
932 * pass addresses that fall within the RMO buffer, and use a known
933 * subset of RTAS calls.
935 * Accordingly, we filter RTAS requests to check that the call is
936 * permitted, and that provided pointers fall within the RMO buffer.
937 * The rtas_filters list contains an entry for each permitted call,
938 * with the indexes of the parameters which are expected to contain
939 * addresses and sizes of buffers allocated inside the RMO buffer.
944 /* Indexes into the args buffer, -1 if not used */
953 static struct rtas_filter rtas_filters
[] __ro_after_init
= {
954 { "ibm,activate-firmware", -1, -1, -1, -1, -1 },
955 { "ibm,configure-connector", -1, 0, -1, 1, -1, 4096 }, /* Special cased */
956 { "display-character", -1, -1, -1, -1, -1 },
957 { "ibm,display-message", -1, 0, -1, -1, -1 },
958 { "ibm,errinjct", -1, 2, -1, -1, -1, 1024 },
959 { "ibm,close-errinjct", -1, -1, -1, -1, -1 },
960 { "ibm,open-errinjct", -1, -1, -1, -1, -1 },
961 { "ibm,get-config-addr-info2", -1, -1, -1, -1, -1 },
962 { "ibm,get-dynamic-sensor-state", -1, 1, -1, -1, -1 },
963 { "ibm,get-indices", -1, 2, 3, -1, -1 },
964 { "get-power-level", -1, -1, -1, -1, -1 },
965 { "get-sensor-state", -1, -1, -1, -1, -1 },
966 { "ibm,get-system-parameter", -1, 1, 2, -1, -1 },
967 { "get-time-of-day", -1, -1, -1, -1, -1 },
968 { "ibm,get-vpd", -1, 0, -1, 1, 2 },
969 { "ibm,lpar-perftools", -1, 2, 3, -1, -1 },
970 { "ibm,platform-dump", -1, 4, 5, -1, -1 },
971 { "ibm,read-slot-reset-state", -1, -1, -1, -1, -1 },
972 { "ibm,scan-log-dump", -1, 0, 1, -1, -1 },
973 { "ibm,set-dynamic-indicator", -1, 2, -1, -1, -1 },
974 { "ibm,set-eeh-option", -1, -1, -1, -1, -1 },
975 { "set-indicator", -1, -1, -1, -1, -1 },
976 { "set-power-level", -1, -1, -1, -1, -1 },
977 { "set-time-for-power-on", -1, -1, -1, -1, -1 },
978 { "ibm,set-system-parameter", -1, 1, -1, -1, -1 },
979 { "set-time-of-day", -1, -1, -1, -1, -1 },
980 #ifdef CONFIG_CPU_BIG_ENDIAN
981 { "ibm,suspend-me", -1, -1, -1, -1, -1 },
982 { "ibm,update-nodes", -1, 0, -1, -1, -1, 4096 },
983 { "ibm,update-properties", -1, 0, -1, -1, -1, 4096 },
985 { "ibm,physical-attestation", -1, 0, 1, -1, -1 },
988 static bool in_rmo_buf(u32 base
, u32 end
)
990 return base
>= rtas_rmo_buf
&&
991 base
< (rtas_rmo_buf
+ RTAS_RMOBUF_MAX
) &&
993 end
>= rtas_rmo_buf
&&
994 end
< (rtas_rmo_buf
+ RTAS_RMOBUF_MAX
);
997 static bool block_rtas_call(int token
, int nargs
,
998 struct rtas_args
*args
)
1002 for (i
= 0; i
< ARRAY_SIZE(rtas_filters
); i
++) {
1003 struct rtas_filter
*f
= &rtas_filters
[i
];
1004 u32 base
, size
, end
;
1006 if (token
!= f
->token
)
1009 if (f
->buf_idx1
!= -1) {
1010 base
= be32_to_cpu(args
->args
[f
->buf_idx1
]);
1011 if (f
->size_idx1
!= -1)
1012 size
= be32_to_cpu(args
->args
[f
->size_idx1
]);
1013 else if (f
->fixed_size
)
1014 size
= f
->fixed_size
;
1018 end
= base
+ size
- 1;
1019 if (!in_rmo_buf(base
, end
))
1023 if (f
->buf_idx2
!= -1) {
1024 base
= be32_to_cpu(args
->args
[f
->buf_idx2
]);
1025 if (f
->size_idx2
!= -1)
1026 size
= be32_to_cpu(args
->args
[f
->size_idx2
]);
1027 else if (f
->fixed_size
)
1028 size
= f
->fixed_size
;
1031 end
= base
+ size
- 1;
1034 * Special case for ibm,configure-connector where the
1037 if (!strcmp(f
->name
, "ibm,configure-connector") &&
1041 if (!in_rmo_buf(base
, end
))
1049 pr_err_ratelimited("sys_rtas: RTAS call blocked - exploit attempt?\n");
1050 pr_err_ratelimited("sys_rtas: token=0x%x, nargs=%d (called by %s)\n",
1051 token
, nargs
, current
->comm
);
1057 static bool block_rtas_call(int token
, int nargs
,
1058 struct rtas_args
*args
)
1063 #endif /* CONFIG_PPC_RTAS_FILTER */
1065 /* We assume to be passed big endian arguments */
1066 SYSCALL_DEFINE1(rtas
, struct rtas_args __user
*, uargs
)
1068 struct rtas_args args
;
1069 unsigned long flags
;
1070 char *buff_copy
, *errbuf
= NULL
;
1071 int nargs
, nret
, token
;
1073 if (!capable(CAP_SYS_ADMIN
))
1079 if (copy_from_user(&args
, uargs
, 3 * sizeof(u32
)) != 0)
1082 nargs
= be32_to_cpu(args
.nargs
);
1083 nret
= be32_to_cpu(args
.nret
);
1084 token
= be32_to_cpu(args
.token
);
1086 if (nargs
>= ARRAY_SIZE(args
.args
)
1087 || nret
> ARRAY_SIZE(args
.args
)
1088 || nargs
+ nret
> ARRAY_SIZE(args
.args
))
1092 if (copy_from_user(args
.args
, uargs
->args
,
1093 nargs
* sizeof(rtas_arg_t
)) != 0)
1096 if (token
== RTAS_UNKNOWN_SERVICE
)
1099 args
.rets
= &args
.args
[nargs
];
1100 memset(args
.rets
, 0, nret
* sizeof(rtas_arg_t
));
1102 if (block_rtas_call(token
, nargs
, &args
))
1105 /* Need to handle ibm,suspend_me call specially */
1106 if (token
== ibm_suspend_me_token
) {
1109 * rtas_ibm_suspend_me assumes the streamid handle is in cpu
1110 * endian, or at least the hcall within it requires it.
1113 u64 handle
= ((u64
)be32_to_cpu(args
.args
[0]) << 32)
1114 | be32_to_cpu(args
.args
[1]);
1115 rc
= rtas_syscall_dispatch_ibm_suspend_me(handle
);
1117 args
.rets
[0] = cpu_to_be32(RTAS_NOT_SUSPENDABLE
);
1118 else if (rc
== -EIO
)
1119 args
.rets
[0] = cpu_to_be32(-1);
1125 buff_copy
= get_errorlog_buffer();
1127 flags
= lock_rtas();
1130 enter_rtas(__pa(&rtas
.args
));
1133 /* A -1 return code indicates that the last command couldn't
1134 be completed due to a hardware error. */
1135 if (be32_to_cpu(args
.rets
[0]) == -1)
1136 errbuf
= __fetch_rtas_last_error(buff_copy
);
1142 log_error(errbuf
, ERR_TYPE_RTAS_LOG
, 0);
1147 /* Copy out args. */
1148 if (copy_to_user(uargs
->args
+ nargs
,
1150 nret
* sizeof(rtas_arg_t
)) != 0)
1157 * Call early during boot, before mem init, to retrieve the RTAS
1158 * information from the device-tree and allocate the RMO buffer for userland
1161 void __init
rtas_initialize(void)
1163 unsigned long rtas_region
= RTAS_INSTANTIATE_MAX
;
1164 u32 base
, size
, entry
;
1165 int no_base
, no_size
, no_entry
;
1166 #ifdef CONFIG_PPC_RTAS_FILTER
1170 /* Get RTAS dev node and fill up our "rtas" structure with infos
1173 rtas
.dev
= of_find_node_by_name(NULL
, "rtas");
1177 no_base
= of_property_read_u32(rtas
.dev
, "linux,rtas-base", &base
);
1178 no_size
= of_property_read_u32(rtas
.dev
, "rtas-size", &size
);
1179 if (no_base
|| no_size
) {
1180 of_node_put(rtas
.dev
);
1187 no_entry
= of_property_read_u32(rtas
.dev
, "linux,rtas-entry", &entry
);
1188 rtas
.entry
= no_entry
? rtas
.base
: entry
;
1190 /* If RTAS was found, allocate the RMO buffer for it and look for
1191 * the stop-self token if any
1194 if (firmware_has_feature(FW_FEATURE_LPAR
)) {
1195 rtas_region
= min(ppc64_rma_size
, RTAS_INSTANTIATE_MAX
);
1196 ibm_suspend_me_token
= rtas_token("ibm,suspend-me");
1199 rtas_rmo_buf
= memblock_phys_alloc_range(RTAS_RMOBUF_MAX
, PAGE_SIZE
,
1202 panic("ERROR: RTAS: Failed to allocate %lx bytes below %pa\n",
1203 PAGE_SIZE
, &rtas_region
);
1205 #ifdef CONFIG_RTAS_ERROR_LOGGING
1206 rtas_last_error_token
= rtas_token("rtas-last-error");
1209 #ifdef CONFIG_PPC_RTAS_FILTER
1210 for (i
= 0; i
< ARRAY_SIZE(rtas_filters
); i
++) {
1211 rtas_filters
[i
].token
= rtas_token(rtas_filters
[i
].name
);
1216 int __init
early_init_dt_scan_rtas(unsigned long node
,
1217 const char *uname
, int depth
, void *data
)
1219 const u32
*basep
, *entryp
, *sizep
;
1221 if (depth
!= 1 || strcmp(uname
, "rtas") != 0)
1224 basep
= of_get_flat_dt_prop(node
, "linux,rtas-base", NULL
);
1225 entryp
= of_get_flat_dt_prop(node
, "linux,rtas-entry", NULL
);
1226 sizep
= of_get_flat_dt_prop(node
, "rtas-size", NULL
);
1228 if (basep
&& entryp
&& sizep
) {
1230 rtas
.entry
= *entryp
;
1234 #ifdef CONFIG_UDBG_RTAS_CONSOLE
1235 basep
= of_get_flat_dt_prop(node
, "put-term-char", NULL
);
1237 rtas_putchar_token
= *basep
;
1239 basep
= of_get_flat_dt_prop(node
, "get-term-char", NULL
);
1241 rtas_getchar_token
= *basep
;
1243 if (rtas_putchar_token
!= RTAS_UNKNOWN_SERVICE
&&
1244 rtas_getchar_token
!= RTAS_UNKNOWN_SERVICE
)
1245 udbg_init_rtas_console();
1253 static arch_spinlock_t timebase_lock
;
1254 static u64 timebase
= 0;
1256 void rtas_give_timebase(void)
1258 unsigned long flags
;
1260 local_irq_save(flags
);
1262 arch_spin_lock(&timebase_lock
);
1263 rtas_call(rtas_token("freeze-time-base"), 0, 1, NULL
);
1264 timebase
= get_tb();
1265 arch_spin_unlock(&timebase_lock
);
1269 rtas_call(rtas_token("thaw-time-base"), 0, 1, NULL
);
1270 local_irq_restore(flags
);
1273 void rtas_take_timebase(void)
1277 arch_spin_lock(&timebase_lock
);
1278 set_tb(timebase
>> 32, timebase
& 0xffffffff);
1280 arch_spin_unlock(&timebase_lock
);