renegade-project/linux-next
2
0
Fork 0
mirror of https://github.com/edk2-porting/linux-next.git synced 2024-12-23 04:34:11 +08:00
Code

powerpc/rtas: improve ppc_rtas_rmo_buf_show documentation

Browse Source 
Add kerneldoc for ppc_rtas_rmo_buf_show(), the callback for
/proc/powerpc/rtas/rmo_buffer, explaining its expected use.

Signed-off-by: Nathan Lynch <nathanl@linux.ibm.com>
Reviewed-by: Alexey Kardashevskiy <aik@ozlabs.ru>
Reviewed-by: Andrew Donnellan <ajd@linux.ibm.com>
Signed-off-by: Michael Ellerman <mpe@ellerman.id.au>
Link: https://lore.kernel.org/r/20210408140630.205502-2-nathanl@linux.ibm.com
This commit is contained in:
Nathan Lynch 2021-04-08 09:06:26 -05:00 committed by Michael Ellerman
parent 5ae5bc12d0
commit c13ff6f325
1 changed files with 10 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
arch/powerpc/kernel/rtas-proc.c
View File

@ -757,7 +757,16 @@ static int ppc_rtas_tone_volume_show(struct seq_file *m, void *v)
#define RMO_READ_BUF_MAX 30 #define RMO_READ_BUF_MAX 30
/* RTAS Userspace access */ /**
* ppc_rtas_rmo_buf_show() - Describe RTAS-addressable region for user space.
*
* Base + size description of a range of RTAS-addressable memory set
* aside for user space to use as work area(s) for certain RTAS
* functions. User space accesses this region via /dev/mem. Apart from
* security policies, the kernel does not arbitrate or serialize
* access to this region, and user space must ensure that concurrent
* users do not interfere with each other.
*/
static int ppc_rtas_rmo_buf_show(struct seq_file *m, void *v) static int ppc_rtas_rmo_buf_show(struct seq_file *m, void *v)
{ {
seq_printf(m, "%016lx %x\n", rtas_rmo_buf, RTAS_RMOBUF_MAX); seq_printf(m, "%016lx %x\n", rtas_rmo_buf, RTAS_RMOBUF_MAX);