[src/trunk]: src/share/man/man9 sync with reality.

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

details:   https://anonhg.NetBSD.org/src/rev/b49c4bbfb735
branches:  trunk
changeset: 550857:b49c4bbfb735
user:      yamt <yamt%NetBSD.org@localhost>
date:      Sat Aug 23 07:21:07 2003 +0000

description:
sync with reality.

diffstat:

 share/man/man9/cpu_exit.9 |  36 ++++++++++++++++++++++++------------
 1 files changed, 24 insertions(+), 12 deletions(-)

diffs (74 lines):

diff -r adc3b989e619 -r b49c4bbfb735 share/man/man9/cpu_exit.9
--- a/share/man/man9/cpu_exit.9 Sat Aug 23 04:15:33 2003 +0000
+++ b/share/man/man9/cpu_exit.9 Sat Aug 23 07:21:07 2003 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: cpu_exit.9,v 1.6 2003/04/16 13:35:26 wiz Exp $
+.\"     $NetBSD: cpu_exit.9,v 1.7 2003/08/23 07:21:07 yamt Exp $
 .\"
 .\" Copyright (c) 2002 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd May 24, 2002
+.Dd August 23, 2003
 .Dt CPU_EXIT 9
 .Os
 .Sh NAME
@@ -43,27 +43,33 @@
 .Sh SYNOPSIS
 .In sys/systm.h
 .Ft void
-.Fn cpu_exit "struct proc *p"
+.Fn cpu_exit "struct lwp *l" "int is_process"
 .Sh DESCRIPTION
 .Fn cpu_exit
 is machine-dependent code invoked by
 .Fn exit1
-as the last action during process exit to switch to a new context
+or
+.Fn lwp_exit
+as the last action during process or lwp exit to switch to a new context
 (possibly the idle context).
 .Fn cpu_exit
-will clean up machine-dependent process state and invoke
+will clean up machine-dependent process state.
+If
+.Fa is_process
+is 0, we're exiting an lwp.  In that case,
+.Fn cpu_exit
+only do lwp-appropriate cleanup.
+.Fn cpu_exit
+will then invoke
 .Fn exit2
-to schedule the old process's u-area and stack to be released by the
+or
+.Fn lwp_exit2
+to schedule the old lwp's u-area and stack to be released by the
 reaper thread.
 .Fn cpu_exit
-will then invoke
+will then invoke an equivalent of
 .Fn cpu_switch
 to wait for another process to wake up.
-.Pp
-Note that
-.Fn cpu_exit
-should be called at
-.Xr splhigh 9 .
 .Sh CODE REFERENCES
 This section describes places within the
 .Nx
@@ -78,5 +84,11 @@
 .Fn exit2
 can be found within the file
 .Pa sys/kern/kern_exit.c .
+.Pp
+.Fn lwp_exit
+and
+.Fn lwp_exit2
+can be found within the file
+.Pa sys/kern/kern_lwp.c .
 .Sh SEE ALSO
 .Xr cpu_switch 9