svn commit: r185117 - user/lstewart/misc_8.x/share/man/man9

[Lawrence Stewart]

Author: lstewart
Date: Thu Nov 20 04:11:21 2008
New Revision: 185117
URL: http://svn.freebsd.org/changeset/base/185117

Log:
  In light of recent discussions regarding the kthread(9)/kproc(9) KPI, clairfy
  the behaviour of kthread_exit(). Whilst we're here, remove some bogus man page
  references.

Modified:
  user/lstewart/misc_8.x/share/man/man9/kproc.9
  user/lstewart/misc_8.x/share/man/man9/kthread.9

Modified: user/lstewart/misc_8.x/share/man/man9/kproc.9
==============================================================================
--- user/lstewart/misc_8.x/share/man/man9/kproc.9	Thu Nov 20 04:04:22 2008	(r185116)
+++ user/lstewart/misc_8.x/share/man/man9/kproc.9	Thu Nov 20 04:11:21 2008	(r185117)
@@ -157,11 +157,17 @@ letting the main function return to its 
 The
 .Fa ecode
 argument specifies the exit status of the process.
-While exiting, the function
-.Xr exit1 9
-will initiate a call to
+While exiting, the function will call
 .Xr wakeup 9
-on the process handle.
+on the calling process's handle.
+If another thread/process needs to wait for the calling process to exit,
+.Xr mtx_sleep 9
+can be used in the waiting thread/process with the
+.Fa chan
+argument set to the exiting process's handle.
+This will put the waiting thread/process to sleep until the exiting process
+has made its final call to
+.Fn kproc_exit .
 .Pp
 The
 .Fn kproc_resume ,
@@ -332,9 +338,8 @@ parameter.
 .El
 .Sh SEE ALSO
 .Xr rfork 2 ,
-.Xr exit1 9 ,
 .Xr kthread 9 ,
-.Xr SYSINIT 9 ,
+.Xr mtx_sleep 9 ,
 .Xr wakeup 9
 .Sh HISTORY
 The

Modified: user/lstewart/misc_8.x/share/man/man9/kthread.9
==============================================================================
--- user/lstewart/misc_8.x/share/man/man9/kthread.9	Thu Nov 20 04:04:22 2008	(r185116)
+++ user/lstewart/misc_8.x/share/man/man9/kthread.9	Thu Nov 20 04:11:21 2008	(r185117)
@@ -171,7 +171,17 @@ The
 function is used to terminate kernel threads.
 It should be called by the main function of the kernel thread rather than
 letting the main function return to its caller.
-.\" XXX "int ecode" argument isn't documented.
+While exiting, the function will call
+.Xr wakeup 9
+on the calling thread's handle.
+If another thread/process needs to wait for the calling thread to exit,
+.Xr mtx_sleep 9
+can be used in the waiting thread/process with the
+.Fa chan
+argument set to the exiting thread's handle.
+This will put the waiting thread/process to sleep until the exiting thread
+has made its final call to
+.Fn kthread_exit .
 .Pp
 The
 .Fn kthread_resume ,
@@ -290,9 +300,8 @@ parameter.
 .El
 .Sh SEE ALSO
 .Xr rfork 2 ,
-.Xr exit1 9 ,
 .Xr kproc 9 ,
-.Xr SYSINIT 9 ,
+.Xr mtx_sleep 9 ,
 .Xr wakeup 9
 .Sh HISTORY
 The