6.16.3 osenv_wakeup: wake up a sleeping process

 

SYNOPSIS

#include <oskit/dev/dev.h>

void osenv_wakeup(osenv_sleeprec_t *sleeprec, int wakeup_status);

DIRECTION

Component OS, Nonblocking

DESCRIPTION

The driver calls this function to wake up a process-level activity that has gone to sleep (or is preparing to go to sleep) waiting on some event. The value of wakeup_status is subsequently returned to the caller of osenv_sleep, making it possible to indicate various wakeup conditions (such as abnormal termination). It is harmless to wake up a process that has already been woken.

PARAMETERS

sleeprec

A pointer to the sleep record of the process to wake up. Must actually point to a valid sleep record variable that has been properly initialized using osenv_sleep_init.

wakeup_status

The status to be returned from osenv_sleep. OSKIT_WAKEUP indicates normal wakeup, while other status values indicate other conditions.