pause(3)

pause3

Stop until signal

Usage

#include <unistd.h>

int

pause(void);

Library

Standard C Library (libc, -lc)

Overview

Pause is made obsolete by sigsuspend(2).

The pause() function forces a process to pause until a signal is received from either the kill(2) function or an interval timer. (See setitimer(2).) Upon termination of a signal handler started during a pause(), the pause() call will return.

Return values

Always returns -1.

Errors

The pause() function always returns:

[EINTR]

The call was interrupted.

Releases

87 releases since FreeBSD 2.0.5-RELEASE; the text changed 46 times.

  1. 2.0.5–2.1.7.1
  2. 2.2.2–2.2.8
  3. 2.2.9
  4. 3.0–3.2
  5. 3.3–3.4
  6. 3.5–3.5.1
  7. 4.0
  8. 4.1–4.2
  9. 4.3
  10. 4.4
  11. 4.5–4.11
  12. 5.0–6.3
  13. 6.4
  14. 7.0
  15. 7.1
  16. 7.2
  17. 7.3
  18. 7.4
  19. 8.0
  20. 8.1
  21. 8.2
  22. 8.3
  23. 8.4
  24. 9.0
  25. 9.1
  26. 9.2
  27. 9.3
  28. 10.0
  29. 10.1
  30. 10.2
  31. 10.3
  32. 10.4
  33. 11.0
  34. 11.1
  35. 11.2
  36. 11.3
  37. 11.4
  38. 12.0
  39. 12.1
  40. 12.2
  41. 12.3
  42. 12.4
  43. 13.0–13.1
  44. 13.2
  45. 13.3–14.5
  46. 15.0
  47. 15.1–16.0

History

A pause() system call first appeared in the Programmer's Workbench (PWB/UNIX) and was then ported to Version 7 AT&T UNIX. It was reimplemented as a wrapper around the sigpause() and sigblock() system calls in 4.2BSD, and around the sigsuspend(2) and sigprocmask(2) system calls in 4.3BSD-Reno.

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.