Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix up busybox detection for relative symlinks #4522

Merged
merged 3 commits into from
Nov 14, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions toolchain/install/BUILD
Original file line number Diff line number Diff line change
Expand Up @@ -71,13 +71,34 @@ cc_library(
],
)

cc_library(
name = "busybox_info",
hdrs = ["busybox_info.h"],
deps = [
"//common:error",
"@llvm-project//llvm:Support",
],
)

cc_test(
name = "busybox_info_test",
srcs = ["busybox_info_test.cpp"],
deps = [
":busybox_info",
"//common:check",
"//testing/base:gtest_main",
"@googletest//:gtest",
],
)

# This target doesn't include prelude libraries. To get a target that has the
# prelude available, use //toolchain.
cc_binary(
name = "carbon-busybox",
srcs = ["busybox_main.cpp"],
env = cc_env(),
deps = [
":busybox_info",
":install_paths",
"//common:all_llvm_targets",
"//common:bazel_working_dir",
Expand Down
47 changes: 47 additions & 0 deletions toolchain/install/busybox_info.h
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
// Exceptions. See /LICENSE for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception

#ifndef CARBON_TOOLCHAIN_INSTALL_BUSYBOX_INFO_H_
#define CARBON_TOOLCHAIN_INSTALL_BUSYBOX_INFO_H_

#include <filesystem>
#include <optional>
#include <string>

#include "common/error.h"
#include "llvm/ADT/StringRef.h"

namespace Carbon {

struct BusyboxInfo {
// The path to `carbon-busybox`.
std::filesystem::path bin_path;
// The mode, such as `carbon` or `clang`.
std::optional<std::string> mode;
};

// Returns the busybox information, given argv[0]. This primarily handles
// resolving symlinks that point at the busybox.
inline auto GetBusyboxInfo(llvm::StringRef argv0) -> ErrorOr<BusyboxInfo> {
BusyboxInfo info = BusyboxInfo{argv0.str(), std::nullopt};
while (true) {
std::string filename = info.bin_path.filename();
if (filename == "carbon-busybox") {
return info;
}
std::error_code ec;
auto symlink_target = std::filesystem::read_symlink(info.bin_path, ec);
if (ec) {
return ErrorBuilder()
<< "expected carbon-busybox symlink at `" << info.bin_path << "`";
}
info.mode = filename;
// Do a path join, to handle relative symlinks.
info.bin_path = info.bin_path.parent_path() / symlink_target;
Comment on lines +40 to +41
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This only handles relative symlinks. That's certainly what we need at the moment, but do you want to support both? Worth documenting only relative?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What do you mean "only"? My understanding is this works for absolute, copying from https://en.cppreference.com/w/cpp/filesystem/path/append:

path("foo") / "/bar"; // the result is "/bar" (replaces)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should have an explicit test though, so sent #4528

}
}

} // namespace Carbon

#endif // CARBON_TOOLCHAIN_INSTALL_BUSYBOX_INFO_H_
156 changes: 156 additions & 0 deletions toolchain/install/busybox_info_test.cpp
Original file line number Diff line number Diff line change
@@ -0,0 +1,156 @@
// Part of the Carbon Language project, under the Apache License v2.0 with LLVM
// Exceptions. See /LICENSE for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception

#include "toolchain/install/busybox_info.h"

#include <gmock/gmock.h>
#include <gtest/gtest.h>

#include <cstdlib>
#include <fstream>

#include "common/check.h"

namespace Carbon {
namespace {

using ::testing::Eq;

class BusyboxInfoTest : public ::testing::Test {
protected:
// Set up a temp directory for the test case.
explicit BusyboxInfoTest() {
const char* tmpdir = std::getenv("TEST_TMPDIR");
CARBON_CHECK(tmpdir);
dir_ = MakeDir(
std::filesystem::path(tmpdir) /
::testing::UnitTest::GetInstance()->current_test_info()->name());
}

// Delete the test case's temp directory.
~BusyboxInfoTest() override {
std::error_code ec;
std::filesystem::remove_all(dir_, ec);
CARBON_CHECK(!ec, "error removing {0}: {1}", dir_, ec.message());
}

// Creates a stub file. Returns the input file for easier use.
auto MakeFile(std::filesystem::path file) -> std::filesystem::path {
std::ofstream out(file.c_str());
out << "stub";
CARBON_CHECK(out, "error creating {0}", file);
return file;
}

// Creates a symlink to the target. Returns the input file for easier use.
auto MakeSymlink(std::filesystem::path file, auto target)
-> std::filesystem::path {
std::error_code ec;
std::filesystem::create_symlink(target, file, ec);
CARBON_CHECK(!ec, "error creating {0}: {1}", file, ec.message());
return file;
}

// Creates a directory. Returns the input file for easier use.
auto MakeDir(std::filesystem::path dir) -> std::filesystem::path {
std::error_code ec;
std::filesystem::create_directory(dir, ec);
CARBON_CHECK(!ec, "error creating {0}: {1}", dir, ec.message());
return dir;
}

// The test's temp directory, deleted on destruction.
std::filesystem::path dir_;
};

TEST_F(BusyboxInfoTest, Direct) {
auto busybox = MakeFile(dir_ / "carbon-busybox");

auto info = GetBusyboxInfo(busybox.string());
ASSERT_TRUE(info.ok()) << info.error();
EXPECT_THAT(info->bin_path, Eq(busybox));
EXPECT_THAT(info->mode, Eq(std::nullopt));
}

TEST_F(BusyboxInfoTest, SymlinkInCurrentDirectory) {
MakeFile(dir_ / "carbon-busybox");
auto target = MakeSymlink(dir_ / "carbon", "carbon-busybox");

auto info = GetBusyboxInfo(target.string());
ASSERT_TRUE(info.ok()) << info.error();
EXPECT_THAT(info->bin_path, Eq(dir_ / "carbon-busybox"));
EXPECT_THAT(info->mode, Eq("carbon"));
}

TEST_F(BusyboxInfoTest, SymlinkInCurrentDirectoryWithDot) {
MakeFile(dir_ / "carbon-busybox");
auto target = MakeSymlink(dir_ / "carbon", "./carbon-busybox");

auto info = GetBusyboxInfo(target.string());
ASSERT_TRUE(info.ok()) << info.error();
EXPECT_THAT(info->bin_path, Eq(dir_ / "./carbon-busybox"));
EXPECT_THAT(info->mode, Eq("carbon"));
}

TEST_F(BusyboxInfoTest, ExtraSymlink) {
MakeFile(dir_ / "carbon-busybox");
MakeSymlink(dir_ / "carbon", "carbon-busybox");
auto target = MakeSymlink(dir_ / "c", "carbon");

auto info = GetBusyboxInfo(target.string());
ASSERT_TRUE(info.ok()) << info.error();
EXPECT_THAT(info->bin_path, Eq(dir_ / "carbon-busybox"));
EXPECT_THAT(info->mode, Eq("carbon"));
}

TEST_F(BusyboxInfoTest, BusyboxIsSymlink) {
MakeFile(dir_ / "actual-busybox");
auto target = MakeSymlink(dir_ / "carbon-busybox", "actual-busybox");

auto info = GetBusyboxInfo(target.string());
ASSERT_TRUE(info.ok()) << info.error();
EXPECT_THAT(info->bin_path, Eq(target));
EXPECT_THAT(info->mode, Eq(std::nullopt));
}

TEST_F(BusyboxInfoTest, BusyboxIsSymlinkToNowhere) {
auto target = MakeSymlink(dir_ / "carbon-busybox", "nonexistent");

auto info = GetBusyboxInfo(target.string());
ASSERT_TRUE(info.ok()) << info.error();
EXPECT_THAT(info->bin_path, Eq(dir_ / "carbon-busybox"));
EXPECT_THAT(info->mode, Eq(std::nullopt));
}

TEST_F(BusyboxInfoTest, RelativeSymlink) {
MakeDir(dir_ / "lib");
MakeDir(dir_ / "lib/carbon");
MakeFile(dir_ / "lib/carbon/carbon-busybox");
MakeDir(dir_ / "bin");
auto target =
MakeSymlink(dir_ / "bin/carbon", "../lib/carbon/carbon-busybox");

auto info = GetBusyboxInfo(target.string());
ASSERT_TRUE(info.ok()) << info.error();
EXPECT_THAT(info->bin_path, Eq(dir_ / "bin/../lib/carbon/carbon-busybox"));
EXPECT_THAT(info->mode, Eq("carbon"));
}

TEST_F(BusyboxInfoTest, NotBusyboxFile) {
auto target = MakeFile(dir_ / "file");

auto info = GetBusyboxInfo(target.string());
EXPECT_FALSE(info.ok());
}

TEST_F(BusyboxInfoTest, NotBusyboxSymlink) {
MakeFile(dir_ / "file");
auto target = MakeSymlink(dir_ / "carbon", "file");

auto info = GetBusyboxInfo(target.string());
EXPECT_FALSE(info.ok());
}

} // namespace
} // namespace Carbon
44 changes: 7 additions & 37 deletions toolchain/install/busybox_main.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,6 @@
#include <unistd.h>

#include <cstdlib>
#include <filesystem>

#include "common/bazel_working_dir.h"
#include "common/error.h"
Expand All @@ -15,58 +14,29 @@
#include "llvm/ADT/StringRef.h"
#include "llvm/Support/LLVMDriver.h"
#include "toolchain/driver/driver.h"
#include "toolchain/install/busybox_info.h"
#include "toolchain/install/install_paths.h"

namespace Carbon {

namespace {
struct BusyboxInfo {
// The path to `carbon-busybox`.
std::filesystem::path bin_path;
// The mode, such as `carbon` or `clang`.
std::optional<std::string> mode;
};
} // namespace

// Returns the busybox information, given argv[0]. This primarily handles
// resolving symlinks that point at the busybox.
static auto GetBusyboxInfo(llvm::StringRef argv0) -> ErrorOr<BusyboxInfo> {
BusyboxInfo info = BusyboxInfo{argv0.str(), std::nullopt};
while (true) {
std::string filename = info.bin_path.filename();
if (filename == "carbon-busybox") {
return info;
}
std::error_code ec;
auto symlink_target = std::filesystem::read_symlink(info.bin_path, ec);
if (ec) {
return ErrorBuilder()
<< "expected carbon-busybox symlink at `" << info.bin_path << "`";
}
info.mode = filename;
info.bin_path = symlink_target;
}
}

// The actual `main` implementation. Can return an exit code or an `Error`
// (which causes EXIT_FAILRUE).
static auto Main(int argc, char** argv) -> ErrorOr<int> {
Carbon::InitLLVM init_llvm(argc, argv);
InitLLVM init_llvm(argc, argv);

// Start by resolving any symlinks.
CARBON_ASSIGN_OR_RETURN(auto busybox_info, Carbon::GetBusyboxInfo(argv[0]));
CARBON_ASSIGN_OR_RETURN(auto busybox_info, GetBusyboxInfo(argv[0]));

auto fs = llvm::vfs::getRealFileSystem();

// Resolve paths before calling SetWorkingDirForBazel.
std::string exe_path =
Carbon::FindExecutablePath(busybox_info.bin_path.string());
const auto install_paths = Carbon::InstallPaths::MakeExeRelative(exe_path);
std::string exe_path = FindExecutablePath(busybox_info.bin_path.string());
const auto install_paths = InstallPaths::MakeExeRelative(exe_path);
if (install_paths.error()) {
return Error(*install_paths.error());
}

Carbon::SetWorkingDirForBazel();
SetWorkingDirForBazel();

llvm::SmallVector<llvm::StringRef> args;
args.reserve(argc + 1);
Expand All @@ -75,7 +45,7 @@ static auto Main(int argc, char** argv) -> ErrorOr<int> {
}
args.append(argv + 1, argv + argc);

Carbon::Driver driver(*fs, &install_paths, llvm::outs(), llvm::errs());
Driver driver(*fs, &install_paths, llvm::outs(), llvm::errs());
bool success = driver.RunCommand(args).success;
return success ? EXIT_SUCCESS : EXIT_FAILURE;
}
Expand Down