[src/trunk]: src/share/man/man9 - document RESCHED_KPREEMPT

[yamt <yamt%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/212a382abafb
branches:  trunk
changeset: 770578:212a382abafb
user:      yamt <yamt%NetBSD.org@localhost>
date:      Mon Oct 24 07:30:29 2011 +0000

description:
- document RESCHED_KPREEMPT
- "Specifically" -> "Typically" in the paragraph which says what this
  function can do, because they are merely examples.

diffstat:

 share/man/man9/cpu_need_resched.9 |  15 +++++++++++++--
 1 files changed, 13 insertions(+), 2 deletions(-)

diffs (36 lines):

diff -r 7b236b66daf1 -r 212a382abafb share/man/man9/cpu_need_resched.9
--- a/share/man/man9/cpu_need_resched.9 Mon Oct 24 07:27:09 2011 +0000
+++ b/share/man/man9/cpu_need_resched.9 Mon Oct 24 07:30:29 2011 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: cpu_need_resched.9,v 1.8 2010/07/31 02:12:20 jruoho Exp $
+.\"     $NetBSD: cpu_need_resched.9,v 1.9 2011/10/24 07:30:29 yamt Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -49,6 +49,17 @@
 queue or if the current LWP has exceeded its time slice.
 .Pp
 If
+.Dv RESCHED_KPREEMPT
+flag is specified in
+.Fa flags
+and
+.Dv __HAVE_PREEMPTION
+C pre-processor macro is defined in
+.In machine/intr.h ,
+machine-dependent code should make a context switch happen as soon as possible
+even if the cpu is running the kernel code.
+.Pp
+If
 .Dv RESCHED_IMMED
 flag is specified in
 .Fa flags ,
@@ -60,7 +71,7 @@
 typically issues an inter processor call to the processor to make it
 notice the need of a context switch as soon as possible.
 .Pp
-Specifically, the
+Typically, the
 .Fn cpu_need_resched
 function will perform the following operations:
 .Bl -bullet -offset indent