An in-memory file system. More...

#include "llvm/Support/VirtualFileSystem.h"

Inheritance diagram for llvm::vfs::InMemoryFileSystem:

Collaboration diagram for llvm::vfs::InMemoryFileSystem:

Public Member Functions
	InMemoryFileSystem (bool UseNormalizedPaths=true)

	~InMemoryFileSystem () override

bool	addFile (const Twine &Path, time_t ModificationTime, std::unique_ptr< llvm::MemoryBuffer > Buffer, Optional< uint32_t > User=None, Optional< uint32_t > Group=None, Optional< llvm::sys::fs::file_type > Type=None, Optional< llvm::sys::fs::perms > Perms=None)
	Add a file containing a buffer or a directory to the VFS with a path. More...

bool	addHardLink (const Twine &From, const Twine &To)
	Add a hard link to a file. More...

bool	addFileNoOwn (const Twine &Path, time_t ModificationTime, llvm::MemoryBuffer *Buffer, Optional< uint32_t > User=None, Optional< uint32_t > Group=None, Optional< llvm::sys::fs::file_type > Type=None, Optional< llvm::sys::fs::perms > Perms=None)
	Add a buffer to the VFS with a path. More...

std::string	toString () const

bool	useNormalizedPaths () const
	Return true if this file system normalizes . and .. in paths. More...

llvm::ErrorOr< Status >	status (const Twine &Path) override
	Get the status of the entry at `Path`, if one exists. More...

llvm::ErrorOr< std::unique_ptr< File > >	openFileForRead (const Twine &Path) override
	Get a `File` object for the file at `Path`, if one exists. More...

directory_iterator	dir_begin (const Twine &Dir, std::error_code &EC) override
	Get a directory_iterator for `Dir`. More...

llvm::ErrorOr< std::string >	getCurrentWorkingDirectory () const override
	Get the working directory of this file system. More...

std::error_code	getRealPath (const Twine &Path, SmallVectorImpl< char > &Output) const override
	Canonicalizes `Path` by combining with the current working directory and normalizing the path (e.g. More...

std::error_code	isLocal (const Twine &Path, bool &Result) override
	Is the file mounted on a local filesystem? More...

std::error_code	setCurrentWorkingDirectory (const Twine &Path) override
	Set the working directory. More...

Public Member Functions inherited from llvm::vfs::FileSystem
virtual	~FileSystem ()

llvm::ErrorOr< std::unique_ptr< llvm::MemoryBuffer > >	getBufferForFile (const Twine &Name, int64_t FileSize=-1, bool RequiresNullTerminator=true, bool IsVolatile=false)
	This is a convenience method that opens a file, gets its content and then closes the file. More...

bool	exists (const Twine &Path)
	Check whether a file exists. Provided for convenience. More...

std::error_code	makeAbsolute (SmallVectorImpl< char > &Path) const
	Make Path an absolute path. More...

Public Member Functions inherited from llvm::ThreadSafeRefCountedBase< FileSystem >
void	Retain () const

void	Release () const

Additional Inherited Members
Protected Member Functions inherited from llvm::ThreadSafeRefCountedBase< FileSystem >
	ThreadSafeRefCountedBase ()

Detailed Description

An in-memory file system.

Definition at line 415 of file VirtualFileSystem.h.

Constructor & Destructor Documentation

◆ InMemoryFileSystem()

llvm::vfs::InMemoryFileSystem::InMemoryFileSystem ( bool UseNormalizedPaths = true )

explicit

Definition at line 679 of file VirtualFileSystem.cpp.

References ~InMemoryFileSystem().

◆ ~InMemoryFileSystem()

llvm::vfs::InMemoryFileSystem::~InMemoryFileSystem ( )

overridedefault

Referenced by InMemoryFileSystem().

Member Function Documentation

◆ addFile()

bool llvm::vfs::InMemoryFileSystem::addFile	(	const Twine &	Path,
		time_t	ModificationTime,
		std::unique_ptr< llvm::MemoryBuffer >	Buffer,
		Optional< uint32_t >	User = `None`,
		Optional< uint32_t >	Group = `None`,
		Optional< llvm::sys::fs::file_type >	Type = `None`,
		Optional< llvm::sys::fs::perms >	Perms = `None`
	)

Add a file containing a buffer or a directory to the VFS with a path.

The VFS owns the buffer. If present, User, Group, Type and Perms apply to the newly-created file or directory.

Returns: true if the file or directory was successfully added, false if the file or directory already exists in the file system with different contents.

Definition at line 783 of file VirtualFileSystem.cpp.

◆ addFileNoOwn()

bool llvm::vfs::InMemoryFileSystem::addFileNoOwn	(	const Twine &	Path,
		time_t	ModificationTime,
		llvm::MemoryBuffer *	Buffer,
		Optional< uint32_t >	User = `None`,
		Optional< uint32_t >	Group = `None`,
		Optional< llvm::sys::fs::file_type >	Type = `None`,
		Optional< llvm::sys::fs::perms >	Perms = `None`
	)

Add a buffer to the VFS with a path.

The VFS does not own the buffer. If present, User, Group, Type and Perms apply to the newly-created file or directory.

Returns: true if the file or directory was successfully added, false if the file or directory already exists in the file system with different contents.

Definition at line 793 of file VirtualFileSystem.cpp.

References llvm::MemoryBuffer::getBuffer(), llvm::MemoryBuffer::getBufferIdentifier(), and llvm::MemoryBuffer::getMemBuffer().

◆ addHardLink()

bool llvm::vfs::InMemoryFileSystem::addHardLink	(	const Twine &	From,
		const Twine &	To
	)

Add a hard link to a file.

Here hard links are not intended to be fully equivalent to the classical filesystem. Both the hard link and the file share the same buffer and status (and thus have the same UniqueID). Because of this there is no way to distinguish between the link and the file after the link has been added.

The To path must be an existing file or a hardlink. The From file must not have been added before. The To Path must not be a directory. The From Node is added as a hard link which points to the resolved file of To Node.