2018-10-02 18:43:55 +08:00
|
|
|
//===--- FS.h - File system related utils ------------------------*- C++-*-===//
|
|
|
|
//
|
2019-01-19 16:50:56 +08:00
|
|
|
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
|
|
|
|
// See https://llvm.org/LICENSE.txt for license information.
|
|
|
|
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
|
2018-10-02 18:43:55 +08:00
|
|
|
//
|
|
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
|
|
|
|
#ifndef LLVM_CLANG_TOOLS_EXTRA_CLANGD_FS_H
|
|
|
|
#define LLVM_CLANG_TOOLS_EXTRA_CLANGD_FS_H
|
|
|
|
|
2018-10-10 21:27:25 +08:00
|
|
|
#include "clang/Basic/LLVM.h"
|
2018-10-02 18:43:55 +08:00
|
|
|
#include "llvm/ADT/Optional.h"
|
2018-10-10 21:27:25 +08:00
|
|
|
#include "llvm/Support/VirtualFileSystem.h"
|
2018-10-02 18:43:55 +08:00
|
|
|
|
|
|
|
namespace clang {
|
|
|
|
namespace clangd {
|
|
|
|
|
|
|
|
/// Records status information for files open()ed or stat()ed during preamble
|
2018-10-09 16:27:31 +08:00
|
|
|
/// build (except for the main file), so we can avoid stat()s on the underlying
|
|
|
|
/// FS when reusing the preamble. For example, code completion can re-stat files
|
|
|
|
/// when getting FileID for source locations stored in preamble (e.g. checking
|
|
|
|
/// whether a location is in the main file).
|
2018-10-02 18:43:55 +08:00
|
|
|
///
|
|
|
|
/// The cache is keyed by absolute path of file name in cached status, as this
|
|
|
|
/// is what preamble stores.
|
|
|
|
///
|
|
|
|
/// The cache is not thread-safe when updates happen, so the use pattern should
|
|
|
|
/// be:
|
|
|
|
/// - One FS writes to the cache from one thread (or several but strictly
|
|
|
|
/// sequenced), e.g. when building preamble.
|
|
|
|
/// - Sequence point (no writes after this point, no reads before).
|
|
|
|
/// - Several FSs can read from the cache, e.g. code completions.
|
|
|
|
///
|
|
|
|
/// Note that the cache is only valid when reusing preamble.
|
|
|
|
class PreambleFileStatusCache {
|
|
|
|
public:
|
2018-10-09 16:27:31 +08:00
|
|
|
/// \p MainFilePath is the absolute path of the main source file this preamble
|
|
|
|
/// corresponds to. The stat for the main file will not be cached.
|
|
|
|
PreambleFileStatusCache(llvm::StringRef MainFilePath);
|
|
|
|
|
2018-10-10 21:27:25 +08:00
|
|
|
void update(const llvm::vfs::FileSystem &FS, llvm::vfs::Status S);
|
2018-10-09 16:27:31 +08:00
|
|
|
|
2018-10-02 18:43:55 +08:00
|
|
|
/// \p Path is a path stored in preamble.
|
2018-10-10 21:27:25 +08:00
|
|
|
llvm::Optional<llvm::vfs::Status> lookup(llvm::StringRef Path) const;
|
2018-10-02 18:43:55 +08:00
|
|
|
|
|
|
|
/// Returns a VFS that collects file status.
|
|
|
|
/// Only cache stats for files that exist because
|
|
|
|
/// 1) we only care about existing files when reusing preamble, unlike
|
|
|
|
/// building preamble.
|
|
|
|
/// 2) we use the file name in the Status as the cache key.
|
|
|
|
///
|
|
|
|
/// Note that the returned VFS should not outlive the cache.
|
2018-10-10 21:27:25 +08:00
|
|
|
IntrusiveRefCntPtr<llvm::vfs::FileSystem>
|
|
|
|
getProducingFS(IntrusiveRefCntPtr<llvm::vfs::FileSystem> FS);
|
2018-10-02 18:43:55 +08:00
|
|
|
|
|
|
|
/// Returns a VFS that uses the cache collected.
|
|
|
|
///
|
|
|
|
/// Note that the returned VFS should not outlive the cache.
|
2018-10-10 21:27:25 +08:00
|
|
|
IntrusiveRefCntPtr<llvm::vfs::FileSystem>
|
|
|
|
getConsumingFS(IntrusiveRefCntPtr<llvm::vfs::FileSystem> FS) const;
|
2018-10-02 18:43:55 +08:00
|
|
|
|
|
|
|
private:
|
2018-10-09 16:27:31 +08:00
|
|
|
std::string MainFilePath;
|
2018-10-10 21:27:25 +08:00
|
|
|
llvm::StringMap<llvm::vfs::Status> StatCache;
|
2018-10-02 18:43:55 +08:00
|
|
|
};
|
|
|
|
|
|
|
|
} // namespace clangd
|
|
|
|
} // namespace clang
|
|
|
|
|
|
|
|
#endif // LLVM_CLANG_TOOLS_EXTRA_CLANGD_FS_H
|