Wait for an arbitrary process.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

71 lines
1.5 KiB

8 years ago
8 years ago
8 years ago
8 years ago
8 years ago
  1. .TH WAIT 1 2013-03-23 "wait4 @PACKAGE_VERSION]" "wait4 Manual"
  2. .SH NAME
  3. wait4 \- Wait for arbitrary processes
  4. .SH SYNOPSIS
  5. .SY wait4
  6. .RB [ \-h | --help ]
  7. .RB [ \-v | --version ]
  8. .RB [ \-t | --timeout
  9. .IR time ]
  10. .IR pid ...
  11. .YS
  12. .SH DESCRIPTION
  13. .PP
  14. .B wait4
  15. waits for the process(es) identified by the specified PID(s)
  16. to terminate, and reports the termination status of the
  17. process whose PID is specified last.
  18. .SH OPTIONS
  19. .TP
  20. .BR -h ", " --help
  21. Display the help message.
  22. .TP
  23. .BR -v ", " --version
  24. Display the version message.
  25. .TP
  26. .BR -t ", " --timeout " " \fItime\fR
  27. Aborts waiting after the specified
  28. .I time
  29. (in seconds).
  30. .SH NOTES
  31. .PP
  32. .B wait4
  33. depends on the
  34. .BR netlink (7)
  35. interface or the
  36. .BR kevent (2)
  37. system call to fulfill its function properly. On systems
  38. which do not have any of these, a fallback
  39. .BR kill (2)-based
  40. mechanism is used, which suffers from the following
  41. limitations: it does not allow to retrieve the termination
  42. status, and thus
  43. .B wait4
  44. will always return 0; and it can miss the termination of a
  45. process, if its PID gets reused too quickly by a new process.
  46. .PP
  47. When using
  48. .BR netlink (7),
  49. the number of processes to wait for cannot be greater than 251.
  50. .SH REPORTING BUGS
  51. .PP
  52. Report bugs to
  53. .MT @PACKAGE_BUGREPORT@
  54. Damien Goutte-Gattat
  55. .ME .
  56. .SH COPYRIGHT
  57. .ad l
  58. .PP
  59. Copyright \(co 2013 Damien Goutte-Gattat
  60. .PP
  61. This program is released under the GNU General Public License.
  62. See the COPYING file in the source distribution or
  63. .UR http://www.gnu.org/licenses/gpl.html
  64. .UE .