Document wakeup_one().

This commit is contained in:
mpp 1997-04-09 05:39:32 +00:00
parent 760778bbe9
commit 8b2ae1155b
2 changed files with 15 additions and 3 deletions

View File

@ -1,4 +1,4 @@
# $Id: Makefile,v 1.28 1997/03/22 22:21:36 mpp Exp $
# $Id: Makefile,v 1.29 1997/03/22 23:50:19 mpp Exp $
MAN9= MD5.9 at_shutdown.9 at_fork.9 at_exit.9 boot.9 cd.9 copy.9 \
devfs_add_devswf.9 \
@ -31,7 +31,7 @@ MLINKS+= malloc.9 free.9 malloc.9 MALLOC.9 malloc.9 FREE.9
MLINKS+= mi_switch.9 cpu_switch.9
MLINKS+= psignal.9 pgsignal.9 psignal.9 gsignal.9
MLINKS+= rtalloc.9 rtalloc_ign.9 rtalloc.9 rtalloc1.9
MLINKS+= sleep.9 tsleep.9 sleep.9 wakeup.9
MLINKS+= sleep.9 tsleep.9 sleep.9 wakeup.9 sleep.9 wakeup_one.9
MLINKS+= spl.9 splbio.9 spl.9 splclock.9 spl.9 splhigh.9 spl.9 splimp.9
MLINKS+= spl.9 splnet.9 spl.9 splsoftclock.9 spl.9 splsofttty.9
MLINKS+= spl.9 splstatclock.9 spl.9 spltty.9 spl.9 splvm.9

View File

@ -23,7 +23,7 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.\" $Id$
.\" $Id: sleep.9,v 1.7 1997/02/22 13:26:26 peter Exp $
.\" "
.Dd April 3, 1996
.Os
@ -42,6 +42,8 @@
.Fn tsleep "void *ident" "int priority" "char *wmesg" "int timo"
.Ft void
.Fn wakeup "void *ident"
.Ft void
.Fn wakeup_one "void *ident"
.Ft int
.Fn sleep "void *ident" "int priority"
.Sh DESCRIPTION
@ -69,6 +71,16 @@ is a string describing the sleep condition for tools like
Due to the limited space of those programs to display arbitrary strings,
this message should not be longer than 6 characters.
.Pp
The
.Fn wakeup_one
function is used to make the first process in the queue that is
sleeping on the parameter
.Fa ident
runnable. This can prevent the system from becoming saturated
when a large number of processes are sleeping on the same address,
but only one of them can actually do any useful work when made
runnable.
.Pp
.Nm Tsleep
is the general sleep call. Suspends the current process until a wakeup is
performed on the specified identifier. The process will then be made