Document wakeup_one().

This commit is contained in:
Mike Pritchard 1997-04-09 05:39:32 +00:00
parent fa10160c65
commit db0ed86298
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=24737
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