uprobes/core: Clean up, refactor and improve the code

Make the uprobes code readable to me:

 - improve the Kconfig text so that a mere mortal gets some idea
   what CONFIG_UPROBES=y is really about

 - do trivial renames to standardize around the uprobes_*() namespace

 - clean up and simplify various code flow details

 - separate basic blocks of functionality

 - line break artifact and white space related removal

 - use standard local varible definition blocks

 - use vertical spacing to make things more readable

 - remove unnecessary volatile

 - restructure comment blocks to make them more uniform and
   more readable in general

Cc: Srikar Dronamraju <srikar@linux.vnet.ibm.com>
Cc: Jim Keniston <jkenisto@us.ibm.com>
Cc: Peter Zijlstra <a.p.zijlstra@chello.nl>
Cc: Oleg Nesterov <oleg@redhat.com>
Cc: Masami Hiramatsu <masami.hiramatsu.pt@hitachi.com>
Cc: Arnaldo Carvalho de Melo <acme@infradead.org>
Cc: Anton Arapov <anton@redhat.com>
Cc: Ananth N Mavinakayanahalli <ananth@in.ibm.com>
Link: http://lkml.kernel.org/n/tip-ewbwhb8o6navvllsauu7k07p@git.kernel.org
Signed-off-by: Ingo Molnar <mingo@elte.hu>

1 files changed, 10 insertions, 4 deletions

diff --git a/arch/Kconfig b/arch/Kconfig
index 284f5898f526..cca5b545d806 100644
--- a/arch/Kconfig
+++ b/arch/Kconfig
@@ -66,13 +66,19 @@ config OPTPROBES
         depends on !PREEMPT
 
 config UPROBES
-        bool "User-space probes (EXPERIMENTAL)"
+        bool "Transparent user-space probes (EXPERIMENTAL)"
         depends on ARCH_SUPPORTS_UPROBES
         default n
         help
-          Uprobes enables kernel subsystems to establish probepoints
-          in user applications and execute handler functions when
-          the probepoints are hit.
+          Uprobes is the user-space counterpart to kprobes: they
+          enable instrumentation applications (such as 'perf probe')
+          to establish unintrusive probes in user-space binaries and
+          libraries, by executing handler functions when the probes
+          are hit by user-space applications.
+
+          ( These probes come in the form of single-byte breakpoints,
+            managed by the kernel and kept transparent to the probed
+            application. )
 
           If in doubt, say "N".