开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 操作系统开发 > 查看源码
WAIT.2
资源名称：os_source.zip　[点击查看]
上传用户：datang2001
上传日期：2007-02-01
资源大小：53269k
文件大小：4k
源码类别：

操作系统开发

开发平台：

C/C++

WAIT.2：源码内容
  1. ." Copyright (c) 1980 Regents of the University of California.
  2. ." All rights reserved.  The Berkeley software License Agreement
  3. ." specifies the terms and conditions for redistribution.
  4. ."
  5. ." @(#)wait.2 6.2 (Berkeley) 6/30/85
  6. ."
  7. .TH WAIT 2 "June 30, 1985"
  8. .UC 4
  9. .SH NAME
  10. wait, waitpid - wait for process to terminate
  11. .SH SYNOPSIS
  12. .ft B
  13. .nf
  14. #include <sys/types.h>
  15. #include <sys/wait.h>
  17. pid_t wait(int *fIstatusfP)
  18. pid_t waitpid(pid_t fIpidfP, int *fIstatusfP, int fIoptionsfP)
  19. .fi
  20. .SH DESCRIPTION
  21. .B Wait
  22. causes its caller to delay until a signal is received or
  23. one of its child
  24. processes terminates.
  25. If any child has died since the last
  26. .BR wait ,
  27. return is immediate, returning the process id and
  28. exit status of one of the terminated
  29. children.
  30. If there are no children, return is immediate with
  31. the value -1 returned.
  32. .PP
  33. On return from a successful 
  34. .B wait
  35. call, 
  36. .I status
  37. is nonzero, and the high byte of 
  38. .I status
  39. contains the low byte of the argument to
  40. .B exit
  41. supplied by the child process;
  42. the low byte of 
  43. .I status
  44. contains the termination status of the process.
  45. A more precise definition of the
  46. .I status
  47. word is given in
  48. .RI < sys/wait.h >.
  49. If
  50. .B wait
  51. can called with a null pointer argument to indicate that no status need
  52. be returned.
  53. .PP
  54. .B Waitpid
  55. provides an alternate interface for programs
  56. that must not block when collecting the status
  57. of child processes, or that wish to wait for
  58. one particular child.  The pid parameter is
  59. the process ID of the child to wait for, -1
  60. for any child.  The
  61. .I status
  62. parameter is defined as above.  The
  63. .I options
  64. parameter is used to indicate the call should not block if
  65. there are no processes that wish to report status (WNOHANG),
  66. and/or that children of the current process that are stopped
  67. due to a SIGTTIN, SIGTTOU, SIGTSTP, or SIGSTOP signal should also have
  68. their status reported (WUNTRACED).  (Job control is not implemented for
  69. Minix, but these symbold and signals are.)
  70. .PP
  71. When the WNOHANG option is specified and no processes
  72. wish to report status, 
  73. .B waitpid
  74. returns -1 with
  75. .B errno
  76. set to
  77. .BR EAGAIN .
  78. The WNOHANG and WUNTRACED options may be combined by 
  79. .IR or 'ing
  80. the two values.
  81. .SH NOTES
  82. The call
  83. .BI "wait(&" status ")"
  84. is equivalent to
  85. .BI "waitpid(-1, &" status ", 0)fR."
  86. .PP
  87. See
  88. .BR sigaction (2)
  89. for a list of termination statuses (signals);
  90. 0 status indicates normal termination.
  91. A special status (0177) is returned for a stopped process
  92. that has not terminated and can be restarted;
  93. see
  94. .BR ptrace (2).
  95. If the 0200 bit of the termination status
  96. is set,
  97. a core image of the process was produced
  98. by the system.
  99. .PP
  100. If the parent process terminates without
  101. waiting on its children,
  102. the initialization process
  103. (process ID = 1)
  104. inherits the children.
  105. .PP
  106. .I <sys/wait.h>
  107. defines a number of macros that operate on a status word:
  108. .TP 5
  109. .BI "WIFEXITED(" status ")"
  110. True if normal exit.
  111. .TP 5
  112. .BI "WEXITSTATUS(" status ")"
  113. Exit status if the process returned by a normal exit, zero otherwise.
  114. .TP 5
  115. .BI "WTERMSIG(" status ")"
  116. Signal number if the process died by a signal, zero otherwise.
  117. .TP 5
  118. .BI "WIFSIGNALED(" status ")"
  119. True if the process died by a signal.
  120. .TP 5
  121. .BI "WIFSTOPPED(" status ")"
  122. True if the process is stopped.  (Never true under Minix.)
  123. .TP 5
  124. .BI "WSTOPSIG(" status ")"
  125. Signal number of the signal that stopped the process.
  126. .SH "RETURN VALUE
  127. If fBwaitfP returns due to a stopped
  128. or terminated child process, the process ID of the child
  129. is returned to the calling process.  Otherwise, a value of -1
  130. is returned and fBerrnofP is set to indicate the error.
  131. .PP
  132. .B Waitpid
  133. returns -1 if there are no children not previously waited for, if
  134. the process that it wants to wait for doesn't exist, or if
  135. WNOHANG is specified and there are no stopped or exited children.
  136. .SH ERRORS
  137. .B Wait
  138. will fail and return immediately if one or more of the following
  139. are true:
  140. .TP 15
  141. [ECHILD]
  142. The calling process has no existing unwaited-for
  143. child processes.
  144. .TP 15
  145. [EFAULT]
  146. The fIstatusfP argument points to an illegal address.
  147. .TP 15
  148. [EAGAIN]
  149. .B Waitpid
  150. is called with the WNOHANG option and no child has exited yet.
  151. .SH "SEE ALSO"
  152. .BR execve (2),
  153. .BR exit (2),
  154. .BR sigaction (2).