From: Thomas Meyer <thomas@m3y3r.de>
Date: Wed, 5 Jul 2017 22:34:04 +0000 (+0200)
Subject: um: Add kerneldoc for segv_handler
X-Git-Url: https://git.stricted.de/?a=commitdiff_plain;h=88af23381ac3a04e35974d9ece422c2b6ebe7775;p=GitHub%2Fmoto-9609%2Fandroid_kernel_motorola_exynos9610.git

um: Add kerneldoc for segv_handler

Signed-off-by: Thomas Meyer <thomas@m3y3r.de>
Signed-off-by: Richard Weinberger <richard@nod.at>
---

diff --git a/arch/um/kernel/trap.c b/arch/um/kernel/trap.c
index 59158871b9fc..4e6fcb32620f 100644
--- a/arch/um/kernel/trap.c
+++ b/arch/um/kernel/trap.c
@@ -183,6 +183,16 @@ void fatal_sigsegv(void)
 	os_dump_core();
 }
 
+/**
+ * segv_handler() - the SIGSEGV handler
+ * @sig:	the signal number
+ * @unused_si:	the signal info struct; unused in this handler
+ * @regs:	the ptrace register information
+ *
+ * The handler first extracts the faultinfo from the UML ptrace regs struct.
+ * If the userfault did not happen in an UML userspace process, bad_segv is called.
+ * Otherwise the signal did happen in a cloned userspace process, handle it.
+ */
 void segv_handler(int sig, struct siginfo *unused_si, struct uml_pt_regs *regs)
 {
 	struct faultinfo * fi = UPT_FAULTINFO(regs);