logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

sys_wait.h.0p (3691B)


  1. '\" et
  2. .TH sys_wait.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. sys/wait.h
  12. \(em declarations for waiting
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. #include <sys/wait.h>
  17. .fi
  18. .SH DESCRIPTION
  19. The
  20. .IR <sys/wait.h>
  21. header shall define the following symbolic constants for use with
  22. \fIwaitpid\fR():
  23. .IP WCONTINUED 14
  24. Report status of continued child process.
  25. .IP WNOHANG 14
  26. Do not hang if no status is available; return immediately.
  27. .IP WUNTRACED 14
  28. Report status of stopped child process.
  29. .P
  30. The
  31. .IR <sys/wait.h>
  32. header shall define the following macros for analysis of process status
  33. values:
  34. .IP WEXITSTATUS 14
  35. Return exit status.
  36. .IP WIFCONTINUED 14
  37. True if child has been continued.
  38. .IP WIFEXITED 14
  39. True if child exited normally.
  40. .IP WIFSIGNALED 14
  41. True if child exited due to uncaught signal.
  42. .IP WIFSTOPPED 14
  43. True if child is currently stopped.
  44. .IP WSTOPSIG 14
  45. Return signal number that caused process to stop.
  46. .IP WTERMSIG 14
  47. Return signal number that caused process to terminate.
  48. .P
  49. The
  50. .IR <sys/wait.h>
  51. header shall define the following symbolic constants as possible values
  52. for the
  53. .IR options
  54. argument to
  55. \fIwaitid\fR():
  56. .IP WEXITED 14
  57. Wait for processes that have exited.
  58. .IP WNOWAIT 14
  59. Keep the process whose status is returned in
  60. .IR infop
  61. in a waitable state.
  62. .IP WSTOPPED 14
  63. Status is returned for any child that has stopped upon receipt of a
  64. signal.
  65. .P
  66. The
  67. WCONTINUED
  68. and WNOHANG constants, described above for
  69. \fIwaitpid\fR(),
  70. can also be used with
  71. \fIwaitid\fR().
  72. .P
  73. The type
  74. .BR idtype_t
  75. shall be defined as an enumeration type whose possible values shall
  76. include at least the following:
  77. P_ALL
  78. P_PGID
  79. P_PID
  80. .P
  81. The
  82. .IR <sys/wait.h>
  83. header shall define the
  84. .BR id_t
  85. and
  86. .BR pid_t
  87. types as described in
  88. .IR <sys/types.h> .
  89. .P
  90. The
  91. .IR <sys/wait.h>
  92. header shall define the
  93. .BR siginfo_t
  94. type and the
  95. .BR sigval
  96. union as described in
  97. .IR <signal.h> .
  98. .P
  99. Inclusion of the
  100. .IR <sys/wait.h>
  101. header may also make visible
  102. all symbols from
  103. .IR <signal.h> .
  104. .P
  105. The following shall be declared as functions and may also be defined
  106. as macros. Function prototypes shall be provided.
  107. .sp
  108. .RS 4
  109. .nf
  110. pid_t wait(int *);
  111. int waitid(idtype_t, id_t, siginfo_t *, int);
  112. pid_t waitpid(pid_t, int *, int);
  113. .fi
  114. .P
  115. .RE
  116. .LP
  117. .IR "The following sections are informative."
  118. .SH "APPLICATION USAGE"
  119. None.
  120. .SH RATIONALE
  121. None.
  122. .SH "FUTURE DIRECTIONS"
  123. None.
  124. .SH "SEE ALSO"
  125. .IR "\fB<signal.h>\fP",
  126. .IR "\fB<sys_resource.h>\fP",
  127. .IR "\fB<sys_types.h>\fP"
  128. .P
  129. The System Interfaces volume of POSIX.1\(hy2017,
  130. .IR "\fIwait\fR\^(\|)",
  131. .IR "\fIwaitid\fR\^(\|)"
  132. .\"
  133. .SH COPYRIGHT
  134. Portions of this text are reprinted and reproduced in electronic form
  135. from IEEE Std 1003.1-2017, Standard for Information Technology
  136. -- Portable Operating System Interface (POSIX), The Open Group Base
  137. Specifications Issue 7, 2018 Edition,
  138. Copyright (C) 2018 by the Institute of
  139. Electrical and Electronics Engineers, Inc and The Open Group.
  140. In the event of any discrepancy between this version and the original IEEE and
  141. The Open Group Standard, the original IEEE and The Open Group Standard
  142. is the referee document. The original Standard can be obtained online at
  143. http://www.opengroup.org/unix/online.html .
  144. .PP
  145. Any typographical or formatting errors that appear
  146. in this page are most likely
  147. to have been introduced during the conversion of the source files to
  148. man page format. To report such errors, see
  149. https://www.kernel.org/doc/man-pages/reporting_bugs.html .