WAIT.2
上传用户:datang2001
上传日期:2007-02-01
资源大小:53269k
文件大小:4k
源码类别:

操作系统开发

开发平台:

C/C++

  1. WAIT(2)                   Minix Programmer's Manual                    WAIT(2)
  2. NAME
  3.      wait, waitpid - wait for process to terminate
  4. SYNOPSIS
  5.      #include <sys/types.h>
  6.      #include <sys/wait.h>
  7.      pid_t wait(int *status)
  8.      pid_t waitpid(pid_t pid, int *status, int options)
  9. DESCRIPTION
  10.      Wait causes its caller to delay until a signal is received or one of  its
  11.      child  processes  terminates.  If any child has died since the last wait,
  12.      return is immediate, returning the process id and exit status of  one  of
  13.      the  terminated  children.  If there are no children, return is immediate
  14.      with the value -1 returned.
  15.      On return from a successful wait call, status is nonzero,  and  the  high
  16.      byte  of status contains the low byte of the argument to exit supplied by
  17.      the child process; the low byte of status contains the termination status
  18.      of the process.  A more precise definition of the status word is given in
  19.      <sys/wait.h>.  If wait  can  called  with  a  null  pointer  argument  to
  20.      indicate that no status need be returned.
  21.      Waitpid provides an alternate interface for programs that must not  block
  22.      when  collecting  the status of child processes, or that wish to wait for
  23.      one particular child.  The pid parameter is the process ID of  the  child
  24.      to wait for, -1 for any child.  The status parameter is defined as above.
  25.      The options parameter is used to indicate the call should  not  block  if
  26.      there  are no processes that wish to report status (WNOHANG), and/or that
  27.      children of the current process  that  are  stopped  due  to  a  SIGTTIN,
  28.      SIGTTOU,  SIGTSTP,  or  SIGSTOP  signal  should  also  have  their status
  29.      reported (WUNTRACED).  (Job control is not  implemented  for  Minix,  but
  30.      these symbold and signals are.)
  31.      When the WNOHANG option is specified and  no  processes  wish  to  report
  32.      status,  waitpid  returns  -1  with errno set to EAGAIN.  The WNOHANG and
  33.      WUNTRACED options may be combined by or'ing the two values.
  34. NOTES
  35.      The call wait(&status) is equivalent to waitpid(-1, &status, 0).
  36.      See sigaction(2) for a list of termination statuses (signals);  0  status
  37.      indicates  normal termination.  A special status (0177) is returned for a
  38.      stopped process that  has  not  terminated  and  can  be  restarted;  see
  39.      ptrace(2).   If  the  0200  bit  of the termination status is set, a core
  40.      image of the process was produced by the system.
  41. 4BSD                              June 30, 1985                              1
  42. WAIT(2)                   Minix Programmer's Manual                    WAIT(2)
  43.      If the parent process terminates without waiting  on  its  children,  the
  44.      initialization process (process ID = 1) inherits the children.
  45.      <sys/wait.h> defines a number of macros that operate on a status word:
  46.      WIFEXITED(status)
  47.           True if normal exit.
  48.      WEXITSTATUS(status)
  49.           Exit  status  if  the  process  returned  by  a  normal  exit,  zero
  50.           otherwise.
  51.      WTERMSIG(status)
  52.           Signal number if the process died by a signal, zero otherwise.
  53.      WIFSIGNALED(status)
  54.           True if the process died by a signal.
  55.      WIFSTOPPED(status)
  56.           True if the process is stopped.  (Never true under Minix.)
  57.      WSTOPSIG(status)
  58.           Signal number of the signal that stopped the process.
  59. RETURN VALUE
  60.      If wait returns due to a stopped or terminated child process, the process
  61.      ID  of  the child is returned to the calling process.  Otherwise, a value
  62.      of -1 is returned and errno is set to indicate the error.
  63.      Waitpid returns -1 if there are no children not previously waited for, if
  64.      the  process  that  it  wants to wait for doesn't exist, or if WNOHANG is
  65.      specified and there are no stopped or exited children.
  66. ERRORS
  67.      Wait will fail and return immediately if one or more of the following are
  68.      true:
  69.      [ECHILD]       The calling process has  no  existing  unwaited-for  child
  70.                     processes.
  71.      [EFAULT]       The status argument points to an illegal address.
  72.      [EAGAIN]       Waitpid is called with the WNOHANG option and no child has
  73.                     exited yet.
  74. SEE ALSO
  75.      execve(2), exit(2), sigaction(2).
  76. 4BSD                              June 30, 1985                              2