← All commands
THE COMMAND REFERENCE

sleep

Pause for a given time.

Last updated

BusyBox

Implementation-level reference; examples are not certified for every installed version.

Overview

sleep does nothing for the number of seconds you give, and then exits. Scripts use it to wait between tries, to space out requests or to give a service time to start. It prints nothing.

Background

A sleep command appeared in Version 4 AT&T UNIX, according to the macOS manual, which also says support for non-integer intervals and for units other than seconds is an extension. Today the name covers GNU sleep, the sleep that macOS ships, and the sleep applet in BusyBox. They agree on a number of seconds.

Examples

Wait one second, then print a message:

sleep 1 && echo done

Wait zero seconds, which returns at once:

sleep 0 && echo ok

Wait between steps in a loop:

for i in 1 2; do echo "step $i"; sleep 1; done

Run something after a delay, in the background, and wait for it:

(sleep 1; echo later) & wait

Common mistakes

sleep 1 waits at least a second, not exactly one, and a script that must match a clock should compare times instead. A fractional value such as 0.5 or a suffix such as 1m works on many systems but not all, so keep to whole seconds in portable scripts. Waiting in a loop for a service is fragile; check for the service itself, for example by trying it, rather than assuming a fixed delay is enough.

Portability

Only whole seconds are in the Common examples. GNU accepts s, m, h and d suffixes and fractions, the macOS release tested accepts them too, and BusyBox accepts them when it is built with the fancy sleep option. The Common examples were executed on GNU coreutils 9.11, macOS system tools, and BusyBox 1.37.0 (see the development guide for the exact check).

About BusyBox sleep

BusyBox bundles sleep as an applet, and anything beyond the common options depends on how it was built. This page's examples ran on BusyBox 1.37.0.

BusyBox notes

BusyBox sleep accepts whole seconds; fractions and suffixes depend on the build.

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.