subprocess.h

Go to the documentation of this file.

// Copyright 2012 Google Inc. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
 
#ifndef NINJA_SUBPROCESS_H_
#define NINJA_SUBPROCESS_H_
 
#include <string>
#include <vector>
#include <queue>
 
#ifdef _WIN32
#include <windows.h>
#else
#include <signal.h>
#endif
 
// ppoll() exists on FreeBSD, but only on newer versions.
#ifdef __FreeBSD__
#  include <sys/param.h>
#  if defined USE_PPOLL && __FreeBSD_version < 1002000
#    undef USE_PPOLL
#  endif
#endif
 
#include "exit_status.h"
 
/// Subprocess wraps a single async subprocess.  It is entirely
/// passive: it expects the caller to notify it when its fds are ready
/// for reading, as well as call Finish() to reap the child once done()
/// is true.
struct Subprocess {
  ~Subprocess();
 
  /// Returns ExitSuccess on successful process exit, ExitInterrupted if
  /// the process was interrupted, ExitFailure if it otherwise failed.
  ExitStatus Finish();
 
  bool Done() const;
 
  const std::string& GetOutput() const;
 
 private:
  Subprocess(bool use_console);
  bool Start(struct SubprocessSet* set, const std::string& command);
  void OnPipeReady();
 
  std::string buf_;
 
#ifdef _WIN32
  /// Set up pipe_ as the parent-side pipe of the subprocess; return the
  /// other end of the pipe, usable in the child process.
  HANDLE SetupPipe(HANDLE ioport);
 
  HANDLE child_;
  HANDLE pipe_;
  OVERLAPPED overlapped_;
  char overlapped_buf_[4 << 10];
  bool is_reading_;
#else
  /// The file descriptor that will be used in ppoll/pselect() for this process,
  /// if any. Otherwise -1.
  /// In non-console mode, this is the read-side of a pipe that was created
  /// specifically for this subprocess. The write-side of the pipe is given to
  /// the subprocess as combined stdout and stderr.
  /// In console mode no pipe is created: fd_ is -1, and process termination is
  /// detected using the SIGCHLD signal and waitpid(WNOHANG).
  int fd_;
  /// PID of the subprocess. Set to -1 when the subprocess is reaped.
  pid_t pid_;
  /// In POSIX platforms it is necessary to use waitpid(WNOHANG) to know whether
  /// a certain subprocess has finished. This is done for terminal subprocesses.
  /// However, this also causes the subprocess to be reaped before Finish() is
  /// called, so we need to store the ExitStatus so that a later Finish()
  /// invocation can return it.
  ExitStatus exit_status_;
 
  /// Call waitpid() on the subprocess with the provided options and update the
  /// pid_ and exit_status_ fields.
  /// Return a boolean indicating whether the subprocess has indeed terminated.
  bool TryFinish(int waitpid_options);
#endif
  bool use_console_;
 
  friend struct SubprocessSet;
};
 
/// SubprocessSet runs a ppoll/pselect() loop around a set of Subprocesses.
/// DoWork() waits for any state change in subprocesses; finished_
/// is a queue of subprocesses as they finish.
struct SubprocessSet {
  SubprocessSet();
  ~SubprocessSet();
 
  Subprocess* Add(const std::string& command, bool use_console = false);
  bool DoWork();
  Subprocess* NextFinished();
  void Clear();
 
  std::vector<Subprocess*> running_;
  std::queue<Subprocess*> finished_;
 
#ifdef _WIN32
  static BOOL WINAPI NotifyInterrupted(DWORD dwCtrlType);
  static HANDLE ioport_;
#else
  static void SetInterruptedFlag(int signum);
  static void SigChldHandler(int signo, siginfo_t* info, void* context);
 
  /// Store the signal number that causes the interruption.
  /// 0 if not interruption.
  static volatile sig_atomic_t interrupted_;
  /// Whether ninja should quit. Set on SIGINT, SIGTERM or SIGHUP reception.
  static bool IsInterrupted() { return interrupted_ != 0; }
  static void HandlePendingInterruption();
 
  /// Initialized to 0 before ppoll/pselect().
  /// Filled to 1 by SIGCHLD handler when a child process terminates.
  static volatile sig_atomic_t s_sigchld_received;
  void CheckConsoleProcessTerminated();
 
  struct sigaction old_int_act_;
  struct sigaction old_term_act_;
  struct sigaction old_hup_act_;
  struct sigaction old_chld_act_;
  sigset_t old_mask_;
#endif
};
 
#endif // NINJA_SUBPROCESS_H_