# C Programming/POSIX Reference/unistd.h/sleep

A computer program (process, task, or thread) may sleep, which places it into an inactive state for a period of time. Eventually the expiration of an interval timer, or the receipt of a signal or interrupt causes the program to resume execution.

## Usage

A typical sleep system call takes a time value as a parameter, specifying the minimum amount of time that the process is to sleep before resuming execution. The parameter typically specifies seconds, although some operating systems provide finer resolution, such as milliseconds or microseconds.

### Windows

On Windows 2000 and newer, the Sleep function takes a single parameter of the number of milliseconds to sleep.
The sleep function is included in the kernel32.dll, but no sleep command (executable) is natively available for scripts (batch files). It can be found in collections of Windows utilities like Windows 2003 Resource Kit.

### Unix

On Unix-like operating systems, the sleep function is called providing a single parameter of type unsigned integer of the number of seconds to sleep. (For more precise sleep times one can use the usleep function.)

### C examples

In Windows OS:
In Unix:

## Low level functionality

Sleep causes the thread or process to enter the Not Runnable state. This allows the CPU to suspend the thread or process and continue executing other threads or processes until the sleep has finished, and the thread or process is allowed to continue executing. On Windows systems the sleep system call is non-interruptible, which differs from Wait and SleepEx system calls, which can be interrupted. However, some functions labeled sleep are alterable by design. On Unix system signals interrupt system calls, including sleep. Sleep often leads to poor code design and the wait or nanosleep functions are preferable.

## Uses

Some system programs that never terminate execute an event loop, going to sleep at the start of each cycle and waiting for some event to awaken them. Once an event is received, the program services the event, then returns to the beginning of the next wait cycle.
Other programs periodically poll for events by going to sleep and resuming execution after a specific interval of time. Once execution is resumed, the program polls for events or status changes, and then services any that occurred while it was asleep. After servicing the events, the program then goes to sleep again for the next time interval. Certain kinds of heartbeat events or keep-alive signals can be generated by these kinds of programs.

### Uninterruptible sleep

An uninterruptible sleep state is a sleep state that won't handle a signal right away. It will wake only as a result of a waited-upon resource becoming available or after a time-out occurs during that wait (if specified when put to sleep). It is mostly used by device drivers waiting for disk or network IO (input/output).
When the process is sleeping uninterruptibly, signals accumulated during the sleep will be noticed when the process returns from the system call or trap.
In Unix-like systems the command 'ps -l' uses code "D" for the uninterruptible sleep state of a process.

## See also

* Signal
* System time
* Unix sleep command
* Sleep mode
* Wait

## References

* ↑ MSDN Library Reference - Sleep
* ↑ batch file sleep command
* ↑ UNIX Man Page - SLEEP(3)
* ↑ UNIX Man Page - usleep(3)
* ↑ Sleep vs. Wait (1)
* ↑ Sleep vs. Wait (2)
* ↑ SleepEx MSDN
* ↑ sleep(3) Linux man Page