sapling/eden/fs/inodes/CheckoutAction.cpp

/*
 *  Copyright (c) 2004-present, Facebook, Inc.
 *  All rights reserved.
 *
 *  This source code is licensed under the BSD-style license found in the
 *  LICENSE file in the root directory of this source tree. An additional grant
 *  of patent rights can be found in the PATENTS file in the same directory.
 *
 */
#include "eden/fs/inodes/CheckoutAction.h"

#include <folly/experimental/logging/xlog.h>

#include "eden/fs/inodes/CheckoutContext.h"
#include "eden/fs/inodes/FileInode.h"
#include "eden/fs/inodes/InodeBase.h"
#include "eden/fs/inodes/TreeInode.h"
#include "eden/fs/model/Blob.h"
#include "eden/fs/model/Tree.h"
#include "eden/fs/model/TreeEntry.h"
#include "eden/fs/service/gen-cpp2/eden_types.h"
#include "eden/fs/store/ObjectStore.h"

using folly::exception_wrapper;
using folly::Future;
using folly::makeFuture;
using folly::Unit;
using std::make_shared;
using std::vector;

namespace facebook {
namespace eden {

CheckoutAction::CheckoutAction(
    CheckoutContext* ctx,
    const TreeEntry* oldScmEntry,
    const TreeEntry* newScmEntry,
    InodePtr&& inode)
    : ctx_(ctx), inode_(std::move(inode)) {
  DCHECK(oldScmEntry || newScmEntry);
  if (oldScmEntry) {
    oldScmEntry_ = *oldScmEntry;
  }
  if (newScmEntry) {
    newScmEntry_ = *newScmEntry;
  }
}

CheckoutAction::CheckoutAction(
    InternalConstructor,
    CheckoutContext* ctx,
    const TreeEntry* oldScmEntry,
    const TreeEntry* newScmEntry,
    folly::Future<InodePtr> inodeFuture)
    : ctx_(ctx), inodeFuture_(std::move(inodeFuture)) {
  DCHECK(oldScmEntry || newScmEntry);
  if (oldScmEntry) {
    oldScmEntry_ = *oldScmEntry;
  }
  if (newScmEntry) {
    newScmEntry_ = *newScmEntry;
  }
}

CheckoutAction::~CheckoutAction() {}

PathComponentPiece CheckoutAction::getEntryName() const {
  DCHECK(oldScmEntry_.hasValue() || newScmEntry_.hasValue());
  return oldScmEntry_.hasValue() ? oldScmEntry_.value().getName()
                                 : newScmEntry_.value().getName();
}

class CheckoutAction::LoadingRefcount {
 public:
  explicit LoadingRefcount(CheckoutAction* action) : action_(action) {
    action_->numLoadsPending_.fetch_add(1);
  }
  LoadingRefcount(LoadingRefcount&& other) noexcept : action_(other.action_) {
    other.action_ = nullptr;
  }
  LoadingRefcount& operator=(LoadingRefcount&& other) noexcept {
    decref();
    action_ = other.action_;
    other.action_ = nullptr;
    return *this;
  }
  ~LoadingRefcount() {
    decref();
  }

  /**
   * Implement the arrow operator, so that LoadingRefcount can be used like a
   * pointer.  This allows users to easily call through it into the underlying
   * CheckoutAction methods.
   */
  CheckoutAction* operator->() const {
    return action_;
  }

 private:
  void decref() {
    if (action_) {
      auto oldCount = action_->numLoadsPending_.fetch_sub(1);
      if (oldCount == 1) {
        // We were the last load to complete.  We can perform the action now.
        action_->allLoadsComplete();
      }
    }
  }

