deploy/installer/executor/executor_impl.h

/*
 * Copyright (C) 2018 The Android Open Source Project
 *
 * 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 EXECUTOR_IMPL_H
#define EXECUTOR_IMPL_H

#include <string>
#include <vector>

#include "tools/base/deploy/installer/executor/executor.h"

namespace deploy {

class ExecutorImpl : public Executor {
 public:
  ExecutorImpl() {}

  bool Run(const std::string& executable_path,
           const std::vector<std::string>& args, std::string* output,
           std::string* error) const;

  // Returns open file descriptors for the child's stdin, stdout, and stderr.
  // It is the caller's responsibility to call waitpid(2) on fork_pid in order
  // to avoid zombie process.
  //
  // It is also the caller's responsibility to close(2) these fds. If the caller
  // is not interested in the child outputs, nullptr can be passed in place of
  // child_stdout_fd and child_stderr_fd in which case fork will establish sinks
  // for the child process outputs.
  bool ForkAndExec(const std::string& executable_path,
                   const std::vector<std::string>& parameters,
                   int* child_stdin_fd, int* child_stdout_fd,
                   int* child_stderr_fd, int* fork_pid) const;

  // Takes a file descriptor which will be duplicated into the stdin of the
  // child process. The child process takes ownershp of stdin_fd. The parent
  // closes stdin_fd, which should not be used after calling this method.
  //
  // Returns open file descriptors for the child's stdout, and stderr.
  // It is the caller's responsibility to call waitpid(2) on fork_pid in order
  // to avoid zombie process.
  //
  // It is also the caller's responsibility to close(2) these fds. If the caller
  // is not interested in the child outputs, nullptr can be passed in place of
  // child_stdout_fd and child_stderr_fd in which case fork will establish sinks
  // for the child process outputs.
  bool ForkAndExecWithStdinFd(const std::string& executable_path,
                              const std::vector<std::string>& parameters,
                              int stdin_fd, int* child_stdout_fd,
                              int* child_stderr_fd, int* fork_pid) const;

 private:
  void Pump(int child_stdout, std::string* output, int child_stderr,
            std::string* error) const;
};

}  // namespace deploy

#endif  // EXECUTOR_IMPL_H