// Copyright (c) 2012 The Chromium OS Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "brillo/process.h"
#include <unistd.h>
#include <base/files/file_path.h>
#include <base/files/file_util.h>
#include <base/files/scoped_temp_dir.h>
#include <gtest/gtest.h>
#include "brillo/process_mock.h"
#include "brillo/unittest_utils.h"
#include "brillo/test_helpers.h"
using base::FilePath;
// This test assumes the following standard binaries are installed.
#if defined(__ANDROID__)
# define SYSTEM_PREFIX "/system"
static const char kBinStat[] = SYSTEM_PREFIX "/bin/stat";
#else
# define SYSTEM_PREFIX ""
static const char kBinStat[] = "/usr/bin/stat";
#endif
static const char kBinSh[] = SYSTEM_PREFIX "/bin/sh";
static const char kBinCat[] = SYSTEM_PREFIX "/bin/cat";
static const char kBinEcho[] = SYSTEM_PREFIX "/bin/echo";
static const char kBinFalse[] = SYSTEM_PREFIX "/bin/false";
static const char kBinSleep[] = SYSTEM_PREFIX "/bin/sleep";
static const char kBinTrue[] = SYSTEM_PREFIX "/bin/true";
namespace brillo {
// Test that the mock has all the functions of the interface by
// instantiating it. This variable is not used elsewhere.
struct CompileMocks {
ProcessMock process_mock;
};
TEST(SimpleProcess, Basic) {
// Log must be cleared before running this test, just as ProcessTest::SetUp.
ClearLog();
ProcessImpl process;
process.AddArg(kBinEcho);
EXPECT_EQ(0, process.Run());
EXPECT_EQ("", GetLog());
}
TEST(SimpleProcess, NoSearchPath) {
ProcessImpl process;
process.AddArg("echo");
EXPECT_EQ(127, process.Run());
}
TEST(SimpleProcess, SearchPath) {
ProcessImpl process;
process.AddArg("echo");
process.SetSearchPath(true);
EXPECT_EQ(EXIT_SUCCESS, process.Run());
}
TEST(SimpleProcess, BindFd) {
int fds[2];
char buf[16];
static const char* kMsg = "hello, world!";
ProcessImpl process;
EXPECT_EQ(0, pipe(fds));
process.AddArg(kBinEcho);
process.AddArg(kMsg);
process.BindFd(fds[1], 1);
process.Run();
memset(buf, 0, sizeof(buf));
EXPECT_EQ(read(fds[0], buf, sizeof(buf) - 1), strlen(kMsg) + 1);
EXPECT_EQ(std::string(kMsg) + "\n", std::string(buf));
}
// The test framework uses the device's dash shell as "sh", which doesn't
// support redirecting stdout to arbitrary large file descriptor numbers
// directly, nor has /proc mounted to open /proc/self/fd/NN. This test would
// fail if pipe.writer is big enough.
// TODO(deymo): Write a helper program that writes "hello_world" to the passed
// file descriptor and re-enabled this test.
TEST(DISABLED_SimpleProcess, BindFdToSameFd) {
static const char* kMsg = "hello_world";
ScopedPipe pipe;
ProcessImpl process;
process.AddArg(kBinSh);
process.AddArg("-c");
process.AddArg(base::StringPrintf("echo %s >&%d", kMsg, pipe.writer));
process.BindFd(pipe.writer, pipe.writer);
process.Run();
close(pipe.writer);
pipe.writer = -1;
char buf[16];
memset(buf, 0, sizeof(buf));
EXPECT_EQ(read(pipe.reader, buf, sizeof(buf) - 1), strlen(kMsg) + 1);
EXPECT_EQ(std::string(kMsg) + "\n", std::string(buf));
}
class ProcessTest : public ::testing::Test {
public:
void SetUp() {
CHECK(temp_dir_.CreateUniqueTempDir());
output_file_ = temp_dir_.GetPath().Append("fork_out").value();
process_.RedirectOutput(output_file_);
ClearLog();
}
static void SetUpTestCase() {
base::CommandLine::Init(0, nullptr);
::brillo::InitLog(brillo::kLogToStderr);
::brillo::LogToString(true);
}
protected:
void CheckStderrCaptured();
FilePath GetFdPath(int fd);
ProcessImpl process_;
std::vector<const char*> args_;
std::string output_file_;
base::ScopedTempDir temp_dir_;
};
TEST_F(ProcessTest, Basic) {
process_.AddArg(kBinEcho);
process_.AddArg("hello world");
EXPECT_EQ(0, process_.Run());
ExpectFileEquals("hello world\n", output_file_.c_str());
EXPECT_EQ("", GetLog());
}
TEST_F(ProcessTest, AddStringOption) {
process_.AddArg(kBinEcho);
process_.AddStringOption("--hello", "world");
EXPECT_EQ(0, process_.Run());
ExpectFileEquals("--hello world\n", output_file_.c_str());
}
TEST_F(ProcessTest, AddIntValue) {
process_.AddArg(kBinEcho);
process_.AddIntOption("--answer", 42);
EXPECT_EQ(0, process_.Run());
ExpectFileEquals("--answer 42\n", output_file_.c_str());
}
TEST_F(ProcessTest, NonZeroReturnValue) {
process_.AddArg(kBinFalse);
EXPECT_EQ(1, process_.Run());
ExpectFileEquals("", output_file_.c_str());
EXPECT_EQ("", GetLog());
}
TEST_F(ProcessTest, RedirectInputDevNull) {
process_.AddArg(kBinCat);
process_.RedirectInput("/dev/null");
EXPECT_EQ(0, process_.Run());
}
TEST_F(ProcessTest, BadInputFile) {
process_.AddArg(kBinCat);
process_.RedirectInput("/bad/path");
EXPECT_EQ(static_cast<pid_t>(Process::kErrorExitStatus), process_.Run());
}
TEST_F(ProcessTest, BadOutputFile) {
process_.AddArg(kBinEcho);
process_.RedirectOutput("/bad/path");
EXPECT_EQ(static_cast<pid_t>(Process::kErrorExitStatus), process_.Run());
}
TEST_F(ProcessTest, BadExecutable) {
process_.AddArg("false");
EXPECT_EQ(static_cast<pid_t>(Process::kErrorExitStatus), process_.Run());
}
void ProcessTest::CheckStderrCaptured() {
process_.AddArg(kBinSh);
process_.AddArg("-c");
process_.AddArg("echo errormessage 1>&2 && exit 1");
EXPECT_EQ(1, process_.Run());
std::string contents;
EXPECT_TRUE(base::ReadFileToString(FilePath(output_file_), &contents));
EXPECT_NE(std::string::npos, contents.find("errormessage"));
EXPECT_EQ("", GetLog());
}
TEST_F(ProcessTest, StderrCaptured) {
CheckStderrCaptured();
}
TEST_F(ProcessTest, StderrCapturedWhenPreviouslyClosed) {
int saved_stderr = dup(STDERR_FILENO);
close(STDERR_FILENO);
CheckStderrCaptured();
dup2(saved_stderr, STDERR_FILENO);
}
FilePath ProcessTest::GetFdPath(int fd) {
return FilePath(base::StringPrintf("/proc/self/fd/%d", fd));
}
TEST_F(ProcessTest, RedirectStderrUsingPipe) {
process_.RedirectOutput("");
process_.AddArg(kBinSh);
process_.AddArg("-c");
process_.AddArg("echo errormessage >&2 && exit 1");
process_.RedirectUsingPipe(STDERR_FILENO, false);
EXPECT_EQ(-1, process_.GetPipe(STDERR_FILENO));
EXPECT_EQ(1, process_.Run());
int pipe_fd = process_.GetPipe(STDERR_FILENO);
EXPECT_GE(pipe_fd, 0);
EXPECT_EQ(-1, process_.GetPipe(STDOUT_FILENO));
EXPECT_EQ(-1, process_.GetPipe(STDIN_FILENO));
std::string contents;
EXPECT_TRUE(base::ReadFileToString(GetFdPath(pipe_fd), &contents));
EXPECT_NE(std::string::npos, contents.find("errormessage"));
EXPECT_EQ("", GetLog());
}
TEST_F(ProcessTest, RedirectStderrUsingPipeWhenPreviouslyClosed) {
int saved_stderr = dup(STDERR_FILENO);
close(STDERR_FILENO);
process_.RedirectOutput("");
process_.AddArg(kBinSh);
process_.AddArg("-c");
process_.AddArg("echo errormessage >&2 && exit 1");
process_.RedirectUsingPipe(STDERR_FILENO, false);
EXPECT_EQ(1, process_.Run());
int pipe_fd = process_.GetPipe(STDERR_FILENO);
EXPECT_GE(pipe_fd, 0);
EXPECT_EQ(-1, process_.GetPipe(STDOUT_FILENO));
EXPECT_EQ(-1, process_.GetPipe(STDIN_FILENO));
std::string contents;
EXPECT_TRUE(base::ReadFileToString(GetFdPath(pipe_fd), &contents));
EXPECT_NE(std::string::npos, contents.find("errormessage"));
EXPECT_EQ("", GetLog());
dup2(saved_stderr, STDERR_FILENO);
}
TEST_F(ProcessTest, RedirectStdoutUsingPipe) {
process_.RedirectOutput("");
process_.AddArg(kBinEcho);
process_.AddArg("hello world\n");
process_.RedirectUsingPipe(STDOUT_FILENO, false);
EXPECT_EQ(-1, process_.GetPipe(STDOUT_FILENO));
EXPECT_EQ(0, process_.Run());
int pipe_fd = process_.GetPipe(STDOUT_FILENO);
EXPECT_GE(pipe_fd, 0);
EXPECT_EQ(-1, process_.GetPipe(STDERR_FILENO));
EXPECT_EQ(-1, process_.GetPipe(STDIN_FILENO));
std::string contents;
EXPECT_TRUE(base::ReadFileToString(GetFdPath(pipe_fd), &contents));
EXPECT_NE(std::string::npos, contents.find("hello world\n"));
EXPECT_EQ("", GetLog());
}
TEST_F(ProcessTest, RedirectStdinUsingPipe) {
const char kMessage[] = "made it!\n";
process_.AddArg(kBinCat);
process_.RedirectUsingPipe(STDIN_FILENO, true);
process_.RedirectOutput(output_file_);
EXPECT_TRUE(process_.Start());
int write_fd = process_.GetPipe(STDIN_FILENO);
EXPECT_EQ(-1, process_.GetPipe(STDERR_FILENO));
EXPECT_TRUE(base::WriteFile(GetFdPath(write_fd), kMessage, strlen(kMessage)));
close(write_fd);
EXPECT_EQ(0, process_.Wait());
ExpectFileEquals(kMessage, output_file_.c_str());
}
TEST_F(ProcessTest, WithSameUid) {
gid_t uid = geteuid();
process_.AddArg(kBinEcho);
process_.SetUid(uid);
EXPECT_EQ(0, process_.Run());
}
TEST_F(ProcessTest, WithSameGid) {
gid_t gid = getegid();
process_.AddArg(kBinEcho);
process_.SetGid(gid);
EXPECT_EQ(0, process_.Run());
}
TEST_F(ProcessTest, WithIllegalUid) {
ASSERT_NE(0, geteuid());
process_.AddArg(kBinEcho);
process_.SetUid(0);
EXPECT_EQ(static_cast<pid_t>(Process::kErrorExitStatus), process_.Run());
std::string contents;
EXPECT_TRUE(base::ReadFileToString(FilePath(output_file_), &contents));
EXPECT_NE(std::string::npos, contents.find("Unable to set UID to 0: 1\n"));
}
TEST_F(ProcessTest, WithIllegalGid) {
ASSERT_NE(0, getegid());
process_.AddArg(kBinEcho);
process_.SetGid(0);
EXPECT_EQ(static_cast<pid_t>(Process::kErrorExitStatus), process_.Run());
std::string contents;
EXPECT_TRUE(base::ReadFileToString(FilePath(output_file_), &contents));
EXPECT_NE(std::string::npos, contents.find("Unable to set GID to 0: 1\n"));
}
TEST_F(ProcessTest, NoParams) {
EXPECT_EQ(-1, process_.Run());
}
#if !defined(__BIONIC__) // Bionic intercepts the segfault on Android.
TEST_F(ProcessTest, SegFaultHandling) {
process_.AddArg(kBinSh);
process_.AddArg("-c");
process_.AddArg("kill -SEGV $$");
EXPECT_EQ(-1, process_.Run());
EXPECT_TRUE(FindLog("did not exit normally: 11"));
}
#endif
TEST_F(ProcessTest, KillHandling) {
process_.AddArg(kBinSh);
process_.AddArg("-c");
process_.AddArg("kill -KILL $$");
EXPECT_EQ(-1, process_.Run());
EXPECT_TRUE(FindLog("did not exit normally: 9"));
}
TEST_F(ProcessTest, KillNoPid) {
process_.Kill(SIGTERM, 0);
EXPECT_TRUE(FindLog("Process not running"));
}
TEST_F(ProcessTest, ProcessExists) {
EXPECT_FALSE(Process::ProcessExists(0));
EXPECT_TRUE(Process::ProcessExists(1));
EXPECT_TRUE(Process::ProcessExists(getpid()));
}
TEST_F(ProcessTest, ResetPidByFile) {
FilePath pid_path = temp_dir_.GetPath().Append("pid");
EXPECT_FALSE(process_.ResetPidByFile(pid_path.value()));
EXPECT_TRUE(base::WriteFile(pid_path, "456\n", 4));
EXPECT_TRUE(process_.ResetPidByFile(pid_path.value()));
EXPECT_EQ(456, process_.pid());
// The purpose of this unit test is to check if Process::ResetPidByFile() can
// properly read a pid from a file. We don't really want to kill the process
// with pid 456, so update the pid to 0 to prevent the Process destructor from
// killing any innocent process.
process_.UpdatePid(0);
}
TEST_F(ProcessTest, KillSleeper) {
process_.AddArg(kBinSleep);
process_.AddArg("10000");
ASSERT_TRUE(process_.Start());
pid_t pid = process_.pid();
ASSERT_GT(pid, 1);
EXPECT_TRUE(process_.Kill(SIGTERM, 1));
EXPECT_EQ(0, process_.pid());
}
TEST_F(ProcessTest, Reset) {
process_.AddArg(kBinFalse);
process_.Reset(0);
process_.AddArg(kBinEcho);
EXPECT_EQ(0, process_.Run());
}
bool ReturnFalse() { return false; }
TEST_F(ProcessTest, PreExecCallback) {
process_.AddArg(kBinTrue);
process_.SetPreExecCallback(base::Bind(&ReturnFalse));
ASSERT_NE(0, process_.Run());
}
TEST_F(ProcessTest, LeakUnusedFileDescriptors) {
ScopedPipe pipe;
process_.AddArg(kBinStat);
process_.AddArg(GetFdPath(pipe.reader).value());
process_.AddArg(GetFdPath(pipe.writer).value());
process_.SetCloseUnusedFileDescriptors(false);
EXPECT_EQ(0, process_.Run());
}
TEST_F(ProcessTest, CloseUnusedFileDescriptors) {
ScopedPipe pipe;
process_.AddArg(kBinStat);
process_.AddArg(GetFdPath(pipe.reader).value());
process_.AddArg(GetFdPath(pipe.writer).value());
process_.SetCloseUnusedFileDescriptors(true);
// Stat should fail when running on these file descriptor because the files
// should not be there.
EXPECT_EQ(1, process_.Run());
}
} // namespace brillo