  CheckoutAction* action_;
};

Future<Unit> CheckoutAction::run(
    CheckoutContext* /* ctx */,
    ObjectStore* store) {
  // Immediately create one LoadingRefcount, to ensure that our
  // numLoadsPending_ refcount does not drop to 0 until after we have started
  // all required load operations.
  //
  // Even if all loads complete immediately, allLoadsComplete() won't be called
  // until this LoadingRefcount is destroyed.
  LoadingRefcount refcount{this};

  try {
    // Load the Blob or Tree for the old TreeEntry.
    if (oldScmEntry_.hasValue()) {
      if (oldScmEntry_.value().isTree()) {
        store->getTree(oldScmEntry_.value().getHash())
            .then([rc = LoadingRefcount(this)](
                      std::shared_ptr<const Tree> oldTree) {
              rc->setOldTree(std::move(oldTree));
            })
            .onError([rc = LoadingRefcount(this)](const exception_wrapper& ew) {
              rc->error("error getting old tree", ew);
            });
      } else {
        store->getBlob(oldScmEntry_.value().getHash())
            .then([rc = LoadingRefcount(this)](
                      std::shared_ptr<const Blob> oldBlob) {
              rc->setOldBlob(std::move(oldBlob));
            })
            .onError([rc = LoadingRefcount(this)](const exception_wrapper& ew) {
              rc->error("error getting old blob", ew);
            });
      }
    }

    // If we have a new TreeEntry, load the corresponding Blob or Tree
    if (newScmEntry_.hasValue()) {
      const auto& newEntry = newScmEntry_.value();
      if (newEntry.isTree()) {
        store->getTree(newEntry.getHash())
            .then([rc = LoadingRefcount(this)](
                      std::shared_ptr<const Tree> newTree) {
              rc->setNewTree(std::move(newTree));
            })
            .onError([rc = LoadingRefcount(this)](const exception_wrapper& ew) {
              rc->error("error getting new tree", ew);
            });
      } else {
        store->getBlob(newEntry.getHash())
            .then([rc = LoadingRefcount(this)](
                      std::shared_ptr<const Blob> newBlob) {
              rc->setNewBlob(std::move(newBlob));
            })
            .onError([rc = LoadingRefcount(this)](const exception_wrapper& ew) {
              rc->error("error getting new blob", ew);
            });
      }
    }

    // If we were constructed with a Future<InodePtr>, wait for it.
    if (!inode_) {
      CHECK(inodeFuture_.hasValue());
      inodeFuture_.value()
          .then([rc = LoadingRefcount(this)](InodePtr inode) {
            rc->setInode(std::move(inode));
          })
          .onError([rc = LoadingRefcount(this)](const exception_wrapper& ew) {
            rc->error("error getting inode", ew);
          });
    }
  } catch (const std::exception& ex) {
    exception_wrapper ew{std::current_exception(), ex};
    refcount->error("error preparing to load data for checkout action", ew);
  }

  return promise_.getFuture();
}

void CheckoutAction::setOldTree(std::shared_ptr<const Tree> tree) {
  CHECK(!oldTree_);
  CHECK(!oldBlob_);
  oldTree_ = std::move(tree);
}

void CheckoutAction::setOldBlob(std::shared_ptr<const Blob> blob) {
  CHECK(!oldTree_);
  CHECK(!oldBlob_);
  oldBlob_ = std::move(blob);
}

void CheckoutAction::setNewTree(std::shared_ptr<const Tree> tree) {
  CHECK(!newTree_);
  CHECK(!newBlob_);
  newTree_ = std::move(tree);
}

void CheckoutAction::setNewBlob(std::shared_ptr<const Blob> blob) {
  CHECK(!newTree_);
  CHECK(!newBlob_);
  newBlob_ = std::move(blob);
}

void CheckoutAction::setInode(InodePtr inode) {
  CHECK(!inode_);
  inode_ = std::move(inode);
}

void CheckoutAction::error(
    folly::StringPiece msg,
    const folly::exception_wrapper& ew) {
  XLOG(ERR) << "error performing checkout action: " << msg << ": "
            << folly::exceptionStr(ew);
  errors_.push_back(ew);
}

void CheckoutAction::allLoadsComplete() noexcept {
  if (!ensureDataReady()) {
    // ensureDataReady() will fulfilled promise_ with an exception
    return;
  }

  try {
    doAction().then(
        [this](folly::Try<Unit>&& t) { this->promise_.setTry(std::move(t)); });
  } catch (const std::exception& ex) {
    exception_wrapper ew{std::current_exception(), ex};
    promise_.setException(ew);
  }
}

bool CheckoutAction::ensureDataReady() noexcept {
  if (!errors_.empty()) {
    // If multiple errors occurred, we log them all, but only propagate
    // up the first one.  If necessary we could change this to create
    // a single exception that contains all of the messages concatenated
    // together.
    if (errors_.size() > 1) {
      XLOG(ERR) << "multiple errors while attempting to load data for "
                   "checkout action:";
      for (const auto& ew : errors_) {
        XLOG(ERR) << "CheckoutAction error: " << folly::exceptionStr(ew);
      }
    }
    promise_.setException(errors_[0]);
    return false;
  }

  // Make sure we actually have all the data we need.
  // (Just in case something went wrong when wiring up the callbacks in such a
  // way that we also failed to call error().)
  if (oldScmEntry_.hasValue() && (!oldTree_ && !oldBlob_)) {
    promise_.setException(
        std::runtime_error("failed to load data for old TreeEntry"));
    return false;
  }
  if (newScmEntry_.hasValue() && (!newTree_ && !newBlob_)) {
    promise_.setException(
        std::runtime_error("failed to load data for new TreeEntry"));
    return false;
  }
  if (!inode_) {
    promise_.setException(std::runtime_error("failed to load affected inode"));
    return false;
  }

  return true;
}

Future<Unit> CheckoutAction::doAction() {
  // All the data is ready and we're ready to go!

  // Check for conflicts first.
  auto conflictWasAddedToCtx = hasConflict();
  // Note that even if we know we are not going to apply the changes, we must
  // still run hasConflict() first because we rely on its side-effects.
  if (conflictWasAddedToCtx && !ctx_->forceUpdate()) {
    // We only report conflicts for files, not directories. The only possible
    // conflict that can occur here if this inode is a TreeInode is that the old
    // source control state was for a file. There aren't really any other
    // conflicts than this to report, even if we recurse. Anything inside this
    // directory is basically just untracked (or possibly ignored) files.
    return makeFuture();
  }

  // Call TreeInode::checkoutUpdateEntry() to actually do the work.
  //
  // Note that we are moving most of our state into the checkoutUpdateEntry()
  // arguments.  We have to be slightly careful here: getEntryName() returns a
  // PathComponentPiece that is pointing into a PathComponent owned either by
  // oldScmEntry_ or newScmEntry_.  Therefore don't move these scm entries,
  // to make sure we don't invalidate the PathComponentPiece data.
  auto parent = inode_->getParent(ctx_->renameLock());
  return parent->checkoutUpdateEntry(
      ctx_,
      getEntryName(),
      std::move(inode_),
      std::move(oldTree_),
      std::move(newTree_),
      newScmEntry_);
}

bool CheckoutAction::hasConflict() {
  if (oldTree_) {
    auto treeInode = inode_.asTreePtrOrNull();
    if (!treeInode) {
      // This was a directory, but has been replaced with a file on disk
      ctx_->addConflict(ConflictType::MODIFIED_MODIFIED, inode_.get());
      return true;
    }

    // TODO: check for permissions changes

    // We don't check if this tree is unmodified from the old tree or not here.
    // We simply apply the checkout to the tree in this case, so that we report
    // conflicts for individual leaf inodes that were modified, and not for the
    // parent directories.
    return false;
  } else if (oldBlob_) {
    auto fileInode = inode_.asFilePtrOrNull();
    if (!fileInode) {
      // This was a file, but has been replaced with a directory on disk
      ctx_->addConflict(ConflictType::MODIFIED_MODIFIED, inode_.get());
      return true;
    }

    // Check that the file contents are the same as the old source control entry
    if (!fileInode->isSameAs(*oldBlob_, oldScmEntry_.value().getType())) {
      // The file contents or mode bits are different:
      // - If the file exists in the new tree but differs from what is currently
      //   in the working copy, then this is a MODIFIED_MODIFIED conflict.
      // - If the file does not exist in the new tree, then this is a
      //   MODIFIED_REMOVED conflict.
      auto conflictType = newScmEntry_ ? ConflictType::MODIFIED_MODIFIED
                                       : ConflictType::MODIFIED_REMOVED;
      ctx_->addConflict(conflictType, inode_.get());
      return true;
    }

    // This file is the same as the old source control state.
    return false;
  }

  DCHECK(!oldScmEntry_) << "Both oldTree_ and oldBlob_ are nullptr, "
                           "so this file should not have an oldScmEntry_.";
  DCHECK(newScmEntry_) << "If there is no oldScmEntry_, then there must be a "
                          "newScmEntry_.";

  auto localIsFile = inode_.asFilePtrOrNull() != nullptr;
  if (localIsFile) {
    auto remoteIsFile = !newScmEntry_->isTree();
    if (remoteIsFile) {
      // This entry is a file that did not exist in the old source control tree,
      // but it exists as a tracked file in the new tree.
      ctx_->addConflict(ConflictType::UNTRACKED_ADDED, inode_.get());
      return true;
    } else {
      // This entry is a file that did not exist in the old source control tree,
      // but it exists as a tracked directory in the new tree.
      ctx_->addConflict(ConflictType::MODIFIED_MODIFIED, inode_.get());
      return true;
    }
  } else {
    // This entry is a directory that did not exist in the old source control
    // tree. We must traverse the directory for UNTRACKED_ADDED and
    // MODIFIED_MODIFIED conflicts. Returning false signals that we must
    // recurse into this directory to continue to look for conflicts.
    return false;
  }
}
} // namespace eden
} // namespace facebook